@usecds/server 0.0.0-stage → 0.1.1

package/dist/core/translations.js

@@ -0,0 +1,125 @@
+import { sha256 } from "../utils.js";
+export const DEFAULT_SOURCE_LOCALE = "en";
+/**
+ * Hash of a source text, as stored in _provenance translation markers (sourceHash).
+ */
+export function translationSourceHash(text) {
+    return sha256(text);
+}
+/**
+ * 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 function inferSourceLocale(collections) {
+    const candidates = new Set();
+    for (const items of Object.values(collections)) {
+        for (const item of items) {
+            for (const [locale, fields] of Object.entries(item._provenance?.translations ?? {})) {
+                for (const marker of Object.values(fields)) {
+                    if (marker.status === "original")
+                        candidates.add(locale);
+                    if (marker.from)
+                        candidates.add(marker.from);
+                }
+            }
+        }
+    }
+    return candidates.size === 1 ? [...candidates][0] : undefined;
+}
+const emptyCounts = () => ({ expected: 0, translated: 0, missing: 0, stale: 0, machine: 0 });
+function addCounts(target, add) {
+    target.expected += add.expected;
+    target.translated += add.translated;
+    target.missing += add.missing;
+    target.stale += add.stale;
+    target.machine += add.machine;
+}
+const isEmpty = (value) => value === undefined || value === null || value === "";
+/**
+ * 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 function analyzeTranslations(collections, sourceLocale, sourceLocaleOrigin, previous, itemLocales) {
+    const locales = new Set();
+    for (const items of Object.values(collections)) {
+        for (const item of items) {
+            Object.keys(item.translations).forEach((l) => locales.add(l));
+        }
+    }
+    locales.delete(sourceLocale);
+    const targetLocales = [...locales].sort();
+    const report = {
+        sourceLocale,
+        sourceLocaleOrigin,
+        locales: Object.fromEntries(targetLocales.map((l) => [l, emptyCounts()])),
+        overall: emptyCounts(),
+        collections: {},
+        itemsWithoutSource: [],
+        issues: []
+    };
+    for (const [collection, items] of Object.entries(collections)) {
+        const perLocale = Object.fromEntries(targetLocales.map((l) => [l, emptyCounts()]));
+        report.collections[collection] = perLocale;
+        const previousById = new Map((previous?.[collection] ?? []).map((i) => [i.id, i]));
+        for (const item of items) {
+            const usedIn = itemLocales?.(collection, item);
+            if (usedIn && !usedIn.includes(sourceLocale))
+                continue;
+            const sourceFields = item.translations[sourceLocale];
+            if (!sourceFields) {
+                report.itemsWithoutSource.push({ collection, id: item.id });
+                continue;
+            }
+            const prevItem = previousById.get(item.id);
+            for (const [field, sourceValue] of Object.entries(sourceFields)) {
+                if (typeof sourceValue !== "string" || sourceValue.length === 0)
+                    continue;
+                for (const locale of targetLocales) {
+                    if (usedIn && !usedIn.includes(locale))
+                        continue;
+                    const counts = perLocale[locale];
+                    counts.expected++;
+                    const value = item.translations[locale]?.[field];
+                    if (isEmpty(value)) {
+                        counts.missing++;
+                        report.issues.push({ collection, id: item.id, locale, field, issue: "missing" });
+                        continue;
+                    }
+                    counts.translated++;
+                    const marker = item._provenance?.translations?.[locale]?.[field];
+                    if (marker?.status === "machine")
+                        counts.machine++;
+                    let stale = false;
+                    if (marker?.sourceHash) {
+                        const reference = item.translations[marker.from ?? sourceLocale]?.[field];
+                        stale = typeof reference === "string" && translationSourceHash(reference) !== marker.sourceHash;
+                    }
+                    else if (prevItem) {
+                        const prevSource = prevItem.translations[sourceLocale]?.[field];
+                        const prevValue = prevItem.translations[locale]?.[field];
+                        stale = typeof prevSource === "string" && prevSource !== sourceValue && prevValue === value;
+                    }
+                    if (stale) {
+                        counts.stale++;
+                        report.issues.push({ collection, id: item.id, locale, field, issue: "stale" });
+                    }
+                }
+            }
+        }
+        for (const locale of targetLocales) {
+            addCounts(report.locales[locale], perLocale[locale]);
+            addCounts(report.overall, perLocale[locale]);
+        }
+    }
+    return report;
+}
+export function toTranslationSummary(report) {
+    return { sourceLocale: report.sourceLocale, locales: report.locales, overall: report.overall };
+}
+//# sourceMappingURL=translations.js.map

package/dist/core/translations.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * from "./types.js";
+export * from "./utils.js";
+export * from "./validation.js";
+export { Publisher, PublisherConfig, PublishOptions, PublishArtifacts, PublishResult, PublishRequirementsError, GarbageCollectOptions, GarbageCollectResult } 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/settings.js";
+export * from "./core/report.js";
+export * from "./core/content-types.js";
+export { FixtureSource } from "./sources/fixture.js";
+export { FilesystemStore } from "./storage/filesystem.js";

package/dist/index.js

@@ -0,0 +1,19 @@
+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/settings.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,oBAAoB,CAAC;AACnC,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":""}