sinfactura-types 1.7.3 → 1.7.5

package/dist/store.d.ts

@@ -113,6 +113,7 @@ declare global {
         phone: string;
         email: string;
         acknowledgedSharedCuit?: boolean;
+        subscription?: StoreRowSubscriptionSummary;
         config: {
             priceDecimals: 0 | 1 | 2 | 3;
             stock: boolean;

package/dist/subscription.d.ts

@@ -294,20 +294,42 @@ declare global {
         entitlements: SubscriptionEntitlementEntry[];
         usage: SubscriptionUsageEntry[];
     }
+    /**
+     * Compact subscription summary attached to `Store.subscription` on
+     * `GET /tenants` (list) and `GET /tenants?storeId=X` (single-store)
+     * responses — the only subscription data SUPERVISOR can read (managerToken
+     * still owns the full audit/override surface). No Stripe ids or amounts
+     * (least-privilege). Absent entirely on a store with no SUBSCRIPTION row.
+     */
+    interface StoreRowSubscriptionSummary {
+        planTier: PlanTier;
+        status: SubscriptionStatus;
+        /** `null` when the row has no billing cycle yet (pre-checkout). */
+        billingCycle: BillingCycle | null;
+        /** Courtesy-gift cutoff (ADR-0010). `YYYY-MM-DD`, matches `Subscription.freeUntil` — not epoch ms. */
+        freeUntil?: string;
+        /** Unix ms. Only meaningful while `status === 'trialing'`. */
+        trialEndsAt?: number;
+        currentPeriodEnd?: number;
+    }
     /**
      * Request body for the MANAGER out-of-band override
      * `PUT /platform/stores/{storeId}/subscription` (api#827). No Stripe call —
-     * a direct DynamoDB write + audit row. `trialEndsAt` is required when
-     * `status === 'trialing'`; `reason` is the audit message (min 10 chars).
+     * a direct DynamoDB write + audit row. `trialEndsAt` is required (non-null)
+     * when `status === 'trialing'`; `reason` is the audit message (min 10 chars).
+     *
+     * `freeUntil` / `trialEndsAt` are three-state (api#1907): omit the key to
+     * leave the existing value untouched, send `null` to clear it, send a value
+     * to set it.
      */
     interface SubscriptionAdminOverrideInput {
         planTier: PlanTier;
         status: SubscriptionStatus;
         billingCycle: BillingCycle;
-        /** Courtesy-gift cutoff (ADR-0010), `YYYY-MM-DD`. Optional on any status. */
-        freeUntil?: string;
-        /** Trial end (Unix ms). Required when `status === 'trialing'`. */
-        trialEndsAt?: number;
+        /** Courtesy-gift cutoff (ADR-0010), `YYYY-MM-DD`. Optional on any status; `null` clears it. */
+        freeUntil?: string | null;
+        /** Trial end (Unix ms). Required (non-null) when `status === 'trialing'`; `null` clears it otherwise. */
+        trialEndsAt?: number | null;
         reason: string;
     }
     /**

package/package.json

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