@iota-uz/sdk 0.3.4 → 0.4.8

package/README.md

@@ -0,0 +1,117 @@
+# Applets
+
+Go library and CLI for the applet framework, plus the **@iota-uz/sdk** npm package (applet context, host, UI components, Tailwind helpers). Consumed by [iota-sdk](https://github.com/iota-uz/iota-sdk) and EAI to build and run applets (e.g. BiChat).
+
+Full architecture and development guides live in [iota-sdk docs](https://github.com/iota-uz/iota-sdk).
+
+---
+
+## Go
+
+Add the module to your project:
+
+```bash
+go get github.com/iota-uz/applets@latest
+```
+
+Import the public API from the root package:
+
+```go
+import "github.com/iota-uz/applets"
+```
+
+Use `Registry`, `Controller`, RPC types, context helpers, and options as needed. For local development with a clone of this repo, use a [Go workspace](https://go.dev/ref/mod#workspaces) in your project with `use` pointing at the applets directory.
+
+---
+
+## NPM
+
+Install the SDK in your applet frontend (e.g. Vite/React):
+
+```bash
+pnpm add @iota-uz/sdk
+```
+
+Use applet context, host utilities, BiChat UI components, and Tailwind configuration from the package.
+
+---
+
+## Applet CLI
+
+Install the CLI (ensure `$GOBIN` is on your PATH):
+
+```bash
+go install github.com/iota-uz/applets/cmd/applet@latest
+```
+
+From a repo that contains an applet (e.g. iota-sdk or EAI):
+
+```bash
+applet doctor              # environment and config diagnostics
+applet rpc gen --name <applet-name>
+applet rpc check --name <applet-name>
+applet deps check
+applet check               # deps + RPC drift for all applets
+applet dev [name]          # start dev environment
+applet build [name]        # build production bundle
+applet list                # list configured applets
+```
+
+- **Specific version:** `go install github.com/iota-uz/applets/cmd/applet@v0.4.4`
+- **Shell completion:** `applet completion bash`, `applet completion zsh`, or `applet completion fish` — see `applet completion --help` for install instructions.
+
+---
+
+## Configuration
+
+The CLI expects a project root where `.applets/config.toml` exists (or, for `applet deps check`, a repo with a `go.mod` for `github.com/iota-uz/iota-sdk` or `github.com/iota-uz/eai`).
+
+Example `.applets/config.toml` with all options documented in comments:
+
+```toml
+# --- Dev (project-level) ---
+[dev]
+# Backend port for dev manifest. Default: 3200
+backend_port = 3200
+
+# Project-level processes (e.g. air, templ). At least one required.
+# Each process: name (required), command (required), args (optional), critical (optional), env (optional).
+[[dev.processes]]
+name = "air"
+command = "air"
+args = ["-c", ".air.toml"]
+critical = true
+# env = { FOO = "bar" }
+
+[[dev.processes]]
+name = "templ"
+command = "templ"
+args = ["generate", "--watch"]
+
+# --- Applets (per-app) ---
+# Each applet: base_path (required), module, web, entry (optional; see defaults below).
+[applets.bichat]
+base_path = "/bi-chat"
+# module = "modules/bichat"                    # default: modules/<name>
+# web = "modules/bichat/presentation/web"       # default: modules/<name>/presentation/web
+# entry = "/src/main.tsx"                       # default: /src/main.tsx
+
+[applets.bichat.dev]
+# Vite dev server port. Default: unique per applet (5173, 5174, …)
+vite_port = 5173
+
+[applets.bichat.rpc]
+# Go function name for RPC codegen. Default: "Router"
+router_func = "Router"
+# If true, the applet module re-exports the RPC contract from the SDK package. Default: false
+needs_reexport_shim = false
+
+# Second applet: only required fields + overrides; rest use defaults
+[applets.otherapp]
+base_path = "/other"
+module = "modules/otherapp"
+web = "modules/otherapp/frontend"
+# dev.vite_port and rpc.* use defaults (unique port, Router, false)
+```
+
+Defaults are applied in sorted applet name order; `vite_port` is made unique when not set to avoid conflicts. Run `applet doctor` to validate config and environment.

package/dist/applet/core.cjs

@@ -0,0 +1,251 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// ui/src/applet-core/context/AppletContext.tsx
+var AppletContext = react.createContext(null);
+var REQUIRED_KEYS = ["user", "tenant", "locale", "config", "route", "session"];
+function validateInitialContext(value, windowKey) {
+  if (!value || typeof value !== "object") {
+    throw new Error(`${windowKey}: expected an object, got ${typeof value}`);
+  }
+  const obj = value;
+  const missing = REQUIRED_KEYS.filter((k) => !(k in obj));
+  if (missing.length > 0) {
+    throw new Error(`${windowKey}: missing required keys: ${missing.join(", ")}`);
+  }
+  const user = obj.user;
+  if (!user || typeof user !== "object") {
+    throw new Error(`${windowKey}.user: expected an object, got ${typeof user}`);
+  }
+  if (typeof user.id !== "number") {
+    throw new Error(`${windowKey}.user.id: expected number, got ${typeof user.id}`);
+  }
+  if (!Array.isArray(user.permissions)) {
+    throw new Error(`${windowKey}.user.permissions: expected array, got ${typeof user.permissions}`);
+  }
+  const tenant = obj.tenant;
+  if (!tenant || typeof tenant !== "object") {
+    throw new Error(`${windowKey}.tenant: expected an object, got ${typeof tenant}`);
+  }
+  if (typeof tenant.id !== "string") {
+    throw new Error(`${windowKey}.tenant.id: expected string, got ${typeof tenant.id}`);
+  }
+  const session = obj.session;
+  if (!session || typeof session !== "object") {
+    throw new Error(`${windowKey}.session: expected an object, got ${typeof session}`);
+  }
+  if (typeof session.csrfToken !== "string") {
+    throw new Error(`${windowKey}.session.csrfToken: expected string, got ${typeof session.csrfToken}`);
+  }
+  if (typeof session.expiresAt !== "number") {
+    throw new Error(`${windowKey}.session.expiresAt: expected number, got ${typeof session.expiresAt}`);
+  }
+  if (typeof session.refreshURL !== "string") {
+    throw new Error(`${windowKey}.session.refreshURL: expected string, got ${typeof session.refreshURL}`);
+  }
+  const config = obj.config;
+  if (!config || typeof config !== "object") {
+    throw new Error(`${windowKey}.config: expected object, got ${typeof config}`);
+  }
+  return value;
+}
+function AppletProvider({ children, windowKey, context }) {
+  const raw = context ?? window[windowKey];
+  if (!raw) {
+    throw new Error(`${windowKey} not found on window. Ensure backend context injection is working.`);
+  }
+  const initialContext = validateInitialContext(raw, windowKey);
+  return /* @__PURE__ */ jsxRuntime.jsx(AppletContext.Provider, { value: initialContext, children });
+}
+function useAppletContext() {
+  const context = react.useContext(AppletContext);
+  if (!context) {
+    throw new Error("useAppletContext must be used within AppletProvider");
+  }
+  return context;
+}
+var ConfigContext = react.createContext(null);
+function ConfigProvider({ children, config }) {
+  return /* @__PURE__ */ jsxRuntime.jsx(ConfigContext.Provider, { value: config, children });
+}
+function useConfigContext() {
+  const context = react.useContext(ConfigContext);
+  if (!context) {
+    throw new Error("useConfigContext must be used within ConfigProvider");
+  }
+  return context;
+}
+
+// ui/src/applet-core/hooks/useAppletContext.ts
+function useAppletContext2(windowKey) {
+  const context = window[windowKey];
+  if (!context) {
+    throw new Error(`${windowKey} not found on window. Ensure backend context injection is working.`);
+  }
+  return context;
+}
+
+// ui/src/applet-core/hooks/useConfig.ts
+function useConfig() {
+  const { config } = useAppletContext();
+  return config;
+}
+
+// ui/src/applet-core/hooks/useUser.ts
+function useUser() {
+  const { user } = useAppletContext();
+  return user;
+}
+
+// ui/src/applet-core/hooks/usePermissions.ts
+function usePermissions() {
+  const { user } = useAppletContext();
+  const hasPermission = (permission) => {
+    return user.permissions.includes(permission);
+  };
+  const hasAnyPermission = (...permissions) => {
+    return permissions.some((p) => user.permissions.includes(p));
+  };
+  return {
+    hasPermission,
+    hasAnyPermission,
+    permissions: user.permissions
+  };
+}
+
+// ui/src/applet-core/hooks/useTranslation.ts
+function useTranslation() {
+  const { locale } = useAppletContext();
+  const t = (key, params) => {
+    let text = locale.translations[key] || key;
+    if (params) {
+      Object.entries(params).forEach(([k, v]) => {
+        text = text.replace(new RegExp(`\\{${k}\\}`, "g"), String(v));
+      });
+    }
+    return text;
+  };
+  return {
+    t,
+    language: locale.language
+  };
+}
+function useSession(options) {
+  const { session } = useAppletContext();
+  const loginPath = options?.loginPath ?? "/login";
+  const isExpiringSoon = react.useMemo(() => {
+    const bufferMs = 5 * 60 * 1e3;
+    return session.expiresAt - Date.now() < bufferMs;
+  }, [session.expiresAt]);
+  const refreshSession = async () => {
+    const response = await fetch(session.refreshURL, {
+      method: "POST",
+      headers: {
+        "X-CSRF-Token": session.csrfToken
+      }
+    });
+    if (!response.ok) {
+      const returnUrl = encodeURIComponent(window.location.pathname);
+      window.location.href = `${loginPath}?redirect=${returnUrl}`;
+      return;
+    }
+    const newToken = response.headers.get("X-CSRF-Token");
+    if (newToken) {
+      window.dispatchEvent(
+        new CustomEvent("iota:csrf-refresh", {
+          detail: { token: newToken }
+        })
+      );
+    }
+  };
+  return {
+    isExpiringSoon,
+    refreshSession,
+    csrfToken: session.csrfToken,
+    expiresAt: session.expiresAt
+  };
+}
+
+// ui/src/applet-core/hooks/useRoute.ts
+function useRoute() {
+  const { route } = useAppletContext();
+  return route;
+}
+function useStreaming() {
+  const [isStreaming, setIsStreaming] = react.useState(false);
+  const abortControllerRef = react.useRef(null);
+  const processStream = react.useCallback(
+    async (generator, onChunk, signal) => {
+      setIsStreaming(true);
+      const controller = new AbortController();
+      abortControllerRef.current = controller;
+      if (signal) {
+        signal.addEventListener("abort", () => {
+          controller.abort();
+        });
+      }
+      try {
+        for await (const chunk of generator) {
+          if (controller.signal.aborted) {
+            break;
+          }
+          onChunk(chunk);
+        }
+      } catch (error) {
+        if (controller.signal.aborted) {
+          return;
+        }
+        throw error;
+      } finally {
+        setIsStreaming(false);
+        abortControllerRef.current = null;
+      }
+    },
+    []
+  );
+  const cancel = react.useCallback(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+    }
+    setIsStreaming(false);
+  }, []);
+  const reset = react.useCallback(() => {
+    abortControllerRef.current = null;
+    setIsStreaming(false);
+  }, []);
+  return {
+    isStreaming,
+    processStream,
+    cancel,
+    reset
+  };
+}
+
+// ui/src/applet-core/hooks/useAppletRuntime.ts
+function useAppletRuntime() {
+  const config = useConfig();
+  const basePath = config.basePath ?? "";
+  const normalizedBasePath = basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
+  const assetsBasePath = config.assetsBasePath ?? `${normalizedBasePath || ""}/assets`;
+  const rpcEndpoint = config.rpcUIEndpoint;
+  const shellMode = config.shellMode;
+  return { basePath: normalizedBasePath, assetsBasePath, rpcEndpoint, shellMode };
+}
+
+exports.AppletProvider = AppletProvider;
+exports.ConfigProvider = ConfigProvider;
+exports.useAppletContext = useAppletContext;
+exports.useAppletContextDirect = useAppletContext2;
+exports.useAppletRuntime = useAppletRuntime;
+exports.useConfig = useConfig;
+exports.useConfigContext = useConfigContext;
+exports.usePermissions = usePermissions;
+exports.useRoute = useRoute;
+exports.useSession = useSession;
+exports.useStreaming = useStreaming;
+exports.useTranslation = useTranslation;
+exports.useUser = useUser;
+//# sourceMappingURL=core.cjs.map
+//# sourceMappingURL=core.cjs.map

package/dist/applet/core.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../ui/src/applet-core/context/AppletContext.tsx","../../ui/src/applet-core/context/ConfigProvider.tsx","../../ui/src/applet-core/hooks/useAppletContext.ts","../../ui/src/applet-core/hooks/useConfig.ts","../../ui/src/applet-core/hooks/useUser.ts","../../ui/src/applet-core/hooks/usePermissions.ts","../../ui/src/applet-core/hooks/useTranslation.ts","../../ui/src/applet-core/hooks/useSession.ts","../../ui/src/applet-core/hooks/useRoute.ts","../../ui/src/applet-core/hooks/useStreaming.ts","../../ui/src/applet-core/hooks/useAppletRuntime.ts"],"names":["createContext","useContext","jsx","useAppletContext","useMemo","useState","useRef","useCallback"],"mappings":"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","file":"core.cjs","sourcesContent":["import { createContext, useContext, ReactNode } from 'react'\nimport type { InitialContext } from '../types'\n\n/**\n * AppletContext provides access to the global context injected by the backend.\n * The context is read from window.__*_CONTEXT__ (configured via windowKey).\n */\nconst AppletContext = createContext<InitialContext | null>(null)\n\nconst REQUIRED_KEYS: Array<keyof InitialContext> = ['user', 'tenant', 'locale', 'config', 'route', 'session']\n\nfunction validateInitialContext(value: unknown, windowKey: string): InitialContext {\n  if (!value || typeof value !== 'object') {\n    throw new Error(`${windowKey}: expected an object, got ${typeof value}`)\n  }\n  const obj = value as Record<string, unknown>\n  const missing = REQUIRED_KEYS.filter((k) => !(k in obj))\n  if (missing.length > 0) {\n    throw new Error(`${windowKey}: missing required keys: ${missing.join(', ')}`)\n  }\n\n  // Deep validation for nested required fields\n  const user = obj.user as Record<string, unknown> | undefined\n  if (!user || typeof user !== 'object') {\n    throw new Error(`${windowKey}.user: expected an object, got ${typeof user}`)\n  }\n  if (typeof user.id !== 'number') {\n    throw new Error(`${windowKey}.user.id: expected number, got ${typeof user.id}`)\n  }\n  if (!Array.isArray(user.permissions)) {\n    throw new Error(`${windowKey}.user.permissions: expected array, got ${typeof user.permissions}`)\n  }\n\n  const tenant = obj.tenant as Record<string, unknown> | undefined\n  if (!tenant || typeof tenant !== 'object') {\n    throw new Error(`${windowKey}.tenant: expected an object, got ${typeof tenant}`)\n  }\n  if (typeof tenant.id !== 'string') {\n    throw new Error(`${windowKey}.tenant.id: expected string, got ${typeof tenant.id}`)\n  }\n\n  const session = obj.session as Record<string, unknown> | undefined\n  if (!session || typeof session !== 'object') {\n    throw new Error(`${windowKey}.session: expected an object, got ${typeof session}`)\n  }\n  if (typeof session.csrfToken !== 'string') {\n    throw new Error(`${windowKey}.session.csrfToken: expected string, got ${typeof session.csrfToken}`)\n  }\n  if (typeof session.expiresAt !== 'number') {\n    throw new Error(`${windowKey}.session.expiresAt: expected number, got ${typeof session.expiresAt}`)\n  }\n  if (typeof session.refreshURL !== 'string') {\n    throw new Error(`${windowKey}.session.refreshURL: expected string, got ${typeof session.refreshURL}`)\n  }\n\n  const config = obj.config\n  if (!config || typeof config !== 'object') {\n    throw new Error(`${windowKey}.config: expected object, got ${typeof config}`)\n  }\n\n  return value as InitialContext\n}\n\nexport interface AppletProviderProps {\n  children: ReactNode\n  windowKey: string\n  context?: InitialContext\n}\n\n/**\n * AppletProvider reads context from window global and provides it to hooks.\n *\n * Usage:\n * <AppletProvider windowKey=\"__BICHAT_CONTEXT__\">\n *   <App />\n * </AppletProvider>\n */\nexport function AppletProvider({ children, windowKey, context }: AppletProviderProps) {\n  // Use provided context or read from window global\n  const raw = context ?? (window as any)[windowKey]\n\n  if (!raw) {\n    throw new Error(`${windowKey} not found on window. Ensure backend context injection is working.`)\n  }\n\n  const initialContext = validateInitialContext(raw, windowKey)\n\n  return (\n    <AppletContext.Provider value={initialContext}>\n      {children}\n    </AppletContext.Provider>\n  )\n}\n\n/**\n * useAppletContext provides access to the full applet context.\n * Use specialized hooks (useUser, useConfig, etc.) for specific context parts.\n */\nexport function useAppletContext<T = InitialContext>(): T {\n  const context = useContext(AppletContext)\n  if (!context) {\n    throw new Error('useAppletContext must be used within AppletProvider')\n  }\n  return context as T\n}\n","import { createContext, useContext, ReactNode } from 'react'\nimport type { InitialContext } from '../types'\n\n/**\n * ConfigProvider is an alternative to AppletProvider that accepts context via props\n * instead of reading from window global. Useful for testing and server-side rendering.\n */\n\nconst ConfigContext = createContext<InitialContext | null>(null)\n\nexport interface ConfigProviderProps {\n  children: ReactNode\n  config: InitialContext\n}\n\n/**\n * ConfigProvider accepts context configuration via props.\n *\n * Usage:\n * <ConfigProvider config={initialContext}>\n *   <App />\n * </ConfigProvider>\n */\nexport function ConfigProvider({ children, config }: ConfigProviderProps) {\n  return (\n    <ConfigContext.Provider value={config}>\n      {children}\n    </ConfigContext.Provider>\n  )\n}\n\n/**\n * useConfigContext provides access to the applet context when using ConfigProvider.\n */\nexport function useConfigContext<T = InitialContext>(): T {\n  const context = useContext(ConfigContext)\n  if (!context) {\n    throw new Error('useConfigContext must be used within ConfigProvider')\n  }\n  return context as T\n}\n","import type { InitialContext } from '../types'\n\n/**\n * useAppletContext provides direct access to the window global context.\n * This is a standalone version that doesn't require AppletProvider.\n *\n * Usage:\n * const context = useAppletContext('__BICHAT_CONTEXT__')\n *\n * Note: Prefer using AppletProvider + context hooks for better type safety\n * and testability. Use this hook only when provider setup is not possible.\n */\nexport function useAppletContext<T = InitialContext>(windowKey: string): T {\n  const context = (window as any)[windowKey]\n\n  if (!context) {\n    throw new Error(`${windowKey} not found on window. Ensure backend context injection is working.`)\n  }\n\n  return context as T\n}\n","import { useAppletContext } from '../context/AppletContext'\nimport type { AppConfig } from '../types'\n\n/**\n * useConfig provides access to applet configuration (endpoints, etc.)\n *\n * Usage:\n * const { graphQLEndpoint, streamEndpoint } = useConfig()\n */\nexport function useConfig(): AppConfig {\n  const { config } = useAppletContext()\n  return config\n}\n","import { useAppletContext } from '../context/AppletContext'\nimport type { UserContext } from '../types'\n\n/**\n * useUser provides access to current user information.\n *\n * Usage:\n * const { id, email, firstName, lastName, permissions } = useUser()\n */\nexport function useUser(): UserContext {\n  const { user } = useAppletContext()\n  return user\n}\n","import { useAppletContext } from '../context/AppletContext'\nimport type { PermissionsHook } from '../types'\n\n/**\n * usePermissions provides permission checking utilities.\n * All user permissions are automatically passed from backend.\n *\n * Usage:\n * const { hasPermission, hasAnyPermission } = usePermissions()\n *\n * if (hasPermission('BiChat.Access')) {\n *   // User has bichat access\n * }\n *\n * if (hasAnyPermission('finance.view', 'finance.edit')) {\n *   // User has at least one of these permissions\n * }\n */\nexport function usePermissions(): PermissionsHook {\n  const { user } = useAppletContext()\n\n  const hasPermission = (permission: string): boolean => {\n    return user.permissions.includes(permission)\n  }\n\n  const hasAnyPermission = (...permissions: string[]): boolean => {\n    return permissions.some(p => user.permissions.includes(p))\n  }\n\n  return {\n    hasPermission,\n    hasAnyPermission,\n    permissions: user.permissions\n  }\n}\n","import { useAppletContext } from '../context/AppletContext'\nimport type { TranslationHook } from '../types'\n\n/**\n * useTranslation provides i18n translation utilities.\n * All translations are automatically passed from backend locale bundle.\n *\n * Usage:\n * const { t, language } = useTranslation()\n *\n * // Simple translation\n * t('BiChat.Title') // Returns translated text\n *\n * // Translation with interpolation\n * t('Common.WelcomeMessage', { name: 'John' })\n * // If translation is \"Welcome {name}!\" -> Returns \"Welcome John!\"\n *\n * React uses same keys as Go backend:\n * Go:    pageCtx.T(\"BiChat.Title\")\n * React: t(\"BiChat.Title\")\n */\nexport function useTranslation(): TranslationHook {\n  const { locale } = useAppletContext()\n\n  const t = (key: string, params?: Record<string, unknown>): string => {\n    let text = locale.translations[key] || key\n\n    // Simple interpolation: \"Hello {name}\" with {name: \"World\"}\n    if (params) {\n      Object.entries(params).forEach(([k, v]) => {\n        text = text.replace(new RegExp(`\\\\{${k}\\\\}`, 'g'), String(v))\n      })\n    }\n\n    return text\n  }\n\n  return {\n    t,\n    language: locale.language\n  }\n}\n","import { useMemo } from 'react'\nimport { useAppletContext } from '../context/AppletContext'\nimport type { SessionHook } from '../types'\n\nexport interface UseSessionOptions {\n  loginPath?: string\n}\n\n/**\n * useSession provides session and authentication handling utilities.\n *\n * Usage:\n * const { isExpiringSoon, refreshSession, csrfToken } = useSession()\n *\n * // Check if session is expiring soon (5 min buffer)\n * if (isExpiringSoon) {\n *   await refreshSession()\n * }\n *\n * // Include CSRF token in requests\n * fetch('/api/endpoint', {\n *   headers: { 'X-CSRF-Token': csrfToken }\n * })\n */\nexport function useSession(options?: UseSessionOptions): SessionHook {\n  const { session } = useAppletContext()\n  const loginPath = options?.loginPath ?? '/login'\n\n  // Check if session is expiring soon (5 minute buffer)\n  const isExpiringSoon = useMemo(() => {\n    const bufferMs = 5 * 60 * 1000 // 5 minutes\n    return session.expiresAt - Date.now() < bufferMs\n  }, [session.expiresAt])\n\n  const refreshSession = async (): Promise<void> => {\n    const response = await fetch(session.refreshURL, {\n      method: 'POST',\n      headers: {\n        'X-CSRF-Token': session.csrfToken\n      }\n    })\n\n    if (!response.ok) {\n      // Session refresh failed - redirect to login with return URL\n      const returnUrl = encodeURIComponent(window.location.pathname)\n      window.location.href = `${loginPath}?redirect=${returnUrl}`\n      return\n    }\n\n    // Dispatch event for CSRF token update\n    const newToken = response.headers.get('X-CSRF-Token')\n    if (newToken) {\n      window.dispatchEvent(\n        new CustomEvent('iota:csrf-refresh', {\n          detail: { token: newToken }\n        })\n      )\n    }\n  }\n\n  return {\n    isExpiringSoon,\n    refreshSession,\n    csrfToken: session.csrfToken,\n    expiresAt: session.expiresAt\n  }\n}\n","import { useAppletContext } from '../context/AppletContext'\nimport type { RouteContext } from '../types'\n\n/**\n * useRoute provides access to the current route context.\n * Route context is initialized from the backend and includes path, params, and query.\n *\n * Usage:\n * const { path, params, query } = useRoute()\n *\n * // Example values:\n * // path: \"/sessions/123\"\n * // params: { id: \"123\" }\n * // query: { tab: \"history\" }\n */\nexport function useRoute(): RouteContext {\n  const { route } = useAppletContext()\n  return route\n}\n","import { useState, useRef, useCallback } from 'react'\nimport type { StreamingHook } from '../types'\n\n/**\n * useStreaming provides SSE (Server-Sent Events) streaming utilities with cancellation support.\n *\n * Usage:\n * const { isStreaming, processStream, cancel, reset } = useStreaming()\n *\n * // Process async generator stream\n * await processStream(messageStream, (chunk) => {\n *   console.log('Received:', chunk)\n * })\n *\n * // Cancel ongoing stream\n * cancel()\n *\n * // Reset state after stream completion\n * reset()\n */\nexport function useStreaming(): StreamingHook {\n  const [isStreaming, setIsStreaming] = useState(false)\n  const abortControllerRef = useRef<AbortController | null>(null)\n\n  const processStream = useCallback(\n    async <T,>(\n      generator: AsyncGenerator<T>,\n      onChunk: (chunk: T) => void,\n      signal?: AbortSignal\n    ): Promise<void> => {\n      setIsStreaming(true)\n\n      // Create abort controller if not provided\n      const controller = new AbortController()\n      abortControllerRef.current = controller\n\n      // Listen to external signal if provided\n      if (signal) {\n        signal.addEventListener('abort', () => {\n          controller.abort()\n        })\n      }\n\n      try {\n        for await (const chunk of generator) {\n          // Check if stream was cancelled\n          if (controller.signal.aborted) {\n            break\n          }\n\n          onChunk(chunk)\n        }\n      } catch (error) {\n        // Stream was cancelled or errored\n        if (controller.signal.aborted) {\n          // Cancellation is expected, don't throw\n          return\n        }\n        throw error\n      } finally {\n        setIsStreaming(false)\n        abortControllerRef.current = null\n      }\n    },\n    []\n  )\n\n  const cancel = useCallback(() => {\n    if (abortControllerRef.current) {\n      abortControllerRef.current.abort()\n    }\n    setIsStreaming(false)\n  }, [])\n\n  const reset = useCallback(() => {\n    abortControllerRef.current = null\n    setIsStreaming(false)\n  }, [])\n\n  return {\n    isStreaming,\n    processStream,\n    cancel,\n    reset\n  }\n}\n","import { useConfig } from './useConfig'\n\nexport type ShellMode = 'embedded' | 'standalone'\n\nexport interface AppletRuntime {\n  basePath: string\n  assetsBasePath: string\n  rpcEndpoint?: string\n  shellMode?: ShellMode\n}\n\nexport function useAppletRuntime(): AppletRuntime {\n  const config = useConfig()\n\n  const basePath = config.basePath ?? ''\n  const normalizedBasePath = basePath.endsWith('/') ? basePath.slice(0, -1) : basePath\n  const assetsBasePath = config.assetsBasePath ?? `${normalizedBasePath || ''}/assets`\n  const rpcEndpoint = config.rpcUIEndpoint\n  const shellMode = config.shellMode\n\n  return { basePath: normalizedBasePath, assetsBasePath, rpcEndpoint, shellMode }\n}\n"]}

package/dist/applet/core.d.cts

@@ -0,0 +1,172 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { I as InitialContext, A as AppConfig, U as UserContext, P as PermissionsHook, c as TranslationHook, a as SessionHook, R as RouteContext, b as StreamingHook } from '../index-Cs_xWkhC.cjs';
+export { L as LocaleContext, S as SessionContext, T as TenantContext } from '../index-Cs_xWkhC.cjs';
+
+interface AppletProviderProps {
+    children: ReactNode;
+    windowKey: string;
+    context?: InitialContext;
+}
+/**
+ * AppletProvider reads context from window global and provides it to hooks.
+ *
+ * Usage:
+ * <AppletProvider windowKey="__BICHAT_CONTEXT__">
+ *   <App />
+ * </AppletProvider>
+ */
+declare function AppletProvider({ children, windowKey, context }: AppletProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * useAppletContext provides access to the full applet context.
+ * Use specialized hooks (useUser, useConfig, etc.) for specific context parts.
+ */
+declare function useAppletContext$1<T = InitialContext>(): T;
+
+interface ConfigProviderProps {
+    children: ReactNode;
+    config: InitialContext;
+}
+/**
+ * ConfigProvider accepts context configuration via props.
+ *
+ * Usage:
+ * <ConfigProvider config={initialContext}>
+ *   <App />
+ * </ConfigProvider>
+ */
+declare function ConfigProvider({ children, config }: ConfigProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * useConfigContext provides access to the applet context when using ConfigProvider.
+ */
+declare function useConfigContext<T = InitialContext>(): T;
+
+/**
+ * useAppletContext provides direct access to the window global context.
+ * This is a standalone version that doesn't require AppletProvider.
+ *
+ * Usage:
+ * const context = useAppletContext('__BICHAT_CONTEXT__')
+ *
+ * Note: Prefer using AppletProvider + context hooks for better type safety
+ * and testability. Use this hook only when provider setup is not possible.
+ */
+declare function useAppletContext<T = InitialContext>(windowKey: string): T;
+
+/**
+ * useConfig provides access to applet configuration (endpoints, etc.)
+ *
+ * Usage:
+ * const { graphQLEndpoint, streamEndpoint } = useConfig()
+ */
+declare function useConfig(): AppConfig;
+
+/**
+ * useUser provides access to current user information.
+ *
+ * Usage:
+ * const { id, email, firstName, lastName, permissions } = useUser()
+ */
+declare function useUser(): UserContext;
+
+/**
+ * usePermissions provides permission checking utilities.
+ * All user permissions are automatically passed from backend.
+ *
+ * Usage:
+ * const { hasPermission, hasAnyPermission } = usePermissions()
+ *
+ * if (hasPermission('BiChat.Access')) {
+ *   // User has bichat access
+ * }
+ *
+ * if (hasAnyPermission('finance.view', 'finance.edit')) {
+ *   // User has at least one of these permissions
+ * }
+ */
+declare function usePermissions(): PermissionsHook;
+
+/**
+ * useTranslation provides i18n translation utilities.
+ * All translations are automatically passed from backend locale bundle.
+ *
+ * Usage:
+ * const { t, language } = useTranslation()
+ *
+ * // Simple translation
+ * t('BiChat.Title') // Returns translated text
+ *
+ * // Translation with interpolation
+ * t('Common.WelcomeMessage', { name: 'John' })
+ * // If translation is "Welcome {name}!" -> Returns "Welcome John!"
+ *
+ * React uses same keys as Go backend:
+ * Go:    pageCtx.T("BiChat.Title")
+ * React: t("BiChat.Title")
+ */
+declare function useTranslation(): TranslationHook;
+
+interface UseSessionOptions {
+    loginPath?: string;
+}
+/**
+ * useSession provides session and authentication handling utilities.
+ *
+ * Usage:
+ * const { isExpiringSoon, refreshSession, csrfToken } = useSession()
+ *
+ * // Check if session is expiring soon (5 min buffer)
+ * if (isExpiringSoon) {
+ *   await refreshSession()
+ * }
+ *
+ * // Include CSRF token in requests
+ * fetch('/api/endpoint', {
+ *   headers: { 'X-CSRF-Token': csrfToken }
+ * })
+ */
+declare function useSession(options?: UseSessionOptions): SessionHook;
+
+/**
+ * useRoute provides access to the current route context.
+ * Route context is initialized from the backend and includes path, params, and query.
+ *
+ * Usage:
+ * const { path, params, query } = useRoute()
+ *
+ * // Example values:
+ * // path: "/sessions/123"
+ * // params: { id: "123" }
+ * // query: { tab: "history" }
+ */
+declare function useRoute(): RouteContext;
+
+/**
+ * useStreaming provides SSE (Server-Sent Events) streaming utilities with cancellation support.
+ *
+ * Usage:
+ * const { isStreaming, processStream, cancel, reset } = useStreaming()
+ *
+ * // Process async generator stream
+ * await processStream(messageStream, (chunk) => {
+ *   console.log('Received:', chunk)
+ * })
+ *
+ * // Cancel ongoing stream
+ * cancel()
+ *
+ * // Reset state after stream completion
+ * reset()
+ */
+declare function useStreaming(): StreamingHook;
+
+type ShellMode = 'embedded' | 'standalone';
+interface AppletRuntime {
+    basePath: string;
+    assetsBasePath: string;
+    rpcEndpoint?: string;
+    shellMode?: ShellMode;
+}
+declare function useAppletRuntime(): AppletRuntime;
+
+export { AppConfig, AppletProvider, ConfigProvider, InitialContext, PermissionsHook, RouteContext, SessionHook, StreamingHook, TranslationHook, UserContext, useAppletContext$1 as useAppletContext, useAppletContext as useAppletContextDirect, useAppletRuntime, useConfig, useConfigContext, usePermissions, useRoute, useSession, useStreaming, useTranslation, useUser };