@krantho/api 0.0.0-stage → 1.0.0

package/dist/jwt.js

@@ -0,0 +1,114 @@
+import { createHmac, randomBytes } from 'node:crypto';
+/** Base64url encode a buffer */
+function base64url(data) {
+    return data.toString('base64url');
+}
+/** Base64url encode a string */
+function base64urlStr(str) {
+    return base64url(Buffer.from(str, 'utf-8'));
+}
+/** Base64url decode to string */
+function base64urlDecode(str) {
+    return Buffer.from(str, 'base64url').toString('utf-8');
+}
+const JWT_HEADER = base64urlStr(JSON.stringify({ alg: 'HS256', typ: 'JWT' }));
+/**
+ * Sign a JWT with HS256.
+ *
+ * @param claims - Token claims (sub, email, name, roles)
+ * @param secret - HMAC secret (`config.auth.jwtSecret`)
+ * @param expiresInSeconds - Token lifetime in seconds (default: 900 = 15 minutes)
+ */
+export function signJwt(claims, secret, expiresInSeconds = 900) {
+    const now = Math.floor(Date.now() / 1000);
+    const payload = {
+        ...claims,
+        iat: now,
+        exp: now + expiresInSeconds,
+    };
+    const payloadEncoded = base64urlStr(JSON.stringify(payload));
+    const data = `${JWT_HEADER}.${payloadEncoded}`;
+    const signature = createHmac('sha256', secret).update(data).digest();
+    return `${data}.${base64url(signature)}`;
+}
+/**
+ * Verify a JWT signature and check expiry.
+ *
+ * @param token - The full JWT string
+ * @param secret - HMAC secret (must match the signing secret)
+ */
+export function verifyJwt(token, secret) {
+    const parts = token.split('.');
+    if (parts.length !== 3) {
+        return { valid: false, error: 'Invalid JWT format' };
+    }
+    const [header, payload, signature] = parts;
+    // Verify signature
+    const data = `${header}.${payload}`;
+    const expectedSignature = createHmac('sha256', secret).update(data).digest();
+    const actualSignature = Buffer.from(signature, 'base64url');
+    if (!expectedSignature.equals(actualSignature)) {
+        return { valid: false, error: 'Invalid signature' };
+    }
+    // Decode and validate claims
+    let claims;
+    try {
+        claims = JSON.parse(base64urlDecode(payload));
+    }
+    catch {
+        return { valid: false, error: 'Invalid JWT payload' };
+    }
+    // Check expiry
+    const now = Math.floor(Date.now() / 1000);
+    if (typeof claims.exp !== 'number' || claims.exp <= now) {
+        return { valid: false, error: 'Token expired' };
+    }
+    // Validate required fields
+    if (typeof claims.sub !== 'string' || !claims.sub) {
+        return { valid: false, error: 'Missing sub claim' };
+    }
+    if (!Array.isArray(claims.roles) || claims.roles.length === 0) {
+        return { valid: false, error: 'Missing roles claim' };
+    }
+    return { valid: true, claims };
+}
+/** Generate a cryptographically random refresh token (64 hex chars) */
+export function generateRefreshToken() {
+    return randomBytes(32).toString('hex');
+}
+/** Hash a refresh token for database storage */
+export function hashRefreshToken(token, secret) {
+    return createHmac('sha256', secret).update(token).digest('hex');
+}
+/** Generate a random JWT secret (for dev mode when none is configured) */
+export function generateJwtSecret() {
+    return randomBytes(32).toString('hex');
+}
+/**
+ * Where the process keeps its ephemeral secret: on `globalThis`, so every copy
+ * of this module a bundler may make (route handlers and pages) shares it
+ */
+const EPHEMERAL_SECRET = Symbol.for('krantho.ephemeralJwtSecret');
+function processSecret() {
+    const store = globalThis;
+    store[EPHEMERAL_SECRET] ??= {};
+    return store[EPHEMERAL_SECRET];
+}
+/**
+ * The effective signing secret: the configured one (KRANTHO_JWT_SECRET beats a
+ * `jwtSecret` set in code, as the config tree resolves it), or, when neither is
+ * set, one ephemeral secret for the whole process — generated with a warning —
+ * so the API and the pages it serves (a signed preview link) agree on it.
+ */
+export function resolveJwtSecret(auth) {
+    if (auth.jwtSecret)
+        return auth.jwtSecret;
+    const secret = processSecret();
+    if (secret.value)
+        return secret.value;
+    // Dev mode: sessions and preview links do not survive restarts
+    secret.value = generateJwtSecret();
+    console.warn('[krantho] No KRANTHO_JWT_SECRET set — using ephemeral secret. Sessions will not survive restarts.');
+    return secret.value;
+}
+//# sourceMappingURL=jwt.js.map

package/dist/jwt.js.map

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

package/dist/locale-fallback.d.ts

@@ -0,0 +1,18 @@
+import type { SiteSection } from '@krantho/config';
+import { type ContentDocument, type IPersistenceAdapter } from '@krantho/persistence';
+/**
+ * Build a locale fallback chain from a requested locale.
+ *
+ * Example: 'es-MX' → ['es-MX', 'es', defaultLocale]
+ * Example: 'fr' → ['fr', defaultLocale]
+ * Example: 'en' (= default) → ['en']
+ */
+export declare function buildFallbackChain(requestedLocale: string, site: SiteSection): string[];
+/**
+ * Get content with locale fallback.
+ *
+ * Tries the requested locale first, then walks the fallback chain.
+ * Returns the first match, or null if no locale has the content.
+ */
+export declare function getContentWithFallback(adapter: IPersistenceAdapter, collection: string, slug: string, locale: string, site: SiteSection): Promise<ContentDocument | null>;
+//# sourceMappingURL=locale-fallback.d.ts.map

package/dist/locale-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-fallback.d.ts","sourceRoot":"","sources":["../src/locale-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,KAAK,eAAe,EAAiB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAEpG;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAkBvF;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAWjC"}

package/dist/locale-fallback.js

@@ -0,0 +1,42 @@
+import { canGetContent } from '@krantho/persistence';
+/**
+ * Build a locale fallback chain from a requested locale.
+ *
+ * Example: 'es-MX' → ['es-MX', 'es', defaultLocale]
+ * Example: 'fr' → ['fr', defaultLocale]
+ * Example: 'en' (= default) → ['en']
+ */
+export function buildFallbackChain(requestedLocale, site) {
+    const defaultLocale = site.defaultLocale ?? site.language;
+    const chain = [requestedLocale];
+    // Add parent locale (e.g. 'es-MX' → 'es')
+    if (requestedLocale.includes('-')) {
+        const parent = requestedLocale.split('-')[0];
+        if (!chain.includes(parent)) {
+            chain.push(parent);
+        }
+    }
+    // Add default locale as final fallback
+    if (!chain.includes(defaultLocale)) {
+        chain.push(defaultLocale);
+    }
+    return chain;
+}
+/**
+ * Get content with locale fallback.
+ *
+ * Tries the requested locale first, then walks the fallback chain.
+ * Returns the first match, or null if no locale has the content.
+ */
+export async function getContentWithFallback(adapter, collection, slug, locale, site) {
+    if (!canGetContent(adapter))
+        return null;
+    const chain = buildFallbackChain(locale, site);
+    for (const loc of chain) {
+        const doc = await adapter.getContent(collection, slug, loc);
+        if (doc)
+            return doc;
+    }
+    return null;
+}
+//# sourceMappingURL=locale-fallback.js.map

package/dist/locale-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-fallback.js","sourceRoot":"","sources":["../src/locale-fallback.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,aAAa,EAA4B,MAAM,sBAAsB,CAAA;AAEpG;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,eAAuB,EAAE,IAAiB;IAC3E,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,QAAQ,CAAA;IACzD,MAAM,KAAK,GAAa,CAAC,eAAe,CAAC,CAAA;IAEzC,0CAA0C;IAC1C,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;QAC7C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC3B,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA4B,EAC5B,UAAkB,EAClB,IAAY,EACZ,MAAc,EACd,IAAiB;IAEjB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IAExC,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAE9C,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;QAC3D,IAAI,GAAG;YAAE,OAAO,GAAG,CAAA;IACrB,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/media-library.d.ts

@@ -0,0 +1,46 @@
+import type { MediaSection } from '@krantho/config';
+import type { BulkDeleteResult, IFileStore, IMediaMetadataAdapter, IMediaStorage, MediaItem, MediaListOptions, MediaStats, MediaUpdateData } from '@krantho/persistence';
+/** The media settings the library enforces */
+export type MediaLibrarySettings = Pick<MediaSection, 'maxFileSize' | 'allowedMimeTypes'>;
+/** An externally uploaded file, as `register` accepts it */
+type RegisteredFile = Parameters<IMediaStorage['register']>[0];
+/**
+ * The media library: metadata in the configured persistence, bytes in the
+ * configured file store. Owns the rules — MIME and size limits, immutable
+ * object keys, dimension detection — and keeps the two in step: a file
+ * written for a failed insert is removed, and a superseded file is deleted
+ * once the metadata no longer points at it.
+ */
+export declare class MediaLibrary implements IMediaStorage {
+    private readonly metadata;
+    private readonly files;
+    private readonly settings;
+    private readonly allowedMimeTypes;
+    constructor(metadata: IMediaMetadataAdapter, files: IFileStore, settings: MediaLibrarySettings);
+    upload(file: Uint8Array, filename: string, mimeType: string): Promise<MediaItem>;
+    register(item: RegisteredFile): Promise<MediaItem>;
+    list(options?: MediaListOptions): Promise<{
+        items: MediaItem[];
+        total: number;
+    }>;
+    get(id: string): Promise<MediaItem | null>;
+    /** Metadata only: a rename changes the display name, never the key or url */
+    update(id: string, updates: MediaUpdateData): Promise<MediaItem | null>;
+    delete(id: string): Promise<void>;
+    bulkDelete(ids: string[]): Promise<BulkDeleteResult>;
+    bulkUpdateAltText(ids: string[], altText: string): Promise<number>;
+    /** Write the new file under a new key, point the record at it, then drop the old file */
+    replace(id: string, file: Uint8Array, filename: string, mimeType: string): Promise<MediaItem | null>;
+    duplicate(id: string): Promise<MediaItem | null>;
+    listTags(): Promise<string[]>;
+    stats(): Promise<MediaStats>;
+    /** Stored bytes from the file store; a registered item is fetched from its url */
+    readOriginal(id: string): Promise<Uint8Array | null>;
+    private assertAccepted;
+    /** Insert a record whose file was just written; the file goes when the insert fails */
+    private insertOrDiscard;
+    /** Append a version pointing at a just-written file; the file goes unless it is now current */
+    private appendOrDiscard;
+}
+export {};
+//# sourceMappingURL=media-library.d.ts.map

package/dist/media-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-library.d.ts","sourceRoot":"","sources":["../src/media-library.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb,SAAS,EACT,gBAAgB,EAGhB,UAAU,EACV,eAAe,EAEhB,MAAM,sBAAsB,CAAA;AAG7B,8CAA8C;AAC9C,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,aAAa,GAAG,kBAAkB,CAAC,CAAA;AAEzF,4DAA4D;AAC5D,KAAK,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAE9D;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,aAAa;IAI9C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;gBAGnC,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,oBAAoB;IAK3C,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAsBhF,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAmBlD,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAKhF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAKhD,6EAA6E;IACvE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAKvE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAcpD,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxE,yFAAyF;IACnF,OAAO,CACX,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAuBtB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAqBhD,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI7B,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAIlC,kFAAkF;IAC5E,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAU1D,OAAO,CAAC,cAAc;IAStB,uFAAuF;YACzE,eAAe;IAS7B,+FAA+F;YACjF,eAAe;CAa9B"}

package/dist/media-library.js

@@ -0,0 +1,231 @@
+import { randomUUID } from 'node:crypto';
+import { detectDimensions } from './image-dimensions.js';
+/**
+ * The media library: metadata in the configured persistence, bytes in the
+ * configured file store. Owns the rules — MIME and size limits, immutable
+ * object keys, dimension detection — and keeps the two in step: a file
+ * written for a failed insert is removed, and a superseded file is deleted
+ * once the metadata no longer points at it.
+ */
+export class MediaLibrary {
+    metadata;
+    files;
+    settings;
+    allowedMimeTypes;
+    constructor(metadata, files, settings) {
+        this.metadata = metadata;
+        this.files = files;
+        this.settings = settings;
+        this.allowedMimeTypes = new Set(settings.allowedMimeTypes);
+    }
+    async upload(file, filename, mimeType) {
+        this.assertAccepted(file, mimeType);
+        const stored = await this.files.put(newKey(filename), file, mimeType);
+        const dimensions = detectDimensions(file);
+        const record = await this.insertOrDiscard(stored.key, {
+            id: randomUUID(),
+            filename,
+            storageKey: stored.key,
+            url: stored.url,
+            altText: '',
+            mimeType,
+            size: file.byteLength,
+            width: dimensions?.width ?? null,
+            height: dimensions?.height ?? null,
+            folder: null,
+            tags: [],
+            crop: null,
+            hotspot: null,
+        });
+        return toMediaItem(record);
+    }
+    async register(item) {
+        const record = await this.metadata.insert({
+            id: randomUUID(),
+            filename: item.filename,
+            storageKey: null,
+            url: item.url,
+            altText: item.altText ?? '',
+            mimeType: item.mimeType,
+            size: item.size,
+            width: item.width,
+            height: item.height,
+            folder: null,
+            tags: [],
+            crop: null,
+            hotspot: null,
+        });
+        return toMediaItem(record);
+    }
+    async list(options) {
+        const { items, total } = await this.metadata.list(options);
+        return { items: items.map(toMediaItem), total };
+    }
+    async get(id) {
+        const record = await this.metadata.get(id);
+        return record ? toMediaItem(record) : null;
+    }
+    /** Metadata only: a rename changes the display name, never the key or url */
+    async update(id, updates) {
+        const record = await this.metadata.appendVersion(id, metadataChanges(updates));
+        return record ? toMediaItem(record) : null;
+    }
+    async delete(id) {
+        const superseded = await this.metadata.markDeleted(id);
+        if (superseded?.storageKey)
+            await this.files.delete(superseded.storageKey);
+    }
+    async bulkDelete(ids) {
+        const deleted = [];
+        const skipped = [];
+        for (const id of ids) {
+            try {
+                await this.delete(id);
+                deleted.push(id);
+            }
+            catch (err) {
+                skipped.push({ id, reason: err instanceof Error ? err.message : 'Unknown error' });
+            }
+        }
+        return { deleted, skipped };
+    }
+    async bulkUpdateAltText(ids, altText) {
+        let count = 0;
+        for (const id of ids) {
+            if (await this.update(id, { altText }))
+                count++;
+        }
+        return count;
+    }
+    /** Write the new file under a new key, point the record at it, then drop the old file */
+    async replace(id, file, filename, mimeType) {
+        const existing = await this.metadata.get(id);
+        if (!existing)
+            return null;
+        this.assertAccepted(file, mimeType);
+        const stored = await this.files.put(newKey(filename), file, mimeType);
+        const dimensions = detectDimensions(file);
+        const record = await this.appendOrDiscard(stored.key, id, {
+            filename,
+            storageKey: stored.key,
+            url: stored.url,
+            mimeType,
+            size: file.byteLength,
+            width: dimensions?.width ?? null,
+            height: dimensions?.height ?? null,
+            crop: null,
+            hotspot: null,
+        });
+        if (!record)
+            return null;
+        if (existing.storageKey)
+            await this.files.delete(existing.storageKey);
+        return toMediaItem(record);
+    }
+    async duplicate(id) {
+        const existing = await this.metadata.get(id);
+        if (!existing)
+            return null;
+        const { createdAt: _createdAt, ...copy } = existing;
+        const newRecord = { ...copy, id: randomUUID() };
+        if (!existing.storageKey)
+            return toMediaItem(await this.metadata.insert(newRecord));
+        const stored = await this.files.copy(existing.storageKey, newKey(existing.filename), existing.mimeType);
+        const record = await this.insertOrDiscard(stored.key, {
+            ...newRecord,
+            storageKey: stored.key,
+            url: stored.url,
+        });
+        return toMediaItem(record);
+    }
+    async listTags() {
+        return this.metadata.listTags();
+    }
+    async stats() {
+        return this.metadata.stats();
+    }
+    /** Stored bytes from the file store; a registered item is fetched from its url */
+    async readOriginal(id) {
+        const record = await this.metadata.get(id);
+        if (!record)
+            return null;
+        if (record.storageKey)
+            return this.files.get(record.storageKey);
+        const response = await fetch(record.url);
+        if (!response.ok)
+            return null;
+        return new Uint8Array(await response.arrayBuffer());
+    }
+    assertAccepted(file, mimeType) {
+        if (!this.allowedMimeTypes.has(mimeType)) {
+            throw new Error(`Unsupported file type: ${mimeType}`);
+        }
+        if (file.byteLength > this.settings.maxFileSize) {
+            throw new Error(`File too large: ${file.byteLength} bytes (max ${this.settings.maxFileSize})`);
+        }
+    }
+    /** Insert a record whose file was just written; the file goes when the insert fails */
+    async insertOrDiscard(key, record) {
+        try {
+            return await this.metadata.insert(record);
+        }
+        catch (err) {
+            await this.files.delete(key);
+            throw err;
+        }
+    }
+    /** Append a version pointing at a just-written file; the file goes unless it is now current */
+    async appendOrDiscard(key, id, changes) {
+        let record = null;
+        try {
+            record = await this.metadata.appendVersion(id, changes);
+            return record;
+        }
+        finally {
+            if (!record)
+                await this.files.delete(key);
+        }
+    }
+}
+/** The public shape of a record: everything but the object key */
+function toMediaItem(record) {
+    const { storageKey: _storageKey, ...item } = record;
+    return item;
+}
+/** Only the fields an update names; the rest of the record carries over */
+function metadataChanges(updates) {
+    const changes = {};
+    if (updates.altText !== undefined)
+        changes.altText = updates.altText;
+    if (updates.folder !== undefined)
+        changes.folder = updates.folder;
+    if (updates.tags !== undefined)
+        changes.tags = updates.tags;
+    if (updates.crop !== undefined)
+        changes.crop = updates.crop;
+    if (updates.hotspot !== undefined)
+        changes.hotspot = updates.hotspot;
+    if (updates.filename !== undefined)
+        changes.filename = updates.filename;
+    return changes;
+}
+/** A fresh, never-reused, flat object key */
+function newKey(filename) {
+    return `${Date.now()}-${randomUUID().slice(0, 8)}-${slugifyFilename(filename)}`;
+}
+/** Lowercase name and extension, every other run of characters a hyphen */
+function slugifyFilename(filename) {
+    const dotIndex = filename.lastIndexOf('.');
+    const name = dotIndex > 0 ? filename.slice(0, dotIndex) : filename;
+    const ext = dotIndex > 0 ? filename.slice(dotIndex + 1) : '';
+    const slug = slugify(name) || 'file';
+    const extension = slugify(ext);
+    return extension ? `${slug}.${extension}` : slug;
+}
+function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+//# sourceMappingURL=media-library.js.map

package/dist/media-library.js.map

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

package/dist/media-reference-updater.d.ts

@@ -0,0 +1,24 @@
+import { type IPersistenceAdapter } from '@krantho/persistence';
+import type { ContentConfig } from '@krantho/schema';
+/** The outcome of a media reference update: documents rewritten, and the ones that could not be */
+export interface MediaReferenceUpdate {
+    readonly updated: number;
+    readonly failed: ReadonlyArray<{
+        collection: string;
+        slug: string;
+        locale: string;
+        reason: string;
+    }>;
+}
+/**
+ * Scan all content for references to an old media URL and update them to the
+ * new URL. Each updated document gets a new version (append-only).
+ *
+ * Scans `fields`, the authored `metadata` (a sharing image, say) and the
+ * markdown `body`. Each write names the version it read and keeps the
+ * document's contract and provenance; a document edited meanwhile is read
+ * again and retried once. A document that still fails is reported, and the
+ * rest are updated all the same.
+ */
+export declare function updateMediaReferences(oldUrl: string, newUrl: string, adapter: IPersistenceAdapter, contentConfig: ContentConfig): Promise<MediaReferenceUpdate>;
+//# sourceMappingURL=media-reference-updater.d.ts.map

package/dist/media-reference-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-reference-updater.d.ts","sourceRoot":"","sources":["../src/media-reference-updater.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,mGAAmG;AACnG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;CACH;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAkB/B"}

package/dist/media-reference-updater.js

@@ -0,0 +1,124 @@
+import { ContentWriteConflict, canGetContent, canQuery, currentIsLive, } from '@krantho/persistence';
+/**
+ * Scan all content for references to an old media URL and update them to the
+ * new URL. Each updated document gets a new version (append-only).
+ *
+ * Scans `fields`, the authored `metadata` (a sharing image, say) and the
+ * markdown `body`. Each write names the version it read and keeps the
+ * document's contract and provenance; a document edited meanwhile is read
+ * again and retried once. A document that still fails is reported, and the
+ * rest are updated all the same.
+ */
+export async function updateMediaReferences(oldUrl, newUrl, adapter, contentConfig) {
+    const collections = [...contentConfig.collections.keys()];
+    if (collections.length === 0 || !canQuery(adapter) || !adapter.writeContent)
+        return { updated: 0, failed: [] };
+    const writer = adapter;
+    let updated = 0;
+    const failed = [];
+    const { items } = await adapter.query({ state: 'current', projection: 'full', collections });
+    for (const item of items) {
+        try {
+            if (await rewriteDocument(writer, item, oldUrl, newUrl))
+                updated++;
+        }
+        catch (error) {
+            const { collection, slug, locale } = item.meta;
+            const reason = error instanceof Error ? error.message : 'unknown error';
+            failed.push({ collection, slug, locale, reason });
+        }
+    }
+    return { updated, failed };
+}
+/** Write the document with the new URL; true when a version was written */
+async function rewriteDocument(adapter, item, oldUrl, newUrl) {
+    let document = item;
+    for (let attempt = 1;; attempt++) {
+        const fields = replaceInFields(document.fields, oldUrl, newUrl);
+        const metadata = replaceInFields(document.metadata, oldUrl, newUrl);
+        const body = document.body.replaceAll(oldUrl, newUrl);
+        if (fields === document.fields && metadata === document.metadata && body === document.body)
+            return false;
+        try {
+            // A live document in step with its page stays live with the new URL;
+            // one with changes ahead gets the new URL in its current version only
+            await adapter.writeContent({
+                collection: document.meta.collection,
+                slug: document.meta.slug,
+                locale: document.meta.locale,
+                fields,
+                body,
+                metadata,
+                contract: document.contract,
+                defaults: document.defaults,
+                repositoryBasis: document.repositoryBasis,
+                publication: currentIsLive(document.meta) ? 'publish' : undefined,
+                expectedVersion: document.meta.version,
+            }, 'media-replace');
+            return true;
+        }
+        catch (error) {
+            if (!(error instanceof ContentWriteConflict) || !canGetContent(adapter) || attempt === 2)
+                throw error;
+            const fresh = await adapter.getContent(document.meta.collection, document.meta.slug, document.meta.locale);
+            // Deleted meanwhile: nothing left that points at the old file
+            if (!fresh)
+                return false;
+            document = fresh;
+        }
+    }
+}
+/**
+ * Recursively replace all string occurrences of oldUrl with newUrl in a fields object.
+ * Returns the same object reference if nothing changed, a new object if changed.
+ */
+function replaceInFields(fields, oldUrl, newUrl) {
+    let changed = false;
+    const result = {};
+    for (const [key, value] of Object.entries(fields)) {
+        if (typeof value === 'string' && value.includes(oldUrl)) {
+            result[key] = value.replaceAll(oldUrl, newUrl);
+            changed = true;
+        }
+        else if (Array.isArray(value)) {
+            const newArr = replaceInArray(value, oldUrl, newUrl);
+            result[key] = newArr.result;
+            if (newArr.changed)
+                changed = true;
+        }
+        else if (value && typeof value === 'object') {
+            const newObj = replaceInFields(value, oldUrl, newUrl);
+            result[key] = newObj;
+            if (newObj !== value)
+                changed = true;
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return changed ? result : fields;
+}
+function replaceInArray(arr, oldUrl, newUrl) {
+    let changed = false;
+    const result = arr.map((item) => {
+        if (typeof item === 'string' && item.includes(oldUrl)) {
+            changed = true;
+            return item.replaceAll(oldUrl, newUrl);
+        }
+        if (item && typeof item === 'object' && !Array.isArray(item)) {
+            const newObj = replaceInFields(item, oldUrl, newUrl);
+            if (newObj !== item)
+                changed = true;
+            return newObj;
+        }
+        if (Array.isArray(item)) {
+            const nested = replaceInArray(item, oldUrl, newUrl);
+            if (nested.changed)
+                changed = true;
+            return nested.result;
+        }
+        return item;
+    });
+    return { result, changed };
+}
+//# sourceMappingURL=media-reference-updater.js.map

package/dist/media-reference-updater.js.map

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