@usecds/server 0.0.0-stage → 0.1.1

package/dist/core/site.js

@@ -0,0 +1,96 @@
+import { validateBlockItem, validatePageItem, validateRouteItem } from "../validation.js";
+// Optional, typed reserved collections describing site structure
+export const ROUTES_COLLECTION = "_routes";
+export const PAGES_COLLECTION = "_pages";
+export const BLOCKS_COLLECTION = "_blocks";
+const byId = (items) => new Map((items ?? []).map((i) => [i.id, i]));
+/**
+ * Checks _routes, _pages and _blocks (each only if present). Throws on the first problem:
+ * schema errors, a route without page or redirect (or both), unknown pages, routes, blocks,
+ * collections or items, redirect cycles, a route without any path, the same path twice in a locale,
+ * and blocks with both items and source.
+ */
+export function validateSite(collections) {
+    const routes = byId(collections[ROUTES_COLLECTION]);
+    const pages = byId(collections[PAGES_COLLECTION]);
+    const blocks = byId(collections[BLOCKS_COLLECTION]);
+    const paths = new Map(); // "locale path" -> route id
+    for (const route of routes.values()) {
+        validateRouteItem(route);
+        if (!!route.page === !!route.redirect) {
+            throw new Error(`Invalid _routes item (${route.id}): needs either a page or a redirect`);
+        }
+        if (route.page && !pages.has(route.page)) {
+            throw new Error(`Invalid _routes item (${route.id}): unknown page "${route.page}"`);
+        }
+        if (route.redirect && !routes.has(route.redirect)) {
+            throw new Error(`Invalid _routes item (${route.id}): redirects to unknown route "${route.redirect}"`);
+        }
+        const localized = Object.entries(route.translations).filter(([, t]) => typeof t?.path === "string");
+        if (localized.length === 0) {
+            throw new Error(`Invalid _routes item (${route.id}): has no path in any locale`);
+        }
+        for (const [locale, t] of localized) {
+            const key = `${locale} ${t.path}`;
+            const existing = paths.get(key);
+            if (existing)
+                throw new Error(`Path ${t.path} (${locale}) is used by routes ${existing} and ${route.id}`);
+            paths.set(key, route.id);
+        }
+    }
+    for (const route of routes.values()) {
+        const seen = new Set([route.id]);
+        let next = route.redirect;
+        while (next) {
+            if (seen.has(next))
+                throw new Error(`Redirect cycle: ${[...seen, next].join(" -> ")}`);
+            seen.add(next);
+            next = routes.get(next)?.redirect;
+        }
+    }
+    for (const page of pages.values()) {
+        validatePageItem(page);
+        for (const blockId of page.blocks ?? []) {
+            if (!blocks.has(blockId))
+                throw new Error(`Invalid _pages item (${page.id}): unknown block "${blockId}"`);
+        }
+    }
+    for (const block of blocks.values()) {
+        validateBlockItem(block);
+        if (block.items && block.source) {
+            throw new Error(`Invalid _blocks item (${block.id}): use either items or source, not both`);
+        }
+        if (block.source && !collections[block.source.collection]) {
+            throw new Error(`Invalid _blocks item (${block.id}): source collection "${block.source.collection}" doesn't exist`);
+        }
+        for (const ref of block.items ?? []) {
+            if (!collections[ref.collection]?.some((i) => i.id === ref.id)) {
+                throw new Error(`Invalid _blocks item (${block.id}): unknown item ${ref.collection}/${ref.id}`);
+            }
+        }
+    }
+}
+/**
+ * Structure that is valid but probably unintended: pages no route shows, blocks no page uses.
+ */
+export function siteRecommendations(collections) {
+    const issues = [];
+    const routedPages = new Set((collections[ROUTES_COLLECTION] ?? []).map((r) => r.page).filter(Boolean));
+    const usedBlocks = new Set((collections[PAGES_COLLECTION] ?? []).flatMap((p) => p.blocks ?? []));
+    if (collections[ROUTES_COLLECTION]) {
+        for (const page of collections[PAGES_COLLECTION] ?? []) {
+            if (!routedPages.has(page.id)) {
+                issues.push({ collection: PAGES_COLLECTION, id: page.id, issue: "unrouted-page", message: `Page ${page.id} isn't shown by any route` });
+            }
+        }
+    }
+    if (collections[PAGES_COLLECTION]) {
+        for (const block of collections[BLOCKS_COLLECTION] ?? []) {
+            if (!usedBlocks.has(block.id)) {
+                issues.push({ collection: BLOCKS_COLLECTION, id: block.id, issue: "unused-block", message: `Block ${block.id} isn't used by any page` });
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=site.js.map

package/dist/core/site.js.map

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

package/dist/core/storage-report.d.ts

@@ -0,0 +1,44 @@
+import { ObjectStore } from "../types.js";
+export interface StoredFile {
+    kind: "object" | "media";
+    hash: string;
+    file: string;
+    bytes: number | null;
+}
+export interface ReleaseDiff {
+    previousReleaseId: string;
+    added: string[];
+    removed: string[];
+    shared: number;
+}
+export interface ReleaseUsage {
+    releaseId: string;
+    channels: string[];
+    objects: number;
+    media: number;
+    bytes: number;
+    uniqueBytes: number;
+    missing: string[];
+    diff: ReleaseDiff | null;
+}
+export interface StorageReport {
+    releases: ReleaseUsage[];
+    channels: Record<string, {
+        releaseId: string;
+        retained: boolean;
+    }>;
+    totals: {
+        objects: number;
+        media: number;
+        bytes: number;
+    };
+    orphans: {
+        files: StoredFile[];
+        bytes: number;
+    };
+}
+/**
+ * Walks the store and reports per-release usage, release-to-release diffs,
+ * channel pointers and orphaned files. Read-only.
+ */
+export declare function analyzeStorage(store: ObjectStore): Promise<StorageReport>;

package/dist/core/storage-report.js

@@ -0,0 +1,112 @@
+/**
+ * Walks the store and reports per-release usage, release-to-release diffs,
+ * channel pointers and orphaned files. Read-only.
+ */
+export async function analyzeStorage(store) {
+    // 1. Inventory of stored files
+    const files = new Map(); // keyed by file path
+    const mediaFilesByHash = new Map();
+    for (const hash of await store.listObjects()) {
+        const file = `objects/${hash}.json`;
+        files.set(file, { kind: "object", hash, file, bytes: await store.objectSize(hash) });
+    }
+    for (const filename of await store.listMedia()) {
+        // Filename is <hash>.<ext>
+        const hash = filename.split(".")[0];
+        const file = `media/${filename}`;
+        files.set(file, { kind: "media", hash, file, bytes: await store.mediaSize(filename) });
+        mediaFilesByHash.set(hash, [...(mediaFilesByHash.get(hash) ?? []), file]);
+    }
+    // 2. Channel pointers
+    const channels = {};
+    const releaseIds = (await store.listReleases()).sort();
+    for (const channel of await store.listChannels()) {
+        const manifest = await store.readChannelManifest(channel);
+        if (manifest) {
+            channels[channel] = { releaseId: manifest.releaseId, retained: releaseIds.includes(manifest.releaseId) };
+        }
+    }
+    // 3. Files referenced by each retained release
+    const referencesByRelease = new Map();
+    for (const releaseId of releaseIds) {
+        const manifest = await store.readRelease(releaseId);
+        if (!manifest)
+            continue;
+        const referenced = new Set();
+        for (const col of Object.values(manifest.collections)) {
+            referenced.add(`objects/${col.hash}.json`);
+        }
+        for (const [virtualPath, med] of Object.entries(manifest.media)) {
+            const stored = mediaFilesByHash.get(med.hash);
+            if (stored) {
+                stored.forEach((f) => referenced.add(f));
+            }
+            else {
+                const ext = virtualPath.includes(".") ? virtualPath.substring(virtualPath.lastIndexOf(".")) : "";
+                referenced.add(`media/${med.hash}${ext}`);
+            }
+        }
+        referencesByRelease.set(releaseId, { files: referenced, manifest });
+    }
+    const referenceCount = new Map();
+    for (const { files: referenced } of referencesByRelease.values()) {
+        referenced.forEach((f) => referenceCount.set(f, (referenceCount.get(f) ?? 0) + 1));
+    }
+    // 4. Per-release usage and diff against the previous retained release
+    const releases = [];
+    let previous = null;
+    for (const [releaseId, { files: referenced }] of referencesByRelease) {
+        const usage = {
+            releaseId,
+            channels: Object.keys(channels).filter((c) => channels[c].releaseId === releaseId),
+            objects: 0,
+            media: 0,
+            bytes: 0,
+            uniqueBytes: 0,
+            missing: [],
+            diff: null
+        };
+        for (const file of referenced) {
+            const stored = files.get(file);
+            if (!stored || stored.bytes === null) {
+                usage.missing.push(file);
+                continue;
+            }
+            if (stored.kind === "object")
+                usage.objects++;
+            else
+                usage.media++;
+            usage.bytes += stored.bytes;
+            if (referenceCount.get(file) === 1)
+                usage.uniqueBytes += stored.bytes;
+        }
+        if (previous) {
+            const prevFiles = previous.files;
+            usage.diff = {
+                previousReleaseId: previous.releaseId,
+                added: [...referenced].filter((f) => !prevFiles.has(f)),
+                removed: [...prevFiles].filter((f) => !referenced.has(f)),
+                shared: [...referenced].filter((f) => prevFiles.has(f)).length
+            };
+        }
+        releases.push(usage);
+        previous = { releaseId, files: referenced };
+    }
+    // 5. Totals and orphans
+    const all = [...files.values()];
+    const orphanFiles = all.filter((f) => !referenceCount.has(f.file));
+    return {
+        releases,
+        channels,
+        totals: {
+            objects: all.filter((f) => f.kind === "object").length,
+            media: all.filter((f) => f.kind === "media").length,
+            bytes: sum(all)
+        },
+        orphans: { files: orphanFiles, bytes: sum(orphanFiles) }
+    };
+}
+function sum(files) {
+    return files.reduce((total, f) => total + (f.bytes ?? 0), 0);
+}
+//# sourceMappingURL=storage-report.js.map

package/dist/core/storage-report.js.map

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

package/dist/core/targets.d.ts

@@ -0,0 +1,63 @@
+export declare const DEFAULT_TARGET_ID = "default";
+export declare const RECOMMENDED_MAX_TARGETS = 8;
+export interface CollectionRules {
+    localized?: object;
+    fields?: object;
+}
+export interface CollectionRequirements extends CollectionRules {
+    minItems?: number;
+    presets?: string[];
+}
+export interface MediaPreset {
+    aspect?: string;
+    fit?: "fill" | "fit";
+    widths: Record<string, number>;
+    formats?: ("avif" | "webp" | "jpeg" | "png")[];
+    quality?: number;
+    lossless?: boolean;
+    background?: string;
+}
+export interface TargetDefinition {
+    id: string;
+    scope?: string[];
+    locales?: {
+        required?: string[];
+        minCompleteness?: number;
+        maxStale?: number;
+    };
+    collections?: Record<string, CollectionRequirements>;
+    items?: {
+        collection: string;
+        key: string;
+    }[];
+    recommendations?: Record<string, CollectionRules>;
+    media?: {
+        breakpoints?: Record<string, number>;
+        dpr?: number[];
+        presets?: Record<string, MediaPreset>;
+    };
+}
+/**
+ * Used when no default target is provided.
+ */
+export declare const BUILTIN_DEFAULT_TARGET: TargetDefinition;
+export interface ResolvedTargets {
+    defaultTarget: TargetDefinition;
+    named: TargetDefinition[];
+    effective: Record<string, TargetDefinition>;
+    warnings: string[];
+}
+/**
+ * Loads all *.json target definitions from a folder. default.json is the default target.
+ */
+export declare function loadTargets(dir: string): Promise<TargetDefinition[]>;
+/**
+ * Validates the given definitions, picks the default target (built-in if none) and
+ * computes each named target's effective definition (default merged with its own).
+ */
+export declare function resolveTargets(definitions: TargetDefinition[]): ResolvedTargets;
+/**
+ * Additive merge: lists are combined, thresholds take the stricter value, schemas are
+ * combined with allOf (both must pass). Nothing is overwritten. Scope is the named target's own.
+ */
+export declare function mergeTargets(base: TargetDefinition, own: TargetDefinition): TargetDefinition;

package/dist/core/targets.js

@@ -0,0 +1,213 @@
+import fs from "fs/promises";
+import path from "path";
+import { deterministicStringify } from "../utils.js";
+import { validateTargetDefinition } from "../validation.js";
+export const DEFAULT_TARGET_ID = "default";
+export const RECOMMENDED_MAX_TARGETS = 8;
+/**
+ * Used when no default target is provided.
+ */
+export const BUILTIN_DEFAULT_TARGET = {
+    id: DEFAULT_TARGET_ID,
+    recommendations: {
+        _media: {
+            localized: {
+                type: "object",
+                required: ["alt", "description"],
+                properties: {
+                    alt: { type: "string", minLength: 1, maxLength: 125 },
+                    description: { type: "string", minLength: 50, maxLength: 300 }
+                }
+            }
+        },
+        _pages: {
+            localized: {
+                type: "object",
+                required: ["title", "description"],
+                properties: {
+                    title: { type: "string", minLength: 1, maxLength: 60 },
+                    description: { type: "string", minLength: 50, maxLength: 160 }
+                }
+            }
+        }
+    }
+};
+/**
+ * Loads all *.json target definitions from a folder. default.json is the default target.
+ */
+export async function loadTargets(dir) {
+    const files = (await fs.readdir(dir)).filter((f) => f.endsWith(".json")).sort();
+    const targets = [];
+    for (const file of files) {
+        const target = JSON.parse(await fs.readFile(path.join(dir, file), "utf-8"));
+        validateTargetDefinition(target);
+        const expectedDefault = file === `${DEFAULT_TARGET_ID}.json`;
+        if (expectedDefault !== (target.id === DEFAULT_TARGET_ID)) {
+            throw new Error(`Target file ${file}: only default.json may (and must) use the id "${DEFAULT_TARGET_ID}"`);
+        }
+        targets.push(target);
+    }
+    return targets;
+}
+/**
+ * Validates the given definitions, picks the default target (built-in if none) and
+ * computes each named target's effective definition (default merged with its own).
+ */
+export function resolveTargets(definitions) {
+    const warnings = [];
+    const seen = new Set();
+    for (const def of definitions) {
+        validateTargetDefinition(def);
+        if (seen.has(def.id))
+            throw new Error(`Duplicate target id: ${def.id}`);
+        seen.add(def.id);
+        if (def.id !== DEFAULT_TARGET_ID)
+            checkOwnScope(def);
+    }
+    const defaultTarget = definitions.find((d) => d.id === DEFAULT_TARGET_ID) ?? BUILTIN_DEFAULT_TARGET;
+    if (defaultTarget.scope) {
+        throw new Error(`The default target applies to everything and can't declare a scope`);
+    }
+    const named = definitions.filter((d) => d.id !== DEFAULT_TARGET_ID);
+    if (named.length > RECOMMENDED_MAX_TARGETS) {
+        warnings.push(`${named.length} named targets; the recommended maximum is ${RECOMMENDED_MAX_TARGETS}`);
+    }
+    checkPresetConflicts([defaultTarget, ...named]);
+    checkBreakpoints([defaultTarget, ...named]);
+    const effective = { [DEFAULT_TARGET_ID]: defaultTarget };
+    for (const target of named) {
+        effective[target.id] = mergeTargets(defaultTarget, target);
+    }
+    return { defaultTarget, named, effective, warnings };
+}
+/**
+ * Additive merge: lists are combined, thresholds take the stricter value, schemas are
+ * combined with allOf (both must pass). Nothing is overwritten. Scope is the named target's own.
+ */
+export function mergeTargets(base, own) {
+    const merged = { id: own.id };
+    if (own.scope)
+        merged.scope = [...own.scope];
+    const locales = {
+        required: union(base.locales?.required, own.locales?.required),
+        minCompleteness: stricter(base.locales?.minCompleteness, own.locales?.minCompleteness, Math.max),
+        maxStale: stricter(base.locales?.maxStale, own.locales?.maxStale, Math.min)
+    };
+    if (locales.required || locales.minCompleteness !== undefined || locales.maxStale !== undefined) {
+        merged.locales = dropUndefined(locales);
+    }
+    const collections = mergeRecords(base.collections, own.collections, (a, b) => dropUndefined({
+        minItems: stricter(a.minItems, b.minItems, Math.max),
+        localized: allOf(a.localized, b.localized),
+        fields: allOf(a.fields, b.fields),
+        presets: union(a.presets, b.presets)
+    }));
+    if (collections)
+        merged.collections = collections;
+    const items = unionBy([...(base.items ?? []), ...(own.items ?? [])], (i) => `${i.collection}\u0000${i.key}`);
+    if (items.length)
+        merged.items = items;
+    const recommendations = mergeRecords(base.recommendations, own.recommendations, (a, b) => dropUndefined({ localized: allOf(a.localized, b.localized), fields: allOf(a.fields, b.fields) }));
+    if (recommendations)
+        merged.recommendations = recommendations;
+    if (base.media || own.media) {
+        merged.media = dropUndefined({
+            breakpoints: base.media?.breakpoints || own.media?.breakpoints
+                ? { ...base.media?.breakpoints, ...own.media?.breakpoints }
+                : undefined,
+            dpr: union(base.media?.dpr, own.media?.dpr)?.sort((x, y) => x - y),
+            presets: base.media?.presets || own.media?.presets ? { ...base.media?.presets, ...own.media?.presets } : undefined
+        });
+    }
+    return merged;
+}
+// A named target's own requirements and recommendations must stay within its own scope
+function checkOwnScope(target) {
+    if (!target.scope)
+        return;
+    const scope = new Set(target.scope);
+    const outside = [
+        ...Object.keys(target.collections ?? {}),
+        ...Object.keys(target.recommendations ?? {}),
+        ...(target.items ?? []).map((i) => i.collection)
+    ].filter((c) => !scope.has(c));
+    if (outside.length) {
+        throw new Error(`Target ${target.id} declares rules outside its scope: ${[...new Set(outside)].join(", ")}`);
+    }
+}
+// All variants land in one release, so a preset name must mean the same thing in every target
+function checkPresetConflicts(targets) {
+    const presets = new Map();
+    for (const target of targets) {
+        for (const [name, preset] of Object.entries(target.media?.presets ?? {})) {
+            const definition = deterministicStringify(preset);
+            const existing = presets.get(name);
+            if (existing && existing.definition !== definition) {
+                throw new Error(`Preset "${name}" is defined differently in targets ${existing.target} and ${target.id}`);
+            }
+            presets.set(name, { target: target.id, definition });
+        }
+    }
+}
+// Breakpoints are shared like presets: one name, one width. Presets may only use declared breakpoints.
+function checkBreakpoints(targets) {
+    const widths = new Map();
+    for (const target of targets) {
+        for (const [name, minWidth] of Object.entries(target.media?.breakpoints ?? {})) {
+            const existing = widths.get(name);
+            if (existing && existing.minWidth !== minWidth) {
+                throw new Error(`Breakpoint "${name}" is defined differently in targets ${existing.target} and ${target.id}`);
+            }
+            widths.set(name, { target: target.id, minWidth });
+        }
+    }
+    for (const target of targets) {
+        for (const [presetName, preset] of Object.entries(target.media?.presets ?? {})) {
+            for (const breakpoint of Object.keys(preset.widths)) {
+                if (!widths.has(breakpoint)) {
+                    throw new Error(`Preset "${presetName}" in target ${target.id} uses unknown breakpoint "${breakpoint}"`);
+                }
+            }
+        }
+    }
+}
+function union(a, b) {
+    if (!a && !b)
+        return undefined;
+    return [...new Set([...(a ?? []), ...(b ?? [])])];
+}
+function unionBy(list, key) {
+    const map = new Map();
+    for (const item of list)
+        map.set(key(item), item);
+    return [...map.values()];
+}
+function stricter(a, b, pick) {
+    if (a === undefined)
+        return b;
+    if (b === undefined)
+        return a;
+    return pick(a, b);
+}
+function allOf(a, b) {
+    if (!a)
+        return b;
+    if (!b)
+        return a;
+    if (deterministicStringify(a) === deterministicStringify(b))
+        return a;
+    return { allOf: [a, b] };
+}
+function mergeRecords(a, b, merge) {
+    if (!a && !b)
+        return undefined;
+    const result = { ...a };
+    for (const [key, value] of Object.entries(b ?? {})) {
+        result[key] = key in result ? merge(result[key], value) : value;
+    }
+    return result;
+}
+function dropUndefined(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+}
+//# sourceMappingURL=targets.js.map

package/dist/core/targets.js.map

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

package/dist/core/translations.d.ts

@@ -0,0 +1,41 @@
+import { CollectionItem, TranslationCounts, TranslationSummary } from "../types.js";
+export declare const DEFAULT_SOURCE_LOCALE = "en";
+export type SourceLocaleOrigin = "argument" | "source" | "inferred" | "fallback";
+export interface TranslationIssue {
+    collection: string;
+    id: string;
+    locale: string;
+    field: string;
+    issue: "missing" | "stale";
+}
+export interface TranslationReport extends TranslationSummary {
+    sourceLocaleOrigin: SourceLocaleOrigin;
+    collections: Record<string, Record<string, TranslationCounts>>;
+    itemsWithoutSource: {
+        collection: string;
+        id: string;
+    }[];
+    issues: TranslationIssue[];
+}
+/**
+ * Hash of a source text, as stored in _provenance translation markers (sourceHash).
+ */
+export declare function translationSourceHash(text: string): string;
+/**
+ * Infers the source locale from _provenance translation markers: the locales of fields marked
+ * "original" plus all "from" locales. Returns undefined unless exactly one candidate exists.
+ */
+export declare function inferSourceLocale(collections: Record<string, CollectionItem[]>): string | undefined;
+export type ItemLocales = (collection: string, item: CollectionItem) => string[] | undefined;
+/**
+ * Measures translation completeness against the source locale.
+ *
+ * - Expected: every source-locale field whose value is a non-empty string. Other source values are ignored.
+ * - Missing: the translation is absent, null or "".
+ * - Stale: the marker's sourceHash differs from the current source text. Without a sourceHash,
+ *   falls back to the previous release: source text changed but the translation didn't.
+ * - Items restricted by itemLocales are only measured in those locales, and skipped entirely
+ *   if they aren't used in the source locale (their texts are originals, not translations).
+ */
+export declare function analyzeTranslations(collections: Record<string, CollectionItem[]>, sourceLocale: string, sourceLocaleOrigin: SourceLocaleOrigin, previous?: Record<string, CollectionItem[]>, itemLocales?: ItemLocales): TranslationReport;
+export declare function toTranslationSummary(report: TranslationReport): TranslationSummary;