@form-engine-ts/storage 7.18.0 → 8.0.0

package/README.md

@@ -21,6 +21,12 @@ Both adapters implement the required `UnifiedSubmissionStorageAdapter` surface:
 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.
 
+## Migration notes
+
+`StorageAdapter`, `TypedStorageAdapter`, and `UnifiedSubmissionStorageAdapter` now require
+`countSubmissions(formId, formVersion?, options?)`. Implementations must apply inclusive `since` and `until` filters
+from `SubmissionQueryOptions`; submission pipelines no longer fall back to scanning every page.
+
 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;

package/dist/testing.cjs

@@ -84,6 +84,23 @@ async function runStorageContract(adapter) {
   check(JSON.stringify(loaded) === JSON.stringify(submissions), "submission ordering/metadata round trip");
   const passed = ["schema", "submission", "translation_metadata"];
   const unsupported = [];
+  check(await adapter.countSubmissions(schema.id) === submissions.length, "count must include all form versions");
+  check(
+    await adapter.countSubmissions(schema.id, schema.version) === submissions.length,
+    "count must filter by form version"
+  );
+  check(
+    await adapter.countSubmissions(schema.id, schema.version, {
+      since: "2026-01-01T00:00:00.000Z",
+      until: "2026-01-01T00:00:00.000Z"
+    }) === submissions.length,
+    "count must include since/until boundaries"
+  );
+  check(
+    await adapter.countSubmissions(schema.id, schema.version, { since: "2026-01-01T00:00:00.001Z" }) === 0,
+    "count must filter by submission time"
+  );
+  passed.push("count");
   if ("listSubmissionPage" in adapter && typeof adapter.listSubmissionPage === "function") {
     const paged = adapter;
     const ids = [];

package/dist/testing.js

@@ -60,6 +60,23 @@ async function runStorageContract(adapter) {
   check(JSON.stringify(loaded) === JSON.stringify(submissions), "submission ordering/metadata round trip");
   const passed = ["schema", "submission", "translation_metadata"];
   const unsupported = [];
+  check(await adapter.countSubmissions(schema.id) === submissions.length, "count must include all form versions");
+  check(
+    await adapter.countSubmissions(schema.id, schema.version) === submissions.length,
+    "count must filter by form version"
+  );
+  check(
+    await adapter.countSubmissions(schema.id, schema.version, {
+      since: "2026-01-01T00:00:00.000Z",
+      until: "2026-01-01T00:00:00.000Z"
+    }) === submissions.length,
+    "count must include since/until boundaries"
+  );
+  check(
+    await adapter.countSubmissions(schema.id, schema.version, { since: "2026-01-01T00:00:00.001Z" }) === 0,
+    "count must filter by submission time"
+  );
+  passed.push("count");
   if ("listSubmissionPage" in adapter && typeof adapter.listSubmissionPage === "function") {
     const paged = adapter;
     const ids = [];

package/package.json

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