@umituz/web-polar-payment 1.0.18 → 1.0.20

package/dist/index.d.mts

@@ -76,6 +76,89 @@ interface PolarContextValue {
 }
 declare function usePolarBilling(): PolarContextValue;
 
+/**
+ * Product Entity
+ *
+ * Represents a Polar.sh product with pricing information
+ */
+type RecurringInterval = 'day' | 'week' | 'month' | 'year';
+type PriceType = 'fixed' | 'custom' | 'free' | 'seat_based' | 'metered_unit';
+interface PolarPrice {
+    id: string;
+    type: PriceType;
+    amount_type: string;
+    amount?: number;
+    currency: string;
+    recurring_interval?: RecurringInterval;
+    is_archived: boolean;
+    product_id: string;
+    legacy?: boolean;
+}
+interface PolarProduct {
+    id: string;
+    name: string;
+    description: string | null;
+    is_recurring: boolean;
+    recurring_interval: RecurringInterval | null;
+    is_archived: boolean;
+    organization_id: string;
+    prices: PolarPrice[];
+    benefits: Array<{
+        id: string;
+        type: string;
+        description: string | null;
+        properties: Record<string, unknown>;
+    }>;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    modified_at: string | null;
+}
+interface ProductListResponse {
+    items: PolarProduct[];
+    pagination: {
+        total_count: number;
+        max_page: number;
+    };
+}
+interface ProductListParams {
+    organizationId?: string;
+    isRecurring?: boolean;
+    page?: number;
+    limit?: number;
+}
+
+/**
+ * usePolarProducts Hook
+ *
+ * Fetch and manage products from Polar.sh API
+ */
+
+interface UsePolarProductsOptions {
+    apiToken: string;
+    organizationId?: string;
+    isRecurring?: boolean;
+    enabled?: boolean;
+}
+interface UsePolarProductsResult {
+    products: PolarProduct[];
+    loading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetch products from Polar.sh API
+ *
+ * @example
+ * ```tsx
+ * const { products, loading, error } = usePolarProducts({
+ *   apiToken: polarApiToken,
+ *   organizationId: polarOrgId,
+ *   isRecurring: true,
+ * });
+ * ```
+ */
+declare function usePolarProducts(options: UsePolarProductsOptions): UsePolarProductsResult;
+
 interface FirebaseAdapterConfig {
     functions: unknown;
     firestore: unknown;
@@ -111,4 +194,54 @@ declare const SUBSCRIPTION_STATUS: Readonly<{
     NONE: "none";
 }>;
 
-export { type BillingCycle, type CancelResult, type CancellationReason, type CheckoutParams, type CheckoutResult, type FirebaseAdapterConfig, type OrderItem, type PolarAdapter, type PolarContextValue, PolarProvider, SUBSCRIPTION_STATUS, type SubscriptionStatus, type SubscriptionStatusValue, type SyncResult, createFirebaseAdapter, usePolarBilling };
+/**
+ * Polar API Service
+ *
+ * Direct client-side calls to Polar.sh API using OAT authentication
+ * Note: OAT tokens should only be used server-side in production
+ * This service is intended for server-side or edge function usage
+ */
+
+interface PolarApiConfig {
+    apiToken: string;
+    baseUrl?: string;
+}
+/**
+ * Fetch products from Polar.sh API
+ *
+ * @param config - Polar API configuration with OAT token
+ * @param params - Query parameters for filtering products
+ * @returns Paginated list of products
+ *
+ * @example
+ * ```ts
+ * const products = await getProducts({
+ *   apiToken: 'polar_oat_xxx',
+ *   baseUrl: 'https://api.polar.sh/v1'
+ * }, {
+ *   organizationId: 'org-123',
+ *   isRecurring: true,
+ *   page: 1,
+ *   limit: 100
+ * });
+ * ```
+ */
+declare function getProducts(config: PolarApiConfig, params?: ProductListParams): Promise<ProductListResponse>;
+/**
+ * Fetch a single product by ID
+ *
+ * @param config - Polar API configuration
+ * @param productId - Product ID to fetch
+ * @returns Product details or null if not found
+ */
+declare function getProductById(config: PolarApiConfig, productId: string): Promise<PolarProduct | null>;
+/**
+ * Fetch all products with automatic pagination
+ *
+ * @param config - Polar API configuration
+ * @param params - Query parameters for filtering
+ * @returns All products matching the criteria
+ */
+declare function getAllProducts(config: PolarApiConfig, params?: Omit<ProductListParams, 'page' | 'limit'>): Promise<PolarProduct[]>;
+
+export { type BillingCycle, type CancelResult, type CancellationReason, type CheckoutParams, type CheckoutResult, type FirebaseAdapterConfig, type OrderItem, type PolarAdapter, type PolarApiConfig, type PolarContextValue, type PolarPrice, type PolarProduct, PolarProvider, type PriceType, type ProductListParams, type ProductListResponse, type RecurringInterval, SUBSCRIPTION_STATUS, type SubscriptionStatus, type SubscriptionStatusValue, type SyncResult, type UsePolarProductsOptions, type UsePolarProductsResult, createFirebaseAdapter, getAllProducts, getProductById, getProducts, usePolarBilling, usePolarProducts };

package/dist/index.d.ts

@@ -76,6 +76,89 @@ interface PolarContextValue {
 }
 declare function usePolarBilling(): PolarContextValue;
 
+/**
+ * Product Entity
+ *
+ * Represents a Polar.sh product with pricing information
+ */
+type RecurringInterval = 'day' | 'week' | 'month' | 'year';
+type PriceType = 'fixed' | 'custom' | 'free' | 'seat_based' | 'metered_unit';
+interface PolarPrice {
+    id: string;
+    type: PriceType;
+    amount_type: string;
+    amount?: number;
+    currency: string;
+    recurring_interval?: RecurringInterval;
+    is_archived: boolean;
+    product_id: string;
+    legacy?: boolean;
+}
+interface PolarProduct {
+    id: string;
+    name: string;
+    description: string | null;
+    is_recurring: boolean;
+    recurring_interval: RecurringInterval | null;
+    is_archived: boolean;
+    organization_id: string;
+    prices: PolarPrice[];
+    benefits: Array<{
+        id: string;
+        type: string;
+        description: string | null;
+        properties: Record<string, unknown>;
+    }>;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    modified_at: string | null;
+}
+interface ProductListResponse {
+    items: PolarProduct[];
+    pagination: {
+        total_count: number;
+        max_page: number;
+    };
+}
+interface ProductListParams {
+    organizationId?: string;
+    isRecurring?: boolean;
+    page?: number;
+    limit?: number;
+}
+
+/**
+ * usePolarProducts Hook
+ *
+ * Fetch and manage products from Polar.sh API
+ */
+
+interface UsePolarProductsOptions {
+    apiToken: string;
+    organizationId?: string;
+    isRecurring?: boolean;
+    enabled?: boolean;
+}
+interface UsePolarProductsResult {
+    products: PolarProduct[];
+    loading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetch products from Polar.sh API
+ *
+ * @example
+ * ```tsx
+ * const { products, loading, error } = usePolarProducts({
+ *   apiToken: polarApiToken,
+ *   organizationId: polarOrgId,
+ *   isRecurring: true,
+ * });
+ * ```
+ */
+declare function usePolarProducts(options: UsePolarProductsOptions): UsePolarProductsResult;
+
 interface FirebaseAdapterConfig {
     functions: unknown;
     firestore: unknown;
@@ -111,4 +194,54 @@ declare const SUBSCRIPTION_STATUS: Readonly<{
     NONE: "none";
 }>;
 
-export { type BillingCycle, type CancelResult, type CancellationReason, type CheckoutParams, type CheckoutResult, type FirebaseAdapterConfig, type OrderItem, type PolarAdapter, type PolarContextValue, PolarProvider, SUBSCRIPTION_STATUS, type SubscriptionStatus, type SubscriptionStatusValue, type SyncResult, createFirebaseAdapter, usePolarBilling };
+/**
+ * Polar API Service
+ *
+ * Direct client-side calls to Polar.sh API using OAT authentication
+ * Note: OAT tokens should only be used server-side in production
+ * This service is intended for server-side or edge function usage
+ */
+
+interface PolarApiConfig {
+    apiToken: string;
+    baseUrl?: string;
+}
+/**
+ * Fetch products from Polar.sh API
+ *
+ * @param config - Polar API configuration with OAT token
+ * @param params - Query parameters for filtering products
+ * @returns Paginated list of products
+ *
+ * @example
+ * ```ts
+ * const products = await getProducts({
+ *   apiToken: 'polar_oat_xxx',
+ *   baseUrl: 'https://api.polar.sh/v1'
+ * }, {
+ *   organizationId: 'org-123',
+ *   isRecurring: true,
+ *   page: 1,
+ *   limit: 100
+ * });
+ * ```
+ */
+declare function getProducts(config: PolarApiConfig, params?: ProductListParams): Promise<ProductListResponse>;
+/**
+ * Fetch a single product by ID
+ *
+ * @param config - Polar API configuration
+ * @param productId - Product ID to fetch
+ * @returns Product details or null if not found
+ */
+declare function getProductById(config: PolarApiConfig, productId: string): Promise<PolarProduct | null>;
+/**
+ * Fetch all products with automatic pagination
+ *
+ * @param config - Polar API configuration
+ * @param params - Query parameters for filtering
+ * @returns All products matching the criteria
+ */
+declare function getAllProducts(config: PolarApiConfig, params?: Omit<ProductListParams, 'page' | 'limit'>): Promise<PolarProduct[]>;
+
+export { type BillingCycle, type CancelResult, type CancellationReason, type CheckoutParams, type CheckoutResult, type FirebaseAdapterConfig, type OrderItem, type PolarAdapter, type PolarApiConfig, type PolarContextValue, type PolarPrice, type PolarProduct, PolarProvider, type PriceType, type ProductListParams, type ProductListResponse, type RecurringInterval, SUBSCRIPTION_STATUS, type SubscriptionStatus, type SubscriptionStatusValue, type SyncResult, type UsePolarProductsOptions, type UsePolarProductsResult, createFirebaseAdapter, getAllProducts, getProductById, getProducts, usePolarBilling, usePolarProducts };

package/dist/index.js

@@ -33,7 +33,11 @@ __export(index_exports, {
   PolarProvider: () => PolarProvider,
   SUBSCRIPTION_STATUS: () => SUBSCRIPTION_STATUS,
   createFirebaseAdapter: () => createFirebaseAdapter,
-  usePolarBilling: () => usePolarBilling
+  getAllProducts: () => getAllProducts,
+  getProductById: () => getProductById,
+  getProducts: () => getProducts,
+  usePolarBilling: () => usePolarBilling,
+  usePolarProducts: () => usePolarProducts
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -165,6 +169,123 @@ function PolarProvider({ adapter, userId, children }) {
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(PolarContext.Provider, { value, children });
 }
 
+// src/presentation/hooks/usePolarProducts.ts
+var import_react3 = require("react");
+
+// src/infrastructure/services/polar-api.service.ts
+async function getProducts(config, params) {
+  const baseUrl = config.baseUrl || "https://api.polar.sh/v1";
+  const url = new URL(`${baseUrl}/products`);
+  if (params?.organizationId) {
+    url.searchParams.set("organization_id", params.organizationId);
+  }
+  if (params?.isRecurring !== void 0) {
+    url.searchParams.set("is_recurring", String(params.isRecurring));
+  }
+  if (params?.page) {
+    url.searchParams.set("page", String(params.page));
+  }
+  if (params?.limit) {
+    url.searchParams.set("limit", String(Math.min(params.limit, 100)));
+  }
+  const response = await fetch(url.toString(), {
+    method: "GET",
+    headers: {
+      "Authorization": `Bearer ${config.apiToken}`,
+      "Accept": "application/json"
+    }
+  });
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(
+      `Polar API error: ${response.status} ${response.statusText}
+${error}`
+    );
+  }
+  const data = await response.json();
+  return data;
+}
+async function getProductById(config, productId) {
+  const baseUrl = config.baseUrl || "https://api.polar.sh/v1";
+  const url = `${baseUrl}/products/${productId}`;
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      "Authorization": `Bearer ${config.apiToken}`,
+      "Accept": "application/json"
+    }
+  });
+  if (response.status === 404) {
+    return null;
+  }
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(
+      `Polar API error: ${response.status} ${response.statusText}
+${error}`
+    );
+  }
+  const data = await response.json();
+  return data;
+}
+async function getAllProducts(config, params) {
+  const allProducts = [];
+  let page = 1;
+  let maxPage = 1;
+  do {
+    const response = await getProducts(config, {
+      ...params,
+      page,
+      limit: 100
+    });
+    allProducts.push(...response.items);
+    maxPage = response.pagination.max_page;
+    page++;
+  } while (page <= maxPage);
+  return allProducts;
+}
+
+// src/presentation/hooks/usePolarProducts.ts
+function usePolarProducts(options) {
+  const { apiToken, organizationId, isRecurring = true, enabled = true } = options;
+  const [products, setProducts] = (0, import_react3.useState)([]);
+  const [loading, setLoading] = (0, import_react3.useState)(true);
+  const [error, setError] = (0, import_react3.useState)(null);
+  const fetchProducts = async () => {
+    if (!enabled) {
+      setLoading(false);
+      return;
+    }
+    try {
+      setLoading(true);
+      setError(null);
+      const params = {
+        isRecurring
+      };
+      if (organizationId) {
+        params.organizationId = organizationId;
+      }
+      const data = await getAllProducts({ apiToken }, params);
+      setProducts(data);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Failed to fetch products";
+      setError(message);
+      console.error("usePolarProducts error:", err);
+    } finally {
+      setLoading(false);
+    }
+  };
+  (0, import_react3.useEffect)(() => {
+    fetchProducts();
+  }, [apiToken, organizationId, isRecurring, enabled]);
+  return {
+    products,
+    loading,
+    error,
+    refetch: fetchProducts
+  };
+}
+
 // src/infrastructure/constants/billing.constants.ts
 var SUBSCRIPTION_STATUS = Object.freeze({
   ACTIVE: "active",
@@ -317,5 +438,9 @@ function createFirebaseAdapter(config) {
   PolarProvider,
   SUBSCRIPTION_STATUS,
   createFirebaseAdapter,
-  usePolarBilling
+  getAllProducts,
+  getProductById,
+  getProducts,
+  usePolarBilling,
+  usePolarProducts
 });

package/dist/index.mjs

@@ -132,6 +132,123 @@ function PolarProvider({ adapter, userId, children }) {
   return /* @__PURE__ */ jsx(PolarContext.Provider, { value, children });
 }
 
+// src/presentation/hooks/usePolarProducts.ts
+import { useState as useState2, useEffect as useEffect2 } from "react";
+
+// src/infrastructure/services/polar-api.service.ts
+async function getProducts(config, params) {
+  const baseUrl = config.baseUrl || "https://api.polar.sh/v1";
+  const url = new URL(`${baseUrl}/products`);
+  if (params?.organizationId) {
+    url.searchParams.set("organization_id", params.organizationId);
+  }
+  if (params?.isRecurring !== void 0) {
+    url.searchParams.set("is_recurring", String(params.isRecurring));
+  }
+  if (params?.page) {
+    url.searchParams.set("page", String(params.page));
+  }
+  if (params?.limit) {
+    url.searchParams.set("limit", String(Math.min(params.limit, 100)));
+  }
+  const response = await fetch(url.toString(), {
+    method: "GET",
+    headers: {
+      "Authorization": `Bearer ${config.apiToken}`,
+      "Accept": "application/json"
+    }
+  });
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(
+      `Polar API error: ${response.status} ${response.statusText}
+${error}`
+    );
+  }
+  const data = await response.json();
+  return data;
+}
+async function getProductById(config, productId) {
+  const baseUrl = config.baseUrl || "https://api.polar.sh/v1";
+  const url = `${baseUrl}/products/${productId}`;
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      "Authorization": `Bearer ${config.apiToken}`,
+      "Accept": "application/json"
+    }
+  });
+  if (response.status === 404) {
+    return null;
+  }
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(
+      `Polar API error: ${response.status} ${response.statusText}
+${error}`
+    );
+  }
+  const data = await response.json();
+  return data;
+}
+async function getAllProducts(config, params) {
+  const allProducts = [];
+  let page = 1;
+  let maxPage = 1;
+  do {
+    const response = await getProducts(config, {
+      ...params,
+      page,
+      limit: 100
+    });
+    allProducts.push(...response.items);
+    maxPage = response.pagination.max_page;
+    page++;
+  } while (page <= maxPage);
+  return allProducts;
+}
+
+// src/presentation/hooks/usePolarProducts.ts
+function usePolarProducts(options) {
+  const { apiToken, organizationId, isRecurring = true, enabled = true } = options;
+  const [products, setProducts] = useState2([]);
+  const [loading, setLoading] = useState2(true);
+  const [error, setError] = useState2(null);
+  const fetchProducts = async () => {
+    if (!enabled) {
+      setLoading(false);
+      return;
+    }
+    try {
+      setLoading(true);
+      setError(null);
+      const params = {
+        isRecurring
+      };
+      if (organizationId) {
+        params.organizationId = organizationId;
+      }
+      const data = await getAllProducts({ apiToken }, params);
+      setProducts(data);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Failed to fetch products";
+      setError(message);
+      console.error("usePolarProducts error:", err);
+    } finally {
+      setLoading(false);
+    }
+  };
+  useEffect2(() => {
+    fetchProducts();
+  }, [apiToken, organizationId, isRecurring, enabled]);
+  return {
+    products,
+    loading,
+    error,
+    refetch: fetchProducts
+  };
+}
+
 // src/infrastructure/constants/billing.constants.ts
 var SUBSCRIPTION_STATUS = Object.freeze({
   ACTIVE: "active",
@@ -283,5 +400,9 @@ export {
   PolarProvider,
   SUBSCRIPTION_STATUS,
   createFirebaseAdapter,
-  usePolarBilling
+  getAllProducts,
+  getProductById,
+  getProducts,
+  usePolarBilling,
+  usePolarProducts
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/web-polar-payment",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "Universal Polar.sh subscription billing — Firebase adapter",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/domain/entities/product.entity.ts

@@ -0,0 +1,56 @@
+/**
+ * Product Entity
+ *
+ * Represents a Polar.sh product with pricing information
+ */
+
+export type RecurringInterval = 'day' | 'week' | 'month' | 'year';
+
+export type PriceType = 'fixed' | 'custom' | 'free' | 'seat_based' | 'metered_unit';
+
+export interface PolarPrice {
+  id: string;
+  type: PriceType;
+  amount_type: string;
+  amount?: number;
+  currency: string;
+  recurring_interval?: RecurringInterval;
+  is_archived: boolean;
+  product_id: string;
+  legacy?: boolean;
+}
+
+export interface PolarProduct {
+  id: string;
+  name: string;
+  description: string | null;
+  is_recurring: boolean;
+  recurring_interval: RecurringInterval | null;
+  is_archived: boolean;
+  organization_id: string;
+  prices: PolarPrice[];
+  benefits: Array<{
+    id: string;
+    type: string;
+    description: string | null;
+    properties: Record<string, unknown>;
+  }>;
+  metadata: Record<string, unknown>;
+  created_at: string;
+  modified_at: string | null;
+}
+
+export interface ProductListResponse {
+  items: PolarProduct[];
+  pagination: {
+    total_count: number;
+    max_page: number;
+  };
+}
+
+export interface ProductListParams {
+  organizationId?: string;
+  isRecurring?: boolean;
+  page?: number;
+  limit?: number;
+}

package/src/index.ts

@@ -1,9 +1,16 @@
 export { PolarProvider } from './presentation/components/PolarProvider';
 export { usePolarBilling } from './presentation/hooks/usePolarBilling';
+export { usePolarProducts } from './presentation/hooks/usePolarProducts';
 export type { PolarContextValue } from './presentation/hooks/usePolarBilling';
+export type { UsePolarProductsOptions, UsePolarProductsResult } from './presentation/hooks/usePolarProducts';
 export { createFirebaseAdapter } from './infrastructure/services/firebase-billing.service';
 export type { FirebaseAdapterConfig } from './infrastructure/services/firebase-billing.service';
 export { SUBSCRIPTION_STATUS } from './infrastructure/constants/billing.constants';
 export type { SubscriptionStatusValue, BillingCycle } from './domain/entities/subscription.entity';
 export type { SubscriptionStatus, CheckoutParams, CheckoutResult, OrderItem, CancellationReason, CancelResult, SyncResult } from './domain/entities';
 export type { PolarAdapter } from './domain/interfaces';
+
+// Product API
+export { getProducts, getProductById, getAllProducts } from './infrastructure/services/polar-api.service';
+export type { PolarApiConfig } from './infrastructure/services/polar-api.service';
+export type { PolarProduct, PolarPrice, ProductListResponse, ProductListParams, RecurringInterval, PriceType } from './domain/entities/product.entity';

package/src/infrastructure/services/polar-api.service.ts

@@ -0,0 +1,147 @@
+/**
+ * Polar API Service
+ *
+ * Direct client-side calls to Polar.sh API using OAT authentication
+ * Note: OAT tokens should only be used server-side in production
+ * This service is intended for server-side or edge function usage
+ */
+
+import type {
+  PolarProduct,
+  ProductListResponse,
+  ProductListParams
+} from '../../domain/entities/product.entity';
+
+export interface PolarApiConfig {
+  apiToken: string;
+  baseUrl?: string;
+}
+
+/**
+ * Fetch products from Polar.sh API
+ *
+ * @param config - Polar API configuration with OAT token
+ * @param params - Query parameters for filtering products
+ * @returns Paginated list of products
+ *
+ * @example
+ * ```ts
+ * const products = await getProducts({
+ *   apiToken: 'polar_oat_xxx',
+ *   baseUrl: 'https://api.polar.sh/v1'
+ * }, {
+ *   organizationId: 'org-123',
+ *   isRecurring: true,
+ *   page: 1,
+ *   limit: 100
+ * });
+ * ```
+ */
+export async function getProducts(
+  config: PolarApiConfig,
+  params?: ProductListParams
+): Promise<ProductListResponse> {
+  const baseUrl = config.baseUrl || 'https://api.polar.sh/v1';
+  const url = new URL(`${baseUrl}/products`);
+
+  if (params?.organizationId) {
+    url.searchParams.set('organization_id', params.organizationId);
+  }
+
+  if (params?.isRecurring !== undefined) {
+    url.searchParams.set('is_recurring', String(params.isRecurring));
+  }
+
+  if (params?.page) {
+    url.searchParams.set('page', String(params.page));
+  }
+
+  if (params?.limit) {
+    url.searchParams.set('limit', String(Math.min(params.limit, 100)));
+  }
+
+  const response = await fetch(url.toString(), {
+    method: 'GET',
+    headers: {
+      'Authorization': `Bearer ${config.apiToken}`,
+      'Accept': 'application/json',
+    },
+  });
+
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(
+      `Polar API error: ${response.status} ${response.statusText}\n${error}`
+    );
+  }
+
+  const data = await response.json();
+  return data as ProductListResponse;
+}
+
+/**
+ * Fetch a single product by ID
+ *
+ * @param config - Polar API configuration
+ * @param productId - Product ID to fetch
+ * @returns Product details or null if not found
+ */
+export async function getProductById(
+  config: PolarApiConfig,
+  productId: string
+): Promise<PolarProduct | null> {
+  const baseUrl = config.baseUrl || 'https://api.polar.sh/v1';
+  const url = `${baseUrl}/products/${productId}`;
+
+  const response = await fetch(url, {
+    method: 'GET',
+    headers: {
+      'Authorization': `Bearer ${config.apiToken}`,
+      'Accept': 'application/json',
+    },
+  });
+
+  if (response.status === 404) {
+    return null;
+  }
+
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(
+      `Polar API error: ${response.status} ${response.statusText}\n${error}`
+    );
+  }
+
+  const data = await response.json();
+  return data as PolarProduct;
+}
+
+/**
+ * Fetch all products with automatic pagination
+ *
+ * @param config - Polar API configuration
+ * @param params - Query parameters for filtering
+ * @returns All products matching the criteria
+ */
+export async function getAllProducts(
+  config: PolarApiConfig,
+  params?: Omit<ProductListParams, 'page' | 'limit'>
+): Promise<PolarProduct[]> {
+  const allProducts: PolarProduct[] = [];
+  let page = 1;
+  let maxPage = 1;
+
+  do {
+    const response = await getProducts(config, {
+      ...params,
+      page,
+      limit: 100,
+    });
+
+    allProducts.push(...response.items);
+    maxPage = response.pagination.max_page;
+    page++;
+  } while (page <= maxPage);
+
+  return allProducts;
+}

package/src/presentation/hooks/usePolarProducts.ts

@@ -0,0 +1,83 @@
+/**
+ * usePolarProducts Hook
+ *
+ * Fetch and manage products from Polar.sh API
+ */
+
+import { useState, useEffect } from 'react';
+import { getAllProducts } from '../../infrastructure/services/polar-api.service';
+import type { PolarProduct, ProductListParams } from '../../domain/entities/product.entity';
+
+export interface UsePolarProductsOptions {
+  apiToken: string;
+  organizationId?: string;
+  isRecurring?: boolean;
+  enabled?: boolean;
+}
+
+export interface UsePolarProductsResult {
+  products: PolarProduct[];
+  loading: boolean;
+  error: string | null;
+  refetch: () => Promise<void>;
+}
+
+/**
+ * Fetch products from Polar.sh API
+ *
+ * @example
+ * ```tsx
+ * const { products, loading, error } = usePolarProducts({
+ *   apiToken: polarApiToken,
+ *   organizationId: polarOrgId,
+ *   isRecurring: true,
+ * });
+ * ```
+ */
+export function usePolarProducts(options: UsePolarProductsOptions): UsePolarProductsResult {
+  const { apiToken, organizationId, isRecurring = true, enabled = true } = options;
+
+  const [products, setProducts] = useState<PolarProduct[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  const fetchProducts = async () => {
+    if (!enabled) {
+      setLoading(false);
+      return;
+    }
+
+    try {
+      setLoading(true);
+      setError(null);
+
+      const params: ProductListParams = {
+        isRecurring,
+      };
+
+      if (organizationId) {
+        params.organizationId = organizationId;
+      }
+
+      const data = await getAllProducts({ apiToken }, params);
+      setProducts(data);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : 'Failed to fetch products';
+      setError(message);
+      console.error('usePolarProducts error:', err);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    fetchProducts();
+  }, [apiToken, organizationId, isRecurring, enabled]);
+
+  return {
+    products,
+    loading,
+    error,
+    refetch: fetchProducts,
+  };
+}