@form-engine-ts/storage-mongodb 1.0.0 → 1.1.0

package/README.md

@@ -17,7 +17,12 @@ import { MongoClient } from "mongodb";
 const client = await new MongoClient(process.env.MONGODB_URI!).connect();
 const storage = createMongoDbStorage({ db: client.db("forms") });
 
+await storage.createIndexes();
 await storage.saveSchema(schema);
+const submissions = await storage.listSubmissions(schema.id, schema.version, {
+  since: "2026-01-01T00:00:00.000Z",
+  until: "2026-01-31T23:59:59.999Z"
+});
 ```
 
-The caller owns the MongoDB connection lifecycle. Collection names can be customized in the factory options.
+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.

package/dist/index.cjs

@@ -106,9 +106,17 @@ function createMongoDbStorage(options) {
         submission: stored
       });
     },
-    async listSubmissions(formId, formVersion) {
-      const documents = await submissions.find({ formId, ...formVersion === void 0 ? {} : { formVersion } }).toArray();
-      return documents.map(parseSubmissionDocument).sort((left, right) => left.submittedAt.localeCompare(right.submittedAt) || left.id.localeCompare(right.id));
+    async listSubmissions(formId, formVersion, options2) {
+      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 documents = await submissions.find({
+        formId,
+        ...formVersion === void 0 ? {} : { formVersion },
+        ...submittedAt === void 0 ? {} : { submittedAt }
+      }).sort({ submittedAt: 1, _id: 1 }).toArray();
+      return documents.map(parseSubmissionDocument);
     },
     async deleteSubmission(submissionId) {
       await submissions.deleteOne({ _id: submissionId });
@@ -118,6 +126,12 @@ function createMongoDbStorage(options) {
     },
     async clear() {
       await Promise.all([schemas.deleteMany({}), submissions.deleteMany({})]);
+    },
+    async createIndexes() {
+      await submissions.createIndexes([
+        { key: { formId: 1, submittedAt: 1 }, name: "form_responses_form_submitted_at" },
+        { key: { "submission.locale": 1 }, name: "form_responses_locale" }
+      ]);
     }
   };
 }

package/dist/index.d.cts

@@ -6,6 +6,9 @@ interface MongoDbStorageOptions {
     readonly schemasCollectionName?: string;
     readonly responsesCollectionName?: string;
 }
-declare function createMongoDbStorage(options: MongoDbStorageOptions): FormStorageAdapter;
+interface MongoDbStorageAdapter extends FormStorageAdapter {
+    createIndexes(): Promise<void>;
+}
+declare function createMongoDbStorage(options: MongoDbStorageOptions): MongoDbStorageAdapter;
 
-export { type MongoDbStorageOptions, createMongoDbStorage };
+export { type MongoDbStorageAdapter, type MongoDbStorageOptions, createMongoDbStorage };

package/dist/index.d.ts

@@ -6,6 +6,9 @@ interface MongoDbStorageOptions {
     readonly schemasCollectionName?: string;
     readonly responsesCollectionName?: string;
 }
-declare function createMongoDbStorage(options: MongoDbStorageOptions): FormStorageAdapter;
+interface MongoDbStorageAdapter extends FormStorageAdapter {
+    createIndexes(): Promise<void>;
+}
+declare function createMongoDbStorage(options: MongoDbStorageOptions): MongoDbStorageAdapter;
 
-export { type MongoDbStorageOptions, createMongoDbStorage };
+export { type MongoDbStorageAdapter, type MongoDbStorageOptions, createMongoDbStorage };

package/dist/index.js

@@ -82,9 +82,17 @@ function createMongoDbStorage(options) {
         submission: stored
       });
     },
-    async listSubmissions(formId, formVersion) {
-      const documents = await submissions.find({ formId, ...formVersion === void 0 ? {} : { formVersion } }).toArray();
-      return documents.map(parseSubmissionDocument).sort((left, right) => left.submittedAt.localeCompare(right.submittedAt) || left.id.localeCompare(right.id));
+    async listSubmissions(formId, formVersion, options2) {
+      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 documents = await submissions.find({
+        formId,
+        ...formVersion === void 0 ? {} : { formVersion },
+        ...submittedAt === void 0 ? {} : { submittedAt }
+      }).sort({ submittedAt: 1, _id: 1 }).toArray();
+      return documents.map(parseSubmissionDocument);
     },
     async deleteSubmission(submissionId) {
       await submissions.deleteOne({ _id: submissionId });
@@ -94,6 +102,12 @@ function createMongoDbStorage(options) {
     },
     async clear() {
       await Promise.all([schemas.deleteMany({}), submissions.deleteMany({})]);
+    },
+    async createIndexes() {
+      await submissions.createIndexes([
+        { key: { formId: 1, submittedAt: 1 }, name: "form_responses_form_submitted_at" },
+        { key: { "submission.locale": 1 }, name: "form_responses_locale" }
+      ]);
     }
   };
 }

package/package.json

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