@salsita-ai/sdk 0.50.0-develop.f101f4c3c9 → 0.50.0-develop.f16492b14e

package/dist/phoenix/commands/inspect-assets.js

@@ -1 +1 @@
-import{globby as e}from"globby";import{resolve as o}from"path";import{inspectGltfFile as t}from"./gltf-inspector.js";let n=e=>e<1024?`${e} B`:e<1048576?`${(e/1024).toFixed(1)} KB`:`${(e/1048576).toFixed(1)} MB`;export const formatSummary=e=>{let o=[`File: ${e.filePath}`,`Size: ${n(e.fileSize)}${e.fileSize>0xa00000?" (large file)":""}`,`Format: ${e.format} ${e.version}`,`Generator: ${e.generator}`];return e.extensions.length>0&&o.push(`Extensions: ${e.extensions.join(", ")}`),e.dracoCompressed&&o.push("Note: Draco-compressed meshes (vertex data not decoded)"),o.join("\n")};let r=e=>String(Math.round(1e3*e)/1e3),a=e=>`[${e.map(r).join(", ")}]`,i=(e,o)=>0===o||Math.abs(e)<.01*o,s=(e,o)=>o>0&&Math.abs(Math.abs(e)-o/2)<.01*o,l=e=>{let o,t,n,l=e.children.length>0?` [${e.children.join(", ")}]`:"",m=`  ${e.name} (${e.type})${l}`;if((0!==(o=e.translation)[0]||0!==o[1]||0!==o[2])&&(m+=`  pos=${a(e.translation)}`),(0!==(t=e.rotation)[0]||0!==t[1]||0!==t[2]||1!==t[3])&&(m+=`  rot=${a(e.rotation)}`),(1!==(n=e.scale)[0]||1!==n[1]||1!==n[2])&&(m+=`  scale=${a(e.scale)}`),e.morphTargets.length>0&&(m+=`  morphs=${e.morphTargets.join(",")}`),e.boundingBox){let o=e.boundingBox.dimensions,t=e.boundingBox.originOffset,n=((e,o)=>{let t=i(e[0],o[0]),n=i(e[1],o[1]),r=i(e[2],o[2]);if(t&&n&&r)return"center";let a=s(e[1],o[1])?e[1]>0?"bottom":"top":"",l=s(e[0],o[0]),m=s(e[2],o[2]),f=t&&r?"center":l&&m?"corner":l||m?"edge":"";return a&&f?`${a}-${f}`:a||f||"offset"})(t,o);m+=`  bounds=${r(o[0])}x${r(o[1])}x${r(o[2])}  origin=${n} ${a(t)}`}return m};export const formatNodes=e=>0===e.length?"Nodes: (none)":[`Nodes (${e.length}):`,...e.map(l)].join("\n");export const formatMaterials=e=>0===e.length?"Materials: (none)":[`Materials (${e.length}):`,...e.map(e=>`  ${e.name}`)].join("\n");export const formatMorphTargets=e=>{if(0===e.size)return"Morph Targets: (none)";let o=["Morph Targets:"];for(let[t,n]of e)o.push(`  ${t}: ${n.join(", ")}`);return o.join("\n")};export const formatAnimations=e=>0===e.length?"Animations: (none)":[`Animations (${e.length}):`,...e.map(e=>`  ${e.name} (${e.duration}s, ${e.channelCount} channels)`)].join("\n");export const formatFullReport=e=>[formatSummary(e),"",formatNodes(e.nodes),"",formatMaterials(e.materials),"",formatMorphTargets(e.morphTargets),"",formatAnimations(e.animations)].join("\n");export const formatSummaryTable=e=>{let o="File                                     Size       Nodes  Materials  Morphs  Animations",t="─".repeat(o.length);return[o,t,...e.map(e=>{let o=[...e.morphTargets.values()].reduce((e,o)=>e+o.length,0);return[e.filePath.padEnd(40),n(e.fileSize).padStart(10),String(e.nodes.length).padStart(7),String(e.materials.length).padStart(10),String(o).padStart(8),String(e.animations.length).padStart(11)].join("")})].join("\n")};let m=e=>({...e,morphTargets:Object.fromEntries(e.morphTargets)});export const runInspectAssetsCommand=async(n,r)=>{let{logger:a}=r;try{if(n.file){let e=o(n.file),r=await t(e);if(n.json)return void console.log(JSON.stringify(m(r),null,2));if(n.objects)return void console.log(formatNodes(r.nodes));if(n.materials)return void console.log(formatMaterials(r.materials));if(n.morphs)return void console.log(formatMorphTargets(r.morphTargets));if(n.animations)return void console.log(formatAnimations(r.animations));console.log(formatFullReport(r));return}let r=await e("public/**/*.{glb,gltf}");if(0===r.length)return void a.warn("No glTF/GLB files found in public/");let i=[];for(let e of r)try{i.push(await t(o(e)))}catch(o){a.error(`Failed to parse ${e}`,o)}if(0===i.length)return void a.warn("No files could be parsed");if(n.json)return void console.log(JSON.stringify(i.map(m),null,2));if(n.objects){let e=i.flatMap(e=>e.nodes.map(o=>`${e.filePath}: ${o.name} (${o.type})`));console.log(e.join("\n"));return}if(n.materials){let e=i.flatMap(e=>e.materials.map(o=>`${e.filePath}: ${o.name}`));console.log(e.join("\n"));return}if(n.morphs){let e=[];for(let o of i)for(let[t,n]of o.morphTargets)e.push(`${o.filePath}: ${t} → ${n.join(", ")}`);if(0===e.length)return void a.info("No morph targets found in any file");console.log(e.join("\n"));return}if(n.animations){let e=i.flatMap(e=>e.animations.map(o=>`${e.filePath}: ${o.name} (${o.duration}s, ${o.channelCount} ch)`));if(0===e.length)return void a.info("No animations found in any file");console.log(e.join("\n"));return}console.log(formatSummaryTable(i))}catch(e){e instanceof Error?a.error(e.message):a.error("Unexpected error during asset inspection",e),process.exit(1)}};
+import{globby as e}from"globby";import{resolve as o}from"path";import{exitCli as t}from"../services/index.js";import{inspectGltfFile as n}from"./gltf-inspector.js";let r=e=>e<1024?`${e} B`:e<1048576?`${(e/1024).toFixed(1)} KB`:`${(e/1048576).toFixed(1)} MB`;export const formatSummary=e=>{let o=[`File: ${e.filePath}`,`Size: ${r(e.fileSize)}${e.fileSize>0xa00000?" (large file)":""}`,`Format: ${e.format} ${e.version}`,`Generator: ${e.generator}`];return e.extensions.length>0&&o.push(`Extensions: ${e.extensions.join(", ")}`),e.dracoCompressed&&o.push("Note: Draco-compressed meshes (vertex data not decoded)"),o.join("\n")};let a=e=>String(Math.round(1e3*e)/1e3),i=e=>`[${e.map(a).join(", ")}]`,s=(e,o)=>0===o||Math.abs(e)<.01*o,l=(e,o)=>o>0&&Math.abs(Math.abs(e)-o/2)<.01*o,m=e=>{let o,t,n,r=e.children.length>0?` [${e.children.join(", ")}]`:"",m=`  ${e.name} (${e.type})${r}`;if((0!==(o=e.translation)[0]||0!==o[1]||0!==o[2])&&(m+=`  pos=${i(e.translation)}`),(0!==(t=e.rotation)[0]||0!==t[1]||0!==t[2]||1!==t[3])&&(m+=`  rot=${i(e.rotation)}`),(1!==(n=e.scale)[0]||1!==n[1]||1!==n[2])&&(m+=`  scale=${i(e.scale)}`),e.morphTargets.length>0&&(m+=`  morphs=${e.morphTargets.join(",")}`),e.boundingBox){let o=e.boundingBox.dimensions,t=e.boundingBox.originOffset,n=((e,o)=>{let t=s(e[0],o[0]),n=s(e[1],o[1]),r=s(e[2],o[2]);if(t&&n&&r)return"center";let a=l(e[1],o[1])?e[1]>0?"bottom":"top":"",i=l(e[0],o[0]),m=l(e[2],o[2]),f=t&&r?"center":i&&m?"corner":i||m?"edge":"";return a&&f?`${a}-${f}`:a||f||"offset"})(t,o);m+=`  bounds=${a(o[0])}x${a(o[1])}x${a(o[2])}  origin=${n} ${i(t)}`}return m};export const formatNodes=e=>0===e.length?"Nodes: (none)":[`Nodes (${e.length}):`,...e.map(m)].join("\n");export const formatMaterials=e=>0===e.length?"Materials: (none)":[`Materials (${e.length}):`,...e.map(e=>`  ${e.name}`)].join("\n");export const formatMorphTargets=e=>{if(0===e.size)return"Morph Targets: (none)";let o=["Morph Targets:"];for(let[t,n]of e)o.push(`  ${t}: ${n.join(", ")}`);return o.join("\n")};export const formatAnimations=e=>0===e.length?"Animations: (none)":[`Animations (${e.length}):`,...e.map(e=>`  ${e.name} (${e.duration}s, ${e.channelCount} channels)`)].join("\n");export const formatFullReport=e=>[formatSummary(e),"",formatNodes(e.nodes),"",formatMaterials(e.materials),"",formatMorphTargets(e.morphTargets),"",formatAnimations(e.animations)].join("\n");export const formatSummaryTable=e=>{let o="File                                     Size       Nodes  Materials  Morphs  Animations",t="─".repeat(o.length);return[o,t,...e.map(e=>{let o=[...e.morphTargets.values()].reduce((e,o)=>e+o.length,0);return[e.filePath.padEnd(40),r(e.fileSize).padStart(10),String(e.nodes.length).padStart(7),String(e.materials.length).padStart(10),String(o).padStart(8),String(e.animations.length).padStart(11)].join("")})].join("\n")};let f=e=>({...e,morphTargets:Object.fromEntries(e.morphTargets)});export const runInspectAssetsCommand=async(r,a)=>{let{logger:i}=a;try{if(r.file){let e=o(r.file),t=await n(e);if(r.json)return void console.log(JSON.stringify(f(t),null,2));if(r.objects)return void console.log(formatNodes(t.nodes));if(r.materials)return void console.log(formatMaterials(t.materials));if(r.morphs)return void console.log(formatMorphTargets(t.morphTargets));if(r.animations)return void console.log(formatAnimations(t.animations));console.log(formatFullReport(t));return}let t=await e("public/**/*.{glb,gltf}");if(0===t.length)return void i.warn("No glTF/GLB files found in public/");let a=[];for(let e of t)try{a.push(await n(o(e)))}catch(o){i.error(`Failed to parse ${e}`,o)}if(0===a.length)return void i.warn("No files could be parsed");if(r.json)return void console.log(JSON.stringify(a.map(f),null,2));if(r.objects){let e=a.flatMap(e=>e.nodes.map(o=>`${e.filePath}: ${o.name} (${o.type})`));console.log(e.join("\n"));return}if(r.materials){let e=a.flatMap(e=>e.materials.map(o=>`${e.filePath}: ${o.name}`));console.log(e.join("\n"));return}if(r.morphs){let e=[];for(let o of a)for(let[t,n]of o.morphTargets)e.push(`${o.filePath}: ${t} → ${n.join(", ")}`);if(0===e.length)return void i.info("No morph targets found in any file");console.log(e.join("\n"));return}if(r.animations){let e=a.flatMap(e=>e.animations.map(o=>`${e.filePath}: ${o.name} (${o.duration}s, ${o.channelCount} ch)`));if(0===e.length)return void i.info("No animations found in any file");console.log(e.join("\n"));return}console.log(formatSummaryTable(a))}catch(e){e instanceof Error?i.error(e.message):i.error("Unexpected error during asset inspection",e),await t(1)}};

package/dist/phoenix/commands/list-environments.js

@@ -1 +1 @@
-import{runCommand as e}from"../utils/index.js";export const runListEnvironmentsCommand=async(n,r)=>{let{logger:t}=r;try{t.warn("DEPRECATED: environment:list command is deprecated, switch to a new workflow and use the prepare environment flow instead"),t.step("Listing deployment environments");let r=["list"];n?.server&&r.push("--server",`"${n.server}"`),n?.apiKey&&r.push("--apiKey",`"${n.apiKey}"`),await e({command:"deployment-cli",args:r,description:"Listing environments"},{logger:t})}catch(e){t.error(`Failed to list environments: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{exitCli as e}from"../services/index.js";import{runCommand as n}from"../utils/index.js";export const runListEnvironmentsCommand=async(r,t)=>{let{logger:i}=t;try{i.warn("DEPRECATED: environment:list command is deprecated, switch to a new workflow and use the prepare environment flow instead"),i.step("Listing deployment environments");let e=["list"];r?.server&&e.push("--server",`"${r.server}"`),r?.apiKey&&e.push("--apiKey",`"${r.apiKey}"`),await n({command:"deployment-cli",args:e,description:"Listing environments"},{logger:i})}catch(n){i.error(`Failed to list environments: ${n instanceof Error?n.message:String(n)}`,n),await e(1)}};

package/dist/phoenix/commands/login.d.ts

@@ -37,5 +37,8 @@ export declare const startLoginCallbackListener: (props: LoginCallbackListenerPr
  * one-time code to this CLI's loopback listener, and the CLI exchanges it with its PKCE verifier for an API token.
  * The browser waits on the callback meanwhile and ends on Studio's page for the outcome.
  */
-export declare const runLoginCommand: (props: LoginCommandProps, { logger }: CommandContext) => Promise<void>;
+export declare const runLoginCommand: (props: LoginCommandProps, { logger }: CommandContext) => Promise<{
+    userId: string;
+    workspaceId: string;
+} | undefined>;
 export {};

package/dist/phoenix/commands/login.js

@@ -1,4 +1,4 @@
-import{spawn as e}from"node:child_process";import{createHash as t,randomBytes as r}from"node:crypto";import{createServer as o}from"node:http";import{hostname as n}from"node:os";import{createApiBaseClient as s}from"#package/client";import{getServerCredentials as i,saveServerCredentials as a}from"../services/index.js";let l={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"},c=(e,t)=>`<!doctype html><html><head><meta charset="utf-8"><title>${e}</title></head><body style="font-family:system-ui,sans-serif;display:grid;place-items:center;height:100vh;margin:0"><main style="text-align:center"><h1>${e}</h1><p>${t.replace(/[&<>"']/g,e=>l[e]??e)}</p></main></body></html>`,d=(e,t,r,o)=>new Promise(n=>{e.destroyed?n():(e.once("close",n),e.writeHead(t,{...r,connection:"close"}).end(o))});export const startLoginCallbackListener=async e=>{let{state:t,studioUrl:r,customer:n}=e,s=(e,t)=>{let o=new URL(e,r);return o.searchParams.set("customer",n),t&&o.searchParams.set("name",t),o.toString()},i=null,a=!1,l=new Promise((e,t)=>{i={resolve:e,reject:t}}),m=o((e,r)=>{let o=new URL(e.url??"/","http://127.0.0.1"),n=o.searchParams.get("code"),l="access_denied"===o.searchParams.get("error");if("/callback"!==o.pathname)return void r.writeHead(404).end();if(o.searchParams.get("state")!==t||a||!n&&!l){d(r,400,{"content-type":"text/html"},c("Sign-in failed","This response does not belong to the waiting CLI. Run phoenix login again.")),a||i?.reject(Error("The sign-in response did not match this CLI session. Run `phoenix login` again."));return}if(a=!0,l||!n)return void d(r,302,{location:s("/builder/cli-login/denied",null)}).then(()=>{i?.reject(Error("The sign-in was denied in Studio. Run `phoenix login` again to sign in."))});let m=o.searchParams.get("name");i?.resolve({code:n,tokenName:m,finish:e=>e.signedIn?d(r,302,{location:s("/builder/cli-login/done",m)}):d(r,200,{"content-type":"text/html"},c("Sign-in failed",e.message))})}),h=await new Promise((e,t)=>{m.once("error",t),m.listen(0,"127.0.0.1",()=>{let r=m.address();null===r||"string"==typeof r?t(Error("The login callback listener did not get a port. Run `phoenix login` again.")):e(r.port)})}),u=setTimeout(()=>{i?.reject(Error("Nobody approved the sign-in within 5 minutes. Run `phoenix login` again."))},3e5);return{port:h,callback:l,close:()=>{clearTimeout(u),m.close()}}};let m=async(e,t)=>{try{let{error:r,response:o}=await s(e).DELETE("/auth/token",{headers:{authorization:`Bearer ${t}`,"content-type":null}});return r&&401!==o.status?r.message:null}catch(e){return e instanceof Error?e.message:String(e)}},h=async(e,t)=>{let{data:r,error:o}=await s(e.serverUrl).POST("/auth/token",{body:t});if(o||!r)throw Error(`The server did not accept the sign-in: ${o?.message??"no response"}`);if(r.customer.slug!==e.customer)throw await m(e.serverUrl,r.token),Error(`The sign-in was approved in workspace "${r.customer.slug}", not "${e.customer}". Check --region or --studioUrl and run \`phoenix login ${e.customer}\` again.`);let n=await i(e.serverUrl),l=await a(e.serverUrl,{token:r.token,userId:r.userId,customerSlug:r.customer.slug,customerName:r.customer.name,studioUrl:e.studioUrl,createdAt:new Date().toISOString()}),c=n?await m(e.serverUrl,n.token):null;return{customerName:r.customer.name,path:l,revokeError:c}};export const runLoginCommand=async(o,{logger:s})=>{let i=r(32).toString("base64url"),a=t("sha256").update(i).digest("base64url"),l=r(16).toString("base64url"),c=n(),d=`phoenix CLI on ${c}`,m=await startLoginCallbackListener({state:l,studioUrl:o.studioUrl,customer:o.customer});try{let t=new URL("/builder/cli-login",o.studioUrl);t.searchParams.set("customer",o.customer),t.searchParams.set("port",String(m.port)),t.searchParams.set("state",l),t.searchParams.set("challenge",a),t.searchParams.set("name",d),t.searchParams.set("host",c),t.searchParams.set("started",String(Date.now())),s.step(`Signing in to workspace "${o.customer}" on ${o.serverUrl}`),s.info(`Approve the CLI in your browser:
+import{spawn as e}from"node:child_process";import{createHash as t,randomBytes as r}from"node:crypto";import{createServer as o}from"node:http";import{hostname as n}from"node:os";import{z as s}from"zod";import{createApiBaseClient as i}from"#package/client";import{getServerCredentials as a,saveServerCredentials as l}from"../services/index.js";let c=s.string().uuid(),d={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"},m=(e,t)=>`<!doctype html><html><head><meta charset="utf-8"><title>${e}</title></head><body style="font-family:system-ui,sans-serif;display:grid;place-items:center;height:100vh;margin:0"><main style="text-align:center"><h1>${e}</h1><p>${t.replace(/[&<>"']/g,e=>d[e]??e)}</p></main></body></html>`,u=(e,t,r,o)=>new Promise(n=>{e.destroyed?n():(e.once("close",n),e.writeHead(t,{...r,connection:"close"}).end(o))});export const startLoginCallbackListener=async e=>{let{state:t,studioUrl:r,customer:n}=e,s=(e,t)=>{let o=new URL(e,r);return o.searchParams.set("customer",n),t&&o.searchParams.set("name",t),o.toString()},i=null,a=!1,l=new Promise((e,t)=>{i={resolve:e,reject:t}}),c=o((e,r)=>{let o=new URL(e.url??"/","http://127.0.0.1"),n=o.searchParams.get("code"),l="access_denied"===o.searchParams.get("error");if("/callback"!==o.pathname)return void r.writeHead(404).end();if(o.searchParams.get("state")!==t||a||!n&&!l){u(r,400,{"content-type":"text/html"},m("Sign-in failed","This response does not belong to the waiting CLI. Run phoenix login again.")),a||i?.reject(Error("The sign-in response did not match this CLI session. Run `phoenix login` again."));return}if(a=!0,l||!n)return void u(r,302,{location:s("/builder/cli-login/denied",null)}).then(()=>{i?.reject(Error("The sign-in was denied in Studio. Run `phoenix login` again to sign in."))});let c=o.searchParams.get("name");i?.resolve({code:n,tokenName:c,finish:e=>e.signedIn?u(r,302,{location:s("/builder/cli-login/done",c)}):u(r,200,{"content-type":"text/html"},m("Sign-in failed",e.message))})}),d=await new Promise((e,t)=>{c.once("error",t),c.listen(0,"127.0.0.1",()=>{let r=c.address();null===r||"string"==typeof r?t(Error("The login callback listener did not get a port. Run `phoenix login` again.")):e(r.port)})}),h=setTimeout(()=>{i?.reject(Error("Nobody approved the sign-in within 5 minutes. Run `phoenix login` again."))},3e5);return{port:d,callback:l,close:()=>{clearTimeout(h),c.close()}}};let h=async(e,t)=>{try{let{error:r,response:o}=await i(e).DELETE("/auth/token",{headers:{authorization:`Bearer ${t}`,"content-type":null}});return r&&401!==o.status?r.message:null}catch(e){return e instanceof Error?e.message:String(e)}},g=async(e,t)=>{let{data:r,error:o}=await i(e.serverUrl).POST("/auth/token",{body:t});if(o||!r)throw Error(`The server did not accept the sign-in: ${o?.message??"no response"}`);if(r.customer.slug!==e.customer)throw await h(e.serverUrl,r.token),Error(`The sign-in was approved in workspace "${r.customer.slug}", not "${e.customer}". Check --region or --studioUrl and run \`phoenix login ${e.customer}\` again.`);let n=await a(e.serverUrl),s=c.safeParse(r.customer.id),d=await l(e.serverUrl,{token:r.token,userId:r.userId,...s.success?{customerId:s.data}:{},customerSlug:r.customer.slug,customerName:r.customer.name,studioUrl:e.studioUrl,createdAt:new Date().toISOString()}),m=n?await h(e.serverUrl,n.token):null;return{customerName:r.customer.name,path:d,revokeError:m,telemetryAssociation:s.success?{userId:r.userId,workspaceId:s.data}:void 0}};export const runLoginCommand=async(o,{logger:s})=>{let i=r(32).toString("base64url"),a=t("sha256").update(i).digest("base64url"),l=r(16).toString("base64url"),c=n(),d=`phoenix CLI on ${c}`,m=await startLoginCallbackListener({state:l,studioUrl:o.studioUrl,customer:o.customer});try{let t=new URL("/builder/cli-login",o.studioUrl);t.searchParams.set("customer",o.customer),t.searchParams.set("port",String(m.port)),t.searchParams.set("state",l),t.searchParams.set("challenge",a),t.searchParams.set("name",d),t.searchParams.set("host",c),t.searchParams.set("started",String(Date.now())),s.step(`Signing in to workspace "${o.customer}" on ${o.serverUrl}`),s.info(`Approve the CLI in your browser:
 
   ${t.toString()}
-`),o.open&&(t=>{let[r,o]="darwin"===process.platform?["open",[t]]:"win32"===process.platform?["rundll32",["url.dll,FileProtocolHandler",t]]:["xdg-open",[t]];e(r,o,{stdio:"ignore",detached:!0}).on("error",()=>void 0).unref()})(t.toString());let r=await m.callback;try{let e=await h(o,{code:r.code,codeVerifier:i,port:m.port,name:d});e.revokeError&&s.warn(`The server did not revoke the token this sign-in replaces (${e.revokeError}). It stays valid on the server. Contact Phoenix support to revoke it.`),await r.finish({signedIn:!0}),s.success(`Signed in to ${e.customerName}. The token is stored in ${e.path}; revoke it with phoenix logout.`)}catch(e){throw await r.finish({signedIn:!1,message:e instanceof Error?e.message:String(e)}),e}}finally{m.close()}};
+`),o.open&&(t=>{let[r,o]="darwin"===process.platform?["open",[t]]:"win32"===process.platform?["rundll32",["url.dll,FileProtocolHandler",t]]:["xdg-open",[t]];e(r,o,{stdio:"ignore",detached:!0}).on("error",()=>void 0).unref()})(t.toString());let r=await m.callback;try{let e=await g(o,{code:r.code,codeVerifier:i,port:m.port,name:d});return e.revokeError&&s.warn(`The server did not revoke the token this sign-in replaces (${e.revokeError}). It stays valid on the server. Contact Phoenix support to revoke it.`),await r.finish({signedIn:!0}),s.success(`Signed in to ${e.customerName}. The token is stored in ${e.path}; revoke it with phoenix logout.`),e.telemetryAssociation}catch(e){throw await r.finish({signedIn:!1,message:e instanceof Error?e.message:String(e)}),e}}finally{m.close()}};

package/dist/phoenix/commands/prepare-deployment-command.js

@@ -1,2 +1,2 @@
-import{writeFile as e}from"fs/promises";import{createApiBaseClient as t}from"#package/client";import{resolveApplicationSpecDeploymentData as a}from"../application-spec/index.js";import{formatEnvContent as r,formatEnvLine as i}from"../utils/index.js";export const runPrepareDeploymentCommand=async(s,n)=>{let{logger:o}=n;try{o.step("Preparing deployment");let{apiKey:n,projectKey:l,projectSlug:p,projectRef:c,projectSha:m,environmentSlug:d,outFile:h,skipUpload:u,overrideSchema:f,uploadLinksFile:g,serverUrl:v}=s;o.info(`Preparing deployment for project "${p}", environment "${d}"`);let b=t(v);o.debug(`Using server URL: ${v}`);let y=await a({skipUpload:u,logger:o});if(y.assistantSetup){let{sdl:e,prompt:t,instructions:a}=y.assistantSetup,r=t.length+e.length+(a?.length??0);o.info(`Assistant GraphQL schema:
-${e}`),o.info(`Assistant prompt of this deployment (generated prompt, schema and instructions): ${r} characters`)}o.info("Preparing deployment on server...");let{data:w,error:S}=await b.POST("/environments/prepare",{body:{projectSlug:p,environmentSlug:d,applicationVersion:y.applicationVersion,projectRef:c,projectSha:m,publishedDataHash:y.publishedDataHash,useAuthHook:y.useAuthHook,overrideSchema:f,configurationSchema:{version:y.schemaVersion,schema:y.schema},adminConfigurationSchema:y.adminSchema?{schema:y.adminSchema,version:y.adminSchemaVersion}:void 0,chat:y.chat,embeddings:y.embeddings,...y.assistant?{assistant:!0}:{},acl:{canCreate:y.aclCanCreate},privateFiles:[...y.assets.privateFilePaths],publicFiles:[...y.assets.publicFilePaths]},headers:{"x-api-key":n,"x-project-key":l,"x-project-slug":p}});if(S)throw Error(`Failed to prepare deployment with server: ${S.message}`);if(!w)throw Error("No data returned from server");o.debug("Deployment prepared on server");let{baseDomain:F,isCustomDomain:P}=w,U=w.environmentVariables,k=w.privateUploadUrls,$=w.publicUploadUrls;if(!U||!k||!$)throw Error("Incomplete data returned from server");try{let t=[r(U),i("BASE_DOMAIN",String(F)),i("IS_CUSTOM_DOMAIN",String(P))].join("\n");await e(h,t+"\n"),o.debug(`Environment variables written to ${h}`)}catch(e){throw Error("Failed to write environment variables to file")}try{if(u)await e(g,JSON.stringify({privateFiles:[],publicFiles:[]},null,2)),o.debug("Upload links file cleared (upload was skipped)");else{let t={privateFiles:[...y.assets.privateFilesFullPaths].map(e=>({localPath:e,uploadUrl:k[e.replace(/^assets\/private\//,"")]})),publicFiles:[...y.assets.publicFilesFullPaths].map(e=>({localPath:e,uploadUrl:$[e.replace(/^assets\/public\//,"")]}))};await e(g,JSON.stringify(t,null,2)),o.debug(`Upload links written to ${g}`),o.info('Run "finish" command to upload files and activate the deployment')}}catch(e){throw Error("Failed to write upload links to file")}o.success("Deployment prepared successfully!")}catch(e){o.error(`Deployment preparation failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{writeFile as e}from"fs/promises";import{createApiBaseClient as a}from"#package/client";import{resolveApplicationSpecDeploymentData as t}from"../application-spec/index.js";import{exitCli as r}from"../services/index.js";import{formatEnvContent as i,formatEnvLine as s}from"../utils/index.js";export const runPrepareDeploymentCommand=async(n,o)=>{let{logger:l}=o;try{l.step("Preparing deployment");let{apiKey:r,projectKey:o,projectSlug:p,projectRef:c,projectSha:m,environmentSlug:d,outFile:h,skipUpload:u,overrideSchema:f,uploadLinksFile:g,serverUrl:v}=n;l.info(`Preparing deployment for project "${p}", environment "${d}"`);let b=a(v);l.debug(`Using server URL: ${v}`);let y=await t({skipUpload:u,logger:l});if(y.assistantSetup){let{sdl:e,prompt:a,instructions:t}=y.assistantSetup,r=a.length+e.length+(t?.length??0);l.info(`Assistant GraphQL schema:
+${e}`),l.info(`Assistant prompt of this deployment (generated prompt, schema and instructions): ${r} characters`)}l.info("Preparing deployment on server...");let{data:w,error:S}=await b.POST("/environments/prepare",{body:{projectSlug:p,environmentSlug:d,applicationVersion:y.applicationVersion,projectRef:c,projectSha:m,publishedDataHash:y.publishedDataHash,useAuthHook:y.useAuthHook,overrideSchema:f,configurationSchema:{version:y.schemaVersion,schema:y.schema},adminConfigurationSchema:y.adminSchema?{schema:y.adminSchema,version:y.adminSchemaVersion}:void 0,chat:y.chat,embeddings:y.embeddings,...y.assistant?{assistant:!0}:{},acl:{canCreate:y.aclCanCreate},privateFiles:[...y.assets.privateFilePaths],publicFiles:[...y.assets.publicFilePaths]},headers:{"x-api-key":r,"x-project-key":o,"x-project-slug":p}});if(S)throw Error(`Failed to prepare deployment with server: ${S.message}`);if(!w)throw Error("No data returned from server");l.debug("Deployment prepared on server");let{baseDomain:F,isCustomDomain:P}=w,U=w.environmentVariables,k=w.privateUploadUrls,$=w.publicUploadUrls;if(!U||!k||!$)throw Error("Incomplete data returned from server");try{let a=[i(U),s("BASE_DOMAIN",String(F)),s("IS_CUSTOM_DOMAIN",String(P))].join("\n");await e(h,a+"\n"),l.debug(`Environment variables written to ${h}`)}catch(e){throw Error("Failed to write environment variables to file")}try{if(u)await e(g,JSON.stringify({privateFiles:[],publicFiles:[]},null,2)),l.debug("Upload links file cleared (upload was skipped)");else{let a={privateFiles:[...y.assets.privateFilesFullPaths].map(e=>({localPath:e,uploadUrl:k[e.replace(/^assets\/private\//,"")]})),publicFiles:[...y.assets.publicFilesFullPaths].map(e=>({localPath:e,uploadUrl:$[e.replace(/^assets\/public\//,"")]}))};await e(g,JSON.stringify(a,null,2)),l.debug(`Upload links written to ${g}`),l.info('Run "finish" command to upload files and activate the deployment')}}catch(e){throw Error("Failed to write upload links to file")}l.success("Deployment prepared successfully!")}catch(e){l.error(`Deployment preparation failed: ${e instanceof Error?e.message:String(e)}`,e),await r(1)}};

package/dist/phoenix/commands/register-deployment.js

@@ -1 +1 @@
-import{runCommand as e}from"../utils/index.js";export const runRegisterDeploymentCommand=async(t,i)=>{let{logger:r}=i;try{r.warn("DEPRECATED: deployment:register command is deprecated, switch to a new workflow and use deployment:prepare and deployment:finish instead"),r.step("Registering deployment");let i=["register"];t?.server&&i.push("--server",`"${t.server}"`),t?.apiKey&&i.push("--apiKey",`"${t.apiKey}"`),t?.outFile&&i.push("--outFile",`"${t.outFile}"`),t?.skipUpload&&i.push("--skipUpload"),t?.activate===void 0||t.activate||i.push("--activate","false"),t?.overrideSchema&&i.push("--overrideSchema"),i.push("--configPath",'"./.phoenix/phoenix.config.ts"'),await e({command:"deployment-cli",args:i,description:"Registering deployment"},{logger:r}),r.success("Deployment registered successfully!")}catch(e){r.error(`Deployment registration failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{exitCli as e}from"../services/index.js";import{runCommand as i}from"../utils/index.js";export const runRegisterDeploymentCommand=async(t,r)=>{let{logger:s}=r;try{s.warn("DEPRECATED: deployment:register command is deprecated, switch to a new workflow and use deployment:prepare and deployment:finish instead"),s.step("Registering deployment");let e=["register"];t?.server&&e.push("--server",`"${t.server}"`),t?.apiKey&&e.push("--apiKey",`"${t.apiKey}"`),t?.outFile&&e.push("--outFile",`"${t.outFile}"`),t?.skipUpload&&e.push("--skipUpload"),t?.activate===void 0||t.activate||e.push("--activate","false"),t?.overrideSchema&&e.push("--overrideSchema"),e.push("--configPath",'"./.phoenix/phoenix.config.ts"'),await i({command:"deployment-cli",args:e,description:"Registering deployment"},{logger:s}),s.success("Deployment registered successfully!")}catch(i){s.error(`Deployment registration failed: ${i instanceof Error?i.message:String(i)}`,i),await e(1)}};

package/dist/phoenix/commands/scene.js

@@ -1 +1 @@
-import{createTRPCClient as e,createWSClient as t,wsLink as r}from"@trpc/client";import{writeFile as o}from"fs/promises";import{resolve as i}from"path";import s from"ws";export const runSceneCommand=async(n,c)=>{let{logger:l}=c,a=n.port??"3020",p=n.pretty??!0,m=t({url:`ws://localhost:${a}`,WebSocket:s}),f=e({links:[r({client:m})]});try{let e=await f.getEditorScene.mutate(),t=JSON.stringify(e,null,p?2:void 0);if(n.output){let e=i(n.output);await o(e,t,"utf-8"),l.success(`Scene saved: ${e}`)}else console.log(t)}catch(e){if(e instanceof Error){let t=e.cause;null!=t&&"object"==typeof t&&"code"in t&&"ECONNREFUSED"===t.code&&(l.error("Dev server not running. Start with `phoenix dev`"),process.exit(1)),l.error(e.message)}else l.error(`Scene command failed: ${String(e)}`);process.exit(1)}finally{await m.close()}};
+import{createTRPCClient as e,createWSClient as t,wsLink as r}from"@trpc/client";import{writeFile as o}from"fs/promises";import{resolve as i}from"path";import n from"ws";import{exitCli as s}from"../services/index.js";export const runSceneCommand=async(a,c)=>{let{logger:l}=c,m=a.port??"3020",f=a.pretty??!0,p=t({url:`ws://localhost:${m}`,WebSocket:n}),u=e({links:[r({client:p})]});try{let e=await u.getEditorScene.mutate(),t=JSON.stringify(e,null,f?2:void 0);if(a.output){let e=i(a.output);await o(e,t,"utf-8"),l.success(`Scene saved: ${e}`)}else console.log(t)}catch(e){if(e instanceof Error){let t=e.cause;if(null!=t&&"object"==typeof t&&"code"in t&&"ECONNREFUSED"===t.code){l.error("Dev server not running. Start with `phoenix dev`"),await s(1);return}l.error(e.message)}else l.error(`Scene command failed: ${String(e)}`);await s(1)}finally{await p.close()}};

package/dist/phoenix/commands/screenshot.js

@@ -1 +1 @@
-import{createTRPCClient as e,createWSClient as t,wsLink as r}from"@trpc/client";import{resolve as o}from"path";import s from"ws";export const runScreenshotCommand=async(n,c)=>{let{logger:i}=c,a=n.port??"3020",l=n.output??"./screenshot.png",p=n.width??1920,h=n.height??1080,m=n.format?.toUpperCase()??"PNG";"PNG"!==m&&"JPEG"!==m&&(i.error(`Invalid format: ${m}. Use PNG or JPEG`),process.exit(1));let f=t({url:`ws://localhost:${a}`,WebSocket:s}),u=e({links:[r({client:f})]});try{let e=await u.takeScreenshot.mutate({width:p,height:h,fileFormat:m,output:o(l)});console.log(`Screenshot saved: ${e.filePath}`)}catch(e){if(e instanceof Error){let t=e.cause;null!=t&&"object"==typeof t&&"code"in t&&"ECONNREFUSED"===t.code&&(i.error("Dev server not running. Start with `phoenix dev`"),process.exit(1)),i.error(e.message)}else i.error(`Screenshot failed: ${String(e)}`);process.exit(1)}finally{await f.close()}};
+import{createTRPCClient as e,createWSClient as t,wsLink as r}from"@trpc/client";import{resolve as o}from"path";import a from"ws";import{exitCli as i}from"../services/index.js";export const runScreenshotCommand=async(n,s)=>{let{logger:c}=s,l=n.port??"3020",p=n.output??"./screenshot.png",f=n.width??1920,h=n.height??1080,m=n.format?.toUpperCase()??"PNG";if("PNG"!==m&&"JPEG"!==m){c.error(`Invalid format: ${m}. Use PNG or JPEG`),await i(1);return}let u=t({url:`ws://localhost:${l}`,WebSocket:a}),d=e({links:[r({client:u})]});try{let e=await d.takeScreenshot.mutate({width:f,height:h,fileFormat:m,output:o(p)});console.log(`Screenshot saved: ${e.filePath}`)}catch(e){if(e instanceof Error){let t=e.cause;if(null!=t&&"object"==typeof t&&"code"in t&&"ECONNREFUSED"===t.code){c.error("Dev server not running. Start with `phoenix dev`"),await i(1);return}c.error(e.message)}else c.error(`Screenshot failed: ${String(e)}`);await i(1)}finally{await u.close()}};

package/dist/phoenix/commands/state.js

@@ -1 +1 @@
-import{createTRPCClient as t,createWSClient as e,wsLink as o}from"@trpc/client";import{writeFile as r}from"fs/promises";import{resolve as i}from"path";import s from"ws";let n=["entities","navigation","validation"];export const runStateCommand=async(a,l)=>{let{logger:c}=l,p=a.port??"3020",m=a.pretty??!0,f=a.sections?a.sections.split(",").map(t=>t.trim()):[...n],u=f.filter(t=>!n.includes(t));u.length>0&&(c.error(`Invalid sections: ${u.join(", ")}. Valid: ${n.join(", ")}`),process.exit(1));let d=e({url:`ws://localhost:${p}`,WebSocket:s}),S=t({links:[o({client:d})]});try{let t=await S.getEditorState.mutate({sections:f}),e=JSON.stringify(t,null,m?2:void 0);if(a.output){let t=i(a.output);await r(t,e,"utf-8"),c.success(`State saved: ${t}`)}else console.log(e)}catch(t){if(t instanceof Error){let e=t.cause;null!=e&&"object"==typeof e&&"code"in e&&"ECONNREFUSED"===e.code&&(c.error("Dev server not running. Start with `phoenix dev`"),process.exit(1)),c.error(t.message)}else c.error(`State command failed: ${String(t)}`);process.exit(1)}finally{await d.close()}};
+import{createTRPCClient as t,createWSClient as e,wsLink as i}from"@trpc/client";import{writeFile as r}from"fs/promises";import{resolve as o}from"path";import a from"ws";import{exitCli as n}from"../services/index.js";let s=["entities","navigation","validation"];export const runStateCommand=async(l,c)=>{let{logger:m}=c,f=l.port??"3020",p=l.pretty??!0,u=l.sections?l.sections.split(",").map(t=>t.trim()):[...s],d=u.filter(t=>!s.includes(t));if(d.length>0){m.error(`Invalid sections: ${d.join(", ")}. Valid: ${s.join(", ")}`),await n(1);return}let v=e({url:`ws://localhost:${f}`,WebSocket:a}),w=t({links:[i({client:v})]});try{let t=await w.getEditorState.mutate({sections:u}),e=JSON.stringify(t,null,p?2:void 0);if(l.output){let t=o(l.output);await r(t,e,"utf-8"),m.success(`State saved: ${t}`)}else console.log(e)}catch(t){if(t instanceof Error){let e=t.cause;if(null!=e&&"object"==typeof e&&"code"in e&&"ECONNREFUSED"===e.code){m.error("Dev server not running. Start with `phoenix dev`"),await n(1);return}m.error(t.message)}else m.error(`State command failed: ${String(t)}`);await n(1)}finally{await v.close()}};

package/dist/phoenix/commands/story-build.js

@@ -1,3 +1,3 @@
-import r from"promise-queue";import{generateApplicationSpecStory as e}from"../application-spec/generate-application-spec-story.js";import{resolveGlobToDirectories as o}from"./resolve-story-directories.js";export const buildStoryInDirectory=async(r,o)=>{let{logger:t}=o;t.step(`Building Storybook example in ${r.targetDir}`),await e(r.targetDir,o),t.success(`Completed building Storybook example in ${r.targetDir}`)};export const runStoryBuildCommand=async(e,t)=>{let{logger:i}=t;try{let s=await o(e.folder,e.baseDir);if(0===s.length){let r=e.baseDir?`${e.baseDir}/${e.folder}`:e.folder;i.error(`No directories found matching pattern: ${r}. The pattern did not match any directories in the base directory, ensure the base directory exists and contains matching folders.`),process.exit(1)}console.log(`
-Found ${s.length} matching ${1===s.length?"directory":"directories"}:
-`),s.forEach(r=>{console.log(`  - ${r}`)}),console.log("");let n=new r(4,1/0),a=[];if(await Promise.all(s.map(async r=>{try{await n.add(()=>buildStoryInDirectory({targetDir:r},t)),console.log("")}catch(e){i.error(`Failed to build story in ${r}: ${e instanceof Error?e.message:String(e)}`),console.log(e),a.push({dir:r,error:e instanceof Error?e:Error(String(e))})}})),a.length>0)throw i.error(`Failed to build ${a.length} ${1===a.length?"story":"stories"}:`),a.forEach(r=>{i.error(`  - ${r.dir}: ${r.error.message}`)}),Error("Failed to build stories");i.success(`Completed building ${s.length} ${1===s.length?"story":"stories"}!`)}catch(r){throw i.error(`Story build failed: ${r instanceof Error?r.message:String(r)}`),r}};
+import r from"promise-queue";import{generateApplicationSpecStory as e}from"../application-spec/generate-application-spec-story.js";import{exitCli as o}from"../services/index.js";import{resolveGlobToDirectories as t}from"./resolve-story-directories.js";export const buildStoryInDirectory=async(r,o)=>{let{logger:t}=o;t.step(`Building Storybook example in ${r.targetDir}`),await e(r.targetDir,o),t.success(`Completed building Storybook example in ${r.targetDir}`)};export const runStoryBuildCommand=async(e,i)=>{let{logger:s}=i;try{let n=await t(e.folder,e.baseDir);if(0===n.length){let r=e.baseDir?`${e.baseDir}/${e.folder}`:e.folder;s.error(`No directories found matching pattern: ${r}. The pattern did not match any directories in the base directory, ensure the base directory exists and contains matching folders.`),await o(1);return}console.log(`
+Found ${n.length} matching ${1===n.length?"directory":"directories"}:
+`),n.forEach(r=>{console.log(`  - ${r}`)}),console.log("");let a=new r(4,1/0),l=[];if(await Promise.all(n.map(async r=>{try{await a.add(()=>buildStoryInDirectory({targetDir:r},i)),console.log("")}catch(e){s.error(`Failed to build story in ${r}: ${e instanceof Error?e.message:String(e)}`),console.log(e),l.push({dir:r,error:e instanceof Error?e:Error(String(e))})}})),l.length>0)throw s.error(`Failed to build ${l.length} ${1===l.length?"story":"stories"}:`),l.forEach(r=>{s.error(`  - ${r.dir}: ${r.error.message}`)}),Error("Failed to build stories");s.success(`Completed building ${n.length} ${1===n.length?"story":"stories"}!`)}catch(r){throw s.error(`Story build failed: ${r instanceof Error?r.message:String(r)}`),r}};

package/dist/phoenix/commands/story-create.js

@@ -1 +1 @@
-import{basename as r,join as e}from"path";import{generateInitialStory as t}from"../story-scaffolding/index.js";import{askQuestion as o,exists as s,toPascalCase as a}from"../utils/index.js";import{buildStoryInDirectory as i}from"./story-build.js";export const runStoryCreateCommand=async(n={},c)=>{let{logger:m}=c;try{m.step("Creating new Storybook example");let y=n.name;if(!y)for(;!y;){let r=await o('Enter the story name (e.g., "my-feature" or "MyFeature"): ');if(!r||0===r.trim().length){m.error("Story name is required");continue}if(!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(r)){m.error("Story name must start with a letter and contain only letters, numbers, hyphens, and underscores");continue}y=r.trim()}y||(m.error("Story name is required"),process.exit(1)),await s(e(process.cwd(),`src/${y}`))&&(m.error(`Story ${y} already exists`),process.exit(1));let l=e(process.cwd(),`src/examples/${y}`),d=a(r(l));await t(l,d),await i({targetDir:l},c),m.success(`Story created successfully in ${l}!`)}catch(r){m.error(`Story creation failed: ${r instanceof Error?r.message:String(r)}`,r),process.exit(1)}};
+import{basename as r,join as e}from"path";import{exitCli as t}from"../services/index.js";import{generateInitialStory as a}from"../story-scaffolding/index.js";import{askQuestion as o,exists as i,toPascalCase as s}from"../utils/index.js";import{buildStoryInDirectory as n}from"./story-build.js";export const runStoryCreateCommand=async(m={},c)=>{let{logger:y}=c;try{y.step("Creating new Storybook example");let f=m.name;if(!f)for(;!f;){let r=await o('Enter the story name (e.g., "my-feature" or "MyFeature"): ');if(!r||0===r.trim().length){y.error("Story name is required");continue}if(!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(r)){y.error("Story name must start with a letter and contain only letters, numbers, hyphens, and underscores");continue}f=r.trim()}if(!f){y.error("Story name is required"),await t(1);return}if(await i(e(process.cwd(),`src/${f}`))){y.error(`Story ${f} already exists`),await t(1);return}let l=e(process.cwd(),`src/examples/${f}`),u=s(r(l));await a(l,u),await n({targetDir:l},c),y.success(`Story created successfully in ${l}!`)}catch(r){y.error(`Story creation failed: ${r instanceof Error?r.message:String(r)}`,r),await t(1)}};

package/dist/phoenix/commands/sync.js

@@ -1 +1 @@
-import{generateProjectFiles as e}from"../application-spec/index.js";export const runSyncCommand=async(s,c)=>{let{logger:i}=c,{sdkVersion:r,projectSlug:t,environmentSlug:n,cliUseWorkspace:o,enableEditor:l,force:p=!1,analyze:a=!1}=s;try{i.step("Syncing Phoenix project files"),i.step("Building project files"),await e({sdkVersion:r,projectSlug:t,environmentSlug:n,cliUseWorkspace:o,enableEditor:l,inlineTemplates:!0,force:p,analyze:a},c),i.success("Project files built successfully"),i.success("Sync completed successfully!")}catch(e){i.error(`Sync failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{generateProjectFiles as e,logDiagnostics as s}from"../application-spec/index.js";import{exitCli as c}from"../services/index.js";export const runSyncCommand=async(i,r)=>{let{logger:t}=r,{sdkVersion:n,projectSlug:o,environmentSlug:l,cliUseWorkspace:a,enableEditor:p,force:f=!1,analyze:m=!1}=i;try{t.step("Syncing Phoenix project files"),t.step("Building project files");let{diagnostics:c}=await e({sdkVersion:n,projectSlug:o,environmentSlug:l,cliUseWorkspace:a,enableEditor:p,inlineTemplates:!0,force:f,analyze:m},r);s(c,t),t.success("Project files built successfully"),t.success("Sync completed successfully!")}catch(e){t.error(`Sync failed: ${e instanceof Error?e.message:String(e)}`,e),await c(1)}};

package/dist/phoenix/commands/variants.js

@@ -1 +1 @@
-import{createTRPCClient as e,createWSClient as t,wsLink as o}from"@trpc/client";import{existsSync as r,readFileSync as i,readdirSync as n,rmSync as a,statSync as s}from"fs";import{isAbsolute as l,join as c,relative as p,resolve as d,sep as h}from"path";import f from"ws";import{toPosixPath as w}from"../utils/path.js";let m=".phoenix",u="variants",v=".variant.js",g=".html",y={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'"},$=e=>{let t=e?.trim();return""===t?void 0:t},b=e=>$(e?.replace(/&(?:amp|lt|gt|quot|#39);/g,e=>y[e]??e)),C=(e,t)=>{let o=e.match(RegExp(`export\\s+const\\s+${t}\\s*=\\s*(['"\`])((?:\\\\.|(?!\\1).)*)\\1`))?.[2];return $(o?.replace(/\\(.)/g,"$1"))};export const readVariantSet=e=>{let t=d(e.projectRoot,m),o=c(t,u),a=d(e.projectRoot,e.directory),f=p(o,a),y=`${m}/${u}/<name>/`;if(""===f||".."===f||f.startsWith(`..${h}`)||l(f))throw Error(`Cannot preview ${e.directory}: the dev server only shows options from a folder of their own below ${m}/${u}/. Write the option files to ${y} and pass that folder`);if(!r(a)||!s(a).isDirectory())throw Error(`Cannot preview ${e.directory}: there is no such folder. Write one ${v} or ${g} file per option to ${y} first`);let $=n(a),E=Math.round(Math.max(0,...$.map(e=>s(c(a,e)).mtimeMs))),x=$.filter(e=>e.endsWith(v)||e.endsWith(g)).sort().map(e=>(e=>{let{webRoot:t,directory:o,name:r,version:n}=e,a=c(o,r),s=i(a,"utf8"),l=`/${w(p(t,a)).split("/").map(encodeURIComponent).join("/")}`,d=r.endsWith(v),h=r.slice(0,-(d?v:g).length),f=s.match(/<meta\b[^>]*\bname=(["'])description\1[^>]*>/i)?.[0];return{id:h,kind:d?"script":"page",label:(d?C(s,"title"):b(s.match(/<title[^>]*>([^<]*)<\/title>/i)?.[1]))??h,description:(d?C(s,"description"):b(f?.match(/\bcontent=(["'])(.*?)\1/i)?.[2]))??"",url:`${l}?t=${n}`}})({webRoot:t,directory:a,name:e,version:E}));if(0===x.length)throw Error(`Cannot preview ${e.directory}: it holds no ${v} or ${g} file, so there is no option to show. Write one file per option; any other file is a helper the options share`);let R=x.find((e,t)=>x.findIndex(t=>t.id===e.id)!==t);if(R)throw Error(`Cannot preview ${e.directory}: two options are named "${R.id}", and the answer names an option by its file name without the suffix. Rename one of the files`);return{directory:a,variantsRoot:o,options:x}};let E=r=>{let i=t({url:`ws://localhost:${r}`,WebSocket:f});return{wsClient:i,client:e({links:[o({client:i})]})}},x=e=>{console.log(JSON.stringify(e,null,2))},R=async e=>{let{wsClient:t,client:o}=E(e);try{let{closed:e}=await o.closeVariantPreview.mutate();x({status:"closed",message:e?"The open preview was closed.":"No preview was open."})}finally{await t.close()}},S=async(e,t,o,i)=>{let{wsClient:s,client:l}=E(t.port);try{let s=await l.previewVariants.mutate({title:t.title??"Which option do you prefer?",description:t.description??"",variants:[...e.options],timeoutMs:o});if("waiting"===s.status)return void x({status:"waiting",message:"The preview is still open and nothing was picked yet. Run the same command again to keep waiting."});if("closed"===s.status)return void x({status:"closed",message:"The preview was closed before an answer was given. The option folder is kept."});await l.claimVariantChoice.mutate({requestId:s.requestId});let c=e.options.find(e=>e.id===s.choice);if(x({status:"chosen",choice:s.choice,label:c?.label??"Original"}),!t.keep)try{a(e.directory,{recursive:!0,force:!0}),r(e.variantsRoot)&&0===n(e.variantsRoot).length&&a(e.variantsRoot,{recursive:!0,force:!0})}catch(t){i.logger.warn(`Could not remove ${e.directory} after the answer: ${t instanceof Error?t.message:String(t)}. Remove the folder yourself`)}}finally{await s.close()}};export const runVariantsCommand=async(e,t)=>{let{logger:o}=t;try{if(e.close)return void await R(e.port);if(void 0===e.directory)throw Error(`Cannot preview without a folder: the options to show are read from it. Pass ${m}/${u}/<name>/, or --close to close the open preview`);let o=(e=>{let t=Math.round((e??540)*1e3);if(!Number.isFinite(t)||t<=0)throw Error(`Cannot wait for ${e} seconds: --timeout is how long the command waits for the answer. Pass a positive number of seconds`);if(t>0x7fffffff)throw Error(`Cannot wait for ${e} seconds: a wait is at most ${Math.floor(2147483.647)} seconds. Pass a smaller --timeout and run the command again while it answers "waiting"`);return t})(e.timeout),r=readVariantSet({projectRoot:process.cwd(),directory:e.directory});await S(r,e,o,t)}catch(e){o.error((e=>{let t;if(!(e instanceof Error))return`Variant preview failed: ${String(e)}`;let o=e.cause;return null!=o&&"object"==typeof o&&"code"in o&&"ECONNREFUSED"===o.code?"Dev server not running. Start with `phoenix dev`":"object"==typeof(t="data"in e?e.data:void 0)&&null!==t&&"code"in t&&"NOT_FOUND"===t.code?"Cannot preview: the dev server that is running has no variant previews, because it runs the legacy pipeline or an older SDK. Variant previews need `phoenix dev` of a project on the application-spec pipeline, started with this SDK version":e.message})(e)),process.exit(1)}};
+import{createTRPCClient as e,createWSClient as t,wsLink as o}from"@trpc/client";import{existsSync as r,readFileSync as i,readdirSync as n,rmSync as a,statSync as s}from"fs";import{isAbsolute as l,join as c,relative as p,resolve as d,sep as h}from"path";import f from"ws";import{exitCli as w}from"../services/index.js";import{toPosixPath as m}from"../utils/path.js";let u=".phoenix",v="variants",g=".variant.js",y=".html",$={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'"},b=e=>{let t=e?.trim();return""===t?void 0:t},C=e=>b(e?.replace(/&(?:amp|lt|gt|quot|#39);/g,e=>$[e]??e)),E=(e,t)=>{let o=e.match(RegExp(`export\\s+const\\s+${t}\\s*=\\s*(['"\`])((?:\\\\.|(?!\\1).)*)\\1`))?.[2];return b(o?.replace(/\\(.)/g,"$1"))};export const readVariantSet=e=>{let t=d(e.projectRoot,u),o=c(t,v),a=d(e.projectRoot,e.directory),f=p(o,a),w=`${u}/${v}/<name>/`;if(""===f||".."===f||f.startsWith(`..${h}`)||l(f))throw Error(`Cannot preview ${e.directory}: the dev server only shows options from a folder of their own below ${u}/${v}/. Write the option files to ${w} and pass that folder`);if(!r(a)||!s(a).isDirectory())throw Error(`Cannot preview ${e.directory}: there is no such folder. Write one ${g} or ${y} file per option to ${w} first`);let $=n(a),b=Math.round(Math.max(0,...$.map(e=>s(c(a,e)).mtimeMs))),x=$.filter(e=>e.endsWith(g)||e.endsWith(y)).sort().map(e=>(e=>{let{webRoot:t,directory:o,name:r,version:n}=e,a=c(o,r),s=i(a,"utf8"),l=`/${m(p(t,a)).split("/").map(encodeURIComponent).join("/")}`,d=r.endsWith(g),h=r.slice(0,-(d?g:y).length),f=s.match(/<meta\b[^>]*\bname=(["'])description\1[^>]*>/i)?.[0];return{id:h,kind:d?"script":"page",label:(d?E(s,"title"):C(s.match(/<title[^>]*>([^<]*)<\/title>/i)?.[1]))??h,description:(d?E(s,"description"):C(f?.match(/\bcontent=(["'])(.*?)\1/i)?.[2]))??"",url:`${l}?t=${n}`}})({webRoot:t,directory:a,name:e,version:b}));if(0===x.length)throw Error(`Cannot preview ${e.directory}: it holds no ${g} or ${y} file, so there is no option to show. Write one file per option; any other file is a helper the options share`);let R=x.find((e,t)=>x.findIndex(t=>t.id===e.id)!==t);if(R)throw Error(`Cannot preview ${e.directory}: two options are named "${R.id}", and the answer names an option by its file name without the suffix. Rename one of the files`);return{directory:a,variantsRoot:o,options:x}};let x=r=>{let i=t({url:`ws://localhost:${r}`,WebSocket:f});return{wsClient:i,client:e({links:[o({client:i})]})}},R=e=>{console.log(JSON.stringify(e,null,2))},j=async e=>{let{wsClient:t,client:o}=x(e);try{let{closed:e}=await o.closeVariantPreview.mutate();R({status:"closed",message:e?"The open preview was closed.":"No preview was open."})}finally{await t.close()}},S=async(e,t,o,i)=>{let{wsClient:s,client:l}=x(t.port);try{let s=await l.previewVariants.mutate({title:t.title??"Which option do you prefer?",description:t.description??"",variants:[...e.options],timeoutMs:o});if("waiting"===s.status)return void R({status:"waiting",message:"The preview is still open and nothing was picked yet. Run the same command again to keep waiting."});if("closed"===s.status)return void R({status:"closed",message:"The preview was closed before an answer was given. The option folder is kept."});await l.claimVariantChoice.mutate({requestId:s.requestId});let c=e.options.find(e=>e.id===s.choice);if(R({status:"chosen",choice:s.choice,label:c?.label??"Original"}),!t.keep)try{a(e.directory,{recursive:!0,force:!0}),r(e.variantsRoot)&&0===n(e.variantsRoot).length&&a(e.variantsRoot,{recursive:!0,force:!0})}catch(t){i.logger.warn(`Could not remove ${e.directory} after the answer: ${t instanceof Error?t.message:String(t)}. Remove the folder yourself`)}}finally{await s.close()}};export const runVariantsCommand=async(e,t)=>{let{logger:o}=t;try{if(e.close)return void await j(e.port);if(void 0===e.directory)throw Error(`Cannot preview without a folder: the options to show are read from it. Pass ${u}/${v}/<name>/, or --close to close the open preview`);let o=(e=>{let t=Math.round((e??540)*1e3);if(!Number.isFinite(t)||t<=0)throw Error(`Cannot wait for ${e} seconds: --timeout is how long the command waits for the answer. Pass a positive number of seconds`);if(t>0x7fffffff)throw Error(`Cannot wait for ${e} seconds: a wait is at most ${Math.floor(2147483.647)} seconds. Pass a smaller --timeout and run the command again while it answers "waiting"`);return t})(e.timeout),r=readVariantSet({projectRoot:process.cwd(),directory:e.directory});await S(r,e,o,t)}catch(e){o.error((e=>{let t;if(!(e instanceof Error))return`Variant preview failed: ${String(e)}`;let o=e.cause;return null!=o&&"object"==typeof o&&"code"in o&&"ECONNREFUSED"===o.code?"Dev server not running. Start with `phoenix dev`":"object"==typeof(t="data"in e?e.data:void 0)&&null!==t&&"code"in t&&"NOT_FOUND"===t.code?"Cannot preview: the dev server that is running has no variant previews, because it runs the legacy pipeline or an older SDK. Variant previews need `phoenix dev` of a project on the application-spec pipeline, started with this SDK version":e.message})(e)),await w(1)}};

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

@@ -0,0 +1 @@
+export { LINGUI_CONFIG_PATH, bootstrapLinguiCatalogs, compileLingui, extractAndCompileLingui } from './lingui.js';

package/dist/phoenix/lingui/index.js

@@ -0,0 +1 @@
+export{LINGUI_CONFIG_PATH,bootstrapLinguiCatalogs,compileLingui,extractAndCompileLingui}from"./lingui.js";

package/dist/phoenix/{services → lingui}/lingui.d.ts

@@ -1,10 +1,11 @@
 import { type Logger } from '../utils/index.js';
 /**
  * The project's Lingui configuration, which sync generates, relative to the project root. The Lingui
- * CLI, the Lingui Vite plugin and the Lingui macros in the Vite builds are always given this path, so a
+ * CLI, the Lingui Vite plugin and the Lingui macros in the Vite builds are given this path, so a
  * `.linguirc` that earlier SDK versions left in the project root is not read. Lingui searches the
  * working directory instead only when the named file is missing; generation writes it with the rest of
- * `.phoenix/` before Phoenix runs Lingui or Vite.
+ * `.phoenix/` before Phoenix runs Lingui or Vite. Missing-catalog bootstrap compiles with a temporary
+ * copy that stages output while keeping every locale available for fallback reads.
  */
 export declare const LINGUI_CONFIG_PATH = ".phoenix/.linguirc";
 interface LinguiCommandContext {
@@ -12,4 +13,6 @@ interface LinguiCommandContext {
 }
 export declare const compileLingui: (context: LinguiCommandContext) => Promise<void>;
 export declare const extractAndCompileLingui: (context: LinguiCommandContext) => Promise<void>;
+/** Creates only catalogs missing from a project's generated domain imports; continuous updates stay opt-in. */
+export declare const bootstrapLinguiCatalogs: (locales: readonly string[], context: LinguiCommandContext) => Promise<void>;
 export {};

package/dist/phoenix/lingui/lingui.js

@@ -0,0 +1 @@
+import{constants as i}from"node:fs";import{copyFile as a,mkdir as t,mkdtemp as e,readFile as o,rm as n,writeFile as s}from"node:fs/promises";import{dirname as r,join as l}from"node:path";import{exists as c,runSdkTool as g}from"../utils/index.js";export const LINGUI_CONFIG_PATH=".phoenix/.linguirc";let p=async i=>{await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["extract","--config",LINGUI_CONFIG_PATH],description:"Extracting i18n messages",quiet:!0,extraEnv:{LC_ALL:"en_US.UTF-8"}},i)};export const compileLingui=async i=>{await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["compile","--config",LINGUI_CONFIG_PATH],description:"Compiling i18n messages",quiet:!0},i)};export const extractAndCompileLingui=async i=>{await p(i),await compileLingui(i)};export const bootstrapLinguiCatalogs=async(p,m)=>{let u,f=(await Promise.all(p.map(async i=>await c(`src/locales/${i}/messages.ts`)?[]:[i]))).flat();if(0!==f.length)try{m.logger.info(`Bootstrapping missing i18n catalogs: ${f.join(", ")}`);let n=(await Promise.all(f.map(async i=>await c(`src/locales/${i}/messages.po`)?[]:[i]))).flat();n.length>0&&await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["extract","--config",LINGUI_CONFIG_PATH,"--locale",n.join(",")],description:"Extracting missing i18n catalogs",quiet:!0,extraEnv:{LC_ALL:"en_US.UTF-8"}},m);let p=JSON.parse(await o(LINGUI_CONFIG_PATH,"utf-8"));if("object"!=typeof p||null===p||Array.isArray(p))throw Error(`${LINGUI_CONFIG_PATH} is not a configuration object`);u=await e(".phoenix/lingui-bootstrap-");let N=l(u,".linguirc");for(let e of(await s(N,JSON.stringify({...p,catalogsMergePath:l(u,"compiled","{locale}","messages").replaceAll("\\","/")})),await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["compile","--config",N],description:"Compiling missing i18n catalogs",quiet:!0},m),f)){let o=l("src","locales",e,"messages.ts");await t(r(o),{recursive:!0}),await a(l(u,"compiled",e,"messages.ts"),o,i.COPYFILE_EXCL)}}catch(i){throw Error(`Cannot bootstrap i18n catalogs for ${f.join(", ")}: ${i instanceof Error?i.message:String(i)}. Fix the reported Lingui error and restart phoenix dev, or run phoenix sync to update all catalogs.`,{cause:i})}finally{void 0!==u&&await n(u,{recursive:!0,force:!0})}};

package/dist/phoenix/services/application-spec-project-watcher.d.ts

@@ -1,4 +1,5 @@
 import { type ViteDevServer } from 'vite';
+import type { ApplicationSpec } from '#package/application-spec';
 import type { Logger } from '../utils/index.js';
 import type { PhoenixPubSub } from './phoenix-pubsub.js';
 import type { VariantFileEdit } from './variant-file-session.js';
@@ -8,7 +9,8 @@ export declare const IGNORED_PATTERNS: string[];
 export interface ApplicationSpecProjectWatcherConfig {
     readonly pubsub: PhoenixPubSub;
     readonly logger: Logger;
-    readonly onRebuilt?: () => void;
+    /** Called with the application spec of every rebuild that succeeded. */
+    readonly onRebuilt?: (applicationSpec: ApplicationSpec) => void;
     readonly onViteServerChange?: (viteServer: ViteDevServer) => void;
     readonly sdkVersion: string;
     readonly projectSlug: string;

package/dist/phoenix/services/application-spec-project-watcher.js

@@ -1,4 +1,4 @@
-import{mkdirSync as e}from"fs";import{resolve as t}from"path";import i from"promise-queue";import{Subject as s,buffer as r,debounceTime as o}from"rxjs";import{createServer as n,normalizePath as l}from"vite";import{watch as h}from"#package/watch";import{ApplicationSpecBuilder as a}from"../application-spec/application-spec-builder.js";import{logDiagnostics as c}from"../application-spec/metrics/index.js";import{syncTemplateFiles as u}from"../application-spec/template-files.js";import{buildWebhooks as p}from"../webhooks/index.js";import{getViteDevConfig as g}from"./vite-config.js";export const WATCH_PATTERNS=["spec/**/*.{yaml,yml}","src/**/*.{ts,tsx,yaml,yml,json,html,css}","templates/*.html",".env",".env.generated",".phoenix/.env.generated"];export const IGNORED_PATTERNS=["src/locales/**/*.{ts,tsx}",".phoenix/!(.env.generated)/**"];export class ApplicationSpecProjectWatcher{watcher=null;subscription=null;rebuildQueue=new i(1,1/0);changeSubject$=new s;viteServer=null;pubsub;logger;onRebuilt;onViteServerChange;builder;useServer;isShuttingDown=!1;suspended=!1;heldChanges=new Set;constructor(e){this.pubsub=e.pubsub,this.logger=e.logger,this.onRebuilt=e.onRebuilt,this.onViteServerChange=e.onViteServerChange,this.builder=new a({logger:e.logger,sdkVersion:e.sdkVersion,projectSlug:e.projectSlug,environmentSlug:e.environmentSlug,cliUseWorkspace:e.cliUseWorkspace,enableEditor:e.enableEditor,inlineTemplates:e.inlineTemplates}),this.useServer=e.useServer}start(e){this.viteServer=e,this.setupFileWatcher(),this.setupRebuildSubscription()}applyVariantFiles(e){this.rebuildQueue.add(async()=>{this.isShuttingDown||await this.rebuild(new Set(e.map(e=>e.fileName)),!1,!0)})}suspend(){this.suspended=!0}resume(){for(let e of(this.suspended=!1,this.heldChanges))this.changeSubject$.next(e);this.heldChanges.clear()}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){e(t(process.cwd(),"src"),{recursive:!0}),this.watcher=h(WATCH_PATTERNS,{ignored:IGNORED_PATTERNS,cwd:process.cwd(),persistent:!0,ignoreInitial:!1}),this.watcher.on("all",(e,t)=>{if("change"===e||"add"===e||"unlink"===e){if(this.suspended)return void this.heldChanges.add(t);this.logger.info(`
+import{mkdirSync as e}from"fs";import{resolve as t}from"path";import i from"promise-queue";import{Subject as s,buffer as r,debounceTime as o}from"rxjs";import{createServer as n,normalizePath as l}from"vite";import{watch as a}from"#package/watch";import{ApplicationSpecBuilder as h}from"../application-spec/application-spec-builder.js";import{logDiagnostics as c}from"../application-spec/metrics/index.js";import{syncTemplateFiles as u}from"../application-spec/template-files.js";import{buildWebhooks as p}from"../webhooks/index.js";import{getViteDevConfig as g}from"./vite-config.js";export const WATCH_PATTERNS=["package.json","spec/**/*.{yaml,yml}","src/**/*.{ts,tsx,yaml,yml,json,html,css}","templates/*.html",".env",".env.generated",".phoenix/.env.generated"];export const IGNORED_PATTERNS=["src/locales/**/*.{ts,tsx}",".phoenix/!(.env.generated)/**"];export class ApplicationSpecProjectWatcher{watcher=null;subscription=null;rebuildQueue=new i(1,1/0);changeSubject$=new s;viteServer=null;pubsub;logger;onRebuilt;onViteServerChange;builder;useServer;isShuttingDown=!1;suspended=!1;heldChanges=new Set;constructor(e){this.pubsub=e.pubsub,this.logger=e.logger,this.onRebuilt=e.onRebuilt,this.onViteServerChange=e.onViteServerChange,this.builder=new h({logger:e.logger,sdkVersion:e.sdkVersion,projectSlug:e.projectSlug,environmentSlug:e.environmentSlug,cliUseWorkspace:e.cliUseWorkspace,enableEditor:e.enableEditor,inlineTemplates:e.inlineTemplates}),this.useServer=e.useServer}start(e){this.viteServer=e,this.setupFileWatcher(),this.setupRebuildSubscription()}applyVariantFiles(e){this.rebuildQueue.add(async()=>{this.isShuttingDown||await this.rebuild(new Set(e.map(e=>e.fileName)),!1,!0)})}suspend(){this.suspended=!0}resume(){for(let e of(this.suspended=!1,this.heldChanges))this.changeSubject$.next(e);this.heldChanges.clear()}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){e(t(process.cwd(),"src"),{recursive:!0}),this.watcher=a(WATCH_PATTERNS,{ignored:IGNORED_PATTERNS,cwd:process.cwd(),persistent:!0,ignoreInitial:!1}),this.watcher.on("all",(e,t)=>{if("change"===e||"add"===e||"unlink"===e){if(this.suspended)return void this.heldChanges.add(t);this.logger.info(`
 📝 Detected ${e}: ${t}`),this.changeSubject$.next(t)}})}setupRebuildSubscription(){let e=this.changeSubject$.pipe(o(10));this.subscription=this.changeSubject$.pipe(r(e)).subscribe(e=>{let t=new Set(e),i=t.has(".env");this.rebuildQueue.add(async()=>{this.isShuttingDown||(this.logger.info(`
 🔨 Rebuilding spec files...
-`),await this.rebuild(t,i,!1))})})}async rebuild(e,i,s){try{let r=this.viteServer;if(!r)throw Error("Cannot rebuild the project: the watcher has no Vite server yet, because it was not started. Start the watcher before applying files");let o=await u();if(this.isShuttingDown)return;let h=await this.builder.build({compile:!s});if(this.isShuttingDown)return;if(c(h.diagnostics,this.logger),!h.ok){for(let e of h.errors)this.logger.error(`[${e.code}] ${e.message}${e.file?` (${e.file})`:""}`);this.pubsub.specFile$.next({rawProjectFiles:h.rawProjectFiles,projectRoot:process.cwd()});return}this.onRebuilt?.();let{application:a,changedFiles:d}=h,w=r.moduleGraph,b=Date.now(),f=new Set,S=process.cwd(),m=e=>{let t=w.getModulesByFile(l(e));if(t)for(let e of t)w.invalidateModule(e,f,b,!0)};for(let i of e)m(t(S,i));for(let e of d)m(t(S,`.phoenix/${e.path}`));if(this.pubsub.specFile$.next({rawProjectFiles:a.rawProjectFiles,projectRoot:process.cwd(),configurationSchemaHash:a.applicationSpec.configurator.configurationSchema.hash}),this.isShuttingDown)return;if(i){if(await r.close(),this.isShuttingDown)return;let e=await g({templateFiles:o});if(this.isShuttingDown)return;let t=await n(e);if(this.isShuttingDown||(await t.listen(),this.isShuttingDown))return void await t.close();this.viteServer=t,this.onViteServerChange?.(t),this.logger.success("Vite server restarted (env changed)")}if(this.useServer&&!s){if(this.logger.step("Building webhooks"),await p({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js",preserveExistingOutput:!0}),this.isShuttingDown)return;this.logger.success("Webhooks rebuilt successfully")}this.logger.success("Project files rebuilt successfully")}catch(e){this.logger.error(`Build failed: ${e instanceof Error?e.message:String(e)}`,e)}}}
+`),await this.rebuild(t,i,!1))})})}async rebuild(e,i,s){try{let r=this.viteServer;if(!r)throw Error("Cannot rebuild the project: the watcher has no Vite server yet, because it was not started. Start the watcher before applying files");let o=await u();if(this.isShuttingDown)return;let a=await this.builder.build({compile:!s});if(this.isShuttingDown)return;if(c(a.diagnostics,this.logger),!a.ok){for(let e of a.errors)this.logger.error(`[${e.code}] ${e.message}${e.file?` (${e.file})`:""}`);this.pubsub.specFile$.next({rawProjectFiles:a.rawProjectFiles,projectRoot:process.cwd()});return}let{application:h,changedFiles:d}=a;this.onRebuilt?.(h.applicationSpec);let w=r.moduleGraph,b=Date.now(),f=new Set,S=process.cwd(),m=e=>{let t=w.getModulesByFile(l(e));if(t)for(let e of t)w.invalidateModule(e,f,b,!0)};for(let i of e)m(t(S,i));for(let e of d)m(t(S,`.phoenix/${e.path}`));if(this.pubsub.specFile$.next({rawProjectFiles:h.rawProjectFiles,projectRoot:process.cwd(),configurationSchemaHash:h.applicationSpec.configurator.configurationSchema.hash}),this.isShuttingDown)return;if(i){if(await r.close(),this.isShuttingDown)return;let e=await g({templateFiles:o});if(this.isShuttingDown)return;let t=await n(e);if(this.isShuttingDown||(await t.listen(),this.isShuttingDown))return void await t.close();this.viteServer=t,this.onViteServerChange?.(t),this.logger.success("Vite server restarted (env changed)")}if(this.useServer&&!s){if(this.logger.step("Building webhooks"),await p({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js",preserveExistingOutput:!0}),this.isShuttingDown)return;this.logger.success("Webhooks rebuilt successfully")}this.logger.success("Project files rebuilt successfully")}catch(e){this.logger.error(`Build failed: ${e instanceof Error?e.message:String(e)}`,e)}}}

package/dist/phoenix/services/cli-credentials.d.ts

@@ -5,6 +5,7 @@ import { z } from 'zod';
 declare const ServerCredentials: z.ZodObject<{
     token: z.ZodString;
     userId: z.ZodString;
+    customerId: z.ZodOptional<z.ZodString>;
     customerSlug: z.ZodString;
     customerName: z.ZodString;
     studioUrl: z.ZodOptional<z.ZodString>;
@@ -12,6 +13,7 @@ declare const ServerCredentials: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     token: string;
     userId: string;
+    customerId?: string | undefined;
     customerSlug: string;
     customerName: string;
     studioUrl?: string | undefined;
@@ -19,6 +21,7 @@ declare const ServerCredentials: z.ZodObject<{
 }, {
     token: string;
     userId: string;
+    customerId?: string | undefined;
     customerSlug: string;
     customerName: string;
     studioUrl?: string | undefined;

package/dist/phoenix/services/cli-credentials.js

@@ -1,2 +1,2 @@
-import{chmod as e,mkdir as r,readFile as t,writeFile as s}from"node:fs/promises";import{homedir as n}from"node:os";import{dirname as a,join as i}from"node:path";import{z as o}from"zod";let l=o.object({token:o.string().min(1),userId:o.string(),customerSlug:o.string(),customerName:o.string(),studioUrl:o.string().optional(),createdAt:o.string()}),c=o.object({version:o.literal(1),servers:o.record(o.string(),l)}),d={version:1,servers:{}};export const getCredentialsPath=()=>process.env.PHOENIX_CREDENTIALS_FILE??i(n(),".phoenix","credentials.json");let u=e=>new URL(e).origin,g=async()=>{let e;try{e=await t(getCredentialsPath(),"utf8")}catch(e){if(e instanceof Error&&"code"in e&&"ENOENT"===e.code)return d;throw e}let r=c.safeParse((e=>{try{return JSON.parse(e)}catch{return null}})(e));if(!r.success)throw Error(`The credentials file ${getCredentialsPath()} is not valid. Delete it and run \`phoenix login\` again.`);return r.data},m=async t=>{let n=getCredentialsPath();return await r(a(n),{recursive:!0,mode:448}),await s(n,`${JSON.stringify(t,null,2)}
+import{chmod as e,mkdir as r,readFile as t,writeFile as s}from"node:fs/promises";import{homedir as n}from"node:os";import{dirname as i,join as o}from"node:path";import{z as a}from"zod";let l=a.object({token:a.string().min(1),userId:a.string(),customerId:a.string().uuid().optional(),customerSlug:a.string(),customerName:a.string(),studioUrl:a.string().optional(),createdAt:a.string()}),c=a.object({version:a.literal(1),servers:a.record(a.string(),l)}),d={version:1,servers:{}};export const getCredentialsPath=()=>process.env.PHOENIX_CREDENTIALS_FILE??o(n(),".phoenix","credentials.json");let u=e=>new URL(e).origin,g=async()=>{let e;try{e=await t(getCredentialsPath(),"utf8")}catch(e){if(e instanceof Error&&"code"in e&&"ENOENT"===e.code)return d;throw e}let r=c.safeParse((e=>{try{return JSON.parse(e)}catch{return null}})(e));if(!r.success)throw Error(`The credentials file ${getCredentialsPath()} is not valid. Delete it and run \`phoenix login\` again.`);return r.data},m=async t=>{let n=getCredentialsPath();return await r(i(n),{recursive:!0,mode:448}),await s(n,`${JSON.stringify(t,null,2)}
 `,{mode:384}),await e(n,384),n};export const getServerCredentials=async e=>(await g()).servers[u(e)]??null;export const saveServerCredentials=async(e,r)=>{let t=await g();return m({...t,servers:{...t.servers,[u(e)]:r}})};export const removeServerCredentials=async e=>{let r=await g(),{[u(e)]:t,...s}=r.servers;await m({...r,servers:s})};

package/dist/phoenix/services/cli-exit.d.ts

@@ -0,0 +1,5 @@
+type BeforeCliExit = (exitCode: number) => Promise<void>;
+export declare const setBeforeCliExit: (handler: BeforeCliExit) => (() => void);
+/** Gives the Phoenix CLI a chance to finish best-effort work, then preserves process.exit semantics. */
+export declare const exitCli: (exitCode: number) => Promise<never>;
+export {};

package/dist/phoenix/services/cli-exit.js

@@ -0,0 +1 @@
+let t=null;export const setBeforeCliExit=e=>(t=e,()=>{t===e&&(t=null)});export const exitCli=async e=>{try{await t?.(e)}finally{process.exit(e)}};

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

@@ -8,6 +8,7 @@ export { MockTemplateWatcher, type MockTemplateWatcherConfig } from './mock-temp
 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 +19,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{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{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/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/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})};