sinfactura-types 1.6.26 → 1.6.28

package/dist/impersonation.d.ts

@@ -0,0 +1,45 @@
+declare global {
+    /**
+     * Wire contract returned by `POST /tenants/{storeId}/impersonate` — the
+     * MANAGER tenant-impersonation mint endpoint (app#1756 · spine #1187).
+     *
+     * BE produces, FE consumes. This is the ONLY impersonation type that crosses
+     * the api↔app boundary: the JWT claims (`act`/`aud`/`scope`/`store`/`sid`),
+     * the request body (`{ targetUserId, reason }`) and the server-side
+     * session-registry DDB item all stay service-local.
+     *
+     * The minted token is an RFC 8693 *delegation* token (`sub` = the tenant
+     * user, `act.sub` = the operator), short-lived (30 min) and
+     * **non-refreshable**, signed with a separate key so a leak is revocable
+     * without rotating the normal auth key. The FE reads the impersonated
+     * identity's roles/permissions from `impersonatedUser` (NOT from the JWT —
+     * `jose.decodeJwt` is used only to read `exp` for the countdown); the
+     * `act`/`scope`/`aud` claims exist purely for BE verification + audit.
+     */
+    interface ImpersonationMintResponse {
+        /**
+         * The minted delegation JWT (`aud: "impersonation"`). In-memory only on the
+         * FE — never persisted to localStorage / URL / the refresh cookie.
+         */
+        impersonationToken: string;
+        /**
+         * The impersonated tenant user, AuthUser-shaped: the target's
+         * roles/permissions/storeId plus the impersonation `accessToken`. The FE
+         * repoints its session identity to this inside the new impersonation tab.
+         */
+        impersonatedUser: AuthUser;
+        /**
+         * Hard expiry of the session, unix milliseconds. Mirrors the JWT `exp`;
+         * because the token is non-refreshable this is absolute. Drives the banner
+         * countdown and the auto-exit.
+         */
+        expiresAt: number;
+        /**
+         * Server-side impersonation-session id (also the JWT `sid`). Identifies the
+         * registry row the FE later passes to
+         * `POST /tenants/{storeId}/impersonation/{sessionId}/end`.
+         */
+        sessionId: string;
+    }
+}
+export {};

package/dist/impersonation.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from "./categories";
 export * from "./currency";
 export * from "./customer";
 export * from "./demo";
+export * from "./impersonation";
 export * from "./imports";
 export * from "./invoice";
 export * from "./log";

package/dist/index.js

@@ -10,6 +10,7 @@ export * from "./categories";
 export * from "./currency";
 export * from "./customer";
 export * from "./demo";
+export * from "./impersonation";
 export * from "./imports";
 export * from "./invoice";
 export * from "./log";

package/dist/subscription.d.ts

@@ -178,8 +178,9 @@ declare global {
     }
     /**
      * One audit row per SUPER_ADMIN-driven plan mutation. Returned by
-     * `GET /sa/plans/{tier}/audit` (api#859). The same row shape is used
-     * for the sibling `STORE` audit partition (api#827).
+     * `GET /platform/billing/plans/{tier}/audit` (api#859). The store-subscription
+     * audit (api#827) shares this storage shape but is read as
+     * `SubscriptionAuditEntry`.
      *
      * `before` and `after` carry only the fields that changed (diff slice),
      * not the full row blob.
@@ -264,11 +265,13 @@ declare global {
     /** A single usage entry as returned by GET /subscription. */
     interface SubscriptionUsageEntry {
         key: FeatureKey;
-        /** Period in YYYYMM format. */
-        period: string;
+        /** Period in YYYYMM format; `null` for lifetime caps (maxProducts/maxCustomers/maxUsers). */
+        period: string | null;
         current: number;
-        limit: number;
-        remaining: number;
+        /** `null` for unlimited tiers (no cap). */
+        limit: number | null;
+        /** `null` when `limit` is unlimited/uncapped. */
+        remaining: number | null;
     }
     /**
      * Full subscription snapshot pushed to the frontend on subscription/entitlement
@@ -277,6 +280,8 @@ declare global {
     interface SubscriptionSyncPayload {
         planTier: PlanTier;
         status: SubscriptionStatus;
+        /** Billing currency snapshotted from the plan template; `null` on free/unbilled tiers (basico). */
+        currency: 'ARS' | 'USD' | null;
         billingCycle: BillingCycle | null;
         currentPeriodStart: number | null;
         currentPeriodEnd: number | null;
@@ -288,5 +293,39 @@ declare global {
         entitlements: SubscriptionEntitlementEntry[];
         usage: SubscriptionUsageEntry[];
     }
+    /**
+     * 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).
+     */
+    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;
+        reason: string;
+    }
+    /**
+     * One audit row for a MANAGER out-of-band subscription change, as returned by
+     * `GET /platform/stores/{storeId}/subscription/audit` (api#827). Written by
+     * the override endpoint and the gift endpoint to the
+     * `AUDIT#SUBSCRIPTION#{storeId}` partition. `before`/`after` carry the
+     * subscription fields an operator can change.
+     */
+    interface SubscriptionAuditEntry {
+        storeId: string;
+        timestamp: number;
+        actor: {
+            userId: string;
+            fullName: string;
+        };
+        before: Pick<Subscription, 'planTier' | 'status' | 'billingCycle' | 'freeUntil' | 'trialEndsAt'>;
+        after: Pick<Subscription, 'planTier' | 'status' | 'billingCycle' | 'freeUntil' | 'trialEndsAt'>;
+        reason: string;
+    }
 }
 export {};

package/package.json

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