@v7-cms/adapters 0.0.0-alpha.9

package/dist/fs-access.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Local editing through the browser's File System Access API.
+ *
+ * The author picks their repository folder once, and the editor reads and writes it directly: no
+ * server, no token, no commit until they choose to push. This is the nicest local mode and also
+ * the least portable — only Chromium browsers implement the API — which is why the proxy exists
+ * as well.
+ *
+ * The handle is kept in IndexedDB because it cannot be serialised anywhere else, and permission is
+ * re-requested on each visit rather than assumed.
+ */
+import { type DirEntry, type FileContents, type MediaStore, type StorageAdapter, type WriteOptions, type WriteResult } from '@v7-cms/core/storage';
+export interface DirectoryPickerWindow {
+    showDirectoryPicker(options?: {
+        mode?: 'read' | 'readwrite';
+    }): Promise<FileSystemDirectoryHandle>;
+}
+export declare function supportsFileSystemAccess(): boolean;
+export declare class FileSystemAdapter implements StorageAdapter {
+    readonly kind: "fs-access";
+    private root;
+    /** Media folder inside the picked directory. */
+    private mediaFolder;
+    /** Content of the last read, so a write can detect an outside change. */
+    private seen;
+    constructor(root: FileSystemDirectoryHandle, options?: {
+        mediaFolder?: string;
+    });
+    init(): Promise<void>;
+    private parts;
+    private directoryFor;
+    private fileHandle;
+    listDir(path: string): Promise<DirEntry[]>;
+    exists(path: string): Promise<boolean>;
+    readFile(path: string): Promise<FileContents>;
+    readBinary(path: string): Promise<Uint8Array>;
+    writeFile(path: string, contents: string | Uint8Array, options: WriteOptions): Promise<WriteResult>;
+    deleteFile(path: string, _options: WriteOptions): Promise<void>;
+    /**
+     * There is no branch concept on a plain folder. Editorial workflow keeps its state in a file
+     * inside the repository instead, so this reports a single implicit branch.
+     */
+    listBranches(): Promise<string[]>;
+    createBranch(): Promise<void>;
+    media(): MediaStore;
+}
+/** Ask the author for their repository folder. Must be called from a user gesture. */
+export declare function pickDirectory(): Promise<FileSystemDirectoryHandle>;
+/**
+ * Remember the picked folder between visits. Only the handle is stored, and the browser still
+ * asks for permission again — the API requires a gesture, and it keeps the grant honest.
+ */
+export declare const handleStore: {
+    save(handle: FileSystemDirectoryHandle): Promise<void>;
+    load(): Promise<FileSystemDirectoryHandle | undefined>;
+    clear(): Promise<void>;
+};
+/** Whether the stored handle is still usable without prompting. */
+export declare function hasPermission(handle: FileSystemDirectoryHandle, mode?: 'read' | 'readwrite'): Promise<boolean>;
+/** Ask for permission again, which needs a user gesture. */
+export declare function requestPermission(handle: FileSystemDirectoryHandle, mode?: 'read' | 'readwrite'): Promise<boolean>;
+//# sourceMappingURL=fs-access.d.ts.map

package/dist/fs-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-access.d.ts","sourceRoot":"","sources":["../src/fs-access.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,YAAY,EAEjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,CAAC,OAAO,CAAC,EAAE;QAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;KAC7B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACxC;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,qBAAa,iBAAkB,YAAW,cAAc;IACtD,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IACrC,OAAO,CAAC,IAAI,CAA4B;IACxC,gDAAgD;IAChD,OAAO,CAAC,WAAW,CAAS;IAC5B,yEAAyE;IACzE,OAAO,CAAC,IAAI,CAA6B;gBAE7B,IAAI,EAAE,yBAAyB,EAAE,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO;IAK7E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,OAAO,CAAC,KAAK;YAIC,YAAY;YAQZ,UAAU;IAQlB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAW1C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAStC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAW7C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAM7C,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,UAAU,EAC7B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC;IA2BjB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrE;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIjC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,KAAK,IAAI,UAAU;CA6BpB;AAED,sFAAsF;AACtF,wBAAsB,aAAa,IAAI,OAAO,CAAC,yBAAyB,CAAC,CAIxE;AAKD;;;GAGG;AACH,eAAO,MAAM,WAAW;iBACH,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;YAU9C,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;aAe7C,OAAO,CAAC,IAAI,CAAC;CAc7B,CAAC;AAEF,mEAAmE;AACnE,wBAAsB,aAAa,CACjC,MAAM,EAAE,yBAAyB,EACjC,IAAI,GAAE,MAAM,GAAG,WAAyB,GACvC,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,4DAA4D;AAC5D,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,yBAAyB,EACjC,IAAI,GAAE,MAAM,GAAG,WAAyB,GACvC,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/fs-access.js

@@ -0,0 +1,239 @@
+/**
+ * Local editing through the browser's File System Access API.
+ *
+ * The author picks their repository folder once, and the editor reads and writes it directly: no
+ * server, no token, no commit until they choose to push. This is the nicest local mode and also
+ * the least portable — only Chromium browsers implement the API — which is why the proxy exists
+ * as well.
+ *
+ * The handle is kept in IndexedDB because it cannot be serialised anywhere else, and permission is
+ * re-requested on each visit rather than assumed.
+ */
+import { ConflictError, NotFoundError, } from '@v7-cms/core/storage';
+export function supportsFileSystemAccess() {
+    return typeof window !== 'undefined' && 'showDirectoryPicker' in window;
+}
+export class FileSystemAdapter {
+    kind = 'fs-access';
+    root;
+    /** Media folder inside the picked directory. */
+    mediaFolder;
+    /** Content of the last read, so a write can detect an outside change. */
+    seen = new Map();
+    constructor(root, options = {}) {
+        this.root = root;
+        this.mediaFolder = options.mediaFolder ?? 'public/images/uploads';
+    }
+    async init() {
+        // Reading the root is the cheapest way to confirm permission is still granted.
+        await this.root.keys().next();
+    }
+    parts(path) {
+        return path.split('/').filter(Boolean);
+    }
+    async directoryFor(parts, create = false) {
+        let current = this.root;
+        for (const part of parts) {
+            current = await current.getDirectoryHandle(part, { create });
+        }
+        return current;
+    }
+    async fileHandle(path, create = false) {
+        const parts = this.parts(path);
+        const name = parts.pop();
+        if (!name)
+            throw new NotFoundError(path);
+        const directory = await this.directoryFor(parts, create);
+        return directory.getFileHandle(name, { create });
+    }
+    async listDir(path) {
+        const directory = await this.directoryFor(this.parts(path)).catch(() => null);
+        if (!directory)
+            return [];
+        const entries = [];
+        for await (const [name, handle] of directory.entries()) {
+            if (name.startsWith('.'))
+                continue;
+            entries.push({ name, type: handle.kind === 'directory' ? 'dir' : 'file' });
+        }
+        return entries.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    async exists(path) {
+        try {
+            await this.fileHandle(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async readFile(path) {
+        const handle = await this.fileHandle(path).catch(() => null);
+        if (!handle)
+            throw new NotFoundError(path);
+        const file = await handle.getFile();
+        const text = await file.text();
+        // The mtime doubles as the revision: it is what a later write checks against.
+        const sha = String(file.lastModified);
+        this.seen.set(path, sha);
+        return { text, sha };
+    }
+    async readBinary(path) {
+        const handle = await this.fileHandle(path).catch(() => null);
+        if (!handle)
+            throw new NotFoundError(path);
+        return new Uint8Array(await (await handle.getFile()).arrayBuffer());
+    }
+    async writeFile(path, contents, options) {
+        // If the file changed on disk since it was read, refuse rather than clobber. This is the only
+        // conflict signal the filesystem offers, and it is worth honouring: an editor that silently
+        // overwrites what another process wrote is worse than one that asks.
+        if (options.sha !== undefined) {
+            const handle = await this.fileHandle(path).catch(() => null);
+            if (handle) {
+                const current = String((await handle.getFile()).lastModified);
+                const original = this.seen.get(path);
+                if (original !== undefined && current !== original) {
+                    throw new ConflictError(`"${path}" changed since it was read.`);
+                }
+            }
+        }
+        const handle = await this.fileHandle(path, true);
+        const writable = await handle.createWritable();
+        await writable.write(typeof contents === 'string' ? contents : new Blob([contents]));
+        await writable.close();
+        const written = String((await handle.getFile()).lastModified);
+        this.seen.set(path, written);
+        return { sha: written };
+    }
+    async deleteFile(path, _options) {
+        void _options;
+        const parts = this.parts(path);
+        const name = parts.pop();
+        if (!name)
+            throw new NotFoundError(path);
+        const directory = await this.directoryFor(parts).catch(() => null);
+        if (!directory)
+            throw new NotFoundError(path);
+        await directory.removeEntry(name);
+        this.seen.delete(path);
+    }
+    /**
+     * There is no branch concept on a plain folder. Editorial workflow keeps its state in a file
+     * inside the repository instead, so this reports a single implicit branch.
+     */
+    async listBranches() {
+        return ['local'];
+    }
+    async createBranch() {
+        /* Nothing to create: the working copy is the branch. */
+    }
+    media() {
+        return {
+            upload: async (file, options) => {
+                const name = options.filename ?? file.name;
+                const path = `${options.folder.replace(/\/+$/, '')}/${name}`;
+                const result = await this.writeFile(path, file.data, { message: `Upload ${name}` });
+                return {
+                    path,
+                    url: `/${path}`,
+                    size: file.data.byteLength,
+                    name,
+                    ...(result.sha ? { sha: result.sha } : {}),
+                };
+            },
+            list: async (folder) => {
+                const entries = await this.listDir(folder);
+                return entries
+                    .filter((entry) => entry.type === 'file')
+                    .map((entry) => ({
+                    path: `${folder}/${entry.name}`,
+                    url: `/${folder}/${entry.name}`,
+                    name: entry.name,
+                }));
+            },
+            remove: async (path) => {
+                await this.deleteFile(path, { message: `Delete ${path}` });
+            },
+        };
+    }
+}
+/** Ask the author for their repository folder. Must be called from a user gesture. */
+export async function pickDirectory() {
+    const picker = window.showDirectoryPicker;
+    if (!picker)
+        throw new Error('This browser cannot open a local folder. Use the proxy instead.');
+    return picker({ mode: 'readwrite' });
+}
+const DB_NAME = 'v7-cms';
+const STORE = 'handles';
+/**
+ * Remember the picked folder between visits. Only the handle is stored, and the browser still
+ * asks for permission again — the API requires a gesture, and it keeps the grant honest.
+ */
+export const handleStore = {
+    async save(handle) {
+        const db = await open();
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE, 'readwrite');
+            tx.objectStore(STORE).put(handle, 'root');
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error ?? new Error('Could not remember the folder.'));
+        });
+        db.close();
+    },
+    async load() {
+        try {
+            const db = await open();
+            const handle = await new Promise((resolve, reject) => {
+                const tx = db.transaction(STORE, 'readonly');
+                const request = tx.objectStore(STORE).get('root');
+                request.onsuccess = () => resolve(request.result);
+                request.onerror = () => reject(request.error ?? new Error('unavailable'));
+            });
+            db.close();
+            return handle;
+        }
+        catch {
+            return undefined;
+        }
+    },
+    async clear() {
+        try {
+            const db = await open();
+            await new Promise((resolve) => {
+                const tx = db.transaction(STORE, 'readwrite');
+                tx.objectStore(STORE).delete('root');
+                tx.oncomplete = () => resolve();
+                tx.onerror = () => resolve();
+            });
+            db.close();
+        }
+        catch {
+            /* Nothing to clear. */
+        }
+    },
+};
+/** Whether the stored handle is still usable without prompting. */
+export async function hasPermission(handle, mode = 'readwrite') {
+    const query = handle.queryPermission;
+    if (!query)
+        return true;
+    return (await query.call(handle, { mode })) === 'granted';
+}
+/** Ask for permission again, which needs a user gesture. */
+export async function requestPermission(handle, mode = 'readwrite') {
+    const request = handle.requestPermission;
+    if (!request)
+        return true;
+    return (await request.call(handle, { mode })) === 'granted';
+}
+function open() {
+    return new Promise((resolve, reject) => {
+        const request = indexedDB.open(DB_NAME, 1);
+        request.onupgradeneeded = () => request.result.createObjectStore(STORE);
+        request.onsuccess = () => resolve(request.result);
+        request.onerror = () => reject(request.error ?? new Error('IndexedDB unavailable'));
+    });
+}
+//# sourceMappingURL=fs-access.js.map

package/dist/fs-access.js.map

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

package/dist/github/adapter.d.ts

@@ -0,0 +1,78 @@
+/**
+ * The GitHub backend.
+ *
+ * Reads and writes repository contents through the REST API. Two things shape the design:
+ *
+ * - Every write carries the sha it was based on, so a change made elsewhere in the meantime is
+ *   refused rather than silently overwritten. `ConflictError` is what the editor reacts to.
+ * - Listing uses the trees API once per directory tree and caches it, instead of one request per
+ *   file, because a content folder with a few hundred entries would otherwise cost a few hundred
+ *   requests against a rate limit.
+ */
+import { type AccountInfo, type DirEntry, type FileContents, type MediaStore, type StorageAdapter, type WriteOptions, type WriteResult } from '@v7-cms/core/storage';
+export interface GitHubAdapterOptions {
+    owner: string;
+    repo: string;
+    branch?: string;
+    token: string;
+    /** Override for GitHub Enterprise. */
+    apiRoot?: string;
+    /** Injected in tests so the network can be faked. */
+    fetch?: typeof globalThis.fetch;
+    /** How the token was obtained; reported by `account()` so the UI can explain sign-out. */
+    via?: 'oauth' | 'token';
+    /** Commit author. GitHub attributes the commit to the token's user without this. */
+    author?: {
+        name: string;
+        email: string;
+    };
+}
+export declare class GitHubAdapter implements StorageAdapter {
+    readonly kind: "github";
+    private readonly owner;
+    private readonly repo;
+    private readonly apiRoot;
+    private readonly request;
+    private token;
+    private branch;
+    private via;
+    /** Cached after the first lookup, so the shell does not re-request on every render. */
+    private accountInfo;
+    private accountFetched;
+    private author?;
+    /** Path -> blob sha, filled from one tree request per branch. */
+    private tree;
+    private dirCache;
+    constructor(options: GitHubAdapterOptions);
+    init(): Promise<void>;
+    /**
+     * The authenticated user, fetched once.
+     *
+     * The token alone says nothing about who holds it, and an author who signed in on a shared
+     * machine needs to see that. `init()` already proved the token works, so a failure here is not
+     * worth failing the editor over — it returns undefined and the panel falls back to the repo.
+     */
+    account(): Promise<AccountInfo | undefined>;
+    /** Swap the token after a sign-in, so the same adapter can outlive a session change. */
+    setToken(token: string): void;
+    setBranch(branch: string): void;
+    private call;
+    /**
+     * One request for the whole branch, then everything is served from it. Cleared on every write,
+     * so a stale listing is never shown after a change.
+     */
+    private loadTree;
+    private forget;
+    listDir(path: string): Promise<DirEntry[]>;
+    exists(path: string): Promise<boolean>;
+    readFile(path: string): Promise<FileContents>;
+    readBinary(path: string): Promise<Uint8Array>;
+    writeFile(path: string, contents: string | Uint8Array, options: WriteOptions): Promise<WriteResult>;
+    private currentSha;
+    deleteFile(path: string, options: WriteOptions): Promise<void>;
+    listBranches(): Promise<string[]>;
+    createBranch(name: string, from: string): Promise<void>;
+    /** Media lives in the repository for this backend, so it reuses the same writes. */
+    media(): MediaStore;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/github/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/github/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EAEjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,0FAA0F;IAC1F,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,oFAAoF;IACpF,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAQD,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAAoB;IAC/B,uFAAuF;IACvF,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,iEAAiE;IACjE,OAAO,CAAC,IAAI,CAAoC;IAChD,OAAO,CAAC,QAAQ,CAAiC;gBAErC,OAAO,EAAE,oBAAoB;IAenC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAwBjD,wFAAwF;IACxF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ7B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;YAMjB,IAAI;IAalB;;;OAGG;YACW,QAAQ;IActB,OAAO,CAAC,MAAM;IAKR,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAqB1C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAa7C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAW7C,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,UAAU,EAC7B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC;YAyCT,UAAU;IAalB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9D,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMjC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB7D,oFAAoF;IACpF,KAAK,IAAI,UAAU;CA0BpB"}