@tinkrapp/widget 1.0.0

package/dist/client-CExUGn7b.d.cts

@@ -0,0 +1,147 @@
+interface WidgetConfig {
+    /**
+     * The API key for this widget instance.
+     * This is the Assistant ID that identifies which AI assistant to use.
+     * Get this from your Tinkr dashboard after creating an assistant.
+     */
+    apiKey: string;
+    /**
+     * The Assistant ID that identifies which AI assistant to use.
+     * @deprecated Use apiKey instead - they serve the same purpose.
+     */
+    assistantId?: string;
+    /**
+     * The base URL for the API.
+     * Defaults to 'http://localhost:3000' in development.
+     * Set to your production URL when deploying.
+     */
+    baseUrl?: string;
+    /**
+     * Optional user ID to identify the user across sessions.
+     * If not provided, a random UUID will be generated.
+     */
+    userId?: string;
+    /**
+     * Enable debug logging in the console.
+     */
+    debug?: boolean;
+}
+interface Message {
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+interface ChatSession {
+    id: string;
+    /** The API key (Assistant ID) this session belongs to */
+    apiKey: string;
+    messages: Message[];
+    createdAt: number;
+}
+interface Artifact {
+    id: string;
+    title: string;
+    category: ArtifactCategory;
+    content: string;
+    createdAt: number;
+    updatedAt: number;
+}
+type ArtifactCategory = 'audio' | 'audio-overview' | 'flashcards' | 'infographic' | 'mind-map' | 'quiz' | 'reports' | 'slide-deck' | 'video-overview';
+type WidgetState = {
+    status: 'idle';
+} | {
+    status: 'initializing';
+} | {
+    status: 'ready';
+    session: ChatSession;
+} | {
+    status: 'loading';
+} | {
+    status: 'error';
+    error: WidgetError;
+};
+interface WidgetError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+type WidgetEvents = {
+    'state:change': {
+        previous: WidgetState;
+        current: WidgetState;
+    };
+    'message:sent': {
+        message: Message;
+    };
+    'message:received': {
+        message: Message;
+    };
+    'error': {
+        error: WidgetError;
+    };
+    'session:created': {
+        session: ChatSession;
+    };
+    'artifact:created': {
+        artifact: Artifact;
+    };
+};
+
+declare class WidgetAPI {
+    private config;
+    constructor(config: WidgetConfig);
+    createSession(): Promise<ChatSession>;
+    sendMessage(sessionId: string, content: string): Promise<Message>;
+    getHistory(sessionId: string): Promise<Message[]>;
+    getSessions(): Promise<ChatSession[]>;
+    getArtifacts(): Promise<Artifact[]>;
+    getArtifact(id: string): Promise<Artifact>;
+    createArtifact(artifact: Omit<Artifact, 'id' | 'createdAt' | 'updatedAt'>): Promise<Artifact>;
+    private request;
+    private log;
+}
+
+declare class WidgetClient {
+    private config;
+    private state;
+    private events;
+    private api;
+    constructor(config: WidgetConfig);
+    /**
+     * Initialize the widget and create a chat session
+     */
+    initialize(): Promise<void>;
+    /**
+     * Send a message to the AI assistant
+     */
+    sendMessage(content: string): Promise<Message>;
+    /**
+     * Get current state
+     */
+    getState(): WidgetState;
+    /**
+     * Get the API instance for direct calls
+     */
+    getAPI(): WidgetAPI;
+    /**
+     * Get the widget configuration
+     */
+    getConfig(): WidgetConfig;
+    /**
+     * Subscribe to events
+     */
+    on<K extends keyof WidgetEvents>(event: K, handler: (payload: WidgetEvents[K]) => void): () => void;
+    /**
+     * Unsubscribe from events
+     */
+    off<K extends keyof WidgetEvents>(event: K, handler: (payload: WidgetEvents[K]) => void): void;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+    private setState;
+}
+
+export { type Artifact as A, type ChatSession as C, type Message as M, WidgetClient as W, WidgetAPI as a, type WidgetConfig as b, type WidgetState as c, type WidgetEvents as d, type WidgetError as e, type ArtifactCategory as f };

package/dist/client-CExUGn7b.d.ts

@@ -0,0 +1,147 @@
+interface WidgetConfig {
+    /**
+     * The API key for this widget instance.
+     * This is the Assistant ID that identifies which AI assistant to use.
+     * Get this from your Tinkr dashboard after creating an assistant.
+     */
+    apiKey: string;
+    /**
+     * The Assistant ID that identifies which AI assistant to use.
+     * @deprecated Use apiKey instead - they serve the same purpose.
+     */
+    assistantId?: string;
+    /**
+     * The base URL for the API.
+     * Defaults to 'http://localhost:3000' in development.
+     * Set to your production URL when deploying.
+     */
+    baseUrl?: string;
+    /**
+     * Optional user ID to identify the user across sessions.
+     * If not provided, a random UUID will be generated.
+     */
+    userId?: string;
+    /**
+     * Enable debug logging in the console.
+     */
+    debug?: boolean;
+}
+interface Message {
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+interface ChatSession {
+    id: string;
+    /** The API key (Assistant ID) this session belongs to */
+    apiKey: string;
+    messages: Message[];
+    createdAt: number;
+}
+interface Artifact {
+    id: string;
+    title: string;
+    category: ArtifactCategory;
+    content: string;
+    createdAt: number;
+    updatedAt: number;
+}
+type ArtifactCategory = 'audio' | 'audio-overview' | 'flashcards' | 'infographic' | 'mind-map' | 'quiz' | 'reports' | 'slide-deck' | 'video-overview';
+type WidgetState = {
+    status: 'idle';
+} | {
+    status: 'initializing';
+} | {
+    status: 'ready';
+    session: ChatSession;
+} | {
+    status: 'loading';
+} | {
+    status: 'error';
+    error: WidgetError;
+};
+interface WidgetError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+type WidgetEvents = {
+    'state:change': {
+        previous: WidgetState;
+        current: WidgetState;
+    };
+    'message:sent': {
+        message: Message;
+    };
+    'message:received': {
+        message: Message;
+    };
+    'error': {
+        error: WidgetError;
+    };
+    'session:created': {
+        session: ChatSession;
+    };
+    'artifact:created': {
+        artifact: Artifact;
+    };
+};
+
+declare class WidgetAPI {
+    private config;
+    constructor(config: WidgetConfig);
+    createSession(): Promise<ChatSession>;
+    sendMessage(sessionId: string, content: string): Promise<Message>;
+    getHistory(sessionId: string): Promise<Message[]>;
+    getSessions(): Promise<ChatSession[]>;
+    getArtifacts(): Promise<Artifact[]>;
+    getArtifact(id: string): Promise<Artifact>;
+    createArtifact(artifact: Omit<Artifact, 'id' | 'createdAt' | 'updatedAt'>): Promise<Artifact>;
+    private request;
+    private log;
+}
+
+declare class WidgetClient {
+    private config;
+    private state;
+    private events;
+    private api;
+    constructor(config: WidgetConfig);
+    /**
+     * Initialize the widget and create a chat session
+     */
+    initialize(): Promise<void>;
+    /**
+     * Send a message to the AI assistant
+     */
+    sendMessage(content: string): Promise<Message>;
+    /**
+     * Get current state
+     */
+    getState(): WidgetState;
+    /**
+     * Get the API instance for direct calls
+     */
+    getAPI(): WidgetAPI;
+    /**
+     * Get the widget configuration
+     */
+    getConfig(): WidgetConfig;
+    /**
+     * Subscribe to events
+     */
+    on<K extends keyof WidgetEvents>(event: K, handler: (payload: WidgetEvents[K]) => void): () => void;
+    /**
+     * Unsubscribe from events
+     */
+    off<K extends keyof WidgetEvents>(event: K, handler: (payload: WidgetEvents[K]) => void): void;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+    private setState;
+}
+
+export { type Artifact as A, type ChatSession as C, type Message as M, WidgetClient as W, WidgetAPI as a, type WidgetConfig as b, type WidgetState as c, type WidgetEvents as d, type WidgetError as e, type ArtifactCategory as f };

package/dist/course-ai-widget.css

@@ -0,0 +1,2 @@
+@keyframes aui-pulse{50%{opacity:.5}}:where(.aui-md[data-status=running]):empty:after,:where(.aui-md[data-status=running])>:where(:not(ol):not(ul):not(pre)):last-child:after,:where(.aui-md[data-status=running])>pre:last-child code:after,:where(.aui-md[data-status=running])>:where(:is(ol,ul):last-child)>:where(li:last-child:not(:has(*>li))):after,:where(.aui-md[data-status=running])>:where(:is(ol,ul):last-child)>:where(li:last-child)>:where(:is(ol,ul):last-child)>:where(li:last-child:not(:has(*>li))):after,:where(.aui-md[data-status=running])>:where(:is(ol,ul):last-child)>:where(li:last-child)>:where(:is(ol,ul):last-child)>:where(li:last-child)>:where(:is(ol,ul):last-child)>:where(li:last-child):after{animation:aui-pulse 2s cubic-bezier(.4,0,.6,1) infinite;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";--aui-content: "\25cf";content:var(--aui-content);margin-left:.25rem;margin-right:.25rem}
+/*# sourceMappingURL=course-ai-widget.css.map */

package/dist/course-ai-widget.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../node_modules/@assistant-ui/react-markdown/styles/dot.css"],"sourcesContent":["@keyframes aui-pulse {\n  50% {\n    opacity: 0.5;\n  }\n}\n\n:where(.aui-md[data-status=\"running\"]):empty::after,\n:where(.aui-md[data-status=\"running\"])\n  > :where(:not(ol):not(ul):not(pre)):last-child::after,\n:where(.aui-md[data-status=\"running\"]) > pre:last-child code::after,\n:where(.aui-md[data-status=\"running\"])\n  > :where(:is(ol, ul):last-child)\n  > :where(li:last-child:not(:has(* > li)))::after,\n:where(.aui-md[data-status=\"running\"])\n  > :where(:is(ol, ul):last-child)\n  > :where(li:last-child)\n  > :where(:is(ol, ul):last-child)\n  > :where(li:last-child:not(:has(* > li)))::after,\n:where(.aui-md[data-status=\"running\"])\n  > :where(:is(ol, ul):last-child)\n  > :where(li:last-child)\n  > :where(:is(ol, ul):last-child)\n  > :where(li:last-child)\n  > :where(:is(ol, ul):last-child)\n  > :where(li:last-child)::after {\n  animation: aui-pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;\n  font-family:\n    ui-sans-serif, system-ui, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\",\n    \"Segoe UI Symbol\", \"Noto Color Emoji\";\n  --aui-content: \"\\25cf\";\n  content: var(--aui-content);\n  margin-left: 0.25rem;\n  margin-right: 0.25rem;\n}\n"],"mappings":"AAAA,WAAW,UACT,IACE,QAAS,EACX,CACF,CAEA,OAAO,CAAC,MAAM,CAAC,qBAAuB,MAAM,OAC5C,OAAO,CADC,MACM,CAAC,qBACb,CAAE,OAAO,KAAK,GAAG,KAAK,GAAG,KAAK,KAAK,WAAW,OAChD,OAAO,CAHC,MAGM,CAAC,qBAAwB,CAAE,GAAG,YAAY,IAAI,OAC5D,OAAO,CAJC,MAIM,CAAC,qBACb,CAAE,OAAO,IAAI,GAAI,GAAG,YACpB,CAAE,OAAO,EAAE,WAAW,KAAK,KAAK,CAAE,CAAE,KAAK,OAC3C,OAAO,CAPC,MAOM,CAAC,qBACb,CAAE,OAAO,IAAI,GAAI,GAAG,YACpB,CAAE,OAAO,EAAE,YACX,CAAE,OAAO,IAAI,GAAI,GAAG,YACpB,CAAE,OAAO,EAAE,WAAW,KAAK,KAAK,CAAE,CAAE,KAAK,OAC3C,OAAO,CAZC,MAYM,CAAC,qBACb,CAAE,OAAO,IAAI,GAAI,GAAG,YACpB,CAAE,OAAO,EAAE,YACX,CAAE,OAAO,IAAI,GAAI,GAAG,YACpB,CAAE,OAAO,EAAE,YACX,CAAE,OAAO,IAAI,GAAI,GAAG,YACpB,CAAE,OAAO,EAAE,YAAY,OACvB,UAAW,UAAU,GAAG,aAAa,EAAG,CAAE,CAAC,CAAE,EAAG,CAAE,GAAG,SACrD,YACE,aAAa,CAAE,SAAS,CAAE,UAAU,CAAE,mBAAmB,CAAE,gBAAgB,CAC3E,eAAiB,CAAE,mBACrB,eAAe,QACf,QAAS,IAAI,eACb,YAAa,OACb,aAAc,MAChB","names":[]}