deepline 0.3.90 → 0.3.91

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

@@ -749,6 +749,7 @@ export type PlaySecretMetadata = {
   scope: 'org' | 'play';
   playName?: string;
   name: string;
+  note?: string;
   status: string;
   hasValue: boolean;
   createdAt: number;
@@ -1085,7 +1086,13 @@ export type MonitorBatchOperationResult = {
   rejoined?: boolean;
   operation: {
     runId: string;
-    kind: 'audit' | 'deactivate' | 'reactivate' | 'deploy' | 'repair';
+    kind:
+      | 'audit'
+      | 'converge'
+      | 'deactivate'
+      | 'reactivate'
+      | 'deploy'
+      | 'repair';
     state: 'running' | 'retry_scheduled' | 'completed' | 'failed';
     dryRun: boolean;
     scope: unknown;
@@ -1205,7 +1212,13 @@ export type MonitorsHealth = {
   /** Bounded current durable monitor work, if the server supports it. */
   batch_operations?: Array<{
     run_id: string;
-    kind: 'audit' | 'deactivate' | 'reactivate' | 'repair' | 'deploy';
+    kind:
+      | 'audit'
+      | 'converge'
+      | 'deactivate'
+      | 'reactivate'
+      | 'repair'
+      | 'deploy';
     state: 'running' | 'retry_scheduled';
     updated_at: number;
     next_attempt_at?: number;
@@ -1457,6 +1470,7 @@ export type TargetBillingPlan = {
   interval: 'month' | 'year';
   included_credits: number;
   purchased_credit_price_usd: number;
+  acquisition_enabled: boolean;
 };
 
 export type TargetBillingPlansResult = {
@@ -1465,6 +1479,7 @@ export type TargetBillingPlansResult = {
   current_plan_sku: string;
   pending_plan_sku: string | null;
   acquisition_enabled: boolean;
+  enabled_offer_keys: TargetBillingPlan['sku'][];
 };
 
 export type TargetBillingStatusResult = {
@@ -1494,6 +1509,8 @@ export type TargetAutoRechargeResult = {
   threshold_credits: number | null;
   refill_to_credits: number | null;
   rolling_limit_cents: null;
+  purchase_limit_cents?: number | null;
+  rolling_committed_cents?: number;
 };
 
 export type TargetAutoRechargeUpdateOptions =
@@ -1505,6 +1522,8 @@ export type TargetAutoRechargeUpdateOptions =
       enabled: true;
       thresholdCredits: number;
       refillToCredits: number;
+      /** Maximum automatic purchases in a rolling 30-day window, in USD cents. */
+      purchaseLimitCents?: number | null;
       idempotencyKey: string;
     };
 
@@ -1632,10 +1651,8 @@ export type WorkspacesNamespace = {
 };
 
 /**
- * Public billing namespace exposed as `client.billing`.
- *
- * Carries plans, subscription state, cancellation, and invoice/receipt history
- * so CLI commands and programmatic callers share one surface.
+ * Public `client.billing` namespace for CLI commands and programmatic callers.
+ * Covers plans, subscription state, cancellation, and invoice/receipt history.
  *
  * @sdkReference client 030 client.billing
  */
@@ -1669,6 +1686,9 @@ export type BillingNamespace = {
   /** Read and manage the Metronome-backed automatic recharge configuration. */
   autoRecharge: {
     get: () => Promise<TargetAutoRechargeResult>;
+    trigger: (options?: {
+      idempotencyKey: string;
+    }) => Promise<{ data: { status: string; operation_id?: string } }>;
     update: (
       options: TargetAutoRechargeUpdateOptions,
     ) => Promise<TargetAutoRechargeResult>;
@@ -1678,6 +1698,12 @@ export type BillingNamespace = {
     credits: number;
     idempotencyKey: string;
   }) => Promise<TargetBillingMutationResult>;
+  /** Inspect or retire the original purchase intent without starting a payment. */
+  recoverCreditPurchase: (options: {
+    credits: number;
+    orgId: string;
+    idempotencyKey: string;
+  }) => Promise<TargetBillingMutationResult>;
   /** Start, change, cancel, or undo a target plan transition. */
   transitionPlan: (
     options: TargetBillingPlanTransitionOptions,
@@ -2267,9 +2293,21 @@ export class DeeplineClient {
       targetStatus: () => this.getTargetBillingStatus(),
       autoRecharge: {
         get: () => this.getTargetAutoRecharge(),
+        trigger: (options) =>
+          this.http.post(
+            '/api/v2/billing/auto-recharge/trigger',
+            {},
+            {
+              'Idempotency-Key': requireTargetBillingIdempotencyKey(
+                options?.idempotencyKey ?? globalThis.crypto.randomUUID(),
+              ),
+            },
+          ),
         update: (options) => this.updateTargetAutoRecharge(options),
       },
       purchaseCredits: (options) => this.purchaseTargetBillingCredits(options),
+      recoverCreditPurchase: (options) =>
+        this.recoverTargetBillingCreditPurchase(options),
       transitionPlan: (options) => this.transitionTargetBillingPlan(options),
       portalSession: () => this.createTargetBillingPortalSession(),
     };
@@ -2525,6 +2563,18 @@ export class DeeplineClient {
     return this.http.get(`/api/v2/secrets?${params.toString()}`);
   }
 
+  /** Add, replace, or clear the non-sensitive note attached to one secret. */
+  async updateSecretNote(
+    secretId: string,
+    note: string,
+  ): Promise<PlaySecretMetadata> {
+    const response = await this.http.patch<{ secret: PlaySecretMetadata }>(
+      `/api/v2/secrets/${encodeURIComponent(secretId)}`,
+      { note },
+    );
+    return response.secret;
+  }
+
   // ——————————————————————————————————————————————————————————
   // Tools
   // ——————————————————————————————————————————————————————————
@@ -5421,6 +5471,9 @@ export class DeeplineClient {
             enabled: true,
             threshold_credits: options.thresholdCredits,
             refill_to_credits: options.refillToCredits,
+            ...(options.purchaseLimitCents !== undefined
+              ? { purchase_limit_cents: options.purchaseLimitCents }
+              : {}),
           }
         : { enabled: false },
       { 'Idempotency-Key': idempotencyKey },
@@ -5447,6 +5500,48 @@ export class DeeplineClient {
     );
   }
 
+  /** Recover only the original workspace, credit amount, and purchase key; never charge. */
+  async recoverTargetBillingCreditPurchase(options: {
+    credits: number;
+    orgId: string;
+    idempotencyKey: string;
+  }): Promise<TargetBillingMutationResult> {
+    if (typeof options.idempotencyKey !== 'string') {
+      throw new DeeplineError(
+        'The original billing idempotencyKey is required.',
+        undefined,
+        'INVALID_BILLING_IDEMPOTENCY_KEY',
+      );
+    }
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey,
+    );
+    if (!Number.isSafeInteger(options.credits) || options.credits <= 0) {
+      throw new DeeplineError(
+        'credits must be a positive safe integer.',
+        undefined,
+        'INVALID_CREDITS',
+      );
+    }
+    if (
+      typeof options.orgId !== 'string' ||
+      !options.orgId.trim() ||
+      options.orgId !== options.orgId.trim()
+    ) {
+      throw new DeeplineError(
+        'The original orgId is required without surrounding whitespace.',
+        undefined,
+        'INVALID_ORG_ID',
+      );
+    }
+    return this.http.post<TargetBillingMutationResult>(
+      '/api/v2/billing/credit-purchases/recover',
+      { credits: options.credits, org_id: options.orgId },
+      { 'Idempotency-Key': idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true },
+    );
+  }
+
   /**
    * Start, change, cancel, or restore a target plan through one idempotent
    * commercial operation.