@typicalday/firegraph 0.7.0 → 0.8.0

package/dist/do-sqlite.js

@@ -0,0 +1,78 @@
+import {
+  buildSchemaStatements,
+  createSqliteBackend,
+  validateTableName
+} from "./chunk-WOAJRVHD.js";
+import {
+  createGraphClientFromBackend
+} from "./chunk-YUXOALMR.js";
+
+// src/do-sqlite.ts
+var DOSqliteExecutor = class {
+  constructor(storage) {
+    this.storage = storage;
+  }
+  async all(sql, params) {
+    return this.storage.sql.exec(sql, ...params).toArray();
+  }
+  async run(sql, params) {
+    this.storage.sql.exec(sql, ...params).toArray();
+  }
+  async batch(statements) {
+    if (statements.length === 0) return;
+    this.storage.transactionSync(() => {
+      for (const s of statements) {
+        this.storage.sql.exec(s.sql, ...s.params).toArray();
+      }
+    });
+  }
+  async transaction(fn) {
+    this.storage.sql.exec("BEGIN IMMEDIATE").toArray();
+    try {
+      const txExec = {
+        all: async (sql, params) => this.storage.sql.exec(sql, ...params).toArray(),
+        run: async (sql, params) => {
+          this.storage.sql.exec(sql, ...params).toArray();
+        }
+      };
+      const result = await fn(txExec);
+      this.storage.sql.exec("COMMIT").toArray();
+      return result;
+    } catch (err) {
+      this.storage.sql.exec("ROLLBACK").toArray();
+      throw err;
+    }
+  }
+};
+function ensureSchema(storage, table) {
+  const statements = buildSchemaStatements(table);
+  for (const sql of statements) {
+    storage.sql.exec(sql).toArray();
+  }
+}
+function createDOSqliteGraphClient(storage, options = {}) {
+  const table = options.table ?? "firegraph";
+  validateTableName(table);
+  if (options.autoMigrate !== false) {
+    ensureSchema(storage, table);
+  }
+  const executor = new DOSqliteExecutor(storage);
+  const backend = createSqliteBackend(executor, table);
+  const { table: _t, autoMigrate: _m, ...clientOptions } = options;
+  void _t;
+  void _m;
+  let metaBackend;
+  if (clientOptions.registryMode && typeof clientOptions.registryMode === "object" && clientOptions.registryMode.collection && clientOptions.registryMode.collection !== table) {
+    const metaTable = clientOptions.registryMode.collection;
+    validateTableName(metaTable);
+    if (options.autoMigrate !== false) {
+      ensureSchema(storage, metaTable);
+    }
+    metaBackend = createSqliteBackend(executor, metaTable);
+  }
+  return createGraphClientFromBackend(backend, clientOptions, metaBackend);
+}
+export {
+  createDOSqliteGraphClient
+};
+//# sourceMappingURL=do-sqlite.js.map

package/dist/do-sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/do-sqlite.ts"],"sourcesContent":["/**\n * Cloudflare Durable Object SQLite driver for firegraph.\n *\n * DO SQLite (`ctx.storage.sql`) is a synchronous API exposed inside the\n * Durable Object's single-threaded execution context. firegraph's storage\n * interface is async, so this driver wraps every call in a resolved\n * `Promise`. Interactive transactions go through `ctx.storage.transactionSync`,\n * which fully supports read-then-conditional-write — the migration write-back\n * path inside `runTransaction()` works as it does on Firestore.\n */\n\nimport { createGraphClientFromBackend } from './client.js';\nimport { createSqliteBackend } from './internal/sqlite-backend.js';\nimport type { SqliteExecutor, SqliteTxExecutor } from './internal/sqlite-executor.js';\nimport { buildSchemaStatements, validateTableName } from './internal/sqlite-schema.js';\nimport type {\n  DynamicGraphClient,\n  DynamicRegistryConfig,\n  GraphClient,\n  GraphClientOptions,\n} from './types.js';\n\n/**\n * Subset of the Durable Object SQL storage interface that firegraph depends\n * on. Typed against `ctx.storage` from `@cloudflare/workers-types` without\n * importing it.\n */\nexport interface DOSqlStorage {\n  sql: DOSqlExecutor;\n  transactionSync<T>(fn: () => T): T;\n}\n\nexport interface DOSqlExecutor {\n  exec<T = Record<string, unknown>>(sql: string, ...params: unknown[]): DOSqlCursor<T>;\n}\n\nexport interface DOSqlCursor<T> {\n  toArray(): T[];\n}\n\nexport interface DOSqliteClientOptions extends GraphClientOptions {\n  /** Table name for firegraph triples (default: `firegraph`). */\n  table?: string;\n  /** Run schema DDL on first use. Default: `true`. */\n  autoMigrate?: boolean;\n}\n\nclass DOSqliteExecutor implements SqliteExecutor {\n  constructor(private readonly storage: DOSqlStorage) {}\n\n  async all(sql: string, params: unknown[]): Promise<Record<string, unknown>[]> {\n    return this.storage.sql.exec<Record<string, unknown>>(sql, ...params).toArray();\n  }\n\n  async run(sql: string, params: unknown[]): Promise<void> {\n    this.storage.sql.exec(sql, ...params).toArray();\n  }\n\n  async batch(statements: ReadonlyArray<{ sql: string; params: unknown[] }>): Promise<void> {\n    if (statements.length === 0) return;\n    this.storage.transactionSync(() => {\n      for (const s of statements) {\n        this.storage.sql.exec(s.sql, ...s.params).toArray();\n      }\n    });\n  }\n\n  async transaction<T>(fn: (tx: SqliteTxExecutor) => Promise<T>): Promise<T> {\n    // We can't use `transactionSync` here: it requires a synchronous\n    // callback, but `fn` is async and may reject only after the sync body\n    // has already returned (and the transaction has already committed).\n    // Manual `BEGIN IMMEDIATE`/`COMMIT`/`ROLLBACK` lets us await `fn` and\n    // still roll back on rejection. `BEGIN IMMEDIATE` acquires the RESERVED\n    // lock up front so a concurrent writer can't sneak in between our reads\n    // and writes (avoids SQLITE_BUSY mid-transaction).\n    this.storage.sql.exec('BEGIN IMMEDIATE').toArray();\n    try {\n      const txExec: SqliteTxExecutor = {\n        all: async (sql: string, params: unknown[]) =>\n          this.storage.sql.exec<Record<string, unknown>>(sql, ...params).toArray(),\n        run: async (sql: string, params: unknown[]) => {\n          this.storage.sql.exec(sql, ...params).toArray();\n        },\n      };\n      const result = await fn(txExec);\n      this.storage.sql.exec('COMMIT').toArray();\n      return result;\n    } catch (err) {\n      this.storage.sql.exec('ROLLBACK').toArray();\n      throw err;\n    }\n  }\n}\n\nfunction ensureSchema(storage: DOSqlStorage, table: string): void {\n  const statements = buildSchemaStatements(table);\n  for (const sql of statements) {\n    storage.sql.exec(sql).toArray();\n  }\n}\n\nexport function createDOSqliteGraphClient(\n  storage: DOSqlStorage,\n  options: DOSqliteClientOptions & { registryMode: DynamicRegistryConfig },\n): DynamicGraphClient;\nexport function createDOSqliteGraphClient(\n  storage: DOSqlStorage,\n  options?: DOSqliteClientOptions,\n): GraphClient;\nexport function createDOSqliteGraphClient(\n  storage: DOSqlStorage,\n  options: DOSqliteClientOptions = {},\n): GraphClient | DynamicGraphClient {\n  const table = options.table ?? 'firegraph';\n  validateTableName(table);\n  if (options.autoMigrate !== false) {\n    ensureSchema(storage, table);\n  }\n\n  const executor = new DOSqliteExecutor(storage);\n  const backend = createSqliteBackend(executor, table);\n\n  const { table: _t, autoMigrate: _m, ...clientOptions } = options;\n  void _t;\n  void _m;\n\n  let metaBackend;\n  if (\n    clientOptions.registryMode &&\n    typeof clientOptions.registryMode === 'object' &&\n    clientOptions.registryMode.collection &&\n    clientOptions.registryMode.collection !== table\n  ) {\n    const metaTable = clientOptions.registryMode.collection;\n    validateTableName(metaTable);\n    if (options.autoMigrate !== false) {\n      ensureSchema(storage, metaTable);\n    }\n    metaBackend = createSqliteBackend(executor, metaTable);\n  }\n\n  return createGraphClientFromBackend(backend, clientOptions, metaBackend);\n}\n"],"mappings":";;;;;;;;;;AA+CA,IAAM,mBAAN,MAAiD;AAAA,EAC/C,YAA6B,SAAuB;AAAvB;AAAA,EAAwB;AAAA,EAErD,MAAM,IAAI,KAAa,QAAuD;AAC5E,WAAO,KAAK,QAAQ,IAAI,KAA8B,KAAK,GAAG,MAAM,EAAE,QAAQ;AAAA,EAChF;AAAA,EAEA,MAAM,IAAI,KAAa,QAAkC;AACvD,SAAK,QAAQ,IAAI,KAAK,KAAK,GAAG,MAAM,EAAE,QAAQ;AAAA,EAChD;AAAA,EAEA,MAAM,MAAM,YAA8E;AACxF,QAAI,WAAW,WAAW,EAAG;AAC7B,SAAK,QAAQ,gBAAgB,MAAM;AACjC,iBAAW,KAAK,YAAY;AAC1B,aAAK,QAAQ,IAAI,KAAK,EAAE,KAAK,GAAG,EAAE,MAAM,EAAE,QAAQ;AAAA,MACpD;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,YAAe,IAAsD;AAQzE,SAAK,QAAQ,IAAI,KAAK,iBAAiB,EAAE,QAAQ;AACjD,QAAI;AACF,YAAM,SAA2B;AAAA,QAC/B,KAAK,OAAO,KAAa,WACvB,KAAK,QAAQ,IAAI,KAA8B,KAAK,GAAG,MAAM,EAAE,QAAQ;AAAA,QACzE,KAAK,OAAO,KAAa,WAAsB;AAC7C,eAAK,QAAQ,IAAI,KAAK,KAAK,GAAG,MAAM,EAAE,QAAQ;AAAA,QAChD;AAAA,MACF;AACA,YAAM,SAAS,MAAM,GAAG,MAAM;AAC9B,WAAK,QAAQ,IAAI,KAAK,QAAQ,EAAE,QAAQ;AACxC,aAAO;AAAA,IACT,SAAS,KAAK;AACZ,WAAK,QAAQ,IAAI,KAAK,UAAU,EAAE,QAAQ;AAC1C,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAEA,SAAS,aAAa,SAAuB,OAAqB;AAChE,QAAM,aAAa,sBAAsB,KAAK;AAC9C,aAAW,OAAO,YAAY;AAC5B,YAAQ,IAAI,KAAK,GAAG,EAAE,QAAQ;AAAA,EAChC;AACF;AAUO,SAAS,0BACd,SACA,UAAiC,CAAC,GACA;AAClC,QAAM,QAAQ,QAAQ,SAAS;AAC/B,oBAAkB,KAAK;AACvB,MAAI,QAAQ,gBAAgB,OAAO;AACjC,iBAAa,SAAS,KAAK;AAAA,EAC7B;AAEA,QAAM,WAAW,IAAI,iBAAiB,OAAO;AAC7C,QAAM,UAAU,oBAAoB,UAAU,KAAK;AAEnD,QAAM,EAAE,OAAO,IAAI,aAAa,IAAI,GAAG,cAAc,IAAI;AACzD,OAAK;AACL,OAAK;AAEL,MAAI;AACJ,MACE,cAAc,gBACd,OAAO,cAAc,iBAAiB,YACtC,cAAc,aAAa,cAC3B,cAAc,aAAa,eAAe,OAC1C;AACA,UAAM,YAAY,cAAc,aAAa;AAC7C,sBAAkB,SAAS;AAC3B,QAAI,QAAQ,gBAAgB,OAAO;AACjC,mBAAa,SAAS,SAAS;AAAA,IACjC;AACA,kBAAc,oBAAoB,UAAU,SAAS;AAAA,EACvD;AAEA,SAAO,6BAA6B,SAAS,eAAe,WAAW;AACzE;","names":[]}