@burdenoff/microfe-channel 2026.510.112

package/dist/channel/providers/ChannelProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelProvider.js","names":[],"sources":["../../../src/channel/providers/ChannelProvider.tsx"],"sourcesContent":["import type { FC, PropsWithChildren } from 'react';\nimport { createContext, useContext } from 'react';\nimport { MemoryRouter } from 'react-router-dom';\nimport { PermissionProvider } from '@burdenoff/fe-libs/shared/providers/shell';\nimport type { ChannelRootProps } from '../types';\n\n/**\n * Context value for Channel microfrontend\n */\ntype ChannelContextValue = ChannelRootProps;\n\nconst ChannelContext = createContext<ChannelContextValue | null>(null);\n\n/**\n * Hook to access Channel context\n */\nexport const useChannel = () => {\n  const context = useContext(ChannelContext);\n  if (!context) {\n    throw new Error('useChannel must be used within ChannelProvider');\n  }\n  return context;\n};\n\n/**\n * Provider component for Channel microfrontend\n * Sets up routing and context\n *\n * When integrated into a shell (basePath provided), the shell already has a router\n * so we don't create another one. When standalone (no basePath), use MemoryRouter.\n */\nexport const ChannelProvider: FC<PropsWithChildren<ChannelRootProps>> = ({\n  children,\n  basePath,\n  navigate,\n  currentUser,\n  workspaceId,\n  organizationId,\n  tenantId,\n  apiGatewayUrl,\n  authToken,\n  registerNavItems,\n  registerFooterItems,\n}) => {\n  const contextValue: ChannelContextValue = {\n    basePath,\n    navigate,\n    currentUser,\n    workspaceId,\n    organizationId,\n    tenantId,\n    apiGatewayUrl,\n    authToken,\n    registerNavItems,\n    registerFooterItems,\n  };\n\n  // PermissionProvider requires the shell's AuthProvider — only mount it in integrated mode.\n  // In standalone/dev mode (MemoryRouter path), there's no AuthProvider, so we skip it.\n  const isIntegrated = !!basePath;\n\n  const content = (\n    <ChannelContext.Provider value={contextValue}>\n      {isIntegrated ? (\n        <PermissionProvider scopeId={organizationId ?? null} gateway=\"global\">\n          {children}\n        </PermissionProvider>\n      ) : (\n        children\n      )}\n    </ChannelContext.Provider>\n  );\n\n  // When integrated into a shell (basePath provided), the shell already has a router\n  // so we don't create another one. When standalone (no basePath), use MemoryRouter.\n  if (isIntegrated) {\n    return content;\n  }\n\n  // Standalone mode: create MemoryRouter for independent operation\n  return <MemoryRouter>{content}</MemoryRouter>;\n};\n"],"mappings":";;;;;AAWA,IAAM,IAAiB,EAA0C,KAAK,EAKzD,UAAmB;CAC9B,IAAM,IAAU,EAAW,EAAe;AAC1C,KAAI,CAAC,EACH,OAAU,MAAM,iDAAiD;AAEnE,QAAO;GAUI,KAA4D,EACvE,aACA,aACA,aACA,gBACA,gBACA,mBACA,aACA,kBACA,cACA,qBACA,6BACI;CACJ,IAAM,IAAoC;EACxC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,EAIK,IAAe,CAAC,CAAC,GAEjB,IACJ,kBAAC,EAAe,UAAhB;EAAyB,OAAO;YAC7B,IACC,kBAAC,GAAD;GAAoB,SAAS,KAAkB;GAAM,SAAQ;GAC1D;GACkB,CAAA,GAErB;EAEsB,CAAA;AAU5B,QALI,IACK,IAIF,kBAAC,GAAD,EAAA,UAAe,GAAuB,CAAA"}

package/dist/channel/types/index.d.ts

@@ -0,0 +1,89 @@
+import { ReactNode } from 'react';
+
+/**
+ * Navigation item for shell integration
+ */
+export interface NavItem {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    path: string;
+    badge?: number;
+    order?: number;
+    group?: string;
+    visible?: boolean;
+    children?: NavItem[];
+}
+/**
+ * Footer item for shell integration
+ */
+export interface FooterItem {
+    id: string;
+    label: string;
+    icon?: string;
+    onClick?: () => void;
+    type?: 'status' | 'action' | 'info';
+    order?: number;
+    badge?: string;
+    section?: 'left' | 'center' | 'right';
+    visible?: boolean;
+}
+/**
+ * Base user type
+ */
+export interface User {
+    id: string;
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    avatar?: string;
+    username?: string;
+    name?: string;
+    role?: string;
+}
+/**
+ * Props for the ChannelRoot component
+ */
+export interface ChannelRootProps {
+    /**
+     * Base path for the microfrontend (e.g., '/channels')
+     */
+    basePath: string;
+    /**
+     * Navigation function injected by the host shell
+     */
+    navigate: (path: string) => void;
+    /**
+     * Current authenticated user
+     */
+    currentUser?: User;
+    /**
+     * Workspace ID for Channel context
+     */
+    workspaceId?: string;
+    /**
+     * Organization ID for Channel context
+     */
+    organizationId?: string;
+    /**
+     * Tenant ID for RBAC permission checks (global gateway scope)
+     */
+    tenantId?: string;
+    /**
+     * API Gateway URL
+     */
+    apiGatewayUrl?: string;
+    /**
+     * Authentication token
+     */
+    authToken?: string;
+    /**
+     * Optional function to register navigation items with the shell
+     */
+    registerNavItems?: (items: NavItem | NavItem[]) => () => void;
+    /**
+     * Optional function to register footer items with the shell
+     */
+    registerFooterItems?: (items: FooterItem | FooterItem[]) => () => void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/channel/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channel/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEjC;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,KAAK,MAAM,IAAI,CAAC;IAE9D;;OAEG;IACH,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,KAAK,MAAM,IAAI,CAAC;CACxE"}

package/dist/channel/utils/shellBridge.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Shell bridge — unified accessor for capabilities exposed by the host app
+ * shell on `globalThis.__burdenoffShell`. Each accessor is fully optional:
+ * the MFE must work in isolation (Storybook/standalone Vite dev) when the
+ * shell global is absent.
+ *
+ * Capabilities consumed:
+ *  - `eventBus`        — cross-MFE pub/sub bus per spec MFE-047
+ *  - `reportError`     — central SRE error sink (Rybbit + backend forward)
+ *  - `graphqlWsClient` — graphql-ws Client instance (probe-only; subs falls
+ *                        back to polling when absent)
+ */
+export interface ShellEventBus {
+    /** Emit a domain event onto the shell bus. */
+    emit?: (name: string, payload?: unknown, options?: Record<string, unknown>) => void;
+    /** Subscribe; returns an unsubscribe function. */
+    on?: (name: string, handler: (event: unknown) => void) => () => void;
+}
+export interface ShellReportErrorMeta {
+    module: string;
+    context?: Record<string, unknown>;
+    componentStack?: string;
+}
+/**
+ * Minimal subset of a graphql-ws Client we rely on.
+ * https://the-guild.dev/graphql/ws/recipes#use-the-client-without-apollo
+ */
+export interface GraphqlWsLike {
+    subscribe: (payload: {
+        query: string;
+        variables?: Record<string, unknown>;
+        operationName?: string;
+    }, sink: {
+        next: (value: {
+            data?: unknown;
+            errors?: readonly unknown[];
+        }) => void;
+        error: (err: unknown) => void;
+        complete: () => void;
+    }) => () => void;
+}
+/**
+ * Emit a domain event onto the shell bus. Safe no-op when the shell or bus
+ * is absent. `name` follows `<domain>.<entity>.<verb>` (per spec 47).
+ */
+export declare function emitShellEvent(name: string, payload?: unknown): void;
+/**
+ * Subscribe to a shell-bus event; returns an unsubscribe function. Returns a
+ * no-op unsubscribe when the bus is absent.
+ */
+export declare function subscribeShellEvent(name: string, handler: (event: unknown) => void): () => void;
+/**
+ * Forward an error to the shell's central error sink. Falls back to
+ * `console.error` only when the sink is missing — mirrors the pattern in
+ * `microfe-tags/src/tags/components/RouteHelpers.tsx`.
+ */
+export declare function reportShellError(error: unknown, meta: ShellReportErrorMeta, fallbackLabel?: string): void;
+export declare function getGraphqlWsClient(): GraphqlWsLike | undefined;
+//# sourceMappingURL=shellBridge.d.ts.map

package/dist/channel/utils/shellBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellBridge.d.ts","sourceRoot":"","sources":["../../../src/channel/utils/shellBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpF,kDAAkD;IAClD,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACtE;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,CACT,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,EACvF,IAAI,EAAE;QACJ,IAAI,EAAE,CAAC,KAAK,EAAE;YAAE,IAAI,CAAC,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;SAAE,KAAK,IAAI,CAAC;QACvE,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;QAC9B,QAAQ,EAAE,MAAM,IAAI,CAAC;KACtB,KACE,MAAM,IAAI,CAAC;CACjB;AAoBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAMpE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAQ/F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,oBAAoB,EAC1B,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAkBN;AAED,wBAAgB,kBAAkB,IAAI,aAAa,GAAG,SAAS,CAE9D"}

package/dist/channel/utils/shellBridge.js

@@ -0,0 +1,36 @@
+//#region src/channel/utils/shellBridge.ts
+function e() {
+	return globalThis.__burdenoffShell;
+}
+function t() {
+	return e()?.eventBus;
+}
+function n(e, n) {
+	try {
+		t()?.emit?.(e, n, { component: "microfe-channel" });
+	} catch {}
+}
+function r(e, n) {
+	let r = t();
+	if (!r?.on) return () => {};
+	try {
+		return r.on(e, n) ?? (() => {});
+	} catch {
+		return () => {};
+	}
+}
+function i(t, n, r) {
+	let i = t instanceof Error ? t : Error(String(t)), a = e();
+	if (a?.reportError) try {
+		a.reportError(i, n);
+		return;
+	} catch {}
+	console.error(r || `[${n.module}]`, i, n.context ?? {});
+}
+function a() {
+	return e()?.graphqlWsClient;
+}
+//#endregion
+export { n as emitShellEvent, a as getGraphqlWsClient, i as reportShellError, r as subscribeShellEvent };
+
+//# sourceMappingURL=shellBridge.js.map

package/dist/channel/utils/shellBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellBridge.js","names":[],"sources":["../../../src/channel/utils/shellBridge.ts"],"sourcesContent":["/**\n * Shell bridge — unified accessor for capabilities exposed by the host app\n * shell on `globalThis.__burdenoffShell`. Each accessor is fully optional:\n * the MFE must work in isolation (Storybook/standalone Vite dev) when the\n * shell global is absent.\n *\n * Capabilities consumed:\n *  - `eventBus`        — cross-MFE pub/sub bus per spec MFE-047\n *  - `reportError`     — central SRE error sink (Rybbit + backend forward)\n *  - `graphqlWsClient` — graphql-ws Client instance (probe-only; subs falls\n *                        back to polling when absent)\n */\n\nexport interface ShellEventBus {\n  /** Emit a domain event onto the shell bus. */\n  emit?: (name: string, payload?: unknown, options?: Record<string, unknown>) => void;\n  /** Subscribe; returns an unsubscribe function. */\n  on?: (name: string, handler: (event: unknown) => void) => () => void;\n}\n\nexport interface ShellReportErrorMeta {\n  module: string;\n  context?: Record<string, unknown>;\n  componentStack?: string;\n}\n\n/**\n * Minimal subset of a graphql-ws Client we rely on.\n * https://the-guild.dev/graphql/ws/recipes#use-the-client-without-apollo\n */\nexport interface GraphqlWsLike {\n  subscribe: (\n    payload: { query: string; variables?: Record<string, unknown>; operationName?: string },\n    sink: {\n      next: (value: { data?: unknown; errors?: readonly unknown[] }) => void;\n      error: (err: unknown) => void;\n      complete: () => void;\n    }\n  ) => () => void;\n}\n\ninterface BurdenoffShell {\n  eventBus?: ShellEventBus;\n  reportError?: (\n    sourceOrError: string | Error,\n    errorOrMeta?: Error | ShellReportErrorMeta,\n    meta?: ShellReportErrorMeta | Record<string, unknown>\n  ) => void;\n  graphqlWsClient?: GraphqlWsLike;\n}\n\nfunction getShell(): BurdenoffShell | undefined {\n  return (globalThis as unknown as { __burdenoffShell?: BurdenoffShell }).__burdenoffShell;\n}\n\nfunction getEventBus(): ShellEventBus | undefined {\n  return getShell()?.eventBus;\n}\n\n/**\n * Emit a domain event onto the shell bus. Safe no-op when the shell or bus\n * is absent. `name` follows `<domain>.<entity>.<verb>` (per spec 47).\n */\nexport function emitShellEvent(name: string, payload?: unknown): void {\n  try {\n    getEventBus()?.emit?.(name, payload, { component: 'microfe-channel' });\n  } catch {\n    /* sink failures must never break the emitter */\n  }\n}\n\n/**\n * Subscribe to a shell-bus event; returns an unsubscribe function. Returns a\n * no-op unsubscribe when the bus is absent.\n */\nexport function subscribeShellEvent(name: string, handler: (event: unknown) => void): () => void {\n  const bus = getEventBus();\n  if (!bus?.on) return () => {};\n  try {\n    return bus.on(name, handler) ?? (() => {});\n  } catch {\n    return () => {};\n  }\n}\n\n/**\n * Forward an error to the shell's central error sink. Falls back to\n * `console.error` only when the sink is missing — mirrors the pattern in\n * `microfe-tags/src/tags/components/RouteHelpers.tsx`.\n */\nexport function reportShellError(\n  error: unknown,\n  meta: ShellReportErrorMeta,\n  fallbackLabel?: string\n): void {\n  const err = error instanceof Error ? error : new Error(String(error));\n  const sink = getShell();\n  if (sink?.reportError) {\n    try {\n      sink.reportError(err, meta);\n      return;\n    } catch {\n      /* fall through to console */\n    }\n  }\n  // Fallback path: shell missing or sink threw. Preserves observability in\n  // standalone dev.\n  if (fallbackLabel) {\n    console.error(fallbackLabel, err, meta.context ?? {});\n  } else {\n    console.error(`[${meta.module}]`, err, meta.context ?? {});\n  }\n}\n\nexport function getGraphqlWsClient(): GraphqlWsLike | undefined {\n  return getShell()?.graphqlWsClient;\n}\n"],"mappings":";AAmDA,SAAS,IAAuC;AAC9C,QAAQ,WAAgE;;AAG1E,SAAS,IAAyC;AAChD,QAAO,GAAU,EAAE;;AAOrB,SAAgB,EAAe,GAAc,GAAyB;AACpE,KAAI;AACF,KAAa,EAAE,OAAO,GAAM,GAAS,EAAE,WAAW,mBAAmB,CAAC;SAChE;;AASV,SAAgB,EAAoB,GAAc,GAA+C;CAC/F,IAAM,IAAM,GAAa;AACzB,KAAI,CAAC,GAAK,GAAI,cAAa;AAC3B,KAAI;AACF,SAAO,EAAI,GAAG,GAAM,EAAQ,WAAW;SACjC;AACN,eAAa;;;AASjB,SAAgB,EACd,GACA,GACA,GACM;CACN,IAAM,IAAM,aAAiB,QAAQ,IAAY,MAAM,OAAO,EAAM,CAAC,EAC/D,IAAO,GAAU;AACvB,KAAI,GAAM,YACR,KAAI;AACF,IAAK,YAAY,GAAK,EAAK;AAC3B;SACM;AAMV,CACE,QAAQ,MADN,KAGY,IAAI,EAAK,OAAO,IAFD,GAAK,EAAK,WAAW,EAAE,CAEM;;AAI9D,SAAgB,IAAgD;AAC9D,QAAO,GAAU,EAAE"}

package/dist/dev/App.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Development app wrapper
+ * Provides mock props and Apollo Client setup for local development
+ */
+export declare function App(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=App.d.ts.map

package/dist/dev/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/dev/App.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AA8CH,wBAAgB,GAAG,4CAMlB"}

package/dist/dev/main.d.ts

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=main.d.ts.map

package/dist/dev/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/dev/main.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,aAAa,CAAC"}