react-native-iap 15.2.0 → 15.2.2

package/lib/module/webhook-client.js

@@ -0,0 +1,164 @@
+"use strict";
+
+// Transport-agnostic webhook client for the openiap kit SSE stream
+// (`GET /v1/webhooks/stream/{apiKey}`). Used by the JavaScript / TS
+// wrappers (react-native-iap, expo-iap) but written without React or
+// React-Native imports so it can also run in plain Node, browser, or
+// any other JS runtime.
+//
+// The wire format is documented in `packages/kit/server/api/v1/webhooks.ts`
+// and matches the GraphQL `WebhookEvent` shape from `webhook.graphql`.
+//
+// Parser logic is split out from the connection so it can be unit-
+// tested without a live server. See `webhook-client.test.ts`.
+
+export const WEBHOOK_EVENT_TYPES = ["SubscriptionStarted", "SubscriptionRenewed", "SubscriptionExpired", "SubscriptionInGracePeriod", "SubscriptionInBillingRetry", "SubscriptionRecovered", "SubscriptionCanceled", "SubscriptionUncanceled", "SubscriptionRevoked", "SubscriptionPriceChange", "SubscriptionProductChanged", "SubscriptionPaused", "SubscriptionResumed", "PurchaseRefunded", "PurchaseConsumptionRequest", "TestNotification"];
+const DEFAULT_BASE_URL = "https://kit.openiap.dev";
+export function connectWebhookStream(options) {
+  const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+  const url = `${trimTrailingSlash(baseUrl)}/v1/webhooks/stream/${encodeURIComponent(options.apiKey)}`;
+  const factory = options.eventSourceFactory ?? defaultEventSourceFactory;
+  let stream;
+  try {
+    stream = factory(url, {});
+  } catch (error) {
+    options.onError?.({
+      code: "NO_EVENTSOURCE",
+      message: error instanceof Error ? error.message : "EventSource constructor unavailable in this runtime",
+      cause: error
+    });
+    return {
+      close: () => {}
+    };
+  }
+  const seenIds = new Set();
+  const seenOrder = [];
+  const markSeen = id => {
+    if (seenIds.has(id)) {
+      return true;
+    }
+    seenIds.add(id);
+    seenOrder.push(id);
+    if (seenOrder.length > 1024) {
+      const evicted = seenOrder.shift();
+      if (evicted !== undefined) {
+        seenIds.delete(evicted);
+      }
+    }
+    return false;
+  };
+  const handleData = raw => {
+    const parsed = parseWebhookEventData(raw);
+    if (parsed.kind === "error") {
+      options.onError?.({
+        code: "PARSE_ERROR",
+        message: parsed.message
+      });
+      return;
+    }
+    if (parsed.kind === "skip") {
+      return;
+    }
+    if (markSeen(parsed.event.id)) {
+      return;
+    }
+    options.onEvent(parsed.event);
+  };
+  if (typeof stream.addEventListener === "function") {
+    stream.addEventListener("message", event => handleData(event.data));
+    // WHATWG EventSource dispatches frames with `event: Foo` only to
+    // listeners registered for `Foo`, not to `message` / `onmessage`.
+    // Kit emits webhook frames as typed SSE events, so subscribe to
+    // every known webhook type and keep `message` for older servers or
+    // polyfills that collapse typed frames into the generic channel.
+    for (const eventType of WEBHOOK_EVENT_TYPES) {
+      stream.addEventListener(eventType, event => handleData(event.data));
+    }
+  } else {
+    stream.onmessage = event => handleData(event.data);
+  }
+  stream.onerror = error => {
+    options.onError?.({
+      code: "TRANSPORT_ERROR",
+      message: "SSE transport error (auto-reconnecting)",
+      cause: error
+    });
+  };
+  return {
+    close: () => {
+      try {
+        stream.close();
+      } catch {
+        // Closing an already-closed EventSource is a no-op in browsers
+        // but throws in some polyfills.
+      }
+    }
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Pure helpers (exported for testing).
+// ---------------------------------------------------------------------------
+
+export function parseWebhookEventData(raw) {
+  if (!raw) {
+    return {
+      kind: "skip",
+      reason: "heartbeat"
+    };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    return {
+      kind: "error",
+      message: error instanceof Error ? `Failed to parse SSE payload: ${error.message}` : "Failed to parse SSE payload"
+    };
+  }
+  if (typeof parsed !== "object" || parsed === null || !("type" in parsed) || typeof parsed.type !== "string") {
+    // Stream-control messages (the `ready`/`stream-error` envelopes
+    // emitted by the kit server) have no `type` and are surfaced as
+    // skips so consumers don't see them as events.
+    return {
+      kind: "skip",
+      reason: "stream-control"
+    };
+  }
+  const event = parsed;
+  if (typeof event.id !== "string" || typeof event.occurredAt !== "number" || typeof event.receivedAt !== "number") {
+    return {
+      kind: "error",
+      message: `WebhookEvent missing required fields (id/occurredAt/receivedAt)`
+    };
+  }
+  // purchaseToken is required for every event type *except*
+  // TestNotification — Apple ASN v2 / Google RTDN test payloads
+  // carry no transaction. Hard-rejecting here would surface valid
+  // test webhooks as MALFORMED_EVENT and never reach listeners.
+  if (event.type !== "TestNotification" && typeof event.purchaseToken !== "string") {
+    return {
+      kind: "error",
+      message: `WebhookEvent missing required field purchaseToken`
+    };
+  }
+  return {
+    kind: "ok",
+    event
+  };
+}
+function trimTrailingSlash(url) {
+  return url.endsWith("/") ? url.slice(0, -1) : url;
+}
+function defaultEventSourceFactory(url, _headers) {
+  // EventSource is part of the WHATWG spec and available in all
+  // browser environments and most JS runtimes (Bun, Node 22+, Deno).
+  // RN does not ship it natively — consumers must pass
+  // `eventSourceFactory` from `react-native-sse` or similar.
+  const ctor = globalThis.EventSource;
+  if (!ctor) {
+    throw new Error("EventSource is not defined. Pass `eventSourceFactory` for runtimes without a built-in EventSource.");
+  }
+  return new ctor(url);
+}
+//# sourceMappingURL=webhook-client.js.map

package/lib/module/webhook-client.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["WEBHOOK_EVENT_TYPES","DEFAULT_BASE_URL","connectWebhookStream","options","baseUrl","url","trimTrailingSlash","encodeURIComponent","apiKey","factory","eventSourceFactory","defaultEventSourceFactory","stream","error","onError","code","message","Error","cause","close","seenIds","Set","seenOrder","markSeen","id","has","add","push","length","evicted","shift","undefined","delete","handleData","raw","parsed","parseWebhookEventData","kind","event","onEvent","addEventListener","data","eventType","onmessage","onerror","reason","JSON","parse","type","occurredAt","receivedAt","purchaseToken","endsWith","slice","_headers","ctor","globalThis","EventSource"],"sourceRoot":"../../src","sources":["webhook-client.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/plugin/src/withIAP.d.ts

@@ -34,7 +34,7 @@ type IapPluginProps = {
     /**
      * IAPKit API key for purchase verification.
      * This key will be added to AndroidManifest.xml (as meta-data) and Info.plist.
-     * Get your API key from https://iapkit.com
+     * Get your API key from https://kit.openiap.dev
      */
     iapkitApiKey?: string;
 };

package/lib/typescript/src/hooks/useIAP.d.ts

@@ -8,25 +8,170 @@ type UseIap = {
     availablePurchases: Purchase[];
     promotedProductIOS?: Product;
     activeSubscriptions: ActiveSubscription[];
+    /**
+     * Complete a purchase transaction. Call after server-side verification to remove it
+     * from the queue.
+     *
+     * @param args.purchase The `Purchase` to finalize.
+     * @param args.isConsumable `true` for consumables (consumes the token so the SKU can be
+     *   re-bought, e.g. coins); `false` (default) for non-consumables and subscriptions.
+     * @returns Promise that resolves once the platform finalizes the transaction.
+     * @throws When the platform finalize call fails.
+     *
+     * @example
+     * ```ts
+     * purchaseUpdatedListener(async (purchase) => {
+     *   if (await verifyOnServer(purchase)) {
+     *     await finishTransaction({ purchase, isConsumable: false });
+     *   }
+     * });
+     * ```
+     *
+     * @remarks **Critical:** Android purchases must be finalized within 3 days or Google
+     *   auto-refunds. iOS unfinished transactions replay on every app launch.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/finish-transaction}
+     */
     finishTransaction: (args: MutationFinishTransactionArgs) => Promise<void>;
+    /**
+     * List the user's unfinished purchases — non-consumables, active subscriptions, and any
+     * pending transactions not yet finished.
+     *
+     * @param options Optional `PurchaseOptions`.
+     *   - iOS: `alsoPublishToEventListenerIOS`, `onlyIncludeActiveItemsIOS`.
+     *   - Android: `includeSuspendedAndroid` (include subscriptions in a paused/grace state).
+     * @returns Promise that resolves when the request is dispatched; results land in the
+     *   hook's reactive `availablePurchases` state — read from there, don't expect a return value.
+     * @throws When the platform query fails.
+     *
+     * @example
+     * ```ts
+     * const { availablePurchases, getAvailablePurchases, finishTransaction } = useIAP();
+     *
+     * useEffect(() => {
+     *   void getAvailablePurchases();
+     * }, [getAvailablePurchases]);
+     *
+     * useEffect(() => {
+     *   for (const p of availablePurchases) {
+     *     void verifyOnServer(p).then((ok) => {
+     *       if (ok) finishTransaction({ purchase: p, isConsumable: false });
+     *     });
+     *   }
+     * }, [availablePurchases, finishTransaction]);
+     * ```
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/get-available-purchases}
+     */
     getAvailablePurchases: (options?: PurchaseOptions) => Promise<void>;
+    /**
+     * Retrieve products or subscriptions from the store by SKU.
+     *
+     * @param params `ProductRequest` — `skus` (string[]) and optional `type`
+     *   (`'in-app' | 'subs' | 'all'`, defaults to `'in-app'`).
+     * @returns Promise that resolves when the request is dispatched; results land in the
+     *   hook's reactive `products` / `subscriptions` state — read from there, don't expect a return value.
+     * @throws When the store rejects the request (empty `skus`, not connected,
+     *   network/store error). Unknown SKUs are simply omitted from the result, not thrown.
+     *
+     * @example
+     * ```ts
+     * const { products, fetchProducts } = useIAP();
+     *
+     * useEffect(() => {
+     *   void fetchProducts({
+     *     skus: ['com.app.coins_100', 'com.app.premium'],
+     *     type: 'in-app',
+     *   });
+     * }, [fetchProducts]);
+     *
+     * // Render `products` directly from hook state.
+     * ```
+     *
+     * @remarks This is a regular promise-based call. Don't confuse with `request*` APIs
+     *   (`requestPurchase`), which are event-based.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/fetch-products}
+     */
     fetchProducts: (params: {
         skus: string[];
         type?: ProductQueryType | null;
     }) => Promise<void>;
+    /**
+     * Initiate a purchase or subscription flow. The result is delivered through
+     * `purchaseUpdatedListener` — NOT the return value.
+     *
+     * @param props `RequestPurchaseProps`, discriminated by `type`:
+     *   - `type: 'in-app'` — pass `request.apple.sku` (iOS) and/or `request.google.skus` (Android).
+     *   - `type: 'subs'`  — same shape, plus `request.google.subscriptionOffers: [{ sku, offerToken }]`.
+     * @returns Promise that resolves when the request is dispatched; results land in the
+     *   hook's `onPurchaseSuccess` / `onPurchaseError` callbacks.
+     * @throws Synchronous rejection from the store (e.g. `E_NOT_PREPARED`, validation failure).
+     *
+     * @example
+     * ```ts
+     * await requestPurchase({
+     *   request: {
+     *     apple: { sku: 'com.app.premium' },
+     *     google: { skus: ['com.app.premium'] },
+     *   },
+     *   type: 'in-app',
+     * });
+     * ```
+     *
+     * @remarks Event-based. Listen for the result via {@link purchaseUpdatedListener} /
+     *   {@link purchaseErrorListener}, or use `useIAP({ onPurchaseSuccess, onPurchaseError })`.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/request-purchase}
+     */
     requestPurchase: (params: RequestPurchaseProps) => Promise<void>;
     /**
      * @deprecated Use `verifyPurchase` instead. This function will be removed in a future version.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/validate-receipt}
      */
     validateReceipt: (options: VerifyPurchaseProps) => Promise<VerifyPurchaseResult>;
-    /** Verify purchase with the configured providers */
+    /**
+     * Verify a purchase against your own backend (returns isValid + raw store metadata).
+     *
+     * @see {@link https://www.openiap.dev/docs/features/validation#verify-purchase}
+     */
     verifyPurchase: (options: VerifyPurchaseProps) => Promise<VerifyPurchaseResult>;
-    /** Verify purchase with a specific provider (e.g., IAPKit) */
+    /**
+     * Verify via a managed provider — currently only `iapkit` (IAPKit). The PurchaseVerificationProvider enum exposes no other provider literal today.
+     *
+     * @see {@link https://www.openiap.dev/docs/features/validation#verify-purchase-with-provider}
+     */
     verifyPurchaseWithProvider: (options: VerifyPurchaseWithProviderProps) => Promise<VerifyPurchaseWithProviderResult>;
+    /**
+     * Restore non-consumable and active subscription purchases.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/restore-purchases}
+     */
     restorePurchases: (options?: PurchaseOptions) => Promise<void>;
+    /**
+     * Read the App Store-promoted product, if any.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/ios/get-promoted-product-ios}
+     */
     getPromotedProductIOS: () => Promise<Product | null>;
+    /**
+     * Buy the currently promoted product.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/ios/request-purchase-on-promoted-product-ios}
+     */
     requestPurchaseOnPromotedProductIOS: () => Promise<boolean>;
+    /**
+     * Get details of all currently active subscriptions.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/get-active-subscriptions}
+     */
     getActiveSubscriptions: (subscriptionIds?: string[]) => Promise<ActiveSubscription[]>;
+    /**
+     * Check whether the user has any active subscription.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/has-active-subscriptions}
+     */
     hasActiveSubscriptions: (subscriptionIds?: string[]) => Promise<boolean>;
     /**
      * Manually retry the store connection.
@@ -34,8 +179,23 @@ type UseIap = {
      * Updates the `connected` state on success.
      */
     reconnect: () => Promise<boolean>;
+    /**
+     * Check whether alternative billing is available for the user.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/android/check-alternative-billing-availability-android}
+     */
     checkAlternativeBillingAvailabilityAndroid?: () => Promise<boolean>;
+    /**
+     * Display Google's alternative billing information dialog.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/android/show-alternative-billing-dialog-android}
+     */
     showAlternativeBillingDialogAndroid?: () => Promise<boolean>;
+    /**
+     * Create a reporting token for an alternative billing flow.
+     *
+     * @see {@link https://www.openiap.dev/docs/apis/android/create-alternative-billing-token-android}
+     */
     createAlternativeBillingTokenAndroid?: (sku?: string) => Promise<string | null>;
 };
 export interface UseIapOptions {

package/lib/typescript/src/hooks/useIAP.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useIAP.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useIAP.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,6BAA6B,EAC7B,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,+BAA+B,EAC/B,gCAAgC,EAChC,eAAe,EAChB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EACV,kBAAkB,EAClB,OAAO,EACP,QAAQ,EACR,aAAa,EACb,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,UAAU,CAAC;AAO5D,KAAK,MAAM,GAAG;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,kBAAkB,EAAE,QAAQ,EAAE,CAAC;IAC/B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,iBAAiB,EAAE,CAAC,IAAI,EAAE,6BAA6B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,qBAAqB,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,aAAa,EAAE,CAAC,MAAM,EAAE;QACtB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;KAChC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,eAAe,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE;;OAEG;IACH,eAAe,EAAE,CACf,OAAO,EAAE,mBAAmB,KACzB,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,oDAAoD;IACpD,cAAc,EAAE,CACd,OAAO,EAAE,mBAAmB,KACzB,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,8DAA8D;IAC9D,0BAA0B,EAAE,CAC1B,OAAO,EAAE,+BAA+B,KACrC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC/C,gBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,qBAAqB,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACrD,mCAAmC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,sBAAsB,EAAE,CACtB,eAAe,CAAC,EAAE,MAAM,EAAE,KACvB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACnC,sBAAsB,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE;;;;OAIG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAElC,0CAA0C,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,mCAAmC,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,oCAAoC,CAAC,EAAE,CACrC,GAAG,CAAC,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACjD,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACjD,oFAAoF;IACpF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,0BAA0B,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACzE;;;;;;;;OAQG;IACH,0BAA0B,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC1D;;;;OAIG;IACH,6BAA6B,CAAC,EAAE,6BAA6B,CAAC;IAC9D;;;;;OAKG;IACH,2BAA2B,CAAC,EAAE,qBAAqB,CAAC;CACrD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAwctD"}
+{"version":3,"file":"useIAP.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useIAP.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/hooks/useWebhookEvents.d.ts

@@ -0,0 +1,55 @@
+import { type WebhookEventPayload, type WebhookEventStream, type WebhookListenerError } from '../webhook-client';
+export type UseWebhookEventsOptions = {
+    /**
+     * kit project API key — same value used for receipt verification.
+     * Must be non-empty to start the stream; pass `null`/`undefined` to
+     * disable the listener (e.g. before the user is logged in).
+     */
+    apiKey: string | null | undefined;
+    /**
+     * Override the kit base URL. Defaults to https://kit.openiap.dev.
+     */
+    baseUrl?: string;
+    /**
+     * Optional EventSource factory. Required on React Native because RN
+     * does not ship a global EventSource — pass an instance from
+     * `react-native-sse` (or any compatible polyfill).
+     */
+    eventSourceFactory?: (url: string, headers: Record<string, string>) => WebhookEventStream;
+    /**
+     * Maximum number of events to retain in the in-memory ring buffer
+     * surfaced as `events`. Older entries are discarded. Defaults to 50.
+     * Set 0 to opt out of the buffer entirely (consume only via
+     * `onEvent`).
+     */
+    bufferSize?: number;
+    /**
+     * Called for every received event in addition to being appended to
+     * the buffer. Useful for side effects (toast, analytics, granting
+     * entitlement). Called with the latest stable callback identity.
+     */
+    onEvent?: (event: WebhookEventPayload) => void;
+    /**
+     * Called when the stream surfaces a transport / parse error.
+     * EventSource auto-reconnects regardless of this hook — this is
+     * primarily for telemetry + UI surfacing.
+     */
+    onError?: (error: WebhookListenerError) => void;
+};
+export type UseWebhookEventsResult = {
+    /** Most recent N events (most-recent-first). Capped at bufferSize. */
+    events: WebhookEventPayload[];
+    /** Last error reported by the underlying stream. Null when healthy. */
+    lastError: WebhookListenerError | null;
+    /**
+     * True once the first webhook event has been received from the
+     * stream. Remains false if the connection is open but idle (the
+     * underlying SSE bridge doesn't surface a "stream opened"
+     * lifecycle event we can hook into; isConnected is therefore an
+     * activity indicator, not a raw socket-state flag). Reset to
+     * false on cleanup / apiKey change.
+     */
+    isConnected: boolean;
+};
+export declare function useWebhookEvents({ apiKey, baseUrl, eventSourceFactory, bufferSize, onEvent, onError, }: UseWebhookEventsOptions): UseWebhookEventsResult;
+//# sourceMappingURL=useWebhookEvents.d.ts.map

package/lib/typescript/src/hooks/useWebhookEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWebhookEvents.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useWebhookEvents.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAEvB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CACnB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC5B,kBAAkB,CAAC;IACxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC/C;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,sEAAsE;IACtE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,uEAAuE;IACvE,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACvC;;;;;;;OAOG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAaF,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,OAAO,EACP,kBAAkB,EAClB,UAAe,EACf,OAAO,EACP,OAAO,GACR,EAAE,uBAAuB,GAAG,sBAAsB,CA8FlD"}