nebula-cms 0.1.0 → 0.1.4

package/src/client/js/storage/fsa.ts

@@ -1,110 +0,0 @@
-/*
- * Storage adapter backed by the File System Access API.
- * Traverses from a project root handle through src/content/{collection}/ for all operations.
- */
-
-import type { StorageAdapter, FileEntry, FileWrite } from './adapter';
-
-// FSA adapter implementation
-export class FsaAdapter implements StorageAdapter {
-  /**
-   * Creates an FSA adapter rooted at the given directory handle.
-   * @param {FileSystemDirectoryHandle} root - The project root directory handle
-   */
-  constructor(private root: FileSystemDirectoryHandle) {}
-
-  /**
-   * Traverses root → src → content → {collection}.
-   * @param {string} collection - The collection name
-   * @return {Promise<FileSystemDirectoryHandle>} The collection directory handle
-   */
-  private async getCollectionDir(
-    collection: string,
-  ): Promise<FileSystemDirectoryHandle> {
-    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: string,
-    extensions: string[],
-  ): Promise<FileEntry[]> {
-    const dir = await this.getCollectionDir(collection);
-    const entries: FileEntry[] = [];
-
-    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: string, filename: string): Promise<void> {
-    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: string, filename: string): Promise<string> {
-    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: string,
-    filename: string,
-    content: string,
-  ): Promise<void> {
-    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: FileWrite[]): Promise<void> {
-    for (const f of files) {
-      await this.writeFile(f.collection, f.filename, f.content);
-    }
-  }
-}

package/src/client/js/storage/github.ts

@@ -1,297 +0,0 @@
-/*
- * Storage adapter backed by the GitHub REST API.
- * Uses a Personal Access Token for authentication. All file operations
- * target src/content/{collection}/ within the repository.
- */
-
-import type { StorageAdapter, FileEntry, FileWrite } from './adapter';
-
-/**
- * Encodes a Uint8Array to a base64 string without using deprecated unescape().
- * @param {Uint8Array} bytes - The bytes to encode
- * @return {string} Base64-encoded string
- */
-function uint8ToBase64(bytes: Uint8Array): string {
-  let binary = '';
-  for (const byte of bytes) binary += String.fromCharCode(byte);
-  return btoa(binary);
-}
-
-export class GitHubAdapter implements StorageAdapter {
-  private token: string;
-  private owner: string;
-  private repo: string;
-  // Cached on validate(); defaults to 'main' before validation
-  private defaultBranch: string = 'main';
-
-  /**
-   * @param {string} token - GitHub Personal Access Token
-   * @param {string} repoSlug - Repository in "owner/repo" format
-   */
-  constructor(token: string, repoSlug: string) {
-    this.token = token;
-    const [owner, repo] = repoSlug.split('/');
-    this.owner = owner;
-    this.repo = repo;
-  }
-
-  /**
-   * Validates credentials by fetching repo metadata and caches the default branch.
-   * @return {Promise<void>}
-   */
-  async validate(): Promise<void> {
-    const res = await this.request('GET', `/repos/${this.owner}/${this.repo}`);
-    if (!res.ok) {
-      const status = res.status;
-      if (status === 401) throw new Error('Invalid or expired token');
-      if (status === 403) throw new Error('Token lacks repository access');
-      if (status === 404)
-        throw new Error(`Repository "${this.owner}/${this.repo}" not found`);
-      throw new Error(`GitHub API error: ${status}`);
-    }
-    const data = await res.json();
-    this.defaultBranch = data.default_branch;
-  }
-
-  /**
-   * 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
-   */
-  async listFiles(
-    collection: string,
-    extensions: string[],
-  ): Promise<FileEntry[]> {
-    const path = `src/content/${collection}`;
-    // Get directory listing
-    const listRes = await this.request(
-      'GET',
-      `/repos/${this.owner}/${this.repo}/contents/${path}?ref=${this.defaultBranch}`,
-    );
-    if (!listRes.ok) {
-      if (listRes.status === 404) return [];
-      throw new Error(`Failed to list files: ${listRes.status}`);
-    }
-    const listing: Array<{ name: string; download_url: string }> =
-      await listRes.json();
-
-    // Filter to requested extensions and fetch all files in parallel
-    const filtered = listing.filter((f) =>
-      extensions.some((ext) => f.name.endsWith(ext)),
-    );
-
-    return Promise.all(
-      filtered.map(async (file) => ({
-        filename: file.name,
-        content: await this.readFile(collection, file.name),
-      })),
-    );
-  }
-
-  /**
-   * 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>}
-   */
-  async deleteFile(collection: string, filename: string): Promise<void> {
-    const path = `src/content/${collection}/${filename}`;
-    // Get the current SHA (required by the GitHub Contents API for deletion)
-    const existing = await this.request(
-      'GET',
-      `/repos/${this.owner}/${this.repo}/contents/${path}?ref=${this.defaultBranch}`,
-    );
-    if (!existing.ok) throw new Error(`File not found for deletion: ${path}`);
-    const data = await existing.json();
-
-    const res = await this.request(
-      'DELETE',
-      `/repos/${this.owner}/${this.repo}/contents/${path}`,
-      undefined,
-      {
-        message: `Delete ${path}`,
-        sha: data.sha,
-        branch: this.defaultBranch,
-      },
-    );
-    if (!res.ok) throw new Error(`Failed to delete ${path}: ${res.status}`);
-  }
-
-  /**
-   * 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
-   */
-  async readFile(collection: string, filename: string): Promise<string> {
-    const path = `src/content/${collection}/${filename}`;
-    const res = await this.request(
-      'GET',
-      `/repos/${this.owner}/${this.repo}/contents/${path}?ref=${this.defaultBranch}`,
-      { Accept: 'application/vnd.github.raw+json' },
-    );
-    if (!res.ok) {
-      throw new Error(`Failed to read ${path}: ${res.status}`);
-    }
-    return res.text();
-  }
-
-  /**
-   * 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>}
-   */
-  async writeFile(
-    collection: string,
-    filename: string,
-    content: string,
-  ): Promise<void> {
-    const path = `src/content/${collection}/${filename}`;
-    // Get current SHA if file exists (required by GitHub API for updates)
-    let sha: string | undefined;
-    const existing = await this.request(
-      'GET',
-      `/repos/${this.owner}/${this.repo}/contents/${path}?ref=${this.defaultBranch}`,
-    );
-    if (existing.ok) {
-      const data = await existing.json();
-      sha = data.sha;
-    }
-
-    const body: Record<string, string> = {
-      message: `Update ${path}`,
-      content: uint8ToBase64(new TextEncoder().encode(content)),
-      branch: this.defaultBranch,
-    };
-    if (sha) body.sha = sha;
-
-    const res = await this.request(
-      'PUT',
-      `/repos/${this.owner}/${this.repo}/contents/${path}`,
-      undefined,
-      body,
-    );
-    if (!res.ok) {
-      const errText = await res.text();
-      throw new Error(`Failed to write ${path}: ${res.status} ${errText}`);
-    }
-  }
-
-  /**
-   * 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>}
-   */
-  async writeFiles(files: FileWrite[]): Promise<void> {
-    if (files.length === 0) return;
-    if (files.length === 1) {
-      await this.writeFile(
-        files[0].collection,
-        files[0].filename,
-        files[0].content,
-      );
-      return;
-    }
-
-    // 1. Get current commit SHA for the default branch
-    const refRes = await this.request(
-      'GET',
-      `/repos/${this.owner}/${this.repo}/git/ref/heads/${this.defaultBranch}`,
-    );
-    if (!refRes.ok)
-      throw new Error(`Failed to get branch ref: ${refRes.status}`);
-    const refData = await refRes.json();
-    const baseCommitSHA = refData.object.sha;
-
-    // Get the base tree SHA from the current commit
-    const commitRes = await this.request(
-      'GET',
-      `/repos/${this.owner}/${this.repo}/git/commits/${baseCommitSHA}`,
-    );
-    if (!commitRes.ok)
-      throw new Error(`Failed to get commit: ${commitRes.status}`);
-    const commitData = await commitRes.json();
-    const baseTreeSHA = commitData.tree.sha;
-
-    // 2. Create a new tree containing all file changes
-    const tree = files.map((f) => ({
-      path: `src/content/${f.collection}/${f.filename}`,
-      mode: '100644' as const,
-      type: 'blob' as const,
-      content: f.content,
-    }));
-
-    const treeRes = await this.request(
-      'POST',
-      `/repos/${this.owner}/${this.repo}/git/trees`,
-      undefined,
-      { base_tree: baseTreeSHA, tree },
-    );
-    if (!treeRes.ok)
-      throw new Error(`Failed to create tree: ${treeRes.status}`);
-    const treeData = await treeRes.json();
-
-    // 3. Create a new commit pointing at the new tree
-    const paths = files.map((f) => `${f.collection}/${f.filename}`).join(', ');
-    const newCommitRes = await this.request(
-      'POST',
-      `/repos/${this.owner}/${this.repo}/git/commits`,
-      undefined,
-      {
-        message: `Update ${paths}`,
-        tree: treeData.sha,
-        parents: [baseCommitSHA],
-      },
-    );
-    if (!newCommitRes.ok)
-      throw new Error(`Failed to create commit: ${newCommitRes.status}`);
-    const newCommitData = await newCommitRes.json();
-
-    // 4. Advance the branch ref to the new commit
-    const updateRefRes = await this.request(
-      'PATCH',
-      `/repos/${this.owner}/${this.repo}/git/refs/heads/${this.defaultBranch}`,
-      undefined,
-      { sha: newCommitData.sha },
-    );
-    if (!updateRefRes.ok)
-      throw new Error(`Failed to update ref: ${updateRefRes.status}`);
-  }
-
-  /**
-   * 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 async request(
-    method: string,
-    path: string,
-    extraHeaders?: Record<string, string>,
-    body?: unknown,
-  ): Promise<Response> {
-    const headers: Record<string, string> = {
-      Authorization: `Bearer ${this.token}`,
-      'X-GitHub-Api-Version': '2026-03-10',
-      // Default to JSON so the browser cache distinguishes from raw content requests
-      Accept: 'application/vnd.github+json',
-      ...extraHeaders,
-    };
-    if (body) {
-      headers['Content-Type'] = 'application/json';
-    }
-
-    return fetch(`https://api.github.com${path}`, {
-      method,
-      headers,
-      body: body ? JSON.stringify(body) : undefined,
-      // API responses must never be served from browser cache
-      cache: 'no-store',
-    });
-  }
-}

package/src/client/js/storage/storage.ts

@@ -1,83 +0,0 @@
-/*
- * Backend configuration persistence using IndexedDB.
- * Stores and retrieves the active storage backend (FSA or GitHub).
- */
-
-import { openDB } from './db';
-
-// Fixed key for the backend config
-const BACKEND_KEY = 'backend';
-
-/**
- * Backend configuration stored in IndexedDB. Tagged union discriminated on `type`.
- * Security note: the GitHub token is stored in plaintext in IndexedDB. This is a
- * deliberate trade-off for a client-only app with no server to proxy through.
- * Same-origin policy protects it from other sites, but any XSS vulnerability
- * would expose the token.
- */
-export type BackendConfig =
-  | { type: 'fsa'; handle: FileSystemDirectoryHandle }
-  | { type: 'github'; token: string; repo: string };
-
-/**
- * Stores backend configuration in IndexedDB for persistence across sessions.
- * @param {BackendConfig} config - The backend config to store
- * @return {Promise<void>}
- */
-export async function saveBackend(config: BackendConfig): Promise<void> {
-  const db = await openDB();
-  return new Promise((resolve, reject) => {
-    const tx = db.transaction('handles', 'readwrite');
-    tx.objectStore('handles').put(config, BACKEND_KEY);
-    tx.oncomplete = () => resolve();
-    tx.onerror = () => reject(tx.error);
-  });
-}
-
-/**
- * Retrieves stored backend configuration from IndexedDB. Handles migration from the old format where a bare FileSystemDirectoryHandle was stored.
- * @return {Promise<BackendConfig | null>} The stored config, or null if none exists
- */
-export async function loadBackend(): Promise<BackendConfig | null> {
-  const db = await openDB();
-  return new Promise((resolve, reject) => {
-    const tx = db.transaction('handles', 'readonly');
-    const request = tx.objectStore('handles').get(BACKEND_KEY);
-    request.onsuccess = () => {
-      const result = request.result;
-      if (!result) {
-        // Check for old-format handle stored under the legacy key
-        const legacyRequest = tx.objectStore('handles').get('projectRoot');
-        legacyRequest.onsuccess = () => {
-          const legacy = legacyRequest.result;
-          if (legacy && legacy instanceof FileSystemDirectoryHandle) {
-            resolve({ type: 'fsa', handle: legacy });
-          } else {
-            resolve(null);
-          }
-        };
-        legacyRequest.onerror = () => resolve(null);
-        return;
-      }
-      resolve(result as BackendConfig);
-    };
-    request.onerror = () => reject(request.error);
-  });
-}
-
-/**
- * Removes the stored backend configuration from IndexedDB. Also clears the legacy key if present.
- * @return {Promise<void>}
- */
-export async function clearBackend(): Promise<void> {
-  const db = await openDB();
-  return new Promise((resolve, reject) => {
-    const tx = db.transaction('handles', 'readwrite');
-    const store = tx.objectStore('handles');
-    store.delete(BACKEND_KEY);
-    // Clean up legacy key if present
-    store.delete('projectRoot');
-    tx.oncomplete = () => resolve();
-    tx.onerror = () => reject(tx.error);
-  });
-}