@salsita-ai/sdk 0.50.0-develop.c33986dc44 → 0.50.0-develop.c402728d10

package/dist/phoenix/services/deployment/deployment-preparation-service.d.ts

@@ -0,0 +1,28 @@
+import type { ApplicationSpec } from '#package/application-spec';
+import type { Logger } from '../../utils/index.js';
+import type { DevelopmentCredential } from '../development-credential.js';
+import type { PhoenixStore } from '../phoenix-store.js';
+/** The deployment identity a server-backed dev session prepares and checks after rebuilds. */
+export interface DeploymentPreparationServiceProps {
+    readonly serverUrl: string;
+    readonly credential: DevelopmentCredential;
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+    readonly sdkVersion: string;
+}
+export interface DeploymentPreparationServiceContext {
+    readonly logger: Logger;
+    readonly store: PhoenixStore;
+}
+/** Prepares the active dev deployment and reports spec changes that require a session restart. */
+export declare class DeploymentPreparationService {
+    private readonly props;
+    private readonly context;
+    constructor(props: DeploymentPreparationServiceProps, context: DeploymentPreparationServiceContext);
+    prepare(): Promise<void>;
+    prepareAtStartup(options: {
+        readonly skipUpload: boolean;
+        readonly debug: boolean;
+    }): Promise<void>;
+    reportUnregisteredSpec(applicationSpec: ApplicationSpec): Promise<void>;
+}

package/dist/phoenix/services/deployment/deployment-preparation-service.js

@@ -0,0 +1 @@
+import{mkdir as e}from"node:fs/promises";import{dirname as t}from"node:path";import{resolveGeneratedEnvFile as r}from"@salsita-ai/common/env";import{getDeploymentFingerprint as o}from"../../application-spec/index.js";import{prepareDevelopmentEnvironment as n}from"../prepare-development-environment.js";import{readGeneratedEnvMarkers as i}from"./generated-env-markers.js";export class DeploymentPreparationService{props;context;constructor(e,t){this.props=e,this.context=t}prepare(){return this.prepareAtStartup({skipUpload:!0,debug:!1})}async prepareAtStartup(o){let i=r(".");await e(t(i),{recursive:!0}),await n({serverUrl:this.props.serverUrl,projectSlug:this.props.projectSlug,environmentSlug:this.props.environmentSlug,credential:this.props.credential,outFile:i,skipUpload:o.skipUpload,overrideSchema:!0,debug:o.debug,projectVersion:this.props.sdkVersion},{logger:this.context.logger})}async reportUnregisteredSpec(e){try{let t=o(e),n=await i(r("."));if(!n||n.PHOENIX_DEPLOYMENT_FINGERPRINT===t)return void this.context.store.reportedFingerprint$.next(null);if(this.context.store.reportedFingerprint$.value===t)return;this.context.store.reportedFingerprint$.next(t),this.context.logger.error("The development deployment on the server still has the domain model and deployment settings it was prepared with, not the ones the spec now declares: a running phoenix dev cannot register a change, because its webhook tunnel and the preview stay bound to the deployment they started with. Restart phoenix dev to prepare the deployment again, then open the Preview address it prints rather than reloading a tab whose address has ?cid=, which loads a configuration saved with the earlier model.")}catch(e){this.context.logger.warn(`Could not compare the spec with the development deployment: ${e instanceof Error?e.message:String(e)}. After a domain model change, restart phoenix dev to register it.`)}}}

package/dist/phoenix/{commands → services/deployment}/generated-env-markers.d.ts

@@ -3,5 +3,6 @@ export interface GeneratedEnvMarkers {
     readonly PHOENIX_PROJECT_SLUG?: string;
     readonly PHOENIX_ENVIRONMENT_SLUG?: string;
     readonly PHOENIX_SERVER_URL?: string;
+    readonly PHOENIX_DEPLOYMENT_FINGERPRINT?: string;
 }
 export declare const readGeneratedEnvMarkers: (outFile: string) => Promise<GeneratedEnvMarkers | null>;

package/dist/phoenix/services/deployment/generated-env-markers.js

@@ -0,0 +1 @@
+import{parse as E}from"dotenv";import{readFile as N}from"node:fs/promises";export const readGeneratedEnvMarkers=async r=>{try{let _=E(await N(r));return{DEPLOYMENT_ID:_.DEPLOYMENT_ID,PHOENIX_PROJECT_SLUG:_.PHOENIX_PROJECT_SLUG,PHOENIX_ENVIRONMENT_SLUG:_.PHOENIX_ENVIRONMENT_SLUG,PHOENIX_SERVER_URL:_.PHOENIX_SERVER_URL,PHOENIX_DEPLOYMENT_FINGERPRINT:_.PHOENIX_DEPLOYMENT_FINGERPRINT}}catch(E){if(E instanceof Error&&"code"in E&&"ENOENT"===E.code)return null;throw E}};

package/dist/phoenix/services/deployment/index.d.ts

@@ -0,0 +1,2 @@
+export { readGeneratedEnvMarkers } from './generated-env-markers.js';
+export { DeploymentPreparationService } from './deployment-preparation-service.js';

package/dist/phoenix/services/deployment/index.js

@@ -0,0 +1 @@
+export{readGeneratedEnvMarkers}from"./generated-env-markers.js";export{DeploymentPreparationService}from"./deployment-preparation-service.js";

package/dist/phoenix/services/index.d.ts

@@ -1,13 +1,15 @@
 export type { BrowserConsoleEvent, DataRequest, DataResult, EditorContextData, EditorLifecycleStatus, EditorStateData, MockTemplateUpdateEvent, SceneRequest, SceneResult, ScreenshotRequest, ScreenshotResult, SpecUpdateEvent, StateRequest, StateResult, StateSection, } from './phoenix-pubsub.js';
 export { PhoenixPubSub } from './phoenix-pubsub.js';
 export { PhoenixStore } from './phoenix-store.js';
-export { PhoenixApplication } from './phoenix-application.js';
+export { DeploymentPreparationService, readGeneratedEnvMarkers } from './deployment/index.js';
+export { PhoenixApplication, type PhoenixApplicationProps, type PhoenixApplicationContext, type PhoenixDevelopmentOptions, type EditorServerHandle, } from './session/index.js';
 export { VariantFileSession } from './variant-file-session.js';
 export { VariantPreviewService } from './variant-preview-service.js';
 export { MockTemplateWatcher, type MockTemplateWatcherConfig } from './mock-template-watcher.js';
 export { ApplicationSpecProjectWatcher, type ApplicationSpecProjectWatcherConfig, } from './application-spec-project-watcher.js';
 export { ApplicationSpecStoryWatcher, type ApplicationSpecStoryWatcherConfig, } from './application-spec-story-watcher.js';
 export { LinguiWatcher, type LinguiWatcherConfig } from './lingui-watcher.js';
+export { bootstrapLinguiCatalogs, extractAndCompileLingui } from '../lingui/index.js';
 export { loadMockTemplates, parseMockTemplateYaml, type LoadMockTemplatesResult, type ParsedMockTemplate, } from './spec-files.js';
 export { LOG_STREAMS, LogBus, type LogEntry, type LogLevel, type LogPage, type LogQuery, type LogStream, } from './log-bus.js';
 export { createBusLogger, type CreateBusLoggerOptions } from './bus-logger.js';
@@ -18,6 +20,8 @@ export { STORY_DEV_MARKER_PATH, readActiveStoryDevMarker, type StoryDevMarker }
 export { composeDefaultBanner } from './phx-banner-plugin.js';
 export { getViteBuildConfigs, getViteDevConfig, setViteLogSink, type ViteLogSink, type ViteLogSinkOptions, } from './vite-config.js';
 export { getServerCredentials, removeServerCredentials, saveServerCredentials } from './cli-credentials.js';
+export { exitCli, setBeforeCliExit } from './cli-exit.js';
 export { createSourceArchive, extractSourceArchive } from './source-archive.js';
 export { resolveSignedInDevelopmentEnvironment } from './signed-in-development-environment.js';
+export { createTelemetryClient, resolveTelemetryCommand, type CommandTelemetryAttempt, type TelemetryAssociation, type TelemetryClient, type TelemetryCommand, } from './telemetry/index.js';
 export { DEFAULT_PHOENIX_REGION, PHOENIX_REGIONS, PUBLIC_PHOENIX_REGIONS, getRegionServerUrl, getRegionStudioUrl, } from './phoenix-regions.js';

package/dist/phoenix/services/index.js

@@ -1 +1 @@
-export{PhoenixPubSub}from"./phoenix-pubsub.js";export{PhoenixStore}from"./phoenix-store.js";export{PhoenixApplication}from"./phoenix-application.js";export{VariantFileSession}from"./variant-file-session.js";export{VariantPreviewService}from"./variant-preview-service.js";export{MockTemplateWatcher}from"./mock-template-watcher.js";export{ApplicationSpecProjectWatcher}from"./application-spec-project-watcher.js";export{ApplicationSpecStoryWatcher}from"./application-spec-story-watcher.js";export{LinguiWatcher}from"./lingui-watcher.js";export{loadMockTemplates,parseMockTemplateYaml}from"./spec-files.js";export{LOG_STREAMS,LogBus}from"./log-bus.js";export{createBusLogger}from"./bus-logger.js";export{patchConsole}from"./console-capture.js";export{WebhookTunnelMonitor}from"./webhook-tunnel-monitor.js";export{compileWithSwc,watchWithSwc}from"./swc.js";export{STORY_DEV_MARKER_PATH,readActiveStoryDevMarker}from"./story-dev-marker.js";export{composeDefaultBanner}from"./phx-banner-plugin.js";export{getViteBuildConfigs,getViteDevConfig,setViteLogSink}from"./vite-config.js";export{getServerCredentials,removeServerCredentials,saveServerCredentials}from"./cli-credentials.js";export{createSourceArchive,extractSourceArchive}from"./source-archive.js";export{resolveSignedInDevelopmentEnvironment}from"./signed-in-development-environment.js";export{DEFAULT_PHOENIX_REGION,PHOENIX_REGIONS,PUBLIC_PHOENIX_REGIONS,getRegionServerUrl,getRegionStudioUrl}from"./phoenix-regions.js";
+export{PhoenixPubSub}from"./phoenix-pubsub.js";export{PhoenixStore}from"./phoenix-store.js";export{DeploymentPreparationService,readGeneratedEnvMarkers}from"./deployment/index.js";export{PhoenixApplication}from"./session/index.js";export{VariantFileSession}from"./variant-file-session.js";export{VariantPreviewService}from"./variant-preview-service.js";export{MockTemplateWatcher}from"./mock-template-watcher.js";export{ApplicationSpecProjectWatcher}from"./application-spec-project-watcher.js";export{ApplicationSpecStoryWatcher}from"./application-spec-story-watcher.js";export{LinguiWatcher}from"./lingui-watcher.js";export{bootstrapLinguiCatalogs,extractAndCompileLingui}from"../lingui/index.js";export{loadMockTemplates,parseMockTemplateYaml}from"./spec-files.js";export{LOG_STREAMS,LogBus}from"./log-bus.js";export{createBusLogger}from"./bus-logger.js";export{patchConsole}from"./console-capture.js";export{WebhookTunnelMonitor}from"./webhook-tunnel-monitor.js";export{compileWithSwc,watchWithSwc}from"./swc.js";export{STORY_DEV_MARKER_PATH,readActiveStoryDevMarker}from"./story-dev-marker.js";export{composeDefaultBanner}from"./phx-banner-plugin.js";export{getViteBuildConfigs,getViteDevConfig,setViteLogSink}from"./vite-config.js";export{getServerCredentials,removeServerCredentials,saveServerCredentials}from"./cli-credentials.js";export{exitCli,setBeforeCliExit}from"./cli-exit.js";export{createSourceArchive,extractSourceArchive}from"./source-archive.js";export{resolveSignedInDevelopmentEnvironment}from"./signed-in-development-environment.js";export{createTelemetryClient,resolveTelemetryCommand}from"./telemetry/index.js";export{DEFAULT_PHOENIX_REGION,PHOENIX_REGIONS,PUBLIC_PHOENIX_REGIONS,getRegionServerUrl,getRegionStudioUrl}from"./phoenix-regions.js";

package/dist/phoenix/services/lingui-watcher.js

@@ -1 +1 @@
-import e from"promise-queue";import{Subject as t,buffer as i,debounceTime as s}from"rxjs";import{watch as r}from"#package/watch";import{compileLingui as n,extractAndCompileLingui as o}from"./lingui.js";let c=["src/**/*.{ts,tsx}","src/locales/**/*.po"],g=["src/locales/**/*.{ts,tsx}"];export class LinguiWatcher{watcher=null;subscription=null;runQueue=new e(1,1/0);changeSubject$=new t;logger;isShuttingDown=!1;constructor(e){this.logger=e.logger}start(){this.setupFileWatcher(),this.setupRunSubscription()}trigger(){this.changeSubject$.next("<codegen-rebuild>")}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){this.watcher=r(c,{ignored:g,cwd:process.cwd(),ignoreInitial:!0,persistent:!0}),this.watcher.on("all",(e,t)=>{("change"===e||"add"===e||"unlink"===e)&&(this.logger.debug(`Lingui source ${e}: ${t}`),this.changeSubject$.next(t))}).on("error",e=>{this.logger.error(`Lingui watcher error: ${e instanceof Error?e.message:String(e)}`,e)})}setupRunSubscription(){let e=this.changeSubject$.pipe(s(200));this.subscription=this.changeSubject$.pipe(i(e)).subscribe(e=>{let t=e.some(e=>!e.endsWith(".po"));this.runQueue.add(async()=>{if(!this.isShuttingDown)try{t?(this.logger.info("Lingui sources changed, extracting and compiling i18n messages..."),await o({logger:this.logger})):(this.logger.info("Lingui catalogs changed, compiling i18n messages..."),await n({logger:this.logger}))}catch(e){this.logger.error(`Lingui update failed: ${e instanceof Error?e.message:String(e)}`,e)}})})}}
+import e from"promise-queue";import{Subject as i,buffer as t,debounceTime as s}from"rxjs";import{watch as r}from"#package/watch";import{compileLingui as n,extractAndCompileLingui as o}from"../lingui/index.js";let c=["src/**/*.{ts,tsx}","src/locales/**/*.po"],g=["src/locales/**/*.{ts,tsx}"];export class LinguiWatcher{watcher=null;subscription=null;runQueue=new e(1,1/0);changeSubject$=new i;logger;isShuttingDown=!1;constructor(e){this.logger=e.logger}start(){this.setupFileWatcher(),this.setupRunSubscription()}trigger(){this.changeSubject$.next("<codegen-rebuild>")}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){this.watcher=r(c,{ignored:g,cwd:process.cwd(),ignoreInitial:!0,persistent:!0}),this.watcher.on("all",(e,i)=>{("change"===e||"add"===e||"unlink"===e)&&(this.logger.debug(`Lingui source ${e}: ${i}`),this.changeSubject$.next(i))}).on("error",e=>{this.logger.error(`Lingui watcher error: ${e instanceof Error?e.message:String(e)}`,e)})}setupRunSubscription(){let e=this.changeSubject$.pipe(s(200));this.subscription=this.changeSubject$.pipe(t(e)).subscribe(e=>{let i=e.some(e=>!e.endsWith(".po"));this.runQueue.add(async()=>{if(!this.isShuttingDown)try{i?(this.logger.info("Lingui sources changed, extracting and compiling i18n messages..."),await o({logger:this.logger})):(this.logger.info("Lingui catalogs changed, compiling i18n messages..."),await n({logger:this.logger}))}catch(e){this.logger.error(`Lingui update failed: ${e instanceof Error?e.message:String(e)}`,e)}})})}}

package/dist/phoenix/services/phoenix-store.d.ts

@@ -1,4 +1,5 @@
 import { BehaviorSubject } from 'rxjs';
+import type { ViteDevServer } from 'vite';
 /**
  * A frontend file script or standalone HTML proposal served from `.phoenix/variants/`.
  */
@@ -44,5 +45,7 @@ export interface VariantPreviewState {
  * editor server reaches it only through them. Events that carry no state stay on PhoenixPubSub.
  */
 export declare class PhoenixStore {
+    readonly viteServer$: BehaviorSubject<ViteDevServer | null>;
+    readonly reportedFingerprint$: BehaviorSubject<string | null>;
     readonly variantPreview$: BehaviorSubject<VariantPreviewState>;
 }

package/dist/phoenix/services/phoenix-store.js

@@ -1 +1 @@
-import{BehaviorSubject as e}from"rxjs";export class PhoenixStore{variantPreview$=new e({open:null,activeChoice:null,unclaimed:null})}
+import{BehaviorSubject as e}from"rxjs";export class PhoenixStore{viteServer$=new e(null);reportedFingerprint$=new e(null);variantPreview$=new e({open:null,activeChoice:null,unclaimed:null})}

package/dist/phoenix/services/prepare-development-environment.js

@@ -1,2 +1,2 @@
-import{writeFile as e}from"node:fs/promises";import{createApiBaseClient as i}from"#package/client";import{resolveApplicationSpecDeploymentData as t}from"../application-spec/index.js";import{formatEnvContent as r,uploadFilesWithPresignedUrls as a}from"../utils/index.js";import{getDevelopmentCredentialHint as o,getDevelopmentHeaders as s}from"./development-credential.js";export const prepareDevelopmentEnvironment=async(n,l)=>{let{logger:p}=l,{projectSlug:d,environmentSlug:m,serverUrl:c,credential:h,outFile:v,skipUpload:f,overrideSchema:u,projectVersion:g}=n;p.step("Preparing development environment"),p.info(`Preparing development environment for project "${d}", environment "${m}"`);let E=i(c);p.debug(`Using server URL: ${c}`);let b=await t({skipUpload:f,logger:p});p.info("Preparing and activating the development deployment on the server...");let{data:P,error:$}=await E.POST("/environments/development/prepare",{body:{applicationVersion:b.applicationVersion,publishedDataHash:b.publishedDataHash,useAuthHook:b.useAuthHook,overrideSchema:u,configurationSchema:{version:b.schemaVersion,schema:b.schema},adminConfigurationSchema:b.adminSchema?{schema:b.adminSchema,version:b.adminSchemaVersion}:void 0,chat:b.chat,embeddings:b.embeddings,...b.assistant?{assistant:!0}:{},acl:{canCreate:b.aclCanCreate},privateFiles:[...b.assets.privateFilePaths],publicFiles:[...b.assets.publicFilePaths],sdkVersion:g},headers:s(h,{projectSlug:d,environmentSlug:m})});if($)throw Error(`Failed to prepare development deployment for ${d}/${m} on ${c}: ${$.message}. ${o(h,d)}`);if(!P)throw Error("No data returned from server while preparing the development deployment.");let{environmentVariables:y,privateUploadUrls:w,publicUploadUrls:F}=P;if(f)p.debug("Skipping file upload");else{p.info("Uploading files to S3...");let e={privateFiles:[...b.assets.privateFilesFullPaths].map(e=>{let i=e.replace("assets/private/",""),t=w[i];if(!t)throw Error(`No upload URL provided for private file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/private directory.`);return{localPath:e,uploadUrl:t}}),publicFiles:[...b.assets.publicFilesFullPaths].map(e=>{let i=e.replace("assets/public/",""),t=F[i];if(!t)throw Error(`No upload URL provided for public file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/public directory.`);return{localPath:e,uploadUrl:t}})};await a(e,{logger:p})}try{await e(v,`${r({...y,PHOENIX_PROJECT_SLUG:d,PHOENIX_ENVIRONMENT_SLUG:m,PHOENIX_SERVER_URL:c})}
+import{writeFile as e}from"node:fs/promises";import{createApiBaseClient as i}from"#package/client";import{resolveApplicationSpecDeploymentData as t}from"../application-spec/index.js";import{formatEnvContent as r,uploadFilesWithPresignedUrls as a}from"../utils/index.js";import{getDevelopmentCredentialHint as o,getDevelopmentHeaders as s}from"./development-credential.js";export const prepareDevelopmentEnvironment=async(n,l)=>{let{logger:p}=l,{projectSlug:d,environmentSlug:m,serverUrl:c,credential:h,outFile:v,skipUpload:f,overrideSchema:u,projectVersion:E}=n;p.step("Preparing development environment"),p.info(`Preparing development environment for project "${d}", environment "${m}"`);let g=i(c);p.debug(`Using server URL: ${c}`);let P=await t({skipUpload:f,logger:p});p.info("Preparing and activating the development deployment on the server...");let{data:b,error:$}=await g.POST("/environments/development/prepare",{body:{applicationVersion:P.applicationVersion,publishedDataHash:P.publishedDataHash,useAuthHook:P.useAuthHook,overrideSchema:u,configurationSchema:{version:P.schemaVersion,schema:P.schema},adminConfigurationSchema:P.adminSchema?{schema:P.adminSchema,version:P.adminSchemaVersion}:void 0,chat:P.chat,embeddings:P.embeddings,...P.assistant?{assistant:!0}:{},acl:{canCreate:P.aclCanCreate},privateFiles:[...P.assets.privateFilePaths],publicFiles:[...P.assets.publicFilePaths],sdkVersion:E},headers:s(h,{projectSlug:d,environmentSlug:m})});if($)throw Error(`Failed to prepare development deployment for ${d}/${m} on ${c}: ${$.message}. ${o(h,d)}`);if(!b)throw Error("No data returned from server while preparing the development deployment.");let{environmentVariables:y,privateUploadUrls:N,publicUploadUrls:w}=b;if(f)p.debug("Skipping file upload");else{p.info("Uploading files to S3...");let e={privateFiles:[...P.assets.privateFilesFullPaths].map(e=>{let i=e.replace("assets/private/",""),t=N[i];if(!t)throw Error(`No upload URL provided for private file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/private directory.`);return{localPath:e,uploadUrl:t}}),publicFiles:[...P.assets.publicFilesFullPaths].map(e=>{let i=e.replace("assets/public/",""),t=w[i];if(!t)throw Error(`No upload URL provided for public file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/public directory.`);return{localPath:e,uploadUrl:t}})};await a(e,{logger:p})}try{await e(v,`${r({...y,PHOENIX_PROJECT_SLUG:d,PHOENIX_ENVIRONMENT_SLUG:m,PHOENIX_SERVER_URL:c,PHOENIX_DEPLOYMENT_FINGERPRINT:P.fingerprint})}
 `),p.debug(`Environment variables written to ${v}`)}catch{throw Error(`Failed to write environment variables to file at ${v}, please verify you have write permissions to this location.`)}p.info(`Project: ${d}`),p.info(`Environment: ${m}`),p.info(`Deployment ID: ${y.DEPLOYMENT_ID}`),p.success("Development environment prepared successfully!")};

package/dist/phoenix/services/session/editor-server-handle.d.ts

@@ -0,0 +1,5 @@
+/** A session-owned editor transport, including the result of binding its port. */
+export interface EditorServerHandle {
+    readonly ready: Promise<void>;
+    readonly close: () => Promise<void>;
+}

package/dist/phoenix/services/session/editor-server-handle.js

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

package/dist/phoenix/services/session/index.d.ts

@@ -0,0 +1,2 @@
+export { PhoenixApplication, type PhoenixApplicationProps, type PhoenixApplicationContext, type PhoenixDevelopmentOptions, } from './phoenix-application.js';
+export type { EditorServerHandle } from './editor-server-handle.js';

package/dist/phoenix/services/session/index.js

@@ -0,0 +1 @@
+export{PhoenixApplication}from"./phoenix-application.js";

package/dist/phoenix/services/session/phoenix-application.d.ts

@@ -0,0 +1,82 @@
+import { Subject } from 'rxjs';
+import { createServer } from 'vite';
+import { type Logger } from '../../utils/index.js';
+import { DeploymentPreparationService } from '../deployment/index.js';
+import { type DevelopmentCredential } from '../development-credential.js';
+import { LinguiWatcher } from '../lingui-watcher.js';
+import { LogBus } from '../log-bus.js';
+import { type BrowserConsoleEvent, PhoenixPubSub } from '../phoenix-pubsub.js';
+import { PhoenixStore } from '../phoenix-store.js';
+import { VariantPreviewService } from '../variant-preview-service.js';
+import { WebhookTunnelMonitor } from '../webhook-tunnel-monitor.js';
+import type { EditorServerHandle } from './editor-server-handle.js';
+/** Resolved inputs for one development session; the application constructs its service graph. */
+export interface PhoenixDevelopmentOptions {
+    readonly sdkVersion: string;
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+    readonly cliUseWorkspace: boolean | undefined;
+    readonly enableEditor: boolean | undefined;
+    readonly debug: boolean;
+    readonly withLingui: boolean;
+    readonly persistenceMode: string | undefined;
+    readonly force: boolean;
+    readonly serverUrl: string | undefined;
+    readonly credential: DevelopmentCredential | undefined;
+    readonly skipUpload: boolean;
+}
+export interface PhoenixApplicationProps {
+    readonly projectRoot: string;
+    readonly mode: 'dev' | 'story';
+    readonly development: PhoenixDevelopmentOptions | undefined;
+    readonly editorPort: number | undefined;
+}
+/** Host adapters for the editor transport and terminal presentation at lifecycle boundaries. */
+export interface PhoenixApplicationContext {
+    readonly logger: Logger;
+    readonly createEditorServer: (props: {
+        readonly port: number;
+        readonly application: PhoenixApplication;
+        readonly logger: Logger;
+        readonly debug: boolean;
+    }) => EditorServerHandle;
+    readonly onProjectPrepared: (logs: LogBus) => void;
+    readonly onStartupFailure: (error: unknown) => void;
+    readonly onBrowserConsole: (event: BrowserConsoleEvent, logs: LogBus) => void;
+}
+/** Composes, starts and closes one dev or story session, including resources acquired during a failed start. */
+export declare class PhoenixApplication {
+    private readonly props;
+    private readonly context;
+    readonly store: PhoenixStore;
+    readonly pubsub: PhoenixPubSub;
+    readonly failures$: Subject<Error>;
+    private readonly logsValue;
+    private readonly tunnelMonitorValue;
+    private readonly deploymentPreparationValue;
+    private variantPreviewsValue;
+    private linguiWatcherValue;
+    private projectWatcher;
+    private storyWatcher;
+    private mockTemplateWatcher;
+    private editorServer;
+    private webhookTunnel;
+    private browserConsoleSubscription;
+    private startPromise;
+    private closePromise;
+    constructor(props: PhoenixApplicationProps, context: PhoenixApplicationContext);
+    get logs(): LogBus | undefined;
+    get tunnelMonitor(): WebhookTunnelMonitor | undefined;
+    get deploymentPreparation(): DeploymentPreparationService | undefined;
+    get projectRoot(): string;
+    get mode(): 'dev' | 'story';
+    get variantPreviews(): VariantPreviewService | undefined;
+    get linguiWatcher(): LinguiWatcher | undefined;
+    start(): Promise<Awaited<ReturnType<typeof createServer>> | undefined>;
+    close(): Promise<void>;
+    private startSession;
+    private startEditor;
+    private startDevelopment;
+    private assertStarting;
+    private closeResources;
+}

package/dist/phoenix/services/session/phoenix-application.js

@@ -0,0 +1,2 @@
+import{Subject as e}from"rxjs";import{createServer as t}from"vite";import{resolveGeneratedEnvFile as o}from"@salsita-ai/common/env";import{generateProjectFiles as r,getDeploymentFingerprint as s}from"../../application-spec/index.js";import{exists as i}from"../../utils/index.js";import{buildWebhooks as n,webhookLogContext as a}from"../../webhooks/index.js";import{ApplicationSpecProjectWatcher as l}from"../application-spec-project-watcher.js";import{ApplicationSpecStoryWatcher as c}from"../application-spec-story-watcher.js";import{DeploymentPreparationService as h,readGeneratedEnvMarkers as p}from"../deployment/index.js";import{getDevelopmentCredentialHint as u}from"../development-credential.js";import{LinguiWatcher as m}from"../lingui-watcher.js";import{LogBus as g}from"../log-bus.js";import{MockTemplateWatcher as d}from"../mock-template-watcher.js";import{PhoenixPubSub as v}from"../phoenix-pubsub.js";import{PhoenixStore as w}from"../phoenix-store.js";import{VariantPreviewService as b}from"../variant-preview-service.js";import{getViteDevConfig as S}from"../vite-config.js";import{createWebhookTunnelTransport as E,readOrCreateTunnelSessionId as x,startWebhookService as f}from"../webhook-service/index.js";import{WebhookTunnelMonitor as P}from"../webhook-tunnel-monitor.js";export class PhoenixApplication{props;context;store=new w;pubsub=new v;failures$=new e;logsValue;tunnelMonitorValue;deploymentPreparationValue;variantPreviewsValue;linguiWatcherValue;projectWatcher;storyWatcher;mockTemplateWatcher;editorServer;webhookTunnel;browserConsoleSubscription;startPromise;closePromise;constructor(e,t){this.props=e,this.context=t;let o="dev"===e.mode?e.development:void 0,r=o&&(!o.persistenceMode||"server"===o.persistenceMode);this.logsValue="dev"===e.mode?new g:void 0,this.tunnelMonitorValue=r&&o.serverUrl?new P(o.serverUrl):void 0,this.deploymentPreparationValue=r&&o.serverUrl&&o.credential?new h({serverUrl:o.serverUrl,credential:o.credential,projectSlug:o.projectSlug,environmentSlug:o.environmentSlug,sdkVersion:o.sdkVersion},{store:this.store,get logger(){return t.logger}}):void 0}get logs(){return this.logsValue}get tunnelMonitor(){return this.tunnelMonitorValue}get deploymentPreparation(){return this.deploymentPreparationValue}get projectRoot(){return this.props.projectRoot}get mode(){return this.props.mode}get variantPreviews(){return this.variantPreviewsValue}get linguiWatcher(){return this.linguiWatcherValue}start(){return this.startPromise??=this.startSession(),this.startPromise}close(){return this.closePromise??=this.closeResources(this.context.logger),this.closePromise}async startSession(){try{if(this.assertStarting(),"story"===this.mode)return void await this.startEditor();let e=this.logs;if(!e)throw Error("Cannot start development: the application has no log bus.");return this.browserConsoleSubscription=this.pubsub.browserConsole$.subscribe(t=>this.context.onBrowserConsole(t,e)),await this.startDevelopment()}catch(e){throw this.closePromise||this.context.onStartupFailure(e),await this.close(),e}}async startEditor(){let e=this.props.editorPort;void 0!==e&&("dev"===this.mode&&this.context.logger.step("Starting editor WebSocket server"),this.editorServer=this.context.createEditorServer({port:e,application:this,logger:this.context.logger,debug:this.props.development?.debug??!1}),await this.editorServer.ready,this.assertStarting(),"dev"===this.mode&&this.context.logger.debug(`Editor WebSocket server started on port ${e}`),this.mockTemplateWatcher=new d({projectRoot:this.projectRoot,pubsub:this.pubsub,logger:this.context.logger}),this.mockTemplateWatcher.start(),"story"===this.mode&&(this.storyWatcher=new c({projectRoot:this.projectRoot,pubsub:this.pubsub,logger:this.context.logger}),this.storyWatcher.start()))}async startDevelopment(){let e=this.props.development,c=this.logs;if(!e||!c)throw Error("Cannot start development: session options are missing. Supply development options when constructing the application.");let{sdkVersion:h,projectSlug:g,environmentSlug:d,cliUseWorkspace:v,enableEditor:w,debug:P,withLingui:j,persistenceMode:y,force:k,serverUrl:V,credential:W,skipUpload:R}=e,{store:N,pubsub:T,deploymentPreparation:I,tunnelMonitor:_}=this;process.env.NODE_ENV="development",y&&(process.env.PERSISTENCE_MODE=y);let O=!y||"server"===y;if(O&&V&&(process.env.SERVER_URL=V),this.context.logger.step("Starting development mode"),!await i("spec"))throw Object.assign(Error('Spec folder not found. Run "phoenix init" first.'),{code:"SPEC_NOT_FOUND"});if(O&&(!V||!W))throw Error("Server persistence needs a server and a credential. Run `phoenix login <workspace>`, or create a development environment in Studio and paste its .env block into .env.");this.context.logger.step("Building project files");let{templateFiles:D,applicationSpec:$}=await r({sdkVersion:h,projectSlug:g,environmentSlug:d,cliUseWorkspace:v,enableEditor:w,withLingui:j,force:k},{logger:this.context.logger});if(this.assertStarting(),this.context.logger.success("Project files built successfully"),O&&V&&W){let e=o("."),t=await p(e);k||t?.PHOENIX_PROJECT_SLUG!==g||t.PHOENIX_ENVIRONMENT_SLUG!==d||t.PHOENIX_SERVER_URL!==V||t.PHOENIX_DEPLOYMENT_FINGERPRINT!==s($)?(this.context.logger.step("Preparing development deployment"),await I?.prepareAtStartup({skipUpload:R,debug:P})):this.context.logger.debug(`${e} matches the current development environment, skipping prepare`)}if(this.assertStarting(),this.context.onProjectPrepared(c),j?(this.linguiWatcherValue=new m({logger:this.context.logger}),this.linguiWatcherValue.start()):this.context.logger.warn("Continuous Lingui updates are disabled; missing catalogs were bootstrapped at startup. Pass --withLingui or set WITH_LINGUI=true to enable."),O&&(this.context.logger.step("Building webhooks"),await a.run("webhook",async()=>{await n({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js"})})),O&&V&&W){let e=o("."),t=await p(e);if(!t?.DEPLOYMENT_ID)throw Error(`Webhook tunnel cannot start because ${e} has no DEPLOYMENT_ID. Rerun phoenix dev to prepare the development deployment.`);this.assertStarting();let r=await x();this.assertStarting();let s=await f({experimental:!0,transport:E({serverUrl:V,credential:W,projectSlug:g,environmentSlug:d}),rejectionHint:u(W,g),environmentSlug:d,deploymentId:t.DEPLOYMENT_ID,sessionId:r,onStatus:(e,o)=>{_?.setStatus(e,{deploymentId:t.DEPLOYMENT_ID,sessionId:r,message:o??null})},onRequest:e=>_?.record(e)});this.closePromise&&(await s.stop(),this.assertStarting()),this.webhookTunnel=s,_?.setStatus("waiting",{deploymentId:t.DEPLOYMENT_ID,sessionId:r}),s.stopped.catch(e=>{this.failures$.next(Error(`Webhook tunnel failed: ${e instanceof Error?e.message:String(e)}`)),this.close()}),this.context.logger.success("Webhook tunnel started")}this.assertStarting();let M=new l({pubsub:T,logger:this.context.logger,sdkVersion:h,projectSlug:g,environmentSlug:d,cliUseWorkspace:v,enableEditor:w??!0,inlineTemplates:!1,useServer:O},{store:N,linguiWatcher:this.linguiWatcherValue,deploymentPreparation:I});this.projectWatcher=M,this.variantPreviewsValue=new b({projectRoot:this.projectRoot},{store:N,logger:this.context.logger,projectWatcher:M}),w&&void 0!==this.props.editorPort&&await this.startEditor();let C=await S({templateFiles:D}),L=await t(C);return this.closePromise&&(await L.close(),this.assertStarting()),this.store.viteServer$.next(L),await L.listen(),this.assertStarting(),this.context.logger.step("Starting Vite dev server"),M.start(L),L}assertStarting(){if(this.closePromise)throw Error("Cannot continue startup: the session has already closed. Start a new Phoenix application.")}async closeResources(e){"dev"===this.mode&&e.debug("Shutting down...");let t="story"===this.mode?[{name:"story source watcher",close:()=>this.storyWatcher?.close()},{name:"mock-template watcher",close:()=>this.mockTemplateWatcher?.close()},{name:"editor server",close:()=>this.editorServer?.close()}]:[{name:"lingui watcher",close:()=>this.linguiWatcherValue?.close()},{name:"project watcher",close:()=>this.projectWatcher?.close()},{name:"mock template watcher",close:()=>this.mockTemplateWatcher?.close()},{name:"editor server",close:()=>this.editorServer?.close()},{name:"variant previews",close:()=>this.variantPreviewsValue?.dispose()},{name:"vite server",close:()=>this.store.viteServer$.value?.close()},{name:"webhook tunnel",close:()=>this.webhookTunnel?.stop()}],o=[];for(let r of t)try{"dev"===this.mode&&e.debug(`Shutting down ${r.name}`),await r.close()}catch(s){let t=s instanceof Error?s.message:String(s);"story"===this.mode?e.warn(`Failed to close the story-dev ${r.name}: ${t}. The process will continue shutting down.`):o.push(`${r.name}: ${t}`)}this.browserConsoleSubscription?.unsubscribe(),this.failures$.complete(),o.length>0&&e.warn(`Cleanup warnings:
+  ${o.join("\n  ")}`),"dev"===this.mode&&e.debug("Shutdown complete")}}

package/dist/phoenix/services/telemetry/amplitude-telemetry-transport.d.ts

@@ -0,0 +1,9 @@
+import type { TelemetryEvent } from './telemetry-event.js';
+export interface TelemetryTransport {
+    readonly send: (events: readonly TelemetryEvent[], timeoutMs: number) => Promise<void>;
+}
+interface AmplitudeTelemetryTransportContext {
+    readonly fetch: typeof fetch;
+}
+export declare const createAmplitudeTelemetryTransport: (context?: AmplitudeTelemetryTransportContext) => TelemetryTransport;
+export {};

package/dist/phoenix/services/telemetry/amplitude-telemetry-transport.js

@@ -0,0 +1 @@
+let e=e=>({event_type:e.name,device_id:e.deviceId,...void 0===e.userId?{}:{user_id:e.userId},insert_id:e.eventId,time:e.occurredAt.getTime(),event_properties:e.properties}),t=e=>429===e.status||e.status>=500;export const createAmplitudeTelemetryTransport=(r={fetch})=>({send:async(a,i)=>{if(0===a.length)return;let n=new AbortController,o=setTimeout(()=>n.abort(),i),s=JSON.stringify({api_key:"46b8fa9ce868c9da04f8ad2b6715a2f7",events:a.map(e)});try{for(let e=0;e<2;e+=1)try{let e=await r.fetch("https://api2.amplitude.com/2/httpapi",{method:"POST",headers:{"content-type":"application/json"},body:s,signal:n.signal});if(await e.body?.cancel(),e.ok||!t(e))return}catch{if(n.signal.aborted)return}}finally{n.abort(),clearTimeout(o)}}});

package/dist/phoenix/services/telemetry/index.d.ts

@@ -0,0 +1,3 @@
+export { createTelemetryClient, type CommandTelemetryAttempt, type TelemetryClient } from './telemetry-client.js';
+export { resolveTelemetryCommand, type TelemetryCommand } from './telemetry-command.js';
+export type { TelemetryAssociation } from './telemetry-state.js';

package/dist/phoenix/services/telemetry/index.js

@@ -0,0 +1 @@
+export{createTelemetryClient}from"./telemetry-client.js";export{resolveTelemetryCommand}from"./telemetry-command.js";

package/dist/phoenix/services/telemetry/telemetry-client.d.ts

@@ -0,0 +1,25 @@
+import { type TelemetryTransport } from './amplitude-telemetry-transport.js';
+import type { TelemetryCommand } from './telemetry-command.js';
+import { type TelemetryFailureCategory, type TelemetryOutcome } from './telemetry-event.js';
+import { type TelemetryAssociation, type TelemetryIdentity } from './telemetry-state.js';
+export interface CommandTelemetryAttempt {
+    readonly ready: () => void;
+    readonly complete: (outcome: TelemetryOutcome, failureCategory?: TelemetryFailureCategory) => void;
+}
+export interface TelemetryClient {
+    readonly startCommandAttempt: (command: TelemetryCommand) => CommandTelemetryAttempt;
+    readonly identify: (association: TelemetryAssociation) => Promise<void>;
+    readonly flush: () => Promise<void>;
+}
+interface CreateTelemetryClientProps {
+    readonly sdkVersion: string;
+}
+interface TelemetryClientContext {
+    readonly createId: () => string;
+    readonly loadIdentity: () => Promise<TelemetryIdentity>;
+    readonly now: () => Date;
+    readonly saveAssociation: (identity: TelemetryIdentity, association: TelemetryAssociation) => Promise<void>;
+    readonly transport: TelemetryTransport;
+}
+export declare const createTelemetryClient: (props: CreateTelemetryClientProps, context?: TelemetryClientContext) => Promise<TelemetryClient>;
+export {};

package/dist/phoenix/services/telemetry/telemetry-client.js

@@ -0,0 +1 @@
+import{randomUUID as t}from"node:crypto";import{createAmplitudeTelemetryTransport as e}from"./amplitude-telemetry-transport.js";import{createCommandEvent as r}from"./telemetry-event.js";import{loadTelemetryIdentity as o,saveTelemetryAssociation as n}from"./telemetry-state.js";let a={ready:()=>void 0,complete:()=>void 0},s={startCommandAttempt:()=>a,identify:async()=>void 0,flush:async()=>void 0};export const createTelemetryClient=async(a,i={createId:t,loadIdentity:o,now:()=>new Date,saveAssociation:n,transport:e()})=>{if("1"===process.env.PHOENIX_TELEMETRY_DISABLED)return s;try{var d;let t,e;return d=await i.loadIdentity(),t=[],e=d,{startCommandAttempt:o=>{let n=i.createId(),s=i.now(),d=!1,c=!1;return t=[...t,r({identity:e,sdkVersion:a.sdkVersion,command:o,attemptId:n,phase:"started",outcome:"unknown",occurredAt:s},i)],{ready:()=>{if("dev"!==o||c||d)return;c=!0;let m=i.now();t=[...t,r({identity:e,sdkVersion:a.sdkVersion,command:o,attemptId:n,phase:"ready",outcome:"unknown",occurredAt:m,durationMs:Math.max(0,m.getTime()-s.getTime())},i)]},complete:(c,m)=>{if(d)return;d=!0;let u=i.now();t=[...t,r({identity:e,sdkVersion:a.sdkVersion,command:o,attemptId:n,phase:"completed",outcome:c,occurredAt:u,durationMs:Math.max(0,u.getTime()-s.getTime()),failureCategory:m},i)]}}},identify:async t=>{e={...e,...t};try{await i.saveAssociation(e,t)}catch{return}},flush:async()=>{let e=t;t=[];try{await i.transport.send(e,1e3)}catch{return}}}}catch{return s}};

package/dist/phoenix/services/telemetry/telemetry-command.d.ts

@@ -0,0 +1,2 @@
+export type TelemetryCommand = 'build' | 'changelog' | 'check' | 'clean' | 'deploy' | 'deployment:activate' | 'deployment:build-envs' | 'deployment:extract-sources' | 'deployment:finish' | 'deployment:prepare' | 'deployment:prepare-dev' | 'deployment:prepare-local' | 'deployment:register' | 'dev' | 'docs' | 'environment:cleanup' | 'environment:create' | 'environment:list' | 'feedback' | 'fix' | 'init' | 'inspect:assets' | 'inspect:data' | 'inspect:scene' | 'inspect:state' | 'link' | 'login' | 'logout' | 'prepare:ci' | 'screenshot' | 'story' | 'sync' | 'unlink' | 'variants';
+export declare const resolveTelemetryCommand: (arguments_: readonly string[]) => TelemetryCommand | null;

package/dist/phoenix/services/telemetry/telemetry-command.js

@@ -0,0 +1 @@
+let e={b:"build",build:"build",c:"check",changelog:"changelog",check:"check",ci:"prepare:ci",cl:"clean",clean:"clean",clog:"changelog",d:"dev",da:"deployment:activate",dbe:"deployment:build-envs",deploy:"deploy","dep:activate":"deployment:activate","dep:build-envs":"deployment:build-envs","dep:finish":"deployment:finish","dep:prepare":"deployment:prepare","dep:prepare-dev":"deployment:prepare-dev","dep:prepare-local":"deployment:prepare-local","dep:register":"deployment:register","deployment:activate":"deployment:activate","deployment:build-envs":"deployment:build-envs","deployment:extract-sources":"deployment:extract-sources","deployment:finish":"deployment:finish","deployment:prepare":"deployment:prepare","deployment:prepare-dev":"deployment:prepare-dev","deployment:prepare-local":"deployment:prepare-local","deployment:register":"deployment:register",dev:"dev",df:"deployment:finish",doc:"docs",docs:"docs",dp:"deployment:prepare",dpd:"deployment:prepare-dev",dpl:"deployment:prepare-local",dr:"deployment:register",ec:"environment:cleanup","env:cleanup":"environment:cleanup","env:create":"environment:create","env:list":"environment:list","environment:cleanup":"environment:cleanup","environment:create":"environment:create","environment:list":"environment:list",f:"fix",feedback:"feedback",fix:"fix",ia:"inspect:assets",id:"inspect:data",init:"init","inspect:assets":"inspect:assets","inspect:data":"inspect:data","inspect:scene":"inspect:scene","inspect:state":"inspect:state",is:"inspect:state",isc:"inspect:scene",l:"link",link:"link",login:"login",logout:"logout",pci:"prepare:ci","prepare:ci":"prepare:ci",s:"sync",screenshot:"screenshot",ss:"screenshot",st:"story",story:"story",sync:"sync",ul:"unlink",unlink:"unlink",variants:"variants"};export const resolveTelemetryCommand=n=>e[n[0]??""]??null;

package/dist/phoenix/services/telemetry/telemetry-event.d.ts

@@ -0,0 +1,44 @@
+import type { TelemetryCommand } from './telemetry-command.js';
+import type { TelemetryIdentity } from './telemetry-state.js';
+export type TelemetryOutcome = 'succeeded' | 'failed';
+export type TelemetryFailureCategory = 'command_failed';
+export type TelemetrySource = 'cli' | 'studio' | 'backend' | 'preview';
+export type TelemetryClassification = 'internal' | 'beta' | 'general' | 'unknown';
+export interface TelemetryEvent {
+    /** Unique event delivery identity, mapped to Amplitude's insert_id. */
+    readonly eventId: string;
+    readonly name: 'cli_command_started' | 'cli_dev_server_ready' | 'cli_command_completed';
+    readonly occurredAt: Date;
+    readonly deviceId: string;
+    readonly userId?: string;
+    readonly properties: {
+        readonly schema_version: 1;
+        readonly source: TelemetrySource;
+        readonly command: TelemetryCommand;
+        readonly attempt_id: string;
+        readonly phase: 'started' | 'ready' | 'completed';
+        readonly outcome: 'unknown' | TelemetryOutcome;
+        readonly duration_ms?: number;
+        readonly failure_category?: TelemetryFailureCategory;
+        readonly sdk_version: string;
+        readonly classification: TelemetryClassification;
+        readonly work_session_id: string;
+        readonly workspace_id?: string;
+    };
+}
+interface CreateCommandEventProps {
+    readonly identity: TelemetryIdentity;
+    readonly sdkVersion: string;
+    readonly command: TelemetryCommand;
+    readonly attemptId: string;
+    readonly phase: 'started' | 'ready' | 'completed';
+    readonly outcome: 'unknown' | TelemetryOutcome;
+    readonly occurredAt: Date;
+    readonly durationMs?: number;
+    readonly failureCategory?: TelemetryFailureCategory;
+}
+interface TelemetryEventContext {
+    readonly createId: () => string;
+}
+export declare const createCommandEvent: (props: CreateCommandEventProps, context: TelemetryEventContext) => TelemetryEvent;
+export {};

package/dist/phoenix/services/telemetry/telemetry-event.js

@@ -0,0 +1 @@
+export const createCommandEvent=(e,t)=>({eventId:t.createId(),name:"ready"===e.phase?"cli_dev_server_ready":"started"===e.phase?"cli_command_started":"cli_command_completed",occurredAt:e.occurredAt,deviceId:e.identity.installationId,..."userId"in e.identity?{userId:e.identity.userId}:{},properties:{schema_version:1,source:"cli",command:e.command,attempt_id:e.attemptId,phase:e.phase,outcome:e.outcome,...void 0===e.durationMs?{}:{duration_ms:e.durationMs},...void 0===e.failureCategory?{}:{failure_category:e.failureCategory},sdk_version:e.sdkVersion,classification:"userId"in e.identity?"general":"unknown",work_session_id:e.identity.workSessionId,..."workspaceId"in e.identity?{workspace_id:e.identity.workspaceId}:{}}});

package/dist/phoenix/services/telemetry/telemetry-state.d.ts

@@ -0,0 +1,25 @@
+export interface AnonymousTelemetryIdentity {
+    /** Random identifier for one operating-system user profile, without machine or account data. */
+    readonly installationId: string;
+    /** Random identifier for CLI activity separated by less than thirty minutes. */
+    readonly workSessionId: string;
+}
+export interface TelemetryAssociation {
+    /** Stable authenticated builder user ID, mapped to Amplitude's user_id after authentication. */
+    readonly userId: string;
+    /** Internal UUID of the SDK-builder workspace the CLI authenticated against. */
+    readonly workspaceId: string;
+}
+export type TelemetryIdentity = AnonymousTelemetryIdentity | (AnonymousTelemetryIdentity & TelemetryAssociation);
+interface TelemetryStateContext {
+    readonly createId: () => string;
+    readonly now: () => Date;
+}
+export declare const getTelemetryStatePath: () => string;
+/**
+ * Loads the anonymous CLI identity and records current activity. Broken or unwritable state never blocks a command:
+ * the invocation gets an ephemeral identity, while an invalid existing file is left untouched for inspection.
+ */
+export declare const loadTelemetryIdentity: (context?: TelemetryStateContext) => Promise<TelemetryIdentity>;
+export declare const saveTelemetryAssociation: (identity: TelemetryIdentity, association: TelemetryAssociation) => Promise<void>;
+export {};

package/dist/phoenix/services/telemetry/telemetry-state.js

@@ -0,0 +1,2 @@
+import{randomUUID as t}from"node:crypto";import{chmod as e,mkdir as i,readFile as n,writeFile as a}from"node:fs/promises";import{homedir as s}from"node:os";import{dirname as r,join as o}from"node:path";import{z as d}from"zod";let l=d.object({installationId:d.string().uuid(),workSessionId:d.string().uuid(),lastActiveAt:d.string().datetime()}),c=d.union([l.extend({userId:d.string().min(5),workspaceId:d.string().uuid()}),l.strict()]),I={createId:t,now:()=>new Date};export const getTelemetryStatePath=()=>process.env.PHOENIX_TELEMETRY_FILE??o(s(),".phoenix","telemetry.json");let u=async(t,n)=>{await i(r(t),{recursive:!0,mode:448}),await a(t,`${JSON.stringify(n,null,2)}
+`,{mode:384}),await e(t,384)},w=async t=>{let e;try{e=await n(t,"utf8")}catch(t){return t instanceof Error&&"code"in t&&"ENOENT"===t.code?{kind:"missing"}:{kind:"invalid"}}try{let t=c.safeParse(JSON.parse(e));return t.success?{kind:"valid",state:t.data}:{kind:"invalid"}}catch{return{kind:"invalid"}}};export const loadTelemetryIdentity=async(t=I)=>{let e=getTelemetryStatePath(),i=await w(e),n="valid"===i.kind?i.state:null,a=t.now(),s=null===n?null:Date.parse(n.lastActiveAt),r=null===s||a.getTime()-s>=18e5,o=null===n?{installationId:t.createId(),workSessionId:t.createId(),lastActiveAt:a.toISOString()}:{...n,workSessionId:r?t.createId():n.workSessionId,lastActiveAt:a.toISOString()};try{"invalid"!==i.kind&&await u(e,o)}catch{return{installationId:o.installationId,workSessionId:o.workSessionId}}return{installationId:o.installationId,workSessionId:o.workSessionId,..."userId"in o&&"workspaceId"in o?{userId:o.userId,workspaceId:o.workspaceId}:{}}};export const saveTelemetryAssociation=async(t,e)=>{let i=getTelemetryStatePath(),n=await w(i);"valid"===n.kind&&n.state.installationId===t.installationId&&n.state.workSessionId===t.workSessionId&&await u(i,{...n.state,...e})};

package/dist/phoenix/services/vite-config.js

@@ -1 +1 @@
-import{getConfig as e}from"@lingui/conf";import{lingui as i}from"@lingui/vite-plugin";import t from"@vitejs/plugin-react";import{mkdir as n,readFile as r,writeFile as o}from"fs/promises";import a from"lodash-es/camelCase.js";import{createRequire as s}from"node:module";import{dirname as l,resolve as m}from"path";import{createLogger as f}from"vite";import p from"vite-plugin-css-injected-by-js";import{isUsingLocalSdk as d}from"../utils/package-info.js";import{loadFrontendConfigModule as c}from"./frontend-config.js";import{LINGUI_CONFIG_PATH as g}from"./lingui.js";import{phxBannerPlugin as u}from"./phx-banner-plugin.js";import{phxCspNoncePlugin as h}from"./phx-csp-nonce-plugin.js";import{phxGlobalIsolationPlugin as b}from"./phx-global-isolation-plugin.js";import{phxLicensesPlugin as S}from"./phx-licenses-plugin.js";import{phxVariantPreviewsPlugin as y}from"./phx-variant-previews-plugin.js";let O=null;export const setViteLogSink=(e,i={})=>{O={sink:e,echo:i.echo??!1}};let x=["react","react-dom","three","@react-three/fiber","@react-three/drei","@react-three/postprocessing","its-fine","@emotion/react","@emotion/styled","@mui/material","@mui/system","@tanstack/react-query","rxjs"],D=()=>[s(import.meta.url).resolve("@lingui/babel-plugin-lingui-macro"),{linguiConfig:e({configPath:g})}],E=e=>{let i=e.DEPLOYMENT_ID;if("string"!=typeof i)throw Error("DEPLOYMENT_ID is required in runtime config");return i};export const getViteDevConfig=async e=>{var n,r;let o,a,p=d(),u=c(),h=u.readRuntimeConfig(),S=u.frontendBuildConfig,v=D(),j=Object.fromEntries((e?.templateFiles??[]).map(e=>[e,`.phoenix/${e}`]));return{...O&&{customLogger:(n=O.sink,r=O.echo,o=f(),{get hasWarned(){return o.hasWarned},info:(e,i)=>{n("info",e),r&&o.info(e,i)},warn:(e,i)=>{n("warn",e),r&&o.warn(e,i)},warnOnce:(e,i)=>{n("warn",e),r&&o.warnOnce(e,i)},error:(e,i)=>{n("error",e),r&&o.error(e,i)},clearScreen:e=>{r&&o.clearScreen(e)},hasErrorLogged:e=>o.hasErrorLogged(e)}),...O.echo?{}:{clearScreen:!1}},mode:"development",optimizeDeps:{exclude:["@swc/wasm-web"],...p&&{entries:["index.html","admin.html",...e?.templateFiles??[]],force:!0}},...p&&{resolve:{alias:(a=s(m(process.cwd(),"package.json")),x.flatMap(e=>{try{let i=l(a.resolve(`${e}/package.json`));return[{find:RegExp(`^${e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}(/|$)`),replacement:`${i}$1`}]}catch{return[]}}))}},plugins:[t({babel:{plugins:[v]}}),i({configPath:g}),{name:"vite:runtime-config",apply:(e,i)=>"build"===i.command||"development"===i.mode,config:e=>{let i=u.readRuntimeConfig(),t=u.frontendBuildConfig;return{...e,define:{...e.define,"phx.frontendEnv":JSON.stringify(i),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(t.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(t.gltfDecoder)}}}},b({getDeploymentId:()=>E(u.readRuntimeConfig())}),y()],define:{"process.env":{},"import.meta.env.DEV":!0,"import.meta.env.PROD":!1,"phx.frontendEnv":JSON.stringify(h),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(S.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(S.gltfDecoder)},build:{rollupOptions:{input:{index:".phoenix/index.html",admin:".phoenix/admin.html",...j}}},root:m(process.cwd(),"./.phoenix"),server:{watch:{ignored:["./**/*.{ts,tsx}","./.swc/**","../spec/**","../src/**"]}}}};export const getViteBuildConfigs=async e=>{let s=c(),f=s.readRuntimeConfig(),d=s.frontendBuildConfig,y=D(),O=S(),x=u({sdkVersion:e.sdkVersion,banner:e.banner}),v=[{name:"salsita-configurator",entryFile:"./configurator.ts",mainScriptPath:"./configurator.ts",htmlFiles:["./index.html",...{templateFiles:e.templateFiles}.templateFiles],main:!0,format:"iife"},{name:"salsita-admin",entryFile:"./admin.ts",mainScriptPath:"./admin.ts",htmlFiles:["./admin.html"],main:!1,format:"iife"},{name:"salsita-embedded-admin",entryFile:"./embedded-admin.ts",mainScriptPath:"./embedded-admin.ts",htmlFiles:[],main:!1,format:"es"},{name:"salsita-embedded-configurator",entryFile:"./embedded-configurator.ts",mainScriptPath:"./embedded-configurator.ts",htmlFiles:[],main:!1,format:"es"}].map(c=>({plugins:[t({babel:{plugins:[y]}}),i({configPath:g}),p({useStrictCSP:!0}),h(),b({getDeploymentId:()=>E(s.readRuntimeConfig())}),{name:"vite:lib-index",writeBundle:async()=>{if(!c.htmlFiles.length)return;let i="iife"===c.format?`${c.name}.iife.js`:`${c.name}.js`;for(let t of c.htmlFiles){if(c.main&&e.enableEditor&&"./index.html"===t)continue;let a=m("./.phoenix",t),s=m("./.phoenix/dist/frontend",t);await n(l(s),{recursive:!0});let f=(await r(a,"utf-8")).replace(c.mainScriptPath,i);await o(s,f,"utf-8")}}},O,x],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,lib:{entry:c.entryFile,name:a(c.name),formats:[c.format],fileName:()=>"iife"===c.format?`${c.name}.iife.js`:`${c.name}.js`},rollupOptions:{external:[],output:{assetFileNames:`${c.name}.[ext]`}},minify:!0,emptyOutDir:!1},root:m(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(f),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(d.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(d.gltfDecoder)}}));return e.enableEditor?[...v,{plugins:[t({babel:{plugins:[y]}}),i({configPath:g}),p({useStrictCSP:!0}),h(),O,x],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,rollupOptions:{external:[]},minify:!0,emptyOutDir:!1},root:m(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(f),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(d.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(d.gltfDecoder)}}]:v};
+import{getConfig as e}from"@lingui/conf";import{lingui as i}from"@lingui/vite-plugin";import t from"@vitejs/plugin-react";import{mkdir as n,readFile as r,writeFile as o}from"fs/promises";import a from"lodash-es/camelCase.js";import{createHash as s}from"node:crypto";import{readFileSync as l,rmSync as m,writeFileSync as p}from"node:fs";import{createRequire as f}from"node:module";import{dirname as d,resolve as c}from"path";import{createLogger as g}from"vite";import u from"vite-plugin-css-injected-by-js";import{LINGUI_CONFIG_PATH as h}from"../lingui/index.js";import{isUsingLocalSdk as y}from"../utils/package-info.js";import{loadFrontendConfigModule as b}from"./frontend-config.js";import{phxBannerPlugin as S}from"./phx-banner-plugin.js";import{phxCspNoncePlugin as x}from"./phx-csp-nonce-plugin.js";import{phxGlobalIsolationPlugin as O}from"./phx-global-isolation-plugin.js";import{phxLicensesPlugin as D}from"./phx-licenses-plugin.js";import{phxVariantPreviewsPlugin as E}from"./phx-variant-previews-plugin.js";let v=null;export const setViteLogSink=(e,i={})=>{v={sink:e,echo:i.echo??!1}};let P=["react","react-dom","three","@react-three/fiber","@react-three/drei","@react-three/postprocessing","its-fine","@emotion/react","@emotion/styled","@mui/material","@mui/system","@tanstack/react-query","rxjs"],j=()=>{let t=l(h),n=s("sha256").update(t).digest("hex"),r=c(`${h}.${process.pid}.${n}.json`);try{return p(r,t),{macroPlugin:[f(import.meta.url).resolve("@lingui/babel-plugin-lingui-macro"),{linguiConfig:e({configPath:r})}],catalogPlugin:i({configPath:r})}}finally{m(r,{force:!0})}},C=e=>{let i=e.DEPLOYMENT_ID;if("string"!=typeof i)throw Error("DEPLOYMENT_ID is required in runtime config");return i};export const getViteDevConfig=async e=>{var i,n;let r,o,a=y(),s=b(),l=s.readRuntimeConfig(),m=s.frontendBuildConfig,p=j(),u=Object.fromEntries((e?.templateFiles??[]).map(e=>[e,`.phoenix/${e}`]));return{...v&&{customLogger:(i=v.sink,n=v.echo,r=g(),{get hasWarned(){return r.hasWarned},info:(e,t)=>{i("info",e),n&&r.info(e,t)},warn:(e,t)=>{i("warn",e),n&&r.warn(e,t)},warnOnce:(e,t)=>{i("warn",e),n&&r.warnOnce(e,t)},error:(e,t)=>{i("error",e),n&&r.error(e,t)},clearScreen:e=>{n&&r.clearScreen(e)},hasErrorLogged:e=>r.hasErrorLogged(e)}),...v.echo?{}:{clearScreen:!1}},mode:"development",optimizeDeps:{exclude:["@swc/wasm-web"],...a&&{entries:["index.html","admin.html",...e?.templateFiles??[]],force:!0}},...a&&{resolve:{alias:(o=f(c(process.cwd(),"package.json")),P.flatMap(e=>{try{let i=d(o.resolve(`${e}/package.json`));return[{find:RegExp(`^${e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}(/|$)`),replacement:`${i}$1`}]}catch{return[]}}))}},plugins:[t({babel:{plugins:[p.macroPlugin]}}),p.catalogPlugin,{name:"vite:runtime-config",apply:(e,i)=>"build"===i.command||"development"===i.mode,config:e=>{let i=s.readRuntimeConfig(),t=s.frontendBuildConfig;return{...e,define:{...e.define,"phx.frontendEnv":JSON.stringify(i),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(t.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(t.gltfDecoder)}}}},O({getDeploymentId:()=>C(s.readRuntimeConfig())}),E()],define:{"process.env":{},"import.meta.env.DEV":!0,"import.meta.env.PROD":!1,"phx.frontendEnv":JSON.stringify(l),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(m.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(m.gltfDecoder)},build:{rollupOptions:{input:{index:".phoenix/index.html",admin:".phoenix/admin.html",...u}}},root:c(process.cwd(),"./.phoenix"),server:{watch:{ignored:["./**/*.{ts,tsx}","./.swc/**","../spec/**","../src/**"]}}}};export const getViteBuildConfigs=async e=>{let i=b(),s=i.readRuntimeConfig(),l=i.frontendBuildConfig,m=j(),p=D(),f=S({sdkVersion:e.sdkVersion,banner:e.banner}),g=[{name:"salsita-configurator",entryFile:"./configurator.ts",mainScriptPath:"./configurator.ts",htmlFiles:["./index.html",...{templateFiles:e.templateFiles}.templateFiles],main:!0,format:"iife"},{name:"salsita-admin",entryFile:"./admin.ts",mainScriptPath:"./admin.ts",htmlFiles:["./admin.html"],main:!1,format:"iife"},{name:"salsita-embedded-admin",entryFile:"./embedded-admin.ts",mainScriptPath:"./embedded-admin.ts",htmlFiles:[],main:!1,format:"es"},{name:"salsita-embedded-configurator",entryFile:"./embedded-configurator.ts",mainScriptPath:"./embedded-configurator.ts",htmlFiles:[],main:!1,format:"es"}].map(g=>({plugins:[t({babel:{plugins:[m.macroPlugin]}}),m.catalogPlugin,u({useStrictCSP:!0}),x(),O({getDeploymentId:()=>C(i.readRuntimeConfig())}),{name:"vite:lib-index",writeBundle:async()=>{if(!g.htmlFiles.length)return;let i="iife"===g.format?`${g.name}.iife.js`:`${g.name}.js`;for(let t of g.htmlFiles){if(g.main&&e.enableEditor&&"./index.html"===t)continue;let a=c("./.phoenix",t),s=c("./.phoenix/dist/frontend",t);await n(d(s),{recursive:!0});let l=(await r(a,"utf-8")).replace(g.mainScriptPath,i);await o(s,l,"utf-8")}}},p,f],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,lib:{entry:g.entryFile,name:a(g.name),formats:[g.format],fileName:()=>"iife"===g.format?`${g.name}.iife.js`:`${g.name}.js`},rollupOptions:{external:[],output:{assetFileNames:`${g.name}.[ext]`}},minify:!0,emptyOutDir:!1},root:c(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(s),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(l.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(l.gltfDecoder)}}));return e.enableEditor?[...g,{plugins:[t({babel:{plugins:[m.macroPlugin]}}),m.catalogPlugin,u({useStrictCSP:!0}),x(),p,f],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,rollupOptions:{external:[]},minify:!0,emptyOutDir:!1},root:c(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(s),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(l.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(l.gltfDecoder)}}]:g};

package/dist/phoenix/services/webhook-service/transport.js

@@ -1 +1 @@
-import{createApiBaseClient as e}from"#package/client";import{getDevelopmentHeaders as t}from"../development-credential.js";let o=(e,t)=>({ok:!1,status:t.status,message:e.message});export const createWebhookTunnelTransport=({serverUrl:a,credential:n,projectSlug:l,environmentSlug:r})=>{let s=e(a),p=t(n,{projectSlug:l,environmentSlug:r});return{poll:async({deploymentId:e,sessionId:t,signal:a})=>{let{data:n,error:l,response:r}=await s.POST("/deployments/{deploymentId}/webhook-tunnel/poll",{params:{path:{deploymentId:e}},body:{sessionId:t},headers:p,signal:a});return l?o(l,r):{ok:!0,value:n?.request??null}},respond:async({deploymentId:e,sessionId:t,requestId:a,status:n,headers:l,body:r,signal:d})=>{let{error:m,response:u}=await s.POST("/deployments/{deploymentId}/webhook-tunnel/respond",{params:{path:{deploymentId:e}},body:{sessionId:t,requestId:a,status:n,headers:l,body:r},headers:p,signal:d});return m?o(m,u):{ok:!0,value:void 0}}}};
+import{createApiBaseClient as e}from"#package/client";import{getDevelopmentHeaders as t}from"../development-credential.js";let n=(e,t)=>({ok:!1,status:t.status,message:e.message});export const createWebhookTunnelTransport=({serverUrl:o,credential:s,projectSlug:a,environmentSlug:r})=>{let l=e(o),d=t(s,{projectSlug:a,environmentSlug:r});return{poll:async({deploymentId:e,sessionId:t,signal:o})=>{let{data:s,error:a,response:r}=await l.POST("/deployments/{deploymentId}/webhook-tunnel/poll",{params:{path:{deploymentId:e}},body:{sessionId:t,acceptResponseEncoding:"gzip"},headers:d,signal:o});return a?n(a,r):{ok:!0,value:s?.request??null}},respond:async({deploymentId:e,sessionId:t,requestId:o,status:s,headers:a,body:r,isBase64Encoded:p,signal:u})=>{let i={sessionId:t,requestId:o,status:s,headers:a,body:r,isBase64Encoded:p};if(Buffer.byteLength(JSON.stringify(i),"utf8")>5242880)return{ok:!1,status:413,message:"Webhook tunnel response exceeds the 5 MiB encoded request limit. Reduce the backend data and retry."};let{error:m,response:c}=await l.POST("/deployments/{deploymentId}/webhook-tunnel/respond",{params:{path:{deploymentId:e}},body:i,headers:d,signal:u});return m?n(m,c):{ok:!0,value:void 0}}}};

package/dist/phoenix/services/webhook-service/tunnel.d.ts

@@ -46,6 +46,7 @@ export interface TunnelRespondRequest {
     readonly status: number;
     readonly headers?: Readonly<Record<string, string>>;
     readonly body: string;
+    readonly isBase64Encoded?: boolean;
     readonly signal: AbortSignal;
 }
 /** Server boundary used by the package-independent tunnel lifecycle. */

package/dist/phoenix/services/webhook-service/tunnel.js

@@ -1 +1 @@
-import{execute as e,getLogger as t,webhookLogContext as r}from"../../webhooks/index.js";export class TunnelTerminalError extends Error{kind;constructor(e,t){super(t),this.kind=e}}let n=async e=>{e.aborted||await new Promise(t=>{let r=()=>{clearTimeout(n),t()},n=setTimeout(()=>{e.removeEventListener("abort",r),t()},5e3);e.addEventListener("abort",r,{once:!0})})},o=e=>new URL(e.url,"http://webhook-tunnel.invalid").searchParams.get("o")??"finalize",s=async(t,n,o)=>{if(o.aborted)return null;let s=()=>void 0,a=new Promise(e=>{(s=()=>e(null),o.aborted)?s():o.addEventListener("abort",s,{once:!0})}),i=(async()=>{try{var o,s;let a=await r.run("webhook",()=>{let r;return e({lambdaPath:n.bundle,lambdaHandler:n.handler,esm:!1,event:(r=new URL(t.url,"http://webhook-tunnel.invalid"),{version:"2.0",routeKey:"$default",rawPath:r.pathname,rawQueryString:r.search,cookies:[],headers:t.headers,queryStringParameters:Object.fromEntries(r.searchParams),requestContext:{accountId:"123456789012",apiId:"api-id",authentication:{},authorizer:{},http:{method:t.method,path:r.pathname,protocol:"HTTP/1.1",sourceIp:"127.0.0.1",userAgent:"phoenix-webhook-tunnel"},requestId:t.requestId,routeKey:"$default",stage:"$default",time:new Date().toISOString(),timeEpoch:Date.now()},body:t.body??void 0,isBase64Encoded:!1}),verboseLevel:n.verbosity??0,timeoutMs:6e4})});if((o=a)&&"object"==typeof o&&"statusCode"in o&&"number"==typeof o.statusCode&&(!("headers"in o)||void 0===o.headers||(s=o.headers)&&"object"==typeof s&&Object.values(s).every(e=>"string"==typeof e)))return{status:a.statusCode,headers:a.headers,body:"string"==typeof a.body?a.body:JSON.stringify(a.body??""),error:null};return{status:200,body:JSON.stringify(a)??"",error:null}}catch(t){let e=t instanceof Error?t.message:String(t);return{status:500,body:JSON.stringify({message:e}),error:e}}})(),l=await Promise.race([i,a]);return o.removeEventListener("abort",s),l};export const startTunnel=e=>{let{transport:r,rejectionHint:a,environmentSlug:i,deploymentId:l,sessionId:d,pollLoops:u=2,onStatus:c,onRequest:h}=e,m=t(),f=new AbortController,p=!1,y=!1,w=!1,b=0,g=null,v=null,$=[],k=new Set,T=e=>void 0,q=new Promise((e,t)=>{T=t}),E=(e,t)=>{m.log(e,t)},I=(e,t)=>{try{c?.(e,t)}catch{}},S=e=>{try{h?.(e)}catch{}},P=e=>(g||(g=e,p=!0,f.abort(),E("error",e.message),I("conflict"===e.kind?"conflict":"error",e.message)),g),x=e=>{w=!0,E("warn",e),I("error",e)},W=()=>new TunnelTerminalError("conflict",`Webhook tunnel for environment ${i} (deployment ${l}) is owned by another phoenix dev session. Stop the other session and restart.`),R=e=>new TunnelTerminalError("rejected",`${e} ${a}`),D=async(e,t)=>{for(;!p;){try{let n=await r.respond({deploymentId:l,sessionId:d,requestId:e.requestId,status:t.status,headers:t.headers,body:t.body,signal:f.signal});if(n.ok)return;if(403===n.status)throw P(W());if(404===n.status)throw P(new TunnelTerminalError("stale",n.message));if(n.status<500)throw P(R(n.message));x(`Webhook tunnel response could not reach the server: ${n.message} Retrying in 5 seconds.`)}catch(e){if(e instanceof TunnelTerminalError)throw e;if(p)return;x(`Webhook tunnel response could not reach the server: ${e instanceof Error?e.message:String(e)} Retrying in 5 seconds.`)}await n(f.signal)}},L=e=>{let t=o(e),r=Date.now();w&&(b+=1),E("warn",`Tunneled ${t} request ${e.requestId} skipped because its deadline expired.`),S({requestId:e.requestId,operation:t,method:e.method,url:e.url,startedAt:r,durationMs:0,outcome:"skipped-expired",responseStatus:null,requestBody:e.body,responseBody:null,error:"Request deadline expired before phoenix dev picked it up."})},j=async t=>{let r=o(t),n=Date.now(),a=await s(t,e,f.signal);if(!a)return;let i=Date.now()-n,l=a.error?"failed":"served";E(a.error?"warn":"info",`Tunneled ${r} request ${t.requestId} ${l} in ${i}ms (status ${a.status}).`),S({requestId:t.requestId,operation:r,method:t.method,url:t.url,startedAt:n,durationMs:i,outcome:l,responseStatus:a.status,requestBody:t.body,responseBody:a.body,error:a.error}),await D(t,a)},O=()=>{for(;!p&&k.size<u;){let e=$.shift();if(!e)return;if(e.deadline<Date.now()){L(e);continue}let t=j(e);k.add(t),t.then(()=>{k.delete(t),O()},e=>{k.delete(t),T(e)})}},B=async e=>{let t=0;for(;!p;)try{let o=await r.poll({deploymentId:l,sessionId:d,signal:f.signal});if(!o.ok){if(409===o.status){if(y||t>=3)throw P(W());t+=1,0===e&&E("warn",`Webhook tunnel for environment ${i} is already claimed. Retrying in 5 seconds (${t}/3).`)}else if(403===o.status)throw P(R(o.message));else if(404===o.status)throw P(new TunnelTerminalError("stale",o.message));else if(o.status<500)throw P(R(o.message));else x(`Webhook tunnel poll failed: ${o.message} Retrying in 5 seconds.`);await n(f.signal);continue}t=0;let s=o.value,a=!!s&&s.deadline<Date.now();s&&a&&L(s),y||(y=!0,E("info",`Webhook tunnel connected for environment ${i} (deployment ${l}, session ${d}).`)),w&&(E("info",`Webhook tunnel reconnected${b>0?`; ${b} queued request(s) expired and were skipped during the interruption.`:"."}`),w=!1,b=0),I("connected"),s&&!a&&($.push(s),O())}catch(e){if(e instanceof TunnelTerminalError)throw e;if(p)return;x(`Webhook tunnel poll could not reach the server: ${e instanceof Error?e.message:String(e)} Retrying in 5 seconds.`),await n(f.signal)}};I("waiting");let C=Promise.race([Promise.all(Array.from({length:u},(e,t)=>B(t))).then(async()=>{await Promise.all(k)}),q]);return{sessionId:d,stop:()=>v||(p=!0,f.abort(),E("info",`Webhook tunnel stopped for environment ${i} (deployment ${l}).`),I("stopped"),v=C.catch(e=>{if(!(e instanceof TunnelTerminalError))throw e})),stopped:C}};
+import{execute as e,getLogger as t,webhookLogContext as r}from"../../webhooks/index.js";export class TunnelTerminalError extends Error{kind;constructor(e,t){super(t),this.kind=e}}let n=async e=>{e.aborted||await new Promise(t=>{let r=()=>{clearTimeout(n),t()},n=setTimeout(()=>{e.removeEventListener("abort",r),t()},5e3);e.addEventListener("abort",r,{once:!0})})},o=e=>new URL(e.url,"http://webhook-tunnel.invalid").searchParams.get("o")??"finalize",s=async(t,n,o)=>{if(o.aborted)return null;let s=()=>void 0,a=new Promise(e=>{(s=()=>e(null),o.aborted)?s():o.addEventListener("abort",s,{once:!0})}),i=(async()=>{try{var o,s;let a=await r.run("webhook",()=>{let r;return e({lambdaPath:n.bundle,lambdaHandler:n.handler,esm:!1,event:(r=new URL(t.url,"http://webhook-tunnel.invalid"),{version:"2.0",routeKey:"$default",rawPath:r.pathname,rawQueryString:r.search,cookies:[],headers:t.headers,queryStringParameters:Object.fromEntries(r.searchParams),requestContext:{accountId:"123456789012",apiId:"api-id",authentication:{},authorizer:{},http:{method:t.method,path:r.pathname,protocol:"HTTP/1.1",sourceIp:"127.0.0.1",userAgent:"phoenix-webhook-tunnel"},requestId:t.requestId,routeKey:"$default",stage:"$default",time:new Date().toISOString(),timeEpoch:Date.now()},body:t.body??void 0,isBase64Encoded:!1}),verboseLevel:n.verbosity??0,timeoutMs:6e4})});if((o=a)&&"object"==typeof o&&"statusCode"in o&&"number"==typeof o.statusCode&&(!("headers"in o)||void 0===o.headers||(s=o.headers)&&"object"==typeof s&&Object.values(s).every(e=>"string"==typeof e)))return{status:a.statusCode,...void 0!==a.isBase64Encoded&&{isBase64Encoded:a.isBase64Encoded},headers:a.headers,body:"string"==typeof a.body?a.body:JSON.stringify(a.body??""),error:null};return{status:200,body:JSON.stringify(a)??"",error:null}}catch(t){let e=t instanceof Error?t.message:String(t);return{status:500,body:JSON.stringify({message:e}),error:e}}})(),d=await Promise.race([i,a]);return o.removeEventListener("abort",s),d};export const startTunnel=e=>{let{transport:r,rejectionHint:a,environmentSlug:i,deploymentId:d,sessionId:l,pollLoops:u=2,onStatus:c,onRequest:h}=e,m=t(),f=new AbortController,y=!1,p=!1,w=!1,b=0,g=null,v=null,$=[],E=new Set,T=e=>void 0,k=new Promise((e,t)=>{T=t}),q=(e,t)=>{m.log(e,t)},B=(e,t)=>{try{c?.(e,t)}catch{}},I=e=>{try{h?.(e)}catch{}},S=e=>(g||(g=e,y=!0,f.abort(),q("error",e.message),B("conflict"===e.kind?"conflict":"error",e.message)),g),P=e=>{w=!0,q("warn",e),B("error",e)},x=()=>new TunnelTerminalError("conflict",`Webhook tunnel for environment ${i} (deployment ${d}) is owned by another phoenix dev session. Stop the other session and restart.`),W=e=>new TunnelTerminalError("rejected",`${e} ${a}`),L=async(e,t)=>{for(;!y;){try{let n=await r.respond({deploymentId:d,sessionId:l,requestId:e.requestId,status:t.status,headers:t.headers,body:t.body,...void 0!==t.isBase64Encoded&&{isBase64Encoded:t.isBase64Encoded},signal:f.signal});if(n.ok)return;if(413===n.status)throw S(new TunnelTerminalError("rejected",n.message));if(403===n.status)throw S(x());if(404===n.status)throw S(new TunnelTerminalError("stale",n.message));if(n.status<500)throw S(W(n.message));P(`Webhook tunnel response could not reach the server: ${n.message} Retrying in 5 seconds.`)}catch(e){if(e instanceof TunnelTerminalError)throw e;if(y)return;P(`Webhook tunnel response could not reach the server: ${e instanceof Error?e.message:String(e)} Retrying in 5 seconds.`)}await n(f.signal)}},R=e=>{let t=o(e),r=Date.now();w&&(b+=1),q("warn",`Tunneled ${t} request ${e.requestId} skipped because its deadline expired.`),I({requestId:e.requestId,operation:t,method:e.method,url:e.url,startedAt:r,durationMs:0,outcome:"skipped-expired",responseStatus:null,requestBody:e.body,responseBody:null,error:"Request deadline expired before phoenix dev picked it up."})},j=async t=>{let r=o(t),n=Date.now(),a=await s(t,e,f.signal);if(!a)return;let i=Date.now()-n,d=a.error?"failed":"served";q(a.error?"warn":"info",`Tunneled ${r} request ${t.requestId} ${d} in ${i}ms (status ${a.status}).`),I({requestId:t.requestId,operation:r,method:t.method,url:t.url,startedAt:n,durationMs:i,outcome:d,responseStatus:a.status,requestBody:t.body,responseBody:a.isBase64Encoded?`[Binary response omitted: ${Buffer.byteLength(a.body,"utf8")} encoded bytes]`:a.body,error:a.error}),await L(t,a)},D=()=>{for(;!y&&E.size<u;){let e=$.shift();if(!e)return;if(e.deadline<Date.now()){R(e);continue}let t=j(e);E.add(t),t.then(()=>{E.delete(t),D()},e=>{E.delete(t),T(e)})}},O=async e=>{let t=0;for(;!y;)try{let o=await r.poll({deploymentId:d,sessionId:l,signal:f.signal});if(!o.ok){if(409===o.status){if(p||t>=3)throw S(x());t+=1,0===e&&q("warn",`Webhook tunnel for environment ${i} is already claimed. Retrying in 5 seconds (${t}/3).`)}else if(403===o.status)throw S(W(o.message));else if(404===o.status)throw S(new TunnelTerminalError("stale",o.message));else if(o.status<500)throw S(W(o.message));else P(`Webhook tunnel poll failed: ${o.message} Retrying in 5 seconds.`);await n(f.signal);continue}t=0;let s=o.value,a=!!s&&s.deadline<Date.now();s&&a&&R(s),p||(p=!0,q("info",`Webhook tunnel connected for environment ${i} (deployment ${d}, session ${l}).`)),w&&(q("info",`Webhook tunnel reconnected${b>0?`; ${b} queued request(s) expired and were skipped during the interruption.`:"."}`),w=!1,b=0),B("connected"),s&&!a&&($.push(s),D())}catch(e){if(e instanceof TunnelTerminalError)throw e;if(y)return;P(`Webhook tunnel poll could not reach the server: ${e instanceof Error?e.message:String(e)} Retrying in 5 seconds.`),await n(f.signal)}};B("waiting");let C=Promise.race([Promise.all(Array.from({length:u},(e,t)=>O(t))).then(async()=>{await Promise.all(E)}),k]);return{sessionId:l,stop:()=>v||(y=!0,f.abort(),q("info",`Webhook tunnel stopped for environment ${i} (deployment ${d}).`),B("stopped"),v=C.catch(e=>{if(!(e instanceof TunnelTerminalError))throw e})),stopped:C}};

package/dist/react-sdk/application-runtime/domain-application-context/chat-system.d.ts

@@ -29,7 +29,7 @@ export interface SendVoiceMessageParams<CHAT_CONTEXT extends Record<string, unkn
  * Runtime chat service consumed only by the legacy configurator chat UI. Its user-facing consumers
  * live under `configurator/ui/legacy/`: `Chat` is reached through `MobileChat`, `TabsSidebar`,
  * `StepsSideBar`, and `SimpleSidebar`, with availability gated by
- * `configurator/configurator-context/configurator-hooks/chat-hooks.ts`.
+ * `react-sdk/domain-application-context/chat-hooks.ts`.
  *
  * `sendMessage` deliberately retains a known reinitialization race. Its `ChunkType.calls`
  * continuation does not recheck the captured generation after `processToolCalls` before publishing

package/dist/{configurator/configurator-context → react-sdk}/configurator-routing/ConfiguratorRoutingProvider.d.ts

@@ -3,7 +3,7 @@ import type { ReactNode } from 'react';
  * This is probably a temporary solution, we may need an actual routing library in the future.
  * @beta
  */
-export declare const useConfiguratorRouting: () => import("#package/react-sdk").RoutingService;
+export declare const useConfiguratorRouting: () => import("../index.js").RoutingService;
 export type UseConfiguratorRouting = typeof useConfiguratorRouting;
 export interface ConfiguratorRoutingProviderProps {
     readonly children: ReactNode;

package/dist/react-sdk/configurator-routing/ConfiguratorRoutingProvider.js

@@ -0,0 +1 @@
+import{jsx as r,Fragment as t}from"react/jsx-runtime";import{useCallback as o,useEffect as e,useLayoutEffect as n,useState as i}from"react";import{standardWebComponentEvents as a,standardWebComponentProperties as u}from"#package/domain";import{ApplicationRoutes as g,INTEGRATION_MODE_SETTINGS as s,setConfigurationIdQuery as m,useDispatchWebComponentEvent as d,useRoutingSelectors as l,useRoutingService as c,useWebComponentProperty$ as f,useWebComponentPropertyValue as p}from"../application-runtime/index.js";import{useOnGoToIndexHandler as x}from"./OnGoToIndexHandler.js";export const useConfiguratorRouting=()=>c();export const ConfiguratorRoutingProvider=T=>{let{children:b}=T,j=c(),v=l(),C=x(),I=p(u.integrationMode),O=f(u.route),R=d(a.navigated),h=o(r=>{O.next(r),s[I].writeCidToUrl&&(r.route===g.Configuration?m(r.configurationId):m(null)),R(r)},[R,I,O]),[G,k]=i(!1),w=C?.handler;return(e(()=>{if(w)return j.registerOnGoToIndex(w)},[j,w]),e(()=>j.registerOnNavigated(h),[j,h]),n(()=>{j.routeTo(O.value),k(!0)},[j,O,I]),e(()=>{let r=O.subscribe(r=>{v.getRoutingState()!==r&&j.routeTo(r)});return()=>{r.unsubscribe()}},[j,v,O]),G)?r(t,{children:b}):null};

package/dist/{configurator/configurator-context → react-sdk}/configurator-routing/OnGoToIndexHandler.d.ts

@@ -1,6 +1,5 @@
 import type { SystemPhoenixHandlerRegistration } from '#package/domain';
-import { type OnGoToIndexContext, type OnGoToIndexHandler } from '#package/react-sdk';
-export type { OnGoToIndexContext, OnGoToIndexHandler } from '#package/react-sdk';
+import type { OnGoToIndexContext, OnGoToIndexHandler } from '../application-runtime/index.js';
 export declare const createOnGoToIndexHandler: (hook: () => {
     handler: OnGoToIndexHandler;
 }) => SystemPhoenixHandlerRegistration<OnGoToIndexContext, void>;

package/dist/react-sdk/configurator-routing/OnGoToIndexHandler.js

@@ -0,0 +1 @@
+import{createSystemPhoenixHandler as o}from"#package/domain";import{useSystemPhoenixHandler as e}from"../handlers/index.js";let n="OnGoToIndex";export const createOnGoToIndexHandler=e=>o(n,e);export const useOnGoToIndexHandler=()=>e(n);

package/dist/react-sdk/configurator-routing/index.d.ts

@@ -0,0 +1,3 @@
+export { ConfiguratorRoutingProvider, useConfiguratorRouting, type UseConfiguratorRouting, } from './ConfiguratorRoutingProvider.js';
+export { createOnGoToIndexHandler, useOnGoToIndexHandler, type CreateOnGoToIndexHandler } from './OnGoToIndexHandler.js';
+export { usePowerRoutingLifecycle } from './use-power-routing-lifecycle.js';

package/dist/{configurator/configurator-context → react-sdk}/configurator-routing/index.js

@@ -1 +1 @@
-export{ConfiguratorRoutingProvider,useConfiguratorRouting}from"./ConfiguratorRoutingProvider.js";export{createOnGoToIndexHandler,useOnGoToIndexHandler}from"./OnGoToIndexHandler.js";
+export{ConfiguratorRoutingProvider,useConfiguratorRouting}from"./ConfiguratorRoutingProvider.js";export{createOnGoToIndexHandler,useOnGoToIndexHandler}from"./OnGoToIndexHandler.js";export{usePowerRoutingLifecycle}from"./use-power-routing-lifecycle.js";

package/dist/{configurator/configurator-context → react-sdk}/configurator-routing/use-power-routing-lifecycle.d.ts

@@ -5,5 +5,7 @@
  * - When power goes from "on" to "off"
  *   - reset route to Index (resetRouteOnPowerDown setting)
  *   - clear `cid` (writeCidToUrl setting)
+ *
+ * @internal Runtime plumbing for the SDK's own configurator application, which runs it at its root.
  */
 export declare const usePowerRoutingLifecycle: () => void;

package/dist/react-sdk/configurator-routing/use-power-routing-lifecycle.js

@@ -0,0 +1 @@
+import{useEffect as e}from"react";import{pairwise as o,startWith as t}from"rxjs";import{match as r}from"ts-pattern";import{standardWebComponentProperties as n}from"#package/domain";import{ApplicationRoutes as i,INTEGRATION_MODE_SETTINGS as a,getAccessTokenFromQuery as u,getConfigurationIdFromQuery as f,setConfigurationIdQuery as s,useRoutingService as l,useWebComponentProperty$ as m,useWebComponentPropertyValue as p}from"../application-runtime/index.js";let d=Symbol("INITIAL_EMISSION");export const usePowerRoutingLifecycle=()=>{let c=p(n.integrationMode),b=m(n.power),w=b.pipe(t(d),o()),x=l(),I=m(n.route);e(()=>{let e=w.subscribe(([e,o])=>{if((e===d||"standby"===e||"off"===e)&&"on"===o&&a[c].readCidAndCaFromUrl){let e=f(),o=u();if(e){let t={route:i.Configuration,configurationId:e,accessToken:o??void 0};I.next(t),x.routeTo(t)}}if("on"===e&&("standby"===o||"off"===o)&&a[c].resetRouteOnPowerDown){let e={route:i.Index};I.next(e),x.routeTo(e),a[c].writeCidToUrl&&s(null)}});return()=>e.unsubscribe()},[w,c,I,x]),e(()=>{r(b.value).with("standby","off",()=>a[c].powerOnOnCid).with("on",()=>!1).exhaustive()&&f()&&b.next("on")},[b,c])};