@bcrumbs.net/inbox 0.0.64 → 0.0.65

package/src/app/inbox/utils/convSuggestionsStorage.d.ts

@@ -0,0 +1,20 @@
+import type { ClientSuggestionsPayload, ConvSuggestionsPayload } from '../../../graphql.autogenerated';
+/** Conversations kept per workspace; the least recently used are dropped first. */
+export declare const MAX_CACHED_CONVERSATIONS = 100;
+/** Cached suggestions older than this are fetched again even if no new messages arrived. */
+export declare const SUGGESTIONS_CACHE_TTL_MS: number;
+export type CachedSuggestions = {
+    /** Message bucket the suggestions were fetched for (see getSuggestionsBucket). */
+    bucket: number;
+    savedAt: number;
+    conversation: ConvSuggestionsPayload | null;
+    client: ClientSuggestionsPayload | null;
+    /** Suggestion keys the agent dismissed or applied in this conversation. */
+    hidden: string[];
+};
+/** The cached entry for a conversation (any bucket), used to restore dismissed suggestions. */
+export declare function readCachedConversation(workspaceId: number, convId: string): CachedSuggestions | undefined;
+/** Cached suggestions for this exact message bucket, if still fresh. */
+export declare function readCachedSuggestions(workspaceId: number, convId: string, bucket: number, now?: number): CachedSuggestions | undefined;
+export declare function saveSuggestions(workspaceId: number, convId: string, result: Pick<CachedSuggestions, 'bucket' | 'conversation' | 'client'>, now?: number): void;
+export declare function saveHidden(workspaceId: number, convId: string, hidden: string[], now?: number): void;

package/src/app/inbox/utils/sounds.d.ts

@@ -2,3 +2,5 @@ export declare function setInboxAudioBaseUrl(baseUrl?: string | null): void;
 export declare function getInboxAudioBaseUrl(): string;
 export declare function playRecMessageSound(): void;
 export declare function playSendMessageSound(): void;
+export declare function playIncomingCallSound(): void;
+export declare function stopIncomingCallSound(): void;

package/src/app/layout/hooks/useCallsEnabled.d.ts

@@ -0,0 +1 @@
+export declare const useCallsEnabled: () => boolean;

package/src/app/layout/hooks/useGatewayPlanEnabled.d.ts

@@ -0,0 +1,5 @@
+/**
+ * PostHog `gateway_plan_enabled` — exposes prepaid Gateway plan in signup/upgrade flows.
+ * Uses the reactive hook so components re-render once PostHog finishes loading flags.
+ */
+export declare function useGatewayPlanEnabled(): boolean;

package/src/app/layout/hooks/useWebchatEnabled.d.ts

@@ -0,0 +1,5 @@
+/**
+ * PostHog `webchat` — lets users create website live chat (BCWEBCHAT) channels.
+ * Uses the reactive hook so components re-render once PostHog finishes loading flags.
+ */
+export declare function useWebchatEnabled(): boolean;

package/src/app/managemnet/components/channels/ChannelItem.d.ts

@@ -5,7 +5,8 @@ interface ChannelItemProps {
     identifier?: string;
     onDelete: (id: string) => void;
     onEdit: (id: string) => void;
+    onAssign: (id: string) => void;
     rtl?: boolean;
 }
-declare const ChannelItem: ({ id, name, date, identifier, onDelete, onEdit, rtl }: ChannelItemProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const ChannelItem: ({ id, name, date, identifier, onDelete, onEdit, onAssign, rtl }: ChannelItemProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default ChannelItem;

package/src/app/managemnet/components/channels/ChannelSettingsDrawer.d.ts

@@ -0,0 +1,15 @@
+/** Tabs of the channel settings drawer. `assign` holds the conversation routing settings. */
+export type ChannelSettingsTab = 'general' | 'assign';
+type ChannelSettingsDrawerProps = {
+    isOpen: boolean;
+    onClose: () => void;
+    onSuccess: () => void;
+    channelId: string;
+    channelType: string;
+    channelTypeName: string;
+    /** Tab the drawer opens on: `general` for the Edit action, `assign` for the Assign action. */
+    initialTab?: ChannelSettingsTab;
+    rtl?: boolean;
+};
+declare const ChannelSettingsDrawer: ({ isOpen, onClose, onSuccess, channelId, channelType, channelTypeName, initialTab, rtl, }: ChannelSettingsDrawerProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export default ChannelSettingsDrawer;

package/src/app/managemnet/components/channels/ShareChannelLinkDialog.d.ts

@@ -0,0 +1,11 @@
+interface ShareChannelLinkDialogProps {
+    isOpen: boolean;
+    url: string | null;
+    loading: boolean;
+    channelTypeName: string;
+    onBack: () => void;
+    onClose: () => void;
+    rtl?: boolean;
+}
+declare const ShareChannelLinkDialog: ({ isOpen, url, loading, channelTypeName, onBack, onClose, rtl, }: ShareChannelLinkDialogProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export default ShareChannelLinkDialog;

package/src/app/managemnet/components/channels/WebChatSnippetBlock.d.ts

@@ -0,0 +1,7 @@
+type WebChatSnippetBlockProps = {
+    /** Script tag from buildWebChatSnippet. */
+    snippet: string;
+};
+/** Embed snippet for a new web chat channel, with a copy button. */
+declare const WebChatSnippetBlock: ({ snippet }: WebChatSnippetBlockProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export default WebChatSnippetBlock;

package/src/app/managemnet/config/webchat.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Script-tag web chat bundle (packages/websdk → script/bc-sdk.js), used in the embed snippet shown
+ * after creating a web chat channel. Not hosted yet: point this at the final host.
+ */
+export declare const WEBCHAT_SDK_URL = "https://gateway.bcrumbs.net/channels/bc-sdk.js";

package/src/app/managemnet/pages/connectChannel/ConnectChannel.d.ts

@@ -0,0 +1,2 @@
+declare const ConnectChannel: () => import("@emotion/react/jsx-runtime").JSX.Element;
+export default ConnectChannel;

package/src/app/managemnet/pages/generalSettings/NoiseFilterSettings.d.ts

@@ -0,0 +1,8 @@
+import { type NoiseFilterFormState } from './noiseFilterConstants';
+export type NoiseFilterSettingsProps = {
+    loading: boolean;
+    value: NoiseFilterFormState;
+    onChange: (next: NoiseFilterFormState) => void;
+};
+declare const NoiseFilterSettings: ({ loading, value, onChange }: NoiseFilterSettingsProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export default NoiseFilterSettings;

package/src/app/managemnet/pages/generalSettings/noiseFilterConstants.d.ts

@@ -0,0 +1,24 @@
+export declare const DEFAULT_RULES_THRESHOLD = 0.9;
+export declare const DEFAULT_SPAM_HIGH_THRESHOLD = 0.85;
+export declare const DEFAULT_BORDERLINE_BAND = 0.1;
+export declare const DEFAULT_HIGH_INTENT_THRESHOLD = 0.7;
+export declare const DEFAULT_MAX_LINKS_PER_MESSAGE = 3;
+export declare const DEFAULT_DENY_PATTERNS: readonly [string, string, string];
+/** Same text the bot uses when triagePrompt is empty. */
+export declare const DEFAULT_NOISE_FILTER_TRIAGE_PROMPT: string;
+export type NoiseFilterFormState = {
+    enabled: boolean;
+    rulesThreshold: number;
+    spamHighThreshold: number;
+    borderlineBand: number;
+    highIntentThreshold: number;
+    triagePrompt: string;
+    denyPatternsText: string;
+    maxLinksPerMessage: number;
+};
+export declare const DEFAULT_NOISE_FILTER_FORM: NoiseFilterFormState;
+export declare function parseDenyPatternsText(value: string): string[];
+export declare function formatDenyPatterns(patterns: string[] | null | undefined): string;
+export declare function clampUnitInterval(value: number, fallback: number): number;
+export declare function clampPositiveInt(value: number, fallback: number): number;
+export declare function noiseFilterFormsEqual(a: NoiseFilterFormState, b: NoiseFilterFormState): boolean;

package/src/app/managemnet/utils/webChatSnippet.d.ts

@@ -0,0 +1,2 @@
+/** Script tag that embeds the web chat widget for one workspace and BCWEBCHAT integration. */
+export declare const buildWebChatSnippet: (workspaceId: number, integrationId: string, sdkUrl?: string) => string;

package/src/app/onboarding/components/OnboardingView.d.ts

@@ -4,6 +4,8 @@ export type OnboardingViewProps = {
     checklistState: OnboardingChecklistState | null;
     completedCount: number;
     celebrateStepId: OnboardingChecklistStepId | null;
+    /** Steps whose completion is still in flight; shown as a spinner instead of a checkbox. */
+    pendingStepIds: Set<OnboardingChecklistStepId>;
     /** Show the "Ask crumby…" input (hidden when Crumby chat is unavailable). */
     showInput: boolean;
     rtl: boolean;
@@ -16,4 +18,4 @@ export type OnboardingViewProps = {
     onFinish: () => void;
 };
 /** Onboarding mode of the unified widget: welcome header, setup checklist, AI input. */
-export declare function OnboardingView({ applicableStepIds, checklistState, completedCount, celebrateStepId, showInput, rtl, toggleStep, onOpenStep, onClose, onSendToChat, onFinish, }: OnboardingViewProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function OnboardingView({ applicableStepIds, checklistState, completedCount, celebrateStepId, pendingStepIds, showInput, rtl, toggleStep, onOpenStep, onClose, onSendToChat, onFinish, }: OnboardingViewProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/src/app/onboarding/components/useOnboardingChecklist.d.ts

@@ -2,29 +2,32 @@ import { type OnboardingChecklistState, type OnboardingChecklistStepId } from '.
 export type UseOnboardingChecklist = {
     /** Steps relevant for the current plan (drops Crumby steps when AI is disabled). */
     applicableStepIds: OnboardingChecklistStepId[];
-    /** Parsed checklist, or null when there is no active checklist for this user. */
+    /** Parsed checklist, or null when the workspace has no active checklist. */
     checklistState: OnboardingChecklistState | null;
     /** Number of applicable steps the user has completed. */
     completedCount: number;
-    /** True while there is a non-expired checklist with at least one applicable step still open. */
+    /** True while there is a checklist with at least one applicable step still open. */
     isActive: boolean;
     /** Step currently playing the completion sweep, or null. */
     celebrateStepId: OnboardingChecklistStepId | null;
-    /** One-shot request to auto-open the widget on onboarding (set right after sign-in). */
+    /** Steps whose completion is still in flight, so the row can show progress. */
+    pendingStepIds: Set<OnboardingChecklistStepId>;
+    /** One-shot request to auto-open the widget on onboarding. */
     shouldAutoOpen: boolean;
     /** Toggle a step's completed flag (manual checkbox). */
     toggleStep: (stepId: OnboardingChecklistStepId) => void;
     /** Clears the one-shot auto-open request once the widget has acted on it. */
     consumeAutoOpen: () => void;
-    /** Run when the widget panel closes: clears the completed checklist from storage. */
+    /** Run when the widget panel closes: dismisses a finished checklist. */
     onPanelClosed: () => void;
-    /** Finish onboarding now (Get started button): clears the checklist for this workspace. */
+    /** Finish onboarding now (Get started button). */
     dismissChecklist: () => void;
 };
 /**
- * Owns the onboarding-checklist state previously held inside OnboardingChecklistWidget:
- * load/parse/TTL, applicable steps for the current plan, completion celebration, the
- * cross-tab updated event, and the post-sign-in auto-open signal. The presentation is
- * delegated to the unified Crumby widget.
+ * Owns the onboarding-checklist state for the Crumby widget.
+ *
+ * Reads from the auth service rather than cookies. The service decides whether a workspace
+ * has an active checklist, so the create-if-pending dance is gone — with it the bug where a
+ * brand-new workspace got no checklist because an existing one consumed the pending flag.
  */
 export declare function useOnboardingChecklist(): UseOnboardingChecklist;

package/src/app/onboarding/constants/workspaceProfileOptions.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Fallback values for the workspace profile fields.
+ *
+ * The auth service owns the accepted values and WorkspaceProfile reads them from the
+ * onboardingOptions query. These only cover the moment before that query resolves, so the
+ * dropdowns are never empty on first paint. They mirror `src/app/constants/onboarding.ts`
+ * in the auth service; if they drift, the service rejects the value rather than storing it.
+ */
+/** Fixed by the ticket. Labels carry the typographic form; values stay ASCII. */
+export declare const COMPANY_SIZE_OPTIONS: {
+    value: string;
+    labelKey: string;
+}[];
+export declare const INDUSTRY_OPTIONS: string[];
+export declare const CREATOR_ROLE_OPTIONS: string[];
+export declare const USE_CASE_OPTIONS: string[];
+export type WorkspaceProfileValues = {
+    industry: string;
+    companySize: string;
+    creatorRole: string;
+    useCase: string;
+};
+export declare const EMPTY_WORKSPACE_PROFILE: WorkspaceProfileValues;
+export type WorkspaceProfileOptions = {
+    industries: string[];
+    companySizes: string[];
+    creatorRoles: string[];
+    useCases: string[];
+};
+export declare const DEFAULT_WORKSPACE_PROFILE_OPTIONS: WorkspaceProfileOptions;

package/src/app/onboarding/utils/onboardingApi.d.ts

@@ -0,0 +1,23 @@
+import { type OnboardingStepId, type WorkspaceOnboardingFragment } from '../../../graphql.autogenerated';
+/**
+ * Server-backed onboarding checklist, replacing the cookie store.
+ *
+ * Imperative rather than hook-based on purpose: the step call sites are effects inside
+ * unrelated features (inbox polling, playground messages, dialogs), so they cannot mount a
+ * mutation hook. The widget is the only consumer that renders from this state, and it holds
+ * it in `useOnboardingChecklist`.
+ */
+export type OnboardingRecord = WorkspaceOnboardingFragment;
+/** Fired after any change so an open widget refreshes. */
+export declare const ONBOARDING_CHECKLIST_UPDATED_EVENT = "showcase-onboarding-checklist-updated";
+export declare function getCachedOnboarding(workspaceId: number): OnboardingRecord | null | undefined;
+export declare function primeOnboardingCache(workspaceId: number, record: OnboardingRecord | null): void;
+export declare function clearOnboardingCache(): void;
+export declare function fetchOnboarding(workspaceId: number): Promise<OnboardingRecord | null>;
+/**
+ * Idempotent server-side, so this fires without checking first. Failures are swallowed:
+ * losing a checklist tick must never surface as an error over the action the user actually
+ * performed.
+ */
+export declare function completeStep(workspaceId: number, stepId: OnboardingStepId): Promise<OnboardingRecord | null>;
+export declare function dismissOnboarding(workspaceId: number): Promise<OnboardingRecord | null>;

package/src/app/onboarding/utils/onboardingChecklistStorage.d.ts

@@ -1,65 +1,58 @@
-export declare const ONBOARDING_CHECKLIST_STORAGE_PREFIX = "showcase_onboarding_checklist";
+import { OnboardingStepId } from '../../../graphql.autogenerated';
+import { type OnboardingRecord } from './onboardingApi';
+/**
+ * Checklist step ids and the call-site helpers.
+ *
+ * State now lives on the auth service (see ./onboardingApi). What used to be a cookie
+ * read is a cached lookup, and what used to be a cookie write is a mutation. The exported
+ * shapes are unchanged so the call sites that mark a step done did not have to move.
+ *
+ * Gone with the server move: the TTL, the per-user "pending" flag and the dismissed marker.
+ * The service decides whether a workspace has an active checklist, which also removes the
+ * bug where the pending flag was consumed by whichever workspace happened to load first.
+ */
 export declare const ONBOARDING_CHECKLIST_UPDATED_EVENT = "showcase-onboarding-checklist-updated";
-export declare const ONBOARDING_CHECKLIST_TTL_MS: number;
-export type OnboardingChecklistStepId = 'workspace' | 'invite' | 'channel' | 'firstMessage' | 'uploadFile' | 'testAi';
-export type OnboardingChecklistState = {
-    startedAt: string;
-    completed: Record<OnboardingChecklistStepId, boolean>;
-};
+/** Aliased to the schema enum so a step added server-side cannot silently drift. */
+export type OnboardingChecklistStepId = OnboardingStepId;
+/** Display order, which the schema does not carry. */
 export declare const ONBOARDING_CHECKLIST_STEP_IDS: OnboardingChecklistStepId[];
 /** Last checklist steps; only shown when Crumby / workspace AI is enabled */
 export declare const ONBOARDING_CHECKLIST_CRUMBY_STEP_IDS: OnboardingChecklistStepId[];
 export declare function getApplicableOnboardingChecklistStepIds(isCrumbyEnabled: boolean): OnboardingChecklistStepId[];
-export declare function isOnboardingChecklistCompleteForCrumbySetting(state: OnboardingChecklistState, isCrumbyEnabled: boolean): boolean;
-export declare function getOnboardingChecklistStorageKey(userId: string | number, workspaceId?: string | number | null): string;
-/** Pre-workspace-scoping key: showcase_onboarding_checklist_{userId} */
-export declare function getLegacyOnboardingChecklistStorageKey(userId: string | number): string;
-/**
- * Load checklist for user + workspace from the durable (cookie) store. Migrates the older
- * localStorage keys (scoped, legacy user-only, empty-workspace) into the cookie store once.
- * Returns null when workspace context is not available.
- */
-export declare function loadOnboardingChecklistState(userId: string | number, workspaceId?: string | number | null): OnboardingChecklistState | null;
 /**
- * Pending key is keyed by user only (NOT workspace): it is a one-shot "user just signed in"
- * signal set at login, before the workspace context is available. The widget consumes it on
- * first load and creates the checklist scoped to whichever workspace the user landed in.
+ * Shape the widget renders. Kept as a map rather than the server's array so the existing
+ * components and their `completed[stepId]` lookups did not need rewriting.
  */
-export declare function getOnboardingChecklistPendingKey(userId: string | number): string;
-/**
- * Persisted "user finished / dismissed onboarding for this workspace" marker.
- * Unlike the checklist key (which is removed on finish), this survives so that a later
- * logout → login does not recreate a fresh checklist for a workspace already onboarded.
- */
-export declare function getOnboardingChecklistDismissedKey(userId: string | number, workspaceId?: string | number | null): string;
-export declare function isOnboardingChecklistDismissed(userId: string | number, workspaceId?: string | number | null): boolean;
-export declare function markOnboardingChecklistDismissed(userId: string | number, workspaceId?: string | number | null): void;
-/** One-shot: open checklist popover after sign-in (session tab only). */
-export declare const ONBOARDING_CHECKLIST_SESSION_AUTOPEN_KEY = "showcase_onboarding_checklist_session_autopen";
-export declare function clearOnboardingChecklistSessionAutopen(): void;
-export declare function shouldOpenOnboardingChecklistFromSession(): boolean;
-export declare function createDefaultOnboardingChecklistState(): OnboardingChecklistState;
-export declare function parseOnboardingChecklistState(value: unknown): OnboardingChecklistState | null;
-/**
- * Call after a successful sign-in. If the user has no active checklist yet, sets a short-lived
- * pending flag so the layout widget can create `startedAt` only on the first load after login
- * (not for sessions that never went through sign-in in this browser).
- */
-export declare function notifyOnboardingChecklistAfterSignIn(userId: string | number): void;
+export type OnboardingChecklistState = {
+    startedAt: string;
+    completed: Record<OnboardingChecklistStepId, boolean>;
+};
+export declare function toChecklistState(record: OnboardingRecord | null): OnboardingChecklistState | null;
+export declare function isOnboardingChecklistCompleteForCrumbySetting(state: OnboardingChecklistState, isCrumbyEnabled: boolean): boolean;
+/** Active workspace id, or null before the context is known. */
+export declare function readChecklistWorkspaceId(workspaceId?: string | number | null): number | null;
 /**
- * Parsed checklist from storage, or null if missing or past TTL.
- * Use this to cheaply skip heavy work (e.g. scanning all inbox messages) when the step is already done
- * or there is no active checklist.
+ * Checklist for the active workspace from the local cache, or null when there is none.
+ *
+ * Synchronous on purpose. Call sites use it to decide whether to bother marking a step, and
+ * they run on every inbox poll and every playground message — a network call there would be
+ * far more expensive than the check is worth. The cache is populated by the widget, which
+ * mounts on every page.
  */
 export declare function getActiveOnboardingChecklistState(userId: string | number | null | undefined, workspaceId?: string | number | null): OnboardingChecklistState | null;
 export type MarkOnboardingChecklistStepOptions = {
-    /** When already loaded (e.g. after a gate check), avoids a second localStorage read. */
+    /** Retained for call-site compatibility; the server is the authority on current state. */
     knownActiveState?: OnboardingChecklistState;
     workspaceId?: string | number | null;
 };
 /**
- * Marks a checklist step done when the user performs the real action (persists + notifies widget).
- * No-op if there is no checklist, it is expired, or the step is already complete.
+ * Marks a step done when the user performs the real action.
+ *
+ * Fire and forget: the mutation is idempotent and the service no-ops when the workspace has
+ * no checklist, so this does not gate on local state and cannot fail the action it follows.
+ *
+ * The signed-in user is read from `auth` rather than passed in. Server-side the step is keyed
+ * to the workspace and the caller is taken from the bearer token, so the id is only needed to
+ * confirm a session exists — which every call site would otherwise have to thread in itself.
  */
-export declare function markOnboardingChecklistStepComplete(userId: string | number | null | undefined, stepId: OnboardingChecklistStepId, options?: MarkOnboardingChecklistStepOptions): void;
-export declare function tryMarkOnboardingChecklistStepFromAuth(stepId: OnboardingChecklistStepId): void;
+export declare function markOnboardingChecklistStepComplete(stepId: OnboardingChecklistStepId, options?: MarkOnboardingChecklistStepOptions): void;

package/src/app/resources/components/Integrations/ChannelDialogLayout.d.ts

@@ -19,6 +19,11 @@ export interface ChannelDialogLayoutProps {
     supportUrl?: string;
     onNext: () => void;
     isNextDisabled: boolean;
+    isNextLoading?: boolean;
     rtl?: boolean;
+    /** Opens the magic-link share step. Hidden on the public connect page. */
+    onShareLink?: () => void;
+    /** Renders the form in the page instead of a dialog. */
+    inline?: boolean;
 }
-export declare const ChannelDialogLayout: ({ isOpen, onClose, channelName, setChannelName, channelTypeName, icon, extraFields, videoUrl, supportUrl, onNext, isNextDisabled, rtl, }: ChannelDialogLayoutProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const ChannelDialogLayout: ({ isOpen, onClose, channelName, setChannelName, channelTypeName, icon, extraFields, videoUrl, supportUrl, onNext, isNextDisabled, isNextLoading, rtl, onShareLink, inline, }: ChannelDialogLayoutProps) => import("@emotion/react/jsx-runtime").JSX.Element;

package/src/app/resources/components/Integrations/RenderCorrectIntegrationFlow.d.ts

@@ -8,11 +8,13 @@ export interface ChannelFlowExtendedProps {
     channelTypeName: string;
     icon?: React.ReactNode;
     rtl?: boolean;
+    onShareLink?: () => void;
+    inline?: boolean;
 }
 interface RenderCorrectIntegrationFlowProps extends IntegrationFlowComponentProps<IntegrationWithSecrets>, ChannelFlowExtendedProps {
     type: IntegrationType;
 }
-export declare const RenderCorrectIntegrationFlow: ({ type, setInitialValues, cancel, isOpen, channelName, setChannelName, channelTypeName, icon, rtl, }: RenderCorrectIntegrationFlowProps) => import("@emotion/react/jsx-runtime").JSX.Element | null;
+export declare const RenderCorrectIntegrationFlow: ({ type, setInitialValues, cancel, isOpen, channelName, setChannelName, channelTypeName, icon, rtl, onShareLink, inline, }: RenderCorrectIntegrationFlowProps) => import("@emotion/react/jsx-runtime").JSX.Element | null;
 export declare const RenderCorrectIntegrationFlowCancelledMessage: ({ type, tryAgain, }: {
     type: IntegrationType;
     tryAgain: () => void;

package/src/app/resources/components/Integrations/WebChat/index.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { IntegrationWithSecrets } from '../../../../../graphql.autogenerated';
+import { IntegrationFlowComponentProps } from '../types';
+import { ChannelFlowExtendedProps } from '../RenderCorrectIntegrationFlow';
+type Props = IntegrationFlowComponentProps<IntegrationWithSecrets> & ChannelFlowExtendedProps;
+/** Website live chat needs only a name: visitors connect through bc-channels, so there are no credentials. */
+export declare const WebChatChannel: React.FC<Props>;
+export {};

package/src/app/resources/components/Integrations/WhatsApp/index.d.ts

@@ -3,5 +3,6 @@ import { IntegrationWithSecrets } from '../../../../../graphql.autogenerated';
 import { IntegrationFlowComponentProps } from '../types';
 import { ChannelFlowExtendedProps } from '../RenderCorrectIntegrationFlow';
 type Props = IntegrationFlowComponentProps<IntegrationWithSecrets> & ChannelFlowExtendedProps;
+export declare const WhatsAppReconnect: React.FC<IntegrationFlowComponentProps<IntegrationWithSecrets>>;
 export declare const WhatsApp: React.FC<Props>;
 export {};

package/src/app/resources/hooks/useFBPagesHook.d.ts

@@ -1,3 +1,4 @@
+import { ChannelSetupProvider } from '../utils/channelSetupTracking';
 declare global {
     interface Window {
         FB: any;
@@ -8,8 +9,9 @@ export interface FBPage {
     name: string;
     access_token: string;
 }
-declare function useFBPagesHook(scope: string): {
-    login: (onResult: (fbUserAccessToken: string, pages: FBPage[]) => void) => void;
+declare function useFBPagesHook(scope: string, provider: ChannelSetupProvider): {
+    login: (onResult: (fbUserAccessToken: string, pages: FBPage[]) => void) => Promise<void>;
     error: string | null;
+    pending: boolean;
 };
 export default useFBPagesHook;

package/src/app/resources/hooks/useWabaHook.d.ts

@@ -4,10 +4,11 @@ declare global {
     }
 }
 declare function useWabaHook(): {
-    login: () => void;
-    phoneId: undefined;
-    wabaId: undefined;
-    accessToken: undefined;
+    login: () => Promise<void>;
+    phoneId: string | undefined;
+    wabaId: string | undefined;
+    accessToken: string | undefined;
     error: string | null;
+    pending: boolean;
 };
 export default useWabaHook;

package/src/app/resources/utils/channelSetupTracking.d.ts

@@ -0,0 +1,21 @@
+import type { PostHog } from 'posthog-js';
+/** Funnel / UX events for the channel setup dialogs (WhatsApp, Facebook, Instagram). */
+export declare const ChannelSetupEvents: {
+    readonly Started: "Channel Setup Started";
+    readonly Failed: "Channel Setup Failed";
+    readonly Timeout: "Channel Setup Timeout";
+};
+/** Why a provider handoff ended without an access token. */
+export declare const ChannelSetupFailureReason: {
+    readonly SdkUnavailable: "sdk_unavailable";
+    readonly PopupClosed: "popup_closed";
+    readonly Denied: "denied";
+};
+export type ChannelSetupProvider = 'whatsapp' | 'facebook' | 'instagram';
+/** Map a failed Meta FB.login response to a single failure reason vocabulary. */
+export declare function failureReasonFromLoginStatus(res: {
+    status?: string;
+} | null | undefined): string;
+export declare function captureChannelSetupStarted(posthog: PostHog | null | undefined, provider: ChannelSetupProvider): void;
+export declare function captureChannelSetupFailed(posthog: PostHog | null | undefined, provider: ChannelSetupProvider, reason: string): void;
+export declare function captureChannelSetupTimeout(posthog: PostHog | null | undefined, provider: ChannelSetupProvider): void;

package/src/app/resources/utils/facebookSdk.d.ts

@@ -0,0 +1,11 @@
+/** True once the GTM-loaded Facebook SDK exposes FB.login. */
+export declare function isFacebookSdkReady(): boolean;
+/**
+ * Resolve once the Facebook SDK can accept a login call, or resolve false when
+ * the deadline passes. A false result means the SDK never arrived, for example
+ * an ad blocker removed the script.
+ *
+ * @param timeoutMs how long to wait for the SDK before giving up
+ * @param pollMs how often to re-check for the SDK
+ */
+export declare function waitForFacebookSdk(timeoutMs?: number, pollMs?: number): Promise<boolean>;

package/src/app/subscriptions/components/NewSubscription/OnboardingStepper.d.ts

@@ -1,7 +1,7 @@
 export type OnboardingStepStatus = 'complete' | 'active' | 'upcoming';
-export type OnboardingStepKey = 'registration' | 'workspace' | 'checkout';
+export type OnboardingStepKey = 'registration' | 'workspace' | 'personalization' | 'checkout';
 type OnboardingStepperProps = {
-    /** Status per step; defaults to registration complete, workspace active, checkout upcoming. */
+    /** Status per step; defaults to registration complete, workspace active, the rest upcoming. */
     statuses?: Partial<Record<OnboardingStepKey, OnboardingStepStatus>>;
 };
 export declare const OnboardingStepper: ({ statuses }: OnboardingStepperProps) => import("@emotion/react/jsx-runtime").JSX.Element;

package/src/app/subscriptions/components/NewSubscription/SubscriptionName.d.ts

@@ -1,5 +1,7 @@
 type SubscriptionNameProps = {
     onSubmit: (companyName: string) => void;
+    /** False when the user already has a workspace: creating another one is not an onboarding flow. */
+    showStepper?: boolean;
 };
 export declare const SubscriptionName: (props: SubscriptionNameProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default SubscriptionName;

package/src/app/subscriptions/components/NewSubscription/WorkspaceProfile.d.ts

@@ -0,0 +1,18 @@
+import { type WorkspaceProfileOptions, type WorkspaceProfileValues } from '../../../onboarding/constants/workspaceProfileOptions';
+type WorkspaceProfileProps = {
+    onSubmit: (values: WorkspaceProfileValues) => void;
+    /** Lets the caller skip ahead; the answers are optional, not a gate on checkout. */
+    onSkip: () => void;
+    submitting?: boolean;
+    /** False when the user already has a workspace: creating another one is not an onboarding flow. */
+    showStepper?: boolean;
+    /** Overrides the onboardingOptions query; used by tests and stories. */
+    options?: WorkspaceProfileOptions;
+};
+/**
+ * Collected between naming the workspace and checkout. Every answer is optional — this is
+ * segmentation data, not something the product needs to run, so it must never block a user
+ * from reaching checkout.
+ */
+export declare const WorkspaceProfile: ({ onSubmit, onSkip, submitting, showStepper, options, }: WorkspaceProfileProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export default WorkspaceProfile;

package/src/app/subscriptions/components/NewSubscription/WorkspaceStepLayout.d.ts

@@ -2,10 +2,13 @@ import { ReactNode } from 'react';
 import { OnboardingStepKey, OnboardingStepStatus } from './OnboardingStepper';
 type WorkspaceStepLayoutProps = {
     statuses?: Partial<Record<OnboardingStepKey, OnboardingStepStatus>>;
-    illustration: string;
+    /** Hidden when the user already owns a workspace — the stepper only frames first-time onboarding. */
+    showStepper?: boolean;
+    /** Optional: the personalization step is a form-only screen. */
+    illustration?: string;
     title: string;
     subtitle?: string;
     children?: ReactNode;
 };
-export declare const WorkspaceStepLayout: ({ statuses, illustration, title, subtitle, children, }: WorkspaceStepLayoutProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const WorkspaceStepLayout: ({ statuses, showStepper, illustration, title, subtitle, children, }: WorkspaceStepLayoutProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default WorkspaceStepLayout;

package/src/app/subscriptions/hooks/useWorkspaceProfileSubmit.d.ts

@@ -0,0 +1,12 @@
+import type { WorkspaceProfileValues } from '../../onboarding/constants/workspaceProfileOptions';
+/**
+ * Submits the company profile answers collected between naming a workspace and checkout.
+ *
+ * Failures are swallowed on purpose: these answers are segmentation data, so losing them
+ * must never keep a user from reaching checkout.
+ */
+export declare function useWorkspaceProfileSubmit(): {
+    submitProfile: (workspaceId: number, values: WorkspaceProfileValues) => Promise<void>;
+    submitting: boolean;
+};
+export default useWorkspaceProfileSubmit;

package/src/app/subscriptions/utils/newWorkspaceContext.d.ts

@@ -1,5 +1,13 @@
 /** Query flag for flows that create a workspace (plan pick, checkout) without using the active workspace context. */
 export declare const NEW_WORKSPACE_QUERY_KEY = "newWorkspace";
 export declare function isCreatingNewWorkspace(pathname: string, search: string): boolean;
+/**
+ * The workspace the create page is working on: its id once created (the page keeps it in the URL),
+ * null before that, and undefined on any other page. Until the new workspace exists, the active
+ * context still points at the previously selected one, so nothing should present that as current.
+ */
+export declare function getCreatePageWorkspaceId(pathname: string, search: string): number | null | undefined;
+/** True on the create page until the new workspace exists. */
+export declare function isNamingNewWorkspace(pathname: string, search: string): boolean;
 export declare function newWorkspaceSearch(): string;
 export declare function buildNewWorkspaceSubscriptionPath(): string;