@waffo/waffo-node 3.1.0 → 3.2.0

package/dist/index.mjs

@@ -348,6 +348,10 @@ var ApiResponse = class _ApiResponse {
   getData() {
     return this.data;
   }
+  /** Returns the same JSON data with business string literals opened to future values. */
+  getOpenData() {
+    return this.data;
+  }
   /**
    * Gets the error message.
    *
@@ -455,7 +459,7 @@ var HEADER_SDK_VERSION = "x-sdk-version";
 var HEADER_CONTENT_TYPE = "content-type";
 var CONTENT_TYPE_JSON = "application/json";
 var API_VERSION = "1.0.0";
-var SDK_VERSION = "waffo-node/3.1.0";
+var SDK_VERSION = "waffo-node/3.2.0";
 var WaffoHttpClient = class {
   baseUrl;
   apiKey;
@@ -646,6 +650,7 @@ var WebhookHandler = class {
   subscriptionPaymentHandler;
   subscriptionPeriodChangedHandler;
   subscriptionChangeHandler;
+  customEventHandlers = /* @__PURE__ */ new Map();
   constructor(config) {
     this.waffoPublicKey = config.waffoPublicKey;
     this.privateKey = config.privateKey;
@@ -694,6 +699,20 @@ var WebhookHandler = class {
     this.subscriptionChangeHandler = handler;
     return this;
   }
+  /** Registers an exact custom event name before receiving webhooks. Later registration replaces the same name. */
+  onEvent(eventType, handler) {
+    if (typeof eventType !== "string" || !eventType.trim()) {
+      throw new WaffoError(WaffoErrorCode.UNEXPECTED, "Custom event name must not be blank");
+    }
+    if (typeof handler !== "function") {
+      throw new WaffoError(WaffoErrorCode.UNEXPECTED, "Custom event handler must be a function");
+    }
+    if (Object.values(WebhookEventType).some((known) => known === eventType)) {
+      throw new WaffoError(WaffoErrorCode.UNEXPECTED, `Use the dedicated handler for built-in event: ${eventType}`);
+    }
+    this.customEventHandlers.set(eventType, handler);
+    return this;
+  }
   /**
    * Processes a webhook notification.
    *
@@ -713,6 +732,9 @@ var WebhookHandler = class {
         return this.createFailedResult("Invalid signature");
       }
       const parsed = JSON.parse(body);
+      if (!parsed || typeof parsed.eventType !== "string") {
+        return this.createFailedResult("Unknown event type");
+      }
       const eventType = parsed.eventType;
       switch (eventType) {
         case "PAYMENT_NOTIFICATION" /* PAYMENT_NOTIFICATION */:
@@ -742,9 +764,15 @@ var WebhookHandler = class {
             await this.subscriptionChangeHandler(parsed);
           }
           break;
-        default:
-          this.logger?.warn(`Unknown webhook event type: ${eventType}`);
-          return this.createFailedResult(`Unknown event type: ${eventType}`);
+        default: {
+          const handler = this.customEventHandlers.get(eventType);
+          if (!handler) {
+            this.logger?.warn(`Unknown webhook event type: ${eventType}`);
+            return this.createFailedResult(`Unknown event type: ${eventType}`);
+          }
+          await handler(parsed);
+          break;
+        }
       }
       return this.createSuccessResult();
     } catch (error) {
@@ -937,14 +965,6 @@ var SubscriptionResource = class _SubscriptionResource extends BaseResource {
   static PATH_UPDATE = "/update";
   static PATH_CHANGE = "/change";
   static PATH_CHANGE_INQUIRY = "/change/inquiry";
-  /**
-   * Creates a new subscription.
-   *
-   * @param params - Subscription creation parameters
-   * @param options - Optional request options
-   * @returns API response with subscription data
-   * @throws WaffoUnknownStatusError for network errors
-   */
   async create(params, options) {
     if (!params.requestedAt) {
       params.requestedAt = getCurrentTimestamp();
@@ -1026,47 +1046,6 @@ var SubscriptionResource = class _SubscriptionResource extends BaseResource {
       null
     );
   }
-  /**
-   * Changes (upgrades/downgrades) an existing subscription.
-   *
-   * This method allows changing an active subscription to a new plan with different
-   * pricing, billing period, or other terms. The remaining amount from the original
-   * subscription can be applied to the new subscription.
-   *
-   * @param params - Subscription change parameters
-   * @param options - Optional request options
-   * @returns API response with change result
-   * @throws WaffoUnknownStatusError for network errors
-   *
-   * @example
-   * ```typescript
-   * const response = await waffo.subscription().change({
-   *   subscriptionRequest: 'new-request-id',
-   *   originSubscriptionRequest: 'original-request-id',
-   *   remainingAmount: '50.00',
-   *   currency: 'HKD',
-   *   requestedAt: new Date().toISOString(),
-   *   notifyUrl: 'https://example.com/webhook',
-   *   productInfoList: [{
-   *     description: 'Premium Monthly',
-   *     periodType: 'MONTH',
-   *     periodInterval: '1',
-   *     amount: '199.00',
-   *   }],
-   *   userInfo: { userId: 'user-123', userEmail: 'user@example.com' },
-   *   goodsInfo: { goodsId: 'premium', goodsName: 'Premium Plan' },
-   *   paymentInfo: { productName: 'SUBSCRIPTION' },
-   * });
-   *
-   * if (response.isSuccess()) {
-   *   const data = response.getData();
-   *   if (data?.subscriptionChangeStatus === 'AUTHORIZATION_REQUIRED') {
-   *     // Redirect user to authorization URL
-   *     const webUrl = JSON.parse(data.subscriptionAction || '{}').webUrl;
-   *   }
-   * }
-   * ```
-   */
   async change(params, options) {
     if (!params.requestedAt) {
       params.requestedAt = getCurrentTimestamp();