@remotedraw/cli 0.1.0

package/dist/cloud.d.ts

@@ -0,0 +1,63 @@
+export declare const DEFAULT_REMOTEDRAW_API_BASE_URL = "https://api.remotedraw.com";
+export type CloudRuntime = {
+    env: Record<string, string | undefined>;
+    isInteractive?: boolean;
+    fetch?: typeof fetch;
+    exists: (filePath: string) => boolean | Promise<boolean>;
+    readFile: (filePath: string) => Promise<string>;
+    writeFile: (filePath: string, contents: string) => Promise<void>;
+    writePrivateFile?: (filePath: string, contents: string) => Promise<void>;
+    mkdir: (dirPath: string) => Promise<void>;
+    chmod?: (filePath: string, mode: number) => Promise<void>;
+    homeDir?: string;
+    openUrl?: (url: string) => void | Promise<void>;
+    sleep?: (milliseconds: number) => Promise<void>;
+    notify?: (message: string) => void;
+};
+type CliAccount = {
+    userId: string;
+    tenantId: string;
+    tenantSlug: string;
+    name?: string;
+    email?: string;
+    credentialName?: string;
+    expiresAt?: number;
+};
+export type ProvisionedProject = {
+    project: {
+        id: string;
+        name: string;
+        slug: string;
+        source: "cli";
+        dashboardUrl: string;
+    };
+    apiKey: {
+        id: string;
+        name: string;
+        value: string;
+    };
+    apiBaseUrl: string;
+};
+export declare function remoteDrawApiBaseUrl(env: Record<string, string | undefined>, requested?: string): string;
+export declare function globalConfigPath(runtime: CloudRuntime): string;
+export declare function currentCliAccount(runtime: CloudRuntime, apiBaseUrl: string): Promise<CliAccount | undefined>;
+export declare function loginToRemoteDraw(runtime: CloudRuntime, apiBaseUrl: string, options?: {
+    openBrowser?: boolean;
+    force?: boolean;
+    deviceName?: string;
+}): Promise<{
+    account: CliAccount;
+    alreadyLoggedIn: boolean;
+}>;
+export declare function logoutFromRemoteDraw(runtime: CloudRuntime, apiBaseUrl: string): Promise<{
+    hadCredential: boolean;
+}>;
+export declare function provisionRemoteDrawProject(runtime: CloudRuntime, apiBaseUrl: string, input: {
+    name: string;
+    keyName?: string;
+}): Promise<ProvisionedProject>;
+export declare function updateEnvContents(contents: string, values: Record<string, string>, force?: boolean): string;
+export declare function assertEnvCanAcceptProvisioning(runtime: CloudRuntime, outputDir: string, apiBaseUrl: string, force: boolean): Promise<void>;
+export declare function writeProvisionedProjectSetup(runtime: CloudRuntime, outputDir: string, provisioning: ProvisionedProject, force: boolean): Promise<void>;
+export {};
+//# sourceMappingURL=cloud.d.ts.map

package/dist/cloud.d.ts.map

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

package/dist/cloud.js

@@ -0,0 +1,302 @@
+import { homedir } from "node:os";
+import path from "node:path";
+export const DEFAULT_REMOTEDRAW_API_BASE_URL = "https://api.remotedraw.com";
+function normalizedOrigin(value) {
+    const url = new URL(value.trim());
+    if ((url.protocol !== "https:" && url.protocol !== "http:") ||
+        url.username ||
+        url.password ||
+        url.pathname !== "/" ||
+        url.search ||
+        url.hash) {
+        throw new Error(`Expected an HTTP API origin, received ${value}.`);
+    }
+    return url.origin;
+}
+export function remoteDrawApiBaseUrl(env, requested) {
+    const value = requested && !requested.includes("<deployment>")
+        ? requested
+        : env.REMOTEDRAW_API_BASE_URL || DEFAULT_REMOTEDRAW_API_BASE_URL;
+    return normalizedOrigin(value);
+}
+export function globalConfigPath(runtime) {
+    const explicit = runtime.env.REMOTEDRAW_CONFIG_DIR?.trim();
+    const configRoot = explicit ||
+        runtime.env.XDG_CONFIG_HOME?.trim() ||
+        path.join(runtime.homeDir || homedir(), ".config");
+    return path.join(configRoot, "remotedraw", "config.json");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function readStoredConfig(runtime) {
+    const configPath = globalConfigPath(runtime);
+    if (!(await runtime.exists(configPath))) {
+        return { version: 1, activeApiBaseUrl: "", profiles: {} };
+    }
+    try {
+        const parsed = JSON.parse(await runtime.readFile(configPath));
+        if (!isRecord(parsed) || !isRecord(parsed.profiles))
+            throw new Error();
+        const profiles = {};
+        for (const [origin, value] of Object.entries(parsed.profiles)) {
+            if (!isRecord(value) || typeof value.cliToken !== "string")
+                continue;
+            profiles[origin] = {
+                apiBaseUrl: typeof value.apiBaseUrl === "string" ? value.apiBaseUrl : origin,
+                cliToken: value.cliToken,
+                ...(isRecord(value.account)
+                    ? { account: value.account }
+                    : {}),
+                ...(typeof value.expiresAt === "number"
+                    ? { expiresAt: value.expiresAt }
+                    : {}),
+            };
+        }
+        return {
+            version: 1,
+            activeApiBaseUrl: typeof parsed.activeApiBaseUrl === "string"
+                ? parsed.activeApiBaseUrl
+                : "",
+            profiles,
+        };
+    }
+    catch {
+        throw new Error(`Could not read RemoteDraw CLI credentials from ${configPath}. Remove or repair that file.`);
+    }
+}
+async function writeStoredConfig(runtime, config) {
+    const configPath = globalConfigPath(runtime);
+    await runtime.mkdir(path.dirname(configPath));
+    await runtime.chmod?.(path.dirname(configPath), 0o700);
+    await writePrivateFile(runtime, configPath, JSON.stringify(config, null, 2) + "\n");
+}
+async function writePrivateFile(runtime, filePath, contents) {
+    if (runtime.writePrivateFile) {
+        await runtime.writePrivateFile(filePath, contents);
+    }
+    else {
+        await runtime.writeFile(filePath, contents);
+    }
+    await runtime.chmod?.(filePath, 0o600);
+}
+async function storedToken(runtime, apiBaseUrl) {
+    const envToken = runtime.env.REMOTEDRAW_CLI_TOKEN?.trim();
+    if (envToken)
+        return envToken;
+    const config = await readStoredConfig(runtime);
+    return config.profiles[apiBaseUrl]?.cliToken;
+}
+async function fetchJson(runtime, apiBaseUrl, pathname, options = {}) {
+    if (!runtime.fetch)
+        throw new Error("This runtime cannot access RemoteDraw.");
+    let response;
+    try {
+        response = await runtime.fetch(`${apiBaseUrl}${pathname}`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...(options.token ? { Authorization: `Bearer ${options.token}` } : {}),
+            },
+            body: JSON.stringify(options.body ?? {}),
+        });
+    }
+    catch (error) {
+        throw new Error(`Could not reach ${apiBaseUrl}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const raw = await response.text();
+    let payload;
+    try {
+        payload = raw ? JSON.parse(raw) : {};
+    }
+    catch {
+        if (response.status === 404) {
+            throw new Error(`RemoteDraw CLI endpoint ${pathname} was not found at ${apiBaseUrl}. Set REMOTEDRAW_API_BASE_URL to a deployment with the latest CLI auth functions.`);
+        }
+        throw new Error(`RemoteDraw returned an invalid response (${response.status}).`);
+    }
+    if (!response.ok) {
+        const message = isRecord(payload) &&
+            isRecord(payload.error) &&
+            typeof payload.error.message === "string"
+            ? payload.error.message
+            : `RemoteDraw request failed (${response.status}).`;
+        throw new Error(message);
+    }
+    return payload;
+}
+export async function currentCliAccount(runtime, apiBaseUrl) {
+    const token = await storedToken(runtime, apiBaseUrl);
+    if (!token)
+        return undefined;
+    return await fetchJson(runtime, apiBaseUrl, "/v1/cli/auth/current", { token });
+}
+export async function loginToRemoteDraw(runtime, apiBaseUrl, options = {}) {
+    const normalized = normalizedOrigin(apiBaseUrl);
+    if (!options.force) {
+        try {
+            const account = await currentCliAccount(runtime, normalized);
+            if (account)
+                return { account, alreadyLoggedIn: true };
+        }
+        catch {
+            // An expired or revoked stored token is replaced by the new login below.
+        }
+    }
+    const request = await fetchJson(runtime, normalized, "/v1/cli/auth/start", {
+        body: { deviceName: options.deviceName ?? "RemoteDraw CLI" },
+    });
+    runtime.notify?.(`Authorize this CLI at ${request.verificationUrl}\nConfirmation code: ${request.userCode}`);
+    if (options.openBrowser !== false && runtime.openUrl) {
+        try {
+            await runtime.openUrl(request.verificationUrl);
+            runtime.notify?.("Opened the browser. Waiting for authorization...");
+        }
+        catch {
+            runtime.notify?.("Could not open the browser automatically; use the URL above.");
+        }
+    }
+    const sleep = runtime.sleep ??
+        ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    while (Date.now() < request.expiresAt) {
+        await sleep(Math.max(500, request.intervalMs));
+        const result = await fetchJson(runtime, normalized, "/v1/cli/auth/token", {
+            body: { deviceCode: request.deviceCode },
+        });
+        if (result.status === "pending")
+            continue;
+        if (result.status !== "authorized") {
+            throw new Error(`CLI authorization ${result.status}. Run remotedraw login again.`);
+        }
+        const config = await readStoredConfig(runtime);
+        config.activeApiBaseUrl = normalized;
+        config.profiles[normalized] = {
+            apiBaseUrl: normalized,
+            cliToken: result.cliToken,
+            account: result.account,
+            expiresAt: result.expiresAt,
+        };
+        await writeStoredConfig(runtime, config);
+        return { account: result.account, alreadyLoggedIn: false };
+    }
+    throw new Error("CLI authorization expired. Run remotedraw login again.");
+}
+export async function logoutFromRemoteDraw(runtime, apiBaseUrl) {
+    const normalized = normalizedOrigin(apiBaseUrl);
+    const token = await storedToken(runtime, normalized);
+    if (token) {
+        try {
+            await fetchJson(runtime, normalized, "/v1/cli/auth/revoke", { token });
+        }
+        catch {
+            // Local logout still removes an expired or already-revoked credential.
+        }
+    }
+    if (!runtime.env.REMOTEDRAW_CLI_TOKEN) {
+        const config = await readStoredConfig(runtime);
+        delete config.profiles[normalized];
+        if (config.activeApiBaseUrl === normalized) {
+            config.activeApiBaseUrl = Object.keys(config.profiles)[0] ?? "";
+        }
+        await writeStoredConfig(runtime, config);
+    }
+    return { hadCredential: Boolean(token) };
+}
+export async function provisionRemoteDrawProject(runtime, apiBaseUrl, input) {
+    const normalized = normalizedOrigin(apiBaseUrl);
+    let token = await storedToken(runtime, normalized);
+    if (!token) {
+        if (!runtime.env.REMOTEDRAW_CLI_TOKEN &&
+            runtime.isInteractive &&
+            runtime.openUrl) {
+            await loginToRemoteDraw(runtime, normalized);
+            token = await storedToken(runtime, normalized);
+        }
+    }
+    if (!token) {
+        throw new Error("Not logged in. Run remotedraw login, or set REMOTEDRAW_CLI_TOKEN for non-interactive use.");
+    }
+    return await fetchJson(runtime, normalized, "/v1/cli/projects", { body: input, token });
+}
+function envAssignment(contents, name) {
+    const line = contents
+        .split(/\r?\n/)
+        .find((candidate) => new RegExp(`^\\s*(?:export\\s+)?${name}\\s*=`).test(candidate));
+    if (!line)
+        return undefined;
+    return line
+        .slice(line.indexOf("=") + 1)
+        .trim()
+        .replace(/^(['"])(.*)\1$/, "$2");
+}
+function isReplaceableEnvValue(name, value) {
+    if (!value)
+        return true;
+    if (value.includes("replace_me") || value.includes("<deployment>"))
+        return true;
+    if (name === "REMOTEDRAW_API_KEY" && value === "rd_sk_...")
+        return true;
+    return false;
+}
+export function updateEnvContents(contents, values, force = false) {
+    let next = contents;
+    for (const [name, value] of Object.entries(values)) {
+        const existing = envAssignment(next, name);
+        if (existing != null &&
+            existing !== value &&
+            !isReplaceableEnvValue(name, existing) &&
+            !force) {
+            throw new Error(`${name} is already set in .env.local. Pass --force to replace it or use --offline to keep setup local-only.`);
+        }
+        const pattern = new RegExp(`^\\s*(?:export\\s+)?${name}\\s*=.*$`, "m");
+        if (pattern.test(next)) {
+            next = next.replace(pattern, `${name}=${value}`);
+        }
+        else {
+            if (next && !next.endsWith("\n"))
+                next += "\n";
+            next += `${name}=${value}\n`;
+        }
+    }
+    return next;
+}
+export async function assertEnvCanAcceptProvisioning(runtime, outputDir, apiBaseUrl, force) {
+    const envPath = path.join(outputDir, ".env.local");
+    const contents = (await runtime.exists(envPath))
+        ? await runtime.readFile(envPath)
+        : "";
+    updateEnvContents(contents, {
+        REMOTEDRAW_API_BASE_URL: apiBaseUrl,
+        REMOTEDRAW_PROJECT_ID: "__pending__",
+        REMOTEDRAW_API_KEY: "rd_sk_replace_me",
+    }, force);
+}
+export async function writeProvisionedProjectSetup(runtime, outputDir, provisioning, force) {
+    const envPath = path.join(outputDir, ".env.local");
+    const envContents = (await runtime.exists(envPath))
+        ? await runtime.readFile(envPath)
+        : "# Generated by RemoteDraw CLI. Server-side secrets only.\n";
+    const nextEnv = updateEnvContents(envContents, {
+        REMOTEDRAW_API_BASE_URL: provisioning.apiBaseUrl,
+        REMOTEDRAW_PROJECT_ID: provisioning.project.id,
+        REMOTEDRAW_API_KEY: provisioning.apiKey.value,
+    }, force);
+    await writePrivateFile(runtime, envPath, nextEnv);
+    const configPath = path.join(outputDir, "remotedraw.config.json");
+    const config = JSON.parse(await runtime.readFile(configPath));
+    config.apiBaseUrl = provisioning.apiBaseUrl;
+    config.cloud = {
+        projectId: provisioning.project.id,
+        apiKeyId: provisioning.apiKey.id,
+        dashboardUrl: provisioning.project.dashboardUrl,
+    };
+    await runtime.writeFile(configPath, JSON.stringify(config, null, 2) + "\n");
+    const gitignorePath = path.join(outputDir, ".gitignore");
+    const gitignore = (await runtime.exists(gitignorePath))
+        ? await runtime.readFile(gitignorePath)
+        : "";
+    if (!gitignore.split(/\r?\n/).includes(".env.local")) {
+        const prefix = gitignore && !gitignore.endsWith("\n") ? `${gitignore}\n` : gitignore;
+        await runtime.writeFile(gitignorePath, `${prefix}.env.local\n`);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { pathToFileURL } from "node:url";
+import { createNodeRuntime, runCli } from "./cli.js";
+if (process.argv[1] &&
+    import.meta.url === pathToFileURL(process.argv[1]).href) {
+    const result = await runCli(process.argv.slice(2), createNodeRuntime());
+    if (result.stdout)
+        process.stdout.write(result.stdout);
+    if (result.stderr)
+        process.stderr.write(result.stderr);
+    process.exitCode = result.exitCode;
+}

package/dist/setup-wizard.d.ts

@@ -0,0 +1,122 @@
+export type WizardFieldKey = "appName" | "target" | "sender" | "sdk" | "preset" | "packageManager" | "apiEndpoint";
+export type WizardValues = Record<WizardFieldKey, string>;
+export type WizardChoice = {
+    value: string;
+    label: string;
+    hint?: string;
+    details?: WizardChoiceDetails;
+};
+export type WizardChoiceDetails = {
+    summary: string;
+    explanation: string;
+    docsUrl: string;
+    docsLabel: string;
+};
+export type WizardField = {
+    key: WizardFieldKey;
+    label: string;
+    kind: "text" | "select";
+    choices?: (values: WizardValues) => readonly WizardChoice[];
+    validate?: (value: string) => string | undefined;
+};
+export type WizardDefinition = {
+    fields: readonly WizardField[];
+    defaults: WizardValues;
+    normalize: (values: WizardValues, changed: WizardFieldKey) => WizardValues;
+    review: (values: WizardValues) => readonly [string, string][];
+};
+export type WizardScreen = "field" | "review" | "confirm" | "executing" | "success" | "error" | "cancelled" | "interrupted";
+export type WizardState = {
+    screen: WizardScreen;
+    fieldIndex: number;
+    values: WizardValues;
+    editedFields: WizardFieldKey[];
+    error?: string | undefined;
+    confirmCreate: boolean;
+    createdPath?: string | undefined;
+    nextCommand?: string | undefined;
+};
+export type WizardAction = {
+    type: "character";
+    value: string;
+} | {
+    type: "backspace";
+} | {
+    type: "previousChoice";
+} | {
+    type: "nextChoice";
+} | {
+    type: "forward";
+} | {
+    type: "back";
+} | {
+    type: "cancel";
+} | {
+    type: "interrupt";
+} | {
+    type: "executionSucceeded";
+    path: string;
+    nextCommand: string;
+} | {
+    type: "executionFailed";
+    message: string;
+};
+export type WizardSemanticView = {
+    screen: WizardScreen;
+    title: string;
+    progress?: {
+        current: number;
+        total: number;
+    } | undefined;
+    activeLabel?: string | undefined;
+    value?: string | undefined;
+    valueIsDefault?: boolean | undefined;
+    choices?: readonly WizardChoice[] | undefined;
+    selectedChoice?: string | undefined;
+    selectedDetails?: WizardChoiceDetails | undefined;
+    validation?: string | undefined;
+    review?: readonly [string, string][] | undefined;
+    controls: readonly string[];
+    createdPath?: string | undefined;
+    nextCommand?: string | undefined;
+    error?: string | undefined;
+};
+export declare function initialWizardState(definition: WizardDefinition): WizardState;
+export declare function transitionWizard(state: WizardState, action: WizardAction, definition: WizardDefinition): WizardState;
+export declare function wizardSemanticView(state: WizardState, definition: WizardDefinition): WizardSemanticView;
+export type WizardKey = {
+    name?: string;
+    sequence?: string;
+    ctrl?: boolean;
+};
+export type WizardTerminal = {
+    columns: number;
+    color: boolean;
+    hyperlinks?: boolean;
+    write: (value: string) => void;
+    readKey: () => Promise<WizardKey>;
+    openUrl?: (url: string) => void | Promise<void>;
+    enter: () => void | Promise<void>;
+    restore: () => void | Promise<void>;
+};
+export type WizardExecutionResult = {
+    path: string;
+    nextCommand: string;
+};
+export declare function runSetupWizard(options: {
+    definition: WizardDefinition;
+    terminal: WizardTerminal;
+    execute: (values: WizardValues) => Promise<WizardExecutionResult>;
+}): Promise<{
+    exitCode: number;
+    state: WizardState;
+}>;
+export declare function actionForKey(key: WizardKey, state: WizardState): WizardAction;
+export declare function renderWizard(state: WizardState, definition: WizardDefinition, terminal: Pick<WizardTerminal, "columns" | "color" | "hyperlinks">, bannerFrame?: number): string;
+type KeypressInput = NodeJS.ReadStream & {
+    isRaw?: boolean;
+    setRawMode?: (mode: boolean) => KeypressInput;
+};
+export declare function createWizardTerminal(input: KeypressInput, output: NodeJS.WriteStream, env: Record<string, string | undefined>): WizardTerminal;
+export {};
+//# sourceMappingURL=setup-wizard.d.ts.map

package/dist/setup-wizard.d.ts.map

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