@salsita-ai/sdk 0.50.0-develop.eb204e0da4 → 0.50.0-develop.ef06ca4ac1

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

@@ -8,5 +8,10 @@ export interface BuildCommandProps {
     readonly enableEditor?: boolean;
     readonly buildTarget?: BundleBuildTarget;
     readonly force?: boolean;
+    /**
+     * Text for the banner comment of every frontend JavaScript file; it is public in the bundles. Without it the
+     * comment names the application version and, in a git checkout, the commit.
+     */
+    readonly banner?: string;
 }
 export declare const runBuildCommand: (props: BuildCommandProps, context: CommandContext) => Promise<void>;

package/dist/phoenix/commands/build.js

@@ -1 +1 @@
-import{rm as e}from"fs/promises";import{build as o}from"vite";import{getViteBuildConfigs as i}from"../services/index.js";import{checkBundleSizeBudgets as t}from"../utils/index.js";import{buildWebhooks as r}from"../webhooks/index.js";import{generateProjectFilesAndInstallDependencies as s}from"./generate-project-files.js";export const runBuildCommand=async(n,c)=>{let{logger:d}=c,{sdkVersion:l,projectSlug:u,environmentSlug:a,cliUseWorkspace:p,enableEditor:b,buildTarget:f="both",force:m=!1}=n;try{process.env.NODE_ENV="production",d.step("Building Phoenix project");let{templateFiles:n,applicationSpec:h}=await s({sdkVersion:l,projectSlug:u,environmentSlug:a,cliUseWorkspace:p,enableEditor:b,inlineTemplates:!0,force:m},c);if(d.success("Project files built successfully"),"frontend"===f||"both"===f){d.step("Cleaning frontend build directory");try{await e("./.phoenix/dist/frontend",{recursive:!0,force:!0}),d.debug("Frontend build directory cleaned")}catch(e){d.debug("No frontend build directory to clean")}for(let e of(d.step("Building Vite bundle"),await i({enableEditor:b,templateFiles:n})))await o(e);d.success("Vite build completed")}("webhook"===f||"both"===f)&&(d.step("Building webhooks"),await r({experimental:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js"}),d.success("Webhooks build completed")),void 0!==h&&await t({budgets:h.budgets,buildTarget:f},c),d.success("Build completed successfully!")}catch(e){d.error(`Build failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{rm as e}from"fs/promises";import{build as o}from"vite";import{generateProjectFiles as i}from"../application-spec/index.js";import{composeDefaultBanner as t,getViteBuildConfigs as r}from"../services/index.js";import{checkBundleSizeBudgets as s,readGitCommit as n}from"../utils/index.js";import{buildWebhooks as c}from"../webhooks/index.js";export const runBuildCommand=async(d,a)=>{let{logger:l}=a,{sdkVersion:p,projectSlug:u,environmentSlug:m,cliUseWorkspace:b,enableEditor:f,buildTarget:h="both",force:w=!1,banner:g}=d;try{process.env.NODE_ENV="production",l.step("Building Phoenix project");let{templateFiles:d,applicationSpec:x}=await i({sdkVersion:p,projectSlug:u,environmentSlug:m,cliUseWorkspace:b,enableEditor:f,inlineTemplates:!0,force:w},a);if(l.success("Project files built successfully"),"frontend"===h||"both"===h){l.step("Cleaning frontend build directory");try{await e("./.phoenix/dist/frontend",{recursive:!0,force:!0}),l.debug("Frontend build directory cleaned")}catch(e){l.debug("No frontend build directory to clean")}l.step("Building Vite bundle");let i=void 0===g?await n({directory:process.cwd(),trackedFile:"package.json"}):void 0;for(let e of(void 0===g&&void 0===i&&l.debug("No git commit found for the banner comment; it names the application version only"),await r({enableEditor:f,templateFiles:d,sdkVersion:p,banner:g??t({applicationVersion:x?.appMetadata.applicationVersion,commit:i})})))await o(e);l.success("Vite build completed")}("webhook"===h||"both"===h)&&(l.step("Building webhooks"),await c({experimental:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js"}),l.success("Webhooks build completed")),void 0!==x&&await s({budgets:x.budgets,buildTarget:h},a),l.success("Build completed successfully!")}catch(e){l.error(`Build failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};

package/dist/phoenix/commands/check.js

@@ -1 +1 @@
-import{runCommand as e}from"../utils/index.js";import{checkFiles as t}from"./prettier.js";export const runCheckCommand=async(r,c)=>{let{logger:s}=c,i=!0===r.types||!0===r.lint||!0===r.format,o=!i||!0===r.types,n=!i||!0===r.lint,a=!i||!0===r.format;try{if(s.step("Running checks"),o&&await e({command:"tsc",args:["--project","tsconfig.json","--noEmit","--checkers","1"],description:"TypeScript check",quiet:!0},{logger:s}),n&&await e({command:"eslint",args:["src"],description:"ESLint check",quiet:!0},{logger:s}),a){if(s.step("Prettier check"),!await t(".",{logger:s}))throw Error("Prettier check failed");s.success("Prettier check passed")}s.success("All checks passed!")}catch(e){s.error(`Check failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{eslintConfigArgs as e,findTypeScriptProject as t}from"../check-configs/index.js";import{runSdkTool as r}from"../utils/index.js";import{checkFiles as c}from"./prettier.js";export const runCheckCommand=async(i,s)=>{let{logger:a}=s,o=!0===i.types||!0===i.lint||!0===i.format,n=!o||!0===i.types,p=!o||!0===i.lint,m=!o||!0===i.format;try{if(a.step("Running checks"),n&&await r({tool:{packageName:"@typescript/native",binName:"tsc"},args:["--project",t(),"--noEmit","--checkers","1"],description:"TypeScript check",quiet:!0},{logger:a}),p&&await r({tool:{packageName:"eslint",binName:"eslint"},args:["src","--no-error-on-unmatched-pattern",...e()],description:"ESLint check",quiet:!0},{logger:a}),m){if(a.step("Prettier check"),!await c(".",{logger:a}))throw Error("Prettier check failed");a.success("Prettier check passed")}a.success("All checks passed!")}catch(e){a.error(`Check failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};

package/dist/phoenix/commands/clean.js

@@ -1 +1 @@
-import{rm as e}from"fs/promises";import{exists as r,runCommand as s}from"../utils/index.js";import{generateProjectFilesAndInstallDependencies as i}from"./generate-project-files.js";export const runCleanCommand=async(o,n)=>{let{logger:t}=n,{sdkVersion:a,projectSlug:c,environmentSlug:p,cliUseWorkspace:l,enableEditor:d}=o;try{for(let s of(t.step("Cleaning Phoenix project"),["node_modules",".phoenix"]))await r(s)&&(t.debug(`Removing ${s}...`),await e(s,{recursive:!0,force:!0}),t.debug(`Removed ${s}`));if(t.success("Cleanup completed"),await s({command:"pnpm",args:["install"],description:"Installing packages",quiet:!0},{logger:t}),!await r("spec"))return void t.warn("Spec folder not found. Skipping spec rebuild.");t.step("Rebuilding specs"),await i({sdkVersion:a,projectSlug:c,environmentSlug:p,cliUseWorkspace:l,enableEditor:d},n),t.success("Clean and rebuild completed successfully!")}catch(e){t.error(`Clean failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{rm as e}from"fs/promises";import{generateProjectFiles as i}from"../application-spec/index.js";import{exists as o}from"../utils/index.js";export const runCleanCommand=async(r,s)=>{let{logger:n}=s,{sdkVersion:p,projectSlug:t,environmentSlug:a,cliUseWorkspace:c,enableEditor:l}=r;try{if(n.step("Cleaning Phoenix project"),await o(".phoenix")&&(n.debug("Removing .phoenix..."),await e(".phoenix",{recursive:!0,force:!0}),n.debug("Removed .phoenix")),n.success("Cleanup completed"),!await o("spec"))return void n.warn("Spec folder not found. Skipping spec rebuild.");n.step("Rebuilding specs"),await i({sdkVersion:p,projectSlug:t,environmentSlug:a,cliUseWorkspace:c,enableEditor:l},s),n.success("Clean and rebuild completed successfully!")}catch(e){n.error(`Clean failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};

package/dist/phoenix/commands/deploy.js

@@ -1,4 +1,4 @@
-import{openAsBlob as e}from"node:fs";import{createApiBaseClient as t}from"#package/client";import{resolveApplicationSpecDeploymentData as i}from"../application-spec/index.js";import{createSourceArchive as r,getServerCredentials as a}from"../services/index.js";import{ensureWorkspaceInstallSettings as o}from"../utils/index.js";let s={queued:"Waiting for a build runner",preparing:"Preparing the deployment",building:"Building the project",deploying:"Deploying the frontend, webhooks and assets",live:"Live",failed:"Failed",cancelled:"Cancelled"},l=e=>new Promise(t=>setTimeout(t,e)),n=async(t,i)=>{let r=new FormData;for(let[e,i]of Object.entries(t.fields))r.append(e,i);r.append("file",await e(i,{type:"application/gzip"}),"sources.tgz");let a=await fetch(t.url,{method:"POST",body:r});if(!a.ok)throw Error(`Uploading the sources failed with HTTP ${a.status}: ${await a.text()}`)};export const runDeployCommand=async(e,{logger:d})=>{let u=await a(e.serverUrl),{pollIntervalMs:p}=e;if(!u)throw Error(`You are not signed in to ${e.serverUrl}. Run \`phoenix login <workspace>\` first.`);let c=t(e.serverUrl),m={authorization:`Bearer ${u.token}`};d.step("Validating the application spec");let h=await i({skipUpload:!0,logger:d});d.success(`The spec is valid (application version ${h.applicationVersion})`),d.step(`Packing the project for ${u.customerName}`),o(e.projectDir);let f=await r(e.projectDir);try{let t;d.info(`  ${f.fileCount} files, ${(t=f.size)<1048576?`${(t/1024).toFixed(1)} KB`:`${(t/1024/1024).toFixed(1)} MB`}`);let i=await c.POST("/deployments/builds",{body:{sdkVersion:e.sdkVersion,sizeBytes:f.size,configurationSchema:{version:h.schemaVersion,schema:h.schema},adminConfigurationSchema:h.adminSchema?{version:h.adminSchemaVersion,schema:h.adminSchema}:void 0},headers:m});if(i.error||!i.data)throw Error(`The server did not create a build: ${i.error?.message??"no response"}`);let{buildId:r,upload:a}=i.data;d.step("Uploading the sources"),await n(a,f.path);let o=await c.POST("/deployments/builds/{buildId}/start",{params:{path:{buildId:r}},headers:{...m,"content-type":null}});if(o.error)throw Error(`The server did not start the build: ${o.error.message}`);if(o.data?.status==="failed")throw Error(`Build ${r} could not be started: ${o.data.error??"the server gave no reason"}`);if(d.success(`Build ${r} started`),u.studioUrl){let e=new URL(`/builder/deployments/${r}`,u.studioUrl);e.searchParams.set("customer",u.customerSlug),d.info(`Follow the build in Studio: ${e.toString()}`)}if(!e.wait)return;let g=null,w=0;for(;;){let{data:e,error:t}=await c.GET("/deployments/builds/{buildId}",{params:{path:{buildId:r}},headers:m}).catch(e=>({data:void 0,error:{message:String(e)}}));if(t||!e){if((w+=1)>=5)throw Error(`Following build ${r} failed: ${t?.message??"no response"}. The build may still finish; check Deployments in Studio.`);await l(p);continue}if(w=0,e.status!==g&&(g=e.status,d.step(s[e.status])),"live"===e.status)return void d.success(`Your configurator is live at ${e.configuratorUrl}`);if("failed"===e.status||"cancelled"===e.status||e.timedOut){let t=await c.GET("/deployments/builds/{buildId}/log",{params:{path:{buildId:r}},headers:m}).catch(()=>({data:void 0})),i=(t.data?.log??"").trim().split("\n").slice(-40).join("\n");i&&d.info(`
+import{openAsBlob as e}from"node:fs";import{createApiBaseClient as t}from"#package/client";import{resolveApplicationSpecDeploymentData as i}from"../application-spec/index.js";import{createSourceArchive as o,getServerCredentials as a}from"../services/index.js";let r={queued:"Waiting for a build runner",preparing:"Preparing the deployment",building:"Building the project",deploying:"Deploying the frontend, webhooks and assets",live:"Live",failed:"Failed",cancelled:"Cancelled"},s=e=>new Promise(t=>setTimeout(t,e)),n=async(t,i)=>{let o=new FormData;for(let[e,i]of Object.entries(t.fields))o.append(e,i);o.append("file",await e(i,{type:"application/gzip"}),"sources.tgz");let a=await fetch(t.url,{method:"POST",body:o});if(!a.ok)throw Error(`Uploading the sources failed with HTTP ${a.status}: ${await a.text()}`)};export const runDeployCommand=async(e,{logger:l})=>{let d=await a(e.serverUrl),{pollIntervalMs:u}=e;if(!d)throw Error(`You are not signed in to ${e.serverUrl}. Run \`phoenix login <workspace>\` first.`);let c=t(e.serverUrl),p={authorization:`Bearer ${d.token}`};l.step("Validating the application spec");let h=await i({skipUpload:!0,logger:l});l.success(`The spec is valid (application version ${h.applicationVersion})`),l.step(`Packing the project for ${d.customerName}`);let m=await o(e.projectDir);try{let t;m.hasConversationLog?l.info("Including conversation.log in the private sources archive. It is not published with the application."):l.warn("No conversation.log found in the project root. Deploying without a conversation transcript."),l.info(`  ${m.fileCount} files, ${(t=m.size)<1048576?`${(t/1024).toFixed(1)} KB`:`${(t/1024/1024).toFixed(1)} MB`}`);let i=await c.POST("/deployments/builds",{body:{sdkVersion:e.sdkVersion,sizeBytes:m.size,configurationSchema:{version:h.schemaVersion,schema:h.schema},adminConfigurationSchema:h.adminSchema?{version:h.adminSchemaVersion,schema:h.adminSchema}:void 0},headers:p});if(i.error||!i.data)throw Error(`The server did not create a build: ${i.error?.message??"no response"}`);let{buildId:o,upload:a}=i.data;l.step("Uploading the sources"),await n(a,m.path);let f=await c.POST("/deployments/builds/{buildId}/start",{params:{path:{buildId:o}},headers:{...p,"content-type":null}});if(f.error)throw Error(`The server did not start the build: ${f.error.message}`);if(f.data?.status==="failed")throw Error(`Build ${o} could not be started: ${f.data.error??"the server gave no reason"}`);if(l.success(`Build ${o} started`),d.studioUrl){let e=new URL(`/builder/deployments/${o}`,d.studioUrl);e.searchParams.set("customer",d.customerSlug),l.info(`Follow the build in Studio: ${e.toString()}`)}if(!e.wait)return;let g=null,w=0;for(;;){let{data:e,error:t}=await c.GET("/deployments/builds/{buildId}",{params:{path:{buildId:o}},headers:p}).catch(e=>({data:void 0,error:{message:String(e)}}));if(t||!e){if((w+=1)>=5)throw Error(`Following build ${o} failed: ${t?.message??"no response"}. The build may still finish; check Deployments in Studio.`);await s(u);continue}if(w=0,e.status!==g&&(g=e.status,l.step(r[e.status])),"live"===e.status){l.success(`Your configurator is live at ${e.configuratorUrl}`),l.info("Coding agents: when the user has nothing more to build, offer the run evaluation from the phoenix-feedback skill, once per conversation.");return}if("failed"===e.status||"cancelled"===e.status||e.timedOut){let t=await c.GET("/deployments/builds/{buildId}/log",{params:{path:{buildId:o}},headers:p}).catch(()=>({data:void 0})),i=(t.data?.log??"").trim().split("\n").slice(-40).join("\n");i&&l.info(`
 Last lines of the build log:
 ${i}
-`);let a=e.timedOut?"it took too long":e.error??"see the build log";throw Error(`Build ${r} did not go live: ${a}`)}await l(p)}}finally{await f.cleanup()}};
+`);let a=e.timedOut?"it took too long":e.error??"see the build log";throw Error(`Build ${o} did not go live: ${a}`)}await s(u)}}finally{await m.cleanup()}};

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

@@ -0,0 +1,73 @@
+import type { CommandContext } from '../types.js';
+export interface DepsCommandProps {
+    /** The project folder whose `package.json` is brought in line with the SDK's peers. */
+    readonly projectRoot: string;
+}
+/** The `package.json` fields whose entries count as the project declaring a package. */
+declare const DECLARED_DEPENDENCY_FIELDS: readonly ['dependencies', 'devDependencies', 'optionalDependencies'];
+type DeclaredDependencyField = (typeof DECLARED_DEPENDENCY_FIELDS)[number];
+/**
+ * A package the project must declare next to the SDK, because the SDK lists it as a peer: the SDK's code imports it,
+ * but the project's install provides it, so the project and the SDK share one copy.
+ */
+interface RequiredPeer {
+    readonly name: string;
+    /** The range from the SDK's `peerDependencies`. A declared version must fall inside it. */
+    readonly range: string;
+    /** The exact version `phoenix deps` writes for a missing or out-of-range peer: the lowest version of `range`. */
+    readonly version: string;
+    /** Type packages are needed only to typecheck, so they go to `devDependencies`; everything else to `dependencies`. */
+    readonly field: 'dependencies' | 'devDependencies';
+}
+/**
+ * A required peer the project does not satisfy: it declares the peer nowhere (`found` is undefined), or it declares
+ * it with a specifier whose lowest version falls outside the SDK's range. A peer declared out of range in two fields
+ * is two mismatches, one per entry.
+ */
+interface PeerMismatch {
+    readonly peer: RequiredPeer;
+    readonly found: {
+        readonly field: DeclaredDependencyField;
+        readonly specifier: string;
+    } | undefined;
+}
+/** A package to add to the project's `package.json` when no dependency field declares it yet. */
+export interface MissingDependency {
+    readonly name: string;
+    readonly version: string;
+    readonly field: 'dependencies' | 'devDependencies';
+}
+type JsonObject = Readonly<Record<string, unknown>>;
+/**
+ * Lists every peer of the SDK the project's `package.json` does not satisfy, in the order of the SDK's
+ * `peerDependencies`. A peer is required unless the SDK marks it optional; `@clerk/clerk-react` is required when the
+ * project's spec sets `useClerk`. A required peer is a mismatch when no dependency field declares it, and once for each
+ * field that declares it with a specifier whose lowest version falls outside the SDK's range.
+ */
+export declare const findSdkPeerMismatches: ({ packageJson, useClerk, }: {
+    readonly packageJson: JsonObject;
+    readonly useClerk: boolean;
+}) => readonly PeerMismatch[];
+/**
+ * Returns the `package.json` with each given package added that no dependency field declares yet, at the given
+ * version in the given field, in alphabetical order among the entries already there. A field is created only when it
+ * gains an entry, and a package the project declares stays as it is, whatever its version.
+ */
+export declare const addMissingDependencies: (packageJson: JsonObject, dependencies: readonly MissingDependency[]) => JsonObject;
+/**
+ * Returns the `package.json` with every required peer of the SDK added that no dependency field declares yet, at the
+ * version `phoenix deps` writes. A peer the project declares stays as it is, even outside the SDK's range: moving it
+ * into the range is the job of `phoenix deps`.
+ */
+export declare const addMissingSdkPeers: (packageJson: JsonObject, { useClerk }: {
+    readonly useClerk: boolean;
+}) => JsonObject;
+/**
+ * Brings the project's `package.json` in line with the SDK: adds every required peer it does not declare and moves
+ * every declared peer whose version falls outside the SDK's range to the lowest version of that range, in the field
+ * that declares it. Specifiers that are not semver ranges stay as they are. The only entries it removes are the
+ * packages `@salsita-ai/sdk` replaces. It installs nothing; the next step it prints is the install of the package manager
+ * that ran it.
+ */
+export declare const runDepsCommand: (props: DepsCommandProps, { logger }: CommandContext) => Promise<void>;
+export {};

package/dist/phoenix/commands/deps/deps.js

@@ -0,0 +1,3 @@
+import{existsSync as e}from"fs";import{readFile as r,writeFile as t}from"fs/promises";import{join as a}from"path";import{lt as n,minVersion as i,satisfies as o,validRange as s}from"semver";import{RuntimeReferenceStore as d,buildPhoenixDefinitions as p,parseApplicationFiles as l}from"#package/application-spec";import{getAllPhxDefinitions as c}from"#package/domain";import{readApplicationFiles as f}from"../../application-spec/application-spec-file-reader.js";import{swcEvalExpressionParser as m,swcModuleAnalyzer as u}from"../../application-spec/swc-module-analyzer.js";import{findPackageManagerCommands as h,naturalCompare as g}from"../../utils/index.js";import{readSdkManifest as v}from"./sdk-manifest.js";let k=["@salsita-ai/platform-project-sdk","@salsita-ai/platform-common","@salsita-ai/platform-contracts","@salsita-ai/common","@salsita-ai/contracts"],j=["dependencies","devDependencies","optionalDependencies"],$=e=>"object"==typeof e&&null!==e&&!Array.isArray(e),w=async t=>{let a;if(!e(t))throw Error(`phoenix deps found no package.json at ${t}. It brings the dependencies of an existing project in line with the SDK, so run it in the project folder.`);let n=await r(t,"utf-8");try{a=JSON.parse(n)}catch(e){throw Error(`phoenix deps could not read package.json because it is not valid JSON: ${e instanceof Error?e.message:String(e)} Fix the file and run phoenix deps again.`)}if(!$(a))throw Error("phoenix deps could not read package.json because it is not a JSON object. Fix the file and run phoenix deps again.");return{content:n,packageJson:a}},x=async(e,r)=>{let t=l({rawProjectFiles:await f({projectRoot:e,envs:{}}),phxDefinitions:p(c())},{analyzer:u,evalExpressionParser:m,referenceStore:new d,logger:r});if(!t.ok)throw Error(`phoenix deps could not parse the application spec, which says through useClerk whether the project needs @clerk/clerk-react:
+${t.errors.map(e=>`  [${e.code}] ${e.message}`).join("\n")}
+Fix these errors and run phoenix deps again.`);return t.value.applicationSpec.appMetadata.useClerk},y=e=>Object.fromEntries(j.map(r=>{let t=e[r];return[r,$(t)?Object.fromEntries(Object.entries(t).filter(e=>"string"==typeof e[1])):{}]})),S=({peer:e,found:r})=>void 0===r?{kind:"add",field:e.field,name:e.name,to:e.version}:{kind:"update",field:r.field,name:e.name,from:r.specifier,to:e.version,range:e.range},b=(e,r)=>{let t=new Set(r.flatMap(e=>"remove"===e.kind?[e.name]:[])),a=new Map(r.flatMap(e=>"update"===e.kind?[[e.name,e.to]]:[])),n=r.flatMap(e=>"add"===e.kind?[e]:[]),i=Object.entries($(e)?e:{}).filter(([e])=>!t.has(e)).map(([e,r])=>[e,a.get(e)??r]);return Object.fromEntries([...n].sort((e,r)=>g(e.name,r.name)).reduce((e,r)=>{var t,a;let n;return t=r.name,a=r.to,-1===(n=e.findIndex(([e])=>g(e,t)>0))?[...e,[t,a]]:[...e.slice(0,n),[t,a],...e.slice(n)]},i))},M=(e,r)=>{let t=e=>r.filter(r=>r.field===e),a=j.filter(e=>t(e).length>0);return Object.fromEntries([...Object.entries(e).map(([e,r])=>{let n=a.find(r=>r===e);return void 0===n?[e,r]:[e,b(r,t(n))]}),...a.filter(r=>!(r in e)).map(e=>[e,b(void 0,t(e))])])},D=e=>{switch(e.kind){case"add":return`  ${e.field}: added ${e.name} ${e.to}`;case"update":var r,t;let a;return(r=e.from,t=e.to,null!==(a=i(r))&&n(t,a))?`  ${e.field}: downgraded ${e.name} ${e.from} → ${e.to}, because the SDK supports ${e.range}`:`  ${e.field}: updated ${e.name} ${e.from} → ${e.to}`;case"remove":return`  ${e.field}: removed ${e.name}, which @salsita-ai/sdk replaces`}};export const findSdkPeerMismatches=({packageJson:e,useClerk:r})=>{let t=y(e);return(e=>{let{peerDependencies:r,optionalPeers:t}=v();return Object.entries(r).filter(([r])=>"@clerk/clerk-react"===r&&e||!t.includes(r)).map(([e,r])=>((e,r)=>{let t=i(r);if(null===t)throw Error(`The SDK's peer range "${r}" for ${e} matches no version, so no version of it can be required. The SDK installation is damaged; reinstall @salsita-ai/sdk.`);return{name:e,range:r,version:t.version,field:e.startsWith("@types/")?"devDependencies":"dependencies"}})(e,r))})(r).flatMap(e=>{let r=j.flatMap(r=>{let a=t[r]?.[e.name];return void 0===a?[]:[{field:r,specifier:a}]});return 0===r.length?[{peer:e,found:void 0}]:r.filter(r=>!((e,r)=>{if(null===s(e))return!0;let t=i(e);return null!==t&&o(t,r,{includePrerelease:!0})})(r.specifier,e.range)).map(r=>({peer:e,found:r}))})};export const addMissingDependencies=(e,r)=>{let t=y(e);return M(e,r.filter(({name:e})=>j.every(r=>t[r]?.[e]===void 0)).map(({name:e,version:r,field:t})=>({kind:"add",field:t,name:e,to:r})))};export const addMissingSdkPeers=(e,{useClerk:r})=>{let t=findSdkPeerMismatches({packageJson:e,useClerk:r}).flatMap(({peer:e,found:r})=>void 0===r?[{name:e.name,version:e.version,field:e.field}]:[]);return addMissingDependencies(e,t)};export const runDepsCommand=async(e,{logger:r})=>{var n,i;let o,s,d,p,l,c=a(e.projectRoot,"package.json"),{content:f,packageJson:m}=await w(c),u=await x(e.projectRoot,r),g=(n=findSdkPeerMismatches({packageJson:m,useClerk:u}),o=y(m),s=j.flatMap(e=>k.filter(r=>o[e]?.[r]!==void 0).map(r=>({kind:"remove",field:e,name:r}))),[...n.map(S),...s]);if(0===g.length)return void r.success("package.json already declares every package the SDK needs. Nothing to change.");await t(c,(i=M(m,g),d=/^[ \t]+(?=")/m.exec(f)?.[0]??"  ",p=f.includes("\r\n")?"\r\n":"\n",l=/\r?\n$/.test(f)?p:"",JSON.stringify(i,null,d).replace(/\n/g,p)+l));let v=h(process.env.npm_config_user_agent),$=void 0===v?"install the dependencies with your package manager":v.install;r.success("Updated package.json:"),r.info(["",...g.map(D),"",`Next step: ${$}`].join("\n"))};

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

@@ -0,0 +1 @@
+export { type MissingDependency, addMissingDependencies, addMissingSdkPeers, findSdkPeerMismatches, runDepsCommand, } from './deps.js';

package/dist/phoenix/commands/deps/index.js

@@ -0,0 +1 @@
+export{addMissingDependencies,addMissingSdkPeers,findSdkPeerMismatches,runDepsCommand}from"./deps.js";

package/dist/phoenix/commands/deps/sdk-manifest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The part of the SDK's own `package.json` that says which packages a project must install next to it. The SDK's
+ * `peerDependencies` are the single source of those versions: `phoenix deps` writes them into a project.
+ */
+export interface SdkManifest {
+    /** Peer name to the semver range the SDK supports. */
+    readonly peerDependencies: Readonly<Record<string, string>>;
+    /** Peers the SDK marks optional, which a project installs only when it uses the feature behind them. */
+    readonly optionalPeers: readonly string[];
+}
+/** Reads the manifest of the SDK this CLI runs from. */
+export declare const readSdkManifest: () => SdkManifest;

package/dist/phoenix/commands/deps/sdk-manifest.js

@@ -0,0 +1 @@
+import{readFileSync as e}from"fs";import{dirname as r,join as t}from"path";import{fileURLToPath as a}from"url";import{z as o}from"zod";let s=o.object({peerDependencies:o.record(o.string(),o.string()).default({}),peerDependenciesMeta:o.record(o.string(),o.object({optional:o.boolean().optional()})).default({})}),i=t(r(a(import.meta.url)),"../../../../package.json");export const readSdkManifest=()=>{let r=s.safeParse(JSON.parse(e(i,"utf-8")));if(!r.success)throw Error(`The SDK's package.json at ${i} has no readable peerDependencies: ${r.error.message}. The SDK installation is damaged; reinstall @salsita-ai/sdk.`);let{peerDependencies:t,peerDependenciesMeta:a}=r.data;return{peerDependencies:t,optionalPeers:Object.entries(a).filter(([,e])=>!0===e.optional).map(([e])=>e)}};

package/dist/phoenix/commands/dev.js

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

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

@@ -2,7 +2,8 @@ import { type FeedbackType } from '@salsita-ai/contracts/domain';
 import type { CommandContext } from './types.js';
 export interface FeedbackCommandProps {
     readonly serverUrl: string;
-    readonly message: string;
+    readonly message: string | undefined;
+    readonly file: string | undefined;
     readonly type: FeedbackType;
     readonly contact: string | undefined;
     readonly agent: string | undefined;

package/dist/phoenix/commands/feedback.js

@@ -1 +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.`)};
+import{readFile as e}from"node:fs/promises";import{FEEDBACK_CONTACT_MAX_LENGTH as t,FEEDBACK_MESSAGE_MAX_LENGTH as a}from"@salsita-ai/contracts/domain";import{createApiBaseClient as r}from"#package/client";import{getServerCredentials as o}from"../services/index.js";let s=async t=>{if(void 0!==t.message&&void 0!==t.file)throw Error("Both a message and --file were given, so it is unclear which one to send. Pass the message as an argument or put it in the file, not both.");if(void 0!==t.file)return e(t.file,"utf8").catch(e=>{throw Error(`The feedback file ${t.file} could not be read: ${e instanceof Error?e.message:String(e)}. Check the path passed to --file and send the feedback again.`)});if(void 0===t.message)throw Error('No feedback message was given. Pass it as an argument, phoenix feedback "<message>", or in a text file with --file <path>.');return t.message};export const runFeedbackCommand=async(e,{logger:i})=>{let n=(await s(e)).trim(),c=e.contact?.trim(),h=e.agent?.trim();if(0===n.length)throw Error('The feedback message is empty. Pass what you want to tell us: phoenix feedback "<message>", or a text file with --file <path>.');if(n.length>a)throw Error(`The feedback message has ${n.length} characters, but at most ${a} are accepted. Shorten it and send it again.`);if(c&&c.length>t)throw Error(`The contact detail has ${c.length} characters, but at most ${t} are accepted. Shorten --contact and send the feedback again.`);let d=await o(e.serverUrl);if(!d)throw Error(`You are not signed in to ${e.serverUrl}, so the feedback was not sent. Run \`phoenix login <workspace>\` first, then send it again.`);let{error:f}=await r(e.serverUrl).POST("/feedback",{body:{message:n,type:e.type,clientVersion:e.sdkVersion,clientInfo:e.clientInfo,...c?{contact:c}:{},...h?{agent:h}:{},...e.project?{project:e.project}:{}},headers:{authorization:`Bearer ${d.token}`}});if(f)throw Error(`The server did not accept the feedback: ${f.message}`);i.success(`Feedback sent to the Phoenix team from workspace ${d.customerName}. Thank you.`)};

package/dist/phoenix/commands/fix.js

@@ -1 +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)}};
+import{eslintConfigArgs as e}from"../check-configs/index.js";import{runSdkTool as t}from"../utils/index.js";import{formatFiles as r}from"./prettier.js";export const runFixCommand=async(i,s)=>{let{logger:o}=s,n=!0===i.lint||!0===i.format,a=!n||!0===i.lint,c=!n||!0===i.format;try{o.step("Running fixes"),a&&await t({tool:{packageName:"eslint",binName:"eslint"},args:["src","--fix","--no-error-on-unmatched-pattern",...e()],description:"ESLint fix",quiet:!0},{logger:o}),c&&(o.step("Prettier fix"),await r(".",{logger:o}),o.success("Prettier fix completed")),o.success("Fixes completed!")}catch(e){o.error(`Fix failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};

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

@@ -12,6 +12,7 @@ export { prepareDevelopmentEnvironment } from '../services/prepare-development-e
 export { prepareLocalEnvironment } from './prepare-local-environment-command.js';
 export { runFinishDeploymentCommand } from './finish-deployment-command.js';
 export { runDeploymentBuildEnvsCommand } from './deployment-build-envs-command.js';
+export { runDepsCommand } from './deps/index.js';
 export { runDevCommand } from './dev.js';
 export { runFixCommand } from './fix.js';
 export { runLinkCommand } from './link.js';
@@ -30,6 +31,7 @@ export { runScreenshotCommand } from './screenshot.js';
 export { runStateCommand } from './state.js';
 export { runDataCommand } from './data.js';
 export { runSceneCommand } from './scene.js';
+export { runVariantsCommand } from './variants.js';
 export { runLoginCommand } from './login.js';
 export { runLogoutCommand } from './logout.js';
 export { runDeployCommand } from './deploy.js';

package/dist/phoenix/commands/index.js

@@ -1 +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";
+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{runDepsCommand}from"./deps/index.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{runVariantsCommand}from"./variants.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.d.ts

@@ -1,15 +1,27 @@
 import type { CommandContext } from './types.js';
+/**
+ * The versions of the tools the SDK runs itself and editors load from the project, taken from the SDK's own
+ * `dependencies`, so the editor and `phoenix check` use the same release.
+ */
+export interface EditorToolVersions {
+    readonly eslint: string;
+    readonly prettier: string;
+}
 export interface InitCommandProps {
     readonly sdkVersion: string;
+    readonly editorToolVersions: EditorToolVersions;
     /** 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,
- * the starter spec and the pnpm settings the first install needs, 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.
+ * 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. The project's `package.json` gains
+ * what it does not have yet: the SDK's required peers, ESLint and Prettier, and the `dev`, `build`, `deploy`, `check`
+ * and `fix` scripts. An entry the project already has stays as it is. It writes no package-manager settings or
+ * `packageManager` field: the project installs with any package manager, and its maintainer owns those settings.
+ * The next steps it prints name the package manager that ran it. 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.
  */

package/dist/phoenix/commands/init.js

@@ -1 +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{ensureWorkspaceInstallSettings as a}from"../utils/index.js";import{starterSpecFiles as s}from"./init-starter-spec.js";let c="@salsita-ai/sdk",l=async e=>{let n=`Install the SDK first (\`pnpm add ${c}\`), 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&&c in n}))throw Error(`phoenix init found no ${c} dependency in package.json. ${n}`);return{...i}},d=async e=>{for(let t of s){let o=p(e,t.path);await n(r(o),{recursive:!0}),await i(o,t.content)}},m=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,s;let f,u=t.projectRoot??process.cwd(),h=p(u,"package.json");if(e(p(u,"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 w=e(h)?await l(h):(r=u,s=t.sdkVersion,{name:(f=o(r).toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/^[._-]+|[-]+$/g,"")).length>0?f:"phoenix-configurator",private:!0,type:"module",dependencies:{[c]:s},devDependencies:{"@lingui/cli":"5.9.5","@lingui/swc-plugin":"5.11.0"}});i.step(`Writing the starter project to ${u}`),await n(u,{recursive:!0}),await d(u),await m(h,w),a(u),i.success(`Phoenix project created in ${u}.`),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.")};
+import{existsSync as e}from"fs";import{mkdir as t,readFile as i,writeFile as n}from"fs/promises";import{basename as o,dirname as r,join as a}from"path";import{findPackageManagerCommands as s}from"../utils/index.js";import{addMissingDependencies as p,addMissingSdkPeers as c}from"./deps/index.js";import{starterSpecFiles as d}from"./init-starter-spec.js";let l="@salsita-ai/sdk",h={dev:"phoenix dev",build:"phoenix build",deploy:"phoenix deploy",check:"phoenix check",fix:"phoenix fix"},f=(e,t)=>void 0===e?`\`phoenix ${t}\` through your package manager`:`\`${e.phoenix(t)}\``,u=async(e,t)=>{let n=void 0===t?`add ${l} with your package manager`:`\`${t.add(l)}\``,o=`Install the SDK first (${n}), then rerun ${f(t,"init")}.`,r=JSON.parse(await i(e,"utf-8"));if("object"!=typeof r||null===r||Array.isArray(r))throw Error(`phoenix init could not read package.json because it is not a JSON object. ${o}`);if(!["dependencies","devDependencies"].some(e=>{let t=Reflect.get(r,e);return"object"==typeof t&&null!==t&&l in t}))throw Error(`phoenix init found no ${l} dependency in package.json. ${o}`);return{...r}},m=async e=>{for(let i of d){let o=a(e,i.path);await t(r(o),{recursive:!0}),await n(o,i.content)}},x=async(e,t,i)=>{let o=t.phoenix,r=t.scripts,a="object"==typeof r&&null!==r?r:{},s=Object.fromEntries(Object.entries(h).filter(([e])=>!(e in a))),d=p(c({...t,scripts:{...a,...s}},{useClerk:!1}),Object.entries(i).map(([e,t])=>({name:e,version:t,field:"devDependencies"})));await n(e,JSON.stringify({...d,phoenix:{..."object"==typeof o&&null!==o?o:{},applicationFlow:!0}},null,2)+"\n")};export const runInitCommand=async(i,{logger:n})=>{var r,p;let c,d,h=i.projectRoot??process.cwd(),g=a(h,"package.json"),j=s(process.env.npm_config_user_agent);if(e(a(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 ${f(j,"sync")}; to start over, run init in an empty project folder.`);let y=e(g)?await u(g,j):(r=h,p=i.sdkVersion,{name:(c=o(r).toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/^[._-]+|[-]+$/g,"")).length>0?c:"phoenix-configurator",private:!0,type:"module",scripts:{},dependencies:{[l]:p}});n.step(`Writing the starter project to ${h}`),await t(h,{recursive:!0}),await m(h),await x(g,y,i.editorToolVersions),n.success(`Phoenix project created in ${h}.`),n.info(["",...(d=["sync","login <workspace>","dev","deploy"],void 0===j?["Next steps, in the project folder, through your package manager:","  install the dependencies",...d.map(e=>`  phoenix ${e}`)]:["Next steps, in the project folder:",`  ${j.install}`,...d.map(e=>`  ${j.phoenix(e)}`)]),"","Developing against a Studio development environment instead? Paste its .env block into .env before phoenix dev."].join("\n"))};

package/dist/phoenix/commands/link.js

@@ -1 +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}};
+import{relative as e,resolve as t}from"path";import{addWorkspaceOverrides as o,assertPnpmProject as r,getSdkPackages as a,getWorkspaceDir as n}from"../utils/index.js";export const runLinkCommand=async(s,i)=>{let{logger:c}=i,l=s.sdkPath??"../configurator-phoenix";try{r({projectRoot:process.cwd(),command:"link"})}catch(e){throw c.error(e instanceof Error?e.message:String(e)),e}try{c.step("Linking local SDK packages");let r=t(l);c.debug(`SDK path: ${r}`);let s=a(r);c.debug(`Found ${s.length} packages to link`);let i=n(),p={};s.forEach(({name:t,path:o})=>{let r=e(i,o);p[t]=`file:${r}`,c.debug(`  ${t} -> ${r}`)}),o(p),c.success(`Linked ${s.length} SDK packages`),c.info("\nNext steps:\n  pnpm install --config.optimistic-repeat-install=false\n  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/login.d.ts

@@ -5,19 +5,37 @@ export interface LoginCommandProps {
     readonly studioUrl: string;
     readonly open: boolean;
 }
+type LoginOutcome = {
+    readonly signedIn: true;
+} | {
+    readonly signedIn: false;
+    readonly message: string;
+};
+interface LoginCallback {
+    readonly code: string;
+    readonly tokenName: string | null;
+    readonly finish: (outcome: LoginOutcome) => Promise<void>;
+}
 interface LoginCallbackListener {
     readonly port: number;
-    readonly code: Promise<string>;
+    readonly callback: Promise<LoginCallback>;
     readonly close: () => void;
 }
+interface LoginCallbackListenerProps {
+    readonly state: string;
+    readonly studioUrl: string;
+    readonly customer: string;
+}
 /**
- * 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.
+ * Receives Studio's answer on 127.0.0.1: the one-time code of an approval, or a denial. Only a callback carrying
+ * this session's state is accepted, so another page cannot feed the CLI a code of its own. The browser ends on a
+ * Studio page; its address is built from the CLI's own Studio URL, never from the request.
  */
-export declare const startLoginCallbackListener: (state: string) => Promise<LoginCallbackListener>;
+export declare const startLoginCallbackListener: (props: LoginCallbackListenerProps) => 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.
+ * Signs the CLI in to an SDK-builder workspace: the user names the token and 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.
+ * 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 {};

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 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"),u=r(16).toString("base64url"),m=await startLoginCallbackListener(u);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",u),t.searchParams.set("challenge",h),l.step(`Signing in to workspace "${o.customer}" on ${o.serverUrl}`),l.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{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:
 
   ${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.code,{data:p,error:g}=await i(o.serverUrl).POST("/auth/token",{body:{code:r,codeVerifier:d,port:m.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,studioUrl:o.studioUrl,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{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 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()}};

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

@@ -1,2 +1,2 @@
-import{writeFile as e}from"fs/promises";import{createApiBaseClient as a}from"#package/client";import{resolveApplicationSpecDeploymentData as r}from"../application-spec/index.js";import{formatEnvContent as t,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=a(v);o.debug(`Using server URL: ${v}`);let y=await r({skipUpload:u,logger:o});if(y.assistant){let{sdl:e,prompt:a,instructions:r}=y.assistant,t=a.length+e.length+(r?.length??0);o.info(`Assistant GraphQL schema:
-${e}`),o.info(`Assistant prompt of this deployment (generated prompt, schema and instructions): ${t} characters`)}o.info("Preparing deployment on server...");let{data:w,error:F}=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,assistant:y.assistant,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(F)throw Error(`Failed to prepare deployment with server: ${F.message}`);if(!w)throw Error("No data returned from server");o.debug("Deployment prepared on server");let{baseDomain:S,isCustomDomain:P}=w,U=w.environmentVariables,k=w.privateUploadUrls,$=w.publicUploadUrls;if(!U||!k||!$)throw Error("Incomplete data returned from server");try{let a=[t(U),i("BASE_DOMAIN",String(S)),i("IS_CUSTOM_DOMAIN",String(P))].join("\n");await e(h,a+"\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 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)),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 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)}};

package/dist/phoenix/commands/prepare-local-environment-command.js

@@ -1 +1 @@
-import{writeFile as e}from"fs/promises";import{createApiBaseClient as r}from"#package/client";import{resolveApplicationSpecDeploymentData as t}from"../application-spec/index.js";import{formatEnvContent as i,uploadFilesWithPresignedUrls as a}from"../utils/index.js";export const prepareLocalEnvironment=async(o,s)=>{let{logger:n}=s;n.step("Preparing local environment");let{projectKey:l,projectSlug:p,outFile:c,skipUpload:d,overrideSchema:m,serverUrl:h,lambdaUrl:f,environmentSlug:v,apiKey:u}=o;n.info(`Preparing local environment for project "${p}", environment "${v}"`);let y=r(h);n.debug(`Using server URL: ${h}`);let b=await t({skipUpload:d,logger:n});n.info("Preparing a local environment and deployment on the server...");let{data:g,error:w}=await y.POST("/environments/prepare",{body:{projectSlug:p,environmentSlug:v,applicationVersion:b.applicationVersion,publishedDataHash:b.publishedDataHash,useAuthHook:b.useAuthHook,overrideSchema:m,configurationSchema:{version:b.schemaVersion,schema:b.schema},adminConfigurationSchema:b.adminSchema?{schema:b.adminSchema,version:b.adminSchemaVersion}:void 0,chat:b.chat,embeddings:b.embeddings,assistant:b.assistant,acl:{canCreate:b.aclCanCreate},privateFiles:[...b.assets.privateFilePaths],publicFiles:[...b.assets.publicFilePaths]},headers:{"x-api-key":u,"x-project-key":l,"x-project-slug":p}});if(w)throw Error(`Failed to prepare deployment with server: ${w.message}`);if(!g)throw Error("No data returned from server");n.debug("Deployment prepared on server");let E=g.environmentVariables,F=g.privateUploadUrls,P=g.publicUploadUrls,$=E?.DEPLOYMENT_ID;if(!E||!F||!P)throw Error("Incomplete data returned from server");if(!$)throw Error("No deployment ID returned from server");try{await e(c,i(E)+"\n"),n.debug(`Environment variables written to ${c}`)}catch(e){throw Error(`Failed to write environment variables to file at ${c}, please verify you have write permissions to this location.`)}if(d)n.debug("Skipping file upload");else{n.info("Uploading files to S3...");let e={privateFiles:[...b.assets.privateFilesFullPaths].map(e=>{let r=e.replace("assets/private/",""),t=F[r];if(!t)throw Error(`No upload URL provided for private file ${r}, 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 r=e.replace("assets/public/",""),t=P[r];if(!t)throw Error(`No upload URL provided for public file ${r}, 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:n})}n.info("Activating deployment...");let{error:U}=await y.POST("/deployments/{deploymentId}/activate",{params:{path:{deploymentId:$}},headers:{"x-project-key":l,"x-project-slug":p,"x-api-key":u},body:{lambdaUrl:f}});if(U)throw Error(`Failed to activate deployment with server: ${U.message}`);n.info(`Project: ${p}`),n.info(`Environment: ${v}`),n.info(`Deployment ID: ${$}`),n.info(`Lambda URL: ${f}`),n.success("Local environment prepared successfully!")};
+import{writeFile as e}from"fs/promises";import{createApiBaseClient as r}from"#package/client";import{resolveApplicationSpecDeploymentData as t}from"../application-spec/index.js";import{formatEnvContent as i,uploadFilesWithPresignedUrls as a}from"../utils/index.js";export const prepareLocalEnvironment=async(o,s)=>{let{logger:n}=s;n.step("Preparing local environment");let{projectKey:l,projectSlug:p,outFile:c,skipUpload:d,overrideSchema:m,serverUrl:h,lambdaUrl:f,environmentSlug:v,apiKey:u}=o;n.info(`Preparing local environment for project "${p}", environment "${v}"`);let y=r(h);n.debug(`Using server URL: ${h}`);let b=await t({skipUpload:d,logger:n});n.info("Preparing a local environment and deployment on the server...");let{data:g,error:w}=await y.POST("/environments/prepare",{body:{projectSlug:p,environmentSlug:v,applicationVersion:b.applicationVersion,publishedDataHash:b.publishedDataHash,useAuthHook:b.useAuthHook,overrideSchema:m,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]},headers:{"x-api-key":u,"x-project-key":l,"x-project-slug":p}});if(w)throw Error(`Failed to prepare deployment with server: ${w.message}`);if(!g)throw Error("No data returned from server");n.debug("Deployment prepared on server");let E=g.environmentVariables,F=g.privateUploadUrls,P=g.publicUploadUrls,$=E?.DEPLOYMENT_ID;if(!E||!F||!P)throw Error("Incomplete data returned from server");if(!$)throw Error("No deployment ID returned from server");try{await e(c,i(E)+"\n"),n.debug(`Environment variables written to ${c}`)}catch(e){throw Error(`Failed to write environment variables to file at ${c}, please verify you have write permissions to this location.`)}if(d)n.debug("Skipping file upload");else{n.info("Uploading files to S3...");let e={privateFiles:[...b.assets.privateFilesFullPaths].map(e=>{let r=e.replace("assets/private/",""),t=F[r];if(!t)throw Error(`No upload URL provided for private file ${r}, 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 r=e.replace("assets/public/",""),t=P[r];if(!t)throw Error(`No upload URL provided for public file ${r}, 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:n})}n.info("Activating deployment...");let{error:U}=await y.POST("/deployments/{deploymentId}/activate",{params:{path:{deploymentId:$}},headers:{"x-project-key":l,"x-project-slug":p,"x-api-key":u},body:{lambdaUrl:f}});if(U)throw Error(`Failed to activate deployment with server: ${U.message}`);n.info(`Project: ${p}`),n.info(`Environment: ${v}`),n.info(`Deployment ID: ${$}`),n.info(`Lambda URL: ${f}`),n.success("Local environment prepared successfully!")};

package/dist/phoenix/commands/prettier.js

@@ -1 +1 @@
-import{readFile as t,writeFile as e}from"fs/promises";import{globby as o}from"globby";import{resolve as r}from"path";import*as i from"prettier";let a=["**/node_modules/**","**/dist/**","**/.git/**","**/webhooks/index.ts`","**/frontend-configurator.ts`","**/frontend-admin.ts`","**/frontend-embedded-admin.ts`","pnpm-lock.yaml",".linguirc"];export const formatFiles=async(n,f)=>{let{logger:l}=f,s=await o("."===n?"**/*":n,{gitignore:!0,ignore:a}),c=0;for(let o of s)try{let a=r(o),n=await t(a,"utf-8"),f=await i.resolveConfig(a);if((await i.getFileInfo(a)).ignored)continue;let l=await i.format(n,{...f,filepath:a});l!==n&&(await e(a,l,"utf-8"),c++)}catch(t){}c>0&&l.info(`Formatted ${c} file${1!==c?"s":""}`)};export const checkFiles=async(e,n)=>{let{logger:f}=n,l=await o("."===e?"**/*":e,{gitignore:!0,ignore:a}),s=[];for(let e of l)try{let o=r(e),a=await t(o,"utf-8"),n=await i.resolveConfig(o);if((await i.getFileInfo(o)).ignored)continue;await i.check(a,{...n,filepath:o})||s.push(e)}catch(t){}return!(s.length>0)||(f.error(`Found ${s.length} unformatted file${1!==s.length?"s":""}:`),s.forEach(t=>{console.error(`  - ${t}`)}),!1)};
+import{readFile as t,writeFile as o}from"fs/promises";import{globby as e}from"globby";import{resolve as r}from"path";import*as i from"prettier";import{prettierrc as a}from"@salsita-ai/common/prettier";let n=["**/node_modules/**","**/dist/**","**/.git/**","**/.phoenix/**","**/locales/*/*.ts","pnpm-lock.yaml","pnpm-workspace.yaml","package-lock.json","npm-shrinkwrap.json","yarn.lock",".yarnrc.yml","bun.lock","bun.lockb",".linguirc"];export const formatFiles=async(l,f)=>{let{logger:c}=f,s=await e("."===l?"**/*":l,{gitignore:!0,ignore:n}),m=0;for(let e of s)try{let n=r(e),l=await t(n,"utf-8"),f=await i.resolveConfig(n)??a;if((await i.getFileInfo(n)).ignored)continue;let c=await i.format(l,{...f,filepath:n});c!==l&&(await o(n,c,"utf-8"),m++)}catch(t){}m>0&&c.info(`Formatted ${m} file${1!==m?"s":""}`)};export const checkFiles=async(o,l)=>{let{logger:f}=l,c=await e("."===o?"**/*":o,{gitignore:!0,ignore:n}),s=[];for(let o of c)try{let e=r(o),n=await t(e,"utf-8"),l=await i.resolveConfig(e)??a;if((await i.getFileInfo(e)).ignored)continue;await i.check(n,{...l,filepath:e})||s.push(o)}catch(t){}return!(s.length>0)||(f.error(`Found ${s.length} unformatted file${1!==s.length?"s":""}:`),s.forEach(t=>{console.error(`  - ${t}`)}),!1)};

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

@@ -1,2 +1,2 @@
-import{globby as e}from"globby";import{rmSync as r}from"node:fs";import{mkdir as o,writeFile as t}from"node:fs/promises";import{dirname as s,resolve as i}from"node:path";import{startEditorServer as a}from"../editor-server/index.js";import{ApplicationSpecStoryWatcher as n}from"../services/application-spec-story-watcher.js";import{STORY_DEV_MARKER_PATH as l,readActiveStoryDevMarker as c}from"../services/index.js";import{MockTemplateWatcher as d}from"../services/mock-template-watcher.js";import{PhoenixPubSub as f}from"../services/phoenix-pubsub.js";import{resolveGlobToDirectories as p}from"./resolve-story-directories.js";import{runStoryBuildCommand as g}from"./story-build.js";let m=async(r,o)=>{let t=o?i(process.cwd(),o):s(r),a=new Set([r,...(await e(`*/${l}`,{cwd:t,absolute:!0})).map(e=>s(s(e)))]);return(await Promise.all([...a].map(c))).find(e=>null!==e)??null},w=async(e,r)=>{let a=i(e,l),n={projectRoot:e,pid:process.pid,port:r};return await o(s(a),{recursive:!0}),await t(a,`${JSON.stringify(n)}
-`),a},u=async(e,o)=>{let t=await p(e.folder,e.baseDir),[s]=t,i=e.editorWsPort??3120;if(!s||1!==t.length)throw Error(`Story dev requires exactly one existing story folder, but "${e.folder}" resolved ${t.length}. Pass one concrete folder and check the base directory.`);let l=await m(s,e.baseDir);if(l)throw Error(`Story dev is already running for "${l.projectRoot}" (PID ${l.pid}) on port ${l.port}. Stop that process before starting another story.`);let c=await w(s,i),u=()=>r(c,{force:!0});process.once("exit",u);let y=new f,h=null,b=null,S=null,v=!1,$=async()=>{if(!v){for(let e of(v=!0,process.off("exit",u),[{name:"story source watcher",close:()=>S?.close()},{name:"mock-template watcher",close:()=>b?.close()},{name:"editor server",close:()=>h?.close()}]))try{await e.close()}catch(r){o.logger.warn(`Failed to close the story-dev ${e.name}: ${r instanceof Error?r.message:String(r)}. The process will continue shutting down.`)}r(c,{force:!0})}};try{return o.logger.step(`Building application-spec story in ${s}`),await g({folder:s,baseDir:e.baseDir},o),h=a({port:i,projectRoot:s,pubsub:y,logger:o.logger,storyMode:!0}),await h.ready,(b=new d({projectRoot:s,pubsub:y,logger:o.logger})).start(),(S=new n({projectRoot:s,pubsub:y,logger:o.logger})).start(),o.logger.success(`Story dev is running for ${s}`),o.logger.info(`Editor WebSocket: ws://localhost:${i}`),o.logger.info("Source changes update the editor without regenerating Storybook files."),{markerPath:c,close:$}}catch(e){throw await $(),e}};export const runStoryDevCommand=async(e,r)=>{let o;if(o=e.folder,/[*?[\]{}()!]/.test(o))throw Error(`Story dev accepts one concrete story folder, but "${e.folder}" contains glob syntax. Pass a folder name without wildcards.`);let t=await u(e,r),s=null,i=new Promise(e=>{s=e}),a=()=>s?.();process.once("SIGINT",a),process.once("SIGTERM",a),e.shutdownSignal?.addEventListener("abort",a,{once:!0}),e.shutdownSignal?.aborted&&a();try{await i}finally{process.off("SIGINT",a),process.off("SIGTERM",a),e.shutdownSignal?.removeEventListener("abort",a),await t.close()}};
+import{globby as e}from"globby";import{rmSync as r}from"node:fs";import{mkdir as o,writeFile as t}from"node:fs/promises";import{dirname as s,resolve as i}from"node:path";import{startEditorServer as a}from"../editor-server/index.js";import{ApplicationSpecStoryWatcher as n}from"../services/application-spec-story-watcher.js";import{STORY_DEV_MARKER_PATH as l,readActiveStoryDevMarker as c}from"../services/index.js";import{MockTemplateWatcher as p}from"../services/mock-template-watcher.js";import{PhoenixApplication as d}from"../services/phoenix-application.js";import{PhoenixPubSub as f}from"../services/phoenix-pubsub.js";import{PhoenixStore as m}from"../services/phoenix-store.js";import{resolveGlobToDirectories as w}from"./resolve-story-directories.js";import{runStoryBuildCommand as g}from"./story-build.js";let u=async(r,o)=>{let t=o?i(process.cwd(),o):s(r),a=new Set([r,...(await e(`*/${l}`,{cwd:t,absolute:!0})).map(e=>s(s(e)))]);return(await Promise.all([...a].map(c))).find(e=>null!==e)??null},y=async(e,r)=>{let a=i(e,l),n={projectRoot:e,pid:process.pid,port:r};return await o(s(a),{recursive:!0}),await t(a,`${JSON.stringify(n)}
+`),a},h=async(e,o)=>{let t=await w(e.folder,e.baseDir),[s]=t,i=e.editorWsPort??3120;if(!s||1!==t.length)throw Error(`Story dev requires exactly one existing story folder, but "${e.folder}" resolved ${t.length}. Pass one concrete folder and check the base directory.`);let l=await u(s,e.baseDir);if(l)throw Error(`Story dev is already running for "${l.projectRoot}" (PID ${l.pid}) on port ${l.port}. Stop that process before starting another story.`);let c=await y(s,i),h=()=>r(c,{force:!0});process.once("exit",h);let v=new f,b=null,S=null,$=null,x=!1,j=async()=>{if(!x){for(let e of(x=!0,process.off("exit",h),[{name:"story source watcher",close:()=>$?.close()},{name:"mock-template watcher",close:()=>S?.close()},{name:"editor server",close:()=>b?.close()}]))try{await e.close()}catch(r){o.logger.warn(`Failed to close the story-dev ${e.name}: ${r instanceof Error?r.message:String(r)}. The process will continue shutting down.`)}r(c,{force:!0})}};try{return o.logger.step(`Building application-spec story in ${s}`),await g({folder:s,baseDir:e.baseDir},o),b=a({port:i,projectRoot:s,application:new d({store:new m,pubsub:v,variantPreviews:void 0}),logger:o.logger,storyMode:!0}),await b.ready,(S=new p({projectRoot:s,pubsub:v,logger:o.logger})).start(),($=new n({projectRoot:s,pubsub:v,logger:o.logger})).start(),o.logger.success(`Story dev is running for ${s}`),o.logger.info(`Editor WebSocket: ws://localhost:${i}`),o.logger.info("Source changes update the editor without regenerating Storybook files."),{markerPath:c,close:j}}catch(e){throw await j(),e}};export const runStoryDevCommand=async(e,r)=>{let o;if(o=e.folder,/[*?[\]{}()!]/.test(o))throw Error(`Story dev accepts one concrete story folder, but "${e.folder}" contains glob syntax. Pass a folder name without wildcards.`);let t=await h(e,r),s=null,i=new Promise(e=>{s=e}),a=()=>s?.();process.once("SIGINT",a),process.once("SIGTERM",a),e.shutdownSignal?.addEventListener("abort",a,{once:!0}),e.shutdownSignal?.aborted&&a();try{await i}finally{process.off("SIGINT",a),process.off("SIGTERM",a),e.shutdownSignal?.removeEventListener("abort",a),await t.close()}};

package/dist/phoenix/commands/sync.js

@@ -1 +1 @@
-import{ensureWorkspaceInstallSettings as e,runCommand as s}from"../utils/index.js";import{generateProjectFilesAndInstallDependencies as c}from"./generate-project-files.js";export const runSyncCommand=async(t,i)=>{let{logger:r}=i,{sdkVersion:n,projectSlug:o,environmentSlug:l,cliUseWorkspace:a,enableEditor:p,force:m=!1,analyze:u=!1}=t;try{r.step("Syncing Phoenix project files"),e(process.cwd()),await s({command:"pnpm",args:["install"],description:"Installing packages",quiet:!0},{logger:r}),r.step("Building project files"),await c({sdkVersion:n,projectSlug:o,environmentSlug:l,cliUseWorkspace:a,enableEditor:p,inlineTemplates:!0,force:m,analyze:u},i),r.success("Project files built successfully"),r.success("Sync completed successfully!")}catch(e){r.error(`Sync failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(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)}};

package/dist/phoenix/commands/unlink.js

@@ -1 +1 @@
-import{getLocalOverrides as n,removeWorkspaceOverrides as e,runCommand as i}from"../utils/index.js";export const runUnlinkCommand=async a=>{let{logger:s}=a;try{s.step("Unlinking local SDK packages");let a=n();if(0===a.length)return void s.info("No linked SDK packages found");s.debug(`Found ${a.length} linked packages`),a.forEach(n=>{s.debug(`  Unlinked ${n}`)}),e(a),s.success(`Unlinked ${a.length} SDK packages`),await i({command:"pnpm",args:["install","--config.optimistic-repeat-install=false"],description:"Installing packages",quiet:!0},{logger:s}),s.info("\nNext step:"),s.info("  Run: phoenix dev")}catch(n){throw s.error(`Failed to unlink SDK packages: ${n instanceof Error?n.message:String(n)}. pnpm-workspace.yaml may be missing or invalid. Check that an overrides section exists in pnpm-workspace.yaml.`),n}};
+import{assertPnpmProject as n,getLocalOverrides as e,removeWorkspaceOverrides as r}from"../utils/index.js";export const runUnlinkCommand=async o=>{let{logger:i}=o;try{n({projectRoot:process.cwd(),command:"unlink"})}catch(n){throw i.error(n instanceof Error?n.message:String(n)),n}try{i.step("Unlinking local SDK packages");let n=e();if(0===n.length)return void i.info("No linked SDK packages found");i.debug(`Found ${n.length} linked packages`),n.forEach(n=>{i.debug(`  Unlinked ${n}`)}),r(n),i.success(`Unlinked ${n.length} SDK packages`),i.info("\nNext steps:\n  pnpm install --config.optimistic-repeat-install=false\n  phoenix dev")}catch(n){throw i.error(`Failed to unlink SDK packages: ${n instanceof Error?n.message:String(n)}. pnpm-workspace.yaml may be missing or invalid. Check that an overrides section exists in pnpm-workspace.yaml.`),n}};