@salsita-ai/sdk 0.50.0-develop.ae52227c7e → 0.50.0-develop.afbc5157e1

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 r}from"@salsita-ai/common/env";import{generateProjectFiles as o,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 g}from"../lingui-watcher.js";import{LogBus as m}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 r="dev"===e.mode?e.development:void 0,o=r&&(!r.persistenceMode||"server"===r.persistenceMode);this.logsValue="dev"===e.mode?new m:void 0,this.tunnelMonitorValue=o&&r.serverUrl?new P(r.serverUrl):void 0,this.deploymentPreparationValue=o&&r.serverUrl&&r.credential?new h({serverUrl:r.serverUrl,credential:r.credential,projectSlug:r.projectSlug,environmentSlug:r.environmentSlug,sdkVersion:r.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:m,environmentSlug:d,cliUseWorkspace:v,devExperience: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 o({sdkVersion:h,projectSlug:m,environmentSlug:d,cliUseWorkspace:v,pageExperience: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=r("."),t=await p(e);k||t?.PHOENIX_PROJECT_SLUG!==m||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 g({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=r("."),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 o=await x();this.assertStarting();let s=await f({experimental:!0,transport:E({serverUrl:V,credential:W,projectSlug:m,environmentSlug:d}),rejectionHint:u(W,m),environmentSlug:d,deploymentId:t.DEPLOYMENT_ID,sessionId:o,onStatus:(e,r)=>{_?.setStatus(e,{deploymentId:t.DEPLOYMENT_ID,sessionId:o,message:r??null})},onRequest:e=>_?.record(e)});this.closePromise&&(await s.stop(),this.assertStarting()),this.webhookTunnel=s,_?.setStatus("waiting",{deploymentId:t.DEPLOYMENT_ID,sessionId:o}),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:m,environmentSlug:d,cliUseWorkspace:v,pageExperience:w,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}),"plain"!==w&&void 0!==this.props.editorPort&&await this.startEditor();let C=await S({templateFiles:D,agentMode:"agent"===w}),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()}],r=[];for(let o of t)try{"dev"===this.mode&&e.debug(`Shutting down ${o.name}`),await o.close()}catch(s){let t=s instanceof Error?s.message:String(s);"story"===this.mode?e.warn(`Failed to close the story-dev ${o.name}: ${t}. The process will continue shutting down.`):r.push(`${o.name}: ${t}`)}this.browserConsoleSubscription?.unsubscribe(),this.failures$.complete(),r.length>0&&e.warn(`Cleanup warnings:
+  ${r.join("\n  ")}`),"dev"===this.mode&&e.debug("Shutdown complete")}}

package/dist/phoenix/services/source-archive.d.ts

@@ -3,6 +3,9 @@ export interface SourceArchive {
     readonly path: string;
     readonly fileCount: number;
     readonly size: number;
+    readonly hasConversationLog: boolean;
+    /** Regular files packed from the project's `docs/` folder, which travel privately and are never published. */
+    readonly documentFileCount: number;
     readonly cleanup: () => Promise<void>;
 }
 /** What `extractSourceArchive` wrote and what it left out. */

package/dist/phoenix/services/source-archive.js

@@ -1 +1 @@
-import{execFile as e}from"node:child_process";import{createReadStream as r,createWriteStream as t}from"node:fs";import{lstat as o,mkdir as i,mkdtemp as a,readdir as n,rm as s,stat as c,writeFile as l}from"node:fs/promises";import{tmpdir as h}from"node:os";import{dirname as p,join as f}from"node:path";import{Transform as d}from"node:stream";import{pipeline as w}from"node:stream/promises";import{promisify as m}from"node:util";import{createGunzip as u}from"node:zlib";import{extract as g}from"tar-stream";import{isProjectFile as y,listProjectEntries as v}from"../application-spec/project-files.js";let x=m(e);export const createSourceArchive=async e=>{let r=await Promise.all((await v(e)).map(async r=>({name:r,entry:await o(f(e,r))}))),t=r.filter(({entry:e})=>!e.isDirectory()&&(!e.isFile()||e.nlink>1)),i=r.filter(({entry:e})=>e.isFile()).map(({name:e})=>e);if(t.length>0)throw Error(`These project files are links or special files, which builds do not accept: ${t.map(({name:e})=>e).join(", ")}. Replace them with regular files and deploy again.`);if(0===i.length)throw Error(`No project files were found in ${e}, so there is nothing to deploy. Run phoenix deploy in the folder of an application-spec project.`);let n=await a(f(h(),"phoenix-deploy-")),p="sources.tgz",d=f(n,p),w=f(n,"files");try{await l(w,i.join("\0")),await x("tar",["-czf",p,"-C",e,"--null","-T",w],{cwd:n,env:{...process.env,COPYFILE_DISABLE:"1"}})}catch(r){await s(n,{recursive:!0,force:!0});let e=r instanceof Error?r.message:String(r);throw Error(`Packing the project with tar failed: ${e}. Check that tar is installed and on the PATH.`)}return{path:d,fileCount:i.length,size:(await c(d)).size,cleanup:()=>s(n,{recursive:!0,force:!0})}};let E=(e,...r)=>e instanceof Error&&"code"in e&&"string"==typeof e.code&&r.includes(e.code),j=async e=>{try{return 0===(await n(e)).length}catch(e){if(E(e,"ENOENT"))return!0;throw e}},T=class ArchiveRefusal extends Error{},b=e=>e.length>0&&!e.startsWith("/")&&!e.includes("\\")&&!/^[A-Za-z]:/.test(e)&&!/[\x00-\x1f\x7f]/.test(e)&&!e.split("/").includes("..");export const extractSourceArchive=async e=>{let o,a,{archivePath:n,targetDir:l}=e,h=(await c(n)).size;if(h>0xc800000)throw Error(`The source archive is ${h} bytes, over the 209715200 byte limit. Remove large files from the project and deploy again.`);if(!await j(l))throw Error(`The folder ${l} is not empty, and extracted sources must not mix with existing files. Extract into a new or empty folder.`);let m=g(),v=new AbortController,x=w(r(n),u(),(a=0,new d({transform(e,r,t){(a+=e.length)>0x40000000?t(new T("The source archive extracts to more than 1073741824 bytes. Remove large files from the project and deploy again.")):t(null,e)}})),m).catch(e=>{o??=e,v.abort()}),$=[],z=0,R=0;try{for await(let e of m){let{type:r}=e.header,o=e.header.name.replace(/^(\.\/)+/,""),a=JSON.stringify(o);if("directory"===r){e.resume();continue}if((R+=1)>1e5)throw new T("The source archive has more than 100000 files. Remove generated or unused files from the project and deploy again.");if(!b(o))throw new T(`The source archive contains ${a}, which is not a plain relative path inside the project. Pack the project with phoenix deploy.`);if("file"!==r)throw new T(`The source archive contains ${a}, which is a ${r??"special file"}. Builds accept only regular files; replace it with a regular file and deploy again.`);if(!y(o)){$.push(o),e.resume();continue}let n=f(l,...o.split("/"));try{await i(p(n),{recursive:!0}),await w(e,t(n,{flags:"wx"}),{signal:v.signal})}catch(e){if(E(e,"EEXIST","ENOTDIR","EISDIR"))throw new T(`The source archive contains ${a}, which repeats or collides with an earlier entry, so its content is ambiguous. Pack the project with phoenix deploy.`);throw e}z+=1}if(await x,void 0!==o)throw o}catch(t){let e=t instanceof T?t:o??t;if(m.destroy(),await x,await s(l,{recursive:!0,force:!0}),e instanceof T)throw e;let r=e instanceof Error?e.message:String(e);throw Error(`The source archive could not be read: ${r}. It is truncated or not a gzip tarball; pack the project with phoenix deploy.`)}return{fileCount:z,skipped:$}};
+import{execFile as e}from"node:child_process";import{createReadStream as r,createWriteStream as t}from"node:fs";import{lstat as o,mkdir as i,mkdtemp as a,readdir as n,rm as s,stat as c,writeFile as l}from"node:fs/promises";import{tmpdir as h}from"node:os";import{dirname as p,join as f}from"node:path";import{Transform as d}from"node:stream";import{pipeline as w}from"node:stream/promises";import{promisify as m}from"node:util";import{createGunzip as u}from"node:zlib";import{extract as g}from"tar-stream";import{isProjectFile as y,listProjectDocumentEntries as v,listProjectEntries as x,listProjectWorkspaceEntries as E}from"../application-spec/index.js";let j=m(e);export const createSourceArchive=async e=>{let r=(await n(e)).includes("conversation.log"),t=await x(e),i=await E(e),p=await v(e),d=[...t,...i,...p,...r?["conversation.log"]:[]],w=await Promise.all(d.map(async r=>({name:r,entry:await o(f(e,r))})));if(w.some(({name:e,entry:r})=>"conversation.log"===e&&r.isDirectory()))throw Error("conversation.log is a directory. Replace it with a regular transcript file and deploy again.");let m=w.filter(({entry:e})=>!e.isDirectory()&&(!e.isFile()||e.nlink>1)),u=w.filter(({entry:e})=>e.isFile()).map(({name:e})=>e),g=new Set(p);if(m.length>0)throw Error(`These project files are links or special files, which builds do not accept: ${m.map(({name:e})=>e).join(", ")}. Replace them with regular files and deploy again.`);if(!u.some(y))throw Error(`No project files were found in ${e}, so there is nothing to deploy. Run phoenix deploy in the folder of an application-spec project.`);let T=await a(f(h(),"phoenix-deploy-")),b="sources.tgz",$=f(T,b),R=f(T,"files");try{await l(R,u.join("\0")),await j("tar",["-czf",b,"-C",e,"--null","-T",R],{cwd:T,env:{...process.env,COPYFILE_DISABLE:"1"}})}catch(r){await s(T,{recursive:!0,force:!0});let e=r instanceof Error?r.message:String(r);throw Error(`Packing the project with tar failed: ${e}. Check that tar is installed and on the PATH.`)}return{path:$,fileCount:u.length,size:(await c($)).size,hasConversationLog:r,documentFileCount:u.filter(e=>g.has(e)).length,cleanup:()=>s(T,{recursive:!0,force:!0})}};let T=(e,...r)=>e instanceof Error&&"code"in e&&"string"==typeof e.code&&r.includes(e.code),b=async e=>{try{return 0===(await n(e)).length}catch(e){if(T(e,"ENOENT"))return!0;throw e}},$=class ArchiveRefusal extends Error{},R=e=>e.length>0&&!e.startsWith("/")&&!e.includes("\\")&&!/^[A-Za-z]:/.test(e)&&!/[\x00-\x1f\x7f]/.test(e)&&!e.split("/").includes("..");export const extractSourceArchive=async e=>{let o,a,{archivePath:n,targetDir:l}=e,h=(await c(n)).size;if(h>0xc800000)throw Error(`The source archive is ${h} bytes, over the 209715200 byte limit. Remove large files from the project and deploy again.`);if(!await b(l))throw Error(`The folder ${l} is not empty, and extracted sources must not mix with existing files. Extract into a new or empty folder.`);let m=g(),v=new AbortController,x=w(r(n),u(),(a=0,new d({transform(e,r,t){(a+=e.length)>0x40000000?t(new $("The source archive extracts to more than 1073741824 bytes. Remove large files from the project and deploy again.")):t(null,e)}})),m).catch(e=>{o??=e,v.abort()}),E=[],j=0,S=0;try{for await(let e of m){let{type:r}=e.header,o=e.header.name.replace(/^(\.\/)+/,""),a=JSON.stringify(o);if("directory"===r){e.resume();continue}if((S+=1)>1e5)throw new $("The source archive has more than 100000 files. Remove generated or unused files from the project and deploy again.");if(!R(o))throw new $(`The source archive contains ${a}, which is not a plain relative path inside the project. Pack the project with phoenix deploy.`);if("file"!==r)throw new $(`The source archive contains ${a}, which is a ${r??"special file"}. Builds accept only regular files; replace it with a regular file and deploy again.`);if(!y(o)){E.push(o),e.resume();continue}let n=f(l,...o.split("/"));try{await i(p(n),{recursive:!0}),await w(e,t(n,{flags:"wx"}),{signal:v.signal})}catch(e){if(T(e,"EEXIST","ENOTDIR","EISDIR"))throw new $(`The source archive contains ${a}, which repeats or collides with an earlier entry, so its content is ambiguous. Pack the project with phoenix deploy.`);throw e}j+=1}if(await x,void 0!==o)throw o}catch(t){let e=t instanceof $?t:o??t;if(m.destroy(),await x,await s(l,{recursive:!0,force:!0}),e instanceof $)throw e;let r=e instanceof Error?e.message:String(e);throw Error(`The source archive could not be read: ${r}. It is truncated or not a gzip tarball; pack the project with phoenix deploy.`)}return{fileCount:j,skipped:E}};

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

@@ -1,16 +1,17 @@
 import { type Logger } from '../utils/index.js';
 export interface SwcCompileProps {
-    readonly sourceDir?: string;
-    readonly outDir?: string;
+    readonly sourceDir: string;
+    readonly outDir: string;
+    readonly ignoredPaths: readonly string[];
 }
-export declare const compileWithSwc: (props?: SwcCompileProps, context?: {
+export declare const compileWithSwc: (props: SwcCompileProps, context?: {
     readonly logger: Logger;
 }) => Promise<void>;
 /**
  * Watch mode for SWC compilation
  * Watches for changes in TypeScript files and non-compilable files
  */
-export declare const watchWithSwc: (props?: SwcCompileProps, context?: {
+export declare const watchWithSwc: (props: SwcCompileProps, context?: {
     readonly logger: Logger;
 }) => Promise<{
     stop: () => Promise<void>;

package/dist/phoenix/services/swc.js

@@ -1,3 +1,3 @@
-import{transform as e}from"@swc/core";import{remove as t}from"fs-extra";import{copyFile as s,mkdir as o,readFile as a,writeFile as i}from"fs/promises";import{globby as r}from"globby";import{dirname as c,relative as l,resolve as n}from"path";import{Subject as p}from"rxjs";import{watch as m}from"#package/watch";import{createLogger as w}from"../utils/index.js";let u=()=>({sourceMaps:!0,module:{type:"es6"},jsc:{target:"es2022",parser:{syntax:"typescript",tsx:!0},transform:{react:{runtime:"automatic"}},keepClassNames:!0,experimental:{plugins:[["@lingui/swc-plugin",{}]]}}}),d=async(e,t,a)=>{let i=process.cwd(),p=n(i,e),m=n(i,t),w=await r(["**/*.{html,css,json,txt,md}","**/.env*"],{cwd:p,ignore:["**/*.{spec,test}.{html,css,json,txt,md}","**/__tests__/**","**/__mocks__/**","**/tsconfig.json"],absolute:!1}),u=0,d=0;for(let e of w)try{let t=n(p,e),a=n(m,e);await o(c(a),{recursive:!0}),await s(t,a),u++}catch(t){d++,console.error(`Failed to copy ${l(i,n(p,e))}:`,t)}if(d>0)throw Error(`Failed to copy ${d} file(s)`);u>0&&a.debug(`Copied ${u} non-compilable file(s)`)};export const compileWithSwc=async(s,p)=>{let{sourceDir:m="src",outDir:f="./node_modules/.phoenix"}=s??{},g=p?.logger??w(),h=process.cwd(),x=n(h,m),_=n(h,f);await t(_);let y=await r(["**/*.{ts,tsx}"],{cwd:x,ignore:["**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/__mocks__/**"],absolute:!1}),b=u(),$=0,j=0;for(let t of y)try{let s=n(x,t),r=n(_,t.replace(/\.tsx?$/,".js")),l=await a(s,"utf-8"),p=await e(l,{...b,filename:s,sourceMaps:!0,outputPath:r});await o(c(r),{recursive:!0}),await i(r,p.code,"utf-8"),p.map&&await i(`${r}.map`,p.map,"utf-8"),$++}catch(e){j++,console.error(`Failed to compile ${l(h,n(x,t))}:`,e)}if(j>0)throw Error(`Failed to compile ${j} file(s)`);g.isDebug&&g.debug(`Compiled ${$} file(s) with swc`),await d(m,f,g)};let f=async(t,s,r)=>{let l=process.cwd(),p=n(l,s),m=n(l,r),w=u(),d=n(p,t),f=n(m,t.replace(/\.tsx?$/,".js")),g=await a(d,"utf-8"),h=await e(g,{...w,filename:d,sourceMaps:!0,outputPath:f});await o(c(f),{recursive:!0}),await i(f,h.code,"utf-8"),h.map&&await i(`${f}.map`,h.map,"utf-8")},g=async(e,t,a)=>{let i=process.cwd(),r=n(i,t),l=n(i,a),p=n(r,e),m=n(l,e);await o(c(m),{recursive:!0}),await s(p,m)};export const watchWithSwc=async(e,t)=>{let{sourceDir:s="src",outDir:o="./node_modules/.phoenix"}=e??{},a=t?.logger??w(),i=n(process.cwd(),s);a.isDebug&&a.step("Running initial SWC compilation"),await compileWithSwc({sourceDir:s,outDir:o},t),a.isDebug&&a.success("Initial compilation complete");let r=new p,c=m(["**/*.{ts,tsx,html,css,json,txt,md}","../.env*"],{cwd:i,ignored:["**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/cache.json"],persistent:!0,ignoreInitial:!0});return c.on("all",(e,t)=>{("change"===e||"add"===e)&&r.next({file:t,type:e})}),r.subscribe(async({file:e})=>{let t=l(i,n(i,e));try{e.match(/\.tsx?$/)?(await f(t,s,o),a.fileChanged(t)):(e.match(/\.(html|css|json|txt|md)$/)||e.match(/\.env/))&&(await g(t,s,o),a.fileChanged(t))}catch(e){a.error(`Failed to process ${t}`),a.isDebug&&console.error(e)}}),a.isDebug&&console.log(`
+import{transform as e}from"@swc/core";import{remove as t}from"fs-extra";import{copyFile as s,mkdir as o,readFile as a,writeFile as r}from"fs/promises";import{globby as i}from"globby";import{createRequire as c}from"node:module";import{dirname as l,relative as n,resolve as p}from"path";import{Subject as m}from"rxjs";import{watch as w}from"#package/watch";import{createLogger as u}from"../utils/index.js";let d=()=>({sourceMaps:!0,module:{type:"es6"},jsc:{target:"es2022",parser:{syntax:"typescript",tsx:!0},transform:{react:{runtime:"automatic"}},keepClassNames:!0,experimental:{plugins:[[c(import.meta.url).resolve("@lingui/swc-plugin"),{}]],cacheRoot:"node_modules/.cache/swc"}}}),f=async(e,t,a,r)=>{let c=process.cwd(),m=p(c,e),w=p(c,t),u=await i(["**/*.{html,css,json,txt,md}","**/.env*"],{cwd:m,ignore:[...a,"**/*.{spec,test}.{html,css,json,txt,md}","**/__tests__/**","**/__mocks__/**","**/tsconfig.json",".env.generated"],absolute:!1}),d=0,f=0;for(let e of u)try{let t=p(m,e),a=p(w,e);await o(l(a),{recursive:!0}),await s(t,a),d++}catch(t){f++,console.error(`Failed to copy ${n(c,p(m,e))}:`,t)}if(f>0)throw Error(`Failed to copy ${f} file(s)`);d>0&&r.debug(`Copied ${d} non-compilable file(s)`)};export const compileWithSwc=async(s,c)=>{let{sourceDir:m,outDir:w,ignoredPaths:g}=s,h=c?.logger??u(),_=process.cwd(),x=p(_,m),y=p(_,w);await t(y);let b=await i(["**/*.{ts,tsx}"],{cwd:x,ignore:[...g,"**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/__mocks__/**"],absolute:!1}),$=d(),j=0,v=0;for(let t of b)try{let s=p(x,t),i=p(y,t.replace(/\.tsx?$/,".js")),c=await a(s,"utf-8"),n=await e(c,{...$,filename:s,sourceMaps:!0,outputPath:i});await o(l(i),{recursive:!0}),await r(i,n.code,"utf-8"),n.map&&await r(`${i}.map`,n.map,"utf-8"),j++}catch(e){v++,console.error(`Failed to compile ${n(_,p(x,t))}:`,e)}if(v>0)throw Error(`Failed to compile ${v} file(s)`);h.isDebug&&h.debug(`Compiled ${j} file(s) with swc`),await f(m,w,g,h)};let g=async(t,s,i)=>{let c=process.cwd(),n=p(c,s),m=p(c,i),w=d(),u=p(n,t),f=p(m,t.replace(/\.tsx?$/,".js")),g=await a(u,"utf-8"),h=await e(g,{...w,filename:u,sourceMaps:!0,outputPath:f});await o(l(f),{recursive:!0}),await r(f,h.code,"utf-8"),h.map&&await r(`${f}.map`,h.map,"utf-8")},h=async(e,t,a)=>{let r=process.cwd(),i=p(r,t),c=p(r,a),n=p(i,e),m=p(c,e);await o(l(m),{recursive:!0}),await s(n,m)};export const watchWithSwc=async(e,t)=>{let{sourceDir:s,outDir:o,ignoredPaths:a}=e,r=t?.logger??u(),i=p(process.cwd(),s);r.isDebug&&r.step("Running initial SWC compilation"),await compileWithSwc({sourceDir:s,outDir:o,ignoredPaths:a},t),r.isDebug&&r.success("Initial compilation complete");let c=new m,l=w(["**/*.{ts,tsx,html,css,json,txt,md}","../.env*"],{cwd:i,ignored:[...a,"**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/cache.json"],persistent:!0,ignoreInitial:!0});return l.on("all",(e,t)=>{("change"===e||"add"===e)&&c.next({file:t,type:e})}),c.subscribe(async({file:e})=>{let t=n(i,p(i,e));try{e.match(/\.tsx?$/)?(await g(t,s,o),r.fileChanged(t)):(e.match(/\.(html|css|json|txt|md)$/)||e.match(/\.env/))&&(await h(t,s,o),r.fileChanged(t))}catch(e){r.error(`Failed to process ${t}`),r.isDebug&&console.error(e)}}),r.isDebug&&console.log(`
 👀 Watching ${s} for changes...
-`),{stop:async()=>{await c.close(),a.isDebug&&a.info("SWC watcher stopped")}}};
+`),{stop:async()=>{await l.close(),r.isDebug&&r.info("SWC watcher stopped")}}};

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.d.ts

@@ -8,8 +8,9 @@ export declare const setViteLogSink: (sink: ViteLogSink, options?: ViteLogSinkOp
 /**
  * Get the inline Vite configuration for Phoenix projects
  */
-export declare const getViteDevConfig: (options?: {
+export declare const getViteDevConfig: (options: {
     readonly templateFiles?: readonly string[];
+    readonly agentMode: boolean;
 }) => Promise<InlineConfig>;
 /**
  * Get the inline Vite configuration for Phoenix projects

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

@@ -1 +1 @@
-import{lingui as e}from"@lingui/vite-plugin";import i from"@vitejs/plugin-react";import{mkdir as t,readFile as n,writeFile as r}from"fs/promises";import o from"lodash-es/camelCase.js";import{createRequire as a}from"node:module";import{dirname as s,resolve as m}from"path";import{createLogger as l}from"vite";import p from"vite-plugin-css-injected-by-js";import{isUsingLocalSdk as d}from"../utils/package-info.js";import{loadFrontendConfigModule as f}from"./frontend-config.js";import{phxBannerPlugin as c}from"./phx-banner-plugin.js";import{phxCspNoncePlugin as g}from"./phx-csp-nonce-plugin.js";import{phxGlobalIsolationPlugin as u}from"./phx-global-isolation-plugin.js";import{phxLicensesPlugin as h}from"./phx-licenses-plugin.js";import{phxVariantPreviewsPlugin as S}from"./phx-variant-previews-plugin.js";let b=null;export const setViteLogSink=(e,i={})=>{b={sink:e,echo:i.echo??!1}};let y=["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"],O=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 t=>{var n,r;let o,p,c=d(),g=f(),h=g.readRuntimeConfig(),x=g.frontendBuildConfig,D=Object.fromEntries((t?.templateFiles??[]).map(e=>[e,`.phoenix/${e}`]));return{...b&&{customLogger:(n=b.sink,r=b.echo,o=l(),{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)}),...b.echo?{}:{clearScreen:!1}},mode:"development",optimizeDeps:{exclude:["@swc/wasm-web"],...c&&{entries:["index.html","admin.html",...t?.templateFiles??[]],force:!0}},...c&&{resolve:{alias:(p=a(m(process.cwd(),"package.json")),y.flatMap(e=>{try{let i=s(p.resolve(`${e}/package.json`));return[{find:RegExp(`^${e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}(/|$)`),replacement:`${i}$1`}]}catch{return[]}}))}},plugins:[i({babel:{plugins:["macros"]}}),e(),{name:"vite:runtime-config",apply:(e,i)=>"build"===i.command||"development"===i.mode,config:e=>{let i=g.readRuntimeConfig(),t=g.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)}}}},u({getDeploymentId:()=>O(g.readRuntimeConfig())}),S()],define:{"process.env":{},"import.meta.env.DEV":!0,"import.meta.env.PROD":!1,"phx.frontendEnv":JSON.stringify(h),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(x.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(x.gltfDecoder)},build:{rollupOptions:{input:{index:".phoenix/index.html",admin:".phoenix/admin.html",...D}}},root:m(process.cwd(),"./.phoenix"),server:{watch:{ignored:["./**/*.{ts,tsx}","./.swc/**","../spec/**","../src/**"]}}}};export const getViteBuildConfigs=async a=>{let l=f(),d=l.readRuntimeConfig(),S=l.frontendBuildConfig,b=h(),y=c({sdkVersion:a.sdkVersion,banner:a.banner}),x=[{name:"salsita-configurator",entryFile:"./configurator.ts",mainScriptPath:"./configurator.ts",htmlFiles:["./index.html",...{templateFiles:a.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(f=>({plugins:[i({babel:{plugins:["macros"]}}),e(),p({useStrictCSP:!0}),g(),u({getDeploymentId:()=>O(l.readRuntimeConfig())}),{name:"vite:lib-index",writeBundle:async()=>{if(!f.htmlFiles.length)return;let e="iife"===f.format?`${f.name}.iife.js`:`${f.name}.js`;for(let i of f.htmlFiles){if(f.main&&a.enableEditor&&"./index.html"===i)continue;let o=m("./.phoenix",i),l=m("./.phoenix/dist/frontend",i);await t(s(l),{recursive:!0});let p=(await n(o,"utf-8")).replace(f.mainScriptPath,e);await r(l,p,"utf-8")}}},b,y],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,lib:{entry:f.entryFile,name:o(f.name),formats:[f.format],fileName:()=>"iife"===f.format?`${f.name}.iife.js`:`${f.name}.js`},rollupOptions:{external:[],output:{assetFileNames:`${f.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(d),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(S.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(S.gltfDecoder)}}));return a.enableEditor?[...x,{plugins:[i({babel:{plugins:["macros"]}}),e(),p({useStrictCSP:!0}),g(),b,y],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(d),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(S.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(S.gltfDecoder)}}]:x};
+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 d}from"node:module";import{dirname as f,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:[d(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=d(c(process.cwd(),"package.json")),P.flatMap(e=>{try{let i=f(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/**"]},hmr:{overlay:!e.agentMode}}}};export const getViteBuildConfigs=async e=>{let i=b(),s=i.readRuntimeConfig(),l=i.frontendBuildConfig,m=j(),p=D(),d=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(f(s),{recursive:!0});let l=(await r(a,"utf-8")).replace(g.mainScriptPath,i);await o(s,l,"utf-8")}}},p,d],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,d],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/phoenix/utils/index.d.ts

@@ -6,8 +6,10 @@ export { createDirectoryFromYaml, exists, scanFolderForFiles, syncChangedFiles,
 export { FileLogger } from './file-logger.js';
 export { isInsideGitRepository } from './git/index.js';
 export { type Logger, type CreateLoggerOptions, createLogger } from './logger.js';
-export { addWorkspaceOverrides, ensureWorkspaceInstallSettings, getLocalOverrides, getSdkPackages, getWorkspaceDir, hasLocalOverrides, readPackageJson, removeWorkspaceOverrides, } from './package-info.js';
+export { addWorkspaceOverrides, getLocalOverrides, getSdkPackages, getWorkspaceDir, hasLocalOverrides, readPackageJson, removeWorkspaceOverrides, } from './package-info.js';
+export { naturalCompare } from './natural-compare.js';
+export { type PackageManagerCommands, assertPnpmProject, findPackageManagerCommands } from './package-manager/index.js';
 export { toPascalCase } from './pascal-case.js';
 export { readGitCommit } from './read-git-commit.js';
-export { type RunCommandProps, runCommand } from './run-command.js';
+export { type RunCommandProps, type RunSdkToolProps, runCommand, runSdkTool } from './run-command.js';
 export { type FileUploadInfo, type UploadLinksData, uploadFilesWithPresignedUrls, readUploadLinks, } from './upload-utils.js';

package/dist/phoenix/utils/index.js

@@ -1 +1 @@
-export{askQuestion}from"./ask-question.js";export{checkBundleSizeBudgets}from"./check-bundle-size-budgets.js";export{formatEnvContent,formatEnvLine}from"./env-file.js";export{parseChangelog,getLatestVersion,getVersion,paginateVersions,getVersionNumbers}from"./changelog-parser.js";export{createDirectoryFromYaml,exists,scanFolderForFiles,syncChangedFiles,syncExistingFolders,validateFolders,writeFileIfNotExists,writeFilesIfNotExists,writeRawFiles}from"./file-system.js";export{FileLogger}from"./file-logger.js";export{isInsideGitRepository}from"./git/index.js";export{createLogger}from"./logger.js";export{addWorkspaceOverrides,ensureWorkspaceInstallSettings,getLocalOverrides,getSdkPackages,getWorkspaceDir,hasLocalOverrides,readPackageJson,removeWorkspaceOverrides}from"./package-info.js";export{toPascalCase}from"./pascal-case.js";export{readGitCommit}from"./read-git-commit.js";export{runCommand}from"./run-command.js";export{uploadFilesWithPresignedUrls,readUploadLinks}from"./upload-utils.js";
+export{askQuestion}from"./ask-question.js";export{checkBundleSizeBudgets}from"./check-bundle-size-budgets.js";export{formatEnvContent,formatEnvLine}from"./env-file.js";export{parseChangelog,getLatestVersion,getVersion,paginateVersions,getVersionNumbers}from"./changelog-parser.js";export{createDirectoryFromYaml,exists,scanFolderForFiles,syncChangedFiles,syncExistingFolders,validateFolders,writeFileIfNotExists,writeFilesIfNotExists,writeRawFiles}from"./file-system.js";export{FileLogger}from"./file-logger.js";export{isInsideGitRepository}from"./git/index.js";export{createLogger}from"./logger.js";export{addWorkspaceOverrides,getLocalOverrides,getSdkPackages,getWorkspaceDir,hasLocalOverrides,readPackageJson,removeWorkspaceOverrides}from"./package-info.js";export{naturalCompare}from"./natural-compare.js";export{assertPnpmProject,findPackageManagerCommands}from"./package-manager/index.js";export{toPascalCase}from"./pascal-case.js";export{readGitCommit}from"./read-git-commit.js";export{runCommand,runSdkTool}from"./run-command.js";export{uploadFilesWithPresignedUrls,readUploadLinks}from"./upload-utils.js";

package/dist/phoenix/utils/node-version/index.d.ts

@@ -0,0 +1 @@
+export { assertSupportedNodeVersion, findUnsupportedNodeVersionMessage } from './supported-node-version.js';

package/dist/phoenix/utils/node-version/index.js

@@ -0,0 +1 @@
+export{assertSupportedNodeVersion,findUnsupportedNodeVersionMessage}from"./supported-node-version.js";

package/dist/phoenix/utils/node-version/supported-node-version.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Explains why the SDK cannot run on the given Node.js version, or returns `undefined` when the version satisfies the
+ * SDK's `engines.node` range.
+ */
+export declare const findUnsupportedNodeVersionMessage: (version: string) => string | undefined;
+/**
+ * Stops the process with a non-zero exit code when the running Node.js does not satisfy the SDK's `engines.node`
+ * range. The `phoenix` binary's entry module (`bin.ts`) calls it and only then loads `cli.ts` with a dynamic import:
+ * static imports are evaluated before the importing module's body, so on an older Node.js the CLI's own imports could
+ * fail with an unrelated error before a check in its body ran.
+ */
+export declare const assertSupportedNodeVersion: () => void;

package/dist/phoenix/utils/node-version/supported-node-version.js

@@ -0,0 +1,4 @@
+import{readFileSync as e}from"node:fs";import{satisfies as o}from"semver";import{z as s}from"zod";let r=s.object({name:s.string(),engines:s.object({node:s.string()})});export const findUnsupportedNodeVersionMessage=s=>{let{name:t,engines:n}=r.parse(JSON.parse(e(new URL("../../../../package.json",import.meta.url),"utf-8")));if(!o(s,n.node,{includePrerelease:!0}))return`${t} requires Node.js ${n.node}, but this is Node.js ${s}.
+The SDK and the tools it runs use Node.js features that older versions do not have, so a command would fail part way through.
+Switch to a Node.js version that satisfies ${n.node} and run the command again.`};export const assertSupportedNodeVersion=()=>{let e=findUnsupportedNodeVersionMessage(process.version);void 0!==e&&(process.stderr.write(`${e}
+`),process.exit(1))};

package/dist/phoenix/utils/package-info.d.ts

@@ -10,15 +10,6 @@ export declare const readPackageJson: (path?: string) => PackageJson;
 export declare const getWorkspaceDir: () => string;
 export declare const addWorkspaceOverrides: (entries: Record<string, string>) => void;
 export declare const removeWorkspaceOverrides: (names: readonly string[]) => void;
-/**
- * Makes a standalone project installable with pnpm 11: its `pnpm-workspace.yaml` decides the build scripts of the
- * SDK's dependencies and exempts the SDK's own packages from the minimum release age. Only missing answers are
- * added, so a value the project set stays, and the file travels with a deploy so the server-side install follows it.
- *
- * A project inside a monorepo is left alone: the workspace root owns these settings, and a file in the project
- * folder would turn it into a workspace root of its own.
- */
-export declare const ensureWorkspaceInstallSettings: (projectRoot: string) => void;
 export declare const hasLocalOverrides: () => boolean;
 export declare const getLocalOverrides: () => string[];
 export declare const hasLocalSymlinks: () => boolean;

package/dist/phoenix/utils/package-info.js

@@ -1 +1 @@
-import{existsSync as e,lstatSync as t,readFileSync as r,readdirSync as s,writeFileSync as o}from"fs";import{dirname as a,join as i,resolve as l}from"path";import{isMap as n,isScalar as c,isSeq as d,parse as p,parseDocument as m}from"yaml";let u="pnpm-workspace.yaml",f="@salsita-ai/";export const readPackageJson=(t=".")=>{let s=l(t,"package.json");if(!e(s))throw Error(`package.json not found at ${s}`);return JSON.parse(r(s,"utf8"))};let g=(t=process.cwd())=>{let r=l(t);for(;;){let t=i(r,u);if(e(t))return t;let s=a(r);if(s===r)return;r=s}},k=()=>g()??i(process.cwd(),u),h=()=>{try{let e=g();if(!e)return{};let t=p(r(e,"utf8"));return t?.overrides??{}}catch{return{}}};export const getWorkspaceDir=()=>a(k());export const addWorkspaceOverrides=t=>{let s=k(),a=m(e(s)?r(s,"utf8"):"");Object.entries(t).forEach(([e,t])=>{a.setIn(["overrides",e],t)}),a.setIn(["optimisticRepeatInstall"],!1),o(s,a.toString())};export const removeWorkspaceOverrides=e=>{let t=g();if(!t)return;let s=m(r(t,"utf8"));e.forEach(e=>{s.deleteIn(["overrides",e])});let a=s.getIn(["overrides"]);n(a)&&0===a.items.length&&s.delete("overrides"),s.delete("optimisticRepeatInstall"),o(t,s.toString())};let x={"@swc/core":!0,esbuild:!0,"es5-ext":!1},y=`${f}*`;export const ensureWorkspaceInstallSettings=t=>{let s=i(t,u);if(!e(s)&&g(t))return;let a=e(s)?r(s,"utf8"):"",l=m(a);n(l.get("allowBuilds"))||l.set("allowBuilds",l.createNode({})),Object.entries(x).forEach(([e,t])=>{"boolean"!=typeof l.getIn(["allowBuilds",e])&&l.setIn(["allowBuilds",e],t)});let p=l.getIn(["minimumReleaseAgeExclude"]);d(p)?p.items.some(e=>c(e)&&e.value===y)||p.add(y):l.setIn(["minimumReleaseAgeExclude"],l.createNode([y]));let f=l.toString();f!==a&&o(s,f)};export const hasLocalOverrides=()=>Object.keys(h()).some(e=>e.startsWith(f));export const getLocalOverrides=()=>Object.keys(h()).filter(e=>e.startsWith(f));let v=["@salsita-ai/common","@salsita-ai/contracts","@salsita-ai/sdk"];export const hasLocalSymlinks=()=>v.some(e=>{let r=l("node_modules",e);try{return t(r).isSymbolicLink()}catch{return!1}});export const isUsingLocalSdk=()=>hasLocalOverrides()||hasLocalSymlinks();export const getSdkPackages=t=>{let r=l(t,"packages/libs");if(!e(r))throw Error(`SDK libs directory not found at ${r}`);return s(r,{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).map(e=>{let t=i(r,e),s=readPackageJson(t);if(!s.name)throw Error(`Package at ${t} has no name in package.json`);return{name:s.name,path:t}})};
+import{existsSync as e,lstatSync as t,readFileSync as r,readdirSync as s,writeFileSync as o}from"fs";import{dirname as a,join as i,resolve as n}from"path";import{isMap as c,parse as l,parseDocument as p}from"yaml";let m="pnpm-workspace.yaml",d="@salsita-ai/";export const readPackageJson=(t=".")=>{let s=n(t,"package.json");if(!e(s))throw Error(`package.json not found at ${s}`);return JSON.parse(r(s,"utf8"))};let f=(t=process.cwd())=>{let r=n(t);for(;;){let t=i(r,m);if(e(t))return t;let s=a(r);if(s===r)return;r=s}},k=()=>f()??i(process.cwd(),m),h=()=>{try{let e=f();if(!e)return{};let t=l(r(e,"utf8"));return t?.overrides??{}}catch{return{}}};export const getWorkspaceDir=()=>a(k());export const addWorkspaceOverrides=t=>{let s=k(),a=p(e(s)?r(s,"utf8"):"");Object.entries(t).forEach(([e,t])=>{a.setIn(["overrides",e],t)}),a.setIn(["optimisticRepeatInstall"],!1),o(s,a.toString())};export const removeWorkspaceOverrides=e=>{let t=f();if(!t)return;let s=p(r(t,"utf8"));e.forEach(e=>{s.deleteIn(["overrides",e])});let a=s.getIn(["overrides"]);c(a)&&0===a.items.length&&s.delete("overrides"),s.delete("optimisticRepeatInstall"),o(t,s.toString())};export const hasLocalOverrides=()=>Object.keys(h()).some(e=>e.startsWith(d));export const getLocalOverrides=()=>Object.keys(h()).filter(e=>e.startsWith(d));let u=["@salsita-ai/common","@salsita-ai/contracts","@salsita-ai/sdk"];export const hasLocalSymlinks=()=>u.some(e=>{let r=n("node_modules",e);try{return t(r).isSymbolicLink()}catch{return!1}});export const isUsingLocalSdk=()=>hasLocalOverrides()||hasLocalSymlinks();export const getSdkPackages=t=>{let r=n(t,"packages/libs");if(!e(r))throw Error(`SDK libs directory not found at ${r}`);return s(r,{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).map(e=>{let t=i(r,e),s=readPackageJson(t);if(!s.name)throw Error(`Package at ${t} has no name in package.json`);return{name:s.name,path:t}})};

package/dist/phoenix/utils/package-manager/index.d.ts

@@ -0,0 +1,2 @@
+export { type PackageManagerCommands, findPackageManagerCommands } from './package-manager-commands.js';
+export { assertPnpmProject } from './pnpm-project.js';

package/dist/phoenix/utils/package-manager/index.js

@@ -0,0 +1 @@
+export{findPackageManagerCommands}from"./package-manager-commands.js";export{assertPnpmProject}from"./pnpm-project.js";

package/dist/phoenix/utils/package-manager/package-manager-commands.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The commands of a package manager the CLI names in the next steps it prints, so a developer can copy the one for
+ * the package manager they use. Phoenix works with any package manager; these only phrase the hints.
+ */
+export interface PackageManagerCommands {
+    /** Installs the project's dependencies, such as `npm install`. */
+    readonly install: string;
+    /** Adds a package to the project's dependencies, such as `npm install @salsita-ai/sdk`. */
+    readonly add: (packageName: string) => string;
+    /** Runs a `phoenix` command from the project's install, such as `npx phoenix sync`. */
+    readonly phoenix: (args: string) => string;
+}
+/**
+ * The commands of the package manager that started the CLI, read from the `npm_config_user_agent` value npm, pnpm,
+ * Yarn and Bun set for the binaries they run (`pnpm/11.1.3 npm/? node/v22.13.0 linux x64`). `undefined` when the CLI
+ * was started some other way, such as straight from `node_modules/.bin`, or by a package manager it does not know;
+ * the hint then names no package manager.
+ */
+export declare const findPackageManagerCommands: (userAgent: string | undefined) => PackageManagerCommands | undefined;

package/dist/phoenix/utils/package-manager/package-manager-commands.js

@@ -0,0 +1 @@
+let n=new Map([["pnpm",{install:"pnpm install",add:n=>`pnpm add ${n}`,phoenix:n=>`pnpm phoenix ${n}`}],["npm",{install:"npm install",add:n=>`npm install ${n}`,phoenix:n=>`npx phoenix ${n}`}],["yarn",{install:"yarn install",add:n=>`yarn add ${n}`,phoenix:n=>`yarn phoenix ${n}`}],["bun",{install:"bun install",add:n=>`bun add ${n}`,phoenix:n=>`bunx phoenix ${n}`}]]);export const findPackageManagerCommands=a=>{let p=a?.split("/")[0]?.trim();return void 0===p?void 0:n.get(p)};

package/dist/phoenix/utils/package-manager/pnpm-project.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stops a pnpm-only command in a project that clearly installs with another package manager: one with another
+ * package manager's lockfile and no `pnpm-lock.yaml`. A project without any lockfile is let through, as it has not
+ * installed yet. Only the project folder is looked at.
+ */
+export declare const assertPnpmProject: (props: {
+    readonly projectRoot: string;
+    readonly command: string;
+}) => void;

package/dist/phoenix/utils/package-manager/pnpm-project.js

@@ -0,0 +1 @@
+import{existsSync as o}from"fs";import{join as t}from"path";let n=["package-lock.json","npm-shrinkwrap.json","yarn.lock","bun.lock","bun.lockb"];export const assertPnpmProject=r=>{if(o(t(r.projectRoot,"pnpm-lock.yaml")))return;let a=n.find(n=>o(t(r.projectRoot,n)));if(void 0!==a)throw Error(`phoenix ${r.command} works with pnpm only, and this project installs with another package manager: it has ${a} and no pnpm-lock.yaml. It is an internal tool for linking a local SDK checkout through the overrides in pnpm-workspace.yaml. Use it in a project that installs with pnpm.`)};

package/dist/phoenix/utils/run-command.d.ts

@@ -1,4 +1,5 @@
 import type { Logger } from './logger.js';
+import { type SdkTool } from './sdk-tool/index.js';
 export interface RunCommandProps {
     readonly command: string;
     readonly args: readonly string[];
@@ -7,6 +8,16 @@ export interface RunCommandProps {
     readonly cwd?: string;
     readonly extraEnv?: Record<string, string>;
 }
+export interface RunSdkToolProps extends Omit<RunCommandProps, 'command'> {
+    readonly tool: SdkTool;
+}
 export declare const runCommand: (props: RunCommandProps, context?: {
     readonly logger: Logger;
 }) => Promise<void>;
+/**
+ * Runs a tool from the SDK's own installation with the Node.js that runs the CLI. It starts no shell, so paths
+ * with spaces reach the tool unchanged.
+ */
+export declare const runSdkTool: (props: RunSdkToolProps, context?: {
+    readonly logger: Logger;
+}) => Promise<void>;

package/dist/phoenix/utils/run-command.js

@@ -1 +1 @@
-import{spawn as e}from"node:child_process";import{createLogger as r}from"./logger.js";export const runCommand=async(o,t)=>{let n=t?.logger??r(),{command:s,args:i,description:a,quiet:l=!1,cwd:c,extraEnv:d}=o;l?n.isDebug&&n.debug(`Running: ${s} ${i.join(" ")}`):n.step(a);let u=n.isDebug?"inherit":l?"pipe":"inherit";await new Promise((r,o)=>{let t=e(s,i,{stdio:u,shell:!0,cwd:c,env:d?{...process.env,...d}:void 0}),l=[],f=[],m=!1;t.stdout?.on("data",e=>l.push(Buffer.from(e))),t.stderr?.on("data",e=>f.push(Buffer.from(e))),t.once("error",e=>{m=!0,n.error(`${a} failed to execute`),n.error(`Error: ${e.message}`),o(Error(`Failed to execute command '${s}': ${e.message}. Ensure the command is installed and available in PATH.`))}),t.once("close",(e,t)=>{if(!m){if(0!==e){let r=null!==e?`exit code ${e}`:"unknown error (process was terminated or failed to start)";n.error(`${a} failed with ${r}`),t&&n.error(`Process was killed with signal: ${t}`),l.length>0&&console.error(Buffer.concat(l).toString()),f.length>0&&console.error(Buffer.concat(f).toString()),o(Error(`${a} failed with ${r}`));return}r()}})}),(!l||n.isDebug)&&n.success(`${a} completed`)};
+import{spawn as e}from"node:child_process";import{createLogger as r}from"./logger.js";import{resolveSdkToolBin as o}from"./sdk-tool/index.js";let t=async(o,t)=>{let s=t?.logger??r(),{command:n,file:i,shell:a,startFailureHint:l,args:c,description:d,quiet:m=!1,cwd:u,extraEnv:f}=o;m?s.isDebug&&s.debug(`Running: ${n} ${c.join(" ")}`):s.step(d);let g=s.isDebug?"inherit":m?"pipe":"inherit";await new Promise((r,o)=>{let t=e(i,c,{stdio:g,shell:a,cwd:u,env:f?{...process.env,...f}:void 0}),m=[],p=[],h=!1;t.stdout?.on("data",e=>m.push(Buffer.from(e))),t.stderr?.on("data",e=>p.push(Buffer.from(e))),t.once("error",e=>{h=!0,s.error(`${d} failed to execute`),s.error(`Error: ${e.message}`),o(Error(`Failed to execute command '${n}': ${e.message}. ${l}`))}),t.once("close",(e,t)=>{if(!h){if(0!==e){let r=null!==e?`exit code ${e}`:"unknown error (process was terminated or failed to start)";s.error(`${d} failed with ${r}`),t&&s.error(`Process was killed with signal: ${t}`),m.length>0&&console.error(Buffer.concat(m).toString()),p.length>0&&console.error(Buffer.concat(p).toString()),o(Error(`${d} failed with ${r}`));return}r()}})}),(!m||s.isDebug)&&s.success(`${d} completed`)};export const runCommand=async(e,r)=>{await t({...e,file:e.command,shell:!0,startFailureHint:"Ensure the command is installed and available in PATH."},r)};export const runSdkTool=async(e,r)=>{let{tool:s,args:n,...i}=e;await t({...i,command:s.binName,file:process.execPath,args:[o(s),...n],shell:!1,startFailureHint:"Ensure Node.js can start this process."},r)};

package/dist/phoenix/utils/sdk-tool/index.d.ts

@@ -0,0 +1 @@
+export { type SdkTool, resolveSdkToolBin } from './resolve-sdk-tool-bin.js';

package/dist/phoenix/utils/sdk-tool/index.js

@@ -0,0 +1 @@
+export{resolveSdkToolBin}from"./resolve-sdk-tool-bin.js";

package/dist/phoenix/utils/sdk-tool/resolve-sdk-tool-bin.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A command-line tool the CLI runs, such as `tsc` for `phoenix check`. The SDK installs every such tool as one of
+ * its own `dependencies` and runs that copy, so the versions a project installs do not decide them.
+ */
+export interface SdkTool {
+    /** The name the SDK's `package.json` lists the package under, the alias where the SDK installs it under one */
+    readonly packageName: string;
+    /** The name of the binary in the package's `bin` field */
+    readonly binName: string;
+}
+/**
+ * Returns the absolute path of a tool's binary in the SDK's own installation. It never looks at `PATH` or the
+ * project's `node_modules`, so the CLI runs the same tool in every project.
+ */
+export declare const resolveSdkToolBin: (tool: SdkTool) => string;

package/dist/phoenix/utils/sdk-tool/resolve-sdk-tool-bin.js

@@ -0,0 +1 @@
+import{existsSync as e,readFileSync as o}from"node:fs";import{createRequire as t}from"node:module";import{join as n,resolve as i}from"node:path";import{z as a}from"zod";let r=a.object({name:a.string(),bin:a.union([a.string(),a.record(a.string())]).optional()}),s=t(import.meta.url);export const resolveSdkToolBin=t=>{var a,p;let d=(o=>{let t=(s.resolve.paths(o)??[]).map(e=>n(e,o)).find(o=>e(n(o,"package.json")));if(void 0===t)throw Error(`Cannot find the package '${o}' in the installation of @salsita-ai/sdk. The SDK runs its own copy of it, so it is one of the SDK's dependencies. Reinstall the project's dependencies.`);return t})(t.packageName),l=(a=r.parse(JSON.parse(o(n(d,"package.json"),"utf-8"))),p=t.binName,"string"==typeof a.bin?a.name.replace(/^@[^/]+\//,"")===p?a.bin:void 0:a.bin?.[p]);if(void 0===l)throw Error(`The package '${t.packageName}' in the installation of @salsita-ai/sdk has no binary '${t.binName}'. The SDK expects it there to run it. Reinstall the project's dependencies.`);return i(d,l)};

package/dist/react-sdk/application-runtime/common-services/analytics/analytics-service.d.ts

@@ -17,5 +17,5 @@ export declare const CommonAnalyticsFactory: {
     Initialized: typeof Initialized;
     ConfigurationLoaded: typeof ConfigurationLoaded;
 };
-export declare const initializeAnalyticsService: (config: AnyApplicationConfig, logger: Logger, isDev: boolean) => AnalyticsSystem;
+export declare const initializeAnalyticsService: (config: Pick<AnyApplicationConfig, 'services' | 'defaultEnvs'>, logger: Logger, isDev: boolean) => AnalyticsSystem;
 export {};