gazetta 0.5.0 → 0.7.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC/F,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1D,oBAAoB;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAEnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAGxD,UAAU;AACV,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAE1E,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAGzC,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAElM,iBAAiB;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,8CAA8C;AAC9C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE3F,0GAA0G"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEhD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAA;AAUpG,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uBAAuB,CAAA;AAM9B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,YAAY,CAAA;AAGnB,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAGpB,WAAW;AACX,OAAO,EACL,eAAe,EACf,cAAc,EACd,UAAU,GAGX,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,cAAc,EAA4B,MAAM,UAAU,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC/F,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1D,oBAAoB;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAEnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAGpD,UAAU;AACV,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAE1E,2EAA2E;AAC3E,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAG9E,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAGzC,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAE9B,iBAAiB;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,8CAA8C;AAC9C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE3F,0GAA0G"}

package/dist/locale.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Locale resolution — single source of truth for locale configuration.
+ *
+ * Resolves the effective locale settings for a site and for each target,
+ * applying inheritance (target inherits from site) and inference
+ * (single-locale target auto-infers its default).
+ *
+ * All locale logic goes through this module. Consumers (renderer, publisher,
+ * CLI, admin API) call these functions instead of reading raw config fields.
+ */
+import type { SiteManifest, TargetConfig } from './types.js';
+/** Resolved locale settings for a site or target. */
+export interface ResolvedLocales {
+    /** All supported locale codes, normalized to lowercase. */
+    supported: string[];
+    /** The default locale code. */
+    default: string;
+    /** Whether the default locale gets a URL prefix. */
+    defaultPrefix: boolean;
+    /** Whether Accept-Language detection/redirect is enabled. */
+    detection: boolean;
+    /** Fallback chains. E.g. { 'pt-br': 'pt' }. */
+    fallbacks: Record<string, string>;
+}
+/**
+ * Validate a locale code against BCP 47 pattern.
+ * Rejects path traversal (../), dots (fr.json), scripts, empty strings,
+ * and anything that isn't a simple language or language-region code.
+ */
+export declare function isValidLocale(locale: string): boolean;
+/** Normalize a BCP 47 locale code to lowercase for filenames. */
+export declare function normalizeLocale(locale: string): string;
+/**
+ * Resolve the default locale for a site manifest.
+ * Chain: explicit `locale` field → first in `locales.supported` → 'en'.
+ */
+export declare function defaultLocaleFor(site: SiteManifest): string;
+/**
+ * Resolve site-level locale settings.
+ * Returns null if i18n is not enabled (no `locales` config).
+ */
+export declare function resolveSiteLocales(site: SiteManifest): ResolvedLocales | null;
+/**
+ * Resolve target-level locale settings, inheriting from site.
+ * Returns null if i18n is not enabled at the site level.
+ */
+export declare function resolveTargetLocales(target: TargetConfig, site: SiteManifest): ResolvedLocales | null;
+/**
+ * Resolve the locale for a given filename suffix.
+ * `page.json` → default locale, `page.fr.json` → 'fr'.
+ */
+export declare function localeFromFilename(filename: string, baseName: string): string | null;
+/**
+ * Build the filename for a locale variant.
+ * `('page', null)` → `page.json`, `('page', 'fr')` → `page.fr.json`.
+ */
+export declare function localeFilename(baseName: string, locale: string | null): string;
+/**
+ * Resolve a locale through the fallback chain.
+ * Returns the first locale in the chain that has content,
+ * or the default if nothing matches.
+ *
+ * @param locale - The requested locale
+ * @param available - Set of locales that have content
+ * @param resolved - The resolved locale settings (for fallbacks and default)
+ */
+export declare function resolveLocaleFallback(locale: string, available: Set<string>, resolved: ResolvedLocales): string;
+/**
+ * Build the route prefix for a locale on a given target.
+ * Default locale → '' (no prefix, unless defaultPrefix is true).
+ * Other locales → '/{locale}'.
+ */
+export declare function localeRoutePrefix(locale: string, resolved: ResolvedLocales): string;
+/**
+ * Build the locale fallback chain for a given active locale, EXCLUDING the
+ * default locale (which is always read separately as the base manifest).
+ *
+ * Distinct from `resolveLocaleFallback` (which is "first-found-wins" page
+ * resolution). This helper supports **per-field cascade** in asset metadata:
+ * the asset walker reads each variant in chain order and merges most-specific-
+ * wins, so a French page can pick up `pt-BR` alt overrides through the
+ * configured `pt-BR → pt` fallback while still using default for everything
+ * else.
+ *
+ * Examples (with site default `en`, fallbacks `{ 'pt-BR': 'pt' }`):
+ *   localeFallbackChain('pt-BR', resolved) → ['pt-br', 'pt']
+ *   localeFallbackChain('fr', resolved)    → ['fr']
+ *   localeFallbackChain('en', resolved)    → []  (active === default; no chain)
+ *
+ * The default locale never appears in the chain — callers always read the
+ * default manifest first as the base, then apply the chain on top.
+ */
+export declare function localeFallbackChain(locale: string, resolved: ResolvedLocales): readonly string[];
+//# sourceMappingURL=locale.d.ts.map

package/dist/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAA;AAE3E,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,aAAa,EAAE,OAAO,CAAA;IACtB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAKD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,IAAI,CAY7E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,IAAI,CAsBrG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWpF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAG9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,CAiB/G;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,CAInF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,SAAS,MAAM,EAAE,CAehG"}

package/dist/locale.js

@@ -0,0 +1,188 @@
+/**
+ * Locale resolution — single source of truth for locale configuration.
+ *
+ * Resolves the effective locale settings for a site and for each target,
+ * applying inheritance (target inherits from site) and inference
+ * (single-locale target auto-infers its default).
+ *
+ * All locale logic goes through this module. Consumers (renderer, publisher,
+ * CLI, admin API) call these functions instead of reading raw config fields.
+ */
+/** BCP 47 locale code pattern: 2-letter language, optional region subtag. */
+const LOCALE_PATTERN = /^[a-z]{2}(-[a-z]{2,8})?$/;
+/**
+ * Validate a locale code against BCP 47 pattern.
+ * Rejects path traversal (../), dots (fr.json), scripts, empty strings,
+ * and anything that isn't a simple language or language-region code.
+ */
+export function isValidLocale(locale) {
+    return LOCALE_PATTERN.test(locale.toLowerCase());
+}
+/** Normalize a BCP 47 locale code to lowercase for filenames. */
+export function normalizeLocale(locale) {
+    return locale.toLowerCase();
+}
+/**
+ * Resolve the default locale for a site manifest.
+ * Chain: explicit `locale` field → first in `locales.supported` → 'en'.
+ */
+export function defaultLocaleFor(site) {
+    return site.locale ?? site.locales?.supported?.[0] ?? 'en';
+}
+/**
+ * Resolve site-level locale settings.
+ * Returns null if i18n is not enabled (no `locales` config).
+ */
+export function resolveSiteLocales(site) {
+    if (!site.locales)
+        return null;
+    const supported = site.locales.supported.map(normalizeLocale);
+    if (supported.length === 0)
+        return null;
+    const defaultLocale = normalizeLocale(defaultLocaleFor(site));
+    return {
+        supported,
+        default: defaultLocale,
+        defaultPrefix: site.locales.defaultPrefix ?? false,
+        detection: site.locales.detection ?? false,
+        fallbacks: normalizeFallbacks(site.locales.fallbacks),
+    };
+}
+/**
+ * Resolve target-level locale settings, inheriting from site.
+ * Returns null if i18n is not enabled at the site level.
+ */
+export function resolveTargetLocales(target, site) {
+    const siteLocales = resolveSiteLocales(site);
+    if (!siteLocales)
+        return null;
+    const supported = target.locales ? target.locales.map(normalizeLocale) : siteLocales.supported;
+    const defaultLocale = target.locale
+        ? normalizeLocale(target.locale)
+        : supported.length === 1
+            ? supported[0] // single-locale target: the only locale IS the default
+            : siteLocales.default;
+    return {
+        supported,
+        default: defaultLocale,
+        defaultPrefix: target.defaultPrefix ?? siteLocales.defaultPrefix,
+        detection: supported.length === 1
+            ? false // single-locale: nothing to detect
+            : (target.detection ?? siteLocales.detection),
+        fallbacks: siteLocales.fallbacks,
+    };
+}
+/**
+ * Resolve the locale for a given filename suffix.
+ * `page.json` → default locale, `page.fr.json` → 'fr'.
+ */
+export function localeFromFilename(filename, baseName) {
+    // page.json → null (default)
+    if (filename === `${baseName}.json`)
+        return null;
+    // page.fr.json → 'fr', page.en-gb.json → 'en-gb'
+    const prefix = `${baseName}.`;
+    const suffix = '.json';
+    if (filename.startsWith(prefix) && filename.endsWith(suffix)) {
+        const locale = filename.slice(prefix.length, -suffix.length);
+        return locale || null;
+    }
+    return null;
+}
+/**
+ * Build the filename for a locale variant.
+ * `('page', null)` → `page.json`, `('page', 'fr')` → `page.fr.json`.
+ */
+export function localeFilename(baseName, locale) {
+    if (!locale)
+        return `${baseName}.json`;
+    return `${baseName}.${normalizeLocale(locale)}.json`;
+}
+/**
+ * Resolve a locale through the fallback chain.
+ * Returns the first locale in the chain that has content,
+ * or the default if nothing matches.
+ *
+ * @param locale - The requested locale
+ * @param available - Set of locales that have content
+ * @param resolved - The resolved locale settings (for fallbacks and default)
+ */
+export function resolveLocaleFallback(locale, available, resolved) {
+    const norm = normalizeLocale(locale);
+    if (available.has(norm))
+        return norm;
+    // Walk fallback chain
+    let current = norm;
+    while (resolved.fallbacks[current]) {
+        current = resolved.fallbacks[current];
+        if (available.has(current))
+            return current;
+    }
+    // Fall back to default
+    if (available.has(resolved.default))
+        return resolved.default;
+    // Last resort: first available
+    for (const loc of available)
+        return loc;
+    return resolved.default;
+}
+/**
+ * Build the route prefix for a locale on a given target.
+ * Default locale → '' (no prefix, unless defaultPrefix is true).
+ * Other locales → '/{locale}'.
+ */
+export function localeRoutePrefix(locale, resolved) {
+    const norm = normalizeLocale(locale);
+    if (norm === resolved.default && !resolved.defaultPrefix)
+        return '';
+    return `/${norm}`;
+}
+/**
+ * Build the locale fallback chain for a given active locale, EXCLUDING the
+ * default locale (which is always read separately as the base manifest).
+ *
+ * Distinct from `resolveLocaleFallback` (which is "first-found-wins" page
+ * resolution). This helper supports **per-field cascade** in asset metadata:
+ * the asset walker reads each variant in chain order and merges most-specific-
+ * wins, so a French page can pick up `pt-BR` alt overrides through the
+ * configured `pt-BR → pt` fallback while still using default for everything
+ * else.
+ *
+ * Examples (with site default `en`, fallbacks `{ 'pt-BR': 'pt' }`):
+ *   localeFallbackChain('pt-BR', resolved) → ['pt-br', 'pt']
+ *   localeFallbackChain('fr', resolved)    → ['fr']
+ *   localeFallbackChain('en', resolved)    → []  (active === default; no chain)
+ *
+ * The default locale never appears in the chain — callers always read the
+ * default manifest first as the base, then apply the chain on top.
+ */
+export function localeFallbackChain(locale, resolved) {
+    const norm = normalizeLocale(locale);
+    if (norm === resolved.default)
+        return [];
+    const chain = [norm];
+    const visited = new Set([norm]);
+    let current = norm;
+    while (resolved.fallbacks[current]) {
+        const next = resolved.fallbacks[current];
+        if (next === resolved.default)
+            break;
+        if (visited.has(next))
+            break; // cycle: stop, never re-visit
+        visited.add(next);
+        chain.push(next);
+        current = next;
+    }
+    return chain;
+}
+/** Normalize fallback keys and values to lowercase. */
+function normalizeFallbacks(fallbacks) {
+    if (!fallbacks)
+        return {};
+    const result = {};
+    for (const [key, value] of Object.entries(fallbacks)) {
+        result[normalizeLocale(key)] = normalizeLocale(value);
+    }
+    return result;
+}
+//# sourceMappingURL=locale.js.map

package/dist/locale.js.map

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

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAiD/G,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAYzG;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAYzG;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAUjH"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,gBAAgB,EAEhB,YAAY,EACZ,YAAY,EACZ,eAAe,EAChB,MAAM,YAAY,CAAA;AAiDnB,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAazG;AAcD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAazG;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAUjH"}

package/dist/manifest.js

@@ -56,10 +56,24 @@ export async function parseSiteManifest(storage, filePath) {
         name: raw.name,
         version: raw.version,
         locale: raw.locale,
-        baseUrl: raw.baseUrl,
+        locales: parseLocalesConfig(raw.locales),
+        defaultOgImage: raw.defaultOgImage,
         systemPages: Array.isArray(raw.systemPages) ? raw.systemPages : undefined,
     };
 }
+function parseLocalesConfig(raw) {
+    if (!raw || typeof raw !== 'object')
+        return undefined;
+    const obj = raw;
+    if (!Array.isArray(obj.supported) || obj.supported.length === 0)
+        return undefined;
+    return {
+        supported: obj.supported,
+        fallbacks: obj.fallbacks,
+        defaultPrefix: typeof obj.defaultPrefix === 'boolean' ? obj.defaultPrefix : undefined,
+        detection: typeof obj.detection === 'boolean' ? obj.detection : undefined,
+    };
+}
 export async function parsePageManifest(storage, filePath) {
     const raw = parseJson(await storage.readFile(filePath), filePath);
     if (typeof raw.template !== 'string') {
@@ -70,6 +84,7 @@ export async function parsePageManifest(storage, filePath) {
         template: raw.template,
         content: raw.content,
         components: parseComponents(raw.components),
+        metadata: raw.metadata,
         cache: raw.cache,
     };
 }

package/dist/manifest.js.map

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

package/dist/providers/_atomic-write.d.ts

@@ -0,0 +1,9 @@
+export declare function atomicWriteString(path: string, content: string): Promise<void>;
+/**
+ * Atomic byte write — bytes-in, no string round-trip. Used by callers
+ * that have a buffer in hand (history blobs, bounded asset writes).
+ * Same write-then-rename guarantees as atomicWriteString.
+ */
+export declare function atomicWriteBytes(path: string, bytes: Uint8Array): Promise<void>;
+export declare function atomicWriteStream(path: string, stream: ReadableStream<Uint8Array>): Promise<void>;
+//# sourceMappingURL=_atomic-write.d.ts.map

package/dist/providers/_atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_atomic-write.d.ts","sourceRoot":"","sources":["../../src/providers/_atomic-write.ts"],"names":[],"mappings":"AA+BA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBvG"}

package/dist/providers/_atomic-write.js

@@ -0,0 +1,72 @@
+/**
+ * Atomic file write policy for the filesystem provider.
+ *
+ * Both text and binary-stream writes use a write-then-rename strategy so
+ * readers mid-write never see a partial file:
+ *
+ * - Text (`atomicWriteString`): delegates to the `write-file-atomic` package
+ *   (same pattern everyone else in the Node ecosystem uses — sharp's internal
+ *   config, npm's lockfile writer, etc.).
+ * - Binary stream (`atomicWriteStream`): pipes the incoming stream into a
+ *   same-directory temp file, then renames onto the target. Temp is cleaned
+ *   up on pipeline failure.
+ *
+ * Atomicity guarantees:
+ * - POSIX `rename(2)` is atomic within a single filesystem. Node's
+ *   `fs.rename` delegates to it on POSIX systems.
+ * - Windows `MoveFileEx` with `MOVEFILE_REPLACE_EXISTING` is atomic on NTFS
+ *   when source and target are on the same volume — write-file-atomic (for
+ *   text) and our temp-path scheme (for streams) both place the temp file
+ *   in the same directory as the target to meet this requirement.
+ *
+ * This module is filesystem-specific. Cloud storage (R2, S3, Azure) has
+ * naturally atomic single-object PUT and does not need this policy.
+ */
+import { createWriteStream } from 'node:fs';
+import { mkdir, rename, rm } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import writeFileAtomic from 'write-file-atomic';
+import { webReadableToNode } from './_stream-interop.js';
+export async function atomicWriteString(path, content) {
+    // Parent directory must exist before write-file-atomic creates its tempfile
+    // next to the target. Same contract as atomicWriteStream.
+    await mkdir(dirname(path), { recursive: true });
+    await writeFileAtomic(path, content, 'utf-8');
+}
+/**
+ * Atomic byte write — bytes-in, no string round-trip. Used by callers
+ * that have a buffer in hand (history blobs, bounded asset writes).
+ * Same write-then-rename guarantees as atomicWriteString.
+ */
+export async function atomicWriteBytes(path, bytes) {
+    await mkdir(dirname(path), { recursive: true });
+    // write-file-atomic accepts Buffer | Uint8Array directly; no encoding
+    // applied when the second arg is bytes. Wrap in Buffer for consistent
+    // typing across Node versions (Buffer extends Uint8Array).
+    await writeFileAtomic(path, Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength));
+}
+export async function atomicWriteStream(path, stream) {
+    // Parent directory must exist before createWriteStream can create the file.
+    // (`write-file-atomic` handles this for text; for streams we do it ourselves.)
+    await mkdir(dirname(path), { recursive: true });
+    const tmpPath = `${path}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
+    const writer = createWriteStream(tmpPath);
+    try {
+        await pipeline(webReadableToNode(stream), writer);
+    }
+    catch (err) {
+        // Clean up the temp file on pipeline failure; swallow rm errors
+        // (already-missing temp is fine).
+        await rm(tmpPath, { force: true }).catch(() => { });
+        throw err;
+    }
+    try {
+        await rename(tmpPath, path);
+    }
+    catch (err) {
+        await rm(tmpPath, { force: true }).catch(() => { });
+        throw err;
+    }
+}
+//# sourceMappingURL=_atomic-write.js.map

package/dist/providers/_atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_atomic-write.js","sourceRoot":"","sources":["../../src/providers/_atomic-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,eAAe,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAiB,MAAM,sBAAsB,CAAA;AAEvE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAe;IACnE,4EAA4E;IAC5E,0DAA0D;IAC1D,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAiB;IACpE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,sEAAsE;IACtE,sEAAsE;IACtE,2DAA2D;IAC3D,MAAM,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAA;AAC5F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAkC;IACtF,4EAA4E;IAC5E,+EAA+E;IAC/E,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE/C,MAAM,OAAO,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;IACnF,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAEzC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAkB,CAAC,CAAA;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,gEAAgE;QAChE,kCAAkC;QAClC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAClD,MAAM,GAAG,CAAA;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAClD,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC"}

package/dist/providers/_rm-ignore-missing.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Storage adapter utility — idempotent remove via probe-then-delete.
+ *
+ * Uses `exists()` to determine whether the path is present, then `rm()`
+ * only when it is. This delegates the "is it missing?" decision to the
+ * provider's own `exists()` implementation — no cross-provider error-
+ * shape matching needed.
+ *
+ * Why probe-then-delete instead of try/catch:
+ * - `exists()` is already part of the StorageProvider contract and every
+ *   provider knows how to answer it correctly for its backend.
+ * - Matching raw error messages (`ENOENT`, `NoSuchKey`, etc.) across four
+ *   providers is fragile and accumulates drift as providers version.
+ * - A TOCTOU race (file deleted between probe and rm) just means `rm()`
+ *   throws, and the caller sees a real error — acceptable because the
+ *   race is vanishingly rare in our single-writer model (the admin is the
+ *   only writer on source content during v1).
+ *
+ * When the storage interface grows a typed `StorageNotFoundError`
+ * (separate PR — retrofit across all four providers + all existing `rm`
+ * callers), this helper becomes a one-liner try/catch. Until then, the
+ * probe is the honest abstraction boundary.
+ */
+import type { StorageProvider } from '../types.js';
+/**
+ * `rm(path)` that swallows "already missing" — probes with `exists()`
+ * first. Returns `true` if a file was actually removed, `false` if it
+ * was already gone. Callers that care can distinguish.
+ */
+export declare function rmIgnoreMissing(storage: StorageProvider, path: string): Promise<boolean>;
+//# sourceMappingURL=_rm-ignore-missing.d.ts.map

package/dist/providers/_rm-ignore-missing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_rm-ignore-missing.d.ts","sourceRoot":"","sources":["../../src/providers/_rm-ignore-missing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI9F"}

package/dist/providers/_rm-ignore-missing.js

@@ -0,0 +1,12 @@
+/**
+ * `rm(path)` that swallows "already missing" — probes with `exists()`
+ * first. Returns `true` if a file was actually removed, `false` if it
+ * was already gone. Callers that care can distinguish.
+ */
+export async function rmIgnoreMissing(storage, path) {
+    if (!(await storage.exists(path)))
+        return false;
+    await storage.rm(path);
+    return true;
+}
+//# sourceMappingURL=_rm-ignore-missing.js.map

package/dist/providers/_rm-ignore-missing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_rm-ignore-missing.js","sourceRoot":"","sources":["../../src/providers/_rm-ignore-missing.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAwB,EAAE,IAAY;IAC1E,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IAC/C,MAAM,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;IACtB,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/providers/_stream-interop.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Stream interoperability between Node's `stream` module and the WHATWG
+ * `ReadableStream` web standard.
+ *
+ * Node 16.5+ provides `Readable.toWeb` / `Readable.fromWeb`, but the types
+ * are subtly wrong for our use case — they return/accept the `node:stream/web`
+ * variant of `ReadableStream` rather than the lib-dom global. These helpers
+ * do the single-point type coercion so every consumer of the filesystem
+ * provider's streaming methods (and future providers) sees the standard
+ * web type without casting at each call site.
+ */
+import { Readable, type Writable } from 'node:stream';
+/** Coerce a Node Readable into the standard `ReadableStream<Uint8Array>`. */
+export declare function nodeReadableToWeb(stream: Readable): ReadableStream<Uint8Array>;
+/** Coerce a standard `ReadableStream<Uint8Array>` into a Node Readable. */
+export declare function webReadableToNode(stream: ReadableStream<Uint8Array>): Readable;
+/**
+ * Re-exported type alias — callers doing `pipeline(webReadableToNode(s), writer)`
+ * need the Writable type for the writer argument, but the Node `stream` module's
+ * typing is verbose to import in every provider.
+ */
+export type { Writable };
+//# sourceMappingURL=_stream-interop.d.ts.map

package/dist/providers/_stream-interop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_stream-interop.d.ts","sourceRoot":"","sources":["../../src/providers/_stream-interop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAErD,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAE9E;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,QAAQ,CAE9E;AAED;;;;GAIG;AACH,YAAY,EAAE,QAAQ,EAAE,CAAA"}

package/dist/providers/_stream-interop.js

@@ -0,0 +1,21 @@
+/**
+ * Stream interoperability between Node's `stream` module and the WHATWG
+ * `ReadableStream` web standard.
+ *
+ * Node 16.5+ provides `Readable.toWeb` / `Readable.fromWeb`, but the types
+ * are subtly wrong for our use case — they return/accept the `node:stream/web`
+ * variant of `ReadableStream` rather than the lib-dom global. These helpers
+ * do the single-point type coercion so every consumer of the filesystem
+ * provider's streaming methods (and future providers) sees the standard
+ * web type without casting at each call site.
+ */
+import { Readable } from 'node:stream';
+/** Coerce a Node Readable into the standard `ReadableStream<Uint8Array>`. */
+export function nodeReadableToWeb(stream) {
+    return Readable.toWeb(stream);
+}
+/** Coerce a standard `ReadableStream<Uint8Array>` into a Node Readable. */
+export function webReadableToNode(stream) {
+    return Readable.fromWeb(stream);
+}
+//# sourceMappingURL=_stream-interop.js.map

package/dist/providers/_stream-interop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_stream-interop.js","sourceRoot":"","sources":["../../src/providers/_stream-interop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,QAAQ,EAAiB,MAAM,aAAa,CAAA;AAErD,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,MAAgB;IAChD,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAA+B,CAAA;AAC7D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,MAAkC;IAClE,OAAO,QAAQ,CAAC,OAAO,CAAC,MAA8D,CAAC,CAAA;AACzF,CAAC"}

package/dist/providers/azure-blob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"azure-blob.d.ts","sourceRoot":"","sources":["../../src/providers/azure-blob.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAY,MAAM,aAAa,CAAA;AAE5D,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB;AAWD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,eAAe,GAAG;IAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAiFtH"}
+{"version":3,"file":"azure-blob.d.ts","sourceRoot":"","sources":["../../src/providers/azure-blob.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuB,eAAe,EAAE,MAAM,aAAa,CAAA;AAGvE,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB;AAWD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,eAAe,GAAG;IAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CA0I7C"}