@sleekcms/sync 1.7.0 → 2.1.0

package/dist/setup-site.js

@@ -1,299 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * SleekCMS site sync — standalone, self-contained.
- *
- * Bi-directional sync between a local workspace and the SleekCMS server.
- * Safe to invoke repeatedly: a `.cache/state.json` inside the workspace
- * tracks server-known state so only real diffs are pushed.
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveViewsDir = resolveViewsDir;
-exports.syncSite = syncSite;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const os_1 = __importDefault(require("os"));
-const path_1 = __importDefault(require("path"));
-const commander_1 = require("commander");
-const API_BASE_URLS = {
-    localhost: "http://app.sleekcms.test/api/mcp",
-    development: "https://app.sleekcms.dev/api/mcp",
-    production: "https://app.sleekcms.com/api/mcp",
-};
-const SRC_DIRS = [
-    "src/views/blocks",
-    "src/views/entries",
-    "src/views/pages",
-    "src/views/layouts",
-    "src/models/blocks",
-    "src/models/entries",
-    "src/models/pages",
-    "src/content/pages",
-    "src/content/entries",
-    "src/public/js",
-    "src/public/css",
-];
-class RequestError extends Error {
-    status;
-    body;
-    constructor(message, status, body) {
-        super(message);
-        this.status = status;
-        this.body = body;
-    }
-}
-async function request(baseUrl, token, method, p, body) {
-    const res = await fetch(baseUrl + p, {
-        method,
-        headers: {
-            Authorization: `Bearer ${token}`,
-            ...(body !== undefined ? { "Content-Type": "application/json" } : {}),
-        },
-        body: body !== undefined ? JSON.stringify(body) : undefined,
-    });
-    if (!res.ok) {
-        const text = await res.text();
-        throw new RequestError(`${method} ${p} → ${res.status}: ${text}`, res.status, text);
-    }
-    return res.json();
-}
-async function writeAuxFiles(viewsDir, agentMdContent) {
-    if (agentMdContent) {
-        await fs_extra_1.default.outputFile(path_1.default.join(viewsDir, "AGENT.md"), agentMdContent);
-        await fs_extra_1.default.outputFile(path_1.default.join(viewsDir, "CLAUDE.md"), agentMdContent);
-        await fs_extra_1.default.outputFile(path_1.default.join(viewsDir, ".vscode", "copilot-instructions.md"), agentMdContent);
-    }
-    await fs_extra_1.default.outputFile(path_1.default.join(viewsDir, ".vscode", "settings.json"), JSON.stringify({
-        "files.associations": { "*.model": "javascript" },
-        "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
-        "js/ts.validate.enabled": false,
-    }, null, 2));
-}
-async function checkAndWriteToken(viewsDir, token) {
-    const tokenPath = path_1.default.join(viewsDir, ".cache", "token");
-    if (await fs_extra_1.default.pathExists(tokenPath)) {
-        const existing = (await fs_extra_1.default.readFile(tokenPath, "utf-8")).trim();
-        if (existing !== token) {
-            throw new Error(`Workspace at ${viewsDir} is tied to a different token. ` +
-                `Remove ${tokenPath} or use a different workspace.`);
-        }
-        return;
-    }
-    await fs_extra_1.default.outputFile(tokenPath, token);
-}
-function resolveViewsDir(basePath, site) {
-    const slug = `${site.name.substr(0, 20)} ${site.id}`
-        .replace(/[\s_]+/g, "-")
-        .toLowerCase();
-    const base = basePath || path_1.default.join(os_1.default.homedir(), "SleekCMS");
-    return path_1.default.resolve(base, slug);
-}
-async function syncSite(opts) {
-    const token = (opts.token || "").trim();
-    if (!token)
-        throw new Error("syncSite: token is required");
-    const env = (opts.env || token.split("-")[2] || "production").toLowerCase();
-    const apiBase = API_BASE_URLS[env] || API_BASE_URLS.production;
-    const site = await request(apiBase, token, "GET", "/get_site");
-    const viewsDir = opts.viewsDir
-        ? path_1.default.resolve(opts.viewsDir)
-        : resolveViewsDir(opts.path, site);
-    await fs_extra_1.default.ensureDir(viewsDir);
-    await Promise.all(SRC_DIRS.map((dir) => fs_extra_1.default.ensureDir(path_1.default.join(viewsDir, dir))));
-    await checkAndWriteToken(viewsDir, token);
-    const statePath = path_1.default.join(viewsDir, ".cache", "state.json");
-    if (opts.flush)
-        await fs_extra_1.default.remove(statePath);
-    const isFirstRun = !(await fs_extra_1.default.pathExists(statePath));
-    let fileMap = isFirstRun ? {} : (await fs_extra_1.default.readJson(statePath)).fileMap || {};
-    let pushed = 0;
-    let pulled = 0;
-    if (isFirstRun) {
-        ({ fileMap, pulled } = await pullServerState(viewsDir, apiBase, token));
-        await writeAuxFiles(viewsDir, opts.agentMd);
-    }
-    else {
-        pushed = await pushLocalChanges(viewsDir, fileMap, apiBase, token);
-    }
-    await fs_extra_1.default.outputJson(statePath, { fileMap }, { spaces: 2 });
-    return { viewsDir, site, isFirstRun, pushed, pulled };
-}
-const IGNORED_FILENAMES = new Set([".DS_Store", "Thumbs.db", "desktop.ini"]);
-async function walkFiles(viewsDir) {
-    const sourceRoot = path_1.default.join(viewsDir, "src");
-    if (!(await fs_extra_1.default.pathExists(sourceRoot)))
-        return [];
-    const out = [];
-    async function walk(dir) {
-        const entries = await fs_extra_1.default.readdir(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            if (IGNORED_FILENAMES.has(entry.name))
-                continue;
-            const full = path_1.default.join(dir, entry.name);
-            if (entry.isDirectory())
-                await walk(full);
-            else if (entry.isFile())
-                out.push(path_1.default.relative(viewsDir, full).replace(/\\/g, "/"));
-        }
-    }
-    await walk(sourceRoot);
-    return out;
-}
-/**
- * Push local edits via /save_files. Server enforces save order.
- *
- * Skip: file mtime matches cache → don't read, don't push.
- * The server replies with success/error per file only — it never echoes back a
- * normalized copy, so local files are never rewritten on save. A failed save is
- * recorded in sync-errors.log; a successful save clears that file's entry.
- * Server-side normalization (resolved image objects, JSON frontmatter, entry
- * refs, etc.) is reflected locally only on a full re-fetch.
- */
-async function pushLocalChanges(viewsDir, fileMap, apiBase, token) {
-    const changes = [];
-    for (const rel of await walkFiles(viewsDir)) {
-        const full = path_1.default.join(viewsDir, rel);
-        const prior = fileMap[rel];
-        const stat = await fs_extra_1.default.stat(full);
-        if (prior && prior.mtimeMs === stat.mtimeMs)
-            continue;
-        const content = await fs_extra_1.default.readFile(full, "utf-8");
-        if (!content.trim())
-            continue;
-        changes.push({ rel, full, stat, content, prior });
-    }
-    if (changes.length === 0)
-        return 0;
-    let results;
-    try {
-        results = await request(apiBase, token, "POST", "/save_files", changes.map((c) => ({ path: c.rel, content: c.content })));
-    }
-    catch (err) {
-        const e = err;
-        console.error("❌ Error saving files:", e.body || e.message);
-        return 0;
-    }
-    const errors = await getSessionErrors(viewsDir);
-    let pushed = 0;
-    const resultsByPath = indexSaveResultsByPath(results);
-    for (let i = 0; i < changes.length; i++) {
-        const c = changes[i];
-        const r = getSaveResult(c, i, results, resultsByPath);
-        if (!r) {
-            const msg = "No save response returned";
-            errors[c.rel] = msg;
-            console.error(`❌ Error saving ${c.rel}: ${msg}`);
-            continue;
-        }
-        if (r.error) {
-            errors[c.rel] = r.error;
-            console.error(`❌ Error saving ${c.rel}: ${r.error}`);
-            continue;
-        }
-        delete errors[c.rel];
-        // Record the mtime we pushed. The local file is left exactly as the
-        // user wrote it — we don't rewrite it with a server-normalized copy.
-        fileMap[c.rel] = { mtimeMs: c.stat.mtimeMs };
-        console.log(`✅ ${c.prior ? "Updated" : "Created"} ${c.rel}`);
-        pushed++;
-    }
-    await dumpErrors(viewsDir, errors);
-    return pushed;
-}
-function indexSaveResultsByPath(results) {
-    const byPath = new Map();
-    for (const result of results) {
-        if (result.path)
-            byPath.set(result.path, result);
-    }
-    return byPath;
-}
-function getSaveResult(change, index, results, resultsByPath) {
-    const resultByPath = resultsByPath.get(change.rel);
-    if (resultByPath)
-        return resultByPath;
-    const resultByIndex = results[index];
-    if (!resultByIndex?.path || resultByIndex.path === change.rel)
-        return resultByIndex;
-    return undefined;
-}
-const ERROR_LOG = "sync-errors.log";
-const syncErrorsByWorkspace = new Map();
-async function getSessionErrors(viewsDir) {
-    const workspace = path_1.default.resolve(viewsDir);
-    const cached = syncErrorsByWorkspace.get(workspace);
-    if (cached)
-        return cached;
-    const errors = await loadErrors(workspace);
-    syncErrorsByWorkspace.set(workspace, errors);
-    return errors;
-}
-async function loadErrors(viewsDir) {
-    const file = path_1.default.join(viewsDir, ERROR_LOG);
-    if (!(await fs_extra_1.default.pathExists(file)))
-        return {};
-    const text = await fs_extra_1.default.readFile(file, "utf-8");
-    const errors = {};
-    for (const line of text.split("\n")) {
-        const idx = line.indexOf(": ");
-        if (idx > 0)
-            errors[line.slice(0, idx)] = line.slice(idx + 2);
-    }
-    return errors;
-}
-async function dumpErrors(viewsDir, errors) {
-    const file = path_1.default.join(viewsDir, ERROR_LOG);
-    const entries = Object.entries(errors);
-    if (entries.length === 0) {
-        await fs_extra_1.default.remove(file);
-        return;
-    }
-    await fs_extra_1.default.outputFile(file, entries.map(([p, msg]) => `${p}: ${msg}`).join("\n") + "\n");
-}
-async function pullServerState(viewsDir, apiBase, token) {
-    syncErrorsByWorkspace.delete(path_1.default.resolve(viewsDir));
-    await fs_extra_1.default.remove(path_1.default.join(viewsDir, ERROR_LOG));
-    console.log("📥 Fetching files...");
-    const files = await request(apiBase, token, "GET", "/get_files");
-    const fileMap = {};
-    let pulled = 0;
-    for (const file of files) {
-        const full = path_1.default.join(viewsDir, file.path);
-        await fs_extra_1.default.outputFile(full, file.content);
-        const mtimeMs = (await fs_extra_1.default.stat(full)).mtimeMs;
-        pulled++;
-        fileMap[file.path] = { mtimeMs };
-    }
-    console.log(`✔️ Synced ${files.length} file(s).`);
-    return { fileMap, pulled };
-}
-if (require.main === module) {
-    commander_1.program
-        .name("setup-site")
-        .description("Initialize a SleekCMS workspace: pull all files and persist the auth token for future syncs.")
-        .requiredOption("-t, --token <token>", "SleekCMS CLI auth token")
-        .option("-d, --dir <dir>", "Parent directory; workspace is created as a slug-named subfolder (default: current directory)")
-        .option("-e, --env <env>", "Environment override (localhost, development, production)")
-        .parse(process.argv);
-    const opts = commander_1.program.opts();
-    syncSite({
-        token: opts.token,
-        path: opts.dir || path_1.default.join(os_1.default.homedir(), "SleekCMS"),
-        env: opts.env,
-    })
-        .then(({ viewsDir, site, isFirstRun, pulled }) => {
-        if (isFirstRun) {
-            console.log(`\n✅ Workspace initialized for "${site.name}" at ${viewsDir} (pulled ${pulled} file(s)).`);
-        }
-        else {
-            console.log(`\n✅ Workspace already initialized for "${site.name}" at ${viewsDir}.`);
-        }
-        console.log(`\nNext: cd ${viewsDir}  →  edit files  →  run sync-site`);
-    })
-        .catch((err) => {
-        console.error("❌", err.body || err.message);
-        process.exit(1);
-    });
-}

package/dist/sync-site.d.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-/**
- * SleekCMS site sync — thin wrapper.
- *
- * Reads the auth token from <workspace>/.cache/token (written by setup-site)
- * and pushes local changes to the server.
- *
- * Usage: sync-site [-d <workspace-dir>]
- *   -d defaults to the current directory.
- *
- * To initialize a new workspace for the first time, run setup-site instead:
- *   setup-site -t <token> [-d <parent-dir>]
- */
-export {};

package/dist/sync-site.js

@@ -1,49 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * SleekCMS site sync — thin wrapper.
- *
- * Reads the auth token from <workspace>/.cache/token (written by setup-site)
- * and pushes local changes to the server.
- *
- * Usage: sync-site [-d <workspace-dir>]
- *   -d defaults to the current directory.
- *
- * To initialize a new workspace for the first time, run setup-site instead:
- *   setup-site -t <token> [-d <parent-dir>]
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
-const commander_1 = require("commander");
-const setup_site_1 = require("./setup-site");
-commander_1.program
-    .name("sync-site")
-    .description("Push local changes to SleekCMS. Reads auth token from <workspace>/.cache/token.")
-    .option("-d, --dir <dir>", "Workspace directory (default: current directory)")
-    .parse(process.argv);
-const opts = commander_1.program.opts();
-const workspaceDir = path_1.default.resolve(opts.dir || ".");
-const tokenPath = path_1.default.join(workspaceDir, ".cache", "token");
-fs_extra_1.default.readFile(tokenPath, "utf-8")
-    .then(raw => {
-    const token = raw.trim();
-    if (!token)
-        throw new Error(`Token file is empty: ${tokenPath}`);
-    return (0, setup_site_1.syncSite)({ token, viewsDir: workspaceDir });
-})
-    .then(({ viewsDir, site, pushed }) => {
-    console.log(`\n✅ Sync complete for "${site.name}" at ${viewsDir} (pushed ${pushed} file(s)).`);
-})
-    .catch((err) => {
-    if (err.code === "ENOENT") {
-        console.error(`❌ Workspace not initialized — run: setup-site -t <token>`);
-    }
-    else {
-        console.error("❌", err.body || err.message);
-    }
-    process.exit(1);
-});

package/dist/watcher.d.ts

@@ -1,18 +0,0 @@
-/**
- * File watching + debounced sync trigger.
- *
- * All push/pull logic lives in setup-site.ts. This module only:
- *   - watches the workspace with chokidar
- *   - debounces change events
- *   - calls back into a provided `onSync` handler that invokes syncSite()
- */
-interface WatcherOptions {
-    viewsDir: string;
-    onSync: () => Promise<unknown>;
-    onIdle?: () => void;
-}
-export declare function init(options: WatcherOptions): void;
-export declare function setShuttingDown(value: boolean): void;
-export declare function monitorFiles(): void;
-export declare function stopWatching(): Promise<void>;
-export {};

package/dist/watcher.js

@@ -1,122 +0,0 @@
-"use strict";
-/**
- * File watching + debounced sync trigger.
- *
- * All push/pull logic lives in setup-site.ts. This module only:
- *   - watches the workspace with chokidar
- *   - debounces change events
- *   - calls back into a provided `onSync` handler that invokes syncSite()
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.init = init;
-exports.setShuttingDown = setShuttingDown;
-exports.monitorFiles = monitorFiles;
-exports.stopWatching = stopWatching;
-const path_1 = __importDefault(require("path"));
-const chokidar_1 = __importDefault(require("chokidar"));
-const DEBOUNCE_DELAY = 5000;
-const IDLE_TIMEOUT_MS = 60 * 60 * 1000;
-// Poll on a short interval and compare wall-clock time so the timeout still
-// fires correctly after the system has been asleep (Node's setTimeout runs on
-// a monotonic clock that pauses during sleep).
-const IDLE_CHECK_INTERVAL_MS = 60 * 1000;
-let watcher = null;
-let isShuttingDown = false;
-let debounceTimer = null;
-let idleCheckTimer = null;
-let lastActivityAt = 0;
-let dirty = false;
-let syncInFlight = false;
-let viewsDir = null;
-let onSync = null;
-let onIdle = null;
-function init(options) {
-    viewsDir = options.viewsDir;
-    onSync = options.onSync;
-    onIdle = options.onIdle ?? null;
-}
-function resetIdleTimer() {
-    lastActivityAt = Date.now();
-    if (isShuttingDown || !onIdle)
-        return;
-    if (idleCheckTimer)
-        return;
-    idleCheckTimer = setInterval(() => {
-        if (isShuttingDown)
-            return;
-        if (Date.now() - lastActivityAt < IDLE_TIMEOUT_MS)
-            return;
-        if (idleCheckTimer) {
-            clearInterval(idleCheckTimer);
-            idleCheckTimer = null;
-        }
-        console.log(`\n💤 No changes for ${IDLE_TIMEOUT_MS / 60000} minutes. Terminating.`);
-        onIdle?.();
-    }, IDLE_CHECK_INTERVAL_MS);
-}
-function setShuttingDown(value) {
-    isShuttingDown = value;
-}
-async function flush() {
-    debounceTimer = null;
-    if (!dirty || isShuttingDown)
-        return;
-    if (syncInFlight) {
-        // Re-arm to retry after the current sync finishes.
-        debounceTimer = setTimeout(flush, DEBOUNCE_DELAY);
-        return;
-    }
-    dirty = false;
-    syncInFlight = true;
-    try {
-        if (onSync)
-            await onSync();
-    }
-    catch (err) {
-        const e = err;
-        console.error("❌ Sync failed:", e.body || e.message);
-    }
-    finally {
-        syncInFlight = false;
-    }
-}
-function scheduleSync() {
-    if (isShuttingDown)
-        return;
-    dirty = true;
-    if (debounceTimer)
-        clearTimeout(debounceTimer);
-    debounceTimer = setTimeout(flush, DEBOUNCE_DELAY);
-    resetIdleTimer();
-}
-function watchTargets(rootDir) {
-    return [path_1.default.join(rootDir, "src")];
-}
-function monitorFiles() {
-    if (!viewsDir)
-        throw new Error("watcher.init must be called before monitorFiles");
-    const watchedFolder = path_1.default.join(viewsDir, "src");
-    console.log(`👀 Watching folder: ${watchedFolder}`);
-    watcher = chokidar_1.default.watch(watchTargets(viewsDir), {
-        persistent: true,
-        ignoreInitial: true,
-        ignored: /(^|[/\\])(\.DS_Store|Thumbs\.db|desktop\.ini)$/,
-    })
-        .on("change", () => { scheduleSync(); })
-        .on("add", () => { scheduleSync(); })
-        .on("unlink", () => { scheduleSync(); });
-    resetIdleTimer();
-}
-async function stopWatching() {
-    if (idleCheckTimer) {
-        clearInterval(idleCheckTimer);
-        idleCheckTimer = null;
-    }
-    if (watcher) {
-        await watcher.close();
-        watcher = null;
-    }
-}