@hyperline/cli 0.1.0-build.1.d3d852c → 0.1.0-build.1.d9114b0

package/dist/bin/hyperline-main.js

@@ -30121,7 +30121,7 @@ Quote status.
 - \`draft\`: The quote is a draft.
 - \`approved\`: The quote is approved and ready to be sent to the customer.
 - \`pending_signature\`: The quote is awaiting the customer's signature.
-  `).option("--owner-email <value>", `Email address of the Hyperline user acting as the quote owner. If not specified, the Hyperline account owner will be assigned.`).requiredOption("--customer-id <value>", `ID of the customer.`).option("--invoicing-entity-id <value>", `ID of the invoicing entity attached to the quote.`).option("--comments <value>", `Custom comments displayed on the quote.`).option("--terms <value>", `Custom quotation terms.`).option("--amount <number>", `Estimated contract value. If not specified, automatically computed from the subscription configuration.`).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("--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-taxes <value>", `Display tax breakdown on the quote.`).option("--display-price-tiers <value>", `Controls which price tiers are displayed on the quote.
+  `).option("--owner-email <value>", `Email address of the Hyperline user acting as the quote owner. If not specified, the Hyperline account owner will be assigned.`).requiredOption("--customer-id <value>", `ID of the customer.`).option("--invoicing-entity-id <value>", `ID of the invoicing entity attached to the quote.`).option("--comments <value>", `Custom comments displayed on the quote.`).option("--terms <value>", `Custom quotation terms.`).option("--amount <number>", `Estimated contract value. If not specified, automatically computed from the subscription configuration.`).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("--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.
@@ -30157,6 +30157,8 @@ Examples:
       args.require_tax_id = opts.requireTaxId;
     if (opts.displayQuoteValue !== void 0)
       args.display_quote_value = opts.displayQuoteValue;
+    if (opts.displayQuoteValueWithTax !== void 0)
+      args.display_quote_value_with_tax = opts.displayQuoteValueWithTax;
     if (opts.displayTaxes !== void 0)
       args.display_taxes = opts.displayTaxes;
     if (opts.displayPriceTiers !== void 0)
@@ -30570,10 +30572,10 @@ Examples:
       queryParamKeys: []
     });
   });
-  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`).requiredOption("--calculation-method <value>", `calculation_method`).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`).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>
+    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>
     hyperline subscriptions create-subscription-update --id <id> --application-schedule <application_schedule> --payment-schedule <payment_schedule> --calculation-method <calculation_method> --type <type> --payload <payload> --output json`).action(async (opts) => {
     const ctx = resource.parent?.opts()._ctx;
     if (!ctx) {
@@ -30589,6 +30591,8 @@ Examples:
       args.apply_at = opts.applyAt;
     if (opts.paymentSchedule !== void 0)
       args.payment_schedule = opts.paymentSchedule;
+    if (opts.chargeAt !== void 0)
+      args.charge_at = opts.chargeAt;
     if (opts.calculationMethod !== void 0)
       args.calculation_method = opts.calculationMethod;
     if (opts.type !== void 0)
@@ -30602,10 +30606,10 @@ 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`).requiredOption("--calculation-method <value>", `calculation_method`).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`).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>
+    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>
     hyperline subscriptions create-subscription-updates --id <id> --application-schedule <application_schedule> --payment-schedule <payment_schedule> --calculation-method <calculation_method> --updates <updates> --output json`).action(async (opts) => {
     const ctx = resource.parent?.opts()._ctx;
     if (!ctx) {
@@ -30621,6 +30625,8 @@ Examples:
       args.apply_at = opts.applyAt;
     if (opts.paymentSchedule !== void 0)
       args.payment_schedule = opts.paymentSchedule;
+    if (opts.chargeAt !== void 0)
+      args.charge_at = opts.chargeAt;
     if (opts.calculationMethod !== void 0)
       args.calculation_method = opts.calculationMethod;
     if (opts.updates !== void 0)
@@ -30758,10 +30764,10 @@ 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`).requiredOption("--calculation-method <value>", `calculation_method`).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`).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>
+    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>
     hyperline subscriptions simulate-subscription-updates --id <id> --application-schedule <application_schedule> --payment-schedule <payment_schedule> --calculation-method <calculation_method> --updates <updates> --output json`).action(async (opts) => {
     const ctx = resource.parent?.opts()._ctx;
     if (!ctx) {
@@ -30777,6 +30783,8 @@ Examples:
       args.apply_at = opts.applyAt;
     if (opts.paymentSchedule !== void 0)
       args.payment_schedule = opts.paymentSchedule;
+    if (opts.chargeAt !== void 0)
+      args.charge_at = opts.chargeAt;
     if (opts.calculationMethod !== void 0)
       args.calculation_method = opts.calculationMethod;
     if (opts.updates !== void 0)
@@ -31098,10 +31106,254 @@ Examples:
       ]
     });
   });
+  resource.command("get").description(`Retrieve full details of a subscription by ID including phases, products, billing dates, and status. Optionally include live_billing data.`).requiredOption("--id <value>", `id parameter`).option("--include-live-billing <value>", `include_live_billing`).addHelpText("after", `
+Examples:
+    hyperline subscriptions get --id <id>
+    hyperline subscriptions get --id <id> --include-live-billing <include_live_billing>`).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.includeLiveBilling !== void 0)
+      args.include_live_billing = opts.includeLiveBilling;
+    await ctx.execute({
+      method: "GET",
+      path: "/v2/subscriptions/{id}",
+      args,
+      queryParamKeys: ["include_live_billing"]
+    });
+  });
+  resource.command("refresh-subscription-seat-products").description(`Trigger a count update on seat-based products within a subscription using the configured dataloader query.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
+Examples:
+    hyperline subscriptions refresh-subscription-seat-products --id <id>
+    hyperline subscriptions refresh-subscription-seat-products --id <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;
+    await ctx.execute({
+      method: "POST",
+      path: "/v2/subscriptions/{id}/refresh-seat-products",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("update").description(`Comprehensive subscription update: modify fields, manage phases (add/update/delete pending phases), update products within phases, and manage coupons. Payload mirrors GET response structure.`).requiredOption("--id <value>", `id parameter`).option("--name <value>", `Subscription custom name.`).option("--purchase-order <value>", `Reference to the purchase order.`).option("--minimum-invoice-fee <number>", `Minimum fee applied to each invoice outside of one time payments.`).option("--crm-opportunity-id <value>", `ID of the related opportunity/deal in the connected CRM.`).option("--tax-only <value>", `Only tax will be charged on this subscription.`).option("--generate-draft-invoices <value>", `Generate draft invoices for the subscription. Each invoice will need to be reviewed and validated manually before being sent`).option("--generate-document <value>", `Generate non-legal documents instead of invoices.`).option("--document-name <value>", `If \`generate_document\` is turned on, allows you to give a name to your document.`).option("--add-tax-to-document <value>", `If \`generate_document\` is turned on, will add taxes to document.`).option("--do-not-charge-subscription <value>", `Subscription will be invoiced but not charged (invoices/documents will be settled directly).`).option("--invoice-custom-note <value>", `Default custom note added to invoices generated by the subscription.`).option("--invoice-schedule <value>", `
+Defines when invoices are generated relative to the billing period.
+
+- \`period_start\`: Invoices are generated at the start of the billing period.
+- \`period_end\`: Invoices are generated at the end of the billing period.
+`).option("--estimated-arr <number>", `Estimated Annual Recurring Revenue generated by the subscription.`).option("--contract-value <number>", `Contract value of the subscription. This value is overridable by the user.`).option("--starts-at <value>", `Applies only if the activation strategy is \`start_date\`. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).option("--initial-billing-at <value>", `Date when the subscription will start being billed. If not specified, it will correspond to the \`starts_at\` date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).option("--cancel-at <value>", `Subscription cancel date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).option("--properties <value>", `Key/value pairs to store any metadata useful in your context.`).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("--display-shipping-details <value>", `Indicates if the shipping details should be displayed on the subscription's invoices.`).option("--phases <value>", `Array of subscription phases. Existing pending phases will be replaced by the ones in the array.`).option("--contract-terms <value>", `Contract terms to update.`).addHelpText("after", `
+Examples:
+    hyperline subscriptions update --id <id>
+    hyperline subscriptions update --id <id> --name <name> --purchase-order <purchase_order>
+    hyperline subscriptions update --id <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.name !== void 0)
+      args.name = opts.name;
+    if (opts.purchaseOrder !== void 0)
+      args.purchase_order = opts.purchaseOrder;
+    if (opts.crmOpportunityId !== void 0)
+      args.crm_opportunity_id = opts.crmOpportunityId;
+    if (opts.taxOnly !== void 0)
+      args.tax_only = opts.taxOnly;
+    if (opts.generateDraftInvoices !== void 0)
+      args.generate_draft_invoices = opts.generateDraftInvoices;
+    if (opts.generateDocument !== void 0)
+      args.generate_document = opts.generateDocument;
+    if (opts.documentName !== void 0)
+      args.document_name = opts.documentName;
+    if (opts.addTaxToDocument !== void 0)
+      args.add_tax_to_document = opts.addTaxToDocument;
+    if (opts.doNotChargeSubscription !== void 0)
+      args.do_not_charge_subscription = opts.doNotChargeSubscription;
+    if (opts.invoiceCustomNote !== void 0)
+      args.invoice_custom_note = opts.invoiceCustomNote;
+    if (opts.invoiceSchedule !== void 0)
+      args.invoice_schedule = opts.invoiceSchedule;
+    if (opts.startsAt !== void 0)
+      args.starts_at = opts.startsAt;
+    if (opts.initialBillingAt !== void 0)
+      args.initial_billing_at = opts.initialBillingAt;
+    if (opts.cancelAt !== void 0)
+      args.cancel_at = opts.cancelAt;
+    if (opts.properties !== void 0)
+      args.properties = opts.properties;
+    if (opts.customProperties !== void 0)
+      args.custom_properties = opts.customProperties;
+    if (opts.displayShippingDetails !== void 0)
+      args.display_shipping_details = opts.displayShippingDetails;
+    if (opts.phases !== void 0)
+      args.phases = opts.phases;
+    if (opts.contractTerms !== void 0)
+      args.contract_terms = opts.contractTerms;
+    if (opts.minimumInvoiceFee !== void 0)
+      args.minimum_invoice_fee = Number(opts.minimumInvoiceFee);
+    if (opts.estimatedArr !== void 0)
+      args.estimated_arr = Number(opts.estimatedArr);
+    if (opts.contractValue !== void 0)
+      args.contract_value = Number(opts.contractValue);
+    await ctx.execute({
+      method: "PUT",
+      path: "/v2/subscriptions/{id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("get-subscription-valuation").description(`Compute valuation metrics for a subscription: contract value (total/invoiced/remaining), recurring contract value, and ARR (fixed + variable). Optionally pass granularity (year/quarter/month) for period breakdown.`).requiredOption("--id <value>", `id parameter`).option("--granularity <value>", `Period granularity for the breakdown. When provided, contract value and recurring contract value include a \`by_period\` array.`).addHelpText("after", `
+Examples:
+    hyperline subscriptions get-subscription-valuation --id <id>
+    hyperline subscriptions get-subscription-valuation --id <id> --granularity <granularity>`).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.granularity !== void 0)
+      args.granularity = opts.granularity;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/subscriptions/{id}/valuation",
+      args,
+      queryParamKeys: ["granularity"]
+    });
+  });
+}
+
+// build/commands/generated/subscriptions-phases.js
+function registerSubscriptions_PhasesCommands(parent) {
+  const resource = parent.command("subscriptions-phases").description("Manage subscriptions > phases");
+  resource.command("list-subscription-phases").description(`List all phases of a subscription. Phases define time-bound product configurations within a subscription.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
+Examples:
+    hyperline subscriptions-phases list-subscription-phases --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: "/v2/subscriptions/{id}/phases",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("get-subscription-phase").description(`Retrieve details of a specific phase within a subscription, including its products and billing configuration.`).requiredOption("--id <value>", `id parameter`).requiredOption("--phase-id <value>", `phaseId parameter`).addHelpText("after", `
+Examples:
+    hyperline subscriptions-phases get-subscription-phase --id <id> --phase-id <phaseId>`).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.phaseId !== void 0)
+      args.phaseId = opts.phaseId;
+    await ctx.execute({
+      method: "GET",
+      path: "/v2/subscriptions/{id}/phases/{phaseId}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("transition-subscription").description(`Transition a subscription to its next configured phase at a specified date.`).requiredOption("--id <value>", `id parameter`).option("--transition-date <value>", `Date of application of the transition. Use it if different than immediately to calculate pro-rata and display past or future dates on invoices. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).addHelpText("after", `
+Examples:
+    hyperline subscriptions-phases transition-subscription --id <id>
+    hyperline subscriptions-phases transition-subscription --id <id> --transition-date <transition_date>
+    hyperline subscriptions-phases transition-subscription --id <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.transitionDate !== void 0)
+      args.transition_date = opts.transitionDate;
+    await ctx.execute({
+      method: "POST",
+      path: "/v2/subscriptions/{id}/next-phase",
+      args,
+      queryParamKeys: []
+    });
+  });
+}
+
+// build/commands/generated/subscriptions-templates.js
+function registerSubscriptions_TemplatesCommands(parent) {
+  const resource = parent.command("subscriptions-templates").description("Manage subscriptions > templates");
+  resource.command("list-subscription-templates").description(`List subscription templates with pagination. Templates define reusable subscription configurations with pre-configured products, phases, and billing settings.`).option("--take <number>", `take`).option("--skip <number>", `skip`).addHelpText("after", `
+Examples:
+    hyperline subscriptions-templates list-subscription-templates
+    hyperline subscriptions-templates list-subscription-templates --take <take>`).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.take !== void 0)
+      args.take = Number(opts.take);
+    if (opts.skip !== void 0)
+      args.skip = Number(opts.skip);
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/subscriptions/templates",
+      args,
+      queryParamKeys: ["take", "skip"]
+    });
+  });
+  resource.command("get-subscription-template").description(`Retrieve a subscription template by ID with its full configuration including products, phases, and pricing details.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
+Examples:
+    hyperline subscriptions-templates get-subscription-template --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/subscriptions/templates/{id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+}
+
+// build/commands/generated/subscriptions-transitions.js
+function registerSubscriptions_TransitionsCommands(parent) {
+  const resource = parent.command("subscriptions-transitions").description("Manage subscriptions > transitions");
   resource.command("list-subscription-transitions").description(`List subscription transitions (migrations from one subscription to another). Filterable and paginated with take/skip.`).option("--take <number>", `take`).option("--skip <number>", `skip`).option("--status <value>", `status`).option("--status.in <value>", `status__in`).option("--source-subscription-id <value>", `source_subscription_id`).option("--source-subscription-id.not <value>", `source_subscription_id__not`).option("--source-subscription-id.is-null <value>", `source_subscription_id__isNull`).option("--source-subscription-id.is-not-null <value>", `source_subscription_id__isNotNull`).option("--source-subscription-id.equals <value>", `source_subscription_id__equals`).option("--source-subscription-id.contains <value>", `source_subscription_id__contains`).option("--source-subscription-id.starts-with <value>", `source_subscription_id__startsWith`).option("--source-subscription-id.end-with <value>", `source_subscription_id__endWith`).option("--base-subscription-id <value>", `base_subscription_id`).option("--base-subscription-id.not <value>", `base_subscription_id__not`).option("--base-subscription-id.is-null <value>", `base_subscription_id__isNull`).option("--base-subscription-id.is-not-null <value>", `base_subscription_id__isNotNull`).option("--base-subscription-id.equals <value>", `base_subscription_id__equals`).option("--base-subscription-id.contains <value>", `base_subscription_id__contains`).option("--base-subscription-id.starts-with <value>", `base_subscription_id__startsWith`).option("--base-subscription-id.end-with <value>", `base_subscription_id__endWith`).option("--target-subscription-id <value>", `target_subscription_id`).option("--target-subscription-id.not <value>", `target_subscription_id__not`).option("--target-subscription-id.is-null <value>", `target_subscription_id__isNull`).option("--target-subscription-id.is-not-null <value>", `target_subscription_id__isNotNull`).option("--target-subscription-id.equals <value>", `target_subscription_id__equals`).option("--target-subscription-id.contains <value>", `target_subscription_id__contains`).option("--target-subscription-id.starts-with <value>", `target_subscription_id__startsWith`).option("--target-subscription-id.end-with <value>", `target_subscription_id__endWith`).option("--transition-date <value>", `transition_date`).option("--transition-date.not <value>", `transition_date__not`).option("--transition-date.is-null <value>", `transition_date__isNull`).option("--transition-date.is-not-null <value>", `transition_date__isNotNull`).option("--transition-date.equals <value>", `transition_date__equals`).option("--transition-date.lt <value>", `transition_date__lt`).option("--transition-date.lte <value>", `transition_date__lte`).option("--transition-date.gt <value>", `transition_date__gt`).option("--transition-date.gte <value>", `transition_date__gte`).option("--transitioned-at <value>", `transitioned_at`).option("--transitioned-at.not <value>", `transitioned_at__not`).option("--transitioned-at.is-null <value>", `transitioned_at__isNull`).option("--transitioned-at.is-not-null <value>", `transitioned_at__isNotNull`).option("--transitioned-at.equals <value>", `transitioned_at__equals`).option("--transitioned-at.lt <value>", `transitioned_at__lt`).option("--transitioned-at.lte <value>", `transitioned_at__lte`).option("--transitioned-at.gt <value>", `transitioned_at__gt`).option("--transitioned-at.gte <value>", `transitioned_at__gte`).addHelpText("after", `
 Examples:
-    hyperline subscriptions list-subscription-transitions
-    hyperline subscriptions list-subscription-transitions --take <take> --status <status>`).action(async (opts) => {
+    hyperline subscriptions-transitions list-subscription-transitions
+    hyperline subscriptions-transitions list-subscription-transitions --take <take> --status <status>`).action(async (opts) => {
     const ctx = resource.parent?.opts()._ctx;
     if (!ctx) {
       process.stderr.write("Error: Not authenticated\n");
@@ -31254,180 +31506,11 @@ Examples:
       ]
     });
   });
-  resource.command("get").description(`Retrieve full details of a subscription by ID including phases, products, billing dates, and status. Optionally include live_billing data.`).requiredOption("--id <value>", `id parameter`).option("--include-live-billing <value>", `include_live_billing`).addHelpText("after", `
-Examples:
-    hyperline subscriptions get --id <id>
-    hyperline subscriptions get --id <id> --include-live-billing <include_live_billing>`).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.includeLiveBilling !== void 0)
-      args.include_live_billing = opts.includeLiveBilling;
-    await ctx.execute({
-      method: "GET",
-      path: "/v2/subscriptions/{id}",
-      args,
-      queryParamKeys: ["include_live_billing"]
-    });
-  });
-  resource.command("list-subscription-phases").description(`List all phases of a subscription. Phases define time-bound product configurations within a subscription.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
-Examples:
-    hyperline subscriptions list-subscription-phases --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: "/v2/subscriptions/{id}/phases",
-      args,
-      queryParamKeys: []
-    });
-  });
-  resource.command("get-subscription-phase").description(`Retrieve details of a specific phase within a subscription, including its products and billing configuration.`).requiredOption("--id <value>", `id parameter`).requiredOption("--phase-id <value>", `phaseId parameter`).addHelpText("after", `
-Examples:
-    hyperline subscriptions get-subscription-phase --id <id> --phase-id <phaseId>`).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.phaseId !== void 0)
-      args.phaseId = opts.phaseId;
-    await ctx.execute({
-      method: "GET",
-      path: "/v2/subscriptions/{id}/phases/{phaseId}",
-      args,
-      queryParamKeys: []
-    });
-  });
-  resource.command("refresh-subscription-seat-products").description(`Trigger a count update on seat-based products within a subscription using the configured dataloader query.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
+  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.`).option("--billing-cycle-transition-method <value>", `The billing cycle transition method to use. 'keep_current_billing_cycle' will keep the current billing cycle dates if possible. 'align_to_new_billing_cycle' will align the billing cycle to the transition date.`).requiredOption("--application-schedule <value>", `Whether the transition should be applied 'immediately' or 'scheduled' for a specific date. 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 <value>", `The configuration of the subscription to transition to`).addHelpText("after", `
 Examples:
-    hyperline subscriptions refresh-subscription-seat-products --id <id>
-    hyperline subscriptions refresh-subscription-seat-products --id <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;
-    await ctx.execute({
-      method: "POST",
-      path: "/v2/subscriptions/{id}/refresh-seat-products",
-      args,
-      queryParamKeys: []
-    });
-  });
-  resource.command("update").description(`Comprehensive subscription update: modify fields, manage phases (add/update/delete pending phases), update products within phases, and manage coupons. Payload mirrors GET response structure.`).requiredOption("--id <value>", `id parameter`).option("--name <value>", `Subscription custom name.`).option("--purchase-order <value>", `Reference to the purchase order.`).option("--minimum-invoice-fee <number>", `Minimum fee applied to each invoice outside of one time payments.`).option("--crm-opportunity-id <value>", `ID of the related opportunity/deal in the connected CRM.`).option("--tax-only <value>", `Only tax will be charged on this subscription.`).option("--generate-draft-invoices <value>", `Generate draft invoices for the subscription. Each invoice will need to be reviewed and validated manually before being sent`).option("--generate-document <value>", `Generate non-legal documents instead of invoices.`).option("--document-name <value>", `If \`generate_document\` is turned on, allows you to give a name to your document.`).option("--add-tax-to-document <value>", `If \`generate_document\` is turned on, will add taxes to document.`).option("--do-not-charge-subscription <value>", `Subscription will be invoiced but not charged (invoices/documents will be settled directly).`).option("--invoice-custom-note <value>", `Default custom note added to invoices generated by the subscription.`).option("--invoice-schedule <value>", `
-Defines when invoices are generated relative to the billing period.
-
-- \`period_start\`: Invoices are generated at the start of the billing period.
-- \`period_end\`: Invoices are generated at the end of the billing period.
-`).option("--estimated-arr <number>", `Estimated Annual Recurring Revenue generated by the subscription.`).option("--contract-value <number>", `Contract value of the subscription. This value is overridable by the user.`).option("--starts-at <value>", `Applies only if the activation strategy is \`start_date\`. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).option("--initial-billing-at <value>", `Date when the subscription will start being billed. If not specified, it will correspond to the \`starts_at\` date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).option("--cancel-at <value>", `Subscription cancel date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).option("--properties <value>", `Key/value pairs to store any metadata useful in your context.`).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("--display-shipping-details <value>", `Indicates if the shipping details should be displayed on the subscription's invoices.`).option("--phases <value>", `Array of subscription phases. Existing pending phases will be replaced by the ones in the array.`).option("--contract-terms <value>", `Contract terms to update.`).addHelpText("after", `
-Examples:
-    hyperline subscriptions update --id <id>
-    hyperline subscriptions update --id <id> --name <name> --purchase-order <purchase_order>
-    hyperline subscriptions update --id <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.name !== void 0)
-      args.name = opts.name;
-    if (opts.purchaseOrder !== void 0)
-      args.purchase_order = opts.purchaseOrder;
-    if (opts.crmOpportunityId !== void 0)
-      args.crm_opportunity_id = opts.crmOpportunityId;
-    if (opts.taxOnly !== void 0)
-      args.tax_only = opts.taxOnly;
-    if (opts.generateDraftInvoices !== void 0)
-      args.generate_draft_invoices = opts.generateDraftInvoices;
-    if (opts.generateDocument !== void 0)
-      args.generate_document = opts.generateDocument;
-    if (opts.documentName !== void 0)
-      args.document_name = opts.documentName;
-    if (opts.addTaxToDocument !== void 0)
-      args.add_tax_to_document = opts.addTaxToDocument;
-    if (opts.doNotChargeSubscription !== void 0)
-      args.do_not_charge_subscription = opts.doNotChargeSubscription;
-    if (opts.invoiceCustomNote !== void 0)
-      args.invoice_custom_note = opts.invoiceCustomNote;
-    if (opts.invoiceSchedule !== void 0)
-      args.invoice_schedule = opts.invoiceSchedule;
-    if (opts.startsAt !== void 0)
-      args.starts_at = opts.startsAt;
-    if (opts.initialBillingAt !== void 0)
-      args.initial_billing_at = opts.initialBillingAt;
-    if (opts.cancelAt !== void 0)
-      args.cancel_at = opts.cancelAt;
-    if (opts.properties !== void 0)
-      args.properties = opts.properties;
-    if (opts.customProperties !== void 0)
-      args.custom_properties = opts.customProperties;
-    if (opts.displayShippingDetails !== void 0)
-      args.display_shipping_details = opts.displayShippingDetails;
-    if (opts.phases !== void 0)
-      args.phases = opts.phases;
-    if (opts.contractTerms !== void 0)
-      args.contract_terms = opts.contractTerms;
-    if (opts.minimumInvoiceFee !== void 0)
-      args.minimum_invoice_fee = Number(opts.minimumInvoiceFee);
-    if (opts.estimatedArr !== void 0)
-      args.estimated_arr = Number(opts.estimatedArr);
-    if (opts.contractValue !== void 0)
-      args.contract_value = Number(opts.contractValue);
-    await ctx.execute({
-      method: "PUT",
-      path: "/v2/subscriptions/{id}",
-      args,
-      queryParamKeys: []
-    });
-  });
-  resource.command("transition").description(`Transition a subscription to its next configured phase at a specified date.`).requiredOption("--id <value>", `id parameter`).option("--transition-date <value>", `Date of application of the transition. Use it if different than immediately to calculate pro-rata and display past or future dates on invoices. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).addHelpText("after", `
-Examples:
-    hyperline subscriptions transition --id <id>
-    hyperline subscriptions transition --id <id> --transition-date <transition_date>
-    hyperline subscriptions transition --id <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.transitionDate !== void 0)
-      args.transition_date = opts.transitionDate;
-    await ctx.execute({
-      method: "POST",
-      path: "/v2/subscriptions/{id}/next-phase",
-      args,
-      queryParamKeys: []
-    });
-  });
-  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.`).option("--billing-cycle-transition-method <value>", `The billing cycle transition method to use. 'keep_current_billing_cycle' will keep the current billing cycle dates if possible. 'align_to_new_billing_cycle' will align the billing cycle to the transition date.`).requiredOption("--application-schedule <value>", `Whether the transition should be applied 'immediately' or 'scheduled' for a future date.`).option("--transition-date <value>", `The date at which the transition should occur. Only applicable if the application schedule is 'scheduled'. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.`).requiredOption("--target-subscription <value>", `The configuration of the subscription to transition to`).addHelpText("after", `
-Examples:
-    hyperline subscriptions create-subscription-transition --source-subscription-id <source_subscription_id> --application-schedule <application_schedule> --target-subscription <target_subscription>
-    hyperline subscriptions create-subscription-transition --source-subscription-id <source_subscription_id> --application-schedule <application_schedule> --target-subscription <target_subscription> --name <name> --calculation-method <calculation_method>
-    hyperline subscriptions create-subscription-transition --source-subscription-id <source_subscription_id> --application-schedule <application_schedule> --target-subscription <target_subscription> --output json`).action(async (opts) => {
+    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>
+    hyperline subscriptions-transitions create-subscription-transition --source-subscription-id <source_subscription_id> --application-schedule <application_schedule> --target-subscription <target_subscription> --output json`).action(async (opts) => {
     const ctx = resource.parent?.opts()._ctx;
     if (!ctx) {
       process.stderr.write("Error: Not authenticated\n");
@@ -31457,7 +31540,7 @@ Examples:
   });
   resource.command("get-subscription-transition").description(`Retrieve details of a subscription transition by ID including source/target subscriptions and schedule.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
 Examples:
-    hyperline subscriptions get-subscription-transition --id <id>`).action(async (opts) => {
+    hyperline subscriptions-transitions get-subscription-transition --id <id>`).action(async (opts) => {
     const ctx = resource.parent?.opts()._ctx;
     if (!ctx) {
       process.stderr.write("Error: Not authenticated\n");
@@ -31475,8 +31558,8 @@ Examples:
   });
   resource.command("cancel-subscription-transition").description(`Cancel a scheduled subscription transition before it is applied.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
 Examples:
-    hyperline subscriptions cancel-subscription-transition --id <id>
-    hyperline subscriptions cancel-subscription-transition --id <id> --output json`).action(async (opts) => {
+    hyperline subscriptions-transitions cancel-subscription-transition --id <id>
+    hyperline subscriptions-transitions cancel-subscription-transition --id <id> --output json`).action(async (opts) => {
     const ctx = resource.parent?.opts()._ctx;
     if (!ctx) {
       process.stderr.write("Error: Not authenticated\n");
@@ -31492,71 +31575,6 @@ Examples:
       queryParamKeys: []
     });
   });
-  resource.command("get-subscription-valuation").description(`Compute valuation metrics for a subscription: contract value (total/invoiced/remaining), recurring contract value, and ARR (fixed + variable). Optionally pass granularity (year/quarter/month) for period breakdown.`).requiredOption("--id <value>", `id parameter`).option("--granularity <value>", `Period granularity for the breakdown. When provided, contract value and recurring contract value include a \`by_period\` array.`).addHelpText("after", `
-Examples:
-    hyperline subscriptions get-subscription-valuation --id <id>
-    hyperline subscriptions get-subscription-valuation --id <id> --granularity <granularity>`).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.granularity !== void 0)
-      args.granularity = opts.granularity;
-    await ctx.execute({
-      method: "GET",
-      path: "/v1/subscriptions/{id}/valuation",
-      args,
-      queryParamKeys: ["granularity"]
-    });
-  });
-}
-
-// build/commands/generated/subscriptions-templates.js
-function registerSubscriptions_TemplatesCommands(parent) {
-  const resource = parent.command("subscriptions-templates").description("Manage subscriptions > templates");
-  resource.command("list-subscription-templates").description(`List subscription templates with pagination. Templates define reusable subscription configurations with pre-configured products, phases, and billing settings.`).option("--take <number>", `take`).option("--skip <number>", `skip`).addHelpText("after", `
-Examples:
-    hyperline subscriptions-templates list-subscription-templates
-    hyperline subscriptions-templates list-subscription-templates --take <take>`).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.take !== void 0)
-      args.take = Number(opts.take);
-    if (opts.skip !== void 0)
-      args.skip = Number(opts.skip);
-    await ctx.execute({
-      method: "GET",
-      path: "/v1/subscriptions/templates",
-      args,
-      queryParamKeys: ["take", "skip"]
-    });
-  });
-  resource.command("get-subscription-template").description(`Retrieve a subscription template by ID with its full configuration including products, phases, and pricing details.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
-Examples:
-    hyperline subscriptions-templates get-subscription-template --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/subscriptions/templates/{id}",
-      args,
-      queryParamKeys: []
-    });
-  });
 }
 
 // build/commands/generated/taxes.js
@@ -32111,6 +32129,8 @@ function registerAllCommands(program2) {
   registerQuotesCommands(program2);
   registerSubscriptionsCommands(program2);
   registerSubscriptions_TemplatesCommands(program2);
+  registerSubscriptions_TransitionsCommands(program2);
+  registerSubscriptions_PhasesCommands(program2);
   registerTaxesCommands(program2);
   registerWalletsCommands(program2);
   registerWebhooksCommands(program2);
@@ -51159,8 +51179,8 @@ var PathParamError = class extends Error {
   missingKeys;
   constructor(missingKeys) {
     super(`Missing required path parameter${missingKeys.length > 1 ? "s" : ""}: ${missingKeys.join(", ")}`);
-    this.missingKeys = missingKeys;
     this.name = "PathParamError";
+    this.missingKeys = missingKeys;
   }
 };
 function removeUsedKeys(args, usedKeys) {

package/package.json

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