@universe-platform/ui 0.1.0-beta.14 → 0.1.0-beta.16

package/dist/index.d.mts

@@ -3,9 +3,13 @@ import { ColumnDef } from './columns';
 export { BaseColumnDef, COLUMN_CAPABILITIES, COLUMN_DEFAULT_INPUT_CONFIG, COLUMN_TYPES, COLUMN_TYPE_LABELS, ColumnCapabilities, ColumnConfig, ColumnConfigMap, ColumnDef, ColumnDefaultInputConfig, ColumnInfo, ColumnType, CurrencyConfig, ExtendedColumnInfo, GoogleContactConfig, GoogleContactNamePart, PhoneConfig, RelationConfig, SubTableConfig, TEXT_REPRESENTABLE_TYPES, TextRepresentableColumnType, TypedColumnDef, isTextRepresentable } from './columns';
 import { RecordData, CellValue } from './records';
 export { CellValue, ColumnValueMap, DriveFileValue, GoogleContactValue, LinkValue, RecordData, SubTableEntryValue, SubTableResolvedEntryValue } from './records';
-export { BaseComponent, ComponentType, EditorApp, EditorPage, PageComponent, PageInput, TableComponent } from './pages';
+import { WhatsAppConfig } from './pages';
+export { BaseComponent, ComponentType, EditorApp, EditorPage, PageComponent, PageInput, TableComponent, WhatsAppConfig } from './pages';
 import { SchemaDef } from './schema';
 export { SchemaDef, TableMeta } from './schema';
+import { TemplateIdentity } from './whatsappValidation';
+export * from './whatsappValidation';
+export { StatusConfig, TemplateIdentity, TemplateValidationParams, TemplateValidationResult, extractUniqueVariableIndices, extractVariableIndices, findVariableAtPosition, formatFileSize, getNextVariableIndex, getStatusConfig, hasBracketSpaces, hasConsecutiveVariables, hasFloatingVariables, hasInsufficientContextBetweenVariables, isDuplicateTemplate, isDuplicateTemplateName, isValidTemplateName, isWordToken, reindexVariables, sanitizeTemplateNameInput, seamlessVariableEngine, validateSequentialVariables, validateTemplateBody, validateWhatsAppTemplate, validateWordToVariableRatio } from './whatsappValidation';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
@@ -26,6 +30,36 @@ declare function openWhatsAppChat(phone: string, defaultCountryCode?: string): v
  */
 declare function formatPhoneDisplay(phone: string): string;
 
+/**
+ * Phone number sanitization, validation, and WhatsApp link generation utilities.
+ * Pure functions with zero React or DOM dependencies for universal (server & client) usage.
+ */
+/**
+ * Sanitizes phone numbers by stripping whitespace, dashes, and non-numeric characters,
+ * preserving a leading '+' if present.
+ */
+declare function sanitizePhoneNumber(phone: string): string;
+/**
+ * Validates whether a phone number is valid (after sanitization).
+ * Supports Israeli formats (e.g. 0501234567, 031234567) and international formats (+972..., 9-15 digits).
+ */
+declare function isValidPhoneNumber(phone: string): boolean;
+/**
+ * Generates an official wa.me WhatsApp direct message link.
+ *
+ * @param phone Raw or sanitized phone number
+ * @param defaultCountryCode Defaults to Israeli code '972'
+ * @returns WhatsApp URL or null if phone is empty
+ */
+declare function generateWhatsAppLink(phone: string, defaultCountryCode?: string): string | null;
+/**
+ * Normalizes a phone number for WhatsApp sending (E.164 without leading '+').
+ * - Strips spaces, dashes, and special characters.
+ * - If it starts with '05' (10 digits), replaces the leading '0' with '972' (e.g., '0586812807' -> '972586812807').
+ * - If it starts with '+', strips the '+'.
+ */
+declare function normalizePhoneForWhatsApp(phone: string): string;
+
 interface PastelPalette {
     bg: string;
     text: string;
@@ -83,11 +117,17 @@ declare function getRolePermissions(role?: OrgRole | string | null): RolePermiss
 interface TableConfig extends SchemaDef {
 }
 type TableData = RecordData[];
+type RowStatusType = "success" | "failed" | "skipped" | "partial";
 interface TableBlockProps extends Partial<BaseComponentProps<TableData, TableConfig>> {
     exportAction?: (payload: any) => Promise<any>;
     role?: OrgRole | string;
     permissions?: ComponentPermissions;
     readOnly?: boolean;
+    onSelectionChange?: (selectedIds: string[]) => void;
+    rowStatusMap?: Record<string, {
+        status: RowStatusType;
+        tooltip?: string;
+    } | RowStatusType>;
 }
 interface CreateRecordPayload {
     records: RecordData[];
@@ -264,13 +304,65 @@ interface RelationFilterPopoverProps {
 }
 declare function RelationFilterPopover({ isOpen, onClose, column, triggerRect, options, filterValue, selectedValues, onSelectionChange, isLoading, }: RelationFilterPopoverProps): react_jsx_runtime.JSX.Element | null;
 
+interface MetaTemplateComponent {
+    type: "HEADER" | "BODY" | "FOOTER" | "BUTTONS" | string;
+    format?: "TEXT" | "IMAGE" | "DOCUMENT" | "VIDEO" | string;
+    text?: string;
+    example?: {
+        header_handle?: string[];
+        body_text?: string[][];
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+interface MetaWhatsAppTemplate {
+    id: string;
+    name: string;
+    status: "APPROVED" | "PENDING" | "IN_REVIEW" | "REJECTED" | "PAUSED" | string;
+    category: "MARKETING" | "UTILITY" | string;
+    language: string;
+    components?: MetaTemplateComponent[];
+    [key: string]: any;
+}
+type WhatsAppData = any;
+interface WhatsAppComponentProps extends Partial<BaseComponentProps<WhatsAppData, WhatsAppConfig>> {
+    permissions?: ComponentPermissions;
+    orgId?: string;
+    organizationId?: string;
+}
+
+/**
+ * WhatsAppComponent
+ * High-level orchestrator for the WhatsApp messaging interface.
+ * Coordinates template selection, dynamic filters, recipient settings/actions,
+ * and the embedded data grid.
+ */
+declare function WhatsAppComponent(props: WhatsAppComponentProps): react_jsx_runtime.JSX.Element;
+
+interface CreateTemplateModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSuccess: () => void;
+    existingTemplateNames?: string[];
+    existingTemplates?: TemplateIdentity[];
+    executeAction?: (actionType: string, payload: Record<string, any>) => Promise<any>;
+    orgId?: string;
+}
+/**
+ * CreateTemplateModal
+ * Enterprise modal dialog for authoring and submitting WhatsApp message templates
+ * with atomic variable deletion, flexible editing, and strict word-to-variable ratio validation.
+ */
+declare function CreateTemplateModal({ isOpen, onClose, onSuccess, existingTemplateNames, existingTemplates, executeAction, orgId, }: CreateTemplateModalProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * UNIVERSE_COMPONENTS
- * Dynamic Component Registry dictionary mapping component type strings (e.g., "TABLE")
+ * Dynamic Component Registry dictionary mapping component type strings (e.g., "TABLE", "WHATSAPP")
  * to their respective React component implementation.
  */
 declare const UNIVERSE_COMPONENTS: {
     readonly TABLE: typeof TableBlock;
+    readonly WHATSAPP: typeof WhatsAppComponent;
 };
 type ComponentRegistry = typeof UNIVERSE_COMPONENTS;
 type UniverseComponentType = keyof ComponentRegistry;
@@ -295,4 +387,4 @@ declare function ToastProvider({ children }: {
 
 declare function useToast(): ToastContextType;
 
-export { type BaseComponentProps, ColumnHeaderTitle, type ColumnHeaderTitleProps, type ComponentCommunication, type ComponentConfig, type ComponentData, type ComponentPermissions, type ComponentRegistry, type ComponentState, type CreateRecordPayload, DatePickerCell, type DeleteRecordPayload, LinkPickerCell, type OrgRole, PASTEL_PALETTES, type PastelPalette, type RelationFilterOption, type RelationFilterPayload, RelationFilterPopover, type RelationFilterPopoverProps, RelationPickerCell, type RolePermissions, type SplitTitleResult, TableBlock, type TableBlockProps, type TableConfig, type TableData, TimePickerCell, ToastContext, type ToastContextType, type ToastItem, ToastProvider, UNIVERSE_COMPONENTS, type UniverseComponentType, type UpdateRecordPayload, type UseColumnReorderOptions, type UseColumnResizeOptions, calculateMinColumnWidth, cn, formatConflictCellValue, formatPhoneDisplay, formatTimeInput, formatTimeIso, getDeterministicPastelBadge, getRolePermissions, measureTextWidth, normalizeRelationValue, openWhatsAppChat, parseLinkValue, parseTimeParts, resolveProtocol, splitHeaderTitle, useColumnReorder, useColumnResize, useToast };
+export { type BaseComponentProps, ColumnHeaderTitle, type ColumnHeaderTitleProps, type ComponentCommunication, type ComponentConfig, type ComponentData, type ComponentPermissions, type ComponentRegistry, type ComponentState, type CreateRecordPayload, CreateTemplateModal, type CreateTemplateModalProps, DatePickerCell, type DeleteRecordPayload, LinkPickerCell, type MetaTemplateComponent, type MetaWhatsAppTemplate, type OrgRole, PASTEL_PALETTES, type PastelPalette, type RelationFilterOption, type RelationFilterPayload, RelationFilterPopover, type RelationFilterPopoverProps, RelationPickerCell, type RolePermissions, type RowStatusType, type SplitTitleResult, TableBlock, type TableBlockProps, type TableConfig, type TableData, TimePickerCell, ToastContext, type ToastContextType, type ToastItem, ToastProvider, UNIVERSE_COMPONENTS, type UniverseComponentType, type UpdateRecordPayload, type UseColumnReorderOptions, type UseColumnResizeOptions, WhatsAppComponent, type WhatsAppComponentProps, type WhatsAppData, calculateMinColumnWidth, cn, formatConflictCellValue, formatPhoneDisplay, formatTimeInput, formatTimeIso, generateWhatsAppLink, getDeterministicPastelBadge, getRolePermissions, isValidPhoneNumber, measureTextWidth, normalizePhoneForWhatsApp, normalizeRelationValue, openWhatsAppChat, parseLinkValue, parseTimeParts, resolveProtocol, sanitizePhoneNumber, splitHeaderTitle, useColumnReorder, useColumnResize, useToast };

package/dist/index.d.ts

@@ -3,9 +3,13 @@ import { ColumnDef } from './columns';
 export { BaseColumnDef, COLUMN_CAPABILITIES, COLUMN_DEFAULT_INPUT_CONFIG, COLUMN_TYPES, COLUMN_TYPE_LABELS, ColumnCapabilities, ColumnConfig, ColumnConfigMap, ColumnDef, ColumnDefaultInputConfig, ColumnInfo, ColumnType, CurrencyConfig, ExtendedColumnInfo, GoogleContactConfig, GoogleContactNamePart, PhoneConfig, RelationConfig, SubTableConfig, TEXT_REPRESENTABLE_TYPES, TextRepresentableColumnType, TypedColumnDef, isTextRepresentable } from './columns';
 import { RecordData, CellValue } from './records';
 export { CellValue, ColumnValueMap, DriveFileValue, GoogleContactValue, LinkValue, RecordData, SubTableEntryValue, SubTableResolvedEntryValue } from './records';
-export { BaseComponent, ComponentType, EditorApp, EditorPage, PageComponent, PageInput, TableComponent } from './pages';
+import { WhatsAppConfig } from './pages';
+export { BaseComponent, ComponentType, EditorApp, EditorPage, PageComponent, PageInput, TableComponent, WhatsAppConfig } from './pages';
 import { SchemaDef } from './schema';
 export { SchemaDef, TableMeta } from './schema';
+import { TemplateIdentity } from './whatsappValidation';
+export * from './whatsappValidation';
+export { StatusConfig, TemplateIdentity, TemplateValidationParams, TemplateValidationResult, extractUniqueVariableIndices, extractVariableIndices, findVariableAtPosition, formatFileSize, getNextVariableIndex, getStatusConfig, hasBracketSpaces, hasConsecutiveVariables, hasFloatingVariables, hasInsufficientContextBetweenVariables, isDuplicateTemplate, isDuplicateTemplateName, isValidTemplateName, isWordToken, reindexVariables, sanitizeTemplateNameInput, seamlessVariableEngine, validateSequentialVariables, validateTemplateBody, validateWhatsAppTemplate, validateWordToVariableRatio } from './whatsappValidation';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
@@ -26,6 +30,36 @@ declare function openWhatsAppChat(phone: string, defaultCountryCode?: string): v
  */
 declare function formatPhoneDisplay(phone: string): string;
 
+/**
+ * Phone number sanitization, validation, and WhatsApp link generation utilities.
+ * Pure functions with zero React or DOM dependencies for universal (server & client) usage.
+ */
+/**
+ * Sanitizes phone numbers by stripping whitespace, dashes, and non-numeric characters,
+ * preserving a leading '+' if present.
+ */
+declare function sanitizePhoneNumber(phone: string): string;
+/**
+ * Validates whether a phone number is valid (after sanitization).
+ * Supports Israeli formats (e.g. 0501234567, 031234567) and international formats (+972..., 9-15 digits).
+ */
+declare function isValidPhoneNumber(phone: string): boolean;
+/**
+ * Generates an official wa.me WhatsApp direct message link.
+ *
+ * @param phone Raw or sanitized phone number
+ * @param defaultCountryCode Defaults to Israeli code '972'
+ * @returns WhatsApp URL or null if phone is empty
+ */
+declare function generateWhatsAppLink(phone: string, defaultCountryCode?: string): string | null;
+/**
+ * Normalizes a phone number for WhatsApp sending (E.164 without leading '+').
+ * - Strips spaces, dashes, and special characters.
+ * - If it starts with '05' (10 digits), replaces the leading '0' with '972' (e.g., '0586812807' -> '972586812807').
+ * - If it starts with '+', strips the '+'.
+ */
+declare function normalizePhoneForWhatsApp(phone: string): string;
+
 interface PastelPalette {
     bg: string;
     text: string;
@@ -83,11 +117,17 @@ declare function getRolePermissions(role?: OrgRole | string | null): RolePermiss
 interface TableConfig extends SchemaDef {
 }
 type TableData = RecordData[];
+type RowStatusType = "success" | "failed" | "skipped" | "partial";
 interface TableBlockProps extends Partial<BaseComponentProps<TableData, TableConfig>> {
     exportAction?: (payload: any) => Promise<any>;
     role?: OrgRole | string;
     permissions?: ComponentPermissions;
     readOnly?: boolean;
+    onSelectionChange?: (selectedIds: string[]) => void;
+    rowStatusMap?: Record<string, {
+        status: RowStatusType;
+        tooltip?: string;
+    } | RowStatusType>;
 }
 interface CreateRecordPayload {
     records: RecordData[];
@@ -264,13 +304,65 @@ interface RelationFilterPopoverProps {
 }
 declare function RelationFilterPopover({ isOpen, onClose, column, triggerRect, options, filterValue, selectedValues, onSelectionChange, isLoading, }: RelationFilterPopoverProps): react_jsx_runtime.JSX.Element | null;
 
+interface MetaTemplateComponent {
+    type: "HEADER" | "BODY" | "FOOTER" | "BUTTONS" | string;
+    format?: "TEXT" | "IMAGE" | "DOCUMENT" | "VIDEO" | string;
+    text?: string;
+    example?: {
+        header_handle?: string[];
+        body_text?: string[][];
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+interface MetaWhatsAppTemplate {
+    id: string;
+    name: string;
+    status: "APPROVED" | "PENDING" | "IN_REVIEW" | "REJECTED" | "PAUSED" | string;
+    category: "MARKETING" | "UTILITY" | string;
+    language: string;
+    components?: MetaTemplateComponent[];
+    [key: string]: any;
+}
+type WhatsAppData = any;
+interface WhatsAppComponentProps extends Partial<BaseComponentProps<WhatsAppData, WhatsAppConfig>> {
+    permissions?: ComponentPermissions;
+    orgId?: string;
+    organizationId?: string;
+}
+
+/**
+ * WhatsAppComponent
+ * High-level orchestrator for the WhatsApp messaging interface.
+ * Coordinates template selection, dynamic filters, recipient settings/actions,
+ * and the embedded data grid.
+ */
+declare function WhatsAppComponent(props: WhatsAppComponentProps): react_jsx_runtime.JSX.Element;
+
+interface CreateTemplateModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSuccess: () => void;
+    existingTemplateNames?: string[];
+    existingTemplates?: TemplateIdentity[];
+    executeAction?: (actionType: string, payload: Record<string, any>) => Promise<any>;
+    orgId?: string;
+}
+/**
+ * CreateTemplateModal
+ * Enterprise modal dialog for authoring and submitting WhatsApp message templates
+ * with atomic variable deletion, flexible editing, and strict word-to-variable ratio validation.
+ */
+declare function CreateTemplateModal({ isOpen, onClose, onSuccess, existingTemplateNames, existingTemplates, executeAction, orgId, }: CreateTemplateModalProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * UNIVERSE_COMPONENTS
- * Dynamic Component Registry dictionary mapping component type strings (e.g., "TABLE")
+ * Dynamic Component Registry dictionary mapping component type strings (e.g., "TABLE", "WHATSAPP")
  * to their respective React component implementation.
  */
 declare const UNIVERSE_COMPONENTS: {
     readonly TABLE: typeof TableBlock;
+    readonly WHATSAPP: typeof WhatsAppComponent;
 };
 type ComponentRegistry = typeof UNIVERSE_COMPONENTS;
 type UniverseComponentType = keyof ComponentRegistry;
@@ -295,4 +387,4 @@ declare function ToastProvider({ children }: {
 
 declare function useToast(): ToastContextType;
 
-export { type BaseComponentProps, ColumnHeaderTitle, type ColumnHeaderTitleProps, type ComponentCommunication, type ComponentConfig, type ComponentData, type ComponentPermissions, type ComponentRegistry, type ComponentState, type CreateRecordPayload, DatePickerCell, type DeleteRecordPayload, LinkPickerCell, type OrgRole, PASTEL_PALETTES, type PastelPalette, type RelationFilterOption, type RelationFilterPayload, RelationFilterPopover, type RelationFilterPopoverProps, RelationPickerCell, type RolePermissions, type SplitTitleResult, TableBlock, type TableBlockProps, type TableConfig, type TableData, TimePickerCell, ToastContext, type ToastContextType, type ToastItem, ToastProvider, UNIVERSE_COMPONENTS, type UniverseComponentType, type UpdateRecordPayload, type UseColumnReorderOptions, type UseColumnResizeOptions, calculateMinColumnWidth, cn, formatConflictCellValue, formatPhoneDisplay, formatTimeInput, formatTimeIso, getDeterministicPastelBadge, getRolePermissions, measureTextWidth, normalizeRelationValue, openWhatsAppChat, parseLinkValue, parseTimeParts, resolveProtocol, splitHeaderTitle, useColumnReorder, useColumnResize, useToast };
+export { type BaseComponentProps, ColumnHeaderTitle, type ColumnHeaderTitleProps, type ComponentCommunication, type ComponentConfig, type ComponentData, type ComponentPermissions, type ComponentRegistry, type ComponentState, type CreateRecordPayload, CreateTemplateModal, type CreateTemplateModalProps, DatePickerCell, type DeleteRecordPayload, LinkPickerCell, type MetaTemplateComponent, type MetaWhatsAppTemplate, type OrgRole, PASTEL_PALETTES, type PastelPalette, type RelationFilterOption, type RelationFilterPayload, RelationFilterPopover, type RelationFilterPopoverProps, RelationPickerCell, type RolePermissions, type RowStatusType, type SplitTitleResult, TableBlock, type TableBlockProps, type TableConfig, type TableData, TimePickerCell, ToastContext, type ToastContextType, type ToastItem, ToastProvider, UNIVERSE_COMPONENTS, type UniverseComponentType, type UpdateRecordPayload, type UseColumnReorderOptions, type UseColumnResizeOptions, WhatsAppComponent, type WhatsAppComponentProps, type WhatsAppData, calculateMinColumnWidth, cn, formatConflictCellValue, formatPhoneDisplay, formatTimeInput, formatTimeIso, generateWhatsAppLink, getDeterministicPastelBadge, getRolePermissions, isValidPhoneNumber, measureTextWidth, normalizePhoneForWhatsApp, normalizeRelationValue, openWhatsAppChat, parseLinkValue, parseTimeParts, resolveProtocol, sanitizePhoneNumber, splitHeaderTitle, useColumnReorder, useColumnResize, useToast };