@cullit/core 1.18.1 → 2.0.1

package/dist/index.d.ts

@@ -71,7 +71,7 @@ interface PipelineResult {
     duration: number;
 }
 
-declare const VERSION = "1.18.1";
+declare const VERSION = "2.0.1";
 declare const DEFAULT_CATEGORIES: string[];
 declare const DEFAULT_MODELS: Record<string, string>;
 declare const AI_PROVIDERS: readonly ["anthropic", "openai", "gemini", "ollama", "none"];
@@ -82,6 +82,12 @@ declare const CHANGE_CATEGORIES: readonly ["features", "fixes", "breaking", "imp
 declare const AUDIENCES: readonly ["developer", "end-user", "executive"];
 declare const TONES: readonly ["professional", "casual", "terse", "edgy", "hype", "snarky"];
 declare const SOURCE_TYPES: readonly ["local", "jira", "linear", "gitlab", "bitbucket", "multi-repo"];
+declare const TIERS: readonly ["free", "basic", "pro", "team", "enterprise"];
+declare const PAID_TIERS: readonly ["basic", "pro", "team", "enterprise"];
+declare const TEAM_TIERS: readonly ["team", "enterprise"];
+declare const TEAM_PLANS: readonly ["team-5", "team-10", "team-25"];
+type TeamPlan = (typeof TEAM_PLANS)[number];
+declare const TEAM_PLAN_SEATS: Record<TeamPlan, number>;
 
 type LogLevel = 'quiet' | 'normal' | 'verbose';
 interface Logger {
@@ -219,7 +225,7 @@ declare function analyzeReleaseReadiness(cwd?: string): ReleaseAdvisory;
  * validateLicense() performs async remote validation with caching.
  * resolveLicense() remains sync for quick format-only checks (display).
  */
-type LicenseTier = 'free' | 'pro' | 'team' | 'enterprise';
+type LicenseTier = 'free' | 'basic' | 'pro' | 'team' | 'enterprise';
 interface LicenseStatus {
     tier: LicenseTier;
     valid: boolean;
@@ -247,8 +253,14 @@ declare function isProviderAllowed(provider: string, license: LicenseStatus): bo
 declare function isPublisherAllowed(publisherType: string, license: LicenseStatus): boolean;
 /**
  * Check whether the current license allows enrichment (Jira/Linear).
+ * Requires Pro tier or above.
  */
 declare function isEnrichmentAllowed(license: LicenseStatus): boolean;
+/**
+ * Check whether the current license allows audience & tone control.
+ * Requires Pro tier or above.
+ */
+declare function isAudienceToneAllowed(license: LicenseStatus): boolean;
 /**
  * Build a human-readable upgrade message for a gated feature.
  */
@@ -315,9 +327,13 @@ declare function fetchWithTimeout(url: string, init: RequestInit, timeoutMs?: nu
 /**
  * Rate Limiter — Sliding-window rate limiter with pluggable backends.
  *
+ * Backends:
+ *   - MemoryRateLimiter (default) — in-process, single instance only
+ *   - RedisRateLimiter — shared across instances via REDIS_URL
+ *
  * Usage:
  *   const limiter = createRateLimiter({ limit: 30, windowMs: 60_000 });
- *   const result = limiter.check('user-ip-or-key');
+ *   const result = await limiter.check('user-ip-or-key');
  *   if (!result.allowed) { // reject }
  */
 interface RateLimitResult {
@@ -327,9 +343,9 @@ interface RateLimitResult {
     resetAt: number;
 }
 interface RateLimiter {
-    check(key: string): RateLimitResult;
+    check(key: string): RateLimitResult | Promise<RateLimitResult>;
     /** Remove all tracked entries */
-    reset(): void;
+    reset(): void | Promise<void>;
 }
 interface RateLimiterOptions {
     /** Max requests per window (default: 30) */
@@ -378,4 +394,4 @@ declare function runPipeline(from: string, to: string, config: CullConfig, optio
     templateProfile?: string;
 }): Promise<PipelineResult>;
 
-export { AI_PROVIDERS, AUDIENCES, CHANGE_CATEGORIES, type ChangeCategory, type ChangeEntry, type Collector, type CollectorFactory, CoreErrorCode, type CoreErrorCodeValue, CullitError, DEFAULT_CATEGORIES, DEFAULT_MODELS, ENRICHMENT_TYPES, type EnrichedContext, type EnrichedTicket, type Enricher, type EnricherFactory, FilePublisher, type Generator, type GeneratorFactory, GitCollector, type GitCommit, type GitDiff, type LicenseStatus, type LicenseTier, type LogLevel, type Logger, MultiRepoCollector, OUTPUT_FORMATS, PUBLISHER_TYPES, type PipelineResult, type Publisher, type PublisherFactory, type RateLimitResult, type RateLimiter, type RateLimiterOptions, type ReleaseAdvisory, type ReleaseNotes, SOURCE_TYPES, type SemverBump, StdoutPublisher, TONES, type TeamFeature, TemplateGenerator, type UsageLimits, VERSION, analyzeReleaseReadiness, createLogger, createRateLimiter, escapeHtml, fetchWithTimeout, formatNotes, getCollector, getEnricher, getFeatureGating, getFormatter, getGenerator, getLatestTag, getPublisher, getRecentTags, getTierLimits, hasCollector, hasEnricher, hasGenerator, hasPublisher, isEnrichmentAllowed, isFeatureAllowed, isProviderAllowed, isPublisherAllowed, listCollectors, listEnrichers, listFormatters, listGenerators, listPublishers, registerCollector, registerEnricher, registerFormatter, registerGenerator, registerPublisher, reportUsage, resolveLicense, runPipeline, upgradeMessage, validateLicense };
+export { AI_PROVIDERS, AUDIENCES, CHANGE_CATEGORIES, type ChangeCategory, type ChangeEntry, type Collector, type CollectorFactory, CoreErrorCode, type CoreErrorCodeValue, CullitError, DEFAULT_CATEGORIES, DEFAULT_MODELS, ENRICHMENT_TYPES, type EnrichedContext, type EnrichedTicket, type Enricher, type EnricherFactory, FilePublisher, type Generator, type GeneratorFactory, GitCollector, type GitCommit, type GitDiff, type LicenseStatus, type LicenseTier, type LogLevel, type Logger, MultiRepoCollector, OUTPUT_FORMATS, PAID_TIERS, PUBLISHER_TYPES, type PipelineResult, type Publisher, type PublisherFactory, type RateLimitResult, type RateLimiter, type RateLimiterOptions, type ReleaseAdvisory, type ReleaseNotes, SOURCE_TYPES, type SemverBump, StdoutPublisher, TEAM_PLANS, TEAM_PLAN_SEATS, TEAM_TIERS, TIERS, TONES, type TeamFeature, type TeamPlan, TemplateGenerator, type UsageLimits, VERSION, analyzeReleaseReadiness, createLogger, createRateLimiter, escapeHtml, fetchWithTimeout, formatNotes, getCollector, getEnricher, getFeatureGating, getFormatter, getGenerator, getLatestTag, getPublisher, getRecentTags, getTierLimits, hasCollector, hasEnricher, hasGenerator, hasPublisher, isAudienceToneAllowed, isEnrichmentAllowed, isFeatureAllowed, isProviderAllowed, isPublisherAllowed, listCollectors, listEnrichers, listFormatters, listGenerators, listPublishers, registerCollector, registerEnricher, registerFormatter, registerGenerator, registerPublisher, reportUsage, resolveLicense, runPipeline, upgradeMessage, validateLicense };

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/constants.ts
-var VERSION = "1.18.1";
+var VERSION = "2.0.1";
 var DEFAULT_CATEGORIES = ["features", "fixes", "breaking", "improvements", "chores"];
 var DEFAULT_MODELS = {
   anthropic: "claude-sonnet-4-20250514",
@@ -15,6 +15,15 @@ var CHANGE_CATEGORIES = ["features", "fixes", "breaking", "improvements", "chore
 var AUDIENCES = ["developer", "end-user", "executive"];
 var TONES = ["professional", "casual", "terse", "edgy", "hype", "snarky"];
 var SOURCE_TYPES = ["local", "jira", "linear", "gitlab", "bitbucket", "multi-repo"];
+var TIERS = ["free", "basic", "pro", "team", "enterprise"];
+var PAID_TIERS = ["basic", "pro", "team", "enterprise"];
+var TEAM_TIERS = ["team", "enterprise"];
+var TEAM_PLANS = ["team-5", "team-10", "team-25"];
+var TEAM_PLAN_SEATS = {
+  "team-5": 5,
+  "team-10": 10,
+  "team-25": 25
+};
 
 // src/logger.ts
 function createLogger(level = "normal") {
@@ -796,7 +805,7 @@ async function validateLicense() {
     if (res.ok) {
       const data = await res.json();
       const status2 = {
-        tier: data.tier === "team" || data.tier === "enterprise" ? data.tier : data.tier === "pro" ? "pro" : "free",
+        tier: data.tier === "team" || data.tier === "enterprise" ? data.tier : data.tier === "pro" ? "pro" : data.tier === "basic" ? "basic" : "free",
         valid: data.valid !== false,
         message: data.message
       };
@@ -829,15 +838,19 @@ function isPublisherAllowed(publisherType, license) {
   return FREE_PUBLISHERS.has(publisherType);
 }
 function isEnrichmentAllowed(license) {
-  return license.tier !== "free" && license.valid;
+  return (license.tier === "pro" || license.tier === "team" || license.tier === "enterprise") && license.valid;
+}
+function isAudienceToneAllowed(license) {
+  return (license.tier === "pro" || license.tier === "team" || license.tier === "enterprise") && license.valid;
 }
 function upgradeMessage(feature) {
-  return `\u{1F512} ${feature} requires a Cullit Pro license.
-   Get your API key at https://cullit.io/pricing
+  return `\u{1F512} ${feature} requires a Cullit Pro plan or above.
+   Upgrade at https://cullit.io/pricing
    Then set CULLIT_API_KEY in your environment.`;
 }
 var TIER_LIMITS = {
   free: { generationsPerMonth: 5, maxProjects: 3 },
+  basic: { generationsPerMonth: 50, maxProjects: 10 },
   pro: { generationsPerMonth: 500, maxProjects: 100 },
   team: { generationsPerMonth: 2e3, maxProjects: 250 },
   enterprise: { generationsPerMonth: Infinity, maxProjects: Infinity }
@@ -850,7 +863,7 @@ var FEATURE_TIERS = {
   approvals: /* @__PURE__ */ new Set(["team", "enterprise"]),
   shared_history: /* @__PURE__ */ new Set(["team", "enterprise"]),
   project_templates: /* @__PURE__ */ new Set(["team", "enterprise"]),
-  hosted_changelog: /* @__PURE__ */ new Set(["pro", "team", "enterprise"]),
+  hosted_changelog: /* @__PURE__ */ new Set(["basic", "pro", "team", "enterprise"]),
   branded_widget: /* @__PURE__ */ new Set(["team", "enterprise"]),
   team_publishers: /* @__PURE__ */ new Set(["team", "enterprise"]),
   org_settings: /* @__PURE__ */ new Set(["team", "enterprise"]),
@@ -986,8 +999,58 @@ var MemoryRateLimiter = class {
   }
 };
 function createRateLimiter(opts) {
+  const redisUrl = process.env["REDIS_URL"];
+  if (redisUrl) {
+    return new RedisRateLimiter(redisUrl, opts);
+  }
   return new MemoryRateLimiter(opts);
 }
+var RedisRateLimiter = class {
+  limit;
+  windowMs;
+  redisUrl;
+  prefix;
+  constructor(redisUrl, opts = {}) {
+    this.limit = opts.limit ?? 30;
+    this.windowMs = opts.windowMs ?? 6e4;
+    this.redisUrl = redisUrl;
+    this.prefix = "cullit:rl:";
+  }
+  async check(key) {
+    const now = Date.now();
+    const windowStart = now - this.windowMs;
+    const redisKey = this.prefix + key;
+    try {
+      const res = await fetch(this.redisUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify([
+          ["ZREMRANGEBYSCORE", redisKey, "0", String(windowStart)],
+          ["ZCARD", redisKey],
+          ["ZADD", redisKey, String(now), `${now}-${Math.random().toString(36).slice(2, 8)}`],
+          ["PEXPIRE", redisKey, String(this.windowMs)]
+        ]),
+        signal: AbortSignal.timeout(3e3)
+      });
+      if (!res.ok) return this.fallbackAllow(now);
+      const results = await res.json();
+      const count = results[1]?.result ?? 0;
+      const remaining = Math.max(0, this.limit - count);
+      const resetAt = Math.ceil((now + this.windowMs) / 1e3);
+      if (count >= this.limit) {
+        return { allowed: false, remaining: 0, resetAt };
+      }
+      return { allowed: true, remaining: remaining - 1, resetAt };
+    } catch {
+      return this.fallbackAllow(now);
+    }
+  }
+  fallbackAllow(now) {
+    return { allowed: true, remaining: this.limit, resetAt: Math.ceil((now + this.windowMs) / 1e3) };
+  }
+  async reset() {
+  }
+};
 
 // src/index.ts
 registerCollector("local", (config) => new GitCollector(config.source?.repoPath));
@@ -1210,9 +1273,14 @@ export {
   GitCollector,
   MultiRepoCollector,
   OUTPUT_FORMATS,
+  PAID_TIERS,
   PUBLISHER_TYPES,
   SOURCE_TYPES,
   StdoutPublisher,
+  TEAM_PLANS,
+  TEAM_PLAN_SEATS,
+  TEAM_TIERS,
+  TIERS,
   TONES,
   TemplateGenerator,
   VERSION,
@@ -1235,6 +1303,7 @@ export {
   hasEnricher,
   hasGenerator,
   hasPublisher,
+  isAudienceToneAllowed,
   isEnrichmentAllowed,
   isFeatureAllowed,
   isProviderAllowed,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cullit/core",
-  "version": "1.18.1",
+  "version": "2.0.1",
   "type": "module",
   "description": "Core engine for Cullit — AI-powered release note generation.",
   "license": "SEE LICENSE IN LICENSE",
@@ -38,7 +38,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@cullit/config": "1.18.1"
+    "@cullit/config": "2.0.1"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",