deepline 0.2.9 → 0.2.11

package/dist/cli/index.mjs

@@ -1025,7 +1025,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.9",
+  version: "0.2.11",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -2162,6 +2162,13 @@ function projectPlayRunActivity(input2) {
     (dataset) => dataset.phase === "registered" || dataset.complete !== true && dataset.phase !== "failed"
   ).sort((left, right) => (right.updatedAt ?? 0) - (left.updatedAt ?? 0))[0];
   if (pendingDataset) {
+    const activeDatasetStep = input2.nodeStates?.find(
+      (candidate) => candidate.nodeId === input2.activeNodeId && candidate.status === "running" && candidate.artifactTableNamespace === pendingDataset.tableNamespace
+    );
+    const datasetStep = activeDatasetStep ?? input2.nodeStates?.find(
+      (candidate) => candidate.artifactTableNamespace === pendingDataset.tableNamespace
+    );
+    const datasetProgress = datasetStep?.progress ?? null;
     return projection(
       {
         schemaVersion: 1,
@@ -2174,12 +2181,12 @@ function projectPlayRunActivity(input2) {
         state: {
           kind: "active",
           progress: {
-            completed: pendingDataset.persistedRows,
-            total: typeof pendingDataset.succeededRows === "number" || typeof pendingDataset.failedRows === "number" ? (pendingDataset.succeededRows ?? 0) + (pendingDataset.failedRows ?? 0) : void 0,
-            failed: pendingDataset.failedRows
+            completed: datasetProgress?.completed ?? pendingDataset.persistedRows,
+            total: datasetProgress?.total ?? (typeof pendingDataset.succeededRows === "number" || typeof pendingDataset.failedRows === "number" ? (pendingDataset.succeededRows ?? 0) + (pendingDataset.failedRows ?? 0) : void 0),
+            failed: datasetProgress?.failed ?? pendingDataset.failedRows
           }
         },
-        observedAt: pendingDataset.updatedAt ?? observedAt
+        observedAt: datasetStep?.updatedAt ?? pendingDataset.updatedAt ?? observedAt
       },
       now
     );
@@ -3484,6 +3491,17 @@ function resolveToolExecuteTimeoutMs(toolId, input2) {
 }
 var RUNS_FAILED_LOG_LIMIT = 20;
 var RUN_LOGS_PAGE_LIMIT = 1e3;
+function requireTargetBillingIdempotencyKey(value) {
+  const normalized = value.trim();
+  if (normalized.length === 0 || normalized.length > 200 || normalized !== value) {
+    throw new DeeplineError(
+      "Billing idempotencyKey must contain 1\u2013200 characters with no leading or trailing whitespace.",
+      void 0,
+      "INVALID_BILLING_IDEMPOTENCY_KEY"
+    );
+  }
+  return normalized;
+}
 function isRecord6(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -3754,7 +3772,12 @@ var DeeplineClient = class {
       },
       invoices: {
         list: (options2) => this.listBillingInvoices(options2)
-      }
+      },
+      targetPlans: () => this.getTargetBillingPlans(),
+      targetStatus: () => this.getTargetBillingStatus(),
+      purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
+      transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
+      portalSession: () => this.createTargetBillingPortalSession()
     };
     this.monitors = {
       status: () => this.getMonitorsAccess(),
@@ -5668,6 +5691,52 @@ var DeeplineClient = class {
       `/api/v2/billing/invoices${suffix}`
     );
   }
+  /** List the reviewed target plans and whether new acquisition is enabled. */
+  async getTargetBillingPlans() {
+    return this.http.get("/api/v2/billing/plans");
+  }
+  /** Read the workspace's normalized target plan, payment, and balance state. */
+  async getTargetBillingStatus() {
+    return this.http.get("/api/v2/billing/status");
+  }
+  /**
+   * Purchase target-billing credits through the durable commercial operation
+   * flow. The caller supplies an idempotency key for safe retries.
+   */
+  async purchaseTargetBillingCredits(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/credit-purchases",
+      { credits: options.credits },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /**
+   * Start, change, cancel, or restore a target plan through one idempotent
+   * commercial operation.
+   */
+  async transitionTargetBillingPlan(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/plan-transitions",
+      {
+        action: options.action,
+        ...options.targetPlanSku ? { target_plan_sku: options.targetPlanSku } : {}
+      },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /** Create a Stripe-hosted portal session for payment recovery and invoices. */
+  async createTargetBillingPortalSession() {
+    const response = await this.http.post("/api/v2/billing/portal-sessions", {});
+    return response.data;
+  }
   // ——————————————————————————————————————————————————————————
   // Monitors
   // ——————————————————————————————————————————————————————————
@@ -7490,6 +7559,9 @@ function topUpIdempotencyKey(raw) {
   }
   return `cli_topup:${Date.now()}:${randomUUID()}`;
 }
+function targetBillingIdempotencyKey(raw) {
+  return typeof raw === "string" ? raw : `cli_target_billing:${Date.now()}:${randomUUID()}`;
+}
 function checkoutCommandForCredits(credits) {
   return `deepline billing checkout --credits ${credits} --no-open --json`;
 }
@@ -8295,6 +8367,92 @@ async function handleTopUp(creditsRaw, options) {
     json: options.json
   });
 }
+async function handleTargetStatus(options) {
+  const client2 = new DeeplineClient();
+  const payload = await client2.billing.targetStatus();
+  printCommandEnvelope(
+    {
+      ok: true,
+      ...payload,
+      render: {
+        sections: [
+          {
+            title: "billing status",
+            lines: [
+              `Plan: ${payload.plan.name} (${payload.plan.sku})`,
+              `State: ${payload.state}`,
+              `Payment: ${payload.payment_state}`,
+              `Automatic recharge: ${payload.recharge_state}`
+            ]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+async function handleBuyCredits(creditsRaw, options) {
+  const credits = parseTopUpCredits(creditsRaw);
+  if (credits === null) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_CREDITS",
+        message: "<credits> must be a positive integer."
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new DeeplineClient().billing.purchaseCredits({
+    credits,
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPlan(planSku, options) {
+  if (planSku !== "payg-v1" && planSku !== "builder-v1" && planSku !== "team-v1") {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_PLAN",
+        message: "Plan must be payg-v1, builder-v1, or team-v1."
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new DeeplineClient().billing.transitionPlan({
+    action: "start_or_change",
+    targetPlanSku: planSku,
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPlanCancellation(options) {
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new DeeplineClient().billing.transitionPlan({
+    action: options.undo ? "undo_cancel" : "cancel",
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPortal(options) {
+  const payload = await new DeeplineClient().billing.portalSession();
+  if (!options.json && !options.noOpen) openInBrowser(payload.url);
+  printCommandEnvelope({ ok: true, ...payload }, { json: options.json });
+}
 async function handleRedeemCode(code, options) {
   const { http } = getAuthedHttpClient();
   const payload = await http.post(
@@ -8490,6 +8648,11 @@ Examples:
     "--idempotency-key <key>",
     "Stable retry key for the same intended top-up"
   ).option("--dry-run", "Print the planned top-up without charging").option("--compact", "Keep only high-signal fields in JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleTopUp);
+  billing.command("buy").description("Buy credits through the target billing contract.").argument("<credits>", "Positive integer Deepline credit amount").option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleBuyCredits);
+  billing.command("status").description("Show normalized target billing state.").option("--json", "Emit JSON output").action(handleTargetStatus);
+  billing.command("change-plan").description("Start or change the target billing plan.").argument("<plan_sku>", "payg-v1, builder-v1, or team-v1").option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleTargetPlan);
+  billing.command("cancel-plan").description("Cancel a target subscription at period end, or undo it.").option("--undo", "Undo a pending period-end cancellation").option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleTargetPlanCancellation);
+  billing.command("portal").description("Open the Stripe-hosted billing recovery portal.").option("--no-open", "Print the URL without opening a browser").option("--json", "Emit JSON output").action(handleTargetPortal);
   billing.command("plans").description("Show published plans and the plan you are on.").addHelpText(
     "after",
     `

package/dist/index.d.mts

@@ -2135,6 +2135,58 @@ type BillingInvoicesResult = {
     org_id: string;
     entries: BillingInvoiceEntry[];
 };
+type TargetBillingOperation = {
+    id: string;
+    state: string;
+    version: number;
+    next_action?: string | null;
+};
+type TargetBillingPlan = {
+    sku: 'payg-v1' | 'builder-v1' | 'team-v1';
+    name: string;
+    recurring_price_usd: number;
+    interval: 'month';
+    included_credits: number;
+    purchased_credit_price_usd: number;
+};
+type TargetBillingPlansResult = {
+    org_id: string;
+    plans: TargetBillingPlan[];
+    current_plan_sku: string;
+    pending_plan_sku: string | null;
+    acquisition_enabled: boolean;
+};
+type TargetBillingStatusResult = {
+    org_id: string;
+    plan: {
+        sku: string;
+        name: string;
+        recurring_price_usd: number | null;
+        interval: string | null;
+        included_credits: number | null;
+    };
+    state: string;
+    changes_allowed: boolean;
+    payment_state: string;
+    recharge_state: string;
+    next_action: string | null;
+    pending_plan_sku: string | null;
+    as_of: string | null;
+};
+type TargetBillingMutationResult = {
+    data: Record<string, unknown>;
+    operation: TargetBillingOperation;
+    request_id?: string;
+};
+type TargetBillingPlanTransitionOptions = {
+    action: 'start_or_change';
+    targetPlanSku: 'payg-v1' | 'builder-v1' | 'team-v1';
+    idempotencyKey: string;
+} | {
+    action: 'cancel' | 'undo_cancel';
+    targetPlanSku?: never;
+    idempotencyKey: string;
+};
 /** Saved payment method details returned by one-click billing top-up. */
 type BillingPaymentMethodSummary = {
     brand?: string | null;
@@ -2206,9 +2258,8 @@ type BillingPlansResult = {
 /**
  * Public billing namespace exposed as `client.billing`.
  *
- * Carries the durable Deepline billing product model — plans, subscription
- * state, period-end cancellation, and invoice/receipt history — so CLI
- * commands and programmatic callers share the same surface.
+ * Carries plans, subscription state, cancellation, and invoice/receipt history
+ * so CLI commands and programmatic callers share one surface.
  *
  * @sdkReference client 030 client.billing
  */
@@ -2237,6 +2288,21 @@ type BillingNamespace = {
             limit?: number;
         }) => Promise<BillingInvoicesResult>;
     };
+    /** Metronome-authored target catalog and current Contract projection. */
+    targetPlans: () => Promise<TargetBillingPlansResult>;
+    /** Normalized target billing state. */
+    targetStatus: () => Promise<TargetBillingStatusResult>;
+    /** Buy Deepline credits through a payment-gated Metronome commit. */
+    purchaseCredits: (options: {
+        credits: number;
+        idempotencyKey: string;
+    }) => Promise<TargetBillingMutationResult>;
+    /** Start, change, cancel, or undo a target plan transition. */
+    transitionPlan: (options: TargetBillingPlanTransitionOptions) => Promise<TargetBillingMutationResult>;
+    /** Create a Stripe-hosted billing Portal session. */
+    portalSession: () => Promise<{
+        url: string;
+    }>;
 };
 /**
  * A staged-file upload target minted by POST /api/v2/plays/files/stage/mint.
@@ -3152,6 +3218,27 @@ declare class DeeplineClient {
     listBillingInvoices(options?: {
         limit?: number;
     }): Promise<BillingInvoicesResult>;
+    /** List the reviewed target plans and whether new acquisition is enabled. */
+    getTargetBillingPlans(): Promise<TargetBillingPlansResult>;
+    /** Read the workspace's normalized target plan, payment, and balance state. */
+    getTargetBillingStatus(): Promise<TargetBillingStatusResult>;
+    /**
+     * Purchase target-billing credits through the durable commercial operation
+     * flow. The caller supplies an idempotency key for safe retries.
+     */
+    purchaseTargetBillingCredits(options: {
+        credits: number;
+        idempotencyKey: string;
+    }): Promise<TargetBillingMutationResult>;
+    /**
+     * Start, change, cancel, or restore a target plan through one idempotent
+     * commercial operation.
+     */
+    transitionTargetBillingPlan(options: TargetBillingPlanTransitionOptions): Promise<TargetBillingMutationResult>;
+    /** Create a Stripe-hosted portal session for payment recovery and invoices. */
+    createTargetBillingPortalSession(): Promise<{
+        url: string;
+    }>;
     /**
      * Whether the current workspace can use Deepline Monitors. Reachable without
      * monitor access; a denial is a normal 200 body, not a 403. Prefer

package/dist/index.d.ts

@@ -2135,6 +2135,58 @@ type BillingInvoicesResult = {
     org_id: string;
     entries: BillingInvoiceEntry[];
 };
+type TargetBillingOperation = {
+    id: string;
+    state: string;
+    version: number;
+    next_action?: string | null;
+};
+type TargetBillingPlan = {
+    sku: 'payg-v1' | 'builder-v1' | 'team-v1';
+    name: string;
+    recurring_price_usd: number;
+    interval: 'month';
+    included_credits: number;
+    purchased_credit_price_usd: number;
+};
+type TargetBillingPlansResult = {
+    org_id: string;
+    plans: TargetBillingPlan[];
+    current_plan_sku: string;
+    pending_plan_sku: string | null;
+    acquisition_enabled: boolean;
+};
+type TargetBillingStatusResult = {
+    org_id: string;
+    plan: {
+        sku: string;
+        name: string;
+        recurring_price_usd: number | null;
+        interval: string | null;
+        included_credits: number | null;
+    };
+    state: string;
+    changes_allowed: boolean;
+    payment_state: string;
+    recharge_state: string;
+    next_action: string | null;
+    pending_plan_sku: string | null;
+    as_of: string | null;
+};
+type TargetBillingMutationResult = {
+    data: Record<string, unknown>;
+    operation: TargetBillingOperation;
+    request_id?: string;
+};
+type TargetBillingPlanTransitionOptions = {
+    action: 'start_or_change';
+    targetPlanSku: 'payg-v1' | 'builder-v1' | 'team-v1';
+    idempotencyKey: string;
+} | {
+    action: 'cancel' | 'undo_cancel';
+    targetPlanSku?: never;
+    idempotencyKey: string;
+};
 /** Saved payment method details returned by one-click billing top-up. */
 type BillingPaymentMethodSummary = {
     brand?: string | null;
@@ -2206,9 +2258,8 @@ type BillingPlansResult = {
 /**
  * Public billing namespace exposed as `client.billing`.
  *
- * Carries the durable Deepline billing product model — plans, subscription
- * state, period-end cancellation, and invoice/receipt history — so CLI
- * commands and programmatic callers share the same surface.
+ * Carries plans, subscription state, cancellation, and invoice/receipt history
+ * so CLI commands and programmatic callers share one surface.
  *
  * @sdkReference client 030 client.billing
  */
@@ -2237,6 +2288,21 @@ type BillingNamespace = {
             limit?: number;
         }) => Promise<BillingInvoicesResult>;
     };
+    /** Metronome-authored target catalog and current Contract projection. */
+    targetPlans: () => Promise<TargetBillingPlansResult>;
+    /** Normalized target billing state. */
+    targetStatus: () => Promise<TargetBillingStatusResult>;
+    /** Buy Deepline credits through a payment-gated Metronome commit. */
+    purchaseCredits: (options: {
+        credits: number;
+        idempotencyKey: string;
+    }) => Promise<TargetBillingMutationResult>;
+    /** Start, change, cancel, or undo a target plan transition. */
+    transitionPlan: (options: TargetBillingPlanTransitionOptions) => Promise<TargetBillingMutationResult>;
+    /** Create a Stripe-hosted billing Portal session. */
+    portalSession: () => Promise<{
+        url: string;
+    }>;
 };
 /**
  * A staged-file upload target minted by POST /api/v2/plays/files/stage/mint.
@@ -3152,6 +3218,27 @@ declare class DeeplineClient {
     listBillingInvoices(options?: {
         limit?: number;
     }): Promise<BillingInvoicesResult>;
+    /** List the reviewed target plans and whether new acquisition is enabled. */
+    getTargetBillingPlans(): Promise<TargetBillingPlansResult>;
+    /** Read the workspace's normalized target plan, payment, and balance state. */
+    getTargetBillingStatus(): Promise<TargetBillingStatusResult>;
+    /**
+     * Purchase target-billing credits through the durable commercial operation
+     * flow. The caller supplies an idempotency key for safe retries.
+     */
+    purchaseTargetBillingCredits(options: {
+        credits: number;
+        idempotencyKey: string;
+    }): Promise<TargetBillingMutationResult>;
+    /**
+     * Start, change, cancel, or restore a target plan through one idempotent
+     * commercial operation.
+     */
+    transitionTargetBillingPlan(options: TargetBillingPlanTransitionOptions): Promise<TargetBillingMutationResult>;
+    /** Create a Stripe-hosted portal session for payment recovery and invoices. */
+    createTargetBillingPortalSession(): Promise<{
+        url: string;
+    }>;
     /**
      * Whether the current workspace can use Deepline Monitors. Reachable without
      * monitor access; a denial is a normal 200 body, not a 403. Prefer

package/dist/index.js

@@ -763,7 +763,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.9",
+  version: "0.2.11",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -1900,6 +1900,13 @@ function projectPlayRunActivity(input) {
     (dataset) => dataset.phase === "registered" || dataset.complete !== true && dataset.phase !== "failed"
   ).sort((left, right) => (right.updatedAt ?? 0) - (left.updatedAt ?? 0))[0];
   if (pendingDataset) {
+    const activeDatasetStep = input.nodeStates?.find(
+      (candidate) => candidate.nodeId === input.activeNodeId && candidate.status === "running" && candidate.artifactTableNamespace === pendingDataset.tableNamespace
+    );
+    const datasetStep = activeDatasetStep ?? input.nodeStates?.find(
+      (candidate) => candidate.artifactTableNamespace === pendingDataset.tableNamespace
+    );
+    const datasetProgress = datasetStep?.progress ?? null;
     return projection(
       {
         schemaVersion: 1,
@@ -1912,12 +1919,12 @@ function projectPlayRunActivity(input) {
         state: {
           kind: "active",
           progress: {
-            completed: pendingDataset.persistedRows,
-            total: typeof pendingDataset.succeededRows === "number" || typeof pendingDataset.failedRows === "number" ? (pendingDataset.succeededRows ?? 0) + (pendingDataset.failedRows ?? 0) : void 0,
-            failed: pendingDataset.failedRows
+            completed: datasetProgress?.completed ?? pendingDataset.persistedRows,
+            total: datasetProgress?.total ?? (typeof pendingDataset.succeededRows === "number" || typeof pendingDataset.failedRows === "number" ? (pendingDataset.succeededRows ?? 0) + (pendingDataset.failedRows ?? 0) : void 0),
+            failed: datasetProgress?.failed ?? pendingDataset.failedRows
           }
         },
-        observedAt: pendingDataset.updatedAt ?? observedAt
+        observedAt: datasetStep?.updatedAt ?? pendingDataset.updatedAt ?? observedAt
       },
       now
     );
@@ -3222,6 +3229,17 @@ function resolveToolExecuteTimeoutMs(toolId, input) {
 }
 var RUNS_FAILED_LOG_LIMIT = 20;
 var RUN_LOGS_PAGE_LIMIT = 1e3;
+function requireTargetBillingIdempotencyKey(value) {
+  const normalized = value.trim();
+  if (normalized.length === 0 || normalized.length > 200 || normalized !== value) {
+    throw new DeeplineError(
+      "Billing idempotencyKey must contain 1\u2013200 characters with no leading or trailing whitespace.",
+      void 0,
+      "INVALID_BILLING_IDEMPOTENCY_KEY"
+    );
+  }
+  return normalized;
+}
 function isRecord6(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -3492,7 +3510,12 @@ var DeeplineClient = class {
       },
       invoices: {
         list: (options2) => this.listBillingInvoices(options2)
-      }
+      },
+      targetPlans: () => this.getTargetBillingPlans(),
+      targetStatus: () => this.getTargetBillingStatus(),
+      purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
+      transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
+      portalSession: () => this.createTargetBillingPortalSession()
     };
     this.monitors = {
       status: () => this.getMonitorsAccess(),
@@ -5406,6 +5429,52 @@ var DeeplineClient = class {
       `/api/v2/billing/invoices${suffix}`
     );
   }
+  /** List the reviewed target plans and whether new acquisition is enabled. */
+  async getTargetBillingPlans() {
+    return this.http.get("/api/v2/billing/plans");
+  }
+  /** Read the workspace's normalized target plan, payment, and balance state. */
+  async getTargetBillingStatus() {
+    return this.http.get("/api/v2/billing/status");
+  }
+  /**
+   * Purchase target-billing credits through the durable commercial operation
+   * flow. The caller supplies an idempotency key for safe retries.
+   */
+  async purchaseTargetBillingCredits(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/credit-purchases",
+      { credits: options.credits },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /**
+   * Start, change, cancel, or restore a target plan through one idempotent
+   * commercial operation.
+   */
+  async transitionTargetBillingPlan(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/plan-transitions",
+      {
+        action: options.action,
+        ...options.targetPlanSku ? { target_plan_sku: options.targetPlanSku } : {}
+      },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /** Create a Stripe-hosted portal session for payment recovery and invoices. */
+  async createTargetBillingPortalSession() {
+    const response = await this.http.post("/api/v2/billing/portal-sessions", {});
+    return response.data;
+  }
   // ——————————————————————————————————————————————————————————
   // Monitors
   // ——————————————————————————————————————————————————————————