guardrail-core 1.0.0

package/dist/tier-config.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Canonical Tier Configuration
+ *
+ * SINGLE SOURCE OF TRUTH for all tier definitions across:
+ * - Backend entitlements
+ * - Rate limiting
+ * - Stripe billing mapping
+ * - Landing page pricing
+ * - CLI entitlements
+ *
+ * DO NOT define tier configurations anywhere else in the codebase.
+ */
+export declare const TIERS: readonly ["free", "starter", "pro", "compliance", "enterprise", "unlimited"];
+export type Tier = typeof TIERS[number];
+/** Tiers that can be purchased (excludes free and unlimited) */
+export declare const PURCHASABLE_TIERS: readonly ["starter", "pro", "compliance", "enterprise"];
+export type PurchasableTier = typeof PURCHASABLE_TIERS[number];
+/** Tier order for comparison (lower index = lower tier) */
+export declare const TIER_ORDER: Tier[];
+export declare const FEATURES: readonly ["scan", "scan:full", "scan:security", "scan:compliance", "gate", "fix", "fix:auto", "ship", "reality", "reality:flows", "ai-agent", "ai-agent:goals", "autopilot", "context", "badge", "mcp", "compliance:soc2", "compliance:hipaa", "compliance:gdpr", "compliance:pci", "compliance:nist", "compliance:iso27001", "reports:html", "reports:pdf", "reports:sarif", "team:members", "team:admin", "api:access", "webhooks", "deploy-hooks"];
+export type Feature = typeof FEATURES[number];
+export interface TierLimits {
+    /** Scans per month (-1 = unlimited) */
+    scansPerMonth: number;
+    /** Reality Mode runs per month */
+    realityRunsPerMonth: number;
+    /** AI Agent runs per month */
+    aiAgentRunsPerMonth: number;
+    /** Number of projects */
+    projects: number;
+    /** Base team members included in tier */
+    teamMembers: number;
+    /** Compliance frameworks available */
+    complianceFrameworks: number;
+}
+export interface SeatPricing {
+    /** Price per additional seat per month */
+    monthlyPricePerSeat: number;
+    /** Price per additional seat per year */
+    annualPricePerSeat: number;
+    /** Maximum additional seats allowed (-1 = unlimited) */
+    maxAdditionalSeats: number;
+    /** Whether this tier supports additional seats */
+    supportsAdditionalSeats: boolean;
+}
+export declare const SEAT_PRICING: Record<Tier, SeatPricing>;
+export interface RateLimitConfig {
+    /** Requests per minute */
+    requestsPerMinute: number;
+    /** Burst limit (max requests in short window) */
+    burstLimit: number;
+    /** Rate limit window in milliseconds */
+    windowMs: number;
+}
+export interface TierConfig {
+    /** Tier identifier */
+    id: Tier;
+    /** Display name */
+    name: string;
+    /** Monthly price in USD */
+    price: number;
+    /** Annual price in USD (typically ~2 months free) */
+    annualPrice: number;
+    /** Short description for pricing page */
+    description: string;
+    /** Features included in this tier */
+    features: Feature[];
+    /** Usage limits */
+    limits: TierLimits;
+    /** API rate limiting configuration */
+    rateLimit: RateLimitConfig;
+    /** Upsell configuration */
+    upsell: {
+        message: string;
+        nextTier: Tier;
+    };
+    /** Stripe price IDs (set via environment variables) */
+    stripe?: {
+        monthlyPriceId?: string;
+        annualPriceId?: string;
+        /** Stripe price ID for additional seats (metered or per-unit) */
+        seatPriceId?: string;
+        seatAnnualPriceId?: string;
+    };
+}
+export declare const TIER_CONFIG: Record<Tier, TierConfig>;
+/**
+ * Check if a tier string is valid
+ */
+export declare function isValidTier(tier: string): tier is Tier;
+/**
+ * Get tier config by tier name
+ */
+export declare function getTierConfig(tier: Tier): TierConfig;
+/**
+ * Get all tier configs as array (useful for iteration)
+ */
+export declare function getAllTierConfigs(): TierConfig[];
+/**
+ * Get purchasable tier configs (for pricing page)
+ */
+export declare function getPurchasableTierConfigs(): TierConfig[];
+/**
+ * Compare two tiers (-1 if a < b, 0 if equal, 1 if a > b)
+ */
+export declare function compareTiers(a: Tier, b: Tier): number;
+/**
+ * Check if tier A is higher than tier B
+ */
+export declare function isTierHigher(a: Tier, b: Tier): boolean;
+/**
+ * Find the minimum tier that has a specific feature
+ */
+export declare function getMinimumTierForFeature(feature: Feature): Tier | null;
+/**
+ * Check if a tier has a specific feature
+ */
+export declare function tierHasFeature(tier: Tier, feature: Feature): boolean;
+/**
+ * Get limit value, handling -1 as Infinity
+ */
+export declare function getEffectiveLimit(limit: number): number;
+/**
+ * Format limit for display
+ */
+export declare function formatLimit(limit: number): string;
+/**
+ * Get Stripe price ID for a tier (from environment)
+ */
+export declare function getStripePriceId(tier: PurchasableTier, interval: 'month' | 'year'): string | undefined;
+/**
+ * Map Stripe price ID back to tier
+ */
+export declare function getTierFromStripePriceId(priceId: string): Tier;
+/**
+ * Get pricing tiers formatted for landing page display
+ */
+export declare function getPricingPageTiers(): Array<{
+    id: Tier;
+    name: string;
+    price: number;
+    annual: number;
+    description: string;
+    popular: boolean;
+    features: string[];
+}>;
+/**
+ * Get rate limit config for a tier (for rate-limiter middleware)
+ */
+export declare function getRateLimitForTier(tier: Tier): RateLimitConfig;
+/**
+ * Get user tiers formatted for rate limiter
+ */
+export declare function getRateLimiterTiers(): Record<Tier, {
+    name: string;
+    baseLimit: number;
+    burstLimit: number;
+    windowMs: number;
+}>;
+/**
+ * Get seat pricing for a tier
+ */
+export declare function getSeatPricing(tier: Tier): SeatPricing;
+/**
+ * Calculate effective team seats (base + purchased extras)
+ */
+export declare function calculateEffectiveSeats(tier: Tier, purchasedExtraSeats: number): number;
+/**
+ * Check if a member can be added given current seats and effective limit
+ */
+export declare function canAddMember(tier: Tier, currentMemberCount: number, purchasedExtraSeats: number): {
+    allowed: boolean;
+    reason?: string;
+    effectiveSeats: number;
+};
+/**
+ * Calculate cost for additional seats
+ */
+export declare function calculateSeatCost(tier: Tier, additionalSeats: number, billingInterval: 'month' | 'year'): {
+    total: number;
+    perSeat: number;
+    supported: boolean;
+};
+/**
+ * Get Stripe seat price ID for a tier
+ */
+export declare function getStripeSeatPriceId(tier: Tier, interval: 'month' | 'year'): string | undefined;
+/**
+ * Format seat info for display
+ */
+export declare function formatSeatInfo(tier: Tier): string;
+/**
+ * Validate seat reduction (graceful handling)
+ * Returns info about whether reduction is safe or requires admin action
+ */
+export declare function validateSeatReduction(currentMemberCount: number, _currentEffectiveSeats: number, // Kept for API compatibility, may be used for logging
+newEffectiveSeats: number): {
+    safe: boolean;
+    requiresAction: boolean;
+    excessMembers: number;
+    message: string;
+};
+//# sourceMappingURL=tier-config.d.ts.map

package/dist/tier-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-config.d.ts","sourceRoot":"","sources":["../src/tier-config.ts"],"names":[],"mappings":"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"}