@sourcepress/media 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @sourcepress/media@0.1.0 build /Users/fabianvontiedemann/Developer/org/sourcepress/packages/media
+> tsc
+

package/.turbo/turbo-test.log

@@ -0,0 +1,16 @@
+
+> @sourcepress/media@0.1.0 test /Users/fabianvontiedemann/Developer/org/sourcepress/packages/media
+> vitest run
+
+
+ RUN  v3.2.4 /Users/fabianvontiedemann/Developer/org/sourcepress/packages/media
+
+ ✓ src/__tests__/registry.test.ts (7 tests) 4ms
+ ✓ src/__tests__/git-storage.test.ts (6 tests) 4ms
+ ✓ src/__tests__/validation.test.ts (10 tests) 2ms
+
+ Test Files  3 passed (3)
+      Tests  23 passed (23)
+   Start at  00:37:58
+   Duration  1.03s (transform 77ms, setup 0ms, collect 146ms, tests 10ms, environment 0ms, prepare 503ms)
+

package/dist/__tests__/git-storage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-storage.test.d.ts.map

package/dist/__tests__/git-storage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-storage.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/git-storage.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/git-storage.test.js

@@ -0,0 +1,137 @@
+import { describe, expect, it, vi } from "vitest";
+import { GitMediaStorage } from "../git-storage.js";
+// Mock crypto.subtle for hash computation
+vi.stubGlobal("crypto", {
+    subtle: {
+        digest: vi.fn().mockResolvedValue(new Uint8Array(32).buffer),
+    },
+});
+function createMockGitHub() {
+    return {
+        getFile: vi.fn().mockResolvedValue(null),
+        createOrUpdateFile: vi.fn().mockResolvedValue({ sha: "file-sha", commit_sha: "commit-sha" }),
+        owner: "test",
+        repo: "test",
+        branch: "main",
+    };
+}
+const defaultConfig = {
+    storage: "git",
+    path: "assets",
+    registry: "media.json",
+};
+describe("GitMediaStorage", () => {
+    it("uploads a file and registers it", async () => {
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub();
+        const storage = new GitMediaStorage(github, defaultConfig);
+        const result = await storage.upload({
+            file: Buffer.from("fake-image-data"),
+            path: "hero.webp",
+            content_type: "image/webp",
+            source: "uploaded",
+            uploaded_by: "test-user",
+            alt: "Hero image",
+        });
+        expect(result.path).toBe("assets/hero.webp");
+        expect(result.content_type).toBe("image/webp");
+        expect(result.source).toBe("uploaded");
+        expect(result.uploaded_by).toBe("test-user");
+        expect(result.alt).toBe("Hero image");
+        // Should have uploaded the file
+        expect(github.createOrUpdateFile).toHaveBeenCalledTimes(2); // file + registry
+    });
+    it("rejects disallowed content type", async () => {
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub();
+        const storage = new GitMediaStorage(github, defaultConfig);
+        await expect(storage.upload({
+            file: Buffer.from("data"),
+            path: "malware.exe",
+            content_type: "application/x-executable",
+            source: "uploaded",
+            uploaded_by: "test-user",
+        })).rejects.toThrow("not allowed");
+    });
+    it("rejects file exceeding max size", async () => {
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub();
+        const storage = new GitMediaStorage(github, {
+            ...defaultConfig,
+            maxSizeMb: 1,
+        });
+        const largeBuffer = Buffer.alloc(2 * 1024 * 1024); // 2MB
+        await expect(storage.upload({
+            file: largeBuffer,
+            path: "large.png",
+            content_type: "image/png",
+            source: "uploaded",
+            uploaded_by: "test-user",
+        })).rejects.toThrow("exceeds maximum");
+    });
+    it("sanitizes upload paths", async () => {
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub();
+        const storage = new GitMediaStorage(github, defaultConfig);
+        const result = await storage.upload({
+            file: Buffer.from("data"),
+            path: "../../../HERO.WebP",
+            content_type: "image/webp",
+            source: "uploaded",
+            uploaded_by: "test-user",
+        });
+        expect(result.path).toBe("assets/hero.webp");
+    });
+    it("lists media entries", async () => {
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub();
+        // Pre-populate registry via getFile mock
+        const registry = {
+            "assets/a.webp": {
+                path: "assets/a.webp",
+                content_type: "image/webp",
+                size_bytes: 1000,
+                hash: "aaa",
+                source: "uploaded",
+                uploaded_at: "2026-04-04",
+                uploaded_by: "test",
+            },
+        };
+        github.getFile.mockResolvedValueOnce({
+            path: "media.json",
+            sha: "reg-sha",
+            content: JSON.stringify(registry),
+            encoding: "utf-8",
+        });
+        const storage = new GitMediaStorage(github, defaultConfig);
+        const list = await storage.list();
+        expect(list).toHaveLength(1);
+        expect(list[0].path).toBe("assets/a.webp");
+    });
+    it("updates metadata for existing file", async () => {
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub();
+        const existingRef = {
+            path: "assets/hero.webp",
+            content_type: "image/webp",
+            size_bytes: 5000,
+            hash: "abc",
+            source: "uploaded",
+            uploaded_at: "2026-04-04",
+            uploaded_by: "test",
+        };
+        github.getFile.mockResolvedValueOnce({
+            path: "media.json",
+            sha: "reg-sha",
+            content: JSON.stringify({ "assets/hero.webp": existingRef }),
+            encoding: "utf-8",
+        });
+        const storage = new GitMediaStorage(github, defaultConfig);
+        const updated = await storage.updateMeta("assets/hero.webp", {
+            alt: "Updated alt text",
+        });
+        expect(updated.alt).toBe("Updated alt text");
+        expect(updated.path).toBe("assets/hero.webp");
+    });
+});
+//# sourceMappingURL=git-storage.test.js.map

package/dist/__tests__/git-storage.test.js.map

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

package/dist/__tests__/registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/__tests__/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/registry.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/registry.test.js

@@ -0,0 +1,90 @@
+import { describe, expect, it, vi } from "vitest";
+import { MediaRegistryManager } from "../registry.js";
+// Mock GitHubClient
+function createMockGitHub(existingRegistry) {
+    const content = existingRegistry ? JSON.stringify(existingRegistry) : null;
+    return {
+        getFile: vi
+            .fn()
+            .mockResolvedValue(content ? { path: "media.json", sha: "abc123", content, encoding: "utf-8" } : null),
+        createOrUpdateFile: vi.fn().mockResolvedValue({ sha: "new-sha", commit_sha: "commit-sha" }),
+        owner: "test",
+        repo: "test",
+        branch: "main",
+    };
+}
+const sampleRef = {
+    path: "assets/hero.webp",
+    content_type: "image/webp",
+    size_bytes: 50000,
+    hash: "abc123def456",
+    source: "uploaded",
+    uploaded_at: "2026-04-04T10:00:00Z",
+    uploaded_by: "test-user",
+};
+describe("MediaRegistryManager", () => {
+    it("loads empty registry when file does not exist", async () => {
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub();
+        const manager = new MediaRegistryManager(github, "media.json");
+        const registry = await manager.load();
+        expect(registry).toEqual({});
+    });
+    it("loads existing registry from Git", async () => {
+        const existing = { "assets/hero.webp": sampleRef };
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub(existing);
+        const manager = new MediaRegistryManager(github, "media.json");
+        const registry = await manager.load();
+        expect(registry["assets/hero.webp"]).toEqual(sampleRef);
+    });
+    it("sets and retrieves an entry", async () => {
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub();
+        const manager = new MediaRegistryManager(github, "media.json");
+        await manager.set("assets/new.png", sampleRef);
+        const result = await manager.get("assets/new.png");
+        expect(result).toEqual(sampleRef);
+    });
+    it("removes an entry", async () => {
+        const existing = { "assets/hero.webp": sampleRef };
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub(existing);
+        const manager = new MediaRegistryManager(github, "media.json");
+        await manager.remove("assets/hero.webp");
+        const result = await manager.get("assets/hero.webp");
+        expect(result).toBeNull();
+    });
+    it("lists entries with prefix filter", async () => {
+        const existing = {
+            "assets/cases/hero.webp": { ...sampleRef, path: "assets/cases/hero.webp" },
+            "assets/team/anna.jpg": { ...sampleRef, path: "assets/team/anna.jpg" },
+            "assets/cases/detail.png": { ...sampleRef, path: "assets/cases/detail.png" },
+        };
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub(existing);
+        const manager = new MediaRegistryManager(github, "media.json");
+        const casesOnly = await manager.list("assets/cases/");
+        expect(casesOnly).toHaveLength(2);
+    });
+    it("saves registry to Git", async () => {
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub();
+        const manager = new MediaRegistryManager(github, "media.json");
+        await manager.set("assets/hero.webp", sampleRef);
+        await manager.save("media: add hero image");
+        expect(github.createOrUpdateFile).toHaveBeenCalledWith("media.json", expect.stringContaining("assets/hero.webp"), "media: add hero image", undefined, undefined);
+    });
+    it("invalidates cache", async () => {
+        const existing = { "assets/hero.webp": sampleRef };
+        // biome-ignore lint/suspicious/noExplicitAny: mock GitHubClient
+        const github = createMockGitHub(existing);
+        const manager = new MediaRegistryManager(github, "media.json");
+        await manager.load();
+        manager.invalidate();
+        // Should call getFile again after invalidation
+        await manager.load();
+        expect(github.getFile).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/__tests__/registry.test.js.map

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

package/dist/__tests__/validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

package/dist/__tests__/validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/validation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/validation.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, it } from "vitest";
+import { sanitizePath, validateUpload } from "../validation.js";
+describe("validateUpload", () => {
+    it("accepts valid image upload", () => {
+        const result = validateUpload("image/webp", 500_000);
+        expect(result.valid).toBe(true);
+        expect(result.error).toBeUndefined();
+    });
+    it("rejects disallowed content type", () => {
+        const result = validateUpload("application/zip", 1000);
+        expect(result.valid).toBe(false);
+        expect(result.error).toContain("not allowed");
+    });
+    it("rejects file exceeding max size", () => {
+        const result = validateUpload("image/png", 20 * 1024 * 1024);
+        expect(result.valid).toBe(false);
+        expect(result.error).toContain("exceeds maximum");
+    });
+    it("uses custom allowed types from config", () => {
+        const result = validateUpload("application/zip", 1000, {
+            allowedTypes: ["application/zip"],
+        });
+        expect(result.valid).toBe(true);
+    });
+    it("uses custom max size from config", () => {
+        const result = validateUpload("image/png", 50 * 1024 * 1024, {
+            maxSizeMb: 100,
+        });
+        expect(result.valid).toBe(true);
+    });
+});
+describe("sanitizePath", () => {
+    it("normalizes backslashes to forward slashes", () => {
+        expect(sanitizePath("assets\\images\\hero.png")).toBe("assets/images/hero.png");
+    });
+    it("removes directory traversal attempts", () => {
+        expect(sanitizePath("../../../etc/passwd")).toBe("etc/passwd");
+    });
+    it("collapses multiple slashes", () => {
+        expect(sanitizePath("assets///images//hero.png")).toBe("assets/images/hero.png");
+    });
+    it("lowercases the path", () => {
+        expect(sanitizePath("Assets/HERO.PNG")).toBe("assets/hero.png");
+    });
+    it("removes leading slash", () => {
+        expect(sanitizePath("/assets/hero.png")).toBe("assets/hero.png");
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/__tests__/validation.test.js.map

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

package/dist/git-storage.d.ts

@@ -0,0 +1,20 @@
+import type { MediaConfig, MediaRef, MediaUploadInput } from "@sourcepress/core";
+import type { GitHubClient } from "@sourcepress/github";
+import type { MediaStorage } from "./interface.js";
+/**
+ * GitMediaStorage stores media files directly in the Git repository.
+ * Best for small sites with < 50 images.
+ */
+export declare class GitMediaStorage implements MediaStorage {
+    private github;
+    private registry;
+    private config;
+    constructor(github: GitHubClient, config: MediaConfig);
+    upload(input: MediaUploadInput): Promise<MediaRef>;
+    get(path: string): Promise<Buffer | null>;
+    delete(path: string): Promise<void>;
+    list(prefix?: string): Promise<MediaRef[]>;
+    getMeta(path: string): Promise<MediaRef | null>;
+    updateMeta(path: string, updates: Partial<Pick<MediaRef, "alt" | "source" | "generated_by" | "prompt">>): Promise<MediaRef>;
+}
+//# sourceMappingURL=git-storage.d.ts.map

package/dist/git-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-storage.d.ts","sourceRoot":"","sources":["../src/git-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAanD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,YAAY;IACnD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW;IAM/C,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAuClD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMzC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI1C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAI/C,UAAU,CACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,CAAC,CAAC,GAC5E,OAAO,CAAC,QAAQ,CAAC;CAYpB"}

package/dist/git-storage.js

@@ -0,0 +1,87 @@
+import { MediaRegistryManager } from "./registry.js";
+import { sanitizePath, validateUpload } from "./validation.js";
+/**
+ * Compute a simple hash from a Buffer using Web Crypto API.
+ */
+async function computeHash(data) {
+    const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+/**
+ * GitMediaStorage stores media files directly in the Git repository.
+ * Best for small sites with < 50 images.
+ */
+export class GitMediaStorage {
+    github;
+    registry;
+    config;
+    constructor(github, config) {
+        this.github = github;
+        this.config = config;
+        this.registry = new MediaRegistryManager(github, config.registry);
+    }
+    async upload(input) {
+        const sanitized = sanitizePath(input.path);
+        const fullPath = `${this.config.path}/${sanitized}`;
+        // Validate
+        const validation = validateUpload(input.content_type, input.file.length, this.config);
+        if (!validation.valid) {
+            throw new Error(validation.error);
+        }
+        // Compute hash
+        const hash = await computeHash(input.file);
+        // Upload file to Git — pass as latin1 string so createOrUpdateFile's
+        // internal btoa() produces valid base64 (no double-encoding).
+        const content = input.file.toString("latin1");
+        await this.github.createOrUpdateFile(fullPath, content, `media: upload ${sanitized}`);
+        // Create MediaRef
+        const ref = {
+            path: fullPath,
+            content_type: input.content_type,
+            size_bytes: input.file.length,
+            hash,
+            alt: input.alt,
+            source: input.source,
+            generated_by: input.generated_by,
+            prompt: input.prompt,
+            uploaded_at: new Date().toISOString(),
+            uploaded_by: input.uploaded_by,
+        };
+        // Register in media.json
+        await this.registry.set(fullPath, ref);
+        await this.registry.save(`media: register ${sanitized}`);
+        return ref;
+    }
+    async get(path) {
+        const file = await this.github.getFile(path);
+        if (!file)
+            return null;
+        return Buffer.from(file.content, "base64");
+    }
+    async delete(path) {
+        // Remove from registry
+        await this.registry.remove(path);
+        await this.registry.save(`media: delete ${path}`);
+        // Note: Git doesn't truly "delete" — we remove from registry.
+        // The file remains in Git history. For actual file deletion,
+        // a future version could use the GitHub Contents API DELETE.
+    }
+    async list(prefix) {
+        return this.registry.list(prefix);
+    }
+    async getMeta(path) {
+        return this.registry.get(path);
+    }
+    async updateMeta(path, updates) {
+        const existing = await this.registry.get(path);
+        if (!existing) {
+            throw new Error(`Media not found: ${path}`);
+        }
+        const updated = { ...existing, ...updates };
+        await this.registry.set(path, updated);
+        await this.registry.save(`media: update metadata for ${path}`);
+        return updated;
+    }
+}
+//# sourceMappingURL=git-storage.js.map

package/dist/git-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-storage.js","sourceRoot":"","sources":["../src/git-storage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;GAEG;AACH,KAAK,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IACzD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,eAAe;IACnB,MAAM,CAAe;IACrB,QAAQ,CAAuB;IAC/B,MAAM,CAAc;IAE5B,YAAY,MAAoB,EAAE,MAAmB;QACpD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAuB;QACnC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;QAEpD,WAAW;QACX,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACtF,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,eAAe;QACf,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3C,qEAAqE;QACrE,8DAA8D;QAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,iBAAiB,SAAS,EAAE,CAAC,CAAC;QAEtF,kBAAkB;QAClB,MAAM,GAAG,GAAa;YACrB,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;YAC7B,IAAI;YACJ,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,WAAW,EAAE,KAAK,CAAC,WAAW;SAC9B,CAAC;QAEF,yBAAyB;QACzB,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,SAAS,EAAE,CAAC,CAAC;QAEzD,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY;QACrB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACxB,uBAAuB;QACvB,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAElD,8DAA8D;QAC9D,6DAA6D;QAC7D,6DAA6D;IAC9D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAe;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,UAAU,CACf,IAAY,EACZ,OAA8E;QAE9E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,OAAO,GAAa,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;QACtD,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;QAE/D,OAAO,OAAO,CAAC;IAChB,CAAC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { MediaStorage } from "./interface.js";
+export { GitMediaStorage } from "./git-storage.js";
+export { MediaRegistryManager } from "./registry.js";
+export { validateUpload, sanitizePath } from "./validation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { GitMediaStorage } from "./git-storage.js";
+export { MediaRegistryManager } from "./registry.js";
+export { validateUpload, sanitizePath } from "./validation.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":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/interface.d.ts

@@ -0,0 +1,34 @@
+import type { MediaRef, MediaUploadInput } from "@sourcepress/core";
+/**
+ * Pluggable media storage interface.
+ * Implementations: GitMediaStorage (default), R2MediaStorage, S3MediaStorage (future).
+ */
+export interface MediaStorage {
+    /**
+     * Upload a file and register it in the media registry.
+     * Returns the MediaRef with hash and metadata.
+     */
+    upload(input: MediaUploadInput): Promise<MediaRef>;
+    /**
+     * Get file contents by path.
+     * Returns null if the file does not exist.
+     */
+    get(path: string): Promise<Buffer | null>;
+    /**
+     * Delete a file and remove it from the registry.
+     */
+    delete(path: string): Promise<void>;
+    /**
+     * List all media entries, optionally filtered by path prefix.
+     */
+    list(prefix?: string): Promise<MediaRef[]>;
+    /**
+     * Get metadata for a single file from the registry.
+     */
+    getMeta(path: string): Promise<MediaRef | null>;
+    /**
+     * Update metadata for an existing file (e.g., alt-text).
+     */
+    updateMeta(path: string, updates: Partial<Pick<MediaRef, "alt" | "source" | "generated_by" | "prompt">>): Promise<MediaRef>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnD;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE3C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAEhD;;OAEG;IACH,UAAU,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,CAAC,CAAC,GAC5E,OAAO,CAAC,QAAQ,CAAC,CAAC;CACrB"}

package/dist/interface.js

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

package/dist/interface.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,42 @@
+import type { MediaRef, MediaRegistry } from "@sourcepress/core";
+import type { GitHubClient } from "@sourcepress/github";
+/**
+ * MediaRegistryManager reads/writes the media.json file in Git.
+ * This is the source of truth for all media metadata.
+ */
+export declare class MediaRegistryManager {
+    private github;
+    private registryPath;
+    private cache;
+    private registrySha;
+    constructor(github: GitHubClient, registryPath: string);
+    /**
+     * Load the full registry from Git.
+     */
+    load(): Promise<MediaRegistry>;
+    /**
+     * Save the registry back to Git.
+     */
+    save(message: string): Promise<void>;
+    /**
+     * Add or update an entry in the registry.
+     */
+    set(path: string, ref: MediaRef): Promise<void>;
+    /**
+     * Get a single entry.
+     */
+    get(path: string): Promise<MediaRef | null>;
+    /**
+     * Remove an entry from the registry.
+     */
+    remove(path: string): Promise<void>;
+    /**
+     * List entries, optionally filtered by prefix.
+     */
+    list(prefix?: string): Promise<MediaRef[]>;
+    /**
+     * Invalidate the in-memory cache.
+     */
+    invalidate(): void;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;GAGG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,WAAW,CAAuB;gBAE9B,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM;IAKtD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC;IAoBpC;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1C;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAKjD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAWhD;;OAEG;IACH,UAAU,IAAI,IAAI;CAIlB"}