@sudobility/sudojo_lib 0.0.200 → 0.0.203

package/dist/utils/shareUrl.js

@@ -1,24 +1,28 @@
 /**
- * Share URL builder and parser for Sudojo puzzle sharing.
+ * Share URL builder and parser for Sudojo sharing.
  *
- * - Daily puzzles share just `/daily`
- * - Level/enter puzzles share `/play/puzzle?level=...&original=...&user=...&autopencilmarks=...&pencilmarks=...&hint=...`
+ * Paths match the web app's routes (the RN app's deep-link config accepts the
+ * same paths):
+ *
+ * | type         | URL                                                     |
+ * |--------------|---------------------------------------------------------|
+ * | `daily`      | `/play/daily` (bare `/daily` has no web route)        |
+ * | `puzzle`     | `/play/puzzle?level=&original=&user=&autopencilmarks=&pencilmarks=&hint=` |
+ * | `levels`     | `/play` (the level list)                                |
+ * | `play`       | `/play/<level>`, or `/play` without a level             |
+ * | `enter`      | `/play/enter`                                           |
+ * | `techniques` | `/techniques`                                           |
+ * | `technique`  | `/techniques/<canonical path>[?hint=<step>]`            |
  *
  * Pencilmarks are appended as a raw comma-separated string (not URL-encoded)
  * to keep URLs readable.
  */
+import { isValidLevel } from '@sudobility/sudojo_types';
+import { toCanonicalTechniquePath } from './technique';
 const DEFAULT_DOMAIN = 'https://sudojo.com';
-/**
- * Build a share URL from game state.
- *
- * Pencilmarks are appended directly to the URL (without URLSearchParams
- * encoding) so commas remain as literal commas.
- */
-export function buildShareUrl(params) {
-    const domain = params.domain ?? DEFAULT_DOMAIN;
-    if (params.type === 'daily') {
-        return `${domain}/daily`;
-    }
+/** An empty 81-cell input string. */
+const EMPTY_INPUT = '0'.repeat(81);
+function buildPuzzleUrl(domain, params) {
     const searchParams = new URLSearchParams();
     if (params.level != null) {
         searchParams.set('level', String(params.level));
@@ -43,30 +47,75 @@ export function buildShareUrl(params) {
     }
     return url;
 }
+/**
+ * Build a share URL. See the table at the top of this file for each type.
+ *
+ * For `puzzle`, pencilmarks are appended directly to the URL (without
+ * URLSearchParams encoding) so commas remain as literal commas.
+ */
+export function buildShareUrl(params) {
+    const domain = params.domain ?? DEFAULT_DOMAIN;
+    switch (params.type) {
+        case 'daily':
+            return `${domain}/play/daily`;
+        case 'levels':
+            return `${domain}/play`;
+        case 'play':
+            return params.level != null
+                ? `${domain}/play/${params.level}`
+                : `${domain}/play`;
+        case 'enter':
+            return `${domain}/play/enter`;
+        case 'techniques':
+            return `${domain}/techniques`;
+        case 'technique': {
+            const slug = toCanonicalTechniquePath(params.path);
+            if (!slug)
+                return `${domain}/techniques`;
+            const hint = params.hint != null ? `?hint=${params.hint}` : '';
+            return `${domain}/techniques/${encodeURIComponent(slug)}${hint}`;
+        }
+        case 'puzzle':
+            return buildPuzzleUrl(domain, params);
+    }
+}
+function readParam(source, name) {
+    if (source instanceof URLSearchParams)
+        return source.get(name);
+    return source[name] ?? null;
+}
 /**
  * Parse share URL query parameters into game state.
- * Returns null if required params (original, user) are missing.
+ *
+ * Accepts URLSearchParams (web) or a plain object of strings (RN route
+ * params). Returns null if `original` is missing. A missing `user` (a bare
+ * puzzle share, e.g. a freshly entered puzzle) becomes 81 zeros.
+ * `level` is kept only when it is a valid level (1-12); `hint` only when it
+ * is a non-negative integer. When `level` is absent, callers fall back to the
+ * level the solver rates the puzzle at (`parsed.level ?? validatedLevel`).
  */
 export function parseShareParams(params) {
-    const original = params.get('original');
-    const user = params.get('user');
-    if (!original || !user) {
+    const original = readParam(params, 'original');
+    if (!original) {
         return null;
     }
-    const levelStr = params.get('level');
-    const hintStr = params.get('hint');
+    const levelStr = readParam(params, 'level');
+    const hintStr = readParam(params, 'hint');
     const result = {
         original,
-        user,
-        pencilmarks: params.get('pencilmarks') ?? '',
-        autopencilmarks: params.get('autopencilmarks') === 'true',
+        user: readParam(params, 'user') || EMPTY_INPUT,
+        pencilmarks: readParam(params, 'pencilmarks') ?? '',
+        autopencilmarks: readParam(params, 'autopencilmarks') === 'true',
     };
     if (levelStr) {
-        result.level = Number(levelStr);
+        const level = Number(levelStr);
+        if (isValidLevel(level)) {
+            result.level = level;
+        }
     }
-    if (hintStr != null) {
+    if (hintStr) {
         const hintNum = Number(hintStr);
-        if (!isNaN(hintNum) && hintNum >= 0) {
+        if (Number.isInteger(hintNum) && hintNum >= 0) {
             result.hint = hintNum;
         }
     }

package/dist/utils/shareUrl.js.map

@@ -1 +1 @@
-{"version":3,"file":"shareUrl.js","sourceRoot":"","sources":["../../src/utils/shareUrl.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Share URL builder and parser for Sudojo puzzle sharing.\n *\n * - Daily puzzles share just `/daily`\n * - Level/enter puzzles share `/play/puzzle?level=...&original=...&user=...&autopencilmarks=...&pencilmarks=...&hint=...`\n *\n * Pencilmarks are appended as a raw comma-separated string (not URL-encoded)\n * to keep URLs readable.\n */\n\nconst DEFAULT_DOMAIN = 'https://sudojo.com';\n\nexport interface ShareUrlParams {\n  type: 'daily' | 'puzzle';\n  /** 81-char original puzzle string */\n  original?: string;\n  /** 81-char user input string */\n  user?: string;\n  /** Comma-separated pencilmarks string (81 cells, 80 commas) */\n  pencilmarks?: string;\n  /** Whether auto-pencilmarks are enabled */\n  autopencilmarks?: boolean;\n  /** Difficulty level (1-based) */\n  level?: number;\n  /** Hint step index (0-based). Only included when hint is active. */\n  hint?: number;\n  /** Base domain (default: https://sudojo.com) */\n  domain?: string;\n}\n\nexport interface ParsedShareParams {\n  original: string;\n  user: string;\n  pencilmarks: string;\n  autopencilmarks: boolean;\n  level?: number;\n  hint?: number;\n}\n\n/**\n * Build a share URL from game state.\n *\n * Pencilmarks are appended directly to the URL (without URLSearchParams\n * encoding) so commas remain as literal commas.\n */\nexport function buildShareUrl(params: ShareUrlParams): string {\n  const domain = params.domain ?? DEFAULT_DOMAIN;\n\n  if (params.type === 'daily') {\n    return `${domain}/daily`;\n  }\n\n  const searchParams = new URLSearchParams();\n  if (params.level != null) {\n    searchParams.set('level', String(params.level));\n  }\n  if (params.original) {\n    searchParams.set('original', params.original);\n  }\n  if (params.user) {\n    searchParams.set('user', params.user);\n  }\n  if (params.autopencilmarks != null) {\n    searchParams.set('autopencilmarks', String(params.autopencilmarks));\n  }\n\n  let url = `${domain}/play/puzzle?${searchParams.toString()}`;\n\n  // Append pencilmarks raw (commas don't need encoding in URLs)\n  if (params.pencilmarks != null) {\n    url += `&pencilmarks=${params.pencilmarks}`;\n  }\n  // Append hint step\n  if (params.hint != null) {\n    url += `&hint=${params.hint}`;\n  }\n\n  return url;\n}\n\n/**\n * Parse share URL query parameters into game state.\n * Returns null if required params (original, user) are missing.\n */\nexport function parseShareParams(\n  params: URLSearchParams\n): ParsedShareParams | null {\n  const original = params.get('original');\n  const user = params.get('user');\n\n  if (!original || !user) {\n    return null;\n  }\n\n  const levelStr = params.get('level');\n  const hintStr = params.get('hint');\n\n  const result: ParsedShareParams = {\n    original,\n    user,\n    pencilmarks: params.get('pencilmarks') ?? '',\n    autopencilmarks: params.get('autopencilmarks') === 'true',\n  };\n  if (levelStr) {\n    result.level = Number(levelStr);\n  }\n  if (hintStr != null) {\n    const hintNum = Number(hintStr);\n    if (!isNaN(hintNum) && hintNum >= 0) {\n      result.hint = hintNum;\n    }\n  }\n  return result;\n}\n\n/**\n * Derive the web app URL from an API base URL.\n *\n * - Localhost: kept as-is (web app and API share the same server in dev)\n * - Production: strips the `api.` subdomain\n *   (e.g. `https://api.sudojo.com` → `https://sudojo.com`)\n */\nexport function getWebUrl(apiBaseUrl: string): string {\n  try {\n    const url = new URL(apiBaseUrl);\n    if (url.hostname !== 'localhost' && url.hostname.startsWith('api.')) {\n      url.hostname = url.hostname.replace(/^api\\./, '');\n    }\n    return url.origin;\n  } catch {\n    return DEFAULT_DOMAIN;\n  }\n}\n"]}
+{"version":3,"file":"shareUrl.js","sourceRoot":"","sources":["../../src/utils/shareUrl.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Share URL builder and parser for Sudojo sharing.\n *\n * Paths match the web app's routes (the RN app's deep-link config accepts the\n * same paths):\n *\n * | type         | URL                                                     |\n * |--------------|---------------------------------------------------------|\n * | `daily`      | `/play/daily` (bare `/daily` has no web route)        |\n * | `puzzle`     | `/play/puzzle?level=&original=&user=&autopencilmarks=&pencilmarks=&hint=` |\n * | `levels`     | `/play` (the level list)                                |\n * | `play`       | `/play/<level>`, or `/play` without a level             |\n * | `enter`      | `/play/enter`                                           |\n * | `techniques` | `/techniques`                                           |\n * | `technique`  | `/techniques/<canonical path>[?hint=<step>]`            |\n *\n * Pencilmarks are appended as a raw comma-separated string (not URL-encoded)\n * to keep URLs readable.\n */\n\nimport { isValidLevel } from '@sudobility/sudojo_types';\nimport { toCanonicalTechniquePath } from './technique';\n\nconst DEFAULT_DOMAIN = 'https://sudojo.com';\n\n/** An empty 81-cell input string. */\nconst EMPTY_INPUT = '0'.repeat(81);\n\n/** What a share URL points at. */\nexport type ShareUrlType =\n  | 'daily'\n  | 'puzzle'\n  | 'levels'\n  | 'play'\n  | 'enter'\n  | 'techniques'\n  | 'technique';\n\nexport interface ShareUrlParams {\n  type: ShareUrlType;\n  /** 81-char original puzzle string (`puzzle`) */\n  original?: string;\n  /** 81-char user input string (`puzzle`) */\n  user?: string;\n  /** Comma-separated pencilmarks string, 81 cells, 80 commas (`puzzle`) */\n  pencilmarks?: string;\n  /** Whether auto-pencilmarks are enabled (`puzzle`) */\n  autopencilmarks?: boolean;\n  /** Difficulty level, 1-based (`puzzle`, `play`) */\n  level?: number;\n  /** Hint step index, 0-based. Only included when a hint is active (`puzzle`, `technique`). */\n  hint?: number;\n  /** Technique path, API or canonical; shared as the canonical slug (`technique`) */\n  path?: string;\n  /** Base domain (default: https://sudojo.com) */\n  domain?: string;\n}\n\nexport interface ParsedShareParams {\n  original: string;\n  /** Player input; 81 zeros when the URL has none (a bare puzzle share). */\n  user: string;\n  pencilmarks: string;\n  autopencilmarks: boolean;\n  level?: number;\n  hint?: number;\n}\n\n/** Query values from URLSearchParams or a plain object (RN route params). */\nexport type ShareParamsSource =\n  | URLSearchParams\n  | Record<string, string | null | undefined>;\n\nfunction buildPuzzleUrl(domain: string, params: ShareUrlParams): string {\n  const searchParams = new URLSearchParams();\n  if (params.level != null) {\n    searchParams.set('level', String(params.level));\n  }\n  if (params.original) {\n    searchParams.set('original', params.original);\n  }\n  if (params.user) {\n    searchParams.set('user', params.user);\n  }\n  if (params.autopencilmarks != null) {\n    searchParams.set('autopencilmarks', String(params.autopencilmarks));\n  }\n\n  let url = `${domain}/play/puzzle?${searchParams.toString()}`;\n\n  // Append pencilmarks raw (commas don't need encoding in URLs)\n  if (params.pencilmarks != null) {\n    url += `&pencilmarks=${params.pencilmarks}`;\n  }\n  // Append hint step\n  if (params.hint != null) {\n    url += `&hint=${params.hint}`;\n  }\n\n  return url;\n}\n\n/**\n * Build a share URL. See the table at the top of this file for each type.\n *\n * For `puzzle`, pencilmarks are appended directly to the URL (without\n * URLSearchParams encoding) so commas remain as literal commas.\n */\nexport function buildShareUrl(params: ShareUrlParams): string {\n  const domain = params.domain ?? DEFAULT_DOMAIN;\n\n  switch (params.type) {\n    case 'daily':\n      return `${domain}/play/daily`;\n    case 'levels':\n      return `${domain}/play`;\n    case 'play':\n      return params.level != null\n        ? `${domain}/play/${params.level}`\n        : `${domain}/play`;\n    case 'enter':\n      return `${domain}/play/enter`;\n    case 'techniques':\n      return `${domain}/techniques`;\n    case 'technique': {\n      const slug = toCanonicalTechniquePath(params.path);\n      if (!slug) return `${domain}/techniques`;\n      const hint = params.hint != null ? `?hint=${params.hint}` : '';\n      return `${domain}/techniques/${encodeURIComponent(slug)}${hint}`;\n    }\n    case 'puzzle':\n      return buildPuzzleUrl(domain, params);\n  }\n}\n\nfunction readParam(source: ShareParamsSource, name: string): string | null {\n  if (source instanceof URLSearchParams) return source.get(name);\n  return source[name] ?? null;\n}\n\n/**\n * Parse share URL query parameters into game state.\n *\n * Accepts URLSearchParams (web) or a plain object of strings (RN route\n * params). Returns null if `original` is missing. A missing `user` (a bare\n * puzzle share, e.g. a freshly entered puzzle) becomes 81 zeros.\n * `level` is kept only when it is a valid level (1-12); `hint` only when it\n * is a non-negative integer. When `level` is absent, callers fall back to the\n * level the solver rates the puzzle at (`parsed.level ?? validatedLevel`).\n */\nexport function parseShareParams(\n  params: ShareParamsSource\n): ParsedShareParams | null {\n  const original = readParam(params, 'original');\n\n  if (!original) {\n    return null;\n  }\n\n  const levelStr = readParam(params, 'level');\n  const hintStr = readParam(params, 'hint');\n\n  const result: ParsedShareParams = {\n    original,\n    user: readParam(params, 'user') || EMPTY_INPUT,\n    pencilmarks: readParam(params, 'pencilmarks') ?? '',\n    autopencilmarks: readParam(params, 'autopencilmarks') === 'true',\n  };\n  if (levelStr) {\n    const level = Number(levelStr);\n    if (isValidLevel(level)) {\n      result.level = level;\n    }\n  }\n  if (hintStr) {\n    const hintNum = Number(hintStr);\n    if (Number.isInteger(hintNum) && hintNum >= 0) {\n      result.hint = hintNum;\n    }\n  }\n  return result;\n}\n\n/**\n * Derive the web app URL from an API base URL.\n *\n * - Localhost: kept as-is (web app and API share the same server in dev)\n * - Production: strips the `api.` subdomain\n *   (e.g. `https://api.sudojo.com` → `https://sudojo.com`)\n */\nexport function getWebUrl(apiBaseUrl: string): string {\n  try {\n    const url = new URL(apiBaseUrl);\n    if (url.hostname !== 'localhost' && url.hostname.startsWith('api.')) {\n      url.hostname = url.hostname.replace(/^api\\./, '');\n    }\n    return url.origin;\n  } catch {\n    return DEFAULT_DOMAIN;\n  }\n}\n"]}

package/dist/utils/subscription.d.ts

@@ -4,7 +4,9 @@
  * These functions work with RevenueCat SDK types to convert to our domain models.
  * The RevenueCat types are passed as generics to avoid direct SDK dependency.
  */
+import type { Level } from '@sudobility/sudojo_types';
 import type { Product, Subscription } from '../types/subscription';
+import type { TranslateFunction } from './localizedHint';
 /** RevenueCat Package shape (simplified) */
 interface RevenueCatPackage {
     identifier: string;
@@ -78,5 +80,121 @@ export declare function isBestValuePlan(period: string | undefined): boolean;
  * @returns User-friendly error message
  */
 export declare function getRevenueCatErrorMessage(errorCode: number): string;
+/**
+ * i18n key (in the `subscription` namespace) for a period's unit, or null.
+ * `P1W` → `periods.week`, `P1M` → `periods.month`, `P3M` → `periods.quarter`,
+ * `P6M` → `periods.halfYear`, `P1Y` / `P12M` → `periods.year`. Named periods
+ * (`monthly`, `yearly`, ...) are accepted too.
+ *
+ * The web paywall's copy had no week and no `P12M` (it showed no unit for
+ * them); both are mapped here.
+ */
+export declare function getPeriodLabelKey(period: string | null | undefined): string | null;
+/**
+ * Price suffix for a period, e.g. `/month`, or '' for an unknown period.
+ *
+ * @param tSub - Translate function for the `subscription` namespace
+ */
+export declare function getPeriodLabel(tSub: TranslateFunction, period: string | null | undefined): string;
+/**
+ * Whether a product is the "best value" plan: an annual period (`P1Y`, `P12M`,
+ * `yearly`) or an identifier containing `annual` / `yearly`
+ * (case-insensitive). Unifies the web paywall's check with isBestValuePlan.
+ */
+export declare function isBestValueProduct(product: {
+    period?: string | null;
+    identifier?: string | null;
+}): boolean;
+/**
+ * Length of a subscription period in months, or null when unknown.
+ *
+ * Accepts the named periods @sudobility/subscription_lib uses (`weekly` 1/4,
+ * `monthly` 1, `quarterly` 3, `yearly` 12, `lifetime` Infinity, matching its
+ * `periodToMonths`) and ISO 8601 durations (`P1W`, `P6M`, `P1Y`, `P30D`, ...).
+ */
+export declare function subscriptionPeriodToMonths(period: string | null | undefined): number | null;
+/** Price and period of a plan, for savings calculations. */
+export interface PricedPeriod {
+    /** Price in the store currency (major units) */
+    price: number;
+    /** Period, named (`monthly`) or ISO 8601 (`P1M`) */
+    period?: string | null;
+}
+/**
+ * Percent saved per month by `plan` compared with `base` (e.g. annual vs
+ * monthly), rounded; null when not comparable (same or unknown/lifetime
+ * period, missing product, zero base price) or when there is no saving.
+ * Port of the RN SubscriptionScreen's calcSavingsPercent.
+ */
+export declare function calculateSavingsPercent(base: PricedPeriod | null | undefined, plan: PricedPeriod | null | undefined): number | null;
+/**
+ * Whether the active subscription was bought on another platform than this
+ * client's (so it must be managed there). False when either side is unknown.
+ * Matches the RN SubscriptionScreen's isCrossPlatform.
+ */
+export declare function isCrossPlatformSubscription(purchasePlatform: string | null | undefined, clientPlatform: string | null | undefined): boolean;
+/** Why an account cannot be deleted right now. */
+export type DeleteAccountBlocker = 
+/** No signed-in user */
+'not_signed_in'
+/** Anonymous (guest) user: there is no account to delete */
+ | 'anonymous'
+/** An active subscription must be cancelled first */
+ | 'active_subscription';
+/** Result of canDeleteAccount. */
+export type DeleteAccountCheck = {
+    allowed: true;
+} | {
+    allowed: false;
+    reason: DeleteAccountBlocker;
+};
+/**
+ * Whether the user may delete their account now. The rule both apps apply:
+ * signed in with a real (non-anonymous) account, and no active subscription
+ * ("Please cancel your subscription before deleting your account." —
+ * `deleteAccountUnsubscribeFirst`). The API also refuses deletion with an
+ * active subscription when RevenueCat is configured.
+ */
+export declare function canDeleteAccount(state: {
+    user: {
+        uid?: string | null;
+        isAnonymous?: boolean | null;
+    } | null | undefined;
+    subscriptionActive: boolean | null | undefined;
+}): DeleteAccountCheck;
+/**
+ * Fraction (0-1) of puzzles a subscription offer unlocks, summed from the
+ * levels' `percentage`:
+ *
+ * - No offerId — only free levels (no subscription required)
+ * - `'1_blue_belt'` — free levels + blue_belt levels
+ * - Anything else — 1.0 (all puzzles)
+ *
+ * usePuzzleDistribution is the memoized hook form.
+ */
+export declare function getPuzzleDistribution(levels: ReadonlyArray<Pick<Level, 'entitlement' | 'percentage'>>, offerId?: string | null): number;
+/** A plan as the paywall lists it (price may be a string, as on Product). */
+export interface PaywallPlan {
+    /** Price in the store currency (major units), e.g. 4.99 or '4.99' */
+    price: number | string;
+    /** Period, named (`monthly`) or ISO 8601 (`P1M`) */
+    period?: string | null;
+}
+/**
+ * The plan the savings badge compares with: the one with the shortest known
+ * period (usually monthly). Plans with an unknown period are skipped; the
+ * first of equal periods wins. Null when no plan has a known period.
+ * (Web SubscriptionPaywall's baseProduct.)
+ */
+export declare function selectSavingsBasePlan<T extends {
+    period?: string | null;
+}>(products: readonly T[]): T | null;
+/**
+ * Percent `plan` saves per month against the savings base plan of
+ * `products` (selectSavingsBasePlan), via calculateSavingsPercent; null when
+ * not comparable or no saving. The web paywall shows it only on the
+ * best-value plan (isBestValueProduct).
+ */
+export declare function getPlanSavingsPercent(products: readonly PaywallPlan[], plan: PaywallPlan): number | null;
 export {};
 //# sourceMappingURL=subscription.d.ts.map

package/dist/utils/subscription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/utils/subscription.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEnE,4CAA4C;AAC5C,UAAU,iBAAiB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE;YACb,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,cAAc,CAAC,EAAE,MAAM,CAAC;SACzB,CAAC;QACF,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,yBAAyB,CAAC,EAAE;YAC1B,UAAU,CAAC,EAAE;gBACX,KAAK,CAAC,EAAE;oBACN,cAAc,CAAC,EAAE,MAAM,CAAC;iBACzB,CAAC;gBACF,cAAc,CAAC,EAAE,MAAM,CAAC;aACzB,CAAC;YACF,KAAK,CAAC,EAAE;gBACN,cAAc,CAAC,EAAE,MAAM,CAAC;aACzB,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,gDAAgD;AAChD,UAAU,qBAAqB;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,iDAAiD;AACjD,UAAU,sBAAsB;IAC9B,YAAY,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;KAC/C,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CA+BvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,sBAAsB,GACnC,YAAY,CA2Bd;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAavE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAanE"}
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/utils/subscription.ts"],"names":[],"mappings":"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"}

package/dist/utils/subscription.js

@@ -4,6 +4,7 @@
  * These functions work with RevenueCat SDK types to convert to our domain models.
  * The RevenueCat types are passed as generics to avoid direct SDK dependency.
  */
+import { getSubscriptionOfferId } from '@sudobility/sudojo_types';
 /**
  * Convert RevenueCat package to our Product interface
  *
@@ -114,4 +115,215 @@ export function getRevenueCatErrorMessage(errorCode) {
             return 'Purchase failed. Please try again.';
     }
 }
+// =============================================================================
+// Paywall display helpers
+// =============================================================================
+/** Named periods (as @sudobility/subscription_lib reports them) → ISO 8601. */
+const NAMED_PERIOD_TO_ISO = {
+    weekly: 'P1W',
+    monthly: 'P1M',
+    quarterly: 'P3M',
+    yearly: 'P1Y',
+};
+function toIsoPeriod(period) {
+    if (!period)
+        return undefined;
+    return NAMED_PERIOD_TO_ISO[period.toLowerCase()] ?? period.toUpperCase();
+}
+/**
+ * i18n key (in the `subscription` namespace) for a period's unit, or null.
+ * `P1W` → `periods.week`, `P1M` → `periods.month`, `P3M` → `periods.quarter`,
+ * `P6M` → `periods.halfYear`, `P1Y` / `P12M` → `periods.year`. Named periods
+ * (`monthly`, `yearly`, ...) are accepted too.
+ *
+ * The web paywall's copy had no week and no `P12M` (it showed no unit for
+ * them); both are mapped here.
+ */
+export function getPeriodLabelKey(period) {
+    switch (toIsoPeriod(period)) {
+        case 'P1W':
+        case 'P7D':
+            return 'periods.week';
+        case 'P1M':
+            return 'periods.month';
+        case 'P3M':
+            return 'periods.quarter';
+        case 'P6M':
+            return 'periods.halfYear';
+        case 'P1Y':
+        case 'P12M':
+            return 'periods.year';
+        default:
+            return null;
+    }
+}
+/**
+ * Price suffix for a period, e.g. `/month`, or '' for an unknown period.
+ *
+ * @param tSub - Translate function for the `subscription` namespace
+ */
+export function getPeriodLabel(tSub, period) {
+    const key = getPeriodLabelKey(period);
+    return key ? `/${tSub(key)}` : '';
+}
+/**
+ * Whether a product is the "best value" plan: an annual period (`P1Y`, `P12M`,
+ * `yearly`) or an identifier containing `annual` / `yearly`
+ * (case-insensitive). Unifies the web paywall's check with isBestValuePlan.
+ */
+export function isBestValueProduct(product) {
+    const iso = toIsoPeriod(product.period);
+    if (iso === 'P1Y' || iso === 'P12M')
+        return true;
+    const id = product.identifier?.toLowerCase() ?? '';
+    return id.includes('annual') || id.includes('yearly');
+}
+/**
+ * Length of a subscription period in months, or null when unknown.
+ *
+ * Accepts the named periods @sudobility/subscription_lib uses (`weekly` 1/4,
+ * `monthly` 1, `quarterly` 3, `yearly` 12, `lifetime` Infinity, matching its
+ * `periodToMonths`) and ISO 8601 durations (`P1W`, `P6M`, `P1Y`, `P30D`, ...).
+ */
+export function subscriptionPeriodToMonths(period) {
+    if (!period)
+        return null;
+    const lower = period.toLowerCase();
+    switch (lower) {
+        case 'weekly':
+            return 1 / 4;
+        case 'monthly':
+            return 1;
+        case 'quarterly':
+            return 3;
+        case 'yearly':
+            return 12;
+        case 'lifetime':
+            return Infinity;
+    }
+    const match = /^P(\d+)([DWMY])$/.exec(period.toUpperCase());
+    if (!match?.[1] || !match[2])
+        return null;
+    const value = parseInt(match[1], 10);
+    switch (match[2]) {
+        case 'D':
+            return value / 30;
+        case 'W':
+            return value / 4;
+        case 'M':
+            return value;
+        default:
+            return value * 12;
+    }
+}
+/**
+ * Percent saved per month by `plan` compared with `base` (e.g. annual vs
+ * monthly), rounded; null when not comparable (same or unknown/lifetime
+ * period, missing product, zero base price) or when there is no saving.
+ * Port of the RN SubscriptionScreen's calcSavingsPercent.
+ */
+export function calculateSavingsPercent(base, plan) {
+    if (!base || !plan)
+        return null;
+    const baseMonths = subscriptionPeriodToMonths(base.period);
+    const planMonths = subscriptionPeriodToMonths(plan.period);
+    if (baseMonths == null || planMonths == null)
+        return null;
+    if (baseMonths <= 0 || planMonths <= 0)
+        return null;
+    if (!isFinite(baseMonths) || !isFinite(planMonths))
+        return null;
+    if (baseMonths === planMonths)
+        return null;
+    const baseMonthlyCost = base.price / baseMonths;
+    const planMonthlyCost = plan.price / planMonths;
+    if (baseMonthlyCost <= 0)
+        return null;
+    const savings = Math.round(((baseMonthlyCost - planMonthlyCost) / baseMonthlyCost) * 100);
+    return savings > 0 ? savings : null;
+}
+/**
+ * Whether the active subscription was bought on another platform than this
+ * client's (so it must be managed there). False when either side is unknown.
+ * Matches the RN SubscriptionScreen's isCrossPlatform.
+ */
+export function isCrossPlatformSubscription(purchasePlatform, clientPlatform) {
+    return (!!purchasePlatform &&
+        !!clientPlatform &&
+        purchasePlatform !== clientPlatform);
+}
+/**
+ * Whether the user may delete their account now. The rule both apps apply:
+ * signed in with a real (non-anonymous) account, and no active subscription
+ * ("Please cancel your subscription before deleting your account." —
+ * `deleteAccountUnsubscribeFirst`). The API also refuses deletion with an
+ * active subscription when RevenueCat is configured.
+ */
+export function canDeleteAccount(state) {
+    if (!state.user?.uid)
+        return { allowed: false, reason: 'not_signed_in' };
+    if (state.user.isAnonymous)
+        return { allowed: false, reason: 'anonymous' };
+    if (state.subscriptionActive) {
+        return { allowed: false, reason: 'active_subscription' };
+    }
+    return { allowed: true };
+}
+/**
+ * Fraction (0-1) of puzzles a subscription offer unlocks, summed from the
+ * levels' `percentage`:
+ *
+ * - No offerId — only free levels (no subscription required)
+ * - `'1_blue_belt'` — free levels + blue_belt levels
+ * - Anything else — 1.0 (all puzzles)
+ *
+ * usePuzzleDistribution is the memoized hook form.
+ */
+export function getPuzzleDistribution(levels, offerId) {
+    if (offerId && offerId !== '1_blue_belt')
+        return 1.0;
+    let total = 0;
+    for (const level of levels) {
+        const levelOfferId = getSubscriptionOfferId(level.entitlement);
+        if (!levelOfferId ||
+            (offerId === '1_blue_belt' && levelOfferId === '1_blue_belt')) {
+            total += level.percentage ?? 0;
+        }
+    }
+    return total;
+}
+/**
+ * The plan the savings badge compares with: the one with the shortest known
+ * period (usually monthly). Plans with an unknown period are skipped; the
+ * first of equal periods wins. Null when no plan has a known period.
+ * (Web SubscriptionPaywall's baseProduct.)
+ */
+export function selectSavingsBasePlan(products) {
+    let base = null;
+    let baseMonths = Infinity;
+    for (const product of products) {
+        const months = subscriptionPeriodToMonths(product.period);
+        if (months != null && months < baseMonths) {
+            base = product;
+            baseMonths = months;
+        }
+    }
+    return base;
+}
+/**
+ * Percent `plan` saves per month against the savings base plan of
+ * `products` (selectSavingsBasePlan), via calculateSavingsPercent; null when
+ * not comparable or no saving. The web paywall shows it only on the
+ * best-value plan (isBestValueProduct).
+ */
+export function getPlanSavingsPercent(products, plan) {
+    const base = selectSavingsBasePlan(products);
+    if (!base)
+        return null;
+    const toPriced = (p) => ({
+        price: typeof p.price === 'number' ? p.price : parseFloat(p.price),
+        period: p.period ?? null,
+    });
+    return calculateSavingsPercent(toPriced(base), toPriced(plan));
+}
 //# sourceMappingURL=subscription.js.map

package/dist/utils/subscription.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/utils/subscription.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Subscription utilities\n *\n * These functions work with RevenueCat SDK types to convert to our domain models.\n * The RevenueCat types are passed as generics to avoid direct SDK dependency.\n */\n\nimport type { Product, Subscription } from '../types/subscription';\n\n/** RevenueCat Package shape (simplified) */\ninterface RevenueCatPackage {\n  identifier: string;\n  rcBillingProduct?: {\n    identifier?: string;\n    title?: string;\n    description?: string;\n    currentPrice?: {\n      amountMicros?: number;\n      formattedPrice?: string;\n    };\n    normalPeriodDuration?: string;\n    defaultSubscriptionOption?: {\n      introPrice?: {\n        price?: {\n          formattedPrice?: string;\n        };\n        periodDuration?: string;\n      };\n      trial?: {\n        periodDuration?: string;\n      };\n    };\n  };\n}\n\n/** RevenueCat CustomerInfo entitlement shape */\ninterface RevenueCatEntitlement {\n  expirationDate?: number | null;\n  latestPurchaseDate?: number | null;\n  productIdentifier?: string;\n  willRenew?: boolean;\n}\n\n/** RevenueCat CustomerInfo shape (simplified) */\ninterface RevenueCatCustomerInfo {\n  entitlements: {\n    active: Record<string, RevenueCatEntitlement>;\n  };\n}\n\n/**\n * Convert RevenueCat package to our Product interface\n *\n * @param pkg - RevenueCat package\n * @returns Product object\n */\nexport function convertPackageToProduct(pkg: RevenueCatPackage): Product {\n  const product = pkg.rcBillingProduct;\n  const subscriptionOption = product?.defaultSubscriptionOption;\n\n  const result: Product = {\n    identifier: pkg.identifier,\n    price: product?.currentPrice?.amountMicros\n      ? (product.currentPrice.amountMicros / 1000000).toFixed(2)\n      : '0',\n    priceString: product?.currentPrice?.formattedPrice ?? '$0',\n    title: product?.title ?? pkg.identifier,\n    description: product?.description ?? '',\n  };\n\n  if (product?.identifier !== undefined) {\n    result.productId = product.identifier;\n  }\n  if (product?.normalPeriodDuration !== undefined) {\n    result.period = product.normalPeriodDuration;\n  }\n  if (subscriptionOption?.introPrice?.price?.formattedPrice !== undefined) {\n    result.introPrice = subscriptionOption.introPrice.price.formattedPrice;\n  }\n  if (subscriptionOption?.introPrice?.periodDuration !== undefined) {\n    result.introPricePeriod = subscriptionOption.introPrice.periodDuration;\n  }\n  if (subscriptionOption?.trial?.periodDuration !== undefined) {\n    result.freeTrialPeriod = subscriptionOption.trial.periodDuration;\n  }\n\n  return result;\n}\n\n/**\n * Parse RevenueCat CustomerInfo into our Subscription interface\n *\n * @param customerInfo - RevenueCat customer info\n * @returns Subscription object\n */\nexport function parseCustomerInfo(\n  customerInfo: RevenueCatCustomerInfo\n): Subscription {\n  const hasActiveEntitlement =\n    Object.keys(customerInfo.entitlements.active).length > 0;\n  const activeEntitlement = Object.values(customerInfo.entitlements.active)[0];\n\n  if (hasActiveEntitlement && activeEntitlement) {\n    const subscription: Subscription = { isActive: true };\n\n    if (activeEntitlement.expirationDate != null) {\n      subscription.expirationDate = new Date(activeEntitlement.expirationDate);\n    }\n    if (activeEntitlement.latestPurchaseDate != null) {\n      subscription.purchaseDate = new Date(\n        activeEntitlement.latestPurchaseDate\n      );\n    }\n    if (activeEntitlement.productIdentifier !== undefined) {\n      subscription.productIdentifier = activeEntitlement.productIdentifier;\n    }\n    if (activeEntitlement.willRenew !== undefined) {\n      subscription.willRenew = activeEntitlement.willRenew;\n    }\n\n    return subscription;\n  }\n\n  return { isActive: false };\n}\n\n/**\n * Get display name for subscription period\n *\n * @param period - ISO 8601 duration string (e.g., \"P1M\", \"P1Y\")\n * @returns Human-readable period name\n */\nexport function getPeriodDisplayName(period: string | undefined): string {\n  if (!period) return '';\n\n  const periodMap: Record<string, string> = {\n    P1W: 'Weekly',\n    P1M: 'Monthly',\n    P3M: 'Quarterly',\n    P6M: 'Semi-Annual',\n    P1Y: 'Annual',\n    P12M: 'Annual',\n  };\n\n  return periodMap[period] ?? period;\n}\n\n/**\n * Check if a plan is the \"best value\" (typically annual plans)\n *\n * @param period - ISO 8601 duration string\n * @returns Whether this is typically the best value option\n */\nexport function isBestValuePlan(period: string | undefined): boolean {\n  return period === 'P1Y' || period === 'P12M';\n}\n\n/**\n * Get RevenueCat purchase error message\n *\n * @param errorCode - RevenueCat error code\n * @returns User-friendly error message\n */\nexport function getRevenueCatErrorMessage(errorCode: number): string {\n  switch (errorCode) {\n    case 1:\n      return 'Purchase cancelled';\n    case 2:\n      return 'Store problem occurred. Please try again later.';\n    case 3:\n      return 'Purchase not allowed on this device';\n    case 7:\n      return 'Network error. Please check your connection.';\n    default:\n      return 'Purchase failed. Please try again.';\n  }\n}\n"]}
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/utils/subscription.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AA6ClE;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAsB;IAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,gBAAgB,CAAC;IACrC,MAAM,kBAAkB,GAAG,OAAO,EAAE,yBAAyB,CAAC;IAE9D,MAAM,MAAM,GAAY;QACtB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY;YACxC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1D,CAAC,CAAC,GAAG;QACP,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,IAAI,IAAI;QAC1D,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC,UAAU;QACvC,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,EAAE;KACxC,CAAC;IAEF,IAAI,OAAO,EAAE,UAAU,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,EAAE,oBAAoB,KAAK,SAAS,EAAE,CAAC;QAChD,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAC/C,CAAC;IACD,IAAI,kBAAkB,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,KAAK,SAAS,EAAE,CAAC;QACxE,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC;IACzE,CAAC;IACD,IAAI,kBAAkB,EAAE,UAAU,EAAE,cAAc,KAAK,SAAS,EAAE,CAAC;QACjE,MAAM,CAAC,gBAAgB,GAAG,kBAAkB,CAAC,UAAU,CAAC,cAAc,CAAC;IACzE,CAAC;IACD,IAAI,kBAAkB,EAAE,KAAK,EAAE,cAAc,KAAK,SAAS,EAAE,CAAC;QAC5D,MAAM,CAAC,eAAe,GAAG,kBAAkB,CAAC,KAAK,CAAC,cAAc,CAAC;IACnE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAAoC;IAEpC,MAAM,oBAAoB,GACxB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3D,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7E,IAAI,oBAAoB,IAAI,iBAAiB,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAEtD,IAAI,iBAAiB,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;YAC7C,YAAY,CAAC,cAAc,GAAG,IAAI,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,iBAAiB,CAAC,kBAAkB,IAAI,IAAI,EAAE,CAAC;YACjD,YAAY,CAAC,YAAY,GAAG,IAAI,IAAI,CAClC,iBAAiB,CAAC,kBAAkB,CACrC,CAAC;QACJ,CAAC;QACD,IAAI,iBAAiB,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACtD,YAAY,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,iBAAiB,CAAC;QACvE,CAAC;QACD,IAAI,iBAAiB,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC9C,YAAY,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC;QACvD,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA0B;IAC7D,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,MAAM,SAAS,GAA2B;QACxC,GAAG,EAAE,QAAQ;QACb,GAAG,EAAE,SAAS;QACd,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,aAAa;QAClB,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE,QAAQ;KACf,CAAC;IAEF,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0B;IACxD,OAAO,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,CAAC;YACJ,OAAO,oBAAoB,CAAC;QAC9B,KAAK,CAAC;YACJ,OAAO,iDAAiD,CAAC;QAC3D,KAAK,CAAC;YACJ,OAAO,qCAAqC,CAAC;QAC/C,KAAK,CAAC;YACJ,OAAO,8CAA8C,CAAC;QACxD;YACE,OAAO,oCAAoC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,+EAA+E;AAC/E,MAAM,mBAAmB,GAAqC;IAC5D,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,KAAK;IAChB,MAAM,EAAE,KAAK;CACd,CAAC;AAEF,SAAS,WAAW,CAAC,MAAiC;IACpD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,mBAAmB,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;AAC3E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAiC;IAEjC,QAAQ,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACR,OAAO,cAAc,CAAC;QACxB,KAAK,KAAK;YACR,OAAO,eAAe,CAAC;QACzB,KAAK,KAAK;YACR,OAAO,iBAAiB,CAAC;QAC3B,KAAK,KAAK;YACR,OAAO,kBAAkB,CAAC;QAC5B,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,OAAO,cAAc,CAAC;QACxB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAuB,EACvB,MAAiC;IAEjC,MAAM,GAAG,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAGlC;IACC,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACnD,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAiC;IAEjC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,CAAC,GAAG,CAAC,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,WAAW;YACd,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC;QACZ,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACjB,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,CAAC,CAAC;QACnB,KAAK,GAAG;YACN,OAAO,KAAK,CAAC;QACf;YACE,OAAO,KAAK,GAAG,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAqC,EACrC,IAAqC;IAErC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,UAAU,IAAI,IAAI,IAAI,UAAU,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC1D,IAAI,UAAU,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAChE,IAAI,UAAU,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;IAChD,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;IAChD,IAAI,eAAe,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CACxB,CAAC,CAAC,eAAe,GAAG,eAAe,CAAC,GAAG,eAAe,CAAC,GAAG,GAAG,CAC9D,CAAC;IACF,OAAO,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,gBAA2C,EAC3C,cAAyC;IAEzC,OAAO,CACL,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,cAAc;QAChB,gBAAgB,KAAK,cAAc,CACpC,CAAC;AACJ,CAAC;AAgBD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAMhC;IACC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACzE,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC3E,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAgE,EAChE,OAAuB;IAEvB,IAAI,OAAO,IAAI,OAAO,KAAK,aAAa;QAAE,OAAO,GAAG,CAAC;IAErD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/D,IACE,CAAC,YAAY;YACb,CAAC,OAAO,KAAK,aAAa,IAAI,YAAY,KAAK,aAAa,CAAC,EAC7D,CAAC;YACD,KAAK,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAsB;IAEtB,IAAI,IAAI,GAAa,IAAI,CAAC;IAC1B,IAAI,UAAU,GAAG,QAAQ,CAAC;IAC1B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,GAAG,UAAU,EAAE,CAAC;YAC1C,IAAI,GAAG,OAAO,CAAC;YACf,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgC,EAChC,IAAiB;IAEjB,MAAM,IAAI,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,QAAQ,GAAG,CAAC,CAAc,EAAgB,EAAE,CAAC,CAAC;QAClD,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;QAClE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI;KACzB,CAAC,CAAC;IACH,OAAO,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC","sourcesContent":["/**\n * Subscription utilities\n *\n * These functions work with RevenueCat SDK types to convert to our domain models.\n * The RevenueCat types are passed as generics to avoid direct SDK dependency.\n */\n\nimport type { Level } from '@sudobility/sudojo_types';\nimport { getSubscriptionOfferId } from '@sudobility/sudojo_types';\nimport type { Product, Subscription } from '../types/subscription';\nimport type { TranslateFunction } from './localizedHint';\n\n/** RevenueCat Package shape (simplified) */\ninterface RevenueCatPackage {\n  identifier: string;\n  rcBillingProduct?: {\n    identifier?: string;\n    title?: string;\n    description?: string;\n    currentPrice?: {\n      amountMicros?: number;\n      formattedPrice?: string;\n    };\n    normalPeriodDuration?: string;\n    defaultSubscriptionOption?: {\n      introPrice?: {\n        price?: {\n          formattedPrice?: string;\n        };\n        periodDuration?: string;\n      };\n      trial?: {\n        periodDuration?: string;\n      };\n    };\n  };\n}\n\n/** RevenueCat CustomerInfo entitlement shape */\ninterface RevenueCatEntitlement {\n  expirationDate?: number | null;\n  latestPurchaseDate?: number | null;\n  productIdentifier?: string;\n  willRenew?: boolean;\n}\n\n/** RevenueCat CustomerInfo shape (simplified) */\ninterface RevenueCatCustomerInfo {\n  entitlements: {\n    active: Record<string, RevenueCatEntitlement>;\n  };\n}\n\n/**\n * Convert RevenueCat package to our Product interface\n *\n * @param pkg - RevenueCat package\n * @returns Product object\n */\nexport function convertPackageToProduct(pkg: RevenueCatPackage): Product {\n  const product = pkg.rcBillingProduct;\n  const subscriptionOption = product?.defaultSubscriptionOption;\n\n  const result: Product = {\n    identifier: pkg.identifier,\n    price: product?.currentPrice?.amountMicros\n      ? (product.currentPrice.amountMicros / 1000000).toFixed(2)\n      : '0',\n    priceString: product?.currentPrice?.formattedPrice ?? '$0',\n    title: product?.title ?? pkg.identifier,\n    description: product?.description ?? '',\n  };\n\n  if (product?.identifier !== undefined) {\n    result.productId = product.identifier;\n  }\n  if (product?.normalPeriodDuration !== undefined) {\n    result.period = product.normalPeriodDuration;\n  }\n  if (subscriptionOption?.introPrice?.price?.formattedPrice !== undefined) {\n    result.introPrice = subscriptionOption.introPrice.price.formattedPrice;\n  }\n  if (subscriptionOption?.introPrice?.periodDuration !== undefined) {\n    result.introPricePeriod = subscriptionOption.introPrice.periodDuration;\n  }\n  if (subscriptionOption?.trial?.periodDuration !== undefined) {\n    result.freeTrialPeriod = subscriptionOption.trial.periodDuration;\n  }\n\n  return result;\n}\n\n/**\n * Parse RevenueCat CustomerInfo into our Subscription interface\n *\n * @param customerInfo - RevenueCat customer info\n * @returns Subscription object\n */\nexport function parseCustomerInfo(\n  customerInfo: RevenueCatCustomerInfo\n): Subscription {\n  const hasActiveEntitlement =\n    Object.keys(customerInfo.entitlements.active).length > 0;\n  const activeEntitlement = Object.values(customerInfo.entitlements.active)[0];\n\n  if (hasActiveEntitlement && activeEntitlement) {\n    const subscription: Subscription = { isActive: true };\n\n    if (activeEntitlement.expirationDate != null) {\n      subscription.expirationDate = new Date(activeEntitlement.expirationDate);\n    }\n    if (activeEntitlement.latestPurchaseDate != null) {\n      subscription.purchaseDate = new Date(\n        activeEntitlement.latestPurchaseDate\n      );\n    }\n    if (activeEntitlement.productIdentifier !== undefined) {\n      subscription.productIdentifier = activeEntitlement.productIdentifier;\n    }\n    if (activeEntitlement.willRenew !== undefined) {\n      subscription.willRenew = activeEntitlement.willRenew;\n    }\n\n    return subscription;\n  }\n\n  return { isActive: false };\n}\n\n/**\n * Get display name for subscription period\n *\n * @param period - ISO 8601 duration string (e.g., \"P1M\", \"P1Y\")\n * @returns Human-readable period name\n */\nexport function getPeriodDisplayName(period: string | undefined): string {\n  if (!period) return '';\n\n  const periodMap: Record<string, string> = {\n    P1W: 'Weekly',\n    P1M: 'Monthly',\n    P3M: 'Quarterly',\n    P6M: 'Semi-Annual',\n    P1Y: 'Annual',\n    P12M: 'Annual',\n  };\n\n  return periodMap[period] ?? period;\n}\n\n/**\n * Check if a plan is the \"best value\" (typically annual plans)\n *\n * @param period - ISO 8601 duration string\n * @returns Whether this is typically the best value option\n */\nexport function isBestValuePlan(period: string | undefined): boolean {\n  return period === 'P1Y' || period === 'P12M';\n}\n\n/**\n * Get RevenueCat purchase error message\n *\n * @param errorCode - RevenueCat error code\n * @returns User-friendly error message\n */\nexport function getRevenueCatErrorMessage(errorCode: number): string {\n  switch (errorCode) {\n    case 1:\n      return 'Purchase cancelled';\n    case 2:\n      return 'Store problem occurred. Please try again later.';\n    case 3:\n      return 'Purchase not allowed on this device';\n    case 7:\n      return 'Network error. Please check your connection.';\n    default:\n      return 'Purchase failed. Please try again.';\n  }\n}\n\n// =============================================================================\n// Paywall display helpers\n// =============================================================================\n\n/** Named periods (as @sudobility/subscription_lib reports them) → ISO 8601. */\nconst NAMED_PERIOD_TO_ISO: Readonly<Record<string, string>> = {\n  weekly: 'P1W',\n  monthly: 'P1M',\n  quarterly: 'P3M',\n  yearly: 'P1Y',\n};\n\nfunction toIsoPeriod(period: string | null | undefined): string | undefined {\n  if (!period) return undefined;\n  return NAMED_PERIOD_TO_ISO[period.toLowerCase()] ?? period.toUpperCase();\n}\n\n/**\n * i18n key (in the `subscription` namespace) for a period's unit, or null.\n * `P1W` → `periods.week`, `P1M` → `periods.month`, `P3M` → `periods.quarter`,\n * `P6M` → `periods.halfYear`, `P1Y` / `P12M` → `periods.year`. Named periods\n * (`monthly`, `yearly`, ...) are accepted too.\n *\n * The web paywall's copy had no week and no `P12M` (it showed no unit for\n * them); both are mapped here.\n */\nexport function getPeriodLabelKey(\n  period: string | null | undefined\n): string | null {\n  switch (toIsoPeriod(period)) {\n    case 'P1W':\n    case 'P7D':\n      return 'periods.week';\n    case 'P1M':\n      return 'periods.month';\n    case 'P3M':\n      return 'periods.quarter';\n    case 'P6M':\n      return 'periods.halfYear';\n    case 'P1Y':\n    case 'P12M':\n      return 'periods.year';\n    default:\n      return null;\n  }\n}\n\n/**\n * Price suffix for a period, e.g. `/month`, or '' for an unknown period.\n *\n * @param tSub - Translate function for the `subscription` namespace\n */\nexport function getPeriodLabel(\n  tSub: TranslateFunction,\n  period: string | null | undefined\n): string {\n  const key = getPeriodLabelKey(period);\n  return key ? `/${tSub(key)}` : '';\n}\n\n/**\n * Whether a product is the \"best value\" plan: an annual period (`P1Y`, `P12M`,\n * `yearly`) or an identifier containing `annual` / `yearly`\n * (case-insensitive). Unifies the web paywall's check with isBestValuePlan.\n */\nexport function isBestValueProduct(product: {\n  period?: string | null;\n  identifier?: string | null;\n}): boolean {\n  const iso = toIsoPeriod(product.period);\n  if (iso === 'P1Y' || iso === 'P12M') return true;\n  const id = product.identifier?.toLowerCase() ?? '';\n  return id.includes('annual') || id.includes('yearly');\n}\n\n/**\n * Length of a subscription period in months, or null when unknown.\n *\n * Accepts the named periods @sudobility/subscription_lib uses (`weekly` 1/4,\n * `monthly` 1, `quarterly` 3, `yearly` 12, `lifetime` Infinity, matching its\n * `periodToMonths`) and ISO 8601 durations (`P1W`, `P6M`, `P1Y`, `P30D`, ...).\n */\nexport function subscriptionPeriodToMonths(\n  period: string | null | undefined\n): number | null {\n  if (!period) return null;\n  const lower = period.toLowerCase();\n  switch (lower) {\n    case 'weekly':\n      return 1 / 4;\n    case 'monthly':\n      return 1;\n    case 'quarterly':\n      return 3;\n    case 'yearly':\n      return 12;\n    case 'lifetime':\n      return Infinity;\n  }\n  const match = /^P(\\d+)([DWMY])$/.exec(period.toUpperCase());\n  if (!match?.[1] || !match[2]) return null;\n  const value = parseInt(match[1], 10);\n  switch (match[2]) {\n    case 'D':\n      return value / 30;\n    case 'W':\n      return value / 4;\n    case 'M':\n      return value;\n    default:\n      return value * 12;\n  }\n}\n\n/** Price and period of a plan, for savings calculations. */\nexport interface PricedPeriod {\n  /** Price in the store currency (major units) */\n  price: number;\n  /** Period, named (`monthly`) or ISO 8601 (`P1M`) */\n  period?: string | null;\n}\n\n/**\n * Percent saved per month by `plan` compared with `base` (e.g. annual vs\n * monthly), rounded; null when not comparable (same or unknown/lifetime\n * period, missing product, zero base price) or when there is no saving.\n * Port of the RN SubscriptionScreen's calcSavingsPercent.\n */\nexport function calculateSavingsPercent(\n  base: PricedPeriod | null | undefined,\n  plan: PricedPeriod | null | undefined\n): number | null {\n  if (!base || !plan) return null;\n  const baseMonths = subscriptionPeriodToMonths(base.period);\n  const planMonths = subscriptionPeriodToMonths(plan.period);\n  if (baseMonths == null || planMonths == null) return null;\n  if (baseMonths <= 0 || planMonths <= 0) return null;\n  if (!isFinite(baseMonths) || !isFinite(planMonths)) return null;\n  if (baseMonths === planMonths) return null;\n  const baseMonthlyCost = base.price / baseMonths;\n  const planMonthlyCost = plan.price / planMonths;\n  if (baseMonthlyCost <= 0) return null;\n  const savings = Math.round(\n    ((baseMonthlyCost - planMonthlyCost) / baseMonthlyCost) * 100\n  );\n  return savings > 0 ? savings : null;\n}\n\n/**\n * Whether the active subscription was bought on another platform than this\n * client's (so it must be managed there). False when either side is unknown.\n * Matches the RN SubscriptionScreen's isCrossPlatform.\n */\nexport function isCrossPlatformSubscription(\n  purchasePlatform: string | null | undefined,\n  clientPlatform: string | null | undefined\n): boolean {\n  return (\n    !!purchasePlatform &&\n    !!clientPlatform &&\n    purchasePlatform !== clientPlatform\n  );\n}\n\n/** Why an account cannot be deleted right now. */\nexport type DeleteAccountBlocker =\n  /** No signed-in user */\n  | 'not_signed_in'\n  /** Anonymous (guest) user: there is no account to delete */\n  | 'anonymous'\n  /** An active subscription must be cancelled first */\n  | 'active_subscription';\n\n/** Result of canDeleteAccount. */\nexport type DeleteAccountCheck =\n  | { allowed: true }\n  | { allowed: false; reason: DeleteAccountBlocker };\n\n/**\n * Whether the user may delete their account now. The rule both apps apply:\n * signed in with a real (non-anonymous) account, and no active subscription\n * (\"Please cancel your subscription before deleting your account.\" —\n * `deleteAccountUnsubscribeFirst`). The API also refuses deletion with an\n * active subscription when RevenueCat is configured.\n */\nexport function canDeleteAccount(state: {\n  user:\n    | { uid?: string | null; isAnonymous?: boolean | null }\n    | null\n    | undefined;\n  subscriptionActive: boolean | null | undefined;\n}): DeleteAccountCheck {\n  if (!state.user?.uid) return { allowed: false, reason: 'not_signed_in' };\n  if (state.user.isAnonymous) return { allowed: false, reason: 'anonymous' };\n  if (state.subscriptionActive) {\n    return { allowed: false, reason: 'active_subscription' };\n  }\n  return { allowed: true };\n}\n\n/**\n * Fraction (0-1) of puzzles a subscription offer unlocks, summed from the\n * levels' `percentage`:\n *\n * - No offerId — only free levels (no subscription required)\n * - `'1_blue_belt'` — free levels + blue_belt levels\n * - Anything else — 1.0 (all puzzles)\n *\n * usePuzzleDistribution is the memoized hook form.\n */\nexport function getPuzzleDistribution(\n  levels: ReadonlyArray<Pick<Level, 'entitlement' | 'percentage'>>,\n  offerId?: string | null\n): number {\n  if (offerId && offerId !== '1_blue_belt') return 1.0;\n\n  let total = 0;\n  for (const level of levels) {\n    const levelOfferId = getSubscriptionOfferId(level.entitlement);\n    if (\n      !levelOfferId ||\n      (offerId === '1_blue_belt' && levelOfferId === '1_blue_belt')\n    ) {\n      total += level.percentage ?? 0;\n    }\n  }\n  return total;\n}\n\n/** A plan as the paywall lists it (price may be a string, as on Product). */\nexport interface PaywallPlan {\n  /** Price in the store currency (major units), e.g. 4.99 or '4.99' */\n  price: number | string;\n  /** Period, named (`monthly`) or ISO 8601 (`P1M`) */\n  period?: string | null;\n}\n\n/**\n * The plan the savings badge compares with: the one with the shortest known\n * period (usually monthly). Plans with an unknown period are skipped; the\n * first of equal periods wins. Null when no plan has a known period.\n * (Web SubscriptionPaywall's baseProduct.)\n */\nexport function selectSavingsBasePlan<T extends { period?: string | null }>(\n  products: readonly T[]\n): T | null {\n  let base: T | null = null;\n  let baseMonths = Infinity;\n  for (const product of products) {\n    const months = subscriptionPeriodToMonths(product.period);\n    if (months != null && months < baseMonths) {\n      base = product;\n      baseMonths = months;\n    }\n  }\n  return base;\n}\n\n/**\n * Percent `plan` saves per month against the savings base plan of\n * `products` (selectSavingsBasePlan), via calculateSavingsPercent; null when\n * not comparable or no saving. The web paywall shows it only on the\n * best-value plan (isBestValueProduct).\n */\nexport function getPlanSavingsPercent(\n  products: readonly PaywallPlan[],\n  plan: PaywallPlan\n): number | null {\n  const base = selectSavingsBasePlan(products);\n  if (!base) return null;\n  const toPriced = (p: PaywallPlan): PricedPeriod => ({\n    price: typeof p.price === 'number' ? p.price : parseFloat(p.price),\n    period: p.period ?? null,\n  });\n  return calculateSavingsPercent(toPriced(base), toPriced(plan));\n}\n"]}