@pplethai/cli 0.4.0 → 0.4.1

package/dist/scaffold.js

@@ -1,58 +0,0 @@
-// Copying the golden-path template into an app's folder.
-import fs from "node:fs/promises";
-import path from "node:path";
-import { CliError } from "./errors.js";
-import { MANUAL_INSTALL } from "./npm.js";
-/** Build output and local secrets are never part of a fresh app. */
-const SKIP = new Set([
-    ".git",
-    "node_modules",
-    "dist",
-    ".wrangler",
-    ".dev.vars",
-    ".env",
-]);
-/**
- * npm strips a file literally named `.gitignore` from published packages, so
- * the bundled template carries it under a safe name and it is restored here.
- */
-const RESTORED_NAMES = new Map([["gitignore", ".gitignore"]]);
-/** The name the template uses for itself everywhere it names something. */
-const TEMPLATE_SLUG = "pple-app";
-/** Files whose contents name the app: package name, D1 database, R2 bucket. */
-const PERSONALIZED = new Set(["package.json", "package-lock.json", "wrangler.jsonc"]);
-export async function scaffold(templateDir, targetDir, slug) {
-    const entries = await fs.readdir(templateDir).catch(() => null);
-    if (entries === null) {
-        throw new CliError("ไม่พบเทมเพลตแอป PPLE ในการติดตั้ง CLI ชุดนี้", `ติดตั้ง CLI ใหม่ (\`${MANUAL_INSTALL}\`) แล้วลองอีกครั้ง`);
-    }
-    const written = [];
-    await copyDir({ from: templateDir, to: targetDir, prefix: "", slug, written });
-    return written.sort();
-}
-async function copyDir(step) {
-    for (const entry of await fs.readdir(step.from, { withFileTypes: true })) {
-        if (SKIP.has(entry.name))
-            continue;
-        const name = RESTORED_NAMES.get(entry.name) ?? entry.name;
-        const source = path.join(step.from, entry.name);
-        const destination = path.join(step.to, name);
-        const relative = step.prefix === "" ? name : `${step.prefix}/${name}`;
-        if (entry.isDirectory()) {
-            await fs.mkdir(destination, { recursive: true });
-            await copyDir({ ...step, from: source, to: destination, prefix: relative });
-            continue;
-        }
-        if (PERSONALIZED.has(name)) {
-            const contents = await fs.readFile(source, "utf8");
-            await fs.writeFile(destination, replaceAll(contents, TEMPLATE_SLUG, step.slug));
-        }
-        else {
-            await fs.copyFile(source, destination);
-        }
-        step.written.push(relative);
-    }
-}
-function replaceAll(text, from, to) {
-    return text.split(from).join(to);
-}

package/dist/session.js

@@ -1,29 +0,0 @@
-import { loadCredentials, saveCredentials } from "./credentials.js";
-import { refresh } from "./device-flow.js";
-import { SIGN_IN_EXPIRED, SIGNED_OUT } from "./errors.js";
-import { ProvisionerClient } from "./api.js";
-/** Refresh this long before expiry, so a command doesn't die mid-flight. */
-const EXPIRY_MARGIN_MS = 60_000;
-/**
- * The access token for this command, refreshed if it is about to expire. The
- * only way a command gets to talk to the platform.
- */
-export async function accessToken(deps) {
-    const stored = await loadCredentials(deps);
-    if (!stored)
-        throw SIGNED_OUT;
-    const expiring = stored.expiresAt !== null && stored.expiresAt - deps.now() < EXPIRY_MARGIN_MS;
-    if (!expiring)
-        return stored.accessToken;
-    if (stored.refreshToken) {
-        const renewed = await refresh(deps, stored.refreshToken);
-        if (renewed) {
-            await saveCredentials(deps, { ...renewed, ssoBase: deps.config.ssoBase });
-            return renewed.accessToken;
-        }
-    }
-    throw SIGN_IN_EXPIRED;
-}
-export async function client(deps) {
-    return new ProvisionerClient(deps, await accessToken(deps));
-}

package/dist/skills.js

@@ -1,86 +0,0 @@
-// Platform Skills as a local overlay in each Builder App workspace.
-// Overwrites only `.claude/skills/pple-platform/`; sibling skills are left alone.
-import { createHash } from "node:crypto";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { CliError } from "./errors.js";
-import { MANUAL_INSTALL } from "./npm.js";
-/** Where the platform Skill lands inside a Builder App workspace. */
-export const PLATFORM_SKILL_REL = path.join(".claude", "skills", "pple-platform");
-/** The only Skills path that belongs in the app's `.gitignore` (posix form). */
-export const PLATFORM_SKILL_IGNORE = `${PLATFORM_SKILL_REL.split(path.sep).join("/")}/`;
-/**
- * Refresh the platform Skill overlay from the CLI bundle. Prints only when
- * the managed content actually changed (first install or update).
- */
-export async function refreshSkills(deps, appDir) {
-    const source = deps.skillsDir;
-    const entries = await fs.readdir(source).catch(() => null);
-    if (entries === null) {
-        throw new CliError("ไม่พบ Skill ของ PPLE Platform ในการติดตั้ง CLI ชุดนี้", `ติดตั้ง CLI ใหม่ (\`${MANUAL_INSTALL}\`) แล้วลองอีกครั้ง`);
-    }
-    const destination = path.join(appDir, PLATFORM_SKILL_REL);
-    const before = await contentFingerprint(destination);
-    await replaceDir(source, destination);
-    await ensureIgnored(appDir);
-    const after = await contentFingerprint(destination);
-    if (before === after)
-        return;
-    deps.out.say(before === null ? "ติดตั้ง Skill ของแพลตฟอร์มแล้ว" : "อัปเดต Skill ของแพลตฟอร์มแล้ว");
-}
-async function replaceDir(from, to) {
-    await fs.rm(to, { recursive: true, force: true });
-    await copyDir(from, to);
-}
-async function copyDir(from, to) {
-    await fs.mkdir(to, { recursive: true });
-    for (const entry of await fs.readdir(from, { withFileTypes: true })) {
-        if (entry.name === ".DS_Store")
-            continue;
-        const src = path.join(from, entry.name);
-        const dst = path.join(to, entry.name);
-        if (entry.isDirectory())
-            await copyDir(src, dst);
-        else
-            await fs.copyFile(src, dst);
-    }
-}
-/** Stable hash of every file under `dir`, or null when the tree is missing. */
-async function contentFingerprint(dir) {
-    const files = await listFiles(dir).catch(() => null);
-    if (files === null)
-        return null;
-    const hash = createHash("sha256");
-    for (const relative of files.sort()) {
-        hash.update(relative);
-        hash.update("\0");
-        hash.update(await fs.readFile(path.join(dir, relative)));
-        hash.update("\0");
-    }
-    return hash.digest("hex");
-}
-async function listFiles(dir, prefix = "") {
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-    const files = [];
-    for (const entry of entries) {
-        if (entry.name === ".DS_Store")
-            continue;
-        const relative = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
-        if (entry.isDirectory()) {
-            files.push(...(await listFiles(path.join(dir, entry.name), relative)));
-        }
-        else {
-            files.push(relative);
-        }
-    }
-    return files;
-}
-async function ensureIgnored(appDir) {
-    const ignorePath = path.join(appDir, ".gitignore");
-    const existing = await fs.readFile(ignorePath, "utf8").catch(() => "");
-    const lines = existing.split("\n");
-    if (lines.some((line) => line.trim() === PLATFORM_SKILL_IGNORE))
-        return;
-    const body = existing.endsWith("\n") || existing === "" ? existing : `${existing}\n`;
-    await fs.writeFile(ignorePath, `${body}${PLATFORM_SKILL_IGNORE}\n`);
-}

package/dist/ui.js

@@ -1,12 +0,0 @@
-export function consoleOutput(write, writeError) {
-    return {
-        say(line = "") {
-            write(`${line}\n`);
-        },
-        fail(error) {
-            writeError(`${error.message}\n`);
-            if (error.hint)
-                writeError(`${error.hint}\n`);
-        },
-    };
-}

package/dist/update.js

@@ -1,142 +0,0 @@
-// The CLI keeping itself current: the daily check that rides along with
-// ordinary commands, and the words both it and `pple upgrade` use — one
-// upgrade story reaches a Builder, however they arrived at it.
-//
-// The check runs before the command the Builder typed, which is the only
-// moment an upgrade is safe: nothing is half-done yet, so the new CLI can
-// simply be handed the same command line. Everything here is written to fail
-// towards the command — a quiet npm, a missing config directory, a refused
-// upgrade all end with `pple deploy` deploying.
-import fs from "node:fs/promises";
-import path from "node:path";
-import { installGlobally, isNewer, isNpmGlobalInstall, latestVersion, MANUAL_INSTALL, npmMessage, } from "./npm.js";
-/** About once a day, per machine — not per app, and not per command. */
-const CHECK_INTERVAL = 24 * 60 * 60 * 1000;
-/** Cadence state, beside credentials.json and well away from any app repo. */
-const STATE_FILE = "update-check.json";
-/** The Builder's own settings for this CLI, the other half of the opt-out. */
-const CONFIG_FILE = "config.json";
-/**
- * Commands that already answer the version question themselves, or that
- * print and exit. `upgrade` doing its own check twice would be silly; help
- * should never touch the network.
- */
-const UNCHECKED = new Set(["upgrade", "help", "--help", "-h"]);
-export function wantsUpdateCheck(argv) {
-    return argv.length > 0 && !UNCHECKED.has(argv[0]);
-}
-/** The one line that opens every "there's a newer pple" conversation. */
-export function announceUpdate(deps, latest) {
-    deps.out.say(`มี pple เวอร์ชันใหม่ (${latest}) คุณใช้เวอร์ชัน ${deps.version}`);
-}
-/**
- * What to say about an install npm's global root doesn't hold. Installing
- * over it would leave the Builder with two pples and no way to tell which
- * one just ran (ADR-0007).
- */
-export function sayOtherChannel(deps) {
-    deps.out.say("pple ชุดนี้ไม่ได้ติดตั้งผ่าน npm การอัปเดตที่นี่อาจทำให้คุณ");
-    deps.out.say("มี pple สองเวอร์ชัน กรุณาอัปเดตด้วยวิธีเดิมที่คุณติดตั้งไว้");
-    deps.out.say(`หรือติดตั้งด้วย npm:\n\n  ${MANUAL_INSTALL}`);
-}
-/** Why npm gave up, and the line the Builder can always run themselves. */
-export function manualHint(result) {
-    return `${npmMessage(result)}\n\nลองรันคำสั่งนี้ด้วยตัวเอง:\n\n  ${MANUAL_INSTALL}`;
-}
-/**
- * Look for a newer CLI, and act on it as far as this session allows. Returns
- * an exit code when the command has already been dealt with — the CLI
- * upgraded and re-ran it, or the Builder chose to stop — and null to let the
- * command the Builder typed run as usual.
- */
-export async function checkForUpdate(deps, argv) {
-    if (!(await isDue(deps)))
-        return null;
-    await recordCheck(deps);
-    const latest = await latestVersion(deps);
-    // A quiet registry is not the Builder's problem: no message, no delay
-    // tomorrow — the command simply carries on.
-    if (latest === null || !isNewer(latest, deps.version))
-        return null;
-    announceUpdate(deps, latest);
-    // The channel comes before the terminal: an install npm doesn't own can't
-    // be upgraded by anyone here, so pointing at `pple upgrade` — which would
-    // only refuse — helps nobody, attended or not.
-    if (!(await isNpmGlobalInstall(deps))) {
-        sayOtherChannel(deps);
-        deps.out.say();
-        return null;
-    }
-    if (!deps.interactive) {
-        deps.out.say("รัน `pple upgrade` เมื่อคุณพร้อม");
-        deps.out.say();
-        return null;
-    }
-    if (!(await deps.confirm("อัปเดต pple ตอนนี้เลยไหม?"))) {
-        deps.out.say();
-        return null;
-    }
-    const result = await installGlobally(deps, latest);
-    if (result.code !== 0)
-        return await afterFailedUpgrade(deps, latest, result);
-    deps.out.say(`pple เป็นเวอร์ชัน ${latest} แล้ว กำลังทำงานต่อจากที่ค้างไว้…`);
-    deps.out.say();
-    return deps.reexec(argv);
-}
-/**
- * A failed upgrade must not strand the work the Builder came to do. Say what
- * npm said, leave them the line they can run themselves, and offer to get on
- * with the command on the CLI they already have. Only an attended run can
- * arrive here at all — an unattended one is never upgrading in the first
- * place — so carrying on is a question, not a default.
- */
-async function afterFailedUpgrade(deps, latest, result) {
-    deps.out.say(`อัปเดต pple เป็น ${latest} ไม่สำเร็จ`);
-    deps.out.say(manualHint(result));
-    deps.out.say();
-    if (await deps.confirm(`ใช้ pple ${deps.version} ทำงานต่อไปก่อนไหม?`)) {
-        deps.out.say();
-        return null;
-    }
-    deps.out.say("หยุดแล้ว ไม่มีอะไรเปลี่ยนแปลง");
-    return 1;
-}
-async function isDue(deps) {
-    if (!deps.updateChecks)
-        return false;
-    if (!(await configAllowsChecks(deps)))
-        return false;
-    const state = await readJson(path.join(deps.configDir, STATE_FILE));
-    if (typeof state?.lastCheckedAt !== "number")
-        return true;
-    return deps.now() - state.lastCheckedAt >= CHECK_INTERVAL;
-}
-/**
- * Record the attempt, not the outcome: a registry that is down today should
- * cost one request, not one per command until it comes back. Unwritable
- * config is not worth a word to the Builder — checking again is harmless.
- */
-async function recordCheck(deps) {
-    const state = { lastCheckedAt: deps.now() };
-    await fs
-        .mkdir(deps.configDir, { recursive: true })
-        .then(() => fs.writeFile(path.join(deps.configDir, STATE_FILE), `${JSON.stringify(state, null, 2)}\n`))
-        .catch(() => undefined);
-}
-/** `{ "updateCheck": false }` turns the check off for this machine. */
-async function configAllowsChecks(deps) {
-    const config = await readJson(path.join(deps.configDir, CONFIG_FILE));
-    return config?.updateCheck !== false;
-}
-/** Parsed JSON, or null for a file that is missing, unreadable, or malformed. */
-async function readJson(file) {
-    const raw = await fs.readFile(file, "utf8").catch(() => null);
-    if (raw === null)
-        return null;
-    try {
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}