@pafi-dev/issuer 0.5.41 → 0.5.42

package/dist/index.d.cts

@@ -2457,13 +2457,13 @@ interface IssuerApiAdapterConfig {
     /** Optional issuer id — when omitted, sponsorAuth is skipped (returns `undefined`). */
     pafiIssuerId?: string;
     /** Sig-gated mint handler. Required for `claim` / `claimPrepare`. */
-    ptClaimHandler: PTClaimHandler;
+    ptClaimHandler?: PTClaimHandler | null;
     /** Reverse-flow handler. Required for `redeem` / `redeemPrepare`. */
     ptRedeemHandler?: PTRedeemHandler | null;
     /** PT → USDT swap handler. Required for `swap`. */
-    swapHandler: SwapHandler;
+    swapHandler?: SwapHandler | null;
     /** Orderly perp-deposit handler. Required for `perpDeposit`. */
-    perpHandler: PerpDepositHandler;
+    perpHandler?: PerpDepositHandler | null;
     /** Pending UserOp store — required for mobile prepare/submit. */
     pendingUserOpStore: IPendingUserOpStore;
     /** PAFI backend client — required for mobile submit + delegate submit + status fallback. */
@@ -2661,6 +2661,13 @@ declare class IssuerApiAdapter {
     private buildSponsorAuth;
     private runMobilePrepare;
     private assertRedeemHandler;
+    /**
+     * Narrow an optional handler to non-null and throw a clear error when
+     * the issuer wired the adapter without it. Lets issuers opt out of
+     * flows they don't expose (gg56 ships only mobile claim/redeem, so
+     * `swapHandler` + `perpHandler` aren't constructed).
+     */
+    private assertHandler;
 }
 
 /**

package/dist/index.d.ts

@@ -2457,13 +2457,13 @@ interface IssuerApiAdapterConfig {
     /** Optional issuer id — when omitted, sponsorAuth is skipped (returns `undefined`). */
     pafiIssuerId?: string;
     /** Sig-gated mint handler. Required for `claim` / `claimPrepare`. */
-    ptClaimHandler: PTClaimHandler;
+    ptClaimHandler?: PTClaimHandler | null;
     /** Reverse-flow handler. Required for `redeem` / `redeemPrepare`. */
     ptRedeemHandler?: PTRedeemHandler | null;
     /** PT → USDT swap handler. Required for `swap`. */
-    swapHandler: SwapHandler;
+    swapHandler?: SwapHandler | null;
     /** Orderly perp-deposit handler. Required for `perpDeposit`. */
-    perpHandler: PerpDepositHandler;
+    perpHandler?: PerpDepositHandler | null;
     /** Pending UserOp store — required for mobile prepare/submit. */
     pendingUserOpStore: IPendingUserOpStore;
     /** PAFI backend client — required for mobile submit + delegate submit + status fallback. */
@@ -2661,6 +2661,13 @@ declare class IssuerApiAdapter {
     private buildSponsorAuth;
     private runMobilePrepare;
     private assertRedeemHandler;
+    /**
+     * Narrow an optional handler to non-null and throw a clear error when
+     * the issuer wired the adapter without it. Lets issuers opt out of
+     * flows they don't expose (gg56 ships only mobile claim/redeem, so
+     * `swapHandler` + `perpHandler` aren't constructed).
+     */
+    private assertHandler;
 }
 
 /**

package/dist/index.js

@@ -2677,8 +2677,13 @@ var IssuerApiAdapter = class {
   }
   // ------------------------------ Action endpoints -------------------------
   async claim(input) {
+    const ptClaimHandler = this.assertHandler(
+      this.cfg.ptClaimHandler,
+      "ptClaimHandler",
+      "claim"
+    );
     const pointTokenAddress = getAddress10(input.pointTokenAddress);
-    const result = await this.cfg.ptClaimHandler.handle({
+    const result = await ptClaimHandler.handle({
       authenticatedAddress: input.authenticatedAddress,
       userAddress: input.authenticatedAddress,
       amount: input.amount,
@@ -2731,7 +2736,12 @@ var IssuerApiAdapter = class {
     };
   }
   async swap(input) {
-    const result = await this.cfg.swapHandler.handle({
+    const swapHandler = this.assertHandler(
+      this.cfg.swapHandler,
+      "swapHandler",
+      "swap"
+    );
+    const result = await swapHandler.handle({
       userAddress: input.authenticatedAddress,
       chainId: input.chainId,
       pointTokenAddress: getAddress10(input.pointTokenAddress),
@@ -2758,7 +2768,12 @@ var IssuerApiAdapter = class {
     };
   }
   async perpDeposit(input) {
-    const result = await this.cfg.perpHandler.handle({
+    const perpHandler = this.assertHandler(
+      this.cfg.perpHandler,
+      "perpHandler",
+      "perpDeposit"
+    );
+    const result = await perpHandler.handle({
       userAddress: input.authenticatedAddress,
       chainId: input.chainId,
       amount: input.amount,
@@ -2787,8 +2802,13 @@ var IssuerApiAdapter = class {
   }
   // ------------------------------ Mobile endpoints -------------------------
   async claimPrepare(input) {
+    const ptClaimHandler = this.assertHandler(
+      this.cfg.ptClaimHandler,
+      "ptClaimHandler",
+      "claimPrepare"
+    );
     const pointTokenAddress = getAddress10(input.pointTokenAddress);
-    const claimResult = await this.cfg.ptClaimHandler.handle({
+    const claimResult = await ptClaimHandler.handle({
       authenticatedAddress: input.authenticatedAddress,
       userAddress: input.authenticatedAddress,
       amount: input.amount,
@@ -2978,6 +2998,20 @@ var IssuerApiAdapter = class {
       );
     }
   }
+  /**
+   * Narrow an optional handler to non-null and throw a clear error when
+   * the issuer wired the adapter without it. Lets issuers opt out of
+   * flows they don't expose (gg56 ships only mobile claim/redeem, so
+   * `swapHandler` + `perpHandler` aren't constructed).
+   */
+  assertHandler(handler, fieldName, methodName) {
+    if (handler === null || handler === void 0) {
+      throw new Error(
+        `${fieldName} not wired \u2014 IssuerApiAdapter.${methodName}() requires a configured ${fieldName}.`
+      );
+    }
+    return handler;
+  }
 };
 
 // src/pools/subgraphPoolsProvider.ts