@framers/sql-storage-adapter 0.7.7 → 0.7.8

package/dist/cjs/adapters/postgresAdapter.js

@@ -232,6 +232,34 @@ const unqualifiedCreateExtension = (statement) => {
   return name.identifier;
 };
 const asError = (value) => value instanceof Error ? value : new Error(String(value));
+const BATCH_SAVEPOINT = "storage_adapter_batch";
+const runBatchSteps = async (trx, operations) => {
+  const results = [];
+  const errors = [];
+  for (const [index, operation] of operations.entries()) {
+    await trx.exec(`SAVEPOINT ${BATCH_SAVEPOINT}`);
+    let result;
+    try {
+      result = await trx.run(operation.statement, operation.parameters);
+    } catch (error) {
+      await trx.exec(`ROLLBACK TO SAVEPOINT ${BATCH_SAVEPOINT}`);
+      await trx.exec(`RELEASE SAVEPOINT ${BATCH_SAVEPOINT}`);
+      errors.push({ index, error: asError(error) });
+      continue;
+    }
+    await trx.exec(`RELEASE SAVEPOINT ${BATCH_SAVEPOINT}`);
+    results.push(result);
+  }
+  return { successful: results.length, failed: errors.length, results, errors };
+};
+const batchInOwnTransaction = async (transaction, operations) => {
+  try {
+    return await transaction((trx) => runBatchSteps(trx, operations));
+  } catch (error) {
+    return { successful: 0, failed: operations.length, errors: [{ index: -1, error: asError(error) }] };
+  }
+};
+const TRANSACTION_ALREADY_OPEN = "A transaction is already open on this connection. Run its statements through the handle its callback receives.";
 const keepRollbackError = (error, rollbackError) => {
   if (typeof error !== "object" || error === null || !Object.isExtensible(error))
     return;
@@ -469,6 +497,17 @@ class PostgresTransactionAdapter {
       return this.afterEnd.transaction(fn);
     return fn(this);
   }
+  /**
+   * Runs the operations inside this transaction, each under a savepoint, going
+   * on past one that fails; the ones that succeed commit or roll back with the
+   * transaction. After the transaction has ended, the batch runs in a
+   * transaction of its own where afterEnd runs it.
+   */
+  async batch(operations) {
+    if (this.ended)
+      return batchInOwnTransaction((fn) => this.afterEnd.transaction(fn), operations);
+    return runBatchSteps(this, operations);
+  }
   async close() {
   }
   /** @internal runTransaction() calls this when the transaction has ended. */
@@ -536,9 +575,8 @@ class PostgresConnectionAdapter {
   async transaction(fn, options) {
     const begin = beginStatement(options);
     const client = this.live();
-    if (this.transactionOpen) {
-      throw new Error("A transaction is already open on this connection. Run its statements through the handle its callback receives.");
-    }
+    if (this.transactionOpen)
+      throw new Error(TRANSACTION_ALREADY_OPEN);
     this.transactionOpen = true;
     try {
       return await runTransaction(client, begin, fn, this.capabilities, this.segment, this, this.onBroken);
@@ -546,6 +584,16 @@ class PostgresConnectionAdapter {
       this.transactionOpen = false;
     }
   }
+  /**
+   * Runs the operations in one transaction on this connection, as the
+   * adapter's batch() does on the pool.
+   */
+  async batch(operations) {
+    this.live();
+    if (this.transactionOpen)
+      throw new Error(TRANSACTION_ALREADY_OPEN);
+    return batchInOwnTransaction((fn) => this.transaction(fn), operations);
+  }
   async close() {
   }
   /** @internal withConnection() calls this when the callback ends. */
@@ -575,8 +623,10 @@ class PostgresAdapter {
       // Native JSON/JSONB support
       "arrays",
       // Native array data types
-      "prepared"
+      "prepared",
       // Prepared statements for security/performance
+      "batch"
+      // batch(): one transaction, a savepoint per operation
     ]);
     this.pool = null;
     this.pgModule = null;
@@ -827,6 +877,18 @@ class PostgresAdapter {
       client.release(releaseError ?? connection.brokenBy ?? watch.failure());
     }
   }
+  /**
+   * Runs the operations in one transaction, going on past one that fails, as
+   * the better-sqlite3 adapter's batch does. Each operation runs under a
+   * savepoint, since a failed statement aborts a PostgreSQL transaction; a
+   * failure rolls back to it and is reported with its index in `errors`. The
+   * operations that succeed commit together. When the transaction itself
+   * fails, nothing commits and the error is reported at index -1.
+   */
+  async batch(operations) {
+    this.requirePool();
+    return batchInOwnTransaction((fn) => this.transaction(fn), operations);
+  }
   /**
    * The pool's counts, or null when the adapter is not open. A pool of the
    * caller's that does not count its connections, as pg's Pool does, reads 0.

package/dist/cjs/adapters/sqlJsAdapter.d.ts

@@ -1,5 +1,6 @@
 import type { SqlJsConfig } from 'sql.js';
 import type { StorageAdapter, StorageCapability, StorageOpenOptions, StorageParameters, StorageRunResult } from '../core/contracts/index.js';
+import { type SqlFunction, type SqlFunctionOptions } from '../shared/sqlFunctions.js';
 /** sql.js's own configuration (`locateFile` and the rest), and the adapter's segment. */
 export type SqlJsAdapterOptions = SqlJsConfig & {
     /**
@@ -20,6 +21,8 @@ export declare class SqlJsAdapter implements StorageAdapter {
     private filePath?;
     /** Foreign-key enforcement as open() was asked for it (undefined: the engine default); sql.js forgets the PRAGMA when export() reopens the connection. */
     private foreignKeys;
+    /** The functions registerFunction made callable from SQL, registered again after each reopening. */
+    private readonly sqlFunctions;
     private readonly runSerializedTransaction;
     /**
      * Open transaction depth. > 0 means a SQLite-level transaction is in
@@ -52,6 +55,12 @@ export declare class SqlJsAdapter implements StorageAdapter {
     private ensureOpen;
     /** Applies the connection settings open() was asked for: sql.js loses them whenever export() reopens the connection. */
     private applyConnectionSettings;
+    /**
+     * Makes a JavaScript function callable from SQL under `name`. It is
+     * registered again whenever sql.js reopens the connection (each save to a
+     * file), which drops the functions it had.
+     */
+    registerFunction(name: string, fn: SqlFunction, _options?: SqlFunctionOptions): void;
     private persistIfNeeded;
 }
 /**

package/dist/cjs/adapters/sqlJsAdapter.js

@@ -36,6 +36,7 @@ var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
 var import_parameterUtils = require("../shared/parameterUtils.js");
 var import_sqlPlaceholders = require("../shared/sqlPlaceholders.js");
+var import_sqlFunctions = require("../shared/sqlFunctions.js");
 var import_serializedTransaction = require("../shared/serializedTransaction.js");
 var import_segment = require("../shared/segment.js");
 const normaliseRowId = (value) => {
@@ -59,6 +60,7 @@ class SqlJsAdapter {
     this.kind = "sqljs";
     this.SQL = null;
     this.db = null;
+    this.sqlFunctions = /* @__PURE__ */ new Map();
     this.runSerializedTransaction = (0, import_serializedTransaction.createSerializedTransactionRunner)();
     this.transactionDepth = 0;
     const { segment, ...sqlJsConfig } = adapterOptions;
@@ -227,6 +229,19 @@ class SqlJsAdapter {
     if (this.foreignKeys !== void 0) {
       this.db.run(`PRAGMA foreign_keys = ${this.foreignKeys ? "ON" : "OFF"};`);
     }
+    for (const [name, fn] of this.sqlFunctions) {
+      this.db.create_function(name, fn);
+    }
+  }
+  /**
+   * Makes a JavaScript function callable from SQL under `name`. It is
+   * registered again whenever sql.js reopens the connection (each save to a
+   * file), which drops the functions it had.
+   */
+  registerFunction(name, fn, _options = {}) {
+    this.sqlFunctions.set((0, import_sqlFunctions.checkFunctionName)(name), fn);
+    if (this.db)
+      this.db.create_function(name, fn);
   }
   async persistIfNeeded() {
     if (!this.filePath || !hasFsAccess()) {

package/dist/cjs/core/contracts/index.d.ts

@@ -220,6 +220,32 @@ export interface StorageAdapter {
      * @throws {Error} If adapter doesn't support prepared statements
      */
     prepare?<T = unknown>(statement: string): PreparedStatement<T>;
+    /**
+     * Makes a JavaScript function callable from SQL under `name` (if supported:
+     * the better-sqlite3, sql.js and IndexedDB adapters). The function takes as
+     * many arguments as it declares (`fn.length`).
+     *
+     * @param name - An identifier: letters, digits and underscores
+     * @param fn - The function; SQL values arrive as its arguments
+     * @param options - `deterministic` (better-sqlite3)
+     * @throws {Error} If the name is not an identifier
+     * @example
+     * db.registerFunction?.('slugify', (title) => String(title).toLowerCase(), { deterministic: true });
+     * const rows = await db.all('SELECT slugify(title) AS slug FROM posts');
+     */
+    registerFunction?(name: string, fn: SqlFunction, options?: SqlFunctionOptions): void;
+}
+/** A JavaScript function SQL can call (see `StorageAdapter.registerFunction`). */
+export type SqlFunction = (...args: unknown[]) => unknown;
+/** Options for `StorageAdapter.registerFunction`. */
+export interface SqlFunctionOptions {
+    /**
+     * The function returns the same result for the same arguments, which SQLite
+     * requires of a function in an expression index, a partial index or a
+     * generated column. better-sqlite3 takes it; sql.js registers every function
+     * as non-deterministic.
+     */
+    deterministic?: boolean;
 }
 /**
  * Prepared statement interface for repeated query execution.

package/dist/cjs/core/portable.d.ts

@@ -21,6 +21,7 @@ export { isUniqueViolation } from '../shared/errors.js';
 export { withHooks } from '../shared/withHooks.js';
 export { setStorageLogger, getStorageLogger, type StorageLogger } from '../shared/logger.js';
 export * from '../features/migrations/schemaMigrations.js';
+export * from '../features/migrations/ensureColumnExists.js';
 export * from '../features/auth/authJsAdapter.js';
 export * from '../shared/parameterUtils.js';
 //# sourceMappingURL=portable.d.ts.map

package/dist/cjs/core/portable.js

@@ -49,6 +49,7 @@ var import_errors = require("../shared/errors.js");
 var import_withHooks = require("../shared/withHooks.js");
 var import_logger = require("../shared/logger.js");
 __reExport(portable_exports, require("../features/migrations/schemaMigrations.js"), module.exports);
+__reExport(portable_exports, require("../features/migrations/ensureColumnExists.js"), module.exports);
 __reExport(portable_exports, require("../features/auth/authJsAdapter.js"), module.exports);
 __reExport(portable_exports, require("../shared/parameterUtils.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
@@ -69,6 +70,7 @@ __reExport(portable_exports, require("../shared/parameterUtils.js"), module.expo
   withHooks,
   ...require("../types/index.js"),
   ...require("../features/migrations/schemaMigrations.js"),
+  ...require("../features/migrations/ensureColumnExists.js"),
   ...require("../features/auth/authJsAdapter.js"),
   ...require("../shared/parameterUtils.js")
 });

package/dist/cjs/features/migrations/ensureColumnExists.d.ts

@@ -0,0 +1,14 @@
+import type { StorageAdapter } from '../../core/contracts/index.js';
+/**
+ * Adds `column` to `table` with `definition` (its type and constraints, as
+ * SQL: `TEXT NOT NULL DEFAULT 'none'`) when the table lacks it, on PostgreSQL
+ * or SQLite. Resolves true when it added the column and false when the table
+ * had it. The table may be schema-qualified on PostgreSQL (`app.notes`).
+ *
+ * @example
+ * ```typescript
+ * await ensureColumnExists(db, 'notes', 'archived_at', d.columnType('timestamp'));
+ * ```
+ */
+export declare function ensureColumnExists(db: StorageAdapter, table: string, column: string, definition: string): Promise<boolean>;
+//# sourceMappingURL=ensureColumnExists.d.ts.map

package/dist/cjs/features/migrations/ensureColumnExists.js

@@ -0,0 +1,54 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ensureColumnExists_exports = {};
+__export(ensureColumnExists_exports, {
+  ensureColumnExists: () => ensureColumnExists
+});
+module.exports = __toCommonJS(ensureColumnExists_exports);
+var import_features = require("../../core/contracts/features.js");
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const checkIdentifier = (what, value) => {
+  if (typeof value !== "string" || !IDENTIFIER.test(value)) {
+    throw new Error(`The ${what} must be an SQL identifier (letters, digits and underscores); got ${JSON.stringify(value)}.`);
+  }
+  return value;
+};
+async function ensureColumnExists(db, table, column, definition) {
+  const dialect = (0, import_features.createStorageFeatures)(db).dialect.name;
+  const parts = typeof table === "string" ? table.split(".") : [table];
+  const schema = dialect === "postgres" && parts.length === 2 ? checkIdentifier("schema", parts[0]) : null;
+  const name = checkIdentifier("table name", schema ? parts[1] : table);
+  checkIdentifier("column name", column);
+  if (dialect === "postgres") {
+    const found = await db.get(`SELECT 1 AS found FROM information_schema.columns
+       WHERE table_schema = COALESCE(?, current_schema()) AND table_name = lower(?) AND column_name = lower(?)`, [schema ? schema.toLowerCase() : null, name, column]);
+    if (found)
+      return false;
+    await db.exec(`ALTER TABLE ${schema ? `${schema}.` : ""}${name} ADD COLUMN IF NOT EXISTS ${column} ${definition}`);
+    return true;
+  }
+  const columns = await db.all("SELECT name FROM pragma_table_info(?)", [name]);
+  if (columns.some((existing) => existing.name.toLowerCase() === column.toLowerCase()))
+    return false;
+  await db.exec(`ALTER TABLE ${name} ADD COLUMN ${column} ${definition}`);
+  return true;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ensureColumnExists
+});

package/dist/cjs/index.d.ts

@@ -13,6 +13,7 @@ export * from './features/migrations/dataExport.js';
 export * from './features/migrations/dataImport.js';
 export * from './features/migrations/migration.js';
 export * from './features/migrations/schemaMigrations.js';
+export * from './features/migrations/ensureColumnExists.js';
 export * from './features/auth/authJsAdapter.js';
 export * from './features/sync/syncManager.js';
 export * from './shared/parameterUtils.js';

package/dist/cjs/index.js

@@ -52,6 +52,7 @@ __reExport(dist_exports, require("./features/migrations/dataExport.js"), module.
 __reExport(dist_exports, require("./features/migrations/dataImport.js"), module.exports);
 __reExport(dist_exports, require("./features/migrations/migration.js"), module.exports);
 __reExport(dist_exports, require("./features/migrations/schemaMigrations.js"), module.exports);
+__reExport(dist_exports, require("./features/migrations/ensureColumnExists.js"), module.exports);
 __reExport(dist_exports, require("./features/auth/authJsAdapter.js"), module.exports);
 __reExport(dist_exports, require("./features/sync/syncManager.js"), module.exports);
 __reExport(dist_exports, require("./shared/parameterUtils.js"), module.exports);
@@ -103,6 +104,7 @@ var import_logger = require("./shared/logger.js");
   ...require("./features/migrations/dataImport.js"),
   ...require("./features/migrations/migration.js"),
   ...require("./features/migrations/schemaMigrations.js"),
+  ...require("./features/migrations/ensureColumnExists.js"),
   ...require("./features/auth/authJsAdapter.js"),
   ...require("./features/sync/syncManager.js"),
   ...require("./shared/parameterUtils.js")

package/dist/cjs/shared/sqlFunctions.d.ts

@@ -0,0 +1,5 @@
+import type { SqlFunction, SqlFunctionOptions } from '../core/contracts/index.js';
+export type { SqlFunction, SqlFunctionOptions };
+/** Checks a SQL function name. */
+export declare const checkFunctionName: (name: string) => string;
+//# sourceMappingURL=sqlFunctions.d.ts.map

package/dist/cjs/shared/sqlFunctions.js

@@ -0,0 +1,33 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var sqlFunctions_exports = {};
+__export(sqlFunctions_exports, {
+  checkFunctionName: () => checkFunctionName
+});
+module.exports = __toCommonJS(sqlFunctions_exports);
+const FUNCTION_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const checkFunctionName = (name) => {
+  if (typeof name !== "string" || !FUNCTION_NAME.test(name)) {
+    throw new Error(`A SQL function name must be an identifier (letters, digits and underscores); got ${JSON.stringify(name)}.`);
+  }
+  return name;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  checkFunctionName
+});

package/dist/core/contracts/index.d.ts

@@ -220,6 +220,32 @@ export interface StorageAdapter {
      * @throws {Error} If adapter doesn't support prepared statements
      */
     prepare?<T = unknown>(statement: string): PreparedStatement<T>;
+    /**
+     * Makes a JavaScript function callable from SQL under `name` (if supported:
+     * the better-sqlite3, sql.js and IndexedDB adapters). The function takes as
+     * many arguments as it declares (`fn.length`).
+     *
+     * @param name - An identifier: letters, digits and underscores
+     * @param fn - The function; SQL values arrive as its arguments
+     * @param options - `deterministic` (better-sqlite3)
+     * @throws {Error} If the name is not an identifier
+     * @example
+     * db.registerFunction?.('slugify', (title) => String(title).toLowerCase(), { deterministic: true });
+     * const rows = await db.all('SELECT slugify(title) AS slug FROM posts');
+     */
+    registerFunction?(name: string, fn: SqlFunction, options?: SqlFunctionOptions): void;
+}
+/** A JavaScript function SQL can call (see `StorageAdapter.registerFunction`). */
+export type SqlFunction = (...args: unknown[]) => unknown;
+/** Options for `StorageAdapter.registerFunction`. */
+export interface SqlFunctionOptions {
+    /**
+     * The function returns the same result for the same arguments, which SQLite
+     * requires of a function in an expression index, a partial index or a
+     * generated column. better-sqlite3 takes it; sql.js registers every function
+     * as non-deterministic.
+     */
+    deterministic?: boolean;
 }
 /**
  * Prepared statement interface for repeated query execution.

package/dist/core/contracts/index.d.ts.map

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

package/dist/core/contracts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsQH;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe,EAAW,SAAoB,EAAE;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,WAAM,GAAN,MAAM,CAAgB;QAE1D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E;;;GAGG;AACH,cAAc,eAAe,CAAC;AAE9B;;;GAGG;AACH,cAAc,SAAS,CAAC;AAQxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmSH;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe,EAAW,SAAoB,EAAE;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,WAAM,GAAN,MAAM,CAAgB;QAE1D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E;;;GAGG;AACH,cAAc,eAAe,CAAC;AAE9B;;;GAGG;AACH,cAAc,SAAS,CAAC;AAQxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/core/portable.d.ts

@@ -21,6 +21,7 @@ export { isUniqueViolation } from '../shared/errors.js';
 export { withHooks } from '../shared/withHooks.js';
 export { setStorageLogger, getStorageLogger, type StorageLogger } from '../shared/logger.js';
 export * from '../features/migrations/schemaMigrations.js';
+export * from '../features/migrations/ensureColumnExists.js';
 export * from '../features/auth/authJsAdapter.js';
 export * from '../shared/parameterUtils.js';
 //# sourceMappingURL=portable.d.ts.map

package/dist/core/portable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portable.d.ts","sourceRoot":"","sources":["../../src/core/portable.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC1F,cAAc,yCAAyC,CAAC;AACxD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"portable.d.ts","sourceRoot":"","sources":["../../src/core/portable.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC1F,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC"}

package/dist/core/portable.js

@@ -21,6 +21,7 @@ export { isUniqueViolation } from '../shared/errors.js';
 export { withHooks } from '../shared/withHooks.js';
 export { setStorageLogger, getStorageLogger } from '../shared/logger.js';
 export * from '../features/migrations/schemaMigrations.js';
+export * from '../features/migrations/ensureColumnExists.js';
 export * from '../features/auth/authJsAdapter.js';
 export * from '../shared/parameterUtils.js';
 //# sourceMappingURL=portable.js.map

package/dist/core/portable.js.map

@@ -1 +1 @@
-{"version":3,"file":"portable.js","sourceRoot":"","sources":["../../src/core/portable.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AAC1F,cAAc,yCAAyC,CAAC;AACxD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"portable.js","sourceRoot":"","sources":["../../src/core/portable.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AAC1F,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC"}

package/dist/features/migrations/ensureColumnExists.d.ts

@@ -0,0 +1,14 @@
+import type { StorageAdapter } from '../../core/contracts/index.js';
+/**
+ * Adds `column` to `table` with `definition` (its type and constraints, as
+ * SQL: `TEXT NOT NULL DEFAULT 'none'`) when the table lacks it, on PostgreSQL
+ * or SQLite. Resolves true when it added the column and false when the table
+ * had it. The table may be schema-qualified on PostgreSQL (`app.notes`).
+ *
+ * @example
+ * ```typescript
+ * await ensureColumnExists(db, 'notes', 'archived_at', d.columnType('timestamp'));
+ * ```
+ */
+export declare function ensureColumnExists(db: StorageAdapter, table: string, column: string, definition: string): Promise<boolean>;
+//# sourceMappingURL=ensureColumnExists.d.ts.map

package/dist/features/migrations/ensureColumnExists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureColumnExists.d.ts","sourceRoot":"","sources":["../../../src/features/migrations/ensureColumnExists.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAY3D;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBhI"}

package/dist/features/migrations/ensureColumnExists.js

@@ -0,0 +1,40 @@
+import { createStorageFeatures } from '../../core/contracts/features.js';
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const checkIdentifier = (what, value) => {
+    if (typeof value !== 'string' || !IDENTIFIER.test(value)) {
+        throw new Error(`The ${what} must be an SQL identifier (letters, digits and underscores); got ${JSON.stringify(value)}.`);
+    }
+    return value;
+};
+/**
+ * Adds `column` to `table` with `definition` (its type and constraints, as
+ * SQL: `TEXT NOT NULL DEFAULT 'none'`) when the table lacks it, on PostgreSQL
+ * or SQLite. Resolves true when it added the column and false when the table
+ * had it. The table may be schema-qualified on PostgreSQL (`app.notes`).
+ *
+ * @example
+ * ```typescript
+ * await ensureColumnExists(db, 'notes', 'archived_at', d.columnType('timestamp'));
+ * ```
+ */
+export async function ensureColumnExists(db, table, column, definition) {
+    const dialect = createStorageFeatures(db).dialect.name;
+    const parts = typeof table === 'string' ? table.split('.') : [table];
+    const schema = dialect === 'postgres' && parts.length === 2 ? checkIdentifier('schema', parts[0]) : null;
+    const name = checkIdentifier('table name', schema ? parts[1] : table);
+    checkIdentifier('column name', column);
+    if (dialect === 'postgres') {
+        const found = await db.get(`SELECT 1 AS found FROM information_schema.columns
+       WHERE table_schema = COALESCE(?, current_schema()) AND table_name = lower(?) AND column_name = lower(?)`, [schema ? schema.toLowerCase() : null, name, column]);
+        if (found)
+            return false;
+        await db.exec(`ALTER TABLE ${schema ? `${schema}.` : ''}${name} ADD COLUMN IF NOT EXISTS ${column} ${definition}`);
+        return true;
+    }
+    const columns = await db.all('SELECT name FROM pragma_table_info(?)', [name]);
+    if (columns.some((existing) => existing.name.toLowerCase() === column.toLowerCase()))
+        return false;
+    await db.exec(`ALTER TABLE ${name} ADD COLUMN ${column} ${definition}`);
+    return true;
+}
+//# sourceMappingURL=ensureColumnExists.js.map

package/dist/features/migrations/ensureColumnExists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureColumnExists.js","sourceRoot":"","sources":["../../../src/features/migrations/ensureColumnExists.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAE9C,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,qEAAqE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5H,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAkB,EAAE,KAAa,EAAE,MAAc,EAAE,UAAkB;IAC5G,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,OAAO,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzG,MAAM,IAAI,GAAG,eAAe,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACtE,eAAe,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAEvC,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,GAAG,CACxB;+GACyG,EACzG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CACrD,CAAC;QACF,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QACxB,MAAM,EAAE,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,6BAA6B,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;QACnH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,GAAG,CAAmB,uCAAuC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAChG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACnG,MAAM,EAAE,CAAC,IAAI,CAAC,eAAe,IAAI,eAAe,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export * from './features/migrations/dataExport.js';
 export * from './features/migrations/dataImport.js';
 export * from './features/migrations/migration.js';
 export * from './features/migrations/schemaMigrations.js';
+export * from './features/migrations/ensureColumnExists.js';
 export * from './features/auth/authJsAdapter.js';
 export * from './features/sync/syncManager.js';
 export * from './shared/parameterUtils.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAQ9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAM5C,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMjF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAQ9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAM5C,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMjF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -21,6 +21,7 @@ export * from './features/migrations/dataExport.js';
 export * from './features/migrations/dataImport.js';
 export * from './features/migrations/migration.js';
 export * from './features/migrations/schemaMigrations.js';
+export * from './features/migrations/ensureColumnExists.js';
 export * from './features/auth/authJsAdapter.js';
 export * from './features/sync/syncManager.js';
 // Note: Cross-platform sync is available via separate entry point for cleaner imports.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,cAAc,SAAS,CAAC;AAExB,8EAA8E;AAC9E,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,+EAA+E;AAC/E,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,wEAAwE;AACxE,yDAAyD;AACzD,2HAA2H;AAC3H,mEAAmE;AAEnE,+EAA+E;AAC/E,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAE5C,uFAAuF;AACvF,sFAAsF;AAEtF,+EAA+E;AAC/E,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEjF,6FAA6F;AAC7F,uGAAuG;AAEvG,iFAAiF;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAsB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,cAAc,SAAS,CAAC;AAExB,8EAA8E;AAC9E,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,+EAA+E;AAC/E,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,wEAAwE;AACxE,yDAAyD;AACzD,2HAA2H;AAC3H,mEAAmE;AAEnE,+EAA+E;AAC/E,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAE5C,uFAAuF;AACvF,sFAAsF;AAEtF,+EAA+E;AAC/E,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEjF,6FAA6F;AAC7F,uGAAuG;AAEvG,iFAAiF;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAsB,MAAM,iBAAiB,CAAC"}

package/dist/shared/sqlFunctions.d.ts

@@ -0,0 +1,5 @@
+import type { SqlFunction, SqlFunctionOptions } from '../core/contracts/index.js';
+export type { SqlFunction, SqlFunctionOptions };
+/** Checks a SQL function name. */
+export declare const checkFunctionName: (name: string) => string;
+//# sourceMappingURL=sqlFunctions.d.ts.map

package/dist/shared/sqlFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlFunctions.d.ts","sourceRoot":"","sources":["../../src/shared/sqlFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;AAIhD,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,MAKhD,CAAC"}

package/dist/shared/sqlFunctions.js

@@ -0,0 +1,9 @@
+const FUNCTION_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Checks a SQL function name. */
+export const checkFunctionName = (name) => {
+    if (typeof name !== 'string' || !FUNCTION_NAME.test(name)) {
+        throw new Error(`A SQL function name must be an identifier (letters, digits and underscores); got ${JSON.stringify(name)}.`);
+    }
+    return name;
+};
+//# sourceMappingURL=sqlFunctions.js.map

package/dist/shared/sqlFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlFunctions.js","sourceRoot":"","sources":["../../src/shared/sqlFunctions.ts"],"names":[],"mappings":"AAIA,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAEjD,kCAAkC;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAU,EAAE;IACxD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,oFAAoF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/H,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/sql-storage-adapter",
-  "version": "0.7.7",
+  "version": "0.7.8",
   "description": "Robust cross-platform SQL storage abstraction with automatic fallbacks and runtime detection",
   "type": "module",
   "main": "dist/cjs/index.js",
@@ -264,8 +264,7 @@
     "@aws-sdk/client-s3": "^3.0.0",
     "@capacitor-community/sqlite": "^6.0.0 || ^7.0.0 || ^8.0.0",
     "better-sqlite3": "^12.0.0 || ^13.0.0",
-    "electron": ">=20.0.0",
-    "pg": "^8.13.1"
+    "electron": ">=20.0.0"
   },
   "peerDependenciesMeta": {
     "@aws-sdk/client-s3": {
@@ -279,9 +278,6 @@
     },
     "electron": {
       "optional": true
-    },
-    "pg": {
-      "optional": true
     }
   }
 }