@notionx/core 0.1.0

package/dist/doctor/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/doctor/cli.ts","../../src/platform/capabilities.ts","../../src/platform/selection.ts","../../src/doctor/doctor.ts"],"sourcesContent":["#!/usr/bin/env node\n// Foundation doctor CLI.\n// Reads wrangler.jsonc and .env/.dev.vars from the current working\n// directory, builds a report via the package's doctor module, and\n// prints it to stdout. Exits with status 1 when required configuration\n// is missing.\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  buildNextionDoctorReport,\n  formatNextionDoctorReport,\n} from \"./index\";\n\nconst projectRoot = process.cwd();\n\nfunction parseArgs(argv: string[]) {\n  const result = {\n    json: false,\n  };\n\n  for (const arg of argv) {\n    if (arg === \"--json\") {\n      result.json = true;\n      continue;\n    }\n    throw new Error(`Unknown argument: ${arg}`);\n  }\n\n  return result;\n}\n\nfunction stripJsonComments(source: string) {\n  let output = \"\";\n  let inString = false;\n  let escaped = false;\n  let lineComment = false;\n  let blockComment = false;\n\n  for (let index = 0; index < source.length; index += 1) {\n    const char = source[index];\n    const next = source[index + 1];\n\n    if (lineComment) {\n      if (char === \"\\n\") {\n        lineComment = false;\n        output += char;\n      }\n      continue;\n    }\n\n    if (blockComment) {\n      if (char === \"*\" && next === \"/\") {\n        blockComment = false;\n        index += 1;\n      }\n      continue;\n    }\n\n    if (inString) {\n      output += char;\n      if (escaped) {\n        escaped = false;\n      } else if (char === \"\\\\\") {\n        escaped = true;\n      } else if (char === \"\\\"\") {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (char === \"\\\"\") {\n      inString = true;\n      output += char;\n      continue;\n    }\n\n    if (char === \"/\" && next === \"/\") {\n      lineComment = true;\n      index += 1;\n      continue;\n    }\n\n    if (char === \"/\" && next === \"*\") {\n      blockComment = true;\n      index += 1;\n      continue;\n    }\n\n    output += char;\n  }\n\n  return output;\n}\n\nfunction readJsonc(filePath: string) {\n  if (!fs.existsSync(filePath)) return null;\n  return JSON.parse(stripJsonComments(fs.readFileSync(filePath, \"utf8\")));\n}\n\nfunction readDotEnvFile(filePath: string) {\n  if (!fs.existsSync(filePath)) return {};\n  const env: Record<string, string> = {};\n  for (const line of fs.readFileSync(filePath, \"utf8\").split(/\\r?\\n/)) {\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith(\"#\")) continue;\n    const equalIndex = trimmed.indexOf(\"=\");\n    if (equalIndex === -1) continue;\n\n    const name = trimmed.slice(0, equalIndex).trim();\n    let value = trimmed.slice(equalIndex + 1).trim();\n    if (\n      (value.startsWith(\"\\\"\") && value.endsWith(\"\\\"\")) ||\n      (value.startsWith(\"'\") && value.endsWith(\"'\"))\n    ) {\n      value = value.slice(1, -1);\n    }\n    env[name] = value;\n  }\n  return env;\n}\n\nfunction mergedEnv(wranglerConfig: { vars?: Record<string, string | undefined> } | null) {\n  return {\n    ...wranglerConfig?.vars,\n    ...readDotEnvFile(path.join(projectRoot, \".env.local\")),\n    ...readDotEnvFile(path.join(projectRoot, \".dev.vars\")),\n    ...process.env,\n  };\n}\n\nasync function main() {\n  const args = parseArgs(process.argv.slice(2));\n  const wranglerConfig = readJsonc(path.join(projectRoot, \"wrangler.jsonc\"));\n  const report = buildNextionDoctorReport({\n    env: mergedEnv(wranglerConfig),\n    wranglerConfig,\n  });\n\n  if (args.json) {\n    console.log(JSON.stringify(report, null, 2));\n  } else {\n    console.log(formatNextionDoctorReport(report));\n  }\n\n  if (report.overall.status === \"missing\") {\n    process.exitCode = 1;\n  }\n}\n\nif (fileURLToPath(import.meta.url) === path.resolve(process.argv[1] ?? \"\")) {\n  main().catch((error) => {\n    console.error(error instanceof Error ? error.message : String(error));\n    process.exitCode = 1;\n  });\n}\n","import type { RuntimeId } from \"./selection\";\n\nexport type RuntimeCapability =\n  | \"server-rendering\"\n  | \"edge-cache\"\n  | \"relational-storage\"\n  | \"object-storage\"\n  | \"image-optimization\"\n  | \"secrets\"\n  | \"observability\";\n\nexport type RuntimeAdapterDefinition = {\n  id: RuntimeId;\n  label: string;\n  status: \"active\" | \"partial\" | \"planned\";\n  services: {\n    compute: string;\n    relationalStorage: string;\n    objectStorage: string;\n    imageOptimization: string;\n    cache: string;\n    authStorage: string;\n  };\n  capabilities: readonly RuntimeCapability[];\n};\n\nexport type RuntimeServiceStatus = {\n  database: boolean;\n  objectStorage: boolean;\n  imageTransformer: boolean;\n  publicCache: boolean;\n};\n\nexport const cloudflareWorkersAdapter: RuntimeAdapterDefinition = {\n  id: \"cloudflare-workers\",\n  label: \"Cloudflare Workers + D1\",\n  status: \"active\",\n  services: {\n    compute: \"Cloudflare Workers via vinext\",\n    relationalStorage: \"D1 through the runtime SQL adapter\",\n    objectStorage: \"R2\",\n    imageOptimization: \"Cloudflare Images\",\n    cache: \"vinext CDN/data adapters and caches.default for media\",\n    authStorage: \"D1 users and signed cookies\",\n  },\n  capabilities: [\n    \"server-rendering\",\n    \"edge-cache\",\n    \"relational-storage\",\n    \"object-storage\",\n    \"image-optimization\",\n    \"secrets\",\n    \"observability\",\n  ],\n};\n\nexport const runtimeAdapters = [cloudflareWorkersAdapter] as const;\n\nexport function getRuntimeAdapter(id: RuntimeAdapterDefinition[\"id\"]) {\n  return runtimeAdapters.find((adapter) => adapter.id === id);\n}\n\nexport function runtimeServiceStatus(\n  platform: {\n    database: unknown;\n    objectStorage: unknown;\n    imageTransformer: unknown;\n    publicCache: unknown;\n  }\n): RuntimeServiceStatus {\n  return {\n    database: Boolean(platform.database),\n    objectStorage: Boolean(platform.objectStorage),\n    imageTransformer: Boolean(platform.imageTransformer),\n    publicCache: Boolean(platform.publicCache),\n  };\n}\n","export type RuntimeId = \"cloudflare-workers\";\n\nexport type RuntimeKind = \"cloudflare\";\n\nexport interface RuntimeSelection {\n  kind: RuntimeKind;\n  runtimeId: RuntimeId;\n}\n\nfunction hasCloudflareBindings(env: unknown): boolean {\n  if (!env || typeof env !== \"object\") return false;\n  const record = env as Record<string, unknown>;\n  return (\n    \"DB\" in record ||\n    \"ASSETS_BUCKET\" in record ||\n    \"R2\" in record ||\n    \"IMAGES\" in record ||\n    \"CONTENT_CACHE\" in record\n  );\n}\n\nexport function selectRuntime(env: unknown): RuntimeSelection {\n  if (hasCloudflareBindings(env)) {\n    return { kind: \"cloudflare\", runtimeId: \"cloudflare-workers\" };\n  }\n  throw new Error(\n    \"No supported runtime detected. Expected Cloudflare Workers bindings \" +\n      \"(DB, ASSETS_BUCKET, R2, IMAGES, or CONTENT_CACHE).\",\n  );\n}\n\nexport function currentRuntimeId(): RuntimeId {\n  return \"cloudflare-workers\";\n}\n","import type { ContentModelDefinition, NotionFieldMap } from \"./model\";\nimport {\n  getRuntimeAdapter,\n  type RuntimeAdapterDefinition,\n} from \"../platform/capabilities\";\nimport { currentRuntimeId, type RuntimeId } from \"../platform/selection\";\n\nexport type NextionDoctorStatus = \"ok\" | \"warn\" | \"missing\";\n\nexport type EnvLike = Record<string, string | undefined>;\n\nexport type WranglerConfigLike = {\n  vars?: EnvLike;\n  d1_databases?: Array<{ binding?: string }>;\n  r2_buckets?: Array<{ binding?: string }>;\n  images?: { binding?: string } | Array<{ binding?: string }>;\n  observability?: { enabled?: boolean };\n};\n\nexport type NextionDoctorCheck = {\n  id: string;\n  label: string;\n  status: NextionDoctorStatus;\n  required: boolean;\n  detail: string;\n  action?: string;\n};\n\nexport type NextionDoctorModel = {\n  id: string;\n  public: boolean;\n  admin: boolean;\n  listPath: string;\n  detailPath: string;\n  publicApiPath?: string;\n  dataSourceEnv: string;\n  dataSourceStatus: NextionDoctorStatus;\n  dataSourceSource: \"env\" | \"default\" | \"missing\";\n};\n\nexport type NextionDoctorReport = {\n  overall: {\n    status: NextionDoctorStatus;\n    summary: string;\n  };\n  runtime: {\n    id: RuntimeId;\n    label: string;\n    adapterStatus: RuntimeAdapterDefinition[\"status\"];\n  };\n  checks: NextionDoctorCheck[];\n  models: NextionDoctorModel[];\n  nextSteps: string[];\n};\n\ntype BuildNextionDoctorReportOptions = {\n  env?: EnvLike;\n  runtimeId?: RuntimeId;\n  wranglerConfig?: WranglerConfigLike | null;\n  models?: readonly ContentModelDefinition<NotionFieldMap>[];\n};\n\nfunction envValue(env: EnvLike, name: string) {\n  const value = String(env[name] ?? \"\").trim();\n  return value || undefined;\n}\n\nfunction hasEnv(env: EnvLike, name: string) {\n  return Boolean(envValue(env, name));\n}\n\nfunction hasD1Binding(config: WranglerConfigLike | null | undefined, binding: string) {\n  return Boolean(config?.d1_databases?.some((item) => item.binding === binding));\n}\n\nfunction hasR2Binding(config: WranglerConfigLike | null | undefined, binding: string) {\n  return Boolean(config?.r2_buckets?.some((item) => item.binding === binding));\n}\n\nfunction hasImagesBinding(\n  config: WranglerConfigLike | null | undefined,\n  binding: string\n) {\n  const images = config?.images;\n  if (Array.isArray(images)) {\n    return images.some((item) => item.binding === binding);\n  }\n  return images?.binding === binding;\n}\n\nfunction statusSummary(status: NextionDoctorStatus) {\n  if (status === \"ok\") return \"ready\";\n  if (status === \"warn\") return \"usable with warnings\";\n  return \"missing required configuration\";\n}\n\nfunction overallStatus(\n  checks: readonly NextionDoctorCheck[],\n  models: readonly NextionDoctorModel[]\n): NextionDoctorStatus {\n  if (\n    checks.some((check) => check.status === \"missing\") ||\n    models.some((model) => model.dataSourceStatus === \"missing\")\n  ) {\n    return \"missing\";\n  }\n\n  if (\n    checks.some((check) => check.status === \"warn\") ||\n    models.some((model) => model.dataSourceStatus === \"warn\")\n  ) {\n    return \"warn\";\n  }\n\n  return \"ok\";\n}\n\nfunction cloudflareChecks(\n  config: WranglerConfigLike | null | undefined\n): NextionDoctorCheck[] {\n  return [\n    {\n      id: \"runtime.database\",\n      label: \"SQL database\",\n      status: hasD1Binding(config, \"DB\") ? \"ok\" : \"missing\",\n      required: true,\n      detail: hasD1Binding(config, \"DB\")\n        ? \"wrangler D1 binding DB is declared\"\n        : \"wrangler D1 binding DB is missing\",\n      action: \"Add a DB binding under d1_databases in wrangler.jsonc.\",\n    },\n    {\n      id: \"runtime.objectStorage\",\n      label: \"Object storage\",\n      status: hasR2Binding(config, \"ASSETS_BUCKET\") ? \"ok\" : \"warn\",\n      required: false,\n      detail: hasR2Binding(config, \"ASSETS_BUCKET\")\n        ? \"wrangler R2 binding ASSETS_BUCKET is declared\"\n        : \"uploads and persistent media cache need ASSETS_BUCKET\",\n      action: \"Add an ASSETS_BUCKET R2 binding for uploads and media cache.\",\n    },\n    {\n      id: \"runtime.imageTransformer\",\n      label: \"Image transformation\",\n      status: hasImagesBinding(config, \"IMAGES\") ? \"ok\" : \"warn\",\n      required: false,\n      detail: hasImagesBinding(config, \"IMAGES\")\n        ? \"wrangler Images binding IMAGES is declared\"\n        : \"Notion media optimization will fall back without IMAGES\",\n      action: \"Add a Cloudflare Images binding named IMAGES.\",\n    },\n    {\n      id: \"runtime.publicCache\",\n      label: \"Public cache\",\n      status: \"ok\",\n      required: true,\n      detail: \"vinext CDN adapter handles page cache; caches.default remains for media\",\n    },\n    {\n      id: \"runtime.observability\",\n      label: \"Observability\",\n      status: config?.observability?.enabled ? \"ok\" : \"warn\",\n      required: false,\n      detail: config?.observability?.enabled\n        ? \"wrangler observability is enabled\"\n        : \"wrangler observability is not enabled\",\n      action: \"Enable observability in wrangler.jsonc for production debugging.\",\n    },\n  ];\n}\n\nfunction notionChecks(env: EnvLike): NextionDoctorCheck[] {\n  return [\n    {\n      id: \"notion.token\",\n      label: \"Notion token\",\n      status: hasEnv(env, \"NOTION_TOKEN\") ? \"ok\" : \"missing\",\n      required: true,\n      detail: hasEnv(env, \"NOTION_TOKEN\")\n        ? \"NOTION_TOKEN is configured\"\n        : \"NOTION_TOKEN is missing\",\n      action: \"Set NOTION_TOKEN to an internal integration token.\",\n    },\n    {\n      id: \"notion.webhook\",\n      label: \"Notion webhook verification\",\n      status: hasEnv(env, \"NOTION_WEBHOOK_VERIFICATION_TOKEN\") ? \"ok\" : \"warn\",\n      required: false,\n      detail: hasEnv(env, \"NOTION_WEBHOOK_VERIFICATION_TOKEN\")\n        ? \"NOTION_WEBHOOK_VERIFICATION_TOKEN is configured\"\n        : \"instant content invalidation needs NOTION_WEBHOOK_VERIFICATION_TOKEN\",\n      action:\n        \"Set NOTION_WEBHOOK_VERIFICATION_TOKEN after creating the Notion webhook.\",\n    },\n  ];\n}\n\nfunction modelDoctorStatus(\n  env: EnvLike,\n  model: ContentModelDefinition<NotionFieldMap>\n): Pick<NextionDoctorModel, \"dataSourceStatus\" | \"dataSourceSource\"> {\n  const hasConfiguredEnv = hasEnv(env, model.source.dataSourceEnv);\n  const hasDefault = Boolean(model.source.defaultDataSourceId);\n  const dataSourceSource = hasConfiguredEnv\n    ? \"env\"\n    : hasDefault\n      ? \"default\"\n      : \"missing\";\n  const dataSourceStatus = dataSourceSource === \"missing\" ? \"missing\" : \"ok\";\n\n  return {\n    dataSourceStatus,\n    dataSourceSource,\n  };\n}\n\nfunction modelChecks(\n  env: EnvLike,\n  models: readonly ContentModelDefinition<NotionFieldMap>[]\n): NextionDoctorModel[] {\n  return models.map((model) => ({\n    id: model.id,\n    public: model.visibility.public,\n    admin: model.visibility.admin,\n    listPath: model.routes.listPath,\n    detailPath: model.routes.detailPath,\n    publicApiPath: model.routes.publicApiPath,\n    dataSourceEnv: model.source.dataSourceEnv,\n    ...modelDoctorStatus(env, model),\n  }));\n}\n\nfunction uniqueActions(checks: readonly NextionDoctorCheck[]) {\n  return Array.from(\n    new Set(\n      checks\n        .filter((check) => check.status !== \"ok\" && check.action)\n        .map((check) => check.action as string)\n    )\n  );\n}\n\nfunction omitResolvedActions(check: NextionDoctorCheck): NextionDoctorCheck {\n  if (check.status !== \"ok\") return check;\n  return {\n    ...check,\n    action: undefined,\n  };\n}\n\nexport function buildNextionDoctorReport(\n  options: BuildNextionDoctorReportOptions = {}\n): NextionDoctorReport {\n  const env = options.env ?? process.env;\n  const runtimeId = options.runtimeId ?? currentRuntimeId();\n  const adapter = getRuntimeAdapter(runtimeId);\n  const checks = [\n    ...cloudflareChecks(options.wranglerConfig),\n    ...notionChecks(env),\n  ].map(omitResolvedActions);\n  const models = modelChecks(env, options.models ?? []);\n  const status = overallStatus(checks, models);\n  const modelActions = models\n    .filter((model) => model.dataSourceStatus === \"missing\")\n    .map(\n      (model) =>\n        `Set ${model.dataSourceEnv} for the ${model.id} content model or add a model defaultDataSourceId.`\n    );\n\n  return {\n    overall: {\n      status,\n      summary: statusSummary(status),\n    },\n    runtime: {\n      id: runtimeId,\n      label: adapter?.label ?? runtimeId,\n      adapterStatus: adapter?.status ?? \"planned\",\n    },\n    checks,\n    models,\n    nextSteps: [...uniqueActions(checks), ...modelActions],\n  };\n}\n\nfunction formatCheck(check: NextionDoctorCheck) {\n  const required = check.required ? \"required\" : \"optional\";\n  return `  [${check.status}] ${check.label} (${required}) - ${check.detail}`;\n}\n\nfunction formatModel(model: NextionDoctorModel) {\n  const visibility = [\n    model.public ? \"public\" : \"\",\n    model.admin ? \"admin\" : \"\",\n  ].filter(Boolean);\n  const source =\n    model.dataSourceSource === \"env\"\n      ? model.dataSourceEnv\n      : model.dataSourceSource === \"default\"\n        ? `${model.dataSourceEnv} or model default`\n        : model.dataSourceEnv;\n\n  return [\n    `  [${model.dataSourceStatus}] ${model.id} (${visibility.join(\", \") || \"private\"})`,\n    `      routes: ${model.listPath}, ${model.detailPath}${\n      model.publicApiPath ? `, ${model.publicApiPath}` : \"\"\n    }`,\n    `      notion: ${source}`,\n  ].join(\"\\n\");\n}\n\nexport function formatNextionDoctorReport(report: NextionDoctorReport) {\n  const lines = [\n    \"vinext nextion doctor\",\n    \"\",\n    `Overall: [${report.overall.status}] ${report.overall.summary}`,\n    `Runtime: ${report.runtime.label} (${report.runtime.id}, ${report.runtime.adapterStatus})`,\n    \"\",\n    \"Checks:\",\n    ...report.checks.map(formatCheck),\n    \"\",\n    \"Content models:\",\n    ...report.models.map(formatModel),\n  ];\n\n  if (report.nextSteps.length > 0) {\n    lines.push(\"\", \"Next steps:\");\n    for (const step of report.nextSteps) {\n      lines.push(`  - ${step}`);\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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","names":[]}

package/dist/doctor/index.d.ts

@@ -0,0 +1,139 @@
+import { RuntimeAdapterDefinition } from '../platform/capabilities.js';
+import { RuntimeId } from '../platform/selection.js';
+
+type NotionSortDirection = "ascending" | "descending";
+type NotionSort = {
+    property: string;
+    direction: NotionSortDirection;
+};
+type NotionFieldMap = Record<string, string | readonly string[]>;
+type ContentModelDefinition<TFields extends NotionFieldMap = NotionFieldMap> = {
+    id: string;
+    kind: "article" | "catalog" | "directory";
+    visibility: {
+        public: boolean;
+        admin: boolean;
+    };
+    source: {
+        type: "notion";
+        tokenEnv: "NOTION_TOKEN";
+        dataSourceEnv: string;
+        defaultDataSourceId?: string;
+        fields: TFields;
+        query: {
+            pageSize: number;
+            sorts?: readonly NotionSort[];
+            filterProperties?: readonly string[];
+        };
+    };
+    routes: {
+        listPath: string;
+        detailPath: string;
+        detailParam: string;
+        publicApiPath?: string;
+    };
+    ui: {
+        name: string;
+        pluralName: string;
+        navLabel: string;
+        listTitle: string;
+        listDescription: string;
+        emptyState: string;
+    };
+    capabilities: {
+        richBlocks: boolean;
+        coverImages: boolean;
+        gatedAssets: boolean;
+    };
+};
+
+type NextionDoctorStatus = "ok" | "warn" | "missing";
+type EnvLike = Record<string, string | undefined>;
+type WranglerConfigLike = {
+    vars?: EnvLike;
+    d1_databases?: Array<{
+        binding?: string;
+    }>;
+    r2_buckets?: Array<{
+        binding?: string;
+    }>;
+    images?: {
+        binding?: string;
+    } | Array<{
+        binding?: string;
+    }>;
+    observability?: {
+        enabled?: boolean;
+    };
+};
+type NextionDoctorCheck = {
+    id: string;
+    label: string;
+    status: NextionDoctorStatus;
+    required: boolean;
+    detail: string;
+    action?: string;
+};
+type NextionDoctorModel = {
+    id: string;
+    public: boolean;
+    admin: boolean;
+    listPath: string;
+    detailPath: string;
+    publicApiPath?: string;
+    dataSourceEnv: string;
+    dataSourceStatus: NextionDoctorStatus;
+    dataSourceSource: "env" | "default" | "missing";
+};
+type NextionDoctorReport = {
+    overall: {
+        status: NextionDoctorStatus;
+        summary: string;
+    };
+    runtime: {
+        id: RuntimeId;
+        label: string;
+        adapterStatus: RuntimeAdapterDefinition["status"];
+    };
+    checks: NextionDoctorCheck[];
+    models: NextionDoctorModel[];
+    nextSteps: string[];
+};
+type BuildNextionDoctorReportOptions = {
+    env?: EnvLike;
+    runtimeId?: RuntimeId;
+    wranglerConfig?: WranglerConfigLike | null;
+    models?: readonly ContentModelDefinition<NotionFieldMap>[];
+};
+declare function buildNextionDoctorReport(options?: BuildNextionDoctorReportOptions): NextionDoctorReport;
+declare function formatNextionDoctorReport(report: NextionDoctorReport): string;
+
+/**
+ * Public, runtime-driven doctor API. Consumers (the worker bootstrap,
+ * scripts, CI) pass a runtime that exposes binding lookups; the doctor
+ * derives a synthetic wrangler config from it and runs the full report.
+ *
+ * `sources` is a list of project content sources. For now, the doctor
+ * ignores their detailed shape; future phases will surface per-source
+ * data-source status as findings.
+ */
+type DoctorFinding = {
+    code: string;
+    message: string;
+    severity: "info" | "warning" | "error";
+};
+type RuntimeLike = {
+    getBinding(name: string): unknown;
+};
+type RunNextionDoctorOptions = {
+    env: EnvLike;
+    runtime: RuntimeLike;
+    sources: readonly unknown[];
+    wranglerConfig?: WranglerConfigLike | null;
+};
+type NextionDoctorFindingsReport = NextionDoctorReport & {
+    findings: DoctorFinding[];
+};
+declare function runNextionDoctor(options: RunNextionDoctorOptions): NextionDoctorFindingsReport;
+
+export { type ContentModelDefinition, type DoctorFinding, type EnvLike, type NextionDoctorCheck, type NextionDoctorFindingsReport, type NextionDoctorModel, type NextionDoctorReport, type NextionDoctorStatus, type NotionFieldMap, type RunNextionDoctorOptions, type RuntimeLike, type WranglerConfigLike, buildNextionDoctorReport, formatNextionDoctorReport as formatDoctorReport, formatNextionDoctorReport, runNextionDoctor };

package/dist/doctor/index.js

@@ -0,0 +1,289 @@
+// src/platform/capabilities.ts
+var cloudflareWorkersAdapter = {
+  id: "cloudflare-workers",
+  label: "Cloudflare Workers + D1",
+  status: "active",
+  services: {
+    compute: "Cloudflare Workers via vinext",
+    relationalStorage: "D1 through the runtime SQL adapter",
+    objectStorage: "R2",
+    imageOptimization: "Cloudflare Images",
+    cache: "vinext CDN/data adapters and caches.default for media",
+    authStorage: "D1 users and signed cookies"
+  },
+  capabilities: [
+    "server-rendering",
+    "edge-cache",
+    "relational-storage",
+    "object-storage",
+    "image-optimization",
+    "secrets",
+    "observability"
+  ]
+};
+var runtimeAdapters = [cloudflareWorkersAdapter];
+function getRuntimeAdapter(id) {
+  return runtimeAdapters.find((adapter) => adapter.id === id);
+}
+
+// src/platform/selection.ts
+function currentRuntimeId() {
+  return "cloudflare-workers";
+}
+
+// src/doctor/doctor.ts
+function envValue(env, name) {
+  const value = String(env[name] ?? "").trim();
+  return value || void 0;
+}
+function hasEnv(env, name) {
+  return Boolean(envValue(env, name));
+}
+function hasD1Binding(config, binding) {
+  return Boolean(config?.d1_databases?.some((item) => item.binding === binding));
+}
+function hasR2Binding(config, binding) {
+  return Boolean(config?.r2_buckets?.some((item) => item.binding === binding));
+}
+function hasImagesBinding(config, binding) {
+  const images = config?.images;
+  if (Array.isArray(images)) {
+    return images.some((item) => item.binding === binding);
+  }
+  return images?.binding === binding;
+}
+function statusSummary(status) {
+  if (status === "ok") return "ready";
+  if (status === "warn") return "usable with warnings";
+  return "missing required configuration";
+}
+function overallStatus(checks, models) {
+  if (checks.some((check) => check.status === "missing") || models.some((model) => model.dataSourceStatus === "missing")) {
+    return "missing";
+  }
+  if (checks.some((check) => check.status === "warn") || models.some((model) => model.dataSourceStatus === "warn")) {
+    return "warn";
+  }
+  return "ok";
+}
+function cloudflareChecks(config) {
+  return [
+    {
+      id: "runtime.database",
+      label: "SQL database",
+      status: hasD1Binding(config, "DB") ? "ok" : "missing",
+      required: true,
+      detail: hasD1Binding(config, "DB") ? "wrangler D1 binding DB is declared" : "wrangler D1 binding DB is missing",
+      action: "Add a DB binding under d1_databases in wrangler.jsonc."
+    },
+    {
+      id: "runtime.objectStorage",
+      label: "Object storage",
+      status: hasR2Binding(config, "ASSETS_BUCKET") ? "ok" : "warn",
+      required: false,
+      detail: hasR2Binding(config, "ASSETS_BUCKET") ? "wrangler R2 binding ASSETS_BUCKET is declared" : "uploads and persistent media cache need ASSETS_BUCKET",
+      action: "Add an ASSETS_BUCKET R2 binding for uploads and media cache."
+    },
+    {
+      id: "runtime.imageTransformer",
+      label: "Image transformation",
+      status: hasImagesBinding(config, "IMAGES") ? "ok" : "warn",
+      required: false,
+      detail: hasImagesBinding(config, "IMAGES") ? "wrangler Images binding IMAGES is declared" : "Notion media optimization will fall back without IMAGES",
+      action: "Add a Cloudflare Images binding named IMAGES."
+    },
+    {
+      id: "runtime.publicCache",
+      label: "Public cache",
+      status: "ok",
+      required: true,
+      detail: "vinext CDN adapter handles page cache; caches.default remains for media"
+    },
+    {
+      id: "runtime.observability",
+      label: "Observability",
+      status: config?.observability?.enabled ? "ok" : "warn",
+      required: false,
+      detail: config?.observability?.enabled ? "wrangler observability is enabled" : "wrangler observability is not enabled",
+      action: "Enable observability in wrangler.jsonc for production debugging."
+    }
+  ];
+}
+function notionChecks(env) {
+  return [
+    {
+      id: "notion.token",
+      label: "Notion token",
+      status: hasEnv(env, "NOTION_TOKEN") ? "ok" : "missing",
+      required: true,
+      detail: hasEnv(env, "NOTION_TOKEN") ? "NOTION_TOKEN is configured" : "NOTION_TOKEN is missing",
+      action: "Set NOTION_TOKEN to an internal integration token."
+    },
+    {
+      id: "notion.webhook",
+      label: "Notion webhook verification",
+      status: hasEnv(env, "NOTION_WEBHOOK_VERIFICATION_TOKEN") ? "ok" : "warn",
+      required: false,
+      detail: hasEnv(env, "NOTION_WEBHOOK_VERIFICATION_TOKEN") ? "NOTION_WEBHOOK_VERIFICATION_TOKEN is configured" : "instant content invalidation needs NOTION_WEBHOOK_VERIFICATION_TOKEN",
+      action: "Set NOTION_WEBHOOK_VERIFICATION_TOKEN after creating the Notion webhook."
+    }
+  ];
+}
+function modelDoctorStatus(env, model) {
+  const hasConfiguredEnv = hasEnv(env, model.source.dataSourceEnv);
+  const hasDefault = Boolean(model.source.defaultDataSourceId);
+  const dataSourceSource = hasConfiguredEnv ? "env" : hasDefault ? "default" : "missing";
+  const dataSourceStatus = dataSourceSource === "missing" ? "missing" : "ok";
+  return {
+    dataSourceStatus,
+    dataSourceSource
+  };
+}
+function modelChecks(env, models) {
+  return models.map((model) => ({
+    id: model.id,
+    public: model.visibility.public,
+    admin: model.visibility.admin,
+    listPath: model.routes.listPath,
+    detailPath: model.routes.detailPath,
+    publicApiPath: model.routes.publicApiPath,
+    dataSourceEnv: model.source.dataSourceEnv,
+    ...modelDoctorStatus(env, model)
+  }));
+}
+function uniqueActions(checks) {
+  return Array.from(
+    new Set(
+      checks.filter((check) => check.status !== "ok" && check.action).map((check) => check.action)
+    )
+  );
+}
+function omitResolvedActions(check) {
+  if (check.status !== "ok") return check;
+  return {
+    ...check,
+    action: void 0
+  };
+}
+function buildNextionDoctorReport(options = {}) {
+  const env = options.env ?? process.env;
+  const runtimeId = options.runtimeId ?? currentRuntimeId();
+  const adapter = getRuntimeAdapter(runtimeId);
+  const checks = [
+    ...cloudflareChecks(options.wranglerConfig),
+    ...notionChecks(env)
+  ].map(omitResolvedActions);
+  const models = modelChecks(env, options.models ?? []);
+  const status = overallStatus(checks, models);
+  const modelActions = models.filter((model) => model.dataSourceStatus === "missing").map(
+    (model) => `Set ${model.dataSourceEnv} for the ${model.id} content model or add a model defaultDataSourceId.`
+  );
+  return {
+    overall: {
+      status,
+      summary: statusSummary(status)
+    },
+    runtime: {
+      id: runtimeId,
+      label: adapter?.label ?? runtimeId,
+      adapterStatus: adapter?.status ?? "planned"
+    },
+    checks,
+    models,
+    nextSteps: [...uniqueActions(checks), ...modelActions]
+  };
+}
+function formatCheck(check) {
+  const required = check.required ? "required" : "optional";
+  return `  [${check.status}] ${check.label} (${required}) - ${check.detail}`;
+}
+function formatModel(model) {
+  const visibility = [
+    model.public ? "public" : "",
+    model.admin ? "admin" : ""
+  ].filter(Boolean);
+  const source = model.dataSourceSource === "env" ? model.dataSourceEnv : model.dataSourceSource === "default" ? `${model.dataSourceEnv} or model default` : model.dataSourceEnv;
+  return [
+    `  [${model.dataSourceStatus}] ${model.id} (${visibility.join(", ") || "private"})`,
+    `      routes: ${model.listPath}, ${model.detailPath}${model.publicApiPath ? `, ${model.publicApiPath}` : ""}`,
+    `      notion: ${source}`
+  ].join("\n");
+}
+function formatNextionDoctorReport(report) {
+  const lines = [
+    "vinext nextion doctor",
+    "",
+    `Overall: [${report.overall.status}] ${report.overall.summary}`,
+    `Runtime: ${report.runtime.label} (${report.runtime.id}, ${report.runtime.adapterStatus})`,
+    "",
+    "Checks:",
+    ...report.checks.map(formatCheck),
+    "",
+    "Content models:",
+    ...report.models.map(formatModel)
+  ];
+  if (report.nextSteps.length > 0) {
+    lines.push("", "Next steps:");
+    for (const step of report.nextSteps) {
+      lines.push(`  - ${step}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+// src/doctor/index.ts
+function deriveWranglerConfig(runtime) {
+  return {
+    d1_databases: runtime.getBinding("DB") ? [{ binding: "DB" }] : [],
+    r2_buckets: runtime.getBinding("ASSETS_BUCKET") ? [{ binding: "ASSETS_BUCKET" }] : [],
+    images: runtime.getBinding("IMAGES") ? { binding: "IMAGES" } : void 0
+  };
+}
+function checkToFindingCode(checkId) {
+  if (checkId === "runtime.database") return "missing-db-binding";
+  if (checkId === "runtime.objectStorage") return "missing-r2-binding";
+  if (checkId === "runtime.imageTransformer") return "missing-images-binding";
+  if (checkId === "runtime.observability") return "observability-disabled";
+  if (checkId === "notion.token") return "missing-notion-token";
+  if (checkId === "notion.webhook") return "missing-notion-webhook";
+  return checkId;
+}
+function checkToFinding(check) {
+  const severity = check.status === "missing" ? "error" : check.status === "warn" ? "warning" : "info";
+  return {
+    code: checkToFindingCode(check.id),
+    message: check.action ?? check.detail,
+    severity
+  };
+}
+function modelToFinding(model) {
+  if (model.dataSourceStatus !== "missing") return null;
+  return {
+    code: `missing-data-source:${model.id}`,
+    message: `Set ${model.dataSourceEnv} for the ${model.id} content model or add a model defaultDataSourceId.`,
+    severity: "error"
+  };
+}
+function runNextionDoctor(options) {
+  const wranglerConfig = options.wranglerConfig ?? deriveWranglerConfig(options.runtime);
+  const report = buildNextionDoctorReport({
+    env: options.env,
+    wranglerConfig,
+    // Phase 6 will map `sources` (ContentSource[]) to the detailed model
+    // shape used by `buildNextionDoctorReport`. For now, treat the
+    // empty array as the default and rely on binding/env checks.
+    models: []
+  });
+  const findings = [
+    ...report.checks.filter((check) => check.status !== "ok").map(checkToFinding),
+    ...report.models.map(modelToFinding).filter((finding) => finding !== null)
+  ];
+  return { ...report, findings };
+}
+export {
+  buildNextionDoctorReport,
+  formatNextionDoctorReport as formatDoctorReport,
+  formatNextionDoctorReport,
+  runNextionDoctor
+};
+//# sourceMappingURL=index.js.map

package/dist/doctor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/platform/capabilities.ts","../../src/platform/selection.ts","../../src/doctor/doctor.ts","../../src/doctor/index.ts"],"sourcesContent":["import type { RuntimeId } from \"./selection\";\n\nexport type RuntimeCapability =\n  | \"server-rendering\"\n  | \"edge-cache\"\n  | \"relational-storage\"\n  | \"object-storage\"\n  | \"image-optimization\"\n  | \"secrets\"\n  | \"observability\";\n\nexport type RuntimeAdapterDefinition = {\n  id: RuntimeId;\n  label: string;\n  status: \"active\" | \"partial\" | \"planned\";\n  services: {\n    compute: string;\n    relationalStorage: string;\n    objectStorage: string;\n    imageOptimization: string;\n    cache: string;\n    authStorage: string;\n  };\n  capabilities: readonly RuntimeCapability[];\n};\n\nexport type RuntimeServiceStatus = {\n  database: boolean;\n  objectStorage: boolean;\n  imageTransformer: boolean;\n  publicCache: boolean;\n};\n\nexport const cloudflareWorkersAdapter: RuntimeAdapterDefinition = {\n  id: \"cloudflare-workers\",\n  label: \"Cloudflare Workers + D1\",\n  status: \"active\",\n  services: {\n    compute: \"Cloudflare Workers via vinext\",\n    relationalStorage: \"D1 through the runtime SQL adapter\",\n    objectStorage: \"R2\",\n    imageOptimization: \"Cloudflare Images\",\n    cache: \"vinext CDN/data adapters and caches.default for media\",\n    authStorage: \"D1 users and signed cookies\",\n  },\n  capabilities: [\n    \"server-rendering\",\n    \"edge-cache\",\n    \"relational-storage\",\n    \"object-storage\",\n    \"image-optimization\",\n    \"secrets\",\n    \"observability\",\n  ],\n};\n\nexport const runtimeAdapters = [cloudflareWorkersAdapter] as const;\n\nexport function getRuntimeAdapter(id: RuntimeAdapterDefinition[\"id\"]) {\n  return runtimeAdapters.find((adapter) => adapter.id === id);\n}\n\nexport function runtimeServiceStatus(\n  platform: {\n    database: unknown;\n    objectStorage: unknown;\n    imageTransformer: unknown;\n    publicCache: unknown;\n  }\n): RuntimeServiceStatus {\n  return {\n    database: Boolean(platform.database),\n    objectStorage: Boolean(platform.objectStorage),\n    imageTransformer: Boolean(platform.imageTransformer),\n    publicCache: Boolean(platform.publicCache),\n  };\n}\n","export type RuntimeId = \"cloudflare-workers\";\n\nexport type RuntimeKind = \"cloudflare\";\n\nexport interface RuntimeSelection {\n  kind: RuntimeKind;\n  runtimeId: RuntimeId;\n}\n\nfunction hasCloudflareBindings(env: unknown): boolean {\n  if (!env || typeof env !== \"object\") return false;\n  const record = env as Record<string, unknown>;\n  return (\n    \"DB\" in record ||\n    \"ASSETS_BUCKET\" in record ||\n    \"R2\" in record ||\n    \"IMAGES\" in record ||\n    \"CONTENT_CACHE\" in record\n  );\n}\n\nexport function selectRuntime(env: unknown): RuntimeSelection {\n  if (hasCloudflareBindings(env)) {\n    return { kind: \"cloudflare\", runtimeId: \"cloudflare-workers\" };\n  }\n  throw new Error(\n    \"No supported runtime detected. Expected Cloudflare Workers bindings \" +\n      \"(DB, ASSETS_BUCKET, R2, IMAGES, or CONTENT_CACHE).\",\n  );\n}\n\nexport function currentRuntimeId(): RuntimeId {\n  return \"cloudflare-workers\";\n}\n","import type { ContentModelDefinition, NotionFieldMap } from \"./model\";\nimport {\n  getRuntimeAdapter,\n  type RuntimeAdapterDefinition,\n} from \"../platform/capabilities\";\nimport { currentRuntimeId, type RuntimeId } from \"../platform/selection\";\n\nexport type NextionDoctorStatus = \"ok\" | \"warn\" | \"missing\";\n\nexport type EnvLike = Record<string, string | undefined>;\n\nexport type WranglerConfigLike = {\n  vars?: EnvLike;\n  d1_databases?: Array<{ binding?: string }>;\n  r2_buckets?: Array<{ binding?: string }>;\n  images?: { binding?: string } | Array<{ binding?: string }>;\n  observability?: { enabled?: boolean };\n};\n\nexport type NextionDoctorCheck = {\n  id: string;\n  label: string;\n  status: NextionDoctorStatus;\n  required: boolean;\n  detail: string;\n  action?: string;\n};\n\nexport type NextionDoctorModel = {\n  id: string;\n  public: boolean;\n  admin: boolean;\n  listPath: string;\n  detailPath: string;\n  publicApiPath?: string;\n  dataSourceEnv: string;\n  dataSourceStatus: NextionDoctorStatus;\n  dataSourceSource: \"env\" | \"default\" | \"missing\";\n};\n\nexport type NextionDoctorReport = {\n  overall: {\n    status: NextionDoctorStatus;\n    summary: string;\n  };\n  runtime: {\n    id: RuntimeId;\n    label: string;\n    adapterStatus: RuntimeAdapterDefinition[\"status\"];\n  };\n  checks: NextionDoctorCheck[];\n  models: NextionDoctorModel[];\n  nextSteps: string[];\n};\n\ntype BuildNextionDoctorReportOptions = {\n  env?: EnvLike;\n  runtimeId?: RuntimeId;\n  wranglerConfig?: WranglerConfigLike | null;\n  models?: readonly ContentModelDefinition<NotionFieldMap>[];\n};\n\nfunction envValue(env: EnvLike, name: string) {\n  const value = String(env[name] ?? \"\").trim();\n  return value || undefined;\n}\n\nfunction hasEnv(env: EnvLike, name: string) {\n  return Boolean(envValue(env, name));\n}\n\nfunction hasD1Binding(config: WranglerConfigLike | null | undefined, binding: string) {\n  return Boolean(config?.d1_databases?.some((item) => item.binding === binding));\n}\n\nfunction hasR2Binding(config: WranglerConfigLike | null | undefined, binding: string) {\n  return Boolean(config?.r2_buckets?.some((item) => item.binding === binding));\n}\n\nfunction hasImagesBinding(\n  config: WranglerConfigLike | null | undefined,\n  binding: string\n) {\n  const images = config?.images;\n  if (Array.isArray(images)) {\n    return images.some((item) => item.binding === binding);\n  }\n  return images?.binding === binding;\n}\n\nfunction statusSummary(status: NextionDoctorStatus) {\n  if (status === \"ok\") return \"ready\";\n  if (status === \"warn\") return \"usable with warnings\";\n  return \"missing required configuration\";\n}\n\nfunction overallStatus(\n  checks: readonly NextionDoctorCheck[],\n  models: readonly NextionDoctorModel[]\n): NextionDoctorStatus {\n  if (\n    checks.some((check) => check.status === \"missing\") ||\n    models.some((model) => model.dataSourceStatus === \"missing\")\n  ) {\n    return \"missing\";\n  }\n\n  if (\n    checks.some((check) => check.status === \"warn\") ||\n    models.some((model) => model.dataSourceStatus === \"warn\")\n  ) {\n    return \"warn\";\n  }\n\n  return \"ok\";\n}\n\nfunction cloudflareChecks(\n  config: WranglerConfigLike | null | undefined\n): NextionDoctorCheck[] {\n  return [\n    {\n      id: \"runtime.database\",\n      label: \"SQL database\",\n      status: hasD1Binding(config, \"DB\") ? \"ok\" : \"missing\",\n      required: true,\n      detail: hasD1Binding(config, \"DB\")\n        ? \"wrangler D1 binding DB is declared\"\n        : \"wrangler D1 binding DB is missing\",\n      action: \"Add a DB binding under d1_databases in wrangler.jsonc.\",\n    },\n    {\n      id: \"runtime.objectStorage\",\n      label: \"Object storage\",\n      status: hasR2Binding(config, \"ASSETS_BUCKET\") ? \"ok\" : \"warn\",\n      required: false,\n      detail: hasR2Binding(config, \"ASSETS_BUCKET\")\n        ? \"wrangler R2 binding ASSETS_BUCKET is declared\"\n        : \"uploads and persistent media cache need ASSETS_BUCKET\",\n      action: \"Add an ASSETS_BUCKET R2 binding for uploads and media cache.\",\n    },\n    {\n      id: \"runtime.imageTransformer\",\n      label: \"Image transformation\",\n      status: hasImagesBinding(config, \"IMAGES\") ? \"ok\" : \"warn\",\n      required: false,\n      detail: hasImagesBinding(config, \"IMAGES\")\n        ? \"wrangler Images binding IMAGES is declared\"\n        : \"Notion media optimization will fall back without IMAGES\",\n      action: \"Add a Cloudflare Images binding named IMAGES.\",\n    },\n    {\n      id: \"runtime.publicCache\",\n      label: \"Public cache\",\n      status: \"ok\",\n      required: true,\n      detail: \"vinext CDN adapter handles page cache; caches.default remains for media\",\n    },\n    {\n      id: \"runtime.observability\",\n      label: \"Observability\",\n      status: config?.observability?.enabled ? \"ok\" : \"warn\",\n      required: false,\n      detail: config?.observability?.enabled\n        ? \"wrangler observability is enabled\"\n        : \"wrangler observability is not enabled\",\n      action: \"Enable observability in wrangler.jsonc for production debugging.\",\n    },\n  ];\n}\n\nfunction notionChecks(env: EnvLike): NextionDoctorCheck[] {\n  return [\n    {\n      id: \"notion.token\",\n      label: \"Notion token\",\n      status: hasEnv(env, \"NOTION_TOKEN\") ? \"ok\" : \"missing\",\n      required: true,\n      detail: hasEnv(env, \"NOTION_TOKEN\")\n        ? \"NOTION_TOKEN is configured\"\n        : \"NOTION_TOKEN is missing\",\n      action: \"Set NOTION_TOKEN to an internal integration token.\",\n    },\n    {\n      id: \"notion.webhook\",\n      label: \"Notion webhook verification\",\n      status: hasEnv(env, \"NOTION_WEBHOOK_VERIFICATION_TOKEN\") ? \"ok\" : \"warn\",\n      required: false,\n      detail: hasEnv(env, \"NOTION_WEBHOOK_VERIFICATION_TOKEN\")\n        ? \"NOTION_WEBHOOK_VERIFICATION_TOKEN is configured\"\n        : \"instant content invalidation needs NOTION_WEBHOOK_VERIFICATION_TOKEN\",\n      action:\n        \"Set NOTION_WEBHOOK_VERIFICATION_TOKEN after creating the Notion webhook.\",\n    },\n  ];\n}\n\nfunction modelDoctorStatus(\n  env: EnvLike,\n  model: ContentModelDefinition<NotionFieldMap>\n): Pick<NextionDoctorModel, \"dataSourceStatus\" | \"dataSourceSource\"> {\n  const hasConfiguredEnv = hasEnv(env, model.source.dataSourceEnv);\n  const hasDefault = Boolean(model.source.defaultDataSourceId);\n  const dataSourceSource = hasConfiguredEnv\n    ? \"env\"\n    : hasDefault\n      ? \"default\"\n      : \"missing\";\n  const dataSourceStatus = dataSourceSource === \"missing\" ? \"missing\" : \"ok\";\n\n  return {\n    dataSourceStatus,\n    dataSourceSource,\n  };\n}\n\nfunction modelChecks(\n  env: EnvLike,\n  models: readonly ContentModelDefinition<NotionFieldMap>[]\n): NextionDoctorModel[] {\n  return models.map((model) => ({\n    id: model.id,\n    public: model.visibility.public,\n    admin: model.visibility.admin,\n    listPath: model.routes.listPath,\n    detailPath: model.routes.detailPath,\n    publicApiPath: model.routes.publicApiPath,\n    dataSourceEnv: model.source.dataSourceEnv,\n    ...modelDoctorStatus(env, model),\n  }));\n}\n\nfunction uniqueActions(checks: readonly NextionDoctorCheck[]) {\n  return Array.from(\n    new Set(\n      checks\n        .filter((check) => check.status !== \"ok\" && check.action)\n        .map((check) => check.action as string)\n    )\n  );\n}\n\nfunction omitResolvedActions(check: NextionDoctorCheck): NextionDoctorCheck {\n  if (check.status !== \"ok\") return check;\n  return {\n    ...check,\n    action: undefined,\n  };\n}\n\nexport function buildNextionDoctorReport(\n  options: BuildNextionDoctorReportOptions = {}\n): NextionDoctorReport {\n  const env = options.env ?? process.env;\n  const runtimeId = options.runtimeId ?? currentRuntimeId();\n  const adapter = getRuntimeAdapter(runtimeId);\n  const checks = [\n    ...cloudflareChecks(options.wranglerConfig),\n    ...notionChecks(env),\n  ].map(omitResolvedActions);\n  const models = modelChecks(env, options.models ?? []);\n  const status = overallStatus(checks, models);\n  const modelActions = models\n    .filter((model) => model.dataSourceStatus === \"missing\")\n    .map(\n      (model) =>\n        `Set ${model.dataSourceEnv} for the ${model.id} content model or add a model defaultDataSourceId.`\n    );\n\n  return {\n    overall: {\n      status,\n      summary: statusSummary(status),\n    },\n    runtime: {\n      id: runtimeId,\n      label: adapter?.label ?? runtimeId,\n      adapterStatus: adapter?.status ?? \"planned\",\n    },\n    checks,\n    models,\n    nextSteps: [...uniqueActions(checks), ...modelActions],\n  };\n}\n\nfunction formatCheck(check: NextionDoctorCheck) {\n  const required = check.required ? \"required\" : \"optional\";\n  return `  [${check.status}] ${check.label} (${required}) - ${check.detail}`;\n}\n\nfunction formatModel(model: NextionDoctorModel) {\n  const visibility = [\n    model.public ? \"public\" : \"\",\n    model.admin ? \"admin\" : \"\",\n  ].filter(Boolean);\n  const source =\n    model.dataSourceSource === \"env\"\n      ? model.dataSourceEnv\n      : model.dataSourceSource === \"default\"\n        ? `${model.dataSourceEnv} or model default`\n        : model.dataSourceEnv;\n\n  return [\n    `  [${model.dataSourceStatus}] ${model.id} (${visibility.join(\", \") || \"private\"})`,\n    `      routes: ${model.listPath}, ${model.detailPath}${\n      model.publicApiPath ? `, ${model.publicApiPath}` : \"\"\n    }`,\n    `      notion: ${source}`,\n  ].join(\"\\n\");\n}\n\nexport function formatNextionDoctorReport(report: NextionDoctorReport) {\n  const lines = [\n    \"vinext nextion doctor\",\n    \"\",\n    `Overall: [${report.overall.status}] ${report.overall.summary}`,\n    `Runtime: ${report.runtime.label} (${report.runtime.id}, ${report.runtime.adapterStatus})`,\n    \"\",\n    \"Checks:\",\n    ...report.checks.map(formatCheck),\n    \"\",\n    \"Content models:\",\n    ...report.models.map(formatModel),\n  ];\n\n  if (report.nextSteps.length > 0) {\n    lines.push(\"\", \"Next steps:\");\n    for (const step of report.nextSteps) {\n      lines.push(`  - ${step}`);\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n","// Re-export the detailed report builder used by the CLI and starter tests.\nexport {\n  buildNextionDoctorReport,\n  formatNextionDoctorReport,\n} from \"./doctor\";\nexport type {\n  NextionDoctorCheck,\n  NextionDoctorModel,\n  NextionDoctorReport,\n  NextionDoctorStatus,\n  EnvLike,\n  WranglerConfigLike,\n} from \"./doctor\";\nexport type { ContentModelDefinition, NotionFieldMap } from \"./model\";\n\nimport {\n  buildNextionDoctorReport,\n  formatNextionDoctorReport,\n  type EnvLike,\n  type NextionDoctorReport,\n  type WranglerConfigLike,\n} from \"./doctor\";\n\n/**\n * Public, runtime-driven doctor API. Consumers (the worker bootstrap,\n * scripts, CI) pass a runtime that exposes binding lookups; the doctor\n * derives a synthetic wrangler config from it and runs the full report.\n *\n * `sources` is a list of project content sources. For now, the doctor\n * ignores their detailed shape; future phases will surface per-source\n * data-source status as findings.\n */\nexport type DoctorFinding = {\n  code: string;\n  message: string;\n  severity: \"info\" | \"warning\" | \"error\";\n};\n\nexport type RuntimeLike = {\n  getBinding(name: string): unknown;\n};\n\nexport type RunNextionDoctorOptions = {\n  env: EnvLike;\n  runtime: RuntimeLike;\n  sources: readonly unknown[];\n  wranglerConfig?: WranglerConfigLike | null;\n};\n\nexport type NextionDoctorFindingsReport = NextionDoctorReport & {\n  findings: DoctorFinding[];\n};\n\nfunction deriveWranglerConfig(runtime: RuntimeLike): WranglerConfigLike {\n  return {\n    d1_databases: runtime.getBinding(\"DB\") ? [{ binding: \"DB\" }] : [],\n    r2_buckets: runtime.getBinding(\"ASSETS_BUCKET\")\n      ? [{ binding: \"ASSETS_BUCKET\" }]\n      : [],\n    images: runtime.getBinding(\"IMAGES\") ? { binding: \"IMAGES\" } : undefined,\n  };\n}\n\nfunction checkToFindingCode(checkId: string): string {\n  if (checkId === \"runtime.database\") return \"missing-db-binding\";\n  if (checkId === \"runtime.objectStorage\") return \"missing-r2-binding\";\n  if (checkId === \"runtime.imageTransformer\") return \"missing-images-binding\";\n  if (checkId === \"runtime.observability\") return \"observability-disabled\";\n  if (checkId === \"notion.token\") return \"missing-notion-token\";\n  if (checkId === \"notion.webhook\") return \"missing-notion-webhook\";\n  return checkId;\n}\n\nfunction checkToFinding(check: import(\"./doctor\").NextionDoctorCheck): DoctorFinding {\n  const severity: DoctorFinding[\"severity\"] =\n    check.status === \"missing\" ? \"error\" : check.status === \"warn\" ? \"warning\" : \"info\";\n  return {\n    code: checkToFindingCode(check.id),\n    message: check.action ?? check.detail,\n    severity,\n  };\n}\n\nfunction modelToFinding(\n  model: import(\"./doctor\").NextionDoctorModel\n): DoctorFinding | null {\n  if (model.dataSourceStatus !== \"missing\") return null;\n  return {\n    code: `missing-data-source:${model.id}`,\n    message: `Set ${model.dataSourceEnv} for the ${model.id} content model or add a model defaultDataSourceId.`,\n    severity: \"error\",\n  };\n}\n\nexport function runNextionDoctor(\n  options: RunNextionDoctorOptions\n): NextionDoctorFindingsReport {\n  const wranglerConfig = options.wranglerConfig ?? deriveWranglerConfig(options.runtime);\n  const report = buildNextionDoctorReport({\n    env: options.env,\n    wranglerConfig,\n    // Phase 6 will map `sources` (ContentSource[]) to the detailed model\n    // shape used by `buildNextionDoctorReport`. For now, treat the\n    // empty array as the default and rely on binding/env checks.\n    models: [],\n  });\n  const findings: DoctorFinding[] = [\n    ...report.checks\n      .filter((check) => check.status !== \"ok\")\n      .map(checkToFinding),\n    ...report.models\n      .map(modelToFinding)\n      .filter((finding): finding is DoctorFinding => finding !== null),\n  ];\n  return { ...report, findings };\n}\n\nexport { formatNextionDoctorReport as formatDoctorReport };\n"],"mappings":"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","names":[]}

package/dist/email/index.d.ts

@@ -0,0 +1,38 @@
+type SendArgs = {
+    to: string | string[];
+    subject: string;
+    html: string;
+    text?: string;
+    replyTo?: string;
+};
+/**
+ * Send an email. When RESEND_API_KEY is not set (the dev default), the
+ * call is silently skipped with a log line instead of failing. Returns
+ * the Resend message id, or null when no-op. Throws on a Resend error.
+ */
+declare function sendEmail(args: SendArgs): Promise<string | null>;
+/** Welcome email for new newsletter subscribers. */
+declare function welcomeEmailHtml(opts: {
+    email: string;
+    unsubscribeUrl: string;
+    siteUrl: string;
+}): string;
+declare function resetPasswordHtml(opts: {
+    resetUrl: string;
+    siteUrl: string;
+    email: string;
+}): string;
+declare function verifyEmailHtml(opts: {
+    verifyUrl: string;
+    siteUrl: string;
+    email: string;
+}): string;
+/** New post notification email. */
+declare function newPostEmailHtml(opts: {
+    title: string;
+    description: string;
+    url: string;
+    unsubscribeUrl: string;
+}): string;
+
+export { newPostEmailHtml, resetPasswordHtml, sendEmail, verifyEmailHtml, welcomeEmailHtml };