@umituz/web-polar-payment 1.0.18 → 1.0.19

package/dist/index.d.mts

@@ -111,4 +111,105 @@ 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 };
+/**
+ * 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;
+}
+
+/**
+ * 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, createFirebaseAdapter, getAllProducts, getProductById, getProducts, usePolarBilling };

package/dist/index.d.ts

@@ -111,4 +111,105 @@ 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 };
+/**
+ * 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;
+}
+
+/**
+ * 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, createFirebaseAdapter, getAllProducts, getProductById, getProducts, usePolarBilling };

package/dist/index.js

@@ -33,6 +33,9 @@ __export(index_exports, {
   PolarProvider: () => PolarProvider,
   SUBSCRIPTION_STATUS: () => SUBSCRIPTION_STATUS,
   createFirebaseAdapter: () => createFirebaseAdapter,
+  getAllProducts: () => getAllProducts,
+  getProductById: () => getProductById,
+  getProducts: () => getProducts,
   usePolarBilling: () => usePolarBilling
 });
 module.exports = __toCommonJS(index_exports);
@@ -312,10 +315,86 @@ function createFirebaseAdapter(config) {
     }
   };
 }
+
+// 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;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PolarProvider,
   SUBSCRIPTION_STATUS,
   createFirebaseAdapter,
+  getAllProducts,
+  getProductById,
+  getProducts,
   usePolarBilling
 });

package/dist/index.mjs

@@ -279,9 +279,85 @@ function createFirebaseAdapter(config) {
     }
   };
 }
+
+// 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;
+}
 export {
   PolarProvider,
   SUBSCRIPTION_STATUS,
   createFirebaseAdapter,
+  getAllProducts,
+  getProductById,
+  getProducts,
   usePolarBilling
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/web-polar-payment",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "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

@@ -7,3 +7,8 @@ export { SUBSCRIPTION_STATUS } from './infrastructure/constants/billing.constant
 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;
+}