@remotedraw/cli 0.1.0

package/README.md

@@ -0,0 +1,79 @@
+# @remotedraw/cli
+
+Command-line tools for starting and inspecting RemoteDraw developer integrations.
+
+## Local Development
+
+```sh
+bun run cli -- guide
+bun run cli -- options --format json
+bun run cli -- login
+bun run cli -- whoami
+bun run cli
+bun run cli -- new
+bun run cli -- new --app-name MijnApp --target web --sender remotedraw-ios --sdk react
+bun run cli -- init --target web --sender embedded-web --sdk react
+bun run cli -- doctor
+bun run cli -- agent --print-skill
+```
+
+The published package will expose the same commands through the `remotedraw`
+binary, for example `npx @remotedraw/cli@latest guide`.
+
+Run `remotedraw` with no arguments in an interactive terminal for the guided
+project-creation wizard. It supports keyboard navigation, review, and explicit
+confirmation before writing. Piped or redirected no-argument use prints the
+same deterministic help as `remotedraw --help` and never waits for input.
+
+`remotedraw new` remains available with either explicit flags or its existing
+interactive prompts. Both routes use the same project validation, templates,
+and file writer.
+
+Coding agents and CI should use the machine-readable path instead of driving
+the wizard:
+
+```sh
+remotedraw options --format json
+remotedraw new --non-interactive --offline --dry-run --format json \
+  --app-name AgentDesk --target web --sender remotedraw-ios \
+  --sdk react --preset sketch --package-manager npm
+remotedraw doctor --format json
+```
+
+`--non-interactive` guarantees that setup never opens prompts or browser
+authorization. JSON dry runs return the resolved plan, applied defaults, file
+list, warnings, cloud mode, and next commands. Remove `--dry-run` only after
+inspecting that result; `--force` remains an explicit overwrite decision.
+
+By default, `new` and `init` also create a project on the RemoteDraw backend,
+mint a project-scoped development API key, and write these server-side values
+to a gitignored `.env.local`:
+
+```dotenv
+REMOTEDRAW_API_BASE_URL=https://api.remotedraw.com
+REMOTEDRAW_PROJECT_ID=...
+REMOTEDRAW_API_KEY=rd_sk_...
+```
+
+The account-level `rd_cli_...` credential is separate: it is stored with mode
+`0600` in the user's config directory (`$XDG_CONFIG_HOME/remotedraw/config.json`
+or `~/.config/remotedraw/config.json`) and never copied into a project. Use
+`remotedraw logout` to revoke it. For CI, provide `REMOTEDRAW_CLI_TOKEN` as a
+secret. Use `--offline` when only local scaffolding is wanted.
+
+Like the Convex CLI, RemoteDraw reads generated runtime values back from
+`.env.local`, so `remotedraw doctor` and `remotedraw create-input --execute`
+work without manually exporting them in the shell.
+
+## Agent Skill
+
+Print or install the RemoteDraw agent skill:
+
+```sh
+remotedraw agent --print-skill
+remotedraw agent --path ~/.codex/skills/remotedraw --force
+```
+
+The skill teaches coding agents the CLI-first integration flow, SDK choices,
+API key boundary, token lifecycle, structured dry-run workflow, and
+verification commands.

package/dist/cli.d.ts

@@ -0,0 +1,141 @@
+import { type WizardDefinition, type WizardTerminal } from "./setup-wizard.js";
+import { type CloudRuntime } from "./cloud.js";
+export declare const CLI_VERSION: string;
+export type CliResult = {
+    exitCode: number;
+    stdout: string;
+    stderr?: string;
+};
+export type PromptChoice<T extends string = string> = {
+    value: T;
+    label: string;
+    hint?: string;
+};
+export type SelectPromptOptions<T extends string> = {
+    message: string;
+    helperText?: string;
+    defaultValue?: T;
+    choices: readonly PromptChoice<T>[];
+};
+export type TextPromptOptions = {
+    message: string;
+    defaultValue?: string;
+    validate?: (value: string) => string | undefined;
+};
+export type CliPrompter = {
+    intro?: (title: string) => void | Promise<void>;
+    text: (options: TextPromptOptions) => Promise<string>;
+    select: <T extends string>(options: SelectPromptOptions<T>) => Promise<T>;
+};
+export type CliRuntime = CloudRuntime & {
+    cwd: string;
+    prompts?: CliPrompter;
+    wizardTerminal?: WizardTerminal | undefined;
+};
+declare const targetChoices: readonly ["web", "desktop", "ios", "headless"];
+declare const senderChoices: readonly ["remotedraw-ios", "embedded-web", "own-ios", "headless"];
+declare const sdkChoices: readonly ["react", "svelte", "js", "swift", "headless"];
+declare const presetChoices: readonly ["signature", "initials", "approval", "sketch", "photoMarkup", "pdfMarkup", "mapMarkup", "screenMarkup", "designReview", "pointer"];
+declare const packageManagerChoices: readonly ["npm", "pnpm", "yarn", "bun"];
+type TargetChoice = (typeof targetChoices)[number];
+type SenderChoice = (typeof senderChoices)[number];
+type SdkChoice = (typeof sdkChoices)[number];
+type PresetChoice = (typeof presetChoices)[number];
+type PackageManagerChoice = (typeof packageManagerChoices)[number];
+export type IntegrationPlan = {
+    appName: string;
+    slug: string;
+    target: TargetChoice;
+    sender: SenderChoice;
+    sdk: SdkChoice;
+    preset: PresetChoice;
+    apiBaseUrl: string;
+    packageManager: PackageManagerChoice;
+};
+export declare function createNodeRuntime(): CliRuntime;
+export declare function cliEnvironmentForWorkspace(cwd: string, env: Record<string, string | undefined>, exists?: (filePath: string) => boolean): Record<string, string | undefined>;
+export declare function runCli(args: string[], runtime?: CliRuntime): Promise<CliResult>;
+export declare function createRemoteDrawProject(plan: IntegrationPlan, outputDir: string, runtime: CliRuntime, options?: {
+    dryRun?: boolean;
+    force?: boolean;
+}): Promise<string[]>;
+export declare function projectSetupDefinition(): WizardDefinition;
+type PayloadOptions = {
+    preset: PresetChoice;
+    label: string;
+    externalId: string;
+    expiresInMs?: number | undefined;
+};
+export declare function createSessionPayload(options: PayloadOptions): {
+    expiresInMs?: number;
+    externalId: string;
+    markupPreset: "signature" | "initials" | "approval" | "sketch" | "photoMarkup" | "pdfMarkup" | "mapMarkup" | "screenMarkup" | "designReview" | "pointer";
+    target: {
+        metadata: {
+            descriptor: {
+                version: number;
+                privacy: string;
+                surfaceRole: string;
+                inputIntent: "signature" | "initials";
+                label: string;
+                components: {
+                    id: "signature" | "initials";
+                    role: string;
+                    inputIntent: "signature" | "initials";
+                    required: boolean;
+                    bounds: {
+                        minX: number;
+                        minY: number;
+                        maxX: number;
+                        maxY: number;
+                    };
+                }[];
+                phoneHints: {
+                    preferredLayout: string;
+                    preferredTool: string;
+                    primaryActionLabel: string;
+                    showUndo: boolean;
+                    showClear: boolean;
+                };
+            } | {
+                version: number;
+                privacy: string;
+                surfaceRole: string;
+                inputIntent: string;
+                label: string;
+                phoneHints: {
+                    preferredLayout: string;
+                    preferredTool: string;
+                    primaryActionLabel: string;
+                    showUndo?: never;
+                    showClear?: never;
+                };
+                components?: never;
+            } | {
+                version: number;
+                privacy: string;
+                surfaceRole: string;
+                inputIntent: string;
+                label: string;
+                phoneHints: {
+                    preferredLayout: string;
+                    preferredTool: string;
+                    primaryActionLabel: string;
+                    showUndo: boolean;
+                    showClear: boolean;
+                };
+                components?: never;
+            };
+        };
+        inputMapping?: "surface";
+        coordinateSpace?: {
+            width: number;
+            height: number;
+        };
+        kind: string;
+        label: string;
+    };
+};
+export declare function agentSkillMarkdown(): string;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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