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

package/dist/phoenix/commands/deployment-build-envs-command.d.ts

@@ -0,0 +1,16 @@
+import type { CommandContext } from './types.js';
+export interface DeploymentBuildEnvsCommandProps {
+    readonly uuid: string;
+    readonly apiKey: string;
+    readonly projectKey: string;
+    readonly projectSlug: string;
+    readonly outFile: string;
+    readonly serverUrl: string;
+    readonly debug: boolean;
+}
+/**
+ * Writes the environment for the build step of a prepared deployment whose build and deploy run separately. The
+ * file has the format `deployment:prepare` writes, without platform secrets and infrastructure values, so the
+ * project builds with it unchanged.
+ */
+export declare const runDeploymentBuildEnvsCommand: (props: DeploymentBuildEnvsCommandProps, context: CommandContext) => Promise<void>;

package/dist/phoenix/commands/deployment-build-envs-command.js

@@ -0,0 +1 @@
+import{writeFile as e}from"fs/promises";import{createApiBaseClient as r}from"#package/client";import{formatEnvContent as t,formatEnvLine as i}from"../utils/index.js";export const runDeploymentBuildEnvsCommand=async(n,o)=>{let{logger:s}=o;try{s.step("Fetching build environment");let{uuid:o,apiKey:a,projectKey:l,projectSlug:m,outFile:d,serverUrl:u}=n,c=r(u);s.debug(`Using server URL: ${u}, deployment ID: ${o}`);let{data:p,error:v}=await c.GET("/deployments/{deploymentId}/build-envs",{params:{path:{deploymentId:o}},headers:{"x-api-key":a,"x-project-key":l,"x-project-slug":m}});if(v)throw Error(`Failed to fetch the build environment from server: ${v.message}`);if(!p)throw Error("No data returned from server");let f=[t(p.environmentVariables),i("BASE_DOMAIN",String(p.baseDomain)),i("IS_CUSTOM_DOMAIN",String(p.isCustomDomain))].join("\n");try{await e(d,f+"\n"),s.debug(`Build environment variables written to ${d}`)}catch(e){throw Error("Failed to write build environment variables to file")}s.success("Build environment written successfully!")}catch(e){s.error(`Fetching build environment failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};

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

@@ -0,0 +1,19 @@
+import { type DevelopmentCredential } from '../services/development-credential.js';
+import type { CommandContext } from './types.js';
+export interface DevCommandProps {
+    readonly sdkVersion: string;
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+    readonly cliUseWorkspace?: boolean;
+    readonly enableEditor?: boolean;
+    readonly editorWsPort?: string;
+    readonly debug?: boolean;
+    readonly withLingui?: boolean;
+    readonly persistenceMode?: string;
+    readonly force?: boolean;
+    readonly tui?: boolean;
+    readonly serverUrl?: string;
+    readonly credential?: DevelopmentCredential;
+    readonly skipUpload: boolean;
+}
+export declare const runDevCommand: (props: DevCommandProps, context: CommandContext) => Promise<void>;

package/dist/phoenix/commands/dev.js

@@ -0,0 +1,5 @@
+import{format as e}from"node:util";import{createServer as t}from"vite";import{startEditorServer as r}from"../editor-server/index.js";import{getDevelopmentCredentialHint as o}from"../services/development-credential.js";import{ApplicationSpecProjectWatcher as n,LinguiWatcher as s,LogBus as i,MockTemplateWatcher as a,PhoenixPubSub as l,WebhookTunnelMonitor as c,createBusLogger as p,getViteDevConfig as d,patchConsole as u,setViteLogSink as m}from"../services/index.js";import{prepareDevelopmentEnvironment as g}from"../services/prepare-development-environment.js";import{createWebhookTunnelTransport as w,readOrCreateTunnelSessionId as v,startWebhookService as h}from"../services/webhook-service/index.js";import{startTui as f}from"../tui/index.js";import{FileLogger as E,createLogger as b,exists as S}from"../utils/index.js";import{buildWebhooks as I,setLogger as k,webhookLogContext as x}from"../webhooks/index.js";import{generateProjectFilesAndInstallDependencies as j}from"./generate-project-files.js";import{readGeneratedEnvMarkers as T}from"./generated-env-markers.js";export const runDevCommand=async($,N)=>{let{logger:D}=N,{sdkVersion:R,projectSlug:y,environmentSlug:P,cliUseWorkspace:_,enableEditor:O,editorWsPort:L,debug:M=!1,withLingui:V=!1,persistenceMode:W,force:U=!1,tui:G=!1,serverUrl:Y,credential:C,skipUpload:H}=$,B=null,X=null,q=null,F=null,J=null,Q=null,z=new E,A=new l,K=new i,Z=G&&!!process.stdout.isTTY&&!!process.stdin.isTTY,ee=!Z,et=null;G&&!Z&&D.warn("TUI requested but stdin/stdout is not an interactive terminal — falling back to plain log output. Run phoenix dev --tui directly in a terminal to use the TUI.");let er=null,eo=D,en=null,es=()=>{et&&(et(),et=null),er&&(er.unmount(),er=null,eo=b({debug:M,fileLogger:z}))},ei=(e=0)=>en||(en=(async()=>{process.off("SIGINT",ea),process.off("SIGTERM",ea),process.off("uncaughtException",el),es(),eo.debug("Shutting down...");let t=[];for(let e of[{name:"lingui watcher",close:()=>F?.close()},{name:"project watcher",close:()=>Q?.close()},{name:"mock template watcher",close:()=>J?.close()},{name:"editor server",close:()=>q?.close()},{name:"vite server",close:()=>B?.close()},{name:"webhook tunnel",close:()=>X?.stop()}])try{eo.debug(`Shutting down ${e.name}`),await e.close()}catch(r){t.push(`${e.name}: ${r instanceof Error?r.message:String(r)}`)}t.length>0&&eo.warn(`Cleanup warnings:
+  ${t.join("\n  ")}`),eo.debug("Shutdown complete"),await z.close(),process.exit(e)})()),ea=()=>{ei(0)},el=e=>{es(),eo.error(`Uncaught exception: ${e.message}`),ei(1)};process.once("SIGINT",ea),process.once("SIGTERM",ea),process.once("uncaughtException",el);try{await z.init(".phoenix"),eo=p({bus:K,stream:"spec",debug:M,fileLogger:z,echo:!0}),m((e,t)=>K.push("vite",e,t),{echo:ee}),k({transports:[],log:(t,...r)=>{K.push("webhook","warn"===t||"error"===t?t:"info",e(...r)),ee&&process.stdout.write(`${e(t,...r)}
+`)}}),A.browserConsole$.subscribe(e=>{K.push("browser",e.level,e.source?`[${e.source}] ${e.message}`:e.message);let t=`[${e.source?`browser:${e.source}`:"browser"}] ${e.message}`;z.write("warn",t),ee&&process.stderr.write(`⚠️  ${t}
+`)}),ee&&(et=u(K,{echo:!0})),process.env.NODE_ENV="development",W&&(process.env.PERSISTENCE_MODE=W);let i=!W||"server"===W,l=i&&Y?new c(Y):void 0;if(eo.step("Starting development mode"),!await S("spec")){eo.error('Spec folder not found. Run "phoenix init" first.'),await ei(1);return}if(i){if(!Y||!C)throw Error("Server persistence needs a server and a credential. Run `phoenix login <workspace>`, or create a development environment in Studio and paste its .env block into .env.");let e=await T(".env.generated");e?.PHOENIX_PROJECT_SLUG!==y||e.PHOENIX_ENVIRONMENT_SLUG!==P||e.PHOENIX_SERVER_URL!==Y?(eo.step("Preparing development deployment"),await g({serverUrl:Y,projectSlug:y,environmentSlug:P,credential:C,outFile:".env.generated",skipUpload:H,overrideSchema:!0,debug:M,projectVersion:R},{logger:eo})):eo.debug(".env.generated matches the current development environment, skipping prepare")}eo.step("Building project files");let{templateFiles:E}=await j({sdkVersion:R,projectSlug:y,environmentSlug:P,cliUseWorkspace:_,enableEditor:O,withLingui:V,force:U},{logger:eo});if(eo.success("Project files built successfully"),Z&&(eo=p({bus:K,stream:"spec",debug:M,fileLogger:z}),et=u(K),er=f(K,{onQuit:()=>void ei(0)})),V?(F=new s({logger:eo})).start():eo.warn("Lingui is disabled: i18n messages are not extracted or compiled during dev. Pass --withLingui or set WITH_LINGUI=true to enable."),i&&(eo.step("Building webhooks"),await x.run("webhook",async()=>{await I({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js"})})),i&&Y&&C){let e=await T(".env.generated");if(!e?.DEPLOYMENT_ID)throw Error("Webhook tunnel cannot start because .env.generated has no DEPLOYMENT_ID. Rerun phoenix dev to prepare the development deployment.");let t=await v();X=await h({experimental:!0,transport:w({serverUrl:Y,credential:C,projectSlug:y,environmentSlug:P}),rejectionHint:o(C,y),environmentSlug:P,deploymentId:e.DEPLOYMENT_ID,sessionId:t,onStatus:(r,o)=>{l?.setStatus(r,{deploymentId:e.DEPLOYMENT_ID,sessionId:t,message:o??null})},onRequest:e=>l?.record(e)}),l?.setStatus("waiting",{deploymentId:e.DEPLOYMENT_ID,sessionId:t}),X.stopped.catch(e=>{es(),eo.error(`Webhook tunnel failed: ${e instanceof Error?e.message:String(e)}`),ei(1)}),eo.success("Webhook tunnel started")}if(O&&L){eo.step("Starting editor WebSocket server");let e=parseInt(L,10);q=r({port:e,projectRoot:process.cwd(),pubsub:A,logger:eo,logBus:K,tunnelMonitor:l,debug:M,prepareDeployment:i&&Y&&C?()=>g({serverUrl:Y,projectSlug:y,environmentSlug:P,credential:C,outFile:".env.generated",skipUpload:!0,overrideSchema:!0,debug:!1,projectVersion:R},{logger:eo}):void 0}),await q.ready,eo.debug(`Editor WebSocket server started on port ${e}`),(J=new a({projectRoot:process.cwd(),pubsub:A,logger:eo})).start()}let b=await d({templateFiles:E});if(B=await t(b),await B.listen(),eo.step("Starting Vite dev server"),(Q=new n({viteServer:B,pubsub:A,logger:eo,onRebuilt:()=>F?.trigger(),onViteServerChange:e=>{B=e},sdkVersion:R,projectSlug:y,environmentSlug:P,cliUseWorkspace:_,enableEditor:O??!0,inlineTemplates:!1,useServer:i})).start(),Z)eo.success("Vite dev server started — watching for changes"),O&&L&&eo.info(`Editor WebSocket: ws://localhost:${L}`);else if(M)eo.success("Vite dev server started");else{let e=e=>{K.push("spec","info",e),process.stdout.write(`${e}
+`)};e("\n\uD83D\uDE80 Phoenix Dev Server\n"),O&&L&&e(`Editor WebSocket: ws://localhost:${L}`),e("\n\uD83D\uDC40 Watching for changes...\n")}}catch(e){es(),eo.error(`Dev mode failed: ${e instanceof Error?e.message:String(e)}`,e),await ei(1)}};

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

@@ -0,0 +1,31 @@
+import type { DocCategory, DocEntry, DocsIndex } from '../scripts/docs-utils.js';
+import type { CommandContext } from './types.js';
+export interface DocsCommandProps {
+    readonly read?: string;
+    readonly category?: string;
+    readonly list?: boolean;
+    readonly search?: string;
+    readonly dir?: boolean;
+}
+export interface DocSearchResult {
+    readonly entry: DocEntry;
+    readonly matches: readonly {
+        readonly line: number;
+        readonly text: string;
+        readonly matchIndex: number;
+        readonly matchLength: number;
+    }[];
+    readonly matchCount: number;
+    readonly metadataMatch: boolean;
+}
+export declare const flattenDocs: (categories: readonly DocCategory[]) => readonly DocEntry[];
+export declare const findCategory: (categories: readonly DocCategory[], name: string) => DocCategory | undefined;
+export declare const formatIndex: (index: DocsIndex) => string;
+export declare const formatDocPaths: (index: DocsIndex) => string;
+export declare const searchDocs: (index: DocsIndex, readDoc: (path: string) => string, term: string) => readonly DocSearchResult[];
+export declare const formatSearchResults: (results: readonly DocSearchResult[], options?: {
+    readonly maxSnippets?: number;
+    readonly maxLineLength?: number;
+}) => string;
+export declare const formatCategory: (category: DocCategory) => string;
+export declare const runDocsCommand: (props: DocsCommandProps, context: CommandContext) => Promise<void>;

package/dist/phoenix/commands/docs.js

@@ -0,0 +1 @@
+import{readFileSync as e}from"fs";import{dirname as t,join as o}from"path";import{fileURLToPath as r}from"url";import{truncateAtWord as n}from"../scripts/docs-utils.js";let s=o(t(r(import.meta.url)),"../.."),a=o(s,"docs/index.json");export const flattenDocs=e=>{let t=[],o=e=>{for(let r of e)t.push(...r.docs),o(r.subcategories)};return o(e),t};export const findCategory=(e,t)=>{let o=t.toLowerCase(),r=e=>{for(let t of e){if(t.name.toLowerCase()===o)return t;let e=r(t.subcategories);if(e)return e}};return r(e)};let c=e=>{let t=e.docs.length;for(let o of e.subcategories)t+=c(o);return t};export const formatIndex=e=>{let t=flattenDocs(e.categories).length,o=[`Phoenix SDK Documentation (${t} docs)`,"","Browse SDK docs for guides on domain model, components, layouts, 3D scene,","webhooks, and more. Use flags below to search, read, or browse by category.","","Categories:"];for(let t of e.categories){let e=c(t),r=t.subcategories.length>0?` (${t.subcategories.map(e=>e.name).join(", ")})`:"";o.push(`  ${t.name} — ${e} docs${r}`)}return o.push("","Usage:","  pnpm phoenix docs -s 'snackbar'         Search all doc content","  pnpm phoenix docs --dir                  Print docs directory for grep","  pnpm phoenix docs -l                     List all doc paths",'  pnpm phoenix docs -l | grep "camera"     Search doc titles',"  pnpm phoenix docs -r <path>              Read a doc (raw MDX to stdout)",'  pnpm phoenix docs -r <path> | grep "ex"  Search within a doc',"  pnpm phoenix docs -c Phoenix             Browse docs in a category"),o.join("\n")};export const formatDocPaths=e=>flattenDocs(e.categories).map(e=>`${e.path}	${e.title}`).join("\n");export const searchDocs=(e,t,o)=>{let r=o.toLowerCase();return flattenDocs(e.categories).map(e=>{let n=t(e.path).split("\n").flatMap((e,t)=>{let n=e.toLowerCase().indexOf(r);return n>=0?[{line:t+1,text:e,matchIndex:n,matchLength:o.length}]:[]}),s=[e.title,e.description,...e.category].some(e=>e.toLowerCase().includes(r));return{entry:e,matches:n,matchCount:n.length+Number(s),metadataMatch:s}}).filter(e=>e.matchCount>0).sort((e,t)=>t.matchCount-e.matchCount||e.entry.path.localeCompare(t.entry.path))};export const formatSearchResults=(e,t={})=>{let{maxSnippets:o=3,maxLineLength:r=120}=t;return e.map(e=>{let t=[`${e.entry.path}	${e.entry.title}`],s=e.matches.slice(0,o);for(let e of s){let o=e.text.trim(),s=e.text.length-e.text.trimStart().length,a=Math.max(0,e.matchIndex-s),c=n(o,r),i=o.slice(a,a+e.matchLength);if(c.toLowerCase().includes(i.toLowerCase())){t.push(`  L${e.line}: ${c}`);continue}let l=Math.max(1,r-6),h=Math.min(e.matchLength,l),p=Math.min(Math.max(0,a-Math.floor((l-h)/2)),Math.max(0,o.length-l)),m=Math.min(o.length,p+l),d=p>0?"...":"",f=m<o.length?"...":"";t.push(`  L${e.line}: ${d}${o.slice(p,m)}${f}`)}let a=e.matches.length-s.length;return a>0&&t.push(`  (+${a} more)`),t.join("\n")}).join("\n\n")};export const formatCategory=e=>{let t=c(e),o=[`${e.name} (${t} docs)`,""],r=(e,t)=>{let s="  ".repeat(t);for(let t of e.docs){let e=t.description?` — ${n(t.description,60)}`:"";o.push(`${s}${t.title}${e}`),o.push(`${s}  ${t.path}`)}for(let n of e.subcategories){let e=c(n);o.push(`${s}${n.name} (${e} docs)`),r(n,t+1)}};return r(e,1),o.join("\n")};export const runDocsCommand=async(t,r)=>{let{logger:n}=r;try{if(t.dir)return void console.log(o(s,"docs"));let r=e(a,"utf-8"),c=JSON.parse(r);if(t.list)return void console.log(formatDocPaths(c));if(t.search){let r=searchDocs(c,t=>e(o(s,t),"utf-8"),t.search);0===r.length&&(n.error(`No docs match "${t.search}"`),process.exit(1)),console.log(formatSearchResults(r));return}if(t.read){let r=o(s,t.read),n=e(r,"utf-8");console.log(n);return}if(t.category){let e=findCategory(c.categories,t.category);if(!e){n.error(`Category "${t.category}" not found`);let e=c.categories.map(e=>e.name);n.info(`Available categories: ${e.join(", ")}`),process.exit(1)}console.log(formatCategory(e));return}console.log(formatIndex(c))}catch(e){throw e instanceof Error&&"code"in e&&"ENOENT"===e.code&&(n.error("Docs index not found. Run docs generation first (pnpm run generate:docs-index)"),process.exit(1)),e}};

package/dist/phoenix/commands/extract-sources-command.d.ts

@@ -0,0 +1,10 @@
+import type { CommandContext } from './types.js';
+export interface ExtractSourcesCommandProps {
+    readonly archivePath: string;
+    readonly targetDir: string;
+}
+/**
+ * Validates the source archive of a `phoenix deploy` and extracts its project files into a new folder. The build
+ * runner calls it on the uploaded archive before it prepares the deployment.
+ */
+export declare const runExtractSourcesCommand: (props: ExtractSourcesCommandProps, { logger }: CommandContext) => Promise<void>;

package/dist/phoenix/commands/extract-sources-command.js

@@ -0,0 +1 @@
+import{resolve as e}from"node:path";import{extractSourceArchive as t}from"../services/index.js";export const runExtractSourcesCommand=async(r,{logger:o})=>{let i=e(r.targetDir),{fileCount:n,skipped:a}=await t({archivePath:e(r.archivePath),targetDir:i});if(0===n)throw Error("The source archive contains no project files, so there is nothing to build. Pack the project with phoenix deploy.");if(a.length>0){let e=a.slice(0,10).join(", "),t=a.length>10?`, and ${a.length-10} more`:"";o.warn(`Left out ${a.length} archive entries that are not project files: ${e}${t}`)}o.success(`Extracted ${n} project files to ${i}`)};

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

@@ -0,0 +1,17 @@
+import { type FeedbackType } from '@salsita-ai/contracts/domain';
+import type { CommandContext } from './types.js';
+export interface FeedbackCommandProps {
+    readonly serverUrl: string;
+    readonly message: string;
+    readonly type: FeedbackType;
+    readonly contact: string | undefined;
+    readonly agent: string | undefined;
+    readonly project: string | undefined;
+    readonly sdkVersion: string;
+    readonly clientInfo: string;
+}
+/**
+ * Sends feedback to the Phoenix team with the stored sign-in, so the server knows which workspace, user and token
+ * it comes from. Nothing of the project is attached except the name of its server project.
+ */
+export declare const runFeedbackCommand: (props: FeedbackCommandProps, { logger }: CommandContext) => Promise<void>;

package/dist/phoenix/commands/feedback.js

@@ -0,0 +1 @@
+import{FEEDBACK_CONTACT_MAX_LENGTH as e,FEEDBACK_MESSAGE_MAX_LENGTH as t}from"@salsita-ai/contracts/domain";import{createApiBaseClient as a}from"#package/client";import{getServerCredentials as r}from"../services/index.js";export const runFeedbackCommand=async(o,{logger:n})=>{let s=o.message.trim(),c=o.contact?.trim(),i=o.agent?.trim();if(0===s.length)throw Error('The feedback message is empty. Pass what you want to tell us: phoenix feedback "<message>".');if(s.length>t)throw Error(`The feedback message has ${s.length} characters, but at most ${t} are accepted. Shorten it and send it again.`);if(c&&c.length>e)throw Error(`The contact detail has ${c.length} characters, but at most ${e} are accepted. Shorten --contact and send the feedback again.`);let h=await r(o.serverUrl);if(!h)throw Error(`You are not signed in to ${o.serverUrl}, so the feedback was not sent. Run \`phoenix login <workspace>\` first, then send it again.`);let{error:d}=await a(o.serverUrl).POST("/feedback",{body:{message:s,type:o.type,clientVersion:o.sdkVersion,clientInfo:o.clientInfo,...c?{contact:c}:{},...i?{agent:i}:{},...o.project?{project:o.project}:{}},headers:{authorization:`Bearer ${h.token}`}});if(d)throw Error(`The server did not accept the feedback: ${d.message}`);n.success(`Feedback sent to the Phoenix team from workspace ${h.customerName}. Thank you.`)};

package/dist/phoenix/commands/finish-deployment-command.d.ts

@@ -0,0 +1,13 @@
+import type { CommandContext } from './types.js';
+export interface DeploymentFinishCommandProps {
+    readonly uuid: string;
+    readonly uploadLinksFile: string;
+    readonly apiKey: string;
+    readonly projectKey: string;
+    readonly projectSlug: string;
+    readonly lambdaUrl: string;
+    readonly serverUrl: string;
+    readonly debug: boolean;
+    readonly skipUpload?: boolean;
+}
+export declare const runFinishDeploymentCommand: (props: DeploymentFinishCommandProps, context: CommandContext) => Promise<void>;

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

@@ -0,0 +1 @@
+import{createApiBaseClient as e}from"#package/client";import{readUploadLinks as t,uploadFilesWithPresignedUrls as i}from"../utils/index.js";export const runFinishDeploymentCommand=async(o,s)=>{let{logger:a}=s;try{a.step("Finishing deployment");let{uuid:s,uploadLinksFile:n,apiKey:l,projectKey:r,projectSlug:p,lambdaUrl:d,serverUrl:c,skipUpload:m}=o;if(a.debug(`Using deployment ID: ${s}`),a.debug(`Upload links file: ${n}, project: ${p}, lambda: ${d}`),m)a.info("Skipping upload (skipUpload flag set)");else{let e=await t(n,{logger:a});a.info("Uploading files to S3..."),await i(e,{logger:a})}a.info("Activating deployment..."),a.debug(`Creating API client for server: ${c}`);let f=e(c),{error:y}=await f.POST("/deployments/{deploymentId}/activate",{params:{path:{deploymentId:s}},headers:{"x-api-key":l,"x-project-key":r,"x-project-slug":p},body:{lambdaUrl:d}});if(y)throw Error(`Failed to activate deployment with server: ${y.message}`);a.info("Deployment activated successfully"),a.success("Deployment finished successfully!")}catch(e){a.error(`Deployment finish failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};

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

@@ -0,0 +1,6 @@
+import type { CommandContext } from './types.js';
+export interface FixCommandProps {
+    readonly lint?: boolean;
+    readonly format?: boolean;
+}
+export declare const runFixCommand: (props: FixCommandProps, context: CommandContext) => Promise<void>;

package/dist/phoenix/commands/fix.js

@@ -0,0 +1 @@
+import{runCommand as t}from"../utils/index.js";import{formatFiles as e}from"./prettier.js";export const runFixCommand=async(i,r)=>{let{logger:s}=r,o=!0===i.lint||!0===i.format,n=!o||!0===i.lint,c=!o||!0===i.format;try{s.step("Running fixes"),n&&await t({command:"eslint",args:["src","--fix"],description:"ESLint fix",quiet:!0},{logger:s}),c&&(s.step("Prettier fix"),await e(".",{logger:s}),s.success("Prettier fix completed")),s.success("Fixes completed!")}catch(t){s.error(`Fix failed: ${t instanceof Error?t.message:String(t)}`,t),process.exit(1)}};

package/dist/phoenix/commands/generate-project-files.d.ts

@@ -0,0 +1,6 @@
+import { generateProjectFiles } from '../application-spec/index.js';
+import type { CommandContext } from './types.js';
+export declare const generateProjectFilesAndInstallDependencies: (props: Parameters<typeof generateProjectFiles>[0], context: CommandContext) => Promise<{
+    templateFiles: readonly string[];
+    applicationSpec: import("../../application-spec/index.js").ApplicationSpec;
+}>;

package/dist/phoenix/commands/generate-project-files.js

@@ -0,0 +1 @@
+import{readFile as a}from"fs/promises";import{generateProjectFiles as e}from"../application-spec/index.js";import{runCommand as t}from"../utils/index.js";export const generateProjectFilesAndInstallDependencies=async(i,n)=>{let s=await a("package.json","utf-8"),o=await e(i,n);return s!==await a("package.json","utf-8")&&await t({command:"pnpm",args:["install"],description:"Reinstalling packages",quiet:!0},n),o};

package/dist/phoenix/commands/generated-env-markers.d.ts

@@ -0,0 +1,7 @@
+export interface GeneratedEnvMarkers {
+    readonly DEPLOYMENT_ID?: string;
+    readonly PHOENIX_PROJECT_SLUG?: string;
+    readonly PHOENIX_ENVIRONMENT_SLUG?: string;
+    readonly PHOENIX_SERVER_URL?: string;
+}
+export declare const readGeneratedEnvMarkers: (outFile: string) => Promise<GeneratedEnvMarkers | null>;

package/dist/phoenix/commands/generated-env-markers.js

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

package/dist/phoenix/commands/gltf-inspector.d.ts

@@ -0,0 +1,38 @@
+export interface GltfBoundingBox {
+    readonly min: readonly [number, number, number];
+    readonly max: readonly [number, number, number];
+    readonly dimensions: readonly [number, number, number];
+    readonly originOffset: readonly [number, number, number];
+}
+export interface GltfNodeInfo {
+    readonly name: string;
+    readonly type: 'Mesh' | 'MeshGroup' | 'Object3D' | 'Light' | 'Camera' | 'Empty';
+    readonly children: readonly string[];
+    readonly translation: readonly [number, number, number];
+    readonly rotation: readonly [number, number, number, number];
+    readonly scale: readonly [number, number, number];
+    readonly morphTargets: readonly string[];
+    readonly boundingBox: GltfBoundingBox | null;
+}
+export interface GltfMaterialInfo {
+    readonly name: string;
+}
+export interface GltfAnimationInfo {
+    readonly name: string;
+    readonly duration: number;
+    readonly channelCount: number;
+}
+export interface GltfInspectResult {
+    readonly filePath: string;
+    readonly fileSize: number;
+    readonly format: 'glTF' | 'GLB';
+    readonly version: string;
+    readonly generator: string;
+    readonly extensions: readonly string[];
+    readonly nodes: readonly GltfNodeInfo[];
+    readonly materials: readonly GltfMaterialInfo[];
+    readonly animations: readonly GltfAnimationInfo[];
+    readonly morphTargets: ReadonlyMap<string, readonly string[]>;
+    readonly dracoCompressed: boolean;
+}
+export declare const inspectGltfFile: (filePath: string) => Promise<GltfInspectResult>;

package/dist/phoenix/commands/gltf-inspector.js

@@ -0,0 +1 @@
+import{NodeIO as e}from"@gltf-transform/core";import{statSync as t}from"fs";import{extname as n}from"path";let a=(e,t)=>e.length<3||t.length<3?null:{min:[e[0],e[1],e[2]],max:[t[0],t[1],t[2]],dimensions:[t[0]-e[0],t[1]-e[1],t[2]-e[2]],originOffset:[(e[0]+t[0])/2,(e[1]+t[1])/2,(e[2]+t[2])/2]},r=(e,t)=>e.reduce((e,n)=>null===e?n:[Math[t](e[0],n[0]),Math[t](e[1],n[1]),Math[t](e[2],n[2])],null),l=e=>e&&Array.isArray(e.targetNames)?e.targetNames:[];export const inspectGltfFile=async s=>{let i=t(s).size,m=".glb"===n(s).toLowerCase()?"GLB":"glTF",o=new e,g=await o.readAsJSON(s),h=g.json.extensionsUsed??[];if(h.includes("KHR_draco_mesh_compression"))return((e,t,n,s)=>{let i=e.json,m=i.nodes??[],o=i.meshes??[],g=i.materials??[],h=i.animations??[],d=i.accessors??[],u=new Map;m.forEach((e,t)=>{e.children&&e.children.length>0&&u.set(t,e.children)});let p=m.map(e=>{let t="Empty";void 0!==e.mesh?t="Mesh":void 0!==e.camera?t="Camera":e.extensions?.KHR_lights_punctual&&(t="Light");let n=e.children??[],s=n.map(e=>m[e]?.name??"(unnamed)"),i=void 0!==e.mesh?o[e.mesh]:void 0,g=l(i?.extras);i?.primitives&&i.primitives.length>1?t="MeshGroup":"Empty"===t&&s.length>0&&(t="Object3D");let h=null,u=[i,...n.map(e=>m[e]?.mesh!==void 0?o[m[e].mesh]:void 0)].flatMap(e=>e?.primitives?.map(e=>e.attributes?.POSITION!==void 0?d[e.attributes.POSITION]:void 0)?.filter(e=>void 0!==e)??[]);if(u.length>0){let e=u.map(e=>e.min).filter(e=>void 0!==e&&e.length>=3),t=u.map(e=>e.max).filter(e=>void 0!==e&&e.length>=3),n=r(e,"min"),l=r(t,"max");null!==n&&null!==l&&(h=a(n,l))}return{name:e.name??"(unnamed)",type:t,children:s,translation:e.translation??[0,0,0],rotation:e.rotation??[0,0,0,1],scale:e.scale??[1,1,1],morphTargets:g,boundingBox:h}}),f=g.map(e=>({name:e.name??"(unnamed)"})),c=h.map(e=>{let t=0;for(let n of e.samplers??[])if(void 0!==n.input){let e=d[n.input];if(e?.max&&e.max.length>0){let n=e.max[0];n>t&&(t=n)}}return{name:e.name??"(unnamed)",duration:Math.round(1e3*t)/1e3,channelCount:e.channels?.length??0}}),v=new Map;for(let e of o){let t=e.name??"(unnamed)",n=e.extras;n&&Array.isArray(n.targetNames)&&n.targetNames.length>0&&v.set(t,n.targetNames)}let M=i.extensionsUsed??[],N=M.includes("KHR_draco_mesh_compression");return{filePath:t,fileSize:n,format:s,version:i.asset?.version??"2.0",generator:i.asset?.generator??"(unknown)",extensions:M,nodes:p,materials:f,animations:c,morphTargets:v,dracoCompressed:N}})(g,s,i,m);let d=(await o.readJSON(g)).getRoot(),u=d.listNodes().map(e=>{let t,n=e.getMesh(),s=l(n?.getExtras()),i=null,m=[n,...e.listChildren().map(e=>e.getMesh())].flatMap(e=>e?.listPrimitives()?.map(e=>e.getAttribute("POSITION"))?.filter(e=>null!==e)??[]);if(m.length>0){let e=m.map(e=>e.getMinNormalized([])).filter(e=>e.length>=3),t=m.map(e=>e.getMaxNormalized([])).filter(e=>e.length>=3),n=r(e,"min"),l=r(t,"max");null!==n&&null!==l&&(i=a(n,l))}return{name:e.getName()??"(unnamed)",type:(t=e.getMesh())?t.listPrimitives().length>1?"MeshGroup":"Mesh":e.getCamera()?"Camera":e.getExtension("KHR_lights_punctual")?"Light":e.listChildren().length>0?"Object3D":"Empty",children:e.listChildren().map(e=>e.getName()??"(unnamed)"),translation:e.getTranslation(),rotation:e.getRotation(),scale:e.getScale(),morphTargets:s,boundingBox:i}}),p=d.listMaterials().map(e=>({name:e.getName()??"(unnamed)"})),f=d.listAnimations().map(e=>({name:e.getName()??"(unnamed)",duration:(e=>{let t=0;for(let n of e.listSamplers()){let e=n.getInput();if(e){let n=e.getArray();if(n&&n.length>0){let e=n[n.length-1];e>t&&(t=e)}}}return Math.round(1e3*t)/1e3})(e),channelCount:e.listChannels().length})),c=new Map;for(let e of d.listMeshes()){let t=e.getName()??"(unnamed)",n=e.getExtras();n&&Array.isArray(n.targetNames)&&n.targetNames.length>0&&c.set(t,n.targetNames)}return{filePath:s,fileSize:i,format:m,version:g.json.asset?.version??"2.0",generator:g.json.asset?.generator??"(unknown)",extensions:h,nodes:u,materials:p,animations:f,morphTargets:c,dracoCompressed:!1}};

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

@@ -0,0 +1,37 @@
+export type { CommandContext } from './types.js';
+export { runBuildCommand } from './build.js';
+export { runCheckCommand } from './check.js';
+export { runCleanCommand } from './clean.js';
+export { runActivateDeploymentCommand } from './activate-deployment.js';
+export { runCreateEnvironmentCommand } from './create-environment.js';
+export { runCleanupEnvironmentCommand } from './cleanup-environment.js';
+export { runListEnvironmentsCommand } from './list-environments.js';
+export { runRegisterDeploymentCommand } from './register-deployment.js';
+export { runPrepareDeploymentCommand } from './prepare-deployment-command.js';
+export { prepareDevelopmentEnvironment } from '../services/prepare-development-environment.js';
+export { prepareLocalEnvironment } from './prepare-local-environment-command.js';
+export { runFinishDeploymentCommand } from './finish-deployment-command.js';
+export { runDeploymentBuildEnvsCommand } from './deployment-build-envs-command.js';
+export { runDevCommand } from './dev.js';
+export { runFixCommand } from './fix.js';
+export { runLinkCommand } from './link.js';
+export { runUnlinkCommand } from './unlink.js';
+export { runPrepareCiCommand } from './prepare-ci.js';
+export { runStoryCommand } from './story.js';
+export { runStoryBuildCommand } from './story-build.js';
+export { runStoryCreateCommand } from './story-create.js';
+export { runStoryDevCommand } from './story-dev.js';
+export { runInitCommand } from './init.js';
+export { runSyncCommand } from './sync.js';
+export { runChangelogCommand } from './changelog.js';
+export { runDocsCommand } from './docs.js';
+export { runInspectAssetsCommand } from './inspect-assets.js';
+export { runScreenshotCommand } from './screenshot.js';
+export { runStateCommand } from './state.js';
+export { runDataCommand } from './data.js';
+export { runSceneCommand } from './scene.js';
+export { runLoginCommand } from './login.js';
+export { runLogoutCommand } from './logout.js';
+export { runDeployCommand } from './deploy.js';
+export { runFeedbackCommand } from './feedback.js';
+export { runExtractSourcesCommand } from './extract-sources-command.js';

package/dist/phoenix/commands/index.js

@@ -0,0 +1 @@
+export{runBuildCommand}from"./build.js";export{runCheckCommand}from"./check.js";export{runCleanCommand}from"./clean.js";export{runActivateDeploymentCommand}from"./activate-deployment.js";export{runCreateEnvironmentCommand}from"./create-environment.js";export{runCleanupEnvironmentCommand}from"./cleanup-environment.js";export{runListEnvironmentsCommand}from"./list-environments.js";export{runRegisterDeploymentCommand}from"./register-deployment.js";export{runPrepareDeploymentCommand}from"./prepare-deployment-command.js";export{prepareDevelopmentEnvironment}from"../services/prepare-development-environment.js";export{prepareLocalEnvironment}from"./prepare-local-environment-command.js";export{runFinishDeploymentCommand}from"./finish-deployment-command.js";export{runDeploymentBuildEnvsCommand}from"./deployment-build-envs-command.js";export{runDevCommand}from"./dev.js";export{runFixCommand}from"./fix.js";export{runLinkCommand}from"./link.js";export{runUnlinkCommand}from"./unlink.js";export{runPrepareCiCommand}from"./prepare-ci.js";export{runStoryCommand}from"./story.js";export{runStoryBuildCommand}from"./story-build.js";export{runStoryCreateCommand}from"./story-create.js";export{runStoryDevCommand}from"./story-dev.js";export{runInitCommand}from"./init.js";export{runSyncCommand}from"./sync.js";export{runChangelogCommand}from"./changelog.js";export{runDocsCommand}from"./docs.js";export{runInspectAssetsCommand}from"./inspect-assets.js";export{runScreenshotCommand}from"./screenshot.js";export{runStateCommand}from"./state.js";export{runDataCommand}from"./data.js";export{runSceneCommand}from"./scene.js";export{runLoginCommand}from"./login.js";export{runLogoutCommand}from"./logout.js";export{runDeployCommand}from"./deploy.js";export{runFeedbackCommand}from"./feedback.js";export{runExtractSourcesCommand}from"./extract-sources-command.js";

package/dist/phoenix/commands/init-starter-spec.d.ts

@@ -0,0 +1,5 @@
+/** Project-relative path and content of each starter spec file. */
+export declare const starterSpecFiles: readonly {
+    readonly path: string;
+    readonly content: string;
+}[];

package/dist/phoenix/commands/init-starter-spec.js

@@ -0,0 +1,139 @@
+import{DEFAULT_PROJECT_ALIAS as e}from"@salsita-ai/contracts/domain";let t=`project: ${e}
+applicationVersion: 1.0.0
+pageTitle: Phoenix Configurator
+`,i=`model:
+  latest:
+    entityTypes:
+      - Box
+    aliases:
+      RootEntity:
+        - Box
+    shapes:
+      Box:
+        width:
+          type: number
+        height:
+          type: number
+        depth:
+          type: number
+        color:
+          type: string
+
+presets:
+  - name: Box
+    description: Resizable starter box
+    rootEntityType: Box
+    initialDomainEntities:
+      - id: Box-1
+        type: Box
+        width: 1800
+        height: 1200
+        depth: 1000
+        color: '#3f7cac'
+
+components:
+  Box:
+    applicationConfig:
+      main:
+        layout: universal
+        miniSidebar: true
+        distanceDataUnit: mm
+
+    fitRootPerspectiveCamera:
+      main:
+        priority: 1
+        fov: 40
+        near: 1
+        far: 10000
+        minDistance: 500
+        maxDistance: 5000
+        distance: 2500
+        azimuthAngle: 0.7
+        polarAngle: 1.1
+        fitToBox: true
+        fitMeshChanges: true
+        animateOnLoad: false
+
+    sceneEntityAmbientLight:
+      fill:
+        color: '#ffffff'
+        intensity: 1.5
+
+    sceneEntityDirectionalLight:
+      key:
+        offsetX: 250
+        offsetY: 300
+        offsetZ: 200
+        color: '#ffffff'
+        intensity: 2
+
+    propertyPage:
+      main:
+        children:
+          - kind: propertyContainerGroup
+            props:
+              spacing: medium
+            children:
+              - kind: propertyContainerItem
+                props:
+                  title: Width
+                children:
+                  - kind: distanceDimensionInput
+                    props:
+                      instanceName: width
+              - kind: propertyContainerItem
+                props:
+                  title: Color
+                children:
+                  - kind: colorPickerInput
+                    props:
+                      instanceName: color
+
+    distanceDimension:
+      width:
+        min: 400
+        max: 3000
+        displayUnit: cm
+        value:
+          $bind: width
+
+    colorValue:
+      color:
+        value:
+          $bind: color
+
+    size:
+      box:
+        sizeX:
+          $bind: width
+        sizeY:
+          $bind: height
+        sizeZ:
+          $bind: depth
+
+    sceneEntityBoxObject:
+      box:
+        width:
+          $read: width
+        height:
+          $read: height
+        depth:
+          $read: depth
+
+    sceneEntityLocalMaterialOverride:
+      surface:
+        materialsToOverride:
+          - BoxMaterial
+        color:
+          $read: color
+        roughness: 0.8
+
+    detail:
+      main:
+        title: Starter box
+        subtitle: Edit spec/configurator.yaml to build your configurator
+        description: Resize and recolor the box, then replace it with your own product model.
+
+    selectable:
+      main: {}
+`;export const starterSpecFiles=[{path:"spec/application.yaml",content:t},{path:"spec/configurator.yaml",content:i}];

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

@@ -0,0 +1,15 @@
+import type { CommandContext } from './types.js';
+export interface InitCommandProps {
+    readonly sdkVersion: string;
+    /** Directory to initialize; defaults to the working directory. */
+    readonly projectRoot?: string;
+}
+/**
+ * Starts a Phoenix project: writes a `package.json` that depends on this CLI's SDK version when the folder has none,
+ * and the starter spec, and switches the project to the application-spec pipeline. It touches no server and asks
+ * nothing: the starter spec names the default project of whichever workspace the developer signs in to, and
+ * everything else is generated by sync or the build.
+ *
+ * Refuses when a `spec/` folder exists, and when an existing `package.json` does not depend on the SDK.
+ */
+export declare const runInitCommand: (props: InitCommandProps, { logger }: CommandContext) => Promise<void>;

package/dist/phoenix/commands/init.js

@@ -0,0 +1 @@
+import{existsSync as e}from"fs";import{mkdir as n,readFile as t,writeFile as i}from"fs/promises";import{basename as o,dirname as r,join as p}from"path";import{starterSpecFiles as a}from"./init-starter-spec.js";let s="@salsita-ai/sdk",c=async e=>{let n=`Install the SDK first (\`pnpm add ${s}\`), then rerun \`pnpm phoenix init\`.`,i=JSON.parse(await t(e,"utf-8"));if("object"!=typeof i||null===i||Array.isArray(i))throw Error(`phoenix init could not read package.json because it is not a JSON object. ${n}`);if(!["dependencies","devDependencies"].some(e=>{let n=Reflect.get(i,e);return"object"==typeof n&&null!==n&&s in n}))throw Error(`phoenix init found no ${s} dependency in package.json. ${n}`);return{...i}},l=async e=>{for(let t of a){let o=p(e,t.path);await n(r(o),{recursive:!0}),await i(o,t.content)}},d=async(e,n)=>{let t=n.phoenix;await i(e,JSON.stringify({...n,phoenix:{..."object"==typeof t&&null!==t?t:{},applicationFlow:!0}},null,2)+"\n")};export const runInitCommand=async(t,{logger:i})=>{var r,a;let f,h=t.projectRoot??process.cwd(),m=p(h,"package.json");if(e(p(h,"spec")))throw Error("phoenix init found an existing spec/ folder. init only starts new projects, and writing a starter spec would overwrite or mix with the existing one. To update an existing project, run `pnpm phoenix sync`; to start over, run init in an empty project folder.");let u=e(m)?await c(m):(r=h,a=t.sdkVersion,{name:(f=o(r).toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/^[._-]+|[-]+$/g,"")).length>0?f:"phoenix-configurator",private:!0,type:"module",dependencies:{[s]:a},devDependencies:{"@lingui/cli":"5.9.5","@lingui/swc-plugin":"5.11.0"}});i.step(`Writing the starter project to ${h}`),await n(h,{recursive:!0}),await l(h),await d(m,u),i.success(`Phoenix project created in ${h}.`),i.info("\nNext steps, in the project folder:\n  pnpm install\n  pnpm phoenix sync\n  pnpm phoenix login <workspace>\n  pnpm phoenix dev\n  pnpm phoenix deploy\n\nDeveloping against a Studio development environment instead? Paste its .env block into .env before phoenix dev.")};

package/dist/phoenix/commands/inspect-assets.d.ts

@@ -0,0 +1,20 @@
+import type { GltfAnimationInfo, GltfInspectResult, GltfNodeInfo } from './gltf-inspector.js';
+import type { CommandContext } from './types.js';
+export interface InspectAssetsCommandProps {
+    readonly file?: string;
+    readonly objects?: boolean;
+    readonly materials?: boolean;
+    readonly morphs?: boolean;
+    readonly animations?: boolean;
+    readonly json?: boolean;
+}
+export declare const formatSummary: (result: GltfInspectResult) => string;
+export declare const formatNodes: (nodes: readonly GltfNodeInfo[]) => string;
+export declare const formatMaterials: (materials: ReadonlyArray<{
+    readonly name: string;
+}>) => string;
+export declare const formatMorphTargets: (morphTargets: ReadonlyMap<string, readonly string[]>) => string;
+export declare const formatAnimations: (animations: readonly GltfAnimationInfo[]) => string;
+export declare const formatFullReport: (result: GltfInspectResult) => string;
+export declare const formatSummaryTable: (results: readonly GltfInspectResult[]) => string;
+export declare const runInspectAssetsCommand: (props: InspectAssetsCommandProps, context: CommandContext) => Promise<void>;

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

@@ -0,0 +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)}};

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

@@ -0,0 +1,5 @@
+import type { CommandContext } from './types.js';
+export interface LinkCommandProps {
+    readonly sdkPath?: string;
+}
+export declare const runLinkCommand: (props: LinkCommandProps, context: CommandContext) => Promise<void>;

package/dist/phoenix/commands/link.js

@@ -0,0 +1 @@
+import{relative as e,resolve as t}from"path";import{addWorkspaceOverrides as a,getSdkPackages as i,getWorkspaceDir as n,runCommand as o}from"../utils/index.js";export const runLinkCommand=async(s,r)=>{let{logger:c}=r,l=s.sdkPath??"../configurator-phoenix";try{c.step("Linking local SDK packages");let s=t(l);c.debug(`SDK path: ${s}`);let r=i(s);c.debug(`Found ${r.length} packages to link`);let p=n(),g={};r.forEach(({name:t,path:a})=>{let i=e(p,a);g[t]=`file:${i}`,c.debug(`  ${t} -> ${i}`)}),a(g),c.success(`Linked ${r.length} SDK packages`),await o({command:"pnpm",args:["install","--config.optimistic-repeat-install=false"],description:"Installing packages",quiet:!0},{logger:c}),c.info("\nNext step:"),c.info("  Run: phoenix dev")}catch(e){throw c.error(`Failed to link SDK packages: ${e instanceof Error?e.message:String(e)}. The SDK path must contain a packages/libs directory. Use --sdk-path flag to specify correct SDK location.`,e),e}};

package/dist/phoenix/commands/list-environments.d.ts

@@ -0,0 +1,8 @@
+import type { CommandContext } from './types.js';
+export interface EnvironmentListCommandProps {
+    readonly server?: string;
+    readonly apiKey?: string;
+    readonly debug?: boolean;
+}
+/** @deprecated Switch to a new workflow and use the prepare environment flow instead */
+export declare const runListEnvironmentsCommand: (props: EnvironmentListCommandProps | undefined, context: CommandContext) => Promise<void>;

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

@@ -0,0 +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)}};

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

@@ -0,0 +1,23 @@
+import type { CommandContext } from './types.js';
+export interface LoginCommandProps {
+    readonly customer: string;
+    readonly serverUrl: string;
+    readonly studioUrl: string;
+    readonly open: boolean;
+}
+interface LoginCallbackListener {
+    readonly port: number;
+    readonly code: Promise<string>;
+    readonly close: () => void;
+}
+/**
+ * Receives the one-time code from Studio on 127.0.0.1. Only a callback carrying this session's state is accepted,
+ * so another page cannot feed the CLI a code of its own.
+ */
+export declare const startLoginCallbackListener: (state: string) => Promise<LoginCallbackListener>;
+/**
+ * Signs the CLI in to an SDK-builder workspace: the user approves in Studio, Studio returns a one-time code to this
+ * CLI's loopback listener, and the CLI exchanges it with its PKCE verifier for an API token.
+ */
+export declare const runLoginCommand: (props: LoginCommandProps, { logger }: CommandContext) => Promise<void>;
+export {};

package/dist/phoenix/commands/login.js

@@ -0,0 +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 i}from"#package/client";import{getServerCredentials as s,saveServerCredentials as a}from"../services/index.js";let l=(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}</p></main></body></html>`;export const startLoginCallbackListener=async e=>{let t=null,r=new Promise((e,r)=>{t={resolve:e,reject:r}}),n=o((r,o)=>{let n=new URL(r.url??"/","http://127.0.0.1"),i=n.searchParams.get("code");if("/callback"!==n.pathname)return void o.writeHead(404).end();if(n.searchParams.get("state")!==e||!i){o.writeHead(400,{"content-type":"text/html"}),o.end(l("Sign-in failed","This response does not belong to the waiting CLI. Run phoenix login again.")),t?.reject(Error("The sign-in response did not match this CLI session. Run `phoenix login` again."));return}o.writeHead(200,{"content-type":"text/html"}),o.end(l("Phoenix CLI signed in","You can close this tab and return to the terminal.")),t?.resolve(i)}),i=await new Promise((e,t)=>{n.once("error",t),n.listen(0,"127.0.0.1",()=>{let r=n.address();null===r||"string"==typeof r?t(Error("The login callback listener did not get a port. Run `phoenix login` again.")):e(r.port)})}),s=setTimeout(()=>{t?.reject(Error("Nobody approved the sign-in within 5 minutes. Run `phoenix login` again."))},3e5);return{port:i,code:r,close:()=>{clearTimeout(s),n.close()}}};let c=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)}};export const runLoginCommand=async(o,{logger:l})=>{let d=r(32).toString("base64url"),h=t("sha256").update(d).digest("base64url"),m=r(16).toString("base64url"),u=await startLoginCallbackListener(m);try{let t=new URL("/builder/cli-login",o.studioUrl);t.searchParams.set("customer",o.customer),t.searchParams.set("port",String(u.port)),t.searchParams.set("state",m),t.searchParams.set("challenge",h),l.step(`Signing in to workspace "${o.customer}" on ${o.serverUrl}`),l.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 u.code,{data:p,error:g}=await i(o.serverUrl).POST("/auth/token",{body:{code:r,codeVerifier:d,port:u.port,name:`phoenix CLI on ${n()}`}});if(g||!p)throw Error(`The server did not accept the sign-in: ${g?.message??"no response"}`);if(p.customer.slug!==o.customer)throw await c(o.serverUrl,p.token),Error(`The sign-in was approved in workspace "${p.customer.slug}", not "${o.customer}". Check --region or --studioUrl and run \`phoenix login ${o.customer}\` again.`);let w=await s(o.serverUrl),y=await a(o.serverUrl,{token:p.token,userId:p.userId,customerSlug:p.customer.slug,customerName:p.customer.name,createdAt:new Date().toISOString()}),f=w?await c(o.serverUrl,w.token):null;f&&l.warn(`The server did not revoke the token this sign-in replaces (${f}). It stays valid on the server. Contact Phoenix support to revoke it.`),l.success(`Signed in to ${p.customer.name}. The token is stored in ${y}; revoke it with phoenix logout.`)}finally{u.close()}};

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

@@ -0,0 +1,9 @@
+import type { CommandContext } from './types.js';
+export interface LogoutCommandProps {
+    readonly serverUrl: string;
+}
+/**
+ * Revokes this CLI's token on the server and forgets it locally. The local copy is removed even when the server
+ * cannot be reached; the token then stays valid on the server, and the user is told so.
+ */
+export declare const runLogoutCommand: (props: LogoutCommandProps, { logger }: CommandContext) => Promise<void>;

package/dist/phoenix/commands/logout.js

@@ -0,0 +1 @@
+import{createApiBaseClient as e}from"#package/client";import{getServerCredentials as r,removeServerCredentials as t}from"../services/index.js";let o=async(r,t)=>{try{let{error:o,response:n}=await e(r).DELETE("/auth/token",{headers:{authorization:`Bearer ${t}`,"content-type":null}});return o&&401!==n.status?o.message:null}catch(e){return e instanceof Error?e.message:String(e)}};export const runLogoutCommand=async(e,{logger:n})=>{let s=await r(e.serverUrl);if(!s)return void n.info(`Not signed in to ${e.serverUrl}.`);let a=await o(e.serverUrl,s.token);(await t(e.serverUrl),a)?n.warn(`Signed out locally, but the server did not revoke the token (${a}). It is removed from this computer but stays valid on the server. Contact Phoenix support to revoke it.`):n.success(`Signed out of ${s.customerName} on ${e.serverUrl}.`)};

package/dist/phoenix/commands/prepare-ci.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from './types.js';
+export declare const runPrepareCiCommand: (context: CommandContext) => Promise<void>;

package/dist/phoenix/commands/prepare-ci.js

@@ -0,0 +1 @@
+import{copyFile as e}from"fs/promises";import{resolve as r}from"path";export const runPrepareCiCommand=async o=>{let{logger:n}=o;try{n.step("\uD83D\uDD27 Preparing CI environment");let o=r(process.cwd(),".env.ci"),s=r(process.cwd(),".env");await e(o,s),n.fileCreated(".env"),n.success("CI environment prepared successfully")}catch(e){throw console.error("❌ Failed to prepare CI environment:",e),e}};

package/dist/phoenix/commands/prepare-deployment-command.d.ts

@@ -0,0 +1,17 @@
+import type { CommandContext } from './types.js';
+export interface DeploymentPrepareCommandProps {
+    readonly apiKey: string;
+    readonly projectKey: string;
+    readonly projectSlug: string;
+    readonly projectRef?: string;
+    readonly projectSha?: string;
+    readonly environmentSlug: string;
+    readonly outFile: string;
+    readonly skipUpload: boolean;
+    readonly overrideSchema: boolean;
+    readonly uploadLinksFile: string;
+    readonly serverUrl: string;
+    readonly debug: boolean;
+    readonly projectVersion: string;
+}
+export declare const runPrepareDeploymentCommand: (props: DeploymentPrepareCommandProps, context: CommandContext) => Promise<void>;