@hyperline/cli 0.1.0-build.1.a88b5e7 → 0.1.0-build.1.a972870

package/dist/bin/hyperline-main.js

@@ -37934,7 +37934,7 @@ Examples:
       queryParamKeys: ["take", "skip"]
     });
   });
-  resource.command("get").description(`Retrieve a specific bank account by its ID. Returns bank account details including IBAN, BIC, and currency.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
+  resource.command("get").description(`Retrieve a specific bank account by its ID. Returns masked bank account details, account type, balance, and currency.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
 Examples:
     hyperline bank-accounts get --id <id>`).action(async (opts) => {
     const ctx = resource.parent?.opts()._ctx;
@@ -37952,6 +37952,31 @@ Examples:
       queryParamKeys: []
     });
   });
+  resource.command("list-bank-account-transactions").description(`List open banking transactions for a specific bank account. Paginated with limit/cursor.`).requiredOption("--id <value>", `id parameter`).option("--limit <number>", `Maximum number of items to return (1-100).`).option("--cursor <value>", `Opaque cursor returned in the previous response's \`next_cursor\`. Omit to fetch the first page.`).option("--include-total <value>", `Set to \`true\` to include \`total\` in the response.`).addHelpText("after", `
+Examples:
+    hyperline bank-accounts list-bank-account-transactions --id <id>
+    hyperline bank-accounts list-bank-account-transactions --id <id> --limit <limit> --cursor <cursor>`).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.cursor !== void 0)
+      args.cursor = opts.cursor;
+    if (opts.includeTotal !== void 0)
+      args.include_total = opts.includeTotal;
+    if (opts.limit !== void 0)
+      args.limit = Number(opts.limit);
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/bank-accounts/{id}/transactions",
+      args,
+      queryParamKeys: ["limit", "cursor", "include_total"]
+    });
+  });
 }
 
 // build/commands/generated/companies.js
@@ -39620,6 +39645,7 @@ Export name.
 - \`draft_invoices\`: Export all draft invoices, with customer and product information.
 - \`open_invoices\`: Export all open invoices, with customer and product information.
 - \`live_subscriptions\`: List of all active subscriptions line by line.
+- \`credit_balances\`: Monthly credit balance roll-forward per customer and credit type (opening, top-ups, consumption, expiry, closing).
 `).requiredOption("--file-type <value>", `
 Export file type.
 
@@ -40197,7 +40223,7 @@ Examples:
 - \`archived\`: A previous version of an invoice.
 - \`charged_on_parent\`: Invoice is charged on the parent customer.
 - \`pending_parent_concat\`: Invoice is pending invoices concatenation on the parent customer to be grouped.
-- \`uncollectible\`: Invoice is uncollectible (bad debt).
+- \`uncollectible\`: Invoice is uncollectible (bad debt). Only metadata (properties, custom_note, custom_properties) can be updated in this status.
 `).option("--invoicing-entity-id <value>", `ID of the invoicing entity attached to the invoice.`).option("--number <value>", `Invoice number. If specified, the invoice will be considered as imported from an external source and the number will not be generated by Hyperline. You are responsible for avoiding duplicates and ensuring it does not impact the numbering sequence in Hyperline.`).option("--type <value>", `Type of the invoice.
 
 - \`invoice\`: Legal invoice to be paid by your customer.
@@ -40439,7 +40465,7 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("update").description(`Update a draft or grace_period invoice. Allows modifying line items, dates, and metadata before finalization.`).requiredOption("--id <value>", `id parameter`).option("--type <value>", `Type of the invoice.
+  resource.command("update").description(`Update an invoice. Draft/grace_period allow modifying line items, dates, and metadata before finalization. Finalized invoices are restricted to metadata (paid: custom_note; uncollectible: properties/custom_note/custom_properties).`).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.
@@ -41252,7 +41278,12 @@ Examples:
       ]
     });
   });
-  resource.command("create").description(`Create a new product with name, type (flat_fee, per_unit, usage, seat, etc.), and pricing configuration.`).requiredOption("--name <value>", `Product name.`).option("--description <value>", `Product description.`).option("--description-display-interval-dates", `Indicates if the dates of the interval should be automatically added in the product description on the invoices.`).option("--public-description <value>", `Public description of the product.`).option("--translations <value>", `Product name and description translations.`).option("--is-available-on-demand", `is_available_on_demand`).option("--is-available-on-subscription", `is_available_on_subscription`).option("--custom-properties <value>", `A list of key value with the slug of the custom property as the key and the custom property value as value.`).option("--accounting <value>", `Mapping invoicing entity ID/accounting settings.`).requiredOption("--type <value>", `Product type for fixed fee products.`).requiredOption("--price-configurations <value>", `Price configurations for the product.`).option("--aggregator <value>", `Aggregator configuration to automatically count seats from billable events. Only count aggregators are supported for seat products.`).option("--aggregator-id <value>", `ID of an existing aggregator to link to this product.`).option("--unit-name <value>", `Name of the unit (e.g., 'user', 'seat').`).option("--is-connected-seat-item", `When true, the seat count is automatically synced from an external source (e.g., CRM users).`).option("--credit-aggregators <value>", `Multiple aggregators with weights for multi-aggregator credit consumption. Cannot be used together with aggregator or aggregator_id.`).option("--low-credits-threshold <number>", `Threshold indicating a low level of credits.`).option("--display-mode <value>", `How bundle items are displayed on invoices.`).option("--exclusive-items-enabled", `When true, only one item in the bundle can be active at a time.`).option("--bundle-items <value>", `Products included in this bundle. Percentages must sum to 100.`).addHelpText("after", `
+  resource.command("create").description(`Create a new product with name, type (flat_fee, per_unit, usage, seat, etc.), and pricing configuration.`).requiredOption("--name <value>", `Product name.`).option("--description <value>", `Product description.`).option("--description-display-interval-dates", `Indicates if the dates of the interval should be automatically added in the product description on the invoices.`).option("--public-description <value>", `Public description of the product.`).option("--translations <value>", `Product name and description translations.`).option("--is-available-on-demand", `is_available_on_demand`).option("--is-available-on-subscription", `is_available_on_subscription`).option("--custom-properties <value>", `A list of key value with the slug of the custom property as the key and the custom property value as value.`).option("--accounting <value>", `Mapping invoicing entity ID/accounting settings.`).requiredOption("--type <value>", `Product type for fixed fee products.`).requiredOption("--price-configurations <value>", `Price configurations for the product.`).option("--aggregator <value>", `Aggregator configuration to automatically count seats from billable events. Only count aggregators are supported for seat products.`).option("--aggregator-id <value>", `ID of an existing aggregator to link to this product.`).option("--unit-name <value>", `Name of the unit (e.g., 'user', 'seat').`).option("--is-connected-seat-item", `When true, the seat count is automatically synced from an external source (e.g., CRM users).`).option("--credit-aggregators <value>", `Multiple aggregators with weights for multi-aggregator credit consumption. Cannot be used together with aggregator or aggregator_id.`).option("--low-credits-threshold <number>", `Threshold indicating a low level of credits.`).option("--credits-grant-mode <value>", `
+How the periodic credit allowance is granted for partial billing periods.
+
+- \`prorated\` (default): the granted credits are prorated to the elapsed period.
+- \`full_allowance\`: the full allowance is always granted (the invoice remains prorated).
+`).option("--display-mode <value>", `How bundle items are displayed on invoices.`).option("--exclusive-items-enabled", `When true, only one item in the bundle can be active at a time.`).option("--bundle-items <value>", `Products included in this bundle. Percentages must sum to 100.`).addHelpText("after", `
 Examples:
     hyperline products create --name <name> --type <type> --price-configurations <price_configurations>
     hyperline products create --name <name> --type <type> --price-configurations <price_configurations> --description <description> --description-display-interval-dates
@@ -41287,6 +41318,8 @@ Examples:
       args.unit_name = opts.unitName;
     if (opts.creditAggregators !== void 0)
       args.credit_aggregators = opts.creditAggregators;
+    if (opts.creditsGrantMode !== void 0)
+      args.credits_grant_mode = opts.creditsGrantMode;
     if (opts.displayMode !== void 0)
       args.display_mode = opts.displayMode;
     if (opts.bundleItems !== void 0)
@@ -41412,7 +41445,7 @@ Examples:
 // build/commands/generated/quotes.js
 function registerQuotesCommands(parent) {
   const resource = parent.command("quotes").description("Manage quotes");
-  resource.command("create").description(`Create a new quote for a customer. Use \`subscription\` (or \`template_id\`) for subscription quotes; use \`invoice\` for one-off quotes backed by a draft invoice with line items. Quotes can be sent for signature and converted to subscriptions or one-off invoices.`).option("--status <value>", `
+  resource.command("create").description(`Create a new quote for a customer. Use \`subscription\` (or \`template_id\`) for subscription quotes; use \`invoice\` for one-off quotes backed by a draft invoice with line items. Quotes can be sent for signature and converted to subscriptions or one-off invoices. When creating from a quote template, do not combine \`template_id\` with subscription overrides for dates, contract terms, products, phases, coupons, discounts, prices, or seats in this call: first create the quote from \`template_id\` so template terms and contract documents are copied, then call \`update_quote\` with the subscription payload.`).option("--status <value>", `
 Quote status.
 
 - \`draft\`: The quote is a draft.
@@ -41708,7 +41741,7 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("update").description(`Update quote-level fields before a quote is finalized. On draft quotes, pass \`subscription\` to create or replace the draft subscription configuration, or pass \`invoice\` on a one-off quote to replace the linked draft invoice.`).requiredOption("--id <value>", `id parameter`).option("--owner-email <value>", `Email address of the Hyperline user acting as the quote owner.`).option("--comments <value>", `Custom comments displayed on the quote.`).option("--terms <value>", `Custom quotation terms.`).option("--amount <number>", `Estimated contract value. Set to \`null\` to clear the manually set value.`).option("--collect-payment-details <value>", `Collect customer payment method mandate during signature flow or not.`).option("--collect-custom-property-ids <value>", `IDs of the customer custom properties required to be filled during the signature flow.`).option("--contract-clause-ids <value>", `IDs of the contract clauses used in the quote terms.`).option("--require-tax-id <value>", `Require the customer to provide a tax ID during the signature flow.`).option("--display-quote-value <value>", `Display the total quote value on the quote.`).option("--display-quote-value-with-tax <value>", `Display the total quote value including tax on the quote. Only applies to \`one_off\` quotes.`).option("--display-taxes <value>", `Display tax breakdown on the quote.`).option("--display-price-tiers <value>", `Controls which price tiers are displayed on the quote.
+  resource.command("update").description(`Update quote-level fields before a quote is finalized. On draft quotes, pass \`subscription\` to create or replace the draft subscription configuration, or pass \`invoice\` on a one-off quote to replace the linked draft invoice. For quotes created from \`template_id\`, use this tool for subscription overrides such as dates, contract terms, products, phases, coupons, discounts, prices, seats, and subscription custom properties. Omit \`terms\`, \`comments\`, and \`contract_clause_ids\` unless deliberately overriding template content.`).requiredOption("--id <value>", `id parameter`).option("--owner-email <value>", `Email address of the Hyperline user acting as the quote owner.`).option("--comments <value>", `Custom comments displayed on the quote.`).option("--terms <value>", `Custom quotation terms.`).option("--amount <number>", `Estimated contract value. Set to \`null\` to clear the manually set value.`).option("--collect-payment-details <value>", `Collect customer payment method mandate during signature flow or not.`).option("--collect-custom-property-ids <value>", `IDs of the customer custom properties required to be filled during the signature flow.`).option("--contract-clause-ids <value>", `IDs of the contract clauses used in the quote terms.`).option("--require-tax-id <value>", `Require the customer to provide a tax ID during the signature flow.`).option("--display-quote-value <value>", `Display the total quote value on the quote.`).option("--display-quote-value-with-tax <value>", `Display the total quote value including tax on the quote. Only applies to \`one_off\` quotes.`).option("--display-taxes <value>", `Display tax breakdown on the quote.`).option("--display-price-tiers <value>", `Controls which price tiers are displayed on the quote.
 
 - \`all\`: Display all pricing tiers.
 - \`matching\`: Only display the tiers used to compute the price based on quantity.
@@ -42064,7 +42097,7 @@ Examples:
 // build/commands/generated/subscriptions.js
 function registerSubscriptionsCommands(parent) {
   const resource = parent.command("subscriptions").description("Manage subscriptions");
-  resource.command("create-subscription-update").description(`Apply a single update to an existing subscription (e.g. change quantity, add/remove product, modify price).`).requiredOption("--id <value>", `id parameter`).requiredOption("--application-schedule <value>", `application_schedule`).option("--apply-at <value>", `The date when the update should be applied. Required when application_schedule is 'scheduled'.`).requiredOption("--payment-schedule <value>", `payment_schedule`).option("--charge-at <value>", `The date when the resulting subscription update should be charged. Required when payment_schedule is 'custom'. Must be in the future.`).requiredOption("--calculation-method <value>", `calculation_method`).option("--refund-method <value>", `Override the refund destination when the update generates a refund credit note (e.g. seat reduction). When omitted, falls back to the invoicing entity's \`creditNoteWalletRefundEnabled\` setting.`).requiredOption("--type <value>", `type`).requiredOption("--payload <value>", `payload`).addHelpText("after", `
+  resource.command("create-subscription-update").description(`Apply a single update to an existing subscription (e.g. change quantity, add/remove product, modify price).`).requiredOption("--id <value>", `id parameter`).requiredOption("--application-schedule <value>", `application_schedule`).option("--apply-at <value>", `The date when the update should be applied. Required when application_schedule is 'scheduled'.`).requiredOption("--payment-schedule <value>", `payment_schedule`).option("--charge-at <value>", `The date when the resulting subscription update should be charged. Required when payment_schedule is 'custom'. Must be in the future.`).requiredOption("--calculation-method <value>", `calculation_method`).option("--precision <value>", `Granularity used to prorate the update amount. Defaults to 'calendar_days' when omitted, prorating on whole calendar days; 'milliseconds' prorates on the exact elapsed time, charging the precise partial period.`).option("--refund-method <value>", `Override the refund destination when the update generates a refund credit note (e.g. seat reduction). When omitted, falls back to the invoicing entity's \`creditNoteWalletRefundEnabled\` setting.`).requiredOption("--type <value>", `type`).requiredOption("--payload <value>", `payload`).addHelpText("after", `
 Examples:
     hyperline subscriptions create-subscription-update --id <id> --application-schedule <application_schedule> --payment-schedule <payment_schedule> --calculation-method <calculation_method> --type <type> --payload <payload>
     hyperline subscriptions create-subscription-update --id <id> --application-schedule <application_schedule> --payment-schedule <payment_schedule> --calculation-method <calculation_method> --type <type> --payload <payload> --apply-at <apply_at> --charge-at <charge_at>
@@ -42087,6 +42120,8 @@ Examples:
       args.charge_at = opts.chargeAt;
     if (opts.calculationMethod !== void 0)
       args.calculation_method = opts.calculationMethod;
+    if (opts.precision !== void 0)
+      args.precision = opts.precision;
     if (opts.refundMethod !== void 0)
       args.refund_method = opts.refundMethod;
     if (opts.type !== void 0)
@@ -42100,7 +42135,7 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("create-subscription-updates").description(`Apply multiple updates at once to an existing subscription in a single atomic operation.`).requiredOption("--id <value>", `id parameter`).requiredOption("--application-schedule <value>", `application_schedule`).option("--apply-at <value>", `The date when the update should be applied. Required when application_schedule is 'scheduled'.`).requiredOption("--payment-schedule <value>", `payment_schedule`).option("--charge-at <value>", `The date when the resulting subscription update should be charged. Required when payment_schedule is 'custom'. Must be in the future.`).requiredOption("--calculation-method <value>", `calculation_method`).option("--refund-method <value>", `Override the refund destination when the update generates a refund credit note (e.g. seat reduction). When omitted, falls back to the invoicing entity's \`creditNoteWalletRefundEnabled\` setting.`).requiredOption("--updates <value>", `updates`).addHelpText("after", `
+  resource.command("create-subscription-updates").description(`Apply multiple updates at once to an existing subscription in a single atomic operation.`).requiredOption("--id <value>", `id parameter`).requiredOption("--application-schedule <value>", `application_schedule`).option("--apply-at <value>", `The date when the update should be applied. Required when application_schedule is 'scheduled'.`).requiredOption("--payment-schedule <value>", `payment_schedule`).option("--charge-at <value>", `The date when the resulting subscription update should be charged. Required when payment_schedule is 'custom'. Must be in the future.`).requiredOption("--calculation-method <value>", `calculation_method`).option("--precision <value>", `Granularity used to prorate the update amount. Defaults to 'calendar_days' when omitted, prorating on whole calendar days; 'milliseconds' prorates on the exact elapsed time, charging the precise partial period.`).option("--refund-method <value>", `Override the refund destination when the update generates a refund credit note (e.g. seat reduction). When omitted, falls back to the invoicing entity's \`creditNoteWalletRefundEnabled\` setting.`).requiredOption("--updates <value>", `updates`).addHelpText("after", `
 Examples:
     hyperline subscriptions create-subscription-updates --id <id> --application-schedule <application_schedule> --payment-schedule <payment_schedule> --calculation-method <calculation_method> --updates <updates>
     hyperline subscriptions create-subscription-updates --id <id> --application-schedule <application_schedule> --payment-schedule <payment_schedule> --calculation-method <calculation_method> --updates <updates> --apply-at <apply_at> --charge-at <charge_at>
@@ -42123,6 +42158,8 @@ Examples:
       args.charge_at = opts.chargeAt;
     if (opts.calculationMethod !== void 0)
       args.calculation_method = opts.calculationMethod;
+    if (opts.precision !== void 0)
+      args.precision = opts.precision;
     if (opts.refundMethod !== void 0)
       args.refund_method = opts.refundMethod;
     if (opts.updates !== void 0)
@@ -42262,7 +42299,7 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("simulate-subscription-updates").description(`Preview the effect of updates on a subscription without applying them. Returns simulated invoice and billing impact.`).requiredOption("--id <value>", `id parameter`).requiredOption("--application-schedule <value>", `application_schedule`).option("--apply-at <value>", `The date when the update should be applied. Required when application_schedule is 'scheduled'.`).requiredOption("--payment-schedule <value>", `payment_schedule`).option("--charge-at <value>", `The date when the resulting subscription update should be charged. Required when payment_schedule is 'custom'. Must be in the future.`).requiredOption("--calculation-method <value>", `calculation_method`).option("--refund-method <value>", `Override the refund destination when the update generates a refund credit note (e.g. seat reduction). When omitted, falls back to the invoicing entity's \`creditNoteWalletRefundEnabled\` setting.`).requiredOption("--updates <value>", `updates`).addHelpText("after", `
+  resource.command("simulate-subscription-updates").description(`Preview the effect of updates on a subscription without applying them. Returns simulated invoice and billing impact.`).requiredOption("--id <value>", `id parameter`).requiredOption("--application-schedule <value>", `application_schedule`).option("--apply-at <value>", `The date when the update should be applied. Required when application_schedule is 'scheduled'.`).requiredOption("--payment-schedule <value>", `payment_schedule`).option("--charge-at <value>", `The date when the resulting subscription update should be charged. Required when payment_schedule is 'custom'. Must be in the future.`).requiredOption("--calculation-method <value>", `calculation_method`).option("--precision <value>", `Granularity used to prorate the update amount. Defaults to 'calendar_days' when omitted, prorating on whole calendar days; 'milliseconds' prorates on the exact elapsed time, charging the precise partial period.`).option("--refund-method <value>", `Override the refund destination when the update generates a refund credit note (e.g. seat reduction). When omitted, falls back to the invoicing entity's \`creditNoteWalletRefundEnabled\` setting.`).requiredOption("--updates <value>", `updates`).addHelpText("after", `
 Examples:
     hyperline subscriptions simulate-subscription-updates --id <id> --application-schedule <application_schedule> --payment-schedule <payment_schedule> --calculation-method <calculation_method> --updates <updates>
     hyperline subscriptions simulate-subscription-updates --id <id> --application-schedule <application_schedule> --payment-schedule <payment_schedule> --calculation-method <calculation_method> --updates <updates> --apply-at <apply_at> --charge-at <charge_at>
@@ -42285,6 +42322,8 @@ Examples:
       args.charge_at = opts.chargeAt;
     if (opts.calculationMethod !== void 0)
       args.calculation_method = opts.calculationMethod;
+    if (opts.precision !== void 0)
+      args.precision = opts.precision;
     if (opts.refundMethod !== void 0)
       args.refund_method = opts.refundMethod;
     if (opts.updates !== void 0)
@@ -61924,13 +61963,16 @@ function logHttpRequest(logger2, request, extra) {
   });
 }
 function logHttpResponse(logger2, response, responseTime, extra) {
-  const { request, statusCode, responseBody } = response;
+  const { request, statusCode, responseBody, responseHeaders } = response;
   const { message, metadata } = transform2(request);
   const readableResponseTime = responseTime ? getReadableTime(responseTime) : void 0;
   const responseMetadata = {
     statusCode,
     responseTime,
-    responseBody
+    responseBody,
+    // Redacted so secrets (authorization/cookie/token/…) never reach the logs
+    // while diagnostic headers (e.g. rate-limit headers on a 429) stay visible.
+    responseHeaders: responseHeaders === void 0 ? void 0 : redactHeaders({ headers: responseHeaders })
   };
   logger2.info(`HTTP RES - ${message} ${statusCode} ${readableResponseTime || ""} ${extra?.postfix || ""}`, {
     ...metadata,
@@ -62715,10 +62757,16 @@ function buildHttpClient(dependencies) {
     return response;
   }, (error48) => {
     if (error48.response) {
-      const { config: responseConfig, status } = error48.response;
+      const { config: responseConfig, status, headers } = error48.response;
       const timeStart = responseConfig.metadata.timeStart;
       const responseTime = timeStart ? Date.now() - timeStart : void 0;
-      logHttpResponse(logger2, { request: toLogRequest(responseConfig), statusCode: status }, responseTime, { metadata: { error: error48.message } });
+      logHttpResponse(logger2, {
+        request: toLogRequest(responseConfig),
+        statusCode: status,
+        // Surfaces upstream response headers on error responses (e.g. the
+        // rate-limit headers on a 429); redacted in logHttpResponse.
+        responseHeaders: headers
+      }, responseTime, { metadata: { error: error48.message } });
     }
     return Promise.reject(error48);
   });

package/package.json

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