@useago/sdk 0.3.2 → 0.3.4

package/dist/index.cjs

@@ -1,347 +1 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_AgoClient = require("./AgoClient-wMVUQqCD.cjs");
-const require_createMockClient = require("./createMockClient-Ci_N2tH8.cjs");
-const require_functions = require("./functions--c6lx3ic.cjs");
-//#region src/state/createStore.ts
-function createStore(initial, persist) {
-	const storage = persist ? persist.storage ?? (typeof localStorage !== "undefined" ? localStorage : void 0) : void 0;
-	let state = initial;
-	if (persist && storage) try {
-		const raw = storage.getItem(persist.key);
-		if (raw != null) state = JSON.parse(raw);
-	} catch {}
-	const subscribers = /* @__PURE__ */ new Set();
-	const notify = () => subscribers.forEach((fn) => fn(state));
-	function persistState() {
-		if (persist && storage) try {
-			storage.setItem(persist.key, JSON.stringify(state));
-		} catch {}
-	}
-	return {
-		get: () => state,
-		set: (next) => {
-			state = next;
-			persistState();
-			notify();
-		},
-		subscribe: (fn) => {
-			subscribers.add(fn);
-			return () => {
-				subscribers.delete(fn);
-			};
-		}
-	};
-}
-//#endregion
-//#region src/functions/defineFunction.ts
-/**
-* Create a reusable function definition.
-* Returns the same object — this is an identity function for discoverability and type-checking.
-*
-* ```ts
-* // Define once, reuse anywhere
-* export const lookupOrder = defineFunction({
-*   name: "lookupOrder",
-*   description: "Look up an order by ID",
-*   parameters: { type: "object", properties: { id: { type: "string" } }, required: ["id"] },
-*   handler: async (args) => fetchOrder(args.id as string),
-* });
-*
-* // Register with client
-* client.registerFunction(lookupOrder);
-*
-* // Or use in React
-* useAgoFunction(lookupOrder.name, lookupOrder);
-* ```
-*/
-function defineFunction(definition) {
-	return definition;
-}
-//#endregion
-//#region src/streaming/helpers.ts
-/**
-* Subscribe to complete messages with a simple callback. Returns an unsubscribe function.
-*
-* ```ts
-* const unsub = onMessage(client, (msg) => console.log(msg.content));
-* // later: unsub();
-* ```
-*/
-function onMessage(client, callback) {
-	client.on("message:complete", callback);
-	return () => client.off("message:complete", callback);
-}
-/**
-* Subscribe to streaming text chunks.
-*
-* ```ts
-* onMessageChunk(client, ({ content }) => {
-*   outputEl.textContent += content;
-* });
-* ```
-*/
-function onMessageChunk(client, callback) {
-	client.on("message:chunk", callback);
-	return () => client.off("message:chunk", callback);
-}
-/**
-* Subscribe to message start events.
-*/
-function onMessageStart(client, callback) {
-	client.on("message:start", callback);
-	return () => client.off("message:start", callback);
-}
-/**
-* Subscribe to message errors.
-*/
-function onMessageError(client, callback) {
-	client.on("message:error", callback);
-	return () => client.off("message:error", callback);
-}
-/**
-* Subscribe to tool call events.
-*/
-function onToolCall(client, callback) {
-	client.on("toolCall:received", callback);
-	return () => client.off("toolCall:received", callback);
-}
-/**
-* Subscribe to client function invocations.
-*/
-function onFunctionInvoke(client, callback) {
-	client.on("function:invoke", callback);
-	return () => client.off("function:invoke", callback);
-}
-/**
-* Send a message and iterate over chunks as an async generator.
-* Gives you full control over how you process the stream.
-*
-* ```ts
-* for await (const chunk of createMessageStream(client, "Hello!")) {
-*   console.log(chunk.type, chunk.data);
-* }
-* ```
-*/
-async function* createMessageStream(client, content, options) {
-	const queue = [];
-	let resolve = null;
-	let done = false;
-	const push = (event) => {
-		queue.push(event);
-		resolve?.();
-	};
-	const onStart = (data) => push({
-		type: "start",
-		data
-	});
-	const onChunk = (data) => push({
-		type: "chunk",
-		data
-	});
-	const onComplete = (data) => {
-		push({
-			type: "complete",
-			data
-		});
-		done = true;
-		resolve?.();
-	};
-	const onError = (data) => {
-		push({
-			type: "error",
-			data
-		});
-		done = true;
-		resolve?.();
-	};
-	const onTool = (data) => push({
-		type: "toolCall",
-		data
-	});
-	client.on("message:start", onStart);
-	client.on("message:chunk", onChunk);
-	client.on("message:complete", onComplete);
-	client.on("message:error", onError);
-	client.on("toolCall:received", onTool);
-	client.sendMessage(content, options).catch(() => {
-		done = true;
-		resolve?.();
-	});
-	try {
-		while (!done || queue.length > 0) if (queue.length > 0) yield queue.shift();
-		else {
-			await new Promise((r) => {
-				resolve = r;
-			});
-			resolve = null;
-		}
-	} finally {
-		client.off("message:start", onStart);
-		client.off("message:chunk", onChunk);
-		client.off("message:complete", onComplete);
-		client.off("message:error", onError);
-		client.off("toolCall:received", onTool);
-	}
-}
-//#endregion
-//#region src/auto/createAgo.ts
-/**
-* Auto-detect AGO configuration from the DOM environment.
-*
-* Checks (in order of priority):
-* 1. `window.AGO` global object (widget config)
-* 2. `<meta>` tags: `<meta name="ago-api-key" content="...">`
-* 3. `data-ago-*` attributes on `<body>` or `<script data-ago-api-key="...">`
-* 4. Explicit overrides passed as argument
-*
-* Returns null if no API key can be found.
-*/
-function autoDetectConfig(overrides) {
-	let baseUrl;
-	let widgetId;
-	let agent;
-	let permission;
-	let userEmail;
-	let userJwt;
-	if (typeof window !== "undefined" && window.AGO) {
-		const ago = window.AGO;
-		baseUrl = ago.basepath;
-		widgetId = ago.widgetId;
-		agent = ago.agent || ago.defaultAgent;
-		permission = ago.permission;
-		userEmail = ago.email;
-		userJwt = ago.jwt;
-	}
-	if (typeof document !== "undefined") {
-		const getMeta = (name) => document.querySelector(`meta[name="${name}"]`)?.getAttribute("content") || void 0;
-		baseUrl = baseUrl || getMeta("ago-base-url");
-		widgetId = widgetId || getMeta("ago-widget-id");
-		agent = agent || getMeta("ago-agent") || getMeta("ago-agent-id");
-		permission = permission || getMeta("ago-permission");
-		userEmail = userEmail || getMeta("ago-user-email");
-	}
-	if (typeof document !== "undefined") {
-		const sources = [document.body, ...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);
-		for (const el of sources) {
-			if (!el) continue;
-			baseUrl = baseUrl || el.getAttribute("data-ago-base-url") || void 0;
-			widgetId = widgetId || el.getAttribute("data-ago-widget-id") || void 0;
-			agent = agent || el.getAttribute("data-ago-agent") || el.getAttribute("data-ago-agent-id") || void 0;
-			permission = permission || el.getAttribute("data-ago-permission") || void 0;
-			userEmail = userEmail || el.getAttribute("data-ago-user-email") || void 0;
-		}
-	}
-	baseUrl = overrides?.baseUrl || baseUrl;
-	widgetId = overrides?.widgetId || widgetId;
-	agent = overrides?.agent || overrides?.defaultAgentId || agent;
-	permission = overrides?.permission || permission;
-	userEmail = overrides?.userEmail || userEmail;
-	userJwt = overrides?.userJwt || userJwt;
-	const debug = overrides?.debug;
-	if (!baseUrl) return null;
-	return {
-		baseUrl,
-		widgetId,
-		agent,
-		permission,
-		userEmail,
-		userJwt,
-		debug
-	};
-}
-/**
-* Create an AgoClient with zero configuration.
-* Auto-detects config from window.AGO, meta tags, and data-ago-* attributes.
-*
-* ```html
-* <!-- In your HTML -->
-* <meta name="ago-base-url" content="https://YOUR-DOMAIN.useago.com">
-*
-* <!-- Or on a script tag -->
-* <script src="app.js" data-ago-base-url="https://YOUR-DOMAIN.useago.com"><\/script>
-* ```
-*
-* ```ts
-* import { createAgo } from "@useago/sdk";
-*
-* // Zero config — picks up from DOM
-* const client = createAgo();
-*
-* // Or with partial overrides
-* const client = createAgo({ debug: true });
-* ```
-*
-* Throws if no base URL can be detected.
-*/
-function createAgo(overrides) {
-	const config = autoDetectConfig(overrides);
-	if (!config) throw new Error("createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name=\"ago-base-url\">, or pass { baseUrl } explicitly.");
-	return new require_AgoClient.AgoClient(config);
-}
-//#endregion
-//#region src/helpers/factory.ts
-/**
-* Attach a handler to a pre-built function definition.
-*
-* Pre-built helpers (`showToast`, `trackEvent`, ...) ship with a no-op or
-* console-logging default handler. Use `withHandler` to wire them up to
-* your actual implementation without mutating the original definition.
-*
-* ```ts
-* import { showToast, withHandler } from "@useago/sdk";
-*
-* client.register(
-*   withHandler(showToast, (args) => {
-*     myToast(args.message as string);
-*     return { shown: true };
-*   })
-* );
-* ```
-*/
-function withHandler(definition, handler) {
-	return {
-		...definition,
-		handler
-	};
-}
-//#endregion
-exports.AgoApiError = require_AgoClient.AgoApiError;
-exports.AgoClient = require_AgoClient.AgoClient;
-exports.AgoError = require_AgoClient.AgoError;
-exports.AgoFunctionError = require_AgoClient.AgoFunctionError;
-exports.AgoNetworkError = require_AgoClient.AgoNetworkError;
-exports.AgoStreamError = require_AgoClient.AgoStreamError;
-exports.ClientContextRegistry = require_AgoClient.ClientContextRegistry;
-exports.EventEmitter = require_AgoClient.EventEmitter;
-exports.FunctionRegistry = require_AgoClient.FunctionRegistry;
-exports.SSEHandler = require_AgoClient.SSEHandler;
-exports.autoDetectConfig = autoDetectConfig;
-exports.copyToClipboard = require_functions.copyToClipboard;
-exports.createAgo = createAgo;
-exports.createMessageStream = createMessageStream;
-exports.createMockClient = require_createMockClient.createMockClient;
-exports.createStore = createStore;
-exports.defineFunction = defineFunction;
-exports.getLocalStorage = require_functions.getLocalStorage;
-exports.getUserLocation = require_functions.getUserLocation;
-exports.highlightElement = require_functions.highlightElement;
-exports.isStreamNetworkError = require_AgoClient.isStreamNetworkError;
-exports.logger = require_AgoClient.logger;
-exports.onFunctionInvoke = onFunctionInvoke;
-exports.onMessage = onMessage;
-exports.onMessageChunk = onMessageChunk;
-exports.onMessageError = onMessageError;
-exports.onMessageStart = onMessageStart;
-exports.onToolCall = onToolCall;
-exports.openUrl = require_functions.openUrl;
-exports.scrollToElement = require_functions.scrollToElement;
-exports.setLocalStorage = require_functions.setLocalStorage;
-exports.setTheme = require_functions.setTheme;
-exports.showConfirmDialog = require_functions.showConfirmDialog;
-exports.showNotification = require_functions.showNotification;
-exports.showToast = require_functions.showToast;
-exports.submitForm = require_functions.submitForm;
-exports.trackEvent = require_functions.trackEvent;
-exports.withHandler = withHandler;
-
-//# sourceMappingURL=index.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./AgoClient-bjN-z2ZQ.cjs"),p=require("./createFormCollector-H4Me_2uj.cjs"),A=require("./createMockClient-DQvFFWnc.cjs"),g=require("./functions-BH1X5kas.cjs");function h(e){return e}function C(e,o){return e.on("message:complete",o),()=>e.off("message:complete",o)}function E(e,o){return e.on("message:chunk",o),()=>e.off("message:chunk",o)}function y(e,o){return e.on("message:start",o),()=>e.off("message:start",o)}function S(e,o){return e.on("message:error",o),()=>e.off("message:error",o)}function b(e,o){return e.on("toolCall:received",o),()=>e.off("toolCall:received",o)}function M(e,o){return e.on("function:invoke",o),()=>e.off("function:invoke",o)}async function*k(e,o,l){const n=[];let r=null,a=!1;const c=s=>{n.push(s),r?.()},f=s=>c({type:"start",data:s}),t=s=>c({type:"chunk",data:s}),u=s=>{c({type:"complete",data:s}),a=!0,r?.()},m=s=>{c({type:"error",data:s}),a=!0,r?.()},d=s=>c({type:"toolCall",data:s});e.on("message:start",f),e.on("message:chunk",t),e.on("message:complete",u),e.on("message:error",m),e.on("toolCall:received",d),e.sendMessage(o,l).catch(()=>{a=!0,r?.()});try{for(;!a||n.length>0;)n.length>0?yield n.shift():(await new Promise(s=>{r=s}),r=null)}finally{e.off("message:start",f),e.off("message:chunk",t),e.off("message:complete",u),e.off("message:error",m),e.off("toolCall:received",d)}}function w(e){let o,l,n,r,a,c;if(typeof window<"u"&&window.AGO){const t=window.AGO;o=t.basepath,l=t.widgetId,n=t.agent||t.defaultAgent,r=t.permission,a=t.email,c=t.jwt}if(typeof document<"u"){const t=u=>document.querySelector(`meta[name="${u}"]`)?.getAttribute("content")||void 0;o=o||t("ago-base-url"),l=l||t("ago-widget-id"),n=n||t("ago-agent")||t("ago-agent-id"),r=r||t("ago-permission"),a=a||t("ago-user-email")}if(typeof document<"u"){const t=[document.body,...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);for(const u of t)u&&(o=o||u.getAttribute("data-ago-base-url")||void 0,l=l||u.getAttribute("data-ago-widget-id")||void 0,n=n||u.getAttribute("data-ago-agent")||u.getAttribute("data-ago-agent-id")||void 0,r=r||u.getAttribute("data-ago-permission")||void 0,a=a||u.getAttribute("data-ago-user-email")||void 0)}o=e?.baseUrl||o,l=e?.widgetId||l,n=e?.agent||e?.defaultAgentId||n,r=e?.permission||r,a=e?.userEmail||a,c=e?.userJwt||c;const f=e?.debug;return o?{baseUrl:o,widgetId:l,agent:n,permission:r,userEmail:a,userJwt:c,debug:f}:null}function v(e){const o=w(e);if(!o)throw new Error('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.');return new i.AgoClient(o)}function F(e,o){return{...e,handler:o}}exports.AgoApiError=i.AgoApiError;exports.AgoClient=i.AgoClient;exports.AgoError=i.AgoError;exports.AgoFunctionError=i.AgoFunctionError;exports.AgoNetworkError=i.AgoNetworkError;exports.AgoStreamError=i.AgoStreamError;exports.ClientContextRegistry=i.ClientContextRegistry;exports.EventEmitter=i.EventEmitter;exports.FunctionRegistry=i.FunctionRegistry;exports.SSEHandler=i.SSEHandler;exports.autoDetectConfig=w;exports.copyToClipboard=g.copyToClipboard;exports.createAgo=v;exports.createFormCollector=p.createFormCollector;exports.createMessageStream=k;exports.createMockClient=A.createMockClient;exports.createStore=p.createStore;exports.defineFunction=h;exports.getLocalStorage=g.getLocalStorage;exports.getUserLocation=g.getUserLocation;exports.highlightElement=g.highlightElement;exports.isStreamNetworkError=i.isStreamNetworkError;exports.logger=i.logger;exports.onFunctionInvoke=M;exports.onMessage=C;exports.onMessageChunk=E;exports.onMessageError=S;exports.onMessageStart=y;exports.onToolCall=b;exports.openUrl=g.openUrl;exports.scrollToElement=g.scrollToElement;exports.setLocalStorage=g.setLocalStorage;exports.setTheme=g.setTheme;exports.showConfirmDialog=g.showConfirmDialog;exports.showNotification=g.showNotification;exports.showToast=g.showToast;exports.submitForm=g.submitForm;exports.trackEvent=g.trackEvent;exports.withHandler=F;