deepline 0.2.12 → 0.2.14

package/dist/bundling-sources/sdk/src/client.ts

@@ -902,6 +902,66 @@ export type BillingInvoicesResult = {
   entries: BillingInvoiceEntry[];
 };
 
+export type TargetBillingOperation = {
+  id: string;
+  state: string;
+  version: number;
+  next_action?: string | null;
+};
+
+export 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;
+};
+
+export type TargetBillingPlansResult = {
+  org_id: string;
+  plans: TargetBillingPlan[];
+  current_plan_sku: string;
+  pending_plan_sku: string | null;
+  acquisition_enabled: boolean;
+};
+
+export 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;
+};
+
+export type TargetBillingMutationResult = {
+  data: Record<string, unknown>;
+  operation: TargetBillingOperation;
+  request_id?: string;
+};
+
+export 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. */
 export type BillingPaymentMethodSummary = {
   brand?: string | null;
@@ -977,9 +1037,8 @@ export 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
  */
@@ -1006,8 +1065,39 @@ export type BillingNamespace = {
     /** Subscription invoices plus credit purchase receipts, newest first. */
     list: (options?: { 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 }>;
 };
 
+function requireTargetBillingIdempotencyKey(value: string): string {
+  const normalized = value.trim();
+  if (
+    normalized.length === 0 ||
+    normalized.length > 200 ||
+    normalized !== value
+  ) {
+    throw new DeeplineError(
+      'Billing idempotencyKey must contain 1–200 characters with no leading or trailing whitespace.',
+      undefined,
+      'INVALID_BILLING_IDEMPOTENCY_KEY',
+    );
+  }
+  return normalized;
+}
+
 function isRecord(value: unknown): value is Record<string, unknown> {
   return Boolean(value && typeof value === 'object' && !Array.isArray(value));
 }
@@ -1495,6 +1585,11 @@ export class DeeplineClient {
       invoices: {
         list: (options) => this.listBillingInvoices(options),
       },
+      targetPlans: () => this.getTargetBillingPlans(),
+      targetStatus: () => this.getTargetBillingStatus(),
+      purchaseCredits: (options) => this.purchaseTargetBillingCredits(options),
+      transitionPlan: (options) => this.transitionTargetBillingPlan(options),
+      portalSession: () => this.createTargetBillingPortalSession(),
     };
     this.monitors = {
       status: () => this.getMonitorsAccess(),
@@ -4016,6 +4111,67 @@ export class DeeplineClient {
     );
   }
 
+  /** List the reviewed target plans and whether new acquisition is enabled. */
+  async getTargetBillingPlans(): Promise<TargetBillingPlansResult> {
+    return this.http.get<TargetBillingPlansResult>('/api/v2/billing/plans');
+  }
+
+  /** Read the workspace's normalized target plan, payment, and balance state. */
+  async getTargetBillingStatus(): Promise<TargetBillingStatusResult> {
+    return this.http.get<TargetBillingStatusResult>('/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: {
+    credits: number;
+    idempotencyKey: string;
+  }): Promise<TargetBillingMutationResult> {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey,
+    );
+    return this.http.post<TargetBillingMutationResult>(
+      '/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: TargetBillingPlanTransitionOptions,
+  ): Promise<TargetBillingMutationResult> {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey,
+    );
+    return this.http.post<TargetBillingMutationResult>(
+      '/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(): Promise<{ url: string }> {
+    const response = await this.http.post<{
+      data: { url: string };
+      request_id?: string;
+    }>('/api/v2/billing/portal-sessions', {});
+    return response.data;
+  }
+
   // ——————————————————————————————————————————————————————————
   // Monitors
   // ——————————————————————————————————————————————————————————

package/dist/bundling-sources/sdk/src/index.ts

@@ -230,6 +230,9 @@ export type {
   PlayDatasetInput,
   PlayCallExecution,
   PlayCallOptions,
+  PlayFetchResponse,
+  RuntimeStepOptions,
+  FetchOptions,
   PlayStepProgramStep,
   PrebuiltPlayRef,
   StepOptions,