@krantho/config 0.0.0-stage → 1.0.0

package/dist/public.js

@@ -0,0 +1,65 @@
+/**
+ * The browser-safe half of the package, published as `@krantho/config/public`.
+ *
+ * Nothing here — or in anything it imports — may reach for a Node built-in, so
+ * a client bundle can import it without pulling in the resolver.
+ */
+import { SECRET_PATHS } from './leaves.js';
+import { getPath, setPath } from './object-path.js';
+/** Placeholder written where a secret's value would be */
+export const REDACTED = '[redacted]';
+/** Project the resolved tree down to what is safe to serialize into a page */
+export function toPublicConfig(config) {
+    return {
+        site: {
+            domain: config.site.domain,
+            name: config.site.name,
+            language: config.site.language,
+            baseUrl: config.site.baseUrl,
+            supportedLocales: [...config.site.supportedLocales],
+            defaultLocale: config.site.defaultLocale,
+            ...(config.site.logo ? { logo: config.site.logo } : {}),
+            ...(config.site.description ? { description: config.site.description } : {}),
+            ...(config.site.alternateName ? { alternateName: config.site.alternateName } : {}),
+            sameAs: [...config.site.sameAs],
+        },
+        seo: {
+            limits: {
+                metaDescription: {
+                    minChars: config.seo.enrichment.meta.minChars,
+                    maxChars: config.seo.enrichment.meta.maxChars,
+                },
+                title: { maxChars: config.seo.enrichment.title.maxChars },
+            },
+            readers: [...config.seo.readers],
+        },
+        cache: {
+            pages: config.cache.pages,
+            shared: config.cache.shared,
+        },
+        features: {
+            media: config.media.provider !== undefined,
+            localization: config.site.supportedLocales.length > 1,
+        },
+    };
+}
+/**
+ * The whole tree with every secret replaced by {@link REDACTED} and the
+ * resolution metadata dropped — safe to log or to return to an authenticated
+ * operator, never to an anonymous browser.
+ */
+export function redact(config) {
+    const { sources: _sources, ...tree } = config;
+    const clone = structuredClone(tree);
+    for (const path of SECRET_PATHS) {
+        if (getPath(clone, path) !== undefined)
+            setPath(clone, path, REDACTED);
+    }
+    // A webhook's secret sits inside a list, which no dotted path reaches
+    for (const hook of clone['webhooks']) {
+        if (hook.secret !== undefined)
+            hook.secret = REDACTED;
+    }
+    return clone;
+}
+//# sourceMappingURL=public.js.map

package/dist/public.js.map

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

package/dist/reference.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Render the whole configuration reference as markdown.
+ *
+ * This is the source of `docs/configuration.md`; regenerate it whenever a leaf
+ * is added, renamed or given a different default.
+ */
+export declare function envReference(): string;
+//# sourceMappingURL=reference.d.ts.map

package/dist/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAgGA;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAmBrC"}

package/dist/reference.js

@@ -0,0 +1,117 @@
+import { DEFAULTS } from './defaults.js';
+import { envNameFor, LEAVES } from './leaves.js';
+import { getPath } from './object-path.js';
+/** Leaves whose default is computed from another leaf rather than written down */
+const DERIVED_DEFAULTS = {
+    'site.supportedLocales': 'the primary language alone',
+    'site.defaultLocale': 'the primary language',
+    'paths.seoGeneratedDir': '`<paths.contentDir>/seo/generated`',
+    'persistence.sqlite.path': '`<paths.dataDir>/content.db`',
+    'persistence.filesystem.contentPath': '`<paths.contentDir>`',
+    'media.s3.publicUrl': '`https://<media.s3.bucket>.s3.<media.s3.region>.amazonaws.com` when media.s3.endpoint is unset',
+    'media.gcs.publicUrl': '`https://storage.googleapis.com/<media.gcs.bucket>`',
+};
+const SECTION_TITLES = {
+    site: 'Site identity',
+    paths: 'Paths',
+    persistence: 'Persistence',
+    content: 'Content engine',
+    cache: 'Page cache',
+    auth: 'Authentication',
+    media: 'Media and images',
+    llm: 'Language model',
+    assistant: 'Studio assistant',
+    seo: 'SEO',
+    webhooks: 'Webhooks',
+    tools: 'Build-time tools',
+};
+const KIND_LABELS = {
+    string: 'string',
+    int: 'integer',
+    boolean: 'boolean',
+    list: 'comma-separated list',
+    structured: 'structured',
+};
+function renderValue(value) {
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '`[]`';
+        return value.map((entry) => `\`${String(entry)}\``).join(', ');
+    }
+    if (value !== null && typeof value === 'object')
+        return `\`${JSON.stringify(value)}\``;
+    return `\`${String(value)}\``;
+}
+function renderDefault(leaf) {
+    const derived = DERIVED_DEFAULTS[leaf.path];
+    if (derived)
+        return derived;
+    const value = getPath(DEFAULTS, leaf.path);
+    if (value === undefined)
+        return 'unset';
+    return renderValue(value);
+}
+function renderRow(leaf) {
+    const env = envNameFor(leaf);
+    const variable = env === null ? 'code only' : `\`${env}\``;
+    const secret = leaf.secret ? ' **Secret.**' : '';
+    const cells = [
+        variable,
+        `\`${leaf.path}\``,
+        KIND_LABELS[leaf.kind],
+        renderDefault(leaf),
+        `${leaf.description}${secret}`,
+    ];
+    return `| ${cells.join(' | ')} |`;
+}
+const PREAMBLE = `# Configuration reference
+
+Every knob krantho reads, where it lives in \`krantho.config.ts\`, and the
+environment variable that overrides it.
+
+Values resolve in one pass at startup: **defaults, then code, then the
+environment**. The environment wins. Every problem found — a bad value, a
+missing required field, a rule spanning two leaves — is reported together in a
+single startup error naming each variable and path.
+
+Notes that apply to the whole table:
+
+- A variable set to an empty string counts as unset.
+- A **secret** leaf also accepts a \`_FILE\` suffix — \`KRANTHO_LLM_ANTHROPIC_API_KEY_FILE\`
+  names a file whose trimmed contents become the value. The variable itself
+  wins when both are set. Secrets never reach a browser and are replaced by
+  \`[redacted]\` in any dump of the tree.
+- A **comma-separated list** splits on commas and trims each entry.
+- A **boolean** accepts \`true\`/\`false\`, \`1\`/\`0\`, \`yes\`/\`no\` and \`on\`/\`off\`.
+- A **structured** leaf holds nested data and is set in code only.
+- Relative filesystem paths resolve against the working directory.
+
+<!-- Generated by envReference() in @krantho/config. Do not edit by hand. -->
+`;
+/**
+ * Render the whole configuration reference as markdown.
+ *
+ * This is the source of `docs/configuration.md`; regenerate it whenever a leaf
+ * is added, renamed or given a different default.
+ */
+export function envReference() {
+    const sections = new Map();
+    for (const leaf of LEAVES) {
+        const section = leaf.path.split('.')[0] ?? leaf.path;
+        const bucket = sections.get(section);
+        if (bucket)
+            bucket.push(leaf);
+        else
+            sections.set(section, [leaf]);
+    }
+    const blocks = [PREAMBLE];
+    for (const [section, leaves] of sections) {
+        blocks.push(`## ${SECTION_TITLES[section] ?? section}\n`);
+        blocks.push('| Variable | Path | Type | Default | Description |');
+        blocks.push('| --- | --- | --- | --- | --- |');
+        blocks.push(leaves.map(renderRow).join('\n'));
+        blocks.push('');
+    }
+    return `${blocks.join('\n')}`;
+}
+//# sourceMappingURL=reference.js.map

package/dist/reference.js.map

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

package/dist/resolve.d.ts

@@ -0,0 +1,27 @@
+import type { KranthoConfig, KranthoConfigInput, PersistenceSection, SeoDefinitions } from './types.js';
+/** Knobs the resolver itself takes — not part of the configuration tree */
+export interface ResolveOptions {
+    /** Directory relative paths resolve against. Defaults to the working directory. */
+    cwd?: string | undefined;
+}
+/**
+ * Resolve the configuration tree: defaults, then the developer's code, then the
+ * environment. Every problem — a bad environment value, a leaf that fails
+ * validation, a rule spanning two leaves — is collected and thrown as one
+ * {@link KranthoConfigError} naming each variable and path.
+ *
+ * Call it once, at startup.
+ */
+export declare function resolveConfig(code?: KranthoConfigInput, env?: Record<string, string | undefined>, options?: ResolveOptions): KranthoConfig;
+/** No SEO definition files — what the pure resolver, which reads no files, gives */
+export declare function emptySeoDefinitions(): SeoDefinitions;
+/**
+ * Resolve only the persistence section, from the defaults and the environment.
+ *
+ * For a process that opens the database without access to `krantho.config.ts`
+ * — the shared Next.js cache handler, which Next loads by path. Values set in
+ * code are not seen, so a deployment that needs one sets its variable. Throws
+ * a {@link KranthoConfigError} like {@link resolveConfig}.
+ */
+export declare function resolvePersistence(env?: Record<string, string | undefined>, options?: ResolveOptions): PersistenceSection;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAEV,aAAa,EACb,kBAAkB,EAElB,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAA;AAEnB,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACzB;AA8BD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,GAAE,kBAAuB,EAC7B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAM,EAC5C,OAAO,GAAE,cAAmB,GAC3B,aAAa,CA0Bf;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,IAAI,cAAc,CAEpD;AAOD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAM,EAC5C,OAAO,GAAE,cAAmB,GAC3B,kBAAkB,CAkBpB"}

package/dist/resolve.js

@@ -0,0 +1,87 @@
+import { DEFAULTS } from './defaults.js';
+import { derive, suppliedPaths } from './derive.js';
+import { buildEnvOverlay } from './env.js';
+import { KranthoConfigError } from './errors.js';
+import { LEAVES } from './leaves.js';
+import { deepMerge } from './object-path.js';
+import { crossFieldIssues, kranthoConfigSchema, persistenceIssues, persistenceTreeSchema, } from './schema.js';
+function renderZodIssue(issue, origins) {
+    const path = issue.path.map(String).join('.');
+    const envName = origins.get(path);
+    const label = path === '' ? '(root)' : path;
+    return envName ? `${envName} (${label}): ${issue.message}` : `${label}: ${issue.message}`;
+}
+function computeSources(code, origins) {
+    const codePaths = suppliedPaths(code);
+    const sources = new Map();
+    for (const leaf of LEAVES) {
+        if (origins.has(leaf.path)) {
+            sources.set(leaf.path, 'env');
+            continue;
+        }
+        const fromCode = codePaths.some((path) => path === leaf.path || path.startsWith(`${leaf.path}.`));
+        sources.set(leaf.path, fromCode ? 'code' : 'default');
+    }
+    return sources;
+}
+/**
+ * Resolve the configuration tree: defaults, then the developer's code, then the
+ * environment. Every problem — a bad environment value, a leaf that fails
+ * validation, a rule spanning two leaves — is collected and thrown as one
+ * {@link KranthoConfigError} naming each variable and path.
+ *
+ * Call it once, at startup.
+ */
+export function resolveConfig(code = {}, env = {}, options = {}) {
+    const overlay = buildEnvOverlay(env);
+    const withCode = deepMerge(DEFAULTS, code);
+    const merged = deepMerge(withCode, overlay.values);
+    const cwd = options.cwd ?? process.cwd();
+    const derived = derive(merged, cwd);
+    const parsed = kranthoConfigSchema.safeParse(derived);
+    const issues = overlay.issues.map((issue) => `${issue.env} (${issue.path}): ${issue.message}`);
+    if (!parsed.success) {
+        issues.push(...parsed.error.issues.map((issue) => renderZodIssue(issue, overlay.origins)));
+        throw new KranthoConfigError(issues);
+    }
+    issues.push(...crossFieldIssues(parsed.data));
+    if (issues.length > 0)
+        throw new KranthoConfigError(issues);
+    const tree = parsed.data;
+    return {
+        ...tree,
+        seo: { ...tree.seo, definitions: emptySeoDefinitions() },
+        sources: computeSources(code, overlay.origins),
+    };
+}
+/** No SEO definition files — what the pure resolver, which reads no files, gives */
+export function emptySeoDefinitions() {
+    return { site: null, collections: {}, routes: {} };
+}
+/** Leaves {@link resolvePersistence} reads — the paths the database location derives from, and the backend */
+const PERSISTENCE_LEAVES = LEAVES.filter((leaf) => leaf.path.startsWith('paths.') || leaf.path.startsWith('persistence.'));
+/**
+ * Resolve only the persistence section, from the defaults and the environment.
+ *
+ * For a process that opens the database without access to `krantho.config.ts`
+ * — the shared Next.js cache handler, which Next loads by path. Values set in
+ * code are not seen, so a deployment that needs one sets its variable. Throws
+ * a {@link KranthoConfigError} like {@link resolveConfig}.
+ */
+export function resolvePersistence(env = {}, options = {}) {
+    const overlay = buildEnvOverlay(env, PERSISTENCE_LEAVES);
+    const defaults = { paths: DEFAULTS.paths, persistence: DEFAULTS.persistence };
+    const merged = deepMerge(defaults, overlay.values);
+    const derived = derive(merged, options.cwd ?? process.cwd());
+    const parsed = persistenceTreeSchema.safeParse(derived);
+    const issues = overlay.issues.map((issue) => `${issue.env} (${issue.path}): ${issue.message}`);
+    if (!parsed.success) {
+        issues.push(...parsed.error.issues.map((issue) => renderZodIssue(issue, overlay.origins)));
+        throw new KranthoConfigError(issues);
+    }
+    issues.push(...persistenceIssues(parsed.data.persistence));
+    if (issues.length > 0)
+        throw new KranthoConfigError(issues);
+    return parsed.data.persistence;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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