zinkee 0.1.32 → 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

@@ -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);