sapixdb 0.1.0

package/README.md

@@ -0,0 +1,295 @@
+# SapixDB JavaScript / TypeScript SDK
+
+Official SDK for [SapixDB](https://sapixdb.com) — the agent-native living database.
+
+Zero dependencies. Works in Node.js 18+, Bun, Deno, and modern browsers.
+
+## Installation
+
+```bash
+npm install sapixdb
+# or
+bun add sapixdb
+```
+
+## Quick Start
+
+```typescript
+import { SapixClient } from "sapixdb";
+
+const db = new SapixClient({
+  url: "http://localhost:7475",
+  agent: "my-app",
+});
+
+// Write a record
+const record = await db.collection("products").write({
+  name: "T-Shirt",
+  price: 29.99,
+  stock: 100,
+});
+console.log(record.id);   // "nuc_abc123"
+console.log(record.hash); // "sha3:e7f2a1..."
+
+// Read latest records
+const products = await db.collection("products").latest();
+
+// Filter
+const shirts = await db.collection("products").find({ category: "apparel" });
+
+// Time travel — what did the DB look like yesterday?
+const yesterday = await db
+  .collection("orders")
+  .asOf("2026-05-11T00:00:00Z")
+  .latest();
+```
+
+## API Reference
+
+### `new SapixClient(config)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `url` | `string` | — | SapixDB agent URL |
+| `agent` | `string` | — | Agent ID (matches `SAPIX_AGENT_ID`) |
+| `headers` | `Record<string,string>` | `{}` | Extra HTTP headers |
+| `timeout` | `number` | `10000` | Request timeout (ms) |
+
+---
+
+### `db.collection(name)`
+
+Returns a `CollectionClient` for the given collection name.
+
+#### `.write(data)` → `WriteResult`
+
+Append a new record. Nothing is ever overwritten.
+
+```typescript
+const result = await db.collection("orders").write({
+  customer_id: "cust_001",
+  total: 149.99,
+  status: "placed",
+});
+// result.id       — nucleotide ID
+// result.hash     — cryptographic fingerprint
+// result.timestamp — ISO 8601 timestamp
+```
+
+#### `.writeBatch(records[])` → `WriteResult[]`
+
+Write multiple records in parallel.
+
+```typescript
+await db.collection("products").writeBatch([
+  { name: "T-Shirt",  price: 29.99 },
+  { name: "Sneakers", price: 89.99 },
+]);
+```
+
+#### `.get(id)` → `NucleotideRecord`
+
+Fetch a single record by its nucleotide ID.
+
+```typescript
+const record = await db.collection("orders").get("nuc_abc123");
+console.log(record.data.status); // "placed"
+```
+
+#### `.latest(options?)` → `NucleotideRecord[]`
+
+Fetch the latest version of every record in the collection.
+
+#### `.history(options?)` → `NucleotideRecord[]`
+
+Fetch ALL versions — the full append-only history.
+
+#### `.find(filter, options?)` → `NucleotideRecord[]`
+
+Find records matching a filter (latest version only).
+
+```typescript
+const pending = await db.collection("orders").find({ status: "pending" });
+```
+
+#### `.findOne(filter)` → `NucleotideRecord | null`
+
+Find the first matching record, or `null`.
+
+#### `.asOf(timestamp)` → `CollectionQuery`
+
+Scope all subsequent reads to a specific point in time.
+
+```typescript
+// What did Alice's record look like 2 hours ago?
+const snapshot = await db
+  .collection("users")
+  .asOf("2026-05-12T08:00:00Z")
+  .find({ name: "Alice" });
+```
+
+---
+
+### `db.graph`
+
+#### `.relate(src, dst, type, weight?)` → `void`
+
+Create a typed directed edge between two records.
+
+```typescript
+await db.graph.relate(orderId, customerId, "placed_by");
+await db.graph.relate(productId, categoryId, "belongs_to");
+await db.graph.relate(managerId, reportId, "manages", 1.0);
+```
+
+#### `.addEdge(edge)` → `void`
+
+Full edge creation with all options.
+
+```typescript
+await db.graph.addEdge({
+  src: "nuc_abc123",
+  dst: "nuc_def456",
+  edge_type: "manages",
+  weight: 1.0,
+});
+```
+
+#### `.traverse(fromId, options?)` → `TraverseResult`
+
+Walk the graph from a starting node.
+
+```typescript
+const { nodes, edges } = await db.graph.traverse("nuc_abc123", {
+  depth: 3,
+  direction: "outbound", // "outbound" | "inbound" | "both"
+});
+```
+
+#### `.neighbors(id, direction?)` → `NucleotideRecord[]`
+
+Get direct neighbours of a node.
+
+---
+
+### `db.ingest(collection, data)` → `WriteResult`
+
+Write via the ingest endpoint — designed for AI agents, webhooks, and automated pipelines.
+
+```typescript
+await db.ingest("ai_decisions", {
+  model: "gpt-4o",
+  action: "approve_loan",
+  confidence: 0.94,
+  reasoning: "Credit score 780, DTI 28%",
+});
+```
+
+---
+
+### `db.health()` / `db.ping()`
+
+```typescript
+const { status, agent } = await db.health(); // throws on failure
+const alive = await db.ping();               // returns true/false, never throws
+```
+
+---
+
+## TypeScript Generics
+
+Pass your type as a generic to get full autocomplete and type checking:
+
+```typescript
+interface Product {
+  name: string;
+  price: number;
+  stock: number;
+  category?: string;
+}
+
+const products = db.collection<Product>("products");
+
+const result = await products.write({ name: "T-Shirt", price: 29.99, stock: 100 });
+const items = await products.latest();
+// items[0].data.price is typed as number ✓
+```
+
+---
+
+## Error Handling
+
+```typescript
+import { SapixError, SapixNetworkError, SapixNotFoundError } from "sapixdb";
+
+try {
+  const record = await db.collection("orders").get("nuc_missing");
+} catch (err) {
+  if (err instanceof SapixNotFoundError) {
+    console.log("Record does not exist");
+  } else if (err instanceof SapixNetworkError) {
+    console.log("Cannot reach SapixDB — is it running?");
+  } else if (err instanceof SapixError) {
+    console.log(`SapixDB error ${err.status}: ${err.message}`);
+  }
+}
+```
+
+---
+
+## Full Example: Online Store
+
+```typescript
+import { SapixClient } from "sapixdb";
+
+const db = new SapixClient({ url: "http://localhost:7475", agent: "store" });
+
+// ── 1. Add products ───────────────────────────────────────────────
+const shirt = await db.collection("products").write({
+  sku: "SHIRT-001", name: "Classic T-Shirt", price: 29.99, stock: 200,
+});
+const shoes = await db.collection("products").write({
+  sku: "SHOE-042", name: "Running Sneakers", price: 89.99, stock: 50,
+});
+
+// ── 2. Register a customer ────────────────────────────────────────
+const customer = await db.collection("customers").write({
+  name: "Alice Johnson", email: "alice@example.com", tier: "standard",
+});
+
+// ── 3. Place an order ─────────────────────────────────────────────
+const order = await db.collection("orders").write({
+  customer_id: customer.id,
+  items: [
+    { product_id: shirt.id, qty: 2, unit_price: 29.99 },
+    { product_id: shoes.id, qty: 1, unit_price: 89.99 },
+  ],
+  total: 149.97,
+  status: "placed",
+});
+
+// Link order → customer in the graph
+await db.graph.relate(order.id, customer.id, "placed_by");
+
+// ── 4. Ship the order (append, never overwrite) ───────────────────
+await db.collection("orders").write({
+  ...order,          // same logical entity
+  status: "shipped",
+  tracking: "UPS-1Z999AA10123456784",
+  shipped_at: new Date().toISOString(),
+});
+
+// ── 5. Audit: what was the order status 10 minutes ago? ───────────
+const tenMinutesAgo = new Date(Date.now() - 10 * 60_000).toISOString();
+const snapshot = await db
+  .collection("orders")
+  .asOf(tenMinutesAgo)
+  .find({ customer_id: customer.id });
+// → returns the "placed" version, before it was shipped
+
+// ── 6. Graph: find everything this customer is connected to ───────
+const { nodes } = await db.graph.traverse(customer.id, {
+  depth: 2, direction: "inbound",
+});
+// → returns the order records linked to this customer
+```

package/dist/client.d.ts

@@ -0,0 +1,43 @@
+import { CollectionClient } from "./collection.js";
+import { GraphClient } from "./graph.js";
+import type { SapixClientConfig, HealthResponse, WriteResult } from "./types.js";
+export declare class SapixClient {
+    private readonly config;
+    /** Graph traversal and edge management. */
+    readonly graph: GraphClient;
+    constructor(config: SapixClientConfig);
+    /**
+     * Access a collection. All reads and writes go through this.
+     *
+     * @example
+     * const products = db.collection("products");
+     * await products.write({ name: "T-Shirt", price: 29.99 });
+     * const all = await products.latest();
+     *
+     * // With TypeScript generics for full type safety:
+     * const products = db.collection<Product>("products");
+     */
+    collection<T = Record<string, unknown>>(name: string): CollectionClient<T>;
+    /**
+     * Ingest a record via the agent ingest endpoint.
+     * Designed for AI agents, webhooks, and automated pipelines.
+     * Supports optional dual-write to Supabase if configured on the server.
+     *
+     * @example
+     * await db.ingest("ai_decisions", {
+     *   model: "gpt-4o",
+     *   action: "approve_loan",
+     *   confidence: 0.94,
+     *   reasoning: "Credit score 780, DTI 28%",
+     * });
+     */
+    ingest(collection: string, data: Record<string, unknown>): Promise<WriteResult>;
+    /** Check that the SapixDB agent is reachable and running. */
+    health(): Promise<HealthResponse>;
+    /**
+     * Ping the agent. Returns true if healthy, false if unreachable.
+     * Does not throw.
+     */
+    ping(): Promise<boolean>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;gBAEhB,MAAM,EAAE,iBAAiB;IASrC;;;;;;;;;;OAUG;IACH,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAI1E;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IASrF,6DAA6D;IACvD,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAIvC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;CAQ/B"}

package/dist/client.js

@@ -0,0 +1,61 @@
+import { request } from "./http.js";
+import { CollectionClient } from "./collection.js";
+import { GraphClient } from "./graph.js";
+export class SapixClient {
+    constructor(config) {
+        this.config = {
+            timeout: 10000,
+            ...config,
+            url: config.url.replace(/\/$/, ""),
+        };
+        this.graph = new GraphClient(this.config);
+    }
+    /**
+     * Access a collection. All reads and writes go through this.
+     *
+     * @example
+     * const products = db.collection("products");
+     * await products.write({ name: "T-Shirt", price: 29.99 });
+     * const all = await products.latest();
+     *
+     * // With TypeScript generics for full type safety:
+     * const products = db.collection<Product>("products");
+     */
+    collection(name) {
+        return new CollectionClient(this.config, name);
+    }
+    /**
+     * Ingest a record via the agent ingest endpoint.
+     * Designed for AI agents, webhooks, and automated pipelines.
+     * Supports optional dual-write to Supabase if configured on the server.
+     *
+     * @example
+     * await db.ingest("ai_decisions", {
+     *   model: "gpt-4o",
+     *   action: "approve_loan",
+     *   confidence: 0.94,
+     *   reasoning: "Credit score 780, DTI 28%",
+     * });
+     */
+    async ingest(collection, data) {
+        return request(this.config, "POST", `/v1/${this.config.agent}/ingest`, { collection, data });
+    }
+    /** Check that the SapixDB agent is reachable and running. */
+    async health() {
+        return request(this.config, "GET", "/v1/health");
+    }
+    /**
+     * Ping the agent. Returns true if healthy, false if unreachable.
+     * Does not throw.
+     */
+    async ping() {
+        try {
+            const res = await this.health();
+            return res.status === "ok";
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAOzC,MAAM,OAAO,WAAW;IAMtB,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,KAAM;YACf,GAAG,MAAM;YACT,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SACnC,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;OAUG;IACH,UAAU,CAA8B,IAAY;QAClD,OAAO,IAAI,gBAAgB,CAAI,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,IAA6B;QAC5D,OAAO,OAAO,CACZ,IAAI,CAAC,MAAM,EACX,MAAM,EACN,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,SAAS,EACjC,EAAE,UAAU,EAAE,IAAI,EAAE,CACrB,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,MAAM;QACV,OAAO,OAAO,CAAiB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,OAAO,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/collection.d.ts

@@ -0,0 +1,41 @@
+import type { SapixClientConfig, WriteResult, NucleotideRecord, QueryOptions } from "./types.js";
+export declare class CollectionQuery<T = Record<string, unknown>> {
+    private readonly config;
+    private readonly name;
+    private readonly asOfTimestamp?;
+    constructor(config: SapixClientConfig, name: string, asOfTimestamp?: string | undefined);
+    /** Fetch all versions matching filter (full history). */
+    all(options?: Omit<QueryOptions, "latest">): Promise<NucleotideRecord<T>[]>;
+    /** Fetch only the latest version of each matching record. */
+    latest(options?: Omit<QueryOptions, "latest">): Promise<NucleotideRecord<T>[]>;
+    /** Find records matching a filter, latest version only. */
+    find(filter: Record<string, unknown>, options?: Omit<QueryOptions, "filter" | "latest">): Promise<NucleotideRecord<T>[]>;
+    /** Find one record matching a filter, or null. */
+    findOne(filter: Record<string, unknown>): Promise<NucleotideRecord<T> | null>;
+    private _query;
+}
+export declare class CollectionClient<T = Record<string, unknown>> {
+    private readonly config;
+    private readonly name;
+    constructor(config: SapixClientConfig, name: string);
+    /**
+     * Return a query scoped to a specific point in time.
+     * @param timestamp ISO 8601 string, e.g. "2026-05-12T10:00:00Z"
+     */
+    asOf(timestamp: string): CollectionQuery<T>;
+    /** Write a new record. Every write is a new nucleotide — nothing is overwritten. */
+    write(data: Partial<T> & Record<string, unknown>): Promise<WriteResult>;
+    /** Write multiple records in one call. */
+    writeBatch(records: Array<Partial<T> & Record<string, unknown>>): Promise<WriteResult[]>;
+    /** Fetch a single record by its nucleotide ID. */
+    get(id: string): Promise<NucleotideRecord<T>>;
+    /** Query the latest version of all records in this collection. */
+    latest(options?: Omit<QueryOptions, "latest">): Promise<NucleotideRecord<T>[]>;
+    /** Query ALL versions (full history) in this collection. */
+    history(options?: Omit<QueryOptions, "latest">): Promise<NucleotideRecord<T>[]>;
+    /** Find records matching a filter (latest version only). */
+    find(filter: Record<string, unknown>, options?: Omit<QueryOptions, "filter" | "latest">): Promise<NucleotideRecord<T>[]>;
+    /** Find one record or return null. */
+    findOne(filter: Record<string, unknown>): Promise<NucleotideRecord<T> | null>;
+}
+//# sourceMappingURL=collection.d.ts.map

package/dist/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEpD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAFd,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,YAAA;IAGzC,yDAAyD;IACnD,GAAG,CAAC,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IAIrF,6DAA6D;IACvD,MAAM,CAAC,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IAIxF,2DAA2D;IACrD,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,QAAQ,CAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IAIlI,kDAAkD;IAC5C,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YAKrE,MAAM;CAerB;AAED,qBAAa,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAErD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,MAAM;IAG/B;;;OAGG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC;IAI3C,oFAAoF;IAC9E,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAS7E,0CAA0C;IACpC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAK9F,kDAAkD;IAC5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAenD,kEAAkE;IAC5D,MAAM,CAAC,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IAIxF,4DAA4D;IACtD,OAAO,CAAC,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IAIzF,4DAA4D;IACtD,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,QAAQ,CAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IAIlI,sCAAsC;IAChC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CAGpF"}

package/dist/collection.js

@@ -0,0 +1,87 @@
+import { request } from "./http.js";
+import { SapixNotFoundError } from "./errors.js";
+export class CollectionQuery {
+    constructor(config, name, asOfTimestamp) {
+        this.config = config;
+        this.name = name;
+        this.asOfTimestamp = asOfTimestamp;
+    }
+    /** Fetch all versions matching filter (full history). */
+    async all(options = {}) {
+        return this._query({ ...options, latest: false });
+    }
+    /** Fetch only the latest version of each matching record. */
+    async latest(options = {}) {
+        return this._query({ ...options, latest: true });
+    }
+    /** Find records matching a filter, latest version only. */
+    async find(filter, options = {}) {
+        return this._query({ filter, latest: true, ...options });
+    }
+    /** Find one record matching a filter, or null. */
+    async findOne(filter) {
+        const results = await this.find(filter, { limit: 1 });
+        return results[0] ?? null;
+    }
+    async _query(options) {
+        const body = {
+            collection: this.name,
+            ...options,
+        };
+        if (this.asOfTimestamp)
+            body.as_of = this.asOfTimestamp;
+        const res = await request(this.config, "POST", `/v1/${this.config.agent}/strand/query`, body);
+        return res.results;
+    }
+}
+export class CollectionClient {
+    constructor(config, name) {
+        this.config = config;
+        this.name = name;
+    }
+    /**
+     * Return a query scoped to a specific point in time.
+     * @param timestamp ISO 8601 string, e.g. "2026-05-12T10:00:00Z"
+     */
+    asOf(timestamp) {
+        return new CollectionQuery(this.config, this.name, timestamp);
+    }
+    /** Write a new record. Every write is a new nucleotide — nothing is overwritten. */
+    async write(data) {
+        return request(this.config, "POST", `/v1/${this.config.agent}/strand/write`, { collection: this.name, data });
+    }
+    /** Write multiple records in one call. */
+    async writeBatch(records) {
+        const results = await Promise.all(records.map((data) => this.write(data)));
+        return results;
+    }
+    /** Fetch a single record by its nucleotide ID. */
+    async get(id) {
+        try {
+            return await request(this.config, "GET", `/v1/${this.config.agent}/strand/${id}`);
+        }
+        catch (err) {
+            if (err instanceof Error && "status" in err && err.status === 404) {
+                throw new SapixNotFoundError(id);
+            }
+            throw err;
+        }
+    }
+    /** Query the latest version of all records in this collection. */
+    async latest(options = {}) {
+        return new CollectionQuery(this.config, this.name).latest(options);
+    }
+    /** Query ALL versions (full history) in this collection. */
+    async history(options = {}) {
+        return new CollectionQuery(this.config, this.name).all(options);
+    }
+    /** Find records matching a filter (latest version only). */
+    async find(filter, options = {}) {
+        return new CollectionQuery(this.config, this.name).find(filter, options);
+    }
+    /** Find one record or return null. */
+    async findOne(filter) {
+        return new CollectionQuery(this.config, this.name).findOne(filter);
+    }
+}
+//# 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,12 @@
+export declare class SapixError extends Error {
+    readonly status?: number | undefined;
+    readonly code?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined);
+}
+export declare class SapixNetworkError extends SapixError {
+    constructor(cause: unknown);
+}
+export declare class SapixNotFoundError extends SapixError {
+    constructor(id: string);
+}
+//# 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;CAKhC;AAED,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,KAAK,EAAE,OAAO;CAI3B;AAED,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,EAAE,EAAE,MAAM;CAIvB"}

package/dist/errors.js

@@ -0,0 +1,21 @@
+export class SapixError extends Error {
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "SapixError";
+    }
+}
+export class SapixNetworkError extends SapixError {
+    constructor(cause) {
+        super(`Network error: ${cause instanceof Error ? cause.message : String(cause)}`);
+        this.name = "SapixNetworkError";
+    }
+}
+export class SapixNotFoundError extends SapixError {
+    constructor(id) {
+        super(`Record not found: ${id}`, 404, "NOT_FOUND");
+        this.name = "SapixNotFoundError";
+    }
+}
+//# 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;IACnC,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;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAC/C,YAAY,KAAc;QACxB,KAAK,CAAC,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,EAAU;QACpB,KAAK,CAAC,qBAAqB,EAAE,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/graph.d.ts

@@ -0,0 +1,28 @@
+import type { SapixClientConfig, GraphEdgeInput, GraphEdge, TraverseOptions, TraverseResult, NucleotideRecord } from "./types.js";
+export declare class GraphClient {
+    private readonly config;
+    constructor(config: SapixClientConfig);
+    /** Create a directed edge between two records. */
+    addEdge(edge: GraphEdgeInput): Promise<void>;
+    /** Remove an edge between two records. */
+    removeEdge(src: string, dst: string, edge_type: string): Promise<void>;
+    /**
+     * Traverse the graph from a starting node.
+     * Returns all reachable nodes and the edges connecting them.
+     */
+    traverse(fromId: string, options?: TraverseOptions): Promise<TraverseResult>;
+    /** Get all direct neighbours of a node. */
+    neighbors(id: string, direction?: "outbound" | "inbound" | "both"): Promise<NucleotideRecord[]>;
+    /** Get all outbound edges from a node. */
+    edges(id: string): Promise<GraphEdge[]>;
+    /**
+     * Connect two records with a typed relationship.
+     * Convenience wrapper around addEdge.
+     *
+     * @example
+     * await db.graph.relate(orderId, customerId, "placed_by");
+     * await db.graph.relate(productId, categoryId, "belongs_to");
+     */
+    relate(src: string, dst: string, type: string, weight?: number): Promise<void>;
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,eAAe,EACf,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAEtD,kDAAkD;IAC5C,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD,0CAA0C;IACpC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5E;;;OAGG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC;IAS1B,2CAA2C;IACrC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,UAAU,GAAG,SAAS,GAAG,MAAmB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKjH,0CAA0C;IACpC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAK7C;;;;;;;OAOG;IACG,MAAM,CACV,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,SAAM,GACX,OAAO,CAAC,IAAI,CAAC;CAGjB"}

package/dist/graph.js

@@ -0,0 +1,44 @@
+import { request } from "./http.js";
+export class GraphClient {
+    constructor(config) {
+        this.config = config;
+    }
+    /** Create a directed edge between two records. */
+    async addEdge(edge) {
+        await request(this.config, "POST", `/v1/${this.config.agent}/graph/edge`, { ...edge, weight: edge.weight ?? 1.0 });
+    }
+    /** Remove an edge between two records. */
+    async removeEdge(src, dst, edge_type) {
+        await request(this.config, "DELETE", `/v1/${this.config.agent}/graph/edge`, { src, dst, edge_type });
+    }
+    /**
+     * Traverse the graph from a starting node.
+     * Returns all reachable nodes and the edges connecting them.
+     */
+    async traverse(fromId, options = {}) {
+        const { depth = 1, direction = "outbound" } = options;
+        return request(this.config, "GET", `/v1/${this.config.agent}/graph/traverse/${fromId}?depth=${depth}&direction=${direction}`);
+    }
+    /** Get all direct neighbours of a node. */
+    async neighbors(id, direction = "outbound") {
+        const result = await this.traverse(id, { depth: 1, direction });
+        return result.nodes;
+    }
+    /** Get all outbound edges from a node. */
+    async edges(id) {
+        const result = await this.traverse(id, { depth: 1 });
+        return result.edges;
+    }
+    /**
+     * Connect two records with a typed relationship.
+     * Convenience wrapper around addEdge.
+     *
+     * @example
+     * await db.graph.relate(orderId, customerId, "placed_by");
+     * await db.graph.relate(productId, categoryId, "belongs_to");
+     */
+    async relate(src, dst, type, weight = 1.0) {
+        return this.addEdge({ src, dst, edge_type: type, weight });
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,MAAM,OAAO,WAAW;IACtB,YAA6B,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAE1D,kDAAkD;IAClD,KAAK,CAAC,OAAO,CAAC,IAAoB;QAChC,MAAM,OAAO,CACX,IAAI,CAAC,MAAM,EACX,MAAM,EACN,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,aAAa,EACrC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE,CACxC,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,GAAW,EAAE,SAAiB;QAC1D,MAAM,OAAO,CACX,IAAI,CAAC,MAAM,EACX,QAAQ,EACR,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,aAAa,EACrC,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,CACxB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CACZ,MAAc,EACd,UAA2B,EAAE;QAE7B,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,SAAS,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;QACtD,OAAO,OAAO,CACZ,IAAI,CAAC,MAAM,EACX,KAAK,EACL,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,mBAAmB,MAAM,UAAU,KAAK,cAAc,SAAS,EAAE,CAC1F,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,SAAS,CAAC,EAAU,EAAE,YAA6C,UAAU;QACjF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAChE,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,KAAK,CAAC,EAAU;QACpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,GAAW,EACX,GAAW,EACX,IAAY,EACZ,MAAM,GAAG,GAAG;QAEZ,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/http.d.ts

@@ -0,0 +1,3 @@
+import type { SapixClientConfig } from "./types.js";
+export declare function request<T>(config: SapixClientConfig, method: string, path: string, body?: unknown): Promise<T>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,CAAC,CAAC,CAqCZ"}

package/dist/http.js

@@ -0,0 +1,42 @@
+import { SapixError, SapixNetworkError } from "./errors.js";
+export async function request(config, method, path, body) {
+    const url = `${config.url}${path}`;
+    const headers = {
+        "Content-Type": "application/json",
+        ...config.headers,
+    };
+    let res;
+    try {
+        const opts = { method, headers };
+        if (body !== undefined)
+            opts.body = JSON.stringify(body);
+        if (config.timeout) {
+            const ac = new AbortController();
+            const timer = setTimeout(() => ac.abort(), config.timeout);
+            opts.signal = ac.signal;
+            res = await fetch(url, opts);
+            clearTimeout(timer);
+        }
+        else {
+            res = await fetch(url, opts);
+        }
+    }
+    catch (err) {
+        throw new SapixNetworkError(err);
+    }
+    if (!res.ok) {
+        let message = `HTTP ${res.status}`;
+        let code;
+        try {
+            const body = await res.json();
+            if (body.error)
+                message = body.error;
+            if (body.code)
+                code = body.code;
+        }
+        catch { /* ignore parse error */ }
+        throw new SapixError(message, res.status, code);
+    }
+    return res.json();
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG5D,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAyB,EACzB,MAAc,EACd,IAAY,EACZ,IAAc;IAEd,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;IACnC,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,GAAG,MAAM,CAAC,OAAO;KAClB,CAAC;IAEF,IAAI,GAAa,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC9C,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAEzD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;YACxB,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7B,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,IAAI,OAAO,GAAG,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QACnC,IAAI,IAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAuC,CAAC;YACnE,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC;YACrC,IAAI,IAAI,CAAC,IAAI;gBAAE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC,CAAC,wBAAwB,CAAC,CAAC;QACpC,MAAM,IAAI,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;AAClC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { SapixClient } from "./client.js";
+export { CollectionClient, CollectionQuery } from "./collection.js";
+export { GraphClient } from "./graph.js";
+export { SapixError, SapixNetworkError, SapixNotFoundError } from "./errors.js";
+export type { SapixClientConfig, WriteResult, NucleotideRecord, QueryOptions, GraphEdge, GraphEdgeInput, TraverseOptions, TraverseResult, HealthResponse, IngestOptions, } from "./types.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,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { SapixClient } from "./client.js";
+export { CollectionClient, CollectionQuery } from "./collection.js";
+export { GraphClient } from "./graph.js";
+export { SapixError, SapixNetworkError, SapixNotFoundError } from "./errors.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,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+export interface SapixClientConfig {
+    /** Base URL of the SapixDB agent, e.g. "http://localhost:7475" */
+    url: string;
+    /** Agent ID set via SAPIX_AGENT_ID env var */
+    agent: string;
+    /** Optional extra headers sent with every request */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds (default: 10000) */
+    timeout?: number;
+}
+export interface WriteResult {
+    id: string;
+    hash: string;
+    prev_hash: string | null;
+    timestamp: string;
+    collection: string;
+}
+export interface NucleotideRecord<T = Record<string, unknown>> {
+    id: string;
+    data: T;
+    timestamp: string;
+    hash: string;
+    prev_hash: string | null;
+    collection: string;
+}
+export interface QueryOptions {
+    filter?: Record<string, unknown>;
+    /** Return only the latest version of each logical entity (default: true) */
+    latest?: boolean;
+    limit?: number;
+    offset?: number;
+}
+export interface TimeTravelQueryOptions extends QueryOptions {
+    as_of: string;
+}
+export interface GraphEdgeInput {
+    src: string;
+    dst: string;
+    edge_type: string;
+    weight?: number;
+}
+export interface GraphEdge extends GraphEdgeInput {
+    timestamp_hlc: number;
+}
+export interface TraverseOptions {
+    depth?: number;
+    direction?: "outbound" | "inbound" | "both";
+}
+export interface TraverseResult {
+    nodes: NucleotideRecord[];
+    edges: GraphEdge[];
+}
+export interface HealthResponse {
+    status: string;
+    agent: string;
+}
+export interface IngestOptions {
+    collection: string;
+    data: Record<string, unknown>;
+}
+export interface SapixErrorResponse {
+    error: string;
+    code?: string;
+}
+//# 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":"AAAA,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,2 @@
+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":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "sapixdb",
+  "version": "0.1.0",
+  "description": "Official JavaScript/TypeScript SDK for SapixDB — the agent-native living database",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node --experimental-vm-modules node_modules/.bin/jest"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "sapixdb",
+    "database",
+    "agent-native",
+    "ai-database",
+    "sdk",
+    "typescript"
+  ],
+  "author": "Sensart Technologies LLC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sensart/sapixdb"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}