@useago/sdk 0.1.6 → 0.1.7

package/dist/functions-C-wLEc8b.js

@@ -0,0 +1,306 @@
+const showToast = {
+  name: "showToast",
+  description: "Show a toast notification to the user. Use this to confirm actions or display brief messages.",
+  parameters: {
+    type: "object",
+    properties: {
+      message: { type: "string", description: "The message to display" },
+      type: {
+        type: "string",
+        description: "Toast type",
+        enum: ["success", "error", "warning", "info"]
+      },
+      duration: {
+        type: "number",
+        description: "Duration in milliseconds (default 3000)"
+      }
+    },
+    required: ["message"]
+  },
+  handler: async () => ({ shown: false, error: "No toast handler configured" })
+};
+const showNotification = {
+  name: "showNotification",
+  description: "Show a browser notification to the user. Useful for important alerts even when the tab is not focused.",
+  parameters: {
+    type: "object",
+    properties: {
+      title: { type: "string", description: "Notification title" },
+      body: { type: "string", description: "Notification body text" }
+    },
+    required: ["title"]
+  },
+  handler: async (args) => {
+    if (typeof Notification === "undefined") {
+      return { shown: false, error: "Notifications not supported" };
+    }
+    if (Notification.permission === "denied") {
+      return { shown: false, error: "Notification permission denied" };
+    }
+    if (Notification.permission !== "granted") {
+      await Notification.requestPermission();
+    }
+    if (Notification.permission === "granted") {
+      new Notification(args.title, { body: args.body });
+      return { shown: true };
+    }
+    return { shown: false, error: "Permission not granted" };
+  }
+};
+const openUrl = {
+  name: "openUrl",
+  description: "Open a URL in a new browser tab.",
+  parameters: {
+    type: "object",
+    properties: {
+      url: { type: "string", description: "The URL to open" }
+    },
+    required: ["url"]
+  },
+  handler: async (args) => {
+    window.open(args.url, "_blank", "noopener,noreferrer");
+    return { opened: true };
+  }
+};
+const copyToClipboard = {
+  name: "copyToClipboard",
+  description: "Copy text to the user's clipboard.",
+  parameters: {
+    type: "object",
+    properties: {
+      text: { type: "string", description: "The text to copy" }
+    },
+    required: ["text"]
+  },
+  handler: async (args) => {
+    await navigator.clipboard.writeText(args.text);
+    return { copied: true };
+  }
+};
+const setTheme = {
+  name: "setTheme",
+  description: "Change the application's color theme. Sets a data-theme attribute on the document element.",
+  parameters: {
+    type: "object",
+    properties: {
+      theme: {
+        type: "string",
+        description: "Theme to apply",
+        enum: ["light", "dark", "system"]
+      }
+    },
+    required: ["theme"]
+  },
+  handler: async (args) => {
+    const theme = args.theme;
+    document.documentElement.setAttribute("data-theme", theme);
+    if (theme === "dark") {
+      document.documentElement.classList.add("dark");
+    } else {
+      document.documentElement.classList.remove("dark");
+    }
+    return { theme, applied: true };
+  }
+};
+const showConfirmDialog = {
+  name: "showConfirmDialog",
+  description: "Show a confirmation dialog to the user and return their choice (true/false).",
+  parameters: {
+    type: "object",
+    properties: {
+      message: {
+        type: "string",
+        description: "The confirmation message to display"
+      }
+    },
+    required: ["message"]
+  },
+  handler: async (args) => {
+    const confirmed = window.confirm(args.message);
+    return { confirmed };
+  }
+};
+const getUserLocation = {
+  name: "getUserLocation",
+  description: "Get the user's current geographic location (requires permission).",
+  parameters: {
+    type: "object",
+    properties: {}
+  },
+  handler: async () => {
+    if (!navigator.geolocation) {
+      return { error: "Geolocation not supported" };
+    }
+    return new Promise((resolve) => {
+      navigator.geolocation.getCurrentPosition(
+        (pos) => resolve({
+          latitude: pos.coords.latitude,
+          longitude: pos.coords.longitude,
+          accuracy: pos.coords.accuracy
+        }),
+        (err) => resolve({ error: err.message })
+      );
+    });
+  }
+};
+const scrollToElement = {
+  name: "scrollToElement",
+  description: "Scroll the page to a specific element identified by CSS selector.",
+  parameters: {
+    type: "object",
+    properties: {
+      selector: {
+        type: "string",
+        description: "CSS selector of the element to scroll to (e.g. '#section-pricing')"
+      },
+      behavior: {
+        type: "string",
+        description: "Scroll behavior",
+        enum: ["smooth", "instant"]
+      }
+    },
+    required: ["selector"]
+  },
+  handler: async (args) => {
+    const el = document.querySelector(args.selector);
+    if (!el) {
+      return { scrolled: false, error: `Element not found: ${args.selector}` };
+    }
+    el.scrollIntoView({ behavior: args.behavior || "smooth" });
+    return { scrolled: true };
+  }
+};
+const setLocalStorage = {
+  name: "setLocalStorage",
+  description: "Store a value in the browser's localStorage.",
+  parameters: {
+    type: "object",
+    properties: {
+      key: { type: "string", description: "Storage key" },
+      value: { type: "string", description: "Value to store" }
+    },
+    required: ["key", "value"]
+  },
+  handler: async (args) => {
+    localStorage.setItem(args.key, args.value);
+    return { stored: true };
+  }
+};
+const getLocalStorage = {
+  name: "getLocalStorage",
+  description: "Retrieve a value from the browser's localStorage.",
+  parameters: {
+    type: "object",
+    properties: {
+      key: { type: "string", description: "Storage key" }
+    },
+    required: ["key"]
+  },
+  handler: async (args) => {
+    const value = localStorage.getItem(args.key);
+    return { key: args.key, value, found: value !== null };
+  }
+};
+const highlightElement = {
+  name: "highlightElement",
+  description: "Highlight a DOM element to draw the user's attention (e.g. for onboarding).",
+  parameters: {
+    type: "object",
+    properties: {
+      selector: {
+        type: "string",
+        description: "CSS selector of the element to highlight"
+      },
+      color: {
+        type: "string",
+        description: "Highlight border color (default: #3b82f6)"
+      }
+    },
+    required: ["selector"]
+  },
+  handler: async (args) => {
+    const el = document.querySelector(args.selector);
+    if (!el) {
+      return { highlighted: false, error: `Element not found: ${args.selector}` };
+    }
+    const prev = el.style.outline;
+    const color = args.color || "#3b82f6";
+    el.style.outline = `3px solid ${color}`;
+    el.style.outlineOffset = "2px";
+    el.scrollIntoView({ behavior: "smooth", block: "center" });
+    setTimeout(() => {
+      el.style.outline = prev;
+      el.style.outlineOffset = "";
+    }, 3e3);
+    return { highlighted: true };
+  }
+};
+const submitForm = {
+  name: "submitForm",
+  description: "Fill and submit an HTML form on the page. Pass field values as key-value pairs.",
+  parameters: {
+    type: "object",
+    properties: {
+      selector: {
+        type: "string",
+        description: "CSS selector of the form element"
+      },
+      values: {
+        type: "string",
+        description: "JSON string of field name → value pairs"
+      }
+    },
+    required: ["selector"]
+  },
+  handler: async (args) => {
+    const form = document.querySelector(args.selector);
+    if (!form) {
+      return { submitted: false, error: `Form not found: ${args.selector}` };
+    }
+    if (args.values) {
+      const values = JSON.parse(args.values);
+      for (const [name, value] of Object.entries(values)) {
+        const input = form.elements.namedItem(name);
+        if (input) input.value = value;
+      }
+    }
+    form.requestSubmit();
+    return { submitted: true };
+  }
+};
+const trackEvent = {
+  name: "trackEvent",
+  description: "Track a custom analytics event. Override the handler to wire up your analytics provider.",
+  parameters: {
+    type: "object",
+    properties: {
+      event: { type: "string", description: "Event name" },
+      properties: {
+        type: "string",
+        description: "JSON string of event properties"
+      }
+    },
+    required: ["event"]
+  },
+  handler: async (args) => {
+    const props = args.properties ? JSON.parse(args.properties) : {};
+    console.log(`[AGO Analytics] ${args.event}`, props);
+    return { tracked: true, event: args.event };
+  }
+};
+export {
+  copyToClipboard,
+  getLocalStorage,
+  getUserLocation,
+  highlightElement,
+  openUrl,
+  scrollToElement,
+  setLocalStorage,
+  setTheme,
+  showConfirmDialog,
+  showNotification,
+  showToast,
+  submitForm,
+  trackEvent
+};
+//# sourceMappingURL=functions-C-wLEc8b.js.map

package/dist/functions-C-wLEc8b.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions-C-wLEc8b.js","sources":["../src/helpers/functions.ts"],"sourcesContent":["import type { ClientFunctionDefinition } from \"../functions/types\";\n\n/**\n * Show a toast/notification to the user.\n * The handler is a no-op by default — wire it up to your toast library.\n *\n * ```ts\n * import { showToast } from \"@useago/sdk/helpers\";\n * showToast.handler = async (args) => { myToast(args.message); return { shown: true }; };\n * client.registerFunction(showToast);\n * ```\n */\nexport const showToast: ClientFunctionDefinition = {\n  name: \"showToast\",\n  description:\n    \"Show a toast notification to the user. Use this to confirm actions or display brief messages.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      message: { type: \"string\", description: \"The message to display\" },\n      type: {\n        type: \"string\",\n        description: \"Toast type\",\n        enum: [\"success\", \"error\", \"warning\", \"info\"],\n      },\n      duration: {\n        type: \"number\",\n        description: \"Duration in milliseconds (default 3000)\",\n      },\n    },\n    required: [\"message\"],\n  },\n  handler: async () => ({ shown: false, error: \"No toast handler configured\" }),\n};\n\n/**\n * Show a browser notification (requires permission).\n */\nexport const showNotification: ClientFunctionDefinition = {\n  name: \"showNotification\",\n  description:\n    \"Show a browser notification to the user. Useful for important alerts even when the tab is not focused.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      title: { type: \"string\", description: \"Notification title\" },\n      body: { type: \"string\", description: \"Notification body text\" },\n    },\n    required: [\"title\"],\n  },\n  handler: async (args) => {\n    if (typeof Notification === \"undefined\") {\n      return { shown: false, error: \"Notifications not supported\" };\n    }\n    if (Notification.permission === \"denied\") {\n      return { shown: false, error: \"Notification permission denied\" };\n    }\n    if (Notification.permission !== \"granted\") {\n      await Notification.requestPermission();\n    }\n    if (Notification.permission === \"granted\") {\n      new Notification(args.title as string, { body: args.body as string });\n      return { shown: true };\n    }\n    return { shown: false, error: \"Permission not granted\" };\n  },\n};\n\n/**\n * Open a URL in a new tab.\n */\nexport const openUrl: ClientFunctionDefinition = {\n  name: \"openUrl\",\n  description: \"Open a URL in a new browser tab.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      url: { type: \"string\", description: \"The URL to open\" },\n    },\n    required: [\"url\"],\n  },\n  handler: async (args) => {\n    window.open(args.url as string, \"_blank\", \"noopener,noreferrer\");\n    return { opened: true };\n  },\n};\n\n/**\n * Copy text to clipboard.\n */\nexport const copyToClipboard: ClientFunctionDefinition = {\n  name: \"copyToClipboard\",\n  description: \"Copy text to the user's clipboard.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      text: { type: \"string\", description: \"The text to copy\" },\n    },\n    required: [\"text\"],\n  },\n  handler: async (args) => {\n    await navigator.clipboard.writeText(args.text as string);\n    return { copied: true };\n  },\n};\n\n/**\n * Set the application theme (light/dark/system).\n * Default handler toggles a `data-theme` attribute on `<html>`.\n */\nexport const setTheme: ClientFunctionDefinition = {\n  name: \"setTheme\",\n  description:\n    \"Change the application's color theme. Sets a data-theme attribute on the document element.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      theme: {\n        type: \"string\",\n        description: \"Theme to apply\",\n        enum: [\"light\", \"dark\", \"system\"],\n      },\n    },\n    required: [\"theme\"],\n  },\n  handler: async (args) => {\n    const theme = args.theme as string;\n    document.documentElement.setAttribute(\"data-theme\", theme);\n    if (theme === \"dark\") {\n      document.documentElement.classList.add(\"dark\");\n    } else {\n      document.documentElement.classList.remove(\"dark\");\n    }\n    return { theme, applied: true };\n  },\n};\n\n/**\n * Show a confirm dialog and return the user's choice.\n */\nexport const showConfirmDialog: ClientFunctionDefinition = {\n  name: \"showConfirmDialog\",\n  description:\n    \"Show a confirmation dialog to the user and return their choice (true/false).\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      message: {\n        type: \"string\",\n        description: \"The confirmation message to display\",\n      },\n    },\n    required: [\"message\"],\n  },\n  handler: async (args) => {\n    const confirmed = window.confirm(args.message as string);\n    return { confirmed };\n  },\n};\n\n/**\n * Get the user's geolocation.\n */\nexport const getUserLocation: ClientFunctionDefinition = {\n  name: \"getUserLocation\",\n  description:\n    \"Get the user's current geographic location (requires permission).\",\n  parameters: {\n    type: \"object\",\n    properties: {},\n  },\n  handler: async () => {\n    if (!navigator.geolocation) {\n      return { error: \"Geolocation not supported\" };\n    }\n    return new Promise((resolve) => {\n      navigator.geolocation.getCurrentPosition(\n        (pos) =>\n          resolve({\n            latitude: pos.coords.latitude,\n            longitude: pos.coords.longitude,\n            accuracy: pos.coords.accuracy,\n          }),\n        (err) => resolve({ error: err.message })\n      );\n    });\n  },\n};\n\n/**\n * Scroll to an element on the page.\n */\nexport const scrollToElement: ClientFunctionDefinition = {\n  name: \"scrollToElement\",\n  description: \"Scroll the page to a specific element identified by CSS selector.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      selector: {\n        type: \"string\",\n        description: \"CSS selector of the element to scroll to (e.g. '#section-pricing')\",\n      },\n      behavior: {\n        type: \"string\",\n        description: \"Scroll behavior\",\n        enum: [\"smooth\", \"instant\"],\n      },\n    },\n    required: [\"selector\"],\n  },\n  handler: async (args) => {\n    const el = document.querySelector(args.selector as string);\n    if (!el) {\n      return { scrolled: false, error: `Element not found: ${args.selector}` };\n    }\n    el.scrollIntoView({ behavior: (args.behavior as ScrollBehavior) || \"smooth\" });\n    return { scrolled: true };\n  },\n};\n\n/**\n * Set a value in localStorage.\n */\nexport const setLocalStorage: ClientFunctionDefinition = {\n  name: \"setLocalStorage\",\n  description: \"Store a value in the browser's localStorage.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      key: { type: \"string\", description: \"Storage key\" },\n      value: { type: \"string\", description: \"Value to store\" },\n    },\n    required: [\"key\", \"value\"],\n  },\n  handler: async (args) => {\n    localStorage.setItem(args.key as string, args.value as string);\n    return { stored: true };\n  },\n};\n\n/**\n * Get a value from localStorage.\n */\nexport const getLocalStorage: ClientFunctionDefinition = {\n  name: \"getLocalStorage\",\n  description: \"Retrieve a value from the browser's localStorage.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      key: { type: \"string\", description: \"Storage key\" },\n    },\n    required: [\"key\"],\n  },\n  handler: async (args) => {\n    const value = localStorage.getItem(args.key as string);\n    return { key: args.key, value, found: value !== null };\n  },\n};\n\n/**\n * Highlight an element on the page (useful for guided tours).\n */\nexport const highlightElement: ClientFunctionDefinition = {\n  name: \"highlightElement\",\n  description:\n    \"Highlight a DOM element to draw the user's attention (e.g. for onboarding).\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      selector: {\n        type: \"string\",\n        description: \"CSS selector of the element to highlight\",\n      },\n      color: {\n        type: \"string\",\n        description: \"Highlight border color (default: #3b82f6)\",\n      },\n    },\n    required: [\"selector\"],\n  },\n  handler: async (args) => {\n    const el = document.querySelector(args.selector as string) as HTMLElement | null;\n    if (!el) {\n      return { highlighted: false, error: `Element not found: ${args.selector}` };\n    }\n    const prev = el.style.outline;\n    const color = (args.color as string) || \"#3b82f6\";\n    el.style.outline = `3px solid ${color}`;\n    el.style.outlineOffset = \"2px\";\n    el.scrollIntoView({ behavior: \"smooth\", block: \"center\" });\n    setTimeout(() => {\n      el.style.outline = prev;\n      el.style.outlineOffset = \"\";\n    }, 3000);\n    return { highlighted: true };\n  },\n};\n\n/**\n * Submit a form on the page programmatically.\n */\nexport const submitForm: ClientFunctionDefinition = {\n  name: \"submitForm\",\n  description:\n    \"Fill and submit an HTML form on the page. Pass field values as key-value pairs.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      selector: {\n        type: \"string\",\n        description: \"CSS selector of the form element\",\n      },\n      values: {\n        type: \"string\",\n        description: \"JSON string of field name → value pairs\",\n      },\n    },\n    required: [\"selector\"],\n  },\n  handler: async (args) => {\n    const form = document.querySelector(args.selector as string) as HTMLFormElement | null;\n    if (!form) {\n      return { submitted: false, error: `Form not found: ${args.selector}` };\n    }\n    if (args.values) {\n      const values = JSON.parse(args.values as string) as Record<string, string>;\n      for (const [name, value] of Object.entries(values)) {\n        const input = form.elements.namedItem(name) as HTMLInputElement | null;\n        if (input) input.value = value;\n      }\n    }\n    form.requestSubmit();\n    return { submitted: true };\n  },\n};\n\n/**\n * Track a custom analytics event.\n * Default handler logs to console — replace with your analytics provider.\n */\nexport const trackEvent: ClientFunctionDefinition = {\n  name: \"trackEvent\",\n  description:\n    \"Track a custom analytics event. Override the handler to wire up your analytics provider.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      event: { type: \"string\", description: \"Event name\" },\n      properties: {\n        type: \"string\",\n        description: \"JSON string of event properties\",\n      },\n    },\n    required: [\"event\"],\n  },\n  handler: async (args) => {\n    const props = args.properties ? JSON.parse(args.properties as string) : {};\n    console.log(`[AGO Analytics] ${args.event}`, props);\n    return { tracked: true, event: args.event };\n  },\n};\n"],"names":[],"mappings":"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"}

package/dist/helpers/factory.d.ts

@@ -0,0 +1,20 @@
+import type { ClientFunctionDefinition, ClientFunctionHandler } from "../functions/types";
+/**
+ * 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 };
+ *   })
+ * );
+ * ```
+ */
+export declare function withHandler<T extends ClientFunctionDefinition>(definition: T, handler: ClientFunctionHandler): T;

package/dist/helpers/functions.d.ts

@@ -0,0 +1,62 @@
+import type { ClientFunctionDefinition } from "../functions/types";
+/**
+ * Show a toast/notification to the user.
+ * The handler is a no-op by default — wire it up to your toast library.
+ *
+ * ```ts
+ * import { showToast } from "@useago/sdk/helpers";
+ * showToast.handler = async (args) => { myToast(args.message); return { shown: true }; };
+ * client.registerFunction(showToast);
+ * ```
+ */
+export declare const showToast: ClientFunctionDefinition;
+/**
+ * Show a browser notification (requires permission).
+ */
+export declare const showNotification: ClientFunctionDefinition;
+/**
+ * Open a URL in a new tab.
+ */
+export declare const openUrl: ClientFunctionDefinition;
+/**
+ * Copy text to clipboard.
+ */
+export declare const copyToClipboard: ClientFunctionDefinition;
+/**
+ * Set the application theme (light/dark/system).
+ * Default handler toggles a `data-theme` attribute on `<html>`.
+ */
+export declare const setTheme: ClientFunctionDefinition;
+/**
+ * Show a confirm dialog and return the user's choice.
+ */
+export declare const showConfirmDialog: ClientFunctionDefinition;
+/**
+ * Get the user's geolocation.
+ */
+export declare const getUserLocation: ClientFunctionDefinition;
+/**
+ * Scroll to an element on the page.
+ */
+export declare const scrollToElement: ClientFunctionDefinition;
+/**
+ * Set a value in localStorage.
+ */
+export declare const setLocalStorage: ClientFunctionDefinition;
+/**
+ * Get a value from localStorage.
+ */
+export declare const getLocalStorage: ClientFunctionDefinition;
+/**
+ * Highlight an element on the page (useful for guided tours).
+ */
+export declare const highlightElement: ClientFunctionDefinition;
+/**
+ * Submit a form on the page programmatically.
+ */
+export declare const submitForm: ClientFunctionDefinition;
+/**
+ * Track a custom analytics event.
+ * Default handler logs to console — replace with your analytics provider.
+ */
+export declare const trackEvent: ClientFunctionDefinition;

package/dist/helpers/index.d.ts

@@ -0,0 +1 @@
+export { showToast, showNotification, openUrl, copyToClipboard, setTheme, showConfirmDialog, getUserLocation, scrollToElement, setLocalStorage, getLocalStorage, highlightElement, submitForm, trackEvent, } from "./functions";

package/dist/helpers.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const helpers = require("./functions-B0Z0rNQW.cjs");
+exports.copyToClipboard = helpers.copyToClipboard;
+exports.getLocalStorage = helpers.getLocalStorage;
+exports.getUserLocation = helpers.getUserLocation;
+exports.highlightElement = helpers.highlightElement;
+exports.openUrl = helpers.openUrl;
+exports.scrollToElement = helpers.scrollToElement;
+exports.setLocalStorage = helpers.setLocalStorage;
+exports.setTheme = helpers.setTheme;
+exports.showConfirmDialog = helpers.showConfirmDialog;
+exports.showNotification = helpers.showNotification;
+exports.showToast = helpers.showToast;
+exports.submitForm = helpers.submitForm;
+exports.trackEvent = helpers.trackEvent;
+//# sourceMappingURL=helpers.cjs.map

package/dist/helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}

package/dist/helpers.d.ts

@@ -0,0 +1 @@
+export * from './helpers/index'

package/dist/helpers.js

@@ -0,0 +1,17 @@
+import { copyToClipboard, getLocalStorage, getUserLocation, highlightElement, openUrl, scrollToElement, setLocalStorage, setTheme, showConfirmDialog, showNotification, showToast, submitForm, trackEvent } from "./functions-C-wLEc8b.js";
+export {
+  copyToClipboard,
+  getLocalStorage,
+  getUserLocation,
+  highlightElement,
+  openUrl,
+  scrollToElement,
+  setLocalStorage,
+  setTheme,
+  showConfirmDialog,
+  showNotification,
+  showToast,
+  submitForm,
+  trackEvent
+};
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/index.cjs

@@ -1,20 +1,187 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const createMockClient = require("./createMockClient-BZKh_1em.cjs");
+const AgoClient = require("./AgoClient-BDO4avLq.cjs");
+const createMockClient = require("./createMockClient-BqNSJUu4.cjs");
+const helpers = require("./functions-B0Z0rNQW.cjs");
 function defineFunction(definition) {
   return definition;
 }
-exports.AgoApiError = createMockClient.AgoApiError;
-exports.AgoClient = createMockClient.AgoClient;
-exports.AgoError = createMockClient.AgoError;
-exports.AgoFunctionError = createMockClient.AgoFunctionError;
-exports.AgoNetworkError = createMockClient.AgoNetworkError;
-exports.AgoStreamError = createMockClient.AgoStreamError;
-exports.EventEmitter = createMockClient.EventEmitter;
-exports.FunctionRegistry = createMockClient.FunctionRegistry;
-exports.SSEHandler = createMockClient.SSEHandler;
+function onMessage(client, callback) {
+  client.on("message:complete", callback);
+  return () => client.off("message:complete", callback);
+}
+function onMessageChunk(client, callback) {
+  client.on("message:chunk", callback);
+  return () => client.off("message:chunk", callback);
+}
+function onMessageStart(client, callback) {
+  client.on("message:start", callback);
+  return () => client.off("message:start", callback);
+}
+function onMessageError(client, callback) {
+  client.on("message:error", callback);
+  return () => client.off("message:error", callback);
+}
+function onToolCall(client, callback) {
+  client.on("toolCall:received", callback);
+  return () => client.off("toolCall:received", callback);
+}
+function onFunctionInvoke(client, callback) {
+  client.on("function:invoke", callback);
+  return () => client.off("function:invoke", callback);
+}
+async function* createMessageStream(client, content, options) {
+  const queue = [];
+  let resolve = null;
+  let done = false;
+  const push = (event) => {
+    queue.push(event);
+    resolve == null ? void 0 : 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 == null ? void 0 : resolve();
+  };
+  const onError = (data) => {
+    push({ type: "error", data });
+    done = true;
+    resolve == null ? void 0 : 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 == null ? void 0 : 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);
+  }
+}
+function autoDetectConfig(overrides) {
+  let baseUrl;
+  let widgetId;
+  let defaultAgentId;
+  let userEmail;
+  let userJwt;
+  let debug;
+  if (typeof window !== "undefined" && window.AGO) {
+    const ago = window.AGO;
+    baseUrl = ago.basepath;
+    widgetId = ago.widgetId;
+    defaultAgentId = ago.defaultAgent;
+    userEmail = ago.email;
+    userJwt = ago.jwt;
+  }
+  if (typeof document !== "undefined") {
+    const getMeta = (name) => {
+      var _a;
+      return ((_a = document.querySelector(`meta[name="${name}"]`)) == null ? void 0 : _a.getAttribute("content")) || void 0;
+    };
+    baseUrl = baseUrl || getMeta("ago-base-url");
+    widgetId = widgetId || getMeta("ago-widget-id");
+    defaultAgentId = defaultAgentId || getMeta("ago-agent-id");
+    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;
+      defaultAgentId = defaultAgentId || el.getAttribute("data-ago-agent-id") || void 0;
+      userEmail = userEmail || el.getAttribute("data-ago-user-email") || void 0;
+    }
+  }
+  baseUrl = (overrides == null ? void 0 : overrides.baseUrl) || baseUrl;
+  widgetId = (overrides == null ? void 0 : overrides.widgetId) || widgetId;
+  defaultAgentId = (overrides == null ? void 0 : overrides.defaultAgentId) || defaultAgentId;
+  userEmail = (overrides == null ? void 0 : overrides.userEmail) || userEmail;
+  userJwt = (overrides == null ? void 0 : overrides.userJwt) || userJwt;
+  debug = (overrides == null ? void 0 : overrides.debug) ?? debug;
+  if (!baseUrl) {
+    return null;
+  }
+  return {
+    baseUrl,
+    widgetId,
+    defaultAgentId,
+    userEmail,
+    userJwt,
+    debug
+  };
+}
+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 AgoClient.AgoClient(config);
+}
+function withHandler(definition, handler) {
+  return { ...definition, handler };
+}
+exports.AgoApiError = AgoClient.AgoApiError;
+exports.AgoClient = AgoClient.AgoClient;
+exports.AgoError = AgoClient.AgoError;
+exports.AgoFunctionError = AgoClient.AgoFunctionError;
+exports.AgoNetworkError = AgoClient.AgoNetworkError;
+exports.AgoStreamError = AgoClient.AgoStreamError;
+exports.ClientContextRegistry = AgoClient.ClientContextRegistry;
+exports.EventEmitter = AgoClient.EventEmitter;
+exports.FunctionRegistry = AgoClient.FunctionRegistry;
+exports.SSEHandler = AgoClient.SSEHandler;
+exports.isStreamNetworkError = AgoClient.isStreamNetworkError;
+exports.logger = AgoClient.logger;
 exports.createMockClient = createMockClient.createMockClient;
-exports.isStreamNetworkError = createMockClient.isStreamNetworkError;
-exports.logger = createMockClient.logger;
+exports.copyToClipboard = helpers.copyToClipboard;
+exports.getLocalStorage = helpers.getLocalStorage;
+exports.getUserLocation = helpers.getUserLocation;
+exports.highlightElement = helpers.highlightElement;
+exports.openUrl = helpers.openUrl;
+exports.scrollToElement = helpers.scrollToElement;
+exports.setLocalStorage = helpers.setLocalStorage;
+exports.setTheme = helpers.setTheme;
+exports.showConfirmDialog = helpers.showConfirmDialog;
+exports.showNotification = helpers.showNotification;
+exports.showToast = helpers.showToast;
+exports.submitForm = helpers.submitForm;
+exports.trackEvent = helpers.trackEvent;
+exports.autoDetectConfig = autoDetectConfig;
+exports.createAgo = createAgo;
+exports.createMessageStream = createMessageStream;
 exports.defineFunction = defineFunction;
+exports.onFunctionInvoke = onFunctionInvoke;
+exports.onMessage = onMessage;
+exports.onMessageChunk = onMessageChunk;
+exports.onMessageError = onMessageError;
+exports.onMessageStart = onMessageStart;
+exports.onToolCall = onToolCall;
+exports.withHandler = withHandler;
 //# sourceMappingURL=index.cjs.map