@sybilion/uilib 1.1.0 → 1.2.0

package/src/mini-app/miniAppChatBridge.ts

@@ -1,55 +0,0 @@
-import type { ChatResponse } from '#uilib/types/chat-api.types';
-
-import {
-  buildChatSendMessage,
-  isTrustedMiniAppParentMessage,
-  parseChatSendResultMessage,
-  resolveParentOriginFromReferrer,
-} from './miniAppProtocol';
-
-const DEFAULT_TIMEOUT_MS = 60_000;
-
-/**
- * Ask the Sybilion host to send a chat message with its auth token.
- * Does not update host ChatSheet state — same session as `chatId` on the agent only.
- */
-export async function sendChatMessage(
-  chatId: string,
-  message: string,
-): Promise<ChatResponse> {
-  if (typeof window === 'undefined' || window.parent === window) {
-    throw new Error('sendChatMessage requires an embedded mini-app (iframe)');
-  }
-
-  const requestId = crypto.randomUUID();
-  const target = resolveParentOriginFromReferrer();
-  const payload = { requestId, chatId, message };
-  const msg = buildChatSendMessage(payload);
-
-  return new Promise((resolve, reject) => {
-    const onMessage = (event: MessageEvent) => {
-      if (!isTrustedMiniAppParentMessage(event)) return;
-      const parsed = parseChatSendResultMessage(event.data);
-      if (!parsed || parsed.requestId !== requestId) return;
-      window.removeEventListener('message', onMessage);
-      clearTimeout(timer);
-      if (parsed.ok === true) {
-        resolve(parsed.result);
-        return;
-      }
-      reject(new Error(parsed.error));
-    };
-
-    window.addEventListener('message', onMessage);
-    const timer = setTimeout(() => {
-      window.removeEventListener('message', onMessage);
-      reject(new Error('Mini-app chat request timed out'));
-    }, DEFAULT_TIMEOUT_MS);
-
-    if (target) {
-      window.parent.postMessage(msg, target);
-    } else {
-      window.parent.postMessage(msg, '*');
-    }
-  });
-}

package/src/mini-app/miniAppDataClient.ts

@@ -1,165 +0,0 @@
-import type {
-  MiniAppDataset,
-  MiniAppDriversComparisonSnapshot,
-  MiniAppForecastMap,
-  MiniAppPerformanceBundle,
-} from './miniAppDataTypes';
-import {
-  type MiniAppDataOp,
-  type MiniAppDataRequestPayload,
-  buildDataRequestMessage,
-  isTrustedMiniAppParentMessage,
-  parseDataResponseMessage,
-  resolveParentOriginFromReferrer,
-} from './miniAppProtocol';
-
-export type MiniAppDataClientOptions = {
-  /** Default 10000 ms. */
-  timeoutMs?: number;
-};
-
-export type MiniAppDataClient = {
-  getDatasets(): Promise<MiniAppDataset[]>;
-  getDataset(id: number): Promise<MiniAppDataset | null>;
-  getForecasts(datasetId: number): Promise<MiniAppForecastMap>;
-  getForecast(datasetId: number, analysisId: number): Promise<unknown | null>;
-  getDrivers(datasetId: number, analysisId: number): Promise<unknown[]>;
-  getPerformanceData(
-    datasetId: number,
-    analysisId: number,
-  ): Promise<MiniAppPerformanceBundle>;
-  getDriversComparisonData(
-    datasetId: number,
-    analysisId: number,
-  ): Promise<MiniAppDriversComparisonSnapshot>;
-};
-
-const DEFAULT_TIMEOUT_MS = 10_000;
-
-type Pending = {
-  resolve: (value: unknown) => void;
-  reject: (err: Error) => void;
-  timer: ReturnType<typeof setTimeout>;
-};
-
-/** One listener per browsing context; tracks in-flight bridge requests by `requestId`. */
-export function createMiniAppDataClient(
-  options?: MiniAppDataClientOptions,
-): MiniAppDataClient {
-  const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  const pending = new Map<string, Pending>();
-  let listening = false;
-
-  const settle = (rid: string, fn: (p: Pending) => void): void => {
-    const p = pending.get(rid);
-    if (!p) return;
-    clearTimeout(p.timer);
-    pending.delete(rid);
-    fn(p);
-  };
-
-  function ensureListener(): void {
-    if (listening || typeof window === 'undefined') return;
-    listening = true;
-    window.addEventListener('message', (event: MessageEvent) => {
-      if (!isTrustedMiniAppParentMessage(event)) return;
-      const msg = parseDataResponseMessage(event.data);
-      if (!msg) return;
-      settle(msg.requestId, p => {
-        if (msg.ok) {
-          p.resolve(msg.result);
-        } else {
-          p.reject(
-            new Error(
-              typeof msg.error === 'string'
-                ? msg.error
-                : 'Mini-app data request failed',
-            ),
-          );
-        }
-      });
-    });
-  }
-
-  function request(
-    payload: Omit<MiniAppDataRequestPayload, 'requestId'>,
-  ): Promise<unknown> {
-    if (typeof window === 'undefined' || window.parent === window) {
-      throw new Error('MiniAppDataClient works only inside an iframe embed');
-    }
-    ensureListener();
-
-    const requestId =
-      typeof crypto !== 'undefined' && 'randomUUID' in crypto
-        ? crypto.randomUUID()
-        : `miniapp-${Date.now()}-${Math.random().toString(36).slice(2)}`;
-
-    const envelope = buildDataRequestMessage({
-      ...payload,
-      requestId,
-    });
-    const target = resolveParentOriginFromReferrer();
-
-    return new Promise((resolve, reject) => {
-      const timer = setTimeout(() => {
-        settle(requestId, p => {
-          p.reject(new Error('Mini-app data request timed out'));
-        });
-      }, timeoutMs);
-
-      pending.set(requestId, {
-        resolve,
-        reject,
-        timer,
-      });
-
-      try {
-        if (target) {
-          window.parent.postMessage(envelope, target);
-        } else {
-          window.parent.postMessage(envelope, '*');
-        }
-      } catch (e) {
-        settle(requestId, p => {
-          p.reject(
-            e instanceof Error ? e : new Error('Mini-app postMessage failed'),
-          );
-        });
-      }
-    });
-  }
-
-  async function rq<R>(
-    op: MiniAppDataOp,
-    params?: Record<string, number>,
-  ): Promise<R> {
-    return request({ op, params }) as Promise<R>;
-  }
-
-  return {
-    getDatasets: () => rq<MiniAppDataset[]>('getDatasets'),
-
-    getDataset: id => rq<MiniAppDataset | null>('getDataset', { id }),
-
-    getForecasts: datasetId =>
-      rq<MiniAppForecastMap>('getForecasts', { datasetId }),
-
-    getForecast: (datasetId, analysisId) =>
-      rq<unknown | null>('getForecast', { datasetId, analysisId }),
-
-    getDrivers: (datasetId, analysisId) =>
-      rq<unknown[]>('getDrivers', { datasetId, analysisId }),
-
-    getPerformanceData: (datasetId, analysisId) =>
-      rq<MiniAppPerformanceBundle>('getPerformanceData', {
-        datasetId,
-        analysisId,
-      }),
-
-    getDriversComparisonData: (datasetId, analysisId) =>
-      rq<MiniAppDriversComparisonSnapshot>('getDriversComparisonData', {
-        datasetId,
-        analysisId,
-      }),
-  };
-}

package/src/mini-app/miniAppProtocol.ts

@@ -1,247 +0,0 @@
-/**
- * postMessage protocol for Sybilion workspace mini-apps (iframe child).
- * Keep in sync with sybilion-client `src/workspace/miniAppBridge.ts` (channel, version, payloads).
- */
-import type { ChatResponse } from '#uilib/types/chat-api.types';
-
-export const MINIAPP_CHANNEL = 'sybilion.miniapp' as const;
-export const MINIAPP_VERSION = 1 as const;
-
-export type ThemeSyncPayload = {
-  mode: 'light' | 'dark';
-  isDarkMode: boolean;
-};
-
-export type MiniAppMessageReady = {
-  channel: typeof MINIAPP_CHANNEL;
-  version: typeof MINIAPP_VERSION;
-  type: 'READY';
-  payload: Record<string, unknown> | { appId?: string };
-};
-
-export type MiniAppMessageThemeSync = {
-  channel: typeof MINIAPP_CHANNEL;
-  version: typeof MINIAPP_VERSION;
-  type: 'THEME_SYNC';
-  payload: ThemeSyncPayload;
-};
-
-export type MiniAppDataOp =
-  | 'getDatasets'
-  | 'getDataset'
-  | 'getForecasts'
-  | 'getForecast'
-  | 'getDrivers'
-  | 'getPerformanceData'
-  | 'getDriversComparisonData';
-
-export type MiniAppDataRequestPayload = {
-  requestId: string;
-  op: MiniAppDataOp;
-  params?: Record<string, number>;
-};
-
-export type MiniAppMessageDataRequest = {
-  channel: typeof MINIAPP_CHANNEL;
-  version: typeof MINIAPP_VERSION;
-  type: 'DATA_REQUEST';
-  payload: MiniAppDataRequestPayload;
-};
-
-export type MiniAppDataResponsePayload = {
-  requestId: string;
-  ok: boolean;
-  result?: unknown;
-  error?: string;
-};
-
-export type MiniAppMessageDataResponse = {
-  channel: typeof MINIAPP_CHANNEL;
-  version: typeof MINIAPP_VERSION;
-  type: 'DATA_RESPONSE';
-  payload: MiniAppDataResponsePayload;
-};
-
-export type MiniAppChatSendPayload = {
-  requestId: string;
-  chatId: string;
-  message: string;
-};
-
-export type MiniAppMessageChatSend = {
-  channel: typeof MINIAPP_CHANNEL;
-  version: typeof MINIAPP_VERSION;
-  type: 'CHAT_SEND';
-  payload: MiniAppChatSendPayload;
-};
-
-export type MiniAppChatSendResultPayload =
-  | {
-      requestId: string;
-      ok: true;
-      result: ChatResponse;
-    }
-  | {
-      requestId: string;
-      ok: false;
-      error: string;
-    };
-
-export type MiniAppMessageChatSendResult = {
-  channel: typeof MINIAPP_CHANNEL;
-  version: typeof MINIAPP_VERSION;
-  type: 'CHAT_SEND_RESULT';
-  payload: MiniAppChatSendResultPayload;
-};
-
-function isRecord(v: unknown): v is Record<string, unknown> {
-  return typeof v === 'object' && v !== null && !Array.isArray(v);
-}
-
-/** Parse parent → child THEME_SYNC (shell uses `buildThemeSyncMessage`). */
-export function parseThemeSyncMessage(data: unknown): ThemeSyncPayload | null {
-  if (!isRecord(data)) return null;
-  if (data.channel !== MINIAPP_CHANNEL) return null;
-  if (data.version !== MINIAPP_VERSION) return null;
-  if (data.type !== 'THEME_SYNC') return null;
-
-  const payload = data.payload;
-  if (!isRecord(payload)) return null;
-
-  const mode = payload.mode === 'dark' ? 'dark' : 'light';
-  const isDarkMode =
-    typeof payload.isDarkMode === 'boolean'
-      ? payload.isDarkMode
-      : mode === 'dark';
-
-  return { mode, isDarkMode };
-}
-
-/** Child → parent READY (optional `appId` for telemetry). */
-export function buildReadyMessage(
-  payload: Record<string, unknown> = {},
-): MiniAppMessageReady {
-  return {
-    channel: MINIAPP_CHANNEL,
-    version: MINIAPP_VERSION,
-    type: 'READY',
-    payload,
-  };
-}
-
-export function resolveParentOriginFromReferrer(): string | null {
-  try {
-    if (typeof document !== 'undefined' && document.referrer) {
-      return new URL(document.referrer).origin;
-    }
-  } catch {
-    /* invalid referrer */
-  }
-  return null;
-}
-
-export function applyThemeToDocument(mode: 'light' | 'dark'): void {
-  if (typeof document === 'undefined') return;
-  const root = document.documentElement;
-  root.classList.remove('light', 'dark');
-  root.classList.add(mode);
-}
-
-/** Only accept shell messages that appear to come from the real embedding parent. */
-export function isTrustedMiniAppParentMessage(event: MessageEvent): boolean {
-  if (event.source !== window.parent) return false;
-  const fromReferrer = resolveParentOriginFromReferrer();
-  if (fromReferrer && event.origin !== fromReferrer) return false;
-  return true;
-}
-
-export function buildDataRequestMessage(
-  payload: MiniAppDataRequestPayload,
-): MiniAppMessageDataRequest {
-  return {
-    channel: MINIAPP_CHANNEL,
-    version: MINIAPP_VERSION,
-    type: 'DATA_REQUEST',
-    payload,
-  };
-}
-
-export function buildChatSendMessage(
-  payload: MiniAppChatSendPayload,
-): MiniAppMessageChatSend {
-  return {
-    channel: MINIAPP_CHANNEL,
-    version: MINIAPP_VERSION,
-    type: 'CHAT_SEND',
-    payload,
-  };
-}
-
-/** Parse parent → child DATA_RESPONSE. */
-export function parseDataResponseMessage(
-  data: unknown,
-): MiniAppDataResponsePayload | null {
-  if (!isRecord(data)) return null;
-  if (data.channel !== MINIAPP_CHANNEL) return null;
-  if (data.version !== MINIAPP_VERSION) return null;
-  if (data.type !== 'DATA_RESPONSE') return null;
-  const payload = data.payload;
-  if (!isRecord(payload)) return null;
-  const requestId = payload.requestId;
-  if (typeof requestId !== 'string' || requestId.length === 0) return null;
-  const ok = payload.ok === true;
-  const errOk = payload.ok === false;
-  if (!ok && !errOk) return null;
-
-  const base: MiniAppDataResponsePayload = {
-    requestId,
-    ok,
-  };
-
-  if ('result' in payload) {
-    base.result = payload.result;
-  }
-  if (typeof payload.error === 'string') {
-    base.error = payload.error;
-  }
-  return base;
-}
-
-/** Parse parent → child CHAT_SEND_RESULT (shell uses `buildChatSendResultMessage`). */
-export function parseChatSendResultMessage(
-  data: unknown,
-): MiniAppChatSendResultPayload | null {
-  if (!isRecord(data)) return null;
-  if (data.channel !== MINIAPP_CHANNEL) return null;
-  if (data.version !== MINIAPP_VERSION) return null;
-  if (data.type !== 'CHAT_SEND_RESULT') return null;
-  const payload = data.payload;
-  if (!isRecord(payload)) return null;
-  const requestId = payload.requestId;
-  if (typeof requestId !== 'string' || requestId.length === 0) return null;
-
-  if (payload.ok === true) {
-    const result = payload.result;
-    if (!isRecord(result)) return null;
-    const responseText = result.response;
-    if (typeof responseText !== 'string') return null;
-    const sidRaw = result.session_id;
-    if (sidRaw !== undefined && sidRaw !== null && typeof sidRaw !== 'string')
-      return null;
-    const session_id: string | null =
-      typeof sidRaw === 'string' ? sidRaw : null;
-    return {
-      requestId,
-      ok: true,
-      result: {
-        response: responseText,
-        session_id,
-      },
-    };
-  }
-  if (payload.ok === false) {
-    if (typeof payload.error !== 'string') return null;
-    return { requestId, ok: false, error: payload.error };
-  }
-  return null;
-}

package/src/mini-app/miniAppThemeConfig.ts

@@ -1,45 +0,0 @@
-import { ThemeDefaults, ThemeHelpers } from '@homecode/ui';
-
-const { colors, getColors, getConfig } = ThemeDefaults;
-
-const defaultPalette = getColors();
-
-const colorsConfig = {
-  light: {
-    ...ThemeHelpers.colorsConfigToVars({
-      ...getColors({
-        accent: colors.dark,
-        decent: colors.light,
-      }),
-    }),
-  },
-  dark: {
-    ...ThemeHelpers.colorsConfigToVars({
-      ...getColors({
-        accent: colors.light,
-        decent: colors.dark,
-      }),
-    }),
-  },
-};
-
-/** Homecode `<Theme config={...}>` shape for workspace mini-apps (generic palette). */
-export function getDefaultMiniAppThemeConfig(isDarkMode: boolean) {
-  return {
-    ...getConfig(),
-    ...colorsConfig[isDarkMode ? 'dark' : 'light'],
-    ...ThemeHelpers.colorsConfigToVars({
-      active: {
-        color: '#00a9c7',
-        mods: {
-          // @ts-ignore — extend defaults so --active-color-alpha-* variants match Homecode
-          alpha: [0, 50, 100, 200, ...defaultPalette.active.mods.alpha],
-        },
-      },
-    }),
-  };
-}
-
-export type MiniAppThemeConfig = ReturnType<
-  typeof getDefaultMiniAppThemeConfig
->;