@iota-uz/sdk 0.3.3 → 0.4.7

package/dist/index.d.cts

@@ -1,232 +1,6 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import react__default, { ReactNode } from 'react';
-import { I as InitialContext, A as AppConfig, U as UserContext, P as PermissionsHook, T as TranslationHook, S as SessionHook, R as RouteContext, a as StreamingHook } from './index-B73-BCi-.cjs';
-export { L as LocaleContext, b as SessionContext, c as TenantContext } from './index-B73-BCi-.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;
-
-/**
- * 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;
-
-type ShellMode$1 = 'embedded' | 'standalone';
-interface AppletRuntime {
-    basePath: string;
-    assetsBasePath: string;
-    rpcEndpoint?: string;
-    shellMode?: ShellMode$1;
-}
-declare function useAppletRuntime(): AppletRuntime;
-
-type RouterMode$1 = 'url' | 'memory';
-type ShellMode = 'embedded' | 'standalone';
-interface AppletHostConfig {
-    basePath: string;
-    shellMode?: ShellMode;
-    routerMode: RouterMode$1;
-    attrs: Record<string, string>;
-}
-interface DefineReactAppletElementOptions {
-    tagName: string;
-    styles?: string | (() => string);
-    render: (host: AppletHostConfig) => react__default.ReactElement;
-    observedAttributes?: string[];
-    observeDarkMode?: boolean;
-}
-declare function defineReactAppletElement(options: DefineReactAppletElementOptions): void;
-
-interface AppletRPCError {
-    code: string;
-    message: string;
-    details?: unknown;
-}
-declare class AppletRPCException extends Error {
-    code: string;
-    details?: unknown;
-    cause?: unknown;
-    constructor(args: {
-        code: string;
-        message: string;
-        details?: unknown;
-        cause?: unknown;
-    });
-}
-type AppletRPCSchema = Record<string, {
-    params: unknown;
-    result: unknown;
-}>;
-interface CreateAppletRPCClientOptions {
-    endpoint: string;
-    fetcher?: typeof fetch;
-}
-declare function createAppletRPCClient(options: CreateAppletRPCClientOptions): {
-    call: <TParams, TResult>(method: string, params: TParams) => Promise<TResult>;
-    callTyped: <TRouter extends AppletRPCSchema, TMethod extends keyof TRouter & string>(method: TMethod, params: TRouter[TMethod]["params"]) => Promise<TRouter[TMethod]["result"]>;
-};
-
-type RouterMode = 'url' | 'memory';
-interface CreateAppletRouterOptions {
-    mode: RouterMode;
-    basePath?: string;
-    BrowserRouter: react__default.ComponentType<any>;
-    MemoryRouter: react__default.ComponentType<any>;
-}
-declare function createAppletRouter(options: CreateAppletRouterOptions): {
-    Router: react__default.FC<{
-        children?: react__default.ReactNode | undefined;
-    }>;
-};
-
-declare function shouldEnableAppletDevtools(): boolean;
-
-declare function AppletDevtoolsOverlay(): react_jsx_runtime.JSX.Element;
-
-export { AppConfig, AppletDevtoolsOverlay, AppletProvider, type AppletRPCError, AppletRPCException, type AppletRPCSchema, ConfigProvider, InitialContext, PermissionsHook, RouteContext, type RouterMode, SessionHook, StreamingHook, TranslationHook, UserContext, createAppletRPCClient, createAppletRouter, defineReactAppletElement, shouldEnableAppletDevtools, useAppletContext$1 as useAppletContext, useAppletContext as useAppletContextDirect, useAppletRuntime, useConfig, useConfigContext, usePermissions, useRoute, useSession, useStreaming, useTranslation, useUser };
+export { AppletProvider, ConfigProvider, useAppletContext, useAppletContextDirect, useAppletRuntime, useConfig, useConfigContext, usePermissions, useRoute, useSession, useStreaming, useTranslation, useUser } from './applet/core.cjs';
+export { A as AppConfig, I as InitialContext, L as LocaleContext, P as PermissionsHook, R as RouteContext, S as SessionContext, a as SessionHook, b as StreamingHook, T as TenantContext, c as TranslationHook, U as UserContext } from './index-Cs_xWkhC.cjs';
+export { AppletRPCError, AppletRPCException, AppletRPCSchema, RouterMode, createAppletRPCClient, createAppletRouter, defineReactAppletElement } from './applet/host.cjs';
+export { AppletDevtoolsOverlay, shouldEnableAppletDevtools } from './applet/devtools.cjs';
+import 'react/jsx-runtime';
+import 'react';

package/dist/index.d.ts

@@ -1,232 +1,6 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import react__default, { ReactNode } from 'react';
-import { I as InitialContext, A as AppConfig, U as UserContext, P as PermissionsHook, T as TranslationHook, S as SessionHook, R as RouteContext, a as StreamingHook } from './index-B73-BCi-.js';
-export { L as LocaleContext, b as SessionContext, c as TenantContext } from './index-B73-BCi-.js';
-
-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;
-
-type ShellMode$1 = 'embedded' | 'standalone';
-interface AppletRuntime {
-    basePath: string;
-    assetsBasePath: string;
-    rpcEndpoint?: string;
-    shellMode?: ShellMode$1;
-}
-declare function useAppletRuntime(): AppletRuntime;
-
-type RouterMode$1 = 'url' | 'memory';
-type ShellMode = 'embedded' | 'standalone';
-interface AppletHostConfig {
-    basePath: string;
-    shellMode?: ShellMode;
-    routerMode: RouterMode$1;
-    attrs: Record<string, string>;
-}
-interface DefineReactAppletElementOptions {
-    tagName: string;
-    styles?: string | (() => string);
-    render: (host: AppletHostConfig) => react__default.ReactElement;
-    observedAttributes?: string[];
-    observeDarkMode?: boolean;
-}
-declare function defineReactAppletElement(options: DefineReactAppletElementOptions): void;
-
-interface AppletRPCError {
-    code: string;
-    message: string;
-    details?: unknown;
-}
-declare class AppletRPCException extends Error {
-    code: string;
-    details?: unknown;
-    cause?: unknown;
-    constructor(args: {
-        code: string;
-        message: string;
-        details?: unknown;
-        cause?: unknown;
-    });
-}
-type AppletRPCSchema = Record<string, {
-    params: unknown;
-    result: unknown;
-}>;
-interface CreateAppletRPCClientOptions {
-    endpoint: string;
-    fetcher?: typeof fetch;
-}
-declare function createAppletRPCClient(options: CreateAppletRPCClientOptions): {
-    call: <TParams, TResult>(method: string, params: TParams) => Promise<TResult>;
-    callTyped: <TRouter extends AppletRPCSchema, TMethod extends keyof TRouter & string>(method: TMethod, params: TRouter[TMethod]["params"]) => Promise<TRouter[TMethod]["result"]>;
-};
-
-type RouterMode = 'url' | 'memory';
-interface CreateAppletRouterOptions {
-    mode: RouterMode;
-    basePath?: string;
-    BrowserRouter: react__default.ComponentType<any>;
-    MemoryRouter: react__default.ComponentType<any>;
-}
-declare function createAppletRouter(options: CreateAppletRouterOptions): {
-    Router: react__default.FC<{
-        children?: react__default.ReactNode | undefined;
-    }>;
-};
-
-declare function shouldEnableAppletDevtools(): boolean;
-
-declare function AppletDevtoolsOverlay(): react_jsx_runtime.JSX.Element;
-
-export { AppConfig, AppletDevtoolsOverlay, AppletProvider, type AppletRPCError, AppletRPCException, type AppletRPCSchema, ConfigProvider, InitialContext, PermissionsHook, RouteContext, type RouterMode, SessionHook, StreamingHook, TranslationHook, UserContext, createAppletRPCClient, createAppletRouter, defineReactAppletElement, shouldEnableAppletDevtools, useAppletContext$1 as useAppletContext, useAppletContext as useAppletContextDirect, useAppletRuntime, useConfig, useConfigContext, usePermissions, useRoute, useSession, useStreaming, useTranslation, useUser };
+export { AppletProvider, ConfigProvider, useAppletContext, useAppletContextDirect, useAppletRuntime, useConfig, useConfigContext, usePermissions, useRoute, useSession, useStreaming, useTranslation, useUser } from './applet/core.js';
+export { A as AppConfig, I as InitialContext, L as LocaleContext, P as PermissionsHook, R as RouteContext, S as SessionContext, a as SessionHook, b as StreamingHook, T as TenantContext, c as TranslationHook, U as UserContext } from './index-Cs_xWkhC.js';
+export { AppletRPCError, AppletRPCException, AppletRPCSchema, RouterMode, createAppletRPCClient, createAppletRouter, defineReactAppletElement } from './applet/host.js';
+export { AppletDevtoolsOverlay, shouldEnableAppletDevtools } from './applet/devtools.js';
+import 'react/jsx-runtime';
+import 'react';

package/dist/index.mjs

@@ -4,11 +4,58 @@ import { createRoot } from 'react-dom/client';
 
 // ui/src/applet-core/context/AppletContext.tsx
 var AppletContext = 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 initialContext = context ?? window[windowKey];
-  if (!initialContext) {
+  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__ */ jsx(AppletContext.Provider, { value: initialContext, children });
 }
 function useAppletContext() {
@@ -84,8 +131,9 @@ function useTranslation() {
     language: locale.language
   };
 }
-function useSession() {
+function useSession(options) {
   const { session } = useAppletContext();
+  const loginPath = options?.loginPath ?? "/login";
   const isExpiringSoon = useMemo(() => {
     const bufferMs = 5 * 60 * 1e3;
     return session.expiresAt - Date.now() < bufferMs;
@@ -99,7 +147,7 @@ function useSession() {
     });
     if (!response.ok) {
       const returnUrl = encodeURIComponent(window.location.pathname);
-      window.location.href = `/login?redirect=${returnUrl}`;
+      window.location.href = `${loginPath}?redirect=${returnUrl}`;
       return;
     }
     const newToken = response.headers.get("X-CSRF-Token");