@salsita-ai/sdk 0.50.0-develop.f42416a4e6 → 0.50.0-develop.f81ab6ac76

package/dist/react-sdk/domain-context/system-hooks/navigation-hooks.js

@@ -1 +1 @@
-import{useCallback as t}from"react";import{useDomain as e}from"../common-hooks/use-domain-context.js";import{useStoreSelector as o}from"../common-hooks/use-store-selector.js";export const useActiveNavigationState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveNavigationState(e.state),[t])};export const useActiveViewState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveViewState(e.state),[t])};export const useActiveToolState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveToolState(e.state),[t])};export const useIsFullscreenActive=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveFullscreenState(e.state),[t])};export const useDraggedDomainEntityId=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveDragState(e.state),[t])};export const useActiveViewports=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveViewportState(e.state),[t])};export const useNavigate=()=>{let{storeSystem:o,navigationSystem:a}=e();return t(t=>{o.stageAndCommit([a.getNavigationUpdate(t)])},[o,a])};export const usePushNavigate=()=>{let{storeSystem:o,navigationSystem:a}=e();return t(t=>{o.stageAndCommit([a.getPushNavigationUpdate(t,o.stateSlices.committed.value.state)])},[o,a])};export const usePopNavigate=()=>{let{storeSystem:o,navigationSystem:a}=e();return t(()=>{let t=a.getPopNavigationUpdate(o.stateSlices.committed.value.state);t&&o.stageAndCommit([t])},[o,a])};
+import{useCallback as t}from"react";import{useDomain as e}from"../common-hooks/use-domain-context.js";import{useStoreSelector as o}from"../common-hooks/use-store-selector.js";export const useActiveNavigationState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveNavigationState(e.state),[t])};export const useActiveViewState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveViewState(e.state),[t])};export const useSetViewState=()=>{let{storeSystem:o,navigationSystem:s}=e();return t(t=>{o.stageAndCommit([s.getViewUpdate(t)])},[o,s])};export const useActiveToolState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveToolState(e.state),[t])};export const useIsFullscreenActive=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveFullscreenState(e.state),[t])};export const useSetFullscreen=()=>{let{storeSystem:o,navigationSystem:s}=e();return t(t=>{o.stageAndCommit([s.getFullscreenUpdate(t)])},[o,s])};export const useDraggedDomainEntityId=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveDragState(e.state),[t])};export const useActiveViewports=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveViewportState(e.state),[t])};export const useNavigate=()=>{let{storeSystem:o,navigationSystem:s}=e();return t(t=>{o.stageAndCommit([s.getNavigationUpdate(t)])},[o,s])};export const usePushNavigate=()=>{let{storeSystem:o,navigationSystem:s}=e();return t(t=>{o.stageAndCommit([s.getPushNavigationUpdate(t,o.stateSlices.committed.value.state)])},[o,s])};export const usePopNavigate=()=>{let{storeSystem:o,navigationSystem:s}=e();return t(()=>{let t=s.getPopNavigationUpdate(o.stateSlices.committed.value.state);t&&o.stageAndCommit([t])},[o,s])};

package/dist/react-sdk/domain-context/system-hooks/tab-navigation-hooks.d.ts

@@ -0,0 +1,61 @@
+import { type ReactNode } from 'react';
+import { type DomainEntityId } from '#package/domain';
+/**
+ * The spec component a layout's tabs come from: the `sidebarTabs` of an entity, or the configurator's
+ * `horizontalTabs`.
+ */
+export type TabSource = 'sidebarTabs' | 'horizontalTabs';
+/**
+ * One tab of the spec, ready to render.
+ */
+export interface TabEntry<NAVIGATION_STATE extends string = string> {
+    /** Position of the tab in `tabs`; what `select` takes */
+    readonly index: number;
+    /** The tab's label, resolved for the active locale */
+    readonly label: string;
+    /** A PhxIcon name, when the spec gives the icon as a string */
+    readonly icon: string | undefined;
+    /** A React node, when TypeScript spec code gives the icon as one (`sidebarTabs` only) */
+    readonly iconNode: ReactNode | undefined;
+    /** The tab's navigation states; the tab is active while one of them is */
+    readonly navigationStates: readonly NAVIGATION_STATE[];
+    /** `navigationStates[0]`, the state `select` enters */
+    readonly state: NAVIGATION_STATE;
+    readonly isActive: boolean;
+}
+/**
+ * Which tabs `useTabNavigation` reads.
+ * - `source`: `'auto'` (default) reads the entity's `sidebarTabs` and, without any, the `horizontalTabs`.
+ * - `entityId`: whose `sidebarTabs` are read; the selected entity by default (the root while nothing is selected).
+ */
+export interface UseTabNavigationOptions {
+    readonly source?: 'auto' | TabSource;
+    readonly entityId?: DomainEntityId<string>;
+}
+/**
+ * The tabs of the spec and the means to switch between them.
+ * - `source`: the component the tabs come from, or `null` when no active instance of it exists.
+ * - `tabs`: the tabs in spec order. `activeTab`: the first tab whose navigation states include the active one.
+ * - `select`: enters a tab, given by its index or by any of its navigation states; an unknown tab does nothing.
+ */
+export interface UseTabNavigationResult<NAVIGATION_STATE extends string = string> {
+    readonly source: TabSource | null;
+    readonly tabs: readonly TabEntry<NAVIGATION_STATE>[];
+    readonly activeTab: TabEntry<NAVIGATION_STATE> | null;
+    readonly select: (tab: number | NAVIGATION_STATE) => void;
+}
+export type UseTabNavigation<NAVIGATION_STATE extends string> = (options?: UseTabNavigationOptions) => UseTabNavigationResult<NAVIGATION_STATE>;
+/**
+ * Hook to read the tabs the spec declares, `sidebarTabs` or `horizontalTabs`, and to switch between them, as the
+ * built-in tabs do.
+ * - `sidebarTabs`: every active instance on the entity, flattened in spec order. `horizontalTabs`: the first active
+ *   instance, on any entity.
+ * - With `source: 'auto'` and both kinds active, `sidebarTabs` win; several active `horizontalTabs` use the first.
+ *   Both log a warning in development and never throw.
+ * - A tab without navigation states cannot be entered and is left out, with a warning in development.
+ * - `select` enters the tab's first navigation state. For `horizontalTabs` it pushes the analytics event the
+ *   built-in horizontal tabs push; for `sidebarTabs` none, as the built-in sidebar tabs.
+ *
+ * It does not check read mode: switching tabs is navigation, not editing.
+ */
+export declare const useTabNavigation: (options?: UseTabNavigationOptions) => UseTabNavigationResult;

package/dist/react-sdk/domain-context/system-hooks/tab-navigation-hooks.js

@@ -0,0 +1 @@
+import{useCallback as t,useEffect as o,useMemo as a}from"react";import{horizontalTabsComponent as e,sidebarTabsComponent as i}from"#package/domain";import{FrontendAnalyticsFactory as n,useAnalyticsService as s,useIsDev as r}from"../../application-runtime/index.js";import{useResolveLocalizable as l}from"../../localizable/index.js";import{useDomain as m}from"../common-hooks/use-domain-context.js";import{useComponents as c}from"../component-hooks/use-component.js";import{useActiveNavigationState as p}from"./navigation-hooks.js";import{useSelectedDomainEntityId as b}from"./selection-hooks.js";let h=(t,a)=>{let e=r();o(()=>{e&&t&&console.warn(a)},[e,t,a])};export const useTabNavigation=(o={})=>{let{source:r="auto",entityId:v}=o,g=p(),d=b(),f=l(),u=s(),{navigationSystem:T,storeSystem:z}=m(),S=c({componentTypes:[i],entityIds:[v??d]}),j=c({componentTypes:[e]}),N="horizontalTabs"!==r&&S.length>0,k="sidebarTabs"!==r&&j.length>0,y=N?"sidebarTabs":k?"horizontalTabs":null;h(N&&k,"Both sidebarTabs and horizontalTabs are active, so useTabNavigation shows the sidebarTabs. Remove one of them from the spec, or pass `source` to choose."),h("horizontalTabs"===y&&j.length>1,"Several horizontalTabs are active, so useTabNavigation shows the first one. Keep one active, for example with $filter.");let x=a(()=>"sidebarTabs"===y?S.flatMap(t=>t.state.tabs):"horizontalTabs"===y?j[0]?.state.tabs??[]:[],[y,S,j]),w=x.filter(t=>0===t.navigationStates.length);h(w.length>0,`The ${y} tabs ${w.map(t=>`"${f(t.label)}"`).join(", ")} have no navigation states, so useTabNavigation leaves them out. Give each tab at least one navigation state.`);let $=a(()=>x.flatMap(t=>{let o=t.navigationStates[0];return void 0===o?[]:[{tab:t,state:o}]}).map(({tab:t,state:o},a)=>({index:a,label:f(t.label),icon:"string"==typeof t.icon?t.icon:void 0,iconNode:"string"==typeof t.icon||null===t.icon?void 0:t.icon,navigationStates:t.navigationStates,state:o,isActive:t.navigationStates.includes(g)})),[x,g,f]),A=$.find(t=>t.isActive)??null,C=t(t=>{let o="number"==typeof t?$[t]:$.find(o=>o.navigationStates.includes(t));o&&("horizontalTabs"===y&&u.push(n.TopNavigationStepClicked(o.state)),z.stageAndCommit([T.getNavigationUpdate(o.state)]))},[$,y,u,z,T]);return{source:y,tabs:$,activeTab:A,select:C}};

package/dist/react-sdk/domain-context/system-hooks/undo-redo-hooks.d.ts

@@ -0,0 +1,20 @@
+/**
+ * What a project layout needs to offer undo and redo.
+ * - `canUndo` and `canRedo`: whether the undo history has a step to go back or forward to; they follow every change.
+ * - `undo`: returns to the previous step and pushes the undo-button analytics event; does nothing while `canUndo`
+ *   is false.
+ * - `redo`: returns to the next step and pushes the redo-button analytics event; does nothing while `canRedo` is
+ *   false.
+ */
+export interface UseUndoRedoResult {
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    readonly undo: () => void;
+    readonly redo: () => void;
+}
+export type UseUndoRedo = () => UseUndoRedoResult;
+/**
+ * Hook to undo and redo changes of the configuration, as the built-in toolbar's undo and redo buttons do. It does
+ * not check read mode; a layout hides undo and redo for a viewer.
+ */
+export declare const useUndoRedo: UseUndoRedo;

package/dist/react-sdk/domain-context/system-hooks/undo-redo-hooks.js

@@ -0,0 +1 @@
+import{useCallback as o}from"react";import{FrontendAnalyticsFactory as e,useAnalyticsService as n}from"../../application-runtime/index.js";import{useDomain as t}from"../common-hooks/use-domain-context.js";import{useEagerObservableValue as r}from"../common-hooks/use-observable-selector.js";export const useUndoRedo=()=>{let d=n(),{undoSystem:m}=t(),{canUndo:s,canRedo:c}=r(m.can$);return{canUndo:s,canRedo:c,undo:o(()=>{m.canUndo()&&(d.push(e.UndoButtonClicked()),m.undo())},[d,m]),redo:o(()=>{m.canRedo()&&(d.push(e.RedoButtonClicked()),m.redo())},[d,m])}};

package/dist/react-sdk/domain-controls/hooks/use-angle-dimension.d.ts

@@ -2,7 +2,7 @@ import { type AnalyticsEvent, type AngleDimensionComponent, AngleUnit, type Comp
 export declare const AngleDimensionSliderUpdateTag = "setAngleDimension";
 export type IsAngleDimensionUpdate<ENTITIES extends DomainEntity<string>> = (update: StateUpdate<ENTITIES, ENTITIES>, types: ReadonlyArray<ENTITIES['type']>, instanceName: string) => update is ComponentModification<AngleDimensionComponent>;
 export declare const isAngleDimensionUpdate: (update: StateUpdate<DomainEntity<string>, DomainEntity<string>>, types: readonly string[], instanceName: string) => update is ComponentModification<AngleDimensionComponent>;
-export declare const useAngleDimension: (entityId: DomainEntityId<string>, instanceName: string, fixableViolations?: string[], createAnalyticsEvent?: (instanceName: string, entityId: DomainEntityId<string>, value: number) => AnalyticsEvent, stageOnUpdate?: boolean) => {
+export declare const useAngleDimension: (entityId: DomainEntityId<string>, instanceName: string, fixableViolations?: readonly string[], createAnalyticsEvent?: (instanceName: string, entityId: DomainEntityId<string>, value: number) => AnalyticsEvent, stageOnUpdate?: boolean) => {
     value: number;
     min: number | undefined;
     max: number | undefined;

package/dist/react-sdk/handlers/index.d.ts

@@ -1,2 +1,3 @@
 export { usePhoenixHandler, useSystemPhoenixHandler, useSystemPhoenixAsyncHandler } from './PhoenixHandler.js';
 export { PhoenixHandlerBoundary } from './PhoenixHandlerBoundary.js';
+export { type UseFinalizeAction, type UseFinalizeActionResult, useFinalizeAction } from './use-finalize-action.js';

package/dist/react-sdk/handlers/index.js

@@ -1 +1 @@
-export{usePhoenixHandler,useSystemPhoenixHandler,useSystemPhoenixAsyncHandler}from"./PhoenixHandler.js";export{PhoenixHandlerBoundary}from"./PhoenixHandlerBoundary.js";
+export{usePhoenixHandler,useSystemPhoenixHandler,useSystemPhoenixAsyncHandler}from"./PhoenixHandler.js";export{PhoenixHandlerBoundary}from"./PhoenixHandlerBoundary.js";export{useFinalizeAction}from"./use-finalize-action.js";

package/dist/react-sdk/handlers/use-finalize-action.d.ts

@@ -0,0 +1,31 @@
+/**
+ * What a project layout needs to show and run one `finalizeAction` of the spec.
+ * - `run`: pushes the finalize-button analytics event, then runs the action's handler. Does nothing while
+ *   `disabled` or `isPending`.
+ * - `isPending`: the handler is running.
+ * - `error`: what the handler's last run rejected with, `null` after a run that resolved and while a new run is
+ *   pending. A rejection that is not an `Error` is wrapped in one, with the rejected value as its `cause`. No snackbar
+ *   is raised; the layout shows it its own way.
+ * - `disabled` and `hints`: from `useFinalizeViolations()`; the configuration cannot be finalized while it has
+ *   a `warning` or worse, or while it is out of sync with the server, and `hints` says why.
+ *
+ * `isPending` and `error` belong to the mounted component: when it unmounts during a run, the handler keeps
+ * running, and a component mounted afterwards starts with `isPending` false and no `error`.
+ */
+export interface UseFinalizeActionResult {
+    readonly run: () => void;
+    readonly isPending: boolean;
+    readonly error: Error | null;
+    readonly disabled: boolean;
+    readonly hints: string | undefined;
+}
+export type UseFinalizeAction = (handler: string) => UseFinalizeActionResult;
+/**
+ * Runs the project handler a `finalizeAction` component names, with the state a finalize button shows.
+ *
+ * It calls `usePhoenixHandler(handler)`, which calls the project's handler factory and the hooks inside it, so:
+ * call it once per component, never in a loop or conditionally, render one component per action, and wrap that
+ * component in `<PhoenixHandlerBoundary name={handler}>` from `@salsita-ai/sdk/react`, so an edited handler takes
+ * effect without a reload. It does not check read mode; a layout hides finalization for a viewer.
+ */
+export declare const useFinalizeAction: UseFinalizeAction;

package/dist/react-sdk/handlers/use-finalize-action.js

@@ -0,0 +1 @@
+import{useMutation as r}from"@tanstack/react-query";import{useCallback as e,useRef as n}from"react";import{FrontendAnalyticsFactory as t,useAnalyticsService as o,useLogger as i}from"../application-runtime/index.js";import{useFinalizeViolations as a}from"../domain-context/index.js";import{usePhoenixHandler as c}from"./PhoenixHandler.js";export const useFinalizeAction=l=>{let{handler:m}=c(l),s=o(),u=i(),{disabled:f,hints:d}=a(),p=n(!1),{mutate:h,isPending:x,error:y}=r({mutationFn:async()=>{try{await m()}catch(r){throw r instanceof Error?r:Error(null==r?"The finalize handler failed without a reason.":String(r),{cause:r})}finally{p.current=!1}},onError:r=>{u.error("Failed to finalize",{error:r.message})}});return{run:e(()=>{f||p.current||(p.current=!0,s.push(t.FinalizeButtonClicked()),h())},[s,f,h]),isPending:x,error:y,disabled:f,hints:d}};

package/dist/react-sdk/session/NotAuthenticatedPage.d.ts

@@ -1,4 +1,8 @@
 import { type PhoenixLayoutElementRegistration } from '#package/domain';
 export declare const createNotAuthenticatedPage: (Element: () => JSX.Element) => PhoenixLayoutElementRegistration;
 export type CreateNotAuthenticatedPage = (Element: () => JSX.Element) => PhoenixLayoutElementRegistration;
+/**
+ * Renders the `NotAuthenticatedPage` element. Its default, the configurator's built-in page, comes from
+ * `defaultConfiguratorElements`; a project element registered under the name replaces it.
+ */
 export declare const NotAuthenticatedPage: () => import("react/jsx-runtime").JSX.Element;

package/dist/react-sdk/session/NotAuthenticatedPage.js

@@ -1 +1 @@
-import{jsx as t}from"react/jsx-runtime";import{createCustomPhoenixLayoutElement as e}from"#package/domain";import{PhoenixLayoutElement as o}from"../elements/index.js";import{ConfigurationNotFoundPage as a}from"./ConfigurationNotFoundPage.js";let r="NotAuthenticatedPage";export const createNotAuthenticatedPage=t=>e(r,t);let n=()=>t(a,{});export const NotAuthenticatedPage=()=>t(o,{name:r,elementProps:{},defaultSlot:n});
+import{jsx as e}from"react/jsx-runtime";import{createCustomPhoenixLayoutElement as t}from"#package/domain";import{PhoenixLayoutElement as o}from"../elements/index.js";let a="NotAuthenticatedPage";export const createNotAuthenticatedPage=e=>t(a,e);export const NotAuthenticatedPage=()=>e(o,{name:a,elementProps:{}});

package/dist/ui-sdk/common/use-viewport-size.d.ts

@@ -13,8 +13,11 @@ export declare const getViewportSize: () => Size;
  * Returns the viewport size. This can also be used as a dependency in a
  * useEffect to trigger an update when the browser resizes.
  *
+ * @param subscriptionActive if `false`, the viewport is neither measured nor followed, and the size
+ * returned is the last one measured, if any (useful for optimization)
+ *
  * @see https://martijnhols.nl/gists/how-to-get-document-height-ios-safari-osk
  * @todo: investigate if this can use `viewport$`
  */
-export declare const useViewportSize: () => Size | undefined;
+export declare const useViewportSize: (subscriptionActive?: boolean) => Size | undefined;
 export {};

package/dist/ui-sdk/common/use-viewport-size.js

@@ -1 +1 @@
-import{useCallback as e,useEffect as i,useLayoutEffect as t,useState as n}from"react";let o="u">typeof window?t:()=>{};export const getViewportSize=()=>window.visualViewport?[window.visualViewport.width,window.visualViewport.height]:[window.innerWidth,window.innerHeight];export const useViewportSize=()=>{let[t,r]=n(),w=e(()=>{let e=getViewportSize();r(i=>i&&i[0]===e[0]&&i[1]===e[1]?i:e)},[]);return o(w,[w]),i(()=>{let e=()=>{w(),setTimeout(w,1e3)};return window.addEventListener("resize",e),window.addEventListener("orientationchange",e),window.visualViewport?.addEventListener("resize",e),()=>{window.removeEventListener("resize",e),window.removeEventListener("orientationchange",e),window.visualViewport?.removeEventListener("resize",e)}},[w]),t};
+import{useCallback as e,useEffect as i,useLayoutEffect as t,useState as n}from"react";let r="u">typeof window?t:()=>{};export const getViewportSize=()=>window.visualViewport?[window.visualViewport.width,window.visualViewport.height]:[window.innerWidth,window.innerHeight];export const useViewportSize=(t=!0)=>{let[o,w]=n(),d=e(()=>{let e=getViewportSize();w(i=>i&&i[0]===e[0]&&i[1]===e[1]?i:e)},[]);return r(()=>{t&&d()},[t,d]),i(()=>{if(!t)return;let e=()=>{d(),setTimeout(d,1e3)};return window.addEventListener("resize",e),window.addEventListener("orientationchange",e),window.visualViewport?.addEventListener("resize",e),()=>{window.removeEventListener("resize",e),window.removeEventListener("orientationchange",e),window.visualViewport?.removeEventListener("resize",e)}},[t,d]),o};

package/dist/ui-sdk/components/mobile-controls/index.d.ts

@@ -1 +1 @@
-export { MobileControls, type MobileControlsLayoutProps, type MobileControlsThemeableProps } from './MobileControls.js';
+export { MobileControls, type MobileControlsLayoutProps, type MobileControlsThemeableProps, type ViewOnlyModeProps, } from './MobileControls.js';

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

@@ -44,7 +44,7 @@ declare module '@mui/material/styles' {
         PhxChat: 'root';
         PhxChatFooter: 'root' | 'formLayout' | 'input';
         PhxChatMessage: 'base' | 'assistant' | 'user' | 'widget' | 'error' | 'helper';
-        PhxAssistantPanel: 'root' | 'header' | 'title' | 'closeButton' | 'thread' | 'greeting' | 'messages' | 'userMessage' | 'assistantMessage' | 'chips' | 'activity' | 'activityIcon' | 'chip' | 'status' | 'notice' | 'newReplyButton' | 'composer' | 'inputFrame' | 'input' | 'sendButton' | 'stopButton' | 'hint';
+        PhxAssistantPanel: 'root' | 'header' | 'title' | 'closeButton' | 'thread' | 'greeting' | 'messages' | 'userMessage' | 'assistantMessage' | 'entityLink' | 'referenceLink' | 'referenceDetails' | 'image' | 'form' | 'formGroup' | 'formGroupLabel' | 'formOptions' | 'formOptionsLabel' | 'formOptionsRow' | 'formReply' | 'formText' | 'formTextInput' | 'formSubmit' | 'formNote' | 'chips' | 'activity' | 'activityIcon' | 'chip' | 'undoButton' | 'status' | 'separator' | 'earlierButton' | 'notice' | 'newReplyButton' | 'composer' | 'inputFrame' | 'input' | 'sendButton' | 'stopButton' | 'hint';
         PhxTopNavigation: 'root' | 'stepper' | 'step';
         PhxListSelector: 'root';
         PhxListSelectorItem: 'root' | 'radio' | 'title' | 'description' | 'formControlLabel';

package/dist/webhook/builders/common.d.ts

@@ -1,4 +1,5 @@
 import type { I18n } from '@lingui/core';
+import type { DeploymentAssistant } from '@salsita-ai/contracts/assistant';
 import type { $DomainEntity, ConfiguratorBuilder, DomainEntity } from '#package/domain';
 export interface ClerkConfig {
     apiKey: string;
@@ -11,6 +12,13 @@ export interface ClerkConfig {
 }
 export interface BuilderDomainContext<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> {
     configuratorBuilder: ConfiguratorBuilder<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>;
+    /** Server-only settings supplied by the generated webhook bundle. */
+    assistantServerSettings?: Pick<DeploymentAssistant, 'instructions' | 'ai'> | null;
+    /**
+     * Asks a development environment to lock an assistant thread when the setup changes, as every
+     * other environment does. The generated webhook bundle sets it from `ASSISTANT_STRICT_THREADS`.
+     */
+    assistantStrictThreads?: boolean;
     createI18n: () => I18n;
     clerk?: ClerkConfig;
 }

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

@@ -1,4 +1,4 @@
-import type { $DomainEntity, DomainEntity } from '#package/domain';
+import { type $DomainEntity, type DomainEntity } from '#package/domain';
 import type { FetchBackendDataHandler } from '../backend-data-handler.js';
 import { type AuthHandler, AuthHandlerBuilder } from './auth-handler-builder.js';
 import { CallbackBuilder } from './callback-builder.js';

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

@@ -1 +1 @@
-import{initConsoleLogger as e}from"@salsita-ai/common/utils";import{routeWebhookRequests as n}from"@salsita-ai/contracts/webhook";import{AdminFinalizeHandlerBuilder as o}from"./admin-finalize-handler-builder.js";import{AuthHandlerBuilder as t}from"./auth-handler-builder.js";import{CallbackBuilder as i}from"./callback-builder.js";import{ConfiguratorFinalizeHandlerBuilder as a}from"./configurator-finalize-handler-builder.js";import{DynamicResourcesFactory as r}from"./dynamic-resources-factory.js";import{PrefetchBuilder as s}from"./prefetch-builder.js";import{TaskFactory as l}from"./task-factory.js";export class WebhookBuilder{_context;_handlers;constructor(e,n){this._context=e,this._handlers=n}withAuthHook(e){return new WebhookBuilder(this._context,{...this._handlers,onAuth:e})}withConfiguratorFinalize(e){return new WebhookBuilder(this._context,{...this._handlers,...e})}withFetchBackendData(e){return new WebhookBuilder(this._context,{...this._handlers,onFetchBackendData:e})}build(){if(!this._handlers)throw Error("Can not build webhook without any handlers! It would be very dumb!");let t=e(),i=new o(this._context).build();return n({onAuth:void 0!==this._handlers.onAuth?(e,n)=>this._handlers.onAuth(e,{logger:t},n):void 0,admin:{onFinalize:(e,n)=>i(e,{logger:t},n)},configurator:{onFetchBackendData:this._handlers.onFetchBackendData?(e,n)=>this._handlers.onFetchBackendData(e,{logger:t},n):void 0,onFinalize:this._handlers.onFinalize?async(e,n)=>{let o=await this._handlers?.onFetchBackendData?.({deploymentId:e.deploymentId,frontendUrl:e.frontendUrl,frontendData:e.frontendData,sessionRole:e.sessionRole,sessionPayload:e.sessionPayload,publishedAdminRevisionPath:e.publishedAdminRevisionPath,publishedChunkUrls:e.publishedChunkUrls},{logger:t},n);return this._handlers.onFinalize({deploymentId:e.deploymentId,frontendUrl:e.frontendUrl,frontendData:e.frontendData,sessionRole:e.sessionRole,sessionPayload:e.sessionPayload,publishedAdminRevisionPath:e.publishedAdminRevisionPath,publishedChunkUrls:e.publishedChunkUrls,data:e.data,locale:e.locale,configurationId:e.configurationId,entities:e.entities,modelVersion:e.modelVersion,revisionId:e.revisionId,rootEntityType:e.rootEntityType,backendData:o?.backendData},{logger:t},n)}:void 0,onCallback:this._handlers.onCallback?(e,n)=>this._handlers.onCallback(e,{logger:t},n):void 0}},t)}}export const createDomainWebhook=e=>{let n=new t(e),o=new WebhookBuilder(e),d=new l(e),h=new r(e),u=new a(e,[]);return{authHandlerBuilder:n,webhookBuilder:o,taskFactory:d,finalizeHandlerBuilder:u,callbackBuilder:new i(e),dynamicResourcesFactory:h,prefetchBuilder:new s(e)}};
+import{initConsoleLogger as t}from"@salsita-ai/common/utils";import{routeWebhookRequests as e}from"@salsita-ai/contracts/webhook";import{applyAssistantSetup as n,buildAssistantManifest as s,generateAssistantPrompt as i,isAssistantSetupHandler as o,projectAssistantSetupManifest as a,resolveHandlerModules as r}from"#package/domain";import{AdminFinalizeHandlerBuilder as d}from"./admin-finalize-handler-builder.js";import{AuthHandlerBuilder as l}from"./auth-handler-builder.js";import{CallbackBuilder as h}from"./callback-builder.js";import{ConfiguratorFinalizeHandlerBuilder as c}from"./configurator-finalize-handler-builder.js";import{DynamicResourcesFactory as u}from"./dynamic-resources-factory.js";import{PrefetchBuilder as m}from"./prefetch-builder.js";import{TaskFactory as f}from"./task-factory.js";export class WebhookBuilder{_context;_handlers;constructor(t,e){this._context=t,this._handlers=e}withAuthHook(t){return new WebhookBuilder(this._context,{...this._handlers,onAuth:t})}withConfiguratorFinalize(t){return new WebhookBuilder(this._context,{...this._handlers,...t})}withFetchBackendData(t){return new WebhookBuilder(this._context,{...this._handlers,onFetchBackendData:t})}build(){if(!this._handlers&&!this._context.assistantServerSettings)throw Error("Can not build webhook without any handlers! It would be very dumb!");let l=t(),h=new d(this._context).build();return e({onAuth:this._handlers?.onAuth!==void 0?(t,e)=>this._handlers.onAuth(t,{logger:l},e):void 0,admin:{onFinalize:(t,e)=>h(t,{logger:l},e)},configurator:{onAssistantSetup:this._context.assistantServerSettings?async t=>{let e=this._context.configuratorBuilder.buildConfig(),d=e.assistant;if(!d)throw Error("Assistant setup operation is not configured for this webhook!");let l=this._context.assistantServerSettings,h=r(e.handlers).find(o),c=h?n(d,l,h.handler().handler({manifest:a(d,l),inputs:{role:t.sessionRole,sessionData:t.sessionPayload,access:t.access}})):{resolved:d,settings:l};if(!c)return{setup:null,...this._context.assistantStrictThreads&&{threadLock:"strict"}};let u=s(c.resolved);return{setup:{sdl:u.sdl,prompt:i(u),...c.settings,instructions:c.settings?.instructions??void 0},...this._context.assistantStrictThreads&&{threadLock:"strict"}}}:void 0,onFetchBackendData:this._handlers?.onFetchBackendData?(t,e)=>this._handlers.onFetchBackendData(t,{logger:l},e):void 0,onFinalize:this._handlers?.onFinalize?async(t,e)=>{let n=await this._handlers?.onFetchBackendData?.({deploymentId:t.deploymentId,frontendUrl:t.frontendUrl,frontendData:t.frontendData,sessionRole:t.sessionRole,sessionPayload:t.sessionPayload,publishedAdminRevisionPath:t.publishedAdminRevisionPath,publishedChunkUrls:t.publishedChunkUrls},{logger:l},e);return this._handlers.onFinalize({deploymentId:t.deploymentId,frontendUrl:t.frontendUrl,frontendData:t.frontendData,sessionRole:t.sessionRole,sessionPayload:t.sessionPayload,publishedAdminRevisionPath:t.publishedAdminRevisionPath,publishedChunkUrls:t.publishedChunkUrls,data:t.data,locale:t.locale,configurationId:t.configurationId,entities:t.entities,modelVersion:t.modelVersion,revisionId:t.revisionId,rootEntityType:t.rootEntityType,backendData:n?.backendData},{logger:l},e)}:void 0,onCallback:this._handlers?.onCallback?(t,e)=>this._handlers.onCallback(t,{logger:l},e):void 0}},l)}}export const createDomainWebhook=t=>{let e=new l(t),n=new WebhookBuilder(t),s=new f(t),i=new u(t),o=new c(t,[]);return{authHandlerBuilder:e,webhookBuilder:n,taskFactory:s,finalizeHandlerBuilder:o,callbackBuilder:new h(t),dynamicResourcesFactory:i,prefetchBuilder:new m(t)}};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salsita-ai/sdk",
-  "version": "0.50.0-develop.f42416a4e6",
+  "version": "0.50.0-develop.f81ab6ac76",
   "description": "TypeScript SDK and CLI for building, running, and deploying Phoenix configurator applications.",
   "keywords": [
     "salsita",
@@ -13,6 +13,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=22.13"
+  },
   "type": "module",
   "imports": {
     "#package/admin": {
@@ -196,7 +199,7 @@
     "domain-cli": "dist/legacy/domain-cli/cli.js",
     "embedding-cli": "dist/legacy/embedding-cli/cli.js",
     "webhook-cli": "dist/legacy/webhook-cli/cli.js",
-    "phoenix": "dist/phoenix/cli.js"
+    "phoenix": "dist/phoenix/bin.js"
   },
   "files": [
     "dist",
@@ -212,20 +215,23 @@
     "@emotion/cache": "11.11.0",
     "@fontsource-variable/roboto": "5.2.5",
     "@gltf-transform/core": "4.3.0",
-    "@gltf-transform/functions": "4.3.0",
+    "@lingui/babel-plugin-lingui-macro": "5.9.5",
+    "@lingui/cli": "5.9.5",
+    "@lingui/conf": "5.9.5",
     "@lingui/message-utils": "5.9.5",
+    "@lingui/swc-plugin": "5.11.0",
     "@lingui/vite-plugin": "5.9.5",
     "@monaco-editor/react": "4.7.0",
     "@mui/utils": "5.17.1",
-    "@phosphor-icons/core": "2.1.1",
     "@swc/core": "1.15.40",
     "@swc/wasm-web": "1.15.40",
     "@tanstack/ai": "0.64.0",
-    "@tanstack/ai-react": "0.29.4",
+    "@tanstack/ai-client": "0.36.1",
     "@trpc/client": "11.17.0",
     "@trpc/react-query": "11.17.0",
     "@trpc/server": "11.17.0",
     "@types/aws-lambda": "8.10.133",
+    "@typescript/native": "npm:typescript@7.0.2",
     "@uiw/color-convert": "2.9.6",
     "@uiw/react-color-hue": "2.9.6",
     "@uiw/react-color-saturation": "2.9.6",
@@ -241,10 +247,12 @@
     "dotenv-expand": "10.0.0",
     "envalid": "8.1.1",
     "esbuild": "0.25.12",
+    "eslint": "9.39.4",
     "fs-extra": "11.2.0",
     "globby": "14.0.2",
     "graphql": "16.14.2",
     "html-to-text": "10.0.0",
+    "htmlparser2": "10.1.0",
     "ink": "5.2.1",
     "its-fine": "1.2.5",
     "jiti": "2.7.0",
@@ -254,37 +262,35 @@
     "lodash-es": "4.18.1",
     "mime-types": "2.1.35",
     "monaco-editor": "0.52.2",
+    "motion": "12.34.0",
     "mui-modal-provider": "2.4.6",
     "notistack": "3.0.2",
     "observable-hooks": "4.2.3",
     "openai": "7.23.0",
     "openapi-fetch": "0.9.2",
     "picomatch": "4.0.4",
-    "postprocessing": "6.36.3",
+    "prettier": "3.8.3",
     "promise-queue": "2.2.5",
     "react-device-detect": "2.2.3",
     "react-dnd": "16.0.1",
     "react-dnd-html5-backend": "16.0.1",
     "react-dropzone": "14.3.8",
     "react-error-boundary": "4.0.12",
-    "react-hook-form": "7.53.0",
     "react-json-tree": "0.20.0",
     "react-markdown": "9.0.1",
     "remark": "15.0.1",
     "remark-gfm": "4.0.0",
-    "rxjs": "7.8.2",
     "semver": "7.6.3",
     "spark-md5": "3.0.2",
     "tar-stream": "3.1.7",
-    "three": "0.160.1",
     "three-mesh-bvh": "0.8.0",
     "three-stdlib": "2.36.1",
     "troika-three-text": "0.47.2",
     "ts-pattern": "5.9.0",
+    "typescript": "6.0.3",
     "use-font-face-observer": "1.2.2",
     "usehooks-ts": "3.1.0",
     "uuid": "14.0.0",
-    "vaul": "1.1.2",
     "vite": "6.4.3",
     "vite-plugin-css-injected-by-js": "3.5.2",
     "vite-plugin-restart": "2.0.0",
@@ -292,19 +298,22 @@
     "yaml": "2.9.0",
     "yargs": "17.7.2",
     "zod": "3.25.76",
-    "@salsita-ai/contracts": "0.50.0-develop.f42416a4e6",
-    "@salsita-ai/common": "0.50.0-develop.f42416a4e6"
+    "@salsita-ai/common": "0.50.0-develop.f81ab6ac76",
+    "@salsita-ai/contracts": "0.50.0-develop.f81ab6ac76"
   },
   "devDependencies": {
     "@clerk/clerk-react": "5.61.8",
     "@emotion/react": "11.11.3",
-    "@lingui/cli": "5.9.5",
+    "@emotion/styled": "11.11.0",
     "@lingui/core": "5.9.5",
     "@lingui/format-po": "5.9.5",
     "@lingui/macro": "5.9.5",
-    "@lingui/swc-plugin": "5.11.0",
+    "@lingui/react": "5.9.5",
     "@mui/material": "5.15.5",
     "@mui/system": "5.16.7",
+    "@phosphor-icons/core": "2.1.1",
+    "@react-three/drei": "9.97.6",
+    "@react-three/fiber": "8.15.16",
     "@react-three/postprocessing": "2.16.3",
     "@storybook/react-vite": "10.4.1",
     "@svgr/cli": "8.1.0",
@@ -333,37 +342,39 @@
     "babel-plugin-macros": "3.1.0",
     "buffer": "6.0.3",
     "chokidar-cli": "3.0.0",
-    "eslint": "9.39.4",
     "happy-dom": "20.9.0",
     "ink-testing-library": "4.0.0",
-    "motion": "12.34.0",
     "openapi-typescript": "7.4.1",
-    "prettier": "3.8.3",
+    "postprocessing": "6.36.3",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "rxjs": "7.8.2",
     "storybook": "10.4.1",
+    "three": "0.160.1",
     "tsx": "4.22.3",
-    "typescript": "npm:@typescript/typescript6@6.0.2",
     "vitest": "4.1.11",
     "server": "1.64.0"
   },
   "peerDependencies": {
-    "@clerk/clerk-react": "5.61.8",
-    "@emotion/react": "11.11.3",
-    "@emotion/styled": "11.11.0",
-    "@lingui/core": "5.9.5",
-    "@lingui/react": "5.9.5",
-    "@mui/material": "5.15.5",
-    "@mui/system": "5.16.7",
-    "@react-three/drei": "9.97.6",
-    "@react-three/fiber": "8.15.16",
-    "@react-three/postprocessing": "2.16.3",
-    "@tanstack/react-query": "5.100.14",
-    "@vitejs/plugin-react": "5.2.0",
-    "envalid": "8.1.1",
-    "motion": "12.34.0",
-    "react": "18.3.1",
-    "react-dom": "18.3.1",
-    "three": "0.160.1",
-    "uuid": "14.0.0"
+    "@clerk/clerk-react": "^5.61.8",
+    "@emotion/react": "^11.11.3",
+    "@emotion/styled": "^11.11.0",
+    "@lingui/core": "^5.9.5",
+    "@lingui/react": "^5.9.5",
+    "@mui/material": "^5.15.5",
+    "@mui/system": "^5.16.7",
+    "@react-three/drei": "^9.97.6",
+    "@react-three/fiber": "^8.15.16",
+    "@react-three/postprocessing": "^2.16.3",
+    "@tanstack/react-query": "^5.100.14",
+    "@types/react": "^18.3.8",
+    "@types/react-dom": "^18.3.0",
+    "@types/three": "^0.160.0",
+    "postprocessing": "~6.36.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "rxjs": "^7.8.2",
+    "three": "^0.160.1"
   },
   "peerDependenciesMeta": {
     "@clerk/clerk-react": {
@@ -395,6 +406,7 @@
     "prettify:fix": "prettier --write .",
     "verify:fix": "pnpm build && pnpm run ts:check && pnpm docs:verify && pnpm lint:fix && pnpm prettify:fix && pnpm test",
     "test": "vitest run",
-    "ts:check": "NODE_OPTIONS=\"--max-old-space-size=8192\" tsc --project ./tsconfig.build.json --emitDeclarationOnly --noEmit --checkers 1"
+    "ts:check": "NODE_OPTIONS=\"--max-old-space-size=8192\" tsc --project ./tsconfig.build.json --emitDeclarationOnly --noEmit --checkers 1 && pnpm ts:check:tests",
+    "ts:check:tests": "NODE_OPTIONS=\"--max-old-space-size=8192\" tsc --project ./tsconfig.test.json --noEmit --checkers 1"
   }
 }