@aithos/sdk 0.1.0-alpha.36 → 0.1.0-alpha.38

package/dist/src/data.d.ts

@@ -24,6 +24,23 @@ export interface CreateDataClientArgs {
     readonly verificationMethod: string;
     /** Optional fetch implementation. Defaults to globalThis.fetch. */
     readonly fetch?: typeof fetch;
+    /**
+     * Optional list of app-defined schema definitions, in addition to
+     * the SDK-bundled core schemas (currently `aithos.contacts.v1`).
+     *
+     * Apps in the vendor namespace (`aithos.x.<vendor>.<name>.v<N>`) or
+     * non-`aithos.*` namespaces MUST supply their schemas here so the
+     * SDK can split records into indexable metadata vs encrypted payload.
+     *
+     * When the same schema id appears in both the bundled core registry
+     * and this list, the app-supplied definition wins (intentional —
+     * allows local overrides for testing, though immutability per spec
+     * §3.5 means a published schema id should never change shape).
+     *
+     * Schemas are scoped to the {@link DataClient} instance — they don't
+     * leak to other clients in the same process.
+     */
+    readonly schemas?: readonly AithosSchemaLite[];
 }
 export interface DataClient {
     /** Get / create a collection handle. */

package/dist/src/data.js

@@ -19,10 +19,17 @@
  * encrypted payload (server-blind), JSON-RPC dispatch.
  *
  * It does not (yet) handle: mandate-delegate authentication on the
- * caller side (the SDK only signs as owner in v0.1), schema
- * publication (only the bundled `aithos.contacts.v1` is recognized),
- * forward-secrecy CMK rotation primitives. Those land in later
- * Sub-jalons.
+ * caller side (the SDK only signs as owner in v0.1), full schema
+ * publication (no `registerSchema` RPC yet — that lands with A2b, cf.
+ * aithos-protocol/PLAN-A2b-schema-self-registration.md), forward-secrecy
+ * CMK rotation primitives. Those land in later Sub-jalons.
+ *
+ * Apps that need to use a vendor schema (`aithos.x.<vendor>.<name>.v<N>`,
+ * or any non-`aithos.*` namespace) pass their schema definitions to
+ * `createDataClient({ schemas: [...] })`. The PDS accepts these at face
+ * value (no server-side metadata validation pending A2b); the SDK uses
+ * the supplied schema definitions to split records into indexable
+ * metadata and encrypted payload.
  *
  * Spec ref: spec/data/01..10 of the aithos-protocol repo.
  */
@@ -59,6 +66,13 @@ class DataClientImpl {
     #seed;
     #vm;
     #fetch;
+    /**
+     * Per-client schema overrides, populated from `args.schemas` at
+     * construction. Looked up BEFORE the bundled SCHEMAS map (so an app
+     * can override a core schema locally if it really wants to, though
+     * the immutability rule of spec §3.5 strongly discourages this).
+     */
+    #localSchemas;
     // Per-collection CMK cache: cleared on reset()
     #cmkCache = new Map();
     #colCache = new Map();
@@ -68,6 +82,15 @@ class DataClientImpl {
         this.#seed = args.sphereSeed;
         this.#vm = args.verificationMethod;
         this.#fetch = args.fetch ?? globalThis.fetch.bind(globalThis);
+        this.#localSchemas = new Map((args.schemas ?? []).map((s) => [s.schema, s]));
+    }
+    /**
+     * Resolve a schema id to its lite definition. App-supplied schemas
+     * (via `createDataClient({ schemas })`) take precedence over the
+     * SDK-bundled core registry.
+     */
+    #resolveSchema(schemaId) {
+        return this.#localSchemas.get(schemaId) ?? SCHEMAS.get(schemaId) ?? null;
     }
     collection(name) {
         return new DataCollectionImpl(this, name);
@@ -168,9 +191,12 @@ class DataClientImpl {
             privateKey: ed25519SeedToX25519PrivateKey(this.#seed),
         });
         this.#cmkCache.set(name, cmk);
-        const schema = SCHEMAS.get(meta.schema);
+        const schema = this.#resolveSchema(meta.schema);
         if (!schema) {
-            throw new Error(`sdk.data: schema "${meta.schema}" not known to the SDK`);
+            throw new Error(`sdk.data: schema "${meta.schema}" not known to the SDK. ` +
+                `Pass it via createDataClient({ schemas: [...] }) if it's an ` +
+                `app-defined (vendor) schema, or upgrade the SDK if it's a core ` +
+                `schema added in a later release.`);
         }
         const state = { name, urn: meta.urn, schema };
         this.#colCache.set(name, state);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aithos/sdk",
-  "version": "0.1.0-alpha.36",
+  "version": "0.1.0-alpha.38",
   "description": "Aithos SDK — high-level TypeScript developer kit for building agentic apps on the Aithos protocol. Wraps @aithos/protocol-client and exposes the Aithos compute proxy and wallet (Stripe top-up) endpoints.",
   "keywords": [
     "aithos",