@yak-io/javascript 0.1.0

package/dist/server/sources.js

@@ -0,0 +1,116 @@
+function isRouteSource(value) {
+    return Boolean(value && typeof value === "object" && "getRoutes" in value && typeof value.getRoutes === "function");
+}
+function isRouteInfoArray(value) {
+    return Array.isArray(value) && value.every((route) => route && typeof route.path === "string");
+}
+function normalizeRouteSourceItem(item, index) {
+    if (isRouteSource(item)) {
+        return {
+            id: item.id ?? `route-source-${index}`,
+            getRoutes: item.getRoutes,
+        };
+    }
+    if (typeof item === "function") {
+        return {
+            id: `route-fn-${index}`,
+            getRoutes: item,
+        };
+    }
+    if (isRouteInfoArray(item)) {
+        return {
+            id: `route-static-${index}`,
+            getRoutes: async () => item,
+        };
+    }
+    throw new Error("Unsupported route source input");
+}
+export function normalizeRouteSources(input) {
+    if (Array.isArray(input)) {
+        if (input.length === 0) {
+            return [];
+        }
+        if (isRouteInfoArray(input)) {
+            return [normalizeRouteSourceItem(input, 0)];
+        }
+        return input.map((item, index) => normalizeRouteSourceItem(item, index));
+    }
+    return [normalizeRouteSourceItem(input, 0)];
+}
+function isToolSource(value) {
+    return Boolean(value && typeof value === "object" && "getTools" in value && typeof value.getTools === "function");
+}
+function isToolManifest(value) {
+    return Boolean(value && typeof value === "object" && "tools" in value);
+}
+function isToolDefinitionArray(value) {
+    return Array.isArray(value) && value.every((tool) => tool && typeof tool.name === "string");
+}
+function toToolDefinitions(result) {
+    if (isToolDefinitionArray(result)) {
+        return result;
+    }
+    if (isToolManifest(result)) {
+        return result.tools;
+    }
+    throw new Error("Tool source must resolve to ToolDefinition[] or ToolManifest");
+}
+function normalizeToolSourceItem(item, index) {
+    if (isToolSource(item)) {
+        return {
+            id: item.id ?? `tool-source-${index}`,
+            getTools: async () => {
+                const result = await item.getTools();
+                return toToolDefinitions(result);
+            },
+            executeTool: item.executeTool,
+        };
+    }
+    if (typeof item === "function") {
+        return {
+            id: `tool-fn-${index}`,
+            getTools: async () => {
+                const result = await item();
+                return toToolDefinitions(result);
+            },
+        };
+    }
+    if (isToolDefinitionArray(item)) {
+        return {
+            id: `tool-static-${index}`,
+            getTools: async () => item,
+        };
+    }
+    if (isToolManifest(item)) {
+        return {
+            id: `tool-manifest-${index}`,
+            getTools: async () => item.tools,
+        };
+    }
+    if (item && typeof item === "object" && "getTools" in item && typeof item.getTools === "function") {
+        return {
+            id: item.id ?? `tool-wrapper-${index}`,
+            getTools: async () => {
+                const result = await item.getTools();
+                return toToolDefinitions(result);
+            },
+            executeTool: item.executeTool,
+        };
+    }
+    throw new Error("Unsupported tool source input");
+}
+export function normalizeToolSources(input) {
+    if (!input) {
+        return [];
+    }
+    if (Array.isArray(input)) {
+        if (input.length === 0) {
+            return [];
+        }
+        if (isToolDefinitionArray(input)) {
+            return [normalizeToolSourceItem(input, 0)];
+        }
+        return input.map((item, index) => normalizeToolSourceItem(item, index));
+    }
+    return [normalizeToolSourceItem(input, 0)];
+}

package/dist/types/config.d.ts

@@ -0,0 +1,19 @@
+import type { SchemaSource, ToolManifest } from "./tools.js";
+import type { RouteManifest } from "./routes.js";
+/**
+ * Combined configuration for the chatbot including routes, tools, and schema sources
+ */
+export type ChatConfig = {
+    /** Route manifest */
+    routes: RouteManifest;
+    /** Optional tool manifest (tRPC, GraphQL, etc.) */
+    tools?: ToolManifest;
+    /** Optional schema sources (GraphQL SDL, OpenAPI specs) passed as context to the LLM */
+    schemaSources?: SchemaSource[];
+};
+/**
+ * Function that provides the chat configuration.
+ * The consuming platform decides how to get the config (static, fetch, etc.)
+ */
+export type ChatConfigProvider = () => Promise<ChatConfig> | ChatConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,mDAAmD;IACnD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,wFAAwF;IACxF,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC"}

package/dist/types/config.js

@@ -0,0 +1 @@
+export {};

package/dist/types/messaging.d.ts

@@ -0,0 +1,153 @@
+import type { SchemaSource, ToolManifest, GraphQLRequest, RESTRequest } from "./tools.js";
+import type { RouteManifest } from "./routes.js";
+import type { EmbedProtocolVersion } from "../version.js";
+/**
+ * Button/launcher style for a single color mode.
+ */
+export type ButtonColors = {
+    /** Button background color */
+    background?: string;
+    /** Button text/icon color */
+    color?: string;
+    /** Button border color */
+    border?: string;
+};
+/**
+ * Color values for a single mode (light or dark).
+ * Applied as CSS variables within the chat UI.
+ */
+export type ThemeColors = {
+    /** Main background color of the chat panel */
+    background?: string;
+    /** Border color for the chat panel and elements */
+    border?: string;
+    /** Button/launcher customization for this color mode */
+    button?: ButtonColors;
+    /** User message bubble background color */
+    messageBackground?: string;
+    /** Input placeholder text color */
+    placeholderColor?: string;
+    /** Submit button background color */
+    submitButtonColor?: string;
+    /** Submit button text/icon color */
+    submitButtonTextColor?: string;
+    /** Header icon color (restart and close buttons) */
+    headerIconColor?: string;
+};
+/**
+ * Theme configuration for the chatbot widget
+ */
+export type Theme = {
+    /** Widget position: for chatbox mode this is the corner, for drawer mode this is the side */
+    position?: "right" | "left";
+    /** Force a specific color mode instead of following system preference */
+    colorMode?: "light" | "dark" | "system";
+    /** Display mode: chatbox (floating corner panel) or drawer (full-height side panel) */
+    displayMode?: "chatbox" | "drawer";
+    /** Color customization for light mode (applied when colorMode is "light" or system prefers light) */
+    light?: ThemeColors;
+    /** Color customization for dark mode (applied when colorMode is "dark" or system prefers dark) */
+    dark?: ThemeColors;
+};
+/**
+ * Page context information from the host page
+ */
+export type PageContext = {
+    url: string;
+    title: string;
+    text: string;
+    timestamp: number;
+};
+/**
+ * Chat configuration options passed from host to chat-ui.
+ * Grouped to minimize contract changes when adding new options.
+ */
+export type ChatOptions = {
+    /** Disable the restart session button in the header */
+    disableRestartButton?: boolean;
+};
+/**
+ * Messages sent FROM the host application TO the iframe
+ */
+export type IframeMessageFromHost = {
+    type: "yak:config";
+    payload: {
+        /** Protocol version for compatibility checking */
+        version?: EmbedProtocolVersion;
+        appId: string;
+        theme?: Theme;
+        toolManifest?: ToolManifest;
+        routeManifest?: RouteManifest;
+        /** Schema sources passed as context to the LLM */
+        schemaSources?: SchemaSource[];
+        /** Chat configuration options */
+        options?: ChatOptions;
+    };
+} | {
+    type: "yak:tool_result";
+    payload: {
+        id: string;
+        ok: true;
+        result: unknown;
+    };
+} | {
+    type: "yak:tool_result";
+    payload: {
+        id: string;
+        ok: false;
+        error: string;
+    };
+} | {
+    type: "yak:page_context";
+    payload: PageContext;
+} | {
+    type: "yak:prompt";
+    payload: {
+        prompt: string;
+    };
+} | {
+    type: "yak:focus";
+};
+/**
+ * Messages sent FROM the iframe TO the host application
+ */
+export type IframeMessageToHost = {
+    type: "yak:ready";
+    /** Protocol version supported by the embed page */
+    payload?: {
+        version: EmbedProtocolVersion;
+    };
+} | {
+    type: "yak:tool_call";
+    payload: {
+        id: string;
+        name: string;
+        args: unknown;
+    };
+} | {
+    type: "yak:graphql_schema_call";
+    payload: {
+        id: string;
+        schemaName: string;
+        request: GraphQLRequest;
+    };
+} | {
+    type: "yak:rest_schema_call";
+    payload: {
+        id: string;
+        schemaName: string;
+        request: RESTRequest;
+    };
+} | {
+    type: "yak:redirect";
+    payload: {
+        path: string;
+    };
+} | {
+    type: "yak:close";
+};
+/**
+ * Union of all message types (for type guards)
+ */
+export type IframeMessage = IframeMessageFromHost | IframeMessageToHost;
+//# sourceMappingURL=messaging.d.ts.map

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

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

package/dist/types/messaging.js

@@ -0,0 +1 @@
+export {};

package/dist/types/routes.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Information about a single route in the host application
+ */
+export type RouteInfo = {
+    /** The route path, e.g., "/dashboard" or "/posts/[id]" */
+    path: string;
+    /** Human-readable title extracted from page metadata */
+    title?: string;
+    /** Description extracted from page metadata */
+    description?: string;
+};
+/**
+ * Manifest of all routes that can be shared with Yak
+ */
+export type RouteManifest = {
+    /** List of all discovered routes */
+    routes: RouteInfo[];
+    /** ISO timestamp when the manifest was generated */
+    generated_at: string;
+    /** Optional metadata about which adapters produced the routes */
+    sources?: Array<{
+        id: string;
+        count: number;
+    }>;
+};
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/types/routes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,oCAAoC;IACpC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ,CAAC"}

package/dist/types/routes.js

@@ -0,0 +1 @@
+export {};

package/dist/types/tools.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Generic JSON Schema type
+ */
+export type JSONSchema = Record<string, unknown>;
+/**
+ * GraphQL schema source for providing API context to the LLM
+ */
+export type GraphQLSchemaSource = {
+    /** Unique identifier for this schema (used in callbacks) */
+    name: string;
+    type: "graphql";
+    /** The GraphQL schema in SDL format */
+    schema: string;
+};
+/**
+ * OpenAPI spec source for providing API context to the LLM
+ */
+export type OpenAPISchemaSource = {
+    /** Unique identifier for this schema (used in callbacks) */
+    name: string;
+    type: "openapi";
+    /** OpenAPI spec as JSON object or YAML string */
+    spec: Record<string, unknown> | string;
+};
+/**
+ * Union type for schema sources
+ */
+export type SchemaSource = GraphQLSchemaSource | OpenAPISchemaSource;
+/**
+ * GraphQL request generated by the LLM
+ */
+export type GraphQLRequest = {
+    /** The GraphQL query or mutation string */
+    query: string;
+    /** Variables for the operation */
+    variables?: Record<string, unknown>;
+    /** Optional operation name if multiple operations in query */
+    operationName?: string;
+};
+/**
+ * REST request generated by the LLM
+ */
+export type RESTRequest = {
+    /** HTTP method */
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    /** Path (e.g., "/users/123") */
+    path: string;
+    /** Query parameters */
+    query?: Record<string, string>;
+    /** Request body */
+    body?: unknown;
+};
+/**
+ * Handler for GraphQL schema tool calls.
+ * The LLM generates the query based on the schema context.
+ *
+ * @param schemaName - The name of the schema (from SchemaSource.name)
+ * @param request - The GraphQL request generated by the LLM
+ * @returns The result of executing the GraphQL operation
+ */
+export type GraphQLSchemaHandler = (schemaName: string, request: GraphQLRequest) => Promise<unknown>;
+/**
+ * Handler for OpenAPI/REST schema tool calls.
+ * The LLM generates the request based on the schema context.
+ *
+ * @param schemaName - The name of the schema (from SchemaSource.name)
+ * @param request - The REST request generated by the LLM
+ * @returns The result of executing the REST request
+ */
+export type RESTSchemaHandler = (schemaName: string, request: RESTRequest) => Promise<unknown>;
+/**
+ * Payload for a tool call request from the iframe
+ */
+export type ToolCallPayload = {
+    id: string;
+    name: string;
+    args: unknown;
+};
+/**
+ * Successful tool call result
+ */
+export type ToolCallSuccess = {
+    ok: true;
+    result: unknown;
+};
+/**
+ * Failed tool call result
+ */
+export type ToolCallError = {
+    ok: false;
+    error: string;
+};
+/**
+ * Union type for tool call responses
+ */
+export type ToolCallResult = ToolCallSuccess | ToolCallError;
+/**
+ * Definition of a single tool available to the LLM
+ */
+export type ToolDefinition = {
+    /** Fully qualified procedure name, e.g. "orders.list" */
+    name: string;
+    /** Human friendly label */
+    displayName?: string;
+    /** Description shown to the LLM as a tool description */
+    description?: string;
+    /** Optional JSON Schema for input args */
+    inputSchema?: JSONSchema;
+    /** Optional JSON Schema for output shape */
+    outputSchema?: JSONSchema;
+};
+/**
+ * Manifest of all tools available to the chatbot
+ */
+export type ToolManifest = {
+    tools: ToolDefinition[];
+    generated_at?: string;
+    sources?: Array<{
+        id: string;
+        count: number;
+    }>;
+};
+/**
+ * Tool executor function type (server-side, receives Request object)
+ */
+export type ToolExecutor = (name: string, args: unknown, req: Request) => Promise<unknown>;
+/**
+ * Tool call handler for client-side integration.
+ * The consuming app decides how to execute the tool call.
+ *
+ * @param name - The tool name being called
+ * @param args - The arguments for the tool
+ * @returns The result of the tool execution
+ * @throws Error if the tool call fails
+ */
+export type ToolCallHandler = (name: string, args: unknown) => Promise<unknown>;
+//# sourceMappingURL=tools.d.ts.map

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

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

package/dist/types/tools.js

@@ -0,0 +1 @@
+export {};

package/dist/version.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Embed protocol version.
+ *
+ * This version is used in the embed URL path (e.g., /embed/v1/[appId])
+ * and in the message protocol to ensure compatibility between the
+ * host packages (@yak-io/javascript, @yak-io/react, @yak-io/nextjs)
+ * and the embedded chat UI.
+ *
+ * Increment this version when making breaking changes to:
+ * - The postMessage protocol (IframeMessageFromHost, IframeMessageToHost)
+ * - The tool manifest format
+ * - The route manifest format
+ * - The config payload structure
+ *
+ * Version history:
+ * - v1: Initial versioned protocol
+ */
+export declare const EMBED_PROTOCOL_VERSION: "1";
+/**
+ * Type for the embed protocol version
+ */
+export type EmbedProtocolVersion = typeof EMBED_PROTOCOL_VERSION;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,sBAAsB,EAAG,GAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,sBAAsB,CAAC"}

package/dist/version.js

@@ -0,0 +1,18 @@
+/**
+ * Embed protocol version.
+ *
+ * This version is used in the embed URL path (e.g., /embed/v1/[appId])
+ * and in the message protocol to ensure compatibility between the
+ * host packages (@yak-io/javascript, @yak-io/react, @yak-io/nextjs)
+ * and the embedded chat UI.
+ *
+ * Increment this version when making breaking changes to:
+ * - The postMessage protocol (IframeMessageFromHost, IframeMessageToHost)
+ * - The tool manifest format
+ * - The route manifest format
+ * - The config payload structure
+ *
+ * Version history:
+ * - v1: Initial versioned protocol
+ */
+export const EMBED_PROTOCOL_VERSION = "1";

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@yak-io/javascript",
+  "version": "0.1.0",
+  "description": "Core JavaScript SDK for embedding yak chatbot",
+  "type": "module",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Yak <support@yak.io>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/9f-au/yak.git",
+    "directory": "packages/javascript"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "keywords": [
+    "yak",
+    "chatbot",
+    "ai",
+    "widget",
+    "chat",
+    "embed"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/index.server.d.ts",
+      "import": "./dist/index.server.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.2",
+    "typescript": "^5.3.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit"
+  }
+}