@mymehq/sdk 3.4.0 → 3.5.0

package/dist/index.d.ts

@@ -69,6 +69,21 @@ interface ClientConfig {
     cdnBaseUrl?: string;
 }
 interface UpdateOptions {
+    /**
+     * Version the caller expects the item to currently be at. When provided,
+     * the SDK skips the upfront `GET /items/:id` and PATCHes directly. If the
+     * server's actual version differs, the update 409s through the usual
+     * conflict path — the caller's retry policy is out of scope here.
+     *
+     * Prefer `expectedVersion` for bulk importers and sync loops that already
+     * know the version locally; one request instead of two.
+     */
+    expectedVersion?: number;
+    /**
+     * Legacy alias for `expectedVersion`. Kept for backwards compatibility;
+     * new code should use `expectedVersion`.
+     * @deprecated Use `expectedVersion`.
+     */
     version?: number;
     /**
      * Override the client's default conflict strategy for this update.
@@ -84,7 +99,10 @@ interface UpdateOptions {
     library?: boolean;
     /**
      * Item type. Required by the `auto` strategy when a `keep_both_copies`
-     * conflict spawns a sibling item. Omit to let the SDK pre-fetch it.
+     * conflict spawns a sibling item. Omit to let the SDK pre-fetch it —
+     * when `expectedVersion` is also omitted the pre-fetch happens upfront;
+     * when `expectedVersion` is provided the fetch is deferred until a
+     * `keep_both_copies` conflict actually needs it.
      */
     type?: string;
     /**

package/dist/index.js

@@ -152,6 +152,13 @@ var HttpTransport = class {
 };
 
 // src/conflict.ts
+async function fetchItemType(transport, itemId) {
+  const res = await transport.request(
+    "GET",
+    `/items/${itemId}`
+  );
+  return res.item.type;
+}
 var MAX_RETRIES = 3;
 function isConflictResponse(body) {
   return typeof body === "object" && body !== null && "error" in body && "current" in body && "conflicting_fields" in body;
@@ -235,9 +242,10 @@ async function handleConflictUpdate(transport, itemId, itemType, clientPatch, ve
       const plan = planAutoMerge(conflict);
       let conflictedCopyId;
       if (plan.keepBothFields.length > 0) {
+        const effectiveType = itemType ?? await fetchItemType(transport, itemId);
         const sibling = await keepBothFlow(
           transport,
-          itemType,
+          effectiveType,
           result.current.properties,
           clientPatch,
           plan.keepBothFields
@@ -341,11 +349,14 @@ var MymeClient = class {
       );
     },
     update: async (id, properties, options) => {
-      let version = options?.version;
+      const expected = options?.expectedVersion ?? options?.version;
+      let version;
       let type = options?.type;
-      if (version === void 0 || type === void 0) {
+      if (expected !== void 0) {
+        version = expected;
+      } else {
         const item = await this.items.get(id);
-        version ??= item.version;
+        version = item.version;
         type ??= item.type;
       }
       const strategy = options?.conflict ?? this.defaultConflictStrategy;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mymehq/sdk",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "type": "module",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -16,7 +16,7 @@
     "dist"
   ],
   "dependencies": {
-    "@mymehq/shared": "3.4.0"
+    "@mymehq/shared": "3.4.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",