@form-engine-ts/storage 7.17.3 → 7.18.1

package/README.md

@@ -20,3 +20,20 @@ through page fetching. MongoDB and Azure Table expose the same typed `fetchSubmi
 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.
+
+The `./testing` subpath exports framework-independent JSON fixtures and contract runners for pagination,
+idempotency, revision conflicts, translation metadata, CSV, and form deletion. Adapters expose
+`inspectFormDeletion` and `deleteForm` through the lifecycle contract when their implementation supports it;
+transactional deletion is required by default and `allowNonAtomic: true` is an explicit fallback.
+
+| Package | 7.18.x contract status |
+| --- | --- |
+| `storage-memory` | lifecycle, pagination, idempotency |
+| `storage-mongodb` | lifecycle, version state/events, transactions |
+| `storage-azure-table` | lifecycle, pagination; no native transaction |
+| `storage-postgres` / `storage-sqlite` / `storage-d1` | lifecycle, pagination; transaction depends on injected client |
+| `storage-localstorage` | lifecycle, pagination; non-atomic only |
+
+Existing `StorageAdapter` methods remain valid. To migrate, pass `schemaValidation` to an adapter when
+Content Mode policy must be enforced at persistence, then use `inspectFormDeletion` before deletion and
+handle `transaction_unsupported` explicitly for adapters without transactions.

package/dist/testing.cjs

@@ -0,0 +1,202 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/testing.ts
+var testing_exports = {};
+__export(testing_exports, {
+  createStorageContractFixtures: () => createStorageContractFixtures,
+  runIdempotencyContract: () => runIdempotencyContract,
+  runLifecycleContract: () => runLifecycleContract,
+  runRevisionConflictContract: () => runRevisionConflictContract,
+  runStorageContract: () => runStorageContract,
+  storageContractScope: () => storageContractScope,
+  verifyStorageCodecVectors: () => verifyStorageCodecVectors
+});
+module.exports = __toCommonJS(testing_exports);
+var import_core = require("@form-engine-ts/core");
+function createStorageContractFixtures() {
+  const schema = {
+    ...(0, import_core.createInitialSchemaByMode)("poll", { id: "contract-form", title: "Contract", locale: "en" }),
+    supportedLocales: ["en", "ja"],
+    metadata: { mode: "poll", tenantId: "tenant-a", ownerId: "owner-a", custom: { nested: [true, 2, "three"] } },
+    translationMetadata: { ja: { title: { provider: "fixture", translationSource: "manual", custom: "retained" } } }
+  };
+  const submissions = ["a", "b", "c"].map((id) => ({
+    id: `contract-${id}`,
+    formId: schema.id,
+    formVersion: schema.version,
+    locale: id === "c" ? "ja" : "en",
+    submittedAt: "2026-01-01T00:00:00.000Z",
+    values: { "question-1": "option-1" },
+    metadata: { tenantId: "tenant-a", ownerId: "owner-a", custom: { source: id } },
+    translationMetadata: { ja: { "question-1": { provider: "fixture", translationSource: "manual" } } }
+  }));
+  const state = { formId: schema.id, nextVersion: 2, revision: 0, publishedVersion: 1 };
+  return {
+    schema,
+    submissions,
+    state,
+    revisionConflict: { expectedRevision: 1, actualRevision: 0 },
+    cursor: { submittedAt: "2026-01-01T00:00:00.000Z", responseId: "contract-a" },
+    invalidCursors: ["not-a-cursor", "%", "{}"],
+    csv: {
+      options: { withBom: false },
+      expected: "submissionId,submittedAt,locale,question-1\r\ncontract-a,2026-01-01T00:00:00.000Z,en,option-1\r\ncontract-b,2026-01-01T00:00:00.000Z,en,option-1\r\ncontract-c,2026-01-01T00:00:00.000Z,ja,option-1"
+    }
+  };
+}
+function storageContractScope(resource) {
+  const value = resource.value;
+  if (typeof value !== "object" || value === null || !("metadata" in value)) return {};
+  const metadata = value.metadata;
+  if (typeof metadata !== "object" || metadata === null) return {};
+  return {
+    ..."tenantId" in metadata && typeof metadata.tenantId === "string" ? { tenantId: metadata.tenantId } : {},
+    ..."ownerId" in metadata && typeof metadata.ownerId === "string" ? { ownerId: metadata.ownerId } : {}
+  };
+}
+function check(condition, message) {
+  if (!condition) throw new Error(`Storage contract: ${message}`);
+}
+async function runStorageContract(adapter) {
+  const { schema, submissions } = createStorageContractFixtures();
+  await adapter.saveSchema(schema);
+  const stored = await adapter.getSchema(schema.id, schema.version);
+  check(JSON.stringify(stored) === JSON.stringify(schema), "schema JSON/translation metadata round trip");
+  for (const submission of submissions) await adapter.saveSubmission(submission);
+  const loaded = await adapter.listSubmissions(schema.id, schema.version);
+  check(JSON.stringify(loaded) === JSON.stringify(submissions), "submission ordering/metadata round trip");
+  const passed = ["schema", "submission", "translation_metadata"];
+  const unsupported = [];
+  if ("listSubmissionPage" in adapter && typeof adapter.listSubmissionPage === "function") {
+    const paged = adapter;
+    const ids = [];
+    let cursor;
+    for (let index = 0; index < 10; index++) {
+      const page = await paged.listSubmissionPage(schema.id, {
+        pageSize: 1,
+        ...cursor === void 0 ? {} : { cursor }
+      });
+      ids.push(...page.items.map((item) => item.id));
+      if (!page.hasMore) break;
+      check(page.nextCursor !== void 0 && page.nextCursor !== cursor, "pagination must make progress");
+      cursor = page.nextCursor;
+    }
+    check(
+      JSON.stringify(ids) === JSON.stringify(submissions.map((item) => item.id)),
+      "pagination must not lose or repeat records"
+    );
+    passed.push("pagination");
+  } else unsupported.push("pagination");
+  return { passed, unsupported };
+}
+async function runIdempotencyContract(save) {
+  const [submission] = createStorageContractFixtures().submissions;
+  if (submission === void 0) throw new Error("Missing fixture");
+  check((await save(submission))?.status === "created", "first idempotent save");
+  check((await save(submission))?.status === "duplicate", "retry must be a duplicate");
+  check(
+    (await save({ ...submission, values: { "question-1": "option-2" } }))?.status === "conflict",
+    "changed payload must conflict"
+  );
+}
+async function runRevisionConflictContract(adapter) {
+  const { schema, state } = createStorageContractFixtures();
+  const planned = (0, import_core.createCloneTransitionPlan)(
+    state,
+    { formId: schema.id, version: 1, status: "published", schema, revision: 1, createdAt: "2026-01-01T00:00:00.000Z" },
+    { expectedRevision: 0, clonedAt: "2026-01-01T00:00:00.000Z" }
+  );
+  check(planned.success, "valid transition fixture");
+  const first = await adapter.commitVersionTransition(planned.value.plan);
+  check(first.success, "first transition commits");
+  const retry = await adapter.commitVersionTransition(planned.value.plan);
+  check(!retry.success && retry.error.type === "revision_conflict", "stale transition conflicts");
+}
+async function runLifecycleContract(adapter) {
+  if (adapter.inspectFormDeletion === void 0 || adapter.deleteForm === void 0 || adapter.lifecycleCapabilities === void 0)
+    throw new Error("Adapter does not expose the lifecycle contract.");
+  const lifecycle = adapter;
+  const { schema, submissions } = createStorageContractFixtures();
+  const submission = submissions[0];
+  if (submission === void 0) throw new Error("Missing fixture");
+  await adapter.saveSchema(schema);
+  await adapter.saveSubmission(submission);
+  await adapter.saveSchema({ ...schema, id: "contract-other" });
+  await adapter.saveSchema({ ...schema, version: 2, metadata: { tenantId: "tenant-b", ownerId: "owner-a" } });
+  await adapter.saveSchema({ ...schema, version: 3, metadata: { tenantId: "tenant-a", ownerId: "owner-b" } });
+  const request = { formId: schema.id, tenantId: "tenant-a", ownerId: "owner-a" };
+  const inspection = await lifecycle.inspectFormDeletion({ ...request, pageSize: 1 });
+  check(inspection.counts.schema === 1 && inspection.counts.submission === 1, "scope inspection counts");
+  check(inspection.targets.length === 1 && inspection.nextCursor !== void 0, "inspection pagination");
+  const next = await lifecycle.inspectFormDeletion({ ...request, pageSize: 1, cursor: inspection.nextCursor });
+  check(next.targets.length === 1 && next.targets[0]?.id !== inspection.targets[0]?.id, "inspection next page");
+  check((await lifecycle.deleteForm({ ...request, dryRun: true })).status === "dry_run", "dry run result");
+  check((await adapter.listSubmissions(schema.id)).length === 1, "dry run must not mutate");
+  if (!lifecycle.lifecycleCapabilities.atomic) {
+    check(
+      (await lifecycle.deleteForm(request)).error?.code === "transaction_unsupported",
+      "atomic default rejects unsupported storage"
+    );
+    check((await adapter.listSubmissions(schema.id)).length === 1, "unsupported transaction must not mutate");
+  }
+  const result = await lifecycle.deleteForm({ ...request, allowNonAtomic: true });
+  check(
+    result.status === "deleted" && result.counts.schema === 1 && result.counts.submission === 1,
+    "actual deletion counts"
+  );
+  check(await adapter.getSchema("contract-other", 1) !== null, "other form survives");
+  check(await adapter.getSchema(schema.id, 2) !== null, "other tenant survives");
+  check(await adapter.getSchema(schema.id, 3) !== null, "other owner survives");
+  const retry = await lifecycle.deleteForm({ ...request, allowNonAtomic: true });
+  check(
+    retry.status === "deleted" && Object.values(retry.counts).every((count) => count === 0),
+    "deletion retry is empty"
+  );
+}
+function verifyStorageCodecVectors() {
+  const fixtures = createStorageContractFixtures();
+  check(
+    JSON.stringify((0, import_core.decodeSubmissionCursor)((0, import_core.encodeSubmissionCursor)(fixtures.cursor))) === JSON.stringify(fixtures.cursor),
+    "cursor round trip"
+  );
+  for (const cursor of fixtures.invalidCursors) {
+    let rejected = false;
+    try {
+      (0, import_core.decodeSubmissionCursor)(cursor);
+    } catch {
+      rejected = true;
+    }
+    check(rejected, "invalid cursor rejection");
+  }
+  check(
+    (0, import_core.exportResponsesToCsv)(fixtures.schema, fixtures.submissions, fixtures.csv.options) === fixtures.csv.expected,
+    "CSV fixture output"
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createStorageContractFixtures,
+  runIdempotencyContract,
+  runLifecycleContract,
+  runRevisionConflictContract,
+  runStorageContract,
+  storageContractScope,
+  verifyStorageCodecVectors
+});

package/dist/testing.d.cts

@@ -0,0 +1,39 @@
+import { FormSchema, FormSubmission, FormVersionState, SubmissionSaveResult, FormStorageAdapter, VersionedFormStorageAdapter, FormResource } from '@form-engine-ts/core';
+
+/** Fresh JSON fixtures: callers may customize a copy without contaminating another adapter's run. */
+declare function createStorageContractFixtures(): {
+    schema: FormSchema;
+    submissions: readonly FormSubmission[];
+    state: FormVersionState;
+    revisionConflict: {
+        expectedRevision: number;
+        actualRevision: number;
+    };
+    cursor: {
+        submittedAt: string;
+        responseId: string;
+    };
+    invalidCursors: string[];
+    csv: {
+        options: {
+            withBom: boolean;
+        };
+        expected: string;
+    };
+};
+declare function storageContractScope(resource: FormResource): {
+    tenantId?: string;
+    ownerId?: string;
+};
+interface StorageContractReport {
+    readonly passed: readonly string[];
+    readonly unsupported: readonly string[];
+}
+/** Run against an empty, disposable adapter. Never clears a caller's database. */
+declare function runStorageContract(adapter: FormStorageAdapter): Promise<StorageContractReport>;
+declare function runIdempotencyContract(save: (submission: FormSubmission) => Promise<undefined | SubmissionSaveResult>): Promise<void>;
+declare function runRevisionConflictContract(adapter: VersionedFormStorageAdapter): Promise<void>;
+declare function runLifecycleContract(adapter: FormStorageAdapter): Promise<void>;
+declare function verifyStorageCodecVectors(): void;
+
+export { type StorageContractReport, createStorageContractFixtures, runIdempotencyContract, runLifecycleContract, runRevisionConflictContract, runStorageContract, storageContractScope, verifyStorageCodecVectors };

package/dist/testing.d.ts

@@ -0,0 +1,39 @@
+import { FormSchema, FormSubmission, FormVersionState, SubmissionSaveResult, FormStorageAdapter, VersionedFormStorageAdapter, FormResource } from '@form-engine-ts/core';
+
+/** Fresh JSON fixtures: callers may customize a copy without contaminating another adapter's run. */
+declare function createStorageContractFixtures(): {
+    schema: FormSchema;
+    submissions: readonly FormSubmission[];
+    state: FormVersionState;
+    revisionConflict: {
+        expectedRevision: number;
+        actualRevision: number;
+    };
+    cursor: {
+        submittedAt: string;
+        responseId: string;
+    };
+    invalidCursors: string[];
+    csv: {
+        options: {
+            withBom: boolean;
+        };
+        expected: string;
+    };
+};
+declare function storageContractScope(resource: FormResource): {
+    tenantId?: string;
+    ownerId?: string;
+};
+interface StorageContractReport {
+    readonly passed: readonly string[];
+    readonly unsupported: readonly string[];
+}
+/** Run against an empty, disposable adapter. Never clears a caller's database. */
+declare function runStorageContract(adapter: FormStorageAdapter): Promise<StorageContractReport>;
+declare function runIdempotencyContract(save: (submission: FormSubmission) => Promise<undefined | SubmissionSaveResult>): Promise<void>;
+declare function runRevisionConflictContract(adapter: VersionedFormStorageAdapter): Promise<void>;
+declare function runLifecycleContract(adapter: FormStorageAdapter): Promise<void>;
+declare function verifyStorageCodecVectors(): void;
+
+export { type StorageContractReport, createStorageContractFixtures, runIdempotencyContract, runLifecycleContract, runRevisionConflictContract, runStorageContract, storageContractScope, verifyStorageCodecVectors };

package/dist/testing.js

@@ -0,0 +1,177 @@
+// src/testing.ts
+import {
+  createCloneTransitionPlan,
+  createInitialSchemaByMode,
+  decodeSubmissionCursor,
+  encodeSubmissionCursor,
+  exportResponsesToCsv
+} from "@form-engine-ts/core";
+function createStorageContractFixtures() {
+  const schema = {
+    ...createInitialSchemaByMode("poll", { id: "contract-form", title: "Contract", locale: "en" }),
+    supportedLocales: ["en", "ja"],
+    metadata: { mode: "poll", tenantId: "tenant-a", ownerId: "owner-a", custom: { nested: [true, 2, "three"] } },
+    translationMetadata: { ja: { title: { provider: "fixture", translationSource: "manual", custom: "retained" } } }
+  };
+  const submissions = ["a", "b", "c"].map((id) => ({
+    id: `contract-${id}`,
+    formId: schema.id,
+    formVersion: schema.version,
+    locale: id === "c" ? "ja" : "en",
+    submittedAt: "2026-01-01T00:00:00.000Z",
+    values: { "question-1": "option-1" },
+    metadata: { tenantId: "tenant-a", ownerId: "owner-a", custom: { source: id } },
+    translationMetadata: { ja: { "question-1": { provider: "fixture", translationSource: "manual" } } }
+  }));
+  const state = { formId: schema.id, nextVersion: 2, revision: 0, publishedVersion: 1 };
+  return {
+    schema,
+    submissions,
+    state,
+    revisionConflict: { expectedRevision: 1, actualRevision: 0 },
+    cursor: { submittedAt: "2026-01-01T00:00:00.000Z", responseId: "contract-a" },
+    invalidCursors: ["not-a-cursor", "%", "{}"],
+    csv: {
+      options: { withBom: false },
+      expected: "submissionId,submittedAt,locale,question-1\r\ncontract-a,2026-01-01T00:00:00.000Z,en,option-1\r\ncontract-b,2026-01-01T00:00:00.000Z,en,option-1\r\ncontract-c,2026-01-01T00:00:00.000Z,ja,option-1"
+    }
+  };
+}
+function storageContractScope(resource) {
+  const value = resource.value;
+  if (typeof value !== "object" || value === null || !("metadata" in value)) return {};
+  const metadata = value.metadata;
+  if (typeof metadata !== "object" || metadata === null) return {};
+  return {
+    ..."tenantId" in metadata && typeof metadata.tenantId === "string" ? { tenantId: metadata.tenantId } : {},
+    ..."ownerId" in metadata && typeof metadata.ownerId === "string" ? { ownerId: metadata.ownerId } : {}
+  };
+}
+function check(condition, message) {
+  if (!condition) throw new Error(`Storage contract: ${message}`);
+}
+async function runStorageContract(adapter) {
+  const { schema, submissions } = createStorageContractFixtures();
+  await adapter.saveSchema(schema);
+  const stored = await adapter.getSchema(schema.id, schema.version);
+  check(JSON.stringify(stored) === JSON.stringify(schema), "schema JSON/translation metadata round trip");
+  for (const submission of submissions) await adapter.saveSubmission(submission);
+  const loaded = await adapter.listSubmissions(schema.id, schema.version);
+  check(JSON.stringify(loaded) === JSON.stringify(submissions), "submission ordering/metadata round trip");
+  const passed = ["schema", "submission", "translation_metadata"];
+  const unsupported = [];
+  if ("listSubmissionPage" in adapter && typeof adapter.listSubmissionPage === "function") {
+    const paged = adapter;
+    const ids = [];
+    let cursor;
+    for (let index = 0; index < 10; index++) {
+      const page = await paged.listSubmissionPage(schema.id, {
+        pageSize: 1,
+        ...cursor === void 0 ? {} : { cursor }
+      });
+      ids.push(...page.items.map((item) => item.id));
+      if (!page.hasMore) break;
+      check(page.nextCursor !== void 0 && page.nextCursor !== cursor, "pagination must make progress");
+      cursor = page.nextCursor;
+    }
+    check(
+      JSON.stringify(ids) === JSON.stringify(submissions.map((item) => item.id)),
+      "pagination must not lose or repeat records"
+    );
+    passed.push("pagination");
+  } else unsupported.push("pagination");
+  return { passed, unsupported };
+}
+async function runIdempotencyContract(save) {
+  const [submission] = createStorageContractFixtures().submissions;
+  if (submission === void 0) throw new Error("Missing fixture");
+  check((await save(submission))?.status === "created", "first idempotent save");
+  check((await save(submission))?.status === "duplicate", "retry must be a duplicate");
+  check(
+    (await save({ ...submission, values: { "question-1": "option-2" } }))?.status === "conflict",
+    "changed payload must conflict"
+  );
+}
+async function runRevisionConflictContract(adapter) {
+  const { schema, state } = createStorageContractFixtures();
+  const planned = createCloneTransitionPlan(
+    state,
+    { formId: schema.id, version: 1, status: "published", schema, revision: 1, createdAt: "2026-01-01T00:00:00.000Z" },
+    { expectedRevision: 0, clonedAt: "2026-01-01T00:00:00.000Z" }
+  );
+  check(planned.success, "valid transition fixture");
+  const first = await adapter.commitVersionTransition(planned.value.plan);
+  check(first.success, "first transition commits");
+  const retry = await adapter.commitVersionTransition(planned.value.plan);
+  check(!retry.success && retry.error.type === "revision_conflict", "stale transition conflicts");
+}
+async function runLifecycleContract(adapter) {
+  if (adapter.inspectFormDeletion === void 0 || adapter.deleteForm === void 0 || adapter.lifecycleCapabilities === void 0)
+    throw new Error("Adapter does not expose the lifecycle contract.");
+  const lifecycle = adapter;
+  const { schema, submissions } = createStorageContractFixtures();
+  const submission = submissions[0];
+  if (submission === void 0) throw new Error("Missing fixture");
+  await adapter.saveSchema(schema);
+  await adapter.saveSubmission(submission);
+  await adapter.saveSchema({ ...schema, id: "contract-other" });
+  await adapter.saveSchema({ ...schema, version: 2, metadata: { tenantId: "tenant-b", ownerId: "owner-a" } });
+  await adapter.saveSchema({ ...schema, version: 3, metadata: { tenantId: "tenant-a", ownerId: "owner-b" } });
+  const request = { formId: schema.id, tenantId: "tenant-a", ownerId: "owner-a" };
+  const inspection = await lifecycle.inspectFormDeletion({ ...request, pageSize: 1 });
+  check(inspection.counts.schema === 1 && inspection.counts.submission === 1, "scope inspection counts");
+  check(inspection.targets.length === 1 && inspection.nextCursor !== void 0, "inspection pagination");
+  const next = await lifecycle.inspectFormDeletion({ ...request, pageSize: 1, cursor: inspection.nextCursor });
+  check(next.targets.length === 1 && next.targets[0]?.id !== inspection.targets[0]?.id, "inspection next page");
+  check((await lifecycle.deleteForm({ ...request, dryRun: true })).status === "dry_run", "dry run result");
+  check((await adapter.listSubmissions(schema.id)).length === 1, "dry run must not mutate");
+  if (!lifecycle.lifecycleCapabilities.atomic) {
+    check(
+      (await lifecycle.deleteForm(request)).error?.code === "transaction_unsupported",
+      "atomic default rejects unsupported storage"
+    );
+    check((await adapter.listSubmissions(schema.id)).length === 1, "unsupported transaction must not mutate");
+  }
+  const result = await lifecycle.deleteForm({ ...request, allowNonAtomic: true });
+  check(
+    result.status === "deleted" && result.counts.schema === 1 && result.counts.submission === 1,
+    "actual deletion counts"
+  );
+  check(await adapter.getSchema("contract-other", 1) !== null, "other form survives");
+  check(await adapter.getSchema(schema.id, 2) !== null, "other tenant survives");
+  check(await adapter.getSchema(schema.id, 3) !== null, "other owner survives");
+  const retry = await lifecycle.deleteForm({ ...request, allowNonAtomic: true });
+  check(
+    retry.status === "deleted" && Object.values(retry.counts).every((count) => count === 0),
+    "deletion retry is empty"
+  );
+}
+function verifyStorageCodecVectors() {
+  const fixtures = createStorageContractFixtures();
+  check(
+    JSON.stringify(decodeSubmissionCursor(encodeSubmissionCursor(fixtures.cursor))) === JSON.stringify(fixtures.cursor),
+    "cursor round trip"
+  );
+  for (const cursor of fixtures.invalidCursors) {
+    let rejected = false;
+    try {
+      decodeSubmissionCursor(cursor);
+    } catch {
+      rejected = true;
+    }
+    check(rejected, "invalid cursor rejection");
+  }
+  check(
+    exportResponsesToCsv(fixtures.schema, fixtures.submissions, fixtures.csv.options) === fixtures.csv.expected,
+    "CSV fixture output"
+  );
+}
+export {
+  createStorageContractFixtures,
+  runIdempotencyContract,
+  runLifecycleContract,
+  runRevisionConflictContract,
+  runStorageContract,
+  storageContractScope,
+  verifyStorageCodecVectors
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/storage",
-  "version": "7.17.3",
+  "version": "7.18.1",
   "publishConfig": {
     "access": "public"
   },
@@ -29,6 +29,11 @@
       "types": "./dist/pagination.d.ts",
       "import": "./dist/pagination.js",
       "require": "./dist/pagination.cjs"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "require": "./dist/testing.cjs"
     }
   },
   "license": "MIT",
@@ -37,10 +42,10 @@
     "url": "git+https://github.com/nitta-a/form-engine-ts.git"
   },
   "dependencies": {
-    "@form-engine-ts/core": "7.17.3"
+    "@form-engine-ts/core": "7.18.1"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/types.ts src/pagination.ts --format esm,cjs --dts --clean --external @form-engine-ts/core",
+    "build": "tsup src/index.ts src/types.ts src/pagination.ts src/testing.ts --format esm,cjs --dts --clean --external @form-engine-ts/core",
     "check": "biome check . && tsc --noEmit",
     "test": "vitest run --globals",
     "typecheck": "tsc --noEmit"