featuredrop 2.7.2 → 3.0.1

package/dist/next.cjs

@@ -0,0 +1,336 @@
+'use strict';
+
+var react = require('react');
+
+// src/semver.ts
+var SEMVER_REGEX = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/;
+function parseSemver(input) {
+  const match = input.trim().match(SEMVER_REGEX);
+  if (!match) return null;
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+    prerelease: match[4] ? match[4].split(".") : []
+  };
+}
+function compareSemver(a, b) {
+  const pa = parseSemver(a);
+  const pb = parseSemver(b);
+  if (!pa || !pb) return 0;
+  for (const key of ["major", "minor", "patch"]) {
+    if (pa[key] !== pb[key]) return pa[key] - pb[key];
+  }
+  const aPre = pa.prerelease;
+  const bPre = pb.prerelease;
+  if (aPre.length === 0 && bPre.length === 0) return 0;
+  if (aPre.length === 0) return 1;
+  if (bPre.length === 0) return -1;
+  const len = Math.max(aPre.length, bPre.length);
+  for (let i = 0; i < len; i++) {
+    const ai = aPre[i];
+    const bi = bPre[i];
+    if (ai === void 0) return -1;
+    if (bi === void 0) return 1;
+    const aNum = Number(ai);
+    const bNum = Number(bi);
+    const aIsNum = Number.isInteger(aNum);
+    const bIsNum = Number.isInteger(bNum);
+    if (aIsNum && bIsNum && aNum !== bNum) return aNum - bNum;
+    if (aIsNum !== bIsNum) return aIsNum ? -1 : 1;
+    if (ai !== bi) return ai < bi ? -1 : 1;
+  }
+  return 0;
+}
+function parseComparator(comp) {
+  const match = comp.trim().match(/^(>=|<=|>|<|=)?\\s*(.+)$/);
+  if (!match) return null;
+  const op = match[1] || ">=";
+  const version = match[2];
+  if (!parseSemver(version)) return null;
+  return { op, version };
+}
+function satisfiesComparator(version, comp) {
+  const diff = compareSemver(version, comp.version);
+  switch (comp.op) {
+    case ">":
+      return diff > 0;
+    case ">=":
+      return diff >= 0;
+    case "<":
+      return diff < 0;
+    case "<=":
+      return diff <= 0;
+    case "=":
+      return diff === 0;
+    default:
+      return false;
+  }
+}
+function satisfiesRange(version, range) {
+  const parts = range.split(/\s+/).filter(Boolean);
+  if (parts.length === 0) return true;
+  for (const part of parts) {
+    const comp = parseComparator(part);
+    if (!comp) return false;
+    if (!satisfiesComparator(version, comp)) return false;
+  }
+  return true;
+}
+
+// src/triggers.ts
+function wildcardToRegExp(value) {
+  const escaped = value.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+  const pattern = `^${escaped.replace(/\*/g, ".*")}$`;
+  return new RegExp(pattern);
+}
+function matchPath(path, pattern) {
+  if (pattern instanceof RegExp) return pattern.test(path);
+  if (!pattern) return false;
+  if (pattern.includes("*")) return wildcardToRegExp(pattern).test(path);
+  return path === pattern || path.startsWith(pattern);
+}
+function isTriggerMatch(trigger, context) {
+  if (!trigger) return true;
+  if (!context) return false;
+  if (trigger.type === "page") {
+    const path = context.path;
+    if (!path) return false;
+    return matchPath(path, trigger.match);
+  }
+  if (trigger.type === "usage") {
+    const usage = context.usage ?? {};
+    const count = usage[trigger.event] ?? 0;
+    return count >= (trigger.minActions ?? 1);
+  }
+  if (trigger.type === "time") {
+    const elapsedMs = context.elapsedMs ?? 0;
+    return elapsedMs >= trigger.minSeconds * 1e3;
+  }
+  if (trigger.type === "milestone") {
+    return context.milestones?.has(trigger.event) ?? false;
+  }
+  if (trigger.type === "frustration") {
+    const usage = context.usage ?? {};
+    const count = usage[trigger.pattern] ?? 0;
+    return count >= (trigger.threshold ?? 1);
+  }
+  if (trigger.type === "scroll") {
+    return (context.scrollPercent ?? 0) >= (trigger.minPercent ?? 50);
+  }
+  try {
+    return trigger.evaluate(context);
+  } catch {
+    return false;
+  }
+}
+
+// src/core.ts
+function matchesAudience(audience, userContext) {
+  if (audience.plan && audience.plan.length > 0) {
+    if (!userContext.plan || !audience.plan.includes(userContext.plan)) {
+      return false;
+    }
+  }
+  if (audience.role && audience.role.length > 0) {
+    if (!userContext.role || !audience.role.includes(userContext.role)) {
+      return false;
+    }
+  }
+  if (audience.region && audience.region.length > 0) {
+    if (!userContext.region || !audience.region.includes(userContext.region)) {
+      return false;
+    }
+  }
+  return true;
+}
+function isAudienceMatch(feature, userContext, matchFn) {
+  if (!feature.audience) return true;
+  const { plan, role, region, custom } = feature.audience;
+  const hasRules = plan && plan.length > 0 || role && role.length > 0 || region && region.length > 0 || custom && Object.keys(custom).length > 0;
+  if (!hasRules) return true;
+  if (!userContext) return false;
+  if (matchFn) return matchFn(feature.audience, userContext);
+  return matchesAudience(feature.audience, userContext);
+}
+function isVersionMatch(feature, appVersion) {
+  const v = feature.version;
+  if (!v || typeof v === "string") return true;
+  if (!appVersion) return false;
+  if (!v.introduced && !v.showNewUntil && !v.deprecatedAt && !v.showIn) return true;
+  if (v.showIn && !satisfiesRange(appVersion, v.showIn)) return false;
+  if (v.introduced && compareSemver(appVersion, v.introduced) < 0) return false;
+  if (v.deprecatedAt && compareSemver(appVersion, v.deprecatedAt) >= 0) return false;
+  if (v.showNewUntil && compareSemver(appVersion, v.showNewUntil) >= 0) return false;
+  return true;
+}
+function isFlagMatch(feature, flagBridge, userContext) {
+  if (!feature.flagKey) return true;
+  if (!flagBridge) return false;
+  try {
+    return flagBridge.isEnabled(feature.flagKey, userContext);
+  } catch {
+    return false;
+  }
+}
+function isProductMatch(feature, product) {
+  if (!feature.product || feature.product === "*") return true;
+  if (!product) return false;
+  return feature.product === product;
+}
+function isDependencyMatch(feature, dismissedIds, dependencyState) {
+  const dependsOn = feature.dependsOn;
+  if (!dependsOn) return true;
+  const seenIds = dependencyState?.seenIds;
+  const clickedIds = dependencyState?.clickedIds;
+  const dismissedDependencyIds = dependencyState?.dismissedIds ?? dismissedIds;
+  if (dependsOn.seen && dependsOn.seen.length > 0) {
+    for (const id of dependsOn.seen) {
+      const seen = seenIds?.has(id) ?? false;
+      if (!seen && !dismissedDependencyIds.has(id)) return false;
+    }
+  }
+  if (dependsOn.clicked && dependsOn.clicked.length > 0) {
+    for (const id of dependsOn.clicked) {
+      if (!(clickedIds?.has(id) ?? false)) return false;
+    }
+  }
+  if (dependsOn.dismissed && dependsOn.dismissed.length > 0) {
+    for (const id of dependsOn.dismissed) {
+      if (!dismissedDependencyIds.has(id)) return false;
+    }
+  }
+  return true;
+}
+function isNew(feature, watermark, dismissedIds, now = /* @__PURE__ */ new Date(), userContext, matchAudience, appVersion, dependencyState, triggerContext, flagBridge, product) {
+  if (dismissedIds.has(feature.id)) return false;
+  if (!isAudienceMatch(feature, userContext, matchAudience)) return false;
+  if (!isDependencyMatch(feature, dismissedIds, dependencyState)) return false;
+  if (!isVersionMatch(feature, appVersion)) return false;
+  if (!isFlagMatch(feature, flagBridge, userContext)) return false;
+  if (!isProductMatch(feature, product)) return false;
+  if (!isTriggerMatch(feature.trigger, triggerContext)) return false;
+  const nowMs = now.getTime();
+  if (feature.publishAt) {
+    const publishMs = new Date(feature.publishAt).getTime();
+    if (nowMs < publishMs) return false;
+  }
+  const showUntilMs = new Date(feature.showNewUntil).getTime();
+  if (nowMs >= showUntilMs) return false;
+  if (watermark) {
+    const watermarkMs = new Date(watermark).getTime();
+    const releasedMs = new Date(feature.releasedAt).getTime();
+    if (releasedMs <= watermarkMs) return false;
+  }
+  return true;
+}
+function getNewFeatures(manifest, storage, now = /* @__PURE__ */ new Date(), userContext, matchAudience, appVersion, dependencyState, triggerContext, flagBridge, product) {
+  const watermark = storage.getWatermark();
+  const dismissedIds = storage.getDismissedIds();
+  return manifest.filter(
+    (f) => isNew(
+      f,
+      watermark,
+      dismissedIds,
+      now,
+      userContext,
+      matchAudience,
+      appVersion,
+      dependencyState,
+      triggerContext,
+      flagBridge,
+      product
+    )
+  );
+}
+function getNewFeatureCount(manifest, storage, now = /* @__PURE__ */ new Date(), userContext, matchAudience, appVersion, dependencyState, triggerContext, flagBridge, product) {
+  return getNewFeatures(
+    manifest,
+    storage,
+    now,
+    userContext,
+    matchAudience,
+    appVersion,
+    dependencyState,
+    triggerContext,
+    flagBridge,
+    product
+  ).length;
+}
+
+// src/adapters/memory.ts
+var MemoryAdapter = class {
+  watermark;
+  dismissed;
+  constructor(options = {}) {
+    this.watermark = options.watermark ?? null;
+    this.dismissed = /* @__PURE__ */ new Set();
+  }
+  getWatermark() {
+    return this.watermark;
+  }
+  getDismissedIds() {
+    return this.dismissed;
+  }
+  dismiss(id) {
+    this.dismissed.add(id);
+  }
+  async dismissAll(now) {
+    this.watermark = now.toISOString();
+    this.dismissed.clear();
+  }
+};
+function getNewFeaturesServer(manifest, dismissedIds, options) {
+  const storage = new MemoryAdapter();
+  if (dismissedIds) {
+    for (const id of dismissedIds) {
+      storage.dismiss(id);
+    }
+  }
+  return getNewFeatures(
+    manifest,
+    storage,
+    options?.now,
+    options?.userContext,
+    options?.matchAudience,
+    options?.appVersion,
+    options?.dependencyState,
+    options?.triggerContext,
+    options?.flagBridge,
+    options?.product
+  );
+}
+function getNewCountServer(manifest, dismissedIds, options) {
+  const storage = new MemoryAdapter();
+  if (dismissedIds) {
+    for (const id of dismissedIds) {
+      storage.dismiss(id);
+    }
+  }
+  return getNewFeatureCount(
+    manifest,
+    storage,
+    options?.now,
+    options?.userContext,
+    options?.matchAudience,
+    options?.appVersion,
+    options?.dependencyState,
+    options?.triggerContext,
+    options?.flagBridge,
+    options?.product
+  );
+}
+function FeatureDropScript({ manifest, dismissedIds }) {
+  const data = JSON.stringify({ manifest, dismissedIds: dismissedIds ?? [] });
+  return react.createElement("script", {
+    id: "__FEATUREDROP_DATA__",
+    type: "application/json",
+    dangerouslySetInnerHTML: { __html: data }
+  });
+}
+
+exports.FeatureDropScript = FeatureDropScript;
+exports.getNewCountServer = getNewCountServer;
+exports.getNewFeaturesServer = getNewFeaturesServer;
+//# sourceMappingURL=next.cjs.map
+//# sourceMappingURL=next.cjs.map

package/dist/next.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/semver.ts","../src/triggers.ts","../src/core.ts","../src/adapters/memory.ts","../src/next/index.ts"],"names":["createElement"],"mappings":"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","file":"next.cjs","sourcesContent":["// Minimal semver comparison utilities (no build metadata sorting needed)\n\nexport type Comparator = \">=\" | \"<=\" | \">\" | \"<\" | \"=\";\n\nexport interface SemverParts {\n  major: number;\n  minor: number;\n  patch: number;\n  prerelease: string[];\n}\n\nconst SEMVER_REGEX = /^(\\d+)\\.(\\d+)\\.(\\d+)(?:-([0-9A-Za-z.-]+))?/;\n\nexport function parseSemver(input: string): SemverParts | null {\n  const match = input.trim().match(SEMVER_REGEX);\n  if (!match) return null;\n  return {\n    major: Number(match[1]),\n    minor: Number(match[2]),\n    patch: Number(match[3]),\n    prerelease: match[4] ? match[4].split(\".\") : [],\n  };\n}\n\nexport function compareSemver(a: string, b: string): number {\n  const pa = parseSemver(a);\n  const pb = parseSemver(b);\n  if (!pa || !pb) return 0;\n\n  for (const key of [\"major\", \"minor\", \"patch\"] as const) {\n    if (pa[key] !== pb[key]) return pa[key] - pb[key];\n  }\n\n  // Handle prerelease: absence > presence, otherwise lexicographic\n  const aPre = pa.prerelease;\n  const bPre = pb.prerelease;\n  if (aPre.length === 0 && bPre.length === 0) return 0;\n  if (aPre.length === 0) return 1;\n  if (bPre.length === 0) return -1;\n\n  const len = Math.max(aPre.length, bPre.length);\n  for (let i = 0; i < len; i++) {\n    const ai = aPre[i];\n    const bi = bPre[i];\n    if (ai === undefined) return -1;\n    if (bi === undefined) return 1;\n    const aNum = Number(ai);\n    const bNum = Number(bi);\n    const aIsNum = Number.isInteger(aNum);\n    const bIsNum = Number.isInteger(bNum);\n    if (aIsNum && bIsNum && aNum !== bNum) return aNum - bNum;\n    if (aIsNum !== bIsNum) return aIsNum ? -1 : 1;\n    if (ai !== bi) return ai < bi ? -1 : 1;\n  }\n  return 0;\n}\n\nfunction parseComparator(comp: string): { op: Comparator; version: string } | null {\n  const match = comp.trim().match(/^(>=|<=|>|<|=)?\\\\s*(.+)$/);\n  if (!match) return null;\n  const op = (match[1] as Comparator) || \">=\";\n  const version = match[2];\n  if (!parseSemver(version)) return null;\n  return { op, version };\n}\n\nfunction satisfiesComparator(version: string, comp: { op: Comparator; version: string }): boolean {\n  const diff = compareSemver(version, comp.version);\n  switch (comp.op) {\n    case \">\":\n      return diff > 0;\n    case \">=\":\n      return diff >= 0;\n    case \"<\":\n      return diff < 0;\n    case \"<=\":\n      return diff <= 0;\n    case \"=\":\n      return diff === 0;\n    default:\n      return false;\n  }\n}\n\n// Space-separated comparator list (AND semantics), e.g. \">=2.5.0 <3.0.0\"\nexport function satisfiesRange(version: string, range: string): boolean {\n  const parts = range.split(/\\s+/).filter(Boolean);\n  if (parts.length === 0) return true;\n  for (const part of parts) {\n    const comp = parseComparator(part);\n    if (!comp) return false;\n    if (!satisfiesComparator(version, comp)) return false;\n  }\n  return true;\n}\n","import type { FeatureEntry, FeatureTrigger, TriggerContext } from \"./types\";\n\nfunction wildcardToRegExp(value: string): RegExp {\n  const escaped = value.replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  const pattern = `^${escaped.replace(/\\*/g, \".*\")}$`;\n  return new RegExp(pattern);\n}\n\nfunction matchPath(path: string, pattern: string | RegExp): boolean {\n  if (pattern instanceof RegExp) return pattern.test(path);\n  if (!pattern) return false;\n  if (pattern.includes(\"*\")) return wildcardToRegExp(pattern).test(path);\n  return path === pattern || path.startsWith(pattern);\n}\n\nexport function isTriggerMatch(trigger: FeatureTrigger | undefined, context?: TriggerContext): boolean {\n  if (!trigger) return true;\n  if (!context) return false;\n\n  if (trigger.type === \"page\") {\n    const path = context.path;\n    if (!path) return false;\n    return matchPath(path, trigger.match);\n  }\n\n  if (trigger.type === \"usage\") {\n    const usage = context.usage ?? {};\n    const count = usage[trigger.event] ?? 0;\n    return count >= (trigger.minActions ?? 1);\n  }\n\n  if (trigger.type === \"time\") {\n    const elapsedMs = context.elapsedMs ?? 0;\n    return elapsedMs >= trigger.minSeconds * 1000;\n  }\n\n  if (trigger.type === \"milestone\") {\n    return context.milestones?.has(trigger.event) ?? false;\n  }\n\n  if (trigger.type === \"frustration\") {\n    const usage = context.usage ?? {};\n    const count = usage[trigger.pattern] ?? 0;\n    return count >= (trigger.threshold ?? 1);\n  }\n\n  if (trigger.type === \"scroll\") {\n    return (context.scrollPercent ?? 0) >= (trigger.minPercent ?? 50);\n  }\n\n  try {\n    return trigger.evaluate(context);\n  } catch {\n    return false;\n  }\n}\n\nexport class TriggerEngine {\n  private context: TriggerContext;\n\n  constructor(initial?: TriggerContext) {\n    this.context = {\n      path: initial?.path,\n      events: new Set(initial?.events ?? []),\n      milestones: new Set(initial?.milestones ?? []),\n      usage: { ...(initial?.usage ?? {}) },\n      elapsedMs: initial?.elapsedMs ?? 0,\n      scrollPercent: initial?.scrollPercent ?? 0,\n      metadata: { ...(initial?.metadata ?? {}) },\n    };\n  }\n\n  setPath(path: string): void {\n    this.context.path = path;\n  }\n\n  trackEvent(event: string): void {\n    const next = new Set(this.context.events ?? new Set<string>());\n    next.add(event);\n    this.context.events = next;\n  }\n\n  trackUsage(event: string, delta = 1): void {\n    const usage = { ...(this.context.usage ?? {}) };\n    usage[event] = (usage[event] ?? 0) + Math.max(1, delta);\n    this.context.usage = usage;\n  }\n\n  trackMilestone(event: string): void {\n    const next = new Set(this.context.milestones ?? new Set<string>());\n    next.add(event);\n    this.context.milestones = next;\n  }\n\n  setElapsedMs(elapsedMs: number): void {\n    this.context.elapsedMs = Math.max(0, elapsedMs);\n  }\n\n  setScrollPercent(scrollPercent: number): void {\n    const clamped = Math.max(0, Math.min(100, scrollPercent));\n    this.context.scrollPercent = clamped;\n  }\n\n  setMetadata(next: Record<string, unknown>): void {\n    this.context.metadata = { ...next };\n  }\n\n  getContext(): TriggerContext {\n    return {\n      path: this.context.path,\n      events: new Set(this.context.events ?? []),\n      milestones: new Set(this.context.milestones ?? []),\n      usage: { ...(this.context.usage ?? {}) },\n      elapsedMs: this.context.elapsedMs,\n      scrollPercent: this.context.scrollPercent,\n      metadata: { ...(this.context.metadata ?? {}) },\n    };\n  }\n\n  evaluate(trigger: FeatureTrigger | undefined): boolean {\n    return isTriggerMatch(trigger, this.context);\n  }\n\n  evaluateFeature(feature: Pick<FeatureEntry, \"trigger\">): boolean {\n    return this.evaluate(feature.trigger);\n  }\n}\n","import type {\n  AudienceMatchFn,\n  AudienceRule,\n  FeatureEntry,\n  FeatureManifest,\n  StorageAdapter,\n  UserContext,\n  FeatureDependencyState,\n  FeatureFlagBridge,\n  TriggerContext,\n} from \"./types\";\nimport { compareSemver, satisfiesRange } from \"./semver\";\nimport { isTriggerMatch } from \"./triggers\";\n\n/**\n * Default audience matching logic.\n *\n * For each specified field (plan, role, region), checks if the user's\n * value is included in the allowed list. Fields use AND logic between them,\n * OR logic within each field's array. The `custom` field is ignored by\n * the default matcher — use a custom `AudienceMatchFn` for that.\n */\nexport function matchesAudience(\n  audience: AudienceRule,\n  userContext: UserContext,\n): boolean {\n  if (audience.plan && audience.plan.length > 0) {\n    if (!userContext.plan || !audience.plan.includes(userContext.plan)) {\n      return false;\n    }\n  }\n  if (audience.role && audience.role.length > 0) {\n    if (!userContext.role || !audience.role.includes(userContext.role)) {\n      return false;\n    }\n  }\n  if (audience.region && audience.region.length > 0) {\n    if (!userContext.region || !audience.region.includes(userContext.region)) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/**\n * Check if a feature's audience allows the given user context.\n *\n * - No `audience` field → visible to all\n * - Empty `audience` ({}) → visible to all\n * - `audience` specified but no `userContext` → hidden (safe default)\n * - Otherwise, delegate to `matchFn` (or default `matchesAudience`)\n */\nfunction isAudienceMatch(\n  feature: FeatureEntry,\n  userContext?: UserContext,\n  matchFn?: AudienceMatchFn,\n): boolean {\n  // No audience restriction → show to everyone\n  if (!feature.audience) return true;\n\n  // Check if audience is empty (no fields with values)\n  const { plan, role, region, custom } = feature.audience;\n  const hasRules =\n    (plan && plan.length > 0) ||\n    (role && role.length > 0) ||\n    (region && region.length > 0) ||\n    (custom && Object.keys(custom).length > 0);\n  if (!hasRules) return true;\n\n  // Audience specified but no user context → hidden (safe default)\n  if (!userContext) return false;\n\n  // Use custom matcher if provided, otherwise default\n  if (matchFn) return matchFn(feature.audience, userContext);\n  return matchesAudience(feature.audience, userContext);\n}\n\nfunction isVersionMatch(feature: FeatureEntry, appVersion?: string): boolean {\n  const v = feature.version;\n  if (!v || typeof v === \"string\") return true; // string = display only\n  if (!appVersion) return false; // Safe default when constraints exist\n  if (!v.introduced && !v.showNewUntil && !v.deprecatedAt && !v.showIn) return true;\n\n  // Range check\n  if (v.showIn && !satisfiesRange(appVersion, v.showIn)) return false;\n\n  if (v.introduced && compareSemver(appVersion, v.introduced) < 0) return false;\n  if (v.deprecatedAt && compareSemver(appVersion, v.deprecatedAt) >= 0) return false;\n\n  // showNewUntil gates \"new\" state only\n  if (v.showNewUntil && compareSemver(appVersion, v.showNewUntil) >= 0) return false;\n\n  return true;\n}\n\nfunction isFlagMatch(\n  feature: FeatureEntry,\n  flagBridge?: FeatureFlagBridge,\n  userContext?: UserContext,\n): boolean {\n  if (!feature.flagKey) return true;\n  if (!flagBridge) return false;\n  try {\n    return flagBridge.isEnabled(feature.flagKey, userContext);\n  } catch {\n    return false;\n  }\n}\n\nfunction isProductMatch(feature: FeatureEntry, product?: string): boolean {\n  if (!feature.product || feature.product === \"*\") return true;\n  if (!product) return false;\n  return feature.product === product;\n}\n\nfunction isDependencyMatch(\n  feature: FeatureEntry,\n  dismissedIds: ReadonlySet<string>,\n  dependencyState?: FeatureDependencyState,\n): boolean {\n  const dependsOn = feature.dependsOn;\n  if (!dependsOn) return true;\n\n  const seenIds = dependencyState?.seenIds;\n  const clickedIds = dependencyState?.clickedIds;\n  const dismissedDependencyIds = dependencyState?.dismissedIds ?? dismissedIds;\n\n  if (dependsOn.seen && dependsOn.seen.length > 0) {\n    for (const id of dependsOn.seen) {\n      const seen = seenIds?.has(id) ?? false;\n      if (!seen && !dismissedDependencyIds.has(id)) return false;\n    }\n  }\n\n  if (dependsOn.clicked && dependsOn.clicked.length > 0) {\n    for (const id of dependsOn.clicked) {\n      if (!(clickedIds?.has(id) ?? false)) return false;\n    }\n  }\n\n  if (dependsOn.dismissed && dependsOn.dismissed.length > 0) {\n    for (const id of dependsOn.dismissed) {\n      if (!dismissedDependencyIds.has(id)) return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Check if a single feature should show as \"new\".\n *\n * A feature is \"new\" when ALL of these are true:\n * 1. Current time is before `showNewUntil`\n * 2. Feature was released after the watermark (or no watermark exists)\n * 3. Feature has not been individually dismissed\n * 4. If `publishAt` is set, current time must be after it (scheduled publishing)\n * 5. If `audience` is set, user must match the targeting rules\n * 6. If `flagKey` is set, the flag bridge must resolve it as enabled\n * 7. If `product` is set, it must match the current product scope\n */\nexport function isNew(\n  feature: FeatureEntry,\n  watermark: string | null,\n  dismissedIds: ReadonlySet<string>,\n  now: Date = new Date(),\n  userContext?: UserContext,\n  matchAudience?: AudienceMatchFn,\n  appVersion?: string,\n  dependencyState?: FeatureDependencyState,\n  triggerContext?: TriggerContext,\n  flagBridge?: FeatureFlagBridge,\n  product?: string,\n): boolean {\n  // Already dismissed by the user on this device\n  if (dismissedIds.has(feature.id)) return false;\n\n  // Audience targeting — check before time-based checks\n  if (!isAudienceMatch(feature, userContext, matchAudience)) return false;\n\n  // Dependency targeting — defer features until prerequisites are satisfied\n  if (!isDependencyMatch(feature, dismissedIds, dependencyState)) return false;\n\n  // Version targeting — requires appVersion when constraints exist\n  if (!isVersionMatch(feature, appVersion)) return false;\n\n  // Feature flag targeting — hide flagged entries unless enabled\n  if (!isFlagMatch(feature, flagBridge, userContext)) return false;\n\n  // Multi-product targeting — hide entries for other product scopes\n  if (!isProductMatch(feature, product)) return false;\n\n  // Contextual trigger rules — show only when trigger condition is satisfied.\n  if (!isTriggerMatch(feature.trigger, triggerContext)) return false;\n\n  const nowMs = now.getTime();\n\n  // Scheduled publishing — hidden until publishAt\n  if (feature.publishAt) {\n    const publishMs = new Date(feature.publishAt).getTime();\n    if (nowMs < publishMs) return false;\n  }\n\n  const showUntilMs = new Date(feature.showNewUntil).getTime();\n\n  // Past the display window\n  if (nowMs >= showUntilMs) return false;\n\n  // If there's a watermark, feature must have been released after it\n  if (watermark) {\n    const watermarkMs = new Date(watermark).getTime();\n    const releasedMs = new Date(feature.releasedAt).getTime();\n    if (releasedMs <= watermarkMs) return false;\n  }\n\n  return true;\n}\n\n/**\n * Get all features that are currently \"new\" for this user.\n */\nexport function getNewFeatures(\n  manifest: FeatureManifest,\n  storage: StorageAdapter,\n  now: Date = new Date(),\n  userContext?: UserContext,\n  matchAudience?: AudienceMatchFn,\n  appVersion?: string,\n  dependencyState?: FeatureDependencyState,\n  triggerContext?: TriggerContext,\n  flagBridge?: FeatureFlagBridge,\n  product?: string,\n): FeatureEntry[] {\n  const watermark = storage.getWatermark();\n  const dismissedIds = storage.getDismissedIds();\n  return manifest.filter((f) =>\n    isNew(\n      f,\n      watermark,\n      dismissedIds,\n      now,\n      userContext,\n      matchAudience,\n      appVersion,\n      dependencyState,\n      triggerContext,\n      flagBridge,\n      product,\n    ),\n  );\n}\n\n/**\n * Get the count of new features.\n */\nexport function getNewFeatureCount(\n  manifest: FeatureManifest,\n  storage: StorageAdapter,\n  now: Date = new Date(),\n  userContext?: UserContext,\n  matchAudience?: AudienceMatchFn,\n  appVersion?: string,\n  dependencyState?: FeatureDependencyState,\n  triggerContext?: TriggerContext,\n  flagBridge?: FeatureFlagBridge,\n  product?: string,\n): number {\n  return getNewFeatures(\n    manifest,\n    storage,\n    now,\n    userContext,\n    matchAudience,\n    appVersion,\n    dependencyState,\n    triggerContext,\n    flagBridge,\n    product,\n  ).length;\n}\n\n/**\n * Check if a specific sidebar key has a new feature.\n */\nexport function hasNewFeature(\n  manifest: FeatureManifest,\n  sidebarKey: string,\n  storage: StorageAdapter,\n  now: Date = new Date(),\n  userContext?: UserContext,\n  matchAudience?: AudienceMatchFn,\n  appVersion?: string,\n  dependencyState?: FeatureDependencyState,\n  triggerContext?: TriggerContext,\n  flagBridge?: FeatureFlagBridge,\n  product?: string,\n): boolean {\n  const watermark = storage.getWatermark();\n  const dismissedIds = storage.getDismissedIds();\n  return manifest.some(\n    (f) =>\n      f.sidebarKey === sidebarKey &&\n      isNew(\n        f,\n        watermark,\n        dismissedIds,\n        now,\n        userContext,\n        matchAudience,\n        appVersion,\n        dependencyState,\n        triggerContext,\n        flagBridge,\n        product,\n      ),\n  );\n}\n\n/**\n * Get all features sorted by priority (critical first) then by release date (newest first).\n */\nexport function getNewFeaturesSorted(\n  manifest: FeatureManifest,\n  storage: StorageAdapter,\n  now: Date = new Date(),\n  userContext?: UserContext,\n  matchAudience?: AudienceMatchFn,\n  appVersion?: string,\n  dependencyState?: FeatureDependencyState,\n  triggerContext?: TriggerContext,\n  flagBridge?: FeatureFlagBridge,\n  product?: string,\n): FeatureEntry[] {\n  const priorityOrder = { critical: 0, normal: 1, low: 2 };\n  return getNewFeatures(\n    manifest,\n    storage,\n    now,\n    userContext,\n    matchAudience,\n    appVersion,\n    dependencyState,\n    triggerContext,\n    flagBridge,\n    product,\n  ).sort(\n    (a, b) => {\n      const pa = priorityOrder[a.priority ?? \"normal\"];\n      const pb = priorityOrder[b.priority ?? \"normal\"];\n      if (pa !== pb) return pa - pb;\n      return (\n        new Date(b.releasedAt).getTime() - new Date(a.releasedAt).getTime()\n      );\n    },\n  );\n}\n","import type { StorageAdapter } from \"../types\";\n\n/**\n * In-memory storage adapter.\n *\n * Useful for:\n * - Testing (no side effects)\n * - Server-side rendering (no `window`/`localStorage`)\n * - Environments without persistent storage\n */\nexport class MemoryAdapter implements StorageAdapter {\n  private watermark: string | null;\n  private dismissed: Set<string>;\n\n  constructor(options: { watermark?: string | null } = {}) {\n    this.watermark = options.watermark ?? null;\n    this.dismissed = new Set();\n  }\n\n  getWatermark(): string | null {\n    return this.watermark;\n  }\n\n  getDismissedIds(): ReadonlySet<string> {\n    return this.dismissed;\n  }\n\n  dismiss(id: string): void {\n    this.dismissed.add(id);\n  }\n\n  async dismissAll(now: Date): Promise<void> {\n    this.watermark = now.toISOString();\n    this.dismissed.clear();\n  }\n}\n","import { getNewFeatures, getNewFeatureCount } from \"../core\";\nimport { MemoryAdapter } from \"../adapters/memory\";\nimport type {\n  FeatureEntry,\n  FeatureManifest,\n  UserContext,\n  AudienceMatchFn,\n  FeatureDependencyState,\n  TriggerContext,\n  FeatureFlagBridge,\n} from \"../types\";\nimport { createElement } from \"react\";\n\n/** Options shared by both server helpers */\nexport interface ServerOptions {\n  /** Current date override (defaults to `new Date()`) */\n  now?: Date;\n  /** User context for audience targeting */\n  userContext?: UserContext;\n  /** Custom audience matcher */\n  matchAudience?: AudienceMatchFn;\n  /** Current app semver string for version targeting */\n  appVersion?: string;\n  /** Dependency state for progressive disclosure */\n  dependencyState?: FeatureDependencyState;\n  /** Trigger context for contextual rules */\n  triggerContext?: TriggerContext;\n  /** Feature flag bridge for flag-gated entries */\n  flagBridge?: FeatureFlagBridge;\n  /** Product scope for multi-product manifests */\n  product?: string;\n}\n\n/**\n * Server-side helper: get new features without browser storage.\n *\n * Creates a temporary MemoryAdapter pre-seeded with the provided dismissed IDs\n * and calls the core `getNewFeatures` function. Safe to use in React Server\n * Components, `generateStaticParams`, or any server context.\n *\n * @param manifest  The feature manifest array.\n * @param dismissedIds  IDs already dismissed by this user (from your session/DB).\n * @param options  Optional targeting overrides.\n */\nexport function getNewFeaturesServer(\n  manifest: FeatureManifest,\n  dismissedIds?: string[],\n  options?: ServerOptions,\n): FeatureEntry[] {\n  const storage = new MemoryAdapter();\n  if (dismissedIds) {\n    for (const id of dismissedIds) {\n      storage.dismiss(id);\n    }\n  }\n  return getNewFeatures(\n    manifest,\n    storage,\n    options?.now,\n    options?.userContext,\n    options?.matchAudience,\n    options?.appVersion,\n    options?.dependencyState,\n    options?.triggerContext,\n    options?.flagBridge,\n    options?.product,\n  );\n}\n\n/**\n * Server-side helper: get new feature count.\n *\n * Same as `getNewFeaturesServer` but returns the count only.\n *\n * @param manifest  The feature manifest array.\n * @param dismissedIds  IDs already dismissed by this user (from your session/DB).\n * @param options  Optional targeting overrides.\n */\nexport function getNewCountServer(\n  manifest: FeatureManifest,\n  dismissedIds?: string[],\n  options?: ServerOptions,\n): number {\n  const storage = new MemoryAdapter();\n  if (dismissedIds) {\n    for (const id of dismissedIds) {\n      storage.dismiss(id);\n    }\n  }\n  return getNewFeatureCount(\n    manifest,\n    storage,\n    options?.now,\n    options?.userContext,\n    options?.matchAudience,\n    options?.appVersion,\n    options?.dependencyState,\n    options?.triggerContext,\n    options?.flagBridge,\n    options?.product,\n  );\n}\n\n/** Props for FeatureDropScript */\nexport interface FeatureDropScriptProps {\n  manifest: FeatureEntry[];\n  dismissedIds?: string[];\n}\n\n/**\n * Injects manifest + dismissed IDs into the page as a JSON script tag.\n *\n * Place this in your root layout (server component) so the client-side\n * `FeatureDropProvider` can read the data on first render without a\n * flash-of-no-content (0 new features → real count).\n *\n * Client-side usage:\n * ```ts\n * const el = document.getElementById(\"__FEATUREDROP_DATA__\");\n * const { manifest, dismissedIds } = JSON.parse(el?.textContent ?? \"{}\");\n * ```\n */\nexport function FeatureDropScript({ manifest, dismissedIds }: FeatureDropScriptProps) {\n  const data = JSON.stringify({ manifest, dismissedIds: dismissedIds ?? [] });\n  return createElement(\"script\", {\n    id: \"__FEATUREDROP_DATA__\",\n    type: \"application/json\",\n    dangerouslySetInnerHTML: { __html: data },\n  });\n}\n"]}

package/dist/next.d.cts

@@ -0,0 +1,243 @@
+import * as react from 'react';
+
+/** Entry type label — determines default icon/color in UI */
+type FeatureType = "feature" | "improvement" | "fix" | "breaking";
+/** Priority level for announcements */
+type FeaturePriority = "critical" | "normal" | "low";
+/** Call-to-action for a feature entry */
+interface FeatureCTA {
+    /** Button/link label */
+    label: string;
+    /** URL to navigate to */
+    url: string;
+}
+/** Variant-level overrides for A/B announcement testing */
+interface FeatureVariant {
+    /** Optional variant-specific label override */
+    label?: string;
+    /** Optional variant-specific description override */
+    description?: string;
+    /** Optional variant-specific image override */
+    image?: string;
+    /** Optional variant-specific CTA override */
+    cta?: FeatureCTA;
+    /** Optional variant-specific metadata overrides */
+    meta?: Record<string, unknown>;
+}
+/** Audience targeting rule — determines which user segments see a feature */
+interface AudienceRule {
+    /** Plans that should see this feature (e.g. ["pro", "enterprise"]) */
+    plan?: string[];
+    /** Roles that should see this feature (e.g. ["admin", "editor"]) */
+    role?: string[];
+    /** Regions that should see this feature (e.g. ["us", "eu"]) */
+    region?: string[];
+    /** Arbitrary key-value pairs for custom matching logic */
+    custom?: Record<string, unknown>;
+}
+/** User context for audience targeting */
+interface UserContext {
+    /** Current user's plan (e.g. "pro", "free") */
+    plan?: string;
+    /** Current user's role (e.g. "admin", "viewer") */
+    role?: string;
+    /** Current user's region (e.g. "us", "eu") */
+    region?: string;
+    /** Arbitrary traits for custom matching logic */
+    traits?: Record<string, unknown>;
+}
+/** Custom audience matcher function */
+type AudienceMatchFn = (audience: AudienceRule, userContext: UserContext) => boolean;
+/** Feature flag resolver interface for gating announcement visibility */
+interface FeatureFlagBridge {
+    isEnabled: (flagKey: string, userContext?: UserContext) => boolean;
+}
+/** Dependency gates for progressive feature discovery */
+interface FeatureDependencies {
+    /** Features the user must have seen before this one can surface */
+    seen?: string[];
+    /** Features the user must have clicked before this one can surface */
+    clicked?: string[];
+    /** Features the user must have dismissed before this one can surface */
+    dismissed?: string[];
+}
+/** Runtime interaction state used to resolve dependency chains */
+interface FeatureDependencyState {
+    /** IDs marked as seen */
+    seenIds?: ReadonlySet<string>;
+    /** IDs marked as clicked */
+    clickedIds?: ReadonlySet<string>;
+    /** IDs marked as dismissed */
+    dismissedIds?: ReadonlySet<string>;
+}
+/** Runtime context used by trigger evaluation */
+interface TriggerContext {
+    /** Current app route/path */
+    path?: string;
+    /** Named events observed in this session */
+    events?: ReadonlySet<string>;
+    /** Named milestone flags reached in this session */
+    milestones?: ReadonlySet<string>;
+    /** Usage counters keyed by event/pattern name */
+    usage?: Record<string, number>;
+    /** Session elapsed time in milliseconds */
+    elapsedMs?: number;
+    /** Scroll completion percentage (0-100) */
+    scrollPercent?: number;
+    /** Optional additional trigger context */
+    metadata?: Record<string, unknown>;
+}
+type FeatureTrigger = {
+    type: "page";
+    match: string | RegExp;
+} | {
+    type: "usage";
+    event: string;
+    minActions?: number;
+} | {
+    type: "time";
+    minSeconds: number;
+} | {
+    type: "milestone";
+    event: string;
+} | {
+    type: "frustration";
+    pattern: string;
+    threshold?: number;
+} | {
+    type: "scroll";
+    minPercent?: number;
+} | {
+    type: "custom";
+    evaluate: (context: TriggerContext) => boolean;
+};
+/** A single feature entry in the manifest */
+interface FeatureEntry {
+    /** Unique identifier for the feature */
+    id: string;
+    /** Human-readable label (e.g. "Decision Journal") */
+    label: string;
+    /** Optional longer description (supports markdown in UI components) */
+    description?: string;
+    /**
+     * Semantic version targeting.
+     * If provided as an object, requires `appVersion` to be supplied to the provider/helpers.
+     * - introduced: earliest app version that includes this feature
+     * - showNewUntil: stop showing "new" once appVersion reaches this
+     * - deprecatedAt: hide feature for app versions at or above this (optional safety)
+     * - showIn: range string, e.g. ">=2.5.0 <3.0.0"
+     */
+    version?: string | {
+        introduced?: string;
+        showNewUntil?: string;
+        deprecatedAt?: string;
+        showIn?: string;
+    };
+    /** ISO date when this feature was released */
+    releasedAt: string;
+    /** ISO date after which the "new" badge should stop showing */
+    showNewUntil: string;
+    /** Optional key to match navigation items (e.g. "/journal", "settings") */
+    sidebarKey?: string;
+    /** Optional grouping category (e.g. "ai", "billing", "core") */
+    category?: string;
+    /** Optional product scope (`"*"`, `"askverdict"`, etc.) for multi-product manifests */
+    product?: string;
+    /** Optional URL to link to (e.g. docs page, changelog entry) */
+    url?: string;
+    /** Optional feature flag key; requires a flag bridge to evaluate */
+    flagKey?: string;
+    /** Entry type — determines default icon/color in UI components */
+    type?: FeatureType;
+    /** Priority level — critical entries get special treatment in UI */
+    priority?: FeaturePriority;
+    /** Optional image/screenshot URL */
+    image?: string;
+    /** Optional call-to-action button */
+    cta?: FeatureCTA;
+    /** ISO date — entry is hidden until this date (scheduled publishing) */
+    publishAt?: string;
+    /** Optional arbitrary metadata */
+    meta?: Record<string, unknown>;
+    /** A/B variants keyed by variant name (e.g. control, treatment_a) */
+    variants?: Record<string, FeatureVariant>;
+    /** Percentage split per variant (same order as variants object keys) */
+    variantSplit?: number[];
+    /** Audience targeting — if set, only matching users see this feature */
+    audience?: AudienceRule;
+    /** Dependency requirements (progressive disclosure sequencing) */
+    dependsOn?: FeatureDependencies;
+    /** Contextual trigger rule */
+    trigger?: FeatureTrigger;
+}
+/** The full feature manifest — an array of feature entries */
+type FeatureManifest = readonly FeatureEntry[];
+
+/** Options shared by both server helpers */
+interface ServerOptions {
+    /** Current date override (defaults to `new Date()`) */
+    now?: Date;
+    /** User context for audience targeting */
+    userContext?: UserContext;
+    /** Custom audience matcher */
+    matchAudience?: AudienceMatchFn;
+    /** Current app semver string for version targeting */
+    appVersion?: string;
+    /** Dependency state for progressive disclosure */
+    dependencyState?: FeatureDependencyState;
+    /** Trigger context for contextual rules */
+    triggerContext?: TriggerContext;
+    /** Feature flag bridge for flag-gated entries */
+    flagBridge?: FeatureFlagBridge;
+    /** Product scope for multi-product manifests */
+    product?: string;
+}
+/**
+ * Server-side helper: get new features without browser storage.
+ *
+ * Creates a temporary MemoryAdapter pre-seeded with the provided dismissed IDs
+ * and calls the core `getNewFeatures` function. Safe to use in React Server
+ * Components, `generateStaticParams`, or any server context.
+ *
+ * @param manifest  The feature manifest array.
+ * @param dismissedIds  IDs already dismissed by this user (from your session/DB).
+ * @param options  Optional targeting overrides.
+ */
+declare function getNewFeaturesServer(manifest: FeatureManifest, dismissedIds?: string[], options?: ServerOptions): FeatureEntry[];
+/**
+ * Server-side helper: get new feature count.
+ *
+ * Same as `getNewFeaturesServer` but returns the count only.
+ *
+ * @param manifest  The feature manifest array.
+ * @param dismissedIds  IDs already dismissed by this user (from your session/DB).
+ * @param options  Optional targeting overrides.
+ */
+declare function getNewCountServer(manifest: FeatureManifest, dismissedIds?: string[], options?: ServerOptions): number;
+/** Props for FeatureDropScript */
+interface FeatureDropScriptProps {
+    manifest: FeatureEntry[];
+    dismissedIds?: string[];
+}
+/**
+ * Injects manifest + dismissed IDs into the page as a JSON script tag.
+ *
+ * Place this in your root layout (server component) so the client-side
+ * `FeatureDropProvider` can read the data on first render without a
+ * flash-of-no-content (0 new features → real count).
+ *
+ * Client-side usage:
+ * ```ts
+ * const el = document.getElementById("__FEATUREDROP_DATA__");
+ * const { manifest, dismissedIds } = JSON.parse(el?.textContent ?? "{}");
+ * ```
+ */
+declare function FeatureDropScript({ manifest, dismissedIds }: FeatureDropScriptProps): react.DetailedReactHTMLElement<{
+    id: string;
+    type: string;
+    dangerouslySetInnerHTML: {
+        __html: string;
+    };
+}, HTMLElement>;
+
+export { FeatureDropScript, type FeatureDropScriptProps, type ServerOptions, getNewCountServer, getNewFeaturesServer };