@saasicat/nest 0.2.0

package/dist/plan-resolution-CFCoUkrE.d.cts

@@ -0,0 +1,41 @@
+import { PlanId } from '@saasicat/types';
+
+/** Input shape: only the fields relevant to resolution. */
+interface EntitlementResolutionInput {
+    plan: PlanId;
+    status: string;
+    isPilot?: boolean;
+    trialEntitlementPlan?: PlanId | null;
+    pendingPlan?: PlanId | null;
+    pendingEffectiveAt?: Date | null;
+}
+/**
+ * Consumer-specific override strategy. All fields optional —
+ * undefined means: no special handling, falls back to `subscription.plan`.
+ */
+interface EntitlementResolutionConfig {
+    /** If `isPilot=true`, this plan applies instead of `subscription.plan`. */
+    pilotEntitlementPlan?: PlanId;
+    /** If `status="PENDING_SALES"`, this plan applies. */
+    pendingSalesEntitlementPlan?: PlanId;
+    /**
+     * Fallback during TRIAL, when `subscription.trialEntitlementPlan` is null.
+     * If the subscription sets a `trialEntitlementPlan`, that one wins.
+     */
+    defaultTrialEntitlementPlan?: PlanId;
+}
+/**
+ * Resolves the effective plan of a subscription for limit aggregation.
+ *
+ * Order of the override rules (highest first):
+ *   1. `isPilot` → `config.pilotEntitlementPlan` (if set).
+ *   2. `status === 'TRIAL'` → `subscription.trialEntitlementPlan`
+ *      or `config.defaultTrialEntitlementPlan` (if set).
+ *   3. `status === 'PENDING_SALES'` → `config.pendingSalesEntitlementPlan`
+ *      (if set).
+ *   4. `pendingPlan` with `pendingEffectiveAt <= now` → `pendingPlan`.
+ *   5. Default → `subscription.plan`.
+ */
+declare function resolveEntitlementPlan(input: EntitlementResolutionInput, config: EntitlementResolutionConfig, now: Date): PlanId;
+
+export { type EntitlementResolutionConfig as E, type EntitlementResolutionInput as a, resolveEntitlementPlan as r };

package/dist/plan-resolution-CFCoUkrE.d.ts

@@ -0,0 +1,41 @@
+import { PlanId } from '@saasicat/types';
+
+/** Input shape: only the fields relevant to resolution. */
+interface EntitlementResolutionInput {
+    plan: PlanId;
+    status: string;
+    isPilot?: boolean;
+    trialEntitlementPlan?: PlanId | null;
+    pendingPlan?: PlanId | null;
+    pendingEffectiveAt?: Date | null;
+}
+/**
+ * Consumer-specific override strategy. All fields optional —
+ * undefined means: no special handling, falls back to `subscription.plan`.
+ */
+interface EntitlementResolutionConfig {
+    /** If `isPilot=true`, this plan applies instead of `subscription.plan`. */
+    pilotEntitlementPlan?: PlanId;
+    /** If `status="PENDING_SALES"`, this plan applies. */
+    pendingSalesEntitlementPlan?: PlanId;
+    /**
+     * Fallback during TRIAL, when `subscription.trialEntitlementPlan` is null.
+     * If the subscription sets a `trialEntitlementPlan`, that one wins.
+     */
+    defaultTrialEntitlementPlan?: PlanId;
+}
+/**
+ * Resolves the effective plan of a subscription for limit aggregation.
+ *
+ * Order of the override rules (highest first):
+ *   1. `isPilot` → `config.pilotEntitlementPlan` (if set).
+ *   2. `status === 'TRIAL'` → `subscription.trialEntitlementPlan`
+ *      or `config.defaultTrialEntitlementPlan` (if set).
+ *   3. `status === 'PENDING_SALES'` → `config.pendingSalesEntitlementPlan`
+ *      (if set).
+ *   4. `pendingPlan` with `pendingEffectiveAt <= now` → `pendingPlan`.
+ *   5. Default → `subscription.plan`.
+ */
+declare function resolveEntitlementPlan(input: EntitlementResolutionInput, config: EntitlementResolutionConfig, now: Date): PlanId;
+
+export { type EntitlementResolutionConfig as E, type EntitlementResolutionInput as a, resolveEntitlementPlan as r };