@raindrop-ai/wizard 0.0.1

package/dist/src/ui/types.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Type definitions for ink-based UI components
+ * Maintains API compatibility with clack
+ */
+export interface SelectOption<T> {
+    value: T;
+    label: string;
+    hint?: string;
+}
+export interface SelectOptions<T> {
+    message: string;
+    options: Array<SelectOption<T>>;
+    initialValue?: T;
+}
+export interface TextOptions {
+    message: string;
+    placeholder?: string;
+    defaultValue?: string;
+    initialValue?: string;
+    validate?: (value: string) => string | void;
+}
+export interface SpinnerInstance {
+    start: (msg?: string) => void;
+    stop: (msg?: string) => void;
+    message: (msg: string) => void;
+}
+export interface LogFunctions {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    success: (msg: string) => void;
+    step: (msg: string) => void;
+}
+/**
+ * Tool approval result - returned to the SDK's canUseTool callback
+ */
+export type ToolApprovalResult = {
+    behavior: 'allow';
+    updatedInput: Record<string, unknown>;
+    allowAllEdits?: boolean;
+    allowAllForFile?: string;
+    allowAllForCommandPattern?: string;
+} | {
+    behavior: 'deny';
+    message: string;
+};
+/**
+ * Props for tool approval prompts
+ */
+export interface ToolApprovalProps {
+    toolName: string;
+    input: Record<string, unknown>;
+    /** For file edits, the diff content */
+    diffContent?: string;
+    /** For file edits, the filename */
+    fileName?: string;
+    /** Description of the tool action */
+    description?: string;
+}
+/**
+ * A single question option from the SDK
+ */
+export interface QuestionOption {
+    label: string;
+    description: string;
+}
+/**
+ * A single clarifying question from the SDK
+ */
+export interface ClarifyingQuestion {
+    question: string;
+    header: string;
+    options: QuestionOption[];
+    multiSelect: boolean;
+}
+/**
+ * Props for clarifying questions prompts
+ */
+export interface ClarifyingQuestionsProps {
+    questions: ClarifyingQuestion[];
+}
+/**
+ * Result from clarifying questions - returned to the SDK
+ */
+export interface ClarifyingQuestionsResult {
+    questions: ClarifyingQuestion[];
+    answers: Record<string, string>;
+}
+/**
+ * Props for plan approval prompts
+ */
+export interface PlanApprovalProps {
+    planContent: string;
+}
+/**
+ * Result from plan approval - returned to the handler
+ */
+export interface PlanApprovalResult {
+    approved: boolean;
+    feedback?: string;
+}
+/**
+ * Props for unified text input component.
+ * Handles both callback mode (during agent execution) and context mode (standalone prompts).
+ * Note: Spinner is managed separately via ui.spinner().
+ */
+export interface PersistentInputProps {
+    placeholder?: string;
+    /** Message to show above the input */
+    message?: string;
+    /** Default value for the input */
+    defaultValue?: string;
+    /** Validation function - return error message or void */
+    validate?: (value: string) => string | void;
+    /** Callback when user submits - if not provided, uses resolvePending from context */
+    onSubmit?: (message: string) => void | Promise<void>;
+    /** Callback when user presses Esc - if not provided, uses resolvePending from context */
+    onInterrupt?: () => void;
+    /** Callback when user presses Ctrl+C - if not provided, falls back to onInterrupt */
+    onCtrlC?: () => void;
+}
+/**
+ * An option in a feedback select prompt
+ */
+export interface FeedbackSelectOption<T> {
+    value: T;
+    label: string;
+    /** If true, selecting this option enables inline text input */
+    allowTextInput?: boolean;
+}
+/**
+ * Props for feedback select prompts
+ */
+export interface FeedbackSelectOptions<T> {
+    message: string;
+    options: Array<FeedbackSelectOption<T>>;
+    /** If true, don't add this prompt's result to history */
+    skipHistory?: boolean;
+}
+/**
+ * Result from feedback select - either an option was selected or text was entered
+ */
+export type FeedbackSelectResult<T> = {
+    type: 'option';
+    value: T;
+} | {
+    type: 'text';
+    value: string;
+};
+/**
+ * Props for continue button prompts
+ */
+export interface ContinuePromptOptions {
+    message: string;
+    buttonLabel?: string;
+}
+/**
+ * Status of a tool call
+ */
+export type ToolCallStatus = 'pending' | 'executing' | 'success' | 'error' | 'denied' | 'interrupted';
+/**
+ * A tool call to display in history
+ */
+export interface ToolCallInfo {
+    toolName: string;
+    description?: string;
+    status: ToolCallStatus;
+    input?: Record<string, unknown>;
+    result?: string;
+    error?: string;
+    /** For file edits, the diff content */
+    diffContent?: string;
+    /** For file edits, the filename */
+    fileName?: string;
+}
+/**
+ * Handle to control an active agent query
+ */
+export interface AgentQueryHandle {
+    /** Interrupt the current agent execution */
+    interrupt: () => Promise<void>;
+    /** @deprecated No-op - use interrupt() then resume with a new prompt instead */
+    sendMessage: (message: string) => void;
+}

package/dist/src/ui/types.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for ink-based UI components
+ * Maintains API compatibility with clack
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/ui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/ui/types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Type definitions for ink-based UI components\n * Maintains API compatibility with clack\n */\n\nexport interface SelectOption<T> {\n  value: T;\n  label: string;\n  hint?: string;\n}\n\nexport interface SelectOptions<T> {\n  message: string;\n  options: Array<SelectOption<T>>;\n  initialValue?: T;\n}\n\nexport interface TextOptions {\n  message: string;\n  placeholder?: string;\n  defaultValue?: string;\n  initialValue?: string;\n  validate?: (value: string) => string | void;\n}\n\nexport interface SpinnerInstance {\n  start: (msg?: string) => void;\n  stop: (msg?: string) => void;\n  message: (msg: string) => void;\n}\n\nexport interface LogFunctions {\n  info: (msg: string) => void;\n  warn: (msg: string) => void;\n  error: (msg: string) => void;\n  success: (msg: string) => void;\n  step: (msg: string) => void;\n}\n\n// ============================================================================\n// Tool Approval Types\n// ============================================================================\n\n/**\n * Tool approval result - returned to the SDK's canUseTool callback\n */\nexport type ToolApprovalResult =\n  | { behavior: 'allow'; updatedInput: Record<string, unknown>; allowAllEdits?: boolean; allowAllForFile?: string; allowAllForCommandPattern?: string }\n  | { behavior: 'deny'; message: string };\n\n/**\n * Props for tool approval prompts\n */\nexport interface ToolApprovalProps {\n  toolName: string;\n  input: Record<string, unknown>;\n  /** For file edits, the diff content */\n  diffContent?: string;\n  /** For file edits, the filename */\n  fileName?: string;\n  /** Description of the tool action */\n  description?: string;\n}\n\n// ============================================================================\n// Clarifying Questions Types (AskUserQuestion tool)\n// ============================================================================\n\n/**\n * A single question option from the SDK\n */\nexport interface QuestionOption {\n  label: string;\n  description: string;\n}\n\n/**\n * A single clarifying question from the SDK\n */\nexport interface ClarifyingQuestion {\n  question: string;\n  header: string;\n  options: QuestionOption[];\n  multiSelect: boolean;\n}\n\n/**\n * Props for clarifying questions prompts\n */\nexport interface ClarifyingQuestionsProps {\n  questions: ClarifyingQuestion[];\n}\n\n/**\n * Result from clarifying questions - returned to the SDK\n */\nexport interface ClarifyingQuestionsResult {\n  questions: ClarifyingQuestion[];\n  answers: Record<string, string>;\n}\n\n// ============================================================================\n// Plan Approval Types (ExitPlanMode tool)\n// ============================================================================\n\n/**\n * Props for plan approval prompts\n */\nexport interface PlanApprovalProps {\n  planContent: string;\n}\n\n/**\n * Result from plan approval - returned to the handler\n */\nexport interface PlanApprovalResult {\n  approved: boolean;\n  feedback?: string; // Present only if approved: false\n}\n\n// ============================================================================\n// Persistent Input Types\n// ============================================================================\n\n/**\n * Props for unified text input component.\n * Handles both callback mode (during agent execution) and context mode (standalone prompts).\n * Note: Spinner is managed separately via ui.spinner().\n */\nexport interface PersistentInputProps {\n  placeholder?: string;\n  /** Message to show above the input */\n  message?: string;\n  /** Default value for the input */\n  defaultValue?: string;\n  /** Validation function - return error message or void */\n  validate?: (value: string) => string | void;\n  /** Callback when user submits - if not provided, uses resolvePending from context */\n  onSubmit?: (message: string) => void | Promise<void>;\n  /** Callback when user presses Esc - if not provided, uses resolvePending from context */\n  onInterrupt?: () => void;\n  /** Callback when user presses Ctrl+C - if not provided, falls back to onInterrupt */\n  onCtrlC?: () => void;\n}\n\n// ============================================================================\n// Feedback Select Types (Select with inline text input option)\n// ============================================================================\n\n/**\n * An option in a feedback select prompt\n */\nexport interface FeedbackSelectOption<T> {\n  value: T;\n  label: string;\n  /** If true, selecting this option enables inline text input */\n  allowTextInput?: boolean;\n}\n\n/**\n * Props for feedback select prompts\n */\nexport interface FeedbackSelectOptions<T> {\n  message: string;\n  options: Array<FeedbackSelectOption<T>>;\n  /** If true, don't add this prompt's result to history */\n  skipHistory?: boolean;\n}\n\n/**\n * Result from feedback select - either an option was selected or text was entered\n */\nexport type FeedbackSelectResult<T> =\n  | { type: 'option'; value: T }\n  | { type: 'text'; value: string };\n\n// ============================================================================\n// Continue Button Types\n// ============================================================================\n\n/**\n * Props for continue button prompts\n */\nexport interface ContinuePromptOptions {\n  message: string;\n  buttonLabel?: string;\n}\n\n// ============================================================================\n// Tool Call Display Types\n// ============================================================================\n\n/**\n * Status of a tool call\n */\nexport type ToolCallStatus =\n  | 'pending'\n  | 'executing'\n  | 'success'\n  | 'error'\n  | 'denied'\n  | 'interrupted';\n\n/**\n * A tool call to display in history\n */\nexport interface ToolCallInfo {\n  toolName: string;\n  description?: string;\n  status: ToolCallStatus;\n  input?: Record<string, unknown>;\n  result?: string;\n  error?: string;\n  /** For file edits, the diff content */\n  diffContent?: string;\n  /** For file edits, the filename */\n  fileName?: string;\n}\n\n// ============================================================================\n// Agent Query Handle\n// ============================================================================\n\n/**\n * Handle to control an active agent query\n */\nexport interface AgentQueryHandle {\n  /** Interrupt the current agent execution */\n  interrupt: () => Promise<void>;\n  /** @deprecated No-op - use interrupt() then resume with a new prompt instead */\n  sendMessage: (message: string) => void;\n}\n"]}

package/dist/src/utils/clack-utils.d.ts

@@ -0,0 +1,13 @@
+import type { WizardOptions } from './types.js';
+import type { Integration } from '../lib/constants.js';
+import { type ConsentFlowResult } from './oauth.js';
+export declare function abort(message?: string, status?: number): never;
+export declare function abortIfCancelled<T>(input: T | Promise<T>, integration?: Integration): Promise<Exclude<T, symbol>>;
+export declare function confirmContinueIfNoOrDirtyGitRepo(options: Pick<WizardOptions, 'default'>): Promise<void>;
+export declare function isInGitRepo(): boolean;
+export declare function getUncommittedOrUntrackedFiles(): string[];
+export declare function askForWizardLogin(): Promise<ConsentFlowResult>;
+/**
+ * Wait for user to press any key
+ */
+export declare function waitForUserKeyPress(): Promise<void>;

package/dist/src/utils/clack-utils.js

@@ -0,0 +1,131 @@
+import * as childProcess from 'node:child_process';
+import * as os from 'node:os';
+import Chalk from 'chalk';
+// chalk v2 types don't work well with ESM default imports
+const chalk = Chalk;
+import ui from './ui.js';
+import { INTEGRATION_CONFIG } from '../lib/config.js';
+import { performConsentFlow } from './oauth.js';
+import { debug } from './debug.js';
+export function abort(message, status) {
+    ui.addItem({ type: 'outro', text: message ?? 'Wizard setup cancelled.' });
+    return process.exit(status ?? 1);
+}
+export async function abortIfCancelled(input, integration) {
+    const resolvedInput = await input;
+    if (ui.isCancel(resolvedInput) ||
+        (typeof resolvedInput === 'symbol' &&
+            resolvedInput.description === 'clack:cancel')) {
+        const docsUrl = integration
+            ? INTEGRATION_CONFIG[integration].docsUrl
+            : 'https://raindrop.com/docs';
+        ui.addItem({
+            type: 'cancel',
+            text: `Wizard setup cancelled. You can read the documentation for ${integration ?? 'Raindrop'} at ${chalk.cyan(docsUrl)} to continue with the setup manually.`,
+        });
+        process.exit(0);
+    }
+    return resolvedInput;
+}
+export async function confirmContinueIfNoOrDirtyGitRepo(options) {
+    if (!isInGitRepo()) {
+        const continueWithoutGit = options.default
+            ? true
+            : await abortIfCancelled(ui.select({
+                message: 'You are not inside a git repository. The Raindrop wizard will create and update files. Do you want to continue anyway?',
+                options: [
+                    { label: 'Yes', value: true },
+                    { label: 'No', value: false },
+                ],
+            }));
+        if (!continueWithoutGit) {
+            abort(undefined, 0);
+        }
+        // return early to avoid checking for uncommitted files
+        return;
+    }
+    const uncommittedOrUntrackedFiles = getUncommittedOrUntrackedFiles();
+    if (uncommittedOrUntrackedFiles.length) {
+        ui.addItem({
+            type: 'warning',
+            text: `You have uncommitted or untracked files in your repo:
+
+${uncommittedOrUntrackedFiles.join('\n')}
+
+The Raindrop wizard will create and update files.`,
+        });
+        const continueWithDirtyRepo = await abortIfCancelled(ui.select({
+            message: 'Do you want to continue anyway?',
+            options: [
+                { label: 'Yes', value: true },
+                { label: 'No', value: false },
+            ],
+        }));
+        if (!continueWithDirtyRepo) {
+            abort(undefined, 0);
+        }
+    }
+}
+export function isInGitRepo() {
+    try {
+        childProcess.execSync('git rev-parse --is-inside-work-tree', {
+            stdio: 'ignore',
+        });
+        return true;
+    }
+    catch (error) {
+        // Not in a git repo - this is expected in some cases
+        debug(`Not in git repository: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+export function getUncommittedOrUntrackedFiles() {
+    try {
+        const gitStatus = childProcess
+            .execSync('git status --porcelain=v1', {
+            // we only care about stdout
+            stdio: ['ignore', 'pipe', 'ignore'],
+        })
+            .toString();
+        const files = gitStatus
+            .split(os.EOL)
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((f) => `- ${f.split(/\s+/)[1]}`);
+        return files;
+    }
+    catch (error) {
+        // Error running git status - likely not in a git repo or git not available
+        debug(`Failed to get git status: ${error instanceof Error ? error.message : String(error)}`);
+        return [];
+    }
+}
+export async function askForWizardLogin() {
+    return performConsentFlow();
+}
+/**
+ * Wait for user to press any key
+ */
+export async function waitForUserKeyPress() {
+    return new Promise((resolve) => {
+        const stdin = process.stdin;
+        // Check if stdin is a TTY and can be set to raw mode
+        if (!stdin.isTTY) {
+            // If not a TTY, just resolve immediately (shouldn't happen in normal usage)
+            resolve();
+            return;
+        }
+        const wasRaw = stdin.isRaw;
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding('utf8');
+        const onData = () => {
+            stdin.setRawMode(wasRaw);
+            stdin.pause();
+            stdin.removeListener('data', onData);
+            resolve();
+        };
+        stdin.once('data', onData);
+    });
+}
+//# sourceMappingURL=clack-utils.js.map

package/dist/src/utils/clack-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clack-utils.js","sourceRoot":"","sources":["../../../src/utils/clack-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import * as childProcess from 'node:child_process';\nimport * as os from 'node:os';\n\nimport Chalk from 'chalk';\n\n// chalk v2 types don't work well with ESM default imports\nconst chalk = Chalk as any;\nimport type { WizardOptions } from './types.js';\nimport type { Integration } from '../lib/constants.js';\nimport ui from './ui.js';\nimport { INTEGRATION_CONFIG } from '../lib/config.js';\nimport { performConsentFlow, type ConsentFlowResult } from './oauth.js';\nimport { debug } from './debug.js';\n\nexport function abort(message?: string, status?: number): never {\n  ui.addItem({ type: 'outro', text: message ?? 'Wizard setup cancelled.' });\n  return process.exit(status ?? 1);\n}\n\nexport async function abortIfCancelled<T>(\n  input: T | Promise<T>,\n  integration?: Integration,\n): Promise<Exclude<T, symbol>> {\n  const resolvedInput = await input;\n\n  if (\n    ui.isCancel(resolvedInput) ||\n    (typeof resolvedInput === 'symbol' &&\n      resolvedInput.description === 'clack:cancel')\n  ) {\n    const docsUrl = integration\n      ? INTEGRATION_CONFIG[integration].docsUrl\n      : 'https://raindrop.com/docs';\n\n    ui.addItem({\n      type: 'cancel',\n      text: `Wizard setup cancelled. You can read the documentation for ${\n        integration ?? 'Raindrop'\n      } at ${chalk.cyan(docsUrl)} to continue with the setup manually.`,\n    });\n    process.exit(0);\n  }\n\n  return resolvedInput as Exclude<T, symbol>;\n}\n\nexport async function confirmContinueIfNoOrDirtyGitRepo(\n  options: Pick<WizardOptions, 'default'>,\n): Promise<void> {\n  if (!isInGitRepo()) {\n    const continueWithoutGit = options.default\n      ? true\n      : await abortIfCancelled(\n          ui.select({\n            message:\n              'You are not inside a git repository. The Raindrop wizard will create and update files. Do you want to continue anyway?',\n            options: [\n              { label: 'Yes', value: true },\n              { label: 'No', value: false },\n            ],\n          }),\n        );\n\n    if (!continueWithoutGit) {\n      abort(undefined, 0);\n    }\n    // return early to avoid checking for uncommitted files\n    return;\n  }\n\n  const uncommittedOrUntrackedFiles = getUncommittedOrUntrackedFiles();\n  if (uncommittedOrUntrackedFiles.length) {\n    ui.addItem({\n      type: 'warning',\n      text: `You have uncommitted or untracked files in your repo:\n\n${uncommittedOrUntrackedFiles.join('\\n')}\n\nThe Raindrop wizard will create and update files.`,\n    });\n    const continueWithDirtyRepo = await abortIfCancelled(\n      ui.select({\n        message: 'Do you want to continue anyway?',\n        options: [\n          { label: 'Yes', value: true },\n          { label: 'No', value: false },\n        ],\n      }),\n    );\n\n    if (!continueWithDirtyRepo) {\n      abort(undefined, 0);\n    }\n  }\n}\n\nexport function isInGitRepo() {\n  try {\n    childProcess.execSync('git rev-parse --is-inside-work-tree', {\n      stdio: 'ignore',\n    });\n    return true;\n  } catch (error) {\n    // Not in a git repo - this is expected in some cases\n    debug(\n      `Not in git repository: ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n    );\n    return false;\n  }\n}\n\nexport function getUncommittedOrUntrackedFiles(): string[] {\n  try {\n    const gitStatus = childProcess\n      .execSync('git status --porcelain=v1', {\n        // we only care about stdout\n        stdio: ['ignore', 'pipe', 'ignore'],\n      })\n      .toString();\n\n    const files = gitStatus\n      .split(os.EOL)\n      .map((line) => line.trim())\n      .filter(Boolean)\n      .map((f) => `- ${f.split(/\\s+/)[1]}`);\n\n    return files;\n  } catch (error) {\n    // Error running git status - likely not in a git repo or git not available\n    debug(\n      `Failed to get git status: ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n    );\n    return [];\n  }\n}\n\n\nexport async function askForWizardLogin(): Promise<ConsentFlowResult> {\n  return performConsentFlow();\n}\n\n/**\n * Wait for user to press any key\n */\nexport async function waitForUserKeyPress(): Promise<void> {\n  return new Promise((resolve) => {\n    const stdin = process.stdin;\n\n    // Check if stdin is a TTY and can be set to raw mode\n    if (!stdin.isTTY) {\n      // If not a TTY, just resolve immediately (shouldn't happen in normal usage)\n      resolve();\n      return;\n    }\n\n    const wasRaw = stdin.isRaw;\n\n    stdin.setRawMode(true);\n    stdin.resume();\n    stdin.setEncoding('utf8');\n\n    const onData = () => {\n      stdin.setRawMode(wasRaw);\n      stdin.pause();\n      stdin.removeListener('data', onData);\n      resolve();\n    };\n\n    stdin.once('data', onData);\n  });\n}\n"]}

package/dist/src/utils/debug.d.ts

@@ -0,0 +1,13 @@
+export declare const LOG_FILE_PATH = "/tmp/raindrop-ai-wizard.log";
+/**
+ * Initialize the log file with a run header.
+ * Call this at the start of each wizard run.
+ */
+export declare function initLogFile(): void;
+/**
+ * Log a message to the file at /tmp/raindrop-ai-wizard.log.
+ * Always writes regardless of debug flag.
+ */
+export declare function logToFile(...args: unknown[]): void;
+export declare function debug(...args: unknown[]): void;
+export declare function enableDebugLogs(): void;

package/dist/src/utils/debug.js

@@ -0,0 +1,47 @@
+import Chalk from 'chalk';
+// chalk v2 types don't work well with ESM default imports
+const chalk = Chalk;
+import { appendFileSync } from 'fs';
+import { prepareMessage } from './logging.js';
+import ui from './ui.js';
+let debugEnabled = false;
+export const LOG_FILE_PATH = '/tmp/raindrop-ai-wizard.log';
+/**
+ * Initialize the log file with a run header.
+ * Call this at the start of each wizard run.
+ */
+export function initLogFile() {
+    const header = `\n${'='.repeat(60)}\nRaindrop wizard Run: ${new Date().toISOString()}\n${'='.repeat(60)}\n`;
+    appendFileSync(LOG_FILE_PATH, header);
+}
+/**
+ * Log a message to the file at /tmp/raindrop-ai-wizard.log.
+ * Always writes regardless of debug flag.
+ */
+export function logToFile(...args) {
+    const timestamp = new Date().toISOString();
+    const msg = args.map((a) => prepareMessage(a)).join(' ');
+    appendFileSync(LOG_FILE_PATH, `[${timestamp}] ${msg}\n`);
+}
+export function debug(...args) {
+    if (!debugEnabled) {
+        return;
+    }
+    // Don't sanitize debug logs to ui - they're for development
+    const msg = args
+        .map((a) => {
+        if (typeof a === 'string') {
+            return a;
+        }
+        if (a instanceof Error) {
+            return `${a.stack || ''}`;
+        }
+        return JSON.stringify(a, null, '\t');
+    })
+        .join(' ');
+    ui.addItem({ type: 'response', text: chalk.dim(msg) });
+}
+export function enableDebugLogs() {
+    debugEnabled = true;
+}
+//# sourceMappingURL=debug.js.map

package/dist/src/utils/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../src/utils/debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,0DAA0D;AAC1D,MAAM,KAAK,GAAG,KAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,MAAM,CAAC,MAAM,aAAa,GAAG,6BAA6B,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,MAAM,CAC5B,EAAE,CACH,0BAA0B,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC;IAC3E,cAAc,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAG,IAAe;IAC1C,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,cAAc,CAAC,aAAa,EAAE,IAAI,SAAS,KAAK,GAAG,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAG,IAAe;IACtC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;IACT,CAAC;IAED,4DAA4D;IAC5D,MAAM,GAAG,GAAG,IAAI;SACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;YACvB,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC","sourcesContent":["import Chalk from 'chalk';\n\n// chalk v2 types don't work well with ESM default imports\nconst chalk = Chalk as any;\nimport { appendFileSync } from 'fs';\nimport { prepareMessage } from './logging.js';\nimport ui from './ui.js';\n\nlet debugEnabled = false;\n\nexport const LOG_FILE_PATH = '/tmp/raindrop-ai-wizard.log';\n\n/**\n * Initialize the log file with a run header.\n * Call this at the start of each wizard run.\n */\nexport function initLogFile() {\n  const header = `\\n${'='.repeat(\n    60,\n  )}\\nRaindrop wizard Run: ${new Date().toISOString()}\\n${'='.repeat(60)}\\n`;\n  appendFileSync(LOG_FILE_PATH, header);\n}\n\n/**\n * Log a message to the file at /tmp/raindrop-ai-wizard.log.\n * Always writes regardless of debug flag.\n */\nexport function logToFile(...args: unknown[]) {\n  const timestamp = new Date().toISOString();\n  const msg = args.map((a) => prepareMessage(a)).join(' ');\n  appendFileSync(LOG_FILE_PATH, `[${timestamp}] ${msg}\\n`);\n}\n\nexport function debug(...args: unknown[]) {\n  if (!debugEnabled) {\n    return;\n  }\n\n  // Don't sanitize debug logs to ui - they're for development\n  const msg = args\n    .map((a) => {\n      if (typeof a === 'string') {\n        return a;\n      }\n      if (a instanceof Error) {\n        return `${a.stack || ''}`;\n      }\n      return JSON.stringify(a, null, '\\t');\n    })\n    .join(' ');\n\n  ui.addItem({ type: 'response', text: chalk.dim(msg) });\n}\n\nexport function enableDebugLogs() {\n  debugEnabled = true;\n}\n"]}

package/dist/src/utils/environment.d.ts

@@ -0,0 +1,5 @@
+import type { WizardOptions } from './types.js';
+export declare function isNonInteractiveEnvironment(): boolean;
+export declare function readEnvironment(): Record<string, unknown>;
+export declare function detectEnvVarPrefix(options: WizardOptions): Promise<string>;
+export declare function saveWriteKeyToEnv(writeKey: string, installDir: string): Promise<void>;

package/dist/src/utils/environment.js

@@ -0,0 +1,131 @@
+import readEnvModule from 'read-env';
+import fg from 'fast-glob';
+import { IS_DEV } from '../lib/constants.js';
+import fs from 'fs';
+import path from 'path';
+// Handle CJS interop - read-env exports { default: fn }
+const readEnv = typeof readEnvModule === 'function'
+    ? readEnvModule
+    : readEnvModule.default;
+export function isNonInteractiveEnvironment() {
+    if (IS_DEV) {
+        return false;
+    }
+    if (!process.stdout.isTTY || !process.stderr.isTTY) {
+        return true;
+    }
+    return false;
+}
+export function readEnvironment() {
+    const result = readEnv('RAINDROP');
+    return result;
+}
+export async function detectEnvVarPrefix(options) {
+    let deps = {};
+    const packageJsonPath = path.join(options.installDir, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const packageJsonContent = await fs.promises.readFile(packageJsonPath, 'utf-8');
+            const packageJson = JSON.parse(packageJsonContent);
+            deps = {
+                ...(packageJson.dependencies || {}),
+                ...(packageJson.devDependencies || {}),
+            };
+        }
+        catch {
+            // package.json exists but couldn't be read/parsed - continue without deps
+        }
+    }
+    const has = (name) => name in deps;
+    const hasAnyFile = async (patterns) => {
+        const matches = await fg(patterns, {
+            cwd: options.installDir,
+            absolute: false,
+            onlyFiles: true,
+            ignore: ['**/node_modules/**'],
+        });
+        return matches.length > 0;
+    };
+    // --- Next.js
+    if (has('next') || (await hasAnyFile(['**/next.config.{js,ts,mjs,cjs}']))) {
+        return 'NEXT_PUBLIC_';
+    }
+    // --- Create React App
+    if (has('react-scripts') ||
+        has('create-react-app') ||
+        (await hasAnyFile(['**/config-overrides.js']))) {
+        return 'REACT_APP_';
+    }
+    // --- Vite (vanilla, TanStack, Solid, etc.)
+    // Note: Vite does not need PUBLIC_ but we use it to follow the docs, to improve the chances of an LLM getting it right.
+    if (has('vite') || (await hasAnyFile(['**/vite.config.{js,ts,mjs,cjs}']))) {
+        return 'VITE_PUBLIC_';
+    }
+    // --- SvelteKit
+    if (has('@sveltejs/kit') ||
+        (await hasAnyFile(['**/svelte.config.{js,ts}']))) {
+        return 'PUBLIC_';
+    }
+    // --- TanStack Start (uses Vite)
+    if (has('@tanstack/start') ||
+        (await hasAnyFile(['**/tanstack.config.{js,ts}']))) {
+        return 'VITE_PUBLIC_';
+    }
+    // --- SolidStart (uses Vite)
+    if (has('solid-start') || (await hasAnyFile(['**/solid.config.{js,ts}']))) {
+        return 'VITE_PUBLIC_';
+    }
+    // --- Astro
+    if (has('astro') || (await hasAnyFile(['**/astro.config.{js,ts,mjs}']))) {
+        return 'PUBLIC_';
+    }
+    // We default to Vite if we can't detect a specific framework, since it's the most commonly used.
+    return 'VITE_PUBLIC_';
+}
+/**
+ * Validates write key format to prevent injection attacks and file corruption.
+ * Write keys should be alphanumeric with optional hyphens/underscores, 20-100 chars.
+ *
+ * @param key - The write key to validate
+ * @returns true if the key is valid, false otherwise
+ */
+function validateWriteKey(key) {
+    // Write keys should be alphanumeric with optional hyphens/underscores
+    // Length: 20-100 characters (reasonable bounds for write keys)
+    const WRITE_KEY_PATTERN = /^[a-zA-Z0-9_-]{20,100}$/;
+    // Check pattern and ensure no dangerous characters
+    return (WRITE_KEY_PATTERN.test(key) &&
+        !key.includes('\n') &&
+        !key.includes('\r') &&
+        !key.includes('\0'));
+}
+export async function saveWriteKeyToEnv(writeKey, installDir) {
+    // Sanitize input by trimming and removing dangerous characters
+    const sanitizedKey = writeKey.trim().replace(/[\r\n\0]/g, '');
+    // Validate the sanitized key
+    if (!validateWriteKey(sanitizedKey)) {
+        throw new Error('Invalid write key format. Write keys must be 20-100 characters long and contain only alphanumeric characters, hyphens, and underscores.');
+    }
+    const envPath = path.join(installDir, '.env');
+    let envContent = '';
+    try {
+        envContent = await fs.promises.readFile(envPath, 'utf-8');
+    }
+    catch {
+        // File doesn't exist, will create it
+    }
+    // Check if RAINDROP_WRITE_KEY already exists in the file
+    if (envContent.includes('RAINDROP_WRITE_KEY=')) {
+        // Replace existing key
+        envContent = envContent.replace(/RAINDROP_WRITE_KEY=.*/, `RAINDROP_WRITE_KEY=${sanitizedKey}`);
+    }
+    else {
+        // Add new key
+        envContent =
+            envContent.trim() +
+                (envContent ? '\n' : '') +
+                `RAINDROP_WRITE_KEY=${sanitizedKey}\n`;
+    }
+    await fs.promises.writeFile(envPath, envContent, 'utf-8');
+}
+//# sourceMappingURL=environment.js.map

package/dist/src/utils/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/utils/environment.ts"],"names":[],"mappings":"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","sourcesContent":["import readEnvModule from 'read-env';\nimport type { WizardOptions } from './types.js';\nimport fg from 'fast-glob';\nimport { IS_DEV } from '../lib/constants.js';\nimport fs from 'fs';\nimport path from 'path';\n\n// Handle CJS interop - read-env exports { default: fn }\nconst readEnv =\n  typeof readEnvModule === 'function'\n    ? readEnvModule\n    : (readEnvModule as { default: typeof readEnvModule }).default;\n\nexport function isNonInteractiveEnvironment(): boolean {\n  if (IS_DEV) {\n    return false;\n  }\n\n  if (!process.stdout.isTTY || !process.stderr.isTTY) {\n    return true;\n  }\n\n  return false;\n}\n\nexport function readEnvironment(): Record<string, unknown> {\n  const result = readEnv('RAINDROP');\n\n  return result;\n}\n\nexport async function detectEnvVarPrefix(\n  options: WizardOptions,\n): Promise<string> {\n  let deps: Record<string, string> = {};\n  const packageJsonPath = path.join(options.installDir, 'package.json');\n  if (fs.existsSync(packageJsonPath)) {\n    try {\n      const packageJsonContent = await fs.promises.readFile(\n        packageJsonPath,\n        'utf-8',\n      );\n      const packageJson = JSON.parse(packageJsonContent);\n      deps = {\n        ...(packageJson.dependencies || {}),\n        ...(packageJson.devDependencies || {}),\n      };\n    } catch {\n      // package.json exists but couldn't be read/parsed - continue without deps\n    }\n  }\n\n  const has = (name: string) => name in deps;\n  const hasAnyFile = async (patterns: string[]) => {\n    const matches = await fg(patterns, {\n      cwd: options.installDir,\n      absolute: false,\n      onlyFiles: true,\n      ignore: ['**/node_modules/**'],\n    });\n    return matches.length > 0;\n  };\n\n  // --- Next.js\n  if (has('next') || (await hasAnyFile(['**/next.config.{js,ts,mjs,cjs}']))) {\n    return 'NEXT_PUBLIC_';\n  }\n\n  // --- Create React App\n  if (\n    has('react-scripts') ||\n    has('create-react-app') ||\n    (await hasAnyFile(['**/config-overrides.js']))\n  ) {\n    return 'REACT_APP_';\n  }\n\n  // --- Vite (vanilla, TanStack, Solid, etc.)\n  // Note: Vite does not need PUBLIC_ but we use it to follow the docs, to improve the chances of an LLM getting it right.\n  if (has('vite') || (await hasAnyFile(['**/vite.config.{js,ts,mjs,cjs}']))) {\n    return 'VITE_PUBLIC_';\n  }\n\n  // --- SvelteKit\n  if (\n    has('@sveltejs/kit') ||\n    (await hasAnyFile(['**/svelte.config.{js,ts}']))\n  ) {\n    return 'PUBLIC_';\n  }\n\n  // --- TanStack Start (uses Vite)\n  if (\n    has('@tanstack/start') ||\n    (await hasAnyFile(['**/tanstack.config.{js,ts}']))\n  ) {\n    return 'VITE_PUBLIC_';\n  }\n\n  // --- SolidStart (uses Vite)\n  if (has('solid-start') || (await hasAnyFile(['**/solid.config.{js,ts}']))) {\n    return 'VITE_PUBLIC_';\n  }\n\n  // --- Astro\n  if (has('astro') || (await hasAnyFile(['**/astro.config.{js,ts,mjs}']))) {\n    return 'PUBLIC_';\n  }\n\n  // We default to Vite if we can't detect a specific framework, since it's the most commonly used.\n  return 'VITE_PUBLIC_';\n}\n\n/**\n * Validates write key format to prevent injection attacks and file corruption.\n * Write keys should be alphanumeric with optional hyphens/underscores, 20-100 chars.\n *\n * @param key - The write key to validate\n * @returns true if the key is valid, false otherwise\n */\nfunction validateWriteKey(key: string): boolean {\n  // Write keys should be alphanumeric with optional hyphens/underscores\n  // Length: 20-100 characters (reasonable bounds for write keys)\n  const WRITE_KEY_PATTERN = /^[a-zA-Z0-9_-]{20,100}$/;\n\n  // Check pattern and ensure no dangerous characters\n  return (\n    WRITE_KEY_PATTERN.test(key) &&\n    !key.includes('\\n') &&\n    !key.includes('\\r') &&\n    !key.includes('\\0')\n  );\n}\n\nexport async function saveWriteKeyToEnv(\n  writeKey: string,\n  installDir: string,\n): Promise<void> {\n  // Sanitize input by trimming and removing dangerous characters\n  const sanitizedKey = writeKey.trim().replace(/[\\r\\n\\0]/g, '');\n\n  // Validate the sanitized key\n  if (!validateWriteKey(sanitizedKey)) {\n    throw new Error(\n      'Invalid write key format. Write keys must be 20-100 characters long and contain only alphanumeric characters, hyphens, and underscores.',\n    );\n  }\n\n  const envPath = path.join(installDir, '.env');\n  let envContent = '';\n\n  try {\n    envContent = await fs.promises.readFile(envPath, 'utf-8');\n  } catch {\n    // File doesn't exist, will create it\n  }\n\n  // Check if RAINDROP_WRITE_KEY already exists in the file\n  if (envContent.includes('RAINDROP_WRITE_KEY=')) {\n    // Replace existing key\n    envContent = envContent.replace(\n      /RAINDROP_WRITE_KEY=.*/,\n      `RAINDROP_WRITE_KEY=${sanitizedKey}`,\n    );\n  } else {\n    // Add new key\n    envContent =\n      envContent.trim() +\n      (envContent ? '\\n' : '') +\n      `RAINDROP_WRITE_KEY=${sanitizedKey}\\n`;\n  }\n\n  await fs.promises.writeFile(envPath, envContent, 'utf-8');\n}\n"]}

package/dist/src/utils/logging.d.ts

@@ -0,0 +1,9 @@
+export declare function prepareMessage(msg: unknown): string;
+export declare function l(msg: string): void;
+export declare function nl(): void;
+export declare function green(msg: string): void;
+export declare function red(msg: string): void;
+export declare function dim(msg: string): void;
+export declare function yellow(msg: string): void;
+export declare function cyan(msg: string): void;
+export declare function debug(msg: any): void;

package/dist/src/utils/logging.js

@@ -0,0 +1,38 @@
+import ChalkModule from 'chalk';
+// chalk v2 types don't work well with ESM default imports
+const Chalk = ChalkModule;
+export function prepareMessage(msg) {
+    if (typeof msg === 'string') {
+        return msg;
+    }
+    if (msg instanceof Error) {
+        return `${msg.stack || ''}`;
+    }
+    return JSON.stringify(msg, null, '\t');
+}
+export function l(msg) {
+    // eslint-disable-next-line no-console
+    console.log(msg);
+}
+export function nl() {
+    return l('');
+}
+export function green(msg) {
+    return l(Chalk.green(prepareMessage(msg)));
+}
+export function red(msg) {
+    return l(Chalk.red(prepareMessage(msg)));
+}
+export function dim(msg) {
+    return l(Chalk.dim(prepareMessage(msg)));
+}
+export function yellow(msg) {
+    return l(Chalk.yellow(prepareMessage(msg)));
+}
+export function cyan(msg) {
+    return l(Chalk.cyan(prepareMessage(msg)));
+}
+export function debug(msg) {
+    return l(Chalk.italic.yellow(prepareMessage(msg)));
+}
+//# sourceMappingURL=logging.js.map

package/dist/src/utils/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../../src/utils/logging.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,OAAO,CAAC;AAEhC,0DAA0D;AAC1D,MAAM,KAAK,GAAG,WAAkB,CAAC;AAEjC,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,CAAC,CAAC,GAAW;IAC3B,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,EAAE;IAChB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,GAAW;IAC7B,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,GAAW;IAC7B,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAQ;IAC5B,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC","sourcesContent":["import ChalkModule from 'chalk';\n\n// chalk v2 types don't work well with ESM default imports\nconst Chalk = ChalkModule as any;\n\nexport function prepareMessage(msg: unknown): string {\n  if (typeof msg === 'string') {\n    return msg;\n  }\n  if (msg instanceof Error) {\n    return `${msg.stack || ''}`;\n  }\n  return JSON.stringify(msg, null, '\\t');\n}\n\nexport function l(msg: string): void {\n  // eslint-disable-next-line no-console\n  console.log(msg);\n}\n\nexport function nl(): void {\n  return l('');\n}\n\nexport function green(msg: string): void {\n  return l(Chalk.green(prepareMessage(msg)));\n}\n\nexport function red(msg: string): void {\n  return l(Chalk.red(prepareMessage(msg)));\n}\n\nexport function dim(msg: string): void {\n  return l(Chalk.dim(prepareMessage(msg)));\n}\n\nexport function yellow(msg: string): void {\n  return l(Chalk.yellow(prepareMessage(msg)));\n}\n\nexport function cyan(msg: string): void {\n  return l(Chalk.cyan(prepareMessage(msg)));\n}\n\nexport function debug(msg: any): void {\n  return l(Chalk.italic.yellow(prepareMessage(msg)));\n}\n"]}