nebula-cms 0.1.3 → 0.1.5

package/dist/client/js/storage/adapter.d.ts.map

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

package/dist/client/js/storage/adapter.js

@@ -0,0 +1,5 @@
+/*
+ * Storage adapter interface and shared types.
+ * Defines the contract that FSA and GitHub storage backends implement.
+ */
+export {};

package/dist/client/js/storage/client.d.ts

@@ -0,0 +1,72 @@
+import type { StorageRequest, FileEntry, FileWrite } from './adapter';
+export declare class StorageClient {
+    private port;
+    private pending;
+    private idCounter;
+    /**
+     * Creates a client wrapping the given port.
+     * @param {MessagePort} port - The port connected to the storage SharedWorker
+     */
+    constructor(port: MessagePort);
+    /**
+     * Routes responses to their pending promises. Responses without an _id are broadcast (like port-connected) and are ignored here.
+     * @param {StorageResponse & { _id?: string }} data - The response data
+     * @return {void}
+     */
+    private handleResponse;
+    /**
+     * Sends a request and waits for the matching response.
+     * @param {StorageRequest} msg - The request to send
+     * @return {Promise<StorageResponse>} The matched response
+     */
+    private send;
+    /**
+     * Initializes the backend adapter in the SharedWorker.
+     * @param {StorageRequest & { type: 'init' }} config - The init config
+     * @return {Promise<void>}
+     */
+    init(config: StorageRequest & {
+        type: 'init';
+    }): Promise<void>;
+    /**
+     * Lists files in a collection matching the given extensions.
+     * @param {string} collection - The collection name
+     * @param {string[]} extensions - File extensions to include (e.g. ['.md', '.mdx'])
+     * @return {Promise<FileEntry[]>} Array of file entries
+     */
+    listFiles(collection: string, extensions: string[]): Promise<FileEntry[]>;
+    /**
+     * Reads a single file's content.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename
+     * @return {Promise<string>} The file content
+     */
+    readFile(collection: string, filename: string): Promise<string>;
+    /**
+     * Writes a single file.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename
+     * @param {string} content - The content to write
+     * @return {Promise<void>}
+     */
+    writeFile(collection: string, filename: string, content: string): Promise<void>;
+    /**
+     * Writes multiple files atomically.
+     * @param {FileWrite[]} files - Array of files to write
+     * @return {Promise<void>}
+     */
+    writeFiles(files: FileWrite[]): Promise<void>;
+    /**
+     * Deletes a file from a collection. Used during file type conversion to remove the old file after the new one is written.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename to delete
+     * @return {Promise<void>}
+     */
+    deleteFile(collection: string, filename: string): Promise<void>;
+    /**
+     * Tears down the active backend adapter.
+     * @return {Promise<void>}
+     */
+    teardown(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client/js/storage/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/client/js/storage/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,cAAc,EAEd,SAAS,EACT,SAAS,EACV,MAAM,WAAW,CAAC;AAEnB,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,OAAO,CAGX;IACJ,OAAO,CAAC,SAAS,CAAK;IAEtB;;;OAGG;gBACS,IAAI,EAAE,WAAW;IAQ7B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAYtB;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAQZ;;;;OAIG;IACG,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;OAKG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,SAAS,EAAE,CAAC;IAWvB;;;;;OAKG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWrE;;;;;;OAMG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/client/js/storage/client.js

@@ -0,0 +1,121 @@
+/*
+ * Typed client for communicating with the storage SharedWorker over a MessagePort.
+ * Wraps postMessage/onmessage into async request/response calls.
+ */
+export class StorageClient {
+    port;
+    pending = new Map();
+    idCounter = 0;
+    /**
+     * Creates a client wrapping the given port.
+     * @param {MessagePort} port - The port connected to the storage SharedWorker
+     */
+    constructor(port) {
+        this.port = port;
+        this.port.addEventListener('message', (event) => {
+            this.handleResponse(event.data);
+        });
+        this.port.start();
+    }
+    /**
+     * Routes responses to their pending promises. Responses without an _id are broadcast (like port-connected) and are ignored here.
+     * @param {StorageResponse & { _id?: string }} data - The response data
+     * @return {void}
+     */
+    handleResponse(data) {
+        if (!data._id)
+            return;
+        const entry = this.pending.get(data._id);
+        if (!entry)
+            return;
+        this.pending.delete(data._id);
+        if ('ok' in data && data.ok === false && 'error' in data) {
+            entry.reject(new Error(data.error));
+        }
+        else {
+            entry.resolve(data);
+        }
+    }
+    /**
+     * Sends a request and waits for the matching response.
+     * @param {StorageRequest} msg - The request to send
+     * @return {Promise<StorageResponse>} The matched response
+     */
+    send(msg) {
+        const _id = String(++this.idCounter);
+        return new Promise((resolve, reject) => {
+            this.pending.set(_id, { resolve, reject });
+            this.port.postMessage({ ...msg, _id });
+        });
+    }
+    /**
+     * Initializes the backend adapter in the SharedWorker.
+     * @param {StorageRequest & { type: 'init' }} config - The init config
+     * @return {Promise<void>}
+     */
+    async init(config) {
+        await this.send(config);
+    }
+    /**
+     * Lists files in a collection matching the given extensions.
+     * @param {string} collection - The collection name
+     * @param {string[]} extensions - File extensions to include (e.g. ['.md', '.mdx'])
+     * @return {Promise<FileEntry[]>} Array of file entries
+     */
+    async listFiles(collection, extensions) {
+        const res = await this.send({
+            type: 'listFiles',
+            collection,
+            extensions,
+        });
+        return res.files;
+    }
+    /**
+     * Reads a single file's content.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename
+     * @return {Promise<string>} The file content
+     */
+    async readFile(collection, filename) {
+        const res = await this.send({
+            type: 'readFile',
+            collection,
+            filename,
+        });
+        return res.content;
+    }
+    /**
+     * Writes a single file.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename
+     * @param {string} content - The content to write
+     * @return {Promise<void>}
+     */
+    async writeFile(collection, filename, content) {
+        await this.send({ type: 'writeFile', collection, filename, content });
+    }
+    /**
+     * Writes multiple files atomically.
+     * @param {FileWrite[]} files - Array of files to write
+     * @return {Promise<void>}
+     */
+    async writeFiles(files) {
+        await this.send({ type: 'writeFiles', files });
+    }
+    /**
+     * Deletes a file from a collection. Used during file type conversion to remove the old file after the new one is written.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename to delete
+     * @return {Promise<void>}
+     */
+    async deleteFile(collection, filename) {
+        await this.send({ type: 'deleteFile', collection, filename });
+    }
+    /**
+     * Tears down the active backend adapter.
+     * @return {Promise<void>}
+     */
+    async teardown() {
+        await this.send({ type: 'teardown' });
+    }
+}

package/dist/client/js/storage/db.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Opens (or returns the cached) shared IndexedDB database, creating or upgrading stores as needed.
+ * The connection is opened once and reused, avoiding a new indexedDB.open() round-trip per call.
+ * Version 1: handles store only. Version 2: adds drafts store.
+ * @return {Promise<IDBDatabase>} Promise resolving to the database instance
+ */
+export declare function openDB(): Promise<IDBDatabase>;
+//# sourceMappingURL=db.d.ts.map

package/dist/client/js/storage/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../../src/client/js/storage/db.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,CAqB7C"}

package/dist/client/js/storage/db.js

@@ -0,0 +1,35 @@
+// Database name for admin CMS persistence
+const DB_NAME = 'cms-admin';
+// Current database version — bumped from 1 to add the drafts store
+const DB_VERSION = 2;
+// Cached database promise — opened once, reused by all callers
+let dbPromise = null;
+/**
+ * Opens (or returns the cached) shared IndexedDB database, creating or upgrading stores as needed.
+ * The connection is opened once and reused, avoiding a new indexedDB.open() round-trip per call.
+ * Version 1: handles store only. Version 2: adds drafts store.
+ * @return {Promise<IDBDatabase>} Promise resolving to the database instance
+ */
+export function openDB() {
+    if (dbPromise)
+        return dbPromise;
+    dbPromise = new Promise((resolve, reject) => {
+        const request = indexedDB.open(DB_NAME, DB_VERSION);
+        request.onupgradeneeded = () => {
+            const db = request.result;
+            if (!db.objectStoreNames.contains('handles')) {
+                db.createObjectStore('handles');
+            }
+            if (!db.objectStoreNames.contains('drafts')) {
+                db.createObjectStore('drafts', { keyPath: 'id' });
+            }
+        };
+        request.onsuccess = () => resolve(request.result);
+        request.onerror = () => {
+            // Reset cache so the next caller retries instead of getting a stale rejection
+            dbPromise = null;
+            reject(request.error);
+        };
+    });
+    return dbPromise;
+}

package/dist/client/js/storage/fsa.d.ts

@@ -0,0 +1,51 @@
+import type { StorageAdapter, FileEntry, FileWrite } from './adapter';
+export declare class FsaAdapter implements StorageAdapter {
+    private root;
+    /**
+     * Creates an FSA adapter rooted at the given directory handle.
+     * @param {FileSystemDirectoryHandle} root - The project root directory handle
+     */
+    constructor(root: FileSystemDirectoryHandle);
+    /**
+     * Traverses root → src → content → {collection}.
+     * @param {string} collection - The collection name
+     * @return {Promise<FileSystemDirectoryHandle>} The collection directory handle
+     */
+    private getCollectionDir;
+    /**
+     * Lists files in the collection matching the given extensions, with their content.
+     * @param {string} collection - The collection name
+     * @param {string[]} extensions - File extensions to include (e.g. ['.md', '.mdx'])
+     * @return {Promise<FileEntry[]>} Array of filename + content pairs
+     */
+    listFiles(collection: string, extensions: string[]): Promise<FileEntry[]>;
+    /**
+     * Deletes a file from the collection directory.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename to delete
+     * @return {Promise<void>}
+     */
+    deleteFile(collection: string, filename: string): Promise<void>;
+    /**
+     * Reads a single file's content from the collection.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename
+     * @return {Promise<string>} The file content
+     */
+    readFile(collection: string, filename: string): Promise<string>;
+    /**
+     * Writes content to a file, creating it if necessary.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename
+     * @param {string} content - The content to write
+     * @return {Promise<void>}
+     */
+    writeFile(collection: string, filename: string, content: string): Promise<void>;
+    /**
+     * Writes multiple files sequentially (FSA has no atomic multi-file write).
+     * @param {FileWrite[]} files - Array of files to write
+     * @return {Promise<void>}
+     */
+    writeFiles(files: FileWrite[]): Promise<void>;
+}
+//# sourceMappingURL=fsa.d.ts.map

package/dist/client/js/storage/fsa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsa.d.ts","sourceRoot":"","sources":["../../../../src/client/js/storage/fsa.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtE,qBAAa,UAAW,YAAW,cAAc;IAKnC,OAAO,CAAC,IAAI;IAJxB;;;OAGG;gBACiB,IAAI,EAAE,yBAAyB;IAEnD;;;;OAIG;YACW,gBAAgB;IAQ9B;;;;;OAKG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,SAAS,EAAE,CAAC;IAmBvB;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrE;;;;;OAKG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOrE;;;;;;OAMG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAQhB;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAKpD"}

package/dist/client/js/storage/fsa.js

@@ -0,0 +1,91 @@
+/*
+ * Storage adapter backed by the File System Access API.
+ * Traverses from a project root handle through src/content/{collection}/ for all operations.
+ */
+// FSA adapter implementation
+export class FsaAdapter {
+    root;
+    /**
+     * Creates an FSA adapter rooted at the given directory handle.
+     * @param {FileSystemDirectoryHandle} root - The project root directory handle
+     */
+    constructor(root) {
+        this.root = root;
+    }
+    /**
+     * Traverses root → src → content → {collection}.
+     * @param {string} collection - The collection name
+     * @return {Promise<FileSystemDirectoryHandle>} The collection directory handle
+     */
+    async getCollectionDir(collection) {
+        const src = await this.root.getDirectoryHandle('src');
+        const content = await src.getDirectoryHandle('content');
+        return content.getDirectoryHandle(collection);
+    }
+    /**
+     * Lists files in the collection matching the given extensions, with their content.
+     * @param {string} collection - The collection name
+     * @param {string[]} extensions - File extensions to include (e.g. ['.md', '.mdx'])
+     * @return {Promise<FileEntry[]>} Array of filename + content pairs
+     */
+    async listFiles(collection, extensions) {
+        const dir = await this.getCollectionDir(collection);
+        const entries = [];
+        for await (const [name, entry] of dir.entries()) {
+            if (entry.kind !== 'file' ||
+                !extensions.some((ext) => name.endsWith(ext))) {
+                continue;
+            }
+            const file = await entry.getFile();
+            const content = await file.text();
+            entries.push({ filename: name, content });
+        }
+        return entries;
+    }
+    /**
+     * Deletes a file from the collection directory.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename to delete
+     * @return {Promise<void>}
+     */
+    async deleteFile(collection, filename) {
+        const dir = await this.getCollectionDir(collection);
+        await dir.removeEntry(filename);
+    }
+    /**
+     * Reads a single file's content from the collection.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename
+     * @return {Promise<string>} The file content
+     */
+    async readFile(collection, filename) {
+        const dir = await this.getCollectionDir(collection);
+        const fileHandle = await dir.getFileHandle(filename);
+        const file = await fileHandle.getFile();
+        return file.text();
+    }
+    /**
+     * Writes content to a file, creating it if necessary.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename
+     * @param {string} content - The content to write
+     * @return {Promise<void>}
+     */
+    async writeFile(collection, filename, content) {
+        const dir = await this.getCollectionDir(collection);
+        const fileHandle = await dir.getFileHandle(filename, { create: true });
+        const writable = await fileHandle.createWritable();
+        await writable.write(content);
+        await writable.close();
+    }
+    /**
+     * Writes multiple files sequentially (FSA has no atomic multi-file write).
+     * @param {FileWrite[]} files - Array of files to write
+     * @return {Promise<void>}
+     */
+    async writeFiles(files) {
+        for (const f of files) {
+            await this.writeFile(f.collection, f.filename, f.content);
+        }
+    }
+}

package/dist/client/js/storage/github.d.ts

@@ -0,0 +1,62 @@
+import type { StorageAdapter, FileEntry, FileWrite } from './adapter';
+export declare class GitHubAdapter implements StorageAdapter {
+    private token;
+    private owner;
+    private repo;
+    private defaultBranch;
+    /**
+     * @param {string} token - GitHub Personal Access Token
+     * @param {string} repoSlug - Repository in "owner/repo" format
+     */
+    constructor(token: string, repoSlug: string);
+    /**
+     * Validates credentials by fetching repo metadata and caches the default branch.
+     * @return {Promise<void>}
+     */
+    validate(): Promise<void>;
+    /**
+     * Lists files in a collection matching the given extensions, with their raw content.
+     * @param {string} collection - The collection name
+     * @param {string[]} extensions - File extensions to include (e.g. ['.md', '.mdx'])
+     * @return {Promise<FileEntry[]>} Array of filename + content pairs
+     */
+    listFiles(collection: string, extensions: string[]): Promise<FileEntry[]>;
+    /**
+     * Deletes a file from the repository via the Contents API.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename to delete
+     * @return {Promise<void>}
+     */
+    deleteFile(collection: string, filename: string): Promise<void>;
+    /**
+     * Reads a single file's raw content via the raw+json Accept header.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename
+     * @return {Promise<string>} The file content
+     */
+    readFile(collection: string, filename: string): Promise<string>;
+    /**
+     * Writes a single file via the Contents API. Fetches the current SHA for updates.
+     * @param {string} collection - The collection name
+     * @param {string} filename - The filename
+     * @param {string} content - The content to write
+     * @return {Promise<void>}
+     */
+    writeFile(collection: string, filename: string, content: string): Promise<void>;
+    /**
+     * Writes multiple files in a single atomic commit using the Git Trees + Commits API.
+     * @param {FileWrite[]} files - Array of files to write
+     * @return {Promise<void>}
+     */
+    writeFiles(files: FileWrite[]): Promise<void>;
+    /**
+     * Makes an authenticated request to the GitHub API.
+     * @param {string} method - HTTP method
+     * @param {string} path - API path (appended to https://api.github.com)
+     * @param {Record<string, string>} [extraHeaders] - Additional headers to merge
+     * @param {unknown} [body] - JSON body to send
+     * @return {Promise<Response>} The fetch response
+     */
+    private request;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/client/js/storage/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../../src/client/js/storage/github.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAatE,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,IAAI,CAAS;IAErB,OAAO,CAAC,aAAa,CAAkB;IAEvC;;;OAGG;gBACS,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAO3C;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B;;;;;OAKG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,SAAS,EAAE,CAAC;IA2BvB;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBrE;;;;;OAKG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAarE;;;;;;OAMG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAgChB;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4EnD;;;;;;;OAOG;YACW,OAAO;CAyBtB"}