@hyperline/cli 0.1.0-build.1.23c80aa → 0.1.0-build.1.245f22f

package/dist/bin/hyperline-main.js

@@ -40673,9 +40673,88 @@ Examples:
   });
 }
 
+// build/commands/generated/approval-requests.js
+function registerApproval_RequestsCommands(parent) {
+  const resource = parent.command("approval-requests").description("Manage approval > requests");
+  resource.command("get").description(`Retrieve an approval request and its decisions.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
+Examples:
+    hyperline approval-requests get --id <id>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/approvals/requests/{id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("approve").description(`Approve the current step of an approval request.`).requiredOption("--id <value>", `id parameter`).requiredOption("--step-id <value>", `Expected current workflow step ID. A stale step is rejected instead of deciding the next step.`).option("--approver-id <value>", `Identifier of the account member making the decision. Supply exactly one of approver_id or approver_email. With a user token, this must be the authenticated user.`).option("--comment <value>", `Decision comment. Required and nonblank when rejecting; optional when approving. Trimmed, with a maximum of 2000 characters.`).option("--approver-email <value>", `Email of the account member making the decision, matched case-insensitively. Supply exactly one of approver_id or approver_email. With a user token, this must be the authenticated user.`).addHelpText("after", `
+Examples:
+    hyperline approval-requests approve --id <id> --step-id <step_id>
+    hyperline approval-requests approve --id <id> --step-id <step_id> --approver-id <approver_id> --comment <comment>
+    hyperline approval-requests approve --id <id> --step-id <step_id> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (opts.stepId !== void 0)
+      args.step_id = opts.stepId;
+    if (opts.approverId !== void 0)
+      args.approver_id = opts.approverId;
+    if (opts.comment !== void 0)
+      args.comment = opts.comment;
+    if (opts.approverEmail !== void 0)
+      args.approver_email = opts.approverEmail;
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/approvals/requests/{id}/approve",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("reject").description(`Reject an approval request with a required comment.`).requiredOption("--id <value>", `id parameter`).requiredOption("--step-id <value>", `Expected current workflow step ID. A stale step is rejected instead of deciding the next step.`).option("--approver-id <value>", `Identifier of the account member making the decision. Supply exactly one of approver_id or approver_email. With a user token, this must be the authenticated user.`).requiredOption("--comment <value>", `Decision comment. Required and nonblank when rejecting; optional when approving. Trimmed, with a maximum of 2000 characters.`).option("--approver-email <value>", `Email of the account member making the decision, matched case-insensitively. Supply exactly one of approver_id or approver_email. With a user token, this must be the authenticated user.`).addHelpText("after", `
+Examples:
+    hyperline approval-requests reject --id <id> --step-id <step_id> --comment <comment>
+    hyperline approval-requests reject --id <id> --step-id <step_id> --comment <comment> --approver-id <approver_id> --approver-email <approver_email>
+    hyperline approval-requests reject --id <id> --step-id <step_id> --comment <comment> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (opts.stepId !== void 0)
+      args.step_id = opts.stepId;
+    if (opts.approverId !== void 0)
+      args.approver_id = opts.approverId;
+    if (opts.comment !== void 0)
+      args.comment = opts.comment;
+    if (opts.approverEmail !== void 0)
+      args.approver_email = opts.approverEmail;
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/approvals/requests/{id}/reject",
+      args,
+      queryParamKeys: []
+    });
+  });
+}
+
 // build/commands/generated/approval-workflows.js
 function registerApproval_WorkflowsCommands(parent) {
-  const resource = parent.command("approval-workflows").description("Manage approval workflows");
+  const resource = parent.command("approval-workflows").description("Manage approval > workflows");
   resource.command("list").description(`List approval workflows with their steps and approvers. Those whose \`applicable_flows\` include \`workflow_step\` can be picked as the \`approvalWorkflowId\` of a workflow's Request approval step (\`hyperline.request_approval\`). Filter with \`is_active\`; paginated with take/skip.`).option("--take <number>", `take`).option("--skip <number>", `skip`).option("--is-active <value>", `Only return workflows matching this active state.`).addHelpText("after", `
 Examples:
     hyperline approval-workflows list
@@ -44097,7 +44176,7 @@ Payment method strategy used to charge the invoice. Only applies to \`to_pay\` s
 
 - \`current\`: Use the current default payment method of the customer.
 - \`external\`: Manage the payment of the invoice outside of Hyperline.
-`).option("--payment-method-id <value>", `ID of the default payment method used to pay the invoice. Transactions related to the invoice may use different payment methods.`).option("--bank-account-id <value>", `ID of the bank account displayed on the invoice. Transactions related to the invoice may use different bank accounts.`).option("--subscription-id <value>", `ID of the subscription related to the invoice.`).option("--emitted-at <value>", `Issue date of the invoice.`).option("--due-at <value>", `Due date of the invoice. Computed from the issue date and the payment delay configured in your settings.`).option("--settled-at <value>", `Date the invoice was fully paid.`).option("--issuing-method <value>", `Set to \`scheduled\` to finalize the draft invoice automatically on its issue date (\`emitted_at\`), resolved to the start of that day in the customer timezone. Requires \`status\` to be \`draft\` and an issue date after today. Default to \`manual\`.`).option("--properties <json>", `Key/value pairs to store any metadata useful in your context.`).option("--custom-properties <json>", `Values for custom properties defined for the \`invoice\` entity, keyed by slug.`).option("--additional-display-fields <json>", `Ordered additional fields displayed on the invoice PDF. Invoice and customer custom properties are referenced by slug.`).requiredOption("--line-items <json>", `line_items`).option("--transactions <json>", `transactions`).option("--coupons <json>", `coupons`).addHelpText("after", `
+`).option("--payment-method-id <value>", `ID of the default payment method used to pay the invoice. Transactions related to the invoice may use different payment methods.`).option("--bank-account-id <value>", `ID of the bank account displayed on the invoice. Transactions related to the invoice may use different bank accounts.`).option("--subscription-id <value>", `ID of the subscription related to the invoice.`).option("--emitted-at <value>", `Issue date of the invoice.`).option("--due-at <value>", `Due date of the invoice. Computed from the issue date and the payment delay configured in your settings.`).option("--settled-at <value>", `Date the invoice was fully paid.`).option("--issuing-method <value>", `Set to \`scheduled\` to finalize the draft invoice automatically on its issue date (\`emitted_at\`), resolved to the start of that day in the customer timezone. Requires \`status\` to be \`draft\` and an issue date after today. Default to \`manual\`.`).option("--properties <json>", `Key/value pairs to store any metadata useful in your context.`).option("--custom-properties <json>", `Values for custom properties defined for the \`invoice\` entity, keyed by slug.`).option("--additional-display-fields <json>", `Ordered additional fields displayed on the invoice PDF. Invoice and customer custom properties are referenced by slug.`).option("--original-invoice-id <value>", `Reference invoice for a credit note, including an imported invoice. Must belong to the same customer, currency and invoicing entity. This reference does not apply credit; use \`allocations\` separately.`).requiredOption("--line-items <json>", `line_items`).option("--allocations <json>", `Invoice applications for a credit note, independent of \`original_invoice_id\`. Omit or send an empty array to apply no credit. Created atomically with the credit note. Amounts must fit the available credit and target balances. For \`paid\` credit notes, non-empty allocations and explicit transactions must settle the full amount; no refund transaction is inferred.`).option("--transactions <json>", `transactions`).option("--coupons <json>", `coupons`).addHelpText("after", `
 Examples:
     hyperline invoices create-invoice --customer-id <customer_id> --line-items <line_items>
     hyperline invoices create-invoice --customer-id <customer_id> --line-items <line_items> --currency <currency> --status <status>
@@ -44150,6 +44229,8 @@ Examples:
       args.settled_at = opts.settledAt;
     if (opts.issuingMethod !== void 0)
       args.issuing_method = opts.issuingMethod;
+    if (opts.originalInvoiceId !== void 0)
+      args.original_invoice_id = opts.originalInvoiceId;
     if (opts.properties !== void 0)
       args.properties = JSON.parse(opts.properties);
     if (opts.customProperties !== void 0)
@@ -44158,6 +44239,8 @@ Examples:
       args.additional_display_fields = JSON.parse(opts.additionalDisplayFields);
     if (opts.lineItems !== void 0)
       args.line_items = JSON.parse(opts.lineItems);
+    if (opts.allocations !== void 0)
+      args.allocations = JSON.parse(opts.allocations);
     if (opts.transactions !== void 0)
       args.transactions = JSON.parse(opts.transactions);
     if (opts.coupons !== void 0)
@@ -44360,7 +44443,28 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("update").description(`Update an invoice. Draft/grace_period allow modifying line items, dates, and metadata before finalization. Finalized invoices allow updating product and price links and revenue classification on existing line items by ID, with unchanged amounts/taxes and automatic accounting reposting, plus metadata (paid/partially_paid: custom_note/purchase_order/custom_properties/additional_display_fields/subscription_id; uncollectible: properties/custom_note/custom_properties/additional_display_fields/subscription_id).`).requiredOption("--id <value>", `id parameter`).option("--type <value>", `Type of the invoice.
+  resource.command("update-credit-note-allocations").description(`Replace a credit note's invoice allocations, including imported invoices, without changing its original invoice reference.`).requiredOption("--id <value>", `id parameter`).requiredOption("--allocations <json>", `Complete replacement of this credit note's invoice applications. An empty array removes all applications, preserving the original invoice reference. Targets must share the customer, currency and invoicing entity. Amounts exceeding available credit or invoice balances are rejected.`).addHelpText("after", `
+Examples:
+    hyperline invoices update-credit-note-allocations --id <id> --allocations <allocations>
+    hyperline invoices update-credit-note-allocations --id <id> --allocations <allocations> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (opts.allocations !== void 0)
+      args.allocations = JSON.parse(opts.allocations);
+    await ctx.execute({
+      method: "PUT",
+      path: "/v1/invoices/{id}/allocations",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("update").description(`Update an invoice. Send original_invoice_id alone to fill a missing reference on an imported credit note without changing allocations. Draft/grace_period allow modifying line items, dates, and metadata before finalization. Finalized invoices allow updating product and price links and revenue classification on existing line items by ID, with unchanged amounts/taxes and automatic accounting reposting, plus metadata (paid/partially_paid: custom_note/purchase_order/custom_properties/additional_display_fields/subscription_id; uncollectible: properties/custom_note/custom_properties/additional_display_fields/subscription_id).`).requiredOption("--id <value>", `id parameter`).option("--type <value>", `Type of the invoice.
 
 - \`invoice\`: Legal invoice to be paid by your customer.
 - \`credit_note\`: Legal credit note cancelling an invoice and refunding your customer.
@@ -44369,7 +44473,7 @@ Examples:
 
 - \`auto\`: Tax is automatically computed and applied.
 - \`not_eligible\`: Tax collection is disabled for the invoice.
-  `).option("--issuing-method <value>", `Set to \`scheduled\` to finalize the draft invoice automatically on its issue date (\`emitted_at\`), in the invoice timezone. The issue date must be after today. Set to \`manual\` to unschedule the invoice.`).option("--emitted-at <value>", `Issue date of the draft invoice. For a scheduled invoice, the day on which it is automatically finalized.`).option("--line-items <json>", `Draft edits replace the line list. Finalized invoice line updates accept up to 100 lines per request and update only the specified existing line IDs and allow product and price links and revenue classification; amounts and taxes stay unchanged. Accounting postings are rebuilt atomically; updates affecting closed accounting periods are rejected.`).option("--coupons <json>", `coupons`).option("--payment-method-type <value>", `payment_method_type`).option("--payment-method-id <value>", `ID of the default payment method used to pay the invoice. Transactions related to the invoice may use different payment methods.`).option("--bank-account-id <value>", `ID of the bank account displayed on the invoice. Transactions related to the invoice may use different bank accounts.`).option("--subscription-id <value>", `ID of the subscription related to the invoice.`).option("--properties <json>", `Key/value pairs to store any metadata useful in your context.`).option("--custom-properties <json>", `Values for custom properties defined for the \`invoice\` entity, keyed by slug.`).option("--additional-display-fields <json>", `Ordered additional fields displayed on the invoice PDF. Invoice and customer custom properties are referenced by slug.`).option("--customer <json>", `Override customer details on the invoice. Only allowed for draft or grace period invoices.`).addHelpText("after", `
+  `).option("--issuing-method <value>", `Set to \`scheduled\` to finalize the draft invoice automatically on its issue date (\`emitted_at\`), in the invoice timezone. The issue date must be after today. Set to \`manual\` to unschedule the invoice.`).option("--emitted-at <value>", `Issue date of the draft invoice. For a scheduled invoice, the day on which it is automatically finalized.`).option("--line-items <json>", `Draft edits replace the line list. Finalized invoice line updates accept up to 100 lines per request and update only the specified existing line IDs and allow product and price links and revenue classification; amounts and taxes stay unchanged. Accounting postings are rebuilt atomically; updates affecting closed accounting periods are rejected.`).option("--coupons <json>", `coupons`).option("--payment-method-type <value>", `payment_method_type`).option("--payment-method-id <value>", `ID of the default payment method used to pay the invoice. Transactions related to the invoice may use different payment methods.`).option("--bank-account-id <value>", `ID of the bank account displayed on the invoice. Transactions related to the invoice may use different bank accounts.`).option("--subscription-id <value>", `ID of the subscription related to the invoice.`).option("--original-invoice-id <value>", `Fill a missing reference invoice on an imported credit note. Cannot replace or clear an existing reference. Does not change allocations. Send this field alone.`).option("--properties <json>", `Key/value pairs to store any metadata useful in your context.`).option("--custom-properties <json>", `Values for custom properties defined for the \`invoice\` entity, keyed by slug.`).option("--additional-display-fields <json>", `Ordered additional fields displayed on the invoice PDF. Invoice and customer custom properties are referenced by slug.`).option("--customer <json>", `Override customer details on the invoice. Only allowed for draft or grace period invoices.`).addHelpText("after", `
 Examples:
     hyperline invoices update --id <id>
     hyperline invoices update --id <id> --type <type> --document-name <document_name>
@@ -44410,6 +44514,8 @@ Examples:
       args.bank_account_id = opts.bankAccountId;
     if (opts.subscriptionId !== void 0)
       args.subscription_id = opts.subscriptionId;
+    if (opts.originalInvoiceId !== void 0)
+      args.original_invoice_id = opts.originalInvoiceId;
     if (opts.lineItems !== void 0)
       args.line_items = JSON.parse(opts.lineItems);
     if (opts.coupons !== void 0)
@@ -48079,6 +48185,7 @@ function registerAllCommands(program2) {
   registerAi_BillingCommands(program2);
   registerAi_CostsCommands(program2);
   registerAnalyticsCommands(program2);
+  registerApproval_RequestsCommands(program2);
   registerApproval_WorkflowsCommands(program2);
   registerBank_AccountsCommands(program2);
   registerCatalogCommands(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperline/cli",
-  "version": "0.1.0-build.1.23c80aa",
+  "version": "0.1.0-build.1.245f22f",
   "description": "Agent-first CLI for Hyperline API",
   "type": "module",
   "main": "./dist/index.js",