@hyperline/cli 0.1.0-build.1.335e98c → 0.1.0-build.1.34b338e

package/dist/bin/hyperline-main.js

@@ -38323,24 +38323,6 @@ Examples:
       queryParamKeys: ["invoicing_entity_id"]
     });
   });
-  resource.command("get-ledger-client-provider").description(`Retrieve the redacted accounting provider connected to a ledger.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
-Examples:
-    hyperline accounting-ledgers get-ledger-client-provider --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/accounting/ledgers/{id}/client-provider",
-      args,
-      queryParamKeys: []
-    });
-  });
   resource.command("create-ledger").description(`Create an accounting ledger for an invoicing entity.`).requiredOption("--invoicing-entity-id <value>", `Identifier of the invoicing entity that owns the ledger.`).requiredOption("--name <value>", `Display name of the ledger.`).requiredOption("--code <value>", `Optional accounting code of the ledger.`).requiredOption("--description <value>", `Optional description of the ledger.`).requiredOption("--type <value>", `Type of ledger.`).requiredOption("--currency <value>", `ISO 4217 currency used by the ledger.`).requiredOption("--entry-number-pattern <value>", `Entry numbering pattern containing \`{number}\`.`).requiredOption("--is-primary", `Whether this is the primary ledger for the invoicing entity.`).requiredOption("--is-inactive", `Whether the ledger is inactive.`).addHelpText("after", `
 Examples:
     hyperline accounting-ledgers create-ledger --invoicing-entity-id <invoicing_entity_id> --name <name> --code <code> --description <description> --type <type> --currency <currency> --entry-number-pattern <entry_number_pattern> --is-primary --is-inactive
@@ -41130,7 +41112,7 @@ Examples:
       ]
     });
   });
-  resource.command("create").description(`Upload a new file (max 10MB). Requires multipart form data with a file field and metadata (name, optional customer_id).`).requiredOption("--name <value>", `Name of the file to be uploaded.`).requiredOption("--customer-id <value>", `ID of the customer to link the file to.`).addHelpText("after", `
+  resource.command("create").description(`Upload a new file (max 10MB). Requires multipart form data with a file field and metadata (name and customer_id).`).requiredOption("--name <value>", `Name of the file to be uploaded.`).requiredOption("--customer-id <value>", `ID of the customer to link the file to.`).addHelpText("after", `
 Examples:
     hyperline files create --name <name> --customer-id <customer_id>
     hyperline files create --name <name> --customer-id <customer_id> --output json`).action(async (opts) => {
@@ -41670,7 +41652,7 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("validate").description(`Finalize a draft invoice: sets its status to to_pay, assigns an invoice number, and makes it immutable. This action is irreversible.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
+  resource.command("validate").description(`Submit a draft invoice for finalization. The result may be pending approval or finalized for payment.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
 Examples:
     hyperline invoices validate --id <id>
     hyperline invoices validate --id <id> --output json`).action(async (opts) => {
@@ -41689,10 +41671,10 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("charge").description(`Manually trigger payment collection for an invoice. Optionally specify a payment_method_id to charge.`).requiredOption("--id <value>", `id parameter`).option("--payment-method-id <value>", `Payment method used to execute the payment. This payment method will override any previously set method on the invoice.`).addHelpText("after", `
+  resource.command("charge").description(`Manually trigger payment collection for an invoice. Optionally specify a payment_method_id and an amount to charge now.`).requiredOption("--id <value>", `id parameter`).option("--payment-method-id <value>", `Payment method used to execute the payment. This payment method will override any previously set method on the invoice.`).option("--amount <number>", `Amount to charge now, expressed in the currency's smallest unit. Defaults to the outstanding invoice amount.`).addHelpText("after", `
 Examples:
     hyperline invoices charge --id <id>
-    hyperline invoices charge --id <id> --payment-method-id <payment_method_id>
+    hyperline invoices charge --id <id> --payment-method-id <payment_method_id> --amount <amount>
     hyperline invoices charge --id <id> --output json`).action(async (opts) => {
     const ctx = resource.parent?.opts()._ctx;
     if (!ctx) {
@@ -41704,6 +41686,8 @@ Examples:
       args.id = opts.id;
     if (opts.paymentMethodId !== void 0)
       args.payment_method_id = opts.paymentMethodId;
+    if (opts.amount !== void 0)
+      args.amount = Number(opts.amount);
     await ctx.execute({
       method: "POST",
       path: "/v1/invoices/{id}/charge",
@@ -42016,7 +42000,7 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("create-invoicing-entity").description(`Create a new invoicing entity with company details, address, and tax configuration. Used as the sender on invoices.`).option("--is-default", `Flag to indicate if this is the default invoicing entity. If true, it will switch the other existing invoicing entities to non-default.`).requiredOption("--name <value>", `The name of the invoicing entity.`).option("--trade-name <value>", `The trade name of the invoicing entity.`).option("--timezone <value>", `The timezone the invoicing entity operates in.`).option("--language <value>", `The default language of the invoicing entity.`).option("--registration-number <value>", `The registration number of the invoicing entity.`).option("--tax-id <value>", `The tax identification number of the invoicing entity.`).option("--billing-email <value>", `The billing email address for the invoicing entity.`).option("--address-line1 <value>", `The first line of the address for the invoicing entity.`).option("--address-line2 <value>", `The second line of the address for the invoicing entity.`).option("--zip-code <value>", `The postal code for the invoicing entity's address.`).option("--state <value>", `The state or province of the invoicing entity.`).option("--city <value>", `The city of the invoicing entity.`).requiredOption("--country <value>", `The country in which the invoicing entity is registered.`).requiredOption("--currency <value>", `The currency code that the invoicing entity operates in.`).requiredOption("--accounting-currency <value>", `The currency used for accounting purposes.`).option("--invoice-number-pattern <value>", `The pattern used for generating invoice numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--credit-note-number-pattern <value>", `The pattern used for generating credit note numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--document-number-pattern <value>", `The pattern used for generating document numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--next-invoice-number <number>", `The next invoice number to be used.`).option("--next-credit-note-number <number>", `The next credit note number to be used.`).option("--next-document-number <number>", `The next document number to be used.`).option("--default-payment-delay <number>", `The default payment term in days.`).option("--invoice-grace-period-duration <number>", `The grace period duration in days.`).option("--invoice-payment-initiation-delay <number>", `The payment initiation delay in days for the invoices.`).option("--document-payment-initiation-delay <number>", `The payment initiation delay in days for the custom documents.`).option("--invoice-late-fees <value>", `The late fees applicable to the invoices.`).option("--invoice-footer <value>", `The footer text to be used in invoices.`).option("--document-footer <value>", `The footer text to be used in documents. If not specified, the invoice footer will be used.`).option("--quote-footer <value>", `The footer text to be used in quotes.`).option("--logo-url <value>", `URL of the logo to be used in invoices.`).option("--favicon-url <value>", `URL of the logo to be used as favicon.`).option("--brand-color <value>", `Brand color to be used in invoices (hexadecimal color code).`).option("--forced-customer-type <value>", `Forces all customers created under this invoicing entity to have this type. Set to null to allow users to choose.`).option("--credit-note-wallet-refund-enabled", `When enabled, credit note refunds default to the customer's wallet for invoices under this invoicing entity. The default applies only when \`refund_method\` is omitted on \`POST /v1/invoices/{id}/credit-notes\`; an explicit \`refund_method\` always wins. Requires wallets to be enabled at the workspace level.`).option("--standalone-credit-note-creation-enabled", `Whether credit notes without an original invoice can be created under this invoicing entity.`).addHelpText("after", `
+  resource.command("create-invoicing-entity").description(`Create a new invoicing entity with company details, address, and tax configuration. Used as the sender on invoices.`).option("--is-default", `Flag to indicate if this is the default invoicing entity. If true, it will switch the other existing invoicing entities to non-default.`).requiredOption("--name <value>", `The name of the invoicing entity.`).option("--trade-name <value>", `The trade name of the invoicing entity.`).option("--timezone <value>", `The timezone the invoicing entity operates in.`).option("--language <value>", `The default language of the invoicing entity.`).option("--registration-number <value>", `The registration number of the invoicing entity.`).option("--tax-id <value>", `The tax identification number of the invoicing entity.`).option("--billing-email <value>", `The billing email address for the invoicing entity.`).option("--address-line1 <value>", `The first line of the address for the invoicing entity.`).option("--address-line2 <value>", `The second line of the address for the invoicing entity.`).option("--zip-code <value>", `The postal code for the invoicing entity's address.`).option("--state <value>", `The state or province of the invoicing entity.`).option("--city <value>", `The city of the invoicing entity.`).requiredOption("--country <value>", `The country in which the invoicing entity is registered. It cannot be changed after creation.`).requiredOption("--currency <value>", `The currency code that the invoicing entity operates in.`).requiredOption("--accounting-currency <value>", `The currency used for accounting purposes.`).option("--invoice-number-pattern <value>", `The pattern used for generating invoice numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--credit-note-number-pattern <value>", `The pattern used for generating credit note numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--document-number-pattern <value>", `The pattern used for generating document numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--next-invoice-number <number>", `The next invoice number to be used.`).option("--next-credit-note-number <number>", `The next credit note number to be used.`).option("--next-document-number <number>", `The next document number to be used.`).option("--default-payment-delay <number>", `The default payment term in days.`).option("--invoice-grace-period-duration <number>", `The grace period duration in days.`).option("--invoice-payment-initiation-delay <number>", `The payment initiation delay in days for the invoices.`).option("--document-payment-initiation-delay <number>", `The payment initiation delay in days for the custom documents.`).option("--invoice-late-fees <value>", `The late fees applicable to the invoices.`).option("--invoice-footer <value>", `The footer text to be used in invoices.`).option("--document-footer <value>", `The footer text to be used in documents. If not specified, the invoice footer will be used.`).option("--quote-footer <value>", `The footer text to be used in quotes.`).option("--logo-url <value>", `URL of the logo to be used in invoices.`).option("--favicon-url <value>", `URL of the logo to be used as favicon.`).option("--brand-color <value>", `Brand color to be used in invoices (hexadecimal color code).`).option("--forced-customer-type <value>", `Forces all customers created under this invoicing entity to have this type. Set to null to allow users to choose.`).option("--credit-note-wallet-refund-enabled", `When enabled and no \`refund_method\` is specified, credit note refunds default to the customer's wallet, including credit notes generated by subscription updates, cancellations, and transitions. An explicit \`refund_method\` always wins. Requires wallets to be enabled at the workspace level.`).option("--standalone-credit-note-creation-enabled", `Whether credit notes without an original invoice can be created under this invoicing entity.`).addHelpText("after", `
 Examples:
     hyperline invoicing-entities create-invoicing-entity --name <name> --country <country> --currency <currency> --accounting-currency <accounting_currency>
     hyperline invoicing-entities create-invoicing-entity --name <name> --country <country> --currency <currency> --accounting-currency <accounting_currency> --is-default --trade-name <trade_name>
@@ -42106,7 +42090,7 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("update-invoicing-entity").description(`Update an existing invoicing entity's details (address, tax ID, branding, etc.).`).requiredOption("--id <value>", `id parameter`).option("--name <value>", `The name of the invoicing entity.`).option("--registration-number <value>", `The registration number of the invoicing entity.`).option("--tax-id <value>", `The tax identification number of the invoicing entity.`).option("--billing-email <value>", `The billing email address for the invoicing entity.`).option("--timezone <value>", `The timezone the invoicing entity operates in.`).option("--language <value>", `The default language of the invoicing entity.`).option("--is-default", `Flag to indicate if this is the default invoicing entity. If true, it will switch the other existing invoicing entities to non-default.`).option("--address-line1 <value>", `The first line of the address for the invoicing entity.`).option("--address-line2 <value>", `The second line of the address for the invoicing entity.`).option("--zip-code <value>", `The postal code for the invoicing entity's address.`).option("--state <value>", `The state or province of the invoicing entity.`).option("--city <value>", `The city of the invoicing entity.`).option("--country <value>", `The country in which the invoicing entity is registered.`).option("--currency <value>", `The currency code that the invoicing entity operates in.`).option("--accounting-currency <value>", `The currency used for accounting purposes.`).option("--invoice-number-pattern <value>", `The pattern used for generating invoice numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--credit-note-number-pattern <value>", `The pattern used for generating credit note numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--document-number-pattern <value>", `The pattern used for generating document numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--default-payment-delay <number>", `The default payment term in days.`).option("--invoice-grace-period-duration <number>", `The grace period duration in days.`).option("--invoice-payment-initiation-delay <number>", `The payment initiation delay in days for the invoices.`).option("--document-payment-initiation-delay <number>", `The payment initiation delay in days for the custom documents.`).option("--invoice-late-fees <value>", `The late fees applicable to the invoices.`).option("--invoice-footer <value>", `The footer text to be used in invoices.`).option("--document-footer <value>", `The footer text to be used in documents. If not specified, the invoice footer will be used.`).option("--logo-url <value>", `URL of the logo to be used in invoices.`).option("--favicon-url <value>", `URL of the logo to be used as favicon.`).option("--brand-color <value>", `Brand color to be used in invoices (hexadecimal color code).`).option("--forced-customer-type <value>", `Forces all customers created under this invoicing entity to have this type. Set to null to allow users to choose.`).option("--credit-note-wallet-refund-enabled", `When enabled, credit note refunds default to the customer's wallet for invoices under this invoicing entity. The default applies only when \`refund_method\` is omitted on \`POST /v1/invoices/{id}/credit-notes\`; an explicit \`refund_method\` always wins. Requires wallets to be enabled at the workspace level.`).option("--standalone-credit-note-creation-enabled", `Whether credit notes without an original invoice can be created under this invoicing entity.`).addHelpText("after", `
+  resource.command("update-invoicing-entity").description(`Update an existing invoicing entity's details (address, tax ID, branding, etc.).`).requiredOption("--id <value>", `id parameter`).option("--name <value>", `The name of the invoicing entity.`).option("--registration-number <value>", `The registration number of the invoicing entity.`).option("--tax-id <value>", `The tax identification number of the invoicing entity.`).option("--billing-email <value>", `The billing email address for the invoicing entity.`).option("--timezone <value>", `The timezone the invoicing entity operates in.`).option("--language <value>", `The default language of the invoicing entity.`).option("--is-default", `Flag to indicate if this is the default invoicing entity. If true, it will switch the other existing invoicing entities to non-default.`).option("--address-line1 <value>", `The first line of the address for the invoicing entity.`).option("--address-line2 <value>", `The second line of the address for the invoicing entity.`).option("--zip-code <value>", `The postal code for the invoicing entity's address.`).option("--state <value>", `The state or province of the invoicing entity.`).option("--city <value>", `The city of the invoicing entity.`).option("--country <value>", `The country in which the invoicing entity is registered. It cannot be changed after creation.`).option("--currency <value>", `The currency code that the invoicing entity operates in.`).option("--accounting-currency <value>", `The currency used for accounting purposes.`).option("--invoice-number-pattern <value>", `The pattern used for generating invoice numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--credit-note-number-pattern <value>", `The pattern used for generating credit note numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--document-number-pattern <value>", `The pattern used for generating document numbers. Available dynamic elements: number {number} (mandatory), year {YYYY}, month {MM} and day {DD}.`).option("--default-payment-delay <number>", `The default payment term in days.`).option("--invoice-grace-period-duration <number>", `The grace period duration in days.`).option("--invoice-payment-initiation-delay <number>", `The payment initiation delay in days for the invoices.`).option("--document-payment-initiation-delay <number>", `The payment initiation delay in days for the custom documents.`).option("--invoice-late-fees <value>", `The late fees applicable to the invoices.`).option("--invoice-footer <value>", `The footer text to be used in invoices.`).option("--document-footer <value>", `The footer text to be used in documents. If not specified, the invoice footer will be used.`).option("--logo-url <value>", `URL of the logo to be used in invoices.`).option("--favicon-url <value>", `URL of the logo to be used as favicon.`).option("--brand-color <value>", `Brand color to be used in invoices (hexadecimal color code).`).option("--forced-customer-type <value>", `Forces all customers created under this invoicing entity to have this type. Set to null to allow users to choose.`).option("--credit-note-wallet-refund-enabled", `When enabled and no \`refund_method\` is specified, credit note refunds default to the customer's wallet, including credit notes generated by subscription updates, cancellations, and transitions. An explicit \`refund_method\` always wins. Requires wallets to be enabled at the workspace level.`).option("--standalone-credit-note-creation-enabled", `Whether credit notes without an original invoice can be created under this invoicing entity.`).addHelpText("after", `
 Examples:
     hyperline invoicing-entities update-invoicing-entity --id <id>
     hyperline invoicing-entities update-invoicing-entity --id <id> --name <name> --registration-number <registration_number>
@@ -43720,7 +43704,7 @@ Payment method strategy used to bill the subscription. By default, the current p
 - \`current\`: Use the current default payment method of the customer.
 - \`external\`: Manage the payments of the subscription outside of Hyperline.
 `).option("--available-payment-method-types <json>", `Set the allowed types of payment methods for the customer. Only applies to the \`new\` payment method strategy.`).option("--billing-cycle-alignment <value>", `
-Alignment of product billing cycles. Only applies when creating a subscription from a plan.
+Alignment of product billing cycles. Only applies when creating a subscription from a plan. If omitted, the billing cycles alignment configured in the account subscription settings applies.
 
 - \`calendar_period\`: The billing cycles of the products will be aligned on the calendar period, after the first period which will be invoiced taking into account the prorata of the first cycle compared to the product periodicity.
 - \`anniversary\`: The billing cycles of the products will be aligned on the anniversary of the phase initial billing date.
@@ -43812,7 +43796,16 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("list").description(`List subscriptions with filters for activation_strategy, status, currency, plan_id, original_quote_id, integration_entity_id, customer_id, invoicing_entity_id, purchase_order, updated_at, custom_properties. Draft, voided, and cancelled excluded by default. Paginated with take/skip.`).option("--take <number>", `take`).option("--skip <number>", `skip`).option("--activation-strategy <value>", `activation_strategy`).option("--activation-strategy.in <value>", `activation_strategy__in`).option("--status <value>", `status`).option("--status.in <value>", `status__in`).option("--currency <value>", `currency`).option("--currency.not <value>", `currency__not`).option("--currency.is-null <value>", `currency__isNull`).option("--currency.is-not-null <value>", `currency__isNotNull`).option("--currency.equals <value>", `currency__equals`).option("--currency.contains <value>", `currency__contains`).option("--currency.starts-with <value>", `currency__startsWith`).option("--currency.end-with <value>", `currency__endWith`).option("--plan-id <value>", `plan_id`).option("--plan-id.not <value>", `plan_id__not`).option("--plan-id.is-null <value>", `plan_id__isNull`).option("--plan-id.is-not-null <value>", `plan_id__isNotNull`).option("--plan-id.equals <value>", `plan_id__equals`).option("--plan-id.contains <value>", `plan_id__contains`).option("--plan-id.starts-with <value>", `plan_id__startsWith`).option("--plan-id.end-with <value>", `plan_id__endWith`).option("--original-quote-id <value>", `original_quote_id`).option("--original-quote-id.not <value>", `original_quote_id__not`).option("--original-quote-id.is-null <value>", `original_quote_id__isNull`).option("--original-quote-id.is-not-null <value>", `original_quote_id__isNotNull`).option("--original-quote-id.equals <value>", `original_quote_id__equals`).option("--original-quote-id.contains <value>", `original_quote_id__contains`).option("--original-quote-id.starts-with <value>", `original_quote_id__startsWith`).option("--original-quote-id.end-with <value>", `original_quote_id__endWith`).option("--customer-id <value>", `customer_id`).option("--customer-id.not <value>", `customer_id__not`).option("--customer-id.is-null <value>", `customer_id__isNull`).option("--customer-id.is-not-null <value>", `customer_id__isNotNull`).option("--customer-id.equals <value>", `customer_id__equals`).option("--customer-id.contains <value>", `customer_id__contains`).option("--customer-id.starts-with <value>", `customer_id__startsWith`).option("--customer-id.end-with <value>", `customer_id__endWith`).option("--invoicing-entity-id <value>", `invoicing_entity_id`).option("--purchase-order <value>", `purchase_order`).option("--purchase-order.not <value>", `purchase_order__not`).option("--purchase-order.is-null <value>", `purchase_order__isNull`).option("--purchase-order.is-not-null <value>", `purchase_order__isNotNull`).option("--purchase-order.equals <value>", `purchase_order__equals`).option("--purchase-order.contains <value>", `purchase_order__contains`).option("--purchase-order.starts-with <value>", `purchase_order__startsWith`).option("--purchase-order.end-with <value>", `purchase_order__endWith`).option("--custom-properties <value>", `custom_properties`).option("--invoice-drafts <value>", `invoice_drafts`).option("--integration-entity-id <value>", `integration_entity_id`).option("--updated-at <value>", `updated_at`).option("--updated-at.not <value>", `updated_at__not`).option("--updated-at.is-null <value>", `updated_at__isNull`).option("--updated-at.is-not-null <value>", `updated_at__isNotNull`).option("--updated-at.equals <value>", `updated_at__equals`).option("--updated-at.lt <value>", `updated_at__lt`).option("--updated-at.lte <value>", `updated_at__lte`).option("--updated-at.gt <value>", `updated_at__gt`).option("--updated-at.gte <value>", `updated_at__gte`).addHelpText("after", `
+  resource.command("list").description(`List subscriptions with filters for activation_strategy, status, currency, plan_id, original_quote_id, integration_entity_id, customer_id, invoicing_entity_id, purchase_order, updated_at, custom_properties. Draft, voided, cancelled and archived excluded by default (status=all applies the same exclusion); status=any returns every status. Paginated with take/skip.`).option("--take <number>", `take`).option("--skip <number>", `skip`).option("--activation-strategy <value>", `activation_strategy`).option("--activation-strategy.in <value>", `activation_strategy__in`).option("--status <value>", `
+Subscription status filter.
+
+- \`active\`, \`pending\`, \`paused\`, \`errored\`, \`cancelled\`, \`draft\`, \`voided\`, \`archived\`: match that status.
+- \`inactive\`: shortcut for \`pending\` + \`paused\`.
+- \`all\`: every status except \`draft\`, \`voided\`, \`cancelled\` and \`archived\` \u2014 the same exclusion as omitting the filter.
+- \`any\`: every status, no exclusion.
+
+Use \`status__in\` with comma-separated values to combine statuses. When the filter is omitted, \`draft\`, \`voided\`, \`cancelled\` and \`archived\` subscriptions are excluded.
+`).option("--status.in <value>", `Comma-separated list of subscription statuses to include. Same values as \`status\`.`).option("--currency <value>", `currency`).option("--currency.not <value>", `currency__not`).option("--currency.is-null <value>", `currency__isNull`).option("--currency.is-not-null <value>", `currency__isNotNull`).option("--currency.equals <value>", `currency__equals`).option("--currency.contains <value>", `currency__contains`).option("--currency.starts-with <value>", `currency__startsWith`).option("--currency.end-with <value>", `currency__endWith`).option("--plan-id <value>", `plan_id`).option("--plan-id.not <value>", `plan_id__not`).option("--plan-id.is-null <value>", `plan_id__isNull`).option("--plan-id.is-not-null <value>", `plan_id__isNotNull`).option("--plan-id.equals <value>", `plan_id__equals`).option("--plan-id.contains <value>", `plan_id__contains`).option("--plan-id.starts-with <value>", `plan_id__startsWith`).option("--plan-id.end-with <value>", `plan_id__endWith`).option("--original-quote-id <value>", `original_quote_id`).option("--original-quote-id.not <value>", `original_quote_id__not`).option("--original-quote-id.is-null <value>", `original_quote_id__isNull`).option("--original-quote-id.is-not-null <value>", `original_quote_id__isNotNull`).option("--original-quote-id.equals <value>", `original_quote_id__equals`).option("--original-quote-id.contains <value>", `original_quote_id__contains`).option("--original-quote-id.starts-with <value>", `original_quote_id__startsWith`).option("--original-quote-id.end-with <value>", `original_quote_id__endWith`).option("--customer-id <value>", `customer_id`).option("--customer-id.not <value>", `customer_id__not`).option("--customer-id.is-null <value>", `customer_id__isNull`).option("--customer-id.is-not-null <value>", `customer_id__isNotNull`).option("--customer-id.equals <value>", `customer_id__equals`).option("--customer-id.contains <value>", `customer_id__contains`).option("--customer-id.starts-with <value>", `customer_id__startsWith`).option("--customer-id.end-with <value>", `customer_id__endWith`).option("--invoicing-entity-id <value>", `invoicing_entity_id`).option("--purchase-order <value>", `purchase_order`).option("--purchase-order.not <value>", `purchase_order__not`).option("--purchase-order.is-null <value>", `purchase_order__isNull`).option("--purchase-order.is-not-null <value>", `purchase_order__isNotNull`).option("--purchase-order.equals <value>", `purchase_order__equals`).option("--purchase-order.contains <value>", `purchase_order__contains`).option("--purchase-order.starts-with <value>", `purchase_order__startsWith`).option("--purchase-order.end-with <value>", `purchase_order__endWith`).option("--custom-properties <value>", `custom_properties`).option("--invoice-drafts <value>", `invoice_drafts`).option("--integration-entity-id <value>", `integration_entity_id`).option("--updated-at <value>", `updated_at`).option("--updated-at.not <value>", `updated_at__not`).option("--updated-at.is-null <value>", `updated_at__isNull`).option("--updated-at.is-not-null <value>", `updated_at__isNotNull`).option("--updated-at.equals <value>", `updated_at__equals`).option("--updated-at.lt <value>", `updated_at__lt`).option("--updated-at.lte <value>", `updated_at__lte`).option("--updated-at.gt <value>", `updated_at__gt`).option("--updated-at.gte <value>", `updated_at__gte`).addHelpText("after", `
 Examples:
     hyperline subscriptions list
     hyperline subscriptions list --take <take> --activation-strategy <activation_strategy>`).action(async (opts) => {
@@ -44439,7 +44432,7 @@ Examples:
       ]
     });
   });
-  resource.command("create-subscription-transition").description(`Create a transition from one subscription to another, configured from a subscription, plan, or template. Can be applied immediately or scheduled.`).requiredOption("--source-subscription-id <value>", `The ID of the subscription to transition from`).option("--name <value>", `An optional name for the transition`).option("--calculation-method <value>", `The calculation method to use for the transition. 'do_not_charge' will not generate any transition invoice. 'pro_rata' will generate a prorated invoice for the remaining period. 'pro_rata_separate_documents' issues a credit note for the current period (the amount invoiced when 'last_renewal', otherwise a prorated cancellation credit) and a separate invoice for the new configuration.`).option("--billing-cycle-transition-method <value>", `The billing cycle transition method to use. 'keep_current_billing_cycle' (the default) keeps the current billing cycle dates; the request is rejected when the phases share no product billing periodicity, as the cycle cannot then be preserved \u2014 use 'align_to_new_billing_cycle' in that case. 'align_to_new_billing_cycle' aligns the billing cycle to the transition date.`).requiredOption("--application-schedule <value>", `When the transition should be applied: 'immediately', 'scheduled' for a specific date, or 'last_renewal' to apply it retroactively to the start of the current billing period (refunding what was already invoiced for that period and re-charging the new configuration). Past dates within the current billing period are supported and will be applied immediately.`).option("--transition-date <value>", `The date at which the transition should occur. Only applicable if the application schedule is 'scheduled'. Can be a past date within the current billing period. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).requiredOption("--target-subscription <json>", `The configuration of the subscription to transition to`).addHelpText("after", `
+  resource.command("create-subscription-transition").description(`Submit a transition from one subscription to another. The result may be pending approval, applied immediately, or scheduled.`).requiredOption("--source-subscription-id <value>", `The ID of the subscription to transition from`).option("--name <value>", `An optional name for the transition`).option("--calculation-method <value>", `The calculation method to use for the transition. 'do_not_charge' will not generate any transition invoice. 'pro_rata' will generate a prorated invoice for the remaining period. 'pro_rata_separate_documents' issues a credit note for the current period (the amount invoiced when 'last_renewal', otherwise a prorated cancellation credit) and a separate invoice for the new configuration.`).option("--billing-cycle-transition-method <value>", `The billing cycle transition method to use. 'keep_current_billing_cycle' (the default) keeps the current billing cycle dates; the request is rejected when the phases share no product billing periodicity, as the cycle cannot then be preserved \u2014 use 'align_to_new_billing_cycle' in that case. 'align_to_new_billing_cycle' aligns the billing cycle to the transition date.`).requiredOption("--application-schedule <value>", `When the transition should be applied: 'immediately', 'scheduled' for a specific date, or 'last_renewal' to apply it retroactively to the start of the current billing period (refunding what was already invoiced for that period and re-charging the new configuration). Past dates within the current billing period are supported and will be applied immediately.`).option("--transition-date <value>", `The date at which the transition should occur. Only applicable if the application schedule is 'scheduled'. Can be a past date within the current billing period. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).requiredOption("--target-subscription <json>", `The configuration of the subscription to transition to`).addHelpText("after", `
 Examples:
     hyperline subscriptions-transitions create-subscription-transition --source-subscription-id <source_subscription_id> --application-schedule <application_schedule> --target-subscription <target_subscription>
     hyperline subscriptions-transitions create-subscription-transition --source-subscription-id <source_subscription_id> --application-schedule <application_schedule> --target-subscription <target_subscription> --name <name> --calculation-method <calculation_method>
@@ -44876,7 +44869,7 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("load").description(`Add paid credits by charging the customer's payment method, or add free credits by issuing a credit note.`).requiredOption("--id <value>", `id parameter`).option("--type <value>", `Wallet load type. Use \`paid\` to collect payment from the customer's payment method, or \`free\` to grant credits without collecting payment.`).option("--amount <number>", `Amount to be loaded onto the wallet as free credits. A corresponding credit note will be generated and no payment is collected. Expressed in currency's smallest unit.`).option("--comment <value>", `Internal comment stored on the wallet transaction for context.`).option("--document-status <value>", `Indicates the status of the generated credit note for free top-ups.`).option("--bank-account-id <value>", `Bank account ID to use when recording a paid wallet load by bank transfer.`).option("--reference <value>", `Reference stored on the payment transaction for a paid wallet load.`).addHelpText("after", `
+  resource.command("load").description(`Add free credits, load selected line items from a paid invoice, apply unallocated funds from an existing payment transaction, or record a new paid transaction.`).requiredOption("--id <value>", `id parameter`).option("--type <value>", `Wallet load type. Use \`paid\` to load paid invoice line items, apply an existing payment transaction, or record a new one, or \`free\` to grant credits without collecting payment.`).option("--amount <number>", `Amount to be loaded onto the wallet as free credits. A corresponding credit note will be generated and no payment is collected. Expressed in currency's smallest unit.`).option("--comment <value>", `Internal comment stored on the wallet transaction for context.`).option("--document-status <value>", `Indicates the status of the generated credit note for free top-ups.`).option("--transaction-id <value>", `Existing payment transaction ID whose unallocated amount will be loaded onto the wallet.`).option("--invoice-id <value>", `Paid invoice ID whose selected line items will be loaded onto the wallet.`).option("--invoice-line-item-ids <json>", `IDs of paid invoice line items whose combined amount will be loaded onto the wallet.`).option("--date <value>", `Date of the new offline payment transaction recorded for the wallet load. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).option("--bank-account-id <value>", `Bank account ID to use when recording a new paid wallet load by bank transfer.`).option("--reference <value>", `Reference stored on the new payment transaction for a paid wallet load.`).addHelpText("after", `
 Examples:
     hyperline wallets load --id <id>
     hyperline wallets load --id <id> --type <type> --amount <amount>
@@ -44895,12 +44888,20 @@ Examples:
       args.comment = opts.comment;
     if (opts.documentStatus !== void 0)
       args.document_status = opts.documentStatus;
+    if (opts.transactionId !== void 0)
+      args.transaction_id = opts.transactionId;
+    if (opts.invoiceId !== void 0)
+      args.invoice_id = opts.invoiceId;
+    if (opts.date !== void 0)
+      args.date = opts.date;
     if (opts.bankAccountId !== void 0)
       args.bank_account_id = opts.bankAccountId;
     if (opts.reference !== void 0)
       args.reference = opts.reference;
     if (opts.amount !== void 0)
       args.amount = Number(opts.amount);
+    if (opts.invoiceLineItemIds !== void 0)
+      args.invoice_line_item_ids = JSON.parse(opts.invoiceLineItemIds);
     await ctx.execute({
       method: "POST",
       path: "/v1/wallets/{id}/load",
@@ -61150,6 +61151,7 @@ var de = {
   "invoices.prorata.paymentForItemFullPeriod": "Zahlung f\xFCr",
   "invoices.prorata.refundForItem": "Anteilig erstatteter Betrag f\xFCr",
   "invoices.prorata.refundForItemFullPeriod": "Erstattung f\xFCr",
+  "wallets.expiredBalanceInvoiceLineName": "{{walletName}} \u2013 abgelaufenes Guthaben",
   "subscriptions.closingChargeName": "Abschlussgeb\xFChr f\xFCr das Abonnement",
   "subscriptions.correction": "Vorperiodische Anpassung",
   "subscriptions.updates.addCoupon": "Gutschein hinzuf\xFCgen {{couponName}}",
@@ -61181,6 +61183,7 @@ var en = {
   "invoices.prorata.paymentForItemFullPeriod": "Payment for",
   "invoices.prorata.refundForItem": "Prorated refund for",
   "invoices.prorata.refundForItemFullPeriod": "Refund for",
+  "wallets.expiredBalanceInvoiceLineName": "{{walletName}} \u2013 expired balance",
   "subscriptions.closingChargeName": "Closing fee for subscription",
   "subscriptions.correction": "Adjustment previous period",
   "subscriptions.updates.addCoupon": "Add coupon {{couponName}}",
@@ -61240,6 +61243,7 @@ var es = {
   "invoices.prorata.paymentForItemFullPeriod": "Pago por",
   "invoices.prorata.refundForItem": "Reembolso prorrateado por",
   "invoices.prorata.refundForItemFullPeriod": "Reembolso por",
+  "wallets.expiredBalanceInvoiceLineName": "{{walletName}} \u2013 saldo caducado",
   "subscriptions.closingChargeName": "Cargo por cierre de suscripci\xF3n",
   "subscriptions.correction": "Ajuste del periodo anterior",
   "subscriptions.updates.addCoupon": "A\xF1adir cup\xF3n {{couponName}}",
@@ -61285,6 +61289,7 @@ var fr = {
   "invoices.prorata.paymentForItemFullPeriod": "Paiement pour",
   "invoices.prorata.refundForItem": "Remboursement au prorata pour",
   "invoices.prorata.refundForItemFullPeriod": "Remboursement pour",
+  "wallets.expiredBalanceInvoiceLineName": "{{walletName}} \u2013 solde expir\xE9",
   "subscriptions.closingChargeName": "Frais de cl\xF4ture pour abonnement",
   "subscriptions.correction": "Ajustement p\xE9riode pr\xE9c\xE9dente",
   "subscriptions.updates.addCoupon": "Ajout du coupon {{couponName}}",
@@ -61330,6 +61335,7 @@ var it = {
   "invoices.prorata.paymentForItemFullPeriod": "Pagamento per",
   "invoices.prorata.refundForItem": "Rimborso proporzionale per",
   "invoices.prorata.refundForItemFullPeriod": "Rimborso per",
+  "wallets.expiredBalanceInvoiceLineName": "{{walletName}} \u2013 saldo scaduto",
   "subscriptions.closingChargeName": "Costo di chiusura per abbonamento",
   "subscriptions.correction": "Correzione periodo precedente",
   "subscriptions.updates.addCoupon": "Aggiungi coupon {{couponName}}",
@@ -61375,6 +61381,7 @@ var nl = {
   "invoices.prorata.paymentForItemFullPeriod": "Betaling voor",
   "invoices.prorata.refundForItem": "Gedeeltelijke terugbetaling voor",
   "invoices.prorata.refundForItemFullPeriod": "Terugbetaling voor",
+  "wallets.expiredBalanceInvoiceLineName": "{{walletName}} \u2013 verlopen saldo",
   "subscriptions.closingChargeName": "Afsluitkosten voor abonnement",
   "subscriptions.correction": "Aanpassing vorige periode",
   "subscriptions.updates.addCoupon": "Coupon toevoegen {{couponName}}",
@@ -61420,6 +61427,7 @@ var pl = {
   "invoices.prorata.paymentForItemFullPeriod": "P\u0142atno\u015B\u0107 za",
   "invoices.prorata.refundForItem": "Zwrot proporcjonalny za",
   "invoices.prorata.refundForItemFullPeriod": "Zwrot za",
+  "wallets.expiredBalanceInvoiceLineName": "{{walletName}} \u2013 wygas\u0142e saldo",
   "subscriptions.closingChargeName": "Op\u0142ata za zamkni\u0119cie subskrypcji",
   "subscriptions.correction": "Korekta poprzedniego okresu",
   "subscriptions.updates.addCoupon": "Dodaj kupon {{couponName}}",
@@ -61465,6 +61473,7 @@ var pt = {
   "invoices.prorata.paymentForItemFullPeriod": "Pagamento por",
   "invoices.prorata.refundForItem": "Reembolso proporcional por",
   "invoices.prorata.refundForItemFullPeriod": "Reembolso por",
+  "wallets.expiredBalanceInvoiceLineName": "{{walletName}} \u2013 saldo expirado",
   "subscriptions.closingChargeName": "Taxa de encerramento da assinatura",
   "subscriptions.correction": "Ajuste do per\xEDodo anterior",
   "subscriptions.updates.addCoupon": "Adicionar cupom {{couponName}}",
@@ -64185,6 +64194,7 @@ var import_shared3 = __toESM(require_shared(), 1);
 import * as https from "node:https";
 
 // ../hyperline-lib/build/utils/json.js
+import { createHash as createHash2 } from "node:crypto";
 import { deepEqual } from "fast-equals";
 
 // ../hyperline-lib/build/utils/api/filterBuilder.js
@@ -64237,7 +64247,7 @@ import { RateLimiterRedis as RateLimiterRedis2, RateLimiterRes as RateLimiterRes
 import multer from "multer";
 
 // ../hyperline-lib/build/http/middlewares/idempotency.js
-import { createHash as createHash2 } from "node:crypto";
+import { createHash as createHash3 } from "node:crypto";
 import { isDeepStrictEqual } from "node:util";
 import { idempotency } from "express-idempotency";
 
@@ -64415,12 +64425,6 @@ var defaultToolOutputSchema = {
   result: external_exports.unknown()
 };
 
-// ../hyperline-mcp/build/session/sessionKey.js
-import { createHmac } from "node:crypto";
-
-// ../hyperline-mcp/build/session/sessionManager.js
-import { LRUCache } from "lru-cache";
-
 // build/output.js
 function formatOutput({ data, format: format2 }) {
   if (format2 === "json") {

package/dist/external-deps.json

@@ -14,7 +14,6 @@
   "helmet": "6.2.0",
   "i18next": "22.5.1",
   "json-prune": "1.1.0",
-  "lru-cache": "11.0.2",
   "multer": "1.4.5-lts.1",
   "rate-limiter-flexible": "11.0.0",
   "stacktrace-parser": "0.1.10",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperline/cli",
-  "version": "0.1.0-build.1.335e98c",
+  "version": "0.1.0-build.1.34b338e",
   "description": "Agent-first CLI for Hyperline API",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,6 @@
     "helmet": "6.2.0",
     "i18next": "22.5.1",
     "json-prune": "1.1.0",
-    "lru-cache": "11.0.2",
     "multer": "1.4.5-lts.1",
     "rate-limiter-flexible": "11.0.0",
     "stacktrace-parser": "0.1.10",