@eide/foir-cli 0.19.0 → 0.20.0

package/dist/cli.js

@@ -6625,7 +6625,9 @@ function registerRecordsCommands(program2, globalOpts) {
       }
     )
   );
-  records.command("update <modelKey> <id>").description("Update a record").option("-d, --data <json>", "Record data as JSON").option("-f, --file <path>", "Read data from file").action(
+  records.command("update <modelKey> <id>").description(
+    "Update a record's data column directly. Bypasses versioning \u2014 no version row is created and currentVersionId is unchanged. For the admin-equivalent atomic save (data + new version + currentVersionId bump), use `records save`."
+  ).option("-d, --data <json>", "Record data as JSON").option("-f, --file <path>", "Read data from file").action(
     withErrorHandler(
       globalOpts,
       async (_modelKey, id, cmdOpts) => {
@@ -6641,6 +6643,34 @@ function registerRecordsCommands(program2, globalOpts) {
       }
     )
   );
+  records.command("save <modelKey> <id>").description(
+    "Save record content (admin Save Draft equivalent). Atomically replaces data, creates an immutable version row, and advances currentVersionId \u2014 preview and storefront see the new content without a separate publish step."
+  ).option("-d, --data <json>", "Record data as JSON").option("-f, --file <path>", "Read data from file").option("-m, --message <msg>", "Change description").option("--variant <key>", "Save into a specific variant").action(
+    withErrorHandler(
+      globalOpts,
+      async (_modelKey, id, cmdOpts) => {
+        const opts = globalOpts();
+        const client = await createPlatformClient(opts);
+        const inputData = await parseInputData(cmdOpts);
+        const result = await client.records.saveContent({
+          recordId: id,
+          data: inputData,
+          variantKey: cmdOpts.variant,
+          changeDescription: cmdOpts.message
+        });
+        formatOutput(
+          {
+            record: result.record ? toJson3(RecordSchema, result.record) : null,
+            version: result.version ? toJson3(RecordSchema, result.version) : null
+          },
+          opts
+        );
+        if (!(opts.json || opts.jsonl || opts.quiet)) {
+          success(`Saved record ${id} \u2192 version ${result.version?.id}`);
+        }
+      }
+    )
+  );
   records.command("delete <modelKey> <id>").description("Delete a record").option("--confirm", "Skip confirmation prompt").action(
     withErrorHandler(
       globalOpts,
@@ -6748,7 +6778,7 @@ function registerRecordsCommands(program2, globalOpts) {
     })
   );
   records.command("create-version <parentId>").description(
-    "Create a new version on a versioned record (or variant). parentId is the record or variant ID."
+    "Low-level: create a version row without touching the parent record's data column or currentVersionId. The new version is orphaned from preview/storefront resolution until published. For the admin-equivalent atomic save (data + version + currentVersionId), use `records save`."
   ).option("-d, --data <json>", "Version content as JSON").option("-f, --file <path>", "Read content from file").option("-m, --message <msg>", "Change description").option("--source-version <id>", "Source version ID to base off").action(
     withErrorHandler(
       globalOpts,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eide/foir-cli",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Universal platform CLI for Foir platform",
   "type": "module",
   "publishConfig": {