@subscrypts/subscrypts-sdk-react 1.6.0

package/dist/hooks/merchant/useMerchantPlans.d.ts

@@ -0,0 +1,30 @@
+import { UsePlansByMerchantReturn } from '../plans/usePlansByMerchant';
+
+/**
+ * Hook return type (re-exported from usePlansByMerchant)
+ */
+export type UseMerchantPlansReturn = UsePlansByMerchantReturn;
+/**
+ * Fetch all plans owned by the connected wallet.
+ *
+ * This is a convenience wrapper around usePlansByMerchant that uses
+ * the connected wallet address automatically.
+ *
+ * @example
+ * ```tsx
+ * const { plans, total, isLoading } = useMerchantPlans();
+ *
+ * return (
+ *   <div>
+ *     <h2>My Plans ({total})</h2>
+ *     {plans.map(plan => (
+ *       <div key={plan.id.toString()}>
+ *         {plan.description} - {plan.subscriberCount.toString()} subscribers
+ *       </div>
+ *     ))}
+ *   </div>
+ * );
+ * ```
+ */
+export declare function useMerchantPlans(): UseMerchantPlansReturn;
+//# sourceMappingURL=useMerchantPlans.d.ts.map

package/dist/hooks/merchant/useMerchantPlans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMerchantPlans.d.ts","sourceRoot":"","sources":["../../../src/hooks/merchant/useMerchantPlans.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAsB,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAE3F;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CAOzD"}

package/dist/hooks/merchant/useMerchantRevenue.d.ts

@@ -0,0 +1,59 @@
+/**
+ * useMerchantRevenue Hook
+ *
+ * Calculate Monthly Recurring Revenue (MRR) from active subscriptions.
+ */
+/**
+ * Merchant revenue data
+ */
+export interface MerchantRevenueData {
+    /** Total number of subscribers across all plans */
+    totalSubscribers: number;
+    /** Number of active subscribers */
+    activeSubscribers: number;
+    /** Monthly Recurring Revenue in SUBS (18 decimals) */
+    monthlyRecurringRevenue: bigint;
+    /** MRR formatted as SUBS string */
+    mrrFormatted: string;
+    /** MRR in USD (estimated using current SUBS price) */
+    mrrUsdEstimate: number | null;
+}
+/**
+ * Hook return type
+ */
+export interface UseMerchantRevenueReturn {
+    /** Revenue data (null if loading or error) */
+    revenue: MerchantRevenueData | null;
+    /** Loading state */
+    isLoading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Manually refresh revenue */
+    refetch: () => Promise<void>;
+}
+/**
+ * Calculate Monthly Recurring Revenue from active subscriptions.
+ *
+ * Fetches all subscriptions for the merchant's plans, filters for active ones,
+ * and calculates MRR by normalizing all subscriptions to monthly amounts.
+ *
+ * @param planIds - Optional array of plan IDs to calculate revenue for (defaults to all merchant plans)
+ *
+ * @example
+ * ```tsx
+ * const { revenue, isLoading } = useMerchantRevenue();
+ *
+ * if (revenue) {
+ *   return (
+ *     <div>
+ *       <h2>Revenue Dashboard</h2>
+ *       <p>MRR: {revenue.mrrFormatted} SUBS</p>
+ *       <p>≈ ${revenue.mrrUsdEstimate?.toFixed(2)}</p>
+ *       <p>{revenue.activeSubscribers} / {revenue.totalSubscribers} active</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useMerchantRevenue(planIds?: string[]): UseMerchantRevenueReturn;
+//# sourceMappingURL=useMerchantRevenue.d.ts.map

package/dist/hooks/merchant/useMerchantRevenue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMerchantRevenue.d.ts","sourceRoot":"","sources":["../../../src/hooks/merchant/useMerchantRevenue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,uBAAuB,EAAE,MAAM,CAAC;IAChC,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpC,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,wBAAwB,CAgI/E"}

package/dist/hooks/merchant/useMerchantSubscribers.d.ts

@@ -0,0 +1,54 @@
+import { Subscription } from '../../types';
+
+/**
+ * Hook return type
+ */
+export interface UseMerchantSubscribersReturn {
+    /** Array of subscriptions for current page */
+    subscribers: Subscription[];
+    /** Total number of subscriptions */
+    total: number;
+    /** Number of active subscriptions */
+    activeCount: number;
+    /** Current page (1-indexed) */
+    page: number;
+    /** Number of subscriptions per page */
+    pageSize: number;
+    /** Whether there are more pages */
+    hasMore: boolean;
+    /** Loading state */
+    isLoading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Go to next page */
+    nextPage: () => void;
+    /** Go to previous page */
+    prevPage: () => void;
+    /** Manually refresh subscriptions */
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetch paginated subscribers for a specific plan
+ *
+ * @param planId - Plan ID to fetch subscribers for
+ * @param pageSize - Number of subscriptions per page (default: 10)
+ *
+ * @example
+ * ```tsx
+ * const { subscribers, activeCount, total, page, hasMore, nextPage, prevPage, isLoading }
+ *   = useMerchantSubscribers('1');
+ *
+ * return (
+ *   <div>
+ *     <h3>{activeCount} active out of {total} total subscribers</h3>
+ *     {subscribers.map(sub => (
+ *       <SubscriptionCard key={sub.id} subscription={sub} />
+ *     ))}
+ *     <button onClick={prevPage} disabled={page === 1}>Previous</button>
+ *     <button onClick={nextPage} disabled={!hasMore}>Next</button>
+ *   </div>
+ * );
+ * ```
+ */
+export declare function useMerchantSubscribers(planId: string, pageSize?: number): UseMerchantSubscribersReturn;
+//# sourceMappingURL=useMerchantSubscribers.d.ts.map

package/dist/hooks/merchant/useMerchantSubscribers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMerchantSubscribers.d.ts","sourceRoot":"","sources":["../../../src/hooks/merchant/useMerchantSubscribers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,8CAA8C;IAC9C,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,qCAAqC;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAW,GACpB,4BAA4B,CA8G9B"}

package/dist/hooks/plans/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Plan Hooks
+ *
+ * React hooks for fetching subscription plan data from the smart contract.
+ */
+export { usePlan } from './usePlan';
+export type { UsePlanReturn } from './usePlan';
+export { usePlans } from './usePlans';
+export type { UsePlansReturn } from './usePlans';
+export { usePlansByMerchant } from './usePlansByMerchant';
+export type { UsePlansByMerchantReturn } from './usePlansByMerchant';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/plans/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/plans/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/hooks/plans/usePlan.d.ts

@@ -0,0 +1,33 @@
+import { Plan } from '../../types';
+
+/**
+ * Hook return type
+ */
+export interface UsePlanReturn {
+    /** Plan data (null if not found or loading) */
+    plan: Plan | null;
+    /** Loading state */
+    isLoading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Manually refresh plan data */
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetch a single plan by ID
+ *
+ * @param planId - Plan ID to fetch
+ *
+ * @example
+ * ```tsx
+ * const { plan, isLoading, error } = usePlan('1');
+ *
+ * if (isLoading) return <Spinner />;
+ * if (error) return <Error message={error.message} />;
+ * if (!plan) return <NotFound />;
+ *
+ * return <PlanDetails plan={plan} />;
+ * ```
+ */
+export declare function usePlan(planId: string): UsePlanReturn;
+//# sourceMappingURL=usePlan.d.ts.map

package/dist/hooks/plans/usePlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlan.d.ts","sourceRoot":"","sources":["../../../src/hooks/plans/usePlan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAInC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,iCAAiC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAmErD"}

package/dist/hooks/plans/usePlans.d.ts

@@ -0,0 +1,36 @@
+import { Plan } from '../../types';
+
+/**
+ * Hook return type
+ */
+export interface UsePlansReturn {
+    /** Array of plans (empty if loading or error) */
+    plans: Plan[];
+    /** Loading state */
+    isLoading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Manually refresh all plans */
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetch multiple plans by IDs
+ *
+ * @param planIds - Array of plan IDs to fetch
+ *
+ * @example
+ * ```tsx
+ * const { plans, isLoading, error } = usePlans(['1', '2', '3']);
+ *
+ * if (isLoading) return <Spinner />;
+ * if (error) return <Error message={error.message} />;
+ *
+ * return (
+ *   <div className="grid">
+ *     {plans.map(plan => <PlanCard key={plan.id.toString()} plan={plan} />)}
+ *   </div>
+ * );
+ * ```
+ */
+export declare function usePlans(planIds: string[]): UsePlansReturn;
+//# sourceMappingURL=usePlans.d.ts.map

package/dist/hooks/plans/usePlans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlans.d.ts","sourceRoot":"","sources":["../../../src/hooks/plans/usePlans.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAInC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,iCAAiC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,cAAc,CA0E1D"}

package/dist/hooks/plans/usePlansByMerchant.d.ts

@@ -0,0 +1,35 @@
+import { Plan } from '../../types';
+
+/**
+ * Hook return type
+ */
+export interface UsePlansByMerchantReturn {
+    /** Plans created by the merchant */
+    plans: Plan[];
+    /** Total matching plans */
+    total: number;
+    /** Loading state */
+    isLoading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Manually refresh data */
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetch all plans created by a specific merchant address.
+ *
+ * Fetches all plans from the contract and filters client-side by merchantAddress.
+ *
+ * @param merchantAddress - Ethereum address of the merchant
+ *
+ * @example
+ * ```tsx
+ * const { plans, total, isLoading } = usePlansByMerchant('0x1234...');
+ *
+ * plans.forEach(plan => {
+ *   console.log(plan.description, plan.subscriberCount);
+ * });
+ * ```
+ */
+export declare function usePlansByMerchant(merchantAddress: string): UsePlansByMerchantReturn;
+//# sourceMappingURL=usePlansByMerchant.d.ts.map

package/dist/hooks/plans/usePlansByMerchant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlansByMerchant.d.ts","sourceRoot":"","sources":["../../../src/hooks/plans/usePlansByMerchant.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,wBAAwB,CAyEpF"}

package/dist/hooks/pricing/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Pricing Hooks
+ *
+ * React hooks for fetching price data from on-chain oracles.
+ */
+export { useSUBSPrice } from './useSUBSPrice';
+export type { UseSUBSPriceReturn } from './useSUBSPrice';
+export { usePlanPrice } from './usePlanPrice';
+export type { UsePlanPriceReturn, PlanPriceInfo } from './usePlanPrice';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/pricing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/pricing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/hooks/pricing/usePlanPrice.d.ts

@@ -0,0 +1,59 @@
+/**
+ * usePlanPrice Hook
+ *
+ * Comprehensive price information for a subscription plan,
+ * including SUBS, USDC, and USD-equivalent prices.
+ */
+/**
+ * Comprehensive price information for a plan
+ */
+export interface PlanPriceInfo {
+    /** Price in SUBS (18 decimals) */
+    subsAmount: bigint;
+    /** Formatted SUBS amount */
+    subsFormatted: string;
+    /** USDC equivalent (6 decimals), null if quote unavailable */
+    usdcAmount: bigint | null;
+    /** Formatted USDC amount, null if quote unavailable */
+    usdcFormatted: string | null;
+    /** USD display value, null if price unavailable */
+    usdValue: number | null;
+    /** Payment frequency label */
+    frequency: string;
+    /** Whether the plan is USD-denominated (currencyCode=1) */
+    isUsdDenominated: boolean;
+}
+/**
+ * Hook return type
+ */
+export interface UsePlanPriceReturn {
+    /** Price information (null if not loaded) */
+    price: PlanPriceInfo | null;
+    /** Loading state */
+    isLoading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Manually refresh price */
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetch comprehensive price information for a subscription plan.
+ *
+ * Resolves SUBS amount, USDC equivalent (via Uniswap), and USD value
+ * for both SUBS-denominated and USD-denominated plans.
+ *
+ * @param planId - Plan ID to fetch pricing for
+ * @param refreshInterval - Refresh interval in ms (default: 60000)
+ *
+ * @example
+ * ```tsx
+ * const { price, isLoading } = usePlanPrice('1');
+ *
+ * if (price) {
+ *   console.log(`${price.subsFormatted} SUBS / ${price.frequency}`);
+ *   if (price.usdValue) console.log(`≈ $${price.usdValue.toFixed(2)}`);
+ * }
+ * ```
+ */
+export declare function usePlanPrice(planId: string, refreshInterval?: number): UsePlanPriceReturn;
+//# sourceMappingURL=usePlanPrice.d.ts.map

package/dist/hooks/pricing/usePlanPrice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlanPrice.d.ts","sourceRoot":"","sources":["../../../src/hooks/pricing/usePlanPrice.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uDAAuD;IACvD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAwBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,eAAe,GAAE,MAAiC,GACjD,kBAAkB,CAwHpB"}

package/dist/hooks/pricing/useSUBSPrice.d.ts

@@ -0,0 +1,39 @@
+/**
+ * useSUBSPrice Hook
+ *
+ * Fetch the current SUBS token price in USD from the on-chain oracle.
+ */
+/**
+ * Hook return type
+ */
+export interface UseSUBSPriceReturn {
+    /** Price of 1 SUBS in USD (null if not loaded) */
+    priceUsd: number | null;
+    /** Raw price from contract (null if not loaded) */
+    rawPrice: bigint | null;
+    /** Loading state */
+    isLoading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Manually refresh price */
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetch the current SUBS/USD price from the on-chain oracle.
+ *
+ * Uses `convertTokenToOtherCurrency(1e18)` to get the USD value of 1 SUBS.
+ * Auto-refreshes every 60 seconds.
+ *
+ * @param refreshInterval - Refresh interval in ms (default: 60000)
+ *
+ * @example
+ * ```tsx
+ * const { priceUsd, isLoading } = useSUBSPrice();
+ *
+ * if (priceUsd) {
+ *   console.log(`1 SUBS = $${priceUsd.toFixed(4)}`);
+ * }
+ * ```
+ */
+export declare function useSUBSPrice(refreshInterval?: number): UseSUBSPriceReturn;
+//# sourceMappingURL=useSUBSPrice.d.ts.map

package/dist/hooks/pricing/useSUBSPrice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSUBSPrice.d.ts","sourceRoot":"","sources":["../../../src/hooks/pricing/useSUBSPrice.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAQD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,eAAe,GAAE,MAAiC,GAAG,kBAAkB,CA8DnG"}

package/dist/hooks/subscriptions/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Subscription hooks exports
+ */
+export { useSubscriptionStatus } from './useSubscriptionStatus';
+export type { UseSubscriptionStatusReturn } from './useSubscriptionStatus';
+export { useSubscribe } from './useSubscribe';
+export type { UseSubscribeReturn, SubscribeParams } from './useSubscribe';
+export { useManageSubscription } from './useManageSubscription';
+export type { UseManageSubscriptionReturn } from './useManageSubscription';
+export { useMySubscriptions } from './useMySubscriptions';
+export type { UseMySubscriptionsReturn } from './useMySubscriptions';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/subscriptions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/subscriptions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/hooks/subscriptions/useManageSubscription.d.ts

@@ -0,0 +1,39 @@
+import { TransactionState } from '../../types';
+
+/**
+ * Hook return type
+ */
+export interface UseManageSubscriptionReturn {
+    /** Cancel subscription (disables auto-renew and sets 0 remaining cycles) */
+    cancelSubscription: () => Promise<void>;
+    /** Toggle auto-renewal on/off */
+    toggleAutoRenew: (enabled: boolean) => Promise<void>;
+    /** Update remaining payment cycles */
+    updateCycles: (cycles: number) => Promise<void>;
+    /** Update subscription custom attributes */
+    updateAttributes: (attributes: string) => Promise<void>;
+    /** Current transaction state */
+    txState: TransactionState;
+    /** Error if any */
+    error: Error | null;
+    /** Whether a transaction is in progress */
+    isProcessing: boolean;
+}
+/**
+ * Manage an existing subscription.
+ *
+ * @param subscriptionId - The subscription ID to manage
+ *
+ * @example
+ * ```tsx
+ * const { cancelSubscription, toggleAutoRenew, isProcessing } = useManageSubscription('42');
+ *
+ * // Cancel subscription
+ * await cancelSubscription();
+ *
+ * // Toggle auto-renewal
+ * await toggleAutoRenew(false);
+ * ```
+ */
+export declare function useManageSubscription(subscriptionId: string): UseManageSubscriptionReturn;
+//# sourceMappingURL=useManageSubscription.d.ts.map

package/dist/hooks/subscriptions/useManageSubscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useManageSubscription.d.ts","sourceRoot":"","sources":["../../../src/hooks/subscriptions/useManageSubscription.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,4EAA4E;IAC5E,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,iCAAiC;IACjC,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,sCAAsC;IACtC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,4CAA4C;IAC5C,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,gCAAgC;IAChC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,mBAAmB;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,2CAA2C;IAC3C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,2BAA2B,CAuIzF"}

package/dist/hooks/subscriptions/useMySubscriptions.d.ts

@@ -0,0 +1,53 @@
+import { Subscription } from '../../types';
+
+/**
+ * Hook return type
+ */
+export interface UseMySubscriptionsReturn {
+    /** Array of subscriptions for current page */
+    subscriptions: Subscription[];
+    /** Total number of subscriptions */
+    total: number;
+    /** Current page (1-indexed) */
+    page: number;
+    /** Number of subscriptions per page */
+    pageSize: number;
+    /** Whether there are more pages */
+    hasMore: boolean;
+    /** Loading state */
+    isLoading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Go to next page */
+    nextPage: () => void;
+    /** Go to previous page */
+    prevPage: () => void;
+    /** Manually refresh subscriptions */
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetch paginated subscriptions for a wallet address
+ *
+ * @param address - Optional address to fetch subscriptions for (defaults to connected wallet)
+ * @param pageSize - Number of subscriptions per page (default: 10)
+ * @param planIds - Optional array of plan IDs to check (recommended for reliability)
+ *
+ * @example
+ * ```tsx
+ * // Get all subscriptions (tries getSubscriptionsByAddress, up to 100 subs)
+ * const { subscriptions, isLoading } = useMySubscriptions();
+ *
+ * // Filter to specific plans + fallback if getSubscriptionsByAddress fails
+ * const { subscriptions, isLoading } = useMySubscriptions(undefined, 10, ['1', '2', '3']);
+ *
+ * if (isLoading) return <Spinner />;
+ *
+ * return (
+ *   <div>
+ *     {subscriptions.map(sub => <SubscriptionCard key={sub.id} subscription={sub} />)}
+ *   </div>
+ * );
+ * ```
+ */
+export declare function useMySubscriptions(address?: string, pageSize?: number, planIds?: string[]): UseMySubscriptionsReturn;
+//# sourceMappingURL=useMySubscriptions.d.ts.map

package/dist/hooks/subscriptions/useMySubscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMySubscriptions.d.ts","sourceRoot":"","sources":["../../../src/hooks/subscriptions/useMySubscriptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,YAAY,EAAwB,MAAM,aAAa,CAAC;AAuBjE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,qCAAqC;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAW,EACrB,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,wBAAwB,CA6I1B"}

package/dist/hooks/subscriptions/useSubscribe.d.ts

@@ -0,0 +1,58 @@
+import { PaymentMethod } from '../../types';
+
+/**
+ * Subscription parameters
+ */
+export interface SubscribeParams {
+    /** Plan ID to subscribe to */
+    planId: string;
+    /** Number of payment cycles */
+    cycleLimit: number;
+    /** Enable auto-renewal */
+    autoRenew: boolean;
+    /** Payment method: SUBS or USDC */
+    paymentMethod: PaymentMethod;
+    /** Referral address (optional) */
+    referralAddress?: string;
+}
+/**
+ * Hook return type
+ */
+export interface UseSubscribeReturn {
+    /** Execute subscription */
+    subscribe: (params: SubscribeParams) => Promise<string>;
+    /** Transaction is in progress */
+    isSubscribing: boolean;
+    /** Current transaction state */
+    txState: 'idle' | 'approving' | 'waiting_approval' | 'subscribing' | 'waiting_subscribe' | 'success' | 'error';
+    /** Error if any */
+    error: Error | null;
+    /** Transaction hash */
+    txHash: string | null;
+    /** Subscription ID (available after success) */
+    subscriptionId: string | null;
+}
+/**
+ * Hook to execute subscription transactions
+ *
+ * @example
+ * ```tsx
+ * const { subscribe, isSubscribing, txState, error } = useSubscribe();
+ *
+ * const handleSubscribe = async () => {
+ *   try {
+ *     const subId = await subscribe({
+ *       planId: '1',
+ *       cycleLimit: 12,
+ *       autoRenew: true,
+ *       paymentMethod: 'SUBS'
+ *     });
+ *     console.log('Subscription ID:', subId);
+ *   } catch (error) {
+ *     console.error('Failed:', error);
+ *   }
+ * };
+ * ```
+ */
+export declare function useSubscribe(): UseSubscribeReturn;
+//# sourceMappingURL=useSubscribe.d.ts.map

package/dist/hooks/subscriptions/useSubscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubscribe.d.ts","sourceRoot":"","sources":["../../../src/hooks/subscriptions/useSubscribe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAU5C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,kCAAkC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,iCAAiC;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,gCAAgC;IAChC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,kBAAkB,GAAG,aAAa,GAAG,mBAAmB,GAAG,SAAS,GAAG,OAAO,CAAC;IAC/G,mBAAmB;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,uBAAuB;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gDAAgD;IAChD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,IAAI,kBAAkB,CAiXjD"}

package/dist/hooks/subscriptions/useSubscriptionStatus.d.ts

@@ -0,0 +1,34 @@
+import { SubscriptionStatus } from '../../types';
+
+/**
+ * Hook return type
+ */
+export interface UseSubscriptionStatusReturn {
+    /** Subscription status (null if not found) */
+    status: SubscriptionStatus | null;
+    /** Loading state */
+    isLoading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Manually refresh subscription status */
+    refetch: () => Promise<void>;
+}
+/**
+ * Check subscription status for a specific plan
+ *
+ * @param planId - Plan ID to check
+ * @param subscriber - Optional subscriber address (defaults to connected wallet)
+ *
+ * @example
+ * ```tsx
+ * const { status, isLoading, error } = useSubscriptionStatus('1');
+ *
+ * if (isLoading) return <Spinner />;
+ * if (error) return <Error message={error.message} />;
+ * if (!status?.isActive) return <Subscribe />;
+ *
+ * return <PremiumContent />;
+ * ```
+ */
+export declare function useSubscriptionStatus(planId: string, subscriber?: string): UseSubscriptionStatusReturn;
+//# sourceMappingURL=useSubscriptionStatus.d.ts.map

package/dist/hooks/subscriptions/useSubscriptionStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubscriptionStatus.d.ts","sourceRoot":"","sources":["../../../src/hooks/subscriptions/useSubscriptionStatus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,kBAAkB,EAAwB,MAAM,aAAa,CAAC;AAIvE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,8CAA8C;IAC9C,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAClC,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,2BAA2B,CA8I7B"}

package/dist/hooks/tokens/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Token hooks exports
+ */
+export { useTokenBalance } from './useTokenBalance';
+export type { UseTokenBalanceReturn, TokenType } from './useTokenBalance';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/tokens/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/tokens/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}