@sapixdb/sdk 0.2.0

package/dist/collection.js

@@ -0,0 +1,190 @@
+// ── CollectionSnapshot ────────────────────────────────────────────────────────
+/**
+ * A read-only view of a collection scoped to a specific point in time.
+ * Returned by `CollectionClient.asOf(timestampHlc)`.
+ *
+ * @example
+ * const snapshot = db.collection("orders").asOf(record.timestamp_hlc);
+ * const results  = await snapshot.latest({ limit: 10 });
+ */
+export class CollectionSnapshot {
+    name;
+    timestampHlc;
+    req;
+    constructor(name, timestampHlc, req) {
+        this.name = name;
+        this.timestampHlc = timestampHlc;
+        this.req = req;
+    }
+    /** Records written at or before this snapshot timestamp, newest-first. */
+    latest(opts = {}) {
+        return this.req("POST", `/v1/agents/${this.name}/query`, {
+            type: "as_of",
+            timestamp_hlc: this.timestampHlc,
+            limit: opts.limit ?? 20,
+        });
+    }
+    /**
+     * Equality-filter scan bounded by the snapshot timestamp.
+     * `filter` is a `{field: value}` object — first key is used.
+     */
+    find(filter, opts = {}) {
+        const [field, value] = Object.entries(filter)[0] ?? [];
+        const whereFilter = field
+            ? { field, op: "eq", value }
+            : undefined;
+        return this.req("POST", `/v1/agents/${this.name}/query`, {
+            type: "scan",
+            limit: opts.limit ?? 20,
+            ...(whereFilter ? { filter: whereFilter } : {}),
+        });
+    }
+    async findOne(filter) {
+        const result = await this.find(filter, { limit: 1 });
+        return result.records[0] ?? null;
+    }
+}
+// ── CollectionClient ──────────────────────────────────────────────────────────
+/**
+ * Client for a named SapixDB agent (collection).
+ * All operations route to `/v1/agents/{name}/...`.
+ *
+ * Obtain via `SapixClient.collection(name)` or `SapixClient.agent(name)`.
+ *
+ * @example
+ * const orders = db.collection("orders");
+ *
+ * // Write
+ * const record = await orders.write({ total: 99.99, status: "pending" });
+ *
+ * // Read
+ * const latest  = await orders.latest({ limit: 20 });
+ * const pending = await orders.find({ status: "pending" });
+ * const one     = await orders.findOne({ status: "pending" });
+ * const byHash  = await orders.get(record.content_hash);
+ *
+ * // History (chronological)
+ * const history = await orders.history({ limit: 100, offset: 0 });
+ *
+ * // Time travel
+ * const snapshot = await orders.asOf(record.timestamp_hlc).latest();
+ *
+ * // Direct SaQL
+ * const result = await orders.query({ type: "latest", limit: 5 });
+ *
+ * // Realtime — handled on SapixClient
+ * client.subscribeAgent("orders", (event) => console.log(event));
+ */
+export class CollectionClient {
+    name;
+    req;
+    constructor(name, req) {
+        this.name = name;
+        this.req = req;
+    }
+    // ── Writes ──────────────────────────────────────────────────────────────────
+    /**
+     * Append a JSON record to the agent's strand.
+     * `data` can be any JSON-serialisable object.
+     */
+    write(data) {
+        return this.req("POST", `/v1/agents/${this.name}/records/json`, { data });
+    }
+    /** Alias for `write` — matches Python/Go SDK naming. */
+    writeJson(data) {
+        return this.write(data);
+    }
+    // ── Reads ───────────────────────────────────────────────────────────────────
+    /**
+     * Fetch a single record by its BLAKE3 content hash.
+     * Use `record.content_hash` from a previous write or query.
+     */
+    get(contentHash) {
+        return this.req("GET", `/v1/agents/${this.name}/records/${contentHash}`);
+    }
+    /**
+     * Return the most recent records, newest-first.
+     *
+     * Pass `filter: { field: value }` to run an equality scan (uses a field
+     * index when one is available for that field, otherwise a full strand scan).
+     */
+    latest(opts = {}) {
+        if (opts.filter) {
+            const [field, value] = Object.entries(opts.filter)[0] ?? [];
+            if (field !== undefined) {
+                return this.req("POST", `/v1/agents/${this.name}/query`, {
+                    type: "scan",
+                    limit: opts.limit ?? 20,
+                    filter: { field, op: "eq", value },
+                });
+            }
+        }
+        return this.req("POST", `/v1/agents/${this.name}/query`, {
+            type: "latest",
+            limit: opts.limit ?? 20,
+        });
+    }
+    /**
+     * Return records in chronological order (oldest-first) with pagination.
+     * Uses `GET /v1/agents/{name}/strand/records`.
+     */
+    history(opts = {}) {
+        const params = new URLSearchParams();
+        if (opts.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts.offset !== undefined)
+            params.set("offset", String(opts.offset));
+        const qs = params.size > 0 ? `?${params}` : "";
+        return this.req("GET", `/v1/agents/${this.name}/strand/records${qs}`);
+    }
+    /**
+     * Equality-filter scan across the full strand.
+     * `filter` is a `{field: value}` object — first key is used.
+     *
+     * Uses a field index when one exists for that field; otherwise falls back
+     * to a full strand scan on the server.
+     */
+    find(filter, opts = {}) {
+        const [field, value] = Object.entries(filter)[0] ?? [];
+        const whereFilter = field
+            ? { field, op: "eq", value }
+            : undefined;
+        return this.req("POST", `/v1/agents/${this.name}/query`, {
+            type: "scan",
+            limit: opts.limit ?? 20,
+            ...(whereFilter ? { filter: whereFilter } : {}),
+        });
+    }
+    /** Return the first matching record, or `null` if none. */
+    async findOne(filter) {
+        const result = await this.find(filter, { limit: 1 });
+        return result.records[0] ?? null;
+    }
+    /** Execute any SaQL query directly against this agent. */
+    query(q) {
+        return this.req("POST", `/v1/agents/${this.name}/query`, q);
+    }
+    /** Current chain head hash and record count. */
+    head() {
+        return this.req("GET", `/v1/agents/${this.name}/strand/head`);
+    }
+    /** Agent status: record count, chain head, zone, schema version, caged state. */
+    status() {
+        return this.req("GET", `/v1/agents/${this.name}/status`);
+    }
+    // ── Time travel ─────────────────────────────────────────────────────────────
+    /**
+     * Scope reads to a point in time identified by an HLC timestamp.
+     * Returns a `CollectionSnapshot` — call `.latest()` or `.find()` on it.
+     *
+     * @param timestampHlc — `NucleotideRecord.timestamp_hlc` from any prior record
+     *
+     * @example
+     * const snapshot = orders.asOf(record.timestamp_hlc);
+     * const state    = await snapshot.latest({ limit: 50 });
+     */
+    asOf(timestampHlc) {
+        return new CollectionSnapshot(this.name, timestampHlc, this.req);
+    }
+}
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,30 @@
+export declare class SapixError extends Error {
+    readonly status?: number | undefined;
+    readonly body?: string | undefined;
+    constructor(message: string, status?: number | undefined, body?: string | undefined);
+    static fromResponse(resp: Response): Promise<SapixError>;
+}
+/**
+ * Thrown when an API key exceeds its configured requests-per-second limit (HTTP 429).
+ *
+ * @example
+ * import { SapixRateLimitError } from "@sapixdb/client";
+ *
+ * try {
+ *   await orders.write(data);
+ * } catch (err) {
+ *   if (err instanceof SapixRateLimitError) {
+ *     const delay = err.rpsLimit ? 1000 / err.rpsLimit : 1000;
+ *     await new Promise(r => setTimeout(r, delay));
+ *     await orders.write(data);  // retry once
+ *   } else throw err;
+ * }
+ */
+export declare class SapixRateLimitError extends SapixError {
+    /** The key's configured limit in requests/second, parsed from the server message. */
+    readonly rpsLimit?: number | undefined;
+    constructor(message: string, 
+    /** The key's configured limit in requests/second, parsed from the server message. */
+    rpsLimit?: number | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;aAGjB,MAAM,CAAC,EAAE,MAAM;aACf,IAAI,CAAC,EAAE,MAAM;gBAF7B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,MAAM,YAAA;WAMlB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;CA0B/D;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IAG/C,qFAAqF;aACrE,QAAQ,CAAC,EAAE,MAAM;gBAFjC,OAAO,EAAE,MAAM;IACf,qFAAqF;IACrE,QAAQ,CAAC,EAAE,MAAM,YAAA;CAKpC"}

package/dist/errors.js

@@ -0,0 +1,60 @@
+export class SapixError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = "SapixError";
+    }
+    static async fromResponse(resp) {
+        let body;
+        try {
+            body = await resp.text();
+        }
+        catch {
+            body = "<unreadable>";
+        }
+        if (resp.status === 429) {
+            let message = "rate limit exceeded";
+            let rpsLimit;
+            try {
+                const data = JSON.parse(body);
+                message = data.message ?? data.error ?? message;
+                const m = message.match(/rate limit of (\d+) req\/s/);
+                if (m)
+                    rpsLimit = Number(m[1]);
+            }
+            catch { /* body was not JSON */ }
+            return new SapixRateLimitError(message, rpsLimit);
+        }
+        return new SapixError(`sapix-agent returned ${resp.status} ${resp.statusText}: ${body}`, resp.status, body);
+    }
+}
+/**
+ * Thrown when an API key exceeds its configured requests-per-second limit (HTTP 429).
+ *
+ * @example
+ * import { SapixRateLimitError } from "@sapixdb/client";
+ *
+ * try {
+ *   await orders.write(data);
+ * } catch (err) {
+ *   if (err instanceof SapixRateLimitError) {
+ *     const delay = err.rpsLimit ? 1000 / err.rpsLimit : 1000;
+ *     await new Promise(r => setTimeout(r, delay));
+ *     await orders.write(data);  // retry once
+ *   } else throw err;
+ * }
+ */
+export class SapixRateLimitError extends SapixError {
+    rpsLimit;
+    constructor(message, 
+    /** The key's configured limit in requests/second, parsed from the server message. */
+    rpsLimit) {
+        super(message, 429);
+        this.rpsLimit = rpsLimit;
+        this.name = "SapixRateLimitError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IACA;IAHlB,YACE,OAAe,EACC,MAAe,EACf,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAS;QACf,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAc;QACtC,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,cAAc,CAAC;QACxB,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACxB,IAAI,OAAO,GAAG,qBAAqB,CAAC;YACpC,IAAI,QAA4B,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyC,CAAC;gBACtE,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC;gBAChD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;gBACtD,IAAI,CAAC;oBAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;YACnC,OAAO,IAAI,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,IAAI,UAAU,CACnB,wBAAwB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,EACjE,IAAI,CAAC,MAAM,EACX,IAAI,CACL,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IAI/B;IAHlB,YACE,OAAe;IACf,qFAAqF;IACrE,QAAiB;QAEjC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAFJ,aAAQ,GAAR,QAAQ,CAAS;QAGjC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { SapixClient } from "./client.js";
+export { AdminClient } from "./admin.js";
+export { CollectionClient, CollectionSnapshot } from "./collection.js";
+export { SapixError, SapixRateLimitError } from "./errors.js";
+export { openAgentStream, openGlobalStream } from "./stream.js";
+export type { AddEdgeRequest, AddRecordRefRequest, AgentStatusResponse, ApiKeyPatch, ApiKeyUsage, ApiKeyView, ChainHeadResponse, CreateApiKeyRequest, CreateApiKeyResponse, EdgeView, GenesisRequest, GenesisResponse, HealthResponse, ListApiKeysResponse, QueryResult, RecordRefView, RecordView, SapixClientOptions, SaqlQuery, StrandRecordsResponse, WhereFilter, WriteResponse, } from "./types.js";
+export type { StreamEvent, SubscribeOptions } from "./stream.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,QAAQ,EACR,cAAc,EACd,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,qBAAqB,EACrB,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { SapixClient } from "./client.js";
+export { AdminClient } from "./admin.js";
+export { CollectionClient, CollectionSnapshot } from "./collection.js";
+export { SapixError, SapixRateLimitError } from "./errors.js";
+export { openAgentStream, openGlobalStream } from "./stream.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/stream.d.ts

@@ -0,0 +1,42 @@
+/** A realtime write event pushed via SSE from SapixDB. */
+export interface StreamEvent {
+    agent_id: string;
+    event_type: string;
+    record_id: string;
+    content_hash: string;
+    timestamp_ms: number;
+    payload?: unknown;
+}
+/** Options for SSE subscriptions. */
+export interface SubscribeOptions {
+    /** HLC timestamp — the server replays records written after this before going live. */
+    since?: number;
+    /** Only emit events whose JSON payload contains this top-level field name. */
+    filter?: string;
+}
+/**
+ * Open an SSE stream for a single named agent.
+ *
+ * Returns an `EventSource`. Call `.close()` to unsubscribe.
+ *
+ * @example
+ * const es = client.subscribeAgent("orders", (ev) => {
+ *   console.log(ev.record_id, ev.payload);
+ * });
+ * es.close();
+ */
+export declare function openAgentStream(baseUrl: string, agentId: string, onEvent: (event: StreamEvent) => void, opts?: SubscribeOptions): EventSource;
+/**
+ * Open an SSE stream for all agents on the node.
+ *
+ * Returns an `EventSource`. Call `.close()` to unsubscribe.
+ *
+ * @example
+ * const es = client.subscribeGlobal((ev) => {
+ *   console.log(ev.agent_id, ev.record_id);
+ * }, { agents: ["orders", "payments"] });
+ */
+export declare function openGlobalStream(baseUrl: string, onEvent: (event: StreamEvent) => void, opts?: SubscribeOptions & {
+    agents?: string[];
+}): EventSource;
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EACrC,IAAI,CAAC,EAAE,gBAAgB,GACtB,WAAW,CAcb;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EACrC,IAAI,CAAC,EAAE,gBAAgB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC9C,WAAW,CAeb"}

package/dist/stream.js

@@ -0,0 +1,60 @@
+/**
+ * Open an SSE stream for a single named agent.
+ *
+ * Returns an `EventSource`. Call `.close()` to unsubscribe.
+ *
+ * @example
+ * const es = client.subscribeAgent("orders", (ev) => {
+ *   console.log(ev.record_id, ev.payload);
+ * });
+ * es.close();
+ */
+export function openAgentStream(baseUrl, agentId, onEvent, opts) {
+    const params = new URLSearchParams();
+    if (opts?.since != null)
+        params.set("since", String(opts.since));
+    if (opts?.filter)
+        params.set("filter", opts.filter);
+    const qs = params.size > 0 ? `?${params}` : "";
+    const es = new EventSource(`${baseUrl}/v1/agents/${agentId}/stream${qs}`);
+    es.addEventListener("record.written", (e) => {
+        try {
+            onEvent(JSON.parse(e.data));
+        }
+        catch {
+            // ignore malformed events
+        }
+    });
+    return es;
+}
+/**
+ * Open an SSE stream for all agents on the node.
+ *
+ * Returns an `EventSource`. Call `.close()` to unsubscribe.
+ *
+ * @example
+ * const es = client.subscribeGlobal((ev) => {
+ *   console.log(ev.agent_id, ev.record_id);
+ * }, { agents: ["orders", "payments"] });
+ */
+export function openGlobalStream(baseUrl, onEvent, opts) {
+    const params = new URLSearchParams();
+    if (opts?.agents?.length)
+        params.set("agents", opts.agents.join(","));
+    if (opts?.since != null)
+        params.set("since", String(opts.since));
+    if (opts?.filter)
+        params.set("filter", opts.filter);
+    const qs = params.size > 0 ? `?${params}` : "";
+    const es = new EventSource(`${baseUrl}/v1/stream${qs}`);
+    es.addEventListener("record.written", (e) => {
+        try {
+            onEvent(JSON.parse(e.data));
+        }
+        catch {
+            // ignore malformed events
+        }
+    });
+    return es;
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,OAAe,EACf,OAAqC,EACrC,IAAuB;IAEvB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,IAAI,IAAI,EAAE,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,GAAG,OAAO,cAAc,OAAO,UAAU,EAAE,EAAE,CAAC,CAAC;IAC1E,EAAE,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,CAAC,CAAQ,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAE,CAAkB,CAAC,IAAI,CAAgB,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,OAAqC,EACrC,IAA+C;IAE/C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,IAAI,EAAE,MAAM,EAAE,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,IAAI,IAAI,EAAE,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,GAAG,OAAO,aAAa,EAAE,EAAE,CAAC,CAAC;IACxD,EAAE,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,CAAC,CAAQ,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAE,CAAkB,CAAC,IAAI,CAAgB,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,195 @@
+export interface GenesisRequest {
+    zone?: "immutable_core" | "protected" | "governed" | "free";
+}
+export interface GenesisResponse {
+    agent_id: string;
+    public_key_hex: string;
+    genesis_record_id: string;
+    chain_head_hex: string;
+    zone: string;
+}
+export interface AgentStatusResponse {
+    agent_id: string;
+    record_count: number;
+    chain_head: string;
+    schema_version: number;
+    zone: string;
+    caged: boolean;
+}
+export interface WriteRequest {
+    /** Base64-encoded payload bytes. */
+    payload_b64: string;
+    /** Block flag bits: GENESIS=1, TOMBSTONE=2, BLOB_REF=4. Default 0. */
+    flags?: number;
+}
+export interface WriteResponse {
+    record_id: string;
+    content_hash: string;
+    chain_head: string;
+    /** null = Codios not configured (open mode); true = Codios authorized. */
+    codios_verified: boolean | null;
+    /** "open" or "enforced" */
+    codios_mode: string;
+    codios_contract_id?: string;
+}
+export interface RecordView {
+    record_id: string;
+    content_hash: string;
+    parent_hash: string;
+    /** HLC timestamp packed as a u64. JSON number — safe to ~2^53 ms (~year 285,428). */
+    timestamp_hlc: number;
+    /** Wall-clock milliseconds since epoch extracted from the HLC. */
+    timestamp_ms: number;
+    /** Base64-encoded raw MessagePack payload bytes. */
+    payload_b64: string;
+    /**
+     * Payload decoded from MessagePack to a plain JSON value.
+     * `null` when the payload is raw binary (not a MessagePack map).
+     */
+    payload: Record<string, unknown> | null;
+    /** Block flag bits (bit0=GENESIS, bit1=TOMBSTONE, bit2=BLOB_REF, bit3=MUTATION). */
+    flags: number;
+    schema_version: number;
+}
+export interface ChainHeadResponse {
+    chain_head: string;
+    record_count: number;
+}
+export interface StrandRecordsResponse {
+    records: RecordView[];
+    total: number;
+}
+export interface WhereFilter {
+    field: string;
+    op: "eq" | "between";
+    value: unknown;
+    /** Upper bound for `between` queries. */
+    upper?: unknown;
+}
+export type SaqlQuery = {
+    type: "hash";
+    content_hash: string;
+} | {
+    type: "time_range";
+    from_ts: number;
+    to_ts: number;
+} | {
+    type: "latest";
+    limit?: number;
+} | {
+    type: "chain_head";
+} | {
+    type: "as_of";
+    timestamp_hlc: number;
+    limit?: number;
+} | {
+    type: "scan";
+    limit?: number;
+    filter?: WhereFilter;
+};
+export interface QueryResult {
+    records: RecordView[];
+}
+export interface AddEdgeRequest {
+    src: string;
+    edge_type: string;
+    dst: string;
+    weight?: number;
+}
+export interface EdgeView {
+    src: string;
+    edge_type: string;
+    dst: string;
+    timestamp_hlc: number;
+    weight: number;
+}
+export interface AddRecordRefRequest {
+    src_agent: string;
+    src_content_hash: string;
+    edge_type: string;
+    dst_agent: string;
+    dst_content_hash: string;
+}
+export interface RecordRefView {
+    src_agent: string;
+    src_content_hash: string;
+    edge_type: string;
+    dst_agent: string;
+    dst_content_hash: string;
+}
+export interface ApiKeyView {
+    key_id: string;
+    /** First 14 characters of the key, e.g. ``sapix_sk_a3f9…`` */
+    key_prefix: string;
+    label: string;
+    scopes: string[];
+    created_at_ms: number;
+    /** undefined = permanent key */
+    expires_at_ms?: number;
+    revoked: boolean;
+    caller_id?: string;
+    /** undefined = unlimited */
+    rate_limit_rps?: number;
+}
+export interface CreateApiKeyRequest {
+    label: string;
+    scopes: string[];
+    /** Unix ms expiry. Omit for a permanent key. */
+    expires_at_ms?: number;
+    caller_id?: string;
+    rate_limit_rps?: number;
+}
+export interface CreateApiKeyResponse extends ApiKeyView {
+    /** The full secret key — shown exactly once. Save it immediately. */
+    key: string;
+    warning: string;
+}
+/**
+ * Partial update for an existing key.
+ * Only provided fields are changed.
+ * Set a nullable field to `null` to clear it (e.g. remove expiry).
+ */
+export interface ApiKeyPatch {
+    label?: string;
+    scopes?: string[];
+    /** `null` = remove expiry (make permanent). */
+    expires_at_ms?: number | null;
+    /** `null` = remove caller identity override. */
+    caller_id?: string | null;
+    /** `null` = remove rate limit (unlimited). */
+    rate_limit_rps?: number | null;
+}
+export interface ApiKeyUsage {
+    key_id: string;
+    label: string;
+    request_count_since_restart: number;
+    /** undefined if the key has never been used since last restart. */
+    last_used_at_ms?: number;
+}
+export interface ListApiKeysResponse {
+    keys: ApiKeyView[];
+    total: number;
+}
+export interface HealthResponse {
+    status: "ok";
+    agent: string;
+}
+export interface SapixClientOptions {
+    /** sapix-agent base URL, e.g. "http://localhost:7475" */
+    baseUrl: string;
+    /**
+     * API key for SapixDB bearer-token authentication.
+     * When set, every request includes `Authorization: Bearer <apiKey>`.
+     */
+    apiKey?: string;
+    /**
+     * Caller identity forwarded to Codios as `caller_identity`.
+     * Sent as `X-Sapix-Caller: <callerId>`.
+     */
+    callerId?: string;
+    /** Request timeout in milliseconds. Default: 10_000. */
+    timeoutMs?: number;
+    /** Optional fetch override (useful for testing). Default: globalThis.fetch */
+    fetch?: typeof globalThis.fetch;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,gBAAgB,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;CAC7D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAID,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,IAAI,GAAG,SAAS,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAID,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAID,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B,EAAE,MAAM,CAAC;IACpC,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ── Agent identity ─────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kFAAkF"}