@form-engine-ts/storage-azure-table 6.8.0 → 6.10.0

package/README.md

@@ -43,7 +43,10 @@ owns table creation, credentials, retries, and client lifecycle.
 The default codec persists the canonical `FormSubmission.values` payload and never creates an `answers` property. Set
 `rejectLegacyAnswers: true` to fail explicitly when a legacy entity is encountered; no legacy decoding or migration is
 performed. `idempotentSubmissions: true` enables typed `created`, `duplicate`, and `conflict` results from
-`saveSubmission(submission)`. Pass `validateAgainstSchema: true` to re-validate against the stored schema.
+`saveSubmission(submission)`. Pass `validateAgainstSchema: true` to re-validate against the stored schema. Pass
+`submissionSchema`, `submissionValidator`, or `validation` to validate every submission before it is written; the same
+source can be supplied per call as `saveSubmission(submission, { validation })`. A source can be a FormSchema, a
+Zod-compatible object with `safeParse`, or an async validator callback.
 
 `listTextAnswerPage` accepts either the legacy single field ID or `TextAnswerPageQueryOptions.fieldIds`. Page size counts
 emitted text items rather than entities. Its opaque Base64 JSON cursor retains the Azure continuation token plus entity

package/dist/index.cjs

@@ -521,6 +521,12 @@ function createAzureTableStorage(options = {}) {
     async saveSubmission(submission, saveOptions = {}) {
       ensureWritable();
       const stored = parseSubmission(submission, `input ${String(submission?.id)}`);
+      const explicitValidation = saveOptions.validator ?? saveOptions.validation;
+      const configuredValidation = options.submissionValidator ?? options.submissionSchema ?? options.validator ?? options.schema ?? options.validation;
+      if (explicitValidation !== void 0) await (0, import_core.assertValidFormSubmissionWith)(explicitValidation, stored);
+      if (explicitValidation === void 0 && configuredValidation !== void 0) {
+        await (0, import_core.assertValidFormSubmissionWith)(configuredValidation, stored);
+      }
       if (options.validateSubmissions === true || saveOptions.validateAgainstSchema === true) {
         const schema = parseSchemaEntity(
           await (await schemaClient(stored.formId)).getEntity(stored.formId, schemaRowKey(stored.formVersion))
@@ -741,6 +747,12 @@ function createAzureTableStorage(options = {}) {
   };
   return {
     ...adapter,
+    async fetchSubmissionPage(formId, options2) {
+      return await adapter.listSubmissionPage(
+        formId,
+        options2
+      );
+    },
     async fetchPage(formId, options2) {
       const page = await adapter.listSubmissionPage(formId, {
         ...options2?.pageSize === void 0 ? {} : { pageSize: options2.pageSize },

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { FormSubmission, BaseSubmissionMetadata, PagedSubmissionStorageAdapter, SubmissionPageQueryOptions, StrictFormSubmission, SaveSubmissionOptions, SubmissionSaveResult, SubmissionFilter, JsonValue, TextAnswerPageQueryOptions, TypedTextAnswerPage } from '@form-engine-ts/core';
+import { FormSubmission, BaseSubmissionMetadata, PagedSubmissionStorageAdapter, TypedSubmissionPageQueryOptions, TypedSubmissionPage, SubmissionPageQueryOptions, FormSubmissionValidationSource, FormSubmissionValidator, StrictFormSubmission, SaveSubmissionOptions, SubmissionSaveResult, SubmissionFilter, JsonValue, TextAnswerPageQueryOptions, TypedTextAnswerPage } from '@form-engine-ts/core';
 
 interface AzureTableListOptions {
     readonly queryOptions?: {
@@ -112,8 +112,16 @@ interface AzureTableStorageOptions<T = FormSubmission> {
     readonly idempotency?: boolean;
     /** Re-validate a submission against the stored FormSchema before saving. */
     readonly validateSubmissions?: boolean;
+    /** Validate every saved submission with an application-owned schema or callback. */
+    readonly submissionSchema?: FormSubmissionValidationSource;
+    readonly submissionValidator?: FormSubmissionValidator;
+    /** Alias for `submissionValidator`/`submissionSchema`. */
+    readonly validation?: FormSubmissionValidationSource;
+    readonly validator?: FormSubmissionValidationSource;
+    readonly schema?: FormSubmissionValidationSource;
 }
 interface AzureTableStorageAdapter<TMeta extends BaseSubmissionMetadata = BaseSubmissionMetadata> extends PagedSubmissionStorageAdapter {
+    readonly fetchSubmissionPage?: (formId: string, options?: TypedSubmissionPageQueryOptions<TMeta>) => Promise<TypedSubmissionPage<TMeta>>;
     readonly fetchPage: (formId: string, options?: {
         readonly pageSize?: number;
         readonly fromSubmittedAt?: string;
@@ -147,6 +155,7 @@ type TypedAzureTableStorageAdapter<TMeta extends BaseSubmissionMetadata | undefi
         readonly items: readonly FormSubmission<TMeta>[];
         readonly nextCursor?: string;
     }>;
+    readonly fetchSubmissionPage?: (formId: string, options?: TypedSubmissionPageQueryOptions<TMeta>) => Promise<TypedSubmissionPage<TMeta>>;
     readonly listTextAnswerPage: (formId: string, fieldIdOrOptions?: string | TextAnswerPageQueryOptions, options?: TextAnswerPageQueryOptions) => Promise<TypedTextAnswerPage<TMeta>>;
 };
 interface AzureTextAnswerCursorPayload {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { FormSubmission, BaseSubmissionMetadata, PagedSubmissionStorageAdapter, SubmissionPageQueryOptions, StrictFormSubmission, SaveSubmissionOptions, SubmissionSaveResult, SubmissionFilter, JsonValue, TextAnswerPageQueryOptions, TypedTextAnswerPage } from '@form-engine-ts/core';
+import { FormSubmission, BaseSubmissionMetadata, PagedSubmissionStorageAdapter, TypedSubmissionPageQueryOptions, TypedSubmissionPage, SubmissionPageQueryOptions, FormSubmissionValidationSource, FormSubmissionValidator, StrictFormSubmission, SaveSubmissionOptions, SubmissionSaveResult, SubmissionFilter, JsonValue, TextAnswerPageQueryOptions, TypedTextAnswerPage } from '@form-engine-ts/core';
 
 interface AzureTableListOptions {
     readonly queryOptions?: {
@@ -112,8 +112,16 @@ interface AzureTableStorageOptions<T = FormSubmission> {
     readonly idempotency?: boolean;
     /** Re-validate a submission against the stored FormSchema before saving. */
     readonly validateSubmissions?: boolean;
+    /** Validate every saved submission with an application-owned schema or callback. */
+    readonly submissionSchema?: FormSubmissionValidationSource;
+    readonly submissionValidator?: FormSubmissionValidator;
+    /** Alias for `submissionValidator`/`submissionSchema`. */
+    readonly validation?: FormSubmissionValidationSource;
+    readonly validator?: FormSubmissionValidationSource;
+    readonly schema?: FormSubmissionValidationSource;
 }
 interface AzureTableStorageAdapter<TMeta extends BaseSubmissionMetadata = BaseSubmissionMetadata> extends PagedSubmissionStorageAdapter {
+    readonly fetchSubmissionPage?: (formId: string, options?: TypedSubmissionPageQueryOptions<TMeta>) => Promise<TypedSubmissionPage<TMeta>>;
     readonly fetchPage: (formId: string, options?: {
         readonly pageSize?: number;
         readonly fromSubmittedAt?: string;
@@ -147,6 +155,7 @@ type TypedAzureTableStorageAdapter<TMeta extends BaseSubmissionMetadata | undefi
         readonly items: readonly FormSubmission<TMeta>[];
         readonly nextCursor?: string;
     }>;
+    readonly fetchSubmissionPage?: (formId: string, options?: TypedSubmissionPageQueryOptions<TMeta>) => Promise<TypedSubmissionPage<TMeta>>;
     readonly listTextAnswerPage: (formId: string, fieldIdOrOptions?: string | TextAnswerPageQueryOptions, options?: TextAnswerPageQueryOptions) => Promise<TypedTextAnswerPage<TMeta>>;
 };
 interface AzureTextAnswerCursorPayload {

package/dist/index.js

@@ -2,6 +2,7 @@
 import {
   assertValidFormSchema,
   assertValidFormSubmission,
+  assertValidFormSubmissionWith,
   hashFormSubmissionPayload,
   matchesSubmissionPageFilters,
   normalizeSubmissionPageSize
@@ -497,6 +498,12 @@ function createAzureTableStorage(options = {}) {
     async saveSubmission(submission, saveOptions = {}) {
       ensureWritable();
       const stored = parseSubmission(submission, `input ${String(submission?.id)}`);
+      const explicitValidation = saveOptions.validator ?? saveOptions.validation;
+      const configuredValidation = options.submissionValidator ?? options.submissionSchema ?? options.validator ?? options.schema ?? options.validation;
+      if (explicitValidation !== void 0) await assertValidFormSubmissionWith(explicitValidation, stored);
+      if (explicitValidation === void 0 && configuredValidation !== void 0) {
+        await assertValidFormSubmissionWith(configuredValidation, stored);
+      }
       if (options.validateSubmissions === true || saveOptions.validateAgainstSchema === true) {
         const schema = parseSchemaEntity(
           await (await schemaClient(stored.formId)).getEntity(stored.formId, schemaRowKey(stored.formVersion))
@@ -717,6 +724,12 @@ function createAzureTableStorage(options = {}) {
   };
   return {
     ...adapter,
+    async fetchSubmissionPage(formId, options2) {
+      return await adapter.listSubmissionPage(
+        formId,
+        options2
+      );
+    },
     async fetchPage(formId, options2) {
       const page = await adapter.listSubmissionPage(formId, {
         ...options2?.pageSize === void 0 ? {} : { pageSize: options2.pageSize },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/storage-azure-table",
-  "version": "6.8.0",
+  "version": "6.10.0",
   "publishConfig": {
     "access": "public"
   },
@@ -39,7 +39,7 @@
     "typescript"
   ],
   "dependencies": {
-    "@form-engine-ts/core": "6.8.0"
+    "@form-engine-ts/core": "6.10.0"
   },
   "peerDependencies": {
     "@azure/data-tables": "^13.3.2"