@burdenoff/fe-libs 2026.528.10 → 2026.528.11

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

@@ -0,0 +1,122 @@
+import { ApolloClient, InMemoryCache } from '@apollo/client/core';
+import { Gateway } from '../config';
+/**
+ * Check if the network circuit breaker is currently open (backend unreachable).
+ * Useful for showing "backend offline" banners in the UI.
+ */
+export declare function isNetworkCircuitOpen(): boolean;
+export type { Gateway } from '../config';
+export interface CreateClientOptions {
+    /** Gateway type: 'workspace' or 'global' */
+    gateway: Gateway;
+    /** Optional base URL override (defaults to gateway's defaultBaseUrl) */
+    baseUrl?: string;
+    /** Authorization token or token getter function */
+    authToken?: string | (() => string | null);
+    /** Workspace token or getter for X-Workspace-Authorization header (workspace gateway only) */
+    workspaceToken?: string | (() => string | null);
+    /** Locale code or getter function for Accept-Language header */
+    locale?: string | (() => string | null);
+    /** Geography getter for x-geo-* headers (country, currency, timezone) */
+    geography?: () => {
+        country?: string;
+        currency?: string;
+        timezone?: string;
+    } | null;
+    /** Organization ID or getter function for x-org-id header (global gateway) */
+    organizationId?: string | (() => string | null);
+    /** Product ID or getter function for x-product-id header (for product-level isolation) */
+    productId?: string | (() => string | null);
+    /** Workspace ID or getter function for x-workspace-id header (workspace context) */
+    workspaceId?: string | (() => string | null);
+    /** Tenant ID or getter function for x-tenant-id header (tenant context) */
+    tenantId?: string | (() => string | null);
+    /** Optional cache instance for sharing between clients */
+    cache?: InMemoryCache;
+    /** Enable SSE subscriptions */
+    enableSubscriptions?: boolean;
+    /** SSE endpoint URL override (defaults to gateway's sse path) */
+    sseUrl?: string;
+    /** Callback when authentication error occurs */
+    onAuthError?: () => void;
+    /**
+     * Callback to attempt token refresh when a 401/UNAUTHENTICATED error occurs.
+     * If provided, the ErrorLink will call this before invoking onAuthError,
+     * and will retry the failed operation with the new token on success.
+     * Should return `true` if refresh succeeded (token updated in storage),
+     * or `false` if refresh failed (triggers onAuthError).
+     */
+    onRefreshToken?: () => Promise<boolean>;
+    /** Callback when network error occurs */
+    onNetworkError?: (error: Error) => void;
+    /** Callback when network status changes (circuit breaker open/closed) */
+    onNetworkStatusChange?: (isOffline: boolean) => void;
+    /** Maximum retry attempts for failed requests (default: 3) */
+    maxRetryAttempts?: number;
+    /**
+     * Maximum number of operations to batch together (default: 10).
+     * Set to 1 to disable batching.
+     */
+    batchMax?: number;
+    /**
+     * Time window (ms) to collect operations before sending a batch.
+     * Defaults to a longer page-load burst window and a shorter steady-state window.
+     */
+    batchInterval?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Creates an Apollo Client configured for a Burdenoff gateway
+ *
+ * @example Basic usage
+ * ```ts
+ * // Workspace gateway client
+ * const workspaceClient = createGraphQLClient({
+ *   gateway: 'workspace',
+ *   authToken: 'your-jwt-token',
+ * });
+ *
+ * // Global gateway client
+ * const globalClient = createGraphQLClient({
+ *   gateway: 'global',
+ *   authToken: () => localStorage.getItem('token'),
+ * });
+ * ```
+ *
+ * @example With subscriptions
+ * ```ts
+ * const client = createGraphQLClient({
+ *   gateway: 'workspace',
+ *   authToken: token,
+ *   enableSubscriptions: true,
+ * });
+ * ```
+ */
+export declare function createGraphQLClient(options: CreateClientOptions): ApolloClient;
+export interface AppClientConfig {
+    workspaceBaseUrl?: string;
+    globalBaseUrl?: string;
+    authToken?: string | (() => string | null);
+    enableSubscriptions?: boolean;
+    onAuthError?: () => void;
+    debug?: boolean;
+}
+/**
+ * Initialize app-level Apollo clients
+ * Call this once during app initialization
+ */
+export declare function initializeAppClients(config: AppClientConfig): void;
+/**
+ * Get the workspace gateway Apollo client
+ */
+export declare function getWorkspaceClient(): ApolloClient;
+/**
+ * Get the global gateway Apollo client
+ */
+export declare function getGlobalClient(): ApolloClient;
+/**
+ * Reset all singleton clients (useful for logout or testing)
+ */
+export declare function resetAppClients(): void;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/shared/graphql/client.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,133 @@
+import { Gateway } from '../config';
+export interface GraphQLFetchOptions {
+    /** Gateway to target */
+    gateway: Gateway;
+    /** GraphQL query / mutation string */
+    query: string;
+    /** Variables for the operation */
+    variables?: Record<string, unknown>;
+    /** Operation name (optional, helps with debugging) */
+    operationName?: string;
+    /** Override auth token (if not provided, reads from profile storage) */
+    authToken?: string;
+    /**
+     * Include workspace token in X-Workspace-Authorization header.
+     * For `gateway: "workspace"`, this defaults to `true` (auto-attach) unless explicitly set to `false`.
+     * Pass `true` to auto-read from profile storage, or pass the token string directly.
+     */
+    workspaceToken?: boolean | string;
+    /**
+     * Include workspace ID in x-workspace-id header.
+     * Pass `true` to auto-read from profile context storage, or pass the workspace ID string directly.
+     * This is the "context workspace" - the user's current working context.
+     * For "target workspace" (e.g., viewing a specific workspace), use GraphQL arguments instead.
+     */
+    workspaceId?: boolean | string;
+    /**
+     * Include organization ID in x-org-id header.
+     * Pass `true` to auto-read from profile context storage, or pass the org ID string directly.
+     */
+    organizationId?: boolean | string;
+    /**
+     * Include tenant ID in x-tenant-id header.
+     * Pass `true` to auto-read from profile context storage, or pass the tenant ID string directly.
+     */
+    tenantId?: boolean | string;
+    /** Override locale (if not provided, reads from profile storage) */
+    locale?: string;
+    /** Override base URL (if not provided, reads from GATEWAYS config) */
+    baseUrl?: string;
+    /** Additional headers to merge (overrides auto-detected values) */
+    extraHeaders?: Record<string, string>;
+    /** AbortSignal for cancellation */
+    signal?: AbortSignal;
+}
+export interface GraphQLResponse<T = unknown> {
+    data: T | null;
+    errors?: Array<{
+        message: string;
+        locations?: Array<{
+            line: number;
+            column: number;
+        }>;
+        path?: Array<string | number>;
+        extensions?: Record<string, unknown>;
+    }>;
+}
+/** Read the active profile's access token from profile-scoped storage */
+export declare function getStoredAuthToken(): string | null;
+/** Read the active profile's workspace token from profile-scoped storage */
+export declare function getStoredWorkspaceToken(): string | null;
+/** Read the active profile's geography from profile-scoped storage */
+export declare function getStoredGeography(): {
+    country?: string;
+    currency?: string;
+    timezone?: string;
+} | null;
+/** Read the active profile's locale from profile-scoped storage */
+export declare function getStoredLocale(): string;
+/** Read the active profile's context (workspaceId, organizationId, tenantId, projectId) from profile-scoped storage */
+export declare function getStoredContext(): {
+    workspaceId?: string;
+    organizationId?: string;
+    tenantId?: string;
+    projectId?: string;
+} | null;
+/** Read the active profile's workspace ID.
+ * Reads from profile-scoped context (bf-p-{profileId}-context) which
+ * ActiveContextProvider now writes to on every setWorkspace() call and on init.
+ * Falls back to the ?workspace= URL param for page loads where the context
+ * hasn't been hydrated yet (mirrors MultiGatewayProvider.getWorkspaceId). */
+export declare function getStoredWorkspaceId(): string | null;
+/** Read the active profile's organization ID from profile context storage */
+export declare function getStoredOrganizationId(): string | null;
+/** Read the active profile's tenant ID from profile context storage */
+export declare function getStoredTenantId(): string | null;
+/** Resolve full gateway GraphQL URL */
+export declare function resolveGatewayUrl(gateway: Gateway, baseUrl?: string): string;
+export interface EnqueueGraphQLFetchOptions {
+    batchMax?: number;
+    batchInterval?: number;
+}
+export declare function enqueueGraphQLFetch(url: string, headers: Record<string, string>, body: Record<string, unknown>, signal?: AbortSignal, options?: EnqueueGraphQLFetchOptions): Promise<unknown>;
+/**
+ * Make a GraphQL request with automatic auth + locale headers.
+ *
+ * @example Basic query (global gateway)
+ * ```ts
+ * const result = await graphqlFetch<{ myWorkspaces: Workspace[] }>({
+ *   gateway: 'global',
+ *   query: `query { myWorkspaces { id name } }`,
+ * });
+ * ```
+ *
+ * @example Workspace query with context headers (auto-read from storage)
+ * ```ts
+ * const result = await graphqlFetch<{ workspaceResources: Resource[] }>({
+ *   gateway: 'workspace',
+ *   query: WORKSPACE_RESOURCES_QUERY,
+ *   workspaceId: true, // auto-reads from profile context storage -> x-workspace-id header
+ * });
+ * ```
+ *
+ * @example Workspace query with explicit workspace ID
+ * ```ts
+ * const result = await graphqlFetch<{ workspaceMembers: MemberList }>({
+ *   gateway: 'workspace',
+ *   query: WORKSPACE_MEMBERS_QUERY,
+ *   variables: { workspaceId: targetWorkspaceId }, // Target workspace in arguments
+ *   workspaceId: contextWorkspaceId, // Context workspace in header (for RBAC)
+ * });
+ * ```
+ *
+ * @example With explicit tokens (e.g. right after login, before storage is updated)
+ * ```ts
+ * const result = await graphqlFetch({
+ *   gateway: 'global',
+ *   query: MY_WORKSPACES_QUERY,
+ *   authToken: freshAccessToken,
+ * });
+ * ```
+ */
+export declare function graphqlFetch<T = unknown>(options: GraphQLFetchOptions): Promise<GraphQLResponse<T>>;
+//# sourceMappingURL=fetch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/shared/graphql/fetch.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+export { createGraphQLClient, initializeAppClients, getWorkspaceClient, getGlobalClient, resetAppClients, type CreateClientOptions, type AppClientConfig, type Gateway, } from './client';
+export { GatewayProvider, useGateway, useGatewayClient, useSafeGateway, useSafeGatewayClient, type GatewayContextValue, type GatewayProviderProps, } from './GatewayContext';
+export { graphqlFetch, getStoredAuthToken, getStoredWorkspaceToken, getStoredWorkspaceId, getStoredLocale, getStoredOrganizationId, resolveGatewayUrl, type GraphQLFetchOptions, type GraphQLResponse, } from './fetch';
+export { getWorkspaceTokenPayload, isWorkspaceTokenValidForContext, type WorkspaceTokenContext, type WorkspaceTokenPayload, } from './workspaceToken';
+export { SSELink, type SSELinkOptions } from './links/sse-link';
+export { ApolloClient, InMemoryCache, type NormalizedCacheObject } from '@apollo/client/core';
+export { ApolloProvider, useQuery, useMutation, useLazyQuery, useSubscription, useApolloClient, } from '@apollo/client/react';
+export { gql } from '@apollo/client/core';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/graphql/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,OAAO,GACb,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIhE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE9F,OAAO,EACL,cAAc,EACd,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/shared/graphql/links/sse-link.d.ts

@@ -0,0 +1,48 @@
+import { ApolloLink, Observable, FetchResult, Operation } from '@apollo/client/core';
+export interface SSELinkOptions {
+    /** SSE endpoint URL */
+    url: string;
+    /** Optional headers to include with requests */
+    headers?: Record<string, string>;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * SSE Link for GraphQL Yoga subscriptions
+ *
+ * GraphQL Yoga uses Server-Sent Events (SSE) for subscriptions over HTTP.
+ * This is more compatible with serverless and edge deployments than WebSockets.
+ *
+ * SSE Format:
+ * - event: next\ndata: {...}\n\n - Subscription data
+ * - event: complete\n\n - Subscription ended
+ * - event: error\ndata: {...}\n\n - Error occurred
+ *
+ * @example
+ * ```ts
+ * import { SSELink } from '@burdenoff/fe-libs/shared/graphql/links/sse-link';
+ *
+ * const sseLink = new SSELink({
+ *   url: 'https://gw-wspace.local.burdenoff.com/workspaces/graphql/stream',
+ *   headers: {
+ *     authorization: `Bearer ${token}`,
+ *   },
+ * });
+ * ```
+ */
+export declare class SSELink extends ApolloLink {
+    private url;
+    private headers;
+    private debug;
+    constructor(options: SSELinkOptions);
+    /**
+     * Update headers (useful for token refresh)
+     */
+    setHeaders(headers: Record<string, string>): void;
+    /**
+     * Update the authorization header
+     */
+    setAuthToken(token: string | null): void;
+    request(operation: Operation): Observable<FetchResult>;
+}
+//# sourceMappingURL=sse-link.d.ts.map

package/dist/shared/graphql/links/sse-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-link.d.ts","sourceRoot":"","sources":["../../../../src/shared/graphql/links/sse-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGlE,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,OAAQ,SAAQ,UAAU;IACrC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,KAAK,CAAU;gBAEX,OAAO,EAAE,cAAc;IAOnC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIjD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAQxC,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC;CAqJvD"}

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

@@ -0,0 +1,13 @@
+type Geography = {
+    country?: string;
+    currency?: string;
+    timezone?: string;
+};
+export declare function getValidAccessTokenFromStorage(tokensRaw: string | null): string | null;
+export declare function sanitizeGeography(input: Geography | null): Geography | null;
+export declare function isSafeRedirectTarget(target: string, baseOrigin?: string): boolean;
+export declare function redirectToSafeLocation(target: string, fallback?: string, baseOrigin?: string): boolean;
+export declare function validateGatewayBaseUrl(value: string): string;
+export declare function sanitizeExtraHeaders(headers?: Record<string, string>): Record<string, string> | undefined;
+export {};
+//# sourceMappingURL=security.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../src/shared/graphql/security.ts"],"names":[],"mappings":"AAkBA,KAAK,SAAS,GAAG;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAiBF,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAoBtF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CA6B3E;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,MAA+B,GAC1C,OAAO,CAeT;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAY,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAST;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkB5D;AAED,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAMpC"}

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

@@ -0,0 +1,13 @@
+export interface WorkspaceTokenContext {
+    workspaceId?: string | null;
+    organizationId?: string | null;
+    tenantId?: string | null;
+    projectId?: string | null;
+}
+export interface WorkspaceTokenPayload extends WorkspaceTokenContext {
+    exp?: number;
+    tokenType?: string;
+}
+export declare function getWorkspaceTokenPayload(token: string): WorkspaceTokenPayload | null;
+export declare function isWorkspaceTokenValidForContext(token: string | null | undefined, expected: WorkspaceTokenContext, expiryBufferMs?: number): token is string;
+//# sourceMappingURL=workspaceToken.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceToken.d.ts","sourceRoot":"","sources":["../../../src/shared/graphql/workspaceToken.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAyBD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAcpF;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,QAAQ,EAAE,qBAAqB,EAC/B,cAAc,SAAS,GACtB,KAAK,IAAI,MAAM,CA+BjB"}

package/dist/shared/help/HelpButton.d.ts

@@ -0,0 +1,25 @@
+import { FC } from 'react';
+export interface HelpButtonProps {
+    /** Additional CSS classes */
+    className?: string;
+    /** Button variant */
+    variant?: 'default' | 'ghost' | 'icon';
+    /** Show label text */
+    showLabel?: boolean;
+    /** Label text */
+    label?: string;
+}
+/**
+ * HelpButton component
+ *
+ * @example
+ * ```tsx
+ * // Icon only
+ * <HelpButton variant="icon" />
+ *
+ * // With label
+ * <HelpButton showLabel label="Help & Support" />
+ * ```
+ */
+export declare const HelpButton: FC<HelpButtonProps>;
+//# sourceMappingURL=HelpButton.d.ts.map

package/dist/shared/help/HelpButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpButton.d.ts","sourceRoot":"","sources":["../../../src/shared/help/HelpButton.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAGhC,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IACvC,sBAAsB;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC,eAAe,CAoC1C,CAAC"}

package/dist/shared/help/HelpPanel.d.ts

@@ -0,0 +1,10 @@
+import { FC } from 'react';
+export interface HelpPanelProps {
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * HelpPanel component
+ */
+export declare const HelpPanel: FC<HelpPanelProps>;
+//# sourceMappingURL=HelpPanel.d.ts.map

package/dist/shared/help/HelpPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpPanel.d.ts","sourceRoot":"","sources":["../../../src/shared/help/HelpPanel.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAKhC,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgID;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,EAAE,CAAC,cAAc,CA0QxC,CAAC"}

package/dist/shared/help/HelpProvider.d.ts

@@ -0,0 +1,40 @@
+import { ReactNode } from 'react';
+import { HelpContext, HelpContent, HelpTour, SupportTicket } from './types';
+declare const HelpContext: import('react').Context<HelpContext | null>;
+export interface HelpProviderProps {
+    children: ReactNode;
+    /** Callback when support ticket is submitted */
+    onSubmitTicket?: (ticket: SupportTicket) => Promise<void>;
+    /** Default articles to include */
+    defaultArticles?: HelpContent['articles'];
+    /** Default tours to include */
+    defaultTours?: HelpContent['tours'];
+}
+/**
+ * HelpProvider component
+ *
+ * @example
+ * ```tsx
+ * <HelpProvider onSubmitTicket={async (ticket) => { ... }}>
+ *   <App />
+ * </HelpProvider>
+ * ```
+ */
+export declare function HelpProvider({ children, onSubmitTicket, defaultArticles, defaultTours, }: HelpProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access help context
+ */
+export declare function useHelp(): HelpContext;
+/**
+ * Hook to get all articles (with optional filtering)
+ */
+export declare function useHelpArticles(options?: {
+    category?: string;
+    search?: string;
+}): import('./types').HelpArticle[];
+/**
+ * Hook to get all tours (with optional context filtering)
+ */
+export declare function useHelpTours(contextId?: string): HelpTour[];
+export {};
+//# sourceMappingURL=HelpProvider.d.ts.map

package/dist/shared/help/HelpProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpProvider.d.ts","sourceRoot":"","sources":["../../../src/shared/help/HelpProvider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAsD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3F,OAAO,KAAK,EACV,WAAW,EAGX,WAAW,EACX,QAAQ,EACR,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,QAAA,MAAM,WAAW,6CAA0C,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,SAAS,CAAC;IACpB,gDAAgD;IAChD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,kCAAkC;IAClC,eAAe,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAC1C,+BAA+B;IAC/B,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,cAAc,EACd,eAAoB,EACpB,YAAiB,GAClB,EAAE,iBAAiB,2CA4LnB;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,WAAW,CAMrC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,mCA+B/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,cAgB9C"}

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

@@ -0,0 +1,53 @@
+/**
+ * Help Framework
+ *
+ * Contextual help system for microfrontend applications.
+ *
+ * Features:
+ * - Help panel with docs, tours, and support tabs
+ * - Guided tours system
+ * - Context-aware content (microfrontends can register their help content)
+ * - Search functionality
+ * - Support ticket creation
+ *
+ * @example
+ * ```tsx
+ * // In your app's root
+ * import { HelpProvider, HelpPanel, HelpButton } from '@burdenoff/fe-libs/shared/help';
+ *
+ * function App() {
+ *   return (
+ *     <HelpProvider onSubmitTicket={handleTicket}>
+ *       <Header>
+ *         <HelpButton />
+ *       </Header>
+ *       <Routes>...</Routes>
+ *       <HelpPanel />
+ *     </HelpProvider>
+ *   );
+ * }
+ *
+ * // In a microfrontend
+ * import { useHelp } from '@burdenoff/fe-libs/shared/help';
+ *
+ * function MyMicrofrontend() {
+ *   const { registerHelpContent } = useHelp();
+ *
+ *   useEffect(() => {
+ *     registerHelpContent({
+ *       contextId: 'my-mfe',
+ *       articles: [...],
+ *       tours: [...],
+ *     });
+ *   }, []);
+ * }
+ * ```
+ */
+export { HelpProvider, useHelp, useHelpArticles, useHelpTours } from './HelpProvider';
+export { HelpButton } from './HelpButton';
+export { HelpPanel } from './HelpPanel';
+export type { HelpArticle, HelpTour, TourStep, SupportTicket, HelpContent, HelpTab, HelpContext, HelpContextState, HelpContextActions, } from './types';
+export type { HelpProviderProps } from './HelpProvider';
+export type { HelpButtonProps } from './HelpButton';
+export type { HelpPanelProps } from './HelpPanel';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/help/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,YAAY,EACV,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,WAAW,EACX,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}