@form-engine-ts/storage-mongodb 2.3.0 → 2.5.1

package/README.md

@@ -26,3 +26,7 @@ const submissions = await storage.listSubmissions(schema.id, schema.version, {
 ```
 
 The caller owns the MongoDB connection lifecycle. Collection names can be customized in the factory options. `createIndexes()` creates named indexes for form/timestamp range scans and locale queries. Range boundaries are inclusive, and MongoDB sorts by submission time and then ID. `clearResponses(formId)` preserves schemas and other forms; `clear()` removes documents only from the configured collections and does not drop collections or indexes.
+
+`listSubmissionPage(formId, { version, pageSize, cursor, since, until, locale })` performs bounded reads using the
+compound `submittedAt`/response-ID cursor. Run `createIndexes()` after upgrading to create the matching compound index.
+`metadataFilters` and custom `filter` predicates are applied before page sizing.

package/dist/index.cjs

@@ -118,6 +118,38 @@ function createMongoDbStorage(options) {
       }).sort({ submittedAt: 1, _id: 1 }).toArray();
       return documents.map(parseSubmissionDocument);
     },
+    async listSubmissionPage(formId, options2 = {}) {
+      const pageSize = (0, import_core.normalizeSubmissionPageSize)(options2.pageSize);
+      const cursor = options2.cursor === void 0 ? void 0 : (0, import_core.decodeSubmissionCursor)(options2.cursor);
+      const submittedAt = options2.since === void 0 && options2.until === void 0 ? void 0 : {
+        ...options2.since === void 0 ? {} : { $gte: options2.since },
+        ...options2.until === void 0 ? {} : { $lte: options2.until }
+      };
+      const filter = {
+        formId,
+        ...options2.version === void 0 ? {} : { formVersion: options2.version },
+        ...options2.locale === void 0 ? {} : { "submission.locale": options2.locale },
+        ...submittedAt === void 0 ? {} : { submittedAt },
+        ...cursor === void 0 ? {} : {
+          $or: [
+            { submittedAt: { $gt: cursor.submittedAt } },
+            { submittedAt: cursor.submittedAt, _id: { $gt: cursor.responseId } }
+          ]
+        }
+      };
+      const sorted = submissions.find(filter).sort({ submittedAt: 1, _id: 1 });
+      const requiresClientFiltering = options2.filter !== void 0 || options2.metadataFilters !== void 0;
+      const documents = requiresClientFiltering ? await sorted.toArray() : await sorted.limit(pageSize + 1).toArray();
+      const candidates = documents.map(parseSubmissionDocument).filter((item) => (0, import_core.matchesSubmissionPageFilters)(item, options2));
+      const hasMore = candidates.length > pageSize;
+      const items = candidates.slice(0, pageSize);
+      const last = items.at(-1);
+      return {
+        items,
+        hasMore,
+        ...hasMore && last !== void 0 ? { nextCursor: (0, import_core.encodeSubmissionCursor)({ submittedAt: last.submittedAt, responseId: last.id }) } : {}
+      };
+    },
     async deleteSubmission(submissionId) {
       await submissions.deleteOne({ _id: submissionId });
     },
@@ -129,7 +161,7 @@ function createMongoDbStorage(options) {
     },
     async createIndexes() {
       await submissions.createIndexes([
-        { key: { formId: 1, submittedAt: 1 }, name: "form_responses_form_submitted_at" },
+        { key: { formId: 1, submittedAt: 1, _id: 1 }, name: "form_responses_form_submitted_at_id" },
         { key: { "submission.locale": 1 }, name: "form_responses_locale" }
       ]);
     }

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { FormStorageAdapter } from '@form-engine-ts/core';
+import { PagedSubmissionStorageAdapter } from '@form-engine-ts/core';
 import { Db } from 'mongodb';
 
 interface MongoDbStorageOptions {
@@ -6,7 +6,7 @@ interface MongoDbStorageOptions {
     readonly schemasCollectionName?: string;
     readonly responsesCollectionName?: string;
 }
-interface MongoDbStorageAdapter extends FormStorageAdapter {
+interface MongoDbStorageAdapter extends PagedSubmissionStorageAdapter {
     createIndexes(): Promise<void>;
 }
 declare function createMongoDbStorage(options: MongoDbStorageOptions): MongoDbStorageAdapter;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { FormStorageAdapter } from '@form-engine-ts/core';
+import { PagedSubmissionStorageAdapter } from '@form-engine-ts/core';
 import { Db } from 'mongodb';
 
 interface MongoDbStorageOptions {
@@ -6,7 +6,7 @@ interface MongoDbStorageOptions {
     readonly schemasCollectionName?: string;
     readonly responsesCollectionName?: string;
 }
-interface MongoDbStorageAdapter extends FormStorageAdapter {
+interface MongoDbStorageAdapter extends PagedSubmissionStorageAdapter {
     createIndexes(): Promise<void>;
 }
 declare function createMongoDbStorage(options: MongoDbStorageOptions): MongoDbStorageAdapter;

package/dist/index.js

@@ -1,5 +1,11 @@
 // src/index.ts
-import { assertValidFormSchema } from "@form-engine-ts/core";
+import {
+  assertValidFormSchema,
+  decodeSubmissionCursor,
+  encodeSubmissionCursor,
+  matchesSubmissionPageFilters,
+  normalizeSubmissionPageSize
+} from "@form-engine-ts/core";
 function cloneJson(value) {
   return JSON.parse(JSON.stringify(value));
 }
@@ -94,6 +100,38 @@ function createMongoDbStorage(options) {
       }).sort({ submittedAt: 1, _id: 1 }).toArray();
       return documents.map(parseSubmissionDocument);
     },
+    async listSubmissionPage(formId, options2 = {}) {
+      const pageSize = normalizeSubmissionPageSize(options2.pageSize);
+      const cursor = options2.cursor === void 0 ? void 0 : decodeSubmissionCursor(options2.cursor);
+      const submittedAt = options2.since === void 0 && options2.until === void 0 ? void 0 : {
+        ...options2.since === void 0 ? {} : { $gte: options2.since },
+        ...options2.until === void 0 ? {} : { $lte: options2.until }
+      };
+      const filter = {
+        formId,
+        ...options2.version === void 0 ? {} : { formVersion: options2.version },
+        ...options2.locale === void 0 ? {} : { "submission.locale": options2.locale },
+        ...submittedAt === void 0 ? {} : { submittedAt },
+        ...cursor === void 0 ? {} : {
+          $or: [
+            { submittedAt: { $gt: cursor.submittedAt } },
+            { submittedAt: cursor.submittedAt, _id: { $gt: cursor.responseId } }
+          ]
+        }
+      };
+      const sorted = submissions.find(filter).sort({ submittedAt: 1, _id: 1 });
+      const requiresClientFiltering = options2.filter !== void 0 || options2.metadataFilters !== void 0;
+      const documents = requiresClientFiltering ? await sorted.toArray() : await sorted.limit(pageSize + 1).toArray();
+      const candidates = documents.map(parseSubmissionDocument).filter((item) => matchesSubmissionPageFilters(item, options2));
+      const hasMore = candidates.length > pageSize;
+      const items = candidates.slice(0, pageSize);
+      const last = items.at(-1);
+      return {
+        items,
+        hasMore,
+        ...hasMore && last !== void 0 ? { nextCursor: encodeSubmissionCursor({ submittedAt: last.submittedAt, responseId: last.id }) } : {}
+      };
+    },
     async deleteSubmission(submissionId) {
       await submissions.deleteOne({ _id: submissionId });
     },
@@ -105,7 +143,7 @@ function createMongoDbStorage(options) {
     },
     async createIndexes() {
       await submissions.createIndexes([
-        { key: { formId: 1, submittedAt: 1 }, name: "form_responses_form_submitted_at" },
+        { key: { formId: 1, submittedAt: 1, _id: 1 }, name: "form_responses_form_submitted_at_id" },
         { key: { "submission.locale": 1 }, name: "form_responses_locale" }
       ]);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/storage-mongodb",
-  "version": "2.3.0",
+  "version": "2.5.1",
   "publishConfig": {
     "access": "public"
   },
@@ -39,7 +39,7 @@
     "typescript"
   ],
   "dependencies": {
-    "@form-engine-ts/core": "2.3.0"
+    "@form-engine-ts/core": "2.5.1"
   },
   "peerDependencies": {
     "mongodb": "^6.0.0"