zinkee 0.1.21 → 0.1.23

package/.claude/settings.local.json

@@ -41,7 +41,9 @@
       "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee config show --foo --bar baz quux ?\" COMP_CWORD=10 node dist/index.js)",
       "Bash(git -C /home/guillermo/dev/cli status)",
       "Bash(git -C /home/guillermo/dev/cli branch --show-current)",
-      "Bash(git -C /home/guillermo/dev/cli diff --stat)"
+      "Bash(git -C /home/guillermo/dev/cli diff --stat)",
+      "Bash(git fetch *)",
+      "Bash(pnpm exec *)"
     ]
   }
 }

package/dist/index.js

@@ -3306,12 +3306,12 @@ var specificExamples = {
 }`
     },
     {
-      description: "Change a DATE variable to use lastWeek.",
-      command: "zinkee --json displays variables update 0f6f062f-1478-4df2-96a1-c495d037d260 bbbbbbbb-2222-4222-a222-222222222222 --date-mode dynamic --date-dynamic-option lastWeek",
+      description: "Change a DATE variable to use last12Months.",
+      command: "zinkee --json displays variables update 0f6f062f-1478-4df2-96a1-c495d037d260 bbbbbbbb-2222-4222-a222-222222222222 --date-mode dynamic --date-dynamic-option last12Months",
       raw: `{
   "date": {
     "mode": "dynamic",
-    "dynamicOption": "lastWeek"
+    "dynamicOption": "last12Months"
   }
 }`
     }
@@ -5450,6 +5450,43 @@ var specificExamples = {
       "steps": ["one", "two"]
     }
   }
+}`
+    },
+    {
+      description: "Add a send-message action. --to maps to fieldMapping.recipients and --message maps to fieldMapping.body. Values are wrapped in {rawValue, source} like every other automation field mapping; use --map / --map-json for extra keys.",
+      command: `zinkee --json automations actions add automation-1 --type send_message --name "Notify customer" --to customer@example.com --subject "Your order status has changed" --message "Hello, your order is now processed."`,
+      raw: `{
+  "type": "send_message",
+  "name": "Notify customer",
+  "config": {
+    "fieldMapping": {
+      "recipients": {
+        "rawValue": "customer@example.com",
+        "source": null
+      },
+      "subject": {
+        "rawValue": "Your order status has changed",
+        "source": null
+      },
+      "body": {
+        "rawValue": "Hello, your order is now processed.",
+        "source": null
+      }
+    }
+  }
+}`
+    },
+    {
+      description: "Add a generate-document action. The renderer reads the template, writes the file, and stores its id in the target FileField of the target schema.",
+      command: 'zinkee --json automations actions add automation-1 --type generate_document --name "Generate invoice PDF" --document-template 6c08673e-f8a6-44d2-8c91-d09eca911f8f --target-schema 68d2c7be-4392-42de-b5ae-625ad79cfc3c --target-file-field c8edbde8-a361-4e9f-a39a-2e88971f21a7',
+      raw: `{
+  "type": "generate_document",
+  "name": "Generate invoice PDF",
+  "config": {
+    "documentTemplateId": "6c08673e-f8a6-44d2-8c91-d09eca911f8f",
+    "targetSchemaId": "68d2c7be-4392-42de-b5ae-625ad79cfc3c",
+    "targetFileFieldId": "c8edbde8-a361-4e9f-a39a-2e88971f21a7"
+  }
 }`
     }
   ]),
@@ -5500,6 +5537,30 @@ var specificExamples = {
     "authMode": "STORED",
     "connectionId": "connection-1"
   }
+}`
+    },
+    {
+      description: "Replace a send-message action. --to maps to fieldMapping.recipients and --message maps to fieldMapping.body; values are wrapped in {rawValue, source}.",
+      command: `zinkee --json automations actions update automation-1 action-1 --type send_message --name "Notify customer" --to customer@example.com --subject "Your order status has changed" --message "Hello, your order is now processed."`,
+      raw: `{
+  "type": "send_message",
+  "name": "Notify customer",
+  "config": {
+    "fieldMapping": {
+      "recipients": {
+        "rawValue": "customer@example.com",
+        "source": null
+      },
+      "subject": {
+        "rawValue": "Your order status has changed",
+        "source": null
+      },
+      "body": {
+        "rawValue": "Hello, your order is now processed.",
+        "source": null
+      }
+    }
+  }
 }`
     }
   ]),
@@ -7007,6 +7068,15 @@ function buildActionInput(options, mode) {
   if (options.targetSchema !== void 0) {
     config.targetSchemaId = options.targetSchema;
   }
+  if (options.to !== void 0) {
+    mappings.recipients = options.to;
+  }
+  if (options.subject !== void 0) {
+    mappings.subject = options.subject;
+  }
+  if (options.message !== void 0) {
+    mappings.body = options.message;
+  }
   if (!isEmptyObject(mappings)) {
     config.fieldMapping = mappings;
   }
@@ -7050,6 +7120,12 @@ function buildActionInput(options, mode) {
   if (!isEmptyObject(args)) {
     config.pluginArgs = args;
   }
+  if (options.documentTemplate !== void 0) {
+    config.documentTemplateId = options.documentTemplate;
+  }
+  if (options.targetFileField !== void 0) {
+    config.targetFileFieldId = options.targetFileField;
+  }
   if (!isEmptyObject(config)) {
     if (isJsonObject2(config.fieldMapping)) {
       config.fieldMapping = normalizeAutomationFieldMapping(
@@ -7236,12 +7312,28 @@ function addTriggerPayloadOptions(command) {
     []
   ).option("--webhook-endpoint-id <uuid>", "webhook endpoint id").option("--raw <json>", "raw trigger JSON payload").option("--raw-file <path>", "path to raw trigger JSON payload");
 }
+var ACTION_TYPES_HELP = `
+Action types and their flags:
+  create_record      --target-schema, --map, --map-json
+  update_record      --target-schema, --use-trigger-record, --map,
+                     --condition, --condition-json
+  search_records     --target-schema, --condition, --condition-json
+  send_message       --to, --subject, --message
+                     (--map / --map-json also accepted for extra keys)
+  http_request       --method, --url, --header, --body, --content-type,
+                     --timeout-ms, --var, --auth-mode, --connection
+  execute_plugin     --plugin, --arg, --arg-json
+  generate_document  --document-template, --target-schema, --target-file-field
+`;
 function addActionPayloadOptions(command) {
-  return command.option("--type <type>", "action type").option("--name <name>", "action name").option("--target-schema <uuid>", "target schema id").option("--map <field=value>", "field mapping", collectValues, []).option("--map-json <field=json>", "JSON field mapping", collectValues, []).option("--condition <field:comparator:value>", "action condition", collectValues, []).option("--condition-json <json>", "action condition as JSON", collectValues, []).option("--use-trigger-record", "use the triggering record").option("--method <method>", "HTTP method").option("--url <url>", "HTTP target URL").option("--header <key=value>", "HTTP header", collectValues, []).option("--body <json>", "HTTP request body as JSON").option("--body-file <path>", "path to HTTP request body JSON").option("--content-type <type>", "HTTP content type").option(
+  return command.option(
+    "--type <type>",
+    "action type (create_record|update_record|search_records|send_message|http_request|execute_plugin|generate_document)"
+  ).option("--name <name>", "action name").option("--target-schema <uuid>", "target schema id").option("--map <field=value>", "field mapping", collectValues, []).option("--map-json <field=json>", "JSON field mapping", collectValues, []).option("--condition <field:comparator:value>", "action condition", collectValues, []).option("--condition-json <json>", "action condition as JSON", collectValues, []).option("--use-trigger-record", "use the triggering record").option("--method <method>", "HTTP method").option("--url <url>", "HTTP target URL").option("--header <key=value>", "HTTP header", collectValues, []).option("--body <json>", "HTTP request body as JSON").option("--body-file <path>", "path to HTTP request body JSON").option("--content-type <type>", "HTTP content type").option(
     "--timeout-ms <n>",
     "HTTP timeout in milliseconds",
     parseNonNegativeInteger
-  ).option("--var <key=value>", "HTTP variable", collectValues, []).option("--auth-mode <mode>", "HTTP auth mode").option("--connection <uuid>", "connection id for HTTP auth").option("--plugin <id>", "plugin id for execute_plugin").option("--arg <key=value>", "plugin argument", collectValues, []).option("--arg-json <key=json>", "plugin argument as JSON", collectValues, []).option("--raw <json>", "raw action JSON payload").option("--raw-file <path>", "path to raw action JSON payload");
+  ).option("--var <key=value>", "HTTP variable", collectValues, []).option("--auth-mode <mode>", "HTTP auth mode").option("--connection <uuid>", "connection id for HTTP auth").option("--plugin <id>", "plugin id for execute_plugin").option("--arg <key=value>", "plugin argument", collectValues, []).option("--arg-json <key=json>", "plugin argument as JSON", collectValues, []).option("--to <recipient>", "send_message recipient (maps to fieldMapping.recipients)").option("--subject <text>", "send_message subject").option("--message <text>", "send_message body text (maps to fieldMapping.body)").option("--document-template <uuid>", "generate_document template id").option("--target-file-field <uuid>", "generate_document target FileField id").option("--raw <json>", "raw action JSON payload").option("--raw-file <path>", "path to raw action JSON payload").addHelpText("after", ACTION_TYPES_HELP);
 }
 function registerAutomationsCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
@@ -8066,6 +8158,7 @@ function parseExpression(input) {
 }
 
 // src/commands/displays.ts
+var DATE_DYNAMIC_OPTIONS = "today, thisWeek, thisMonth, thisQuarter, thisSemester, thisYear, next7Days, next30Days, next6Months, next12Months, last12Months";
 function getCommandIo4(stdout) {
   return stdout ?? process.stdout;
 }
@@ -8502,7 +8595,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     printTable([match], void 0, stdout);
   });
-  variables.command("create").description("Create variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", collectFilters, []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
+  variables.command("create").description("Create variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", collectFilters, []).option("--date-mode <mode>").option("--date-dynamic-option <option>", `dynamic date period (${DATE_DYNAMIC_OPTIONS})`).option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays variables create", readOnly, "write");
     const data = await api.createVariable(display, buildVariableBody(commandOptions));
@@ -8512,7 +8605,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     writeLine4(stdout, `Created variable on display "${display.value}".`);
   });
-  variables.command("update").description("Update variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<variable>", "variable id").option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", collectFilters, []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, variableId, commandOptions) {
+  variables.command("update").description("Update variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<variable>", "variable id").option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", collectFilters, []).option("--date-mode <mode>").option("--date-dynamic-option <option>", `dynamic date period (${DATE_DYNAMIC_OPTIONS})`).option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, variableId, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays variables update", readOnly, "write");
     const data = await api.updateVariable(display, variableId, buildVariableBody(commandOptions));