featuredrop 1.2.0 → 1.3.0

package/dist/ci.cjs

@@ -0,0 +1,328 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/dependencies.ts
+function getDirectDependencies(feature) {
+  const dependsOn = feature.dependsOn;
+  if (!dependsOn) return [];
+  const seen = dependsOn.seen ?? [];
+  const clicked = dependsOn.clicked ?? [];
+  const dismissed = dependsOn.dismissed ?? [];
+  const unique = /* @__PURE__ */ new Set();
+  for (const id of [...seen, ...clicked, ...dismissed]) {
+    if (id) unique.add(id);
+  }
+  return Array.from(unique);
+}
+function hasDependencyCycle(manifest) {
+  const ids = new Set(manifest.map((feature) => feature.id));
+  const outgoing = /* @__PURE__ */ new Map();
+  const indegree = /* @__PURE__ */ new Map();
+  for (const feature of manifest) {
+    outgoing.set(feature.id, /* @__PURE__ */ new Set());
+    indegree.set(feature.id, 0);
+  }
+  for (const feature of manifest) {
+    for (const dependencyId of getDirectDependencies(feature)) {
+      if (!ids.has(dependencyId)) continue;
+      const edges = outgoing.get(dependencyId);
+      if (!edges || edges.has(feature.id)) continue;
+      edges.add(feature.id);
+      indegree.set(feature.id, (indegree.get(feature.id) ?? 0) + 1);
+    }
+  }
+  const queue = [];
+  for (const feature of manifest) {
+    if ((indegree.get(feature.id) ?? 0) === 0) queue.push(feature.id);
+  }
+  let visited = 0;
+  while (queue.length > 0) {
+    const id = queue.shift();
+    if (!id) continue;
+    visited += 1;
+    const edges = outgoing.get(id);
+    if (!edges) continue;
+    for (const nextId of edges) {
+      const nextDegree = (indegree.get(nextId) ?? 0) - 1;
+      indegree.set(nextId, nextDegree);
+      if (nextDegree === 0) queue.push(nextId);
+    }
+  }
+  return visited !== manifest.length;
+}
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isValidDate(value) {
+  return Number.isFinite(new Date(value).getTime());
+}
+var nonEmptyString = zod.z.string().trim().min(1, "must be a non-empty string");
+var isoDateString = nonEmptyString.refine(isValidDate, {
+  message: "must be a valid date",
+  params: { featuredropCode: "invalid_date" }
+});
+var dependsOnSchema = zod.z.object({
+  seen: zod.z.array(zod.z.string()).optional(),
+  clicked: zod.z.array(zod.z.string()).optional(),
+  dismissed: zod.z.array(zod.z.string()).optional()
+}).optional();
+var ctaSchema = zod.z.object({
+  label: nonEmptyString,
+  url: nonEmptyString
+}).optional();
+var featureEntrySchema = zod.z.object({
+  id: nonEmptyString,
+  label: nonEmptyString,
+  releasedAt: isoDateString,
+  showNewUntil: isoDateString,
+  description: zod.z.string().optional(),
+  flagKey: zod.z.string().optional(),
+  product: zod.z.string().optional(),
+  url: zod.z.string().optional(),
+  image: zod.z.string().optional(),
+  type: zod.z.enum(["feature", "improvement", "fix", "breaking"]).optional(),
+  priority: zod.z.enum(["critical", "normal", "low"]).optional(),
+  cta: ctaSchema,
+  meta: zod.z.record(zod.z.unknown()).optional(),
+  dependsOn: dependsOnSchema
+}).passthrough();
+zod.z.array(featureEntrySchema);
+function toIssuePath(path) {
+  if (path.length === 0) return "$";
+  let output = "";
+  for (const part of path) {
+    if (typeof part === "number") output += `[${part}]`;
+    else output += output ? `.${part}` : part;
+  }
+  return output;
+}
+function mapZodIssue(issue) {
+  const codeParam = issue.params?.featuredropCode;
+  if (codeParam === "invalid_date") {
+    return {
+      path: toIssuePath(issue.path),
+      message: issue.message,
+      code: "invalid_date"
+    };
+  }
+  if (issue.code === "invalid_type") {
+    return {
+      path: toIssuePath(issue.path),
+      message: issue.message,
+      code: issue.received === "undefined" ? "missing_required" : "invalid_type"
+    };
+  }
+  return {
+    path: toIssuePath(issue.path),
+    message: issue.message,
+    code: "invalid_value"
+  };
+}
+var UNSAFE_META_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+function isSafeUrl(value) {
+  const normalized = value.trim();
+  if (!normalized) return false;
+  if (/^(\/|\.\/|\.\.\/|\?|#)/.test(normalized)) return true;
+  if (/^https?:\/\//i.test(normalized)) return true;
+  return false;
+}
+function findUnsafeMetaPath(value, path = "meta") {
+  if (Array.isArray(value)) {
+    for (let index = 0; index < value.length; index++) {
+      const nested = findUnsafeMetaPath(value[index], `${path}[${index}]`);
+      if (nested) return nested;
+    }
+    return null;
+  }
+  if (!isRecord(value)) return null;
+  for (const [key, nestedValue] of Object.entries(value)) {
+    if (UNSAFE_META_KEYS.has(key)) {
+      return `${path}.${key}`;
+    }
+    const nested = findUnsafeMetaPath(nestedValue, `${path}.${key}`);
+    if (nested) return nested;
+  }
+  return null;
+}
+function validateFeatureEntry(raw, index) {
+  if (!isRecord(raw)) {
+    return {
+      issues: [
+        {
+          path: `[${index}]`,
+          message: "Feature entry must be an object",
+          code: "invalid_type"
+        }
+      ]
+    };
+  }
+  const parsed = featureEntrySchema.safeParse(raw);
+  if (!parsed.success) {
+    return {
+      issues: parsed.error.issues.map((issue) => ({
+        ...mapZodIssue(issue),
+        path: `[${index}]${issue.path.length > 0 ? `.${toIssuePath(issue.path)}` : ""}`
+      }))
+    };
+  }
+  return {
+    issues: [],
+    entry: parsed.data
+  };
+}
+function validateManifest(data) {
+  const errors = [];
+  if (!Array.isArray(data)) {
+    return {
+      valid: false,
+      errors: [
+        {
+          path: "$",
+          message: "Manifest must be an array",
+          code: "invalid_type"
+        }
+      ]
+    };
+  }
+  const entries = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  data.forEach((item, index) => {
+    const result = validateFeatureEntry(item, index);
+    errors.push(...result.issues);
+    if (!result.entry) return;
+    if (seenIds.has(result.entry.id)) {
+      errors.push({
+        path: `[${index}].id`,
+        message: `Duplicate feature id "${result.entry.id}"`,
+        code: "duplicate_id"
+      });
+      return;
+    }
+    seenIds.add(result.entry.id);
+    entries.push(result.entry);
+  });
+  if (entries.length > 0 && hasDependencyCycle(entries)) {
+    errors.push({
+      path: "$",
+      message: "Circular dependsOn relationship detected",
+      code: "circular_dependency"
+    });
+  }
+  for (let index = 0; index < entries.length; index++) {
+    const entry = entries[index];
+    if (new Date(entry.showNewUntil).getTime() <= new Date(entry.releasedAt).getTime()) {
+      errors.push({
+        path: `[${index}].showNewUntil`,
+        message: "showNewUntil must be after releasedAt",
+        code: "invalid_value"
+      });
+    }
+    if (entry.url && !isSafeUrl(entry.url)) {
+      errors.push({
+        path: `[${index}].url`,
+        message: "url must be http, https, or relative",
+        code: "invalid_value"
+      });
+    }
+    if (entry.image && !isSafeUrl(entry.image)) {
+      errors.push({
+        path: `[${index}].image`,
+        message: "image must be http, https, or relative",
+        code: "invalid_value"
+      });
+    }
+    if (entry.cta?.url && !isSafeUrl(entry.cta.url)) {
+      errors.push({
+        path: `[${index}].cta.url`,
+        message: "cta.url must be http, https, or relative",
+        code: "invalid_value"
+      });
+    }
+    const unsafeMetaPath = findUnsafeMetaPath(entry.meta);
+    if (unsafeMetaPath) {
+      errors.push({
+        path: `[${index}].${unsafeMetaPath}`,
+        message: `meta contains unsafe key "${unsafeMetaPath.split(".").pop()}"`,
+        code: "invalid_value"
+      });
+    }
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+
+// src/ci.ts
+function isRecord2(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function collectChangedFields(beforeValue, afterValue, path, output) {
+  if (beforeValue === afterValue) return;
+  if (Array.isArray(beforeValue) && Array.isArray(afterValue)) {
+    if (beforeValue.length !== afterValue.length) {
+      output.push(path);
+      return;
+    }
+    for (let i = 0; i < beforeValue.length; i += 1) {
+      collectChangedFields(beforeValue[i], afterValue[i], `${path}[${i}]`, output);
+    }
+    return;
+  }
+  if (isRecord2(beforeValue) && isRecord2(afterValue)) {
+    const keys = /* @__PURE__ */ new Set([...Object.keys(beforeValue), ...Object.keys(afterValue)]);
+    keys.forEach((key) => {
+      const nextPath = path ? `${path}.${key}` : key;
+      collectChangedFields(beforeValue[key], afterValue[key], nextPath, output);
+    });
+    return;
+  }
+  output.push(path);
+}
+function diffManifest(before, after) {
+  const beforeById = new Map(before.map((feature) => [feature.id, feature]));
+  const afterById = new Map(after.map((feature) => [feature.id, feature]));
+  const added = after.filter((feature) => !beforeById.has(feature.id));
+  const removed = before.filter((feature) => !afterById.has(feature.id));
+  const changed = after.filter((feature) => beforeById.has(feature.id)).map((feature) => {
+    const previous = beforeById.get(feature.id);
+    if (!previous) return null;
+    const changedFields = [];
+    collectChangedFields(previous, feature, "", changedFields);
+    if (changedFields.length === 0) return null;
+    return {
+      id: feature.id,
+      before: previous,
+      after: feature,
+      changedFields
+    };
+  }).filter((item) => item !== null);
+  return { added, removed, changed };
+}
+function generateChangelogDiff(diff, options = {}) {
+  const parts = [];
+  if (diff.added.length > 0) {
+    parts.push(`Added: ${diff.added.map((feature) => feature.label).join(", ")}`);
+  }
+  if (diff.changed.length > 0) {
+    const changedText = diff.changed.map((item) => {
+      if (!options.includeFieldChanges) return item.after.label;
+      return `${item.after.label} [${item.changedFields.join(", ")}]`;
+    });
+    parts.push(`Changed: ${changedText.join(", ")}`);
+  }
+  if (diff.removed.length > 0) {
+    parts.push(`Removed: ${diff.removed.map((feature) => feature.label).join(", ")}`);
+  }
+  return parts.length > 0 ? parts.join(". ") : "No manifest changes.";
+}
+function validateManifestForCI(manifest) {
+  return validateManifest(manifest);
+}
+
+exports.diffManifest = diffManifest;
+exports.generateChangelogDiff = generateChangelogDiff;
+exports.validateManifestForCI = validateManifestForCI;
+//# sourceMappingURL=ci.cjs.map
+//# sourceMappingURL=ci.cjs.map

package/dist/ci.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dependencies.ts","../src/schema.ts","../src/ci.ts"],"names":["z","isRecord"],"mappings":"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","file":"ci.cjs","sourcesContent":["import type { FeatureEntry, FeatureManifest } from \"./types\";\n\nfunction getDirectDependencies(feature: FeatureEntry): string[] {\n  const dependsOn = feature.dependsOn;\n  if (!dependsOn) return [];\n  const seen = dependsOn.seen ?? [];\n  const clicked = dependsOn.clicked ?? [];\n  const dismissed = dependsOn.dismissed ?? [];\n  const unique = new Set<string>();\n  for (const id of [...seen, ...clicked, ...dismissed]) {\n    if (id) unique.add(id);\n  }\n  return Array.from(unique);\n}\n\nexport function resolveDependencyOrder(manifest: FeatureManifest): string[] {\n  const ids = new Set(manifest.map((feature) => feature.id));\n  const outgoing = new Map<string, Set<string>>();\n  const indegree = new Map<string, number>();\n\n  for (const feature of manifest) {\n    outgoing.set(feature.id, new Set());\n    indegree.set(feature.id, 0);\n  }\n\n  for (const feature of manifest) {\n    for (const dependencyId of getDirectDependencies(feature)) {\n      if (!ids.has(dependencyId)) continue;\n      const edges = outgoing.get(dependencyId);\n      if (!edges || edges.has(feature.id)) continue;\n      edges.add(feature.id);\n      indegree.set(feature.id, (indegree.get(feature.id) ?? 0) + 1);\n    }\n  }\n\n  const queue: string[] = [];\n  for (const feature of manifest) {\n    if ((indegree.get(feature.id) ?? 0) === 0) queue.push(feature.id);\n  }\n\n  const ordered: string[] = [];\n  while (queue.length > 0) {\n    const id = queue.shift();\n    if (!id) continue;\n    ordered.push(id);\n    const edges = outgoing.get(id);\n    if (!edges) continue;\n    for (const nextId of edges) {\n      const nextDegree = (indegree.get(nextId) ?? 0) - 1;\n      indegree.set(nextId, nextDegree);\n      if (nextDegree === 0) queue.push(nextId);\n    }\n  }\n\n  // On cycles, append remaining IDs in original order to keep behavior stable.\n  if (ordered.length < manifest.length) {\n    const included = new Set(ordered);\n    for (const feature of manifest) {\n      if (included.has(feature.id)) continue;\n      ordered.push(feature.id);\n    }\n  }\n\n  return ordered;\n}\n\nexport function hasDependencyCycle(manifest: FeatureManifest): boolean {\n  const ids = new Set(manifest.map((feature) => feature.id));\n  const outgoing = new Map<string, Set<string>>();\n  const indegree = new Map<string, number>();\n\n  for (const feature of manifest) {\n    outgoing.set(feature.id, new Set());\n    indegree.set(feature.id, 0);\n  }\n\n  for (const feature of manifest) {\n    for (const dependencyId of getDirectDependencies(feature)) {\n      if (!ids.has(dependencyId)) continue;\n      const edges = outgoing.get(dependencyId);\n      if (!edges || edges.has(feature.id)) continue;\n      edges.add(feature.id);\n      indegree.set(feature.id, (indegree.get(feature.id) ?? 0) + 1);\n    }\n  }\n\n  const queue: string[] = [];\n  for (const feature of manifest) {\n    if ((indegree.get(feature.id) ?? 0) === 0) queue.push(feature.id);\n  }\n\n  let visited = 0;\n  while (queue.length > 0) {\n    const id = queue.shift();\n    if (!id) continue;\n    visited += 1;\n    const edges = outgoing.get(id);\n    if (!edges) continue;\n    for (const nextId of edges) {\n      const nextDegree = (indegree.get(nextId) ?? 0) - 1;\n      indegree.set(nextId, nextDegree);\n      if (nextDegree === 0) queue.push(nextId);\n    }\n  }\n\n  return visited !== manifest.length;\n}\n\nexport function sortFeaturesByDependencies(features: FeatureEntry[]): FeatureEntry[] {\n  if (features.length <= 1) return [...features];\n  const order = resolveDependencyOrder(features);\n  const rank = new Map(order.map((id, index) => [id, index]));\n  return [...features].sort((a, b) => {\n    const ra = rank.get(a.id);\n    const rb = rank.get(b.id);\n    if (ra === undefined || rb === undefined) return 0;\n    return ra - rb;\n  });\n}\n","import { hasDependencyCycle } from \"./dependencies\";\nimport type { FeatureEntry, FeatureManifest } from \"./types\";\nimport { z } from \"zod\";\n\nexport interface ValidationIssue {\n  path: string;\n  message: string;\n  code:\n    | \"invalid_type\"\n    | \"missing_required\"\n    | \"invalid_value\"\n    | \"invalid_date\"\n    | \"duplicate_id\"\n    | \"circular_dependency\";\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: ValidationIssue[];\n}\n\nexport const featureEntryJsonSchema = {\n  type: \"object\",\n  required: [\"id\", \"label\", \"releasedAt\", \"showNewUntil\"],\n  properties: {\n    id: { type: \"string\" },\n    label: { type: \"string\" },\n    description: { type: \"string\" },\n    releasedAt: { type: \"string\", format: \"date-time\" },\n    showNewUntil: { type: \"string\", format: \"date-time\" },\n    flagKey: { type: \"string\" },\n    product: { type: \"string\" },\n    url: { type: \"string\" },\n    image: { type: \"string\" },\n    type: { enum: [\"feature\", \"improvement\", \"fix\", \"breaking\"] },\n    priority: { enum: [\"critical\", \"normal\", \"low\"] },\n    cta: {\n      type: \"object\",\n      properties: {\n        label: { type: \"string\" },\n        url: { type: \"string\" },\n      },\n    },\n    meta: { type: \"object\" },\n  },\n} as const;\n\nexport const featureManifestJsonSchema = {\n  type: \"array\",\n  items: featureEntryJsonSchema,\n} as const;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction isValidDate(value: string): boolean {\n  return Number.isFinite(new Date(value).getTime());\n}\n\nconst nonEmptyString = z.string().trim().min(1, \"must be a non-empty string\");\n\nconst isoDateString = nonEmptyString.refine(isValidDate, {\n  message: \"must be a valid date\",\n  params: { featuredropCode: \"invalid_date\" },\n});\n\nconst dependsOnSchema = z\n  .object({\n    seen: z.array(z.string()).optional(),\n    clicked: z.array(z.string()).optional(),\n    dismissed: z.array(z.string()).optional(),\n  })\n  .optional();\n\nconst ctaSchema = z\n  .object({\n    label: nonEmptyString,\n    url: nonEmptyString,\n  })\n  .optional();\n\nexport const featureEntrySchema = z\n  .object({\n    id: nonEmptyString,\n    label: nonEmptyString,\n    releasedAt: isoDateString,\n    showNewUntil: isoDateString,\n    description: z.string().optional(),\n    flagKey: z.string().optional(),\n    product: z.string().optional(),\n    url: z.string().optional(),\n    image: z.string().optional(),\n    type: z.enum([\"feature\", \"improvement\", \"fix\", \"breaking\"]).optional(),\n    priority: z.enum([\"critical\", \"normal\", \"low\"]).optional(),\n    cta: ctaSchema,\n    meta: z.record(z.unknown()).optional(),\n    dependsOn: dependsOnSchema,\n  })\n  .passthrough();\n\nexport const featureManifestSchema = z.array(featureEntrySchema);\n\nfunction toIssuePath(path: Array<string | number>): string {\n  if (path.length === 0) return \"$\";\n  let output = \"\";\n  for (const part of path) {\n    if (typeof part === \"number\") output += `[${part}]`;\n    else output += output ? `.${part}` : part;\n  }\n  return output;\n}\n\nfunction mapZodIssue(issue: z.ZodIssue): ValidationIssue {\n  const codeParam = (issue as { params?: Record<string, unknown> }).params?.featuredropCode;\n  if (codeParam === \"invalid_date\") {\n    return {\n      path: toIssuePath(issue.path),\n      message: issue.message,\n      code: \"invalid_date\",\n    };\n  }\n  if (issue.code === \"invalid_type\") {\n    return {\n      path: toIssuePath(issue.path),\n      message: issue.message,\n      code: issue.received === \"undefined\" ? \"missing_required\" : \"invalid_type\",\n    };\n  }\n  return {\n    path: toIssuePath(issue.path),\n    message: issue.message,\n    code: \"invalid_value\",\n  };\n}\n\nconst UNSAFE_META_KEYS = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\nfunction isSafeUrl(value: string): boolean {\n  const normalized = value.trim();\n  if (!normalized) return false;\n  if (/^(\\/|\\.\\/|\\.\\.\\/|\\?|#)/.test(normalized)) return true;\n  if (/^https?:\\/\\//i.test(normalized)) return true;\n  return false;\n}\n\nfunction findUnsafeMetaPath(value: unknown, path = \"meta\"): string | null {\n  if (Array.isArray(value)) {\n    for (let index = 0; index < value.length; index++) {\n      const nested = findUnsafeMetaPath(value[index], `${path}[${index}]`);\n      if (nested) return nested;\n    }\n    return null;\n  }\n\n  if (!isRecord(value)) return null;\n  for (const [key, nestedValue] of Object.entries(value)) {\n    if (UNSAFE_META_KEYS.has(key)) {\n      return `${path}.${key}`;\n    }\n    const nested = findUnsafeMetaPath(nestedValue, `${path}.${key}`);\n    if (nested) return nested;\n  }\n  return null;\n}\n\nfunction validateFeatureEntry(raw: unknown, index: number): { entry?: FeatureEntry; issues: ValidationIssue[] } {\n  if (!isRecord(raw)) {\n    return {\n      issues: [\n        {\n          path: `[${index}]`,\n          message: \"Feature entry must be an object\",\n          code: \"invalid_type\",\n        },\n      ],\n    };\n  }\n\n  const parsed = featureEntrySchema.safeParse(raw);\n  if (!parsed.success) {\n    return {\n      issues: parsed.error.issues.map((issue) => ({\n        ...mapZodIssue(issue),\n        path: `[${index}]${issue.path.length > 0 ? `.${toIssuePath(issue.path)}` : \"\"}`,\n      })),\n    };\n  }\n\n  return {\n    issues: [],\n    entry: parsed.data as FeatureEntry,\n  };\n}\n\nexport function validateManifest(data: unknown): ValidationResult {\n  const errors: ValidationIssue[] = [];\n  if (!Array.isArray(data)) {\n    return {\n      valid: false,\n      errors: [\n        {\n          path: \"$\",\n          message: \"Manifest must be an array\",\n          code: \"invalid_type\",\n        },\n      ],\n    };\n  }\n\n  const entries: FeatureEntry[] = [];\n  const seenIds = new Set<string>();\n  data.forEach((item, index) => {\n    const result = validateFeatureEntry(item, index);\n    errors.push(...result.issues);\n    if (!result.entry) return;\n    if (seenIds.has(result.entry.id)) {\n      errors.push({\n        path: `[${index}].id`,\n        message: `Duplicate feature id \"${result.entry.id}\"`,\n        code: \"duplicate_id\",\n      });\n      return;\n    }\n    seenIds.add(result.entry.id);\n    entries.push(result.entry);\n  });\n\n  if (entries.length > 0 && hasDependencyCycle(entries as FeatureManifest)) {\n    errors.push({\n      path: \"$\",\n      message: \"Circular dependsOn relationship detected\",\n      code: \"circular_dependency\",\n    });\n  }\n\n  for (let index = 0; index < entries.length; index++) {\n    const entry = entries[index];\n    if (new Date(entry.showNewUntil).getTime() <= new Date(entry.releasedAt).getTime()) {\n      errors.push({\n        path: `[${index}].showNewUntil`,\n        message: \"showNewUntil must be after releasedAt\",\n        code: \"invalid_value\",\n      });\n    }\n\n    if (entry.url && !isSafeUrl(entry.url)) {\n      errors.push({\n        path: `[${index}].url`,\n        message: \"url must be http, https, or relative\",\n        code: \"invalid_value\",\n      });\n    }\n\n    if (entry.image && !isSafeUrl(entry.image)) {\n      errors.push({\n        path: `[${index}].image`,\n        message: \"image must be http, https, or relative\",\n        code: \"invalid_value\",\n      });\n    }\n\n    if (entry.cta?.url && !isSafeUrl(entry.cta.url)) {\n      errors.push({\n        path: `[${index}].cta.url`,\n        message: \"cta.url must be http, https, or relative\",\n        code: \"invalid_value\",\n      });\n    }\n\n    const unsafeMetaPath = findUnsafeMetaPath(entry.meta);\n    if (unsafeMetaPath) {\n      errors.push({\n        path: `[${index}].${unsafeMetaPath}`,\n        message: `meta contains unsafe key \"${unsafeMetaPath.split(\".\").pop()}\"`,\n        code: \"invalid_value\",\n      });\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n","import { validateManifest } from \"./schema\";\nimport type { FeatureEntry, FeatureManifest } from \"./types\";\n\nexport interface ChangedFeature {\n  id: string;\n  before: FeatureEntry;\n  after: FeatureEntry;\n  changedFields: string[];\n}\n\nexport interface ManifestDiff {\n  added: FeatureEntry[];\n  removed: FeatureEntry[];\n  changed: ChangedFeature[];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction collectChangedFields(\n  beforeValue: unknown,\n  afterValue: unknown,\n  path: string,\n  output: string[],\n): void {\n  if (beforeValue === afterValue) return;\n\n  if (Array.isArray(beforeValue) && Array.isArray(afterValue)) {\n    if (beforeValue.length !== afterValue.length) {\n      output.push(path);\n      return;\n    }\n    for (let i = 0; i < beforeValue.length; i += 1) {\n      collectChangedFields(beforeValue[i], afterValue[i], `${path}[${i}]`, output);\n    }\n    return;\n  }\n\n  if (isRecord(beforeValue) && isRecord(afterValue)) {\n    const keys = new Set([...Object.keys(beforeValue), ...Object.keys(afterValue)]);\n    keys.forEach((key) => {\n      const nextPath = path ? `${path}.${key}` : key;\n      collectChangedFields(beforeValue[key], afterValue[key], nextPath, output);\n    });\n    return;\n  }\n\n  output.push(path);\n}\n\nexport function diffManifest(before: FeatureManifest, after: FeatureManifest): ManifestDiff {\n  const beforeById = new Map(before.map((feature) => [feature.id, feature]));\n  const afterById = new Map(after.map((feature) => [feature.id, feature]));\n\n  const added = after.filter((feature) => !beforeById.has(feature.id));\n  const removed = before.filter((feature) => !afterById.has(feature.id));\n\n  const changed = after\n    .filter((feature) => beforeById.has(feature.id))\n    .map((feature) => {\n      const previous = beforeById.get(feature.id);\n      if (!previous) return null;\n      const changedFields: string[] = [];\n      collectChangedFields(previous, feature, \"\", changedFields);\n      if (changedFields.length === 0) return null;\n      return {\n        id: feature.id,\n        before: previous,\n        after: feature,\n        changedFields,\n      } satisfies ChangedFeature;\n    })\n    .filter((item): item is ChangedFeature => item !== null);\n\n  return { added, removed, changed };\n}\n\nexport interface ChangelogDiffOptions {\n  includeFieldChanges?: boolean;\n}\n\nexport function generateChangelogDiff(\n  diff: ManifestDiff,\n  options: ChangelogDiffOptions = {},\n): string {\n  const parts: string[] = [];\n\n  if (diff.added.length > 0) {\n    parts.push(`Added: ${diff.added.map((feature) => feature.label).join(\", \")}`);\n  }\n\n  if (diff.changed.length > 0) {\n    const changedText = diff.changed.map((item) => {\n      if (!options.includeFieldChanges) return item.after.label;\n      return `${item.after.label} [${item.changedFields.join(\", \")}]`;\n    });\n    parts.push(`Changed: ${changedText.join(\", \")}`);\n  }\n\n  if (diff.removed.length > 0) {\n    parts.push(`Removed: ${diff.removed.map((feature) => feature.label).join(\", \")}`);\n  }\n\n  return parts.length > 0 ? parts.join(\". \") : \"No manifest changes.\";\n}\n\nexport function validateManifestForCI(manifest: FeatureManifest) {\n  return validateManifest(manifest);\n}\n"]}

package/dist/ci.d.cts

@@ -0,0 +1,176 @@
+interface ValidationIssue {
+    path: string;
+    message: string;
+    code: "invalid_type" | "missing_required" | "invalid_value" | "invalid_date" | "duplicate_id" | "circular_dependency";
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: ValidationIssue[];
+}
+
+/** 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>;
+}
+/** 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 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[];
+
+interface ChangedFeature {
+    id: string;
+    before: FeatureEntry;
+    after: FeatureEntry;
+    changedFields: string[];
+}
+interface ManifestDiff {
+    added: FeatureEntry[];
+    removed: FeatureEntry[];
+    changed: ChangedFeature[];
+}
+declare function diffManifest(before: FeatureManifest, after: FeatureManifest): ManifestDiff;
+interface ChangelogDiffOptions {
+    includeFieldChanges?: boolean;
+}
+declare function generateChangelogDiff(diff: ManifestDiff, options?: ChangelogDiffOptions): string;
+declare function validateManifestForCI(manifest: FeatureManifest): ValidationResult;
+
+export { type ChangedFeature, type ChangelogDiffOptions, type ManifestDiff, diffManifest, generateChangelogDiff, validateManifestForCI };