@form-engine-ts/storage-mongodb 2.8.0 → 2.9.1

package/README.md

@@ -39,3 +39,6 @@ lives in `form_version_states`. `commitVersionTransition(plan)` compares `expect
 `revision_conflict` to losing concurrent publishers; on a real MongoDB client, the state and record changes are committed
 in one transaction. Clone, publish, and draft-delete plans persist complete version state, affected records, and audit
 events. State/record/list reads and typed commit errors are exposed through the full `VersionedFormStorageAdapter` API.
+Version commits require transaction support and return `transaction_unsupported` before any write when it is unavailable.
+MongoDB duplicate-key failures are mapped to `draft_already_exists` or `revision_conflict` rather than a generic storage
+error.

package/dist/index.cjs

@@ -102,15 +102,29 @@ function parseVersionRecordDocument(document) {
   }
   return cloneJson(document.record);
 }
-function isCasConflict(error) {
+function mongoErrorMessage(error) {
+  return error instanceof Error ? error.message : isRecord(error) ? String(error.message ?? "") : "";
+}
+function isDuplicateKeyError(error) {
+  return isRecord(error) && error.code === 11e3;
+}
+function duplicateIndexName(error) {
+  if (!isDuplicateKeyError(error)) return void 0;
+  return /unique_(?:draft|published|version)_per_form/u.exec(mongoErrorMessage(error))?.[0];
+}
+function isRevisionConflict(error) {
   if (!isRecord(error)) return false;
-  if (error.code === 11e3) {
-    const message = error instanceof Error ? error.message : String(error.message ?? "");
-    return !/unique_(?:draft|published|version)_per_form/u.test(message);
-  }
+  if (error.code === 11e3) return duplicateIndexName(error) !== "unique_draft_per_form";
   if (error.code === 112 || error.code === 251) return true;
   return typeof error.hasErrorLabel === "function" && error.hasErrorLabel("TransientTransactionError") === true;
 }
+function isTransactionUnsupported(error) {
+  if (!isRecord(error)) return false;
+  if (error.code === 20 || error.code === 263 || error.code === 303) return true;
+  return /transaction numbers are only allowed|transactions? (?:are|is) not supported|replica set member|mongos/iu.test(
+    mongoErrorMessage(error)
+  );
+}
 function parseSchemaDocument(document) {
   try {
     (0, import_core.assertValidFormSchema)(document.schema);
@@ -169,6 +183,18 @@ function createMongoDbStorage(options) {
       }
     };
   };
+  const storageDraftAlreadyExists = async (plan) => {
+    const state = await versionStates.findOne({ _id: plan.formId });
+    const record = await versions.findOne({ formId: plan.formId, status: "draft" });
+    const currentDraftVersion = record?.version ?? state?.draftVersion ?? plan.draftToCreate?.version;
+    return currentDraftVersion === void 0 ? storageRevisionConflict(plan) : { success: false, error: { type: "draft_already_exists", currentDraftVersion } };
+  };
+  const mapCommitError = async (error, plan) => {
+    if (isTransactionUnsupported(error)) return { success: false, error: { type: "transaction_unsupported" } };
+    if (duplicateIndexName(error) === "unique_draft_per_form") return storageDraftAlreadyExists(plan);
+    if (isRevisionConflict(error)) return storageRevisionConflict(plan);
+    return { success: false, error: { type: "storage_error", cause: error } };
+  };
   const upsertVersionRecord = async (record, session) => {
     const stored = cloneJson(record);
     await versions.updateOne(
@@ -426,16 +452,18 @@ function createMongoDbStorage(options) {
       }
       const client = options.db.client;
       if (client === void 0 || typeof client.startSession !== "function") {
-        try {
-          return await applyVersionTransition(plan);
-        } catch (error) {
-          if (isCasConflict(error)) {
-            return storageRevisionConflict(plan);
-          }
-          return { success: false, error: { type: "storage_error", cause: error } };
-        }
+        return { success: false, error: { type: "transaction_unsupported" } };
+      }
+      let session;
+      try {
+        session = client.startSession();
+      } catch (error) {
+        return isTransactionUnsupported(error) ? { success: false, error: { type: "transaction_unsupported" } } : { success: false, error: { type: "storage_error", cause: error } };
+      }
+      if (typeof session.withTransaction !== "function") {
+        await session.endSession();
+        return { success: false, error: { type: "transaction_unsupported" } };
       }
-      const session = client.startSession();
       try {
         let result = {
           success: false,
@@ -446,10 +474,7 @@ function createMongoDbStorage(options) {
         });
         return result;
       } catch (error) {
-        if (isCasConflict(error)) {
-          return storageRevisionConflict(plan);
-        }
-        return { success: false, error: { type: "storage_error", cause: error } };
+        return mapCommitError(error, plan);
       } finally {
         await session.endSession();
       }

package/dist/index.js

@@ -85,15 +85,29 @@ function parseVersionRecordDocument(document) {
   }
   return cloneJson(document.record);
 }
-function isCasConflict(error) {
+function mongoErrorMessage(error) {
+  return error instanceof Error ? error.message : isRecord(error) ? String(error.message ?? "") : "";
+}
+function isDuplicateKeyError(error) {
+  return isRecord(error) && error.code === 11e3;
+}
+function duplicateIndexName(error) {
+  if (!isDuplicateKeyError(error)) return void 0;
+  return /unique_(?:draft|published|version)_per_form/u.exec(mongoErrorMessage(error))?.[0];
+}
+function isRevisionConflict(error) {
   if (!isRecord(error)) return false;
-  if (error.code === 11e3) {
-    const message = error instanceof Error ? error.message : String(error.message ?? "");
-    return !/unique_(?:draft|published|version)_per_form/u.test(message);
-  }
+  if (error.code === 11e3) return duplicateIndexName(error) !== "unique_draft_per_form";
   if (error.code === 112 || error.code === 251) return true;
   return typeof error.hasErrorLabel === "function" && error.hasErrorLabel("TransientTransactionError") === true;
 }
+function isTransactionUnsupported(error) {
+  if (!isRecord(error)) return false;
+  if (error.code === 20 || error.code === 263 || error.code === 303) return true;
+  return /transaction numbers are only allowed|transactions? (?:are|is) not supported|replica set member|mongos/iu.test(
+    mongoErrorMessage(error)
+  );
+}
 function parseSchemaDocument(document) {
   try {
     assertValidFormSchema(document.schema);
@@ -152,6 +166,18 @@ function createMongoDbStorage(options) {
       }
     };
   };
+  const storageDraftAlreadyExists = async (plan) => {
+    const state = await versionStates.findOne({ _id: plan.formId });
+    const record = await versions.findOne({ formId: plan.formId, status: "draft" });
+    const currentDraftVersion = record?.version ?? state?.draftVersion ?? plan.draftToCreate?.version;
+    return currentDraftVersion === void 0 ? storageRevisionConflict(plan) : { success: false, error: { type: "draft_already_exists", currentDraftVersion } };
+  };
+  const mapCommitError = async (error, plan) => {
+    if (isTransactionUnsupported(error)) return { success: false, error: { type: "transaction_unsupported" } };
+    if (duplicateIndexName(error) === "unique_draft_per_form") return storageDraftAlreadyExists(plan);
+    if (isRevisionConflict(error)) return storageRevisionConflict(plan);
+    return { success: false, error: { type: "storage_error", cause: error } };
+  };
   const upsertVersionRecord = async (record, session) => {
     const stored = cloneJson(record);
     await versions.updateOne(
@@ -409,16 +435,18 @@ function createMongoDbStorage(options) {
       }
       const client = options.db.client;
       if (client === void 0 || typeof client.startSession !== "function") {
-        try {
-          return await applyVersionTransition(plan);
-        } catch (error) {
-          if (isCasConflict(error)) {
-            return storageRevisionConflict(plan);
-          }
-          return { success: false, error: { type: "storage_error", cause: error } };
-        }
+        return { success: false, error: { type: "transaction_unsupported" } };
+      }
+      let session;
+      try {
+        session = client.startSession();
+      } catch (error) {
+        return isTransactionUnsupported(error) ? { success: false, error: { type: "transaction_unsupported" } } : { success: false, error: { type: "storage_error", cause: error } };
+      }
+      if (typeof session.withTransaction !== "function") {
+        await session.endSession();
+        return { success: false, error: { type: "transaction_unsupported" } };
       }
-      const session = client.startSession();
       try {
         let result = {
           success: false,
@@ -429,10 +457,7 @@ function createMongoDbStorage(options) {
         });
         return result;
       } catch (error) {
-        if (isCasConflict(error)) {
-          return storageRevisionConflict(plan);
-        }
-        return { success: false, error: { type: "storage_error", cause: error } };
+        return mapCommitError(error, plan);
       } finally {
         await session.endSession();
       }

package/package.json

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