@form-engine-ts/storage-azure-table 6.0.0 → 6.2.0

package/dist/index.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   createAzureTableStorage: () => createAzureTableStorage,
+  createLegacyArrayAzureTableCodec: () => createLegacyArrayAzureTableCodec,
   createLegacyAzureTableCodec: () => createLegacyAzureTableCodec,
   defaultAzureTableSubmissionCodec: () => defaultAzureTableSubmissionCodec,
   metadataFiltersToOData: () => metadataFiltersToOData,
@@ -28,6 +29,57 @@ __export(index_exports, {
 });
 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}`);
@@ -648,6 +700,7 @@ function createAzureTableStorage(options = {}) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createAzureTableStorage,
+  createLegacyArrayAzureTableCodec,
   createLegacyAzureTableCodec,
   defaultAzureTableSubmissionCodec,
   metadataFiltersToOData,

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { FormSubmission, SubmissionPageQueryOptions, PagedSubmissionStorageAdapter, SubmissionFilter } from '@form-engine-ts/core';
+import { FormSubmission, SubmissionPageQueryOptions, BaseSubmissionMetadata, StrictFormSubmission, PagedSubmissionStorageAdapter, SubmissionFilter } from '@form-engine-ts/core';
 
 interface AzureTableListOptions {
     readonly queryOptions?: {
@@ -44,6 +44,22 @@ interface AzureTableLegacyCodec {
     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;
@@ -104,4 +120,4 @@ declare function metadataFiltersToOData(options: SubmissionPageQueryOptions, map
 declare function submissionFilterToOData(filter: SubmissionFilter, mapping?: AzureTableFieldMapping): string | undefined;
 declare function createAzureTableStorage(options?: AzureTableStorageOptions): PagedSubmissionStorageAdapter;
 
-export { type AzureTableClientLike, type AzureTableEntityCodec, type AzureTableEntityIterator, type AzureTableEntityPage, type AzureTableFieldMapping, type AzureTableLegacyCodec, type AzureTableLegacyEntity, type AzureTableListOptions, type AzureTablePageSettings, type AzureTableStorageOptions, type AzureTableSubmissionCodec, type AzureTableValueCodec, type AzureTextAnswerCursorPayload, createAzureTableStorage, createLegacyAzureTableCodec, defaultAzureTableSubmissionCodec, metadataFiltersToOData, submissionFilterToOData };
+export { type AzureTableClientLike, type AzureTableEntityCodec, type AzureTableEntityIterator, type AzureTableEntityPage, type AzureTableFieldMapping, type AzureTableLegacyCodec, type AzureTableLegacyEntity, type AzureTableListOptions, type AzureTablePageSettings, type AzureTableStorageOptions, type AzureTableSubmissionCodec, type AzureTableValueCodec, type AzureTextAnswerCursorPayload, type LegacyAnswerArrayEntity, type LegacyArrayAzureTableCodec, createAzureTableStorage, createLegacyArrayAzureTableCodec, createLegacyAzureTableCodec, defaultAzureTableSubmissionCodec, metadataFiltersToOData, submissionFilterToOData };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { FormSubmission, SubmissionPageQueryOptions, PagedSubmissionStorageAdapter, SubmissionFilter } from '@form-engine-ts/core';
+import { FormSubmission, SubmissionPageQueryOptions, BaseSubmissionMetadata, StrictFormSubmission, PagedSubmissionStorageAdapter, SubmissionFilter } from '@form-engine-ts/core';
 
 interface AzureTableListOptions {
     readonly queryOptions?: {
@@ -44,6 +44,22 @@ interface AzureTableLegacyCodec {
     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;
@@ -104,4 +120,4 @@ declare function metadataFiltersToOData(options: SubmissionPageQueryOptions, map
 declare function submissionFilterToOData(filter: SubmissionFilter, mapping?: AzureTableFieldMapping): string | undefined;
 declare function createAzureTableStorage(options?: AzureTableStorageOptions): PagedSubmissionStorageAdapter;
 
-export { type AzureTableClientLike, type AzureTableEntityCodec, type AzureTableEntityIterator, type AzureTableEntityPage, type AzureTableFieldMapping, type AzureTableLegacyCodec, type AzureTableLegacyEntity, type AzureTableListOptions, type AzureTablePageSettings, type AzureTableStorageOptions, type AzureTableSubmissionCodec, type AzureTableValueCodec, type AzureTextAnswerCursorPayload, createAzureTableStorage, createLegacyAzureTableCodec, defaultAzureTableSubmissionCodec, metadataFiltersToOData, submissionFilterToOData };
+export { type AzureTableClientLike, type AzureTableEntityCodec, type AzureTableEntityIterator, type AzureTableEntityPage, type AzureTableFieldMapping, type AzureTableLegacyCodec, type AzureTableLegacyEntity, type AzureTableListOptions, type AzureTablePageSettings, type AzureTableStorageOptions, type AzureTableSubmissionCodec, type AzureTableValueCodec, type AzureTextAnswerCursorPayload, type LegacyAnswerArrayEntity, type LegacyArrayAzureTableCodec, createAzureTableStorage, createLegacyArrayAzureTableCodec, createLegacyAzureTableCodec, defaultAzureTableSubmissionCodec, metadataFiltersToOData, submissionFilterToOData };

package/dist/index.js

@@ -1,5 +1,56 @@
 // src/index.ts
 import { assertValidFormSchema, 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}`);
@@ -619,6 +670,7 @@ function createAzureTableStorage(options = {}) {
 }
 export {
   createAzureTableStorage,
+  createLegacyArrayAzureTableCodec,
   createLegacyAzureTableCodec,
   defaultAzureTableSubmissionCodec,
   metadataFiltersToOData,

package/package.json

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