authtara-sdk 1.1.8 → 1.1.9

package/dist/index.d.mts

@@ -447,6 +447,147 @@ declare class PricingModule {
     getAppPricing(): Promise<AppPricingResult | null>;
 }
 
+/**
+ * Authtara SDK - Checkout Module
+ *
+ * Handles checkout and payment flow for subscriptions.
+ * Integrates with Digital Solution's billing system.
+ */
+
+/**
+ * Parameters for creating a checkout session
+ */
+interface CreateCheckoutParams {
+    /** Tenant ID making the purchase */
+    tenantId: string;
+    /** User ID initiating the checkout */
+    userId: string;
+    /** Plan slug (e.g., 'pro', 'basic') */
+    planSlug: string;
+    /** Billing cycle */
+    billingCycle: 'MONTHLY' | 'YEARLY';
+}
+/**
+ * Result of creating a checkout session
+ */
+interface CheckoutResult {
+    /** Unique order identifier */
+    orderId: string;
+    /** URL to redirect user for payment */
+    paymentUrl: string;
+    /** Total amount to be charged */
+    amount: number;
+    /** Currency code (e.g., 'IDR') */
+    currency: string;
+    /** When the checkout session expires */
+    expiresAt: string;
+    /** Created subscription ID */
+    subscriptionId: string;
+}
+/**
+ * Checkout/payment status
+ */
+interface CheckoutStatus {
+    /** Order identifier */
+    orderId: string;
+    /** Current status */
+    status: 'PENDING' | 'PAID' | 'FAILED' | 'EXPIRED';
+    /** Subscription details if available */
+    subscription: {
+        id: string;
+        status: string;
+        plan: string;
+    } | null;
+    /** Payment timestamp if paid */
+    paidAt: string | null;
+}
+/**
+ * Checkout Module
+ *
+ * Provides functions for subscription checkout and payment management.
+ * Use this to create checkout sessions and verify payment status.
+ *
+ * @example
+ * ```typescript
+ * // Create checkout session
+ * const checkout = await ds.checkout.create({
+ *   tenantId: 'tenant-123',
+ *   userId: 'user-456',
+ *   planSlug: 'pro',
+ *   billingCycle: 'MONTHLY'
+ * });
+ *
+ * // Redirect user to payment
+ * window.location.href = checkout.paymentUrl;
+ *
+ * // After payment redirect, verify status
+ * const status = await ds.checkout.verify(checkout.orderId);
+ * if (status.status === 'PAID') {
+ *   console.log('Subscription activated!');
+ * }
+ * ```
+ */
+declare class CheckoutModule {
+    private readonly httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * Create a checkout session for a subscription purchase
+     *
+     * @param params - Checkout parameters
+     * @returns CheckoutResult with payment URL and order details
+     *
+     * @example
+     * ```typescript
+     * const checkout = await ds.checkout.create({
+     *   tenantId: session.tenant.id,
+     *   userId: session.user.id,
+     *   planSlug: 'pro',
+     *   billingCycle: 'MONTHLY'
+     * });
+     *
+     * // Redirect to payment page
+     * window.location.href = checkout.paymentUrl;
+     * ```
+     */
+    create(params: CreateCheckoutParams): Promise<CheckoutResult>;
+    /**
+     * Get checkout/payment status by order ID
+     *
+     * @param orderId - The order ID from checkout creation
+     * @returns CheckoutStatus with current payment status
+     *
+     * @example
+     * ```typescript
+     * const status = await ds.checkout.getStatus(orderId);
+     * console.log('Payment status:', status.status);
+     * ```
+     */
+    getStatus(orderId: string): Promise<CheckoutStatus>;
+    /**
+     * Verify checkout and activate subscription
+     *
+     * Call this after the user returns from the payment gateway.
+     * If payment is complete, the subscription will be activated.
+     *
+     * @param orderId - The order ID from checkout creation
+     * @returns CheckoutStatus with updated subscription status
+     *
+     * @example
+     * ```typescript
+     * // After redirect from payment gateway
+     * const status = await ds.checkout.verify(orderId);
+     *
+     * if (status.status === 'PAID') {
+     *   console.log('Subscription activated!', status.subscription);
+     *   redirect('/dashboard');
+     * } else {
+     *   console.log('Payment failed:', status.status);
+     * }
+     * ```
+     */
+    verify(orderId: string): Promise<CheckoutStatus>;
+}
+
 /**
  * Authtara SDK - Custom Error Classes
  *
@@ -580,6 +721,10 @@ declare class Authtara {
      * Pricing module untuk mengambil data pricing aplikasi
      */
     readonly pricing: PricingModule;
+    /**
+     * Checkout module untuk subscription purchase dan payment
+     */
+    readonly checkout: CheckoutModule;
     /**
      * Create new Authtara SDK instance
      *
@@ -589,4 +734,4 @@ declare class Authtara {
     constructor(config: AuthtaraConfig);
 }
 
-export { ApiError, type AppFeature, type AppPlan, type AppPlanFeature, type AppPrice, type AppPricingResult, Authtara, type AuthtaraConfig, AuthtaraError, type CheckEntitlementParams, ConfigurationError, EntitlementDeniedError, type EntitlementResult, type ExchangeResult, InvalidTokenError, type RecordUsageParams, type RecordUsageResult, type SessionVerifyResult, Authtara as default };
+export { ApiError, type AppFeature, type AppPlan, type AppPlanFeature, type AppPrice, type AppPricingResult, Authtara, type AuthtaraConfig, AuthtaraError, type CheckEntitlementParams, type CheckoutResult, type CheckoutStatus, ConfigurationError, type CreateCheckoutParams, EntitlementDeniedError, type EntitlementResult, type ExchangeResult, InvalidTokenError, type RecordUsageParams, type RecordUsageResult, type SessionVerifyResult, Authtara as default };

package/dist/index.d.ts

@@ -447,6 +447,147 @@ declare class PricingModule {
     getAppPricing(): Promise<AppPricingResult | null>;
 }
 
+/**
+ * Authtara SDK - Checkout Module
+ *
+ * Handles checkout and payment flow for subscriptions.
+ * Integrates with Digital Solution's billing system.
+ */
+
+/**
+ * Parameters for creating a checkout session
+ */
+interface CreateCheckoutParams {
+    /** Tenant ID making the purchase */
+    tenantId: string;
+    /** User ID initiating the checkout */
+    userId: string;
+    /** Plan slug (e.g., 'pro', 'basic') */
+    planSlug: string;
+    /** Billing cycle */
+    billingCycle: 'MONTHLY' | 'YEARLY';
+}
+/**
+ * Result of creating a checkout session
+ */
+interface CheckoutResult {
+    /** Unique order identifier */
+    orderId: string;
+    /** URL to redirect user for payment */
+    paymentUrl: string;
+    /** Total amount to be charged */
+    amount: number;
+    /** Currency code (e.g., 'IDR') */
+    currency: string;
+    /** When the checkout session expires */
+    expiresAt: string;
+    /** Created subscription ID */
+    subscriptionId: string;
+}
+/**
+ * Checkout/payment status
+ */
+interface CheckoutStatus {
+    /** Order identifier */
+    orderId: string;
+    /** Current status */
+    status: 'PENDING' | 'PAID' | 'FAILED' | 'EXPIRED';
+    /** Subscription details if available */
+    subscription: {
+        id: string;
+        status: string;
+        plan: string;
+    } | null;
+    /** Payment timestamp if paid */
+    paidAt: string | null;
+}
+/**
+ * Checkout Module
+ *
+ * Provides functions for subscription checkout and payment management.
+ * Use this to create checkout sessions and verify payment status.
+ *
+ * @example
+ * ```typescript
+ * // Create checkout session
+ * const checkout = await ds.checkout.create({
+ *   tenantId: 'tenant-123',
+ *   userId: 'user-456',
+ *   planSlug: 'pro',
+ *   billingCycle: 'MONTHLY'
+ * });
+ *
+ * // Redirect user to payment
+ * window.location.href = checkout.paymentUrl;
+ *
+ * // After payment redirect, verify status
+ * const status = await ds.checkout.verify(checkout.orderId);
+ * if (status.status === 'PAID') {
+ *   console.log('Subscription activated!');
+ * }
+ * ```
+ */
+declare class CheckoutModule {
+    private readonly httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * Create a checkout session for a subscription purchase
+     *
+     * @param params - Checkout parameters
+     * @returns CheckoutResult with payment URL and order details
+     *
+     * @example
+     * ```typescript
+     * const checkout = await ds.checkout.create({
+     *   tenantId: session.tenant.id,
+     *   userId: session.user.id,
+     *   planSlug: 'pro',
+     *   billingCycle: 'MONTHLY'
+     * });
+     *
+     * // Redirect to payment page
+     * window.location.href = checkout.paymentUrl;
+     * ```
+     */
+    create(params: CreateCheckoutParams): Promise<CheckoutResult>;
+    /**
+     * Get checkout/payment status by order ID
+     *
+     * @param orderId - The order ID from checkout creation
+     * @returns CheckoutStatus with current payment status
+     *
+     * @example
+     * ```typescript
+     * const status = await ds.checkout.getStatus(orderId);
+     * console.log('Payment status:', status.status);
+     * ```
+     */
+    getStatus(orderId: string): Promise<CheckoutStatus>;
+    /**
+     * Verify checkout and activate subscription
+     *
+     * Call this after the user returns from the payment gateway.
+     * If payment is complete, the subscription will be activated.
+     *
+     * @param orderId - The order ID from checkout creation
+     * @returns CheckoutStatus with updated subscription status
+     *
+     * @example
+     * ```typescript
+     * // After redirect from payment gateway
+     * const status = await ds.checkout.verify(orderId);
+     *
+     * if (status.status === 'PAID') {
+     *   console.log('Subscription activated!', status.subscription);
+     *   redirect('/dashboard');
+     * } else {
+     *   console.log('Payment failed:', status.status);
+     * }
+     * ```
+     */
+    verify(orderId: string): Promise<CheckoutStatus>;
+}
+
 /**
  * Authtara SDK - Custom Error Classes
  *
@@ -580,6 +721,10 @@ declare class Authtara {
      * Pricing module untuk mengambil data pricing aplikasi
      */
     readonly pricing: PricingModule;
+    /**
+     * Checkout module untuk subscription purchase dan payment
+     */
+    readonly checkout: CheckoutModule;
     /**
      * Create new Authtara SDK instance
      *
@@ -589,4 +734,4 @@ declare class Authtara {
     constructor(config: AuthtaraConfig);
 }
 
-export { ApiError, type AppFeature, type AppPlan, type AppPlanFeature, type AppPrice, type AppPricingResult, Authtara, type AuthtaraConfig, AuthtaraError, type CheckEntitlementParams, ConfigurationError, EntitlementDeniedError, type EntitlementResult, type ExchangeResult, InvalidTokenError, type RecordUsageParams, type RecordUsageResult, type SessionVerifyResult, Authtara as default };
+export { ApiError, type AppFeature, type AppPlan, type AppPlanFeature, type AppPrice, type AppPricingResult, Authtara, type AuthtaraConfig, AuthtaraError, type CheckEntitlementParams, type CheckoutResult, type CheckoutStatus, ConfigurationError, type CreateCheckoutParams, EntitlementDeniedError, type EntitlementResult, type ExchangeResult, InvalidTokenError, type RecordUsageParams, type RecordUsageResult, type SessionVerifyResult, Authtara as default };

package/dist/index.js

@@ -406,6 +406,109 @@ var PricingModule = class {
   }
 };
 
+// src/checkout/index.ts
+var CheckoutModule = class {
+  constructor(httpClient) {
+    if (!httpClient) {
+      throw new ConfigurationError("httpClient is required for CheckoutModule");
+    }
+    this.httpClient = httpClient;
+  }
+  /**
+   * Create a checkout session for a subscription purchase
+   *
+   * @param params - Checkout parameters
+   * @returns CheckoutResult with payment URL and order details
+   *
+   * @example
+   * ```typescript
+   * const checkout = await ds.checkout.create({
+   *   tenantId: session.tenant.id,
+   *   userId: session.user.id,
+   *   planSlug: 'pro',
+   *   billingCycle: 'MONTHLY'
+   * });
+   *
+   * // Redirect to payment page
+   * window.location.href = checkout.paymentUrl;
+   * ```
+   */
+  async create(params) {
+    if (!params.tenantId) {
+      throw new ConfigurationError("tenantId is required");
+    }
+    if (!params.userId) {
+      throw new ConfigurationError("userId is required");
+    }
+    if (!params.planSlug) {
+      throw new ConfigurationError("planSlug is required");
+    }
+    if (!params.billingCycle) {
+      throw new ConfigurationError("billingCycle is required");
+    }
+    return this.httpClient.post(
+      "/api/v1/dev/checkout/create",
+      {
+        tenantId: params.tenantId,
+        userId: params.userId,
+        planSlug: params.planSlug,
+        billingCycle: params.billingCycle
+      }
+    );
+  }
+  /**
+   * Get checkout/payment status by order ID
+   *
+   * @param orderId - The order ID from checkout creation
+   * @returns CheckoutStatus with current payment status
+   *
+   * @example
+   * ```typescript
+   * const status = await ds.checkout.getStatus(orderId);
+   * console.log('Payment status:', status.status);
+   * ```
+   */
+  async getStatus(orderId) {
+    if (!orderId) {
+      throw new ConfigurationError("orderId is required");
+    }
+    return this.httpClient.get(
+      `/api/v1/dev/checkout/status/${orderId}`
+    );
+  }
+  /**
+   * Verify checkout and activate subscription
+   *
+   * Call this after the user returns from the payment gateway.
+   * If payment is complete, the subscription will be activated.
+   *
+   * @param orderId - The order ID from checkout creation
+   * @returns CheckoutStatus with updated subscription status
+   *
+   * @example
+   * ```typescript
+   * // After redirect from payment gateway
+   * const status = await ds.checkout.verify(orderId);
+   *
+   * if (status.status === 'PAID') {
+   *   console.log('Subscription activated!', status.subscription);
+   *   redirect('/dashboard');
+   * } else {
+   *   console.log('Payment failed:', status.status);
+   * }
+   * ```
+   */
+  async verify(orderId) {
+    if (!orderId) {
+      throw new ConfigurationError("orderId is required");
+    }
+    return this.httpClient.post(
+      "/api/v1/dev/checkout/verify",
+      { orderId }
+    );
+  }
+};
+
 // src/index.ts
 var Authtara = class {
   /**
@@ -434,6 +537,7 @@ var Authtara = class {
     this.billing = new BillingModule(httpClient);
     this.metering = new MeteringModule(httpClient);
     this.pricing = new PricingModule(httpClient);
+    this.checkout = new CheckoutModule(httpClient);
   }
 };
 var index_default = Authtara;

package/dist/index.mjs

@@ -374,6 +374,109 @@ var PricingModule = class {
   }
 };
 
+// src/checkout/index.ts
+var CheckoutModule = class {
+  constructor(httpClient) {
+    if (!httpClient) {
+      throw new ConfigurationError("httpClient is required for CheckoutModule");
+    }
+    this.httpClient = httpClient;
+  }
+  /**
+   * Create a checkout session for a subscription purchase
+   *
+   * @param params - Checkout parameters
+   * @returns CheckoutResult with payment URL and order details
+   *
+   * @example
+   * ```typescript
+   * const checkout = await ds.checkout.create({
+   *   tenantId: session.tenant.id,
+   *   userId: session.user.id,
+   *   planSlug: 'pro',
+   *   billingCycle: 'MONTHLY'
+   * });
+   *
+   * // Redirect to payment page
+   * window.location.href = checkout.paymentUrl;
+   * ```
+   */
+  async create(params) {
+    if (!params.tenantId) {
+      throw new ConfigurationError("tenantId is required");
+    }
+    if (!params.userId) {
+      throw new ConfigurationError("userId is required");
+    }
+    if (!params.planSlug) {
+      throw new ConfigurationError("planSlug is required");
+    }
+    if (!params.billingCycle) {
+      throw new ConfigurationError("billingCycle is required");
+    }
+    return this.httpClient.post(
+      "/api/v1/dev/checkout/create",
+      {
+        tenantId: params.tenantId,
+        userId: params.userId,
+        planSlug: params.planSlug,
+        billingCycle: params.billingCycle
+      }
+    );
+  }
+  /**
+   * Get checkout/payment status by order ID
+   *
+   * @param orderId - The order ID from checkout creation
+   * @returns CheckoutStatus with current payment status
+   *
+   * @example
+   * ```typescript
+   * const status = await ds.checkout.getStatus(orderId);
+   * console.log('Payment status:', status.status);
+   * ```
+   */
+  async getStatus(orderId) {
+    if (!orderId) {
+      throw new ConfigurationError("orderId is required");
+    }
+    return this.httpClient.get(
+      `/api/v1/dev/checkout/status/${orderId}`
+    );
+  }
+  /**
+   * Verify checkout and activate subscription
+   *
+   * Call this after the user returns from the payment gateway.
+   * If payment is complete, the subscription will be activated.
+   *
+   * @param orderId - The order ID from checkout creation
+   * @returns CheckoutStatus with updated subscription status
+   *
+   * @example
+   * ```typescript
+   * // After redirect from payment gateway
+   * const status = await ds.checkout.verify(orderId);
+   *
+   * if (status.status === 'PAID') {
+   *   console.log('Subscription activated!', status.subscription);
+   *   redirect('/dashboard');
+   * } else {
+   *   console.log('Payment failed:', status.status);
+   * }
+   * ```
+   */
+  async verify(orderId) {
+    if (!orderId) {
+      throw new ConfigurationError("orderId is required");
+    }
+    return this.httpClient.post(
+      "/api/v1/dev/checkout/verify",
+      { orderId }
+    );
+  }
+};
+
 // src/index.ts
 var Authtara = class {
   /**
@@ -402,6 +505,7 @@ var Authtara = class {
     this.billing = new BillingModule(httpClient);
     this.metering = new MeteringModule(httpClient);
     this.pricing = new PricingModule(httpClient);
+    this.checkout = new CheckoutModule(httpClient);
   }
 };
 var index_default = Authtara;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "authtara-sdk",
-    "version": "1.1.8",
+    "version": "1.1.9",
     "description": "SDK Client untuk integrasi dengan DigitalSolution Platform - SSO, Billing, dan Metering",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",