@aiquants/contact-map 0.4.0 → 0.5.0

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 import * as react from "react";
 import { CSSProperties, ReactNode, RefObject, PointerEvent, MouseEvent } from "react";
 import { UseFuzzySearchOptions } from "@aiquants/fuzzy-search/react";
-import { C as ContactRecord, a as ContactMapStreamPhase, b as ContactMapSearchOutletContext, c as ContactMapOutletContext, d as ContactMapLogger, S as SerializedContactStreamRow } from "./wire-CFgYO13H.js";
+import { C as ContactRecord, a as ContactMapStreamPhase, b as ContactMapSearchOutletContext, c as ContactMapOutletContext, d as ContactMapLogger, S as SerializedContactStreamRow } from "./wire-hAxBVVH6.js";
 import { DirectoryTreeLabels, DirectoryTreeVirtualScrollOptions } from "@aiquants/directory-tree";
 import * as _aiquants_virtualscroll from "@aiquants/virtualscroll";
 import { VirtualScrollLocale } from "@aiquants/virtualscroll";
@@ -93,6 +93,7 @@ type ContactMapOwnLabels = {
     readonly annotationStreamingProgress: (progress: ContactMapStreamProgress) => string;
     readonly annotationStreamingCount: (loaded: number) => string;
     readonly annotationLoadFailed: (loaded: number) => string;
+    readonly annotationAuthRequired: string;
     readonly annotationRetry: string;
     readonly recordUnit: (displayed: string) => string;
     readonly companyUnit: (displayed: string) => string;
@@ -375,7 +376,25 @@ type ContactMapLabelOverrides = {
 };
 declare const CONTACT_MAP_LABEL_KEYS: readonly (keyof ContactMapLabels)[];
 declare const CONTACT_MAP_LABEL_CATALOGS: Readonly<Record<ContactMapLocale, ContactMapLabels>>;
-declare const resolveContactMapLabels: (locale: ContactMapLocale | undefined, overrides: ContactMapLabelOverrides | undefined) => ContactMapLabels;
+type ContactMapChromeSurface = {
+    readonly locale: string;
+    readonly labels: string;
+};
+declare const resolveContactMapLabels: (locale: ContactMapLocale | undefined, overrides: ContactMapLabelOverrides | undefined, surface?: ContactMapChromeSurface) => ContactMapLabels;
+type ContactMapWorkerUrls = {
+    indexWorker?: string;
+    levenshteinWorker?: string;
+    treeWorker?: string;
+};
+type ContactMapWorkerUrlKey = keyof ContactMapWorkerUrls;
+type ContactMapWorkerUrlsSurface = {
+    readonly setting: string;
+    readonly keys?: readonly ContactMapWorkerUrlKey[];
+    readonly hints?: Partial<Record<ContactMapWorkerUrlKey, string>>;
+};
+declare function assertContactMapWorkerUrls(workerUrls: unknown, surface?: ContactMapWorkerUrlsSurface): asserts workerUrls is ContactMapWorkerUrls | undefined;
+declare function assertContactMapTreeWorkerUrl(treeWorkerUrl: unknown): asserts treeWorkerUrl is string | undefined;
+declare const layerContactMapWorkerUrls: (provided: ContactMapWorkerUrls | undefined, own: ContactMapWorkerUrls | undefined, surface?: ContactMapWorkerUrlsSurface) => ContactMapWorkerUrls;
 interface ContactMapAppViewProps {
     renderHeader?: (props: {
         title: string;
@@ -385,11 +404,7 @@ interface ContactMapAppViewProps {
     locale?: ContactMapLocale;
     labels?: ContactMapLabelOverrides;
     streamEndpoint?: string;
-    workerUrls?: {
-        indexWorker?: string;
-        levenshteinWorker?: string;
-        treeWorker?: string;
-    };
+    workerUrls?: ContactMapWorkerUrls;
     onFooterVisibilityChange?: (mode: "visible" | "mobile-hidden") => void;
 }
 declare const ContactMapAppView: (props: ContactMapAppViewProps) => react.JSX.Element;
@@ -419,14 +434,11 @@ declare const ContactMapSearchListView: ({ context }: ContactMapSearchListViewPr
 type ContactMapTab = "search" | "settings" | "statistics";
 interface ContactMapSearchPageProps {
     streamState?: ContactMapOutletContext;
-    workerUrls?: {
-        indexWorker?: string;
-        levenshteinWorker?: string;
-    };
+    workerUrls?: Pick<ContactMapWorkerUrls, "indexWorker" | "levenshteinWorker">;
     onFooterVisibilityChange?: (mode: "visible" | "mobile-hidden") => void;
     children?: (context: ContactMapSearchOutletContext) => ReactNode;
 }
-declare const ContactMapSearchPage: ({ streamState, workerUrls, onFooterVisibilityChange, children }?: ContactMapSearchPageProps) => react.JSX.Element;
+declare const ContactMapSearchPage: ({ streamState, ...rest }?: ContactMapSearchPageProps) => react.JSX.Element;
 interface ContactMapSearchTabGroupProps {
     context: ContactMapSearchOutletContext;
 }
@@ -524,21 +536,13 @@ interface ContactMapConfig {
     streamEndpoint?: string;
     openEmailsWithGmail?: boolean;
     treeWorkerFactory?: () => Worker;
-    workerUrls?: {
-        indexWorker?: string;
-        levenshteinWorker?: string;
-        treeWorker?: string;
-    };
-    fuzzyWorkerUrls?: {
-        indexWorkerUrl?: string;
-        levenshteinWorkerUrl?: string;
-    };
+    workerUrls?: ContactMapWorkerUrls;
     layoutSpec?: Partial<ResponsiveLayoutSpec>;
     locale?: ContactMapLocale;
     labels?: ContactMapLabelOverrides;
 }
 declare function ContactMapConfigProvider({ config, children }: {
-    config?: ContactMapConfig;
+    config: ContactMapConfig;
     children: ReactNode;
 }): react.JSX.Element;
 declare function useContactMapConfig(): ContactMapConfig;
@@ -553,18 +557,19 @@ type ContactMapStreamState = {
 };
 type ContactMapStreamClientDeps = {
     fetchFn?: typeof fetch;
-    endpoint?: string;
+    endpoint: string;
     initialRetryDelayMs?: number;
     maxRetryDelayMs?: number;
     maxConsecutiveFailures?: number;
     logger?: ContactMapLogger;
 };
+declare function assertContactMapStreamEndpoint(endpoint: unknown): asserts endpoint is string;
 declare const deserializeStreamRecord: (row: SerializedContactStreamRow) => ContactRecord;
 declare class ContactMapStreamClient {
     private readonly recordMap;
     private readonly listeners;
     private readonly fetchFn;
-    private readonly endpoint;
+    readonly endpoint: string;
     private readonly initialRetryDelayMs;
     private readonly maxRetryDelayMs;
     private readonly maxConsecutiveFailures;
@@ -576,12 +581,11 @@ declare class ContactMapStreamClient {
     private activeController;
     private wakeRetryWait;
     private state;
-    constructor(deps?: ContactMapStreamClientDeps);
+    constructor(deps: ContactMapStreamClientDeps);
     getState(): ContactMapStreamState;
     getRecordMap(): ReadonlyMap<number, ContactRecord>;
     subscribe(listener: (state: ContactMapStreamState) => void): () => void;
     start(): void;
-    retry(): void;
     retryNow(): void;
     dispose(): void;
     private readonly handleOnline;
@@ -593,11 +597,17 @@ declare class ContactMapStreamClient {
     private streamOnce;
 }
 declare const useAnimatedNumber: (targetValue: number, durationMs?: number) => number;
-declare const getContactMapStreamClient: (endpoint?: string) => ContactMapStreamClient;
+type ContactMapStreamHandle = ContactMapStreamState & {
+    readonly recordMap: ReadonlyMap<number, ContactRecord>;
+    readonly retryNow: () => void;
+};
+declare const getContactMapStreamClient: (endpoint: string) => ContactMapStreamClient;
 declare const resetContactMapStreamClientForTesting: () => void;
-declare const getContactMapRecordMap: () => ReadonlyMap<number, ContactRecord>;
-declare function useContactMapStream(endpointOverride?: string): ContactMapStreamState & {
-    retryNow: () => void;
+declare function useContactMapStream(): ContactMapStreamHandle;
+declare const countContactMapCompanies: (records: readonly ContactRecord[]) => number;
+declare function useStreamedContactMapContext(): {
+    readonly context: ContactMapOutletContext;
+    readonly retryNow: () => void;
 };
 interface UseDynamicViewportHeightOptions {
     enableMutationObserver?: boolean;
@@ -656,6 +666,11 @@ interface TreeWorkerState {
     snapshot: TreeWorkerSnapshot | null;
     isBuilding: boolean;
 }
+type TreeWorkerSource = "treeWorkerFactory" | "workerUrls.treeWorker";
+interface TreeWorkerSessionOptions {
+    readonly workerSource: TreeWorkerSource;
+    readonly logger?: ContactMapLogger;
+}
 declare class TreeWorkerSession {
     private worker;
     private generation;
@@ -666,12 +681,15 @@ declare class TreeWorkerSession {
     private postedNaming;
     private lastSyncedNaming;
     private consecutiveFailures;
-    private finalizeRequested;
+    private finalizeRequest;
+    private finalizedPostedCount;
     private retryTimer;
     private readonly listeners;
     private readonly workerFactory;
+    private readonly workerSource;
+    private readonly logger;
     private state;
-    constructor(workerFactory: () => Worker);
+    constructor(workerFactory: () => Worker, { workerSource, logger }: TreeWorkerSessionOptions);
     getState: () => TreeWorkerState;
     private updateState;
     subscribe: (listener: () => void) => (() => void);
@@ -681,11 +699,11 @@ declare class TreeWorkerSession {
     private readonly handleFailure;
     syncRecords(records: readonly ContactRecordForTree[], naming: ContactMapTreeNaming): void;
     finalize(): void;
-    dispose(): void;
+    private cancelWorker;
+    stop(): void;
+    reset(): void;
 }
-declare const getTreeWorkerSession: (factory?: () => Worker, treeWorkerUrl?: string) => TreeWorkerSession;
-declare const syncTreeWorkerRecords: (records: readonly ContactRecordForTree[], naming: ContactMapTreeNaming) => void;
-declare const finalizeTreeWorker: () => void;
+declare const getTreeWorkerSession: (treeWorkerUrl?: string) => TreeWorkerSession;
 declare const resetTreeWorkerSessionForTesting: () => void;
 declare function useTreeWorker(records: readonly ContactRecordForTree[], isComplete?: boolean): TreeWorkerState;
 declare const useContactMapLabels: () => ContactMapLabels;
@@ -709,4 +727,4 @@ declare const Tabs: react.ForwardRefExoticComponent<TabsPrimitive.TabsProps & re
 declare const TabsList: react.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsListProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 declare const TabsTrigger: react.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsTriggerProps & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
 declare const TabsContent: react.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsContentProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
-export { AdvancedSearchSettings, type AdvancedSearchSettingsProps, BasicSearchSettings, type BasicSearchSettingsProps, CONTACT_MAP_LABEL_CATALOGS, CONTACT_MAP_LABEL_KEYS, ContactDetailGrid, type ContactDetailGridProps, type ContactDetailGridSkeletonProps, ContactDetailPanel, type ContactDetailPanelProps, ContactDetailPopup, type ContactDetailPopupProps, ContactDetailRowLayout, type ContactDetailRowLayoutProps, ContactMapAnnotation, type ContactMapAnnotationProps, ContactMapAppView, type ContactMapAppViewProps, type ContactMapConfig, ContactMapConfigProvider, type ContactMapHistoryEntry, type ContactMapLabelOverrides, type ContactMapLabels, type ContactMapLocale, type ContactMapOwnLabels, type ContactMapQueryLengthStat, ContactMapSearchListView, ContactMapSearchPage, type ContactMapSearchPageProps, ContactMapSearchTabGroup, type ContactMapSearchTabGroupProps, ContactMapSearchTreeView, type ContactMapSearchTreeViewProps, ContactMapStreamClient, type ContactMapStreamClientDeps, ContactMapStreamPhase, type ContactMapStreamProgress, type ContactMapStreamState, type ContactMapTab, HighlightedText, type HighlightedTextProps, type HorizontalDragScrollHandlers, IndexWorkerSettings, type IndexWorkerSettingsProps, LIST_COLLAPSE_THRESHOLD, LIST_DETAIL_PANEL_MIN_WIDTH, LIST_EXPAND_THRESHOLD, LIST_PANEL_MIN_WIDTH, LIST_RESIZE_HANDLE_THICKNESS, LevenshteinWorkerSettings, type LevenshteinWorkerSettingsProps, type PopupCloseOptions, Progress, type ProgressProps, SearchOptionsPanel, type SearchOptionsPanelProps, type SearchOptionsPanelTab, StatItem, type StatItemProps, StatisticsPanel, type StatisticsPanelProps, type StatisticsPanelTab, SwipeOverlay, type SwipeOverlayProps, TREE_COLLAPSE_THRESHOLD, TREE_DETAIL_PANEL_MIN_WIDTH, TREE_EXPAND_THRESHOLD, TREE_PANEL_MIN_WIDTH, TREE_RESIZE_HANDLE_THICKNESS, Tabs, TabsContent, TabsList, TabsTrigger, TreeWorkerSession, type TreeWorkerSnapshot, type TreeWorkerState, type UseDynamicViewportHeightOptions, type UseDynamicViewportHeightResult, type UseHorizontalDragScrollOptions, type UseLongPressPopupOptions, type UseLongPressPopupReturn, type UseResponsiveTwoColumnLayoutOptions, type UseResponsiveTwoColumnLayoutResult, type WorkerStatsKind, WorkerStatsSection, type WorkerStatsSectionProps, composeTreeVirtualScrollOptions, contactMapShouldRevalidate, deserializeStreamRecord, finalizeTreeWorker, getContactMapRecordMap, getContactMapStreamClient, getTreeWorkerSession, resetContactMapStreamClientForTesting, resetTreeWorkerSessionForTesting, resolveContactMapLabels, syncTreeWorkerRecords, useAnimatedNumber, useContactMapConfig, useContactMapLabels, useContactMapStream, useContactPanelSizing, useDynamicViewportHeight, useHorizontalDragScroll, useLongPressPopup, useReportPopupVisibility, useResponsiveTwoColumnLayout, useRowPopupRegistry, useTreeWorker };
+export { AdvancedSearchSettings, type AdvancedSearchSettingsProps, BasicSearchSettings, type BasicSearchSettingsProps, CONTACT_MAP_LABEL_CATALOGS, CONTACT_MAP_LABEL_KEYS, ContactDetailGrid, type ContactDetailGridProps, type ContactDetailGridSkeletonProps, ContactDetailPanel, type ContactDetailPanelProps, ContactDetailPopup, type ContactDetailPopupProps, ContactDetailRowLayout, type ContactDetailRowLayoutProps, ContactMapAnnotation, type ContactMapAnnotationProps, ContactMapAppView, type ContactMapAppViewProps, type ContactMapChromeSurface, type ContactMapConfig, ContactMapConfigProvider, type ContactMapHistoryEntry, type ContactMapLabelOverrides, type ContactMapLabels, type ContactMapLocale, type ContactMapOwnLabels, type ContactMapQueryLengthStat, ContactMapSearchListView, ContactMapSearchPage, type ContactMapSearchPageProps, ContactMapSearchTabGroup, type ContactMapSearchTabGroupProps, ContactMapSearchTreeView, type ContactMapSearchTreeViewProps, ContactMapStreamClient, type ContactMapStreamClientDeps, type ContactMapStreamHandle, ContactMapStreamPhase, type ContactMapStreamProgress, type ContactMapStreamState, type ContactMapTab, type ContactMapWorkerUrlKey, type ContactMapWorkerUrls, type ContactMapWorkerUrlsSurface, HighlightedText, type HighlightedTextProps, type HorizontalDragScrollHandlers, IndexWorkerSettings, type IndexWorkerSettingsProps, LIST_COLLAPSE_THRESHOLD, LIST_DETAIL_PANEL_MIN_WIDTH, LIST_EXPAND_THRESHOLD, LIST_PANEL_MIN_WIDTH, LIST_RESIZE_HANDLE_THICKNESS, LevenshteinWorkerSettings, type LevenshteinWorkerSettingsProps, type PopupCloseOptions, Progress, type ProgressProps, SearchOptionsPanel, type SearchOptionsPanelProps, type SearchOptionsPanelTab, StatItem, type StatItemProps, StatisticsPanel, type StatisticsPanelProps, type StatisticsPanelTab, SwipeOverlay, type SwipeOverlayProps, TREE_COLLAPSE_THRESHOLD, TREE_DETAIL_PANEL_MIN_WIDTH, TREE_EXPAND_THRESHOLD, TREE_PANEL_MIN_WIDTH, TREE_RESIZE_HANDLE_THICKNESS, Tabs, TabsContent, TabsList, TabsTrigger, TreeWorkerSession, type TreeWorkerSessionOptions, type TreeWorkerSnapshot, type TreeWorkerSource, type TreeWorkerState, type UseDynamicViewportHeightOptions, type UseDynamicViewportHeightResult, type UseHorizontalDragScrollOptions, type UseLongPressPopupOptions, type UseLongPressPopupReturn, type UseResponsiveTwoColumnLayoutOptions, type UseResponsiveTwoColumnLayoutResult, type WorkerStatsKind, WorkerStatsSection, type WorkerStatsSectionProps, assertContactMapStreamEndpoint, assertContactMapTreeWorkerUrl, assertContactMapWorkerUrls, composeTreeVirtualScrollOptions, contactMapShouldRevalidate, countContactMapCompanies, deserializeStreamRecord, getContactMapStreamClient, getTreeWorkerSession, layerContactMapWorkerUrls, resetContactMapStreamClientForTesting, resetTreeWorkerSessionForTesting, resolveContactMapLabels, useAnimatedNumber, useContactMapConfig, useContactMapLabels, useContactMapStream, useContactPanelSizing, useDynamicViewportHeight, useHorizontalDragScroll, useLongPressPopup, useReportPopupVisibility, useResponsiveTwoColumnLayout, useRowPopupRegistry, useStreamedContactMapContext, useTreeWorker };