@salsita-ai/sdk 0.0.0-stage → 0.49.0-develop.cbee856178

package/dist/ui-sdk/theme/types.d.ts

@@ -0,0 +1,213 @@
+import type { ButtonProps } from '@mui/material';
+import type { ComponentsOverrides, ComponentsVariants } from '@mui/material/styles';
+import type { PhxCardSelectorThemeableProps } from '../components/card-selector/CardSelectorItem.js';
+import type { FooterContainerOwnerState } from '../components/chat/InputFooter.js';
+import type { PhxDisabledOverlayThemeableProps } from '../components/disabled-overlay/DisabledOverlay.js';
+import type { PhxEntityHeaderThemeableProps } from '../components/entity-panel/EntityHeader.js';
+import type { ListSelectorRootProps, PhxListSelectorItemThemeableProps } from '../components/list-selector/ListSelector.js';
+import type { PhxNumericalInputThemeableProps } from '../components/numerical-input/InputField.js';
+import type { PhxPresetScreenThemeableProps } from '../components/preset/PresetScreenLayout.js';
+import type { PhxSidebarPanelThemeableProps } from '../components/sidebar/SidebarPanel.js';
+import type { SwatchSelectorItemProps } from '../components/swatch-selector/SwatchSelector.js';
+import type { PhxTextInputThemeableProps } from '../components/text-input/TextInput.js';
+import type { PhxToggleSelectorItemThemeableProps } from '../components/toggle-selector/ToggleSelectorItem.js';
+import type { PhxToggleSelectorRootThemeableProps } from '../components/toggle-selector/ToggleSelectorRoot.js';
+import type { PhxIconName } from '../icons/index.js';
+interface PhxToolbarUndoRedoThemeableProps {
+    showLabels: boolean;
+}
+interface PhxFinalizeButtonThemeableProps {
+    icon: PhxIconName;
+    iconPlacement: 'start' | 'end';
+    variant?: ButtonProps['variant'];
+    color?: ButtonProps['color'];
+}
+declare module '@mui/material/styles' {
+    interface TypeBackground {
+        scene: string;
+    }
+    interface Theme {
+        shape: {
+            borderRadius: number;
+            sidebarBorderRadius: number;
+        };
+    }
+    interface ThemeOptions {
+        shape?: {
+            borderRadius?: number;
+            sidebarBorderRadius?: number;
+        };
+    }
+    interface ComponentNameToClassKey {
+        PhxSidebarLayout: 'root' | 'aside' | 'panel' | 'chat';
+        PhxSidebarPanel: 'root' | 'padding' | 'footer';
+        PhxChat: 'root';
+        PhxChatFooter: 'root' | 'formLayout' | 'input';
+        PhxChatMessage: 'base' | 'assistant' | 'user' | 'widget' | 'error' | 'helper';
+        PhxTopNavigation: 'root' | 'stepper' | 'step';
+        PhxListSelector: 'root';
+        PhxListSelectorItem: 'root' | 'radio' | 'title' | 'description' | 'formControlLabel';
+        PhxInterfaceLayout: 'container';
+        PhxPreviewLayout: 'root' | 'body';
+        PhxSwatchSelectorRoot: 'layout';
+        PhxSwatchSelectorItem: 'root' | 'tooltip' | 'swatch';
+        PhxCardSelectorItem: 'root' | 'action' | 'header' | 'content' | 'image';
+        PhxToggleSelectorRoot: 'root';
+        PhxToggleSelectorItem: 'root' | 'button';
+        PhxDisabledOverlay: 'root' | 'iconContainer';
+        PhxPresetScreen: 'heading';
+        PhxDesktopToolbarRoot: 'root';
+        PhxDesktopToolbarButtonGroup: 'root' | 'divider';
+        PhxDesktopToolbarButton: 'root' | 'button' | 'title';
+        PhxDesktopToolbarPopper: 'popper';
+        PhxNumericalInput: 'layout' | 'inputField' | 'slider';
+        PhxTextInput: 'inputField';
+        PhxDryRunButton: 'root' | 'button';
+        PhxDesktopToolControls: 'root' | 'group';
+        PhxDesktopToolControlsItem: 'button';
+        PhxSketchingSceneButton: 'button';
+        PhxSketchingEditSceneButton: 'button';
+    }
+    interface ComponentsPropsList {
+        PhxChatFooter: Partial<FooterContainerOwnerState>;
+        PhxSwatchSelectorItem: Partial<SwatchSelectorItemProps>;
+        PhxListSelector: Partial<ListSelectorRootProps>;
+        PhxCardSelectorItem: Partial<PhxCardSelectorThemeableProps>;
+        PhxListSelectorItem: Partial<PhxListSelectorItemThemeableProps>;
+        PhxDisabledOverlay: Partial<PhxDisabledOverlayThemeableProps>;
+        PhxFinalizeButton: Partial<PhxFinalizeButtonThemeableProps>;
+        PhxToolbarUndoRedo: Partial<PhxToolbarUndoRedoThemeableProps>;
+        PhxSidebarPanel: Partial<PhxSidebarPanelThemeableProps>;
+        PhxToggleSelectorRoot: Partial<PhxToggleSelectorRootThemeableProps>;
+        PhxToggleSelectorItem: Partial<PhxToggleSelectorItemThemeableProps>;
+        PhxPresetScreen: Partial<PhxPresetScreenThemeableProps>;
+        PhxNumericalInput: Partial<PhxNumericalInputThemeableProps>;
+        PhxTextInput: Partial<PhxTextInputThemeableProps>;
+        PhxEntityHeader: Partial<PhxEntityHeaderThemeableProps>;
+    }
+    interface Components {
+        PhxSidebarLayout?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxSidebarLayout'];
+        };
+        PhxSidebarPanel?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxSidebarPanel'];
+            defaultProps?: ComponentsPropsList['PhxSidebarPanel'];
+        };
+        PhxInterfaceLayout?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxInterfaceLayout'];
+        };
+        PhxTopNavigation?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxTopNavigation'];
+        };
+        PhxChat?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxChat'];
+        };
+        PhxChatFooter?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxChatFooter'];
+            variants?: ComponentsVariants['PhxChatFooter'];
+        };
+        PhxChatMessage?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxChatMessage'];
+        };
+        PhxPreviewLayout?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxPreviewLayout'];
+        };
+        PhxListSelector?: {
+            defaultProps?: ComponentsPropsList['PhxListSelector'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxListSelector'];
+        };
+        PhxSwatchSelectorRoot?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxSwatchSelectorRoot'];
+        };
+        PhxSwatchSelectorItem?: {
+            defaultProps?: ComponentsPropsList['PhxSwatchSelectorItem'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxSwatchSelectorItem'];
+            variants?: ComponentsVariants['PhxSwatchSelectorItem'];
+        };
+        PhxListSelectorItem?: {
+            defaultProps?: ComponentsPropsList['PhxListSelectorItem'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxListSelectorItem'];
+            variants?: ComponentsVariants['PhxListSelectorItem'];
+        };
+        PhxCardSelectorItem?: {
+            defaultProps?: ComponentsPropsList['PhxCardSelectorItem'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxCardSelectorItem'];
+        };
+        PhxToggleSelectorRoot?: {
+            defaultProps?: ComponentsPropsList['PhxToggleSelectorRoot'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxToggleSelectorRoot'];
+        };
+        PhxToggleSelectorItem?: {
+            defaultProps?: ComponentsPropsList['PhxToggleSelectorItem'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxToggleSelectorItem'];
+        };
+        PhxDisabledOverlay?: {
+            defaultProps?: ComponentsPropsList['PhxDisabledOverlay'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxDisabledOverlay'];
+        };
+        PhxPresetScreen?: {
+            defaultProps?: ComponentsPropsList['PhxPresetScreen'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxPresetScreen'];
+        };
+        PhxNumericalInput?: {
+            defaultProps?: ComponentsPropsList['PhxNumericalInput'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxNumericalInput'];
+        };
+        PhxTextInput?: {
+            defaultProps?: ComponentsPropsList['PhxTextInput'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxTextInput'];
+        };
+        PhxEntityHeader?: {
+            defaultProps?: ComponentsPropsList['PhxEntityHeader'];
+        };
+        PhxDesktopToolbarRoot?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxDesktopToolbarRoot'];
+        };
+        PhxDesktopToolbarButtonGroup?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxDesktopToolbarButtonGroup'];
+        };
+        PhxDesktopToolbarButton?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxDesktopToolbarButton'];
+        };
+        PhxDesktopToolbarPopper?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxDesktopToolbarPopper'];
+        };
+        PhxFinalizeButton?: {
+            defaultProps?: ComponentsPropsList['PhxFinalizeButton'];
+        };
+        PhxToolbarUndoRedo?: {
+            defaultProps?: ComponentsPropsList['PhxToolbarUndoRedo'];
+        };
+        PhxDryRunButton?: {
+            defaultProps?: ComponentsPropsList['MuiButton'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxDryRunButton'];
+        };
+        PhxDesktopToolControls?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxDesktopToolControls'];
+        };
+        PhxDesktopToolControlsItem?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxDesktopToolControlsItem'];
+        };
+        PhxSpotlight?: {
+            defaultProps?: ComponentsPropsList['PhxSpotlight'];
+            styleOverrides?: ComponentsOverrides<Theme>['PhxSpotlight'];
+        };
+        PhxSketchingSceneButton?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxSketchingSceneButton'];
+        };
+        PhxSketchingEditSceneButton?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxSketchingEditSceneButton'];
+        };
+    }
+}
+declare module '@mui/material/styles' {
+    interface ComponentNameToClassKey {
+        PhxDesktopSidebarFooterButton: 'button';
+    }
+    interface Components {
+        PhxDesktopSidebarFooterButton?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxDesktopSidebarFooterButton'];
+        };
+    }
+}
+export {};

package/dist/ui-sdk/theme/types.js

@@ -0,0 +1 @@
+export{};

package/dist/ui-sdk/theme/typography.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Converts pixel values to rem units based on the theme's base font size.
+ *
+ * @param value - The value to convert (number for pixels, string values are returned as-is)
+ * @param baseFontSize - The base font size in pixels (default: 16)
+ * @returns The rem value as a string for numbers, or the original string for string inputs
+ *
+ * IMPORTANT: When using custom theme.typography.htmlFontSize, you MUST pass it as the
+ * baseFontSize parameter to ensure correct scaling. Example:
+ *
+ * // Theme with htmlFontSize: 10
+ * typography: {
+ *   htmlFontSize: 10,
+ *   h6: {
+ *     fontSize: pxToRem(16, 10),  // ✅ Correct: 16/10 = 1.6rem → 16px
+ *     // fontSize: pxToRem(16),   // ❌ Wrong: 16/16 = 1rem → 10px
+ *   }
+ * }
+ */
+export declare const pxToRem: (value: number | string, baseFontSize?: number) => string;

package/dist/ui-sdk/theme/typography.js

@@ -0,0 +1 @@
+export const pxToRem=(e,o=16)=>"string"==typeof e?e:`${e/o}rem`;

package/dist/ui-sdk/themes/balustrade-theme.d.ts

@@ -0,0 +1,2 @@
+import type { ThemeOptions } from '@mui/material';
+export declare const balustradeTheme: ThemeOptions;

package/dist/ui-sdk/themes/balustrade-theme.js

@@ -0,0 +1,7 @@
+import{avatarClasses as e}from"@mui/material";import{desktopStyles as o}from"../theme/index.js";let r=["none",`
+    0 2px 8px -1px hsl(from black h s l / 10%),
+    0 1px 4px -2px hsl(from black h s l / 10%)
+  `,...Array(23).fill("none")];export const balustradeTheme={components:{MuiButton:{styleOverrides:{root:{borderRadius:8,textTransform:"none"}}},MuiListItemAvatar:{styleOverrides:{root:({theme:{palette:o}})=>({minWidth:52,[`.${e.root}`]:{background:o.action.focus,borderRadius:16},[`.${e.img}`]:{blockSize:24,inlineSize:24}})}},MuiTextField:{defaultProps:{variant:"outlined"}},MuiOutlinedInput:{styleOverrides:{root:{borderRadius:8}}},PhxDesktopSidebar:{defaultProps:{filter:`
+          drop-shadow(0 2px 8px hsl(from black h s l / 5%))
+          drop-shadow(0 1px 4px hsl(from black h s l / 5%))
+        `}},PhxPropertyContainerItem:{styleOverrides:{content:({theme:{spacing:e}})=>({marginBlockStart:e(2)})}},PhxDesktopBrandingHeader:{defaultProps:{imageHeight:20,imageUrl:"/logos/logoipsum.svg"}},PhxDesktopBrandingPoweredBy:{defaultProps:{visible:!1}},PhxMobileBrandingHeader:{defaultProps:{imageHeight:20,imageUrl:"/logos/logoipsum.svg"}},PhxMobileBrandingPoweredBy:{defaultProps:{visible:!1}},PhxSceneFab:{defaultProps:{size:"medium"},styleOverrides:{fab:{borderRadius:16}}},PhxListSelectorItem:{styleOverrides:{root:{borderRadius:8,minBlockSize:0},formControlLabel:({theme:{spacing:e}})=>({paddingBlock:e(1)})}},PhxToggleSelectorRoot:{defaultProps:{columnCount:"auto-fit"}},PhxToggleSelectorItem:{styleOverrides:{button:{paddingBlock:8,"&:is(*, #chucknorris)":{borderRadius:8}}}},PhxSwitchSelector:{defaultProps:{compact:!0}}},palette:{background:{scene:"#F2F3F4",default:"#FBFBFB"},primary:{main:"#131E48",dark:"#081235",light:"#2F3E78"},secondary:{main:"#EB9B2D",dark:"#C37A16",light:"#EEAF57"}},shadows:r,shape:{borderRadius:16},typography:{fontFamily:'"Geist Variable", sans-serif',h4:{...o({fontWeight:500})},h5:{...o({fontWeight:500})},overline:{...o({letterSpacing:"0.083333em"})}}};

package/dist/ui-sdk/themes/branding-theme.d.ts

@@ -0,0 +1,2 @@
+import type { ThemeOptions } from '@mui/material';
+export declare const brandingTheme: ThemeOptions;

package/dist/ui-sdk/themes/branding-theme.js

@@ -0,0 +1 @@
+export const brandingTheme={components:{PhxBrandingHeader:{defaultProps:{imageHeight:20,imageUrl:"/logos/logoipsum.svg"}},PhxDesktopBrandingHeader:{defaultProps:{imageAlt:"Ipsum logo",imageHeight:20,imageUrl:"/logos/logoipsum.svg"}},PhxMobileBrandingHeader:{defaultProps:{imageAlt:"Ipsum logo",imageHeight:20,imageUrl:"/logos/logoipsum-mobile.svg"}}}};

package/dist/ui-sdk/themes/console-theme.d.ts

@@ -0,0 +1,2 @@
+import type { ThemeOptions } from '@mui/material';
+export declare const consoleTheme: ThemeOptions;

package/dist/ui-sdk/themes/console-theme.js

@@ -0,0 +1 @@
+import{desktopStyles as e}from"../theme/index.js";let t=Array.from({length:25},(e,t)=>1===t?"0px 4px 16px 0px #0000001F":"none");export const consoleTheme={components:{MuiButton:{styleOverrides:{root:{borderRadius:8}}},MuiPaper:{defaultProps:{elevation:1}},PhxTabNavigation:{defaultProps:{variant:"rounded"}}},palette:{background:{default:"#F3F3F3",scene:"#EEEEEE"},text:{primary:"#000000DE",secondary:"#00000099",disabled:"#00000061"},primary:{main:"#000000DE"},warning:{main:"#EF6C00"},action:{active:"#0000008F",disabled:"#00000061",disabledBackground:"#0000001F"}},shadows:t,shape:{borderRadius:8,sidebarBorderRadius:8},typography:{fontFamily:"Poppins, sans-serif",h5:{...e({fontSize:22,fontWeight:500})},h6:{...e({fontSize:18})},body1:{...e({letterSpacing:0})},body2:{...e({letterSpacing:0})},subtitle1:{...e({letterSpacing:0})},subtitle2:{...e({letterSpacing:0})},overline:{...e({letterSpacing:"0.083333em"})}}};

package/dist/ui-sdk/themes/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Collection of themes for use in Storybook only.
+ *
+ * These themes are intended for demonstration, visual testing, and component development within Storybook.
+ * They are not guaranteed to reflect production configurations and should not be used in runtime environments.
+ */
+export declare const getPhoenixThemes: () => {
+    Balustrade: import("@mui/material").Theme;
+    RoundedRed: import("@mui/material").Theme;
+    Console: import("@mui/material").Theme;
+    Kitchen: import("@mui/material").Theme;
+    MUI: import("@mui/material").Theme;
+    Padlock: import("@mui/material").Theme;
+    Phoenix: import("@mui/material").Theme;
+    PhoenixBranding: import("@mui/material").Theme;
+    Railing: import("@mui/material").Theme;
+    Vanity: import("@mui/material").Theme;
+    WallShelf: import("@mui/material").Theme;
+    WoodenTable: import("@mui/material").Theme;
+};

package/dist/ui-sdk/themes/index.js

@@ -0,0 +1 @@
+import{createTheme as e}from"@mui/material";import{memoOnce as o}from"@salsita-ai/common/utils";import{createScaledPhoenixTheme as m}from"../theme/index.js";import{balustradeTheme as t}from"./balustrade-theme.js";import{brandingTheme as r}from"./branding-theme.js";import{consoleTheme as i}from"./console-theme.js";import{kitchenTheme as n}from"./kitchen-theme.js";import{padlockTheme as s}from"./padlock-theme.js";import{pictureTheme as a}from"./picture-theme.js";import{railingTheme as h}from"./railing-theme.js";import{roundedRedTheme as l}from"./rounded-red-theme.js";import{wallShelfTheme as p}from"./wall-shelf-theme.js";import{woodenTableTheme as d}from"./wooden-table-theme.js";export const getPhoenixThemes=o(()=>({Balustrade:m(t),RoundedRed:m(l),Console:m(i),Kitchen:m(n),MUI:e(),Padlock:m(s),Phoenix:m(),PhoenixBranding:m(r),Railing:m(h),Vanity:m(a),WallShelf:m(p),WoodenTable:m(d)}));

package/dist/ui-sdk/themes/kitchen-theme.d.ts

@@ -0,0 +1,2 @@
+import type { ThemeOptions } from '@mui/material';
+export declare const kitchenTheme: ThemeOptions;

package/dist/ui-sdk/themes/kitchen-theme.js

@@ -0,0 +1 @@
+import{jsx as e}from"react/jsx-runtime";import{iconButtonClasses as t,listClasses as o,listItemAvatarClasses as r,listItemClasses as i,listItemSecondaryActionClasses as a,listItemTextClasses as n}from"@mui/material";import{PhxIcon as s}from"../icons/index.js";import{desktopStyles as l}from"../theme/index.js";export const kitchenTheme={components:{MuiAccordion:{defaultProps:{disableGutters:!0},styleOverrides:{root:{"&::before":{content:"none"}}}},MuiAccordionDetails:{styleOverrides:{root:({theme:{palette:e,spacing:s}})=>({padding:0,[`.${o.root}`]:{display:"grid",gap:s(.5),paddingBlock:s(1.5)},[`.${i.root}`]:{gap:s(1.5),"&[class]":{padding:`${s(.5)} ${s(1)}`}},[`.${r.root}`]:{minWidth:0},[`.${n.root}`]:{margin:0},[`.${a.root}`]:{"&[class][class]":{padding:0},[`.${t.root}`]:{blockSize:36,color:e.action.active,inlineSize:36}}})}},MuiAccordionSummary:{defaultProps:{expandIcon:e(s,{name:"CaretDown",fontSize:"small"})},styleOverrides:{root:({theme:{spacing:e}})=>({paddingInline:`${e(1)} ${e(2)}`,"& :empty":{margin:0}}),content:{margin:0}}},MuiButton:{defaultProps:{disableElevation:!0},styleOverrides:{root:({theme:{palette:e}})=>({variants:[{props:{variant:"contained",color:"primary"},style:{"&:is(:focus-visible, :hover)":{backgroundColor:e.primary.light}}}]})}},MuiPaper:{defaultProps:{elevation:0}},MuiTextField:{defaultProps:{variant:"outlined"}},PhxDesktopBrandingHeader:{defaultProps:{imageHeight:20,imageUrl:"/logos/logoipsum.svg"}},PhxCardSelectorItem:{styleOverrides:{header:{blockSize:72,padding:0},image:{blockSize:70,objectFit:"cover"}}},PhxDesktopToolbarButton:{styleOverrides:{button:({theme:{palette:e}})=>({color:e.primary.main})}},PhxMobileBrandingHeader:{defaultProps:{imageHeight:20,imageUrl:"/logos/logoipsum.svg"}},PhxPropertyContainerItem:{styleOverrides:{content:({theme:{spacing:e}})=>({marginBlockStart:e(2)})}},PhxSidebarPanel:{styleOverrides:{padding:{padding:20}}},PhxToggleSelectorRoot:{defaultProps:{columnCount:"auto-fit"}},PhxToggleSelectorItem:{styleOverrides:{button:({theme:{spacing:e}})=>({paddingBlock:e(1)})}},PhxTopNavigation:{styleOverrides:{root:()=>({justifyContent:"center"}),stepper:{maxWidth:856}}}},palette:{background:{default:"#F1F1F1",scene:"#EDEAE5"},primary:{main:"#0F0F0F"}},shape:{borderRadius:0},typography:{fontFamily:'"Urbanist Variable", sans-serif',h5:{...l({fontWeight:600})},h6:{...l({fontWeight:600})},body2:{...l({letterSpacing:"0.012143em"})},subtitle2:{...l({letterSpacing:"0.007143em"})},overline:{...l({letterSpacing:"0.083333em"})},caption:{...l({fontWeight:600})}}};

package/dist/ui-sdk/themes/padlock-theme.d.ts

@@ -0,0 +1,2 @@
+import type { ThemeOptions } from '@mui/material';
+export declare const padlockTheme: ThemeOptions;

package/dist/ui-sdk/themes/padlock-theme.js

@@ -0,0 +1 @@
+import{alpha as e}from"@mui/material";import{desktopStyles as t}from"../theme/index.js";export const padlockTheme={components:{MuiButton:{styleOverrides:{root:({theme:e})=>({paddingBlock:e.spacing(1.5),paddingInline:e.spacing(3)}),containedPrimary:({theme:e})=>({"&:hover":{backgroundColor:e.palette.primary.light}})},defaultProps:{disableElevation:!0}},MuiCardActions:{styleOverrides:{root:({theme:e})=>({padding:e.spacing(3),paddingTop:0})}},MuiCardContent:{styleOverrides:{root:({theme:e})=>({padding:e.spacing(4)})}},MuiCardMedia:{styleOverrides:{img:()=>({objectFit:"contain"})}},MuiPaper:{defaultProps:{elevation:0}},PhxDisabledOverlay:{styleOverrides:{iconContainer:{visibility:"hidden"}}},PhxEntityHeader:{defaultProps:{titleVariant:"h4"}},PhxPresetScreen:{defaultProps:{headingVariant:"h2"}},PhxSidebarPanel:{styleOverrides:{root:({theme:e})=>({backgroundColor:e.palette.background.default}),padding:({theme:e})=>({padding:e.spacing(2.5)}),footer:({theme:t})=>({boxShadow:`0px -1px 8px 0px ${e(t.palette.text.primary,.08)}`,backgroundColor:t.palette.background.paper})}},PhxTabNavigation:{styleOverrides:{root:({theme:e})=>({backgroundColor:e.palette.background.default})}}},palette:{background:{default:"#F7F7F7",scene:"#DEDEDE",paper:"#FFF"},primary:{main:e("#000",.87)},secondary:{main:e("#000",.6)},warning:{main:"#D32F2F"},action:{selected:"#000"}},shape:{borderRadius:0,sidebarBorderRadius:0},typography:{fontFamily:'"Futura BT", sans-serif',fontSize:16,fontWeightRegular:400,h4:{...t({fontSize:"1.875rem",fontWeight:700,lineHeight:"2.3rem",letterSpacing:"0.25px"})},h6:{...t({fontSize:"1.25rem",fontWeight:700,lineHeight:"1.75rem",letterSpacing:"0.15px"})},body1:{...t({fontSize:"1rem",fontWeight:400,lineHeight:"1.4rem",letterSpacing:"0.15px"})},body2:{...t({fontSize:"0.875rem",fontWeight:400,lineHeight:"1.25rem",letterSpacing:"0.17px"})},caption:{...t({fontSize:"0.75rem",fontWeight:400,lineHeight:"0.975rem",letterSpacing:"0.1px"})}}};

package/dist/ui-sdk/themes/picture-theme.d.ts

@@ -0,0 +1,2 @@
+import type { ThemeOptions } from '@mui/material';
+export declare const pictureTheme: ThemeOptions;

package/dist/ui-sdk/themes/picture-theme.js

@@ -0,0 +1,7 @@
+import{typographyClasses as e}from"@mui/material";import{desktopStyles as o}from"../theme/index.js";let r=["none",`
+    0 2px 8px -1px hsl(from black h s l / 10%),
+    0 1px 4px -2px hsl(from black h s l / 10%)
+  `,...Array(23).fill("none")];export const pictureTheme={components:{MuiCard:{defaultProps:{elevation:0}},MuiCardContent:{styleOverrides:{root:({theme:{palette:o}})=>({borderBlockStart:`1px solid ${o.divider}`,[`.${e.body1}`]:{display:"block"}})}},MuiCardMedia:{styleOverrides:{img:{objectFit:"contain",maxWidth:"100%"}}},PhxDesktopBrandingHeader:{defaultProps:{imageHeight:20,imageUrl:"/logos/logoipsum.svg"}},PhxDesktopSidebar:{defaultProps:{filter:`
+          drop-shadow(0 2px 8px hsl(from black h s l / 5%))
+          drop-shadow(0 1px 4px hsl(from black h s l / 5%))
+        `}},PhxMobileBrandingHeader:{defaultProps:{imageHeight:20,imageUrl:"/logos/logoipsum.svg"}},PhxSwatchSelectorItem:{defaultProps:{variant:"square"}},PhxTabNavigation:{defaultProps:{variant:"rounded"}}},palette:{background:{default:"#F8F8F8",scene:"#FFF"},primary:{main:"#000"}},shadows:r,shape:{borderRadius:0},typography:{fontFamily:'"Futura", sans-serif',h5:{...o({fontWeight:500})},h6:{...o({fontSize:18})},body2:{...o({letterSpacing:"0.012143em"})},overline:{...o({letterSpacing:"0.083333em"})}}};

package/dist/ui-sdk/themes/railing-theme.d.ts

@@ -0,0 +1,2 @@
+import type { ThemeOptions } from '@mui/material';
+export declare const railingTheme: ThemeOptions;

package/dist/ui-sdk/themes/railing-theme.js

@@ -0,0 +1 @@
+import{toggleButtonClasses as e}from"@mui/material";import{desktopStyles as t}from"../theme/index.js";export const railingTheme={components:{MuiButton:{styleOverrides:{root:({theme:e})=>({borderRadius:0,paddingBlock:e.spacing(1.5),paddingInline:e.spacing(3)}),containedPrimary:({theme:e})=>({"&:hover":{backgroundColor:e.palette.primary.light}})},defaultProps:{disableElevation:!0}},MuiCardContent:{styleOverrides:{root:({theme:e})=>({padding:e.spacing(4)})}},MuiCardActions:{styleOverrides:{root:({theme:e})=>({padding:e.spacing(3),paddingTop:0})}},MuiIconButton:{defaultProps:{color:"primary"}},MuiLink:{styleOverrides:{root:{textUnderlinePosition:"under",textDecorationThickness:"2px"}}},MuiPaper:{styleOverrides:{root:{borderRadius:0}},defaultProps:{elevation:0}},MuiStepConnector:{styleOverrides:{line:({theme:e})=>({borderColor:e.palette.primary.main})}},MuiStepLabel:{styleOverrides:{label:{fontSize:"0.9375rem"}}},PhxFinalizeButton:{defaultProps:{icon:"ArrowRight",iconPlacement:"end"}},PhxListSelector:{defaultProps:{itemVariant:"containedStrong"}},PhxListSelectorItem:{defaultProps:{variant:"containedStrong"},styleOverrides:{root:{borderRadius:0}}},PhxSidebarPanel:{styleOverrides:{padding:({theme:e})=>({paddingBlock:e.spacing(2)})},defaultProps:{footerProps:{dividerVariant:"none"}}},PhxToggleSelectorItem:{defaultProps:{variant:"containedStrong"},styleOverrides:{button:()=>({[`&.${e.root}`]:{borderRadius:0}})}},PhxToolbarUndoRedo:{defaultProps:{showLabels:!0}},PhxTopNavigation:{styleOverrides:{root:()=>({justifyContent:"center"}),stepper:{maxWidth:722}}}},palette:{primary:{main:"#131415"},action:{selected:"#131415"},background:{scene:"#EDEDED",default:"#EDEDED"},warning:{main:"#D32F2F"}},shape:{sidebarBorderRadius:0},typography:{fontFamily:'"Futura BT", sans-serif',fontSize:16,fontWeightRegular:400,h2:{...t({fontSize:"3.875rem"})},h4:{...t({fontSize:"2.25rem",fontWeight:700})},h5:{...t({fontSize:"1.625rem",fontWeight:500})},body1:{...t({fontSize:"1.1875rem"})},subtitle1:{...t({fontWeight:500})}}};

package/dist/ui-sdk/themes/rounded-red-theme.d.ts

@@ -0,0 +1,2 @@
+import type { ThemeOptions } from '@mui/material';
+export declare const roundedRedTheme: ThemeOptions;

package/dist/ui-sdk/themes/rounded-red-theme.js

@@ -0,0 +1 @@
+import{alpha as e}from"@mui/material";import{desktopStyles as r}from"../theme/index.js";export const roundedRedTheme={components:{MuiButton:{styleOverrides:{root:{borderRadius:"calc(infinity * 1px)"}},defaultProps:{disableElevation:!0}},MuiCard:{styleOverrides:{root:({theme:e})=>({"&.CardSelectorItem-selected":{outline:"2px solid",outlineColor:e.palette.primary.main,color:e.palette.primary.main},borderRadius:e.spacing(1),borderWidth:0,backgroundColor:e.palette.background.default,boxShadow:"0px 2px 16.9px 0px rgba(0, 0, 0, 0.09)"})},defaultProps:{variant:"outlined"}},MuiDialog:{styleOverrides:{paper:({theme:e})=>({borderRadius:e.shape.sidebarBorderRadius})}},MuiDialogActions:{styleOverrides:{root:({theme:e})=>({padding:e.spacing(2)})}},MuiBottomNavigation:{styleOverrides:{root:({theme:e})=>({backgroundColor:e.palette.background.default})}},MuiBottomNavigationAction:{styleOverrides:{root:({theme:r,ownerState:a})=>({...a.selected?{backgroundColor:e(r.palette.primary.main,.09)}:{}})}},MuiPaper:{defaultProps:{elevation:0}},PhxSidebarPanel:{styleOverrides:{padding:({theme:e})=>({paddingBlock:e.spacing(3),paddingInline:e.spacing(3)})}},PhxSwatchSelectorItem:{defaultProps:{variant:"rounded"}}},palette:{background:{default:"#FAFBFC",scene:"#F4F4F4"},primary:{main:"#E93335"}},shape:{sidebarBorderRadius:10},typography:{fontFamily:"Barlow, sans-serif",h5:{...r({fontWeight:600})},subtitle1:{...r({fontWeight:500})}}};

package/dist/ui-sdk/themes/wall-shelf-theme.d.ts

@@ -0,0 +1,2 @@
+import type { ThemeOptions } from '@mui/material';
+export declare const wallShelfTheme: ThemeOptions;

package/dist/ui-sdk/themes/wall-shelf-theme.js

@@ -0,0 +1 @@
+import{buttonClasses as e}from"@mui/material";import{desktopStyles as o}from"../theme/index.js";export const wallShelfTheme={components:{MuiButton:{styleOverrides:{root:{borderRadius:12,textTransform:"none",[`&.${e.sizeLarge}`]:{borderRadius:16}}}},MuiListSubheader:{styleOverrides:{root:({theme:{typography:e}})=>({...e.overline})}},PhxDesktopBrandingHeader:{defaultProps:{imageHeight:20,imageUrl:"/logos/logoipsum.svg"}},PhxDesktopBackButton:{defaultProps:{kind:"iconButton",size:"medium"},styleOverrides:{button:({theme:{shadows:e}})=>({backgrounfColor:"white",boxShadow:e[1]})}},PhxDesktopSidebarFooterButton:{styleOverrides:{button:{svg:{display:"none"}}}},PhxDesktopToolbarButtonGroup:{styleOverrides:{root:{borderRadius:"calc(Infinity * 1px)"}}},PhxDryRunButton:{defaultProps:{color:"inherit",fullWidth:!0,variant:"contained"},styleOverrides:{button:({theme:{palette:o}})=>({whiteSpace:"nowrap",[`&.${e.containedInherit}`]:{backgroundColor:"white","&:where(:hover, :focus-visible)":{backgroundColor:"hsl(from white h s l / 88%)"}},[`&.${e.containedError}`]:{backgroundColor:"white",color:o.error.main,"&:where(:hover, :focus-visible)":{backgroundColor:"hsl(from white h s l / 88%)"}},[`&.${e.disabled}`]:{backgroundColor:"#D0D0D0",color:"hsl(from black h s l / 38%)"}})}},PhxMobileBrandingHeader:{defaultProps:{imageHeight:20,imageUrl:"/logos/logoipsum.svg"}},PhxSceneFab:{defaultProps:{color:"secondary"}},PhxSwatchSelectorItem:{defaultProps:{variant:"rounded"}}},palette:{background:{default:"#F7F8F6",scene:"#F8F8F6"},primary:{main:"#69A2FF",dark:"#5293FF",light:"#8AB6FF",contrastText:"#FFFFFF"},secondary:{main:"#0B2341",dark:"#05101F",light:"#133D71"},error:{main:"#E3274C",dark:"#CB1A3E",light:"#E95371"}},shape:{borderRadius:16},typography:{fontFamily:'"Haffer XH", sans-serif',h5:{fontSize:20,...o({fontWeight:500,letterSpacing:"-0.041667em"})},h6:{fontSize:16,letterSpacing:0,...o({fontSize:18,letterSpacing:0})},body1:{...o({letterSpacing:0})},body2:{...o({letterSpacing:0})},subtitle1:{...o({letterSpacing:0})},subtitle2:{...o({letterSpacing:0})},overline:{...o({letterSpacing:"0.083333em"})}}};

package/dist/ui-sdk/themes/wooden-table-theme.d.ts

@@ -0,0 +1,2 @@
+import type { ThemeOptions } from '@mui/material';
+export declare const woodenTableTheme: ThemeOptions;

package/dist/ui-sdk/themes/wooden-table-theme.js

@@ -0,0 +1 @@
+import{alpha as e,paperClasses as r}from"@mui/material";import{desktopStyles as o}from"../theme/index.js";export const woodenTableTheme={components:{MuiButton:{styleOverrides:{root:()=>({borderRadius:0})},defaultProps:{disableElevation:!0}},MuiDrawer:{styleOverrides:{root:({theme:e})=>({[`& .${r.root}`]:{borderRadius:e.shape.sidebarBorderRadius,border:"none",boxShadow:e.shadows[0]}})}},MuiFab:{styleOverrides:{root:({theme:e})=>({borderRadius:e.spacing(0),boxShadow:e.shadows[0]})}},MuiPaper:{styleOverrides:{root:{borderRadius:0}},defaultProps:{elevation:0}},PhxChat:{styleOverrides:{root:()=>({backgroundColor:"#F7F7F7"})}},PhxChatFooter:{styleOverrides:{root:({ownerState:e})=>({..."mobile"===e.variant&&{marginTop:0}}),formLayout:()=>({borderRadius:0})}},PhxChatMessage:{styleOverrides:{user:({theme:e})=>({backgroundColor:e.palette.secondary.main}),assistant:({theme:e})=>({backgroundColor:e.palette.background.scene})}},PhxDisabledOverlay:{defaultProps:{icon:"Lock",placement:"center"}},PhxPropertyContainerItem:{styleOverrides:{content:({theme:e})=>({marginTop:e.spacing(2)})}},PhxSidebarPanel:{styleOverrides:{padding:({theme:e})=>({padding:e.spacing(2.5),backgroundColor:"#F7F7F7"})}}},palette:{background:{scene:"#EBEBEB"},primary:{main:"#000"},secondary:{main:"#C89415"},info:{main:"#E1F1FF"},error:{main:"#FE8A7E"},warning:{main:"#FEEBD6"},success:{main:"#EAF6CF"},action:{selected:e("#000",.04),selectedOpacity:.04}},shape:{sidebarBorderRadius:0},typography:{fontFamily:"Poppins, sans-serif",h4:{...o({fontSize:"1.75rem",fontWeight:600,lineHeight:1.2})},h5:{...o({fontSize:"1.5rem",fontWeight:600,lineHeight:1.2})},h6:{...o({fontSize:"1.25rem",fontWeight:500,lineHeight:1.3})},body2:{...o({lineHeight:1.25,fontWeight:400,letterSpacing:"0.17px"})}}};

package/dist/watch/dev-local.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/watch/dev-local.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+let e,o,r;import s from"lodash-es/debounce.js";import{spawn as l}from"node:child_process";import{watch as t}from"./watch.js";let i=process.argv.slice(2),n=()=>{let e=l("vite",["--force",...i],{stdio:"inherit"});return e.on("close",e=>{null!==e&&0!==e&&console.log(`Vite process exited with code ${e}`)}),e};e=null,o=s(()=>{console.log("Files changed, restarting vite..."),e&&e.kill(),e=n()},1e3),(r=t("../../node_modules/@salsita-ai/**/dist/**/*.js",{persistent:!0})).on("ready",()=>{e=n()}).on("change",()=>{o()}).on("error",e=>{console.error(`Watcher error: ${e}`)}),process.on("SIGINT",()=>{e&&e.kill(),r.close().then(()=>process.exit(0))});

package/dist/watch/glob-matcher.d.ts

@@ -0,0 +1,49 @@
+import type { Stats } from 'node:fs';
+interface PathOperations {
+    readonly relative: (from: string, to: string) => string;
+    readonly sep: string;
+}
+/**
+ * Build a chokidar v4 `ignored` callback from include + exclude glob arrays.
+ *
+ * Internal helper for {@link watch | the watch shim} in `./watch.ts`. Not part of the
+ * public surface — consumers pass glob strings to `watch(...)` and this conversion
+ * happens inside the shim.
+ *
+ * Returned predicate semantics:
+ * - excludes are checked first against every path (file or directory). Patterns ending in
+ *   `/**` are auto-expanded to also match the bare directory form so chokidar prunes the
+ *   subtree instead of walking it.
+ * - for directories, includes are not applied — chokidar must descend to find matching files.
+ * - for files (or when stats is unavailable), includes are required when non-empty.
+ */
+export declare const createWatchIgnoreMatcher: (params: {
+    readonly includes?: readonly string[];
+    readonly excludes?: readonly string[];
+    /**
+     * If set, absolute paths passed to the predicate are converted to paths relative to
+     * this directory before being matched. Chokidar v4 passes absolute paths to `ignored`
+     * even when `cwd` is set, but the include/exclude globs in this codebase are written
+     * relative to the project root — this option bridges that.
+     */
+    readonly cwd?: string;
+    /** Path operations seam for exercising native Windows path behavior on any platform. */
+    readonly pathOperations?: PathOperations;
+}) => ((path: string, stats?: Stats) => boolean);
+/**
+ * Derive a concrete watch root from a glob.
+ *
+ * `spec/**\/*.{yaml,yml}` → `spec`
+ * `domain/sub/**\/*.yaml` → `domain/sub`
+ * `**\/*.yaml`            → `.`
+ * `foo.yaml`              → `foo.yaml`
+ */
+export declare const deriveWatchRoot: (glob: string) => string;
+export declare const containsGlob: (s: string) => boolean;
+/**
+ * Globs with `**` traverse subdirectories and need a base-dir + recursive watcher.
+ * Globs without `**` (e.g. `*.env*`, `../.env*`) only match a fixed depth — those can
+ * be resolved concretely at startup.
+ */
+export declare const isRecursiveGlob: (g: string) => boolean;
+export {};

package/dist/watch/glob-matcher.js

@@ -0,0 +1 @@
+import*as t from"node:path";import e from"picomatch";export const createWatchIgnoreMatcher=o=>{let{includes:r=[],excludes:n=[],cwd:l,pathOperations:s=t}=o,i=r.length>0?e([...r]):null,c=n.length>0?e((t=>{let e=[];for(let o of t)e.push(o),o.endsWith("/**")&&e.push(o.slice(0,-3));return e})(n)):null;return(t,e)=>{let o,r=(""===(o=l?s.relative(l,t):t)?".":o).split(s.sep).join("/");return!!c?.(r)||!!e&&!!e.isFile()&&!(!i||i(r))}};export const deriveWatchRoot=t=>{let e=t.split("/"),o=e.findIndex(t=>/[*?[{]/.test(t));return -1===o?t:0===o?".":e.slice(0,o).join("/")};let o=/[*?[{]/;export const containsGlob=t=>o.test(t);export const isRecursiveGlob=t=>t.includes("**");

package/dist/watch/index.d.ts

@@ -0,0 +1 @@
+export { type FSWatcher, type WatchOptions, watch } from './watch.js';

package/dist/watch/index.js

@@ -0,0 +1 @@
+export{watch}from"./watch.js";

package/dist/watch/watch.d.ts

@@ -0,0 +1,36 @@
+import { type FSWatcher } from 'chokidar';
+/**
+ * chokidar v3-style options accepted by {@link watch}. Globs are accepted in both
+ * `paths` (the first arg) and `ignored`, matching the chokidar 3.x API.
+ */
+export interface WatchOptions {
+    readonly ignored?: string | readonly string[];
+    readonly cwd?: string;
+    readonly persistent?: boolean;
+    readonly ignoreInitial?: boolean;
+    /** Force polling instead of native fs events. Primarily for tests. */
+    readonly usePolling?: boolean;
+    readonly interval?: number;
+}
+/**
+ * Watch files/directories with the chokidar v3 calling convention — accepts glob
+ * strings for both `paths` and `ignored`.
+ *
+ * Backed by chokidar v4 internally (v4 dropped glob support; this shim restores it).
+ * Each input glob is classified:
+ *
+ * - **Concrete path** (no glob chars): added to watch roots as-is.
+ * - **Recursive glob** (contains `**`): the prefix is used as the watch root, the full
+ *   pattern stays as an include filter so new files matching the glob still trigger events.
+ *   Example: `spec/**\/*.{yaml,yml}` → watches `spec/`, filters to `*.yaml`/`*.yml`.
+ * - **Non-recursive glob** (e.g. `../.env*`, `*.ts`): the prefix is used as the watch
+ *   root, the full pattern stays as an include filter so new files matching the glob
+ *   still trigger events.
+ *
+ * Watch roots that don't exist at call time are dropped silently (chokidar v4 emits
+ * `error` events for missing paths otherwise).
+ *
+ * Returns chokidar's `FSWatcher` — the `.on()` / `.close()` event API is unchanged.
+ */
+export declare const watch: (paths: string | readonly string[], options?: WatchOptions) => FSWatcher;
+export type { FSWatcher };

package/dist/watch/watch.js

@@ -0,0 +1 @@
+import{watch as e}from"chokidar";import{statSync as t}from"node:fs";import{resolve as r}from"node:path";import{containsGlob as o,createWatchIgnoreMatcher as n,deriveWatchRoot as i,isRecursiveGlob as l}from"./glob-matcher.js";export const watch=(d,f)=>{let a=f?.cwd??process.cwd(),h=f?.ignored==null?[]:"string"==typeof f.ignored?[f.ignored]:f.ignored,p=[],g=[],c=new Set;for(let e of"string"==typeof d?[d]:d){if(!o(e)){t(r(a,e),{throwIfNoEntry:!1})&&(c.add(e),g.push(e));continue}if(!l(e)){p.push(e);let o=i(e);t(r(a,o),{throwIfNoEntry:!1})&&c.add(o);continue}p.push(e);let n=i(e);t(r(a,n),{throwIfNoEntry:!1})&&c.add(n)}if(p.length>0)for(let e of g){let o=t(r(a,e),{throwIfNoEntry:!1});p.push(o?.isDirectory()?`${e}/**/*`:e)}let u=[...c];return 0===u.length?s():e(u,{cwd:a,persistent:f?.persistent,ignoreInitial:f?.ignoreInitial,usePolling:f?.usePolling,interval:f?.interval,ignored:n({includes:p.length>0?p:void 0,excludes:h,cwd:a})})};let s=()=>{let t=e([],{persistent:!1});return setImmediate(()=>t.emit("ready")),t};

package/dist/webhook/backend-data-handler.d.ts

@@ -0,0 +1,7 @@
+import type { APIGatewayProxyEventV2 } from 'aws-lambda';
+import type { Logger } from '@salsita-ai/common/utils';
+import type { FetchBackendDataHandlerResponse, FetchBackendDataPayload } from '@salsita-ai/contracts/webhook';
+export interface FetchBackendDataHandlerContext {
+    logger: Logger;
+}
+export type FetchBackendDataHandler<SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>> = (data: FetchBackendDataPayload<SESSION_DATA, FRONTEND_DATA>, ctx: FetchBackendDataHandlerContext, e: APIGatewayProxyEventV2) => Promise<FetchBackendDataHandlerResponse>;

package/dist/webhook/backend-data-handler.js

@@ -0,0 +1 @@
+export{};

package/dist/webhook/builders/admin-finalize-handler-builder.d.ts

@@ -0,0 +1,16 @@
+import type { APIGatewayProxyEventV2 } from 'aws-lambda';
+import type { Logger } from '@salsita-ai/common/utils';
+import { type FinalizeWebhookPayload, type WebhookFinalizeTaskConfiguration } from '@salsita-ai/contracts/webhook';
+import { type $DomainEntity, type DomainEntity } from '#package/domain';
+import type { BuilderDomainContext } from './common.js';
+interface AdminFinalizeHandlerContext {
+    logger: Logger;
+}
+export type AdminFinalizeHandler<ADMIN_ENTITIES extends DomainEntity<string>> = (body: FinalizeWebhookPayload<never, ADMIN_ENTITIES, Record<string, unknown>, Record<string, unknown>>, ctx: AdminFinalizeHandlerContext, e: APIGatewayProxyEventV2) => Promise<WebhookFinalizeTaskConfiguration>;
+export declare class AdminFinalizeHandlerBuilder<ENTITIES extends DomainEntity<string> = never, ALLOWED_ROOT_ENTITIES extends ENTITIES = never, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>> = never, NAVIGATION_STATES extends string = never, VIEW_STATES extends string = never, TOOL_STATES extends string = never, EXPORT_STATES extends string = never, PUBLISHED_DATA extends Record<string, unknown> = never, SESSION_DATA extends Record<string, unknown> = never, FRONTEND_DATA extends Record<string, unknown> = never, ADMIN_ENTITIES extends DomainEntity<string> = never, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES = never, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>> = never, ADMIN_NAVIGATION_STATES extends string = never, ADMIN_VIEW_STATES extends string = never, FINALIZE_DATA extends Record<string, unknown> = never, PREFETCHED_FINALIZE_DATA extends Record<string, unknown> = never, FINALIZE_RESULT extends Record<string, unknown> = never, CALLBACK_DATA extends Record<string, unknown> = never, RESOURCE extends string = never> {
+    private readonly _context;
+    constructor(_context: BuilderDomainContext<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES, FINALIZE_DATA, PREFETCHED_FINALIZE_DATA, FINALIZE_RESULT, CALLBACK_DATA, RESOURCE>);
+    build(): AdminFinalizeHandler<ADMIN_ENTITIES>;
+    private readonly _fetchConnectedSheetData;
+}
+export {};

package/dist/webhook/builders/admin-finalize-handler-builder.js

@@ -0,0 +1 @@
+import{ChunkKey as e,ChunkScope as t}from"@salsita-ai/contracts/domain";import{createPublishRevisionTask as a,getSpreadsheetAdapter as i}from"@salsita-ai/contracts/webhook";import{ConnectedDataConfig as r,NoopAnalyticsSystem as n,createDomainRuntime as o,createFinalizeAdminDomain as s,mapPublishedChunkedData as d,mapPublishedData as c}from"#package/domain";import{createPublishRevisionChunksTaskForWebhook as l}from"./create-publish-revision-chunks-task.js";export class AdminFinalizeHandlerBuilder{_context;constructor(e){this._context=e}build(){return async(i,r)=>{let{entities:h,revisionId:u,rootEntityType:p}=i,{logger:f}=r,b=this._context.configuratorBuilder.buildWebhookContext(),{config:m}=b,{chunks:v,dataSpec:k}=m,{domainFactory:y}=m.adminDomain,g=o({config:m,services:{analyticsService:new n,i18n:this._context.createI18n(),logger:f}});if(v&&Object.keys(v).length>0){let a,{publishedDataHash:r}=m;if(!r)throw Error("publishedDataHash is missing from webhook context but is required for chunked published data revisions. This value is generated during codegen — run `phoenix generate` to regenerate application-types.ts with the PublishedDataHash constant.");let n=await this._fetchConnectedSheetData(i,f),{domain:o,state:c}=s({adminDomainFactory:y,domainRuntime:g,rootEntityType:p,entities:h});if(b.mapPublishedChunkedData){let e=o.getRoot$Entity(c);a=b.mapPublishedChunkedData({entities:c.entities,adminEntity:e,connectedSheetData:n})}let w=d(c.entities,k??{},v,n,a,{rowValidator:b.dataRowValidator,sheetValidator:b.sheetValidator}),x=Object.entries(v).map(([a,i])=>({key:e(a),scope:t(i.scope),data:w[a]??{}}));return{dataVersion:1,tasks:[await l({revisionId:u,chunks:x,publishedDataHash:r,chunksUploadUrl:i.chunksUploadUrl},{logger:f})],resources:[]}}return{dataVersion:1,tasks:[a({type:"PublishRevision",version:1,revisionId:u,data:c(y,g,b.mapPublishedRevisionData??(()=>({})),p,h)})],resources:[]}}}_fetchConnectedSheetData=async(e,t)=>{let{connectedProviderAccessTokens:a}=e;if(!a)return void t.warn("Connected data are not being fetched because no connected provider access tokens found!");let n=e.entities.filter(e=>r.is(e));if(0===n.length)return void t.debug("No connected data configs found!");let o={};for(let e of n){let r=a[e.provider];if(!r)throw Error(`No access token for provider "${e.provider}" (data entry: ${e.dataEntryKey})`);t.info("Fetching connected sheet data",{dataEntryKey:e.dataEntryKey,provider:e.provider});let n=i(e.provider);o[e.dataEntryKey]=await n.fetchData(r,{fileId:e.externalFileId,driveId:e.driveId},e.tabSelection,e.headerRowIndex)}return o}}

package/dist/webhook/builders/auth-handler-builder.d.ts

@@ -0,0 +1,43 @@
+import type { APIGatewayProxyEventV2 } from 'aws-lambda';
+import type { Logger } from '@salsita-ai/common/utils';
+import { type SessionRole } from '@salsita-ai/contracts/api';
+import { type AnonymousPayload, type AuthHandlerResponse, type CodePayload, type RefreshPayload } from '@salsita-ai/contracts/webhook';
+import type { $DomainEntity, DomainEntity } from '#package/domain';
+import { type BuilderDomainContext } from './common.js';
+export interface AuthHandlerContext {
+    logger: Logger;
+}
+export type AuthHandler<SESSION_DATA extends Record<string, unknown>> = (body: unknown, ctx: AuthHandlerContext, e: APIGatewayProxyEventV2) => Promise<AuthHandlerResponse<SESSION_DATA>>;
+export declare class AuthHandlerBuilder<ENTITIES extends DomainEntity<string> = never, ALLOWED_ROOT_ENTITIES extends ENTITIES = never, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>> = never, NAVIGATION_STATES extends string = never, VIEW_STATES extends string = never, TOOL_STATES extends string = never, EXPORT_STATES extends string = never, PUBLISHED_DATA extends Record<string, unknown> = never, SESSION_DATA extends Record<string, unknown> = never, FRONTEND_DATA extends Record<string, unknown> = never, ADMIN_ENTITIES extends DomainEntity<string> = never, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES = never, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>> = never, ADMIN_NAVIGATION_STATES extends string = never, ADMIN_VIEW_STATES extends string = never, FINALIZE_DATA extends Record<string, unknown> = never, PREFETCHED_FINALIZE_DATA extends Record<string, unknown> = never, FINALIZE_RESULT extends Record<string, unknown> = never, CALLBACK_DATA extends Record<string, unknown> = never, RESOURCE extends string = never> {
+    private readonly _context;
+    private readonly _handlers?;
+    private readonly _clerkTokenService?;
+    constructor(_context: BuilderDomainContext<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES, FINALIZE_DATA, PREFETCHED_FINALIZE_DATA, FINALIZE_RESULT, CALLBACK_DATA, RESOURCE>, _handlers?: {
+        onClerkCode?: (data: CodePayload, ctx: AuthHandlerContext) => Promise<AuthHandlerResponse<SESSION_DATA>>;
+        onClerkSession?: (data: CodePayload, ctx: AuthHandlerContext) => Promise<AuthHandlerResponse<SESSION_DATA>>;
+        onClerkRefresh?: (data: RefreshPayload, ctx: AuthHandlerContext) => Promise<AuthHandlerResponse<SESSION_DATA>>;
+        onCode?: (data: CodePayload, ctx: AuthHandlerContext) => Promise<AuthHandlerResponse<SESSION_DATA>>;
+        onRefresh?: (data: RefreshPayload, ctx: AuthHandlerContext) => Promise<AuthHandlerResponse<SESSION_DATA>>;
+        onAnonymous?: (data: AnonymousPayload, ctx: AuthHandlerContext) => Promise<AuthHandlerResponse<SESSION_DATA>>;
+        scopeResolver?: (params: {
+            readonly role: SessionRole;
+            readonly data: SESSION_DATA;
+        }) => readonly string[];
+    } | undefined);
+    private _isClerkIdToken;
+    private _isClerkRefreshToken;
+    private handleAnonymous;
+    private handleCode;
+    private handleRefresh;
+    withCodeHandler(handler: (data: CodePayload, ctx: AuthHandlerContext) => Promise<AuthHandlerResponse<SESSION_DATA>>): AuthHandlerBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES, FINALIZE_DATA, PREFETCHED_FINALIZE_DATA, FINALIZE_RESULT, CALLBACK_DATA, RESOURCE>;
+    withClerkCodeHandler(): AuthHandlerBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES, FINALIZE_DATA, PREFETCHED_FINALIZE_DATA, FINALIZE_RESULT, CALLBACK_DATA, RESOURCE>;
+    withClerkSessionHandler(): AuthHandlerBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES, FINALIZE_DATA, PREFETCHED_FINALIZE_DATA, FINALIZE_RESULT, CALLBACK_DATA, RESOURCE>;
+    withRefreshHandler(handler: (data: RefreshPayload, ctx: AuthHandlerContext) => Promise<AuthHandlerResponse<SESSION_DATA>>): AuthHandlerBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES, FINALIZE_DATA, PREFETCHED_FINALIZE_DATA, FINALIZE_RESULT, CALLBACK_DATA, RESOURCE>;
+    withClerkRefreshHandler(): AuthHandlerBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES, FINALIZE_DATA, PREFETCHED_FINALIZE_DATA, FINALIZE_RESULT, CALLBACK_DATA, RESOURCE>;
+    withAnonymousHandler(handler: (data: AnonymousPayload, ctx: AuthHandlerContext) => Promise<AuthHandlerResponse<SESSION_DATA>>): AuthHandlerBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES, FINALIZE_DATA, PREFETCHED_FINALIZE_DATA, FINALIZE_RESULT, CALLBACK_DATA, RESOURCE>;
+    withPublishedChunkScopes(resolver: (params: {
+        readonly role: SessionRole;
+        readonly data: SESSION_DATA;
+    }) => readonly string[]): AuthHandlerBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES, FINALIZE_DATA, PREFETCHED_FINALIZE_DATA, FINALIZE_RESULT, CALLBACK_DATA, RESOURCE>;
+    build(): AuthHandler<SESSION_DATA>;
+}

package/dist/webhook/builders/auth-handler-builder.js

@@ -0,0 +1 @@
+import{match as e}from"ts-pattern";import{ClerkTokenService as r,isClerkSessionToken as o}from"@salsita-ai/contracts/clerk";import{AuthPayload as s}from"@salsita-ai/contracts/webhook";import{SYSTEM_CHUNK_SCOPE as n}from"#package/domain";import{createClerkAuthCodeHandler as t}from"./clerk-auth-handlers/clerk-code-handler.js";import{createClerkRefreshHandler as i}from"./clerk-auth-handlers/clerk-refresh-handler.js";import{createClerkSessionHandler as h}from"./clerk-auth-handlers/clerk-session-handler.js";export class AuthHandlerBuilder{_context;_handlers;_clerkTokenService;constructor(e,o){this._context=e,this._handlers=o,e.clerk&&(this._clerkTokenService=new r(e.clerk.apiKey))}_isClerkIdToken(e){let r;if(!this._clerkTokenService)throw Error("Clerk token service is not configured!");try{r=this._clerkTokenService.parseIdToken(e)}catch(e){return!1}return r.iss.replace(/\/$/,"")===this._context.clerk?.oauthProviderBaseUrl.replace(/\/$/,"")}_isClerkRefreshToken(e){if(!this._clerkTokenService)throw Error("Clerk token service is not configured!");try{this._clerkTokenService.parseRefreshToken(e)}catch(e){return!1}return!0}async handleAnonymous(e,r){if(!this._handlers?.onAnonymous)throw Error("Can not authorize anonymous request, the anonymous handler is not configured!");return r.logger.debug("Anonymous flow."),{response:await this._handlers.onAnonymous(e,r),userIdSource:"custom"}}async handleCode(e,r){if(this._handlers?.onClerkCode&&e.idToken&&this._isClerkIdToken(e.idToken))return r.logger.debug("Clerk code flow."),{response:await this._handlers.onClerkCode(e,r),userIdSource:"clerk"};if(this._handlers?.onClerkSession&&!e.idToken&&this._context.clerk&&o(e.accessToken,this._context.clerk.oauthProviderBaseUrl))return r.logger.debug("Clerk session flow."),{response:await this._handlers.onClerkSession(e,r),userIdSource:"clerk"};if(this._handlers?.onCode)return r.logger.debug("Custom code flow."),{response:await this._handlers.onCode(e,r),userIdSource:"custom"};throw Error("Can not authorize code request, the code handler is not configured!")}async handleRefresh(e,r){if(this._handlers?.onClerkRefresh&&this._isClerkRefreshToken(e.refreshToken))return r.logger.debug("Clerk refresh flow."),{response:await this._handlers.onClerkRefresh(e,r),userIdSource:"clerk"};if(this._handlers?.onRefresh)return r.logger.debug("Custom refresh flow."),{response:await this._handlers.onRefresh(e,r),userIdSource:"custom"};throw Error("Refresh handler is not configured!")}withCodeHandler(e){if(this._handlers?.onCode)throw Error("Code handler is already configured!");return new AuthHandlerBuilder(this._context,{...this._handlers,onCode:e})}withClerkCodeHandler(){if(this._handlers?.onClerkCode)throw Error("Clerk code handler is already configured!");if(!this._context.clerk)throw Error("Clerk context is not configured!");let e=t(this._context.clerk);return new AuthHandlerBuilder(this._context,{...this._handlers,onClerkCode:e})}withClerkSessionHandler(){if(this._handlers?.onClerkSession)throw Error("Clerk session handler is already configured!");if(!this._context.clerk)throw Error("Clerk context is not configured!");let{authorizedParties:e}=this._context.clerk;if(!e||0===e.length)throw Error("Clerk session handler authorized parties are not configured!");let r=h({...this._context.clerk,authorizedParties:e});return new AuthHandlerBuilder(this._context,{...this._handlers,onClerkSession:r})}withRefreshHandler(e){if(this._handlers?.onRefresh)throw Error("Refresh handler is already configured!");return new AuthHandlerBuilder(this._context,{...this._handlers,onRefresh:e})}withClerkRefreshHandler(){if(this._handlers?.onClerkRefresh)throw Error("Clerk refresh handler is already configured!");if(!this._context.clerk)throw Error("Clerk context is not configured!");let e=i(this._context.clerk);return new AuthHandlerBuilder(this._context,{...this._handlers,onClerkRefresh:e})}withAnonymousHandler(e){if(this._handlers?.onAnonymous)throw Error("Anonymous handler is already configured!");return new AuthHandlerBuilder(this._context,{...this._handlers,onAnonymous:e})}withPublishedChunkScopes(e){if(this._handlers?.scopeResolver)throw Error("Published chunk scopes resolver is already configured!");return new AuthHandlerBuilder(this._context,{...this._handlers,scopeResolver:e})}build(){return async(r,o)=>{let t=s.parse(r),{response:i,userIdSource:h}=await e(t).with({type:"code"},e=>this.handleCode(e,o)).with({type:"refresh"},e=>this.handleRefresh(e,o)).with({type:"anonymous"},e=>this.handleAnonymous(e,o)).exhaustive(),l=this._context.configuratorBuilder.buildWebhookContext();if(!i.success)return{success:!1};{let e=l.config.domain.domainFactory.parseSessionData(i.data),r=this._handlers?.scopeResolver?this._handlers.scopeResolver({role:i.role,data:e}):[];return{success:i.success,data:e,role:i.role,refreshToken:i.refreshToken,expirationTime:i.expirationTime,scopes:[...new Set([...r,n])],userId:i.userId,userIdSource:h}}}}}