@bcrumbs.net/inbox 0.0.78 → 0.0.80

package/index.cjs.js

@@ -12127,8 +12127,8 @@ const getClientAvatarUrl = (avatarUrl, email, size = 36) => {
 
 const BLUR_CONTAINER = 'root';
 const LOADING_COLOR = bcUi.Color.PRIMARY;
-const FavIcon16 = "/assets/icons/favicons/favicon-16x16.png";
-const FavIcon32 = "/assets/icons/favicons/favicon-32x32.png";
+const FavIcon16 = '/assets/icons/favicons/favicon-16x16.png';
+const FavIcon32 = '/assets/icons/favicons/favicon-32x32.png';
 //export const HELPDESK_URL = 'https://bcrumbs.featurebase.app/help';
 const HELPDESK_URL = 'https://docs.bcrumbs.net/';
 

package/index.esm.js

@@ -12109,8 +12109,8 @@ const getClientAvatarUrl = (avatarUrl, email, size = 36) => {
 
 const BLUR_CONTAINER = 'root';
 const LOADING_COLOR = Color.PRIMARY;
-const FavIcon16 = "/assets/icons/favicons/favicon-16x16.png";
-const FavIcon32 = "/assets/icons/favicons/favicon-32x32.png";
+const FavIcon16 = '/assets/icons/favicons/favicon-16x16.png';
+const FavIcon32 = '/assets/icons/favicons/favicon-32x32.png';
 //export const HELPDESK_URL = 'https://bcrumbs.featurebase.app/help';
 const HELPDESK_URL = 'https://docs.bcrumbs.net/';
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bcrumbs.net/inbox",
   "description": "Inbox widget for Bread Crumbs portals",
-  "version": "0.0.78",
+  "version": "0.0.80",
   "keyword": [
     "bcrumbs",
     "bc-ui",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@bcrumbs.net/bc-shared": "^0.0.12",
-    "@bcrumbs.net/bc-ui": "^0.0.18",
+    "@bcrumbs.net/bc-ui": "^0.0.19",
     "@bcrumbs.net/bc-api": "^0.0.49",
     "@azure/storage-blob": "^12.25.0"
   },

package/src/app/ai/components/Crumby/CrumbyPageContext.d.ts

@@ -1,10 +1,12 @@
 import { type MutableRefObject } from 'react';
 import type { PromptSectionChange, PromptSectionsUpdateResult, PromptState } from '../../config/promptSettings';
+import type { OnboardingChecklistStepId } from '../../../onboarding/utils/onboardingChecklistStorage';
 /** Lets Crumby read and edit the Prompt settings form while that page is mounted. */
 export type PromptEditorBridge = {
     getSections: () => PromptState;
     applyChanges: (changes: PromptSectionChange[]) => PromptSectionsUpdateResult;
 };
+export type OnboardingStepOpener = (stepId: OnboardingChecklistStepId) => void;
 type CrumbyPageContextValue = {
     /** Ref (not state) so the chat transport always reads the latest page values at send time. */
     promptEditorRef: MutableRefObject<PromptEditorBridge | null>;
@@ -13,6 +15,12 @@ type CrumbyPageContextValue = {
     /** Increments on every open request; the widget opens its chat when it changes. */
     openRequestId: number;
     requestOpen: () => void;
+    /**
+     * Opens a checklist step's guide in the widget, as if picked there. Null while no widget can
+     * show it (the mobile Inbox has none, and only workspace managers see the checklist).
+     */
+    openOnboardingStep: OnboardingStepOpener | null;
+    registerOnboardingStepOpener: (opener: OnboardingStepOpener) => () => void;
 };
 /** Shares page-level state between portal pages and the Crumby widget mounted in the layout. */
 export declare const CrumbyPageProvider: ({ children }: {

package/src/app/gatewayHome/hooks/useSendableTemplates.d.ts

@@ -1,6 +1,6 @@
 import type { TemplateOption } from '../types';
 /**
- * Approved WhatsApp templates that need no parameters, so the console can send them as-is.
+ * Approved WhatsApp templates with a language that need no parameters, so the console can send them as-is.
  * The list query has no components, so each template's details are fetched (and cached by Apollo).
  */
 export declare function useSendableTemplates(workspaceId: number, integrationId?: string): {

package/src/app/gatewayHome/utils/isSendableTemplate.d.ts

@@ -0,0 +1,7 @@
+type TemplateSummary = {
+    status?: string | null;
+    language?: string | null;
+};
+/** Approved and has a language code: Meta rejects template sends without `language.code`. */
+export declare function isSendableTemplate(template: TemplateSummary): boolean;
+export {};

package/src/app/generic/utils/reportError.d.ts

@@ -0,0 +1,10 @@
+type ReportErrorContext = {
+    /** Sent as Sentry `extra` and as PostHog exception properties. */
+    extra?: Record<string, unknown>;
+};
+/**
+ * Reports a handled error to Sentry and PostHog error tracking. Uncaught errors reach both on
+ * their own, but an error swallowed by a catch block only gets reported through here.
+ */
+export declare const reportError: (error: unknown, context?: ReportErrorContext) => void;
+export {};

package/src/app/inbox/components/EmptyInboxOnboarding/ChannelConnectCard.d.ts

@@ -0,0 +1,9 @@
+import type { EmptyInboxChannelOption } from '../../constants/emptyInboxChannels';
+type ChannelConnectCardProps = {
+    option: EmptyInboxChannelOption;
+    /** Omitted for users who cannot create channels: the card then only describes the channel. */
+    onConnect?: (option: EmptyInboxChannelOption) => void;
+};
+/** One channel offered on the empty Inbox: what it does, setup time, and a direct Connect action. */
+declare const ChannelConnectCard: ({ option, onConnect }: ChannelConnectCardProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export default ChannelConnectCard;

package/src/app/inbox/components/EmptyInboxOnboarding/EmptyInboxOnboarding.d.ts

@@ -0,0 +1,10 @@
+type EmptyInboxOnboardingProps = {
+    /** Called after a channel was created and its setup dialog closed. */
+    onChannelConnected: () => void;
+};
+/**
+ * First screen for a workspace without channels: channel cards with direct Connect actions,
+ * the onboarding checklist inline, and a way to reach the team for help (BCR-871).
+ */
+declare const EmptyInboxOnboarding: ({ onChannelConnected }: EmptyInboxOnboardingProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export default EmptyInboxOnboarding;

package/src/app/inbox/components/EmptyInboxOnboarding/GetStartedChecklist.d.ts

@@ -0,0 +1,10 @@
+type GetStartedChecklistProps = {
+    /** Mobile: show only the progress summary until the user expands it. */
+    collapsible?: boolean;
+};
+/**
+ * Inline "Get started" checklist for the empty Inbox; mirrors the floating widget's steps.
+ * Renders nothing when the workspace has no checklist or the user cannot manage the workspace.
+ */
+declare const GetStartedChecklist: ({ collapsible }: GetStartedChecklistProps) => import("@emotion/react/jsx-runtime").JSX.Element | null;
+export default GetStartedChecklist;

package/src/app/inbox/components/EmptyInboxOnboarding/SetupHelpCard.d.ts

@@ -0,0 +1,9 @@
+import type { EmptyInboxHelpAction } from '../../utils/emptyInboxTracking';
+type SetupHelpCardProps = {
+    onHelpClick: (action: EmptyInboxHelpAction) => void;
+    /** Mobile: stack the actions full width. */
+    stacked?: boolean;
+};
+/** "Need help connecting WhatsApp?" card: chat with support or book a guided setup call. */
+declare const SetupHelpCard: ({ onHelpClick, stacked }: SetupHelpCardProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export default SetupHelpCard;

package/src/app/inbox/constants/emptyInboxChannels.d.ts

@@ -0,0 +1,15 @@
+import { IntegrationType } from '../../../graphql.autogenerated';
+/** i18n key under `emptyInboxOnboarding.channels`. */
+export type EmptyInboxChannelKey = 'whatsapp' | 'instagram' | 'messenger' | 'telegram';
+export type EmptyInboxChannelOption = {
+    key: EmptyInboxChannelKey;
+    type: IntegrationType;
+    /** Rough setup time shown on the card. */
+    setupMinutes: number;
+    /** Background of the provider icon tile. */
+    iconBackground: string;
+    /** Highlighted as the main option, with a "Most popular" badge. */
+    featured?: boolean;
+};
+/** Channels offered on the empty Inbox, in display order. */
+export declare const EMPTY_INBOX_CHANNELS: EmptyInboxChannelOption[];

package/src/app/inbox/hooks/useConnectChannelDialog.d.ts

@@ -0,0 +1,14 @@
+import type { EmptyInboxChannelOption } from '../constants/emptyInboxChannels';
+/**
+ * Drives the channel setup dialog opened from the empty Inbox.
+ *
+ * A created channel is only reported once the dialog closes: reporting it straight away would
+ * swap the empty Inbox for the regular one and unmount the dialog's success step mid-view.
+ */
+export declare function useConnectChannelDialog(onChannelConnected: () => void): {
+    activeChannel: EmptyInboxChannelOption | null;
+    isOpen: boolean;
+    open: (option: EmptyInboxChannelOption) => void;
+    close: () => void;
+    markCreated: () => void;
+};

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

@@ -0,0 +1,12 @@
+import type { PostHog } from 'posthog-js';
+import type { EmptyInboxChannelKey } from '../constants/emptyInboxChannels';
+/** Funnel events for the empty-Inbox onboarding (BCR-871). */
+export declare const EmptyInboxEvents: {
+    readonly Viewed: "Empty Inbox Viewed";
+    readonly ChannelCardClicked: "Empty Inbox Channel Card Clicked";
+    readonly HelpClicked: "Empty Inbox Help Clicked";
+};
+export type EmptyInboxHelpAction = 'chat' | 'setup_call';
+export declare function captureEmptyInboxViewed(posthog: PostHog | null | undefined): void;
+export declare function captureChannelCardClicked(posthog: PostHog | null | undefined, channel: EmptyInboxChannelKey): void;
+export declare function captureHelpClicked(posthog: PostHog | null | undefined, action: EmptyInboxHelpAction): void;

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

@@ -0,0 +1,7 @@
+/**
+ * Pages where the floating guide waits instead of opening on its own: the Inbox (it shows the
+ * checklist itself when there are no channels, and conversations otherwise) and the workspace
+ * creation wizard, Welcome included since it only forwards to the Inbox. The guide then opens
+ * once, on the first other page the user visits.
+ */
+export declare function isGuideAutoOpenHeld(pathname: string, search: string): boolean;

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

@@ -4,6 +4,7 @@ export declare const ChannelSetupEvents: {
     readonly Started: "Channel Setup Started";
     readonly Failed: "Channel Setup Failed";
     readonly Timeout: "Channel Setup Timeout";
+    readonly Connected: "Channel Connected";
 };
 /** Why a provider handoff ended without an access token. */
 export declare const ChannelSetupFailureReason: {
@@ -18,4 +19,6 @@ export declare function failureReasonFromLoginStatus(res: {
 } | 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;
+/** A channel of any type was created; `type` is the integration type, lower-cased. */
+export declare function captureChannelConnected(posthog: PostHog | null | undefined, type: string): void;
 export declare function captureChannelSetupTimeout(posthog: PostHog | null | undefined, provider: ChannelSetupProvider): void;

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

@@ -11,3 +11,8 @@ export declare function getCreatePageWorkspaceId(pathname: string, search: strin
 export declare function isNamingNewWorkspace(pathname: string, search: string): boolean;
 export declare function newWorkspaceSearch(): string;
 export declare function buildNewWorkspaceSubscriptionPath(): string;
+/**
+ * Upgrade page search for a workspace that was just created. The flag tells Upgrade it is a plan
+ * pick, not a plan change, so the new workspace's Free plan is offered instead of shown as current.
+ */
+export declare function buildNewWorkspaceUpgradeSearch(workspaceId: number): string;

package/src/assets/locales/translations.d.ts

@@ -1089,6 +1089,48 @@ export declare const convertLanguageJsonToObject: (json: any, objToConvertTo?: C
             };
         };
     };
+    emptyInboxOnboarding: {
+        welcome: string;
+        subtitle: string;
+        subtitleAskAdmin: string;
+        connectFirstChannel: string;
+        mostPopular: string;
+        setupTime: string;
+        connect: string;
+        channels: {
+            whatsapp: {
+                name: string;
+                description: string;
+                requirement: string;
+            };
+            instagram: {
+                name: string;
+                description: string;
+                requirement: string;
+            };
+            messenger: {
+                name: string;
+                description: string;
+                requirement: string;
+            };
+            telegram: {
+                name: string;
+                description: string;
+                requirement: string;
+            };
+        };
+        checklist: {
+            title: string;
+            progress: string;
+            progressLabel: string;
+        };
+        help: {
+            title: string;
+            description: string;
+            chat: string;
+            bookCall: string;
+        };
+    };
     onboardingChecklist: {
         title: string;
         getStarted: string;
@@ -1651,6 +1693,8 @@ export declare const convertLanguageJsonToObject: (json: any, objToConvertTo?: C
         stuck: string;
         ourTeam: string;
         isHereForYou: string;
+        stuckContact: string;
+        stuckContactOrCall: string;
         customChannelSetup: string;
         customChannelDescription: string;
         webChatChannelDescription: string;

package/src/config/constants.d.ts

@@ -8,3 +8,5 @@ export declare const CHANGELOG_URL = "https://bcrumbs.featurebase.app/changelog"
 export declare const FEEDBACK_URL = "https://bcrumbs.featurebase.app/";
 export declare const ROADMAP_URL = "https://bcrumbs.featurebase.app/roadmap";
 export declare const SUPPORT_PHONE = "905301749170";
+/** Calendar link for a guided channel setup call. Empty hides the "Book a setup call" actions. */
+export declare const SETUP_CALL_URL = "https://cal.com/muneer-alwais-yisu4f/intro";