zinkee 0.1.31 → 0.1.33

package/README.md

@@ -299,8 +299,11 @@ zinkee --json records get projects <record-uuid>
 # Update
 zinkee records update projects <record-uuid> --set status=2
 
-# Delete
-zinkee records delete projects <record-uuid>
+# Delete one or more records (--record is repeatable)
+zinkee records delete projects --record <record-uuid> --record <record-uuid>
+
+# Delete many records listing one uuid per line in a file (merged with --record, de-duplicated)
+zinkee records delete projects --records-file ./record-ids.txt
 
 # Clear all records from a schema (destructive — irreversible)
 zinkee records clear projects

package/dist/index.js

@@ -2444,7 +2444,7 @@ var specificExamples = {
 }`
     },
     {
-      description: "Set the highlighted (main) field of a schema.",
+      description: "Set the schema's highlighted (main) field \u2014 the field whose value names each record in the UI (activity-panel title and detail-view record list).",
       command: "zinkee --json schemas update contacts --highlighted-field contact-name",
       raw: `{
   "highlightedField": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
@@ -4533,10 +4533,24 @@ var specificExamples = {
   ]),
   "records delete": buildCommandExamples([
     {
-      description: "Delete a record.",
-      command: `zinkee --json records delete contacts ${SAMPLE_UUID}`,
+      description: "Delete one or more records by id (--record is repeatable).",
+      command: `zinkee --json records delete contacts --record 550e8400-e29b-41d4-a716-446655440000 --record 6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d`,
       response: `{
-  "recordId": "550e8400-e29b-41d4-a716-446655440000",
+  "recordIds": [
+    "550e8400-e29b-41d4-a716-446655440000",
+    "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
+  ],
+  "deleted": true
+}`
+    },
+    {
+      description: "Delete many records listing one uuid per line in a file (merged with any --record flags and de-duplicated).",
+      command: `zinkee --json records delete contacts --records-file ./record-ids.txt`,
+      response: `{
+  "recordIds": [
+    "550e8400-e29b-41d4-a716-446655440000",
+    "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
+  ],
   "deleted": true
 }`
     }
@@ -10733,10 +10747,10 @@ var RecordsApi = class {
       jsonOptions6(input, "PATCH")
     );
   }
-  deleteRecord(schema, record) {
+  deleteRecords(schema, recordIds) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue8(schema)}/records/${selectorValue8(record)}`,
-      { method: "DELETE" }
+      `/api/v2/schemas/${selectorValue8(schema)}/records:delete`,
+      jsonOptions6({ recordIds }, "POST")
     );
   }
   clearRecords(schema) {
@@ -10960,6 +10974,61 @@ function parseJsonKeyValueAssignment(input) {
 function dedupeStrings(values) {
   return [...new Set(values)];
 }
+function toRecordUuid(value) {
+  try {
+    const normalized = normalizeUuidOrSlug(value);
+    return normalized.kind === "uuid" ? normalized.value : null;
+  } catch {
+    return null;
+  }
+}
+function collectRecordIds(value, previous = []) {
+  const uuid = toRecordUuid(value.trim());
+  if (!uuid) {
+    throw new InvalidArgumentError8(`Expected a record UUID, received "${value}".`);
+  }
+  return [...previous, uuid];
+}
+function readRecordIdsFromFile(path) {
+  let contents;
+  try {
+    contents = readFileSync8(path, "utf8");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unable to read file.";
+    throw new CliError(
+      "invalid_cli_usage",
+      `Failed to read record ids from ${path}: ${message}`
+    );
+  }
+  const ids = [];
+  contents.split(/\r?\n/).forEach((line, index) => {
+    const value = line.trim();
+    if (!value) {
+      return;
+    }
+    const uuid = toRecordUuid(value);
+    if (!uuid) {
+      throw new CliError(
+        "invalid_cli_usage",
+        `Invalid record UUID "${value}" at ${path}:${index + 1}.`
+      );
+    }
+    ids.push(uuid);
+  });
+  return ids;
+}
+function resolveDeleteRecordIds(options) {
+  const flagIds = options.record ?? [];
+  const fileIds = options.recordsFile ? readRecordIdsFromFile(options.recordsFile) : [];
+  const recordIds = dedupeStrings([...flagIds, ...fileIds]);
+  if (recordIds.length === 0) {
+    throw new CliError(
+      "invalid_cli_usage",
+      'Provide at least one record id via "--record <uuid>" (repeatable) or "--records-file <path>".'
+    );
+  }
+  return recordIds;
+}
 function collectStringValues(value, previous = []) {
   return [...previous, value];
 }
@@ -11234,21 +11303,23 @@ function registerRecordsCommands(program, options = {}) {
     }
     writeLine10(stdout, `Updated record "${getRecordIdentifier(data)}".`);
   });
-  records.command("delete").description("Delete a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema, record) {
+  records.command("delete").description("Delete one or more records").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).option("--record <uuid>", "record uuid to delete (repeatable)", collectRecordIds, []).option(
+    "--records-file <path>",
+    "path to a file with one record uuid per line (merged with --record)"
+  ).action(async function action(schema, commandOptions) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
     ensureWritable7("records delete", readOnly, "destructive");
+    const recordIds = resolveDeleteRecordIds(commandOptions);
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
-    await api.deleteRecord(resolvedSchema, record);
-    const data = {
-      schema: resolvedSchema.value,
-      record: record.value,
-      deleted: true
-    };
+    const data = await api.deleteRecords(resolvedSchema, recordIds);
     if (json) {
       emitJson10(stdout, "records delete", data, filePath);
       return;
     }
-    writeLine10(stdout, `Deleted record "${record.value}" from schema "${schema.value}".`);
+    writeLine10(
+      stdout,
+      `Deleted ${recordIds.length} record(s) from schema "${schema.value}".`
+    );
   });
   records.command("clear").description("Delete all records from a schema's table").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
@@ -11266,6 +11337,15 @@ function registerRecordsCommands(program, options = {}) {
 // src/commands/schemas.ts
 import { readFileSync as readFileSync9 } from "fs";
 import { InvalidArgumentError as InvalidArgumentError9 } from "commander";
+var HIGHLIGHTED_FIELD_HELP = `
+Highlighted field:
+  The schema's "main" field. The frontend uses its value as each record's
+  display name, in two places:
+    - Activity panel: the record's title in the activity side panel
+      (the panel with the record's logs and comments).
+    - Detail view: the record's name in the left-hand record list you
+      browse to open each record's form.
+`;
 function getCommandIo11(stdout) {
   return stdout ?? process.stdout;
 }
@@ -11603,7 +11683,7 @@ function registerSchemasCommands(program, options = {}) {
   });
   schemas.command("update").description("Update a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector9).option("--name <name>", "schema name").option("--slug <slug>", "schema slug").option("--auditable <bool>", "auditable flag", parseBooleanFlag).option("--commentable <bool>", "commentable flag", parseBooleanFlag).option(
     "--highlighted-field <field>",
-    "highlighted (main) field uuid or slug",
+    "its value is used as each record's display name in the UI (field uuid or slug)",
     parseUuidOrSlugSelector9
   ).action(async function action(schema, commandOptions) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
@@ -11630,7 +11710,7 @@ function registerSchemasCommands(program, options = {}) {
       return;
     }
     writeLine11(stdout, `Updated schema "${data.slug ?? schema.value}".`);
-  });
+  }).addHelpText("after", HIGHLIGHTED_FIELD_HELP);
   schemas.command("set-unique-fields").description("Set or clear the composite unique-field constraint on a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector9).option(
     "--field <field>",
     "field uuid or slug to include in the unique constraint (repeatable)",