@b3os/cli 0.0.0-stage → 0.0.1

package/dist/commands/web.js

@@ -0,0 +1,205 @@
+// b3os scrape | screenshot | video: vision.scrape, render.createScreenshot and render.createVideo.
+import { readFileSync, writeFileSync } from "node:fs";
+import { EXIT, intFlag, pairs, parse, UsageError } from "../ctx.js";
+const FORMATS = ["markdown", "html", "raw_html", "text", "links", "metadata", "screenshot", "json"];
+export async function scrape(ctx, argv) {
+    const a = parse(argv, {
+        format: { type: "string", short: "f", multiple: true },
+        "all-content": { type: "boolean" },
+        engine: { type: "string" },
+        "wait-for": { type: "string" },
+        "max-age": { type: "string" },
+        "no-cache": { type: "boolean" },
+        header: { type: "string", multiple: true },
+        profile: { type: "string" },
+        out: { type: "string", short: "o" },
+    });
+    ctx.applyGlobals(a.values);
+    const url = a.positionals[0];
+    if (!url || a.values.help) {
+        ctx.out("usage: b3os scrape <url> [--format markdown|html|raw_html|text|links|json ...] [--all-content]\n" +
+            "                   [--engine auto|fetch|browser] [--wait-for MS] [--max-age MS|--no-cache]\n" +
+            "                   [--header K=V ...] [--profile NAME] [--out FILE] [--json]");
+        return url ? EXIT.OK : EXIT.USAGE;
+    }
+    const formats = (a.values.format ?? ["markdown"]).flatMap((f) => f.split(","));
+    for (const f of formats) {
+        if (!FORMATS.includes(f))
+            throw new UsageError(`unknown format "${f}" (${FORMATS.join(", ")})`);
+    }
+    const body = { url, formats: formats };
+    if (a.values["all-content"])
+        body.only_main_content = false;
+    if (typeof a.values.engine === "string")
+        body.engine = a.values.engine;
+    const wait = intFlag(a.values["wait-for"], "--wait-for");
+    if (wait !== undefined)
+        body.wait_for_ms = wait;
+    const maxAge = a.values["no-cache"] ? 0 : intFlag(a.values["max-age"], "--max-age");
+    if (maxAge !== undefined)
+        body.max_age_ms = maxAge;
+    if (a.values.header)
+        body.headers = pairs(a.values.header, "--header");
+    if (typeof a.values.profile === "string")
+        body.profile = a.values.profile;
+    const { data: page, response } = await ctx.client().vision.scrape(body).withResponse();
+    const single = formats.length === 1 ? formats[0] : undefined;
+    let text;
+    if (single === "markdown" || single === "html" || single === "raw_html" || single === "text") {
+        text = page[single] ?? "";
+    }
+    else if (single === "links") {
+        text = (page.links ?? []).join("\n");
+    }
+    if (typeof a.values.out === "string") {
+        writeFileSync(a.values.out, ctx.json || text === undefined ? JSON.stringify(page, null, 2) : text);
+        ctx.info(`Wrote ${a.values.out}`);
+    }
+    else if (ctx.json || text === undefined) {
+        ctx.printJson(page);
+    }
+    else {
+        ctx.out(text);
+    }
+    const t = response.timing.total_ms;
+    ctx.info(`${page.status_code} ${page.final_url} via ${page.tier} (cache ${page.cache.state})${t === null ? "" : `, server ${t} ms`}`);
+    return EXIT.OK;
+}
+export async function screenshot(ctx, argv) {
+    const a = parse(argv, {
+        out: { type: "string", short: "o" },
+        format: { type: "string" },
+        width: { type: "string" },
+        height: { type: "string" },
+        dpr: { type: "string" },
+        "full-page": { type: "boolean" },
+        selector: { type: "string" },
+        background: { type: "string" },
+        frame: { type: "string" },
+        theme: { type: "string" },
+        "wait-for": { type: "string" },
+        hide: { type: "string", multiple: true },
+        profile: { type: "string" },
+        html: { type: "string" },
+    });
+    ctx.applyGlobals(a.values);
+    const url = a.positionals[0];
+    if ((!url && !a.values.html) || a.values.help) {
+        ctx.out("usage: b3os screenshot <url> [--out FILE] [--format webp|png|jpeg] [--width W --height H] [--dpr 1|2|3]\n" +
+            "                       [--full-page] [--selector CSS] [--background PRESET] [--frame PRESET]\n" +
+            "                       [--theme light|dark] [--wait-for MS] [--hide CSS ...] [--html FILE] [--json]");
+        return url || a.values.html ? EXIT.OK : EXIT.USAGE;
+    }
+    const format = a.values.format ?? "png";
+    const body = { format };
+    if (url)
+        body.url = url;
+    if (typeof a.values.html === "string")
+        body.html = readFileSync(a.values.html, "utf8");
+    const w = intFlag(a.values.width, "--width");
+    const h = intFlag(a.values.height, "--height");
+    if (w !== undefined || h !== undefined)
+        body.viewport = { width: w ?? 1600, height: h ?? 900 };
+    const dpr = intFlag(a.values.dpr, "--dpr");
+    if (dpr !== undefined)
+        body.dpr = dpr;
+    if (a.values["full-page"])
+        body.full_page = true;
+    if (typeof a.values.selector === "string")
+        body.target = { selector: a.values.selector };
+    if (a.values.background || a.values.frame) {
+        body.style = {};
+        if (typeof a.values.background === "string")
+            body.style.background = a.values.background;
+        if (typeof a.values.frame === "string")
+            body.style.frame = a.values.frame;
+    }
+    if (typeof a.values.theme === "string")
+        body.theme = a.values.theme;
+    const wait = intFlag(a.values["wait-for"], "--wait-for");
+    if (wait !== undefined)
+        body.wait_for_ms = wait;
+    if (a.values.hide)
+        body.hide = a.values.hide;
+    if (typeof a.values.profile === "string")
+        body.profile = a.values.profile;
+    const b3 = ctx.client();
+    if (ctx.json) {
+        ctx.printJson(await b3.render.createScreenshot(body));
+        return EXIT.OK;
+    }
+    const accept = format === "jpeg" ? "image/jpeg" : format === "webp" ? "image/webp" : "image/png";
+    const { data, response } = await b3.render.createScreenshot(body, { accept }).withResponse();
+    const out = typeof a.values.out === "string" ? a.values.out : `screenshot.${format === "jpeg" ? "jpg" : format}`;
+    writeFileSync(out, data);
+    const t = response.timing.total_ms;
+    ctx.out(out);
+    ctx.info(`${data.byteLength} bytes${t === null ? "" : `, server ${t} ms`}`);
+    return EXIT.OK;
+}
+function readJsonFile(path) {
+    const text = readFileSync(path, "utf8");
+    try {
+        return JSON.parse(text);
+    }
+    catch (e) {
+        throw new UsageError(`${path} is not JSON (${e.message}); video scripts are VideoCreateRequest JSON`);
+    }
+}
+export async function video(ctx, argv) {
+    const a = parse(argv, {
+        out: { type: "string", short: "o" },
+        "no-wait": { type: "boolean" },
+        kind: { type: "string" },
+    });
+    ctx.applyGlobals(a.values);
+    const file = a.positionals[0];
+    if (!file || a.values.help) {
+        ctx.out("usage: b3os video <script.json> [--out FILE] [--kind mp4|gif|poster|vtt] [--no-wait] [--json]\n" +
+            "  script.json is a render video request (render.yaml VideoCreateRequest: source, beats, voice, style, ...)");
+        return file ? EXIT.OK : EXIT.USAGE;
+    }
+    const body = readJsonFile(file);
+    const b3 = ctx.client();
+    if (a.values["no-wait"]) {
+        const job = await b3.render.createVideo(body);
+        ctx.result(job, () => ctx.out(job.id));
+        return EXIT.OK;
+    }
+    const stream = b3.render.createVideo(body).events();
+    for await (const ev of stream) {
+        if (ctx.json)
+            ctx.printJsonLine(ev);
+        else
+            logVideoEvent(ctx, ev);
+    }
+    const done = await stream.result;
+    if (done.status !== "succeeded") {
+        ctx.warn(`video ${done.id} ${done.status}: ${done.error?.detail ?? ""}`);
+        return EXIT.FAILED;
+    }
+    const kind = a.values.kind ?? "mp4";
+    const art = done.result?.artifacts.find((x) => x.kind === kind);
+    if (!art?.url) {
+        ctx.warn(`video ${done.id} has no ${kind} artifact`);
+        return EXIT.FAILED;
+    }
+    const out = typeof a.values.out === "string" ? a.values.out : `${done.id}.${kind === "poster" ? "jpg" : kind}`;
+    const res = await fetch(art.url);
+    if (!res.ok)
+        throw new Error(`download of ${art.url} answered ${res.status}`);
+    writeFileSync(out, new Uint8Array(await res.arrayBuffer()));
+    if (!ctx.json)
+        ctx.out(out);
+    return EXIT.OK;
+}
+function logVideoEvent(ctx, ev) {
+    const e = ev;
+    if (e.type === "video.phase" && e.phase)
+        ctx.info(`${e.phase}...`);
+    else if (e.type === "job.progress" && e.progress)
+        ctx.info(`${e.progress.completed}/${e.progress.total ?? "?"}`);
+    else if (e.type.startsWith("job."))
+        ctx.info(e.type.slice(4));
+}
+//# sourceMappingURL=web.js.map

package/dist/commands/web.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,21 @@
+export interface StoredCredentials {
+    /** `b3os_pat_…` from the device login. */
+    token: string;
+    base_url: string;
+    org_id?: string;
+    project_id?: string;
+    scope?: string;
+    /** RFC 3339; when the token stops working. */
+    expires_at?: string | null;
+    created_at: string;
+}
+export declare function configDir(): string;
+export declare function credentialsPath(): string;
+export declare function loadCredentials(): StoredCredentials | null;
+/**
+ * Writes the token to a new 0600 file next to the target and renames it over the old one, so the token is never
+ * in a file with wider permissions (an existing file keeps its mode under writeFileSync), and a crash leaves either
+ * the old file or the new one.
+ */
+export declare function saveCredentials(c: StoredCredentials): string;
+export declare function deleteCredentials(): boolean;

package/dist/config.js

@@ -0,0 +1,71 @@
+// Stored login: `b3os login` keeps the device-flow token in $XDG_CONFIG_HOME/b3os/credentials.json (default
+// ~/.config/b3os/), mode 0600 in a 0700 directory. B3OS_API_KEY and --api-key always win over it.
+import { chmodSync, closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, writeSync, } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export function configDir() {
+    const base = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
+    return join(base, "b3os");
+}
+export function credentialsPath() {
+    return process.env.B3OS_CREDENTIALS_FILE || join(configDir(), "credentials.json");
+}
+export function loadCredentials() {
+    const p = credentialsPath();
+    if (!existsSync(p))
+        return null;
+    try {
+        const c = JSON.parse(readFileSync(p, "utf8"));
+        if (typeof c.token !== "string" || !c.token)
+            return null;
+        if (c.expires_at && Date.parse(c.expires_at) < Date.now())
+            return null;
+        return c;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Writes the token to a new 0600 file next to the target and renames it over the old one, so the token is never
+ * in a file with wider permissions (an existing file keeps its mode under writeFileSync), and a crash leaves either
+ * the old file or the new one.
+ */
+export function saveCredentials(c) {
+    const p = credentialsPath();
+    const dir = dirname(p);
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    if (!process.env.B3OS_CREDENTIALS_FILE) {
+        try {
+            chmodSync(dir, 0o700); // our own directory: tighten one that was created by hand or by an older version
+        }
+        catch {
+            // Not ours to change; the file itself is still 0600.
+        }
+    }
+    const tmp = `${p}.${process.pid}.${Date.now()}.tmp`;
+    const fd = openSync(tmp, "wx", 0o600);
+    try {
+        writeSync(fd, `${JSON.stringify(c, null, 2)}\n`);
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+    try {
+        renameSync(tmp, p);
+    }
+    catch (e) {
+        rmSync(tmp, { force: true });
+        throw e;
+    }
+    return p;
+}
+export function deleteCredentials() {
+    const p = credentialsPath();
+    if (!existsSync(p))
+        return false;
+    rmSync(p);
+    return true;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/ctx.d.ts

@@ -0,0 +1,112 @@
+import { type ParseArgsConfig } from "node:util";
+import { B3OS, type ClientOptions } from "@b3os/sdk";
+/** Exit codes. Stable: scripts may rely on them (documented in packages/cli/README.md). */
+export declare const EXIT: {
+    readonly OK: 0;
+    readonly ERROR: 1;
+    readonly USAGE: 2;
+    readonly AUTH: 3;
+    readonly NOT_FOUND: 4;
+    readonly INVALID: 5;
+    readonly LIMITED: 6;
+    readonly SERVER: 7;
+    readonly TIMEOUT: 8;
+    readonly CONNECTION: 9;
+    readonly FAILED: 10;
+    readonly INTERRUPTED: 130;
+};
+export declare class UsageError extends Error {
+    constructor(message: string);
+}
+/** Options every command takes. */
+export declare const GLOBAL_OPTIONS: {
+    readonly json: {
+        readonly type: "boolean";
+    };
+    readonly yes: {
+        readonly type: "boolean";
+        readonly short: "y";
+    };
+    readonly quiet: {
+        readonly type: "boolean";
+        readonly short: "q";
+    };
+    readonly help: {
+        readonly type: "boolean";
+        readonly short: "h";
+    };
+    readonly "api-key": {
+        readonly type: "string";
+    };
+    readonly "base-url": {
+        readonly type: "string";
+    };
+    readonly timeout: {
+        readonly type: "string";
+    };
+};
+export type Options = NonNullable<ParseArgsConfig["options"]>;
+export interface Parsed {
+    values: Record<string, string | boolean | string[] | boolean[] | undefined>;
+    positionals: string[];
+}
+export declare function parse(argv: string[], options?: Options): Parsed;
+export interface Streams {
+    stdout: {
+        write(s: string | Uint8Array): unknown;
+        isTTY?: boolean;
+    };
+    stderr: {
+        write(s: string): unknown;
+        isTTY?: boolean;
+    };
+    stdin: NodeJS.ReadableStream & {
+        isTTY?: boolean;
+    };
+}
+export declare class Ctx {
+    json: boolean;
+    yes: boolean;
+    quiet: boolean;
+    apiKey: string | undefined;
+    baseUrl: string | undefined;
+    timeoutMs: number | undefined;
+    private cached;
+    readonly io: Streams;
+    /** Extra client options (tests). */
+    clientOptions: ClientOptions;
+    constructor(io: Streams);
+    applyGlobals(v: Parsed["values"]): void;
+    get isTTY(): boolean;
+    /** The API key in effect: --api-key, B3OS_API_KEY, then the stored login. */
+    credential(): {
+        key: string | null;
+        source: string;
+        baseUrl: string;
+    };
+    /**
+     * The base URL the user chose (--base-url, B3OS_BASE_URL, or a stored login's non-default host), else undefined.
+     * Only a chosen one is passed to the SDK: a base URL turns off its default-socket detection on a node.
+     */
+    configuredBaseUrl(): string | undefined;
+    client(): B3OS;
+    out(s: string): void;
+    /** Progress and notes go to stderr so stdout stays data. Silent with --quiet or --json. */
+    info(s: string): void;
+    warn(s: string): void;
+    printJson(v: unknown): void;
+    /** One JSON document per line (streams with --json). */
+    printJsonLine(v: unknown): void;
+    /** --json prints `data`; otherwise `human()` decides. */
+    result(data: unknown, human: () => void): void;
+    table(rows: Array<Record<string, unknown>>, columns: string[]): void;
+    /** Asks before a destructive action. Never prompts without a TTY: then --yes is required. */
+    confirm(question: string): Promise<boolean>;
+}
+export declare function exitCodeFor(e: unknown): number;
+/** The error as printed: one readable line (plus validation items), or a JSON object with --json. */
+export declare function renderError(e: unknown, json: boolean): string;
+/** Reads `k=v` pairs (`--env A=1`). */
+export declare function pairs(list: unknown, flag: string): Record<string, string>;
+export declare function intFlag(v: unknown, flag: string): number | undefined;
+export declare function jsonFlag(v: unknown, flag: string): unknown;