rd-mini 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Raindrop - Zero-config AI Observability SDK
+ *
+ * @example
+ * ```typescript
+ * import { Raindrop } from 'raindrop';
+ * import OpenAI from 'openai';
+ *
+ * const raindrop = new Raindrop({ apiKey: process.env.RAINDROP_API_KEY });
+ * const openai = raindrop.wrap(new OpenAI());
+ *
+ * // All calls are now automatically traced
+ * const response = await openai.chat.completions.create({
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ *
+ * console.log(response._traceId); // Access trace ID for feedback
+ * ```
+ */
+export { Raindrop, Interaction } from './raindrop.js';
+export type { RaindropConfig, UserTraits, FeedbackOptions, RaindropRequestOptions, WithTraceId, InteractionOptions, InteractionContext, WrapToolOptions, BeginOptions, FinishOptions, Attachment, } from './types.js';
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * Raindrop - Zero-config AI Observability SDK
+ *
+ * @example
+ * ```typescript
+ * import { Raindrop } from 'raindrop';
+ * import OpenAI from 'openai';
+ *
+ * const raindrop = new Raindrop({ apiKey: process.env.RAINDROP_API_KEY });
+ * const openai = raindrop.wrap(new OpenAI());
+ *
+ * // All calls are now automatically traced
+ * const response = await openai.chat.completions.create({
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ *
+ * console.log(response._traceId); // Access trace ID for feedback
+ * ```
+ */
+export { Raindrop, Interaction } from './raindrop.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/raindrop.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Raindrop - Zero-config AI Observability SDK
+ *
+ * Usage:
+ *   const raindrop = new Raindrop({ apiKey: process.env.RAINDROP_API_KEY });
+ *   const openai = raindrop.wrap(new OpenAI());
+ *   // All calls are now automatically traced
+ *
+ * Multi-step pipelines:
+ *   await raindrop.withInteraction({ userId, event: 'rag_query' }, async () => {
+ *     const docs = await searchDocs(query);  // Auto-linked
+ *     const response = await openai.chat.completions.create(...);  // Auto-linked
+ *   });
+ */
+import type { RaindropConfig, UserTraits, FeedbackOptions, RaindropRequestOptions, InteractionOptions, InteractionContext, WrapToolOptions, BeginOptions, FinishOptions, Attachment } from './types.js';
+/**
+ * Interaction object returned by begin()
+ * Allows manual control over interaction lifecycle
+ */
+export declare class Interaction {
+    private context;
+    private raindrop;
+    private finished;
+    constructor(context: InteractionContext, raindrop: Raindrop);
+    /** Get the interaction/event ID */
+    get id(): string;
+    /** Get or set the output */
+    get output(): string | undefined;
+    set output(value: string | undefined);
+    /** Set a single property */
+    setProperty(key: string, value: unknown): this;
+    /** Merge multiple properties */
+    setProperties(props: Record<string, unknown>): this;
+    /** Add attachments */
+    addAttachments(attachments: Attachment[]): this;
+    /** Set the input */
+    setInput(input: string): this;
+    /** Get the underlying context (for internal use) */
+    getContext(): InteractionContext;
+    /**
+     * Finish the interaction and send to Raindrop
+     */
+    finish(options?: FinishOptions): void;
+}
+export declare class Raindrop {
+    private config;
+    private transport;
+    private currentUserId?;
+    private _currentUserTraits?;
+    private lastTraceId?;
+    private activeInteractions;
+    constructor(config: RaindropConfig);
+    /**
+     * Wrap an AI client or model to auto-trace all calls
+     *
+     * Supports:
+     * - OpenAI client: raindrop.wrap(new OpenAI())
+     * - Anthropic client: raindrop.wrap(new Anthropic())
+     * - Vercel AI SDK model: raindrop.wrap(openai('gpt-4o'))
+     */
+    wrap<T>(client: T, options?: RaindropRequestOptions): T;
+    /**
+     * Identify a user for all subsequent calls
+     */
+    identify(userId: string, traits?: UserTraits): void;
+    /**
+     * Send feedback for a specific trace
+     */
+    feedback(traceId: string, options: FeedbackOptions): Promise<void>;
+    /**
+     * Start an interaction manually (escape hatch for complex flows)
+     *
+     * For simple cases, use withInteraction() instead.
+     * Use begin() when you need to start and finish in different places.
+     *
+     * @example
+     * const interaction = raindrop.begin({
+     *   userId: 'user123',
+     *   event: 'chat_message',
+     *   input: 'What is X?',
+     * });
+     *
+     * // ... later, maybe in a different function
+     * interaction.finish({ output: 'X is...' });
+     */
+    begin(options?: BeginOptions): Interaction;
+    /**
+     * Resume an existing interaction by ID
+     *
+     * @example
+     * const interaction = raindrop.resumeInteraction(eventId);
+     * interaction.finish({ output: 'Done!' });
+     */
+    resumeInteraction(eventId: string): Interaction;
+    /**
+     * Internal: Called by Interaction.finish()
+     * @internal
+     */
+    _finishInteraction(context: InteractionContext): void;
+    /**
+     * Get the last trace ID (useful if you can't access _traceId on response)
+     */
+    getLastTraceId(): string | undefined;
+    /**
+     * Get the current user's traits (set via identify)
+     */
+    getUserTraits(): UserTraits | undefined;
+    /**
+     * Flush all pending events and close
+     */
+    close(): Promise<void>;
+    /**
+     * Run code within an interaction context
+     * All wrapped clients and tools called within will be auto-linked
+     *
+     * @example
+     * await raindrop.withInteraction(
+     *   { userId: 'user123', event: 'rag_query', input: 'What is X?' },
+     *   async (ctx) => {
+     *     const docs = await searchDocs(query);  // Auto-linked
+     *     const response = await openai.chat.completions.create(...);  // Auto-linked
+     *     ctx.output = response.choices[0].message.content;  // Set output
+     *   }
+     * );
+     */
+    withInteraction<T>(options: InteractionOptions, fn: (ctx: InteractionContext) => Promise<T>): Promise<T>;
+    /**
+     * Wrap a tool function for automatic tracing
+     * When called within withInteraction(), the tool will be auto-linked
+     *
+     * @example
+     * const searchDocs = raindrop.wrapTool('search_docs', async (query: string) => {
+     *   return await vectorDb.search(query);
+     * });
+     *
+     * // Use normally
+     * const docs = await searchDocs('how to use raindrop');
+     */
+    wrapTool<TArgs extends unknown[], TResult>(name: string, fn: (...args: TArgs) => Promise<TResult>, options?: WrapToolOptions): (...args: TArgs) => Promise<TResult>;
+    /**
+     * Get the current interaction context (if any)
+     * Useful for wrappers to check if they're within an interaction
+     */
+    getInteractionContext(): InteractionContext | undefined;
+    /**
+     * Internal: Send an interaction with all its spans
+     */
+    private sendInteraction;
+    /**
+     * Internal: Send a standalone tool trace
+     */
+    private sendToolTrace;
+    /**
+     * Internal: Send a trace
+     */
+    private sendTrace;
+    /**
+     * Internal: Generate a unique trace ID
+     */
+    private generateTraceId;
+    /**
+     * Internal: Detect the provider type from a client/model
+     */
+    private detectProvider;
+}
+//# sourceMappingURL=raindrop.d.ts.map

package/dist/raindrop.d.ts.map

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