feat(packages/node): add platform-specific package generation and @sqliteai/sqlite-vector package initial commit

Author: Gioee

.github/workflows/main.yml

@@ -5,6 +5,7 @@ on:
 
 permissions:
   contents: write
+  # id-token: write  # TODO: Enable after first release for npm provenance with OIDC
 
 jobs:
   build:
@@ -321,13 +322,86 @@ jobs:
         if: steps.tag.outputs.version != ''
         run: cd packages/android && ./gradlew publishAggregationToCentralPortal -PSIGNING_KEY="${{ secrets.SIGNING_KEY }}" -PSIGNING_PASSWORD="${{ secrets.SIGNING_PASSWORD }}" -PSONATYPE_USERNAME="${{ secrets.MAVEN_CENTRAL_USERNAME }}" -PSONATYPE_PASSWORD="${{ secrets.MAVEN_CENTRAL_TOKEN }}" -PVERSION="${{ steps.tag.outputs.version }}" -PAAR_PATH="../../artifacts/vector-android-aar/vector.aar"
 
+      - uses: actions/setup-node@v4
+        if: steps.tag.outputs.version != ''
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: build and publish npm packages
+        if: steps.tag.outputs.version != ''
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          cd packages/node
+
+          # Generate platform packages
+          echo "Generating platform packages..."
+          node generate-platform-packages.js "${{ steps.tag.outputs.version }}" "../../artifacts" "./platform-packages"
+          echo "✓ Generated 7 platform packages"
+          ls -la platform-packages/
+
+          # Build main package
+          echo "Building main package..."
+          npm install
+          npm run build
+          npm test
+          echo "✓ Main package built and tested"
+
+          # Publish platform packages
+          echo "Publishing platform packages to npm..."
+          cd platform-packages
+          for platform_dir in */; do
+            platform_name=$(basename "$platform_dir")
+            echo "  Publishing @sqliteai/sqlite-vector-${platform_name}..."
+            cd "$platform_dir"
+            npm publish --access public
+            # TODO: Add --provenance flag after switching to OIDC (requires package to exist first)
+            cd ..
+            echo "  ✓ Published @sqliteai/sqlite-vector-${platform_name}"
+          done
+          cd ..
+
+          # Publish main package
+          echo "Publishing main package to npm..."
+          npm publish --access public
+          # TODO: Add --provenance flag after switching to OIDC (requires package to exist first)
+          echo "✓ Published @sqliteai/sqlite-vector@${{ steps.tag.outputs.version }}"
+
+          echo ""
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo "✅ Successfully published 8 packages to npm"
+          echo "   Main: @sqliteai/sqlite-vector@${{ steps.tag.outputs.version }}"
+          echo "   Platform packages: 7"
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
       - uses: softprops/[email protected]
         if: steps.tag.outputs.version != ''
         with:
           body: |
+            # Node.js/npm Package
+
+            **Main package**: [@sqliteai/sqlite-vector](https://www.npmjs.com/package/@sqliteai/sqlite-vector)
+
+            ```bash
+            npm install @sqliteai/sqlite-vector
+            ```
+
+            Platform-specific packages are installed automatically based on your OS.
+
+            ---
+
             # WASM Releases
+
             **WASM repository**: [sqlite-wasm](https://github.com/sqliteai/sqlite-wasm)
-            **WASM package** is available on npm: [@sqliteai/sqlite-wasm](https://www.npmjs.com/package/@sqliteai/sqlite-wasm)
+            **WASM package**: [@sqliteai/sqlite-wasm](https://www.npmjs.com/package/@sqliteai/sqlite-wasm)
+
+            ```bash
+            npm install @sqliteai/sqlite-wasm
+            ```
+
+            ---
+
           generate_release_notes: true
           tag_name: ${{ steps.tag.outputs.version }}
           files: vector-*-${{ steps.tag.outputs.version }}.*

packages/node/.gitignore

@@ -0,0 +1,33 @@
+# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+*.tsbuildinfo
+
+# Test coverage
+coverage/
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Generated platform packages (created dynamically in GitHub Actions)
+platform-packages/
+
+# Test outputs
+test-artifacts/
+test-output/
+test-platform-packages/

packages/node/.npmignore

@@ -0,0 +1,23 @@
+# Development and build files
+src/
+*.test.ts
+*.test.js
+tsconfig.json
+tsup.config.ts
+
+# Documentation (not needed in published package)
+IMPLEMENTATION.md
+WORKFLOW_STEPS.md
+README.md
+
+# Scripts (only for repo/CI)
+generate-platform-packages.js
+
+# Development files
+node_modules/
+coverage/
+*.log
+
+# Git
+.git/
+.gitignore

packages/node/LICENSE.md

@@ -0,0 +1 @@
+../../LICENSE.md