@burdenoff/fe-libs 2026.528.10 → 2026.528.11

package/dist/shared/events/sinks/BroadcastChannelSink.d.ts

@@ -0,0 +1,10 @@
+interface BroadcastChannelSinkProps {
+    channelName?: string;
+}
+/**
+ * BroadcastChannelSink relays every event bus emission to a BroadcastChannel
+ * so other tabs/windows of the same origin receive the events.
+ */
+export declare function BroadcastChannelSink({ channelName, }: BroadcastChannelSinkProps): null;
+export {};
+//# sourceMappingURL=BroadcastChannelSink.d.ts.map

package/dist/shared/events/sinks/BroadcastChannelSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BroadcastChannelSink.d.ts","sourceRoot":"","sources":["../../../../src/shared/events/sinks/BroadcastChannelSink.tsx"],"names":[],"mappings":"AAKA,UAAU,yBAAyB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,WAAgC,GACjC,EAAE,yBAAyB,QAoB3B"}

package/dist/shared/events/sinks/DevtoolsSink.d.ts

@@ -0,0 +1,10 @@
+interface DevtoolsSinkProps {
+    enabled?: boolean;
+}
+/**
+ * DevtoolsSink logs every event bus emission to the browser console.
+ * Render inside EventBusProvider. Typically enabled only in development.
+ */
+export declare function DevtoolsSink({ enabled }: DevtoolsSinkProps): null;
+export {};
+//# sourceMappingURL=DevtoolsSink.d.ts.map

package/dist/shared/events/sinks/DevtoolsSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevtoolsSink.d.ts","sourceRoot":"","sources":["../../../../src/shared/events/sinks/DevtoolsSink.tsx"],"names":[],"mappings":"AAKA,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,OAAc,EAAE,EAAE,iBAAiB,QAgBjE"}

package/dist/shared/events/sinks/OtelBrowserSink.d.ts

@@ -0,0 +1,14 @@
+interface OtelBrowserSinkProps {
+    endpoint: string | undefined;
+    /** Service name for OTLP resource. Default "frontend". */
+    serviceName?: string;
+    /** How long to wait before flushing spans (ms). Default 5000. */
+    flushInterval?: number;
+}
+/**
+ * OtelBrowserSink forwards event bus emissions as OTLP/HTTP trace spans.
+ * Uses fetch to POST to the configured OpenTelemetry collector endpoint.
+ */
+export declare function OtelBrowserSink({ endpoint, serviceName, flushInterval, }: OtelBrowserSinkProps): null;
+export {};
+//# sourceMappingURL=OtelBrowserSink.d.ts.map

package/dist/shared/events/sinks/OtelBrowserSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelBrowserSink.d.ts","sourceRoot":"","sources":["../../../../src/shared/events/sinks/OtelBrowserSink.tsx"],"names":[],"mappings":"AAMA,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAiED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,WAAwB,EACxB,aAAoB,GACrB,EAAE,oBAAoB,QAmDtB"}

package/dist/shared/events/sinks/RybbitSink.d.ts

@@ -0,0 +1,19 @@
+import { BurdenoffEventName } from '../index';
+interface RybbitSinkProps {
+    siteId: string | undefined;
+    scriptUrl?: string;
+    /** Map event bus names to Rybbit event names. Defaults to identity. */
+    rename?: Partial<Record<BurdenoffEventName, string>>;
+    /** Only forward these event names to Rybbit. Defaults to a minimal privacy-safe list. */
+    allowlist?: BurdenoffEventName[];
+    /** Which event triggers `rybbit.identify`. */
+    identifyOn?: BurdenoffEventName;
+}
+export declare function shouldDropAnalyticsKey(key: string, eventName: BurdenoffEventName): boolean;
+/**
+ * RybbitSink injects the Rybbit analytics script and forwards matching
+ * event bus emissions as Rybbit custom events.
+ */
+export declare function RybbitSink({ siteId, scriptUrl, rename, allowlist, identifyOn, }: RybbitSinkProps): null;
+export {};
+//# sourceMappingURL=RybbitSink.d.ts.map

package/dist/shared/events/sinks/RybbitSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RybbitSink.d.ts","sourceRoot":"","sources":["../../../../src/shared/events/sinks/RybbitSink.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAuChE,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,yFAAyF;IACzF,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AA2BD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAI1F;AA6BD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,SAAiD,EACjD,MAAW,EACX,SAAoC,EACpC,UAA6B,GAC9B,EAAE,eAAe,QAuDjB"}

package/dist/shared/events/sinks/index.d.ts

@@ -0,0 +1,6 @@
+export { DevtoolsSink } from './DevtoolsSink';
+export { BroadcastChannelSink } from './BroadcastChannelSink';
+export { BackendAuditSink } from './BackendAuditSink';
+export { RybbitSink } from './RybbitSink';
+export { OtelBrowserSink } from './OtelBrowserSink';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/events/sinks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/events/sinks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/shared/feature-flags/FeatureFlagProvider.d.ts

@@ -0,0 +1,47 @@
+import { ReactNode } from 'react';
+import { FeatureFlagContextValue, FeatureFlagProviderConfig } from './types';
+export interface FeatureFlagProviderProps extends FeatureFlagProviderConfig {
+    children: ReactNode;
+}
+/**
+ * FeatureFlagProvider — manages feature flag state for UI components.
+ *
+ * Evaluates feature flags against the backend for the given workspace context.
+ * When workspaceId is null (not in a workspace), flags are not fetched and
+ * all flags return the default-allow value (true).
+ *
+ * @example
+ * ```tsx
+ * // In your app shell
+ * <FeatureFlagProvider workspaceId={activeWorkspaceId} refreshInterval={60000}>
+ *   <App />
+ * </FeatureFlagProvider>
+ *
+ * // In components
+ * const { isEnabled } = useFeatureFlags();
+ * if (isEnabled('new-dashboard')) {
+ *   return <NewDashboard />;
+ * }
+ * ```
+ */
+export declare function FeatureFlagProvider({ children, workspaceId, gateway, flagKeys, refreshInterval, // 5 minutes
+staleTime, // 5 minutes
+debug, defaultEnabled, }: FeatureFlagProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access the feature flag context.
+ *
+ * @throws Error if used outside a FeatureFlagProvider.
+ *
+ * @example
+ * ```tsx
+ * const { isEnabled, getValue, isLoading } = useFeatureFlags();
+ *
+ * if (isLoading) return <Spinner />;
+ *
+ * if (isEnabled('new-dashboard')) {
+ *   return <NewDashboard />;
+ * }
+ * ```
+ */
+export declare function useFeatureFlags(): FeatureFlagContextValue;
+//# sourceMappingURL=FeatureFlagProvider.d.ts.map

package/dist/shared/feature-flags/FeatureFlagProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFlagProvider.d.ts","sourceRoot":"","sources":["../../../src/shared/feature-flags/FeatureFlagProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAGV,uBAAuB,EACvB,yBAAyB,EAE1B,MAAM,SAAS,CAAC;AA+BjB,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,WAAW,EACX,OAAkB,EAClB,QAAQ,EACR,eAA+B,EAAE,YAAY;AAC7C,SAAyB,EAAE,YAAY;AACvC,KAAa,EACb,cAAqB,GACtB,EAAE,wBAAwB,2CAwN1B;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,IAAI,uBAAuB,CAMzD"}

package/dist/shared/feature-flags/FeatureGate.d.ts

@@ -0,0 +1,27 @@
+import { ReactNode } from 'react';
+export interface FeatureGateProps {
+    /** Feature flag key to check */
+    flag: string;
+    /** Content to render when the flag is enabled (or disabled if inverted) */
+    children: ReactNode;
+    /** Content to render when the flag is disabled (or enabled if inverted) */
+    fallback?: ReactNode;
+    /** Content to render while flags are loading */
+    loading?: ReactNode;
+    /**
+     * Invert the check: render children when the flag is DISABLED.
+     * Useful for showing legacy UI until a new feature is enabled.
+     * @default false
+     */
+    invert?: boolean;
+    /**
+     * Default value if the flag is not found.
+     * @default true (default-allow)
+     */
+    defaultValue?: boolean;
+}
+/**
+ * FeatureGate — conditionally renders content based on a feature flag.
+ */
+export declare function FeatureGate({ flag, children, fallback, loading, invert, defaultValue, }: FeatureGateProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FeatureGate.d.ts.map

package/dist/shared/feature-flags/FeatureGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureGate.d.ts","sourceRoot":"","sources":["../../../src/shared/feature-flags/FeatureGate.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,CAAC;IACpB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gDAAgD;IAChD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,QAAQ,EACR,QAAe,EACf,OAAc,EACd,MAAc,EACd,YAAmB,GACpB,EAAE,gBAAgB,2CAiBlB"}

package/dist/shared/feature-flags/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @burdenoff/fe-libs/shared/feature-flags
+ *
+ * Enhanced feature flag module for Burdenoff products.
+ *
+ * Provides a React context provider that evaluates feature flags against
+ * the global-tenant-svc backend, with workspace-aware re-fetching,
+ * polling, and default-allow semantics.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *   FeatureFlagProvider,
+ *   useFeatureFlags,
+ *   useFeatureFlag,
+ *   FeatureGate,
+ * } from '@burdenoff/fe-libs/shared/feature-flags';
+ *
+ * // In shell
+ * <FeatureFlagProvider workspaceId={workspaceId}>
+ *   <App />
+ * </FeatureFlagProvider>
+ *
+ * // In components
+ * const isEnabled = useFeatureFlag('new-dashboard');
+ * // or
+ * <FeatureGate flag="new-dashboard" fallback={<LegacyDashboard />}>
+ *   <NewDashboard />
+ * </FeatureGate>
+ * ```
+ */
+export { FeatureFlagProvider, useFeatureFlags } from './FeatureFlagProvider';
+export type { FeatureFlagProviderProps } from './FeatureFlagProvider';
+export { useFeatureFlag, useFeatureFlagValue, useFeatureFlagDetails } from './useFeatureFlag';
+export { FeatureGate } from './FeatureGate';
+export type { FeatureGateProps } from './FeatureGate';
+export type { FlagValue, FlagType, FlagStatus, FlagEvaluation, BulkEvaluationResponse, FeatureFlagProviderConfig, FeatureFlagContextValue, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/feature-flags/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/feature-flags/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7E,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,YAAY,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,cAAc,EACd,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,SAAS,CAAC"}

package/dist/shared/feature-flags/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Feature Flags — Type Definitions
+ *
+ * Types for the enhanced feature flag provider that communicates with
+ * the global-tenant-svc `evaluateFeatureFlags` GraphQL endpoint.
+ *
+ * Compatible with OpenFeature ResolutionDetails.
+ */
+/** Supported feature flag value types */
+export type FlagValue = boolean | string | number | Record<string, unknown>;
+/** Feature flag type enumeration (mirrors backend FeatureFlagType) */
+export type FlagType = 'BOOLEAN' | 'STRING' | 'NUMBER' | 'JSON';
+/** Feature flag status (mirrors backend FeatureFlagStatus) */
+export type FlagStatus = 'ACTIVE' | 'ARCHIVED';
+/**
+ * Single flag evaluation result from the backend.
+ * Compatible with OpenFeature ResolutionDetails.
+ */
+export interface FlagEvaluation {
+    /** Flag key */
+    key: string;
+    /** Resolved value */
+    value: FlagValue;
+    /** Variant name (optional) */
+    variant?: string;
+    /** Resolution reason (e.g., "DEFAULT", "WORKSPACE_OVERRIDE", "USER_PREFERENCE") */
+    reason: string;
+    /** Flag type */
+    flagType: FlagType;
+    /** Error code if evaluation failed */
+    errorCode?: string;
+}
+/**
+ * Bulk evaluation response from backend.
+ */
+export interface BulkEvaluationResponse {
+    evaluateFeatureFlags: {
+        evaluations: FlagEvaluation[];
+    };
+}
+/**
+ * Configuration for the FeatureFlagProvider.
+ */
+export interface FeatureFlagProviderConfig {
+    /**
+     * Workspace ID for flag evaluation context.
+     * Flags are re-fetched when this changes.
+     */
+    workspaceId: string | null;
+    /**
+     * Gateway to use for fetching flags.
+     * @default 'global'
+     */
+    gateway?: 'workspace' | 'global';
+    /**
+     * Specific flag keys to evaluate.
+     * If omitted, evaluates ALL active flags.
+     */
+    flagKeys?: string[];
+    /**
+     * Polling interval in milliseconds for auto-refresh.
+     * Set to 0 to disable polling.
+     * @default 300000 (5 minutes)
+     */
+    refreshInterval?: number;
+    /**
+     * Stale time in milliseconds. Flags are considered fresh for this duration.
+     * @default 300000 (5 minutes)
+     */
+    staleTime?: number;
+    /**
+     * Enable debug logging.
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Default value returned by isEnabled() when a flag is not found.
+     * Follows the default-allow principle.
+     * @default true
+     */
+    defaultEnabled?: boolean;
+}
+/**
+ * Feature flag context value provided to consumers.
+ */
+export interface FeatureFlagContextValue {
+    /** Map of flag key -> evaluation result */
+    evaluations: Map<string, FlagEvaluation>;
+    /** Whether flags are currently being fetched */
+    isLoading: boolean;
+    /** Error from the last fetch attempt */
+    error: Error | null;
+    /**
+     * Check if a feature flag is enabled.
+     * Returns `defaultEnabled` (default: true) if the flag is not found
+     * (default-allow principle). Pass `defaultValue=false` per-call to opt
+     * into default-deny for not-yet-ready surfaces.
+     */
+    isEnabled: (flagKey: string, defaultValue?: boolean) => boolean;
+    /**
+     * Get the resolved value of a feature flag.
+     * Returns `defaultValue` if the flag is not found.
+     */
+    getValue: <T extends FlagValue = FlagValue>(flagKey: string, defaultValue: T) => T;
+    /**
+     * Get the full evaluation details for a flag.
+     * Returns undefined if the flag is not found.
+     */
+    getEvaluation: (flagKey: string) => FlagEvaluation | undefined;
+    /**
+     * Get a flat map of all flag keys to their boolean enabled states.
+     * Useful for bulk checks or debugging.
+     */
+    getAllFlags: () => Record<string, FlagValue>;
+    /**
+     * Manually trigger a re-fetch of all flags.
+     */
+    refreshFlags: () => Promise<void>;
+    /** Current workspace ID being evaluated against */
+    workspaceId: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/feature-flags/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/feature-flags/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,yCAAyC;AACzC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5E,sEAAsE;AACtE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhE,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAM/C;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,eAAe;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oBAAoB,EAAE;QACpB,WAAW,EAAE,cAAc,EAAE,CAAC;KAC/B,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAMD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2CAA2C;IAC3C,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEzC,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IAEnB,wCAAwC;IACxC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB;;;;;OAKG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IAEhE;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC;IAEnF;;;OAGG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IAE/D;;;OAGG;IACH,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAE7C;;OAEG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,mDAAmD;IACnD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B"}

package/dist/shared/feature-flags/useFeatureFlag.d.ts

@@ -0,0 +1,41 @@
+import { FlagValue, FlagEvaluation } from './types';
+/**
+ * Check if a single feature flag is enabled.
+ *
+ * @param flagKey - The feature flag key to check
+ * @param defaultValue - Default value if flag not found (default: true — default-allow)
+ * @returns Whether the flag is enabled
+ */
+export declare function useFeatureFlag(flagKey: string, defaultValue?: boolean): boolean;
+/**
+ * Get the resolved value of a single feature flag.
+ *
+ * @param flagKey - The feature flag key
+ * @param defaultValue - Default value if flag not found
+ * @returns The resolved flag value
+ *
+ * @example
+ * ```tsx
+ * const maxItems = useFeatureFlagValue('max-items-per-page', 20);
+ * const theme = useFeatureFlagValue('experiment-theme', 'default');
+ * ```
+ */
+export declare function useFeatureFlagValue<T extends FlagValue = FlagValue>(flagKey: string, defaultValue: T): T;
+/**
+ * Get full evaluation details for a single feature flag.
+ *
+ * Useful when you need the resolution reason, variant, or error code.
+ *
+ * @param flagKey - The feature flag key
+ * @returns The evaluation details, or undefined if not found
+ *
+ * @example
+ * ```tsx
+ * const evaluation = useFeatureFlagDetails('ab-test-checkout');
+ * if (evaluation?.variant === 'variant-b') {
+ *   return <CheckoutVariantB />;
+ * }
+ * ```
+ */
+export declare function useFeatureFlagDetails(flagKey: string): FlagEvaluation | undefined;
+//# sourceMappingURL=useFeatureFlag.d.ts.map

package/dist/shared/feature-flags/useFeatureFlag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFeatureFlag.d.ts","sourceRoot":"","sources":["../../../src/shared/feature-flags/useFeatureFlag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,OAAO,CAY5E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EACjE,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,CAAC,GACd,CAAC,CAOH;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAMjF"}

package/dist/shared/geography/GeographyProvider.d.ts

@@ -0,0 +1,40 @@
+import { ReactNode } from 'react';
+import { CountryData } from './countries';
+export interface GeographyContextValue {
+    /** Currently selected country */
+    country: CountryData | null;
+    /** ISO country code */
+    countryCode: string | null;
+    /** Active currency code */
+    currency: string;
+    /** Active timezone */
+    timezone: string;
+    /** Whether geography is loading */
+    loading: boolean;
+    /** Whether geography was auto-detected */
+    autoDetected: boolean;
+    /** Set country by ISO code */
+    setCountry: (code: string) => void;
+    /** Override currency (independent of country) */
+    setCurrency: (currency: string) => void;
+    /** Override timezone (independent of country) */
+    setTimezone: (timezone: string) => void;
+}
+export interface GeographyProviderProps {
+    children: ReactNode;
+    /** Profile ID for scoped storage (from auth) */
+    profileId?: string | null;
+    /** Default country code if detection fails */
+    defaultCountry?: string;
+    /** Whether to enable auto-detection via GPS/timezone */
+    enableAutoDetect?: boolean;
+    /** Callback when geography changes (for persisting to backend) */
+    onGeographyChange?: (geo: {
+        country: string;
+        currency: string;
+        timezone: string;
+    }) => void;
+}
+export declare function useGeography(): GeographyContextValue;
+export declare function GeographyProvider({ children, profileId, defaultCountry, enableAutoDetect, onGeographyChange, }: GeographyProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=GeographyProvider.d.ts.map

package/dist/shared/geography/GeographyProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeographyProvider.d.ts","sourceRoot":"","sources":["../../../src/shared/geography/GeographyProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,uBAAuB;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,YAAY,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,iDAAiD;IACjD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,iDAAiD;IACjD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC5F;AAQD,wBAAgB,YAAY,IAAI,qBAAqB,CAMpD;AAwHD,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,SAAS,EACT,cAAqB,EACrB,gBAAuB,EACvB,iBAAiB,GAClB,EAAE,sBAAsB,2CA0KxB"}

package/dist/shared/geography/countries.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Comprehensive country dataset based on ISO 3166-1 alpha-2.
+ *
+ * Sources:
+ *  - Country codes & names: ISO 3166-1
+ *  - Currencies: ISO 4217
+ *  - Timezones: IANA Time Zone Database
+ *  - Calling codes: ITU-T E.164
+ *  - Regions: UN M49 geoscheme (simplified to 5 macro regions)
+ */
+export interface CountryData {
+    /** ISO 3166-1 alpha-2 code */
+    code: string;
+    /** English name */
+    name: string;
+    /** Emoji flag */
+    flag: string;
+    /** Default ISO 4217 currency code */
+    currency: string;
+    /** Currency symbol */
+    currencySymbol: string;
+    /** Primary IANA timezone */
+    timezone: string;
+    /** International calling code */
+    callingCode: string;
+    /** Geographic region */
+    region: 'Africa' | 'Americas' | 'Asia' | 'Europe' | 'Oceania';
+}
+/**
+ * All ISO 3166-1 alpha-2 countries.
+ *
+ * The most significant countries are listed first (US, GB, IN, DE, FR, JP,
+ * CN, AU, CA, BR, ...) followed by every remaining country sorted
+ * alphabetically by its two-letter code.
+ */
+export declare const COUNTRIES: CountryData[];
+/** Map of country code to CountryData for O(1) lookup */
+export declare const COUNTRY_MAP: Record<string, CountryData>;
+/** Get country by ISO 3166-1 alpha-2 code */
+export declare function getCountryByCode(code: string): CountryData | undefined;
+/** Get all countries belonging to a geographic region */
+export declare function getCountriesByRegion(region: CountryData['region']): CountryData[];
+/** All available regions */
+export declare const REGIONS: CountryData['region'][];
+/**
+ * Map from common IANA timezones to ISO 3166-1 alpha-2 country codes.
+ *
+ * Useful for reverse geo-detection: detect the browser timezone via
+ * `Intl.DateTimeFormat().resolvedOptions().timeZone` then look up the likely
+ * country.
+ */
+export declare const TIMEZONE_TO_COUNTRY: Record<string, string>;
+//# sourceMappingURL=countries.d.ts.map

package/dist/shared/geography/countries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countries.d.ts","sourceRoot":"","sources":["../../../src/shared/geography/countries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC/D;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,WAAW,EAk8ElC,CAAC;AAMF,yDAAyD;AACzD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAM,CAAC;AAK3D,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEtE;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,WAAW,EAAE,CAEjF;AAED,4BAA4B;AAC5B,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAwD,CAAC;AAMpG;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoVtD,CAAC"}

package/dist/shared/geography/index.d.ts

@@ -0,0 +1,5 @@
+export { COUNTRIES, COUNTRY_MAP, REGIONS, TIMEZONE_TO_COUNTRY, getCountryByCode, getCountriesByRegion, } from './countries';
+export type { CountryData } from './countries';
+export { GeographyProvider, useGeography } from './GeographyProvider';
+export type { GeographyContextValue, GeographyProviderProps } from './GeographyProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/geography/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/geography/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,OAAO,EACP,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/shared/graphql/GatewayContext.d.ts

@@ -0,0 +1,55 @@
+import { ReactNode } from 'react';
+import { ApolloClient } from '@apollo/client/core';
+import { Gateway } from '../config';
+export interface GatewayContextValue {
+    /** Apollo client for the workspace gateway (port 4003) */
+    workspaceClient: ApolloClient;
+    /** Apollo client for the global gateway (port 4000) */
+    globalClient: ApolloClient;
+    /** Get client by gateway type */
+    getClient: (gateway: Gateway) => ApolloClient;
+}
+export interface GatewayProviderProps {
+    children: ReactNode;
+    value: GatewayContextValue;
+}
+/**
+ * GatewayProvider — wraps the React tree with gateway client access.
+ *
+ * This is called ONCE by the app shell's MultiGatewayProvider.
+ * Microfrontends should never render this directly.
+ */
+export declare function GatewayProvider({ children, value }: GatewayProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Access both gateway clients.
+ *
+ * @example
+ * ```ts
+ * const { workspaceClient, globalClient } = useGateway();
+ * ```
+ */
+export declare function useGateway(): GatewayContextValue;
+/**
+ * Get a specific gateway's Apollo client.
+ *
+ * @example
+ * ```ts
+ * const globalClient = useGatewayClient('global');
+ * const { data } = useQuery(MY_QUERY, { client: globalClient });
+ * ```
+ */
+export declare function useGatewayClient(gateway: Gateway): ApolloClient;
+/**
+ * Same as `useGateway` but returns `null` instead of throwing when no
+ * `GatewayProvider` is mounted. Used by cross-cutting components (tour
+ * triggers, shell chrome) that may render in trees where the provider is
+ * intentionally absent — tests, standalone previews, or embed hosts.
+ */
+export declare function useSafeGateway(): GatewayContextValue | null;
+/**
+ * Same as `useGatewayClient` but returns `null` instead of throwing when no
+ * `GatewayProvider` is mounted. Callers should short-circuit their data
+ * fetching when this returns null.
+ */
+export declare function useSafeGatewayClient(gateway: Gateway): ApolloClient | null;
+//# sourceMappingURL=GatewayContext.d.ts.map

package/dist/shared/graphql/GatewayContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayContext.d.ts","sourceRoot":"","sources":["../../../src/shared/graphql/GatewayContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,eAAe,EAAE,YAAY,CAAC;IAC9B,uDAAuD;IACvD,YAAY,EAAE,YAAY,CAAC;IAC3B,iCAAiC;IACjC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC;CAC/C;AAID,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,oBAAoB,2CAExE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,mBAAmB,CAQhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAG/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,mBAAmB,GAAG,IAAI,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAG1E"}