@form-engine-ts/storage-sqlite 7.18.1 → 8.0.1

package/README.md

@@ -28,3 +28,6 @@ const storage = createSqliteStorage({ db: executor, autoMigrate: true });
 `better-sqlite3` is only an example and is not a runtime dependency. Wrap `bun:sqlite`, libSQL, or another driver in the same `run/get/all` interface; return values may be synchronous or promises. The caller owns the database lifecycle and transaction policy.
 
 `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"`.

package/dist/index.cjs

@@ -214,6 +214,43 @@ function createSqliteStorage(options) {
         [stored.id, stored.formId, stored.formVersion, stored.locale, stored.submittedAt, JSON.stringify(stored)]
       );
     },
+    async saveSubmissionWithinLimit(submission, maxResponses, saveOptions = {}) {
+      if (!Number.isInteger(maxResponses) || maxResponses < 1)
+        throw new RangeError("maxResponses must be a positive integer.");
+      await ensureReady();
+      if (options.db.transaction === void 0)
+        throw Object.assign(new Error("SQLite transactions are required for atomic response limits."), {
+          code: "transaction_unsupported"
+        });
+      const stored = parseSubmission(submission, `input "${String(submission?.id)}"`);
+      const payloadHash = await (0, import_core.hashFormSubmissionPayload)(stored);
+      return options.db.transaction(async (db) => {
+        const existingRow = await db.get(
+          `SELECT response_id, form_id, form_version, locale, submitted_at, submission_json
+           FROM ${responsesTable} WHERE response_id = ?`,
+          [stored.id]
+        );
+        if (existingRow !== void 0) {
+          if (saveOptions.idempotent !== true) throw new Error(`A submission with ID "${stored.id}" already exists.`);
+          const existing = parseSubmissionRow(existingRow, 0);
+          const existingPayloadHash = await (0, import_core.hashFormSubmissionPayload)(existing);
+          if (existingPayloadHash === payloadHash) return { status: "duplicate", submission: existing, payloadHash };
+          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]
+        );
+        if (Number(row?.count ?? 0) >= maxResponses) return { status: "limit_reached" };
+        await db.run(
+          `INSERT INTO ${responsesTable}
+            (response_id, form_id, form_version, locale, submitted_at, submission_json)
+           VALUES (?, ?, ?, ?, ?, ?)`,
+          [stored.id, stored.formId, stored.formVersion, stored.locale, stored.submittedAt, JSON.stringify(stored)]
+        );
+        if (saveOptions.idempotent === true) return { status: "created", submission: stored, payloadHash };
+      });
+    },
     async listSubmissions(formId, formVersion, queryOptions) {
       await ensureReady();
       const conditions = ["form_id = ?"];
@@ -237,6 +274,28 @@ function createSqliteStorage(options) {
       );
       return rows.map(parseSubmissionRow);
     },
+    async countSubmissions(formId, formVersion, queryOptions) {
+      await ensureReady();
+      const conditions = ["form_id = ?"];
+      const params = [formId];
+      if (formVersion !== void 0) {
+        conditions.push("form_version = ?");
+        params.push(formVersion);
+      }
+      if (queryOptions?.since !== void 0) {
+        conditions.push("submitted_at >= ?");
+        params.push(queryOptions.since);
+      }
+      if (queryOptions?.until !== void 0) {
+        conditions.push("submitted_at <= ?");
+        params.push(queryOptions.until);
+      }
+      const row = await options.db.get(
+        `SELECT COUNT(*) AS count FROM ${responsesTable} WHERE ${conditions.join(" AND ")}`,
+        params
+      );
+      return Number(row?.count ?? 0);
+    },
     async deleteSubmission(submissionId) {
       await ensureReady();
       await options.db.run(`DELETE FROM ${responsesTable} WHERE response_id = ?`, [submissionId]);

package/dist/index.js

@@ -1,7 +1,8 @@
 // src/index.ts
 import {
   assertValidFormSchema,
-  createFormLifecycleAdapter
+  createFormLifecycleAdapter,
+  hashFormSubmissionPayload
 } from "@form-engine-ts/core";
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -193,6 +194,43 @@ function createSqliteStorage(options) {
         [stored.id, stored.formId, stored.formVersion, stored.locale, stored.submittedAt, JSON.stringify(stored)]
       );
     },
+    async saveSubmissionWithinLimit(submission, maxResponses, saveOptions = {}) {
+      if (!Number.isInteger(maxResponses) || maxResponses < 1)
+        throw new RangeError("maxResponses must be a positive integer.");
+      await ensureReady();
+      if (options.db.transaction === void 0)
+        throw Object.assign(new Error("SQLite transactions are required for atomic response limits."), {
+          code: "transaction_unsupported"
+        });
+      const stored = parseSubmission(submission, `input "${String(submission?.id)}"`);
+      const payloadHash = await hashFormSubmissionPayload(stored);
+      return options.db.transaction(async (db) => {
+        const existingRow = await db.get(
+          `SELECT response_id, form_id, form_version, locale, submitted_at, submission_json
+           FROM ${responsesTable} WHERE response_id = ?`,
+          [stored.id]
+        );
+        if (existingRow !== void 0) {
+          if (saveOptions.idempotent !== true) throw new Error(`A submission with ID "${stored.id}" already exists.`);
+          const existing = parseSubmissionRow(existingRow, 0);
+          const existingPayloadHash = await hashFormSubmissionPayload(existing);
+          if (existingPayloadHash === payloadHash) return { status: "duplicate", submission: existing, payloadHash };
+          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]
+        );
+        if (Number(row?.count ?? 0) >= maxResponses) return { status: "limit_reached" };
+        await db.run(
+          `INSERT INTO ${responsesTable}
+            (response_id, form_id, form_version, locale, submitted_at, submission_json)
+           VALUES (?, ?, ?, ?, ?, ?)`,
+          [stored.id, stored.formId, stored.formVersion, stored.locale, stored.submittedAt, JSON.stringify(stored)]
+        );
+        if (saveOptions.idempotent === true) return { status: "created", submission: stored, payloadHash };
+      });
+    },
     async listSubmissions(formId, formVersion, queryOptions) {
       await ensureReady();
       const conditions = ["form_id = ?"];
@@ -216,6 +254,28 @@ function createSqliteStorage(options) {
       );
       return rows.map(parseSubmissionRow);
     },
+    async countSubmissions(formId, formVersion, queryOptions) {
+      await ensureReady();
+      const conditions = ["form_id = ?"];
+      const params = [formId];
+      if (formVersion !== void 0) {
+        conditions.push("form_version = ?");
+        params.push(formVersion);
+      }
+      if (queryOptions?.since !== void 0) {
+        conditions.push("submitted_at >= ?");
+        params.push(queryOptions.since);
+      }
+      if (queryOptions?.until !== void 0) {
+        conditions.push("submitted_at <= ?");
+        params.push(queryOptions.until);
+      }
+      const row = await options.db.get(
+        `SELECT COUNT(*) AS count FROM ${responsesTable} WHERE ${conditions.join(" AND ")}`,
+        params
+      );
+      return Number(row?.count ?? 0);
+    },
     async deleteSubmission(submissionId) {
       await ensureReady();
       await options.db.run(`DELETE FROM ${responsesTable} WHERE response_id = ?`, [submissionId]);

package/package.json

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