sinfactura-types 1.0.95 → 1.1.1

package/dist/subscription.d.ts

@@ -5,24 +5,32 @@
  * sinfactura/app/docs/plans/SUBSCRIPTION_BUSINESS_DECISIONS.md.
  *
  * Notes:
- * - Tier names are the 4 locked Spanish tiers (per SUBSCRIPTION_TIERS_BEST_PRACTICES §0).
- * - `fundador` is a `SubscriptionStatus` on `negocio`-tier plans (ADR-0009).
+ * - Tier names are the 5 locked Spanish tiers (per SUBSCRIPTION_TIERS_BEST_PRACTICES §0
+ *   and api#802 — the launch lineup is BÁSICO, EMPRENDEDOR, PROFESIONAL, AVANZADO,
+ *   plus FUNDADOR for the pre-launch cohort).
+ * - `fundador` is BOTH a `PlanTier` (the cohort plan template seeded at api#802) and a
+ *   pre-existing `SubscriptionStatus` value (kept for backward compat — the registration
+ *   flow now sets status='active' on fundador subscriptions).
  * - `FeatureKey` uses flat camelCase (not the dotted `reports.advanced` from the design kit).
  * - Monetary amounts are integers in minor units (ARS cents) to avoid float issues.
- * - WhatsApp-specific feature keys + `customDomain` are intentionally OUT of scope here;
- *   they ship with their own epics (#1072, #1152) after Product sign-off.
+ * - Feature keys now match the BE wire format directly (renamed afip→afipInvoicing,
+ *   cash→cashManagement, stripePayments→paymentIntegrations, reportsAdvanced→advancedReports
+ *   as of 2026-04-26). New keys whatsappCommerce/aiFeatures/mobileApp/customDomain are
+ *   declared here even when their epics haven't shipped — the matrix can set
+ *   enabled:false until they do.
  */
 declare global {
-    type PlanTier = 'basico' | 'emprendedor' | 'negocio' | 'empresa';
+    type PlanTier = 'basico' | 'emprendedor' | 'profesional' | 'avanzado' | 'fundador';
     /**
      * Lifecycle status of a tenant's subscription.
      *
-     * - `trialing` — new signup in the 30-day NEGOCIO trial (no payment method).
+     * - `trialing` — new signup in the 30-day PROFESIONAL trial (no payment method).
      * - `active` — paid subscription, period current.
      * - `past_due` — payment failed, in the 7-day grace window.
      * - `readonly` — grace elapsed, writes blocked, tenant can still read.
      * - `canceled` — tenant ended subscription; data retained per grace policy.
-     * - `fundador` — pre-launch cohort, 12-month free NEGOCIO entitlements (ADR-0009).
+     * - `fundador` — legacy pre-cohort status. Post-api#802, fundador subscriptions
+     *   carry `status: 'active'` and are identified via `planTier === 'fundador'`.
      */
     type SubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'readonly' | 'canceled' | 'fundador';
     type BillingCycle = 'monthly' | 'annual';
@@ -39,16 +47,19 @@ declare global {
     type EntitlementType = 'boolean' | 'numeric' | 'metered';
     interface Entitlement {
         type: EntitlementType;
-        enabled: boolean;
+        /** `null` for `numeric`/`metered` types where on/off semantics don't apply (limit-driven). */
+        enabled: boolean | null;
         /** Required for `numeric` and `metered`. `Infinity`-equivalent — treat sentinel value for "unlimited". */
         limit?: number;
+        /** Origin of this entitlement entry. `plan` = from the tier matrix; `override` = tenant-specific override; `trial` = trial bonus. */
+        source?: 'plan' | 'override' | 'trial';
     }
     /**
      * All gated features. Add new keys here when a new feature becomes gateable;
      * every existing plan in `FEATURE_MATRIX` must then declare the new key
      * (TypeScript enforces this via `Record<FeatureKey, Entitlement>`).
      */
-    type FeatureKey = 'maxOrdersMonth' | 'maxInvoicesMonth' | 'maxProducts' | 'maxUsers' | 'maxCustomers' | 'maxStores' | 'afip' | 'stripePayments' | 'suppliers' | 'cash' | 'multiStore' | 'importExport' | 'reportsAdvanced' | 'customBranding' | 'apiAccess' | 'prioritySupport';
+    type FeatureKey = 'maxOrdersMonth' | 'maxInvoicesMonth' | 'maxProducts' | 'maxUsers' | 'maxCustomers' | 'maxStores' | 'afipInvoicing' | 'paymentIntegrations' | 'suppliers' | 'cashManagement' | 'multiStore' | 'importExport' | 'advancedReports' | 'customBranding' | 'apiAccess' | 'prioritySupport' | 'whatsappCommerce' | 'aiFeatures' | 'mobileApp' | 'customDomain';
     /** Full feature matrix — every tier declares every feature. */
     type FeatureMatrix = Record<PlanTier, Record<FeatureKey, Entitlement>>;
     /** Resolved entitlements for a specific tenant (matrix + overrides applied). */
@@ -58,11 +69,11 @@ declare global {
      * served to the frontend via GET /subscription/plans.
      *
      * Prices are integers in ARS cents (e.g. $40 000 = 4_000_000).
-     * `null` = "Contactar ventas" (EMPRESA, pre-unlock).
+     * `null` = "Contactar ventas" (AVANZADO, pre-unlock).
      */
     interface Plan {
         tier: PlanTier;
-        /** Display label — "BÁSICO", "EMPRENDEDOR", "NEGOCIO", "EMPRESA". */
+        /** Display label — "BÁSICO", "EMPRENDEDOR", "PROFESIONAL", "AVANZADO", "FUNDADOR". */
         label: string;
         /** Short marketing tagline (Spanish). */
         blurb?: string;
@@ -78,10 +89,10 @@ declare global {
          * the plan row.
          */
         isActive: boolean;
-        /** Marked as the anchor / recommended tier on the pricing page. NEGOCIO at launch. */
+        /** Marked as the anchor / recommended tier on the pricing page. PROFESIONAL at launch. */
         isPopular?: boolean;
         /**
-         * Visibility on the public pricing page. EMPRESA = `false` until
+         * Visibility on the public pricing page. AVANZADO = `false` until
          * ≥2 Planned features ship (per SUBSCRIPTION_TIERS_BEST_PRACTICES §0).
          */
         isPublic: boolean;
@@ -107,8 +118,17 @@ declare global {
         currentPeriodEnd: number;
         /** Set while `status === 'trialing'`. Unix ms. */
         trialEndsAt?: number;
-        /** Set while `status === 'fundador'`. Unix ms. Per ADR-0009: 2027-06-30T00:00:00Z. */
-        freeUntil?: number;
+        /**
+         * Founders cohort only — YYYY-MM-DD when the 12-month free PROFESIONAL
+         * entitlement window ends. Set on registration when `?mode=founders`
+         * is opted into and the cohort is open. String (not numeric ms) so it's
+         * human-readable in the DynamoDB console — matches api#802 verbatim.
+         */
+        freeUntil?: string;
+        /** Founders cohort only — YYYY-MM-DD when the post-free grace period ends. */
+        graceUntil?: string;
+        /** Founders cohort only — eligible for the perpetual founder discount after cutoff. */
+        founderDiscountEligible?: boolean;
         /** Stripe identifiers (absent for trialing/fundador before checkout). */
         stripeCustomerId?: string;
         stripeSubscriptionId?: string;
@@ -134,14 +154,39 @@ declare global {
         counters: Partial<Record<FeatureKey, number>>;
         updatedAt: number;
     }
+    /** A single entitlement entry as returned by GET /subscription. */
+    interface SubscriptionEntitlementEntry {
+        key: FeatureKey;
+        type: EntitlementType;
+        enabled: boolean | null;
+        limit: number | null;
+        source: 'plan' | 'override' | 'trial';
+    }
+    /** A single usage entry as returned by GET /subscription. */
+    interface SubscriptionUsageEntry {
+        key: FeatureKey;
+        /** Period in YYYYMM format. */
+        period: string;
+        current: number;
+        limit: number;
+        remaining: number;
+    }
     /**
      * Full subscription snapshot pushed to the frontend on subscription/entitlement
-     * changes. Consumers use this to invalidate RTK Query caches and re-render gates.
+     * changes. Flat shape — matches GET /subscription wire format directly.
      */
     interface SubscriptionSyncPayload {
-        subscription: Subscription;
-        entitlements: ResolvedEntitlements;
-        usage?: UsageCounters;
+        planTier: PlanTier;
+        status: SubscriptionStatus;
+        billingCycle: BillingCycle | null;
+        currentPeriodStart: number | null;
+        currentPeriodEnd: number | null;
+        trialEndsAt: number | null;
+        freeUntil?: string;
+        cancelAt: number | null;
+        canceledAt: number | null;
+        entitlements: SubscriptionEntitlementEntry[];
+        usage: SubscriptionUsageEntry[];
     }
 }
 export {};

package/dist/subscription.js

@@ -5,11 +5,18 @@
  * sinfactura/app/docs/plans/SUBSCRIPTION_BUSINESS_DECISIONS.md.
  *
  * Notes:
- * - Tier names are the 4 locked Spanish tiers (per SUBSCRIPTION_TIERS_BEST_PRACTICES §0).
- * - `fundador` is a `SubscriptionStatus` on `negocio`-tier plans (ADR-0009).
+ * - Tier names are the 5 locked Spanish tiers (per SUBSCRIPTION_TIERS_BEST_PRACTICES §0
+ *   and api#802 — the launch lineup is BÁSICO, EMPRENDEDOR, PROFESIONAL, AVANZADO,
+ *   plus FUNDADOR for the pre-launch cohort).
+ * - `fundador` is BOTH a `PlanTier` (the cohort plan template seeded at api#802) and a
+ *   pre-existing `SubscriptionStatus` value (kept for backward compat — the registration
+ *   flow now sets status='active' on fundador subscriptions).
  * - `FeatureKey` uses flat camelCase (not the dotted `reports.advanced` from the design kit).
  * - Monetary amounts are integers in minor units (ARS cents) to avoid float issues.
- * - WhatsApp-specific feature keys + `customDomain` are intentionally OUT of scope here;
- *   they ship with their own epics (#1072, #1152) after Product sign-off.
+ * - Feature keys now match the BE wire format directly (renamed afip→afipInvoicing,
+ *   cash→cashManagement, stripePayments→paymentIntegrations, reportsAdvanced→advancedReports
+ *   as of 2026-04-26). New keys whatsappCommerce/aiFeatures/mobileApp/customDomain are
+ *   declared here even when their epics haven't shipped — the matrix can set
+ *   enabled:false until they do.
  */
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sinfactura-types",
-  "version": "1.0.95",
+  "version": "1.1.1",
   "main": "dist/index.js",
   "type": "module",
   "types": "./dist/index.d.ts",