@krantho/config 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Descoped
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/defaults.d.ts

@@ -0,0 +1,15 @@
+import type { KranthoConfigInput } from './types.js';
+/**
+ * Every default in the tree, in one place.
+ *
+ * Each value reproduces what the code did before the tree existed, so a site
+ * that sets nothing behaves exactly as it did. `site.domain`, `site.name`,
+ * `site.language` and `site.baseUrl` have no default — they identify the site
+ * and must come from code or the environment. `media.provider` has no default:
+ * media is off until a file store is chosen. `site.supportedLocales`,
+ * `site.defaultLocale`, `paths.seoGeneratedDir`, `persistence.sqlite.path`,
+ * `persistence.filesystem.contentPath`, `media.s3.publicUrl` and
+ * `media.gcs.publicUrl` are derived from other leaves; see `derive.ts`.
+ */
+export declare const DEFAULTS: KranthoConfigInput;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,EAAE,kBAsItB,CAAA"}

package/dist/defaults.js

@@ -0,0 +1,148 @@
+/**
+ * Every default in the tree, in one place.
+ *
+ * Each value reproduces what the code did before the tree existed, so a site
+ * that sets nothing behaves exactly as it did. `site.domain`, `site.name`,
+ * `site.language` and `site.baseUrl` have no default — they identify the site
+ * and must come from code or the environment. `media.provider` has no default:
+ * media is off until a file store is chosen. `site.supportedLocales`,
+ * `site.defaultLocale`, `paths.seoGeneratedDir`, `persistence.sqlite.path`,
+ * `persistence.filesystem.contentPath`, `media.s3.publicUrl` and
+ * `media.gcs.publicUrl` are derived from other leaves; see `derive.ts`.
+ */
+export const DEFAULTS = {
+    site: { sameAs: [] },
+    paths: {
+        dataDir: '.krantho',
+        contentDir: 'content',
+    },
+    persistence: {
+        provider: 'sqlite',
+        sqlite: { busyTimeoutMs: 10000, walRetries: 10, walRetryDelayMs: 50 },
+        postgres: {},
+        filesystem: {},
+    },
+    content: {
+        cache: { enabled: true, ttlMs: 300000, maxEntries: 100 },
+        atNotation: true,
+        watch: false,
+        defaultStatus: { filesystem: 'published' },
+        list: {},
+        search: { minQueryLength: 2, defaultLimit: 200, maxLimit: 500 },
+        versions: { keep: 10 },
+        lock: { leaseMs: 300000 },
+    },
+    cache: {
+        pages: 'none',
+        cdn: {
+            provider: 'none',
+            sMaxAgeSec: 86400,
+            staleWhileRevalidateSec: 604800,
+            tagHeader: 'x-krantho-cache-tag',
+            cloudfront: {},
+            gcp: {},
+        },
+        shared: 'none',
+    },
+    auth: {
+        mode: 'none',
+        requireAuthForReads: false,
+        token: { email: 'admin@local', role: 'admin' },
+        oidc: {
+            postLogoutUri: '/studio/',
+            scopes: ['openid', 'email', 'profile'],
+            signup: 'closed',
+            studioEntry: 'login',
+            adminEmails: [],
+            newUserRole: 'viewer',
+        },
+        workload: { subjects: [] },
+        session: {
+            accessTtlSec: 900,
+            refreshTtlSec: 2592000,
+            cookiePrefix: 'krantho',
+            secure: 'auto',
+            sameSite: 'lax',
+        },
+        trustProxy: false,
+    },
+    secrets: { provider: 'local', local: {} },
+    media: {
+        local: { dir: 'public/uploads', urlPrefix: '/uploads' },
+        vercelBlob: {},
+        s3: { forcePathStyle: false },
+        gcs: {},
+        maxFileSize: 10485760,
+        allowedMimeTypes: [
+            'image/jpeg',
+            'image/png',
+            'image/gif',
+            'image/webp',
+            'image/avif',
+            'image/svg+xml',
+        ],
+        image: {
+            maxWidth: 2048,
+            quality: { jpeg: 82, webp: 80, avif: 65, normalize: 85 },
+            presets: { xs: 48, sm: 96, md: 256, lg: 512, xl: 1024, full: null },
+            cache: { maxEntries: 1000, maxMb: 256, ttiSec: 3600 },
+        },
+    },
+    llm: {
+        provider: 'anthropic',
+        anthropic: {},
+        openai: {},
+        gemini: {},
+        openrouter: {},
+        claudeCode: {},
+        profiles: {},
+    },
+    assistant: {
+        enabled: false,
+        role: 'editor',
+        confirmTtlSec: 600,
+        limits: {
+            maxTurns: 8,
+            maxToolCalls: 16,
+            maxTokens: 16000,
+            maxRequestTokens: 200000,
+            maxHistoryMessages: 40,
+            maxInputChars: 60000,
+            toolResultChars: 12000,
+        },
+    },
+    seo: {
+        collections: {},
+        routes: {},
+        richCollections: {},
+        richRoutes: {},
+        seedMode: 'seed',
+        readers: ['google', 'bing'],
+        indexNow: {},
+        enrichment: {
+            meta: { minChars: 120, maxChars: 155, contentCap: 2000, maxTokens: 1024 },
+            title: { maxChars: 70 },
+            archetype: { contentCap: 3000, maxTokens: 2048 },
+        },
+    },
+    webhooks: [],
+    tools: {
+        concurrency: 5,
+        enrich: {
+            serviceCap: 1500,
+            llmsDescriptionCap: 300,
+            faqMinPerRoute: 5,
+            // The kinds of field every site has: descriptions, navigation, footer, forms.
+            // A site's own field names are added in its krantho.config.ts.
+            skipFields: [
+                'description',
+                'meta-description',
+                'meta-description-*',
+                'nav-*',
+                'footer-*',
+                'form-*',
+            ],
+        },
+    },
+};
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAuB;IAC1C,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACpB,KAAK,EAAE;QACL,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE,SAAS;KACtB;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;QACrE,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,EAAE;KACf;IACD,OAAO,EAAE;QACP,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE;QACxD,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,KAAK;QACZ,aAAa,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE;QAC1C,IAAI,EAAE,EAAE;QACR,MAAM,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;QAC/D,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1B;IACD,KAAK,EAAE;QACL,KAAK,EAAE,MAAM;QACb,GAAG,EAAE;YACH,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,KAAK;YACjB,uBAAuB,EAAE,MAAM;YAC/B,SAAS,EAAE,qBAAqB;YAChC,UAAU,EAAE,EAAE;YACd,GAAG,EAAE,EAAE;SACR;QACD,MAAM,EAAE,MAAM;KACf;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,mBAAmB,EAAE,KAAK;QAC1B,KAAK,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE;QAC9C,IAAI,EAAE;YACJ,aAAa,EAAE,UAAU;YACzB,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC;YACtC,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,OAAO;YACpB,WAAW,EAAE,EAAE;YACf,WAAW,EAAE,QAAQ;SACtB;QACD,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC1B,OAAO,EAAE;YACP,YAAY,EAAE,GAAG;YACjB,aAAa,EAAE,OAAO;YACtB,YAAY,EAAE,SAAS;YACvB,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,KAAK;SAChB;QACD,UAAU,EAAE,KAAK;KAClB;IACD,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;IACzC,KAAK,EAAE;QACL,KAAK,EAAE,EAAE,GAAG,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE;QACvD,UAAU,EAAE,EAAE;QACd,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE;QAC7B,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,QAAQ;QACrB,gBAAgB,EAAE;YAChB,YAAY;YACZ,WAAW;YACX,WAAW;YACX,YAAY;YACZ,YAAY;YACZ,eAAe;SAChB;QACD,KAAK,EAAE;YACL,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;YACxD,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;YACnE,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;SACtD;KACF;IACD,GAAG,EAAE;QACH,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;IACD,SAAS,EAAE;QACT,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,QAAQ;QACd,aAAa,EAAE,GAAG;QAClB,MAAM,EAAE;YACN,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,EAAE;YAChB,SAAS,EAAE,KAAK;YAChB,gBAAgB,EAAE,MAAM;YACxB,kBAAkB,EAAE,EAAE;YACtB,aAAa,EAAE,KAAK;YACpB,eAAe,EAAE,KAAK;SACvB;KACF;IACD,GAAG,EAAE;QACH,WAAW,EAAE,EAAE;QACf,MAAM,EAAE,EAAE;QACV,eAAe,EAAE,EAAE;QACnB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;YACzE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YACvB,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;SACjD;KACF;IACD,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE;QACL,WAAW,EAAE,CAAC;QACd,MAAM,EAAE;YACN,UAAU,EAAE,IAAI;YAChB,kBAAkB,EAAE,GAAG;YACvB,cAAc,EAAE,CAAC;YACjB,8EAA8E;YAC9E,+DAA+D;YAC/D,UAAU,EAAE;gBACV,aAAa;gBACb,kBAAkB;gBAClB,oBAAoB;gBACpB,OAAO;gBACP,UAAU;gBACV,QAAQ;aACT;SACF;KACF;CACF,CAAA"}

package/dist/define.d.ts

@@ -0,0 +1,11 @@
+import type { KranthoConfigInput } from './types.js';
+/**
+ * Declare a site's configuration.
+ *
+ * The call is a typed identity function: it gives `krantho.config.ts` its
+ * shape and its editor completions. Nothing is resolved here — the server and
+ * the tools hand the result to {@link resolveConfig}, which layers the
+ * environment on top and validates the whole tree once.
+ */
+export declare function defineKranthoConfig(config: KranthoConfigInput): KranthoConfigInput;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAElF"}

package/dist/define.js

@@ -0,0 +1,12 @@
+/**
+ * Declare a site's configuration.
+ *
+ * The call is a typed identity function: it gives `krantho.config.ts` its
+ * shape and its editor completions. Nothing is resolved here — the server and
+ * the tools hand the result to {@link resolveConfig}, which layers the
+ * environment on top and validates the whole tree once.
+ */
+export function defineKranthoConfig(config) {
+    return config;
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA0B;IAC5D,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/derive.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fill the leaves whose default is computed from another leaf, then turn every
+ * filesystem path into an absolute one.
+ *
+ * Runs on the merged tree before validation, so a derived value is validated
+ * like any other and a site that sets nothing gets the same absolute paths the
+ * code produced before the tree existed.
+ */
+export declare function derive(merged: Record<string, unknown>, cwd: string): Record<string, unknown>;
+/** Dotted paths of every scalar the developer or the environment supplied */
+export declare function suppliedPaths(source: unknown, prefix?: string): string[];
+//# sourceMappingURL=derive.d.ts.map

package/dist/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"AA0CA;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8B5F;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,SAAK,GAAG,MAAM,EAAE,CAapE"}

package/dist/derive.js

@@ -0,0 +1,90 @@
+import { isAbsolute, join, resolve as resolvePath } from 'node:path';
+import { getPath, isPlainObject, setPath } from './object-path.js';
+/** Paths holding a filesystem location that is resolved against the working directory */
+const PATH_LEAVES = [
+    'paths.dataDir',
+    'paths.contentDir',
+    'paths.seoGeneratedDir',
+    'persistence.sqlite.path',
+    'persistence.filesystem.contentPath',
+    'media.local.dir',
+    'seo.configDir',
+];
+function fillIfAbsent(target, path, value) {
+    if (getPath(target, path) === undefined)
+        setPath(target, path, value);
+}
+/**
+ * SQLite reads `:memory:` and `file:` URIs as instructions, not as locations.
+ * Resolving them against the working directory would turn an in-memory database
+ * into a file called `:memory:` in the project root.
+ */
+function isFilesystemLocation(value) {
+    return value !== ':memory:' && !value.startsWith('file:');
+}
+/** Public bucket URLs of the object stores that have a canonical one */
+function deriveMediaPublicUrls(tree) {
+    const s3Bucket = getPath(tree, 'media.s3.bucket');
+    const s3Region = getPath(tree, 'media.s3.region');
+    const s3Endpoint = getPath(tree, 'media.s3.endpoint');
+    if (typeof s3Bucket === 'string' && typeof s3Region === 'string' && s3Endpoint === undefined) {
+        fillIfAbsent(tree, 'media.s3.publicUrl', `https://${s3Bucket}.s3.${s3Region}.amazonaws.com`);
+    }
+    const gcsBucket = getPath(tree, 'media.gcs.bucket');
+    if (typeof gcsBucket === 'string') {
+        fillIfAbsent(tree, 'media.gcs.publicUrl', `https://storage.googleapis.com/${gcsBucket}`);
+    }
+}
+/**
+ * Fill the leaves whose default is computed from another leaf, then turn every
+ * filesystem path into an absolute one.
+ *
+ * Runs on the merged tree before validation, so a derived value is validated
+ * like any other and a site that sets nothing gets the same absolute paths the
+ * code produced before the tree existed.
+ */
+export function derive(merged, cwd) {
+    const tree = structuredClone(merged);
+    const language = getPath(tree, 'site.language');
+    if (typeof language === 'string') {
+        fillIfAbsent(tree, 'site.supportedLocales', [language]);
+        fillIfAbsent(tree, 'site.defaultLocale', language);
+    }
+    const dataDir = getPath(tree, 'paths.dataDir');
+    if (typeof dataDir === 'string') {
+        fillIfAbsent(tree, 'persistence.sqlite.path', join(dataDir, 'content.db'));
+    }
+    const contentDir = getPath(tree, 'paths.contentDir');
+    if (typeof contentDir === 'string') {
+        fillIfAbsent(tree, 'persistence.filesystem.contentPath', contentDir);
+        fillIfAbsent(tree, 'paths.seoGeneratedDir', join(contentDir, 'seo', 'generated'));
+    }
+    deriveMediaPublicUrls(tree);
+    for (const path of PATH_LEAVES) {
+        const value = getPath(tree, path);
+        if (typeof value !== 'string' || isAbsolute(value))
+            continue;
+        if (!isFilesystemLocation(value))
+            continue;
+        setPath(tree, path, resolvePath(cwd, value));
+    }
+    return tree;
+}
+/** Dotted paths of every scalar the developer or the environment supplied */
+export function suppliedPaths(source, prefix = '') {
+    if (!isPlainObject(source))
+        return prefix ? [prefix] : [];
+    const paths = [];
+    for (const [key, value] of Object.entries(source)) {
+        if (value === undefined)
+            continue;
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (isPlainObject(value)) {
+            paths.push(...suppliedPaths(value, path));
+            continue;
+        }
+        paths.push(path);
+    }
+    return paths;
+}
+//# sourceMappingURL=derive.js.map

package/dist/derive.js.map

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

package/dist/env.d.ts

@@ -0,0 +1,19 @@
+import type { LeafSpec } from './leaves.js';
+/** A problem found while reading one environment variable */
+export interface EnvIssue {
+    /** Variable that carried the bad value */
+    env: string;
+    /** Configuration path it feeds */
+    path: string;
+    message: string;
+}
+/** The overlay built from the environment, with the paths it set */
+export interface EnvOverlay {
+    values: Record<string, unknown>;
+    /** Configuration paths this overlay supplies, mapped to the variable that supplied them */
+    origins: Map<string, string>;
+    issues: EnvIssue[];
+}
+/** Build the configuration overlay the environment contributes to the given leaves */
+export declare function buildEnvOverlay(env: Record<string, string | undefined>, leaves?: readonly LeafSpec[]): EnvOverlay;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAI3C,6DAA6D;AAC7D,MAAM,WAAW,QAAQ;IACvB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,2FAA2F;IAC3F,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,MAAM,EAAE,QAAQ,EAAE,CAAA;CACnB;AA+DD,sFAAsF;AACtF,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,MAAM,GAAE,SAAS,QAAQ,EAAW,GACnC,UAAU,CA2BZ"}

package/dist/env.js

@@ -0,0 +1,89 @@
+import { readFileSync } from 'node:fs';
+import { envNameFor, LEAVES } from './leaves.js';
+import { setPath } from './object-path.js';
+const TRUE_WORDS = new Set(['true', '1', 'yes', 'on']);
+const FALSE_WORDS = new Set(['false', '0', 'no', 'off']);
+function parseLeafValue(leaf, raw) {
+    switch (leaf.kind) {
+        case 'int': {
+            if (!/^-?\d+$/.test(raw.trim())) {
+                return { message: `expected an integer, got ${JSON.stringify(raw)}` };
+            }
+            return { value: Number.parseInt(raw.trim(), 10) };
+        }
+        case 'boolean': {
+            const word = raw.trim().toLowerCase();
+            if (TRUE_WORDS.has(word))
+                return { value: true };
+            if (FALSE_WORDS.has(word))
+                return { value: false };
+            return {
+                message: `expected a boolean (true/false, 1/0, yes/no, on/off), got ${JSON.stringify(raw)}`,
+            };
+        }
+        case 'list': {
+            return {
+                value: raw
+                    .split(',')
+                    .map((entry) => entry.trim())
+                    .filter((entry) => entry.length > 0),
+            };
+        }
+        default:
+            return { value: raw };
+    }
+}
+/**
+ * Read a leaf's raw string from the environment.
+ *
+ * The variable itself wins; a secret leaf also accepts a `_FILE` suffix naming
+ * a file to read the value from. An empty value counts as unset.
+ */
+function readRaw(leaf, name, env) {
+    const direct = env[name];
+    if (direct !== undefined && direct !== '')
+        return { raw: direct, from: name };
+    if (!leaf.secret)
+        return null;
+    const fileName = `${name}_FILE`;
+    const filePath = env[fileName];
+    if (filePath === undefined || filePath === '')
+        return null;
+    try {
+        const contents = readFileSync(filePath, 'utf8').trim();
+        if (contents === '')
+            return { message: `file ${filePath} is empty`, from: fileName };
+        return { raw: contents, from: fileName };
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        return { message: `cannot read ${filePath}: ${reason}`, from: fileName };
+    }
+}
+/** Build the configuration overlay the environment contributes to the given leaves */
+export function buildEnvOverlay(env, leaves = LEAVES) {
+    const values = {};
+    const origins = new Map();
+    const issues = [];
+    for (const leaf of leaves) {
+        const name = envNameFor(leaf);
+        if (name === null)
+            continue;
+        const read = readRaw(leaf, name, env);
+        if (read === null)
+            continue;
+        if ('message' in read) {
+            issues.push({ env: read.from, path: leaf.path, message: read.message });
+            continue;
+        }
+        const parsed = parseLeafValue(leaf, read.raw);
+        if ('message' in parsed) {
+            issues.push({ env: read.from, path: leaf.path, message: parsed.message });
+            continue;
+        }
+        setPath(values, leaf.path, parsed.value);
+        origins.set(leaf.path, read.from);
+    }
+    return { values, origins, issues };
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,6 @@
+/** Every problem found while resolving the configuration, reported at once */
+export declare class KranthoConfigError extends Error {
+    readonly issues: readonly string[];
+    constructor(issues: readonly string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;gBAEtB,MAAM,EAAE,SAAS,MAAM,EAAE;CAMtC"}

package/dist/errors.js

@@ -0,0 +1,11 @@
+/** Every problem found while resolving the configuration, reported at once */
+export class KranthoConfigError extends Error {
+    issues;
+    constructor(issues) {
+        const body = issues.map((issue) => `  - ${issue}`).join('\n');
+        super(`Invalid krantho configuration:\n${body}`);
+        this.name = 'KranthoConfigError';
+        this.issues = issues;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,MAAM,CAAmB;IAElC,YAAY,MAAyB;QACnC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7D,KAAK,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAA;QAChD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { DEFAULTS } from './defaults.js';
+export { defineKranthoConfig } from './define.js';
+export { KranthoConfigError } from './errors.js';
+export type { LeafKind, LeafSpec } from './leaves.js';
+export { envNameFor, LEAVES, leafByPath, mechanicalEnvName, SECRET_PATHS } from './leaves.js';
+export type { LlmCredentialLeaf, LlmCredentialType, LlmProviderName } from './llm-providers.js';
+export { claudeCodeTokenMissing, LLM_PROVIDERS, llmCredentialLeaf } from './llm-providers.js';
+export { productionWarnings } from './production.js';
+export type { PublicConfig } from './public.js';
+export { REDACTED, redact, toPublicConfig } from './public.js';
+export { envReference } from './reference.js';
+export type { ResolveOptions } from './resolve.js';
+export { resolveConfig, resolvePersistence } from './resolve.js';
+export { isConfigured } from './sources.js';
+export type { AssistantRole, AssistantSection, AuthMode, AuthSection, CacheCdnProvider, CacheSection, CdnSection, ConfigSource, ConfigSources, ContentSection, CookieSameSite, CookieSecurePolicy, DeepPartial, FilesystemPersistenceSection, GcsMediaSection, KranthoConfig, KranthoConfigInput, KranthoConfigTree, LlmModelProfile, LlmSection, LocalMediaSection, MediaProvider, MediaSection, PageCacheStrategy, PathsSection, PersistenceProvider, PersistenceSection, PostgresPersistenceSection, S3MediaSection, SecretsProvider, SecretsSection, SeedMode, SeoDefinitions, SeoEntityConfig, SeoScopeConfig, SeoSection, SeoStructureConfig, ServerConfig, SharedCacheStrategy, SignupMode, SiteSection, SqlitePersistenceSection, StudioEntry, ToolsSection, VercelBlobMediaSection, WebhookEvent, WebhookTarget, } from './types.js';
+export { WEBHOOK_EVENTS } from './webhook-events.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC7F,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC/F,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,4BAA4B,EAC5B,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,cAAc,EACd,eAAe,EACf,cAAc,EACd,QAAQ,EACR,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,wBAAwB,EACxB,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { DEFAULTS } from './defaults.js';
+export { defineKranthoConfig } from './define.js';
+export { KranthoConfigError } from './errors.js';
+export { envNameFor, LEAVES, leafByPath, mechanicalEnvName, SECRET_PATHS } from './leaves.js';
+export { claudeCodeTokenMissing, LLM_PROVIDERS, llmCredentialLeaf } from './llm-providers.js';
+export { productionWarnings } from './production.js';
+export { REDACTED, redact, toPublicConfig } from './public.js';
+export { envReference } from './reference.js';
+export { resolveConfig, resolvePersistence } from './resolve.js';
+export { isConfigured } from './sources.js';
+export { WEBHOOK_EVENTS } from './webhook-events.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE7F,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAkD3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/leaves.d.ts

@@ -0,0 +1,34 @@
+/** How an environment variable's string is turned into a configuration value */
+export type LeafKind = 'string' | 'int' | 'boolean' | 'list' | 'structured';
+/** One configurable leaf of the tree */
+export interface LeafSpec {
+    /** Dotted path into the resolved tree */
+    path: string;
+    kind: LeafKind;
+    /**
+     * Environment variable name. Omitted means the mechanical
+     * `KRANTHO_<SECTION>_<KEY>` form derived from {@link LeafSpec.path}.
+     * `structured` leaves have no environment override.
+     */
+    env?: string;
+    /** Secret leaves are redacted, never serialized to a browser, and accept a `_FILE` suffix */
+    secret?: true;
+    description: string;
+}
+/** Derive the mechanical environment variable name for a dotted path */
+export declare function mechanicalEnvName(path: string): string;
+/** The environment variable a leaf reads, or null when it has none */
+export declare function envNameFor(leaf: LeafSpec): string | null;
+/**
+ * Every leaf of the configuration tree.
+ *
+ * The `env` overrides are the variables that existed before the tree did, which
+ * keep their names so running deployments keep working, and the one credential
+ * whose name states what the token is. Everything else takes the mechanical form.
+ */
+export declare const LEAVES: readonly LeafSpec[];
+/** Look a leaf up by its dotted path */
+export declare function leafByPath(path: string): LeafSpec | undefined;
+/** Dotted paths of every secret leaf */
+export declare const SECRET_PATHS: readonly string[];
+//# sourceMappingURL=leaves.d.ts.map

package/dist/leaves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaves.d.ts","sourceRoot":"","sources":["../src/leaves.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,CAAA;AAE3E,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,CAAA;IACd;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,6FAA6F;IAC7F,MAAM,CAAC,EAAE,IAAI,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAGxD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,QAAQ,EA+uBrC,CAAA;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE7D;AAED,wCAAwC;AACxC,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAEzC,CAAA"}