@form-engine-ts/storage 6.9.0 → 7.0.0

package/README.md

@@ -13,5 +13,10 @@ The package exports `StorageCursor`, cursor payload contracts, cursor encoders/d
 `maxScanPages` bounds low-density scans, and `totalScannedCount` reports the amount of source data inspected.
 
 `TypedPagedSubmissionStorageAdapter<TMeta>` and `iterateTypedSubmissionPages` preserve application metadata types
-through page fetching. The Azure Table and MongoDB factories expose a typed `fetchPage` when called as
-`createAzureTableStorage<TMeta>(...)` or `createMongoDbStorage<TMeta>(...)`.
+through page fetching. MongoDB and Azure Table expose the same typed `fetchSubmissionPage` arguments and the same
+`{ items, hasMore, nextCursor }` page result when called as `createMongoDbStorage<TMeta>(...)` or
+`createAzureTableStorage<TMeta>(...)`. The older `fetchPage` helper remains available for compatibility.
+
+Both adapters implement the required `UnifiedSubmissionStorageAdapter` surface: typed submission paging and filters,
+free-text answer paging, idempotent saving, typed validation, response aggregation, and CSV export. These common
+operations use the same core contracts regardless of the backing database.

package/dist/index.d.cts

@@ -1,3 +1,3 @@
-export { TypedPagedSubmissionStorageAdapter, TypedSubmissionPage, TypedSubmissionPageQueryOptions, iterateTypedSubmissionPages, paginateWithFilter } from './pagination.cjs';
+export { TypedPagedSubmissionStorageAdapter, iterateTypedSubmissionPages, paginateWithFilter } from './pagination.cjs';
 export { StorageFilterPushdownContract, TenantIsolationOptions } from './types.cjs';
-export { CursorPagingOptions, PaginatedResult, StorageCursor, StorageFilterCriteria, SubmissionCursorPayload, TextAnswerCursorPayload, decodeStorageSubmissionCursor, decodeStorageTextAnswerCursor, encodeStorageSubmissionCursor, encodeStorageTextAnswerCursor } from '@form-engine-ts/core';
+export { CursorPagingOptions, PaginatedResult, StorageCursor, StorageFilterCriteria, StorageSubmissionExportOptions, SubmissionCursorPayload, TextAnswerCursorPayload, TypedSubmissionPage, TypedSubmissionPageQueryOptions, UnifiedSubmissionStorageAdapter, decodeStorageSubmissionCursor, decodeStorageTextAnswerCursor, encodeStorageSubmissionCursor, encodeStorageTextAnswerCursor } from '@form-engine-ts/core';

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { TypedPagedSubmissionStorageAdapter, TypedSubmissionPage, TypedSubmissionPageQueryOptions, iterateTypedSubmissionPages, paginateWithFilter } from './pagination.js';
+export { TypedPagedSubmissionStorageAdapter, iterateTypedSubmissionPages, paginateWithFilter } from './pagination.js';
 export { StorageFilterPushdownContract, TenantIsolationOptions } from './types.js';
-export { CursorPagingOptions, PaginatedResult, StorageCursor, StorageFilterCriteria, SubmissionCursorPayload, TextAnswerCursorPayload, decodeStorageSubmissionCursor, decodeStorageTextAnswerCursor, encodeStorageSubmissionCursor, encodeStorageTextAnswerCursor } from '@form-engine-ts/core';
+export { CursorPagingOptions, PaginatedResult, StorageCursor, StorageFilterCriteria, StorageSubmissionExportOptions, SubmissionCursorPayload, TextAnswerCursorPayload, TypedSubmissionPage, TypedSubmissionPageQueryOptions, UnifiedSubmissionStorageAdapter, decodeStorageSubmissionCursor, decodeStorageTextAnswerCursor, encodeStorageSubmissionCursor, encodeStorageTextAnswerCursor } from '@form-engine-ts/core';

package/dist/pagination.d.cts

@@ -1,18 +1,6 @@
-import { BaseSubmissionMetadata, FormSubmission, StorageCursor, PaginatedResult } from '@form-engine-ts/core';
-export { CursorPagingOptions, PaginatedResult, StorageCursor, decodeStorageSubmissionCursor, decodeStorageTextAnswerCursor, encodeStorageSubmissionCursor, encodeStorageTextAnswerCursor } from '@form-engine-ts/core';
+import { BaseSubmissionMetadata, TypedSubmissionPageQueryOptions, TypedSubmissionPage, FormSubmission, StorageCursor, PaginatedResult } from '@form-engine-ts/core';
+export { CursorPagingOptions, PaginatedResult, StorageCursor, TypedSubmissionPage, TypedSubmissionPageQueryOptions, decodeStorageSubmissionCursor, decodeStorageTextAnswerCursor, encodeStorageSubmissionCursor, encodeStorageTextAnswerCursor } from '@form-engine-ts/core';
 
-interface TypedSubmissionPageQueryOptions<TMeta extends BaseSubmissionMetadata> {
-    readonly pageSize?: number;
-    readonly fromSubmittedAt?: string;
-    readonly toSubmittedAt?: string;
-    readonly locale?: string;
-    readonly metadataFilters?: Partial<TMeta>;
-    readonly cursor?: string;
-}
-interface TypedSubmissionPage<TMeta extends BaseSubmissionMetadata> {
-    readonly items: readonly FormSubmission<TMeta>[];
-    readonly nextCursor?: string;
-}
 interface TypedPagedSubmissionStorageAdapter<TMeta extends BaseSubmissionMetadata> {
     readonly fetchPage: (formId: string, options?: TypedSubmissionPageQueryOptions<TMeta>) => Promise<TypedSubmissionPage<TMeta>>;
 }
@@ -29,4 +17,4 @@ declare function paginateWithFilter<T>(params: {
     readonly encodeCursor: (lastItem: T) => StorageCursor;
 }): Promise<PaginatedResult<T>>;
 
-export { type TypedPagedSubmissionStorageAdapter, type TypedSubmissionPage, type TypedSubmissionPageQueryOptions, iterateTypedSubmissionPages, paginateWithFilter };
+export { type TypedPagedSubmissionStorageAdapter, iterateTypedSubmissionPages, paginateWithFilter };

package/dist/pagination.d.ts

@@ -1,18 +1,6 @@
-import { BaseSubmissionMetadata, FormSubmission, StorageCursor, PaginatedResult } from '@form-engine-ts/core';
-export { CursorPagingOptions, PaginatedResult, StorageCursor, decodeStorageSubmissionCursor, decodeStorageTextAnswerCursor, encodeStorageSubmissionCursor, encodeStorageTextAnswerCursor } from '@form-engine-ts/core';
+import { BaseSubmissionMetadata, TypedSubmissionPageQueryOptions, TypedSubmissionPage, FormSubmission, StorageCursor, PaginatedResult } from '@form-engine-ts/core';
+export { CursorPagingOptions, PaginatedResult, StorageCursor, TypedSubmissionPage, TypedSubmissionPageQueryOptions, decodeStorageSubmissionCursor, decodeStorageTextAnswerCursor, encodeStorageSubmissionCursor, encodeStorageTextAnswerCursor } from '@form-engine-ts/core';
 
-interface TypedSubmissionPageQueryOptions<TMeta extends BaseSubmissionMetadata> {
-    readonly pageSize?: number;
-    readonly fromSubmittedAt?: string;
-    readonly toSubmittedAt?: string;
-    readonly locale?: string;
-    readonly metadataFilters?: Partial<TMeta>;
-    readonly cursor?: string;
-}
-interface TypedSubmissionPage<TMeta extends BaseSubmissionMetadata> {
-    readonly items: readonly FormSubmission<TMeta>[];
-    readonly nextCursor?: string;
-}
 interface TypedPagedSubmissionStorageAdapter<TMeta extends BaseSubmissionMetadata> {
     readonly fetchPage: (formId: string, options?: TypedSubmissionPageQueryOptions<TMeta>) => Promise<TypedSubmissionPage<TMeta>>;
 }
@@ -29,4 +17,4 @@ declare function paginateWithFilter<T>(params: {
     readonly encodeCursor: (lastItem: T) => StorageCursor;
 }): Promise<PaginatedResult<T>>;
 
-export { type TypedPagedSubmissionStorageAdapter, type TypedSubmissionPage, type TypedSubmissionPageQueryOptions, iterateTypedSubmissionPages, paginateWithFilter };
+export { type TypedPagedSubmissionStorageAdapter, iterateTypedSubmissionPages, paginateWithFilter };

package/dist/types.d.cts

@@ -1,5 +1,5 @@
 import { StorageFilterCriteria } from '@form-engine-ts/core';
-export { CursorPagingOptions, PaginatedResult, StorageCursor, StorageFilterCriteria, SubmissionCursorPayload, TextAnswerCursorPayload } from '@form-engine-ts/core';
+export { CursorPagingOptions, PaginatedResult, StorageCursor, StorageFilterCriteria, StorageSubmissionExportOptions, SubmissionCursorPayload, TextAnswerCursorPayload, UnifiedSubmissionStorageAdapter } from '@form-engine-ts/core';
 
 interface StorageFilterPushdownContract {
     readonly supportedMetadataFields: readonly string[];

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import { StorageFilterCriteria } from '@form-engine-ts/core';
-export { CursorPagingOptions, PaginatedResult, StorageCursor, StorageFilterCriteria, SubmissionCursorPayload, TextAnswerCursorPayload } from '@form-engine-ts/core';
+export { CursorPagingOptions, PaginatedResult, StorageCursor, StorageFilterCriteria, StorageSubmissionExportOptions, SubmissionCursorPayload, TextAnswerCursorPayload, UnifiedSubmissionStorageAdapter } from '@form-engine-ts/core';
 
 interface StorageFilterPushdownContract {
     readonly supportedMetadataFields: readonly string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/storage",
-  "version": "6.9.0",
+  "version": "7.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -37,7 +37,7 @@
     "url": "git+https://github.com/nitta-a/form-engine-ts.git"
   },
   "dependencies": {
-    "@form-engine-ts/core": "6.9.0"
+    "@form-engine-ts/core": "7.0.0"
   },
   "scripts": {
     "build": "tsup src/index.ts src/types.ts src/pagination.ts --format esm,cjs --dts --clean --external @form-engine-ts/core",