raindrop-cli 0.1.0

package/dist/output/index.d.ts

@@ -0,0 +1,23 @@
+import type { OutputFormat } from "../types/index.js";
+export interface OutputOptions {
+    format?: OutputFormat;
+    quiet: boolean;
+    verbose: boolean;
+    debug: boolean;
+}
+/**
+ * Style hints for terminal formatters (plain, table).
+ * These are ignored by data formats (json, tsv).
+ */
+export type ColumnStyle = "bold" | "dim" | "cyan" | "none";
+export interface ColumnConfig {
+    key: string;
+    header: string;
+    width?: number;
+    /** If true, display prominently without label (for title/URL in plain format) */
+    prominent?: boolean;
+    /** Style hint for terminal formatters. Ignored by json/tsv. Default: none */
+    style?: ColumnStyle;
+}
+export declare function output<T>(data: T, columns: ColumnConfig[], options: OutputOptions): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/output/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQtD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CA2CxF"}

package/dist/output/json.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Format data as JSON.
+ * Data should be clean (no ANSI codes) - styling is applied only by terminal formatters.
+ */
+export declare function formatJson<T>(data: T): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/output/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAE7C"}

package/dist/output/plain.d.ts

@@ -0,0 +1,16 @@
+import type { ColumnConfig } from "./index.js";
+/**
+ * Format data as styled plain text with labeled fields.
+ * Each record is displayed as multi-line with icons, colors, and proper formatting.
+ * Records are separated by a styled divider.
+ *
+ * Features:
+ * - Prominent fields (title/URL) displayed without labels, bold/cyan
+ * - Emoji icons for regular field types
+ * - Bold field labels
+ * - Dimmed placeholder for empty values
+ * - Proper indentation for multiline content
+ * - Newlines around separators for visual breathing room
+ */
+export declare function formatPlain<T>(data: T, columns: ColumnConfig[]): string;
+//# sourceMappingURL=plain.d.ts.map

package/dist/output/plain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain.d.ts","sourceRoot":"","sources":["../../src/output/plain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,YAAY,CAAC;AAqK5D;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CA6EvE"}

package/dist/output/table.d.ts

@@ -0,0 +1,3 @@
+import type { ColumnConfig } from "./index.js";
+export declare function formatTable<T>(data: T, columns: ColumnConfig[]): string;
+//# sourceMappingURL=table.d.ts.map

package/dist/output/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/output/table.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,YAAY,CAAC;AAuB5D,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAiBvE"}

package/dist/output/tree.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Tree-specific output formatting.
+ *
+ * Trees need special handling because:
+ * - Terminal output should show a compact tree structure (not separate cards)
+ * - Data formats (JSON/TSV) should output clean structured data (not visual characters)
+ */
+import type { OutputFormat } from "../types/index.js";
+import type { TreeNode, TreeItem } from "../utils/tree.js";
+export interface TreeOutputOptions {
+    format?: OutputFormat;
+    quiet: boolean;
+}
+/**
+ * Output tree data with format-appropriate rendering.
+ *
+ * - quiet: Just output IDs
+ * - json: Structured data with title, _id, count, parentId, depth
+ * - tsv: Same structured data as TSV
+ * - plain/table: Compact tree visualization
+ */
+export declare function outputTree<T extends TreeItem>(tree: TreeNode<T>[], options: TreeOutputOptions): void;
+//# sourceMappingURL=tree.d.ts.map

package/dist/output/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/output/tree.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAK3D,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB;AAoID;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,QAAQ,EAC3C,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EACnB,OAAO,EAAE,iBAAiB,GACzB,IAAI,CA0CN"}

package/dist/output/tsv.d.ts

@@ -0,0 +1,3 @@
+import type { ColumnConfig } from "./index.js";
+export declare function formatTsv<T>(data: T, columns: ColumnConfig[]): string;
+//# sourceMappingURL=tsv.d.ts.map

package/dist/output/tsv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsv.d.ts","sourceRoot":"","sources":["../../src/output/tsv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmB/C,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAcrE"}

package/dist/output/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function getNestedValue(obj: unknown, path: string): unknown;
+export declare function formatValue(value: unknown): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/output/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/output/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAclE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYlD"}

package/dist/types/index.d.ts

@@ -0,0 +1,13 @@
+export declare const OUTPUT_FORMATS: readonly ["json", "table", "tsv", "plain"];
+export type OutputFormat = (typeof OUTPUT_FORMATS)[number];
+export interface GlobalOptions {
+    format?: OutputFormat;
+    json?: boolean;
+    quiet: boolean;
+    verbose: boolean;
+    debug: boolean;
+}
+export interface CommandContext {
+    options: GlobalOptions;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,4CAA6C,CAAC;AACzE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,aAAa,CAAC;CACxB"}

package/dist/utils/axios-interceptors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Axios interceptors for the Raindrop API client.
+ *
+ * Provides:
+ * - Request/response logging (verbose mode)
+ * - Automatic retry with exponential backoff for transient errors
+ * - Rate limit detection and RateLimitError throwing
+ * - Error transformation to ApiError
+ */
+import type { AxiosInstance, AxiosError } from "axios";
+declare const MAX_RETRIES = 3;
+declare const INITIAL_DELAY_MS = 1000;
+declare const MAX_DELAY_MS = 30000;
+/**
+ * Check if an error is retryable (transient).
+ * Retryable: network errors, 5xx server errors, 408 timeout.
+ * NOT retryable: 429 (handled separately), 4xx client errors.
+ */
+export declare function isRetryableError(error: AxiosError): boolean;
+/**
+ * Calculate exponential backoff delay with jitter.
+ * Formula: min(initialDelay * 2^retryCount + jitter, maxDelay)
+ */
+export declare function calculateBackoff(retryCount: number): number;
+/**
+ * Get the API delay from environment variable.
+ * Used to throttle requests during live tests to avoid rate limits.
+ */
+declare function getApiDelayMs(): number;
+/**
+ * Extract rate limit info from response headers.
+ */
+export declare function extractRateLimitInfo(headers: Record<string, string>): {
+    limit?: number;
+    remaining?: number;
+    reset?: number;
+};
+/**
+ * Configure Axios interceptors on a Raindrop client instance.
+ * Call this after creating the client.
+ */
+export declare function setupClientInterceptors(axiosInstance: AxiosInstance): void;
+export { MAX_RETRIES, INITIAL_DELAY_MS, MAX_DELAY_MS, getApiDelayMs };
+//# sourceMappingURL=axios-interceptors.d.ts.map

package/dist/utils/axios-interceptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axios-interceptors.d.ts","sourceRoot":"","sources":["../../src/utils/axios-interceptors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAA6C,MAAM,OAAO,CAAC;AAWlG,QAAA,MAAM,WAAW,IAAI,CAAC;AACtB,QAAA,MAAM,gBAAgB,OAAO,CAAC;AAC9B,QAAA,MAAM,YAAY,QAAQ,CAAC;AAQ3B;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAmB3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK3D;AASD;;;GAGG;AACH,iBAAS,aAAa,IAAI,MAAM,CAS/B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAQA;AA2JD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAG1E;AAGD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/utils/collections.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared utilities for collection ID parsing and special collections.
+ */
+/**
+ * Special collection IDs in Raindrop.io
+ */
+export declare const SPECIAL_COLLECTIONS: {
+    readonly all: 0;
+    readonly unsorted: -1;
+    readonly trash: -99;
+};
+export type SpecialCollectionName = keyof typeof SPECIAL_COLLECTIONS;
+/**
+ * Parse collection ID from string argument.
+ * Supports numeric IDs and special names (all, unsorted, trash).
+ */
+export declare function parseCollectionId(value: string | undefined): number;
+//# sourceMappingURL=collections.d.ts.map

package/dist/utils/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/utils/collections.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAErE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAmBnE"}

package/dist/utils/colors.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Color utilities for CLI output.
+ *
+ * Uses picocolors for terminal coloring, with automatic detection
+ * of when colors should be disabled (NO_COLOR, --no-color, non-TTY, etc).
+ *
+ * @example
+ * ```ts
+ * import { colors } from "./utils/colors.js";
+ * console.log(colors.red("Error!"));
+ * console.log(colors.bold(colors.green("Success")));
+ * ```
+ */
+type ColorFunction = (text: string | number) => string;
+interface Colors {
+    reset: ColorFunction;
+    bold: ColorFunction;
+    dim: ColorFunction;
+    italic: ColorFunction;
+    underline: ColorFunction;
+    inverse: ColorFunction;
+    hidden: ColorFunction;
+    strikethrough: ColorFunction;
+    black: ColorFunction;
+    red: ColorFunction;
+    green: ColorFunction;
+    yellow: ColorFunction;
+    blue: ColorFunction;
+    magenta: ColorFunction;
+    cyan: ColorFunction;
+    white: ColorFunction;
+    gray: ColorFunction;
+    bgBlack: ColorFunction;
+    bgRed: ColorFunction;
+    bgGreen: ColorFunction;
+    bgYellow: ColorFunction;
+    bgBlue: ColorFunction;
+    bgMagenta: ColorFunction;
+    bgCyan: ColorFunction;
+    bgWhite: ColorFunction;
+}
+/**
+ * Get the colors object, respecting NO_COLOR, --no-color, and TTY detection.
+ *
+ * Note: This checks shouldUseColor() on each call, so the --no-color flag
+ * can be set after import and will still be respected.
+ */
+export declare function getColors(): Colors;
+/**
+ * Convenience export for direct usage.
+ * Use getColors() if you need dynamic color detection after flag parsing.
+ *
+ * @example
+ * ```ts
+ * import { colors } from "./utils/colors.js";
+ * console.log(colors.red("Error"));
+ * ```
+ */
+export declare const colors: Colors;
+export {};
+//# sourceMappingURL=colors.d.ts.map

package/dist/utils/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,KAAK,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;AAEvD,UAAU,MAAM;IAEd,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC;IACpB,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;IAG7B,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE,aAAa,CAAC;IACnB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC;IAGpB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;CACxB;AAkCD;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,QAIjB,CAAC"}

package/dist/utils/command-options.d.ts

@@ -0,0 +1,15 @@
+import { Command } from "commander";
+/**
+ * Add global output options to a subcommand.
+ *
+ * Commander.js doesn't automatically make program-level options available
+ * when placed after subcommand names. This helper adds the common output
+ * options to subcommands so users can write:
+ *   rdcli bookmarks list -q
+ * instead of:
+ *   rdcli -q bookmarks list
+ *
+ * The options are still accessed via `this.optsWithGlobals()` in actions.
+ */
+export declare function addOutputOptions(cmd: Command): Command;
+//# sourceMappingURL=command-options.d.ts.map

package/dist/utils/command-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-options.d.ts","sourceRoot":"","sources":["../../src/utils/command-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAG5C;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQtD"}

package/dist/utils/debug.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Debug and verbose output utilities.
+ *
+ * Per clig.dev guidelines:
+ * - --debug: Show stack traces, internal state, detailed error info
+ * - --verbose: Show operational details (what's happening, timing, API calls)
+ *
+ * Both output to stderr to keep stdout clean for data.
+ */
+/**
+ * Set the debug flag (typically from CLI --debug option)
+ */
+export declare function setDebugEnabled(enabled: boolean): void;
+/**
+ * Set the verbose flag (typically from CLI --verbose option)
+ */
+export declare function setVerboseEnabled(enabled: boolean): void;
+/**
+ * Check if debug mode is enabled
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Check if verbose mode is enabled
+ */
+export declare function isVerboseEnabled(): boolean;
+/**
+ * Output debug information (stack traces, internal state).
+ * Only outputs when --debug flag is set.
+ */
+export declare function debug(message: string, data?: unknown): void;
+/**
+ * Output verbose operational information (API calls, timing).
+ * Only outputs when --verbose flag is set.
+ */
+export declare function verbose(message: string): void;
+/**
+ * Time an async operation and log it (verbose mode only).
+ * Returns the result of the operation.
+ */
+export declare function verboseTime<T>(label: string, operation: () => Promise<T>): Promise<T>;
+/**
+ * Reset debug/verbose state (useful for testing)
+ */
+export declare function resetDebugState(): void;
+//# sourceMappingURL=debug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAe3D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG7C;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAkB3F;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,38 @@
+export declare class RaindropCliError extends Error {
+    code: string;
+    details?: Record<string, unknown> | undefined;
+    exitCode: number;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined, exitCode?: number);
+    toJSON(): object;
+}
+export declare class UsageError extends RaindropCliError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class ConfigError extends RaindropCliError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class ApiError extends RaindropCliError {
+    statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined, details?: Record<string, unknown>);
+}
+export declare class RateLimitError extends RaindropCliError {
+    limit: number;
+    resetTime: number;
+    constructor(limit: number, resetTime: number);
+}
+export declare class TimeoutError extends RaindropCliError {
+    timeoutSeconds: number;
+    constructor(timeoutSeconds: number, details?: Record<string, unknown>);
+}
+/**
+ * Handle and output an error, then exit.
+ *
+ * When --debug is enabled:
+ * - Shows error details for RaindropCliError
+ * - Shows stack traces for all errors
+ *
+ * @param error - The error to handle
+ * @param debugOverride - Override the global debug flag (for testing)
+ */
+export declare function handleError(error: unknown, debugOverride?: boolean): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAGA,qBAAa,gBAAiB,SAAQ,KAAK;IAGhC,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjC,QAAQ;gBAHf,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA,EACjC,QAAQ,SAAI;IAMrB,MAAM,IAAI,MAAM;CAQjB;AAED,qBAAa,UAAW,SAAQ,gBAAgB;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,WAAY,SAAQ,gBAAgB;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,QAAS,SAAQ,gBAAgB;IAGnC,UAAU,CAAC,EAAE,MAAM;gBAD1B,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA,EAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKpC;AAED,qBAAa,cAAe,SAAQ,gBAAgB;IAEzC,KAAK,EAAE,MAAM;IACb,SAAS,EAAE,MAAM;gBADjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM;CAU3B;AAED,qBAAa,YAAa,SAAQ,gBAAgB;IAEvC,cAAc,EAAE,MAAM;gBAAtB,cAAc,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUpC;AA2DD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,KAAK,CAkC1E"}

package/dist/utils/help-formatter.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Styled help formatter for Commander.js
+ *
+ * Adds color and formatting to help text while respecting TTY detection
+ * and NO_COLOR environment variable. Falls back to plain text in non-TTY
+ * environments.
+ *
+ * Styling approach (conservative, per clig.dev recommendations):
+ * - Bold: Section headers (Usage:, Options:, Commands:)
+ * - Cyan: Command and subcommand names
+ * - Yellow: Option flags (-h, --help)
+ * - Dim: Metadata like defaults, choices, argument placeholders
+ */
+import { Help, Command } from "commander";
+/**
+ * Custom Help class that adds styling to Commander's help output.
+ * Uses Commander's built-in style methods for consistent formatting.
+ */
+export declare class StyledHelp extends Help {
+    /**
+     * Style section titles like "Usage:", "Options:", "Commands:"
+     */
+    styleTitle(title: string): string;
+    /**
+     * Style the usage string (the part after "Usage:")
+     * e.g., "rd bookmarks list|ls [options] [collection-id]"
+     */
+    styleUsage(str: string): string;
+    /**
+     * Style command name in usage string
+     */
+    styleCommandText(str: string): string;
+    /**
+     * Style option flags like "-h, --help" or "--format <format>"
+     * The flag part is yellow, argument placeholders are dim.
+     */
+    styleOptionText(str: string): string;
+    /**
+     * Style subcommand names in the command list
+     */
+    styleSubcommandText(str: string): string;
+    /**
+     * Style argument placeholders like "<id>" or "[collection-id]"
+     */
+    styleArgumentText(str: string): string;
+    /**
+     * Style option descriptions, dimming metadata like (default:) and (choices:)
+     */
+    styleOptionDescription(str: string): string;
+    /**
+     * Style subcommand descriptions, dimming metadata like (alias:) and (shortcut for:)
+     */
+    styleSubcommandDescription(str: string): string;
+    /**
+     * Style argument descriptions
+     */
+    styleArgumentDescription(str: string): string;
+    /**
+     * Format a list of items with a heading.
+     * Adds a blank line after the heading for better readability.
+     */
+    formatItemList(heading: string, items: string[], helper: Help): string[];
+}
+/**
+ * Configure a Command to use styled help output.
+ * Must be called on each command (including subcommands) for styling to apply.
+ *
+ * The styling automatically respects:
+ * - NO_COLOR environment variable
+ * - --no-color flag
+ * - TTY detection (no colors when piped)
+ * - TERM=dumb
+ */
+export declare function configureStyledHelp(cmd: Command): void;
+/**
+ * Recursively configure styled help on a command and all its subcommands.
+ * Call this on your root program after all commands have been added.
+ */
+export declare function configureStyledHelpRecursive(program: Command): void;
+//# sourceMappingURL=help-formatter.d.ts.map

package/dist/utils/help-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/help-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C;;;GAGG;AACH,qBAAa,UAAW,SAAQ,IAAI;IAClC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIjC;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IA2B/B;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIrC;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAepC;;OAEG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIxC;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAItC;;OAEG;IACH,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI/C;;OAEG;IACH,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI7C;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,GAAG,MAAM,EAAE;CAKzE;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAEtD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAKnE"}

package/dist/utils/output-streams.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Semantic output utilities for proper stdout/stderr separation.
+ *
+ * Per clig.dev guidelines:
+ * - stdout: primary output, machine-readable data
+ * - stderr: log messages, errors, warnings, progress
+ *
+ * This enables proper piping (e.g., `rd raindrops list | jq`).
+ */
+/**
+ * Output data to stdout. Use for primary output that may be piped.
+ * Examples: JSON data, table output, IDs in quiet mode
+ */
+export declare function outputData(message: string): void;
+/**
+ * Output a message to stderr. Use for informational/status messages.
+ * Examples: "Validating token...", "Token saved successfully!"
+ */
+export declare function outputMessage(message: string): void;
+/**
+ * Output an error to stderr. Use for errors and warnings.
+ * Examples: "Invalid token", "Warning: Rate limit approaching"
+ */
+export declare function outputError(message: string): void;
+/**
+ * Output data without trailing newline. Use for partial output.
+ * TODO: Currently unused - reserved for future streaming output (rd-8o9)
+ */
+export declare function outputDataRaw(message: string): void;
+/**
+ * Output message without trailing newline. Use for progress/spinners.
+ * TODO: Currently unused - reserved for future progress indicators (rd-8o9)
+ */
+export declare function outputMessageRaw(message: string): void;
+//# sourceMappingURL=output-streams.d.ts.map

package/dist/utils/output-streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-streams.d.ts","sourceRoot":"","sources":["../../src/utils/output-streams.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEtD"}

package/dist/utils/pagination.d.ts

@@ -0,0 +1,13 @@
+export interface PaginationOptions {
+    page?: number;
+    perPage?: number;
+}
+export interface PaginatedResult<T> {
+    items: T[];
+    count: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+}
+export declare function createPaginatedResult<T>(items: T[], count: number, page: number, perPage: number): PaginatedResult<T>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,eAAe,CAAC,CAAC,CAAC,CAQpB"}

package/dist/utils/progress.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Combined progress utility that provides both verbose timing and spinner feedback.
+ *
+ * This combines the behavior of verboseTime (for --verbose mode) and withSpinner
+ * (for interactive terminal feedback) into a single, unified API.
+ *
+ * Behavior:
+ * - Verbose mode: Shows timing information (via verboseTime)
+ * - Normal TTY mode: Shows spinner (via withSpinner)
+ * - Non-TTY mode: Silent execution
+ */
+/**
+ * Execute an async operation with appropriate progress feedback.
+ *
+ * In verbose mode, shows timing information.
+ * In normal TTY mode, shows a spinner.
+ * In non-TTY mode (piped/scripted), runs silently.
+ *
+ * @param message - Message describing the operation (shown in spinner and verbose output)
+ * @param operation - Async operation to execute
+ * @returns The result of the operation
+ *
+ * @example
+ * const response = await withProgress("Fetching bookmarks", () =>
+ *   client.raindrop.getRaindrops(collectionId)
+ * );
+ */
+export declare function withProgress<T>(message: string, operation: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=progress.d.ts.map

package/dist/utils/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAK9F"}

package/dist/utils/prompt.d.ts

@@ -0,0 +1,32 @@
+import type { Interface as ReadlineInterface } from "node:readline";
+import { UsageError } from "./errors.js";
+/**
+ * Error thrown when attempting to prompt in a non-interactive context.
+ * Extends UsageError because it's a usage issue (user needs --force in non-interactive mode).
+ */
+export declare class NonInteractiveError extends UsageError {
+    constructor(message: string);
+}
+/**
+ * Check if stdin is a TTY (interactive terminal).
+ * Returns false when input is piped or redirected.
+ */
+export declare function isStdinTTY(): boolean;
+/**
+ * Options for confirmAction, primarily for testing.
+ */
+export interface ConfirmActionOptions {
+    /** Custom readline interface (for testing) */
+    rl?: ReadlineInterface;
+    /** Skip TTY check (for testing) */
+    skipTTYCheck?: boolean;
+}
+/**
+ * Prompt the user for confirmation.
+ * Returns true if the user enters 'y', 'yes', 'Y', or 'YES', false otherwise.
+ * Returns false if the user sends EOF (Ctrl+D).
+ *
+ * @throws {NonInteractiveError} if stdin is not a TTY (non-interactive context)
+ */
+export declare function confirmAction(message: string, options?: ConfirmActionOptions): Promise<boolean>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/utils/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,EAAE,CAAC,EAAE,iBAAiB,CAAC;IACvB,mCAAmC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,OAAO,CAAC,CAkClB"}