@usecds/server 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,18 @@
+export * from "./types.js";
+export * from "./utils.js";
+export * from "./validation.js";
+export { Publisher, PublishRequirementsError } from "./core/publisher.js";
+export * from "./core/storage-report.js";
+export * from "./core/translations.js";
+export * from "./core/targets.js";
+export * from "./core/content-report.js";
+export * from "./core/media-metadata.js";
+export * from "./core/media-names.js";
+export * from "./core/jsonld.js";
+export * from "./core/site.js";
+export * from "./core/menu.js";
+export * from "./core/report.js";
+export * from "./core/content-types.js";
+export { FixtureSource } from "./sources/fixture.js";
+export { FilesystemStore } from "./storage/filesystem.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACL,SAAS,EAKT,wBAAwB,EAGzB,MAAM,qBAAqB,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/sources/fixture.d.ts

@@ -0,0 +1,9 @@
+import { ContentSource, CollectionItem, SourceMedia, SourceMap } from "../types.js";
+export declare class FixtureSource implements ContentSource {
+    private collections;
+    private media;
+    getSourceMap?: () => Promise<SourceMap>;
+    constructor(collections?: Record<string, CollectionItem[]>, media?: SourceMedia[], sourceMap?: SourceMap);
+    getCollections(): Promise<Record<string, CollectionItem[]>>;
+    getMedia(): Promise<SourceMedia[]>;
+}

package/dist/sources/fixture.js

@@ -0,0 +1,79 @@
+export class FixtureSource {
+    collections;
+    media;
+    getSourceMap;
+    constructor(collections, media, sourceMap) {
+        if (sourceMap) {
+            this.getSourceMap = async () => sourceMap;
+        }
+        this.collections = collections || {
+            categories: [
+                {
+                    id: "cat_apparel",
+                    key: "apparel",
+                    translations: {
+                        en: { name: "Apparel" },
+                        de: { name: "Kleidung" }
+                    }
+                },
+                {
+                    id: "cat_electronics",
+                    key: "electronics",
+                    translations: {
+                        en: { name: "Electronics" },
+                        de: { name: "Elektronik" }
+                    }
+                }
+            ],
+            products: [
+                {
+                    id: "prod_tshirt",
+                    key: "classic-tshirt",
+                    translations: {
+                        en: { title: "Classic T-Shirt", description: "An everyday essential." },
+                        de: { title: "Klassisches T-Shirt", description: "Ein Alltags-Klassiker." }
+                    },
+                    references: [
+                        { collection: "categories", id: "cat_apparel" }
+                    ],
+                    media: [
+                        "products/tshirt.png"
+                    ]
+                },
+                {
+                    id: "prod_phone",
+                    key: "smart-phone",
+                    translations: {
+                        en: { title: "Smart Phone", description: "Stay connected." },
+                        de: { title: "Smartphone", description: "Immer in Verbindung." }
+                    },
+                    references: [
+                        { collection: "categories", id: "cat_electronics" }
+                    ],
+                    media: [
+                        "products/phone.png"
+                    ]
+                }
+            ]
+        };
+        this.media = media || [
+            {
+                virtualPath: "products/tshirt.png",
+                content: Buffer.from("fakedata-tshirt-png-image-content-here"),
+                mimeType: "image/png"
+            },
+            {
+                virtualPath: "products/phone.png",
+                content: Buffer.from("fakedata-phone-png-image-content-here"),
+                mimeType: "image/png"
+            }
+        ];
+    }
+    async getCollections() {
+        return this.collections;
+    }
+    async getMedia() {
+        return this.media;
+    }
+}
+//# sourceMappingURL=fixture.js.map

package/dist/sources/fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../../src/sources/fixture.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IAChB,WAAW,CAAmC;IAC9C,KAAK,CAAgB;IAC7B,YAAY,CAA4B;IAExC,YACE,WAA8C,EAC9C,KAAqB,EACrB,SAAqB;QAErB,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,YAAY,GAAG,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI;YAChC,UAAU,EAAE;gBACV;oBACE,EAAE,EAAE,aAAa;oBACjB,GAAG,EAAE,SAAS;oBACd,YAAY,EAAE;wBACZ,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;wBACvB,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;qBACzB;iBACF;gBACD;oBACE,EAAE,EAAE,iBAAiB;oBACrB,GAAG,EAAE,aAAa;oBAClB,YAAY,EAAE;wBACZ,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;wBAC3B,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;qBAC3B;iBACF;aACF;YACD,QAAQ,EAAE;gBACR;oBACE,EAAE,EAAE,aAAa;oBACjB,GAAG,EAAE,gBAAgB;oBACrB,YAAY,EAAE;wBACZ,EAAE,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,wBAAwB,EAAE;wBACvE,EAAE,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,wBAAwB,EAAE;qBAC5E;oBACD,UAAU,EAAE;wBACV,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,aAAa,EAAE;qBAChD;oBACD,KAAK,EAAE;wBACL,qBAAqB;qBACtB;iBACF;gBACD;oBACE,EAAE,EAAE,YAAY;oBAChB,GAAG,EAAE,aAAa;oBAClB,YAAY,EAAE;wBACZ,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE;wBAC5D,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE;qBACjE;oBACD,UAAU,EAAE;wBACV,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,iBAAiB,EAAE;qBACpD;oBACD,KAAK,EAAE;wBACL,oBAAoB;qBACrB;iBACF;aACF;SACF,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI;YACpB;gBACE,WAAW,EAAE,qBAAqB;gBAClC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC;gBAC9D,QAAQ,EAAE,WAAW;aACtB;YACD;gBACE,WAAW,EAAE,oBAAoB;gBACjC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC;gBAC7D,QAAQ,EAAE,WAAW;aACtB;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/storage/filesystem.d.ts

@@ -0,0 +1,23 @@
+import { ObjectStore, ReleaseManifest, ChannelManifest } from "../types.js";
+export declare class FilesystemStore implements ObjectStore {
+    private baseDir;
+    constructor(baseDir: string);
+    private ensureDir;
+    writeObject(hash: string, content: string): Promise<void>;
+    writeMedia(hash: string, ext: string, content: Buffer): Promise<void>;
+    writeRelease(releaseId: string, manifest: ReleaseManifest): Promise<void>;
+    writeChannelManifest(channel: string, manifest: ChannelManifest): Promise<void>;
+    listChannels(): Promise<string[]>;
+    readChannelManifest(channel: string): Promise<ChannelManifest | null>;
+    readRelease(releaseId: string): Promise<ReleaseManifest | null>;
+    listReleases(): Promise<string[]>;
+    deleteRelease(releaseId: string): Promise<void>;
+    readObject(hash: string): Promise<string | null>;
+    listObjects(): Promise<string[]>;
+    deleteObject(hash: string): Promise<void>;
+    objectSize(hash: string): Promise<number | null>;
+    listMedia(): Promise<string[]>;
+    deleteMedia(filename: string): Promise<void>;
+    mediaSize(filename: string): Promise<number | null>;
+    private fileSize;
+}

package/dist/storage/filesystem.js

@@ -0,0 +1,125 @@
+import fs from "fs/promises";
+import { existsSync } from "fs";
+import path from "path";
+export class FilesystemStore {
+    baseDir;
+    constructor(baseDir) {
+        this.baseDir = path.resolve(baseDir);
+    }
+    async ensureDir(dirPath) {
+        await fs.mkdir(dirPath, { recursive: true });
+    }
+    async writeObject(hash, content) {
+        const filePath = path.join(this.baseDir, "objects", `${hash}.json`);
+        await this.ensureDir(path.dirname(filePath));
+        await fs.writeFile(filePath, content, "utf-8");
+    }
+    async writeMedia(hash, ext, content) {
+        const extension = ext.startsWith(".") ? ext : `.${ext}`;
+        const filePath = path.join(this.baseDir, "media", `${hash}${extension}`);
+        await this.ensureDir(path.dirname(filePath));
+        await fs.writeFile(filePath, content);
+    }
+    async writeRelease(releaseId, manifest) {
+        // Escape filename just in case, though releaseId should be alphanumeric/dashes
+        const safeReleaseId = releaseId.replace(/[^a-zA-Z0-9_-]/g, "_");
+        const filePath = path.join(this.baseDir, "releases", `${safeReleaseId}.json`);
+        await this.ensureDir(path.dirname(filePath));
+        await fs.writeFile(filePath, JSON.stringify(manifest, null, 2), "utf-8");
+    }
+    async writeChannelManifest(channel, manifest) {
+        const safeChannel = channel.replace(/[^a-zA-Z0-9_-]/g, "_");
+        const filePath = path.join(this.baseDir, "channels", safeChannel, "manifest.json");
+        await this.ensureDir(path.dirname(filePath));
+        await fs.writeFile(filePath, JSON.stringify(manifest, null, 2), "utf-8");
+    }
+    async listChannels() {
+        const dir = path.join(this.baseDir, "channels");
+        if (!existsSync(dir))
+            return [];
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isDirectory() && existsSync(path.join(dir, e.name, "manifest.json")))
+            .map((e) => e.name);
+    }
+    async readChannelManifest(channel) {
+        const safeChannel = channel.replace(/[^a-zA-Z0-9_-]/g, "_");
+        const filePath = path.join(this.baseDir, "channels", safeChannel, "manifest.json");
+        if (!existsSync(filePath)) {
+            return null;
+        }
+        const content = await fs.readFile(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    async readRelease(releaseId) {
+        const safeReleaseId = releaseId.replace(/[^a-zA-Z0-9_-]/g, "_");
+        const filePath = path.join(this.baseDir, "releases", `${safeReleaseId}.json`);
+        if (!existsSync(filePath)) {
+            return null;
+        }
+        const content = await fs.readFile(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    async listReleases() {
+        const dir = path.join(this.baseDir, "releases");
+        if (!existsSync(dir))
+            return [];
+        const files = await fs.readdir(dir);
+        return files
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => f.slice(0, -5)); // Remove .json extension
+    }
+    async deleteRelease(releaseId) {
+        const safeReleaseId = releaseId.replace(/[^a-zA-Z0-9_-]/g, "_");
+        const filePath = path.join(this.baseDir, "releases", `${safeReleaseId}.json`);
+        if (existsSync(filePath)) {
+            await fs.unlink(filePath);
+        }
+    }
+    async readObject(hash) {
+        const filePath = path.join(this.baseDir, "objects", `${hash}.json`);
+        if (!existsSync(filePath)) {
+            return null;
+        }
+        return await fs.readFile(filePath, "utf-8");
+    }
+    async listObjects() {
+        const dir = path.join(this.baseDir, "objects");
+        if (!existsSync(dir))
+            return [];
+        const files = await fs.readdir(dir);
+        return files
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => f.slice(0, -5)); // Return list of hashes
+    }
+    async deleteObject(hash) {
+        const filePath = path.join(this.baseDir, "objects", `${hash}.json`);
+        if (existsSync(filePath)) {
+            await fs.unlink(filePath);
+        }
+    }
+    async objectSize(hash) {
+        return this.fileSize(path.join(this.baseDir, "objects", `${hash}.json`));
+    }
+    async listMedia() {
+        const dir = path.join(this.baseDir, "media");
+        if (!existsSync(dir))
+            return [];
+        return await fs.readdir(dir);
+    }
+    async deleteMedia(filename) {
+        const filePath = path.join(this.baseDir, "media", filename);
+        if (existsSync(filePath)) {
+            await fs.unlink(filePath);
+        }
+    }
+    async mediaSize(filename) {
+        return this.fileSize(path.join(this.baseDir, "media", filename));
+    }
+    async fileSize(filePath) {
+        if (!existsSync(filePath))
+            return null;
+        return (await fs.stat(filePath)).size;
+    }
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/storage/filesystem.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,223 @@
+export interface ChannelManifest {
+    schemaVersion: 1;
+    channel: string;
+    releaseId: string;
+    updatedAt: string;
+}
+export interface Reference {
+    collection: string;
+    id: string;
+}
+export type ProvenanceStatus = "original" | "human" | "machine" | "reviewed";
+export interface ProvenanceMarker {
+    status: ProvenanceStatus;
+    from?: string;
+    sourceHash?: string;
+    model?: string;
+}
+export interface Provenance {
+    translations?: Record<string, Record<string, ProvenanceMarker>>;
+    fields?: Record<string, ProvenanceMarker>;
+}
+export interface CollectionItem {
+    id: string;
+    key: string;
+    translations: Record<string, Record<string, any>>;
+    references?: Reference[];
+    media?: string[];
+    _provenance?: Provenance;
+    [key: string]: any;
+}
+export interface MediaMetadataItem extends CollectionItem {
+    name?: string;
+    translations: Record<string, {
+        alt?: string | null;
+        description?: string | null;
+        [field: string]: any;
+    }>;
+    focalPoint?: {
+        x: number;
+        y: number;
+    };
+    focalPoints?: Record<string, {
+        x: number;
+        y: number;
+    }>;
+    width?: number;
+    height?: number;
+}
+export interface Collection {
+    schemaVersion: 1;
+    collection: string;
+    items: CollectionItem[];
+}
+export interface CollectionMeta {
+    hash: string;
+    itemCount: number;
+    size: number;
+}
+export interface MediaMeta {
+    hash: string;
+    size: number;
+    mimeType: string;
+}
+export interface TranslationCounts {
+    expected: number;
+    translated: number;
+    missing: number;
+    stale: number;
+    machine: number;
+}
+export interface TranslationSummary {
+    sourceLocale: string;
+    locales: Record<string, TranslationCounts>;
+    overall: TranslationCounts;
+}
+export interface ReleaseManifest {
+    schemaVersion: 1;
+    releaseId: string;
+    createdAt: string;
+    sourceReadAt?: string;
+    collections: Record<string, CollectionMeta>;
+    media: Record<string, MediaMeta>;
+    translations?: TranslationSummary;
+    targets?: string[];
+}
+export interface SourceMedia {
+    virtualPath: string;
+    content: Buffer;
+    mimeType: string;
+}
+export interface SourceItemRef {
+    id: string;
+    collection?: string;
+    path?: string;
+    fields?: Record<string, SourceFieldRef>;
+}
+export interface SourceFieldRef {
+    collection: string;
+    id: string;
+    field: string;
+    format?: "plain" | "html";
+    editable?: boolean;
+}
+export type EditValue = string | number | boolean | null;
+export interface SourceEdit {
+    ref: SourceFieldRef;
+    value: EditValue;
+    basedOn: EditValue;
+}
+export type EditResult = {
+    status: "saved";
+    value: EditValue;
+} | {
+    status: "conflict";
+    current: EditValue;
+} | {
+    status: "rejected";
+    message: string;
+    code?: number;
+};
+export interface EditorSession {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    user?: {
+        id: string;
+        name?: string;
+    };
+}
+/**
+ * The optional write side of a source adapter. Edits go to the source system, never into a release:
+ * the next publish includes them. Adapters without it simply offer no editing.
+ */
+export interface SourceEditor {
+    login(credentials: {
+        email: string;
+        password: string;
+    }): Promise<EditorSession>;
+    refresh?(session: EditorSession): Promise<EditorSession>;
+    logout?(session: EditorSession): Promise<void>;
+    read(ref: SourceFieldRef, session: EditorSession): Promise<EditValue>;
+    write(edit: SourceEdit, session: EditorSession): Promise<EditResult>;
+}
+/**
+ * Changes to the site structure in CDS terms (pages, routes, blocks, menus), for previews. Optional,
+ * like all editing. The source system's shape of these is site-specific, so this is implemented next
+ * to the site's mapping (the mapping's inverse), on top of the adapter's editor. Ids are CDS ids.
+ */
+export interface StructureEditor {
+    /** Block types that can be added, e.g. ["hero", "text"] */
+    blockTypes(): string[];
+    createPage(input: {
+        title: string;
+        slug: string;
+        status?: string;
+    }, session: EditorSession): Promise<{
+        page: string;
+    }>;
+    /** Adds a block after another (null: at the top, undefined: at the end) */
+    addBlock(input: {
+        page: string;
+        type: string;
+        after?: string | null;
+        texts?: Record<string, string>;
+    }, session: EditorSession): Promise<{
+        block: string;
+    }>;
+    /** Puts the page's published blocks in this order; content the release doesn't show keeps its place */
+    reorderBlocks(input: {
+        page: string;
+        blocks: string[];
+    }, session: EditorSession): Promise<void>;
+    /** A menu entry linking a page (canonical: the page's route) or a URL, under a menu or another entry */
+    addMenuEntry(input: {
+        parent: string;
+        label: string;
+        page?: string;
+        url?: string;
+        canonical?: boolean;
+    }, session: EditorSession): Promise<{
+        entry: string;
+    }>;
+}
+export interface SourceMediaRef extends SourceItemRef {
+    adapter: string;
+}
+export interface SourceMap {
+    sources: Record<string, {
+        baseUrl?: string;
+    }>;
+    collections: Record<string, {
+        source?: {
+            adapter: string;
+            collection: string;
+        };
+        items: Record<string, SourceItemRef>;
+    }>;
+    media: Record<string, SourceMediaRef>;
+}
+export interface ContentSource {
+    getCollections(): Promise<Record<string, CollectionItem[]>>;
+    getMedia(): Promise<SourceMedia[]>;
+    getSourceMap?(): Promise<SourceMap>;
+    getSourceLocale?(): Promise<string | undefined>;
+}
+export interface ObjectStore {
+    writeObject(hash: string, content: string): Promise<void>;
+    writeMedia(hash: string, ext: string, content: Buffer): Promise<void>;
+    writeRelease(releaseId: string, manifest: ReleaseManifest): Promise<void>;
+    writeChannelManifest(channel: string, manifest: ChannelManifest): Promise<void>;
+    listChannels(): Promise<string[]>;
+    readChannelManifest(channel: string): Promise<ChannelManifest | null>;
+    readRelease(releaseId: string): Promise<ReleaseManifest | null>;
+    listReleases(): Promise<string[]>;
+    deleteRelease(releaseId: string): Promise<void>;
+    readObject(hash: string): Promise<string | null>;
+    listObjects(): Promise<string[]>;
+    deleteObject(hash: string): Promise<void>;
+    objectSize(hash: string): Promise<number | null>;
+    listMedia(): Promise<string[]>;
+    deleteMedia(filename: string): Promise<void>;
+    mediaSize(filename: string): Promise<number | null>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function deterministicStringify(val: any): string;
+export declare function sha256(content: string | Buffer): string;

package/dist/utils.js

@@ -0,0 +1,17 @@
+import crypto from "crypto";
+export function deterministicStringify(val) {
+    if (val === null)
+        return "null";
+    if (Array.isArray(val)) {
+        return "[" + val.map(v => deterministicStringify(v)).join(",") + "]";
+    }
+    if (typeof val === "object") {
+        const keys = Object.keys(val).sort();
+        return "{" + keys.map(k => JSON.stringify(k) + ":" + deterministicStringify(val[k])).join(",") + "}";
+    }
+    return JSON.stringify(val);
+}
+export function sha256(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,UAAU,sBAAsB,CAAC,GAAQ;IAC7C,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACvG,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,OAAwB;IAC7C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,21 @@
+export declare function validateChannelManifest(data: any): void;
+export declare function validateReleaseManifest(data: any): void;
+export declare function validateCollection(data: any): void;
+export declare function validateTargetDefinition(data: any): void;
+export declare function validateMediaMetadataItem(data: any): void;
+export declare function validateJsonLdDefinition(data: any): void;
+export declare const validateRouteItem: (data: any) => void;
+export declare const validatePageItem: (data: any) => void;
+export declare const validateBlockItem: (data: any) => void;
+export declare const validateMenuItem: (data: any) => void;
+export interface ContentSchemaError {
+    keyword: string;
+    instancePath: string;
+    params: Record<string, any>;
+    message?: string;
+}
+/**
+ * Compiles a JSON Schema declared in a target definition (requirements/recommendations).
+ * The returned function lists all violations; an empty list means valid.
+ */
+export declare function compileContentSchema(schema: object): (data: any) => ContentSchemaError[];

package/dist/validation.js

@@ -0,0 +1,100 @@
+import AjvModule from "ajv";
+import addFormatsModule from "ajv-formats";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+const Ajv = AjvModule.default || AjvModule;
+const addFormats = addFormatsModule.default || addFormatsModule;
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Helper to load schema files from the monorepo root
+function loadSchema(filename) {
+    // We look for schemas first in ../../schemas/v1/ (development/test run)
+    // or inside a relative path depending on build outputs.
+    const possiblePaths = [
+        path.join(__dirname, "..", "..", "schemas", "v1", filename),
+        path.join(__dirname, "..", "schemas", "v1", filename),
+        path.join(__dirname, "schemas", "v1", filename)
+    ];
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p)) {
+            return JSON.parse(fs.readFileSync(p, "utf-8"));
+        }
+    }
+    throw new Error(`Schema file not found: ${filename}`);
+}
+const channelManifestSchema = loadSchema("channel-manifest.json");
+const releaseManifestSchema = loadSchema("release-manifest.json");
+const collectionSchema = loadSchema("collection.json");
+const targetSchema = loadSchema("target.json");
+const mediaMetadataSchema = loadSchema("media-metadata.json");
+const jsonLdSchema = loadSchema("jsonld.json");
+const ajv = new Ajv({ allErrors: true });
+addFormats(ajv);
+const validateChannelManifestFn = ajv.compile(channelManifestSchema);
+const validateReleaseManifestFn = ajv.compile(releaseManifestSchema);
+const validateCollectionFn = ajv.compile(collectionSchema);
+const validateTargetFn = ajv.compile(targetSchema);
+const validateMediaMetadataFn = ajv.compile(mediaMetadataSchema);
+const validateJsonLdFn = ajv.compile(jsonLdSchema);
+// Target-provided schemas are often partial (e.g. only "required"), so strict-mode type hints are off
+const contentAjv = new Ajv({ allErrors: true, strict: false });
+addFormats(contentAjv);
+export function validateChannelManifest(data) {
+    const valid = validateChannelManifestFn(data);
+    if (!valid) {
+        throw new Error(`Invalid Channel Manifest: ${ajv.errorsText(validateChannelManifestFn.errors)}`);
+    }
+}
+export function validateReleaseManifest(data) {
+    const valid = validateReleaseManifestFn(data);
+    if (!valid) {
+        throw new Error(`Invalid Release Manifest: ${ajv.errorsText(validateReleaseManifestFn.errors)}`);
+    }
+}
+export function validateCollection(data) {
+    const valid = validateCollectionFn(data);
+    if (!valid) {
+        throw new Error(`Invalid Collection (${data.collection || "unknown"}): ${ajv.errorsText(validateCollectionFn.errors)}`);
+    }
+}
+export function validateTargetDefinition(data) {
+    const valid = validateTargetFn(data);
+    if (!valid) {
+        throw new Error(`Invalid Target Definition (${data?.id || "unknown"}): ${ajv.errorsText(validateTargetFn.errors)}`);
+    }
+}
+export function validateMediaMetadataItem(data) {
+    const valid = validateMediaMetadataFn(data);
+    if (!valid) {
+        throw new Error(`Invalid _media item (${data?.id || "unknown"}): ${ajv.errorsText(validateMediaMetadataFn.errors)}`);
+    }
+}
+export function validateJsonLdDefinition(data) {
+    const valid = validateJsonLdFn(data);
+    if (!valid) {
+        throw new Error(`Invalid _jsonld item (${data?.id || "unknown"}): ${ajv.errorsText(validateJsonLdFn.errors)}`);
+    }
+}
+// Validators for items of the optional site-structure collections
+function itemValidator(schemaFile, label) {
+    const validate = ajv.compile(loadSchema(schemaFile));
+    return (data) => {
+        if (!validate(data)) {
+            throw new Error(`Invalid ${label} item (${data?.id || "unknown"}): ${ajv.errorsText(validate.errors)}`);
+        }
+    };
+}
+export const validateRouteItem = itemValidator("route.json", "_routes");
+export const validatePageItem = itemValidator("page.json", "_pages");
+export const validateBlockItem = itemValidator("block.json", "_blocks");
+export const validateMenuItem = itemValidator("menu.json", "_menu");
+/**
+ * Compiles a JSON Schema declared in a target definition (requirements/recommendations).
+ * The returned function lists all violations; an empty list means valid.
+ */
+export function compileContentSchema(schema) {
+    const validate = contentAjv.compile(schema);
+    return (data) => (validate(data) ? [] : validate.errors);
+}
+//# sourceMappingURL=validation.js.map