@krantho/server 0.0.0-stage → 1.0.1

package/dist/indexnow.js

@@ -0,0 +1,89 @@
+import { documentPath, pageCollection } from '@krantho/core';
+/** The shared IndexNow endpoint; participating engines (Bing among them) share submissions */
+export const INDEXNOW_ENDPOINT = 'https://api.indexnow.org/indexnow';
+/** IndexNow accepts at most this many URLs in one submission */
+const MAX_URLS_PER_SUBMISSION = 10_000;
+/**
+ * Tell IndexNow that these URLs changed (added, updated or removed). Every URL
+ * must be on the site's host. Resolves with the HTTP status of each request
+ * when IndexNow accepted them all (200, or 202 while it validates the key),
+ * and throws otherwise.
+ */
+export async function submitIndexNow(site, urls, fetchFn = fetch) {
+    const origin = new URL(site.baseUrl);
+    const statuses = [];
+    for (let start = 0; start < urls.length; start += MAX_URLS_PER_SUBMISSION) {
+        const response = await fetchFn(INDEXNOW_ENDPOINT, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json; charset=utf-8' },
+            body: JSON.stringify({
+                host: origin.host,
+                key: site.key,
+                keyLocation: `${origin.origin}/${site.key}.txt`,
+                urlList: urls.slice(start, start + MAX_URLS_PER_SUBMISSION),
+            }),
+        });
+        if (response.status !== 200 && response.status !== 202) {
+            throw new Error(`IndexNow rejected ${urls.length} URLs: HTTP ${response.status}`);
+        }
+        statuses.push(response.status);
+    }
+    return statuses;
+}
+/** One log line for an accepted submission: how many URLs, IndexNow's answer, and the URLs */
+export function describeSubmission(urls, statuses) {
+    const count = urls.length === 1 ? '1 URL' : `${urls.length} URLs`;
+    return `IndexNow: submitted ${count}, HTTP ${statuses.join(', ')}\n${urls.map((url) => `  ${url}`).join('\n')}`;
+}
+/**
+ * The pages a change touched: a document's page when its published version
+ * changed (a draft save touches none), every page in the sitemap after a
+ * site-wide change such as the startup import.
+ */
+export function changedUrlsFor(baseUrl, collections, listSitemap) {
+    const origin = baseUrl.replace(/\/$/, '');
+    return async (change) => {
+        if (change.kind === 'site')
+            return listSitemap();
+        if (change.kind !== 'document' || !change.live)
+            return [];
+        const path = documentPath(pageCollection(collections, change.collection), change.slug);
+        return path === null ? [] : [`${origin}${path}`];
+    };
+}
+/** Local development serves the configured site from a machine nobody indexes */
+function isLocal(baseUrl) {
+    const host = new URL(baseUrl).hostname;
+    return (host === 'localhost' || host === '127.0.0.1' || host === '[::1]' || host.endsWith('.localhost'));
+}
+/**
+ * A change listener that notifies IndexNow of the pages a committed write
+ * touched, when `seo.indexNow.key` is set, the site is not on a local host and
+ * the server runs in production: a development server configured for the real
+ * site would otherwise announce its draft pages under the site's domain.
+ * The submission runs alongside the response (`waitUntil` on serverless hosts)
+ * and never fails the write; every submission is logged with IndexNow's answer.
+ */
+export function indexNowChangeListener(config, nodeEnv, changedUrls, waitUntil, fetchFn = fetch) {
+    const key = config.seo.indexNow.key;
+    const baseUrl = config.site.baseUrl;
+    if (!key || isLocal(baseUrl) || nodeEnv !== 'production')
+        return null;
+    return (change) => {
+        const work = changedUrls(change)
+            .then(async (urls) => {
+            if (urls.length === 0)
+                return;
+            const statuses = await submitIndexNow({ baseUrl, key }, urls, fetchFn);
+            console.log(`[indexnow] ${describeSubmission(urls, statuses)}`);
+        })
+            .catch((error) => console.error('[indexnow] notification failed:', error));
+        try {
+            waitUntil?.(work);
+        }
+        catch (error) {
+            console.error('[indexnow] waitUntil rejected the notification:', error);
+        }
+    };
+}
+//# sourceMappingURL=indexnow.js.map

package/dist/indexnow.js.map

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

package/dist/lazy-handler.d.ts

@@ -0,0 +1,7 @@
+import type { KranthoHandler, KranthoHandlerOptions } from './handler.js';
+/**
+ * Create a lazy-initialized handler singleton. First call creates, subsequent
+ * calls return cached. A failed creation is not cached — the next call retries.
+ */
+export declare function createLazyHandler(options: KranthoHandlerOptions): () => Promise<KranthoHandler>;
+//# sourceMappingURL=lazy-handler.d.ts.map

package/dist/lazy-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-handler.d.ts","sourceRoot":"","sources":["../src/lazy-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAGzE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAS/F"}

package/dist/lazy-handler.js

@@ -0,0 +1,16 @@
+import { createKranthoHandler } from './handler.js';
+/**
+ * Create a lazy-initialized handler singleton. First call creates, subsequent
+ * calls return cached. A failed creation is not cached — the next call retries.
+ */
+export function createLazyHandler(options) {
+    let promise = null;
+    return () => {
+        promise ??= createKranthoHandler(options).catch((err) => {
+            promise = null;
+            throw err;
+        });
+        return promise;
+    };
+}
+//# sourceMappingURL=lazy-handler.js.map

package/dist/lazy-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-handler.js","sourceRoot":"","sources":["../src/lazy-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA8B;IAC9D,IAAI,OAAO,GAAmC,IAAI,CAAA;IAClD,OAAO,GAAG,EAAE;QACV,OAAO,KAAK,oBAAoB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YAC/D,OAAO,GAAG,IAAI,CAAA;YACd,MAAM,GAAG,CAAA;QACX,CAAC,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;AACH,CAAC"}

package/dist/llm-seed.d.ts

@@ -0,0 +1,25 @@
+import type { KranthoConfig, KranthoConfigInput } from '@krantho/config';
+/** The slice of the site settings store seeding uses */
+interface SettingsStore {
+    getSetting(key: string): Promise<string | null>;
+    setSetting(key: string, value: string): Promise<void>;
+}
+/**
+ * Whether boot should seed the stored LLM settings: the app's code passed an
+ * `llm` block, or the environment chose a provider and supplied that provider's
+ * own key. Any other `llm.*` variable alone is not enough — a lone credential
+ * for a provider nobody chose must not pick one silently, and a provider
+ * without a credential would stand in the way of a key supplied later.
+ */
+export declare function shouldSeedLlm(code: KranthoConfigInput, config: KranthoConfig): boolean;
+/**
+ * Seed LLM config from developer-defined defaults: the provider, model and base URL.
+ * Idempotent — a provider is stored only while none is; a key without a chosen
+ * provider seeds no provider. Admin overrides via Setup › AI provider are always preserved.
+ * No credential is ever stored: the API reads each provider's key, and the
+ * subscription token of the claude-code provider, from the configuration per request,
+ * so a key the deployment injects stays out of the database.
+ */
+export declare function seedLlmConfig(config: KranthoConfig, adapter: SettingsStore): Promise<void>;
+export {};
+//# sourceMappingURL=llm-seed.d.ts.map

package/dist/llm-seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-seed.d.ts","sourceRoot":"","sources":["../src/llm-seed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGxE,wDAAwD;AACxD,UAAU,aAAa;IACrB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAC/C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtD;AAOD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAKtF;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAShG"}

package/dist/llm-seed.js

@@ -0,0 +1,42 @@
+import { storedBaseUrlSetting, storedModelSetting } from '@krantho/api';
+import { llmCredentialLeaf } from '@krantho/config';
+/** Whether the operator or the developer chose the provider, rather than the default standing */
+function providerChosen(config) {
+    return config.sources.get('llm.provider') !== 'default';
+}
+/**
+ * Whether boot should seed the stored LLM settings: the app's code passed an
+ * `llm` block, or the environment chose a provider and supplied that provider's
+ * own key. Any other `llm.*` variable alone is not enough — a lone credential
+ * for a provider nobody chose must not pick one silently, and a provider
+ * without a credential would stand in the way of a key supplied later.
+ */
+export function shouldSeedLlm(code, config) {
+    if (code.llm !== undefined)
+        return true;
+    if (config.sources.get('llm.provider') !== 'env')
+        return false;
+    const leaf = llmCredentialLeaf(config.llm, config.llm.provider);
+    return leaf?.type === 'api-key' && config.sources.get(leaf.path) === 'env';
+}
+/**
+ * Seed LLM config from developer-defined defaults: the provider, model and base URL.
+ * Idempotent — a provider is stored only while none is; a key without a chosen
+ * provider seeds no provider. Admin overrides via Setup › AI provider are always preserved.
+ * No credential is ever stored: the API reads each provider's key, and the
+ * subscription token of the claude-code provider, from the configuration per request,
+ * so a key the deployment injects stays out of the database.
+ */
+export async function seedLlmConfig(config, adapter) {
+    if (await adapter.getSetting('llm.provider'))
+        return; // Already configured — don't overwrite
+    const { llm } = config;
+    if (providerChosen(config)) {
+        await adapter.setSetting('llm.provider', llm.provider);
+        if (llm.model)
+            await adapter.setSetting(storedModelSetting(llm.provider), llm.model);
+        if (llm.baseUrl)
+            await adapter.setSetting(storedBaseUrlSetting(llm.provider), llm.baseUrl);
+    }
+}
+//# sourceMappingURL=llm-seed.js.map

package/dist/llm-seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-seed.js","sourceRoot":"","sources":["../src/llm-seed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAQnD,iGAAiG;AACjG,SAAS,cAAc,CAAC,MAAqB;IAC3C,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,SAAS,CAAA;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAwB,EAAE,MAAqB;IAC3E,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACvC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,KAAK;QAAE,OAAO,KAAK,CAAA;IAC9D,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC/D,OAAO,IAAI,EAAE,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,CAAA;AAC5E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAqB,EAAE,OAAsB;IAC/E,IAAI,MAAM,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;QAAE,OAAM,CAAC,uCAAuC;IAE5F,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAA;IACtB,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;QACtD,IAAI,GAAG,CAAC,KAAK;YAAE,MAAM,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;QACpF,IAAI,GAAG,CAAC,OAAO;YAAE,MAAM,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5F,CAAC;AACH,CAAC"}

package/dist/lock-adapters.d.ts

@@ -0,0 +1,21 @@
+import type { ILockAdapter, IMediaFolderStorage, IMediaMetadataAdapter, IPageCacheStore, IRetentionAdapter, ISeoConfigAdapter, ISiteSettingsAdapter, IWebhookDeliveryAdapter } from '@krantho/persistence';
+export interface LockAdapterResult {
+    lockAdapter: ILockAdapter | undefined;
+    webhookDeliveryAdapter: IWebhookDeliveryAdapter | undefined;
+    retentionAdapter: IRetentionAdapter | undefined;
+    siteSettingsAdapter: ISiteSettingsAdapter | undefined;
+    seoConfigAdapter: ISeoConfigAdapter | undefined;
+    mediaAdapter: IMediaMetadataAdapter | undefined;
+    mediaFolderAdapter: IMediaFolderStorage | undefined;
+    pageCacheStore: IPageCacheStore | undefined;
+}
+/**
+ * Create lock, webhook delivery, retention, site settings, SEO config, media
+ * metadata and media folder adapters, and the shared page cache store, from a
+ * raw database handle.
+ *
+ * Detects whether the handle is SQLite (has `prepare` method) or Postgres
+ * (a callable function with `begin` method) and loads the appropriate adapter package.
+ */
+export declare function createLockAdapters(lockDb: unknown | undefined, persistenceType?: string | undefined): Promise<LockAdapterResult>;
+//# sourceMappingURL=lock-adapters.d.ts.map

package/dist/lock-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-adapters.d.ts","sourceRoot":"","sources":["../src/lock-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,YAAY,GAAG,SAAS,CAAA;IACrC,sBAAsB,EAAE,uBAAuB,GAAG,SAAS,CAAA;IAC3D,gBAAgB,EAAE,iBAAiB,GAAG,SAAS,CAAA;IAC/C,mBAAmB,EAAE,oBAAoB,GAAG,SAAS,CAAA;IACrD,gBAAgB,EAAE,iBAAiB,GAAG,SAAS,CAAA;IAC/C,YAAY,EAAE,qBAAqB,GAAG,SAAS,CAAA;IAC/C,kBAAkB,EAAE,mBAAmB,GAAG,SAAS,CAAA;IACnD,cAAc,EAAE,eAAe,GAAG,SAAS,CAAA;CAC5C;AAaD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,OAAO,GAAG,SAAS,EAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAe5B"}

package/dist/lock-adapters.js

@@ -0,0 +1,69 @@
+const EMPTY = {
+    lockAdapter: undefined,
+    webhookDeliveryAdapter: undefined,
+    retentionAdapter: undefined,
+    siteSettingsAdapter: undefined,
+    seoConfigAdapter: undefined,
+    mediaAdapter: undefined,
+    mediaFolderAdapter: undefined,
+    pageCacheStore: undefined,
+};
+/**
+ * Create lock, webhook delivery, retention, site settings, SEO config, media
+ * metadata and media folder adapters, and the shared page cache store, from a
+ * raw database handle.
+ *
+ * Detects whether the handle is SQLite (has `prepare` method) or Postgres
+ * (a callable function with `begin` method) and loads the appropriate adapter package.
+ */
+export async function createLockAdapters(lockDb, persistenceType) {
+    if (!lockDb)
+        return EMPTY;
+    // Postgres: the sql object is a function (tagged template) with a `begin` method
+    if (persistenceType === 'postgres') {
+        return createPostgresAdapters(lockDb);
+    }
+    // SQLite: the db object has a `prepare` method
+    const db = lockDb;
+    if (typeof db.prepare === 'function') {
+        return createSqliteAdapters(lockDb);
+    }
+    return EMPTY;
+}
+async function createSqliteAdapters(lockDb) {
+    try {
+        const mod = (await import('@krantho/persistence-sqlite'));
+        return {
+            lockAdapter: new mod.SqliteLockAdapter(lockDb),
+            webhookDeliveryAdapter: new mod.SqliteWebhookDeliveryAdapter(lockDb),
+            retentionAdapter: new mod.SqliteRetentionAdapter(lockDb),
+            siteSettingsAdapter: new mod.SqliteSiteSettingsAdapter(lockDb),
+            seoConfigAdapter: new mod.SqliteSeoConfigAdapter(lockDb),
+            mediaAdapter: new mod.SqliteMediaAdapter(lockDb),
+            mediaFolderAdapter: new mod.SqliteMediaFolderAdapter(lockDb),
+            pageCacheStore: new mod.SqlitePageCacheStore(lockDb),
+        };
+    }
+    catch {
+        return EMPTY;
+    }
+}
+/**
+ * The Postgres package already loaded for the main adapter, so a failure here is
+ * a real error. It propagates rather than leaving locks, settings and SEO config
+ * silently disabled on a Postgres site.
+ */
+async function createPostgresAdapters(lockDb) {
+    const mod = (await import('@krantho/persistence-postgres'));
+    return {
+        lockAdapter: new mod.PostgresLockAdapter(lockDb),
+        webhookDeliveryAdapter: new mod.PostgresWebhookDeliveryAdapter(lockDb),
+        retentionAdapter: new mod.PostgresRetentionAdapter(lockDb),
+        siteSettingsAdapter: new mod.PostgresSiteSettingsAdapter(lockDb),
+        seoConfigAdapter: new mod.PostgresSeoConfigAdapter(lockDb),
+        mediaAdapter: new mod.PostgresMediaAdapter(lockDb),
+        mediaFolderAdapter: new mod.PostgresMediaFolderAdapter(lockDb),
+        pageCacheStore: new mod.PostgresPageCacheStore(lockDb),
+    };
+}
+//# sourceMappingURL=lock-adapters.js.map

package/dist/lock-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-adapters.js","sourceRoot":"","sources":["../src/lock-adapters.ts"],"names":[],"mappings":"AAsBA,MAAM,KAAK,GAAsB;IAC/B,WAAW,EAAE,SAAS;IACtB,sBAAsB,EAAE,SAAS;IACjC,gBAAgB,EAAE,SAAS;IAC3B,mBAAmB,EAAE,SAAS;IAC9B,gBAAgB,EAAE,SAAS;IAC3B,YAAY,EAAE,SAAS;IACvB,kBAAkB,EAAE,SAAS;IAC7B,cAAc,EAAE,SAAS;CAC1B,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAA2B,EAC3B,eAAoC;IAEpC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IAEzB,iFAAiF;IACjF,IAAI,eAAe,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAA;IACvC,CAAC;IAED,+CAA+C;IAC/C,MAAM,EAAE,GAAG,MAA+B,CAAA;IAC1C,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAA;IACrC,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,MAAe;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,6BAA6B,CAAC,CASvD,CAAA;QACD,OAAO;YACL,WAAW,EAAE,IAAI,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC;YAC9C,sBAAsB,EAAE,IAAI,GAAG,CAAC,4BAA4B,CAAC,MAAM,CAAC;YACpE,gBAAgB,EAAE,IAAI,GAAG,CAAC,sBAAsB,CAAC,MAAM,CAAC;YACxD,mBAAmB,EAAE,IAAI,GAAG,CAAC,yBAAyB,CAAC,MAAM,CAAC;YAC9D,gBAAgB,EAAE,IAAI,GAAG,CAAC,sBAAsB,CAAC,MAAM,CAAC;YACxD,YAAY,EAAE,IAAI,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC;YAChD,kBAAkB,EAAE,IAAI,GAAG,CAAC,wBAAwB,CAAC,MAAM,CAAC;YAC5D,cAAc,EAAE,IAAI,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC;SACrD,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,sBAAsB,CAAC,MAAe;IACnD,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,+BAA+B,CAAC,CASzD,CAAA;IACD,OAAO;QACL,WAAW,EAAE,IAAI,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC;QAChD,sBAAsB,EAAE,IAAI,GAAG,CAAC,8BAA8B,CAAC,MAAM,CAAC;QACtE,gBAAgB,EAAE,IAAI,GAAG,CAAC,wBAAwB,CAAC,MAAM,CAAC;QAC1D,mBAAmB,EAAE,IAAI,GAAG,CAAC,2BAA2B,CAAC,MAAM,CAAC;QAChE,gBAAgB,EAAE,IAAI,GAAG,CAAC,wBAAwB,CAAC,MAAM,CAAC;QAC1D,YAAY,EAAE,IAAI,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC;QAClD,kBAAkB,EAAE,IAAI,GAAG,CAAC,0BAA0B,CAAC,MAAM,CAAC;QAC9D,cAAc,EAAE,IAAI,GAAG,CAAC,sBAAsB,CAAC,MAAM,CAAC;KACvD,CAAA;AACH,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,15 @@
+import type { ContentManifest } from '@krantho/persistence';
+/** The file in the content directory that versions the repository's content */
+export declare const CONTENT_MANIFEST_FILE = "manifest.json";
+/**
+ * Write `<contentDir>/manifest.json`: the content's version and each markdown
+ * file's SHA-256, keyed by its path relative to the content directory, and the git commit the
+ * build ran at when it is known: the baseline a pull of production's edits starts from.
+ *
+ * Run at build time. A deployment whose manifest version is higher than the
+ * database's imports the repository's new and changed files on startup (see
+ * `runContentMigration`), so the version must grow with every content change —
+ * `contentVersion` derives one from git.
+ */
+export declare function generateManifest(contentDir: string, version: number, commit?: string | undefined): Promise<ContentManifest>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAG3D,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,kBAAkB,CAAA;AAEpD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAC1B,OAAO,CAAC,eAAe,CAAC,CAyB1B"}

package/dist/manifest.js

@@ -0,0 +1,39 @@
+import { createHash } from 'node:crypto';
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { contentDateKey } from './content-dates.js';
+/** The file in the content directory that versions the repository's content */
+export const CONTENT_MANIFEST_FILE = 'manifest.json';
+/**
+ * Write `<contentDir>/manifest.json`: the content's version and each markdown
+ * file's SHA-256, keyed by its path relative to the content directory, and the git commit the
+ * build ran at when it is known: the baseline a pull of production's edits starts from.
+ *
+ * Run at build time. A deployment whose manifest version is higher than the
+ * database's imports the repository's new and changed files on startup (see
+ * `runContentMigration`), so the version must grow with every content change —
+ * `contentVersion` derives one from git.
+ */
+export async function generateManifest(contentDir, version, commit) {
+    const files = {};
+    const entries = await readdir(contentDir, { withFileTypes: true, recursive: true });
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.md'))
+            continue;
+        const filePath = join(entry.parentPath, entry.name);
+        const content = await readFile(filePath, 'utf-8');
+        files[contentDateKey(contentDir, filePath)] = {
+            checksum: createHash('sha256').update(content).digest('hex'),
+            size: Buffer.byteLength(content, 'utf-8'),
+        };
+    }
+    const manifest = {
+        version,
+        ...(commit === undefined ? {} : { commit }),
+        generatedAt: new Date().toISOString(),
+        files,
+    };
+    await writeFile(join(contentDir, CONTENT_MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}\n`, 'utf-8');
+    return manifest;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAA;AAEpD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,OAAe,EACf,MAA2B;IAE3B,MAAM,KAAK,GAA6B,EAAE,CAAA;IAC1C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAQ;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QACnD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACjD,KAAK,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,GAAG;YAC5C,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC5D,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;SAC1C,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAoB;QAChC,OAAO;QACP,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3C,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,KAAK;KACN,CAAA;IACD,MAAM,SAAS,CACb,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC,EACvC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EACxC,OAAO,CACR,CAAA;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/mime-types.d.ts

@@ -0,0 +1,3 @@
+/** Common MIME type mappings for static file serving */
+export declare const MIME_TYPES: Record<string, string>;
+//# sourceMappingURL=mime-types.d.ts.map

package/dist/mime-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-types.d.ts","sourceRoot":"","sources":["../src/mime-types.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY7C,CAAA"}

package/dist/mime-types.js

@@ -0,0 +1,15 @@
+/** Common MIME type mappings for static file serving */
+export const MIME_TYPES = {
+    '.html': 'text/html',
+    '.js': 'application/javascript',
+    '.css': 'text/css',
+    '.json': 'application/json',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.woff2': 'font/woff2',
+    '.woff': 'font/woff',
+    '.txt': 'text/plain',
+};
+//# sourceMappingURL=mime-types.js.map

package/dist/mime-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-types.js","sourceRoot":"","sources":["../src/mime-types.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,wBAAwB;IAC/B,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,cAAc;IACtB,QAAQ,EAAE,YAAY;IACtB,OAAO,EAAE,WAAW;IACpB,MAAM,EAAE,YAAY;CACrB,CAAA"}

package/dist/page-cache-rules.d.ts

@@ -0,0 +1,41 @@
+import type { KranthoConfigInput } from '@krantho/config';
+/**
+ * The page cache rules every framework adapter serves pages by.
+ *
+ * A `GET` or `HEAD` outside `/api` and `/studio` renders inside a page request
+ * scope. With a verified signed preview token it reads drafts and answers
+ * never stored and never indexed. Otherwise it reads the published version
+ * and, under `cache.pages: 'cdn'`, a `200` or `404` that sets no cookie and
+ * whose own `Cache-Control` is not `private`, `no-store` or `no-cache` is
+ * cached at the CDN, tagged with every read that rendered it. Everything else
+ * renders outside a scope and gets no headers.
+ */
+/** The request a page is rendered for */
+export interface PageCacheRequest {
+    /** Absolute, or a path with its query string */
+    url: string | URL;
+    method: string;
+}
+/** What the rules need to know about a rendered page's response */
+export interface RenderedPageInfo {
+    status: number;
+    /**
+     * One of the response's own headers by name, in any case — several values
+     * joined with `, ` — or null when it has none
+     */
+    header: (name: string) => string | null;
+}
+/** A rendered page and the headers the rules add to it */
+export interface ServedPage<T> {
+    value: T;
+    headers: Record<string, string>;
+}
+/**
+ * Render one page under the page cache rules.
+ *
+ * Start every content read inside `render`: a read started before it, or one
+ * that outlives it, records no tags. Never call `runPageRequest` inside
+ * `render` — a nested scope's tags do not reach this one.
+ */
+export declare function servePageRequest<T>(request: PageCacheRequest, config: KranthoConfigInput, render: () => Promise<T>, inspect: (value: T) => RenderedPageInfo): Promise<ServedPage<T>>;
+//# sourceMappingURL=page-cache-rules.d.ts.map

package/dist/page-cache-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-cache-rules.d.ts","sourceRoot":"","sources":["../src/page-cache-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAMxE;;;;;;;;;;GAUG;AAEH,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;CACxC;AAED,0DAA0D;AAC1D,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAA;IACR,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAWD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,gBAAgB,GACtC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAYxB"}

package/dist/page-cache-rules.js

@@ -0,0 +1,94 @@
+import { loadConfig } from '@krantho/config/node';
+import { cdnCacheHeaders, previewHeaders } from '@krantho/core';
+import { runPageRequest } from './page-request.js';
+import { verifyPreviewRequest } from './preview-token.js';
+/** `Cache-Control` directives by which a page keeps itself out of any shared cache */
+const UNCACHEABLE_DIRECTIVES = new Set(['private', 'no-store', 'no-cache']);
+/** Paths the krantho API and Studio own — never a page */
+const KRANTHO_PREFIXES = ['/api', '/studio'];
+/** Only a path needs a base; its origin is never used */
+const URL_BASE = 'http://localhost';
+/**
+ * Render one page under the page cache rules.
+ *
+ * Start every content read inside `render`: a read started before it, or one
+ * that outlives it, records no tags. Never call `runPageRequest` inside
+ * `render` — a nested scope's tags do not reach this one.
+ */
+export async function servePageRequest(request, config, render, inspect) {
+    const url = requestUrl(request.url);
+    if (!isPageRequest(url, request.method))
+        return { value: await render(), headers: {} };
+    const resolved = loadConfig({ code: config, env: process.env });
+    if (verifyPreviewRequest(url, resolved)) {
+        const { value } = await runPageRequest({ preview: true }, render);
+        return { value, headers: { ...previewHeaders(), 'Referrer-Policy': 'no-referrer' } };
+    }
+    const { value, tags } = await runPageRequest({ preview: false }, render);
+    return { value, headers: publishedPageHeaders(resolved, inspect(value), tags) };
+}
+/**
+ * A path is appended to the base, never resolved against it: resolving
+ * would read `//studio/x` as the host `admin` and the path `/x`.
+ */
+function requestUrl(url) {
+    if (typeof url === 'string' && url.startsWith('/'))
+        return new URL(`${URL_BASE}${url}`);
+    return new URL(url);
+}
+/** A `GET` or `HEAD` for a path the krantho API and Studio do not own */
+function isPageRequest(url, method) {
+    const verb = method.toUpperCase();
+    if (verb !== 'GET' && verb !== 'HEAD')
+        return false;
+    return !isKranthoPath(url.pathname);
+}
+/**
+ * Whether a path belongs to the API or Studio, however it is spelled:
+ * percent-encoded, in any case, or with repeated slashes. A path that does not
+ * decode is treated as theirs, so it is never cached as a page.
+ */
+function isKranthoPath(pathname) {
+    let path;
+    try {
+        path = decodeURIComponent(pathname);
+    }
+    catch {
+        return true;
+    }
+    const normal = path.replace(/\/{2,}/g, '/').toLowerCase();
+    return KRANTHO_PREFIXES.some((prefix) => normal === prefix || normal.startsWith(`${prefix}/`));
+}
+function publishedPageHeaders(config, page, tags) {
+    const { pages, cdn } = config.cache;
+    if (pages !== 'cdn' || cdn.provider === 'none')
+        return {};
+    if (page.status !== 200 && page.status !== 404)
+        return {};
+    if (!isShareable(page))
+        return {};
+    return cdnCacheHeaders({
+        tags,
+        provider: cdn.provider,
+        sMaxAgeSec: cdn.sMaxAgeSec,
+        staleWhileRevalidateSec: cdn.staleWhileRevalidateSec,
+        tagHeader: cdn.tagHeader,
+    });
+}
+/**
+ * Whether a page's own response lets a shared cache keep it: it sets no
+ * cookie, and its own `Cache-Control`, if any, says none of `private`,
+ * `no-store` or `no-cache` — a page that depends on the visitor's cookie or
+ * credentials says so there, and that header is left as the page set it.
+ */
+function isShareable(page) {
+    if (page.header('set-cookie') !== null)
+        return false;
+    const cacheControl = page.header('cache-control');
+    if (cacheControl === null)
+        return true;
+    return !cacheControl
+        .split(',')
+        .some((directive) => UNCACHEABLE_DIRECTIVES.has(directive.split('=')[0]?.trim().toLowerCase() ?? ''));
+}
+//# sourceMappingURL=page-cache-rules.js.map

package/dist/page-cache-rules.js.map

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

package/dist/page-cache-store.d.ts

@@ -0,0 +1,11 @@
+import type { PersistenceSection } from '@krantho/config';
+import type { IPageCacheStore } from '@krantho/persistence';
+/**
+ * Open the shared page cache store of a site's database.
+ *
+ * Opens the database as the server does — the adapter runs the migrations —
+ * and returns its page cache store. Throws when the backend keeps no page
+ * cache: the filesystem provider has no database to share between instances.
+ */
+export declare function openPageCacheStore(persistence: PersistenceSection): Promise<IPageCacheStore>;
+//# sourceMappingURL=page-cache-store.d.ts.map

package/dist/page-cache-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-cache-store.d.ts","sourceRoot":"","sources":["../src/page-cache-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,kBAAkB,EAAe,MAAM,iBAAiB,CAAA;AAEtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAwB3D;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,kBAAkB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAkB1B"}

package/dist/page-cache-store.js

@@ -0,0 +1,46 @@
+import { mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { DEFAULTS } from '@krantho/config';
+import { createLockAdapters } from './lock-adapters.js';
+import { createAdapter } from './persistence.js';
+/**
+ * The site's default locale the adapter is opened with. The page cache reads no
+ * content and runs without the site's configuration, so it has no locale to
+ * give: an empty one matches no document, where a guessed locale would read
+ * some other language's content.
+ */
+const NO_CONTENT_SITE = { defaultLocale: '' };
+/**
+ * Content status defaults the adapter is opened with. The page cache reads no
+ * content, so the values only satisfy the adapter's options.
+ */
+function contentDefaults() {
+    const status = DEFAULTS.content?.defaultStatus;
+    if (status?.filesystem === undefined) {
+        throw new Error('The configuration defaults name no content.defaultStatus');
+    }
+    return { defaultStatus: { filesystem: status.filesystem } };
+}
+/**
+ * Open the shared page cache store of a site's database.
+ *
+ * Opens the database as the server does — the adapter runs the migrations —
+ * and returns its page cache store. Throws when the backend keeps no page
+ * cache: the filesystem provider has no database to share between instances.
+ */
+export async function openPageCacheStore(persistence) {
+    if (persistence.provider === 'filesystem') {
+        throw new Error('The shared page cache needs a database, but persistence.provider is "filesystem". ' +
+            'Use sqlite or postgres, or set cache.shared to "none".');
+    }
+    if (persistence.provider === 'sqlite') {
+        await mkdir(dirname(persistence.sqlite.path), { recursive: true });
+    }
+    const { lockDb } = await createAdapter(persistence, NO_CONTENT_SITE, contentDefaults(), new Map());
+    const { pageCacheStore } = await createLockAdapters(lockDb, persistence.provider);
+    if (!pageCacheStore) {
+        throw new Error(`The ${persistence.provider} persistence backend could not open the shared page cache store.`);
+    }
+    return pageCacheStore;
+}
+//# sourceMappingURL=page-cache-store.js.map

package/dist/page-cache-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-cache-store.js","sourceRoot":"","sources":["../src/page-cache-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,eAAe,GAAuC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAA;AAEjF;;;GAGG;AACH,SAAS,eAAe;IACtB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC9C,IAAI,MAAM,EAAE,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC7E,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,CAAA;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAA+B;IAE/B,IAAI,WAAW,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,oFAAoF;YAClF,wDAAwD,CAC3D,CAAA;IACH,CAAC;IACD,IAAI,WAAW,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;IAClG,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;IACjF,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,OAAO,WAAW,CAAC,QAAQ,kEAAkE,CAC9F,CAAA;IACH,CAAC;IACD,OAAO,cAAc,CAAA;AACvB,CAAC"}