@akira-io/billing-js 0.1.0

package/dist/helpers.cjs

@@ -0,0 +1,116 @@
+'use strict';
+
+// src/checkout.ts
+function checkoutUrl(baseUrl, productKey, planKey) {
+  return `${baseUrl.replace(/\/$/, "")}/subscribe/${productKey}/${planKey}`;
+}
+
+// src/pricing.ts
+function formatPrice(amountInCents, currency) {
+  const symbol = currency.toLowerCase() === "eur" ? "\u20AC" : currency.toUpperCase() + " ";
+  const major = (amountInCents / 100).toFixed(amountInCents % 100 === 0 ? 0 : 2);
+  return `${symbol}${major}`;
+}
+
+// src/helpers.ts
+function isFreeTier(tier) {
+  return tier.monthly?.amount === 0 && tier.yearly === null && tier.oneTime === null;
+}
+function isOneTimeTier(tier) {
+  return tier.oneTime !== null && tier.monthly === null;
+}
+function hasYearly(tier) {
+  return tier.yearly !== null && tier.monthly !== null;
+}
+function getCtaProps(tier, opts) {
+  const meta = opts.tierMeta;
+  const monthlyHref = tier.monthly ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.monthly.planKey) : null;
+  const yearlyHref = tier.yearly ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.yearly.planKey) : null;
+  const oneTimeHref = tier.oneTime ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.oneTime.planKey) : null;
+  if (tier.isComingSoon) {
+    return {
+      label: opts.comingSoonLabel ?? "Coming soon",
+      href: null,
+      disabled: true,
+      monthlyHref,
+      yearlyHref,
+      oneTimeHref
+    };
+  }
+  if (meta?.ctaHref) {
+    return {
+      label: meta.ctaLabel ?? "Get started",
+      href: meta.ctaHref,
+      disabled: false,
+      monthlyHref,
+      yearlyHref,
+      oneTimeHref
+    };
+  }
+  let primary;
+  let defaultLabel;
+  if (isFreeTier(tier)) {
+    primary = null;
+    defaultLabel = opts.freeLabel ?? "Get started";
+  } else if (isOneTimeTier(tier)) {
+    primary = oneTimeHref;
+    defaultLabel = opts.buyLabel ?? "Buy";
+  } else {
+    primary = opts.interval === "yearly" ? yearlyHref ?? monthlyHref : monthlyHref;
+    defaultLabel = opts.subscribeLabel ?? "Subscribe";
+  }
+  return {
+    label: meta?.ctaLabel ?? defaultLabel,
+    href: primary,
+    disabled: false,
+    monthlyHref,
+    yearlyHref,
+    oneTimeHref
+  };
+}
+function getActivePrice(tier, interval) {
+  if (interval === "yearly" && tier.yearly) {
+    return {
+      amount: formatPrice(tier.yearly.amount, tier.yearly.currency),
+      suffix: "/year",
+      raw: { amount: tier.yearly.amount, currency: tier.yearly.currency },
+      note: tier.yearly.monthsFree > 0 ? `${tier.yearly.monthsFree} months free` : void 0
+    };
+  }
+  if (interval === "oneTime" && tier.oneTime) {
+    return {
+      amount: formatPrice(tier.oneTime.amount, tier.oneTime.currency),
+      suffix: " one-time",
+      raw: { amount: tier.oneTime.amount, currency: tier.oneTime.currency }
+    };
+  }
+  if (tier.monthly) {
+    return {
+      amount: formatPrice(tier.monthly.amount, tier.monthly.currency),
+      suffix: "/month",
+      raw: { amount: tier.monthly.amount, currency: tier.monthly.currency }
+    };
+  }
+  if (tier.oneTime) {
+    return {
+      amount: formatPrice(tier.oneTime.amount, tier.oneTime.currency),
+      suffix: " one-time",
+      raw: { amount: tier.oneTime.amount, currency: tier.oneTime.currency }
+    };
+  }
+  return { amount: "\u2014", suffix: "", raw: null };
+}
+function defaultInterval(tiers) {
+  if (tiers.some(hasYearly)) return "monthly";
+  if (tiers.every((t) => t.monthly === null && t.oneTime !== null)) return "oneTime";
+  return "monthly";
+}
+
+exports.defaultInterval = defaultInterval;
+exports.getActivePrice = getActivePrice;
+exports.getCtaProps = getCtaProps;
+exports.hasYearly = hasYearly;
+exports.isFreeTier = isFreeTier;
+exports.isOneTimeTier = isOneTimeTier;
+//# sourceMappingURL=helpers.cjs.map
+//# sourceMappingURL=helpers.cjs.map

package/dist/helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/checkout.ts","../src/pricing.ts","../src/helpers.ts"],"names":[],"mappings":"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","file":"helpers.cjs","sourcesContent":["export function checkoutUrl(baseUrl: string, productKey: string, planKey: string): string {\n    return `${baseUrl.replace(/\\/$/, '')}/subscribe/${productKey}/${planKey}`;\n}\n","import type {\n    BillingInterval,\n    PricingFeature,\n    PricingPayload,\n    PricingTier,\n    TierMeta,\n} from './types';\n\nexport type FetchPricingConfig = {\n    baseUrl: string;\n    productKey: string;\n    tierMeta?: Record<string, TierMeta>;\n    yearlyMonthsFree?: number;\n    /** Override the global fetch (e.g. Node 18+ or custom retry). */\n    fetcher?: typeof fetch;\n};\n\ntype ApiFeature = {\n    key: string;\n    name: string;\n    description: string | null;\n};\n\ntype ApiPlan = {\n    key: string;\n    name: string;\n    description: string | null;\n    amount: number | null;\n    currency: string | null;\n    billing_interval: BillingInterval | null;\n    trial_period_days: number;\n    is_coming_soon?: boolean;\n    features: ApiFeature[];\n};\n\ntype ApiPayload = {\n    product: string;\n    name: string;\n    description: string | null;\n    beta_active: boolean;\n    plans: ApiPlan[];\n};\n\nconst INTERVAL_SUFFIXES = ['_monthly', '_yearly', '_month', '_year', '_one_time'];\n\nfunction tierKeyFromPlanKey(planKey: string): string {\n    for (const suf of INTERVAL_SUFFIXES) {\n        if (planKey.endsWith(suf)) {\n            return planKey.slice(0, -suf.length);\n        }\n    }\n    return planKey;\n}\n\nfunction titleCase(s: string): string {\n    return s.replace(/[_-]+/g, ' ').replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n\nfunction emptyPayload(productKey: string): PricingPayload {\n    return { product: productKey, betaActive: false, tiers: [] };\n}\n\nfunction shapeFromApi(payload: ApiPayload, config: FetchPricingConfig): PricingPayload {\n    const meta = config.tierMeta ?? {};\n    const monthsFree = config.yearlyMonthsFree ?? 2;\n    const tiersMap = new Map<string, PricingTier>();\n\n    for (const plan of payload.plans) {\n        const tierKey = tierKeyFromPlanKey(plan.key);\n        const m = meta[tierKey];\n\n        if (!tiersMap.has(tierKey)) {\n            tiersMap.set(tierKey, {\n                key: tierKey,\n                name: m?.label ?? titleCase(tierKey),\n                tagline: m?.tagline ?? plan.description ?? '',\n                highlighted: m?.highlighted ?? false,\n                monthly: null,\n                yearly: null,\n                oneTime: null,\n                isComingSoon: false,\n                features: plan.features.map(\n                    (f): PricingFeature => ({ key: f.key, name: f.name, description: f.description }),\n                ),\n            });\n        }\n\n        const tier = tiersMap.get(tierKey)!;\n\n        if (plan.is_coming_soon === true) {\n            tier.isComingSoon = true;\n        }\n\n        if (tier.features.length === 0 && plan.features.length > 0) {\n            tier.features = plan.features.map((f) => ({ key: f.key, name: f.name, description: f.description }));\n        }\n\n        if (plan.billing_interval === 'month' && plan.amount !== null && plan.currency !== null) {\n            tier.monthly = { amount: plan.amount, currency: plan.currency, planKey: plan.key };\n            continue;\n        }\n\n        if (plan.billing_interval === 'year' && plan.amount !== null && plan.currency !== null) {\n            tier.yearly = { amount: plan.amount, currency: plan.currency, monthsFree, planKey: plan.key };\n            continue;\n        }\n\n        if (plan.billing_interval === null) {\n            const amount = plan.amount ?? 0;\n            const currency = plan.currency ?? 'eur';\n            if (amount === 0) {\n                tier.monthly = { amount: 0, currency, planKey: plan.key };\n            } else {\n                tier.oneTime = { amount, currency, planKey: plan.key };\n            }\n        }\n    }\n\n    const tiers = Array.from(tiersMap.values()).sort((a, b) => {\n        const oa = meta[a.key]?.order ?? 999;\n        const ob = meta[b.key]?.order ?? 999;\n        return oa - ob;\n    });\n\n    return {\n        product: payload.product,\n        betaActive: payload.beta_active,\n        tiers,\n    };\n}\n\nexport async function fetchPricing(config: FetchPricingConfig): Promise<PricingPayload> {\n    const base = config.baseUrl?.replace(/\\/$/, '');\n    if (!base) return emptyPayload(config.productKey);\n\n    const f = config.fetcher ?? globalThis.fetch;\n    if (!f) {\n        throw new Error('No fetch implementation available. Pass a fetcher in config or use Node 18+.');\n    }\n\n    try {\n        const res = await f(`${base}/api/v1/products/${config.productKey}/plans`, {\n            headers: { Accept: 'application/json' },\n        });\n        if (!res.ok) return emptyPayload(config.productKey);\n        const data = (await res.json()) as ApiPayload;\n        return shapeFromApi(data, config);\n    } catch {\n        return emptyPayload(config.productKey);\n    }\n}\n\nexport function formatPrice(amountInCents: number, currency: string): string {\n    const symbol = currency.toLowerCase() === 'eur' ? '€' : currency.toUpperCase() + ' ';\n    const major = (amountInCents / 100).toFixed(amountInCents % 100 === 0 ? 0 : 2);\n    return `${symbol}${major}`;\n}\n\nexport type { PricingFeature, PricingPayload, PricingTier, TierMeta };\n","import { checkoutUrl } from './checkout';\nimport { formatPrice } from './pricing';\nimport type { PricingTier, TierMeta } from './types';\n\nexport type IntervalKey = 'monthly' | 'yearly' | 'oneTime';\n\nexport type CtaProps = {\n    label: string;\n    href: string | null;\n    disabled: boolean;\n    monthlyHref: string | null;\n    yearlyHref: string | null;\n    oneTimeHref: string | null;\n};\n\nexport type CtaOptions = {\n    billingBaseUrl: string;\n    productKey: string;\n    tierMeta?: TierMeta;\n    interval?: IntervalKey;\n    freeLabel?: string;\n    subscribeLabel?: string;\n    buyLabel?: string;\n    comingSoonLabel?: string;\n};\n\nexport function isFreeTier(tier: PricingTier): boolean {\n    return tier.monthly?.amount === 0 && tier.yearly === null && tier.oneTime === null;\n}\n\nexport function isOneTimeTier(tier: PricingTier): boolean {\n    return tier.oneTime !== null && tier.monthly === null;\n}\n\nexport function hasYearly(tier: PricingTier): boolean {\n    return tier.yearly !== null && tier.monthly !== null;\n}\n\n/**\n * Resolves all CTA fields for a tier — label, primary href, per-interval\n * hrefs (so a UI toggle can hot-swap without re-deriving), and disabled\n * state for coming-soon plans. Replaces hand-rolled if/else trees in\n * landing pages.\n */\nexport function getCtaProps(tier: PricingTier, opts: CtaOptions): CtaProps {\n    const meta = opts.tierMeta;\n    const monthlyHref = tier.monthly\n        ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.monthly.planKey)\n        : null;\n    const yearlyHref = tier.yearly\n        ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.yearly.planKey)\n        : null;\n    const oneTimeHref = tier.oneTime\n        ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.oneTime.planKey)\n        : null;\n\n    if (tier.isComingSoon) {\n        return {\n            label: opts.comingSoonLabel ?? 'Coming soon',\n            href: null,\n            disabled: true,\n            monthlyHref,\n            yearlyHref,\n            oneTimeHref,\n        };\n    }\n\n    if (meta?.ctaHref) {\n        return {\n            label: meta.ctaLabel ?? 'Get started',\n            href: meta.ctaHref,\n            disabled: false,\n            monthlyHref,\n            yearlyHref,\n            oneTimeHref,\n        };\n    }\n\n    let primary: string | null;\n    let defaultLabel: string;\n\n    if (isFreeTier(tier)) {\n        primary = null;\n        defaultLabel = opts.freeLabel ?? 'Get started';\n    } else if (isOneTimeTier(tier)) {\n        primary = oneTimeHref;\n        defaultLabel = opts.buyLabel ?? 'Buy';\n    } else {\n        primary = opts.interval === 'yearly' ? yearlyHref ?? monthlyHref : monthlyHref;\n        defaultLabel = opts.subscribeLabel ?? 'Subscribe';\n    }\n\n    return {\n        label: meta?.ctaLabel ?? defaultLabel,\n        href: primary,\n        disabled: false,\n        monthlyHref,\n        yearlyHref,\n        oneTimeHref,\n    };\n}\n\nexport type FormattedPrice = {\n    amount: string;\n    suffix: string;\n    raw: { amount: number; currency: string } | null;\n    note?: string;\n};\n\n/**\n * Returns the price + suffix to render for a tier given the active\n * interval. Falls back gracefully: a tier with only monthly always\n * shows monthly; a free tier shows €0; a one-time tier shows the amount\n * with a 'one-time' suffix.\n */\nexport function getActivePrice(tier: PricingTier, interval: IntervalKey): FormattedPrice {\n    if (interval === 'yearly' && tier.yearly) {\n        return {\n            amount: formatPrice(tier.yearly.amount, tier.yearly.currency),\n            suffix: '/year',\n            raw: { amount: tier.yearly.amount, currency: tier.yearly.currency },\n            note: tier.yearly.monthsFree > 0 ? `${tier.yearly.monthsFree} months free` : undefined,\n        };\n    }\n\n    if (interval === 'oneTime' && tier.oneTime) {\n        return {\n            amount: formatPrice(tier.oneTime.amount, tier.oneTime.currency),\n            suffix: ' one-time',\n            raw: { amount: tier.oneTime.amount, currency: tier.oneTime.currency },\n        };\n    }\n\n    if (tier.monthly) {\n        return {\n            amount: formatPrice(tier.monthly.amount, tier.monthly.currency),\n            suffix: '/month',\n            raw: { amount: tier.monthly.amount, currency: tier.monthly.currency },\n        };\n    }\n\n    if (tier.oneTime) {\n        return {\n            amount: formatPrice(tier.oneTime.amount, tier.oneTime.currency),\n            suffix: ' one-time',\n            raw: { amount: tier.oneTime.amount, currency: tier.oneTime.currency },\n        };\n    }\n\n    return { amount: '—', suffix: '', raw: null };\n}\n\n/**\n * Picks the natural default interval for a list of tiers: 'yearly' if\n * any tier has a yearly option, else 'monthly'. Useful as the initial\n * state for a billing-interval toggle.\n */\nexport function defaultInterval(tiers: PricingTier[]): IntervalKey {\n    if (tiers.some(hasYearly)) return 'monthly';\n    if (tiers.every((t) => t.monthly === null && t.oneTime !== null)) return 'oneTime';\n    return 'monthly';\n}\n"]}

package/dist/helpers.d.cts

@@ -0,0 +1,55 @@
+import { T as TierMeta, b as PricingTier } from './types-CH4Vkivj.cjs';
+
+type IntervalKey = 'monthly' | 'yearly' | 'oneTime';
+type CtaProps = {
+    label: string;
+    href: string | null;
+    disabled: boolean;
+    monthlyHref: string | null;
+    yearlyHref: string | null;
+    oneTimeHref: string | null;
+};
+type CtaOptions = {
+    billingBaseUrl: string;
+    productKey: string;
+    tierMeta?: TierMeta;
+    interval?: IntervalKey;
+    freeLabel?: string;
+    subscribeLabel?: string;
+    buyLabel?: string;
+    comingSoonLabel?: string;
+};
+declare function isFreeTier(tier: PricingTier): boolean;
+declare function isOneTimeTier(tier: PricingTier): boolean;
+declare function hasYearly(tier: PricingTier): boolean;
+/**
+ * Resolves all CTA fields for a tier — label, primary href, per-interval
+ * hrefs (so a UI toggle can hot-swap without re-deriving), and disabled
+ * state for coming-soon plans. Replaces hand-rolled if/else trees in
+ * landing pages.
+ */
+declare function getCtaProps(tier: PricingTier, opts: CtaOptions): CtaProps;
+type FormattedPrice = {
+    amount: string;
+    suffix: string;
+    raw: {
+        amount: number;
+        currency: string;
+    } | null;
+    note?: string;
+};
+/**
+ * Returns the price + suffix to render for a tier given the active
+ * interval. Falls back gracefully: a tier with only monthly always
+ * shows monthly; a free tier shows €0; a one-time tier shows the amount
+ * with a 'one-time' suffix.
+ */
+declare function getActivePrice(tier: PricingTier, interval: IntervalKey): FormattedPrice;
+/**
+ * Picks the natural default interval for a list of tiers: 'yearly' if
+ * any tier has a yearly option, else 'monthly'. Useful as the initial
+ * state for a billing-interval toggle.
+ */
+declare function defaultInterval(tiers: PricingTier[]): IntervalKey;
+
+export { type CtaOptions, type CtaProps, type FormattedPrice, type IntervalKey, defaultInterval, getActivePrice, getCtaProps, hasYearly, isFreeTier, isOneTimeTier };

package/dist/helpers.d.ts

@@ -0,0 +1,55 @@
+import { T as TierMeta, b as PricingTier } from './types-CH4Vkivj.js';
+
+type IntervalKey = 'monthly' | 'yearly' | 'oneTime';
+type CtaProps = {
+    label: string;
+    href: string | null;
+    disabled: boolean;
+    monthlyHref: string | null;
+    yearlyHref: string | null;
+    oneTimeHref: string | null;
+};
+type CtaOptions = {
+    billingBaseUrl: string;
+    productKey: string;
+    tierMeta?: TierMeta;
+    interval?: IntervalKey;
+    freeLabel?: string;
+    subscribeLabel?: string;
+    buyLabel?: string;
+    comingSoonLabel?: string;
+};
+declare function isFreeTier(tier: PricingTier): boolean;
+declare function isOneTimeTier(tier: PricingTier): boolean;
+declare function hasYearly(tier: PricingTier): boolean;
+/**
+ * Resolves all CTA fields for a tier — label, primary href, per-interval
+ * hrefs (so a UI toggle can hot-swap without re-deriving), and disabled
+ * state for coming-soon plans. Replaces hand-rolled if/else trees in
+ * landing pages.
+ */
+declare function getCtaProps(tier: PricingTier, opts: CtaOptions): CtaProps;
+type FormattedPrice = {
+    amount: string;
+    suffix: string;
+    raw: {
+        amount: number;
+        currency: string;
+    } | null;
+    note?: string;
+};
+/**
+ * Returns the price + suffix to render for a tier given the active
+ * interval. Falls back gracefully: a tier with only monthly always
+ * shows monthly; a free tier shows €0; a one-time tier shows the amount
+ * with a 'one-time' suffix.
+ */
+declare function getActivePrice(tier: PricingTier, interval: IntervalKey): FormattedPrice;
+/**
+ * Picks the natural default interval for a list of tiers: 'yearly' if
+ * any tier has a yearly option, else 'monthly'. Useful as the initial
+ * state for a billing-interval toggle.
+ */
+declare function defaultInterval(tiers: PricingTier[]): IntervalKey;
+
+export { type CtaOptions, type CtaProps, type FormattedPrice, type IntervalKey, defaultInterval, getActivePrice, getCtaProps, hasYearly, isFreeTier, isOneTimeTier };

package/dist/helpers.js

@@ -0,0 +1,109 @@
+// src/checkout.ts
+function checkoutUrl(baseUrl, productKey, planKey) {
+  return `${baseUrl.replace(/\/$/, "")}/subscribe/${productKey}/${planKey}`;
+}
+
+// src/pricing.ts
+function formatPrice(amountInCents, currency) {
+  const symbol = currency.toLowerCase() === "eur" ? "\u20AC" : currency.toUpperCase() + " ";
+  const major = (amountInCents / 100).toFixed(amountInCents % 100 === 0 ? 0 : 2);
+  return `${symbol}${major}`;
+}
+
+// src/helpers.ts
+function isFreeTier(tier) {
+  return tier.monthly?.amount === 0 && tier.yearly === null && tier.oneTime === null;
+}
+function isOneTimeTier(tier) {
+  return tier.oneTime !== null && tier.monthly === null;
+}
+function hasYearly(tier) {
+  return tier.yearly !== null && tier.monthly !== null;
+}
+function getCtaProps(tier, opts) {
+  const meta = opts.tierMeta;
+  const monthlyHref = tier.monthly ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.monthly.planKey) : null;
+  const yearlyHref = tier.yearly ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.yearly.planKey) : null;
+  const oneTimeHref = tier.oneTime ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.oneTime.planKey) : null;
+  if (tier.isComingSoon) {
+    return {
+      label: opts.comingSoonLabel ?? "Coming soon",
+      href: null,
+      disabled: true,
+      monthlyHref,
+      yearlyHref,
+      oneTimeHref
+    };
+  }
+  if (meta?.ctaHref) {
+    return {
+      label: meta.ctaLabel ?? "Get started",
+      href: meta.ctaHref,
+      disabled: false,
+      monthlyHref,
+      yearlyHref,
+      oneTimeHref
+    };
+  }
+  let primary;
+  let defaultLabel;
+  if (isFreeTier(tier)) {
+    primary = null;
+    defaultLabel = opts.freeLabel ?? "Get started";
+  } else if (isOneTimeTier(tier)) {
+    primary = oneTimeHref;
+    defaultLabel = opts.buyLabel ?? "Buy";
+  } else {
+    primary = opts.interval === "yearly" ? yearlyHref ?? monthlyHref : monthlyHref;
+    defaultLabel = opts.subscribeLabel ?? "Subscribe";
+  }
+  return {
+    label: meta?.ctaLabel ?? defaultLabel,
+    href: primary,
+    disabled: false,
+    monthlyHref,
+    yearlyHref,
+    oneTimeHref
+  };
+}
+function getActivePrice(tier, interval) {
+  if (interval === "yearly" && tier.yearly) {
+    return {
+      amount: formatPrice(tier.yearly.amount, tier.yearly.currency),
+      suffix: "/year",
+      raw: { amount: tier.yearly.amount, currency: tier.yearly.currency },
+      note: tier.yearly.monthsFree > 0 ? `${tier.yearly.monthsFree} months free` : void 0
+    };
+  }
+  if (interval === "oneTime" && tier.oneTime) {
+    return {
+      amount: formatPrice(tier.oneTime.amount, tier.oneTime.currency),
+      suffix: " one-time",
+      raw: { amount: tier.oneTime.amount, currency: tier.oneTime.currency }
+    };
+  }
+  if (tier.monthly) {
+    return {
+      amount: formatPrice(tier.monthly.amount, tier.monthly.currency),
+      suffix: "/month",
+      raw: { amount: tier.monthly.amount, currency: tier.monthly.currency }
+    };
+  }
+  if (tier.oneTime) {
+    return {
+      amount: formatPrice(tier.oneTime.amount, tier.oneTime.currency),
+      suffix: " one-time",
+      raw: { amount: tier.oneTime.amount, currency: tier.oneTime.currency }
+    };
+  }
+  return { amount: "\u2014", suffix: "", raw: null };
+}
+function defaultInterval(tiers) {
+  if (tiers.some(hasYearly)) return "monthly";
+  if (tiers.every((t) => t.monthly === null && t.oneTime !== null)) return "oneTime";
+  return "monthly";
+}
+
+export { defaultInterval, getActivePrice, getCtaProps, hasYearly, isFreeTier, isOneTimeTier };
+//# sourceMappingURL=helpers.js.map
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/checkout.ts","../src/pricing.ts","../src/helpers.ts"],"names":[],"mappings":"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","file":"helpers.js","sourcesContent":["export function checkoutUrl(baseUrl: string, productKey: string, planKey: string): string {\n    return `${baseUrl.replace(/\\/$/, '')}/subscribe/${productKey}/${planKey}`;\n}\n","import type {\n    BillingInterval,\n    PricingFeature,\n    PricingPayload,\n    PricingTier,\n    TierMeta,\n} from './types';\n\nexport type FetchPricingConfig = {\n    baseUrl: string;\n    productKey: string;\n    tierMeta?: Record<string, TierMeta>;\n    yearlyMonthsFree?: number;\n    /** Override the global fetch (e.g. Node 18+ or custom retry). */\n    fetcher?: typeof fetch;\n};\n\ntype ApiFeature = {\n    key: string;\n    name: string;\n    description: string | null;\n};\n\ntype ApiPlan = {\n    key: string;\n    name: string;\n    description: string | null;\n    amount: number | null;\n    currency: string | null;\n    billing_interval: BillingInterval | null;\n    trial_period_days: number;\n    is_coming_soon?: boolean;\n    features: ApiFeature[];\n};\n\ntype ApiPayload = {\n    product: string;\n    name: string;\n    description: string | null;\n    beta_active: boolean;\n    plans: ApiPlan[];\n};\n\nconst INTERVAL_SUFFIXES = ['_monthly', '_yearly', '_month', '_year', '_one_time'];\n\nfunction tierKeyFromPlanKey(planKey: string): string {\n    for (const suf of INTERVAL_SUFFIXES) {\n        if (planKey.endsWith(suf)) {\n            return planKey.slice(0, -suf.length);\n        }\n    }\n    return planKey;\n}\n\nfunction titleCase(s: string): string {\n    return s.replace(/[_-]+/g, ' ').replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n\nfunction emptyPayload(productKey: string): PricingPayload {\n    return { product: productKey, betaActive: false, tiers: [] };\n}\n\nfunction shapeFromApi(payload: ApiPayload, config: FetchPricingConfig): PricingPayload {\n    const meta = config.tierMeta ?? {};\n    const monthsFree = config.yearlyMonthsFree ?? 2;\n    const tiersMap = new Map<string, PricingTier>();\n\n    for (const plan of payload.plans) {\n        const tierKey = tierKeyFromPlanKey(plan.key);\n        const m = meta[tierKey];\n\n        if (!tiersMap.has(tierKey)) {\n            tiersMap.set(tierKey, {\n                key: tierKey,\n                name: m?.label ?? titleCase(tierKey),\n                tagline: m?.tagline ?? plan.description ?? '',\n                highlighted: m?.highlighted ?? false,\n                monthly: null,\n                yearly: null,\n                oneTime: null,\n                isComingSoon: false,\n                features: plan.features.map(\n                    (f): PricingFeature => ({ key: f.key, name: f.name, description: f.description }),\n                ),\n            });\n        }\n\n        const tier = tiersMap.get(tierKey)!;\n\n        if (plan.is_coming_soon === true) {\n            tier.isComingSoon = true;\n        }\n\n        if (tier.features.length === 0 && plan.features.length > 0) {\n            tier.features = plan.features.map((f) => ({ key: f.key, name: f.name, description: f.description }));\n        }\n\n        if (plan.billing_interval === 'month' && plan.amount !== null && plan.currency !== null) {\n            tier.monthly = { amount: plan.amount, currency: plan.currency, planKey: plan.key };\n            continue;\n        }\n\n        if (plan.billing_interval === 'year' && plan.amount !== null && plan.currency !== null) {\n            tier.yearly = { amount: plan.amount, currency: plan.currency, monthsFree, planKey: plan.key };\n            continue;\n        }\n\n        if (plan.billing_interval === null) {\n            const amount = plan.amount ?? 0;\n            const currency = plan.currency ?? 'eur';\n            if (amount === 0) {\n                tier.monthly = { amount: 0, currency, planKey: plan.key };\n            } else {\n                tier.oneTime = { amount, currency, planKey: plan.key };\n            }\n        }\n    }\n\n    const tiers = Array.from(tiersMap.values()).sort((a, b) => {\n        const oa = meta[a.key]?.order ?? 999;\n        const ob = meta[b.key]?.order ?? 999;\n        return oa - ob;\n    });\n\n    return {\n        product: payload.product,\n        betaActive: payload.beta_active,\n        tiers,\n    };\n}\n\nexport async function fetchPricing(config: FetchPricingConfig): Promise<PricingPayload> {\n    const base = config.baseUrl?.replace(/\\/$/, '');\n    if (!base) return emptyPayload(config.productKey);\n\n    const f = config.fetcher ?? globalThis.fetch;\n    if (!f) {\n        throw new Error('No fetch implementation available. Pass a fetcher in config or use Node 18+.');\n    }\n\n    try {\n        const res = await f(`${base}/api/v1/products/${config.productKey}/plans`, {\n            headers: { Accept: 'application/json' },\n        });\n        if (!res.ok) return emptyPayload(config.productKey);\n        const data = (await res.json()) as ApiPayload;\n        return shapeFromApi(data, config);\n    } catch {\n        return emptyPayload(config.productKey);\n    }\n}\n\nexport function formatPrice(amountInCents: number, currency: string): string {\n    const symbol = currency.toLowerCase() === 'eur' ? '€' : currency.toUpperCase() + ' ';\n    const major = (amountInCents / 100).toFixed(amountInCents % 100 === 0 ? 0 : 2);\n    return `${symbol}${major}`;\n}\n\nexport type { PricingFeature, PricingPayload, PricingTier, TierMeta };\n","import { checkoutUrl } from './checkout';\nimport { formatPrice } from './pricing';\nimport type { PricingTier, TierMeta } from './types';\n\nexport type IntervalKey = 'monthly' | 'yearly' | 'oneTime';\n\nexport type CtaProps = {\n    label: string;\n    href: string | null;\n    disabled: boolean;\n    monthlyHref: string | null;\n    yearlyHref: string | null;\n    oneTimeHref: string | null;\n};\n\nexport type CtaOptions = {\n    billingBaseUrl: string;\n    productKey: string;\n    tierMeta?: TierMeta;\n    interval?: IntervalKey;\n    freeLabel?: string;\n    subscribeLabel?: string;\n    buyLabel?: string;\n    comingSoonLabel?: string;\n};\n\nexport function isFreeTier(tier: PricingTier): boolean {\n    return tier.monthly?.amount === 0 && tier.yearly === null && tier.oneTime === null;\n}\n\nexport function isOneTimeTier(tier: PricingTier): boolean {\n    return tier.oneTime !== null && tier.monthly === null;\n}\n\nexport function hasYearly(tier: PricingTier): boolean {\n    return tier.yearly !== null && tier.monthly !== null;\n}\n\n/**\n * Resolves all CTA fields for a tier — label, primary href, per-interval\n * hrefs (so a UI toggle can hot-swap without re-deriving), and disabled\n * state for coming-soon plans. Replaces hand-rolled if/else trees in\n * landing pages.\n */\nexport function getCtaProps(tier: PricingTier, opts: CtaOptions): CtaProps {\n    const meta = opts.tierMeta;\n    const monthlyHref = tier.monthly\n        ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.monthly.planKey)\n        : null;\n    const yearlyHref = tier.yearly\n        ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.yearly.planKey)\n        : null;\n    const oneTimeHref = tier.oneTime\n        ? checkoutUrl(opts.billingBaseUrl, opts.productKey, tier.oneTime.planKey)\n        : null;\n\n    if (tier.isComingSoon) {\n        return {\n            label: opts.comingSoonLabel ?? 'Coming soon',\n            href: null,\n            disabled: true,\n            monthlyHref,\n            yearlyHref,\n            oneTimeHref,\n        };\n    }\n\n    if (meta?.ctaHref) {\n        return {\n            label: meta.ctaLabel ?? 'Get started',\n            href: meta.ctaHref,\n            disabled: false,\n            monthlyHref,\n            yearlyHref,\n            oneTimeHref,\n        };\n    }\n\n    let primary: string | null;\n    let defaultLabel: string;\n\n    if (isFreeTier(tier)) {\n        primary = null;\n        defaultLabel = opts.freeLabel ?? 'Get started';\n    } else if (isOneTimeTier(tier)) {\n        primary = oneTimeHref;\n        defaultLabel = opts.buyLabel ?? 'Buy';\n    } else {\n        primary = opts.interval === 'yearly' ? yearlyHref ?? monthlyHref : monthlyHref;\n        defaultLabel = opts.subscribeLabel ?? 'Subscribe';\n    }\n\n    return {\n        label: meta?.ctaLabel ?? defaultLabel,\n        href: primary,\n        disabled: false,\n        monthlyHref,\n        yearlyHref,\n        oneTimeHref,\n    };\n}\n\nexport type FormattedPrice = {\n    amount: string;\n    suffix: string;\n    raw: { amount: number; currency: string } | null;\n    note?: string;\n};\n\n/**\n * Returns the price + suffix to render for a tier given the active\n * interval. Falls back gracefully: a tier with only monthly always\n * shows monthly; a free tier shows €0; a one-time tier shows the amount\n * with a 'one-time' suffix.\n */\nexport function getActivePrice(tier: PricingTier, interval: IntervalKey): FormattedPrice {\n    if (interval === 'yearly' && tier.yearly) {\n        return {\n            amount: formatPrice(tier.yearly.amount, tier.yearly.currency),\n            suffix: '/year',\n            raw: { amount: tier.yearly.amount, currency: tier.yearly.currency },\n            note: tier.yearly.monthsFree > 0 ? `${tier.yearly.monthsFree} months free` : undefined,\n        };\n    }\n\n    if (interval === 'oneTime' && tier.oneTime) {\n        return {\n            amount: formatPrice(tier.oneTime.amount, tier.oneTime.currency),\n            suffix: ' one-time',\n            raw: { amount: tier.oneTime.amount, currency: tier.oneTime.currency },\n        };\n    }\n\n    if (tier.monthly) {\n        return {\n            amount: formatPrice(tier.monthly.amount, tier.monthly.currency),\n            suffix: '/month',\n            raw: { amount: tier.monthly.amount, currency: tier.monthly.currency },\n        };\n    }\n\n    if (tier.oneTime) {\n        return {\n            amount: formatPrice(tier.oneTime.amount, tier.oneTime.currency),\n            suffix: ' one-time',\n            raw: { amount: tier.oneTime.amount, currency: tier.oneTime.currency },\n        };\n    }\n\n    return { amount: '—', suffix: '', raw: null };\n}\n\n/**\n * Picks the natural default interval for a list of tiers: 'yearly' if\n * any tier has a yearly option, else 'monthly'. Useful as the initial\n * state for a billing-interval toggle.\n */\nexport function defaultInterval(tiers: PricingTier[]): IntervalKey {\n    if (tiers.some(hasYearly)) return 'monthly';\n    if (tiers.every((t) => t.monthly === null && t.oneTime !== null)) return 'oneTime';\n    return 'monthly';\n}\n"]}