@krantho/config 0.0.0-stage → 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,413 @@
+/**
+ * The resolved krantho configuration tree.
+ *
+ * Every leaf has a value after {@link resolveConfig} runs — optional leaves are
+ * the ones that are genuinely absent by default (a secret nobody set, a limit
+ * nobody imposed). Defaults reproduce the values the code used before the tree
+ * existed.
+ */
+import type { LlmProviderName } from './llm-providers.js';
+import type { WEBHOOK_EVENTS } from './webhook-events.js';
+/** Persistence backend selector */
+export type PersistenceProvider = 'sqlite' | 'postgres' | 'filesystem';
+/**
+ * How rendered pages are cached: `none` renders every request; `next-isr`
+ * keeps each Next.js page until a content change invalidates it; `cdn` sends
+ * CDN cache headers with each page and purges the CDN when content changes
+ */
+export type PageCacheStrategy = 'none' | 'next-isr' | 'cdn';
+/** The CDN in front of the site, purged when content changes — `none` purges nothing */
+export type CacheCdnProvider = 'none' | 'vercel' | 'cloudfront' | 'gcp';
+/** Where Next.js keeps its cache: `none` per instance, `database` shared through persistence */
+export type SharedCacheStrategy = 'none' | 'database';
+/** Authentication mode */
+export type AuthMode = 'none' | 'token' | 'oidc';
+/** Whether OIDC first-time logins create a user */
+export type SignupMode = 'open' | 'closed';
+/** How /studio treats a visitor without a session */
+export type StudioEntry = 'login' | 'redirect';
+/** Cookie `Secure` policy — `auto` derives it from the request protocol */
+export type CookieSecurePolicy = 'auto' | 'always' | 'never';
+/** Cookie `SameSite` policy */
+export type CookieSameSite = 'lax' | 'strict' | 'none';
+/** SEO seed behaviour — `seed` preserves existing rows, `overwrite` replaces them */
+export type SeedMode = 'seed' | 'overwrite';
+/** A Schema.org entity with its properties, as stored in the SEO config */
+export interface SeoEntityConfig {
+    '@type': string;
+    '@id'?: string | undefined;
+    role?: string | undefined;
+    properties: Record<string, unknown>;
+}
+/** Rich SEO configuration for one scope (site, collection or route) */
+export interface SeoScopeConfig {
+    entities: SeoEntityConfig[];
+    fieldMappings?: Record<string, string> | undefined;
+    /** The page structure the scope's pages get when their template states none */
+    structure?: SeoStructureConfig | undefined;
+}
+/** A scope's page structure: the trail above its pages, root first, and their kind */
+export interface SeoStructureConfig {
+    trail?: Array<{
+        name: string;
+        url?: string | undefined;
+    }> | undefined;
+    kind?: string | undefined;
+}
+/** The SEO definition files of `seo.configDir`, parsed and checked */
+export interface SeoDefinitions {
+    site: SeoScopeConfig | null;
+    /** Keyed by collection name */
+    collections: Record<string, SeoScopeConfig>;
+    /** Keyed by URL pattern */
+    routes: Record<string, SeoScopeConfig>;
+}
+/** Site identity — the only section that must be supplied */
+export interface SiteSection {
+    domain: string;
+    name: string;
+    language: string;
+    baseUrl: string;
+    supportedLocales: string[];
+    defaultLocale: string;
+    /** The site's or its organization's logo, an absolute URL */
+    logo?: string | undefined;
+    /** What the site or its organization is, in a sentence */
+    description?: string | undefined;
+    /** Another name the site or organization is known by */
+    alternateName?: string | undefined;
+    /** Profile pages that identify the organization — social, registry, code hosting */
+    sameAs: string[];
+}
+/** Filesystem and URL locations */
+export interface PathsSection {
+    dataDir: string;
+    contentDir: string;
+    seoGeneratedDir: string;
+}
+export interface SqlitePersistenceSection {
+    path: string;
+    busyTimeoutMs: number;
+    walRetries: number;
+    walRetryDelayMs: number;
+}
+export interface PostgresPersistenceSection {
+    url?: string | undefined;
+    maxConnections?: number | undefined;
+    prepare?: boolean | undefined;
+    idleTimeoutSec?: number | undefined;
+}
+export interface FilesystemPersistenceSection {
+    contentPath: string;
+}
+export interface PersistenceSection {
+    provider: PersistenceProvider;
+    sqlite: SqlitePersistenceSection;
+    postgres: PostgresPersistenceSection;
+    filesystem: FilesystemPersistenceSection;
+}
+export interface ContentSection {
+    cache: {
+        enabled: boolean;
+        ttlMs: number;
+        maxEntries: number;
+    };
+    atNotation: boolean;
+    watch: boolean;
+    defaultStatus: {
+        filesystem: string;
+    };
+    list: {
+        maxLimit?: number | undefined;
+    };
+    search: {
+        minQueryLength: number;
+        defaultLimit: number;
+        maxLimit: number;
+    };
+    versions: {
+        keep: number;
+    };
+    lock: {
+        leaseMs: number;
+    };
+}
+export interface CdnSection {
+    provider: CacheCdnProvider;
+    sMaxAgeSec: number;
+    staleWhileRevalidateSec: number;
+    /** Response header carrying the cache tags — CloudFront only */
+    tagHeader: string;
+    cloudfront: {
+        distributionId?: string | undefined;
+    };
+    gcp: {
+        project?: string | undefined;
+        urlMap?: string | undefined;
+        accessToken?: string | undefined;
+    };
+}
+export interface CacheSection {
+    pages: PageCacheStrategy;
+    cdn: CdnSection;
+    shared: SharedCacheStrategy;
+}
+export interface AuthSection {
+    mode: AuthMode;
+    requireAuthForReads: boolean;
+    token: {
+        secret?: string | undefined;
+        email: string;
+        role: string;
+    };
+    jwtSecret?: string | undefined;
+    oidc: {
+        issuer?: string | undefined;
+        clientId?: string | undefined;
+        clientSecret?: string | undefined;
+        redirectUri?: string | undefined;
+        postLogoutUri: string;
+        scopes: string[];
+        signup: SignupMode;
+        studioEntry: StudioEntry;
+        adminEmails: string[];
+        newUserRole: string;
+    };
+    /** A CI platform's workload identity: all three leaves set turns it on, none leaves it off */
+    workload: {
+        issuer?: string | undefined;
+        audience?: string | undefined;
+        subjects: string[];
+    };
+    session: {
+        accessTtlSec: number;
+        refreshTtlSec: number;
+        cookiePrefix: string;
+        secure: CookieSecurePolicy;
+        sameSite: CookieSameSite;
+    };
+    trustProxy: boolean;
+}
+/** Where media file bytes are stored; unset means media is off */
+export type MediaProvider = 'local' | 'vercel-blob' | 's3' | 'gcs';
+/** Local-disk file store */
+export interface LocalMediaSection {
+    /** Directory files are written to; the host framework serves it at `urlPrefix` */
+    dir: string;
+    urlPrefix: string;
+}
+/** Vercel Blob file store */
+export interface VercelBlobMediaSection {
+    token?: string | undefined;
+}
+/** S3-compatible file store */
+export interface S3MediaSection {
+    bucket?: string | undefined;
+    region?: string | undefined;
+    endpoint?: string | undefined;
+    forcePathStyle: boolean;
+    publicUrl?: string | undefined;
+    accessKeyId?: string | undefined;
+    secretAccessKey?: string | undefined;
+}
+/** Google Cloud Storage file store */
+export interface GcsMediaSection {
+    bucket?: string | undefined;
+    publicUrl?: string | undefined;
+    /** Service-account key JSON; unset uses the metadata server */
+    credentials?: string | undefined;
+}
+export interface MediaSection {
+    provider?: MediaProvider | undefined;
+    local: LocalMediaSection;
+    vercelBlob: VercelBlobMediaSection;
+    s3: S3MediaSection;
+    gcs: GcsMediaSection;
+    maxFileSize: number;
+    allowedMimeTypes: string[];
+    image: {
+        maxWidth: number;
+        quality: {
+            jpeg: number;
+            webp: number;
+            avif: number;
+            normalize: number;
+        };
+        presets: Record<string, number | null>;
+        cache: {
+            maxEntries: number;
+            maxMb: number;
+            ttiSec: number;
+        };
+    };
+}
+/** Where secrets the site stores (a pasted LLM key) are encrypted: the vault that holds the key */
+export type SecretsProvider = 'local';
+/** Vault that encrypts the secrets a site stores in its database */
+export interface SecretsSection {
+    provider: SecretsProvider;
+    local: {
+        /** Key the local vault derives its encryption key from; unset falls back to `auth.jwtSecret` */
+        key?: string | undefined;
+    };
+}
+export interface LlmSection {
+    provider: string;
+    model?: string | undefined;
+    baseUrl?: string | undefined;
+    /** One credential per provider; ollama needs none */
+    anthropic: {
+        apiKey?: string | undefined;
+    };
+    openai: {
+        apiKey?: string | undefined;
+    };
+    gemini: {
+        apiKey?: string | undefined;
+    };
+    openrouter: {
+        apiKey?: string | undefined;
+    };
+    /** Claude subscription token for the `claude-code` provider — development only, never stored */
+    claudeCode: {
+        authToken?: string | undefined;
+    };
+    /** Per-model request settings over the defaults, by model id */
+    profiles: Record<string, LlmModelProfile>;
+}
+/** How requests to one model are shaped, over the default for that model */
+export interface LlmModelProfile {
+    /** `reasoning_effort` to ask for, or `default` to leave it to the model; not read by the Anthropic providers */
+    reasoningEffort?: 'default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | undefined;
+    /** Output tokens added to a request's cap for the thinking a model does before it answers */
+    reasoningHeadroom?: number | undefined;
+    /** Sampling temperature to send; unset sends none */
+    temperature?: number | undefined;
+}
+/** The lowest role that may use the Studio assistant */
+export type AssistantRole = 'admin' | 'editor' | 'viewer';
+/** The Studio assistant — off unless enabled */
+export interface AssistantSection {
+    enabled: boolean;
+    /** Provider for the assistant, with that provider's own credential; unset uses the provider in Setup › AI provider */
+    provider?: LlmProviderName | undefined;
+    /** Model for the assistant; unset uses the model in Setup › AI provider, or the provider's default when `provider` is set */
+    model?: string | undefined;
+    /** The lowest role that may use the assistant */
+    role: AssistantRole;
+    /** How long a proposed action can be confirmed, in seconds */
+    confirmTtlSec: number;
+    limits: {
+        /** Model calls per chat request */
+        maxTurns: number;
+        /** Tool executions per chat request */
+        maxToolCalls: number;
+        /** Output token cap per model call */
+        maxTokens: number;
+        /** Input plus output tokens across all model calls of one chat request */
+        maxRequestTokens: number;
+        /** Conversation messages accepted from the client */
+        maxHistoryMessages: number;
+        /** Characters accepted from the client across the conversation */
+        maxInputChars: number;
+        /** Characters of one tool result sent to the model */
+        toolResultChars: number;
+    };
+}
+export interface SeoSection {
+    identity?: string | undefined;
+    collections: Record<string, string[]>;
+    routes: Record<string, string[]>;
+    site?: SeoScopeConfig | undefined;
+    richCollections: Record<string, SeoScopeConfig>;
+    richRoutes: Record<string, SeoScopeConfig>;
+    seedMode: SeedMode;
+    /** Readers whose published rules the structured data is checked against, by profile id */
+    readers: string[];
+    configDir?: string | undefined;
+    /**
+     * The definition files of `configDir`. Read by `loadConfig` from
+     * `@krantho/config/node`; empty from the pure `resolveConfig`, which reads
+     * no files.
+     */
+    definitions: SeoDefinitions;
+    /** IndexNow (Bing and other participating engines): the site's key, served at `/<key>.txt` */
+    indexNow: {
+        key?: string | undefined;
+    };
+    enrichment: {
+        meta: {
+            minChars: number;
+            maxChars: number;
+            contentCap: number;
+            maxTokens: number;
+        };
+        title: {
+            maxChars: number;
+        };
+        archetype: {
+            contentCap: number;
+            maxTokens: number;
+        };
+    };
+}
+/** A content event a webhook can subscribe to */
+export type WebhookEvent = (typeof WEBHOOK_EVENTS)[number];
+/** One outgoing webhook: where to POST, for which events, and how to sign it */
+export interface WebhookTarget {
+    /** Absolute http(s) URL the payload is POSTed to */
+    url: string;
+    /** Events that trigger the webhook; at least one */
+    events: WebhookEvent[];
+    /** Signs each delivery with HMAC-SHA256 in the `X-Webhook-Signature` header */
+    secret?: string | undefined;
+}
+export interface ToolsSection {
+    concurrency: number;
+    enrich: {
+        serviceCap: number;
+        llmsDescriptionCap: number;
+        faqMinPerRoute: number;
+        /** Frontmatter fields left out of the text sent to the model; a trailing `*` matches a prefix */
+        skipFields: string[];
+    };
+}
+/** The configuration sections, without the resolution metadata */
+export interface KranthoConfigTree {
+    site: SiteSection;
+    paths: PathsSection;
+    persistence: PersistenceSection;
+    content: ContentSection;
+    cache: CacheSection;
+    auth: AuthSection;
+    media: MediaSection;
+    secrets: SecretsSection;
+    llm: LlmSection;
+    assistant: AssistantSection;
+    seo: SeoSection;
+    webhooks: WebhookTarget[];
+    tools: ToolsSection;
+}
+/** Recursively optional view of a type — arrays and primitives are kept whole */
+export type DeepPartial<T> = T extends readonly unknown[] ? T : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]> | undefined;
+} : T;
+/** What a developer writes in `krantho.config.ts` */
+export type KranthoConfigInput = DeepPartial<KranthoConfigTree>;
+/** Where a resolved leaf's value came from */
+export type ConfigSource = 'default' | 'code' | 'env' | 'file';
+/** Dotted leaf path to the layer that supplied its value */
+export type ConfigSources = ReadonlyMap<string, ConfigSource>;
+/**
+ * The resolved configuration tree handed to the server and the tools.
+ *
+ * `sources` records which layer supplied each leaf, so a settings screen can
+ * say whether a value came from the environment, from code, or from the
+ * shipped default.
+ */
+export interface KranthoConfig extends KranthoConfigTree {
+    readonly sources: ConfigSources;
+}
+/** Only the server may hold secret leaves — the browser gets `PublicConfig` */
+export type ServerConfig = KranthoConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,mCAAmC;AACnC,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAA;AAEtE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAA;AAE3D,wFAAwF;AACxF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,KAAK,CAAA;AAEvE,gGAAgG;AAChG,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,UAAU,CAAA;AAErD,0BAA0B;AAC1B,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAEhD,mDAAmD;AACnD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAA;AAC1C,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,CAAA;AAE9C,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE5D,+BAA+B;AAC/B,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEtD,qFAAqF;AACrF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;AAE3C,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;IAClD,+EAA+E;IAC/E,SAAS,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAA;CAC3C;AAED,sFAAsF;AACtF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,GAAG,SAAS,CAAA;IACrE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;IAC3B,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC3C,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CACvC;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,oFAAoF;IACpF,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,MAAM,EAAE,wBAAwB,CAAA;IAChC,QAAQ,EAAE,0BAA0B,CAAA;IACpC,UAAU,EAAE,4BAA4B,CAAA;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9D,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,aAAa,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IACrC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IACvC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1E,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1B,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IACnD,GAAG,EAAE;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACjC,CAAA;CACF;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,iBAAiB,CAAA;IACxB,GAAG,EAAE,UAAU,CAAA;IACf,MAAM,EAAE,mBAAmB,CAAA;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAA;IACd,mBAAmB,EAAE,OAAO,CAAA;IAC5B,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACnE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,IAAI,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACjC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAChC,aAAa,EAAE,MAAM,CAAA;QACrB,MAAM,EAAE,MAAM,EAAE,CAAA;QAChB,MAAM,EAAE,UAAU,CAAA;QAClB,WAAW,EAAE,WAAW,CAAA;QACxB,WAAW,EAAE,MAAM,EAAE,CAAA;QACrB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,8FAA8F;IAC9F,QAAQ,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,QAAQ,EAAE,MAAM,EAAE,CAAA;KACnB,CAAA;IACD,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAA;QACpB,aAAa,EAAE,MAAM,CAAA;QACrB,YAAY,EAAE,MAAM,CAAA;QACpB,MAAM,EAAE,kBAAkB,CAAA;QAC1B,QAAQ,EAAE,cAAc,CAAA;KACzB,CAAA;IACD,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,kEAAkE;AAClE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,aAAa,GAAG,IAAI,GAAG,KAAK,CAAA;AAElE,4BAA4B;AAC5B,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,6BAA6B;AAC7B,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B;AAED,+BAA+B;AAC/B,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,cAAc,EAAE,OAAO,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;IACpC,KAAK,EAAE,iBAAiB,CAAA;IACxB,UAAU,EAAE,sBAAsB,CAAA;IAClC,EAAE,EAAE,cAAc,CAAA;IAClB,GAAG,EAAE,eAAe,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAA;QAChB,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;QACxE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;QACtC,KAAK,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAC7D,CAAA;CACF;AAED,mGAAmG;AACnG,MAAM,MAAM,eAAe,GAAG,OAAO,CAAA;AAErC,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,CAAA;IACzB,KAAK,EAAE;QACL,gGAAgG;QAChG,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACzB,CAAA;CACF;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,qDAAqD;IACrD,SAAS,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IAC1C,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IACvC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IACvC,UAAU,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IAC3C,gGAAgG;IAChG,UAAU,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IAC9C,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CAC1C;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,gHAAgH;IAChH,eAAe,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IAClG,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC;AAED,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEzD,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,sHAAsH;IACtH,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS,CAAA;IACtC,6HAA6H;IAC7H,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,iDAAiD;IACjD,IAAI,EAAE,aAAa,CAAA;IACnB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE;QACN,mCAAmC;QACnC,QAAQ,EAAE,MAAM,CAAA;QAChB,uCAAuC;QACvC,YAAY,EAAE,MAAM,CAAA;QACpB,sCAAsC;QACtC,SAAS,EAAE,MAAM,CAAA;QACjB,0EAA0E;QAC1E,gBAAgB,EAAE,MAAM,CAAA;QACxB,qDAAqD;QACrD,kBAAkB,EAAE,MAAM,CAAA;QAC1B,kEAAkE;QAClE,aAAa,EAAE,MAAM,CAAA;QACrB,sDAAsD;QACtD,eAAe,EAAE,MAAM,CAAA;KACxB,CAAA;CACF;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;IACjC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC/C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC1C,QAAQ,EAAE,QAAQ,CAAA;IAClB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B;;;;OAIG;IACH,WAAW,EAAE,cAAc,CAAA;IAC3B,8FAA8F;IAC9F,QAAQ,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IACtC,UAAU,EAAE;QACV,IAAI,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;QACnF,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;QAC3B,SAAS,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KACrD,CAAA;CACF;AAED,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,oDAAoD;IACpD,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAA;QAClB,kBAAkB,EAAE,MAAM,CAAA;QAC1B,cAAc,EAAE,MAAM,CAAA;QACtB,iGAAiG;QACjG,UAAU,EAAE,MAAM,EAAE,CAAA;KACrB,CAAA;CACF;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,YAAY,CAAA;IACnB,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE,cAAc,CAAA;IACvB,KAAK,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,cAAc,CAAA;IACvB,GAAG,EAAE,UAAU,CAAA;IACf,SAAS,EAAE,gBAAgB,CAAA;IAC3B,GAAG,EAAE,UAAU,CAAA;IACf,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,KAAK,EAAE,YAAY,CAAA;CACpB;AAED,iFAAiF;AACjF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,OAAO,EAAE,GACrD,CAAC,GACD,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;CAAE,GAClD,CAAC,CAAA;AAEP,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAA;AAE/D,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;AAE9D,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAChC;AAED,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG,aAAa,CAAA"}

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * The resolved krantho configuration tree.
+ *
+ * Every leaf has a value after {@link resolveConfig} runs — optional leaves are
+ * the ones that are genuinely absent by default (a secret nobody set, a limit
+ * nobody imposed). Defaults reproduce the values the code used before the tree
+ * existed.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/webhook-events.d.ts

@@ -0,0 +1,3 @@
+/** The content events a webhook can subscribe to — the one list the schema and the API share */
+export declare const WEBHOOK_EVENTS: readonly ["create", "update", "publish", "delete"];
+//# sourceMappingURL=webhook-events.d.ts.map

package/dist/webhook-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-events.d.ts","sourceRoot":"","sources":["../src/webhook-events.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,eAAO,MAAM,cAAc,oDAAqD,CAAA"}

package/dist/webhook-events.js

@@ -0,0 +1,3 @@
+/** The content events a webhook can subscribe to — the one list the schema and the API share */
+export const WEBHOOK_EVENTS = ['create', 'update', 'publish', 'delete'];
+//# sourceMappingURL=webhook-events.js.map

package/dist/webhook-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-events.js","sourceRoot":"","sources":["../src/webhook-events.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAA"}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@krantho/config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "license": "MIT",
+  "homepage": "https://krantho.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descoped/krantho.git",
+    "directory": "packages/config"
+  },
+  "bugs": {
+    "url": "https://github.com/descoped/krantho/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./public": {
+      "types": "./dist/public.d.ts",
+      "import": "./dist/public.js",
+      "require": "./dist/public.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js",
+      "require": "./dist/node/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^4.4.3",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.9",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "reference": "tsx scripts/write-reference.ts",
+    "test:bundle": "node test/bundle-boundary.mjs"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.