@form-engine-ts/storage-azure-table 6.9.0 → 7.0.0

package/README.md

@@ -37,12 +37,11 @@ unsupported expressions remain client-filtered with identical semantics.
 
 `listSubmissionPage` follows opaque Azure continuation tokens and scans at most `maxScanPages` native pages (default 5)
 to fill the requested logical page after client-side filtering. `buildSubmissionFilter` can replace filter generation.
-The deprecated `client`, `submissionCodec`, and `toODataFilter` options remain available for compatibility. The caller
-owns table creation, credentials, retries, and client lifecycle.
+The caller 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
+The default codec persists the canonical `FormSubmission.values` payload and never creates an `answers` property. The
+standard adapter rejects entities containing the legacy `answers` column; it does not decode or migrate them. Legacy
+codecs are available only from `@form-engine-ts/legacy`. `idempotentSubmissions: true` enables typed `created`, `duplicate`, and `conflict` results from
 `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
@@ -55,5 +54,7 @@ consume the item limit, and scanning remains bounded by `maxScanPages`. Cursor f
 version, sorted fields, and a SHA-256 filter fingerprint. Reusing a cursor with different query context throws
 `invalid_cursor_context`.
 
-The legacy codec APIs are retained only as deprecated source symbols for existing applications; the standard factory does
-not use them.
+The Azure adapter exposes the same required typed submission surface as MongoDB: `listSubmissionPage`,
+`listTextAnswerPage`, `aggregateResponses`, `exportResponsesToCsv`, `validateSubmission`, and idempotent
+`saveSubmission`. Aggregation and CSV options accept the same submission filter query, so applications do not need an
+Azure-specific reporting branch.

package/dist/index.cjs

@@ -22,88 +22,12 @@ var index_exports = {};
 __export(index_exports, {
   createAzureTableStorage: () => createAzureTableStorage,
   createAzureTableSubmissionCodec: () => createAzureTableSubmissionCodec,
-  createLegacyArrayAzureTableCodec: () => createLegacyArrayAzureTableCodec,
-  createLegacyAzureTableCodec: () => createLegacyAzureTableCodec,
   defaultAzureTableSubmissionCodec: () => defaultAzureTableSubmissionCodec,
   metadataFiltersToOData: () => metadataFiltersToOData,
   submissionFilterToOData: () => submissionFilterToOData
 });
 module.exports = __toCommonJS(index_exports);
 var import_core = require("@form-engine-ts/core");
-function createLegacyArrayAzureTableCodec(options = {}) {
-  const defaultLocale = options.defaultLocale ?? "ja";
-  if (defaultLocale.trim().length === 0) throw new TypeError("defaultLocale must not be empty.");
-  return {
-    encode: (submission) => ({
-      PartitionKey: submission.formId,
-      RowKey: submission.id,
-      answers: JSON.stringify(Object.entries(submission.values).map(([questionId, value]) => ({ questionId, value }))),
-      answeredAt: submission.submittedAt,
-      surveyVersion: submission.formVersion,
-      locale: submission.locale,
-      ...submission.metadata
-    }),
-    decode: (entity) => {
-      const raw = entity;
-      if (typeof raw.PartitionKey !== "string" || typeof raw.RowKey !== "string") {
-        throw new Error("Azure Table legacy array submission is missing PartitionKey or RowKey.");
-      }
-      const submittedAt = typeof raw.answeredAt === "string" ? raw.answeredAt : entity.Timestamp;
-      if (typeof submittedAt !== "string" || submittedAt.trim().length === 0) {
-        throw new Error("Azure Table legacy array submission is missing answeredAt or Timestamp.");
-      }
-      let values = {};
-      if (typeof raw.answers === "string") {
-        const parsed = parseJson(raw.answers, "legacy array answers");
-        if (Array.isArray(parsed)) {
-          values = Object.fromEntries(
-            parsed.flatMap((item) => {
-              if (!isRecord(item) || typeof item.questionId !== "string") return [];
-              return [[item.questionId, item.value]];
-            })
-          );
-        } else if (isRecord(parsed)) {
-          values = parsed;
-        } else {
-          throw new Error("Azure Table legacy array answers payload must be an array or object.");
-        }
-      }
-      const formVersion = Number(raw.surveyVersion);
-      return {
-        id: raw.RowKey,
-        formId: raw.PartitionKey,
-        formVersion: Number.isSafeInteger(formVersion) && formVersion > 0 ? formVersion : 1,
-        values,
-        locale: typeof raw.locale === "string" && raw.locale.trim().length > 0 ? raw.locale : defaultLocale,
-        metadata: options.metadataExtractor?.(entity) ?? {},
-        submittedAt
-      };
-    }
-  };
-}
-var createLegacyAzureTableCodec = (options = {}) => {
-  const createPartitionKey = options.partitionKeyGenerator ?? ((formId) => formId);
-  const createRowKey = options.rowKeyGenerator ?? ((submittedAt, submissionId) => `${submittedAt}_${submissionId}`);
-  return {
-    decode: (entity) => {
-      const values = entity.answers === void 0 ? {} : parseLegacyJsonObject(entity.answers, "answers");
-      const submittedAt = entity.answeredAt ?? entity.Timestamp;
-      if (submittedAt === void 0 || submittedAt.trim().length === 0) {
-        throw new Error("Azure Table legacy submission is missing answeredAt or Timestamp.");
-      }
-      return {
-        id: entity.RowKey,
-        formId: entity.PartitionKey,
-        formVersion: entity.surveyVersion ?? 1,
-        values,
-        metadata: {},
-        submittedAt
-      };
-    },
-    createPartitionKey: (formId, submissionId) => createPartitionKey(formId, submissionId),
-    createRowKey: (submittedAt, submissionId) => createRowKey(submittedAt, submissionId)
-  };
-};
 var BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 function encodeBase64(bytes) {
   let result = "";
@@ -212,11 +136,6 @@ function parseJson(value, location) {
     throw new Error(`Azure Table ${location} payload is invalid.`, { cause });
   }
 }
-function parseLegacyJsonObject(value, property) {
-  const parsed = parseJson(value, `legacy ${property}`);
-  if (!isRecord(parsed)) throw new Error(`Azure Table legacy ${property} payload must be an object.`);
-  return parsed;
-}
 function parseSubmission(value, location) {
   const parsed = typeof value === "string" ? parseJson(value, location) : value;
   if (!isRecord(parsed) || typeof parsed.id !== "string" || typeof parsed.formId !== "string" || !Number.isInteger(parsed.formVersion) || typeof parsed.locale !== "string" || typeof parsed.submittedAt !== "string" || !isRecord(parsed.values) || !Object.values(parsed.values).every(isFormValue)) {
@@ -312,22 +231,21 @@ function createAzureTableSubmissionCodec() {
   };
 }
 var defaultAzureTableSubmissionCodec = createAzureTableSubmissionCodec();
-function legacyCodec(codec) {
-  return {
-    createEntity: (value) => ({
-      ...codec.serialize(value),
-      kind: "submission",
-      formVersion: value.formVersion,
-      locale: value.locale,
-      submittedAt: value.submittedAt,
-      responseId: value.id
-    }),
-    deserialize: codec.deserialize,
-    matchesEntity: (entity) => entity.kind === "submission",
-    createPartitionKey: codec.createPartitionKey,
-    createPartitionKeyFromQuery: (formId) => codec.createPartitionKeyFromFormId?.(formId) ?? formId,
-    createRowKey: codec.createRowKey
-  };
+async function collectSubmissionPages(fetchPage, formId, options) {
+  const submissions = [];
+  const seen = /* @__PURE__ */ new Set();
+  let cursor = options.cursor;
+  do {
+    if (cursor !== void 0) {
+      if (seen.has(cursor)) throw new TypeError("Submission pagination cursor cycle detected.");
+      seen.add(cursor);
+    }
+    const page = await fetchPage(formId, { ...options, ...cursor === void 0 ? {} : { cursor } });
+    submissions.push(...page.items);
+    if (!page.hasMore || page.nextCursor === void 0 || page.nextCursor.length === 0) break;
+    cursor = page.nextCursor;
+  } while (cursor !== void 0);
+  return submissions;
 }
 function parseSchemaEntity(value) {
   if (typeof value.partitionKey !== "string" || typeof value.rowKey !== "string" || value.kind !== "schema" || !Number.isInteger(value.formVersion) || typeof value.payload !== "string") {
@@ -354,6 +272,11 @@ function parseSubmissionEntity(value, codec, mapping, valueCodec) {
   }
   return submission;
 }
+function assertCanonicalSubmissionEntity(value) {
+  if (Object.hasOwn(value, "answers")) {
+    throw new Error("Azure Table legacy answers column is not supported by the standard submission storage.");
+  }
+}
 function escapeOData(value) {
   return value.replaceAll("'", "''");
 }
@@ -406,19 +329,19 @@ function submissionFilterToOData(filter, mapping) {
     ...filter.to === void 0 ? [] : [`${property} le ${valueToOData(filter.to)}`]
   ].join(" and ");
 }
-function defaultSubmissionFilter(codec, formId, options, legacyExtension, mapping, rejectLegacyAnswers = false) {
+function defaultSubmissionFilter(codec, formId, options, customExtension, mapping) {
   const partitionKey = codec.createPartitionKeyFromQuery(formId, options);
   const ast = options.filter === void 0 || typeof options.filter === "function" ? void 0 : submissionFilterToOData(options.filter, mapping);
   const keys = physicalKeyNames(mapping);
   return [
     ...partitionKey === void 0 ? [] : [`${keys.partitionKey} eq '${escapeOData(partitionKey)}'`],
-    ...codec === defaultAzureTableSubmissionCodec && !rejectLegacyAnswers ? ["kind eq 'submission'"] : [],
+    ...codec === defaultAzureTableSubmissionCodec ? ["kind eq 'submission'"] : [],
     ...options.version === void 0 ? [] : [`${propertyName(mapping, "formVersion", "formVersion")} eq ${options.version}`],
     ...options.since === void 0 ? [] : [`${propertyName(mapping, "submittedAt", "submittedAt")} ge '${escapeOData(options.since)}'`],
     ...options.until === void 0 ? [] : [`${propertyName(mapping, "submittedAt", "submittedAt")} le '${escapeOData(options.until)}'`],
     ...options.locale === void 0 ? [] : [`locale eq '${escapeOData(options.locale)}'`],
     ...ast === void 0 || ast.length === 0 ? [] : [`(${ast})`],
-    ...legacyExtension.trim().length === 0 ? [] : [`(${legacyExtension})`]
+    ...customExtension.trim().length === 0 ? [] : [`(${customExtension})`]
   ].join(" and ");
 }
 function isNotFound(error) {
@@ -440,7 +363,7 @@ function createAzureTableStorage(options = {}) {
   const staticSubmissions = options.submissionsTableClient ?? options.client;
   const configuredCodec = options.codec;
   const valueCodec = configuredCodec !== void 0 && "encodeValues" in configuredCodec ? configuredCodec : void 0;
-  const codec = (configuredCodec !== void 0 && "createEntity" in configuredCodec ? configuredCodec : void 0) ?? (options.submissionCodec === void 0 ? defaultAzureTableSubmissionCodec : legacyCodec(options.submissionCodec));
+  const codec = (configuredCodec !== void 0 && "createEntity" in configuredCodec ? configuredCodec : void 0) ?? defaultAzureTableSubmissionCodec;
   const maxScanPages = options.maxScanPages ?? 5;
   if (!Number.isSafeInteger(maxScanPages) || maxScanPages < 1) {
     throw new TypeError("maxScanPages must be a positive safe integer.");
@@ -457,21 +380,15 @@ function createAzureTableStorage(options = {}) {
       codec,
       formId,
       query,
-      options.toODataFilter?.(query) ?? metadataFiltersToOData(query, options.fieldMapping),
-      options.fieldMapping,
-      options.rejectLegacyAnswers
+      metadataFiltersToOData(query, options.fieldMapping),
+      options.fieldMapping
     );
   };
   const ensureWritable = () => {
     if (options.readOnly === true) throw new Error("Azure Table storage is read-only.");
   };
-  const rejectLegacyEntity = (entity) => {
-    if (options.rejectLegacyAnswers === true && Object.hasOwn(entity, "answers")) {
-      throw new Error("Azure Table legacy answers column is not supported by the standard submission storage.");
-    }
-  };
   const deserializeIfMatching = (entity) => {
-    rejectLegacyEntity(entity);
+    assertCanonicalSubmissionEntity(entity);
     return codec.matchesEntity(entity) ? parseSubmissionEntity(entity, codec, options.fieldMapping, valueCodec) : void 0;
   };
   const listSubmissionCandidates = async (formId, query) => {
@@ -534,7 +451,9 @@ function createAzureTableStorage(options = {}) {
         (0, import_core.assertValidFormSubmission)(schema, stored);
       }
       const payloadHash = await (0, import_core.hashFormSubmissionPayload)(stored);
-      const mappedEntity = mappedSubmissionEntity(codec.createEntity(stored), stored, options.fieldMapping, valueCodec);
+      const createdEntity = codec.createEntity(stored);
+      assertCanonicalSubmissionEntity(createdEntity);
+      const mappedEntity = mappedSubmissionEntity(createdEntity, stored, options.fieldMapping, valueCodec);
       const keys = physicalKeyNames(options.fieldMapping);
       const partitionKey = codec.createPartitionKey(stored);
       const rowKey = codec.createRowKey(stored);
@@ -703,6 +622,44 @@ function createAzureTableStorage(options = {}) {
         })
       };
     },
+    async aggregateResponses(schema, options2 = {}) {
+      const query = { ...options2, version: options2.version ?? schema.version };
+      const items = await collectSubmissionPages(
+        (formId, pageOptions) => adapter.listSubmissionPage(formId, pageOptions),
+        schema.id,
+        query
+      );
+      return (0, import_core.aggregateResponses)(schema, items);
+    },
+    async exportResponsesToCsv(schema, options2 = {}) {
+      const { query, ...csvOptions } = options2;
+      const items = await collectSubmissionPages(
+        (formId, pageOptions) => adapter.listSubmissionPage(formId, pageOptions),
+        schema.id,
+        { ...query ?? {}, version: query?.version ?? schema.version }
+      );
+      const exportOptions = {
+        ...csvOptions.withBom === void 0 ? {} : { withBom: csvOptions.withBom },
+        ...csvOptions.useBom === void 0 ? {} : { useBom: csvOptions.useBom },
+        ...csvOptions.neutralizeFormulas === void 0 ? {} : { neutralizeFormulas: csvOptions.neutralizeFormulas },
+        ...csvOptions.preventFormulaInjection === void 0 ? {} : { preventFormulaInjection: csvOptions.preventFormulaInjection },
+        ...csvOptions.includeLocale === void 0 ? {} : { includeLocale: csvOptions.includeLocale },
+        ...csvOptions.includePiiStatus === void 0 ? {} : { includePiiStatus: csvOptions.includePiiStatus },
+        ...csvOptions.customColumns === void 0 ? {} : { customColumns: csvOptions.customColumns },
+        ...csvOptions.includeMetadataFields === void 0 ? {} : { includeMetadataFields: csvOptions.includeMetadataFields }
+      };
+      const exportItems = items.map((item) => ({ ...item, metadata: item.metadata ?? {} }));
+      return (0, import_core.exportResponsesToCsv)(schema, exportItems, exportOptions);
+    },
+    async validateSubmission(submission, source) {
+      if (source !== void 0) {
+        await (0, import_core.assertValidFormSubmissionWith)(source, submission);
+        return;
+      }
+      const schema = await adapter.getSchema(submission.formId, submission.formVersion);
+      if (schema === null) throw new Error("Azure Table submission schema was not found.");
+      (0, import_core.assertValidFormSubmission)(schema, submission);
+    },
     async deleteSubmission(submissionId) {
       ensureWritable();
       const client = await submissionClient("");
@@ -747,6 +704,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 },
@@ -767,8 +730,6 @@ function createAzureTableStorage(options = {}) {
 0 && (module.exports = {
   createAzureTableStorage,
   createAzureTableSubmissionCodec,
-  createLegacyArrayAzureTableCodec,
-  createLegacyAzureTableCodec,
   defaultAzureTableSubmissionCodec,
   metadataFiltersToOData,
   submissionFilterToOData

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { FormSubmission, BaseSubmissionMetadata, PagedSubmissionStorageAdapter, SubmissionPageQueryOptions, FormSubmissionValidationSource, FormSubmissionValidator, StrictFormSubmission, SaveSubmissionOptions, SubmissionSaveResult, SubmissionFilter, JsonValue, TextAnswerPageQueryOptions, TypedTextAnswerPage } from '@form-engine-ts/core';
+import { BaseSubmissionMetadata, PagedSubmissionStorageAdapter, TextAnswerPageQueryOptions, TextAnswerPage, TypedSubmissionPageQueryOptions, TypedSubmissionPage, FormSubmission, FormSchema, SubmissionPageQueryOptions, FormAnalytics, StorageSubmissionExportOptions, FormSubmissionValidationSource, FormSubmissionValidator, SaveSubmissionOptions, SubmissionSaveResult, SubmissionFilter, JsonValue, TypedTextAnswerPage } from '@form-engine-ts/core';
 
 interface AzureTableListOptions {
     readonly queryOptions?: {
@@ -22,52 +22,13 @@ interface AzureTableClientLike {
     listEntities(options?: AzureTableListOptions): AzureTableEntityIterator;
     deleteEntity(partitionKey: string, rowKey: string): Promise<unknown>;
 }
-/** @deprecated Use AzureTableSubmissionCodec. */
-interface AzureTableEntityCodec<T> {
-    readonly createPartitionKey: (submission: T) => string;
-    readonly createPartitionKeyFromFormId?: (formId: string) => string;
-    readonly createRowKey: (submission: T) => string;
-    readonly serialize: (submission: T) => Record<string, unknown>;
-    readonly deserialize: (entity: Record<string, unknown>) => T;
-}
-interface AzureTableLegacyEntity {
-    readonly PartitionKey: string;
-    readonly RowKey: string;
-    readonly answers?: string;
-    readonly answeredAt?: string;
-    readonly surveyVersion?: number;
-    readonly Timestamp?: string;
-    readonly [key: string]: unknown;
-}
-interface AzureTableLegacyCodec {
-    readonly decode: (entity: AzureTableLegacyEntity) => FormSubmission;
-    readonly createPartitionKey: (formId: string, submissionId: string) => string;
-    readonly createRowKey: (submittedAt: string, submissionId: string) => string;
-}
-interface LegacyAnswerArrayEntity extends Record<string, unknown> {
-    readonly PartitionKey: string;
-    readonly RowKey: string;
-    readonly answers: string;
-    readonly answeredAt: string;
-    readonly surveyVersion: number;
-    readonly locale?: string;
-}
-interface LegacyArrayAzureTableCodec<TMeta extends BaseSubmissionMetadata = BaseSubmissionMetadata> {
-    readonly encode: (submission: StrictFormSubmission<TMeta>) => Record<string, unknown>;
-    readonly decode: (entity: Record<string, unknown>) => StrictFormSubmission<TMeta>;
-}
-declare function createLegacyArrayAzureTableCodec<TMeta extends BaseSubmissionMetadata = BaseSubmissionMetadata>(options?: {
-    readonly defaultLocale?: string;
-    readonly metadataExtractor?: (entity: Record<string, unknown>) => TMeta;
-}): LegacyArrayAzureTableCodec<TMeta>;
-declare const createLegacyAzureTableCodec: (options?: {
-    readonly partitionKeyGenerator?: (formId: string, submissionId: string) => string;
-    readonly rowKeyGenerator?: (submittedAt: string, submissionId: string) => string;
-}) => AzureTableLegacyCodec;
+type AzureTableSubmissionEntity = Record<string, unknown> & {
+    readonly answers?: never;
+};
 interface AzureTableSubmissionCodec<T = FormSubmission> {
-    readonly createEntity: (value: T) => Record<string, unknown>;
-    readonly deserialize: (entity: Record<string, unknown>) => T;
-    readonly matchesEntity: (entity: Record<string, unknown>) => boolean;
+    readonly createEntity: (value: T) => AzureTableSubmissionEntity;
+    readonly deserialize: (entity: AzureTableSubmissionEntity) => T;
+    readonly matchesEntity: (entity: AzureTableSubmissionEntity) => boolean;
     readonly createPartitionKey: (value: T) => string;
     readonly createPartitionKeyFromQuery: (formId: string, query: SubmissionPageQueryOptions) => string | undefined;
     readonly createRowKey: (value: T) => string;
@@ -96,16 +57,10 @@ interface AzureTableStorageOptions<T = FormSubmission> {
         readonly query?: SubmissionPageQueryOptions;
     }) => AzureTableClientLike | Promise<AzureTableClientLike>;
     readonly codec?: AzureTableSubmissionCodec<T> | AzureTableValueCodec;
-    /** @deprecated Use codec. */
-    readonly submissionCodec?: AzureTableEntityCodec<FormSubmission>;
     readonly buildSubmissionFilter?: (formId: string, query: SubmissionPageQueryOptions) => string;
-    /** @deprecated Use buildSubmissionFilter. */
-    readonly toODataFilter?: (options: SubmissionPageQueryOptions) => string;
     readonly maxScanPages?: number;
     readonly fieldMapping?: AzureTableFieldMapping;
     readonly readOnly?: boolean;
-    /** Detect legacy entities that expose an `answers` column and fail explicitly. */
-    readonly rejectLegacyAnswers?: boolean;
     /** Enable typed duplicate/conflict results for submission IDs. */
     readonly idempotentSubmissions?: boolean;
     /** Alias for idempotentSubmissions. */
@@ -121,6 +76,8 @@ interface AzureTableStorageOptions<T = FormSubmission> {
     readonly schema?: FormSubmissionValidationSource;
 }
 interface AzureTableStorageAdapter<TMeta extends BaseSubmissionMetadata = BaseSubmissionMetadata> extends PagedSubmissionStorageAdapter {
+    readonly listTextAnswerPage: (formId: string, fieldIdOrOptions?: string | TextAnswerPageQueryOptions, options?: TextAnswerPageQueryOptions) => Promise<TextAnswerPage>;
+    readonly fetchSubmissionPage?: (formId: string, options?: TypedSubmissionPageQueryOptions<TMeta>) => Promise<TypedSubmissionPage<TMeta>>;
     readonly fetchPage: (formId: string, options?: {
         readonly pageSize?: number;
         readonly fromSubmittedAt?: string;
@@ -132,6 +89,9 @@ interface AzureTableStorageAdapter<TMeta extends BaseSubmissionMetadata = BaseSu
         readonly items: readonly FormSubmission<TMeta>[];
         readonly nextCursor?: string;
     }>;
+    readonly aggregateResponses: (schema: FormSchema, options?: SubmissionPageQueryOptions) => Promise<FormAnalytics>;
+    readonly exportResponsesToCsv: (schema: FormSchema, options?: StorageSubmissionExportOptions) => Promise<string>;
+    readonly validateSubmission: (submission: FormSubmission, source?: FormSubmissionValidationSource) => Promise<void>;
 }
 type TypedAzureTableStorageAdapter<TMeta extends BaseSubmissionMetadata | undefined = undefined> = Omit<PagedSubmissionStorageAdapter, "saveSubmission" | "listSubmissionPage" | "listTextAnswerPage"> & {
     readonly saveSubmission: (submission: FormSubmission<TMeta>, options?: SaveSubmissionOptions) => Promise<undefined | SubmissionSaveResult<TMeta>>;
@@ -154,7 +114,11 @@ 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>>;
+    readonly aggregateResponses: (schema: FormSchema, options?: TypedSubmissionPageQueryOptions<TMeta>) => Promise<FormAnalytics>;
+    readonly exportResponsesToCsv: (schema: FormSchema, options?: StorageSubmissionExportOptions<TMeta>) => Promise<string>;
+    readonly validateSubmission: (submission: FormSubmission<TMeta>, source?: FormSubmissionValidationSource<TMeta>) => Promise<void>;
 };
 interface AzureTextAnswerCursorPayload {
     readonly formatVersion: 1;
@@ -170,7 +134,7 @@ declare function createAzureTableSubmissionCodec<TMeta extends BaseSubmissionMet
 declare const defaultAzureTableSubmissionCodec: AzureTableSubmissionCodec<FormSubmission>;
 declare function metadataFiltersToOData(options: SubmissionPageQueryOptions, mapping?: AzureTableFieldMapping): string;
 declare function submissionFilterToOData(filter: SubmissionFilter, mapping?: AzureTableFieldMapping): string | undefined;
-declare function createAzureTableStorage(options?: AzureTableStorageOptions): PagedSubmissionStorageAdapter;
+declare function createAzureTableStorage(options?: AzureTableStorageOptions): AzureTableStorageAdapter;
 declare function createAzureTableStorage<TMeta extends BaseSubmissionMetadata | undefined = undefined>(options?: AzureTableStorageOptions): TypedAzureTableStorageAdapter<TMeta>;
 
-export { type AzureTableClientLike, type AzureTableEntityCodec, type AzureTableEntityIterator, type AzureTableEntityPage, type AzureTableFieldMapping, type AzureTableLegacyCodec, type AzureTableLegacyEntity, type AzureTableListOptions, type AzureTablePageSettings, type AzureTableStorageAdapter, type AzureTableStorageOptions, type AzureTableSubmissionCodec, type AzureTableValueCodec, type AzureTextAnswerCursorPayload, type LegacyAnswerArrayEntity, type LegacyArrayAzureTableCodec, type TypedAzureTableStorageAdapter, createAzureTableStorage, createAzureTableSubmissionCodec, createLegacyArrayAzureTableCodec, createLegacyAzureTableCodec, defaultAzureTableSubmissionCodec, metadataFiltersToOData, submissionFilterToOData };
+export { type AzureTableClientLike, type AzureTableEntityIterator, type AzureTableEntityPage, type AzureTableFieldMapping, type AzureTableListOptions, type AzureTablePageSettings, type AzureTableStorageAdapter, type AzureTableStorageOptions, type AzureTableSubmissionCodec, type AzureTableSubmissionEntity, type AzureTableValueCodec, type AzureTextAnswerCursorPayload, type TypedAzureTableStorageAdapter, createAzureTableStorage, createAzureTableSubmissionCodec, defaultAzureTableSubmissionCodec, metadataFiltersToOData, submissionFilterToOData };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { FormSubmission, BaseSubmissionMetadata, PagedSubmissionStorageAdapter, SubmissionPageQueryOptions, FormSubmissionValidationSource, FormSubmissionValidator, StrictFormSubmission, SaveSubmissionOptions, SubmissionSaveResult, SubmissionFilter, JsonValue, TextAnswerPageQueryOptions, TypedTextAnswerPage } from '@form-engine-ts/core';
+import { BaseSubmissionMetadata, PagedSubmissionStorageAdapter, TextAnswerPageQueryOptions, TextAnswerPage, TypedSubmissionPageQueryOptions, TypedSubmissionPage, FormSubmission, FormSchema, SubmissionPageQueryOptions, FormAnalytics, StorageSubmissionExportOptions, FormSubmissionValidationSource, FormSubmissionValidator, SaveSubmissionOptions, SubmissionSaveResult, SubmissionFilter, JsonValue, TypedTextAnswerPage } from '@form-engine-ts/core';
 
 interface AzureTableListOptions {
     readonly queryOptions?: {
@@ -22,52 +22,13 @@ interface AzureTableClientLike {
     listEntities(options?: AzureTableListOptions): AzureTableEntityIterator;
     deleteEntity(partitionKey: string, rowKey: string): Promise<unknown>;
 }
-/** @deprecated Use AzureTableSubmissionCodec. */
-interface AzureTableEntityCodec<T> {
-    readonly createPartitionKey: (submission: T) => string;
-    readonly createPartitionKeyFromFormId?: (formId: string) => string;
-    readonly createRowKey: (submission: T) => string;
-    readonly serialize: (submission: T) => Record<string, unknown>;
-    readonly deserialize: (entity: Record<string, unknown>) => T;
-}
-interface AzureTableLegacyEntity {
-    readonly PartitionKey: string;
-    readonly RowKey: string;
-    readonly answers?: string;
-    readonly answeredAt?: string;
-    readonly surveyVersion?: number;
-    readonly Timestamp?: string;
-    readonly [key: string]: unknown;
-}
-interface AzureTableLegacyCodec {
-    readonly decode: (entity: AzureTableLegacyEntity) => FormSubmission;
-    readonly createPartitionKey: (formId: string, submissionId: string) => string;
-    readonly createRowKey: (submittedAt: string, submissionId: string) => string;
-}
-interface LegacyAnswerArrayEntity extends Record<string, unknown> {
-    readonly PartitionKey: string;
-    readonly RowKey: string;
-    readonly answers: string;
-    readonly answeredAt: string;
-    readonly surveyVersion: number;
-    readonly locale?: string;
-}
-interface LegacyArrayAzureTableCodec<TMeta extends BaseSubmissionMetadata = BaseSubmissionMetadata> {
-    readonly encode: (submission: StrictFormSubmission<TMeta>) => Record<string, unknown>;
-    readonly decode: (entity: Record<string, unknown>) => StrictFormSubmission<TMeta>;
-}
-declare function createLegacyArrayAzureTableCodec<TMeta extends BaseSubmissionMetadata = BaseSubmissionMetadata>(options?: {
-    readonly defaultLocale?: string;
-    readonly metadataExtractor?: (entity: Record<string, unknown>) => TMeta;
-}): LegacyArrayAzureTableCodec<TMeta>;
-declare const createLegacyAzureTableCodec: (options?: {
-    readonly partitionKeyGenerator?: (formId: string, submissionId: string) => string;
-    readonly rowKeyGenerator?: (submittedAt: string, submissionId: string) => string;
-}) => AzureTableLegacyCodec;
+type AzureTableSubmissionEntity = Record<string, unknown> & {
+    readonly answers?: never;
+};
 interface AzureTableSubmissionCodec<T = FormSubmission> {
-    readonly createEntity: (value: T) => Record<string, unknown>;
-    readonly deserialize: (entity: Record<string, unknown>) => T;
-    readonly matchesEntity: (entity: Record<string, unknown>) => boolean;
+    readonly createEntity: (value: T) => AzureTableSubmissionEntity;
+    readonly deserialize: (entity: AzureTableSubmissionEntity) => T;
+    readonly matchesEntity: (entity: AzureTableSubmissionEntity) => boolean;
     readonly createPartitionKey: (value: T) => string;
     readonly createPartitionKeyFromQuery: (formId: string, query: SubmissionPageQueryOptions) => string | undefined;
     readonly createRowKey: (value: T) => string;
@@ -96,16 +57,10 @@ interface AzureTableStorageOptions<T = FormSubmission> {
         readonly query?: SubmissionPageQueryOptions;
     }) => AzureTableClientLike | Promise<AzureTableClientLike>;
     readonly codec?: AzureTableSubmissionCodec<T> | AzureTableValueCodec;
-    /** @deprecated Use codec. */
-    readonly submissionCodec?: AzureTableEntityCodec<FormSubmission>;
     readonly buildSubmissionFilter?: (formId: string, query: SubmissionPageQueryOptions) => string;
-    /** @deprecated Use buildSubmissionFilter. */
-    readonly toODataFilter?: (options: SubmissionPageQueryOptions) => string;
     readonly maxScanPages?: number;
     readonly fieldMapping?: AzureTableFieldMapping;
     readonly readOnly?: boolean;
-    /** Detect legacy entities that expose an `answers` column and fail explicitly. */
-    readonly rejectLegacyAnswers?: boolean;
     /** Enable typed duplicate/conflict results for submission IDs. */
     readonly idempotentSubmissions?: boolean;
     /** Alias for idempotentSubmissions. */
@@ -121,6 +76,8 @@ interface AzureTableStorageOptions<T = FormSubmission> {
     readonly schema?: FormSubmissionValidationSource;
 }
 interface AzureTableStorageAdapter<TMeta extends BaseSubmissionMetadata = BaseSubmissionMetadata> extends PagedSubmissionStorageAdapter {
+    readonly listTextAnswerPage: (formId: string, fieldIdOrOptions?: string | TextAnswerPageQueryOptions, options?: TextAnswerPageQueryOptions) => Promise<TextAnswerPage>;
+    readonly fetchSubmissionPage?: (formId: string, options?: TypedSubmissionPageQueryOptions<TMeta>) => Promise<TypedSubmissionPage<TMeta>>;
     readonly fetchPage: (formId: string, options?: {
         readonly pageSize?: number;
         readonly fromSubmittedAt?: string;
@@ -132,6 +89,9 @@ interface AzureTableStorageAdapter<TMeta extends BaseSubmissionMetadata = BaseSu
         readonly items: readonly FormSubmission<TMeta>[];
         readonly nextCursor?: string;
     }>;
+    readonly aggregateResponses: (schema: FormSchema, options?: SubmissionPageQueryOptions) => Promise<FormAnalytics>;
+    readonly exportResponsesToCsv: (schema: FormSchema, options?: StorageSubmissionExportOptions) => Promise<string>;
+    readonly validateSubmission: (submission: FormSubmission, source?: FormSubmissionValidationSource) => Promise<void>;
 }
 type TypedAzureTableStorageAdapter<TMeta extends BaseSubmissionMetadata | undefined = undefined> = Omit<PagedSubmissionStorageAdapter, "saveSubmission" | "listSubmissionPage" | "listTextAnswerPage"> & {
     readonly saveSubmission: (submission: FormSubmission<TMeta>, options?: SaveSubmissionOptions) => Promise<undefined | SubmissionSaveResult<TMeta>>;
@@ -154,7 +114,11 @@ 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>>;
+    readonly aggregateResponses: (schema: FormSchema, options?: TypedSubmissionPageQueryOptions<TMeta>) => Promise<FormAnalytics>;
+    readonly exportResponsesToCsv: (schema: FormSchema, options?: StorageSubmissionExportOptions<TMeta>) => Promise<string>;
+    readonly validateSubmission: (submission: FormSubmission<TMeta>, source?: FormSubmissionValidationSource<TMeta>) => Promise<void>;
 };
 interface AzureTextAnswerCursorPayload {
     readonly formatVersion: 1;
@@ -170,7 +134,7 @@ declare function createAzureTableSubmissionCodec<TMeta extends BaseSubmissionMet
 declare const defaultAzureTableSubmissionCodec: AzureTableSubmissionCodec<FormSubmission>;
 declare function metadataFiltersToOData(options: SubmissionPageQueryOptions, mapping?: AzureTableFieldMapping): string;
 declare function submissionFilterToOData(filter: SubmissionFilter, mapping?: AzureTableFieldMapping): string | undefined;
-declare function createAzureTableStorage(options?: AzureTableStorageOptions): PagedSubmissionStorageAdapter;
+declare function createAzureTableStorage(options?: AzureTableStorageOptions): AzureTableStorageAdapter;
 declare function createAzureTableStorage<TMeta extends BaseSubmissionMetadata | undefined = undefined>(options?: AzureTableStorageOptions): TypedAzureTableStorageAdapter<TMeta>;
 
-export { type AzureTableClientLike, type AzureTableEntityCodec, type AzureTableEntityIterator, type AzureTableEntityPage, type AzureTableFieldMapping, type AzureTableLegacyCodec, type AzureTableLegacyEntity, type AzureTableListOptions, type AzureTablePageSettings, type AzureTableStorageAdapter, type AzureTableStorageOptions, type AzureTableSubmissionCodec, type AzureTableValueCodec, type AzureTextAnswerCursorPayload, type LegacyAnswerArrayEntity, type LegacyArrayAzureTableCodec, type TypedAzureTableStorageAdapter, createAzureTableStorage, createAzureTableSubmissionCodec, createLegacyArrayAzureTableCodec, createLegacyAzureTableCodec, defaultAzureTableSubmissionCodec, metadataFiltersToOData, submissionFilterToOData };
+export { type AzureTableClientLike, type AzureTableEntityIterator, type AzureTableEntityPage, type AzureTableFieldMapping, type AzureTableListOptions, type AzureTablePageSettings, type AzureTableStorageAdapter, type AzureTableStorageOptions, type AzureTableSubmissionCodec, type AzureTableSubmissionEntity, type AzureTableValueCodec, type AzureTextAnswerCursorPayload, type TypedAzureTableStorageAdapter, createAzureTableStorage, createAzureTableSubmissionCodec, defaultAzureTableSubmissionCodec, metadataFiltersToOData, submissionFilterToOData };

package/dist/index.js

@@ -1,86 +1,14 @@
 // src/index.ts
 import {
+  aggregateResponses,
   assertValidFormSchema,
   assertValidFormSubmission,
   assertValidFormSubmissionWith,
+  exportResponsesToCsv,
   hashFormSubmissionPayload,
   matchesSubmissionPageFilters,
   normalizeSubmissionPageSize
 } from "@form-engine-ts/core";
-function createLegacyArrayAzureTableCodec(options = {}) {
-  const defaultLocale = options.defaultLocale ?? "ja";
-  if (defaultLocale.trim().length === 0) throw new TypeError("defaultLocale must not be empty.");
-  return {
-    encode: (submission) => ({
-      PartitionKey: submission.formId,
-      RowKey: submission.id,
-      answers: JSON.stringify(Object.entries(submission.values).map(([questionId, value]) => ({ questionId, value }))),
-      answeredAt: submission.submittedAt,
-      surveyVersion: submission.formVersion,
-      locale: submission.locale,
-      ...submission.metadata
-    }),
-    decode: (entity) => {
-      const raw = entity;
-      if (typeof raw.PartitionKey !== "string" || typeof raw.RowKey !== "string") {
-        throw new Error("Azure Table legacy array submission is missing PartitionKey or RowKey.");
-      }
-      const submittedAt = typeof raw.answeredAt === "string" ? raw.answeredAt : entity.Timestamp;
-      if (typeof submittedAt !== "string" || submittedAt.trim().length === 0) {
-        throw new Error("Azure Table legacy array submission is missing answeredAt or Timestamp.");
-      }
-      let values = {};
-      if (typeof raw.answers === "string") {
-        const parsed = parseJson(raw.answers, "legacy array answers");
-        if (Array.isArray(parsed)) {
-          values = Object.fromEntries(
-            parsed.flatMap((item) => {
-              if (!isRecord(item) || typeof item.questionId !== "string") return [];
-              return [[item.questionId, item.value]];
-            })
-          );
-        } else if (isRecord(parsed)) {
-          values = parsed;
-        } else {
-          throw new Error("Azure Table legacy array answers payload must be an array or object.");
-        }
-      }
-      const formVersion = Number(raw.surveyVersion);
-      return {
-        id: raw.RowKey,
-        formId: raw.PartitionKey,
-        formVersion: Number.isSafeInteger(formVersion) && formVersion > 0 ? formVersion : 1,
-        values,
-        locale: typeof raw.locale === "string" && raw.locale.trim().length > 0 ? raw.locale : defaultLocale,
-        metadata: options.metadataExtractor?.(entity) ?? {},
-        submittedAt
-      };
-    }
-  };
-}
-var createLegacyAzureTableCodec = (options = {}) => {
-  const createPartitionKey = options.partitionKeyGenerator ?? ((formId) => formId);
-  const createRowKey = options.rowKeyGenerator ?? ((submittedAt, submissionId) => `${submittedAt}_${submissionId}`);
-  return {
-    decode: (entity) => {
-      const values = entity.answers === void 0 ? {} : parseLegacyJsonObject(entity.answers, "answers");
-      const submittedAt = entity.answeredAt ?? entity.Timestamp;
-      if (submittedAt === void 0 || submittedAt.trim().length === 0) {
-        throw new Error("Azure Table legacy submission is missing answeredAt or Timestamp.");
-      }
-      return {
-        id: entity.RowKey,
-        formId: entity.PartitionKey,
-        formVersion: entity.surveyVersion ?? 1,
-        values,
-        metadata: {},
-        submittedAt
-      };
-    },
-    createPartitionKey: (formId, submissionId) => createPartitionKey(formId, submissionId),
-    createRowKey: (submittedAt, submissionId) => createRowKey(submittedAt, submissionId)
-  };
-};
 var BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 function encodeBase64(bytes) {
   let result = "";
@@ -189,11 +117,6 @@ function parseJson(value, location) {
     throw new Error(`Azure Table ${location} payload is invalid.`, { cause });
   }
 }
-function parseLegacyJsonObject(value, property) {
-  const parsed = parseJson(value, `legacy ${property}`);
-  if (!isRecord(parsed)) throw new Error(`Azure Table legacy ${property} payload must be an object.`);
-  return parsed;
-}
 function parseSubmission(value, location) {
   const parsed = typeof value === "string" ? parseJson(value, location) : value;
   if (!isRecord(parsed) || typeof parsed.id !== "string" || typeof parsed.formId !== "string" || !Number.isInteger(parsed.formVersion) || typeof parsed.locale !== "string" || typeof parsed.submittedAt !== "string" || !isRecord(parsed.values) || !Object.values(parsed.values).every(isFormValue)) {
@@ -289,22 +212,21 @@ function createAzureTableSubmissionCodec() {
   };
 }
 var defaultAzureTableSubmissionCodec = createAzureTableSubmissionCodec();
-function legacyCodec(codec) {
-  return {
-    createEntity: (value) => ({
-      ...codec.serialize(value),
-      kind: "submission",
-      formVersion: value.formVersion,
-      locale: value.locale,
-      submittedAt: value.submittedAt,
-      responseId: value.id
-    }),
-    deserialize: codec.deserialize,
-    matchesEntity: (entity) => entity.kind === "submission",
-    createPartitionKey: codec.createPartitionKey,
-    createPartitionKeyFromQuery: (formId) => codec.createPartitionKeyFromFormId?.(formId) ?? formId,
-    createRowKey: codec.createRowKey
-  };
+async function collectSubmissionPages(fetchPage, formId, options) {
+  const submissions = [];
+  const seen = /* @__PURE__ */ new Set();
+  let cursor = options.cursor;
+  do {
+    if (cursor !== void 0) {
+      if (seen.has(cursor)) throw new TypeError("Submission pagination cursor cycle detected.");
+      seen.add(cursor);
+    }
+    const page = await fetchPage(formId, { ...options, ...cursor === void 0 ? {} : { cursor } });
+    submissions.push(...page.items);
+    if (!page.hasMore || page.nextCursor === void 0 || page.nextCursor.length === 0) break;
+    cursor = page.nextCursor;
+  } while (cursor !== void 0);
+  return submissions;
 }
 function parseSchemaEntity(value) {
   if (typeof value.partitionKey !== "string" || typeof value.rowKey !== "string" || value.kind !== "schema" || !Number.isInteger(value.formVersion) || typeof value.payload !== "string") {
@@ -331,6 +253,11 @@ function parseSubmissionEntity(value, codec, mapping, valueCodec) {
   }
   return submission;
 }
+function assertCanonicalSubmissionEntity(value) {
+  if (Object.hasOwn(value, "answers")) {
+    throw new Error("Azure Table legacy answers column is not supported by the standard submission storage.");
+  }
+}
 function escapeOData(value) {
   return value.replaceAll("'", "''");
 }
@@ -383,19 +310,19 @@ function submissionFilterToOData(filter, mapping) {
     ...filter.to === void 0 ? [] : [`${property} le ${valueToOData(filter.to)}`]
   ].join(" and ");
 }
-function defaultSubmissionFilter(codec, formId, options, legacyExtension, mapping, rejectLegacyAnswers = false) {
+function defaultSubmissionFilter(codec, formId, options, customExtension, mapping) {
   const partitionKey = codec.createPartitionKeyFromQuery(formId, options);
   const ast = options.filter === void 0 || typeof options.filter === "function" ? void 0 : submissionFilterToOData(options.filter, mapping);
   const keys = physicalKeyNames(mapping);
   return [
     ...partitionKey === void 0 ? [] : [`${keys.partitionKey} eq '${escapeOData(partitionKey)}'`],
-    ...codec === defaultAzureTableSubmissionCodec && !rejectLegacyAnswers ? ["kind eq 'submission'"] : [],
+    ...codec === defaultAzureTableSubmissionCodec ? ["kind eq 'submission'"] : [],
     ...options.version === void 0 ? [] : [`${propertyName(mapping, "formVersion", "formVersion")} eq ${options.version}`],
     ...options.since === void 0 ? [] : [`${propertyName(mapping, "submittedAt", "submittedAt")} ge '${escapeOData(options.since)}'`],
     ...options.until === void 0 ? [] : [`${propertyName(mapping, "submittedAt", "submittedAt")} le '${escapeOData(options.until)}'`],
     ...options.locale === void 0 ? [] : [`locale eq '${escapeOData(options.locale)}'`],
     ...ast === void 0 || ast.length === 0 ? [] : [`(${ast})`],
-    ...legacyExtension.trim().length === 0 ? [] : [`(${legacyExtension})`]
+    ...customExtension.trim().length === 0 ? [] : [`(${customExtension})`]
   ].join(" and ");
 }
 function isNotFound(error) {
@@ -417,7 +344,7 @@ function createAzureTableStorage(options = {}) {
   const staticSubmissions = options.submissionsTableClient ?? options.client;
   const configuredCodec = options.codec;
   const valueCodec = configuredCodec !== void 0 && "encodeValues" in configuredCodec ? configuredCodec : void 0;
-  const codec = (configuredCodec !== void 0 && "createEntity" in configuredCodec ? configuredCodec : void 0) ?? (options.submissionCodec === void 0 ? defaultAzureTableSubmissionCodec : legacyCodec(options.submissionCodec));
+  const codec = (configuredCodec !== void 0 && "createEntity" in configuredCodec ? configuredCodec : void 0) ?? defaultAzureTableSubmissionCodec;
   const maxScanPages = options.maxScanPages ?? 5;
   if (!Number.isSafeInteger(maxScanPages) || maxScanPages < 1) {
     throw new TypeError("maxScanPages must be a positive safe integer.");
@@ -434,21 +361,15 @@ function createAzureTableStorage(options = {}) {
       codec,
       formId,
       query,
-      options.toODataFilter?.(query) ?? metadataFiltersToOData(query, options.fieldMapping),
-      options.fieldMapping,
-      options.rejectLegacyAnswers
+      metadataFiltersToOData(query, options.fieldMapping),
+      options.fieldMapping
     );
   };
   const ensureWritable = () => {
     if (options.readOnly === true) throw new Error("Azure Table storage is read-only.");
   };
-  const rejectLegacyEntity = (entity) => {
-    if (options.rejectLegacyAnswers === true && Object.hasOwn(entity, "answers")) {
-      throw new Error("Azure Table legacy answers column is not supported by the standard submission storage.");
-    }
-  };
   const deserializeIfMatching = (entity) => {
-    rejectLegacyEntity(entity);
+    assertCanonicalSubmissionEntity(entity);
     return codec.matchesEntity(entity) ? parseSubmissionEntity(entity, codec, options.fieldMapping, valueCodec) : void 0;
   };
   const listSubmissionCandidates = async (formId, query) => {
@@ -511,7 +432,9 @@ function createAzureTableStorage(options = {}) {
         assertValidFormSubmission(schema, stored);
       }
       const payloadHash = await hashFormSubmissionPayload(stored);
-      const mappedEntity = mappedSubmissionEntity(codec.createEntity(stored), stored, options.fieldMapping, valueCodec);
+      const createdEntity = codec.createEntity(stored);
+      assertCanonicalSubmissionEntity(createdEntity);
+      const mappedEntity = mappedSubmissionEntity(createdEntity, stored, options.fieldMapping, valueCodec);
       const keys = physicalKeyNames(options.fieldMapping);
       const partitionKey = codec.createPartitionKey(stored);
       const rowKey = codec.createRowKey(stored);
@@ -680,6 +603,44 @@ function createAzureTableStorage(options = {}) {
         })
       };
     },
+    async aggregateResponses(schema, options2 = {}) {
+      const query = { ...options2, version: options2.version ?? schema.version };
+      const items = await collectSubmissionPages(
+        (formId, pageOptions) => adapter.listSubmissionPage(formId, pageOptions),
+        schema.id,
+        query
+      );
+      return aggregateResponses(schema, items);
+    },
+    async exportResponsesToCsv(schema, options2 = {}) {
+      const { query, ...csvOptions } = options2;
+      const items = await collectSubmissionPages(
+        (formId, pageOptions) => adapter.listSubmissionPage(formId, pageOptions),
+        schema.id,
+        { ...query ?? {}, version: query?.version ?? schema.version }
+      );
+      const exportOptions = {
+        ...csvOptions.withBom === void 0 ? {} : { withBom: csvOptions.withBom },
+        ...csvOptions.useBom === void 0 ? {} : { useBom: csvOptions.useBom },
+        ...csvOptions.neutralizeFormulas === void 0 ? {} : { neutralizeFormulas: csvOptions.neutralizeFormulas },
+        ...csvOptions.preventFormulaInjection === void 0 ? {} : { preventFormulaInjection: csvOptions.preventFormulaInjection },
+        ...csvOptions.includeLocale === void 0 ? {} : { includeLocale: csvOptions.includeLocale },
+        ...csvOptions.includePiiStatus === void 0 ? {} : { includePiiStatus: csvOptions.includePiiStatus },
+        ...csvOptions.customColumns === void 0 ? {} : { customColumns: csvOptions.customColumns },
+        ...csvOptions.includeMetadataFields === void 0 ? {} : { includeMetadataFields: csvOptions.includeMetadataFields }
+      };
+      const exportItems = items.map((item) => ({ ...item, metadata: item.metadata ?? {} }));
+      return exportResponsesToCsv(schema, exportItems, exportOptions);
+    },
+    async validateSubmission(submission, source) {
+      if (source !== void 0) {
+        await assertValidFormSubmissionWith(source, submission);
+        return;
+      }
+      const schema = await adapter.getSchema(submission.formId, submission.formVersion);
+      if (schema === null) throw new Error("Azure Table submission schema was not found.");
+      assertValidFormSubmission(schema, submission);
+    },
     async deleteSubmission(submissionId) {
       ensureWritable();
       const client = await submissionClient("");
@@ -724,6 +685,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 },
@@ -743,8 +710,6 @@ function createAzureTableStorage(options = {}) {
 export {
   createAzureTableStorage,
   createAzureTableSubmissionCodec,
-  createLegacyArrayAzureTableCodec,
-  createLegacyAzureTableCodec,
   defaultAzureTableSubmissionCodec,
   metadataFiltersToOData,
   submissionFilterToOData

package/package.json

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