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

package/dist/legacy/webhook-cli/lambda-local/index.js

@@ -1 +1 @@
-import dotenv from"dotenv";import fs from"fs";import{createServer}from"http";import{createRequire}from"module";import os from"os";import path from"path";import Context from"./lib/context.js";import{installLambdaStreaming}from"./lib/streaming.js";import*as utils from"./lib/utils.js";import{webhookLogContext}from"./log-context.js";installLambdaStreaming();let require=createRequire(import.meta.url);export const version="2.2.0";var logger=utils.getWinstonConsole();export function setLogger(e){null!=e&&void 0!==e.transports?logger=e:console.warn("Invalid logger object ! Using default logger")}export function getLogger(){return logger}export function execute(e){if(e.callback)_executeSync.apply(this,[e]);else{var t=this;return new Promise(function(o,n){var r=Object.assign({},e);r.callback=function(e,t){e&&n(e),o(t)},_executeSync.apply(t,[r])})}}export function watch(e){e.verboseLevel||(e.verboseLevel=0);let t=createServer(async function(e,t){return webhookLogContext.run("webhook",async()=>o(e,t))});async function o(t,o){let n=t.method,r=t.url;function a(e){return logger.log("warn",`⚠️  ${n} ${r} => `,e),o.statusCode=500,o.end(JSON.stringify({error:e}))}try{_getRequestPayload(t,async(t,s)=>{try{if(t)throw t;let a=await execute({...e,event:s}),i=_formatResponsePayload(o,a);return e.verboseLevel>0&&logger.log("info",`✓ ${n} ${r}`),o.end(i)}catch(e){return a(e)}})}catch(e){return a(e)}}return t.listen(e.port,function(){logger.log("info",`ℹ️  Lambda handler ready on http://localhost:${e.port}`)}),t}function _getRequestPayload(e,t){let o="";e.on("data",e=>{o+=e.toString()}),e.on("end",()=>{let n,r,a="application/json"!==e.headers["content-type"];try{n=a?o:Buffer.from(o,"utf-8").toString("base64")}catch(e){t(e);return}if(n.event)r=n.event;else{let t=new URL(e.url,`http://${e.headers.host}`);r={version:"2.0",routeKey:"$default",rawPath:t.pathname,rawQueryString:t.search,cookies:utils.parseCookies(e),headers:e.headers,queryStringParameters:Object.fromEntries(t.searchParams),requestContext:{accountId:"123456789012",apiId:"api-id",authentication:{},authorizer:{},http:{method:e.method,path:t.pathname,protocol:"HTTP/"+e.httpVersion,sourceIp:e.socket.localAddress,userAgent:e.headers["user-agent"]},requestId:"id",routeKey:"$default",stage:"$default",time:new Date().toISOString(),timeEpoch:new Date().getTime()},body:n,isBase64Encoded:!a}}t(null,r)})}function _formatResponsePayload(e,t){return t.statusCode||(t={isBase64Encoded:!1,statusCode:200,body:t,headers:{"content-type":"application/json"}}),e.writeHead(t.statusCode,t.headers),t.body}function updateEnv(e){Object.keys(e).forEach(function(t){process.env[t]||(process.env[t]=e[t])})}function _executeSync(opts){var event=opts.event,lambdaFunc=opts.lambdaFunc,lambdaPath=opts.lambdaPath,lambdaHandler=opts.lambdaHandler||"handler",esm=opts.esm,profilePath=opts.profilePath,profileName=opts.profileName||process.env.AWS_PROFILE||process.env.AWS_DEFAULT_PROFILE,region=opts.region,environment=opts.environment,envdestroy=opts.envdestroy,envfile=opts.envfile,callbackWaitsForEmptyEventLoop=opts.callbackWaitsForEmptyEventLoop||!1,timeoutMs=opts.timeoutMs||1e4,verboseLevel=opts.verboseLevel,callback=opts.callback,contextOverwrite=opts.contextOverwrite,onInvocationEnd=opts.onInvocationEnd,clientContext=null;if(opts.clientContext)if("string"==typeof opts.clientContext)try{clientContext=JSON.parse(opts.clientContext)}catch(err){throw SyntaxError("clientContext is an invalid stringified JS object")}else clientContext=opts.clientContext;if(lambdaFunc&&lambdaPath)throw SyntaxError("Cannot specify both lambdaFunc and lambdaPath !");callbackWaitsForEmptyEventLoop&&16>utils.get_node_major_version()&&(console.warn("callbackWaitsForEmptyEventLoop not supported on node < 16"),callbackWaitsForEmptyEventLoop=!1),lambdaPath&&(lambdaPath=(esm&&"win32"===process.platform?"file://":"")+utils.getAbsolutePath(lambdaPath));var envVars={AWS_LAMBDA_FUNCTION_NAME:lambdaHandler,AWS_LAMBDA_FUNCTION_MEMORY_SIZE:Math.floor(os.freemem()/1048576).toString(),AWS_LAMBDA_FUNCTION_VERSION:"1.0",AWS_EXECUTION_ENV:"AWS_Lambda_nodejs"+process.version.substr(1),LAMBDA_CONSOLE_SOCKET:"14",LAMBDA_CONTROL_SOCKET:"11",LAMBDA_RUNTIME_DIR:process.cwd(),NODE_PATH:utils.getAbsolutePath("node_modules"),TZ:Intl.DateTimeFormat().resolvedOptions().timeZone};lambdaPath?(envVars.LAMBDA_TASK_ROOT=path.dirname(lambdaPath),envVars._HANDLER=path.basename(lambdaPath,path.extname(lambdaPath))+"."+lambdaHandler):(envVars.LAMBDA_TASK_ROOT=process.cwd(),envVars._HANDLER="index."+lambdaHandler),updateEnv(envVars),null!=environment&&(null==envdestroy&&(envdestroy=!1),Object.keys(environment).forEach(function(e){process.env[e]=environment[e]})),null!=envfile&&dotenv.config({path:envfile,quiet:!0}),profilePath=profilePath||process.env.AWS_SHARED_CREDENTIALS_FILE;var default_config_file=utils.getAbsolutePath("~/.aws/config"),default_credentials_file=utils.getAbsolutePath("~/.aws/credentials");fs.existsSync(default_config_file)&&utils.loadAWSCredentials(default_config_file,profileName),fs.existsSync(default_credentials_file)&&utils.loadAWSCredentials(default_credentials_file,profileName),profilePath&&utils.loadAWSCredentials(profilePath,profileName),process.env.AWS_REGION=region||process.env.AWS_REGION||"us-east-1",process.env.AWS_DEFAULT_REGION=region||process.env.AWS_DEFAULT_REGION||"us-east-1",void 0===verboseLevel&&(verboseLevel=3);var context=new Context;context._initialize({functionName:lambdaHandler,timeoutMs:timeoutMs,callbackWaitsForEmptyEventLoop:callbackWaitsForEmptyEventLoop,verboseLevel:verboseLevel,logger:logger,finalCallback:function(){null!=environment&&envdestroy&&Object.keys(environment).forEach(function(e){delete process.env[e]})},clientContext:clientContext,onInvocationEnd:onInvocationEnd}),callback&&(context.callback=callback);var ctx=context.generate_context();contextOverwrite&&opts.contextOverwrite(ctx);let executeLambdaFunc=e=>{try{event instanceof Function&&(event=event()),context._init_timeout();var t=e[lambdaHandler](event,ctx,ctx.done);t&&(t.then?t.then(ctx.succeed,ctx.fail):ctx.succeed(null))}catch(e){ctx.fail(e)}};try{lambdaFunc?executeLambdaFunc(lambdaFunc):esm?eval("import(lambdaPath)").then(executeLambdaFunc,e=>ctx.fail(e)):(delete require.cache[require.resolve(lambdaPath)],executeLambdaFunc(require(lambdaPath)))}catch(err){ctx.fail(err)}}
+import dotenv from"dotenv";import fs from"fs";import{createServer}from"http";import{createRequire}from"module";import os from"os";import path from"path";import Context from"./lib/context.js";import{installLambdaStreaming}from"./lib/streaming.js";import*as utils from"./lib/utils.js";import{webhookLogContext}from"./log-context.js";installLambdaStreaming();let require=createRequire(import.meta.url);export const version="2.2.0";var logger=utils.getWinstonConsole();export function setLogger(e){null!=e&&void 0!==e.transports?logger=e:console.warn("Invalid logger object ! Using default logger")}export function getLogger(){return logger}export function execute(e){if(e.callback)_executeSync.apply(this,[e]);else{var t=this;return new Promise(function(o,n){var r=Object.assign({},e);r.callback=function(e,t){e&&n(e),o(t)},_executeSync.apply(t,[r])})}}export function watch(e){e.verboseLevel||(e.verboseLevel=0);let t=createServer(async function(e,t){return webhookLogContext.run("webhook",async()=>o(e,t))});async function o(t,o){let n=t.method,r=t.url;function a(e){return logger.log("warn",`⚠️  ${n} ${r} => `,e),o.statusCode=500,o.end(JSON.stringify({error:e}))}try{_getRequestPayload(t,async(t,s)=>{try{if(t)throw t;let a=await execute({...e,event:s}),i=_formatResponsePayload(o,a);return e.verboseLevel>0&&logger.log("info",`✓ ${n} ${r}`),o.end(i)}catch(e){return a(e)}})}catch(e){return a(e)}}return t.listen(e.port,function(){logger.log("info",`ℹ️  Lambda handler ready on http://localhost:${e.port}`)}),t}function _getRequestPayload(e,t){let o="";e.on("data",e=>{o+=e.toString()}),e.on("end",()=>{let n,r,a="application/json"!==e.headers["content-type"];try{n=a?o:Buffer.from(o,"utf-8").toString("base64")}catch(e){t(e);return}if(n.event)r=n.event;else{let t=new URL(e.url,`http://${e.headers.host}`);r={version:"2.0",routeKey:"$default",rawPath:t.pathname,rawQueryString:t.search,cookies:utils.parseCookies(e),headers:e.headers,queryStringParameters:Object.fromEntries(t.searchParams),requestContext:{accountId:"123456789012",apiId:"api-id",authentication:{},authorizer:{},http:{method:e.method,path:t.pathname,protocol:"HTTP/"+e.httpVersion,sourceIp:e.socket.localAddress,userAgent:e.headers["user-agent"]},requestId:"id",routeKey:"$default",stage:"$default",time:new Date().toISOString(),timeEpoch:new Date().getTime()},body:n,isBase64Encoded:!a}}t(null,r)})}function _formatResponsePayload(e,t){return t.statusCode||(t={isBase64Encoded:!1,statusCode:200,body:t,headers:{"content-type":"application/json"}}),e.writeHead(t.statusCode,t.headers),t.isBase64Encoded?Buffer.from(t.body??"","base64"):t.body}function updateEnv(e){Object.keys(e).forEach(function(t){process.env[t]||(process.env[t]=e[t])})}function _executeSync(opts){var event=opts.event,lambdaFunc=opts.lambdaFunc,lambdaPath=opts.lambdaPath,lambdaHandler=opts.lambdaHandler||"handler",esm=opts.esm,profilePath=opts.profilePath,profileName=opts.profileName||process.env.AWS_PROFILE||process.env.AWS_DEFAULT_PROFILE,region=opts.region,environment=opts.environment,envdestroy=opts.envdestroy,envfile=opts.envfile,callbackWaitsForEmptyEventLoop=opts.callbackWaitsForEmptyEventLoop||!1,timeoutMs=opts.timeoutMs||1e4,verboseLevel=opts.verboseLevel,callback=opts.callback,contextOverwrite=opts.contextOverwrite,onInvocationEnd=opts.onInvocationEnd,clientContext=null;if(opts.clientContext)if("string"==typeof opts.clientContext)try{clientContext=JSON.parse(opts.clientContext)}catch(err){throw SyntaxError("clientContext is an invalid stringified JS object")}else clientContext=opts.clientContext;if(lambdaFunc&&lambdaPath)throw SyntaxError("Cannot specify both lambdaFunc and lambdaPath !");callbackWaitsForEmptyEventLoop&&16>utils.get_node_major_version()&&(console.warn("callbackWaitsForEmptyEventLoop not supported on node < 16"),callbackWaitsForEmptyEventLoop=!1),lambdaPath&&(lambdaPath=(esm&&"win32"===process.platform?"file://":"")+utils.getAbsolutePath(lambdaPath));var envVars={AWS_LAMBDA_FUNCTION_NAME:lambdaHandler,AWS_LAMBDA_FUNCTION_MEMORY_SIZE:Math.floor(os.freemem()/1048576).toString(),AWS_LAMBDA_FUNCTION_VERSION:"1.0",AWS_EXECUTION_ENV:"AWS_Lambda_nodejs"+process.version.substr(1),LAMBDA_CONSOLE_SOCKET:"14",LAMBDA_CONTROL_SOCKET:"11",LAMBDA_RUNTIME_DIR:process.cwd(),NODE_PATH:utils.getAbsolutePath("node_modules"),TZ:Intl.DateTimeFormat().resolvedOptions().timeZone};lambdaPath?(envVars.LAMBDA_TASK_ROOT=path.dirname(lambdaPath),envVars._HANDLER=path.basename(lambdaPath,path.extname(lambdaPath))+"."+lambdaHandler):(envVars.LAMBDA_TASK_ROOT=process.cwd(),envVars._HANDLER="index."+lambdaHandler),updateEnv(envVars),null!=environment&&(null==envdestroy&&(envdestroy=!1),Object.keys(environment).forEach(function(e){process.env[e]=environment[e]})),null!=envfile&&dotenv.config({path:envfile,quiet:!0}),profilePath=profilePath||process.env.AWS_SHARED_CREDENTIALS_FILE;var default_config_file=utils.getAbsolutePath("~/.aws/config"),default_credentials_file=utils.getAbsolutePath("~/.aws/credentials");fs.existsSync(default_config_file)&&utils.loadAWSCredentials(default_config_file,profileName),fs.existsSync(default_credentials_file)&&utils.loadAWSCredentials(default_credentials_file,profileName),profilePath&&utils.loadAWSCredentials(profilePath,profileName),process.env.AWS_REGION=region||process.env.AWS_REGION||"us-east-1",process.env.AWS_DEFAULT_REGION=region||process.env.AWS_DEFAULT_REGION||"us-east-1",void 0===verboseLevel&&(verboseLevel=3);var context=new Context;context._initialize({functionName:lambdaHandler,timeoutMs:timeoutMs,callbackWaitsForEmptyEventLoop:callbackWaitsForEmptyEventLoop,verboseLevel:verboseLevel,logger:logger,finalCallback:function(){null!=environment&&envdestroy&&Object.keys(environment).forEach(function(e){delete process.env[e]})},clientContext:clientContext,onInvocationEnd:onInvocationEnd}),callback&&(context.callback=callback);var ctx=context.generate_context();contextOverwrite&&opts.contextOverwrite(ctx);let executeLambdaFunc=e=>{try{event instanceof Function&&(event=event()),context._init_timeout();var t=e[lambdaHandler](event,ctx,ctx.done);t&&(t.then?t.then(ctx.succeed,ctx.fail):ctx.succeed(null))}catch(e){ctx.fail(e)}};try{lambdaFunc?executeLambdaFunc(lambdaFunc):esm?eval("import(lambdaPath)").then(executeLambdaFunc,e=>ctx.fail(e)):(delete require.cache[require.resolve(lambdaPath)],executeLambdaFunc(require(lambdaPath)))}catch(err){ctx.fail(err)}}

package/dist/phoenix/application-spec/application-spec-builder.d.ts

@@ -1,5 +1,5 @@
 import { GeneratedApplicationFile } from '#package/application-spec';
-import type { Application, ParseContext, ParseCount, ParseMetric, RawProjectFiles, SpecDiagnostic } from '#package/application-spec';
+import type { Application, PageExperience, ParseContext, ParseCount, ParseMetric, RawProjectFiles, SpecDiagnostic } from '#package/application-spec';
 import { type Logger } from '../utils/index.js';
 interface ApplicationSpecBuilderConfig {
     readonly logger: Logger;
@@ -7,9 +7,7 @@ interface ApplicationSpecBuilderConfig {
     readonly projectSlug: string;
     readonly environmentSlug: string;
     readonly cliUseWorkspace?: boolean;
-    readonly name?: string;
-    readonly description?: string;
-    readonly enableEditor: boolean;
+    readonly pageExperience: PageExperience;
     readonly inlineTemplates: boolean;
 }
 export type ApplicationSpecBuildResult = {

package/dist/phoenix/application-spec/application-spec-builder.js

@@ -1 +1 @@
-import{existsSync as e,lstatSync as i,readFileSync as t,readdirSync as r,rmSync as o,unlinkSync as s}from"fs";import{join as n}from"path";import{format as a}from"prettier";import{prettierrc as l}from"@salsita-ai/common/prettier";import{GeneratedApplication as c,GeneratedApplicationFile as p,RuntimeReferenceStore as g,buildPhoenixDefinitions as f,createContentDiffTracker as h,generateApplicationCode as d,parseApplicationFiles as m}from"#package/application-spec";import{getAllPhxDefinitions as u}from"#package/domain";import{compileWithSwc as w}from"../services/swc.js";import{isInsideGitRepository as b,syncChangedFiles as S}from"../utils/index.js";import{readApplicationFiles as j}from"./application-spec-file-reader.js";import{cleanStaleAgentSkills as v,removeProjectFiles as D}from"./clean-project-files.js";import{swcEvalExpressionParser as F,swcModuleAnalyzer as x}from"./swc-module-analyzer.js";let y=".phoenix",P=`${y}/`,k=async e=>{if(e.binary||!1===e.format)return e;try{let i=await a(e.content,{...l,filepath:e.path});return p(e.path,i,{binary:e.binary,format:e.format})}catch{return e}},C=async e=>{let[i,t,r]=await Promise.all([Promise.all(e.generatedProjectFiles.map(k)),Promise.all(e.initialProjectFiles.map(k)),Promise.all(e.prettierFiles.map(k))]);return c({files:e.files,generatedProjectFiles:i,initialProjectFiles:t,prettierFiles:r,removedProjectFiles:e.removedProjectFiles})};export class ApplicationSpecBuilder{contentDiff;referenceStore;config;logger;phxDefinitions;constructor(e){this.config=e,this.logger=e.logger,this.referenceStore=new g,this.contentDiff=h({readDiskContent:this.readDiskContent}),this.phxDefinitions=f(u())}async build(e){let i=e?.parsingContext,t=e?.compile??!0;e?.force&&this.referenceStore.clear();let r=i?.startSpan("readFiles","build","application-spec-builder.ts"),o=e?.rawProjectFiles??await j({envs:{}});r?.();let s=m({rawProjectFiles:o,phxDefinitions:this.phxDefinitions},{analyzer:x,evalExpressionParser:F,referenceStore:this.referenceStore,logger:this.logger,parsingContext:i});if(!s.ok)return{ok:!1,rawProjectFiles:o,errors:s.errors,diagnostics:s.diagnostics,metrics:s.metrics,counts:s.counts};let{applicationSpec:n,categorizedFiles:a,rawMockTemplates:l}=s.value,c=i?.startSpan("generateCode","build","application-spec-builder.ts"),p=b(process.cwd());p||this.logger.debug("  Not inside a git repository, .gitignore is not written");let g=d({applicationSpec:n,categorizedFiles:a,phxDefinitions:this.phxDefinitions,sdkVersion:this.config.sdkVersion,projectInGitRepository:p,cliUseWorkspace:this.config.cliUseWorkspace,name:this.config.name,description:this.config.description,projectSlug:this.config.projectSlug,environmentSlug:this.config.environmentSlug,enableEditor:this.config.enableEditor,inlineTemplates:this.config.inlineTemplates,rawMockTemplates:l});c?.();let f=i?.startSpan("cleanStaleFiles","build","application-spec-builder.ts"),h=new Set(g.files.map(e=>e.path));this.cleanStaleGeneratedFiles(h),D(g.removedProjectFiles,{logger:this.logger}),v(new Set(g.generatedProjectFiles.map(e=>e.path)),{logger:this.logger}),f?.();let u=i?.startSpan("contentDiff","build","application-spec-builder.ts"),w=await C(g),y=this.contentDiff.getChangedApplicationFiles(w,{generatedFilesPathPrefix:P,force:e?.force}),k=y.changedGeneratedFiles;u?.(),k.length>0?this.logger.info(`  ${k.length}/${g.files.length} generated files changed`):this.logger.info("  No generated files changed");let $=y.filesToWrite.length-k.length;$>0&&this.logger.info(`  ${$} project files changed`);let T=i?.startSpan("writeFiles","build","application-spec-builder.ts");return await S(y.filesToWrite,{logger:this.logger,skipChecksum:!0}),T?.(),t&&await this.compile(i),{ok:!0,application:s.value,changedFiles:k,diagnostics:s.diagnostics,metrics:s.metrics,counts:s.counts}}async compile(e){let i=e?.startSpan("swcCompile(src)","build","application-spec-builder.ts");await w({sourceDir:"src",outDir:`./${y}/.swc/src`},{logger:this.logger}),i?.();let t=e?.startSpan("swcCompile(.phoenix)","build","application-spec-builder.ts");await w({sourceDir:y,outDir:`./${y}/.swc/${y}`},{logger:this.logger}),t?.()}readDiskContent=i=>{try{if(e(i))return t(i,"utf-8")}catch{}};cleanStaleGeneratedFiles(t){let a=new Set(["public",".swc","dist","phoenix-dev.log","phoenix-dev.log.1","phoenix-dev.log.2","variants","variant-recovery.json"]);try{if(!e(y))return;for(let e of r(y)){if(a.has(e)||t.has(e))continue;let r=n(y,e);try{let e=i(r);if(e.isSymbolicLink())continue;e.isDirectory()?o(r,{recursive:!0}):s(r),this.logger.debug(`  Removed stale: ${r}`)}catch{}}}catch{}}}
+import{existsSync as e,lstatSync as t,readFileSync as i,readdirSync as r,rmSync as s,unlinkSync as n}from"fs";import{join as o}from"path";import{format as a,resolveConfig as l}from"prettier";import{prettierrc as c}from"@salsita-ai/common/prettier";import{GeneratedApplication as p,GeneratedApplicationFile as g,RuntimeReferenceStore as d,buildPhoenixDefinitions as h,createContentDiffTracker as f,generateApplicationCode as m,isTextFile as u,parseApplicationFiles as k}from"#package/application-spec";import{getAllPhxDefinitions as j}from"#package/domain";import{findSdkPeerMismatches as S}from"../commands/deps/index.js";import{compileWithSwc as w}from"../services/swc.js";import{findPackageManagerCommands as b,isInsideGitRepository as v,syncChangedFiles as y}from"../utils/index.js";import{readApplicationFiles as x}from"./application-spec-file-reader.js";import{cleanStaleAgentSkills as $,removeProjectFiles as F}from"./clean-project-files.js";import{PROJECT_WORKSPACE_ENTRY as D}from"./project-files.js";import{swcEvalExpressionParser as P,swcModuleAnalyzer as C}from"./swc-module-analyzer.js";let E=".phoenix",T=`${E}/`,A="@salsita-ai/sdk",N=e=>({code:"SDK_PEER_MISMATCH",message:e,severity:"error",path:[]}),V=async e=>{try{return await l(e)??c}catch{return c}},_=async e=>{if(e.binary||!1===e.format)return e;try{let t=await a(e.content,{...await V(e.path),filepath:e.path});return g(e.path,t,{binary:e.binary,format:!1})}catch{return g(e.path,e.content,{binary:e.binary,format:!1})}},R=async e=>{let[t,i]=await Promise.all([Promise.all(e.generatedProjectFiles.map(_)),Promise.all(e.initialProjectFiles.map(_))]);return p({files:e.files,generatedProjectFiles:t,initialProjectFiles:i,removedProjectFiles:e.removedProjectFiles})};export class ApplicationSpecBuilder{contentDiff;referenceStore;config;logger;phxDefinitions;constructor(e){this.config=e,this.logger=e.logger,this.referenceStore=new d,this.contentDiff=f({readDiskContent:this.readDiskContent}),this.phxDefinitions=h(j())}async build(e){let t=e?.parsingContext,i=e?.compile??!0;e?.force&&this.referenceStore.clear();let r=t?.startSpan("readFiles","build","application-spec-builder.ts"),s=e?.rawProjectFiles??await x({envs:{}});r?.();let n=k({rawProjectFiles:s,phxDefinitions:this.phxDefinitions},{analyzer:C,evalExpressionParser:P,referenceStore:this.referenceStore,logger:this.logger,parsingContext:t});if(!n.ok)return{ok:!1,rawProjectFiles:s,errors:n.errors,diagnostics:n.diagnostics,metrics:n.metrics,counts:n.counts};let{applicationSpec:o,categorizedFiles:a,rawMockTemplates:l}=n.value,c=(e=>{let t,i,r=e.rawFiles.files.filter(u).find(e=>"package.json"===e.name),s={};try{s=void 0===r?{}:JSON.parse(r.content)}catch(e){return N(`package.json is not valid JSON (${e instanceof Error?e.message:String(e)}), so the build cannot check that it declares the packages ${A} needs. Fix the file and run the command again.`)}if(!("object"==typeof(t=s)&&null!==t&&!Array.isArray(t)))return N(`package.json is not a JSON object, so the build cannot check that it declares the packages ${A} needs. Fix the file and run the command again.`);let n=S({packageJson:s,useClerk:e.useClerk});if(0===n.length)return;let o=n.map(({peer:e,found:t})=>void 0===t?`  ${e.name}: needs ${e.range}, missing`:`  ${e.name}: needs ${e.range}, found ${t.specifier} in ${t.field}`);return N([`package.json does not declare the packages ${A} ${e.sdkVersion} needs next to it at versions it supports:`,...o,`The SDK's code imports these packages from the project's install. ${void 0===(i=b(process.env.npm_config_user_agent))?"Run `phoenix deps` through your package manager, then install the dependencies, and run this command again.":`Run \`${i.phoenix("deps")}\`, then \`${i.install}\`, and run this command again.`}`].join("\n"))})({rawFiles:s,useClerk:o.appMetadata.useClerk,sdkVersion:this.config.sdkVersion});if(void 0!==c)return{ok:!1,rawProjectFiles:s,errors:[c],diagnostics:n.diagnostics,metrics:n.metrics,counts:n.counts};let p=t?.startSpan("generateCode","build","application-spec-builder.ts"),g=v(process.cwd());g||this.logger.debug("  Not inside a git repository, .gitignore is not written");let d=m({applicationSpec:o,categorizedFiles:a,phxDefinitions:this.phxDefinitions,sdkVersion:this.config.sdkVersion,projectInGitRepository:g,cliUseWorkspace:this.config.cliUseWorkspace,projectSlug:this.config.projectSlug,environmentSlug:this.config.environmentSlug,pageExperience:this.config.pageExperience,inlineTemplates:this.config.inlineTemplates,rawMockTemplates:l});p?.();let h=t?.startSpan("cleanStaleFiles","build","application-spec-builder.ts"),f=new Set(d.files.map(e=>e.path));this.cleanStaleGeneratedFiles(f),F(d.removedProjectFiles,{logger:this.logger}),$(new Set(d.generatedProjectFiles.map(e=>e.path)),{logger:this.logger}),h?.();let j=t?.startSpan("contentDiff","build","application-spec-builder.ts"),w=await R(d),D=this.contentDiff.getChangedApplicationFiles(w,{generatedFilesPathPrefix:T,force:e?.force}),E=D.changedGeneratedFiles;j?.(),E.length>0?this.logger.info(`  ${E.length}/${d.files.length} generated files changed`):this.logger.info("  No generated files changed");let V=D.filesToWrite.length-E.length;V>0&&this.logger.info(`  ${V} project files changed`);let _=t?.startSpan("writeFiles","build","application-spec-builder.ts");return await y(D.filesToWrite,{logger:this.logger,skipChecksum:!0}),_?.(),i&&await this.compile(t),{ok:!0,application:n.value,changedFiles:E,diagnostics:n.diagnostics,metrics:n.metrics,counts:n.counts}}async compile(e){let t=e?.startSpan("swcCompile(src)","build","application-spec-builder.ts");await w({sourceDir:"src",outDir:`./${E}/.swc/src`,ignoredPaths:[]},{logger:this.logger}),t?.();let i=e?.startSpan("swcCompile(.phoenix)","build","application-spec-builder.ts");await w({sourceDir:E,outDir:`./${E}/.swc/${E}`,ignoredPaths:[`${D}/**`]},{logger:this.logger}),i?.()}readDiskContent=t=>{try{if(e(t))return i(t,"utf-8")}catch{}};cleanStaleGeneratedFiles(i){let a=new Set(["public",".swc","dist","phoenix-dev.log","phoenix-dev.log.1","phoenix-dev.log.2","variants","variant-recovery.json",D,".env.generated"]);try{if(!e(E))return;for(let e of r(E)){if(a.has(e)||i.has(e))continue;let r=o(E,e);try{let e=t(r);if(e.isSymbolicLink())continue;e.isDirectory()?s(r,{recursive:!0}):n(r),this.logger.debug(`  Removed stale: ${r}`)}catch{}}}catch{}}}

package/dist/phoenix/application-spec/generate-application-spec-project.d.ts

@@ -1,12 +1,11 @@
+import { type PageExperience } from '#package/application-spec';
 import { type Logger } from '../utils/index.js';
 interface GenerateProjectOptions {
     readonly sdkVersion: string;
     readonly projectSlug: string;
     readonly environmentSlug: string;
     readonly cliUseWorkspace?: boolean;
-    readonly name?: string;
-    readonly description?: string;
-    readonly enableEditor?: boolean;
+    readonly pageExperience: PageExperience;
     readonly inlineTemplates?: boolean;
     readonly withLingui?: boolean;
     readonly force?: boolean;
@@ -16,5 +15,6 @@ interface GenerateProjectOptions {
 export declare const generateApplicationSpecProject: (options: GenerateProjectOptions) => Promise<{
     templateFiles: readonly string[];
     applicationSpec: import("#package/application-spec").ApplicationSpec;
+    diagnostics: readonly import("#package/application-spec").SpecDiagnostic[];
 }>;
 export {};

package/dist/phoenix/application-spec/generate-application-spec-project.js

@@ -1,2 +1,2 @@
-import{symlink as e}from"fs/promises";import{ParseContext as i}from"#package/application-spec";import{extractAndCompileLingui as t}from"../services/lingui.js";import{compileWithSwc as p}from"../services/swc.js";import{exists as a}from"../utils/index.js";import{ApplicationSpecBuilder as s}from"./application-spec-builder.js";import{formatMetrics as r}from"./metrics/index.js";import{syncTemplateFiles as n}from"./template-files.js";let o=".phoenix",c=async(e,i)=>{let t=i.startSpan("swcCompile(src)","sync","generate-application-spec-project.ts");await p({sourceDir:"src",outDir:`./${o}/.swc/src`},{logger:e}),t();let a=i.startSpan("swcCompile(.phoenix)","sync","generate-application-spec-project.ts");await p({sourceDir:o,outDir:`./${o}/.swc/${o}`},{logger:e}),a()};export const generateApplicationSpecProject=async p=>{let{withLingui:o=!0,force:l=!1,analyze:m=!1}=p,u=p.logger;u.info("Using application-spec pipeline");let g=new i,j=g.startSpan("sync","generateApplicationSpecProject","generate-application-spec-project.ts"),w=g.startSpan("build","sync","application-spec-builder.ts"),d=new s({logger:u,sdkVersion:p.sdkVersion,projectSlug:p.projectSlug,environmentSlug:p.environmentSlug,cliUseWorkspace:p.cliUseWorkspace,name:p.name,description:p.description,enableEditor:p.enableEditor??!0,inlineTemplates:p.inlineTemplates??!1}),S=await d.build({force:l,parsingContext:g,compile:!1});if(w(),!S.ok)throw Error(`Failed to parse application spec:
-${S.errors.map(e=>`  [${e.code}] ${e.message}`).join("\n")}`);let f=g.startSpan("symlink","sync","generate-application-spec-project.ts");await a("./.phoenix/public")||await e("../public","./.phoenix/public");let b=await n();if(f(),o){let e=g.startSpan("lingui","sync","generate-application-spec-project.ts");await t({logger:u}),e()}return await c(u,g),j(),m&&r(g.metrics,g.counts,u),{templateFiles:b,applicationSpec:S.application.applicationSpec}};
+import{symlink as e}from"fs/promises";import{ParseContext as i}from"#package/application-spec";import{bootstrapLinguiCatalogs as t,extractAndCompileLingui as p}from"../lingui/index.js";import{compileWithSwc as a}from"../services/swc.js";import{exists as o}from"../utils/index.js";import{ApplicationSpecBuilder as s}from"./application-spec-builder.js";import{formatMetrics as r}from"./metrics/index.js";import{PROJECT_WORKSPACE_ENTRY as c}from"./project-files.js";import{syncTemplateFiles as n}from"./template-files.js";let l=".phoenix",m=async(e,i)=>{let t=i.startSpan("swcCompile(src)","sync","generate-application-spec-project.ts");await a({sourceDir:"src",outDir:`./${l}/.swc/src`,ignoredPaths:[]},{logger:e}),t();let p=i.startSpan("swcCompile(.phoenix)","sync","generate-application-spec-project.ts");await a({sourceDir:l,outDir:`./${l}/.swc/${l}`,ignoredPaths:[`${c}/**`]},{logger:e}),p()};export const generateApplicationSpecProject=async a=>{let{withLingui:c=!0,force:l=!1,analyze:g=!1}=a,u=a.logger;u.info("Using application-spec pipeline");let j=new i,f=j.startSpan("sync","generateApplicationSpecProject","generate-application-spec-project.ts"),w=j.startSpan("build","sync","application-spec-builder.ts"),d=new s({logger:u,sdkVersion:a.sdkVersion,projectSlug:a.projectSlug,environmentSlug:a.environmentSlug,cliUseWorkspace:a.cliUseWorkspace,pageExperience:a.pageExperience,inlineTemplates:a.inlineTemplates??!1}),S=await d.build({force:l,parsingContext:j,compile:!1});if(w(),!S.ok)throw Error(`Failed to build the project files:
+${S.errors.map(e=>`  [${e.code}] ${e.message}`).join("\n")}`);let x=j.startSpan("symlink","sync","generate-application-spec-project.ts");await o("./.phoenix/public")||await e("../public","./.phoenix/public");let b=await n();if(x(),c){let e=j.startSpan("lingui","sync","generate-application-spec-project.ts");await p({logger:u}),e()}else await t(S.application.applicationSpec.configurator.ui.availableLocales,{logger:u});return await m(u,j),f(),g&&r(j.metrics,j.counts,u),{templateFiles:b,applicationSpec:S.application.applicationSpec,diagnostics:S.diagnostics}};

package/dist/phoenix/application-spec/generate-application-spec-story.js

@@ -1,2 +1,2 @@
-import{readFile as e}from"node:fs/promises";import{basename as o,join as r}from"node:path";import{GeneratedApplicationFile as a,RuntimeReferenceStore as i,buildPhoenixDefinitions as t,generateApplicationSpecStoryFiles as n,getStoryTextFiles as p,parseApplicationFiles as s}from"#package/application-spec";import{getAllPhxDefinitions as m}from"#package/domain";import{exists as c,runCommand as g,syncChangedFiles as l,toPascalCase as d}from"../utils/index.js";import{readApplicationFiles as f}from"./application-spec-file-reader.js";import{generateStoryMdxContent as u}from"./story-mdx.js";import{swcEvalExpressionParser as w,swcModuleAnalyzer as x}from"./swc-module-analyzer.js";export const generateApplicationSpecStory=async(y,j)=>{let v=await f({projectRoot:y,envs:{}}),b=p(v),h=t(m()),E=s({rawProjectFiles:v,phxDefinitions:h},{analyzer:x,evalExpressionParser:w,referenceStore:new i,logger:j.logger});if(!E.ok)throw Error(`Cannot build application-spec story because the project spec is invalid. Fix these diagnostics and rebuild:
-${E.errors.map(e=>`  [${e.code}] ${e.message}`).join("\n")}`);let S=o(y),$=d(S),k=n({application:E.value,phxDefinitions:h,rawProjectFiles:v,storyFolderName:S,storyName:$}).map(e=>a(r(y,e.path),e.content,{binary:e.binary,format:e.format})),C=r(y,`${$}.mdx`),L=await c(C)?await e(C,"utf-8"):void 0,q=a(C,u({existingMdx:L,storyName:$,textFiles:b}));await l([...k,q],{logger:j.logger}),await g({command:"npx ",args:["lingui","extract"],description:"Extracting i18n messages",quiet:!0,cwd:y,extraEnv:{LC_ALL:"en_US.UTF-8"}},{logger:j.logger}),await g({command:"npx ",args:["lingui","compile"],description:"Compiling i18n messages",quiet:!0,cwd:y},{logger:j.logger})};
+import{readFile as e}from"node:fs/promises";import{basename as i,join as a}from"node:path";import{GeneratedApplicationFile as o,RuntimeReferenceStore as r,buildPhoenixDefinitions as t,generateApplicationSpecStoryFiles as n,getStoryTextFiles as p,parseApplicationFiles as s}from"#package/application-spec";import{getAllPhxDefinitions as l}from"#package/domain";import{exists as m,runSdkTool as c,syncChangedFiles as g,toPascalCase as d}from"../utils/index.js";import{readApplicationFiles as f}from"./application-spec-file-reader.js";import{generateStoryMdxContent as u}from"./story-mdx.js";import{swcEvalExpressionParser as w,swcModuleAnalyzer as x}from"./swc-module-analyzer.js";export const generateApplicationSpecStory=async(y,b)=>{let j=await f({projectRoot:y,envs:{}}),v=p(j),h=t(l()),k=s({rawProjectFiles:j,phxDefinitions:h},{analyzer:x,evalExpressionParser:w,referenceStore:new r,logger:b.logger});if(!k.ok)throw Error(`Cannot build application-spec story because the project spec is invalid. Fix these diagnostics and rebuild:
+${k.errors.map(e=>`  [${e.code}] ${e.message}`).join("\n")}`);let E=i(y),N=d(E),S=n({application:k.value,phxDefinitions:h,rawProjectFiles:j,storyFolderName:E,storyName:N}).map(e=>o(a(y,e.path),e.content,{binary:e.binary,format:e.format})),$=a(y,`${N}.mdx`),C=await m($)?await e($,"utf-8"):void 0,L=o($,u({existingMdx:C,storyName:N,textFiles:v}));await g([...S,L],{logger:b.logger}),await c({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["extract"],description:"Extracting i18n messages",quiet:!0,cwd:y,extraEnv:{LC_ALL:"en_US.UTF-8"}},{logger:b.logger}),await c({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["compile"],description:"Compiling i18n messages",quiet:!0,cwd:y},{logger:b.logger})};

package/dist/phoenix/application-spec/generate-project-files.d.ts

@@ -1,12 +1,11 @@
+import type { PageExperience } from '#package/application-spec';
 import type { CommandContext } from '../commands/types.js';
 export interface GenerateProjectFilesProps {
     readonly sdkVersion: string;
     readonly projectSlug: string;
     readonly environmentSlug: string;
     readonly cliUseWorkspace?: boolean;
-    readonly name?: string;
-    readonly description?: string;
-    readonly enableEditor?: boolean;
+    readonly pageExperience: PageExperience;
     readonly inlineTemplates?: boolean;
     readonly withLingui?: boolean;
     readonly force?: boolean;
@@ -14,5 +13,6 @@ export interface GenerateProjectFilesProps {
 }
 export declare const generateProjectFiles: (props: GenerateProjectFilesProps, context?: CommandContext) => Promise<{
     templateFiles: readonly string[];
-    applicationSpec: import("../../application-spec/index.js").ApplicationSpec;
+    applicationSpec: import("#package/application-spec").ApplicationSpec;
+    diagnostics: readonly import("#package/application-spec").SpecDiagnostic[];
 }>;

package/dist/phoenix/application-spec/generate-project-files.js

@@ -1 +1 @@
-import{createLogger as e}from"../utils/logger.js";import{generateApplicationSpecProject as r}from"./generate-application-spec-project.js";export const generateProjectFiles=(t,o)=>{let p=o?.logger??e(),{enableEditor:g=!0,inlineTemplates:i=!1,withLingui:l=!0,force:s=!1}=t;return r({...t,enableEditor:g,inlineTemplates:i,withLingui:l,force:s,logger:p})};
+import{createLogger as e}from"../utils/logger.js";import{generateApplicationSpecProject as r}from"./generate-application-spec-project.js";export const generateProjectFiles=(t,o)=>{let p=o?.logger??e(),{inlineTemplates:g=!1,withLingui:i=!0,force:l=!1}=t;return r({...t,inlineTemplates:g,withLingui:i,force:l,logger:p})};

package/dist/phoenix/application-spec/index.d.ts

@@ -4,3 +4,6 @@ export * from './application-spec-file-reader.js';
 export * from './application-spec-builder.js';
 export * from './resolve-deployment-data.js';
 export { generateProjectFiles } from './generate-project-files.js';
+export { logDiagnostics } from './metrics/index.js';
+export { PROJECT_WORKSPACE_ENTRY, isProjectFile, listProjectDocumentEntries, listProjectEntries, listProjectWorkspaceEntries, } from './project-files.js';
+export { readSpecProject } from './read-spec-project.js';

package/dist/phoenix/application-spec/index.js

@@ -1 +1 @@
-export*from"./generate-application-spec-project.js";export*from"./generate-application-spec-story.js";export*from"./application-spec-file-reader.js";export*from"./application-spec-builder.js";export*from"./resolve-deployment-data.js";export{generateProjectFiles}from"./generate-project-files.js";
+export*from"./generate-application-spec-project.js";export*from"./generate-application-spec-story.js";export*from"./application-spec-file-reader.js";export*from"./application-spec-builder.js";export*from"./resolve-deployment-data.js";export{generateProjectFiles}from"./generate-project-files.js";export{logDiagnostics}from"./metrics/index.js";export{PROJECT_WORKSPACE_ENTRY,isProjectFile,listProjectDocumentEntries,listProjectEntries,listProjectWorkspaceEntries}from"./project-files.js";export{readSpecProject}from"./read-spec-project.js";

package/dist/phoenix/application-spec/project-files.d.ts

@@ -1,3 +1,5 @@
+/** Project-owned records, preserved inside the otherwise generated Phoenix directory. */
+export declare const PROJECT_WORKSPACE_ENTRY = "workspace";
 /** The application spec files. */
 export declare const SPEC_FILE_PATTERN = "spec/**/*.yaml";
 /** Files the parse pipeline reads with their content. */
@@ -6,8 +8,8 @@ export declare const PARSED_TEXT_FILE_PATTERNS: string[];
 export declare const PARSED_ASSET_FILE_PATTERNS: string[];
 /**
  * Whether a project-relative, `/`-separated path is a file an application-spec project consists of: what the parse
- * pipeline reads plus what only the build consumes. It is the one definition `phoenix deploy` packs by and
- * `phoenix deployment:extract-sources` filters an uploaded archive by.
+ * pipeline reads plus what only the build consumes. Deployment archives also carry source-only records,
+ * which `phoenix deployment:extract-sources` leaves out of build inputs.
  */
 export declare const isProjectFile: (path: string) => boolean;
 /**
@@ -16,3 +18,7 @@ export declare const isProjectFile: (path: string) => boolean;
  * file standing in its place.
  */
 export declare const listProjectEntries: (projectRoot: string) => Promise<readonly string[]>;
+/** Lists the project's working records and specification sources under `.phoenix/workspace/`. */
+export declare const listProjectWorkspaceEntries: (projectRoot: string) => Promise<readonly string[]>;
+/** Lists the rendered client documents under `docs/`. */
+export declare const listProjectDocumentEntries: (projectRoot: string) => Promise<readonly string[]>;

package/dist/phoenix/application-spec/project-files.js

@@ -1 +1 @@
-import{globby as s}from"globby";import e from"picomatch";export const SPEC_FILE_PATTERN="spec/**/*.yaml";export const PARSED_TEXT_FILE_PATTERNS=["spec/**/*.yaml","src/**/*.{ts,tsx}","mocks/**/*.{yaml,yml}",".gitignore",".cursor/rules/phoenix.mdc","CLAUDE.md","package.json","assets/chat/embeddings.csv","assets/chat/chat.yaml"];export const PARSED_ASSET_FILE_PATTERNS=["assets/private/**","assets/public/**"];let o=[...PARSED_TEXT_FILE_PATTERNS,...PARSED_ASSET_FILE_PATTERNS,"src/**","mocks/**","assets/**","public/**","templates/**","pnpm-lock.yaml","pnpm-workspace.yaml"],t=["**/node_modules/**","**/.phoenix/**","**/__generated/**","**/.DS_Store","**/._*","**/.env","**/.env.*"],c=e(o,{dot:!0,ignore:t});export const isProjectFile=s=>c(s);export const listProjectEntries=async e=>(await s(o,{cwd:e,dot:!0,ignore:t,onlyFiles:!1,followSymbolicLinks:!1})).sort();
+import{globby as o}from"globby";import{lstat as t}from"node:fs/promises";import{join as e}from"node:path";import r from"picomatch";export const PROJECT_WORKSPACE_ENTRY="workspace";export const SPEC_FILE_PATTERN="spec/**/*.yaml";export const PARSED_TEXT_FILE_PATTERNS=["spec/**/*.yaml","src/**/*.{ts,tsx}","mocks/**/*.{yaml,yml}",".gitignore",".cursor/rules/phoenix.mdc","CLAUDE.md","package.json","tsconfig.json","eslint.config.js","prettier.config.js","assets/chat/embeddings.csv","assets/chat/chat.yaml"];export const PARSED_ASSET_FILE_PATTERNS=["assets/private/**","assets/public/**"];let s=[...PARSED_TEXT_FILE_PATTERNS,...PARSED_ASSET_FILE_PATTERNS,"src/**","mocks/**","assets/**","public/**","templates/**","pnpm-lock.yaml","pnpm-workspace.yaml"],c=["**/node_modules/**","**/.phoenix/**","**/__generated/**","**/.DS_Store","**/._*","**/.env","**/.env.*"],i=r(s,{dot:!0,ignore:c});export const isProjectFile=o=>i(o);export const listProjectEntries=async t=>(await o(s,{cwd:t,dot:!0,ignore:c,onlyFiles:!1,followSymbolicLinks:!1})).sort();let n=async(r,s,i)=>{let n=s.split("/");for(let o of n.map((o,t)=>n.slice(0,t+1).join("/")))try{if(!(await t(e(r,o))).isDirectory())throw Error(`Cannot pack ${i}: ${o} is not a regular directory. Replace links or files at that path with a directory before deploying.`)}catch(o){if(o instanceof Error&&"code"in o&&"ENOENT"===o.code)return[];throw o}return(await o("**/*",{cwd:e(r,s),dot:!0,ignore:c,onlyFiles:!1,followSymbolicLinks:!1})).map(o=>`${s}/${o}`).sort()};export const listProjectWorkspaceEntries=o=>n(o,".phoenix/workspace","project workspace records");export const listProjectDocumentEntries=o=>n(o,"docs","project documents");

package/dist/phoenix/application-spec/read-spec-project.d.ts

@@ -1,5 +1,4 @@
 /**
- * Reads `project` from the application spec without parsing the spec: `phoenix dev` needs the project to pick its
- * development environment before anything is generated.
+ * Reads the server project named by the spec for development and deployment targeting.
  */
 export declare const readSpecProject: (projectRoot: string) => Promise<string | undefined>;

package/dist/phoenix/application-spec/read-spec-project.js

@@ -1 +1 @@
-import{readFile as e}from"fs/promises";import{globby as r}from"globby";import{join as o}from"path";import{parse as t}from"yaml";import{SPEC_FILE_PATTERN as i}from"./project-files.js";export const readSpecProject=async p=>{let s=await r(i,{cwd:p}),n=new Map;for(let r of s.sort()){let i;try{i=t(await e(o(p,r),"utf-8"),{merge:!0})}catch(e){throw Error(`phoenix dev could not read \`project\` from the spec because ${r} is not valid YAML: ${e instanceof Error?e.message:String(e)} Fix the file and run phoenix dev again.`)}let s="object"==typeof i&&null!==i?Reflect.get(i,"project"):null;"string"==typeof s&&""!==s.trim()&&n.set(r,s.trim())}if(n.size>1){let e=[...n].map(([e,r])=>`${e} says "${r}"`).join(", ");throw Error(`The spec sets \`project\` in more than one file: ${e}. An application is developed in one server project, so keep \`project\` in one spec file.`)}return n.values().next().value};
+import{readFile as e}from"fs/promises";import{globby as r}from"globby";import{join as t}from"path";import{parse as o}from"yaml";import{SPEC_FILE_PATTERN as i}from"./project-files.js";export const readSpecProject=async s=>{let a=await r(i,{cwd:s}),n=new Map;for(let r of a.sort()){let i;try{i=o(await e(t(s,r),"utf-8"),{merge:!0})}catch(e){throw Error(`Phoenix could not read \`project\` from the spec because ${r} is not valid YAML: ${e instanceof Error?e.message:String(e)} Fix the file and run the command again.`)}let a="object"==typeof i&&null!==i?Reflect.get(i,"project"):null;"string"==typeof a&&""!==a.trim()&&n.set(r,a.trim())}if(n.size>1){let e=[...n].map(([e,r])=>`${e} says "${r}"`).join(", ");throw Error(`The spec sets \`project\` in more than one file: ${e}. An application is developed in one server project, so keep \`project\` in one spec file.`)}return n.values().next().value};

package/dist/phoenix/application-spec/resolve-deployment-data.d.ts

@@ -1,4 +1,5 @@
 import type { DeploymentAssistant } from '@salsita-ai/contracts/assistant';
+import { type ApplicationSpec } from '#package/application-spec';
 import type { Logger } from '../utils/index.js';
 interface ResolveOptions {
     readonly skipUpload: boolean;
@@ -22,6 +23,8 @@ interface DeploymentData {
     readonly assistant: boolean;
     /** Generated locally for prepare-command diagnostics; never sent to the server. */
     readonly assistantSetup: DeploymentAssistant | undefined;
+    /** {@link getDeploymentFingerprint} of the spec the data was resolved from; never sent to the server. */
+    readonly fingerprint: string;
     readonly assets: {
         readonly privateFilePaths: readonly string[];
         readonly publicFilePaths: readonly string[];
@@ -29,6 +32,14 @@ interface DeploymentData {
         readonly publicFilesFullPaths: readonly string[];
     };
 }
+/**
+ * Fingerprint of what the server applies to the requests of a deployment prepared from the spec: the configurator and
+ * admin configuration schemas with their versions, the published data schema, the auth hook, the roles that may
+ * create configurations and the assistant. Preparing a development deployment records it in the generated env file,
+ * and `phoenix dev` prepares again when the spec's fingerprint differs from the recorded one, such as after a domain
+ * model change.
+ */
+export declare const getDeploymentFingerprint: (applicationSpec: ApplicationSpec) => string;
 /** Resolves deployment data using the new application-spec pipeline (parse only, no codegen/write). */
 export declare const resolveApplicationSpecDeploymentData: (options: ResolveOptions) => Promise<DeploymentData>;
 export {};

package/dist/phoenix/application-spec/resolve-deployment-data.js

@@ -1,2 +1,2 @@
-import{RuntimeReferenceStore as e,buildPhoenixDefinitions as a,parseApplicationFiles as s}from"#package/application-spec";import{generateAssistantPrompt as i,getAllPhxDefinitions as t}from"#package/domain";import{readApplicationFiles as o}from"./application-spec-file-reader.js";import{readProjectAssets as r}from"./read-project-assets.js";import{swcEvalExpressionParser as n,swcModuleAnalyzer as l}from"./swc-module-analyzer.js";export const resolveApplicationSpecDeploymentData=async p=>{let{skipUpload:c,logger:m}=p,u=s({rawProjectFiles:await o({envs:{}}),phxDefinitions:a(t())},{analyzer:l,evalExpressionParser:n,referenceStore:new e,logger:m});if(!u.ok)throw Error(`Failed to parse application spec:
-${u.errors.map(e=>`  [${e.code}] ${e.message}`).join("\n")}`);let{configurator:d,admin:h}=u.value.applicationSpec,{configurationSchema:v}=d,f=h.configurationSchema,S=await r(),g=[],F=[],b=[],A=[];c||(g=S.privateAssetFiles,F=S.publicAssetFiles,b=S.privateAssetFilesFullPaths,A=S.publicAssetFilesFullPaths,m.debug(`Scanned assets: ${g.length} private files, ${F.length} public files`));let{appMetadata:j,infra:w}=u.value.applicationSpec,{assistant:k,assistantServerSettings:D}=d;return{schema:{...v.schema},schemaVersion:v.version,adminSchema:{...f.schema},adminSchemaVersion:f.version,applicationVersion:j.applicationVersion,publishedDataHash:d.dataSchemas.publishedDataHash,useAuthHook:j.useAuthHook,aclCanCreate:w.acl.canCreate,embeddings:void 0,chat:void 0,assistant:null!==k&&null!==D,assistantSetup:k&&D?{sdl:k.sdl,prompt:i(k),instructions:D.instructions??void 0,ai:D.ai}:void 0,assets:{privateFilePaths:g,publicFilePaths:F,privateFilesFullPaths:b,publicFilesFullPaths:A}}};
+import{createHash as e}from"node:crypto";import{RuntimeReferenceStore as a,buildPhoenixDefinitions as s,parseApplicationFiles as t}from"#package/application-spec";import{generateAssistantPrompt as i,getAllPhxDefinitions as n}from"#package/domain";import{readApplicationFiles as o}from"./application-spec-file-reader.js";import{readProjectAssets as r}from"./read-project-assets.js";import{swcEvalExpressionParser as c,swcModuleAnalyzer as l}from"./swc-module-analyzer.js";let p=e=>null!==e.assistant&&null!==e.assistantServerSettings;export const getDeploymentFingerprint=a=>{let{configurator:s,admin:t,appMetadata:i,infra:n}=a,o={configurationSchema:[s.configurationSchema.version,s.configurationSchema.hash],adminConfigurationSchema:[t.configurationSchema.version,t.configurationSchema.hash],publishedDataHash:s.dataSchemas.publishedDataHash,useAuthHook:i.useAuthHook,aclCanCreate:n.acl.canCreate,assistant:p(s)};return e("sha256").update(JSON.stringify(o)).digest("hex")};export const resolveApplicationSpecDeploymentData=async e=>{let{skipUpload:h,logger:m}=e,u=t({rawProjectFiles:await o({envs:{}}),phxDefinitions:s(n())},{analyzer:l,evalExpressionParser:c,referenceStore:new a,logger:m});if(!u.ok)throw Error(`Failed to parse application spec:
+${u.errors.map(e=>`  [${e.code}] ${e.message}`).join("\n")}`);let{applicationSpec:d}=u.value,{configurator:g,admin:f}=d,{configurationSchema:S}=g,v=f.configurationSchema,F=await r(),b=[],A=[],D=[],y=[];h||(b=F.privateAssetFiles,A=F.publicAssetFiles,D=F.privateAssetFilesFullPaths,y=F.publicAssetFilesFullPaths,m.debug(`Scanned assets: ${b.length} private files, ${A.length} public files`));let{appMetadata:H,infra:k}=d,{assistant:C,assistantServerSettings:j}=g;return{schema:{...S.schema},schemaVersion:S.version,adminSchema:{...v.schema},adminSchemaVersion:v.version,applicationVersion:H.applicationVersion,publishedDataHash:g.dataSchemas.publishedDataHash,useAuthHook:H.useAuthHook,aclCanCreate:k.acl.canCreate,embeddings:void 0,chat:void 0,assistant:p(g),assistantSetup:C&&j?{sdl:C.sdl,prompt:i(C),instructions:j.instructions??void 0,ai:j.ai}:void 0,fingerprint:getDeploymentFingerprint(d),assets:{privateFilePaths:b,publicFilePaths:A,privateFilesFullPaths:D,publicFilesFullPaths:y}}};

package/dist/phoenix/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/phoenix/bin.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import{assertSupportedNodeVersion as e}from"./utils/node-version/index.js";e(),await import("./cli.js").catch(e=>{throw console.error("If this error comes from loading a dependency, check peerDependencies in the installed @salsita-ai/sdk package.json, align your project's dependencies, reinstall, and retry."),e});

package/dist/phoenix/check-configs/built-in-eslint-config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The ESLint configuration `phoenix check` and `phoenix fix` lint a project with when it has no
+ * `eslint.config.js` of its own: the SDK's shared configuration, the one the `eslint.config.js` that
+ * sync writes re-exports. ESLint loads this module from the SDK's installation through `--config`.
+ *
+ * @module
+ */
+import { eslintrc } from '@salsita-ai/common/eslint';
+export default eslintrc;

package/dist/phoenix/check-configs/built-in-eslint-config.js

@@ -0,0 +1 @@
+import{eslintrc as o}from"@salsita-ai/common/eslint";export default o;

package/dist/phoenix/check-configs/eslint-config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The ESLint arguments that select the configuration. A project with its own `eslint.config.js` is
+ * linted with it, and ESLint finds it without arguments. Any other project is linted with the SDK's
+ * built-in configuration, whose typed rules read the TypeScript configuration the type check uses,
+ * so a project without a root `tsconfig.json` is linted with `.phoenix/tsconfig.json`.
+ *
+ * ESLint is started without a shell, so the path of the built-in configuration reaches it unquoted,
+ * spaces in the installation folder included.
+ */
+export declare const eslintConfigArgs: () => readonly string[];

package/dist/phoenix/check-configs/eslint-config.js

@@ -0,0 +1 @@
+import{existsSync as o}from"fs";import{dirname as t,join as i}from"path";import{fileURLToPath as r}from"url";import{findTypeScriptProject as p}from"./typescript-project.js";let s=i(t(r(import.meta.url)),"../../../dist/phoenix/check-configs/built-in-eslint-config.js");export const eslintConfigArgs=()=>o("eslint.config.js")?[]:["--config",s,"--parser-options",`project:${p()}`];

package/dist/phoenix/check-configs/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The configurations `phoenix check` and `phoenix fix` run TypeScript and ESLint with: the project's
+ * own when it has them, and the SDK's otherwise.
+ *
+ * @module
+ */
+export { eslintConfigArgs } from './eslint-config.js';
+export { findTypeScriptProject } from './typescript-project.js';

package/dist/phoenix/check-configs/index.js

@@ -0,0 +1 @@
+export{eslintConfigArgs}from"./eslint-config.js";export{findTypeScriptProject}from"./typescript-project.js";

package/dist/phoenix/check-configs/typescript-project.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The TypeScript configuration the checks use: the project's root `tsconfig.json` when it has one, and
+ * otherwise the settings sync generates into `.phoenix/tsconfig.json`, which the root file extends.
+ */
+export declare const findTypeScriptProject: () => string;

package/dist/phoenix/check-configs/typescript-project.js

@@ -0,0 +1 @@
+import{existsSync as o}from"fs";export const findTypeScriptProject=()=>o("tsconfig.json")?"tsconfig.json":".phoenix/tsconfig.json";

package/dist/phoenix/cli.d.ts

@@ -1,2 +1 @@
-#!/usr/bin/env node
 export {};