deepline 0.1.194 → 0.1.196

package/dist/index.d.ts

@@ -1396,6 +1396,27 @@ type BillingInvoicesResult = {
     org_id: string;
     entries: BillingInvoiceEntry[];
 };
+/** Saved payment method details returned by one-click billing top-up. */
+type BillingPaymentMethodSummary = {
+    brand?: string | null;
+    last4?: string | null;
+    exp_month?: number | null;
+    exp_year?: number | null;
+    label?: string | null;
+};
+/**
+ * Result of `POST /api/v2/billing/top-up`: a saved-card charge and purchased
+ * Deepline credit grant for the active workspace.
+ */
+type BillingTopUpResult = {
+    ok: true;
+    credits: number;
+    amount_cents: number;
+    currency: string;
+    balance: number;
+    stripe_payment_intent_id: string;
+    payment_method?: BillingPaymentMethodSummary | null;
+};
 /** One published plan from `GET /api/v2/billing/catalog/current`. */
 type BillingPlanEntry = {
     plan_family_id: string;
@@ -1453,6 +1474,11 @@ type BillingPlansResult = {
  * @sdkReference client 030 client.billing
  */
 type BillingNamespace = {
+    /** Charge the saved payment method and add Deepline credits to the active workspace. */
+    topUp: (options: {
+        credits: number;
+        idempotencyKey?: string;
+    }) => Promise<BillingTopUpResult>;
     /** Published plans plus the plan you are on ("what plans exist and what am I on"). */
     plans: () => Promise<BillingPlansResult>;
     subscription: {
@@ -2329,6 +2355,18 @@ declare class DeeplineClient {
      * @returns Snake_case catalog from `GET /api/v2/billing/catalog/current`
      */
     getBillingPlans(): Promise<BillingPlansResult>;
+    /**
+     * Charge the saved payment method and add Deepline credits to the active
+     * workspace. Prefer `client.billing.topUp(...)`.
+     *
+     * @throws {@link DeeplineError} with `statusCode: 409` when checkout is
+     *   required because the workspace has no saved payment method or the card
+     *   requires confirmation.
+     */
+    topUpBillingBalance(options: {
+        credits: number;
+        idempotencyKey?: string;
+    }): Promise<BillingTopUpResult>;
     /**
      * Subscription state for the active workspace: active plan, whether a
      * Stripe subscription backs it, renewal/cancellation facts, and remaining
@@ -4251,4 +4289,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, PHONE_STATUS_VALUES, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PhoneStatus, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolExecutionRequest, type ToolMetadata, type ToolSearchOptions, type ToolSearchResult, defineInput, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, PHONE_STATUS_VALUES, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PhoneStatus, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolExecutionRequest, type ToolMetadata, type ToolSearchOptions, type ToolSearchResult, defineInput, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.js

@@ -422,10 +422,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.194",
+  version: "0.1.196",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.194",
+    latest: "0.1.196",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -2353,6 +2353,7 @@ var DeeplineClient = class {
       stopAll: (options2) => this.stopAllRuns(options2)
     };
     this.billing = {
+      topUp: (options2) => this.topUpBillingBalance(options2),
       plans: () => this.getBillingPlans(),
       subscription: {
         status: () => this.getBillingSubscriptionStatus(),
@@ -4034,6 +4035,28 @@ var DeeplineClient = class {
   async getBillingPlans() {
     return this.http.get("/api/v2/billing/catalog/current");
   }
+  /**
+   * Charge the saved payment method and add Deepline credits to the active
+   * workspace. Prefer `client.billing.topUp(...)`.
+   *
+   * @throws {@link DeeplineError} with `statusCode: 409` when checkout is
+   *   required because the workspace has no saved payment method or the card
+   *   requires confirmation.
+   */
+  async topUpBillingBalance(options) {
+    return this.http.post(
+      "/api/v2/billing/top-up",
+      {
+        credits: options.credits,
+        ...options.idempotencyKey ? { idempotency_key: options.idempotencyKey } : {}
+      },
+      void 0,
+      // The idempotency key makes a retry at the product layer safe, but the
+      // CLI should not hide ambiguous local delivery failures behind implicit
+      // transport retries for a payment mutation.
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
   /**
    * Subscription state for the active workspace: active plan, whether a
    * Stripe subscription backs it, renewal/cancellation facts, and remaining

package/dist/index.mjs

@@ -352,10 +352,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.194",
+  version: "0.1.196",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.194",
+    latest: "0.1.196",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -2283,6 +2283,7 @@ var DeeplineClient = class {
       stopAll: (options2) => this.stopAllRuns(options2)
     };
     this.billing = {
+      topUp: (options2) => this.topUpBillingBalance(options2),
       plans: () => this.getBillingPlans(),
       subscription: {
         status: () => this.getBillingSubscriptionStatus(),
@@ -3964,6 +3965,28 @@ var DeeplineClient = class {
   async getBillingPlans() {
     return this.http.get("/api/v2/billing/catalog/current");
   }
+  /**
+   * Charge the saved payment method and add Deepline credits to the active
+   * workspace. Prefer `client.billing.topUp(...)`.
+   *
+   * @throws {@link DeeplineError} with `statusCode: 409` when checkout is
+   *   required because the workspace has no saved payment method or the card
+   *   requires confirmation.
+   */
+  async topUpBillingBalance(options) {
+    return this.http.post(
+      "/api/v2/billing/top-up",
+      {
+        credits: options.credits,
+        ...options.idempotencyKey ? { idempotency_key: options.idempotencyKey } : {}
+      },
+      void 0,
+      // The idempotency key makes a retry at the product layer safe, but the
+      // CLI should not hide ambiguous local delivery failures behind implicit
+      // transport retries for a payment mutation.
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
   /**
    * Subscription state for the active workspace: active plan, whether a
    * Stripe subscription backs it, renewal/cancellation facts, and remaining

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.194",
+  "version": "0.1.196",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {