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

package/dist/index.cjs

@@ -48,12 +48,12 @@ function parseSubmission(value, location) {
   }
   return cloneJson(parsed);
 }
-function parseSchemaRow(value, index) {
+function parseSchemaRow(value, index, validation = {}) {
   if (!isRecord(value)) throw new Error(`SQLite schema row ${index} is invalid.`);
   const row = value;
   const schema = parseJson(row.schema_json, `schema row ${index}`);
   try {
-    (0, import_core.assertValidFormSchema)(schema);
+    (0, import_core.assertValidFormSchema)(schema, validation);
   } catch (cause) {
     throw new Error(`SQLite schema row ${index} is invalid.`, { cause });
   }
@@ -111,10 +111,72 @@ function createSqliteStorage(options) {
     })();
     await migration;
   };
+  function lifecycleBackend(client) {
+    const query = async (sql, params) => {
+      return await client.all(sql, params);
+    };
+    const marker = (_index) => "?";
+    return {
+      resources: ["schema", "submission"],
+      async list(formId) {
+        await ensureReady();
+        const records = [];
+        for (const kind of ["schema", "submission"]) {
+          const table = kind === "schema" ? schemasTable : responsesTable;
+          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 value = parseJson(payload, "lifecycle");
+            const id = kind === "schema" ? JSON.stringify([row.form_id, row.form_version]) : String(row.response_id);
+            records.push({ kind, id, value: { row, value } });
+          }
+        }
+        return records;
+      },
+      async remove(resource) {
+        if (!isRecord(resource.value) || !isRecord(resource.value.row))
+          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 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)}`;
+        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"}`,
+          params
+        );
+        if (deleted.length === 0) throw new Error("Deletion revision conflict or record disappeared.");
+        return deleted.length;
+      },
+      ...client.transaction === void 0 ? {} : {
+        transaction: (operation) => {
+          if (client.transaction === void 0) throw new Error("Transaction unavailable.");
+          return client.transaction((operationClient) => operation(lifecycleBackend(operationClient)));
+        }
+      }
+    };
+  }
+  const lifecycle = (0, import_core.createFormLifecycleAdapter)(
+    lifecycleBackend(options.db),
+    options.lifecycle === void 0 ? {} : {
+      ...options.lifecycle,
+      ...options.lifecycle.scope === void 0 ? {} : {
+        scope: (resource) => {
+          if (!isRecord(resource.value)) throw new TypeError("Invalid lifecycle resource.");
+          return options.lifecycle?.scope?.({ ...resource, value: resource.value.value }) ?? {};
+        }
+      }
+    }
+  );
   return {
+    ...lifecycle,
     async saveSchema(schema) {
       await ensureReady();
-      (0, import_core.assertValidFormSchema)(schema);
+      (0, import_core.assertValidFormSchema)(schema, options.schemaValidation);
       await options.db.run(
         `INSERT INTO ${schemasTable} (form_id, form_version, schema_json, updated_at)
          VALUES (?, ?, ?, CURRENT_TIMESTAMP)
@@ -129,14 +191,14 @@ function createSqliteStorage(options) {
         `SELECT form_id, form_version, schema_json FROM ${schemasTable} WHERE form_id = ? AND form_version = ?`,
         [formId, formVersion]
       );
-      return row === void 0 ? null : parseSchemaRow(row, 0);
+      return row === void 0 ? null : parseSchemaRow(row, 0, options.schemaValidation);
     },
     async listSchemas() {
       await ensureReady();
       const rows = await options.db.all(
         `SELECT form_id, form_version, schema_json FROM ${schemasTable} ORDER BY form_id, form_version`
       );
-      return rows.map(parseSchemaRow);
+      return rows.map((row, index) => parseSchemaRow(row, index, options.schemaValidation));
     },
     async deleteSchema(formId, formVersion) {
       await ensureReady();

package/dist/index.d.cts

@@ -1,11 +1,14 @@
-import { FormStorageAdapter } from '@form-engine-ts/core';
+import { ValidateFormSchemaOptions, FormLifecycleOptions, FormStorageAdapter } from '@form-engine-ts/core';
 
 interface SqliteExecutor {
+    readonly transaction?: <T>(operation: (db: SqliteExecutor) => Promise<T>) => Promise<T>;
     run(sql: string, params?: readonly unknown[]): Promise<void> | void;
     get<T>(sql: string, params?: readonly unknown[]): Promise<T | undefined> | T | undefined;
     all<T>(sql: string, params?: readonly unknown[]): Promise<readonly T[]> | readonly T[];
 }
 interface SqliteStorageOptions {
+    readonly schemaValidation?: ValidateFormSchemaOptions;
+    readonly lifecycle?: FormLifecycleOptions;
     readonly db: SqliteExecutor;
     readonly schemasTable?: string;
     readonly responsesTable?: string;

package/dist/index.d.ts

@@ -1,11 +1,14 @@
-import { FormStorageAdapter } from '@form-engine-ts/core';
+import { ValidateFormSchemaOptions, FormLifecycleOptions, FormStorageAdapter } from '@form-engine-ts/core';
 
 interface SqliteExecutor {
+    readonly transaction?: <T>(operation: (db: SqliteExecutor) => Promise<T>) => Promise<T>;
     run(sql: string, params?: readonly unknown[]): Promise<void> | void;
     get<T>(sql: string, params?: readonly unknown[]): Promise<T | undefined> | T | undefined;
     all<T>(sql: string, params?: readonly unknown[]): Promise<readonly T[]> | readonly T[];
 }
 interface SqliteStorageOptions {
+    readonly schemaValidation?: ValidateFormSchemaOptions;
+    readonly lifecycle?: FormLifecycleOptions;
     readonly db: SqliteExecutor;
     readonly schemasTable?: string;
     readonly responsesTable?: string;

package/dist/index.js

@@ -1,5 +1,8 @@
 // src/index.ts
-import { assertValidFormSchema } from "@form-engine-ts/core";
+import {
+  assertValidFormSchema,
+  createFormLifecycleAdapter
+} from "@form-engine-ts/core";
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -24,12 +27,12 @@ function parseSubmission(value, location) {
   }
   return cloneJson(parsed);
 }
-function parseSchemaRow(value, index) {
+function parseSchemaRow(value, index, validation = {}) {
   if (!isRecord(value)) throw new Error(`SQLite schema row ${index} is invalid.`);
   const row = value;
   const schema = parseJson(row.schema_json, `schema row ${index}`);
   try {
-    assertValidFormSchema(schema);
+    assertValidFormSchema(schema, validation);
   } catch (cause) {
     throw new Error(`SQLite schema row ${index} is invalid.`, { cause });
   }
@@ -87,10 +90,72 @@ function createSqliteStorage(options) {
     })();
     await migration;
   };
+  function lifecycleBackend(client) {
+    const query = async (sql, params) => {
+      return await client.all(sql, params);
+    };
+    const marker = (_index) => "?";
+    return {
+      resources: ["schema", "submission"],
+      async list(formId) {
+        await ensureReady();
+        const records = [];
+        for (const kind of ["schema", "submission"]) {
+          const table = kind === "schema" ? schemasTable : responsesTable;
+          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 value = parseJson(payload, "lifecycle");
+            const id = kind === "schema" ? JSON.stringify([row.form_id, row.form_version]) : String(row.response_id);
+            records.push({ kind, id, value: { row, value } });
+          }
+        }
+        return records;
+      },
+      async remove(resource) {
+        if (!isRecord(resource.value) || !isRecord(resource.value.row))
+          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 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)}`;
+        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"}`,
+          params
+        );
+        if (deleted.length === 0) throw new Error("Deletion revision conflict or record disappeared.");
+        return deleted.length;
+      },
+      ...client.transaction === void 0 ? {} : {
+        transaction: (operation) => {
+          if (client.transaction === void 0) throw new Error("Transaction unavailable.");
+          return client.transaction((operationClient) => operation(lifecycleBackend(operationClient)));
+        }
+      }
+    };
+  }
+  const lifecycle = createFormLifecycleAdapter(
+    lifecycleBackend(options.db),
+    options.lifecycle === void 0 ? {} : {
+      ...options.lifecycle,
+      ...options.lifecycle.scope === void 0 ? {} : {
+        scope: (resource) => {
+          if (!isRecord(resource.value)) throw new TypeError("Invalid lifecycle resource.");
+          return options.lifecycle?.scope?.({ ...resource, value: resource.value.value }) ?? {};
+        }
+      }
+    }
+  );
   return {
+    ...lifecycle,
     async saveSchema(schema) {
       await ensureReady();
-      assertValidFormSchema(schema);
+      assertValidFormSchema(schema, options.schemaValidation);
       await options.db.run(
         `INSERT INTO ${schemasTable} (form_id, form_version, schema_json, updated_at)
          VALUES (?, ?, ?, CURRENT_TIMESTAMP)
@@ -105,14 +170,14 @@ function createSqliteStorage(options) {
         `SELECT form_id, form_version, schema_json FROM ${schemasTable} WHERE form_id = ? AND form_version = ?`,
         [formId, formVersion]
       );
-      return row === void 0 ? null : parseSchemaRow(row, 0);
+      return row === void 0 ? null : parseSchemaRow(row, 0, options.schemaValidation);
     },
     async listSchemas() {
       await ensureReady();
       const rows = await options.db.all(
         `SELECT form_id, form_version, schema_json FROM ${schemasTable} ORDER BY form_id, form_version`
       );
-      return rows.map(parseSchemaRow);
+      return rows.map((row, index) => parseSchemaRow(row, index, options.schemaValidation));
     },
     async deleteSchema(formId, formVersion) {
       await ensureReady();

package/package.json

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