@form-engine-ts/storage-sqlite 8.1.6 → 8.2.0

package/README.md

@@ -30,4 +30,5 @@ const storage = createSqliteStorage({ db: executor, autoMigrate: true });
 `autoMigrate` defaults to `false`; when enabled, idempotent table/index DDL runs lazily once. Schemas use a `(form_id, form_version)` primary key. Complete schemas and submissions are stored as JSON text alongside searchable response metadata. `listSubmissions` accepts inclusive `since`/`until` ISO 8601 boundaries and orders by timestamp then ID. Schema deletion does not cascade; form-scoped and full clears retain the configured tables.
 
 `saveSubmissionWithinLimit(submission, maxResponses, options?)` requires `SqliteExecutor.transaction` so the capacity
-check and insert commit atomically. Without it, the method throws an error with `code: "transaction_unsupported"`.
+check and insert commit atomically. `responseLimitScope: "form"` checks the total across versions. Without a transaction,
+the method throws an error with `code: "transaction_unsupported"`.

package/dist/index.cjs

@@ -81,6 +81,11 @@ function createSqliteStorage(options) {
   }
   const schemasTable = identifier(options.schemasTable, "form_schemas", "schemasTable");
   const responsesTableName = options.responsesTable ?? "form_responses";
+  const runtimeSettingsTable = identifier(
+    options.runtimeSettingsTable,
+    "form_runtime_settings",
+    "runtimeSettingsTable"
+  );
   const responsesTable = identifier(responsesTableName, "form_responses", "responsesTable");
   const responsesIndex = identifier(`${responsesTableName}_lookup_idx`, "form_responses_lookup_idx", "responsesTable");
   let migration;
@@ -102,6 +107,10 @@ function createSqliteStorage(options) {
         submitted_at TEXT NOT NULL,
         submission_json TEXT NOT NULL
       )`);
+      await options.db.run(`CREATE TABLE IF NOT EXISTS ${runtimeSettingsTable} (
+        form_id TEXT PRIMARY KEY,
+        settings_json TEXT NOT NULL
+      )`);
       await options.db.run(
         `CREATE INDEX IF NOT EXISTS ${responsesIndex} ON ${responsesTable} (form_id, submitted_at, response_id)`
       );
@@ -114,18 +123,18 @@ function createSqliteStorage(options) {
     };
     const marker = (_index) => "?";
     return {
-      resources: ["schema", "submission"],
+      resources: ["schema", "submission", "runtimeSettings"],
       async list(formId) {
         await ensureReady();
         const records = [];
-        for (const kind of ["schema", "submission"]) {
-          const table = kind === "schema" ? schemasTable : responsesTable;
+        for (const kind of ["schema", "submission", "runtimeSettings"]) {
+          const table = kind === "schema" ? schemasTable : kind === "submission" ? responsesTable : runtimeSettingsTable;
           const rows = await query(`SELECT * FROM ${table} WHERE form_id = ${marker(1)}`, [formId]);
           for (const row of rows) {
             if (!isRecord(row)) throw new TypeError("Invalid lifecycle row.");
-            const payload = row[kind === "schema" ? "schema_json" : "submission_json"];
+            const payload = row[kind === "schema" ? "schema_json" : kind === "submission" ? "submission_json" : "settings_json"];
             const value = parseJson(payload, "lifecycle");
-            const id = kind === "schema" ? JSON.stringify([row.form_id, row.form_version]) : String(row.response_id);
+            const id = kind === "schema" ? JSON.stringify([row.form_id, row.form_version]) : kind === "submission" ? String(row.response_id) : formId;
             records.push({ kind, id, value: { row, value } });
           }
         }
@@ -136,14 +145,15 @@ function createSqliteStorage(options) {
           throw new TypeError("Invalid lifecycle resource.");
         const row = resource.value.row;
         const schema = resource.kind === "schema";
-        const table = schema ? schemasTable : responsesTable;
-        const payloadColumn = schema ? "schema_json" : "submission_json";
+        const settings = resource.kind === "runtimeSettings";
+        const table = schema ? schemasTable : settings ? runtimeSettingsTable : responsesTable;
+        const payloadColumn = schema ? "schema_json" : settings ? "settings_json" : "submission_json";
         const payload = row[payloadColumn];
-        const params = schema ? [row.form_id, row.form_version] : [row.response_id, row.form_id];
-        const identity = schema ? `form_id = ${marker(1)} AND form_version = ${marker(2)}` : `response_id = ${marker(1)} AND form_id = ${marker(2)}`;
+        const params = schema ? [row.form_id, row.form_version] : settings ? [row.form_id] : [row.response_id, row.form_id];
+        const identity = schema ? `form_id = ${marker(1)} AND form_version = ${marker(2)}` : settings ? `form_id = ${marker(1)}` : `response_id = ${marker(1)} AND form_id = ${marker(2)}`;
         params.push(typeof payload === "string" ? payload : JSON.stringify(payload));
         const deleted = await query(
-          `DELETE FROM ${table} WHERE ${identity} AND ${payloadColumn} = ${marker(3)} RETURNING ${schema ? "form_id" : "response_id"}`,
+          `DELETE FROM ${table} WHERE ${identity} AND ${payloadColumn} = ${marker(params.length)} RETURNING ${schema ? "form_id" : settings ? "form_id" : "response_id"}`,
           params
         );
         if (deleted.length === 0) throw new Error("Deletion revision conflict or record disappeared.");
@@ -190,6 +200,26 @@ function createSqliteStorage(options) {
       );
       return row === void 0 ? null : parseSchemaRow(row, 0, options.schemaValidation);
     },
+    async getRuntimeSettings(formId) {
+      await ensureReady();
+      const row = await options.db.get(
+        `SELECT settings_json FROM ${runtimeSettingsTable} WHERE form_id = ?`,
+        [formId]
+      );
+      if (row === void 0) return null;
+      const settings = parseJson(row.settings_json, "runtime settings");
+      (0, import_core.assertValidFormRuntimeSettings)(settings);
+      return cloneJson(settings);
+    },
+    async saveRuntimeSettings(settings) {
+      await ensureReady();
+      (0, import_core.assertValidFormRuntimeSettings)(settings);
+      await options.db.run(
+        `INSERT INTO ${runtimeSettingsTable} (form_id, settings_json) VALUES (?, ?)
+         ON CONFLICT (form_id) DO UPDATE SET settings_json = excluded.settings_json`,
+        [settings.formId, JSON.stringify(settings)]
+      );
+    },
     async listSchemas() {
       await ensureReady();
       const rows = await options.db.all(
@@ -235,8 +265,8 @@ function createSqliteStorage(options) {
           return { status: "conflict", submissionId: stored.id, payloadHash, existingPayloadHash };
         }
         const row = await db.get(
-          `SELECT COUNT(*) AS count FROM ${responsesTable} WHERE form_id = ? AND form_version = ?`,
-          [stored.formId, stored.formVersion]
+          `SELECT COUNT(*) AS count FROM ${responsesTable} WHERE form_id = ?${saveOptions.responseLimitScope === "form" ? "" : " AND form_version = ?"}`,
+          saveOptions.responseLimitScope === "form" ? [stored.formId] : [stored.formId, stored.formVersion]
         );
         if (Number(row?.count ?? 0) >= maxResponses) return { status: "limit_reached" };
         await db.run(
@@ -305,6 +335,7 @@ function createSqliteStorage(options) {
       await ensureReady();
       await options.db.run(`DELETE FROM ${responsesTable}`);
       await options.db.run(`DELETE FROM ${schemasTable}`);
+      await options.db.run(`DELETE FROM ${runtimeSettingsTable}`);
     }
   };
 }

package/dist/index.d.cts

@@ -12,6 +12,7 @@ interface SqliteStorageOptions {
     readonly db: SqliteExecutor;
     readonly schemasTable?: string;
     readonly responsesTable?: string;
+    readonly runtimeSettingsTable?: string;
     readonly autoMigrate?: boolean;
 }
 declare function createSqliteStorage(options: SqliteStorageOptions): FormStorageAdapter;

package/dist/index.d.ts

@@ -12,6 +12,7 @@ interface SqliteStorageOptions {
     readonly db: SqliteExecutor;
     readonly schemasTable?: string;
     readonly responsesTable?: string;
+    readonly runtimeSettingsTable?: string;
     readonly autoMigrate?: boolean;
 }
 declare function createSqliteStorage(options: SqliteStorageOptions): FormStorageAdapter;

package/dist/index.js

@@ -1,5 +1,6 @@
 // src/index.ts
 import {
+  assertValidFormRuntimeSettings,
   assertValidFormSchema,
   createFormLifecycleAdapter,
   hashFormSubmissionPayload,
@@ -62,6 +63,11 @@ function createSqliteStorage(options) {
   }
   const schemasTable = identifier(options.schemasTable, "form_schemas", "schemasTable");
   const responsesTableName = options.responsesTable ?? "form_responses";
+  const runtimeSettingsTable = identifier(
+    options.runtimeSettingsTable,
+    "form_runtime_settings",
+    "runtimeSettingsTable"
+  );
   const responsesTable = identifier(responsesTableName, "form_responses", "responsesTable");
   const responsesIndex = identifier(`${responsesTableName}_lookup_idx`, "form_responses_lookup_idx", "responsesTable");
   let migration;
@@ -83,6 +89,10 @@ function createSqliteStorage(options) {
         submitted_at TEXT NOT NULL,
         submission_json TEXT NOT NULL
       )`);
+      await options.db.run(`CREATE TABLE IF NOT EXISTS ${runtimeSettingsTable} (
+        form_id TEXT PRIMARY KEY,
+        settings_json TEXT NOT NULL
+      )`);
       await options.db.run(
         `CREATE INDEX IF NOT EXISTS ${responsesIndex} ON ${responsesTable} (form_id, submitted_at, response_id)`
       );
@@ -95,18 +105,18 @@ function createSqliteStorage(options) {
     };
     const marker = (_index) => "?";
     return {
-      resources: ["schema", "submission"],
+      resources: ["schema", "submission", "runtimeSettings"],
       async list(formId) {
         await ensureReady();
         const records = [];
-        for (const kind of ["schema", "submission"]) {
-          const table = kind === "schema" ? schemasTable : responsesTable;
+        for (const kind of ["schema", "submission", "runtimeSettings"]) {
+          const table = kind === "schema" ? schemasTable : kind === "submission" ? responsesTable : runtimeSettingsTable;
           const rows = await query(`SELECT * FROM ${table} WHERE form_id = ${marker(1)}`, [formId]);
           for (const row of rows) {
             if (!isRecord(row)) throw new TypeError("Invalid lifecycle row.");
-            const payload = row[kind === "schema" ? "schema_json" : "submission_json"];
+            const payload = row[kind === "schema" ? "schema_json" : kind === "submission" ? "submission_json" : "settings_json"];
             const value = parseJson(payload, "lifecycle");
-            const id = kind === "schema" ? JSON.stringify([row.form_id, row.form_version]) : String(row.response_id);
+            const id = kind === "schema" ? JSON.stringify([row.form_id, row.form_version]) : kind === "submission" ? String(row.response_id) : formId;
             records.push({ kind, id, value: { row, value } });
           }
         }
@@ -117,14 +127,15 @@ function createSqliteStorage(options) {
           throw new TypeError("Invalid lifecycle resource.");
         const row = resource.value.row;
         const schema = resource.kind === "schema";
-        const table = schema ? schemasTable : responsesTable;
-        const payloadColumn = schema ? "schema_json" : "submission_json";
+        const settings = resource.kind === "runtimeSettings";
+        const table = schema ? schemasTable : settings ? runtimeSettingsTable : responsesTable;
+        const payloadColumn = schema ? "schema_json" : settings ? "settings_json" : "submission_json";
         const payload = row[payloadColumn];
-        const params = schema ? [row.form_id, row.form_version] : [row.response_id, row.form_id];
-        const identity = schema ? `form_id = ${marker(1)} AND form_version = ${marker(2)}` : `response_id = ${marker(1)} AND form_id = ${marker(2)}`;
+        const params = schema ? [row.form_id, row.form_version] : settings ? [row.form_id] : [row.response_id, row.form_id];
+        const identity = schema ? `form_id = ${marker(1)} AND form_version = ${marker(2)}` : settings ? `form_id = ${marker(1)}` : `response_id = ${marker(1)} AND form_id = ${marker(2)}`;
         params.push(typeof payload === "string" ? payload : JSON.stringify(payload));
         const deleted = await query(
-          `DELETE FROM ${table} WHERE ${identity} AND ${payloadColumn} = ${marker(3)} RETURNING ${schema ? "form_id" : "response_id"}`,
+          `DELETE FROM ${table} WHERE ${identity} AND ${payloadColumn} = ${marker(params.length)} RETURNING ${schema ? "form_id" : settings ? "form_id" : "response_id"}`,
           params
         );
         if (deleted.length === 0) throw new Error("Deletion revision conflict or record disappeared.");
@@ -171,6 +182,26 @@ function createSqliteStorage(options) {
       );
       return row === void 0 ? null : parseSchemaRow(row, 0, options.schemaValidation);
     },
+    async getRuntimeSettings(formId) {
+      await ensureReady();
+      const row = await options.db.get(
+        `SELECT settings_json FROM ${runtimeSettingsTable} WHERE form_id = ?`,
+        [formId]
+      );
+      if (row === void 0) return null;
+      const settings = parseJson(row.settings_json, "runtime settings");
+      assertValidFormRuntimeSettings(settings);
+      return cloneJson(settings);
+    },
+    async saveRuntimeSettings(settings) {
+      await ensureReady();
+      assertValidFormRuntimeSettings(settings);
+      await options.db.run(
+        `INSERT INTO ${runtimeSettingsTable} (form_id, settings_json) VALUES (?, ?)
+         ON CONFLICT (form_id) DO UPDATE SET settings_json = excluded.settings_json`,
+        [settings.formId, JSON.stringify(settings)]
+      );
+    },
     async listSchemas() {
       await ensureReady();
       const rows = await options.db.all(
@@ -216,8 +247,8 @@ function createSqliteStorage(options) {
           return { status: "conflict", submissionId: stored.id, payloadHash, existingPayloadHash };
         }
         const row = await db.get(
-          `SELECT COUNT(*) AS count FROM ${responsesTable} WHERE form_id = ? AND form_version = ?`,
-          [stored.formId, stored.formVersion]
+          `SELECT COUNT(*) AS count FROM ${responsesTable} WHERE form_id = ?${saveOptions.responseLimitScope === "form" ? "" : " AND form_version = ?"}`,
+          saveOptions.responseLimitScope === "form" ? [stored.formId] : [stored.formId, stored.formVersion]
         );
         if (Number(row?.count ?? 0) >= maxResponses) return { status: "limit_reached" };
         await db.run(
@@ -286,6 +317,7 @@ function createSqliteStorage(options) {
       await ensureReady();
       await options.db.run(`DELETE FROM ${responsesTable}`);
       await options.db.run(`DELETE FROM ${schemasTable}`);
+      await options.db.run(`DELETE FROM ${runtimeSettingsTable}`);
     }
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/storage-sqlite",
-  "version": "8.1.6",
+  "version": "8.2.0",
   "publishConfig": {
     "access": "public"
   },
@@ -40,10 +40,10 @@
     "typescript"
   ],
   "dependencies": {
-    "@form-engine-ts/core": "8.1.6"
+    "@form-engine-ts/core": "8.2.0"
   },
   "devDependencies": {
-    "@form-engine-ts/storage": "8.1.6"
+    "@form-engine-ts/storage": "8.2.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean --external @form-engine-ts/core",