feat(parser): Bundle types locally to avoid @pgsql/types dependency

- Copy TypeScript type definitions from types/*/dist/ during build
- Update import paths to use local ./types instead of @pgsql/types
- Make parser package completely self-contained with all necessary types
- Update PUBLISH.md to document the types bundling process

Author: pyramation

PUBLISH.md

@@ -229,11 +229,13 @@ PARSER_BUILD_TYPE=lts npm run build
 ### Build Process
 The simplified parser package:
 1. Copies WASM files from the `versions/*/wasm/` directories
-2. Generates index files from templates based on the build configuration
-3. Creates version-specific export files
-4. Creates a `build-info.json` file documenting what was included
+2. Copies TypeScript type definitions from the `types/*/dist/` directories
+3. Updates import paths to use local types instead of `@pgsql/types`
+4. Generates index files from templates based on the build configuration
+5. Creates version-specific export files
+6. Creates a `build-info.json` file documenting what was included
 
-The templates automatically adjust to include only the versions specified in the build configuration, ensuring proper TypeScript types and runtime validation.
+The templates automatically adjust to include only the versions specified in the build configuration, ensuring proper TypeScript types and runtime validation. The package is completely self-contained with all necessary types bundled.
 
 **Note**: Build scripts use `cross-env` for Windows compatibility.
 

parser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgsql/parser",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "author": "Dan Lynch <[email protected]>",
   "description": "Multi-version PostgreSQL parser with dynamic version selection",
   "main": "./wasm/index.cjs",

parser/scripts/prepare.js

@@ -107,8 +107,40 @@ config.versions.forEach(version => {
     if (fs.statSync(sourcePath).isFile()) {
       console.log(`Copying ${file} for v${version}...`);
       fs.copyFileSync(sourcePath, destPath);
+      
+      // Update index.d.ts to use local types
+      if (file === 'index.d.ts') {
+        let content = fs.readFileSync(destPath, 'utf8');
+        content = content.replace('export * from "@pgsql/types";', 'export * from "./types";');
+        fs.writeFileSync(destPath, content);
+      }
     }
   });
+  
+  // Copy types files
+  const typesSourceDir = path.join(__dirname, `../../types/${version}/dist`);
+  const typesTargetDir = path.join(versionWasmDir, 'types');
+  
+  if (fs.existsSync(typesSourceDir)) {
+    // Create types directory
+    if (!fs.existsSync(typesTargetDir)) {
+      fs.mkdirSync(typesTargetDir, { recursive: true });
+    }
+    
+    // Copy essential type files
+    const typeFiles = ['index.d.ts', 'index.js', 'types.d.ts', 'types.js', 'enums.d.ts', 'enums.js'];
+    typeFiles.forEach(file => {
+      const sourcePath = path.join(typesSourceDir, file);
+      const destPath = path.join(typesTargetDir, file);
+      
+      if (fs.existsSync(sourcePath)) {
+        console.log(`Copying types/${file} for v${version}...`);
+        fs.copyFileSync(sourcePath, destPath);
+      }
+    });
+  } else {
+    console.warn(`Warning: Types for version ${version} not found at ${typesSourceDir}`);
+  }
 });
 
 // Generate files from templates

parser/templates/index.d.ts.template

@@ -13,14 +13,6 @@ export interface ParseResult {
   };
 }
 
-export interface Parser {
-  parse(query: string): ParseResult;
-  parseSync?(query: string): ParseResult;
-  fingerprint?(query: string): string;
-  normalize?(query: string): string;
-  loadModule?(): Promise<void>;
-}
-
 export declare class Parser {
   constructor(version?: ${VERSION_UNION});
   parse(query: string): Promise<ParseResult>;
@@ -32,4 +24,7 @@ export declare class Parser {
 export default Parser;
 
 // Version-specific exports
-${VERSION_TYPE_EXPORTS}
+${VERSION_TYPE_EXPORTS}
+
+// Re-export types from the default version
+export * from './v${DEFAULT_VERSION}/types';