featuredrop 2.7.1 → 3.0.1

package/dist/remix.cjs

@@ -0,0 +1,331 @@
+'use strict';
+
+// 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();
+  }
+};
+
+// src/remix/index.ts
+function buildAdapter(dismissedIds = []) {
+  const adapter = new MemoryAdapter();
+  for (const id of dismissedIds) {
+    adapter.dismiss(id);
+  }
+  return adapter;
+}
+function getNewFeaturesServer(manifest, dismissedIds = [], options = {}) {
+  const adapter = buildAdapter(dismissedIds);
+  return getNewFeatures(
+    manifest,
+    adapter,
+    options.now,
+    options.userContext,
+    options.matchAudience,
+    options.appVersion,
+    options.dependencyState,
+    options.triggerContext,
+    options.flagBridge,
+    options.product
+  );
+}
+function getNewCountServer(manifest, dismissedIds = [], options = {}) {
+  const adapter = buildAdapter(dismissedIds);
+  return getNewFeatureCount(
+    manifest,
+    adapter,
+    options.now,
+    options.userContext,
+    options.matchAudience,
+    options.appVersion,
+    options.dependencyState,
+    options.triggerContext,
+    options.flagBridge,
+    options.product
+  );
+}
+function createFeatureDropHeaders(manifest, dismissedIds = [], options = {}) {
+  const count = getNewCountServer(manifest, dismissedIds, options);
+  const headers = new Headers();
+  headers.set("X-FD-New-Count", String(count));
+  return headers;
+}
+
+exports.createFeatureDropHeaders = createFeatureDropHeaders;
+exports.getNewCountServer = getNewCountServer;
+exports.getNewFeaturesServer = getNewFeaturesServer;
+//# sourceMappingURL=remix.cjs.map
+//# sourceMappingURL=remix.cjs.map

package/dist/remix.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/semver.ts","../src/triggers.ts","../src/core.ts","../src/adapters/memory.ts","../src/remix/index.ts"],"names":[],"mappings":"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","file":"remix.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","/**\n * featuredrop — Remix integration\n *\n * Server-side loader helpers for computing new feature state from session data.\n *\n * Typical usage in a Remix loader:\n *\n * ```ts\n * import { getNewFeaturesServer, createFeatureDropHeaders } from \"featuredrop/remix\";\n * import { manifest } from \"~/features/manifest\";\n *\n * export async function loader({ request }: LoaderFunctionArgs) {\n *   const session = await getSession(request.headers.get(\"Cookie\"));\n *   const dismissedIds: string[] = session.get(\"fd_dismissed\") ?? [];\n *\n *   const newFeatures = getNewFeaturesServer(manifest, dismissedIds);\n *   const headers = createFeatureDropHeaders(manifest, dismissedIds);\n *\n *   return json({ newFeatures }, { headers });\n * }\n * ```\n *\n * All helpers are pure functions — they create a transient MemoryAdapter\n * internally so there are no shared global state concerns between requests.\n */\n\nimport { 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\";\n\n// Re-export types for downstream convenience\nexport type { FeatureEntry, FeatureManifest };\n\n/**\n * Options bag for server-side newness checks.\n *\n * Mirrors the optional parameters of the core `getNewFeatures` function.\n * All fields are optional — omit what you don't use.\n */\nexport interface IsNewOptions {\n  /** Override the current timestamp (defaults to `new Date()`). */\n  now?: Date;\n  /**\n   * User context for audience targeting rules.\n   * Required when any manifest entry has an `audience` field.\n   */\n  userContext?: UserContext;\n  /**\n   * Custom audience matching function.\n   * Replaces the built-in plan/role/region matcher when provided.\n   */\n  matchAudience?: AudienceMatchFn;\n  /**\n   * Current app version string (e.g. `\"2.5.0\"`).\n   * Required when any manifest entry uses semver `version` constraints.\n   */\n  appVersion?: string;\n  /** Runtime dependency state for progressive feature discovery. */\n  dependencyState?: FeatureDependencyState;\n  /**\n   * Trigger context for contextual display rules.\n   * On the server you typically omit this (triggers are client-side).\n   */\n  triggerContext?: TriggerContext;\n  /** Feature flag bridge for evaluating `flagKey` entries. */\n  flagBridge?: FeatureFlagBridge;\n  /**\n   * Product scope filter.\n   * Use when your manifest covers multiple products and you want to\n   * surface only entries for the current product.\n   */\n  product?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Internal helper — builds a populated MemoryAdapter from an array of IDs\n// ---------------------------------------------------------------------------\n\nfunction buildAdapter(dismissedIds: readonly string[] = []): MemoryAdapter {\n  const adapter = new MemoryAdapter();\n  for (const id of dismissedIds) {\n    adapter.dismiss(id);\n  }\n  return adapter;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Return all features that are currently \"new\" for the given user.\n *\n * Creates a short-lived `MemoryAdapter` seeded with the provided\n * `dismissedIds`, then delegates to `getNewFeatures` from core.\n *\n * @param manifest   The full feature manifest.\n * @param dismissedIds  IDs the user has already dismissed (from session/DB).\n * @param options    Optional targeting overrides.\n * @returns          Array of `FeatureEntry` objects considered new.\n *\n * @example\n * ```ts\n * // In a Remix loader\n * const dismissed: string[] = session.get(\"fd_dismissed\") ?? [];\n * const newFeatures = getNewFeaturesServer(manifest, dismissed, {\n *   userContext: { plan: \"pro\" },\n * });\n * return json({ newFeatures });\n * ```\n */\nexport function getNewFeaturesServer(\n  manifest: FeatureManifest,\n  dismissedIds: readonly string[] = [],\n  options: IsNewOptions = {},\n): FeatureEntry[] {\n  const adapter = buildAdapter(dismissedIds);\n  return getNewFeatures(\n    manifest,\n    adapter,\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 * Return the count of features that are currently \"new\" for the given user.\n *\n * Lightweight alternative to `getNewFeaturesServer` when you only need the\n * number — avoids allocating the full result array on the caller's side.\n *\n * @param manifest     The full feature manifest.\n * @param dismissedIds IDs the user has already dismissed.\n * @param options      Optional targeting overrides.\n * @returns            Integer count of new features.\n *\n * @example\n * ```ts\n * const count = getNewCountServer(manifest, session.get(\"fd_dismissed\") ?? []);\n * // Pass count to the client as a header or in the JSON payload\n * ```\n */\nexport function getNewCountServer(\n  manifest: FeatureManifest,\n  dismissedIds: readonly string[] = [],\n  options: IsNewOptions = {},\n): number {\n  const adapter = buildAdapter(dismissedIds);\n  return getNewFeatureCount(\n    manifest,\n    adapter,\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 * Build a `Headers` object carrying the new-feature count.\n *\n * Useful when you want the client to know about the badge count without\n * serialising the entire feature list into the JSON response body.\n *\n * The header `X-FD-New-Count` is set to the string representation of the\n * count. Clients can read it via `useFetcher` or a custom hook.\n *\n * @param manifest     The full feature manifest.\n * @param dismissedIds IDs the user has already dismissed.\n * @param options      Optional targeting overrides.\n * @returns            A `Headers` instance with `X-FD-New-Count` set.\n *\n * @example\n * ```ts\n * export async function loader({ request }: LoaderFunctionArgs) {\n *   const dismissed: string[] = session.get(\"fd_dismissed\") ?? [];\n *   const headers = createFeatureDropHeaders(manifest, dismissed);\n *   return json({ ok: true }, { headers });\n * }\n * ```\n */\nexport function createFeatureDropHeaders(\n  manifest: FeatureManifest,\n  dismissedIds: readonly string[] = [],\n  options: IsNewOptions = {},\n): Headers {\n  const count = getNewCountServer(manifest, dismissedIds, options);\n  const headers = new Headers();\n  headers.set(\"X-FD-New-Count\", String(count));\n  return headers;\n}\n"]}