component api

.github/workflows/test.yml

@@ -16,19 +16,21 @@ jobs:
     timeout-minutes: 30
 
     steps:
-      - uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
 
       - name: Node setup
-        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
+        uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444 # v5
         with:
-          node-version: "20.19.5"
+          cache-dependency-path: package.json
+          node-version: "20.x"
+          cache: "npm"
 
-      - name: Install dependencies
+      - name: Install and build
         run: |
           npm i
           npm run build
-      - name: pkg-pr-new
-        run: npx pkg-pr-new publish .
+      - name: Publish package for testing branch
+        run: npx pkg-pr-new publish || echo "Have you set up pkg-pr-new for this repo?"
       - name: Test
         run: |
           npm run test

.prettierrc.json

@@ -1,3 +1,4 @@
 {
-  "trailingComma": "es5"
+  "trailingComma": "all",
+  "proseWrap": "always"
 }

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.6.0
+
+- Adds /test and /\_generated/component.js entrypoints
+- Drops commonjs support
+- Improves source mapping for generated files
+- Changes to a statically generated component API
+
 ## 0.5.4
 
 - Support gateway string IDs for models
@@ -28,18 +35,17 @@
 
 - ai is a regular dependency
 - namespaces can be deleted if there are no entries left in them
-- namespaces can be synchronously deleted from an action if there
-  are entries in them
+- namespaces can be synchronously deleted from an action if there are entries in
+  them
 
 ## 0.3.3
 
 - Allow deleting an entry by key asynchronously or sync
-- Deprecated: `.delete` from mutations is deprecated.
-  `.delete` is now synchronous for an entry.
-  Use `.deleteAsync` from mutations instead.
+- Deprecated: `.delete` from mutations is deprecated. `.delete` is now
+  synchronous for an entry. Use `.deleteAsync` from mutations instead.
 - Fix: Delete embeddings when deleting entry
-- Fix: Replacing small documents by key no longer leaves
-  them in "pending" state.
+- Fix: Replacing small documents by key no longer leaves them in "pending"
+  state.
 
 ## 0.3.2
 
@@ -57,15 +63,17 @@
 
 - Demote document titles to h2 when auto-generating prompt template
 - Rename replacedVersion -> replaced{Entry,Namespace} to match onComplete
-- Allow listing documents by status without specifying a namespace (e.g. vacuuming)
+- Allow listing documents by status without specifying a namespace (e.g.
+  vacuuming)
 - Return replacedAt when listing documents
 
 ## 0.1.7/0.3.0
 
 - Renamed to RAG
 - Adds a default chunker, so you can pass `text` to `add[Async]`
 - Adds a `generateText` with default prompt formatting for one-off generation.
-- OnComplete handler now has updated status for the replaced & new entry/namespace
+- OnComplete handler now has updated status for the replaced & new
+  entry/namespace
 - Example showcases prompting as well as searching.
 
 ## 0.1.6
@@ -79,8 +87,8 @@
 ## 0.1.4
 
 - Allow adding files asynchronously
-- Allow passing an onComplete handler to creating entries
-  or namespaces, that is called when they are no longer pending.
+- Allow passing an onComplete handler to creating entries or namespaces, that is
+  called when they are no longer pending.
 - Support generic type-safe metadata to be stored on the entry.
 - Updated the example to also show uploading files via http.
 
@@ -89,8 +97,8 @@
 - Renamed doc to entry
 - Allows passing vectorScoreThreshold to search
 - More convenient `text` returned from search
-- Enables passing in your own embedding parameter to add
-  -> Allows adding (a few chunks) from a mutation.
+- Enables passing in your own embedding parameter to add -> Allows adding (a few
+  chunks) from a mutation.
 
 ## 0.1.2
 
@@ -99,8 +107,8 @@
 ## 0.1.1
 
 - Vector search over chunked content, with namespaces, search filters, etc.
-- You can also gracefully transition between models, embedding lengths,
-  chunking strategies, and versions, with automatically versioned namespaces.
+- You can also gracefully transition between models, embedding lengths, chunking
+  strategies, and versions, with automatically versioned namespaces.
 - See the example for injesting pdfs, images, audio, and text!
 - List namespaces by status, entries by namespace/status, and chunks by entry
 - Find older versions by content hash to restore.

CONTRIBUTING.md

@@ -24,7 +24,7 @@ npm run test
 
 ```sh
 npm run clean
-npm run build
+npm ci
 npm pack
 ```
 
@@ -34,9 +34,7 @@ npm pack
 npm run release
 ```
 
-#### Alpha release
-
-The same as above, but it will publish the release with the `@alpha` tag:
+or for alpha release:
 
 ```sh
 npm run alpha