@iota-uz/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,237 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/**
+ * TypeScript type definitions for IOTA SDK Applet Core
+ * Matches Go backend types from pkg/applet/types.go
+ */
+interface InitialContext {
+    user: UserContext;
+    tenant: TenantContext;
+    locale: LocaleContext;
+    config: AppConfig;
+    route: RouteContext;
+    session: SessionContext;
+    error: ErrorContext | null;
+    extensions?: Record<string, unknown>;
+}
+interface UserContext {
+    id: number;
+    email: string;
+    firstName: string;
+    lastName: string;
+    permissions: string[];
+}
+interface TenantContext {
+    id: string;
+    name: string;
+}
+interface LocaleContext {
+    language: string;
+    translations: Record<string, string>;
+}
+interface AppConfig {
+    graphQLEndpoint?: string;
+    streamEndpoint?: string;
+    restEndpoint?: string;
+}
+interface RouteContext {
+    path: string;
+    params: Record<string, string>;
+    query: Record<string, string>;
+}
+interface SessionContext {
+    expiresAt: number;
+    refreshURL: string;
+    csrfToken: string;
+}
+interface ErrorContext {
+    supportEmail?: string;
+    debugMode: boolean;
+    errorCodes?: Record<string, string>;
+    retryConfig?: RetryConfig;
+}
+interface RetryConfig {
+    maxAttempts: number;
+    backoffMs: number;
+}
+/**
+ * Hook return types
+ */
+interface TranslationHook {
+    t: (key: string, params?: Record<string, unknown>) => string;
+    language: string;
+}
+interface PermissionsHook {
+    hasPermission: (permission: string) => boolean;
+    hasAnyPermission: (...permissions: string[]) => boolean;
+    permissions: string[];
+}
+interface SessionHook {
+    isExpiringSoon: boolean;
+    refreshSession: () => Promise<void>;
+    csrfToken: string;
+    expiresAt: number;
+}
+interface StreamingHook {
+    isStreaming: boolean;
+    processStream: <T>(generator: AsyncGenerator<T>, onChunk: (chunk: T) => void, signal?: AbortSignal) => Promise<void>;
+    cancel: () => void;
+    reset: () => void;
+}
+
+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;
+
+/**
+ * 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(): 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;
+
+export { type AppConfig, AppletProvider, ConfigProvider, type InitialContext, type LocaleContext, type PermissionsHook, type RouteContext, type SessionContext, type SessionHook, type StreamingHook, type TenantContext, type TranslationHook, type UserContext, useAppletContext$1 as useAppletContext, useAppletContext as useAppletContextDirect, useConfig, useConfigContext, usePermissions, useRoute, useSession, useStreaming, useTranslation, useUser };

package/dist/index.mjs

@@ -0,0 +1,178 @@
+import { createContext, useContext, useMemo, useState, useRef, useCallback } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// ui/src/applet-core/context/AppletContext.tsx
+var AppletContext = createContext(null);
+function AppletProvider({ children, windowKey, context }) {
+  const initialContext = context ?? window[windowKey];
+  if (!initialContext) {
+    throw new Error(`${windowKey} not found on window. Ensure backend context injection is working.`);
+  }
+  return /* @__PURE__ */ jsx(AppletContext.Provider, { value: initialContext, children });
+}
+function useAppletContext() {
+  const context = useContext(AppletContext);
+  if (!context) {
+    throw new Error("useAppletContext must be used within AppletProvider");
+  }
+  return context;
+}
+var ConfigContext = createContext(null);
+function ConfigProvider({ children, config }) {
+  return /* @__PURE__ */ jsx(ConfigContext.Provider, { value: config, children });
+}
+function useConfigContext() {
+  const context = 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() {
+  const { session } = useAppletContext();
+  const isExpiringSoon = 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 = `/login?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] = useState(false);
+  const abortControllerRef = useRef(null);
+  const processStream = 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 = useCallback(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+    }
+    setIsStreaming(false);
+  }, []);
+  const reset = useCallback(() => {
+    abortControllerRef.current = null;
+    setIsStreaming(false);
+  }, []);
+  return {
+    isStreaming,
+    processStream,
+    cancel,
+    reset
+  };
+}
+
+export { AppletProvider, ConfigProvider, useAppletContext, useAppletContext2 as useAppletContextDirect, useConfig, useConfigContext, usePermissions, useRoute, useSession, useStreaming, useTranslation, useUser };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.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"],"names":["createContext","jsx","useContext","useAppletContext"],"mappings":";;;;AAOA,IAAM,aAAA,GAAgB,cAAqC,IAAI,CAAA;AAgBxD,SAAS,cAAA,CAAe,EAAE,QAAA,EAAU,SAAA,EAAW,SAAQ,EAAwB;AAEpF,EAAA,MAAM,cAAA,GAAiB,OAAA,IAAY,MAAA,CAAe,SAAS,CAAA;AAE3D,EAAA,IAAI,CAAC,cAAA,EAAgB;AACnB,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,kEAAA,CAAoE,CAAA;AAAA,EAClG;AAEA,EAAA,2BACG,aAAA,CAAc,QAAA,EAAd,EAAuB,KAAA,EAAO,gBAC5B,QAAA,EACH,CAAA;AAEJ;AAMO,SAAS,gBAAA,GAA0C;AACxD,EAAA,MAAM,OAAA,GAAU,WAAW,aAAa,CAAA;AACxC,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,EACvE;AACA,EAAA,OAAO,OAAA;AACT;ACxCA,IAAM,aAAA,GAAgBA,cAAqC,IAAI,CAAA;AAexD,SAAS,cAAA,CAAe,EAAE,QAAA,EAAU,MAAA,EAAO,EAAwB;AACxE,EAAA,uBACEC,GAAAA,CAAC,aAAA,CAAc,UAAd,EAAuB,KAAA,EAAO,QAC5B,QAAA,EACH,CAAA;AAEJ;AAKO,SAAS,gBAAA,GAA0C;AACxD,EAAA,MAAM,OAAA,GAAUC,WAAW,aAAa,CAAA;AACxC,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,EACvE;AACA,EAAA,OAAO,OAAA;AACT;;;AC5BO,SAASC,kBAAqC,SAAA,EAAsB;AACzE,EAAA,MAAM,OAAA,GAAW,OAAe,SAAS,CAAA;AAEzC,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,kEAAA,CAAoE,CAAA;AAAA,EAClG;AAEA,EAAA,OAAO,OAAA;AACT;;;ACXO,SAAS,SAAA,GAAuB;AACrC,EAAA,MAAM,EAAE,MAAA,EAAO,GAAI,gBAAA,EAAiB;AACpC,EAAA,OAAO,MAAA;AACT;;;ACHO,SAAS,OAAA,GAAuB;AACrC,EAAA,MAAM,EAAE,IAAA,EAAK,GAAI,gBAAA,EAAiB;AAClC,EAAA,OAAO,IAAA;AACT;;;ACMO,SAAS,cAAA,GAAkC;AAChD,EAAA,MAAM,EAAE,IAAA,EAAK,GAAI,gBAAA,EAAiB;AAElC,EAAA,MAAM,aAAA,GAAgB,CAAC,UAAA,KAAgC;AACrD,IAAA,OAAO,IAAA,CAAK,WAAA,CAAY,QAAA,CAAS,UAAU,CAAA;AAAA,EAC7C,CAAA;AAEA,EAAA,MAAM,gBAAA,GAAmB,IAAI,WAAA,KAAmC;AAC9D,IAAA,OAAO,YAAY,IAAA,CAAK,CAAA,CAAA,KAAK,KAAK,WAAA,CAAY,QAAA,CAAS,CAAC,CAAC,CAAA;AAAA,EAC3D,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,aAAA;AAAA,IACA,gBAAA;AAAA,IACA,aAAa,IAAA,CAAK;AAAA,GACpB;AACF;;;ACbO,SAAS,cAAA,GAAkC;AAChD,EAAA,MAAM,EAAE,MAAA,EAAO,GAAI,gBAAA,EAAiB;AAEpC,EAAA,MAAM,CAAA,GAAI,CAAC,GAAA,EAAa,MAAA,KAA6C;AACnE,IAAA,IAAI,IAAA,GAAO,MAAA,CAAO,YAAA,CAAa,GAAG,CAAA,IAAK,GAAA;AAGvC,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,KAAM;AACzC,QAAA,IAAA,GAAO,IAAA,CAAK,OAAA,CAAQ,IAAI,MAAA,CAAO,CAAA,GAAA,EAAM,CAAC,CAAA,GAAA,CAAA,EAAO,GAAG,CAAA,EAAG,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,MAC9D,CAAC,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,IAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,CAAA;AAAA,IACA,UAAU,MAAA,CAAO;AAAA,GACnB;AACF;ACrBO,SAAS,UAAA,GAA0B;AACxC,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,gBAAA,EAAiB;AAGrC,EAAA,MAAM,cAAA,GAAiB,QAAQ,MAAM;AACnC,IAAA,MAAM,QAAA,GAAW,IAAI,EAAA,GAAK,GAAA;AAC1B,IAAA,OAAO,OAAA,CAAQ,SAAA,GAAY,IAAA,CAAK,GAAA,EAAI,GAAI,QAAA;AAAA,EAC1C,CAAA,EAAG,CAAC,OAAA,CAAQ,SAAS,CAAC,CAAA;AAEtB,EAAA,MAAM,iBAAiB,YAA2B;AAChD,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,OAAA,CAAQ,UAAA,EAAY;AAAA,MAC/C,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS;AAAA,QACP,gBAAgB,OAAA,CAAQ;AAAA;AAC1B,KACD,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAEhB,MAAA,MAAM,SAAA,GAAY,kBAAA,CAAmB,MAAA,CAAO,QAAA,CAAS,QAAQ,CAAA;AAC7D,MAAA,MAAA,CAAO,QAAA,CAAS,IAAA,GAAO,CAAA,gBAAA,EAAmB,SAAS,CAAA,CAAA;AACnD,MAAA;AAAA,IACF;AAGA,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAA;AACpD,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,MAAA,CAAO,aAAA;AAAA,QACL,IAAI,YAAY,mBAAA,EAAqB;AAAA,UACnC,MAAA,EAAQ,EAAE,KAAA,EAAO,QAAA;AAAS,SAC3B;AAAA,OACH;AAAA,IACF;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,cAAA;AAAA,IACA,cAAA;AAAA,IACA,WAAW,OAAA,CAAQ,SAAA;AAAA,IACnB,WAAW,OAAA,CAAQ;AAAA,GACrB;AACF;;;AC9CO,SAAS,QAAA,GAAyB;AACvC,EAAA,MAAM,EAAE,KAAA,EAAM,GAAI,gBAAA,EAAiB;AACnC,EAAA,OAAO,KAAA;AACT;ACEO,SAAS,YAAA,GAA8B;AAC5C,EAAA,MAAM,CAAC,WAAA,EAAa,cAAc,CAAA,GAAI,SAAS,KAAK,CAAA;AACpD,EAAA,MAAM,kBAAA,GAAqB,OAA+B,IAAI,CAAA;AAE9D,EAAA,MAAM,aAAA,GAAgB,WAAA;AAAA,IACpB,OACE,SAAA,EACA,OAAA,EACA,MAAA,KACkB;AAClB,MAAA,cAAA,CAAe,IAAI,CAAA;AAGnB,MAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,MAAA,kBAAA,CAAmB,OAAA,GAAU,UAAA;AAG7B,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,MAAA,CAAO,gBAAA,CAAiB,SAAS,MAAM;AACrC,UAAA,UAAA,CAAW,KAAA,EAAM;AAAA,QACnB,CAAC,CAAA;AAAA,MACH;AAEA,MAAA,IAAI;AACF,QAAA,WAAA,MAAiB,SAAS,SAAA,EAAW;AAEnC,UAAA,IAAI,UAAA,CAAW,OAAO,OAAA,EAAS;AAC7B,YAAA;AAAA,UACF;AAEA,UAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,QACf;AAAA,MACF,SAAS,KAAA,EAAO;AAEd,QAAA,IAAI,UAAA,CAAW,OAAO,OAAA,EAAS;AAE7B,UAAA;AAAA,QACF;AACA,QAAA,MAAM,KAAA;AAAA,MACR,CAAA,SAAE;AACA,QAAA,cAAA,CAAe,KAAK,CAAA;AACpB,QAAA,kBAAA,CAAmB,OAAA,GAAU,IAAA;AAAA,MAC/B;AAAA,IACF,CAAA;AAAA,IACA;AAAC,GACH;AAEA,EAAA,MAAM,MAAA,GAAS,YAAY,MAAM;AAC/B,IAAA,IAAI,mBAAmB,OAAA,EAAS;AAC9B,MAAA,kBAAA,CAAmB,QAAQ,KAAA,EAAM;AAAA,IACnC;AACA,IAAA,cAAA,CAAe,KAAK,CAAA;AAAA,EACtB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,kBAAA,CAAmB,OAAA,GAAU,IAAA;AAC7B,IAAA,cAAA,CAAe,KAAK,CAAA;AAAA,EACtB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO;AAAA,IACL,WAAA;AAAA,IACA,aAAA;AAAA,IACA,MAAA;AAAA,IACA;AAAA,GACF;AACF","file":"index.mjs","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\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 initialContext = context ?? (window as any)[windowKey]\n\n  if (!initialContext) {\n    throw new Error(`${windowKey} not found on window. Ensure backend context injection is working.`)\n  }\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\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(): SessionHook {\n  const { session } = useAppletContext()\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 = `/login?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"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@iota-uz/sdk",
+  "version": "0.1.0",
+  "description": "IOTA SDK UI utilities, Tailwind configuration, and React components for building IOTA SDK applets.",
+  "license": "MIT",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "tailwind",
+    "assets",
+    "README.MD",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./bichat": {
+      "types": "./dist/bichat/index.d.ts",
+      "import": "./dist/bichat/index.mjs",
+      "require": "./dist/bichat/index.cjs"
+    },
+    "./bichat/styles.css": "./dist/bichat/styles.css",
+    "./tailwind/main.css": "./tailwind/main.css",
+    "./tailwind/iota.css": "./tailwind/iota.css",
+    "./tailwind/create-config": "./tailwind/create-config.cjs",
+    "./assets/*": "./assets/*",
+    "./assets/fonts/*": "./assets/fonts/*"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@phosphor-icons/react": "^2.1.0",
+    "date-fns": "^3.0.0",
+    "framer-motion": "^11.0.0",
+    "react-markdown": "^9.0.1",
+    "react-syntax-highlighter": "^15.5.0",
+    "recharts": "^2.12.0",
+    "rehype-sanitize": "^6.0.0",
+    "remark-gfm": "^4.0.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/cli": "4.1.18",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "@types/react-syntax-highlighter": "^15.5.13",
+    "tailwindcss": "4.1.18",
+    "tsup": "^8.5.0",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "pnpm run build:js && pnpm run build:tailwind && pnpm run build:assets",
+    "build:js": "tsup",
+    "build:tailwind": "node ./scripts/build-tailwind-files.mjs",
+    "build:assets": "node ./scripts/build-assets.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo \"no lint\""
+  }
+}

package/tailwind/create-config.cjs

@@ -0,0 +1,142 @@
+const sdkThemeExtend = {
+  fontFamily: {
+    sans: ['Gilroy'],
+  },
+  backgroundColor: {
+    surface: {
+      100: 'oklch(var(--clr-surface-100))',
+      200: 'oklch(var(--clr-surface-200))',
+      300: 'oklch(var(--clr-surface-300))',
+      400: 'oklch(var(--clr-surface-400))',
+      500: 'oklch(var(--clr-surface-500))',
+      600: 'oklch(var(--clr-surface-600))',
+    },
+    avatar: 'oklch(var(--clr-avatar-bg))',
+  },
+  borderColor: {
+    primary: 'oklch(var(--clr-border-primary))',
+    secondary: 'oklch(var(--clr-border-secondary))',
+    green: 'oklch(var(--clr-border-green))',
+    pink: 'oklch(var(--clr-border-pink))',
+    yellow: 'oklch(var(--clr-border-yellow))',
+    blue: 'oklch(var(--clr-border-blue))',
+    purple: 'oklch(var(--clr-border-purple))',
+  },
+  textColor: {
+    100: 'oklch(var(--clr-text-100))',
+    200: 'oklch(var(--clr-text-200))',
+    300: 'oklch(var(--clr-text-300))',
+    green: 'oklch(var(--clr-text-green))',
+    pink: 'oklch(var(--clr-text-pink))',
+    yellow: 'oklch(var(--clr-text-yellow))',
+    blue: 'oklch(var(--clr-text-blue))',
+    purple: 'oklch(var(--clr-text-purple))',
+    avatar: 'oklch(var(--clr-avatar-text))',
+  },
+  colors: {
+    100: 'oklch(var(--clr-text-100))',
+    200: 'oklch(var(--clr-text-200))',
+    300: 'oklch(var(--clr-text-300))',
+    green: 'oklch(var(--clr-text-green))',
+    pink: 'oklch(var(--clr-text-pink))',
+    yellow: 'oklch(var(--clr-text-yellow))',
+    blue: 'oklch(var(--clr-text-blue))',
+    purple: 'oklch(var(--clr-text-purple))',
+    avatar: 'oklch(var(--clr-avatar-text))',
+    black: {
+      DEFAULT: 'oklch(var(--black))',
+      950: 'oklch(var(--black-950))',
+    },
+    brand: {
+      500: 'oklch(var(--primary-500) / <alpha-value>)',
+      600: 'oklch(var(--primary-600) / <alpha-value>)',
+      700: 'oklch(var(--primary-700) / <alpha-value>)',
+    },
+    gray: {
+      50: 'oklch(var(--gray-50) / <alpha-value>)',
+      100: 'oklch(var(--gray-100) / <alpha-value>)',
+      200: 'oklch(var(--gray-200) / <alpha-value>)',
+      300: 'oklch(var(--gray-300) / <alpha-value>)',
+      400: 'oklch(var(--gray-400) / <alpha-value>)',
+      500: 'oklch(var(--gray-500) / <alpha-value>)',
+      600: 'oklch(var(--gray-600) / <alpha-value>)',
+      700: 'oklch(var(--gray-700) / <alpha-value>)',
+      800: 'oklch(var(--gray-800) / <alpha-value>)',
+      900: 'oklch(var(--gray-900) / <alpha-value>)',
+      950: 'oklch(var(--gray-950) / <alpha-value>)',
+    },
+    green: {
+      50: 'oklch(var(--green-50) / <alpha-value>)',
+      100: 'oklch(var(--green-100) / <alpha-value>)',
+      200: 'oklch(var(--green-200) / <alpha-value>)',
+      500: 'oklch(var(--green-500) / <alpha-value>)',
+      600: 'oklch(var(--green-600) / <alpha-value>)',
+    },
+    red: {
+      100: 'oklch(var(--red-100))',
+      200: 'oklch(var(--red-200))',
+      500: 'oklch(var(--red-500) / <alpha-value>)',
+      600: 'oklch(var(--red-600) / <alpha-value>)',
+      700: 'oklch(var(--red-700) / <alpha-value>)',
+    },
+    badge: {
+      pink: 'oklch(var(--clr-badge-pink))',
+      yellow: 'oklch(var(--clr-badge-yellow))',
+      green: 'oklch(var(--clr-badge-green))',
+      blue: 'oklch(var(--clr-badge-blue))',
+      purple: 'oklch(var(--clr-badge-purple))',
+      gray: 'oklch(var(--clr-badge-gray))',
+    },
+    success: {
+      DEFAULT: 'oklch(var(--green-500) / <alpha-value>)',
+    },
+    on: {
+      success: 'oklch(var(--white))',
+    },
+  },
+}
+
+function isPlainObject(value) {
+  return (
+    value !== null &&
+    typeof value === 'object' &&
+    !Array.isArray(value) &&
+    Object.prototype.toString.call(value) === '[object Object]'
+  )
+}
+
+function mergeDeep(base, extra) {
+  const out = { ...base }
+  for (const [key, value] of Object.entries(extra ?? {})) {
+    if (isPlainObject(out[key]) && isPlainObject(value)) {
+      out[key] = mergeDeep(out[key], value)
+      continue
+    }
+    out[key] = value
+  }
+  return out
+}
+
+function normalizeContent(content) {
+  const list = Array.isArray(content) ? content.slice() : []
+  const sdkGlob = './node_modules/@iotauz/iota-sdk/dist/**/*.{js,mjs,cjs}'
+  if (!list.includes(sdkGlob)) list.push(sdkGlob)
+  return list
+}
+
+function createIotaTailwindConfig(options = {}) {
+  const content = normalizeContent(options.content)
+  const extend = mergeDeep(sdkThemeExtend, options.extend ?? {})
+  const plugins = Array.isArray(options.plugins) ? options.plugins : []
+
+  return {
+    darkMode: 'class',
+    content,
+    theme: { extend },
+    plugins,
+  }
+}
+
+module.exports = createIotaTailwindConfig
+module.exports.createIotaTailwindConfig = createIotaTailwindConfig
+