@krantho/server 0.0.0-stage → 1.0.0

package/dist/seo-config-io.js

@@ -0,0 +1,151 @@
+/**
+ * SEO configuration export and import, and seeding the stored configuration.
+ *
+ * Writes per-entity YAML files in the layout `@krantho/config/node` reads
+ * definition files from (`readSeoDefinitions`), so production state
+ * round-trips into a project's `seo.configDir`.
+ *
+ * Layout:
+ *   krantho.seo/
+ *   ├── site/                          ← site-scope entities
+ *   │   ├── professional-service.yaml
+ *   │   ├── website.yaml
+ *   │   ├── founder.person.yaml        ← role.type.yaml
+ *   │   └── _field-mappings.yaml
+ *   ├── collections/{name}/            ← collection-scope entities
+ *   └── routes/{slug-encoded}.yaml
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { encodeRouteSlug, readSeoDefinitions } from '@krantho/config/node';
+import { stringify as stringifyYaml } from 'yaml';
+// ---------------------------------------------------------------------------
+// Export — DB → files
+// ---------------------------------------------------------------------------
+/** Export all SEO config from the database to a directory. */
+export async function exportSeoConfig(adapter, targetDir) {
+    const configs = await adapter.listConfigs();
+    const filesWritten = [];
+    let entitiesExported = 0;
+    for (const config of configs) {
+        const { id, config: data } = config;
+        // Route scope: write all entities with index prefix per pattern
+        if (id.startsWith('route:')) {
+            const routesDir = join(targetDir, 'routes');
+            await mkdir(routesDir, { recursive: true });
+            const pattern = id.slice('route:'.length);
+            const slug = encodeRouteSlug(pattern);
+            for (let i = 0; i < data.entities.length; i++) {
+                const entity = data.entities[i];
+                const prefix = String(i).padStart(2, '0');
+                const filePath = join(routesDir, `${slug}--${prefix}-${entityToFilename(entity)}`);
+                await writeFile(filePath, stringifyEntityYaml(entity), 'utf-8');
+                filesWritten.push(filePath);
+                entitiesExported++;
+            }
+            continue;
+        }
+        const scopeDir = scopeIdToDir(id, targetDir);
+        await mkdir(scopeDir, { recursive: true });
+        // Write entity files with index prefix to preserve order
+        for (let i = 0; i < data.entities.length; i++) {
+            const entity = data.entities[i];
+            const prefix = String(i).padStart(2, '0');
+            const filename = `${prefix}-${entityToFilename(entity)}`;
+            const filePath = join(scopeDir, filename);
+            await writeFile(filePath, stringifyEntityYaml(entity), 'utf-8');
+            filesWritten.push(filePath);
+            entitiesExported++;
+        }
+        // Write field mappings if present
+        if (data.fieldMappings && Object.keys(data.fieldMappings).length > 0) {
+            const mappingsPath = join(scopeDir, '_field-mappings.yaml');
+            await writeFile(mappingsPath, stringifyYaml(data.fieldMappings), 'utf-8');
+            filesWritten.push(mappingsPath);
+        }
+    }
+    return {
+        scopesExported: configs.length,
+        entitiesExported,
+        filesWritten,
+    };
+}
+// ---------------------------------------------------------------------------
+// Import — files → DB
+// ---------------------------------------------------------------------------
+/** Import SEO config from a directory into the database. */
+export async function importSeoConfig(adapter, sourceDir, options) {
+    const mode = options?.mode ?? 'seed';
+    return applySeedConfig(adapter, readSeoDefinitions(sourceDir), mode);
+}
+// ---------------------------------------------------------------------------
+// Seed application — shared by directory loader and programmatic seed
+// ---------------------------------------------------------------------------
+/** Apply a SeoSeedConfig to the database. */
+export async function applySeedConfig(adapter, config, mode = 'seed') {
+    let scopesImported = 0;
+    let entitiesImported = 0;
+    const skipped = [];
+    async function seedScope(id, scope, data) {
+        if (mode === 'seed') {
+            const existing = await adapter.getConfig(id);
+            if (existing) {
+                skipped.push(id);
+                return;
+            }
+        }
+        await adapter.saveConfig({ id, scope, config: data });
+        scopesImported++;
+        entitiesImported += data.entities.length;
+    }
+    if (config.site) {
+        await seedScope('site', 'site', config.site);
+    }
+    for (const [name, data] of Object.entries(config.collections ?? {})) {
+        await seedScope(`collection:${name}`, 'collection', data);
+    }
+    for (const [pattern, data] of Object.entries(config.routes ?? {})) {
+        await seedScope(`route:${pattern}`, 'route', data);
+    }
+    return { scopesImported, entitiesImported, skipped, errors: [] };
+}
+// ---------------------------------------------------------------------------
+// File naming helpers
+// ---------------------------------------------------------------------------
+/** Convert a SeoConfigEntity to a filename. */
+function entityToFilename(entity) {
+    const type = toKebabCase(entity['@type']);
+    if (entity.role) {
+        return `${toKebabCase(entity.role)}.${type}.yaml`;
+    }
+    return `${type}.yaml`;
+}
+/** Convert a scope config ID to a directory path. */
+function scopeIdToDir(id, baseDir) {
+    if (id === 'site')
+        return join(baseDir, 'site');
+    if (id.startsWith('collection:'))
+        return join(baseDir, 'collections', id.slice('collection:'.length));
+    if (id.startsWith('route:')) {
+        return join(baseDir, 'routes');
+    }
+    throw new Error(`Unknown scope ID format: ${id}`);
+}
+/** Stringify an entity as YAML. */
+function stringifyEntityYaml(entity) {
+    const obj = { '@type': entity['@type'] };
+    if (entity['@id'])
+        obj['@id'] = entity['@id'];
+    if (entity.role)
+        obj['role'] = entity.role;
+    obj['properties'] = entity.properties;
+    return stringifyYaml(obj);
+}
+/** Convert PascalCase to kebab-case. */
+function toKebabCase(str) {
+    return str
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        .toLowerCase();
+}
+//# sourceMappingURL=seo-config-io.js.map

package/dist/seo-config-io.js.map

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

package/dist/seo-seed.d.ts

@@ -0,0 +1,12 @@
+import type { KranthoConfig } from '@krantho/config';
+import type { ISeoConfigAdapter } from '@krantho/persistence';
+/**
+ * Seed the stored SEO configuration from the `seo` section, once per process
+ * and database. The handler and the loader both await it before they serve
+ * anything, so no page is composed — and cached — from an unseeded database,
+ * and the seed has nothing to announce. Seeding is idempotent across
+ * processes too: `seed` mode writes only missing rows, and a row is saved
+ * whole, so two instances seeding one database write the same rows.
+ */
+export declare function seedSeoOnce(config: KranthoConfig, adapter: ISeoConfigAdapter): Promise<void>;
+//# sourceMappingURL=seo-seed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seo-seed.d.ts","sourceRoot":"","sources":["../src/seo-seed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,iBAAiB,CAAA;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAa7D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB5F"}

package/dist/seo-seed.js

@@ -0,0 +1,100 @@
+import { resolve } from 'node:path';
+import { isConfigured } from '@krantho/config';
+import { applySeedConfig } from './seo-config-io.js';
+/**
+ * This process's SEO seeds, by database and seed: the API handler and the
+ * content loader open their own connections to one database, and each seed
+ * runs once between them — concurrent first requests share it, and a later
+ * caller does not seed again over edits made since. A failed seed is
+ * forgotten, so the next caller retries it.
+ */
+const seeds = new Map();
+/**
+ * Seed the stored SEO configuration from the `seo` section, once per process
+ * and database. The handler and the loader both await it before they serve
+ * anything, so no page is composed — and cached — from an unseeded database,
+ * and the seed has nothing to announce. Seeding is idempotent across
+ * processes too: `seed` mode writes only missing rows, and a row is saved
+ * whole, so two instances seeding one database write the same rows.
+ */
+export function seedSeoOnce(config, adapter) {
+    if (!isConfigured(config, 'seo'))
+        return Promise.resolve();
+    const plan = seedPlan(config.seo);
+    const key = JSON.stringify([
+        databaseKey(config.persistence),
+        config.seo.definitions,
+        config.seo.seedMode,
+        plan,
+    ]);
+    let seeding = seeds.get(key);
+    if (!seeding) {
+        seeding = seedSeoConfig(config.seo, plan, adapter).catch((err) => {
+            seeds.delete(key);
+            throw err;
+        });
+        seeds.set(key, seeding);
+    }
+    return seeding;
+}
+/** The database a connection opens, whichever connection it is */
+function databaseKey(persistence) {
+    switch (persistence.provider) {
+        case 'sqlite':
+            return `sqlite:${resolve(persistence.sqlite.path)}`;
+        case 'postgres':
+            return `postgres:${persistence.postgres.url ?? ''}`;
+        case 'filesystem':
+            return `filesystem:${resolve(persistence.filesystem.contentPath)}`;
+    }
+}
+/**
+ * Seed SEO config from developer-defined defaults: the definition files the
+ * configuration loaded from `configDir` first, then the section's own shapes.
+ * Seed mode `seed` (the default) keeps stored rows; `overwrite` replaces them.
+ */
+async function seedSeoConfig(seo, plan, adapter) {
+    if (seo.configDir) {
+        await applySeedConfig(adapter, seo.definitions, seo.seedMode);
+    }
+    if (plan.site || plan.collections || plan.routes) {
+        await applySeedConfig(adapter, plan, seo.seedMode);
+    }
+}
+/**
+ * The seed the section's own shapes describe:
+ * 1. Thin: `identity`, `collections`, `routes` — type lists only
+ * 2. Rich: `site`, `richCollections`, `richRoutes` — full entity config, which
+ *    wins over the thin shape for the same scope
+ */
+function seedPlan(seo) {
+    const plan = {};
+    if (seo.site) {
+        plan.site = seo.site;
+    }
+    else if (seo.identity) {
+        plan.site = { entities: [{ '@type': seo.identity, properties: {} }] };
+    }
+    if (Object.keys(seo.richCollections).length > 0) {
+        plan.collections = { ...seo.richCollections };
+    }
+    if (Object.keys(seo.richRoutes).length > 0) {
+        plan.routes = { ...seo.richRoutes };
+    }
+    for (const [collection, types] of Object.entries(seo.collections)) {
+        if (seo.richCollections[collection])
+            continue;
+        plan.collections ??= {};
+        plan.collections[collection] = {
+            entities: types.map((t) => ({ '@type': t, properties: {} })),
+        };
+    }
+    for (const [pattern, types] of Object.entries(seo.routes)) {
+        if (seo.richRoutes[pattern])
+            continue;
+        plan.routes ??= {};
+        plan.routes[pattern] = { entities: types.map((t) => ({ '@type': t, properties: {} })) };
+    }
+    return plan;
+}
+//# sourceMappingURL=seo-seed.js.map

package/dist/seo-seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-seed.js","sourceRoot":"","sources":["../src/seo-seed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEpD;;;;;;GAMG;AACH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAqB,EAAE,OAA0B;IAC3E,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QACzB,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,WAAW;QACtB,MAAM,CAAC,GAAG,CAAC,QAAQ;QACnB,IAAI;KACL,CAAC,CAAA;IACF,IAAI,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACxE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACjB,MAAM,GAAG,CAAA;QACX,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,kEAAkE;AAClE,SAAS,WAAW,CAAC,WAAyC;IAC5D,QAAQ,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC7B,KAAK,QAAQ;YACX,OAAO,UAAU,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAA;QACrD,KAAK,UAAU;YACb,OAAO,YAAY,WAAW,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,EAAE,CAAA;QACrD,KAAK,YAAY;YACf,OAAO,cAAc,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAA;IACtE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,aAAa,CAC1B,GAAe,EACf,IAAmB,EACnB,OAA0B;IAE1B,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,MAAM,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC/D,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACjD,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;IACpD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,GAAe;IAC/B,MAAM,IAAI,GAAkB,EAAE,CAAA;IAE9B,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAA;IACtB,CAAC;SAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,EAAE,CAAA;IACvE,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAA;IAC/C,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,CAAA;IACrC,CAAC;IAED,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAClE,IAAI,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC;YAAE,SAAQ;QAC7C,IAAI,CAAC,WAAW,KAAK,EAAE,CAAA;QACvB,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG;YAC7B,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;SAC7D,CAAA;IACH,CAAC;IAED,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAQ;QACrC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAA;QAClB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAA;IACzF,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/studio-gate.d.ts

@@ -0,0 +1,25 @@
+import type { KranthoConfigInput } from '@krantho/config';
+/** A request for a Studio path, reduced to what serving it needs */
+export interface StudioRequest {
+    url: URL;
+    cookie?: string | undefined;
+}
+/** Serves /studio: the gate, then the SPA files, then the not-built notice */
+export type StudioServer = (request: StudioRequest) => Response;
+/**
+ * Create the /studio server shared by every framework adapter.
+ *
+ * Without configuration, or unless `auth.oidc.studioEntry` is `redirect`, it
+ * serves the Studio SPA as-is and the SPA shows its own sign-in page. With
+ * `redirect`, Studio is served only with a valid access token. Without one,
+ * a browser that holds a refresh token is sent to `GET /api/auth/refresh`,
+ * which issues a new token pair and returns it here — or, when the refresh
+ * token is no longer valid, clears the session and starts a new sign-in. A
+ * browser without either is sent to the OIDC sign-in, which returns it here.
+ * Gated responses are private, so a shared cache never answers for the gate.
+ * The build's hashed assets are served without the gate: they hold no data,
+ * and the SPA fetches chunks lazily — after the access cookie expired, a gated
+ * chunk would redirect and break the running Studio.
+ */
+export declare function createStudioServer(config?: KranthoConfigInput): StudioServer;
+//# sourceMappingURL=studio-gate.d.ts.map

package/dist/studio-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-gate.d.ts","sourceRoot":"","sources":["../src/studio-gate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAItE,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,GAAG,CAAA;IACR,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B;AAED,8EAA8E;AAC9E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,QAAQ,CAAA;AAE/D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAY5E"}

package/dist/studio-gate.js

@@ -0,0 +1,70 @@
+import { accessCookieName, parseCookie, refreshCookieName, verifyJwt } from '@krantho/api';
+import { loadConfig } from '@krantho/config/node';
+import { isStudioBuildAsset, STUDIO_NOT_AVAILABLE_MESSAGE, serveStudioAsset } from './studio.js';
+/**
+ * Create the /studio server shared by every framework adapter.
+ *
+ * Without configuration, or unless `auth.oidc.studioEntry` is `redirect`, it
+ * serves the Studio SPA as-is and the SPA shows its own sign-in page. With
+ * `redirect`, Studio is served only with a valid access token. Without one,
+ * a browser that holds a refresh token is sent to `GET /api/auth/refresh`,
+ * which issues a new token pair and returns it here — or, when the refresh
+ * token is no longer valid, clears the session and starts a new sign-in. A
+ * browser without either is sent to the OIDC sign-in, which returns it here.
+ * Gated responses are private, so a shared cache never answers for the gate.
+ * The build's hashed assets are served without the gate: they hold no data,
+ * and the SPA fetches chunks lazily — after the access cookie expired, a gated
+ * chunk would redirect and break the running Studio.
+ */
+export function createStudioServer(config) {
+    let auth;
+    return (request) => {
+        if (config) {
+            auth ??= loadConfig({ code: config, env: process.env }).auth;
+            if (auth.mode === 'oidc' && auth.oidc.studioEntry === 'redirect') {
+                return serveGated(request, auth);
+            }
+        }
+        return serveStudioAsset(request.url.pathname) ?? studioNotAvailable();
+    };
+}
+function serveGated(request, auth) {
+    if (isStudioBuildAsset(request.url.pathname)) {
+        return serveStudioAsset(request.url.pathname) ?? studioNotAvailable();
+    }
+    const token = parseCookie(request.cookie, accessCookieName(auth.session));
+    // Validation guarantees a JWT secret whenever studioEntry is redirect
+    const hasSession = token !== undefined && auth.jwtSecret !== undefined && verifyJwt(token, auth.jwtSecret).valid;
+    if (hasSession) {
+        const response = serveStudioAsset(request.url.pathname) ?? studioNotAvailable();
+        return privateCopy(response);
+    }
+    const returnTo = encodeURIComponent(request.url.pathname + request.url.search);
+    const canRefresh = Boolean(parseCookie(request.cookie, refreshCookieName(auth.session)));
+    const location = canRefresh
+        ? `/api/auth/refresh?returnTo=${returnTo}`
+        : `/api/auth/login/oidc?returnTo=${returnTo}`;
+    return new Response(null, {
+        status: 302,
+        headers: { location, 'cache-control': 'no-store' },
+    });
+}
+/** Same response, cacheable by the browser only */
+function privateCopy(response) {
+    const headers = new Headers(response.headers);
+    const cacheControl = headers.get('cache-control');
+    let privateControl = 'private';
+    if (cacheControl?.includes('public'))
+        privateControl = cacheControl.replace('public', 'private');
+    else if (cacheControl)
+        privateControl = `private, ${cacheControl}`;
+    headers.set('cache-control', privateControl);
+    return new Response(response.body, { status: response.status, headers });
+}
+function studioNotAvailable() {
+    return new Response(STUDIO_NOT_AVAILABLE_MESSAGE, {
+        status: 503,
+        headers: { 'content-type': 'text/plain' },
+    });
+}
+//# sourceMappingURL=studio-gate.js.map

package/dist/studio-gate.js.map

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

package/dist/studio.d.ts

@@ -0,0 +1,17 @@
+/** Error message when Studio SPA is not built — shared across all server adapters */
+export declare const STUDIO_NOT_AVAILABLE_MESSAGE = "Studio not available. Build it with: pnpm --filter @krantho/studio run build";
+/**
+ * Whether a path names a file of the Studio build's `assets/` directory. Those
+ * files are content-hashed and immutable, and hold no data — the same files
+ * ship in the published `@krantho/studio` package.
+ */
+export declare function isStudioBuildAsset(requestPath: string): boolean;
+/**
+ * Serve admin static assets from @krantho/studio/dist/.
+ *
+ * Returns a Response for the requested file, or the SPA index.html
+ * for client-side routing paths. A missing build asset answers 404, never
+ * index.html. Returns null if admin is not available.
+ */
+export declare function serveStudioAsset(requestPath: string): Response | null;
+//# sourceMappingURL=studio.d.ts.map

package/dist/studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../src/studio.ts"],"names":[],"mappings":"AAKA,qFAAqF;AACrF,eAAO,MAAM,4BAA4B,iFACuC,CAAA;AA6ChF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAgDrE"}

package/dist/studio.js

@@ -0,0 +1,107 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, extname, join, resolve, sep } from 'node:path';
+import { MIME_TYPES } from './mime-types.js';
+/** Error message when Studio SPA is not built — shared across all server adapters */
+export const STUDIO_NOT_AVAILABLE_MESSAGE = 'Studio not available. Build it with: pnpm --filter @krantho/studio run build';
+let studioDistDir;
+/**
+ * Resolve the path to @krantho/studio's dist directory.
+ *
+ * Resolves from the app's own dependencies first: the app installs @krantho/studio,
+ * and resolving from the app root (not from this module) keeps working when a
+ * bundler inlines this package. Walking up from cwd covers a workspace checkout,
+ * or a deployed function where the SPA was traced under `packages/studio/dist`.
+ */
+function getStudioDistDir() {
+    studioDistDir ??= resolveStudioDist() ?? findStudioDistFromCwd();
+    return studioDistDir;
+}
+function resolveStudioDist() {
+    try {
+        const require = createRequire(join(process.cwd(), 'package.json'));
+        return dirname(require.resolve('@krantho/studio/dist/index.html'));
+    }
+    catch {
+        return undefined;
+    }
+}
+function findStudioDistFromCwd() {
+    let dir = process.cwd();
+    while (dir !== resolve(dir, '..')) {
+        const candidate = join(dir, 'node_modules', '@krantho', 'studio', 'dist', 'index.html');
+        if (existsSync(candidate))
+            return join(candidate, '..');
+        // Also check sibling packages (monorepo symlink layout)
+        const sibling = join(dir, 'packages', 'studio', 'dist', 'index.html');
+        if (existsSync(sibling))
+            return join(sibling, '..');
+        dir = resolve(dir, '..');
+    }
+    throw new Error('@krantho/studio is not installed or not built. Run: pnpm --filter @krantho/studio run build');
+}
+/** Where the Studio build puts its content-hashed JS, CSS and fonts */
+const BUILD_ASSETS_PREFIX = '/studio/assets/';
+/**
+ * Whether a path names a file of the Studio build's `assets/` directory. Those
+ * files are content-hashed and immutable, and hold no data — the same files
+ * ship in the published `@krantho/studio` package.
+ */
+export function isStudioBuildAsset(requestPath) {
+    return requestPath.startsWith(BUILD_ASSETS_PREFIX);
+}
+/**
+ * Serve admin static assets from @krantho/studio/dist/.
+ *
+ * Returns a Response for the requested file, or the SPA index.html
+ * for client-side routing paths. A missing build asset answers 404, never
+ * index.html. Returns null if admin is not available.
+ */
+export function serveStudioAsset(requestPath) {
+    let distDir;
+    try {
+        distDir = getStudioDistDir();
+    }
+    catch {
+        return null;
+    }
+    // Strip /studio prefix to get the asset path
+    const assetPath = requestPath.replace(/^\/studio\/?/, '') || 'index.html';
+    const filePath = resolve(join(distDir, assetPath));
+    // Security: prevent path traversal
+    const safeRoot = distDir.endsWith(sep) ? distDir : distDir + sep;
+    if (!filePath.startsWith(safeRoot) && filePath !== resolve(distDir)) {
+        return new Response('Forbidden', { status: 403 });
+    }
+    try {
+        const content = readFileSync(filePath);
+        const ext = extname(filePath);
+        const contentType = MIME_TYPES[ext] ?? 'application/octet-stream';
+        // Build assets are content-hashed and immutable; everything else must revalidate
+        const cacheControl = isStudioBuildAsset(requestPath)
+            ? 'public, max-age=31536000, immutable'
+            : 'no-cache';
+        return new Response(content, {
+            status: 200,
+            headers: { 'content-type': contentType, 'cache-control': cacheControl },
+        });
+    }
+    catch {
+        // A missing chunk must fail as one; index.html in its place is no module
+        if (isStudioBuildAsset(requestPath)) {
+            return new Response('Not found', { status: 404, headers: { 'content-type': 'text/plain' } });
+        }
+        // File not found — serve index.html for SPA client-side routing
+        try {
+            const indexContent = readFileSync(join(distDir, 'index.html'));
+            return new Response(indexContent, {
+                status: 200,
+                headers: { 'content-type': 'text/html', 'cache-control': 'no-cache' },
+            });
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=studio.js.map

package/dist/studio.js.map

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

package/dist/webhook-sweep.d.ts

@@ -0,0 +1,22 @@
+import type { WebhookConfig } from '@krantho/api';
+import type { IWebhookDeliveryAdapter } from '@krantho/persistence';
+/** The least time between two sweeps for deliveries that are due again */
+export declare const WEBHOOK_SWEEP_INTERVAL_MS = 30000;
+export interface WebhookSweepOptions {
+    webhooks: readonly WebhookConfig[];
+    /** The delivery log the sweep reads the due deliveries from and records outcomes in */
+    deliveries: IWebhookDeliveryAdapter;
+    /** Keeps the sweep running until it settles, on hosts that end a request's work with its response */
+    waitUntil?: ((work: Promise<unknown>) => void) | undefined;
+    /** The clock, in milliseconds; tests replace it */
+    now?: (() => number) | undefined;
+}
+/**
+ * Retry the deliveries that are due, without a timer: serverless hosts do not
+ * keep one alive. The returned function is called for every request; it starts
+ * a sweep when none is running and at least {@link WEBHOOK_SWEEP_INTERVAL_MS}
+ * has passed since the last one started, and otherwise does nothing. A sweep
+ * never blocks a request, and a failing one is logged, never thrown.
+ */
+export declare function createWebhookSweep(options: WebhookSweepOptions): () => void;
+//# sourceMappingURL=webhook-sweep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-sweep.d.ts","sourceRoot":"","sources":["../src/webhook-sweep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAEnE,0EAA0E;AAC1E,eAAO,MAAM,yBAAyB,QAAS,CAAA;AAE/C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAA;IAClC,uFAAuF;IACvF,UAAU,EAAE,uBAAuB,CAAA;IACnC,qGAAqG;IACrG,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IAC1D,mDAAmD;IACnD,GAAG,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAA;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAsB3E"}

package/dist/webhook-sweep.js

@@ -0,0 +1,33 @@
+import { processWebhookRetries } from '@krantho/api';
+/** The least time between two sweeps for deliveries that are due again */
+export const WEBHOOK_SWEEP_INTERVAL_MS = 30_000;
+/**
+ * Retry the deliveries that are due, without a timer: serverless hosts do not
+ * keep one alive. The returned function is called for every request; it starts
+ * a sweep when none is running and at least {@link WEBHOOK_SWEEP_INTERVAL_MS}
+ * has passed since the last one started, and otherwise does nothing. A sweep
+ * never blocks a request, and a failing one is logged, never thrown.
+ */
+export function createWebhookSweep(options) {
+    const now = options.now ?? Date.now;
+    let lastStartedAt = Number.NEGATIVE_INFINITY;
+    let running = false;
+    return () => {
+        const startedAt = now();
+        if (running || startedAt - lastStartedAt < WEBHOOK_SWEEP_INTERVAL_MS)
+            return;
+        lastStartedAt = startedAt;
+        running = true;
+        // Read the due deliveries after the request's own synchronous work, not before it
+        const sweep = Promise.resolve()
+            .then(() => processWebhookRetries(options.webhooks, options.deliveries))
+            .catch((err) => {
+            console.warn('[webhook] Retry sweep failed:', err);
+        })
+            .finally(() => {
+            running = false;
+        });
+        options.waitUntil?.(sweep);
+    };
+}
+//# sourceMappingURL=webhook-sweep.js.map

package/dist/webhook-sweep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-sweep.js","sourceRoot":"","sources":["../src/webhook-sweep.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAGpD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAA;AAY/C;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;IACnC,IAAI,aAAa,GAAG,MAAM,CAAC,iBAAiB,CAAA;IAC5C,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,OAAO,GAAG,EAAE;QACV,MAAM,SAAS,GAAG,GAAG,EAAE,CAAA;QACvB,IAAI,OAAO,IAAI,SAAS,GAAG,aAAa,GAAG,yBAAyB;YAAE,OAAM;QAC5E,aAAa,GAAG,SAAS,CAAA;QACzB,OAAO,GAAG,IAAI,CAAA;QAEd,kFAAkF;QAClF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE;aAC5B,IAAI,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;aACvE,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAA;QACpD,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,OAAO,GAAG,KAAK,CAAA;QACjB,CAAC,CAAC,CAAA;QACJ,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAA;IAC5B,CAAC,CAAA;AACH,CAAC"}