@akira-io/billing-js 0.1.0

package/dist/pricing.js

@@ -0,0 +1,101 @@
+// src/pricing.ts
+var INTERVAL_SUFFIXES = ["_monthly", "_yearly", "_month", "_year", "_one_time"];
+function tierKeyFromPlanKey(planKey) {
+  for (const suf of INTERVAL_SUFFIXES) {
+    if (planKey.endsWith(suf)) {
+      return planKey.slice(0, -suf.length);
+    }
+  }
+  return planKey;
+}
+function titleCase(s) {
+  return s.replace(/[_-]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function emptyPayload(productKey) {
+  return { product: productKey, betaActive: false, tiers: [] };
+}
+function shapeFromApi(payload, config) {
+  const meta = config.tierMeta ?? {};
+  const monthsFree = config.yearlyMonthsFree ?? 2;
+  const tiersMap = /* @__PURE__ */ new Map();
+  for (const plan of payload.plans) {
+    const tierKey = tierKeyFromPlanKey(plan.key);
+    const m = meta[tierKey];
+    if (!tiersMap.has(tierKey)) {
+      tiersMap.set(tierKey, {
+        key: tierKey,
+        name: m?.label ?? titleCase(tierKey),
+        tagline: m?.tagline ?? plan.description ?? "",
+        highlighted: m?.highlighted ?? false,
+        monthly: null,
+        yearly: null,
+        oneTime: null,
+        isComingSoon: false,
+        features: plan.features.map(
+          (f) => ({ key: f.key, name: f.name, description: f.description })
+        )
+      });
+    }
+    const tier = tiersMap.get(tierKey);
+    if (plan.is_coming_soon === true) {
+      tier.isComingSoon = true;
+    }
+    if (tier.features.length === 0 && plan.features.length > 0) {
+      tier.features = plan.features.map((f) => ({ key: f.key, name: f.name, description: f.description }));
+    }
+    if (plan.billing_interval === "month" && plan.amount !== null && plan.currency !== null) {
+      tier.monthly = { amount: plan.amount, currency: plan.currency, planKey: plan.key };
+      continue;
+    }
+    if (plan.billing_interval === "year" && plan.amount !== null && plan.currency !== null) {
+      tier.yearly = { amount: plan.amount, currency: plan.currency, monthsFree, planKey: plan.key };
+      continue;
+    }
+    if (plan.billing_interval === null) {
+      const amount = plan.amount ?? 0;
+      const currency = plan.currency ?? "eur";
+      if (amount === 0) {
+        tier.monthly = { amount: 0, currency, planKey: plan.key };
+      } else {
+        tier.oneTime = { amount, currency, planKey: plan.key };
+      }
+    }
+  }
+  const tiers = Array.from(tiersMap.values()).sort((a, b) => {
+    const oa = meta[a.key]?.order ?? 999;
+    const ob = meta[b.key]?.order ?? 999;
+    return oa - ob;
+  });
+  return {
+    product: payload.product,
+    betaActive: payload.beta_active,
+    tiers
+  };
+}
+async function fetchPricing(config) {
+  const base = config.baseUrl?.replace(/\/$/, "");
+  if (!base) return emptyPayload(config.productKey);
+  const f = config.fetcher ?? globalThis.fetch;
+  if (!f) {
+    throw new Error("No fetch implementation available. Pass a fetcher in config or use Node 18+.");
+  }
+  try {
+    const res = await f(`${base}/api/v1/products/${config.productKey}/plans`, {
+      headers: { Accept: "application/json" }
+    });
+    if (!res.ok) return emptyPayload(config.productKey);
+    const data = await res.json();
+    return shapeFromApi(data, config);
+  } catch {
+    return emptyPayload(config.productKey);
+  }
+}
+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}`;
+}
+
+export { fetchPricing, formatPrice };
+//# sourceMappingURL=pricing.js.map
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pricing.ts"],"names":[],"mappings":"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","file":"pricing.js","sourcesContent":["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"]}

package/dist/react.cjs

@@ -0,0 +1,219 @@
+'use strict';
+
+var react = require('react');
+
+// src/react.ts
+
+// src/pricing.ts
+var INTERVAL_SUFFIXES = ["_monthly", "_yearly", "_month", "_year", "_one_time"];
+function tierKeyFromPlanKey(planKey) {
+  for (const suf of INTERVAL_SUFFIXES) {
+    if (planKey.endsWith(suf)) {
+      return planKey.slice(0, -suf.length);
+    }
+  }
+  return planKey;
+}
+function titleCase(s) {
+  return s.replace(/[_-]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function emptyPayload(productKey) {
+  return { product: productKey, betaActive: false, tiers: [] };
+}
+function shapeFromApi(payload, config) {
+  const meta = config.tierMeta ?? {};
+  const monthsFree = config.yearlyMonthsFree ?? 2;
+  const tiersMap = /* @__PURE__ */ new Map();
+  for (const plan of payload.plans) {
+    const tierKey = tierKeyFromPlanKey(plan.key);
+    const m = meta[tierKey];
+    if (!tiersMap.has(tierKey)) {
+      tiersMap.set(tierKey, {
+        key: tierKey,
+        name: m?.label ?? titleCase(tierKey),
+        tagline: m?.tagline ?? plan.description ?? "",
+        highlighted: m?.highlighted ?? false,
+        monthly: null,
+        yearly: null,
+        oneTime: null,
+        isComingSoon: false,
+        features: plan.features.map(
+          (f) => ({ key: f.key, name: f.name, description: f.description })
+        )
+      });
+    }
+    const tier = tiersMap.get(tierKey);
+    if (plan.is_coming_soon === true) {
+      tier.isComingSoon = true;
+    }
+    if (tier.features.length === 0 && plan.features.length > 0) {
+      tier.features = plan.features.map((f) => ({ key: f.key, name: f.name, description: f.description }));
+    }
+    if (plan.billing_interval === "month" && plan.amount !== null && plan.currency !== null) {
+      tier.monthly = { amount: plan.amount, currency: plan.currency, planKey: plan.key };
+      continue;
+    }
+    if (plan.billing_interval === "year" && plan.amount !== null && plan.currency !== null) {
+      tier.yearly = { amount: plan.amount, currency: plan.currency, monthsFree, planKey: plan.key };
+      continue;
+    }
+    if (plan.billing_interval === null) {
+      const amount = plan.amount ?? 0;
+      const currency = plan.currency ?? "eur";
+      if (amount === 0) {
+        tier.monthly = { amount: 0, currency, planKey: plan.key };
+      } else {
+        tier.oneTime = { amount, currency, planKey: plan.key };
+      }
+    }
+  }
+  const tiers = Array.from(tiersMap.values()).sort((a, b) => {
+    const oa = meta[a.key]?.order ?? 999;
+    const ob = meta[b.key]?.order ?? 999;
+    return oa - ob;
+  });
+  return {
+    product: payload.product,
+    betaActive: payload.beta_active,
+    tiers
+  };
+}
+async function fetchPricing(config) {
+  const base = config.baseUrl?.replace(/\/$/, "");
+  if (!base) return emptyPayload(config.productKey);
+  const f = config.fetcher ?? globalThis.fetch;
+  if (!f) {
+    throw new Error("No fetch implementation available. Pass a fetcher in config or use Node 18+.");
+  }
+  try {
+    const res = await f(`${base}/api/v1/products/${config.productKey}/plans`, {
+      headers: { Accept: "application/json" }
+    });
+    if (!res.ok) return emptyPayload(config.productKey);
+    const data = await res.json();
+    return shapeFromApi(data, config);
+  } catch {
+    return emptyPayload(config.productKey);
+  }
+}
+
+// src/downloads.ts
+function downloadUrl(config) {
+  const base = config.baseUrl.replace(/\/$/, "");
+  const path = `/api/v1/downloads/${config.product}/${config.channel}/${config.platform}`;
+  const params = new URLSearchParams();
+  for (const [k, v] of Object.entries(config.query ?? {})) {
+    if (v !== void 0 && v !== "") params.set(k, v);
+  }
+  const qs = params.toString();
+  return qs ? `${base}${path}?${qs}` : `${base}${path}`;
+}
+async function issueDownload(config) {
+  const f = config.fetcher ?? globalThis.fetch;
+  if (!f) {
+    throw new Error("No fetch implementation available. Pass a fetcher in config or use Node 18+.");
+  }
+  const url = downloadUrl(config);
+  const res = await f(url, { headers: { Accept: "application/json" } });
+  if (!res.ok) {
+    throw new Error(`download issue failed: HTTP ${res.status}`);
+  }
+  return await res.json();
+}
+function sendCompletionBeacon(beaconUrl) {
+  if (typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function") {
+    navigator.sendBeacon(beaconUrl);
+    return;
+  }
+  if (typeof fetch !== "undefined") {
+    void fetch(beaconUrl, { method: "POST", keepalive: true }).catch(() => {
+    });
+  }
+}
+async function triggerDownload(config) {
+  const issued = await issueDownload(config);
+  const delay = config.beaconDelayMs ?? 1500;
+  if (typeof window !== "undefined") {
+    window.location.href = issued.signedUrl;
+    setTimeout(() => sendCompletionBeacon(issued.beaconUrl), delay);
+  }
+  return issued;
+}
+
+// src/helpers.ts
+function hasYearly(tier) {
+  return tier.yearly !== null && tier.monthly !== null;
+}
+function defaultInterval(tiers) {
+  if (tiers.some(hasYearly)) return "monthly";
+  if (tiers.every((t) => t.monthly === null && t.oneTime !== null)) return "oneTime";
+  return "monthly";
+}
+
+// src/react.ts
+function usePricing(config) {
+  const [data, setData] = react.useState(null);
+  const [error, setError] = react.useState(null);
+  const [isLoading, setIsLoading] = react.useState(true);
+  const [tick, setTick] = react.useState(0);
+  react.useEffect(() => {
+    let alive = true;
+    setIsLoading(true);
+    setError(null);
+    fetchPricing(config).then((p) => {
+      if (alive) setData(p);
+    }).catch((e) => {
+      if (alive) setError(e instanceof Error ? e : new Error(String(e)));
+    }).finally(() => {
+      if (alive) setIsLoading(false);
+    });
+    return () => {
+      alive = false;
+    };
+  }, [config.baseUrl, config.productKey, config.yearlyMonthsFree, tick]);
+  const refresh = react.useCallback(() => setTick((t) => t + 1), []);
+  return { data, error, isLoading, refresh };
+}
+function useBillingInterval(tiers) {
+  const initial = react.useMemo(() => defaultInterval(tiers ?? []), [tiers]);
+  const [interval, setInterval] = react.useState(initial);
+  react.useEffect(() => {
+    setInterval(initial);
+  }, [initial]);
+  const toggle = react.useCallback(
+    () => setInterval((cur) => cur === "monthly" ? "yearly" : "monthly"),
+    []
+  );
+  return { interval, setInterval, toggle };
+}
+function useDownload(config) {
+  const [isPending, setIsPending] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const [lastIssued, setLastIssued] = react.useState(null);
+  const trigger = react.useCallback(async () => {
+    setIsPending(true);
+    setError(null);
+    try {
+      const issued = await triggerDownload(config);
+      setLastIssued(issued);
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error(String(e)));
+    } finally {
+      setIsPending(false);
+    }
+  }, [
+    config.baseUrl,
+    config.product,
+    config.channel,
+    config.platform,
+    config.beaconDelayMs,
+    JSON.stringify(config.query ?? {})
+  ]);
+  return { trigger, isPending, error, lastIssued };
+}
+
+exports.useBillingInterval = useBillingInterval;
+exports.useDownload = useDownload;
+exports.usePricing = usePricing;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pricing.ts","../src/downloads.ts","../src/helpers.ts","../src/react.ts"],"names":["useState","useEffect","useCallback","useMemo"],"mappings":"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","file":"react.cjs","sourcesContent":["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 type { AssetPlatform, IssuedDownload, ReleaseChannel } from './types';\n\nexport type DownloadConfig = {\n    baseUrl: string;\n    product: string;\n    channel: ReleaseChannel;\n    platform: AssetPlatform;\n    /** Optional UTM + landing tracking. */\n    query?: Record<string, string | undefined>;\n    /** Delay before firing the completion beacon, ms. Default 1500. */\n    beaconDelayMs?: number;\n    fetcher?: typeof fetch;\n};\n\nexport function downloadUrl(config: Pick<DownloadConfig, 'baseUrl' | 'product' | 'channel' | 'platform' | 'query'>): string {\n    const base = config.baseUrl.replace(/\\/$/, '');\n    const path = `/api/v1/downloads/${config.product}/${config.channel}/${config.platform}`;\n    const params = new URLSearchParams();\n    for (const [k, v] of Object.entries(config.query ?? {})) {\n        if (v !== undefined && v !== '') params.set(k, v);\n    }\n    const qs = params.toString();\n    return qs ? `${base}${path}?${qs}` : `${base}${path}`;\n}\n\n/**\n * Issues a download via the billing API and returns the signed asset URL +\n * beacon URL without redirecting. Useful when you want full control of the\n * UX (e.g. fetch then trigger your own `<a download>` flow).\n */\nexport async function issueDownload(config: DownloadConfig): Promise<IssuedDownload> {\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    const url = downloadUrl(config);\n    const res = await f(url, { headers: { Accept: 'application/json' } });\n\n    if (!res.ok) {\n        throw new Error(`download issue failed: HTTP ${res.status}`);\n    }\n\n    return (await res.json()) as IssuedDownload;\n}\n\n/**\n * Fires the completion beacon for an issued download. Uses\n * `navigator.sendBeacon` when available (survives page navigation), falls\n * back to `fetch` with `keepalive: true`. Safe to call at unload time.\n */\nexport function sendCompletionBeacon(beaconUrl: string): void {\n    if (typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {\n        navigator.sendBeacon(beaconUrl);\n        return;\n    }\n\n    if (typeof fetch !== 'undefined') {\n        void fetch(beaconUrl, { method: 'POST', keepalive: true }).catch(() => {});\n    }\n}\n\n/**\n * One-shot helper for landing-page download CTAs: fetches a signed URL,\n * navigates the current tab to the asset, then schedules the completion\n * beacon. The function resolves once the navigation has been triggered.\n */\nexport async function triggerDownload(config: DownloadConfig): Promise<IssuedDownload> {\n    const issued = await issueDownload(config);\n    const delay = config.beaconDelayMs ?? 1500;\n\n    if (typeof window !== 'undefined') {\n        window.location.href = issued.signedUrl;\n        setTimeout(() => sendCompletionBeacon(issued.beaconUrl), delay);\n    }\n\n    return issued;\n}\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","import { useCallback, useEffect, useMemo, useState } from 'react';\nimport { fetchPricing, type FetchPricingConfig } from './pricing';\nimport { triggerDownload, type DownloadConfig } from './downloads';\nimport { defaultInterval, type IntervalKey } from './helpers';\nimport type { IssuedDownload, PricingPayload, PricingTier } from './types';\n\nexport type UsePricingResult = {\n    data: PricingPayload | null;\n    error: Error | null;\n    isLoading: boolean;\n    refresh: () => void;\n};\n\n/**\n * Fetches pricing for a product on mount (and whenever productKey/baseUrl\n * changes). Returns loading + error state plus a manual refresh callback.\n */\nexport function usePricing(config: FetchPricingConfig): UsePricingResult {\n    const [data, setData] = useState<PricingPayload | null>(null);\n    const [error, setError] = useState<Error | null>(null);\n    const [isLoading, setIsLoading] = useState<boolean>(true);\n    const [tick, setTick] = useState(0);\n\n    useEffect(() => {\n        let alive = true;\n        setIsLoading(true);\n        setError(null);\n\n        fetchPricing(config)\n            .then((p) => {\n                if (alive) setData(p);\n            })\n            .catch((e: unknown) => {\n                if (alive) setError(e instanceof Error ? e : new Error(String(e)));\n            })\n            .finally(() => {\n                if (alive) setIsLoading(false);\n            });\n\n        return () => {\n            alive = false;\n        };\n    }, [config.baseUrl, config.productKey, config.yearlyMonthsFree, tick]);\n\n    const refresh = useCallback(() => setTick((t) => t + 1), []);\n\n    return { data, error, isLoading, refresh };\n}\n\nexport type UseBillingIntervalResult = {\n    interval: IntervalKey;\n    setInterval: (next: IntervalKey) => void;\n    toggle: () => void;\n};\n\n/**\n * Local state for a monthly/yearly billing toggle. Default is derived\n * from the tier list (yearly when any tier has one, else monthly).\n */\nexport function useBillingInterval(tiers: PricingTier[] | null | undefined): UseBillingIntervalResult {\n    const initial = useMemo(() => defaultInterval(tiers ?? []), [tiers]);\n    const [interval, setInterval] = useState<IntervalKey>(initial);\n\n    useEffect(() => {\n        setInterval(initial);\n    }, [initial]);\n\n    const toggle = useCallback(\n        () => setInterval((cur) => (cur === 'monthly' ? 'yearly' : 'monthly')),\n        [],\n    );\n\n    return { interval, setInterval, toggle };\n}\n\nexport type UseDownloadResult = {\n    trigger: () => Promise<void>;\n    isPending: boolean;\n    error: Error | null;\n    lastIssued: IssuedDownload | null;\n};\n\n/**\n * Returns a memoized download trigger plus pending/error state for the\n * click handler. Wraps triggerDownload() under the hood.\n */\nexport function useDownload(config: DownloadConfig): UseDownloadResult {\n    const [isPending, setIsPending] = useState(false);\n    const [error, setError] = useState<Error | null>(null);\n    const [lastIssued, setLastIssued] = useState<IssuedDownload | null>(null);\n\n    const trigger = useCallback(async () => {\n        setIsPending(true);\n        setError(null);\n        try {\n            const issued = await triggerDownload(config);\n            setLastIssued(issued);\n        } catch (e: unknown) {\n            setError(e instanceof Error ? e : new Error(String(e)));\n        } finally {\n            setIsPending(false);\n        }\n    }, [\n        config.baseUrl,\n        config.product,\n        config.channel,\n        config.platform,\n        config.beaconDelayMs,\n        JSON.stringify(config.query ?? {}),\n    ]);\n\n    return { trigger, isPending, error, lastIssued };\n}\n"]}

package/dist/react.d.cts

@@ -0,0 +1,39 @@
+import { FetchPricingConfig } from './pricing.cjs';
+import { DownloadConfig } from './downloads.cjs';
+import { IntervalKey } from './helpers.cjs';
+import { I as IssuedDownload, a as PricingPayload, b as PricingTier } from './types-CH4Vkivj.cjs';
+
+type UsePricingResult = {
+    data: PricingPayload | null;
+    error: Error | null;
+    isLoading: boolean;
+    refresh: () => void;
+};
+/**
+ * Fetches pricing for a product on mount (and whenever productKey/baseUrl
+ * changes). Returns loading + error state plus a manual refresh callback.
+ */
+declare function usePricing(config: FetchPricingConfig): UsePricingResult;
+type UseBillingIntervalResult = {
+    interval: IntervalKey;
+    setInterval: (next: IntervalKey) => void;
+    toggle: () => void;
+};
+/**
+ * Local state for a monthly/yearly billing toggle. Default is derived
+ * from the tier list (yearly when any tier has one, else monthly).
+ */
+declare function useBillingInterval(tiers: PricingTier[] | null | undefined): UseBillingIntervalResult;
+type UseDownloadResult = {
+    trigger: () => Promise<void>;
+    isPending: boolean;
+    error: Error | null;
+    lastIssued: IssuedDownload | null;
+};
+/**
+ * Returns a memoized download trigger plus pending/error state for the
+ * click handler. Wraps triggerDownload() under the hood.
+ */
+declare function useDownload(config: DownloadConfig): UseDownloadResult;
+
+export { type UseBillingIntervalResult, type UseDownloadResult, type UsePricingResult, useBillingInterval, useDownload, usePricing };

package/dist/react.d.ts

@@ -0,0 +1,39 @@
+import { FetchPricingConfig } from './pricing.js';
+import { DownloadConfig } from './downloads.js';
+import { IntervalKey } from './helpers.js';
+import { I as IssuedDownload, a as PricingPayload, b as PricingTier } from './types-CH4Vkivj.js';
+
+type UsePricingResult = {
+    data: PricingPayload | null;
+    error: Error | null;
+    isLoading: boolean;
+    refresh: () => void;
+};
+/**
+ * Fetches pricing for a product on mount (and whenever productKey/baseUrl
+ * changes). Returns loading + error state plus a manual refresh callback.
+ */
+declare function usePricing(config: FetchPricingConfig): UsePricingResult;
+type UseBillingIntervalResult = {
+    interval: IntervalKey;
+    setInterval: (next: IntervalKey) => void;
+    toggle: () => void;
+};
+/**
+ * Local state for a monthly/yearly billing toggle. Default is derived
+ * from the tier list (yearly when any tier has one, else monthly).
+ */
+declare function useBillingInterval(tiers: PricingTier[] | null | undefined): UseBillingIntervalResult;
+type UseDownloadResult = {
+    trigger: () => Promise<void>;
+    isPending: boolean;
+    error: Error | null;
+    lastIssued: IssuedDownload | null;
+};
+/**
+ * Returns a memoized download trigger plus pending/error state for the
+ * click handler. Wraps triggerDownload() under the hood.
+ */
+declare function useDownload(config: DownloadConfig): UseDownloadResult;
+
+export { type UseBillingIntervalResult, type UseDownloadResult, type UsePricingResult, useBillingInterval, useDownload, usePricing };