dodopayments 2.26.0 → 2.28.0

package/resources/webhook-events.d.ts

@@ -10,13 +10,13 @@ export declare class WebhookEvents extends APIResource {
 /**
  * Event types for Dodo events
  */
-export type WebhookEventType = 'payment.succeeded' | 'payment.failed' | 'payment.processing' | 'payment.cancelled' | 'refund.succeeded' | 'refund.failed' | 'dispute.opened' | 'dispute.expired' | 'dispute.accepted' | 'dispute.cancelled' | 'dispute.challenged' | 'dispute.won' | 'dispute.lost' | 'subscription.active' | 'subscription.renewed' | 'subscription.on_hold' | 'subscription.cancelled' | 'subscription.failed' | 'subscription.expired' | 'subscription.plan_changed' | 'subscription.updated' | 'license_key.created' | 'payout.not_initiated' | 'payout.on_hold' | 'payout.in_progress' | 'payout.failed' | 'payout.success' | 'credit.added' | 'credit.deducted' | 'credit.expired' | 'credit.rolled_over' | 'credit.rollover_forfeited' | 'credit.overage_charged' | 'credit.manual_adjustment' | 'credit.balance_low' | 'abandoned_checkout.detected' | 'abandoned_checkout.recovered' | 'dunning.started' | 'dunning.recovered' | 'acr.email' | 'dunning.email';
+export type WebhookEventType = 'payment.succeeded' | 'payment.failed' | 'payment.processing' | 'payment.cancelled' | 'refund.succeeded' | 'refund.failed' | 'dispute.opened' | 'dispute.expired' | 'dispute.accepted' | 'dispute.cancelled' | 'dispute.challenged' | 'dispute.won' | 'dispute.lost' | 'subscription.active' | 'subscription.renewed' | 'subscription.on_hold' | 'subscription.cancelled' | 'subscription.failed' | 'subscription.expired' | 'subscription.plan_changed' | 'subscription.updated' | 'license_key.created' | 'payout.not_initiated' | 'payout.on_hold' | 'payout.in_progress' | 'payout.failed' | 'payout.success' | 'credit.added' | 'credit.deducted' | 'credit.expired' | 'credit.rolled_over' | 'credit.rollover_forfeited' | 'credit.overage_charged' | 'credit.manual_adjustment' | 'credit.balance_low' | 'abandoned_checkout.detected' | 'abandoned_checkout.recovered' | 'dunning.started' | 'dunning.recovered' | 'acr.email' | 'dunning.email' | 'entitlement_grant.created' | 'entitlement_grant.delivered' | 'entitlement_grant.failed' | 'entitlement_grant.revoked';
 export interface WebhookPayload {
     business_id: string;
     /**
      * The latest data at the time of delivery attempt
      */
-    data: WebhookPayload.Payment | WebhookPayload.Subscription | WebhookPayload.Refund | WebhookPayload.Dispute | WebhookPayload.LicenseKey | WebhookPayload.CreditLedgerEntry | WebhookPayload.CreditBalanceLow | WebhookPayload.AbandonedCheckout | WebhookPayload.DunningAttempt;
+    data: WebhookPayload.Payment | WebhookPayload.Subscription | WebhookPayload.Refund | WebhookPayload.Dispute | WebhookPayload.LicenseKey | WebhookPayload.CreditLedgerEntry | WebhookPayload.CreditBalanceLow | WebhookPayload.AbandonedCheckout | WebhookPayload.DunningAttempt | WebhookPayload.EntitlementGrant;
     /**
      * The timestamp of when the event occurred (not necessarily the same of when it
      * was delivered)
@@ -81,6 +81,32 @@ export declare namespace WebhookPayload {
         trigger_state: 'on_hold' | 'cancelled';
         payment_id?: string | null;
     }
+    interface EntitlementGrant {
+        id: string;
+        business_id: string;
+        created_at: string;
+        customer_id: string;
+        entitlement_id: string;
+        external_id: string;
+        payload_type: 'EntitlementGrant';
+        status: 'Pending' | 'Delivered' | 'Failed' | 'Revoked';
+        updated_at: string;
+        delivered_at?: string | null;
+        error_code?: string | null;
+        error_message?: string | null;
+        license_key?: string | null;
+        license_key_activations_limit?: number | null;
+        license_key_activations_used?: number | null;
+        license_key_expires_at?: string | null;
+        license_key_status?: string | null;
+        metadata?: unknown;
+        oauth_expires_at?: string | null;
+        oauth_url?: string | null;
+        payment_id?: string | null;
+        revocation_reason?: string | null;
+        revoked_at?: string | null;
+        subscription_id?: string | null;
+    }
 }
 export declare namespace WebhookEvents {
     export { type WebhookEventType as WebhookEventType, type WebhookPayload as WebhookPayload };

package/resources/webhook-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhook-events.d.ts","sourceRoot":"","sources":["../src/resources/webhook-events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"webhook-events.d.ts","sourceRoot":"","sources":["../src/resources/webhook-events.ts"],"names":[],"mappings":"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"}

package/src/client.ts

@@ -93,6 +93,7 @@ import {
 } from './resources/license-key-instances';
 import {
   LicenseKey,
+  LicenseKeyCreateParams,
   LicenseKeyListParams,
   LicenseKeyStatus,
   LicenseKeyUpdateParams,
@@ -1189,6 +1190,7 @@ export declare namespace DodoPayments {
     type LicenseKey as LicenseKey,
     type LicenseKeyStatus as LicenseKeyStatus,
     type LicenseKeysDefaultPageNumberPagination as LicenseKeysDefaultPageNumberPagination,
+    type LicenseKeyCreateParams as LicenseKeyCreateParams,
     type LicenseKeyUpdateParams as LicenseKeyUpdateParams,
     type LicenseKeyListParams as LicenseKeyListParams,
   };

package/src/internal/utils/env.ts

@@ -9,10 +9,10 @@
  */
 export const readEnv = (env: string): string | undefined => {
   if (typeof (globalThis as any).process !== 'undefined') {
-    return (globalThis as any).process.env?.[env]?.trim() ?? undefined;
+    return (globalThis as any).process.env?.[env]?.trim() || undefined;
   }
   if (typeof (globalThis as any).Deno !== 'undefined') {
-    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+    return (globalThis as any).Deno.env?.get?.(env)?.trim() || undefined;
   }
   return undefined;
 };

package/src/resources/discounts.ts

@@ -99,6 +99,8 @@ export interface Discount {
    */
   discount_id: string;
 
+  metadata: { [key: string]: string };
+
   /**
    * Whether this discount should be preserved when a subscription changes plans.
    * Default: false (discount is removed on plan change)
@@ -176,6 +178,11 @@ export interface DiscountCreateParams {
    */
   expires_at?: string | null;
 
+  /**
+   * Additional metadata for the discount
+   */
+  metadata?: { [key: string]: string };
+
   name?: string | null;
 
   /**
@@ -221,6 +228,11 @@ export interface DiscountUpdateParams {
 
   expires_at?: string | null;
 
+  /**
+   * Additional metadata for the discount
+   */
+  metadata?: { [key: string]: string } | null;
+
   name?: string | null;
 
   /**

package/src/resources/index.ts

@@ -92,6 +92,7 @@ export {
   LicenseKeys,
   type LicenseKey,
   type LicenseKeyStatus,
+  type LicenseKeyCreateParams,
   type LicenseKeyUpdateParams,
   type LicenseKeyListParams,
   type LicenseKeysDefaultPageNumberPagination,

package/src/resources/license-keys.ts

@@ -14,35 +14,33 @@ export class LicenseKeys extends APIResource {
   /**
    * @example
    * ```ts
-   * const licenseKey = await client.licenseKeys.retrieve(
-   *   'lic_123',
-   * );
+   * const licenseKey = await client.licenseKeys.create({
+   *   customer_id: 'customer_id',
+   *   key: 'key',
+   *   product_id: 'product_id',
+   * });
    * ```
    */
+  create(body: LicenseKeyCreateParams, options?: RequestOptions): APIPromise<LicenseKey> {
+    return this._client.post('/license_keys', { body, ...options });
+  }
+
+  /**
+   * @deprecated
+   */
   retrieve(id: string, options?: RequestOptions): APIPromise<LicenseKey> {
     return this._client.get(path`/license_keys/${id}`, options);
   }
 
   /**
-   * @example
-   * ```ts
-   * const licenseKey = await client.licenseKeys.update(
-   *   'lic_123',
-   * );
-   * ```
+   * @deprecated
    */
   update(id: string, body: LicenseKeyUpdateParams, options?: RequestOptions): APIPromise<LicenseKey> {
     return this._client.patch(path`/license_keys/${id}`, { body, ...options });
   }
 
   /**
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const licenseKey of client.licenseKeys.list()) {
-   *   // ...
-   * }
-   * ```
+   * @deprecated
    */
   list(
     query: LicenseKeyListParams | null | undefined = {},
@@ -89,14 +87,15 @@ export interface LicenseKey {
   key: string;
 
   /**
-   * The unique identifier of the payment associated with the license key.
+   * The unique identifier of the product associated with the license key.
    */
-  payment_id: string;
+  product_id: string;
 
   /**
-   * The unique identifier of the product associated with the license key.
+   * The source of the license key - 'auto' for keys generated by
+   * payment/subscription flows, 'import' for merchant-imported keys.
    */
-  product_id: string;
+  source: 'auto' | 'import';
 
   /**
    * The current status of the license key (e.g., active, inactive, expired).
@@ -113,6 +112,11 @@ export interface LicenseKey {
    */
   expires_at?: string | null;
 
+  /**
+   * The unique identifier of the payment associated with the license key, if any.
+   */
+  payment_id?: string | null;
+
   /**
    * The unique identifier of the subscription associated with the license key, if
    * any.
@@ -122,6 +126,33 @@ export interface LicenseKey {
 
 export type LicenseKeyStatus = 'active' | 'expired' | 'disabled';
 
+export interface LicenseKeyCreateParams {
+  /**
+   * The customer this license key belongs to.
+   */
+  customer_id: string;
+
+  /**
+   * The license key string to import.
+   */
+  key: string;
+
+  /**
+   * The product this license key is for.
+   */
+  product_id: string;
+
+  /**
+   * Maximum number of activations allowed. Null means unlimited.
+   */
+  activations_limit?: number | null;
+
+  /**
+   * Expiration timestamp. Null means the key never expires.
+   */
+  expires_at?: string | null;
+}
+
 export interface LicenseKeyUpdateParams {
   /**
    * The updated activation limit for the license key. Use `null` to remove the
@@ -163,6 +194,11 @@ export interface LicenseKeyListParams extends DefaultPageNumberPaginationParams
    */
   product_id?: string;
 
+  /**
+   * Filter by license key source
+   */
+  source?: 'auto' | 'import';
+
   /**
    * Filter by license key status
    */
@@ -174,6 +210,7 @@ export declare namespace LicenseKeys {
     type LicenseKey as LicenseKey,
     type LicenseKeyStatus as LicenseKeyStatus,
     type LicenseKeysDefaultPageNumberPagination as LicenseKeysDefaultPageNumberPagination,
+    type LicenseKeyCreateParams as LicenseKeyCreateParams,
     type LicenseKeyUpdateParams as LicenseKeyUpdateParams,
     type LicenseKeyListParams as LicenseKeyListParams,
   };

package/src/resources/products/products.ts

@@ -542,13 +542,18 @@ export interface Product {
    */
   credit_entitlements: Array<CreditEntitlementMappingResponse>;
 
+  /**
+   * Attached entitlements (integration-based access grants)
+   */
+  entitlements: Array<Product.Entitlement>;
+
   /**
    * Indicates if the product is recurring (e.g., subscriptions).
    */
   is_recurring: boolean;
 
   /**
-   * Indicates whether the product requires a license key.
+   * @deprecated Indicates whether the product requires a license key.
    */
   license_key_enabled: boolean;
 
@@ -595,12 +600,12 @@ export interface Product {
   image?: string | null;
 
   /**
-   * Message sent upon license key activation, if applicable.
+   * @deprecated Message sent upon license key activation, if applicable.
    */
   license_key_activation_message?: string | null;
 
   /**
-   * Limit on the number of activations for the license key, if enabled.
+   * @deprecated Limit on the number of activations for the license key, if enabled.
    */
   license_key_activations_limit?: number | null;
 
@@ -620,6 +625,94 @@ export interface Product {
   product_collection_id?: string | null;
 }
 
+export namespace Product {
+  /**
+   * Summary of an entitlement attached to a product
+   */
+  export interface Entitlement {
+    id: string;
+
+    /**
+     * Platform-specific configuration for an entitlement. Each variant uses unique
+     * field names so `#[serde(untagged)]` can disambiguate correctly.
+     */
+    integration_config:
+      | Entitlement.GitHubConfig
+      | Entitlement.DiscordConfig
+      | Entitlement.TelegramConfig
+      | Entitlement.FigmaConfig
+      | Entitlement.FramerConfig
+      | Entitlement.NotionConfig
+      | Entitlement.DigitalFilesConfig
+      | Entitlement.LicenseKeyConfig;
+
+    integration_type:
+      | 'discord'
+      | 'telegram'
+      | 'github'
+      | 'figma'
+      | 'framer'
+      | 'notion'
+      | 'digital_files'
+      | 'license_key';
+
+    name: string;
+
+    description?: string | null;
+  }
+
+  export namespace Entitlement {
+    export interface GitHubConfig {
+      /**
+       * One of: pull, push, admin, maintain, triage
+       */
+      permission: string;
+
+      target_id: string;
+    }
+
+    export interface DiscordConfig {
+      guild_id: string;
+
+      role_id?: string | null;
+    }
+
+    export interface TelegramConfig {
+      chat_id: string;
+    }
+
+    export interface FigmaConfig {
+      figma_file_id: string;
+    }
+
+    export interface FramerConfig {
+      framer_template_id: string;
+    }
+
+    export interface NotionConfig {
+      notion_template_id: string;
+    }
+
+    export interface DigitalFilesConfig {
+      digital_file_ids: Array<string>;
+
+      external_url?: string | null;
+
+      instructions?: string | null;
+    }
+
+    export interface LicenseKeyConfig {
+      activation_message?: string | null;
+
+      activations_limit?: number | null;
+
+      duration_count?: number | null;
+
+      duration_interval?: string | null;
+    }
+  }
+}
+
 export interface ProductListResponse {
   /**
    * Unique identifier for the business to which the product belongs.
@@ -631,6 +724,11 @@ export interface ProductListResponse {
    */
   created_at: string;
 
+  /**
+   * Entitlements linked to this product
+   */
+  entitlements: Array<ProductListResponse.Entitlement>;
+
   /**
    * Indicates if the product is recurring (e.g., subscriptions).
    */
@@ -701,6 +799,94 @@ export interface ProductListResponse {
   tax_inclusive?: boolean | null;
 }
 
+export namespace ProductListResponse {
+  /**
+   * Summary of an entitlement attached to a product
+   */
+  export interface Entitlement {
+    id: string;
+
+    /**
+     * Platform-specific configuration for an entitlement. Each variant uses unique
+     * field names so `#[serde(untagged)]` can disambiguate correctly.
+     */
+    integration_config:
+      | Entitlement.GitHubConfig
+      | Entitlement.DiscordConfig
+      | Entitlement.TelegramConfig
+      | Entitlement.FigmaConfig
+      | Entitlement.FramerConfig
+      | Entitlement.NotionConfig
+      | Entitlement.DigitalFilesConfig
+      | Entitlement.LicenseKeyConfig;
+
+    integration_type:
+      | 'discord'
+      | 'telegram'
+      | 'github'
+      | 'figma'
+      | 'framer'
+      | 'notion'
+      | 'digital_files'
+      | 'license_key';
+
+    name: string;
+
+    description?: string | null;
+  }
+
+  export namespace Entitlement {
+    export interface GitHubConfig {
+      /**
+       * One of: pull, push, admin, maintain, triage
+       */
+      permission: string;
+
+      target_id: string;
+    }
+
+    export interface DiscordConfig {
+      guild_id: string;
+
+      role_id?: string | null;
+    }
+
+    export interface TelegramConfig {
+      chat_id: string;
+    }
+
+    export interface FigmaConfig {
+      figma_file_id: string;
+    }
+
+    export interface FramerConfig {
+      framer_template_id: string;
+    }
+
+    export interface NotionConfig {
+      notion_template_id: string;
+    }
+
+    export interface DigitalFilesConfig {
+      digital_file_ids: Array<string>;
+
+      external_url?: string | null;
+
+      instructions?: string | null;
+    }
+
+    export interface LicenseKeyConfig {
+      activation_message?: string | null;
+
+      activations_limit?: number | null;
+
+      duration_count?: number | null;
+
+      duration_interval?: string | null;
+    }
+  }
+}
+
 export interface ProductUpdateFilesResponse {
   file_id: string;
 
@@ -749,12 +935,18 @@ export interface ProductCreateParams {
   digital_product_delivery?: ProductCreateParams.DigitalProductDelivery | null;
 
   /**
-   * Optional message displayed during license key activation
+   * Optional entitlement IDs to attach to this product (max 20)
+   */
+  entitlement_ids?: Array<string> | null;
+
+  /**
+   * @deprecated Optional message displayed during license key activation
    */
   license_key_activation_message?: string | null;
 
   /**
-   * The number of times the license key can be activated. Must be 0 or greater
+   * @deprecated The number of times the license key can be activated. Must be 0 or
+   * greater
    */
   license_key_activations_limit?: number | null;
 
@@ -766,7 +958,8 @@ export interface ProductCreateParams {
   license_key_duration?: LicenseKeyDuration | null;
 
   /**
-   * When true, generates and sends a license key to your customer. Defaults to false
+   * @deprecated When true, generates and sends a license key to your customer.
+   * Defaults to false
    */
   license_key_enabled?: boolean | null;
 
@@ -817,13 +1010,19 @@ export interface ProductUpdateParams {
    */
   digital_product_delivery?: ProductUpdateParams.DigitalProductDelivery | null;
 
+  /**
+   * Entitlement IDs to attach (replaces all existing when present) Send empty array
+   * to remove all, omit field to leave unchanged
+   */
+  entitlement_ids?: Array<string> | null;
+
   /**
    * Product image id after its uploaded to S3
    */
   image_id?: string | null;
 
   /**
-   * Message sent to the customer upon license key activation.
+   * @deprecated Message sent to the customer upon license key activation.
    *
    * Only applicable if `license_key_enabled` is `true`. This message contains
    * instructions for activating the license key.
@@ -831,7 +1030,7 @@ export interface ProductUpdateParams {
   license_key_activation_message?: string | null;
 
   /**
-   * Limit for the number of activations for the license key.
+   * @deprecated Limit for the number of activations for the license key.
    *
    * Only applicable if `license_key_enabled` is `true`. Represents the maximum
    * number of times the license key can be activated.
@@ -847,7 +1046,7 @@ export interface ProductUpdateParams {
   license_key_duration?: LicenseKeyDuration | null;
 
   /**
-   * Whether the product requires a license key.
+   * @deprecated Whether the product requires a license key.
    *
    * If `true`, additional fields related to license key (duration, activations
    * limit, activation message) become applicable.

package/src/resources/webhook-events.ts

@@ -54,7 +54,11 @@ export type WebhookEventType =
   | 'dunning.started'
   | 'dunning.recovered'
   | 'acr.email'
-  | 'dunning.email';
+  | 'dunning.email'
+  | 'entitlement_grant.created'
+  | 'entitlement_grant.delivered'
+  | 'entitlement_grant.failed'
+  | 'entitlement_grant.revoked';
 
 export interface WebhookPayload {
   business_id: string;
@@ -71,7 +75,8 @@ export interface WebhookPayload {
     | WebhookPayload.CreditLedgerEntry
     | WebhookPayload.CreditBalanceLow
     | WebhookPayload.AbandonedCheckout
-    | WebhookPayload.DunningAttempt;
+    | WebhookPayload.DunningAttempt
+    | WebhookPayload.EntitlementGrant;
 
   /**
    * The timestamp of when the event occurred (not necessarily the same of when it
@@ -167,6 +172,56 @@ export namespace WebhookPayload {
 
     payment_id?: string | null;
   }
+
+  export interface EntitlementGrant {
+    id: string;
+
+    business_id: string;
+
+    created_at: string;
+
+    customer_id: string;
+
+    entitlement_id: string;
+
+    external_id: string;
+
+    payload_type: 'EntitlementGrant';
+
+    status: 'Pending' | 'Delivered' | 'Failed' | 'Revoked';
+
+    updated_at: string;
+
+    delivered_at?: string | null;
+
+    error_code?: string | null;
+
+    error_message?: string | null;
+
+    license_key?: string | null;
+
+    license_key_activations_limit?: number | null;
+
+    license_key_activations_used?: number | null;
+
+    license_key_expires_at?: string | null;
+
+    license_key_status?: string | null;
+
+    metadata?: unknown;
+
+    oauth_expires_at?: string | null;
+
+    oauth_url?: string | null;
+
+    payment_id?: string | null;
+
+    revocation_reason?: string | null;
+
+    revoked_at?: string | null;
+
+    subscription_id?: string | null;
+  }
 }
 
 export declare namespace WebhookEvents {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '2.26.0'; // x-release-please-version
+export const VERSION = '2.28.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.26.0";
+export declare const VERSION = "2.28.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.26.0";
+export declare const VERSION = "2.28.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '2.26.0'; // x-release-please-version
+exports.VERSION = '2.28.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '2.26.0'; // x-release-please-version
+export const VERSION = '2.28.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map