teckel-ai 0.3.3 → 0.3.5

package/dist/index.d.ts

@@ -1,10 +1,389 @@
+import { z } from 'zod';
+
 /**
- * teckel-ai v0.3.3
- * Simple SDK for AI conversation tracking and RAG observability
+ * Type definitions for teckel-ai SDK v0.3.5
+ * Simple, clean types matching existing database schema
+ */
+/**
+ * SDK Configuration
+ */
+interface TeckelConfig {
+    apiKey: string;
+    endpoint?: string;
+    debug?: boolean;
+    timeoutMs?: number;
+}
+/**
+ * Conversation options
+ * sessionRef IS the conversation identifier
  *
- * @packageDocumentation
+ * Naming convention:
+ * - *Ref = Client-provided identifier (TEXT)
+ * - *Id = Server-generated internal ID (UUID)
+ */
+interface ConversationOptions {
+    sessionRef?: string;
+    userRef?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Document structure for RAG systems
+ * Matches existing documents + chunk_events schema
+ */
+interface Document {
+    documentRef: string;
+    documentName: string;
+    documentText: string;
+    documentLastUpdated?: string;
+    sourceUri?: string;
+    sourceType?: string;
+    similarity?: number;
+    rank?: number;
+    ownerEmail?: string;
+    documentType?: string;
+}
+/**
+ * Token usage tracking
+ */
+interface TokenUsage {
+    prompt: number;
+    completion: number;
+    total: number;
+}
+/**
+ * Trace data for a single query-response interaction
+ * Matches existing traces table schema
+ */
+interface TraceData {
+    query: string;
+    response: string;
+    model?: string;
+    responseTimeMs?: number;
+    documents?: Document[];
+    tokens?: TokenUsage;
+    metadata?: Record<string, unknown>;
+    traceRef?: string;
+    userRef?: string;
+}
+/**
+ * Feedback types
+ */
+type FeedbackType = 'thumbs_up' | 'thumbs_down' | 'flag' | 'rating';
+/**
+ * User feedback signal
+ */
+interface FeedbackData {
+    type: FeedbackType;
+    value?: string;
+    comment?: string;
+    traceRef?: string;
+}
+/**
+ * Result returned when a trace is created
+ */
+interface TraceResult {
+    traceRef: string;
+    turnNumber: number;
+}
+
+/**
+ * Conversation class for teckel-ai SDK v0.3.5
+ * Manages a single conversation with fire-and-forget semantics
+ */
+
+/** Internal type - sessionRef is guaranteed by TeckelTracer.start() */
+interface ResolvedConversationOptions extends ConversationOptions {
+    sessionRef: string;
+}
+declare class Conversation {
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly sessionRef;
+    private readonly userRef?;
+    private readonly metadata?;
+    private readonly startedAt;
+    private readonly debug;
+    private readonly timeoutMs;
+    private turnCount;
+    private startPromise;
+    private sendQueue;
+    constructor(apiKey: string, endpoint: string, options: ResolvedConversationOptions, debug?: boolean, extras?: {
+        timeoutMs: number;
+    });
+    /**
+     * Record a trace (single query-response interaction)
+     * Fire-and-forget by default - never blocks
+     * For serverless, call flush() before function termination
+     */
+    trace(data: TraceData): TraceResult | void;
+    /**
+     * Add user feedback signal
+     * Never throws - gracefully handles errors
+     */
+    feedback(data: FeedbackData): Promise<void>;
+    /**
+     * End the conversation
+     * Flushes all pending traces before sending end signal
+     * Never throws - gracefully handles errors
+     */
+    end(): Promise<void>;
+    /**
+     * Read-only properties
+     */
+    get id(): string;
+    get turns(): number;
+    get started(): Date;
+    private fetchWithRetry;
+    private _startConversation;
+    private _sendTrace;
+    private _sendFeedback;
+    private _endConversation;
+    private enqueueSend;
+    /**
+     * Flush queued sends with a bounded timeout.
+     * Returns when the queue is empty or the timeout elapses (whichever comes first).
+     */
+    flush(timeoutMs?: number): Promise<void>;
+}
+
+/**
+ * TeckelTracer - Main SDK class for teckel-ai v0.3.5
+ * Simple, lightweight SDK for AI conversation tracking
+ */
+
+declare class TeckelTracer {
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly debug;
+    private readonly timeoutMs;
+    constructor(config: TeckelConfig);
+    /**
+     * Start a new conversation
+     * sessionRef IS the public conversation identifier
+     * If not provided, auto-generates one as 'auto:{8-char-uuid}'
+     */
+    start(options?: ConversationOptions): Conversation;
+}
+
+/**
+ * Zod validation schemas for teckel-ai SDK v0.3.5
+ */
+
+/**
+ * Document schema
+ */
+declare const DocumentSchema: z.ZodObject<{
+    documentRef: z.ZodString;
+    documentName: z.ZodString;
+    documentText: z.ZodString;
+    documentLastUpdated: z.ZodOptional<z.ZodString>;
+    sourceUri: z.ZodOptional<z.ZodString>;
+    sourceType: z.ZodOptional<z.ZodString>;
+    similarity: z.ZodOptional<z.ZodNumber>;
+    rank: z.ZodOptional<z.ZodNumber>;
+    ownerEmail: z.ZodOptional<z.ZodString>;
+    documentType: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    documentRef: string;
+    documentName: string;
+    documentText: string;
+    documentLastUpdated?: string | undefined;
+    sourceUri?: string | undefined;
+    sourceType?: string | undefined;
+    similarity?: number | undefined;
+    rank?: number | undefined;
+    ownerEmail?: string | undefined;
+    documentType?: string | undefined;
+}, {
+    documentRef: string;
+    documentName: string;
+    documentText: string;
+    documentLastUpdated?: string | undefined;
+    sourceUri?: string | undefined;
+    sourceType?: string | undefined;
+    similarity?: number | undefined;
+    rank?: number | undefined;
+    ownerEmail?: string | undefined;
+    documentType?: string | undefined;
+}>;
+/**
+ * Token usage schema
+ */
+declare const TokenUsageSchema: z.ZodObject<{
+    prompt: z.ZodNumber;
+    completion: z.ZodNumber;
+    total: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    prompt: number;
+    completion: number;
+    total: number;
+}, {
+    prompt: number;
+    completion: number;
+    total: number;
+}>;
+/**
+ * Trace data schema
+ */
+declare const TraceDataSchema: z.ZodObject<{
+    query: z.ZodString;
+    response: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    responseTimeMs: z.ZodOptional<z.ZodNumber>;
+    documents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        documentRef: z.ZodString;
+        documentName: z.ZodString;
+        documentText: z.ZodString;
+        documentLastUpdated: z.ZodOptional<z.ZodString>;
+        sourceUri: z.ZodOptional<z.ZodString>;
+        sourceType: z.ZodOptional<z.ZodString>;
+        similarity: z.ZodOptional<z.ZodNumber>;
+        rank: z.ZodOptional<z.ZodNumber>;
+        ownerEmail: z.ZodOptional<z.ZodString>;
+        documentType: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        documentRef: string;
+        documentName: string;
+        documentText: string;
+        documentLastUpdated?: string | undefined;
+        sourceUri?: string | undefined;
+        sourceType?: string | undefined;
+        similarity?: number | undefined;
+        rank?: number | undefined;
+        ownerEmail?: string | undefined;
+        documentType?: string | undefined;
+    }, {
+        documentRef: string;
+        documentName: string;
+        documentText: string;
+        documentLastUpdated?: string | undefined;
+        sourceUri?: string | undefined;
+        sourceType?: string | undefined;
+        similarity?: number | undefined;
+        rank?: number | undefined;
+        ownerEmail?: string | undefined;
+        documentType?: string | undefined;
+    }>, "many">>;
+    tokens: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodNumber;
+        completion: z.ZodNumber;
+        total: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        prompt: number;
+        completion: number;
+        total: number;
+    }, {
+        prompt: number;
+        completion: number;
+        total: number;
+    }>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    traceRef: z.ZodOptional<z.ZodString>;
+    userRef: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    response: string;
+    model?: string | undefined;
+    responseTimeMs?: number | undefined;
+    documents?: {
+        documentRef: string;
+        documentName: string;
+        documentText: string;
+        documentLastUpdated?: string | undefined;
+        sourceUri?: string | undefined;
+        sourceType?: string | undefined;
+        similarity?: number | undefined;
+        rank?: number | undefined;
+        ownerEmail?: string | undefined;
+        documentType?: string | undefined;
+    }[] | undefined;
+    tokens?: {
+        prompt: number;
+        completion: number;
+        total: number;
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    traceRef?: string | undefined;
+    userRef?: string | undefined;
+}, {
+    query: string;
+    response: string;
+    model?: string | undefined;
+    responseTimeMs?: number | undefined;
+    documents?: {
+        documentRef: string;
+        documentName: string;
+        documentText: string;
+        documentLastUpdated?: string | undefined;
+        sourceUri?: string | undefined;
+        sourceType?: string | undefined;
+        similarity?: number | undefined;
+        rank?: number | undefined;
+        ownerEmail?: string | undefined;
+        documentType?: string | undefined;
+    }[] | undefined;
+    tokens?: {
+        prompt: number;
+        completion: number;
+        total: number;
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    traceRef?: string | undefined;
+    userRef?: string | undefined;
+}>;
+/**
+ * Conversation options schema
+ */
+declare const ConversationOptionsSchema: z.ZodObject<{
+    sessionRef: z.ZodOptional<z.ZodString>;
+    userRef: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    metadata?: Record<string, unknown> | undefined;
+    userRef?: string | undefined;
+    sessionRef?: string | undefined;
+}, {
+    metadata?: Record<string, unknown> | undefined;
+    userRef?: string | undefined;
+    sessionRef?: string | undefined;
+}>;
+/**
+ * Feedback data schema
+ */
+declare const FeedbackDataSchema: z.ZodObject<{
+    type: z.ZodEnum<["thumbs_up", "thumbs_down", "flag", "rating"]>;
+    value: z.ZodOptional<z.ZodString>;
+    comment: z.ZodOptional<z.ZodString>;
+    traceRef: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "thumbs_up" | "thumbs_down" | "flag" | "rating";
+    value?: string | undefined;
+    traceRef?: string | undefined;
+    comment?: string | undefined;
+}, {
+    type: "thumbs_up" | "thumbs_down" | "flag" | "rating";
+    value?: string | undefined;
+    traceRef?: string | undefined;
+    comment?: string | undefined;
+}>;
+/**
+ * Config schema
  */
-export { TeckelTracer } from './tracer';
-export { Conversation } from './conversation';
-export type { TeckelConfig, ConversationOptions, TraceData, Document, TokenUsage, FeedbackData, FeedbackType, ValidationResult, TraceResult } from './types';
-export { TeckelConfigSchema, ConversationOptionsSchema, TraceDataSchema, DocumentSchema, TokenUsageSchema, FeedbackDataSchema } from './schemas';
+declare const TeckelConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    endpoint: z.ZodOptional<z.ZodString>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    apiKey: string;
+    endpoint?: string | undefined;
+    debug?: boolean | undefined;
+    timeoutMs?: number | undefined;
+}, {
+    apiKey: string;
+    endpoint?: string | undefined;
+    debug?: boolean | undefined;
+    timeoutMs?: number | undefined;
+}>;
+
+export { Conversation, type ConversationOptions, ConversationOptionsSchema, type Document, DocumentSchema, type FeedbackData, FeedbackDataSchema, type FeedbackType, type TeckelConfig, TeckelConfigSchema, TeckelTracer, type TokenUsage, TokenUsageSchema, type TraceData, TraceDataSchema, type TraceResult };

package/dist/index.js

@@ -1,22 +1,2 @@
-"use strict";
-/**
- * teckel-ai v0.3.3
- * Simple SDK for AI conversation tracking and RAG observability
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FeedbackDataSchema = exports.TokenUsageSchema = exports.DocumentSchema = exports.TraceDataSchema = exports.ConversationOptionsSchema = exports.TeckelConfigSchema = exports.Conversation = exports.TeckelTracer = void 0;
-// Main SDK exports
-var tracer_1 = require("./tracer");
-Object.defineProperty(exports, "TeckelTracer", { enumerable: true, get: function () { return tracer_1.TeckelTracer; } });
-var conversation_1 = require("./conversation");
-Object.defineProperty(exports, "Conversation", { enumerable: true, get: function () { return conversation_1.Conversation; } });
-// Schema exports (for advanced use cases)
-var schemas_1 = require("./schemas");
-Object.defineProperty(exports, "TeckelConfigSchema", { enumerable: true, get: function () { return schemas_1.TeckelConfigSchema; } });
-Object.defineProperty(exports, "ConversationOptionsSchema", { enumerable: true, get: function () { return schemas_1.ConversationOptionsSchema; } });
-Object.defineProperty(exports, "TraceDataSchema", { enumerable: true, get: function () { return schemas_1.TraceDataSchema; } });
-Object.defineProperty(exports, "DocumentSchema", { enumerable: true, get: function () { return schemas_1.DocumentSchema; } });
-Object.defineProperty(exports, "TokenUsageSchema", { enumerable: true, get: function () { return schemas_1.TokenUsageSchema; } });
-Object.defineProperty(exports, "FeedbackDataSchema", { enumerable: true, get: function () { return schemas_1.FeedbackDataSchema; } });
+'use strict';var zod=require('zod');var y=zod.z.object({documentRef:zod.z.string().min(1,"documentRef is required"),documentName:zod.z.string().min(1,"documentName is required"),documentText:zod.z.string().min(1,"documentText is required"),documentLastUpdated:zod.z.string().optional(),sourceUri:zod.z.string().optional(),sourceType:zod.z.string().optional(),similarity:zod.z.number().min(0).max(1).optional(),rank:zod.z.number().int().nonnegative().optional(),ownerEmail:zod.z.string().email().optional(),documentType:zod.z.string().optional()}),b=zod.z.object({prompt:zod.z.number().int().nonnegative(),completion:zod.z.number().int().nonnegative(),total:zod.z.number().int().nonnegative()}),l=zod.z.object({query:zod.z.string().min(1,"query is required").max(1e4,"query too long (max 10,000 characters)"),response:zod.z.string().min(1,"response is required").max(5e4,"response too long (max 50,000 characters)"),model:zod.z.string().optional(),responseTimeMs:zod.z.number().nonnegative().optional(),documents:zod.z.array(y).max(50,"Too many documents (max 50)").optional(),tokens:b.optional(),metadata:zod.z.record(zod.z.string(),zod.z.unknown()).optional(),traceRef:zod.z.string().min(1).optional(),userRef:zod.z.string().min(1).optional()}),h=zod.z.object({sessionRef:zod.z.string().min(1).optional(),userRef:zod.z.string().optional(),metadata:zod.z.record(zod.z.string(),zod.z.unknown()).optional()}),p=zod.z.object({type:zod.z.enum(["thumbs_up","thumbs_down","flag","rating"]),value:zod.z.string().optional(),comment:zod.z.string().optional(),traceRef:zod.z.string().optional()}),f=zod.z.object({apiKey:zod.z.string().min(1,"apiKey is required"),endpoint:zod.z.string().url().optional(),debug:zod.z.boolean().optional(),timeoutMs:zod.z.number().int().positive().max(6e4).optional()});var u=class{constructor(n,e,s,o=false,a={timeoutMs:5e3}){this.turnCount=0;this.sendQueue=Promise.resolve();this.apiKey=n,this.endpoint=e,this.sessionRef=s.sessionRef,this.userRef=s.userRef,this.metadata=s.metadata,this.startedAt=new Date,this.debug=o,this.timeoutMs=a.timeoutMs,this.debug&&console.log("[Teckel] Conversation started:",{sessionRef:this.sessionRef,userRef:this.userRef}),this.startPromise=this._startConversation().catch(i=>{this.debug&&console.warn("[Teckel] Start failed:",i.message);});}trace(n){try{let e=l.parse(n),s=++this.turnCount,o=e.traceRef&&e.traceRef.length>0?e.traceRef:`${this.sessionRef}:${s}`;this.debug&&console.log("[Teckel] Queueing trace:",{sessionRef:this.sessionRef,turnNumber:s,queryLength:e.query.length,responseLength:e.response.length,documentCount:e.documents?.length||0});let a={...e,traceRef:o,userRef:e.userRef||this.userRef};return this.enqueueSend(async()=>{try{await this.startPromise,await this._sendTrace(a);}catch(i){if(this.debug){let d=i instanceof Error?i.message:String(i);console.warn("[Teckel] Trace send failed (non-blocking):",d);}}}),{traceRef:o,turnNumber:s}}catch(e){this.debug&&console.warn("[Teckel] Invalid trace data:",e);}}async feedback(n){try{let e=p.parse(n);this.debug&&console.log("[Teckel] Sending feedback:",{sessionRef:this.sessionRef,type:e.type}),this.enqueueSend(async()=>{try{await this._sendFeedback(e);}catch(s){if(this.debug){let o=s instanceof Error?s.message:String(s);console.warn("[Teckel] Feedback failed:",o);}}});}catch(e){this.debug&&console.warn("[Teckel] Invalid feedback data:",e);}}async end(){let n=Date.now()-this.startedAt.getTime();this.debug&&console.log("[Teckel] Ending conversation:",{sessionRef:this.sessionRef,durationMs:n,turnCount:this.turnCount}),this.enqueueSend(async()=>{try{await this._endConversation(n);}catch(e){if(this.debug){let s=e instanceof Error?e.message:String(e);console.warn("[Teckel] End failed:",s);}}}),await this.flush();}get id(){return this.sessionRef}get turns(){return this.turnCount}get started(){return this.startedAt}async fetchWithRetry(n,e,s){let o=s?.retries??1,a=s?.retryDelayMs??250,i=0,d=r=>new Promise(T=>setTimeout(T,r));for(;;)try{let r=await fetch(n,e);if(!r.ok&&(r.status===429||r.status>=500&&r.status<=599)&&i<o){i++,this.debug&&console.warn("[Teckel] HTTP retry",{url:n,status:r.status,attempt:i}),await d(a+Math.floor(Math.random()*100));continue}return r}catch(r){if(i<o){i++,this.debug&&console.warn("[Teckel] Network retry",{url:n,attempt:i,error:r instanceof Error?r.message:String(r)}),await d(a+Math.floor(Math.random()*100));continue}throw r}}async _startConversation(){let n=await this.fetchWithRetry(`${this.endpoint}/conversations`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},keepalive:true,signal:m(this.timeoutMs),body:JSON.stringify({sessionRef:this.sessionRef,userRef:this.userRef,metadata:this.metadata})},{retries:1,retryDelayMs:300});if(!n.ok)throw new Error(`HTTP ${n.status}: ${n.statusText}`)}async _sendTrace(n,e){let s=await this.fetchWithRetry(`${this.endpoint}/conversations/${this.sessionRef}/traces`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},keepalive:true,signal:m(e?.timeoutMs??this.timeoutMs),body:JSON.stringify(n)},{retries:1,retryDelayMs:300});if(!s.ok)throw new Error(`HTTP ${s.status}: ${s.statusText}`);return await s.json()}async _sendFeedback(n){let e=await this.fetchWithRetry(`${this.endpoint}/conversations/${this.sessionRef}/feedback`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},keepalive:true,signal:m(this.timeoutMs),body:JSON.stringify(n)},{retries:1,retryDelayMs:300});if(!e.ok)throw new Error(`HTTP ${e.status}: ${e.statusText}`)}async _endConversation(n){let e=await this.fetchWithRetry(`${this.endpoint}/conversations/${this.sessionRef}`,{method:"PATCH",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},keepalive:true,signal:m(this.timeoutMs),body:JSON.stringify({durationMs:n,turnCount:this.turnCount})},{retries:1,retryDelayMs:300});if(!e.ok)throw new Error(`HTTP ${e.status}: ${e.statusText}`)}enqueueSend(n){this.sendQueue=this.sendQueue.then(()=>n()).catch(()=>{});}async flush(n){let e=typeof n=="number"&&Number.isFinite(n)&&n>=0?n:this.timeoutMs,s=this.sendQueue.catch(()=>{}),o;try{await Promise.race([s,new Promise((a,i)=>{o=setTimeout(()=>i(new Error("Flush timeout")),e);})]);}catch(a){if(this.debug){let i=a instanceof Error?a.message:String(a);console.warn("[Teckel] Flush incomplete:",i);}throw a}finally{o&&clearTimeout(o);}}};function m(c){if(!(typeof c!="number"||c<=0)&&typeof AbortSignal.timeout=="function")return AbortSignal.timeout(c)}var g=class{constructor(n){let e=f.parse(n);e.apiKey.startsWith("tk_live_")||console.warn('[Teckel] API key should start with "tk_live_". Current key: '+e.apiKey.substring(0,10)+"..."),this.apiKey=e.apiKey,this.endpoint=e.endpoint||"https://app.teckel.ai/api",this.debug=e.debug||false,this.timeoutMs=typeof e.timeoutMs=="number"?e.timeoutMs:5e3,this.debug&&console.log("[Teckel] SDK initialized:",{endpoint:this.endpoint,version:"0.3.5",timeoutMs:this.timeoutMs});}start(n={}){let e=h.parse(n),s=e.sessionRef||`auto:${crypto.randomUUID().slice(0,8)}`;return new u(this.apiKey,this.endpoint,{...e,sessionRef:s},this.debug,{timeoutMs:this.timeoutMs})}};
+exports.Conversation=u;exports.ConversationOptionsSchema=h;exports.DocumentSchema=y;exports.FeedbackDataSchema=p;exports.TeckelConfigSchema=f;exports.TeckelTracer=g;exports.TokenUsageSchema=b;exports.TraceDataSchema=l;

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import {z}from'zod';var y=z.object({documentRef:z.string().min(1,"documentRef is required"),documentName:z.string().min(1,"documentName is required"),documentText:z.string().min(1,"documentText is required"),documentLastUpdated:z.string().optional(),sourceUri:z.string().optional(),sourceType:z.string().optional(),similarity:z.number().min(0).max(1).optional(),rank:z.number().int().nonnegative().optional(),ownerEmail:z.string().email().optional(),documentType:z.string().optional()}),b=z.object({prompt:z.number().int().nonnegative(),completion:z.number().int().nonnegative(),total:z.number().int().nonnegative()}),l=z.object({query:z.string().min(1,"query is required").max(1e4,"query too long (max 10,000 characters)"),response:z.string().min(1,"response is required").max(5e4,"response too long (max 50,000 characters)"),model:z.string().optional(),responseTimeMs:z.number().nonnegative().optional(),documents:z.array(y).max(50,"Too many documents (max 50)").optional(),tokens:b.optional(),metadata:z.record(z.string(),z.unknown()).optional(),traceRef:z.string().min(1).optional(),userRef:z.string().min(1).optional()}),h=z.object({sessionRef:z.string().min(1).optional(),userRef:z.string().optional(),metadata:z.record(z.string(),z.unknown()).optional()}),p=z.object({type:z.enum(["thumbs_up","thumbs_down","flag","rating"]),value:z.string().optional(),comment:z.string().optional(),traceRef:z.string().optional()}),f=z.object({apiKey:z.string().min(1,"apiKey is required"),endpoint:z.string().url().optional(),debug:z.boolean().optional(),timeoutMs:z.number().int().positive().max(6e4).optional()});var u=class{constructor(n,e,s,o=false,a={timeoutMs:5e3}){this.turnCount=0;this.sendQueue=Promise.resolve();this.apiKey=n,this.endpoint=e,this.sessionRef=s.sessionRef,this.userRef=s.userRef,this.metadata=s.metadata,this.startedAt=new Date,this.debug=o,this.timeoutMs=a.timeoutMs,this.debug&&console.log("[Teckel] Conversation started:",{sessionRef:this.sessionRef,userRef:this.userRef}),this.startPromise=this._startConversation().catch(i=>{this.debug&&console.warn("[Teckel] Start failed:",i.message);});}trace(n){try{let e=l.parse(n),s=++this.turnCount,o=e.traceRef&&e.traceRef.length>0?e.traceRef:`${this.sessionRef}:${s}`;this.debug&&console.log("[Teckel] Queueing trace:",{sessionRef:this.sessionRef,turnNumber:s,queryLength:e.query.length,responseLength:e.response.length,documentCount:e.documents?.length||0});let a={...e,traceRef:o,userRef:e.userRef||this.userRef};return this.enqueueSend(async()=>{try{await this.startPromise,await this._sendTrace(a);}catch(i){if(this.debug){let d=i instanceof Error?i.message:String(i);console.warn("[Teckel] Trace send failed (non-blocking):",d);}}}),{traceRef:o,turnNumber:s}}catch(e){this.debug&&console.warn("[Teckel] Invalid trace data:",e);}}async feedback(n){try{let e=p.parse(n);this.debug&&console.log("[Teckel] Sending feedback:",{sessionRef:this.sessionRef,type:e.type}),this.enqueueSend(async()=>{try{await this._sendFeedback(e);}catch(s){if(this.debug){let o=s instanceof Error?s.message:String(s);console.warn("[Teckel] Feedback failed:",o);}}});}catch(e){this.debug&&console.warn("[Teckel] Invalid feedback data:",e);}}async end(){let n=Date.now()-this.startedAt.getTime();this.debug&&console.log("[Teckel] Ending conversation:",{sessionRef:this.sessionRef,durationMs:n,turnCount:this.turnCount}),this.enqueueSend(async()=>{try{await this._endConversation(n);}catch(e){if(this.debug){let s=e instanceof Error?e.message:String(e);console.warn("[Teckel] End failed:",s);}}}),await this.flush();}get id(){return this.sessionRef}get turns(){return this.turnCount}get started(){return this.startedAt}async fetchWithRetry(n,e,s){let o=s?.retries??1,a=s?.retryDelayMs??250,i=0,d=r=>new Promise(T=>setTimeout(T,r));for(;;)try{let r=await fetch(n,e);if(!r.ok&&(r.status===429||r.status>=500&&r.status<=599)&&i<o){i++,this.debug&&console.warn("[Teckel] HTTP retry",{url:n,status:r.status,attempt:i}),await d(a+Math.floor(Math.random()*100));continue}return r}catch(r){if(i<o){i++,this.debug&&console.warn("[Teckel] Network retry",{url:n,attempt:i,error:r instanceof Error?r.message:String(r)}),await d(a+Math.floor(Math.random()*100));continue}throw r}}async _startConversation(){let n=await this.fetchWithRetry(`${this.endpoint}/conversations`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},keepalive:true,signal:m(this.timeoutMs),body:JSON.stringify({sessionRef:this.sessionRef,userRef:this.userRef,metadata:this.metadata})},{retries:1,retryDelayMs:300});if(!n.ok)throw new Error(`HTTP ${n.status}: ${n.statusText}`)}async _sendTrace(n,e){let s=await this.fetchWithRetry(`${this.endpoint}/conversations/${this.sessionRef}/traces`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},keepalive:true,signal:m(e?.timeoutMs??this.timeoutMs),body:JSON.stringify(n)},{retries:1,retryDelayMs:300});if(!s.ok)throw new Error(`HTTP ${s.status}: ${s.statusText}`);return await s.json()}async _sendFeedback(n){let e=await this.fetchWithRetry(`${this.endpoint}/conversations/${this.sessionRef}/feedback`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},keepalive:true,signal:m(this.timeoutMs),body:JSON.stringify(n)},{retries:1,retryDelayMs:300});if(!e.ok)throw new Error(`HTTP ${e.status}: ${e.statusText}`)}async _endConversation(n){let e=await this.fetchWithRetry(`${this.endpoint}/conversations/${this.sessionRef}`,{method:"PATCH",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},keepalive:true,signal:m(this.timeoutMs),body:JSON.stringify({durationMs:n,turnCount:this.turnCount})},{retries:1,retryDelayMs:300});if(!e.ok)throw new Error(`HTTP ${e.status}: ${e.statusText}`)}enqueueSend(n){this.sendQueue=this.sendQueue.then(()=>n()).catch(()=>{});}async flush(n){let e=typeof n=="number"&&Number.isFinite(n)&&n>=0?n:this.timeoutMs,s=this.sendQueue.catch(()=>{}),o;try{await Promise.race([s,new Promise((a,i)=>{o=setTimeout(()=>i(new Error("Flush timeout")),e);})]);}catch(a){if(this.debug){let i=a instanceof Error?a.message:String(a);console.warn("[Teckel] Flush incomplete:",i);}throw a}finally{o&&clearTimeout(o);}}};function m(c){if(!(typeof c!="number"||c<=0)&&typeof AbortSignal.timeout=="function")return AbortSignal.timeout(c)}var g=class{constructor(n){let e=f.parse(n);e.apiKey.startsWith("tk_live_")||console.warn('[Teckel] API key should start with "tk_live_". Current key: '+e.apiKey.substring(0,10)+"..."),this.apiKey=e.apiKey,this.endpoint=e.endpoint||"https://app.teckel.ai/api",this.debug=e.debug||false,this.timeoutMs=typeof e.timeoutMs=="number"?e.timeoutMs:5e3,this.debug&&console.log("[Teckel] SDK initialized:",{endpoint:this.endpoint,version:"0.3.5",timeoutMs:this.timeoutMs});}start(n={}){let e=h.parse(n),s=e.sessionRef||`auto:${crypto.randomUUID().slice(0,8)}`;return new u(this.apiKey,this.endpoint,{...e,sessionRef:s},this.debug,{timeoutMs:this.timeoutMs})}};
+export{u as Conversation,h as ConversationOptionsSchema,y as DocumentSchema,p as FeedbackDataSchema,f as TeckelConfigSchema,g as TeckelTracer,b as TokenUsageSchema,l as TraceDataSchema};

package/package.json

@@ -1,17 +1,31 @@
 {
   "name": "teckel-ai",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Simple SDK for AI conversation tracking and RAG observability",
   "main": "dist/index.js",
+  "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
   "files": [
     "dist/**/*",
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsup",
     "clean": "rm -rf dist",
-    "prepublishOnly": "npm run clean && npm run build"
+    "prepublishOnly": "npm run clean && npm run build",
+    "type-check": "tsc --noEmit"
   },
   "keywords": [
     "llm",
@@ -25,19 +39,16 @@
   ],
   "author": "Teckel AI",
   "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false,
   "dependencies": {
     "zod": "^3.23.8"
   },
   "devDependencies": {
+    "tsup": "^8.3.5",
     "typescript": "^5.0.0"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/spencine/AI-Audit-Tool.git",
-    "directory": "packages/tracer"
-  },
-  "homepage": "https://teckel.ai",
-  "bugs": {
-    "url": "https://github.com/spencine/AI-Audit-Tool/issues"
-  }
+  "homepage": "https://teckel.ai"
 }

package/dist/conversation.d.ts

@@ -1,55 +0,0 @@
-/**
- * Conversation class for teckel-ai SDK v0.3.2
- * Manages a single conversation with fire-and-forget semantics
- */
-import type { TraceData, FeedbackData, ConversationOptions, TraceResult } from './types';
-export declare class Conversation {
-    private readonly apiKey;
-    private readonly endpoint;
-    private readonly sessionRef;
-    private readonly userId?;
-    private readonly metadata?;
-    private readonly startedAt;
-    private readonly debug;
-    private readonly timeoutMs;
-    private turnCount;
-    private startPromise;
-    private sendQueue;
-    constructor(apiKey: string, endpoint: string, options: ConversationOptions, debug?: boolean, extras?: {
-        timeoutMs: number;
-    });
-    /**
-     * Record a trace (single query-response interaction)
-     * Fire-and-forget by default - never blocks
-     * For serverless, call flush() before function termination
-     */
-    trace(data: TraceData): TraceResult | void;
-    /**
-     * Add user feedback signal
-     * Never throws - gracefully handles errors
-     */
-    feedback(data: FeedbackData): Promise<void>;
-    /**
-     * End the conversation
-     * Flushes all pending traces before sending end signal
-     * Never throws - gracefully handles errors
-     */
-    end(): Promise<void>;
-    /**
-     * Read-only properties
-     */
-    get id(): string;
-    get turns(): number;
-    get started(): Date;
-    private fetchWithRetry;
-    private _startConversation;
-    private _sendTrace;
-    private _sendFeedback;
-    private _endConversation;
-    private enqueueSend;
-    /**
-     * Flush queued sends with a bounded timeout.
-     * Returns when the queue is empty or the timeout elapses (whichever comes first).
-     */
-    flush(timeoutMs?: number): Promise<void>;
-}