@prave/shared 1.0.0 → 1.0.2

package/dist/schemas/intelligence.schema.d.ts

@@ -115,4 +115,27 @@ export declare const recordSkillUsageBatchSchema: z.ZodObject<{
     }[];
 }>;
 export type RecordSkillUsageBatchInput = z.infer<typeof recordSkillUsageBatchSchema>;
+/**
+ * Slug-keyed usage event. Used by the real-time PostToolUse hook so the
+ * CLI can fire-and-forget without first running `prave sync` to populate
+ * `skill_metadata`. The server resolves the slug → `skill_metadata_id`
+ * itself, creating a minimal stub row when needed (self-healing).
+ */
+export declare const recordSkillUsageBySlugSchema: z.ZodObject<{
+    slug: z.ZodString;
+    trigger_phrase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    triggered_at: z.ZodOptional<z.ZodString>;
+    agent_type: z.ZodOptional<z.ZodEnum<["claude", "codex", "cursor", "gemini", "cline", "amp"]>>;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    agent_type?: "claude" | "codex" | "cursor" | "gemini" | "cline" | "amp" | undefined;
+    trigger_phrase?: string | null | undefined;
+    triggered_at?: string | undefined;
+}, {
+    slug: string;
+    agent_type?: "claude" | "codex" | "cursor" | "gemini" | "cline" | "amp" | undefined;
+    trigger_phrase?: string | null | undefined;
+    triggered_at?: string | undefined;
+}>;
+export type RecordSkillUsageBySlugInput = z.infer<typeof recordSkillUsageBySlugSchema>;
 //# sourceMappingURL=intelligence.schema.d.ts.map

package/dist/schemas/intelligence.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intelligence.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/intelligence.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,eAAe,oEAAsB,CAAA;AAElD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,6BAA6B;;;;;;;;;EAGxC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEnF,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYpC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEhF,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE1E;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;EAWtC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"intelligence.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/intelligence.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,eAAe,oEAAsB,CAAA;AAElD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,6BAA6B;;;;;;;;;EAGxC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEnF,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYpC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEhF,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE1E;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;EAWtC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAEpF;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;EASvC,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA"}

package/dist/schemas/intelligence.schema.js

@@ -47,3 +47,19 @@ export const recordSkillUsageBatchSchema = z.object({
         .min(1)
         .max(500),
 });
+/**
+ * Slug-keyed usage event. Used by the real-time PostToolUse hook so the
+ * CLI can fire-and-forget without first running `prave sync` to populate
+ * `skill_metadata`. The server resolves the slug → `skill_metadata_id`
+ * itself, creating a minimal stub row when needed (self-healing).
+ */
+export const recordSkillUsageBySlugSchema = z.object({
+    slug: z
+        .string()
+        .min(1)
+        .max(120)
+        .regex(/^[a-z0-9][a-z0-9_-]*$/i, 'slug must be kebab/snake case'),
+    trigger_phrase: z.string().max(500).nullish(),
+    triggered_at: z.string().datetime().optional(),
+    agent_type: z.enum(['claude', 'codex', 'cursor', 'gemini', 'cline', 'amp']).optional(),
+});

package/dist/types/plan-limits.d.ts

@@ -1,54 +1,113 @@
 import type { Plan } from '../schemas/billing.schema.js';
 /**
  * PLAN_LIMITS — single source of truth for every gate, quota and copy
- * choice across the app. Backend uses the numeric/boolean fields to
- * enforce rules; frontend reads the same object to render disabled
- * states + upgrade CTAs; CLI calls /me/plan and resolves limits here so
- * one config drives all three surfaces.
+ * choice across the platform.
  *
- * `null` numeric limits = unlimited.
+ * Tier identity:
+ *   - `free`      → public **Free** tier. Discovery + 5 installs/month.
+ *   - `explorer`  → marketed as **Pro** ($16/mo · $144/yr). Power-user toolkit.
+ *   - `creator`   → marketed as **Max** ($39/mo · $360/yr). Bulk-dev + BYO-key.
+ *
+ * The internal IDs stay `free | explorer | creator` because Stripe price
+ * env vars, the `profiles.plan` enum and live customer rows already use
+ * them — renaming would break every existing reference. The user-visible
+ * `label` field is the only thing that ever surfaces in UI copy, and
+ * those map cleanly to Free / Pro / Max.
  */
 export interface PlanLimits {
-    /** Display label used in pricing cards / Settings */
+    /** Display label used in pricing cards / Settings ("Free" / "Pro" / "Max"). */
     label: string;
-    /** Monthly price in EUR (display only — Stripe is the source of truth) */
-    price_eur_monthly: number;
-    /** Marketing tagline for the plan card */
+    /** Marketing tagline for the plan card. */
     tagline: string;
-    /** Marketplace creator share (0–1). Free can't sell. */
-    creator_revenue_share: number | null;
-    /** Max public skills the user can publish. null = unlimited. */
-    max_public_skills: number | null;
+    /** Monthly price in USD (display only — Stripe is the source of truth). */
+    price_usd_monthly: number;
+    /** Yearly price in USD — ~25-30% off the monthly equivalent. */
+    price_usd_yearly: number;
+    /** Position on the upgrade ladder. Higher = more features. */
+    rank: number;
+    /** Highlighted "most popular" pin in the pricing grid. */
+    highlight: boolean;
+    /** Browse + LLM-search the public registry. Always true. */
+    can_discover: boolean;
+    /** Bookmarks. Always true. */
+    can_bookmark: boolean;
+    /**
+     * Monthly install ceiling. `null` = unlimited.
+     * Free: 5/mo, Pro+ unlimited. Counter resets on calendar month rollover.
+     */
+    install_monthly_limit: number | null;
+    /** Allowed deploy targets. Empty list = no Multi-Agent feature. */
+    multi_agent_targets: ReadonlyArray<'claude' | 'codex' | 'cursor' | 'gemini' | 'cline' | 'amp'>;
+    /** `prave sync` enabled. */
+    can_cli_sync: boolean;
+    /** `prave update` (and the dashboard Update Banner). */
+    can_cli_update: boolean;
+    /** Cross-machine install ledger sync. */
+    can_cross_machine_sync: boolean;
+    /** Can the user publish public skills? */
+    can_authoring_public: boolean;
     /** Can the user create private skills? */
-    can_private_skills: boolean;
-    /** Max private skills if allowed. null = unlimited. */
-    max_private_skills: number | null;
+    can_authoring_private: boolean;
+    /**
+     * Total authored-skill ceiling (public + private). `null` = unlimited.
+     */
+    authoring_max_skills: number | null;
     /** History tab + revert. */
     can_versioning: boolean;
-    /** Max paid skills listed simultaneously. 0 = no marketplace. null = unlimited. */
-    max_marketplace_listings: number | null;
-    /** Monthly BYOK tester runs. 0 = blocked. null = unlimited. */
-    tester_credits_monthly: number | null;
-    /** Max bookmarks. null = unlimited. */
-    max_bookmarks: number | null;
-    /** Total skills the user may import via CLI. null = unlimited. */
-    cli_max_imports: number | null;
-    /** Monthly export quota via CLI. 0 = blocked. null = unlimited. */
-    cli_exports_monthly: number | null;
-    /** `prave sync` enabled. */
-    can_cli_sync: boolean;
-    /** Auto-update on `prave sync` rather than diff-only. */
-    can_cli_auto_update: boolean;
-    /** `prave install --bulk`, `prave export --bulk`. */
-    can_cli_bulk: boolean;
-    /** Drag-and-drop block builder UI. */
-    can_block_builder: boolean;
-    /** CI-style skill pipelines + automated tests. */
-    can_pipelines: boolean;
-    /** Per-skill analytics page. */
-    can_analytics: boolean;
-    /** Verified Creator badge on public profile. */
-    has_creator_badge: boolean;
+    /** AI-Description generate-button in the editor. */
+    can_ai_description: boolean;
+    /** Pull-request workflow on others' skills. */
+    can_pull_requests: boolean;
+    /**
+     * Monthly Skill-Tester credits. 0 = blocked entirely.
+     * 1 run costs `tester_cost_per_run` credits.
+     * Free: 0   ·   Pro: 100   ·   Max: 300
+     */
+    tester_credits_monthly: number;
+    /** Cost (in credits) of a single tester run. */
+    tester_cost_per_run: number;
+    /**
+     * Anti-spam cooldown between tester runs in seconds. 0 = no cooldown
+     * (Max-tier privilege). Pro = 180s (3 min).
+     */
+    tester_cooldown_seconds: number;
+    /** BYO-Anthropic-key tester mode (uses user's own key, no Prave credits). */
+    can_byo_tester_key: boolean;
+    /** Access the Intelligence dashboard at all. */
+    can_intelligence: boolean;
+    /**
+     * How many of the user's skills get indexed by the Intelligence
+     * pipeline (token audit + conflicts + optimizer).
+     * Pro = 25, Max = unlimited (`null`). Beyond the limit, skills exist
+     * but don't appear in conflict/optimizer outputs.
+     */
+    intelligence_indexed_max: number | null;
+    /** "Apply all suggestions" batch run on the editor. */
+    can_apply_all: boolean;
+    /** Hook + scanner usage tracking. */
+    can_usage_tracking: boolean;
+    /**
+     * How many days of usage-stat history are retained for the user.
+     * `null` = forever.
+     */
+    usage_history_days: number | null;
+    /** CSV export of usage history. */
+    can_usage_export: boolean;
+    /** Public profile page at `/u/<username>`. */
+    can_public_profile: boolean;
+    /**
+     * Magic-link skill sharing. Generates time-limited URLs that let
+     * non-paying recipients install a private skill once. Max-only.
+     */
+    can_magic_link_share: boolean;
+    /** Verified Creator badge (auto for paid plans). */
+    has_verified_badge: boolean;
+    /** Priority badge highlight (Max only — small visual emphasis). */
+    has_priority_badge: boolean;
+    /** Priority email support with a 24h SLA. */
+    has_priority_support: boolean;
+    /** Early access to in-development features. */
+    has_early_access: boolean;
 }
 export declare const PLAN_LIMITS: Record<Plan, PlanLimits>;
 export declare const PLAN_RANK: Record<Plan, number>;
@@ -56,7 +115,21 @@ export declare const PLAN_RANK: Record<Plan, number>;
 export declare const planMeets: (actual: Plan, required: Plan) => boolean;
 /**
  * Smallest plan that satisfies a feature flag. Used by the UI to render
- * accurate "Upgrade to X" CTAs without hard-coding plan names.
+ * accurate "Upgrade to <plan>" CTAs without hard-coding plan names.
+ *
+ * Numeric features pass when the value is non-zero or `null` (unlimited);
+ * boolean features pass when `true`.
  */
 export declare const minPlanFor: (feature: keyof PlanLimits) => Plan | null;
+/**
+ * Resolve a plan's user-facing label from the internal id. Use this in
+ * any copy ("upgrade to Pro", "Max-only feature") so renames stay
+ * consistent.
+ */
+export declare const planLabel: (plan: Plan) => string;
+/**
+ * Compute the user's remaining monthly install allowance. Returns
+ * `null` for unlimited tiers and a non-negative number otherwise.
+ */
+export declare const installsRemaining: (plan: Plan, usedThisMonth: number) => number | null;
 //# sourceMappingURL=plan-limits.d.ts.map

package/dist/types/plan-limits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-limits.d.ts","sourceRoot":"","sources":["../../src/types/plan-limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AAExD;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAA;IACzB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,wDAAwD;IACxD,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;IAGpC,gEAAgE;IAChE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,0CAA0C;IAC1C,kBAAkB,EAAE,OAAO,CAAA;IAC3B,uDAAuD;IACvD,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,4BAA4B;IAC5B,cAAc,EAAE,OAAO,CAAA;IAGvB,mFAAmF;IACnF,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAA;IAGvC,+DAA+D;IAC/D,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;IAGrC,uCAAuC;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAG5B,kEAAkE;IAClE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,mEAAmE;IACnE,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,4BAA4B;IAC5B,YAAY,EAAE,OAAO,CAAA;IACrB,yDAAyD;IACzD,mBAAmB,EAAE,OAAO,CAAA;IAC5B,qDAAqD;IACrD,YAAY,EAAE,OAAO,CAAA;IAGrB,sCAAsC;IACtC,iBAAiB,EAAE,OAAO,CAAA;IAC1B,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAA;IACtB,gCAAgC;IAChC,aAAa,EAAE,OAAO,CAAA;IACtB,gDAAgD;IAChD,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,CA+EhD,CAAA;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAI1C,CAAA;AAED,8DAA8D;AAC9D,eAAO,MAAM,SAAS,GAAI,QAAQ,IAAI,EAAE,UAAU,IAAI,KAAG,OACf,CAAA;AAE1C;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,UAAU,KAAG,IAAI,GAAG,IAO7D,CAAA"}
+{"version":3,"file":"plan-limits.d.ts","sourceRoot":"","sources":["../../src/types/plan-limits.ts"],"names":[],"mappings":"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"}

package/dist/types/plan-limits.js

@@ -1,88 +1,162 @@
+const ALL_AGENTS = ['claude', 'codex', 'cursor', 'gemini', 'cline', 'amp'];
 export const PLAN_LIMITS = {
+    // ── Free ──────────────────────────────────────────────────────────
     free: {
-        label: 'Starter',
-        price_eur_monthly: 0,
-        tagline: 'Discover, install and try Prave Skills.',
-        creator_revenue_share: null,
-        max_public_skills: 3,
-        can_private_skills: false,
-        max_private_skills: 0,
-        can_versioning: false,
-        max_marketplace_listings: 0,
-        tester_credits_monthly: 10,
-        max_bookmarks: 5,
-        cli_max_imports: 10,
-        cli_exports_monthly: 0,
+        label: 'Free',
+        tagline: 'Discover and install Skills across your agents.',
+        price_usd_monthly: 0,
+        price_usd_yearly: 0,
+        rank: 0,
+        highlight: false,
+        can_discover: true,
+        can_bookmark: true,
+        install_monthly_limit: 5,
+        multi_agent_targets: ['claude'],
         can_cli_sync: false,
-        can_cli_auto_update: false,
-        can_cli_bulk: false,
-        can_block_builder: false,
-        can_pipelines: false,
-        can_analytics: false,
-        has_creator_badge: false,
+        can_cli_update: false,
+        can_cross_machine_sync: false,
+        can_authoring_public: false,
+        can_authoring_private: false,
+        authoring_max_skills: 0,
+        can_versioning: false,
+        can_ai_description: false,
+        can_pull_requests: false,
+        tester_credits_monthly: 0,
+        tester_cost_per_run: 5,
+        tester_cooldown_seconds: 0,
+        can_byo_tester_key: false,
+        can_intelligence: false,
+        intelligence_indexed_max: 0,
+        can_apply_all: false,
+        can_usage_tracking: false,
+        usage_history_days: 0,
+        can_usage_export: false,
+        can_public_profile: false,
+        can_magic_link_share: false,
+        has_verified_badge: false,
+        has_priority_badge: false,
+        has_priority_support: false,
+        has_early_access: false,
     },
+    // ── Pro (internally `explorer`) ───────────────────────────────────
     explorer: {
-        label: 'Explorer',
-        price_eur_monthly: 4,
-        tagline: 'For developers building and shipping Skills.',
-        creator_revenue_share: null,
-        max_public_skills: 20,
-        can_private_skills: true,
-        max_private_skills: 20,
-        can_versioning: true,
-        max_marketplace_listings: 0,
-        tester_credits_monthly: 80,
-        max_bookmarks: null,
-        cli_max_imports: null,
-        cli_exports_monthly: 50,
+        label: 'Pro',
+        tagline: 'Multi-agent skill ops + Intelligence audit for power users.',
+        price_usd_monthly: 16,
+        price_usd_yearly: 144,
+        rank: 1,
+        highlight: true,
+        can_discover: true,
+        can_bookmark: true,
+        install_monthly_limit: null,
+        multi_agent_targets: ALL_AGENTS,
         can_cli_sync: true,
-        can_cli_auto_update: false,
-        can_cli_bulk: false,
-        can_block_builder: false,
-        can_pipelines: false,
-        can_analytics: false,
-        has_creator_badge: false,
+        can_cli_update: true,
+        can_cross_machine_sync: true,
+        can_authoring_public: true,
+        can_authoring_private: true,
+        authoring_max_skills: null,
+        can_versioning: true,
+        can_ai_description: true,
+        can_pull_requests: true,
+        tester_credits_monthly: 100,
+        tester_cost_per_run: 5,
+        tester_cooldown_seconds: 180,
+        can_byo_tester_key: false,
+        can_intelligence: true,
+        intelligence_indexed_max: 25,
+        can_apply_all: false,
+        can_usage_tracking: true,
+        usage_history_days: 30,
+        can_usage_export: false,
+        can_public_profile: true,
+        can_magic_link_share: false,
+        has_verified_badge: true,
+        has_priority_badge: false,
+        has_priority_support: false,
+        has_early_access: false,
     },
+    // ── Max (internally `creator`) ────────────────────────────────────
     creator: {
-        label: 'Creator',
-        price_eur_monthly: 10,
-        tagline: 'For power users shipping and selling Skills daily.',
-        creator_revenue_share: 0.7,
-        max_public_skills: null,
-        can_private_skills: true,
-        max_private_skills: null,
-        can_versioning: true,
-        max_marketplace_listings: null,
-        tester_credits_monthly: 250,
-        max_bookmarks: null,
-        cli_max_imports: null,
-        cli_exports_monthly: null,
+        label: 'Max',
+        tagline: 'Bulk-dev tier with unlimited audit, BYO-key tester and magic-link sharing.',
+        price_usd_monthly: 39,
+        price_usd_yearly: 360,
+        rank: 2,
+        highlight: false,
+        can_discover: true,
+        can_bookmark: true,
+        install_monthly_limit: null,
+        multi_agent_targets: ALL_AGENTS,
         can_cli_sync: true,
-        can_cli_auto_update: true,
-        can_cli_bulk: true,
-        can_block_builder: true,
-        can_pipelines: true,
-        can_analytics: true,
-        has_creator_badge: true,
+        can_cli_update: true,
+        can_cross_machine_sync: true,
+        can_authoring_public: true,
+        can_authoring_private: true,
+        authoring_max_skills: null,
+        can_versioning: true,
+        can_ai_description: true,
+        can_pull_requests: true,
+        tester_credits_monthly: 300,
+        tester_cost_per_run: 5,
+        tester_cooldown_seconds: 0,
+        can_byo_tester_key: true,
+        can_intelligence: true,
+        intelligence_indexed_max: null,
+        can_apply_all: true,
+        can_usage_tracking: true,
+        usage_history_days: null,
+        can_usage_export: true,
+        can_public_profile: true,
+        can_magic_link_share: true,
+        has_verified_badge: true,
+        has_priority_badge: true,
+        has_priority_support: true,
+        has_early_access: true,
     },
 };
 export const PLAN_RANK = {
-    free: 0,
-    explorer: 1,
-    creator: 2,
+    free: PLAN_LIMITS.free.rank,
+    explorer: PLAN_LIMITS.explorer.rank,
+    creator: PLAN_LIMITS.creator.rank,
 };
 /** True when `actual` includes everything `required` does. */
 export const planMeets = (actual, required) => PLAN_RANK[actual] >= PLAN_RANK[required];
 /**
  * Smallest plan that satisfies a feature flag. Used by the UI to render
- * accurate "Upgrade to X" CTAs without hard-coding plan names.
+ * accurate "Upgrade to <plan>" CTAs without hard-coding plan names.
+ *
+ * Numeric features pass when the value is non-zero or `null` (unlimited);
+ * boolean features pass when `true`.
  */
 export const minPlanFor = (feature) => {
     const order = ['free', 'explorer', 'creator'];
     for (const plan of order) {
         const v = PLAN_LIMITS[plan][feature];
-        if (typeof v === 'boolean' ? v : v !== 0)
+        if (typeof v === 'boolean' && v)
+            return plan;
+        if (typeof v === 'number' && v > 0)
+            return plan;
+        if (v === null)
+            return plan;
+        if (Array.isArray(v) && v.length > 0)
             return plan;
     }
     return null;
 };
+/**
+ * Resolve a plan's user-facing label from the internal id. Use this in
+ * any copy ("upgrade to Pro", "Max-only feature") so renames stay
+ * consistent.
+ */
+export const planLabel = (plan) => PLAN_LIMITS[plan].label;
+/**
+ * Compute the user's remaining monthly install allowance. Returns
+ * `null` for unlimited tiers and a non-negative number otherwise.
+ */
+export const installsRemaining = (plan, usedThisMonth) => {
+    const limit = PLAN_LIMITS[plan].install_monthly_limit;
+    if (limit === null)
+        return null;
+    return Math.max(0, limit - usedThisMonth);
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prave/shared",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "publishConfig": {
     "access": "public"