@umituz/web-payment 0.0.0-stage → 1.0.0

package/dist/chunk-PIWNUAKW.mjs

@@ -0,0 +1,30 @@
+// src/domain/utils/minor-units.ts
+var MINOR_UNIT_DIVISOR = 100;
+var ZERO_DECIMAL_CURRENCIES = /* @__PURE__ */ new Set([
+  "JPY",
+  "KRW",
+  "VND",
+  "CLP",
+  "PYG",
+  "XAF",
+  "XOF",
+  "BIF",
+  "DJF",
+  "GNF",
+  "XPF"
+]);
+function minorUnitDivisor(currency) {
+  return ZERO_DECIMAL_CURRENCIES.has(currency.toUpperCase()) ? 1 : MINOR_UNIT_DIVISOR;
+}
+function toMajorUnits(amount, currency) {
+  return amount / minorUnitDivisor(currency);
+}
+function toMinorUnits(amount, currency) {
+  return Math.round(amount * minorUnitDivisor(currency));
+}
+
+export {
+  minorUnitDivisor,
+  toMajorUnits,
+  toMinorUnits
+};

package/dist/chunk-QFB7AOSQ.mjs

@@ -0,0 +1,33 @@
+// src/infrastructure/config/billing-env.ts
+var CHECKOUT_ID_PARAM = "checkout_id";
+var CHECKOUT_ID_PLACEHOLDER = "{CHECKOUT_ID}";
+function parseProductIds(raw) {
+  const map = /* @__PURE__ */ new Map();
+  if (typeof raw !== "string" || raw.length === 0) return map;
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return map;
+  }
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) return map;
+  for (const [key, value] of Object.entries(parsed)) {
+    if (typeof value === "string" && value.length > 0) map.set(key, value);
+  }
+  return map;
+}
+function productIdOf(ids, productKey) {
+  return ids.get(productKey) ?? null;
+}
+function successUrlWithCheckoutId(origin, returnPath) {
+  const separator = returnPath.includes("?") ? "&" : "?";
+  return `${origin}${returnPath}${separator}${CHECKOUT_ID_PARAM}=${CHECKOUT_ID_PLACEHOLDER}`;
+}
+
+export {
+  CHECKOUT_ID_PARAM,
+  CHECKOUT_ID_PLACEHOLDER,
+  parseProductIds,
+  productIdOf,
+  successUrlWithCheckoutId
+};

package/dist/chunk-RQTMBR74.mjs

@@ -0,0 +1,30 @@
+// src/domain/enums/billing-cycle.enum.ts
+var BILLING_CYCLE = Object.freeze({
+  MONTHLY: "monthly",
+  YEARLY: "yearly"
+});
+var BILLING_CYCLE_VALUES = Object.freeze([
+  BILLING_CYCLE.MONTHLY,
+  BILLING_CYCLE.YEARLY
+]);
+var CANONICAL_BILLING_CYCLES = new Set(BILLING_CYCLE_VALUES);
+var BILLING_CYCLE_ALIASES = /* @__PURE__ */ new Map([
+  [BILLING_CYCLE.MONTHLY, BILLING_CYCLE.MONTHLY],
+  ["month", BILLING_CYCLE.MONTHLY],
+  [BILLING_CYCLE.YEARLY, BILLING_CYCLE.YEARLY],
+  ["year", BILLING_CYCLE.YEARLY]
+]);
+function isKnownBillingCycle(value) {
+  return typeof value === "string" && CANONICAL_BILLING_CYCLES.has(value.toLowerCase());
+}
+function parseBillingCycle(value) {
+  if (typeof value !== "string") return null;
+  return BILLING_CYCLE_ALIASES.get(value.toLowerCase()) ?? null;
+}
+
+export {
+  BILLING_CYCLE,
+  BILLING_CYCLE_VALUES,
+  isKnownBillingCycle,
+  parseBillingCycle
+};

package/dist/chunk-U45FS4FF.mjs

@@ -0,0 +1,110 @@
+import {
+  parseBillingCycle
+} from "./chunk-RQTMBR74.mjs";
+
+// src/domain/enums/subscription-status.enum.ts
+var SUBSCRIPTION_STATUS = {
+  ACTIVE: "active",
+  CANCELED: "canceled",
+  REVOKED: "revoked",
+  TRIALING: "trialing",
+  PAST_DUE: "past_due",
+  INCOMPLETE: "incomplete",
+  INCOMPLETE_EXPIRED: "incomplete_expired",
+  UNPAID: "unpaid",
+  NONE: "none"
+};
+var SUBSCRIPTION_STATUS_VALUES = Object.freeze([
+  SUBSCRIPTION_STATUS.ACTIVE,
+  SUBSCRIPTION_STATUS.CANCELED,
+  SUBSCRIPTION_STATUS.REVOKED,
+  SUBSCRIPTION_STATUS.TRIALING,
+  SUBSCRIPTION_STATUS.PAST_DUE,
+  SUBSCRIPTION_STATUS.INCOMPLETE,
+  SUBSCRIPTION_STATUS.INCOMPLETE_EXPIRED,
+  SUBSCRIPTION_STATUS.UNPAID,
+  SUBSCRIPTION_STATUS.NONE
+]);
+var SUBSCRIPTION_STATUS_SET = new Set(SUBSCRIPTION_STATUS_VALUES);
+function isKnownSubscriptionStatus(value) {
+  return typeof value === "string" && SUBSCRIPTION_STATUS_SET.has(value.toLowerCase());
+}
+
+// src/domain/mappers/product.mapper.ts
+var KNOWN_AMOUNT_TYPES = /* @__PURE__ */ new Set([
+  "fixed",
+  "custom",
+  "free",
+  "seat_based",
+  "metered_unit"
+]);
+function toAmountType(raw) {
+  if (raw && KNOWN_AMOUNT_TYPES.has(raw)) return raw;
+  return "fixed";
+}
+function toBillingCycle(interval) {
+  return parseBillingCycle(interval);
+}
+function asRecord(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function toPrice(dto) {
+  return {
+    id: String(dto.id),
+    type: toAmountType(dto.type),
+    amountType: toAmountType(dto.amount_type),
+    amount: typeof dto.amount === "number" ? dto.amount : void 0,
+    currency: String(dto.currency),
+    recurringInterval: toBillingCycle(dto.recurring_interval) ?? void 0,
+    isArchived: Boolean(dto.is_archived),
+    productId: String(dto.product_id),
+    legacy: Boolean(dto.legacy)
+  };
+}
+function toBenefit(dto) {
+  return {
+    id: String(dto.id),
+    type: String(dto.type),
+    description: dto.description ?? null,
+    properties: asRecord(dto.properties)
+  };
+}
+function mapProduct(dto) {
+  if (!dto || typeof dto !== "object") {
+    throw new TypeError("mapProduct: expected a product DTO object");
+  }
+  return {
+    id: String(dto.id),
+    name: String(dto.name),
+    description: dto.description ?? null,
+    isRecurring: Boolean(dto.is_recurring),
+    recurringInterval: toBillingCycle(dto.recurring_interval),
+    isArchived: Boolean(dto.is_archived),
+    organizationId: String(dto.organization_id),
+    prices: Array.isArray(dto.prices) ? dto.prices.map(toPrice) : [],
+    benefits: Array.isArray(dto.benefits) ? dto.benefits.map(toBenefit) : [],
+    metadata: asRecord(dto.metadata),
+    createdAt: String(dto.created_at),
+    modifiedAt: dto.modified_at ?? null
+  };
+}
+function mapProductList(dto) {
+  if (!dto || typeof dto !== "object") {
+    return { items: [], pagination: { totalCount: 0, maxPage: 1 } };
+  }
+  return {
+    items: Array.isArray(dto.items) ? dto.items.map(mapProduct) : [],
+    pagination: {
+      totalCount: Number(dto.pagination?.total_count ?? 0),
+      maxPage: Number(dto.pagination?.max_page ?? 1)
+    }
+  };
+}
+
+export {
+  SUBSCRIPTION_STATUS,
+  SUBSCRIPTION_STATUS_VALUES,
+  isKnownSubscriptionStatus,
+  mapProduct,
+  mapProductList
+};

package/dist/chunk-XQ2HJTTA.mjs

@@ -0,0 +1,252 @@
+import {
+  mapProduct,
+  mapProductList
+} from "./chunk-U45FS4FF.mjs";
+
+// src/infrastructure/constants/billing.constants.ts
+var API_BASE_URL = "https://api.polar.sh/v1";
+var API_MAX_PAGE_SIZE = 100;
+
+// src/infrastructure/http/http-client.ts
+var DEFAULT_TIMEOUT_MS = 15e3;
+var FetchHttpClient = class {
+  async request(request) {
+    const init = {
+      method: request.method,
+      headers: {
+        Accept: "application/json",
+        ...request.headers ?? {}
+      }
+    };
+    if (request.body !== void 0) {
+      init.body = JSON.stringify(request.body);
+      init.headers["Content-Type"] = "application/json";
+    }
+    const timeoutMs = request.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      controller.abort();
+    }, timeoutMs);
+    const forwardAbort = () => controller.abort();
+    if (request.signal) {
+      if (request.signal.aborted) controller.abort();
+      else request.signal.addEventListener("abort", forwardAbort);
+    }
+    init.signal = controller.signal;
+    let response;
+    try {
+      response = await fetch(request.url, init);
+    } catch (error) {
+      if (timedOut && error instanceof Error && error.name === "AbortError") {
+        throw new DOMException(`Request timed out after ${timeoutMs}ms`, "TimeoutError");
+      }
+      throw error;
+    } finally {
+      clearTimeout(timer);
+      request.signal?.removeEventListener("abort", forwardAbort);
+    }
+    const bodyText = await response.text();
+    let data = null;
+    if (bodyText.length > 0) {
+      try {
+        data = JSON.parse(bodyText);
+      } catch {
+        data = null;
+      }
+    }
+    return {
+      status: response.status,
+      ok: response.ok,
+      data,
+      text: async () => bodyText
+    };
+  }
+};
+
+// src/infrastructure/query/query-builder.ts
+var QueryBuilder = class {
+  params;
+  constructor(initial) {
+    this.params = new URLSearchParams();
+    if (initial) this.setMany(initial);
+  }
+  set(key, value) {
+    if (value === void 0 || value === null) return this;
+    this.params.set(key, String(value));
+    return this;
+  }
+  setMany(values) {
+    for (const [key, value] of Object.entries(values)) {
+      this.set(key, value);
+    }
+    return this;
+  }
+  toString() {
+    return this.params.toString();
+  }
+};
+
+// src/infrastructure/pagination/page-iterator.ts
+var PageIterator = class {
+  fetcher;
+  limit;
+  signal;
+  constructor(fetcher, options = {}) {
+    this.fetcher = fetcher;
+    this.limit = options.limit ?? 100;
+    this.signal = options.signal;
+  }
+  async *[Symbol.asyncIterator]() {
+    let page = 1;
+    while (true) {
+      if (this.signal?.aborted) return;
+      const current = await this.fetcher.fetchPage(page, this.limit);
+      for (const item of current.items) {
+        if (this.signal?.aborted) return;
+        yield item;
+      }
+      if (current.isLast || page >= current.maxPage) return;
+      page++;
+    }
+  }
+};
+
+// src/infrastructure/utils/pagination-clamp.ts
+var MIN_PAGE_SIZE = 1;
+var PaginationClamp = class {
+  static pageSize(raw, max = API_MAX_PAGE_SIZE) {
+    if (raw === void 0) return max;
+    return Math.min(Math.max(MIN_PAGE_SIZE, raw), max);
+  }
+};
+
+// src/infrastructure/services/product.repository.ts
+var BillingApiError = class _BillingApiError extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "BillingApiError";
+    Object.setPrototypeOf(this, _BillingApiError.prototype);
+  }
+};
+function isBillingApiError(error) {
+  return error instanceof BillingApiError;
+}
+var ProductRepository = class {
+  http;
+  apiToken;
+  baseUrl;
+  constructor(config, http = new FetchHttpClient()) {
+    this.http = http;
+    this.apiToken = config.apiToken;
+    this.baseUrl = config.baseUrl ?? API_BASE_URL;
+  }
+  async list(params, options) {
+    const query = new QueryBuilder({
+      organization_id: params?.organizationId,
+      is_recurring: params?.isRecurring,
+      page: params?.page,
+      limit: this.clampLimit(params?.limit)
+    });
+    const url = `${this.baseUrl}/products?${query.toString()}`;
+    const response = await this.http.request({
+      method: "GET",
+      url,
+      headers: this.authHeaders(),
+      signal: options?.signal,
+      timeoutMs: options?.timeoutMs
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new BillingApiError(
+        `Billing API error: ${response.status}`,
+        response.status,
+        body
+      );
+    }
+    return mapProductList(response.data);
+  }
+  async findById(productId, options) {
+    const url = `${this.baseUrl}/products/${encodeURIComponent(productId)}`;
+    const response = await this.http.request({
+      method: "GET",
+      url,
+      headers: this.authHeaders(),
+      signal: options?.signal,
+      timeoutMs: options?.timeoutMs
+    });
+    if (response.status === 404) return null;
+    if (!response.ok) {
+      const body = await response.text();
+      throw new BillingApiError(
+        `Billing API error: ${response.status}`,
+        response.status,
+        body
+      );
+    }
+    if (!response.data) {
+      throw new BillingApiError(
+        "Billing API returned an empty product body",
+        response.status
+      );
+    }
+    return mapProduct(response.data);
+  }
+  iterateAll(params, options = {}) {
+    const limit = this.clampLimit(options.limit);
+    const fetcher = {
+      fetchPage: async (page, pageLimit) => {
+        const response = await this.list(
+          { ...params, page, limit: pageLimit },
+          { signal: options.signal }
+        );
+        const pageData = {
+          items: response.items,
+          page,
+          totalCount: response.pagination.totalCount,
+          maxPage: response.pagination.maxPage,
+          isLast: page >= response.pagination.maxPage
+        };
+        return pageData;
+      }
+    };
+    return new PageIterator(fetcher, { limit, signal: options.signal });
+  }
+  async listAll(params, options = {}) {
+    const out = [];
+    for await (const product of this.iterateAll(params, options)) {
+      out.push(product);
+    }
+    return out;
+  }
+  authHeaders() {
+    return { Authorization: `Bearer ${this.apiToken}` };
+  }
+  clampLimit(limit) {
+    return PaginationClamp.pageSize(limit, API_MAX_PAGE_SIZE);
+  }
+};
+var defaultClient = new FetchHttpClient();
+async function getProducts(config, params, options) {
+  return new ProductRepository(config, defaultClient).list(params, options);
+}
+async function getProductById(config, productId, options) {
+  return new ProductRepository(config, defaultClient).findById(productId, options);
+}
+async function getAllProducts(config, params, options = {}) {
+  return new ProductRepository(config, defaultClient).listAll(params, options);
+}
+
+export {
+  API_BASE_URL,
+  FetchHttpClient,
+  BillingApiError,
+  isBillingApiError,
+  ProductRepository,
+  getProducts,
+  getProductById,
+  getAllProducts
+};

package/dist/core.d.mts

@@ -0,0 +1,17 @@
+export { B as BuildCheckoutMetadataInput, C as CheckoutOrderMetadata, P as PAYMENT_PROVIDER, a as PAYMENT_PROVIDER_VALUES, b as PaymentProvider, c as buildCheckoutMetadata, f as formatReceiptNumber, i as isKnownPaymentProvider, r as readCheckoutMetadata } from './checkout-metadata-D7Wp_DAD.mjs';
+export { B as BillingAdapter, C as CANCELLATION_REASON, a as CANCELLATION_REASON_VALUES, b as CancelResult, c as CancellationReason, d as CheckoutParams, e as CheckoutResult, F as FREE_SUBSCRIPTION_STATUS, O as OrderItem, S as SUBSCRIPTION_STATUS, f as SUBSCRIPTION_STATUS_VALUES, g as SubscriptionStatus, h as SubscriptionStatusValue, i as SyncResult, j as isActiveSubscription, k as isKnownSubscriptionStatus } from './billing-adapter.interface-CDkeeowZ.mjs';
+export { B as BILLING_CYCLE, a as BILLING_CYCLE_VALUES, b as BillingCycle, i as isKnownBillingCycle, p as parseBillingCycle } from './billing-cycle.enum--hJRYlgP.mjs';
+export { A as AmountType, P as POLAR_AMOUNT_TYPE, a as Product, b as ProductBenefit, c as ProductBenefitDto, d as ProductDto, e as ProductListParams, f as ProductListResponse, g as ProductListResponseDto, h as ProductPrice, i as ProductPriceDto, m as mapProduct, j as mapProductList } from './product.mapper-noVl-sel.mjs';
+export { MemoryAdapterConfig, createMemoryBillingAdapter } from './memory.mjs';
+
+type RecurringInterval = 'day' | 'week' | 'month' | 'year';
+type PriceType = 'fixed' | 'custom' | 'free' | 'seat_based' | 'metered_unit';
+
+declare function minorUnitDivisor(currency: string): number;
+declare function toMajorUnits(amount: number, currency: string): number;
+declare function toMinorUnits(amount: number, currency: string): number;
+
+declare function normalizeCouponCode(code: unknown): string | null;
+declare function applyPercentDiscount(baseAmount: number, percent: number, minimumAmount: number): number;
+
+export { type PriceType, type RecurringInterval, applyPercentDiscount, minorUnitDivisor, normalizeCouponCode, toMajorUnits, toMinorUnits };

package/dist/core.d.ts

@@ -0,0 +1,17 @@
+export { B as BuildCheckoutMetadataInput, C as CheckoutOrderMetadata, P as PAYMENT_PROVIDER, a as PAYMENT_PROVIDER_VALUES, b as PaymentProvider, c as buildCheckoutMetadata, f as formatReceiptNumber, i as isKnownPaymentProvider, r as readCheckoutMetadata } from './checkout-metadata-D7Wp_DAD.js';
+export { B as BillingAdapter, C as CANCELLATION_REASON, a as CANCELLATION_REASON_VALUES, b as CancelResult, c as CancellationReason, d as CheckoutParams, e as CheckoutResult, F as FREE_SUBSCRIPTION_STATUS, O as OrderItem, S as SUBSCRIPTION_STATUS, f as SUBSCRIPTION_STATUS_VALUES, g as SubscriptionStatus, h as SubscriptionStatusValue, i as SyncResult, j as isActiveSubscription, k as isKnownSubscriptionStatus } from './billing-adapter.interface-m7yE50I0.js';
+export { B as BILLING_CYCLE, a as BILLING_CYCLE_VALUES, b as BillingCycle, i as isKnownBillingCycle, p as parseBillingCycle } from './billing-cycle.enum--hJRYlgP.js';
+export { A as AmountType, P as POLAR_AMOUNT_TYPE, a as Product, b as ProductBenefit, c as ProductBenefitDto, d as ProductDto, e as ProductListParams, f as ProductListResponse, g as ProductListResponseDto, h as ProductPrice, i as ProductPriceDto, m as mapProduct, j as mapProductList } from './product.mapper-CnY1ISOp.js';
+export { MemoryAdapterConfig, createMemoryBillingAdapter } from './memory.js';
+
+type RecurringInterval = 'day' | 'week' | 'month' | 'year';
+type PriceType = 'fixed' | 'custom' | 'free' | 'seat_based' | 'metered_unit';
+
+declare function minorUnitDivisor(currency: string): number;
+declare function toMajorUnits(amount: number, currency: string): number;
+declare function toMinorUnits(amount: number, currency: string): number;
+
+declare function normalizeCouponCode(code: unknown): string | null;
+declare function applyPercentDiscount(baseAmount: number, percent: number, minimumAmount: number): number;
+
+export { type PriceType, type RecurringInterval, applyPercentDiscount, minorUnitDivisor, normalizeCouponCode, toMajorUnits, toMinorUnits };