featuredrop 1.1.0 → 1.3.0

package/dist/schema.cjs

@@ -0,0 +1,292 @@
+'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;
+}
+var featureEntryJsonSchema = {
+  type: "object",
+  required: ["id", "label", "releasedAt", "showNewUntil"],
+  properties: {
+    id: { type: "string" },
+    label: { type: "string" },
+    description: { type: "string" },
+    releasedAt: { type: "string", format: "date-time" },
+    showNewUntil: { type: "string", format: "date-time" },
+    flagKey: { type: "string" },
+    product: { type: "string" },
+    url: { type: "string" },
+    image: { type: "string" },
+    type: { enum: ["feature", "improvement", "fix", "breaking"] },
+    priority: { enum: ["critical", "normal", "low"] },
+    cta: {
+      type: "object",
+      properties: {
+        label: { type: "string" },
+        url: { type: "string" }
+      }
+    },
+    meta: { type: "object" }
+  }
+};
+var featureManifestJsonSchema = {
+  type: "array",
+  items: featureEntryJsonSchema
+};
+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();
+var featureManifestSchema = 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
+  };
+}
+
+exports.featureEntryJsonSchema = featureEntryJsonSchema;
+exports.featureEntrySchema = featureEntrySchema;
+exports.featureManifestJsonSchema = featureManifestJsonSchema;
+exports.featureManifestSchema = featureManifestSchema;
+exports.validateManifest = validateManifest;
+//# sourceMappingURL=schema.cjs.map
+//# sourceMappingURL=schema.cjs.map

package/dist/schema.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dependencies.ts","../src/schema.ts"],"names":["z"],"mappings":"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","file":"schema.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"]}

package/dist/schema.d.cts

@@ -0,0 +1,345 @@
+import { z } from 'zod';
+
+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[];
+}
+declare const featureEntryJsonSchema: {
+    readonly type: "object";
+    readonly required: readonly ["id", "label", "releasedAt", "showNewUntil"];
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+        };
+        readonly label: {
+            readonly type: "string";
+        };
+        readonly description: {
+            readonly type: "string";
+        };
+        readonly releasedAt: {
+            readonly type: "string";
+            readonly format: "date-time";
+        };
+        readonly showNewUntil: {
+            readonly type: "string";
+            readonly format: "date-time";
+        };
+        readonly flagKey: {
+            readonly type: "string";
+        };
+        readonly product: {
+            readonly type: "string";
+        };
+        readonly url: {
+            readonly type: "string";
+        };
+        readonly image: {
+            readonly type: "string";
+        };
+        readonly type: {
+            readonly enum: readonly ["feature", "improvement", "fix", "breaking"];
+        };
+        readonly priority: {
+            readonly enum: readonly ["critical", "normal", "low"];
+        };
+        readonly cta: {
+            readonly type: "object";
+            readonly properties: {
+                readonly label: {
+                    readonly type: "string";
+                };
+                readonly url: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly meta: {
+            readonly type: "object";
+        };
+    };
+};
+declare const featureManifestJsonSchema: {
+    readonly type: "array";
+    readonly items: {
+        readonly type: "object";
+        readonly required: readonly ["id", "label", "releasedAt", "showNewUntil"];
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly label: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly releasedAt: {
+                readonly type: "string";
+                readonly format: "date-time";
+            };
+            readonly showNewUntil: {
+                readonly type: "string";
+                readonly format: "date-time";
+            };
+            readonly flagKey: {
+                readonly type: "string";
+            };
+            readonly product: {
+                readonly type: "string";
+            };
+            readonly url: {
+                readonly type: "string";
+            };
+            readonly image: {
+                readonly type: "string";
+            };
+            readonly type: {
+                readonly enum: readonly ["feature", "improvement", "fix", "breaking"];
+            };
+            readonly priority: {
+                readonly enum: readonly ["critical", "normal", "low"];
+            };
+            readonly cta: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly label: {
+                        readonly type: "string";
+                    };
+                    readonly url: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly meta: {
+                readonly type: "object";
+            };
+        };
+    };
+};
+declare const featureEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    releasedAt: z.ZodEffects<z.ZodString, string, string>;
+    showNewUntil: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodOptional<z.ZodString>;
+    flagKey: z.ZodOptional<z.ZodString>;
+    product: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["feature", "improvement", "fix", "breaking"]>>;
+    priority: z.ZodOptional<z.ZodEnum<["critical", "normal", "low"]>>;
+    cta: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        url: string;
+    }, {
+        label: string;
+        url: string;
+    }>>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dependsOn: z.ZodOptional<z.ZodObject<{
+        seen: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        clicked: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dismissed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    label: z.ZodString;
+    releasedAt: z.ZodEffects<z.ZodString, string, string>;
+    showNewUntil: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodOptional<z.ZodString>;
+    flagKey: z.ZodOptional<z.ZodString>;
+    product: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["feature", "improvement", "fix", "breaking"]>>;
+    priority: z.ZodOptional<z.ZodEnum<["critical", "normal", "low"]>>;
+    cta: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        url: string;
+    }, {
+        label: string;
+        url: string;
+    }>>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dependsOn: z.ZodOptional<z.ZodObject<{
+        seen: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        clicked: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dismissed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    label: z.ZodString;
+    releasedAt: z.ZodEffects<z.ZodString, string, string>;
+    showNewUntil: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodOptional<z.ZodString>;
+    flagKey: z.ZodOptional<z.ZodString>;
+    product: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["feature", "improvement", "fix", "breaking"]>>;
+    priority: z.ZodOptional<z.ZodEnum<["critical", "normal", "low"]>>;
+    cta: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        url: string;
+    }, {
+        label: string;
+        url: string;
+    }>>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dependsOn: z.ZodOptional<z.ZodObject<{
+        seen: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        clicked: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dismissed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }>>;
+}, z.ZodTypeAny, "passthrough">>;
+declare const featureManifestSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    releasedAt: z.ZodEffects<z.ZodString, string, string>;
+    showNewUntil: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodOptional<z.ZodString>;
+    flagKey: z.ZodOptional<z.ZodString>;
+    product: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["feature", "improvement", "fix", "breaking"]>>;
+    priority: z.ZodOptional<z.ZodEnum<["critical", "normal", "low"]>>;
+    cta: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        url: string;
+    }, {
+        label: string;
+        url: string;
+    }>>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dependsOn: z.ZodOptional<z.ZodObject<{
+        seen: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        clicked: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dismissed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    label: z.ZodString;
+    releasedAt: z.ZodEffects<z.ZodString, string, string>;
+    showNewUntil: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodOptional<z.ZodString>;
+    flagKey: z.ZodOptional<z.ZodString>;
+    product: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["feature", "improvement", "fix", "breaking"]>>;
+    priority: z.ZodOptional<z.ZodEnum<["critical", "normal", "low"]>>;
+    cta: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        url: string;
+    }, {
+        label: string;
+        url: string;
+    }>>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dependsOn: z.ZodOptional<z.ZodObject<{
+        seen: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        clicked: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dismissed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    label: z.ZodString;
+    releasedAt: z.ZodEffects<z.ZodString, string, string>;
+    showNewUntil: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodOptional<z.ZodString>;
+    flagKey: z.ZodOptional<z.ZodString>;
+    product: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["feature", "improvement", "fix", "breaking"]>>;
+    priority: z.ZodOptional<z.ZodEnum<["critical", "normal", "low"]>>;
+    cta: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        url: string;
+    }, {
+        label: string;
+        url: string;
+    }>>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dependsOn: z.ZodOptional<z.ZodObject<{
+        seen: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        clicked: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dismissed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }, {
+        seen?: string[] | undefined;
+        clicked?: string[] | undefined;
+        dismissed?: string[] | undefined;
+    }>>;
+}, z.ZodTypeAny, "passthrough">>, "many">;
+declare function validateManifest(data: unknown): ValidationResult;
+
+export { type ValidationIssue, type ValidationResult, featureEntryJsonSchema, featureEntrySchema, featureManifestJsonSchema, featureManifestSchema, validateManifest };