@stacksjs/actions 0.75.557 → 0.75.558

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,5 @@
1
- import{copyFileSync,cpSync,existsSync,mkdirSync,mkdtempSync,readFileSync,rmSync,writeFileSync}from"node:fs";import{tmpdir}from"node:os";import{basename,join,resolve}from"node:path";import process from"node:process";import{log}from"@stacksjs/cli";import{artifactUrlProblem,compareVersions,DEFAULT_UPDATE_PREFIX,describeArtifact,developerIdProblem,loadWebviewDesktop,publishDesktopUpdate,publishedArtifactUrl,releaseArtifactNames,releaseVersionProblem,resolveDmgPackaging,splitDesktopTarget,storageUpdateStore,updateArtifactKey,updateManifestKey,updatePublicKey,validateUpdateManifest}from"@stacksjs/desktop-build";import{projectPath}from"@stacksjs/path";import{imageDmg,notarizeAndStaple,notaryArguments}from"./notarize";process.exitCode=1;const root=projectPath();const pkg=existsSync(join(root,"package.json"))?JSON.parse(readFileSync(join(root,"package.json"),"utf8")):{};const config=await loadWebviewDesktop(root,pkg.version);if(!config)throw new Error("config/desktop.ts has no webview section.");if(!config.updates)throw new Error("config/desktop.ts has no webview.updates: a release needs the feed URL and the public keys the app trusts.");const dryRun=process.env.DESKTOP_RELEASE_DRY_RUN==="1";const updates=config.updates;const channel=process.env.DESKTOP_RELEASE_CHANNEL||config.updates.channel||"stable";const prefix=config.updates.prefix??DEFAULT_UPDATE_PREFIX;const output=resolve(root,config.output);const releaseDir=join(output,"release");const buildFile=join(output,"build.json");if(!existsSync(buildFile))throw new Error("Nothing was built. Run `buddy build:desktop` first, or drop --skip-build.");const build=JSON.parse(readFileSync(buildFile,"utf8"));if(build.version!==config.version)throw new Error(`The build is ${build.version} but the config says ${config.version}. Build again.`);if(!build.sourceRevision||!/^[0-9a-f]{40}$/.test(build.sourceRevision))throw new Error("A release names the commit it was built from, and this build has none. Build from a Git checkout.");const sourceRevision=build.sourceRevision;const dirty=Bun.spawnSync(["git","status","--porcelain"],{cwd:root,stdout:"pipe"}).stdout.toString().trim();const head=Bun.spawnSync(["git","rev-parse","HEAD"],{cwd:root,stdout:"pipe"}).stdout.toString().trim();if(process.env.DESKTOP_RELEASE_ALLOW_DIRTY!=="1"){if(dirty)throw new Error(`The working tree is not clean, and the build came out of it. Commit these first:
2
- ${dirty}`);if(head!==sourceRevision)throw new Error(`The build is from ${sourceRevision.slice(0,12)} but HEAD is ${head.slice(0,12)}. Build again.`)}const privateKey=process.env.DESKTOP_UPDATE_PRIVATE_KEY;if(!privateKey)throw new Error("DESKTOP_UPDATE_PRIVATE_KEY is not set. It is the private half `buddy desktop:update:keypair` printed.");const publicKey=updatePublicKey(privateKey);const keyId=Object.entries(config.updates.publicKeys).find(([,key])=>key===publicKey)?.[0];if(!keyId)throw new Error("DESKTOP_UPDATE_PRIVATE_KEY does not match any key in webview.updates.publicKeys: installed apps would refuse what it signs.");const notes=process.env.DESKTOP_RELEASE_NOTES?readFileSync(resolve(root,process.env.DESKTOP_RELEASE_NOTES),"utf8").trim():undefined;const{signingIdentity,notary}=resolveDmgPackaging({flags:{},env:process.env});const store=dryRun?{read:async()=>null,write:async()=>{},publicUrl:async(key)=>`https://dry-run.invalid/${key}`}:await storageUpdateStore(config.updates.disk);const artifactUrl=(location,file)=>publishedArtifactUrl({store,artifactBaseUrl:updates.artifactBaseUrl,feedUrl:updates.feedUrl,...location},config.version,basename(file));const planned=[];for(const item of build.targets){const{platform,architecture}=splitDesktopTarget(item.target);const directory=join(output,item.directory);const names=releaseArtifactNames(config,item.target);const staged=join(releaseDir,item.target);const location={platform,architecture,channel,prefix};const existing=await store.read(updateManifestKey(location));const unreachable=artifactUrlProblem(await artifactUrl(location,names.update));if(unreachable&&process.env.DESKTOP_RELEASE_ALLOW_LOCAL_URL!=="1"){throw new Error(`${item.target}: ${unreachable}. Set webview.updates.${updates.artifactBaseUrl?"artifactBaseUrl":"feedUrl"} to the address the app is served from.`)}const problem=releaseVersionProblem(config.version,existing?validateUpdateManifest(JSON.parse(existing)).version:null,compareVersions);if(problem)throw new Error(`${item.target}: ${problem}`);if(platform==="darwin"){const app=join(directory,`${config.appName}.app`);if(process.platform!=="darwin"||!existsSync(app))throw new Error(`${item.target}: the .app is signed and notarized on macOS. Run this release on a Mac.`);if(!dryRun){if(!signingIdentity||!notary)throw new Error(`${item.target}: a release needs a Developer ID identity and notary credentials: --identity and --notary-profile (or DESKTOP_SIGNING_IDENTITY / DESKTOP_NOTARY_PROFILE).`);const signature=Bun.spawnSync(["codesign","-dvv",app],{stderr:"pipe"});const unsigned=developerIdProblem(`${signature.stdout.toString()}${signature.stderr.toString()}`);if(unsigned)throw new Error(`${item.target}: ${app} cannot be notarized: ${unsigned}`)}const dmg=join(staged,names.downloads[0]);planned.push({target:item.target,directory:staged,update:join(staged,names.update),downloads:[dmg],prepare:async()=>{const scratch=mkdtempSync(join(tmpdir(),"stacks-desktop-release-"));try{const auth=!dryRun&&notary?notaryArguments(notary):undefined;if(auth)await notarizeAndStaple(app,`${config.appName}.app`,auth,scratch);run(["ditto","-c","-k","--keepParent",app,join(staged,names.update)]);const staging=join(scratch,"dmg");mkdirSync(staging,{recursive:true});cpSync(app,join(staging,`${config.appName}.app`),{recursive:true,verbatimSymlinks:true});await imageDmg({staging,volumeName:config.appName,dmgPath:dmg,...dryRun?{}:{signingIdentity}});if(auth){await notarizeAndStaple(dmg,"the DMG",auth,scratch);run(["codesign","--verify","--deep","--strict",app]);run(["spctl","-a","-t","open","--context","context:primary-signature",dmg]);run(["xcrun","stapler","validate",dmg])}}finally{rmSync(scratch,{recursive:true,force:true})}}});continue}const packages=join(directory,"packages");const made=item.artifacts.map((artifact)=>join(directory,artifact.name));const find=(extension)=>made.find((file)=>file.toLowerCase().endsWith(extension)&&existsSync(file));const wanted=platform==="win32"?".msi":".appimage";const installer=find(wanted);if(!installer){throw new Error(`${item.target}: there is no ${platform==="win32"?"MSI":"AppImage"} in ${packages}. Run \`buddy build:desktop --target ${item.target} --package\` on ${platform==="win32"?"Windows":"Linux"}, then release with --skip-build.`)}const extras=platform==="linux"?[".deb",".rpm"].map(find).filter((file)=>Boolean(file)):[];planned.push({target:item.target,directory:staged,update:join(staged,names.update),downloads:extras.map((file,index)=>join(staged,names.downloads[index]??basename(file))),prepare:async()=>{copyFileSync(installer,join(staged,names.update));extras.forEach((file,index)=>copyFileSync(file,join(staged,names.downloads[index]??basename(file))))}})}if(!planned.length)throw new Error("The build has no targets to release.");function run(command){console.log(`> ${command.join(" ")}`);const result=Bun.spawnSync(command,{stdout:"inherit",stderr:"inherit"});if(result.exitCode!==0)throw new Error(`${command[0]} exited with ${result.exitCode}`)}rmSync(releaseDir,{recursive:true,force:true});for(const item of planned){mkdirSync(item.directory,{recursive:true});await log.info(`Preparing ${item.target}`);await item.prepare()}const published=[];for(const item of planned){const{platform,architecture}=splitDesktopTarget(item.target);const location={platform,architecture,channel,prefix};const downloads=[];for(const file of item.downloads){const key=updateArtifactKey(location,config.version,basename(file));await store.write(key,readFileSync(file));const{sha256,size}=await describeArtifact(file);downloads.push({name:basename(file),url:await artifactUrl(location,file),sha256,bytes:size})}const manifest=await publishDesktopUpdate({store,artifact:item.update,version:config.version,sourceRevision,privateKey,keyId,notes,artifactBaseUrl:updates.artifactBaseUrl,feedUrl:updates.feedUrl,...location});writeFileSync(join(item.directory,"latest.json"),`${JSON.stringify(manifest,null,2)}
3
- `);published.push({target:item.target,manifest,downloads});await log.success(`${item.target}: ${dryRun?"would publish":"published"} ${basename(item.update)} (${manifest.size} bytes, sha256 ${manifest.sha256})`)}const summary={version:config.version,channel,sourceRevision,publishedAt:new Date().toISOString(),targets:published.map((item)=>({target:item.target,update:{url:item.manifest.url,sha256:item.manifest.sha256,bytes:item.manifest.size},downloads:item.downloads}))};writeFileSync(join(releaseDir,"release.json"),`${JSON.stringify(summary,null,2)}
4
- `);if(!dryRun)await store.write(`${prefix}/${channel}/release.json`,`${JSON.stringify(summary,null,2)}
1
+ import{copyFileSync,cpSync,existsSync,mkdirSync,mkdtempSync,readFileSync,rmSync,writeFileSync}from"node:fs";import{tmpdir}from"node:os";import{basename,join,resolve}from"node:path";import process from"node:process";import{log}from"@stacksjs/cli";import{artifactUrlProblem,compareVersions,DEFAULT_UPDATE_PREFIX,describeArtifact,developerIdProblem,loadWebviewDesktop,mergeReleaseRecord,publishDesktopUpdate,publishedArtifactUrl,releaseArtifactNames,releaseRecordKey,releaseVersionProblem,resolveDmgPackaging,splitDesktopTarget,storageUpdateStore,updateArtifactKey,updateManifestKey,updatePublicKey,validateUpdateManifest}from"@stacksjs/desktop-build";import{projectPath}from"@stacksjs/path";import{imageDmg,notarizeAndStaple,notaryArguments}from"./notarize";process.exitCode=1;const root=projectPath();const pkg=existsSync(join(root,"package.json"))?JSON.parse(readFileSync(join(root,"package.json"),"utf8")):{};const config=await loadWebviewDesktop(root,pkg.version);if(!config)throw new Error("config/desktop.ts has no webview section.");if(!config.updates)throw new Error("config/desktop.ts has no webview.updates: a release needs the feed URL and the public keys the app trusts.");const dryRun=process.env.DESKTOP_RELEASE_DRY_RUN==="1";const updates=config.updates;const channel=process.env.DESKTOP_RELEASE_CHANNEL||config.updates.channel||"stable";const prefix=config.updates.prefix??DEFAULT_UPDATE_PREFIX;const output=resolve(root,config.output);const releaseDir=join(output,"release");const buildFile=join(output,"build.json");if(!existsSync(buildFile))throw new Error("Nothing was built. Run `buddy build:desktop` first, or drop --skip-build.");const build=JSON.parse(readFileSync(buildFile,"utf8"));if(build.version!==config.version)throw new Error(`The build is ${build.version} but the config says ${config.version}. Build again.`);if(!build.sourceRevision||!/^[0-9a-f]{40}$/.test(build.sourceRevision))throw new Error("A release names the commit it was built from, and this build has none. Build from a Git checkout.");const sourceRevision=build.sourceRevision;const dirty=Bun.spawnSync(["git","status","--porcelain"],{cwd:root,stdout:"pipe"}).stdout.toString().trim();const head=Bun.spawnSync(["git","rev-parse","HEAD"],{cwd:root,stdout:"pipe"}).stdout.toString().trim();if(process.env.DESKTOP_RELEASE_ALLOW_DIRTY!=="1"){if(dirty)throw new Error(`The working tree is not clean, and the build came out of it. Commit these first:
2
+ ${dirty}`);if(head!==sourceRevision)throw new Error(`The build is from ${sourceRevision.slice(0,12)} but HEAD is ${head.slice(0,12)}. Build again.`)}const privateKey=process.env.DESKTOP_UPDATE_PRIVATE_KEY;if(!privateKey)throw new Error("DESKTOP_UPDATE_PRIVATE_KEY is not set. It is the private half `buddy desktop:update:keypair` printed.");const publicKey=updatePublicKey(privateKey);const keyId=Object.entries(config.updates.publicKeys).find(([,key])=>key===publicKey)?.[0];if(!keyId)throw new Error("DESKTOP_UPDATE_PRIVATE_KEY does not match any key in webview.updates.publicKeys: installed apps would refuse what it signs.");const notes=process.env.DESKTOP_RELEASE_NOTES?readFileSync(resolve(root,process.env.DESKTOP_RELEASE_NOTES),"utf8").trim():undefined;const{signingIdentity,notary}=resolveDmgPackaging({flags:{},env:process.env});const store=dryRun?{read:async()=>null,write:async()=>{},publicUrl:async(key)=>`https://dry-run.invalid/${key}`}:await storageUpdateStore(config.updates.disk);const artifactUrl=(location,file)=>publishedArtifactUrl({store,artifactBaseUrl:updates.artifactBaseUrl,feedUrl:updates.feedUrl,...location},config.version,basename(file));const planned=[];for(const item of build.targets){const{platform,architecture}=splitDesktopTarget(item.target);const directory=join(output,item.directory);const names=releaseArtifactNames(config,item.target);const staged=join(releaseDir,item.target);const location={platform,architecture,channel,prefix};const existing=await store.read(updateManifestKey(location));const unreachable=artifactUrlProblem(await artifactUrl(location,names.update));if(unreachable&&process.env.DESKTOP_RELEASE_ALLOW_LOCAL_URL!=="1"){throw new Error(`${item.target}: ${unreachable}. Set webview.updates.${updates.artifactBaseUrl?"artifactBaseUrl":"feedUrl"} to the address the app is served from.`)}const problem=releaseVersionProblem(config.version,existing?validateUpdateManifest(JSON.parse(existing)).version:null,compareVersions);if(problem)throw new Error(`${item.target}: ${problem}`);if(platform==="darwin"){const app=join(directory,`${config.appName}.app`);if(process.platform!=="darwin"||!existsSync(app))throw new Error(`${item.target}: the .app is signed and notarized on macOS. Run this release on a Mac.`);if(!dryRun){if(!signingIdentity||!notary)throw new Error(`${item.target}: a release needs a Developer ID identity and notary credentials: --identity and --notary-profile (or DESKTOP_SIGNING_IDENTITY / DESKTOP_NOTARY_PROFILE).`);const signature=Bun.spawnSync(["codesign","-dvv",app],{stderr:"pipe"});const unsigned=developerIdProblem(`${signature.stdout.toString()}${signature.stderr.toString()}`);if(unsigned)throw new Error(`${item.target}: ${app} cannot be notarized: ${unsigned}`)}const dmg=join(staged,names.downloads[0]);planned.push({target:item.target,directory:staged,update:join(staged,names.update),downloads:[dmg],prepare:async()=>{const scratch=mkdtempSync(join(tmpdir(),"stacks-desktop-release-"));try{const auth=!dryRun&&notary?notaryArguments(notary):undefined;if(auth)await notarizeAndStaple(app,`${config.appName}.app`,auth,scratch);run(["ditto","-c","-k","--keepParent",app,join(staged,names.update)]);const staging=join(scratch,"dmg");mkdirSync(staging,{recursive:true});cpSync(app,join(staging,`${config.appName}.app`),{recursive:true,verbatimSymlinks:true});await imageDmg({staging,volumeName:config.appName,dmgPath:dmg,...dryRun?{}:{signingIdentity}});if(auth){await notarizeAndStaple(dmg,"the DMG",auth,scratch);run(["codesign","--verify","--deep","--strict",app]);run(["spctl","-a","-t","open","--context","context:primary-signature",dmg]);run(["xcrun","stapler","validate",dmg])}}finally{rmSync(scratch,{recursive:true,force:true})}}});continue}const packages=join(directory,"packages");const made=item.artifacts.map((artifact)=>join(directory,artifact.name));const find=(extension)=>made.find((file)=>file.toLowerCase().endsWith(extension)&&existsSync(file));const wanted=platform==="win32"?".msi":".appimage";const installer=find(wanted);if(!installer){throw new Error(`${item.target}: there is no ${platform==="win32"?"MSI":"AppImage"} in ${packages}. Run \`buddy build:desktop --target ${item.target} --package\` on ${platform==="win32"?"Windows":"Linux"}, then release with --skip-build.`)}const extras=platform==="linux"?[".deb",".rpm"].map(find).filter((file)=>Boolean(file)):[];planned.push({target:item.target,directory:staged,update:join(staged,names.update),downloads:extras.map((file,index)=>join(staged,names.downloads[index]??basename(file))),prepare:async()=>{copyFileSync(installer,join(staged,names.update));extras.forEach((file,index)=>copyFileSync(file,join(staged,names.downloads[index]??basename(file))))}})}if(!planned.length)throw new Error("The build has no targets to release.");function run(command){console.log(`> ${command.join(" ")}`);const result=Bun.spawnSync(command,{stdout:"inherit",stderr:"inherit"});if(result.exitCode!==0)throw new Error(`${command[0]} exited with ${result.exitCode}`)}for(const item of planned){rmSync(item.directory,{recursive:true,force:true});mkdirSync(item.directory,{recursive:true});await log.info(`Preparing ${item.target}`);await item.prepare()}const published=[];for(const item of planned){const{platform,architecture}=splitDesktopTarget(item.target);const location={platform,architecture,channel,prefix};const downloads=[];for(const file of item.downloads){const key=updateArtifactKey(location,config.version,basename(file));await store.write(key,readFileSync(file));const{sha256,size}=await describeArtifact(file);downloads.push({name:basename(file),url:await artifactUrl(location,file),sha256,bytes:size})}const manifest=await publishDesktopUpdate({store,artifact:item.update,version:config.version,sourceRevision,privateKey,keyId,notes,artifactBaseUrl:updates.artifactBaseUrl,feedUrl:updates.feedUrl,...location});writeFileSync(join(item.directory,"latest.json"),`${JSON.stringify(manifest,null,2)}
3
+ `);published.push({target:item.target,manifest,downloads});await log.success(`${item.target}: ${dryRun?"would publish":"published"} ${basename(item.update)} (${manifest.size} bytes, sha256 ${manifest.sha256})`)}const thisRun={version:config.version,channel,sourceRevision,publishedAt:new Date().toISOString(),targets:published.map((item)=>({target:item.target,update:{url:item.manifest.url,sha256:item.manifest.sha256,bytes:item.manifest.size},downloads:item.downloads}))};const recordKey=releaseRecordKey({channel,prefix});const localRecord=join(releaseDir,"release.json");const stored=dryRun?existsSync(localRecord)?readFileSync(localRecord,"utf8"):null:await store.read(recordKey);const summary=mergeReleaseRecord(stored,thisRun);mkdirSync(releaseDir,{recursive:true});writeFileSync(localRecord,`${JSON.stringify(summary,null,2)}
4
+ `);if(!dryRun)await store.write(recordKey,`${JSON.stringify(summary,null,2)}
5
5
  `);await log.success(dryRun?`Dry run: nothing was notarized or uploaded. See ${releaseDir}`:`Released ${config.appName} ${config.version} on ${channel} for ${published.map((item)=>item.target).join(", ")}`);process.exitCode=0;
@@ -1,6 +1,6 @@
1
- import{createHash}from"node:crypto";import{chmodSync,copyFileSync,existsSync,mkdirSync,readFileSync,rmSync,writeFileSync}from"node:fs";import{basename,join,relative,resolve}from"node:path";import process from"node:process";import{log}from"@stacksjs/cli";import{assembleWebviewMacosApp,collectViewFiles,findDevelopmentIdentity,hostDesktopTarget,loadWebviewDesktop,nativeBuildSteps,parseDesktopTargets,probeCraftFlags,renderViewsBuildScript,renderWebviewEntry,resolveCraftExecutable,resolveWebviewComponents,signtoolArgs,splitDesktopTarget,validateWebviewDesktop,webviewAgentEntry,webviewCompileArgs,webviewManifest,webviewPackageConfig,webviewRuntimeFor}from"@stacksjs/desktop-build";import{projectPath}from"@stacksjs/path";process.exitCode=1;const root=projectPath();const pkg=existsSync(join(root,"package.json"))?JSON.parse(readFileSync(join(root,"package.json"),"utf8")):{};const config=await loadWebviewDesktop(root,pkg.version);if(!config)throw new Error("config/desktop.ts has no webview section.");const problems=validateWebviewDesktop(config);if(problems.length)throw new Error(`config/desktop.ts cannot build:
1
+ import{createHash}from"node:crypto";import{chmodSync,copyFileSync,existsSync,mkdirSync,readFileSync,rmSync,writeFileSync}from"node:fs";import{basename,join,relative,resolve}from"node:path";import process from"node:process";import{log}from"@stacksjs/cli";import{assembleWebviewMacosApp,collectViewFiles,configuredWebviewRuntime,fetchCraftRuntime,findDevelopmentIdentity,hostDesktopTarget,installedCraftVersion,loadWebviewDesktop,nativeBuildSteps,parseDesktopTargets,probeCraftFlags,renderViewsBuildScript,renderWebviewEntry,resolveCraftExecutable,resolveWebviewComponents,signtoolArgs,splitDesktopTarget,validateWebviewDesktop,webviewAgentEntry,webviewCompileArgs,webviewManifest,webviewPackageConfig,webviewRuntimeFor,windowsRuntimeCompanions}from"@stacksjs/desktop-build";import{projectPath}from"@stacksjs/path";process.exitCode=1;const root=projectPath();const pkg=existsSync(join(root,"package.json"))?JSON.parse(readFileSync(join(root,"package.json"),"utf8")):{};const config=await loadWebviewDesktop(root,pkg.version);if(!config)throw new Error("config/desktop.ts has no webview section.");const problems=validateWebviewDesktop(config);if(problems.length)throw new Error(`config/desktop.ts cannot build:
2
2
  ${problems.map((problem)=>` - ${problem}`).join(`
3
3
  `)}`);const host=hostDesktopTarget();const output=resolve(root,config.output);const work=join(output,".build");mkdirSync(work,{recursive:true});const agentEntry=webviewAgentEntry(root,config.agent.entry);const viewsDir=resolve(root,config.agent.views);const hostRuntime=()=>resolveCraftExecutable();if(process.env.STACKS_DESKTOP_LAUNCH==="1"){const entry=join(work,"dev-entry.ts");const devRuntime=webviewRuntimeFor(config,host,{root,hostRuntime});writeFileSync(entry,renderWebviewEntry({manifest:webviewManifest(config,{runtime:devRuntime,runtimeFlags:probeCraftFlags(devRuntime),development:true}),agentEntry,...existsSync(viewsDir)?{stxViews:{dir:viewsDir,root,...config.agent.components?.length?{components:resolveWebviewComponents(root,config.agent.components)}:{}}}:{}}));await log.info(`Starting ${config.appName} (Ctrl-C quits)`);const child=Bun.spawn(["bun",entry,...process.argv.slice(2).filter((arg)=>!arg.startsWith("-"))],{cwd:root,stdio:["inherit","inherit","inherit"]});for(const signal of["SIGINT","SIGTERM"])process.on(signal,()=>child.kill(signal));process.exitCode=await child.exited;process.exit()}const targets=parseDesktopTargets(process.env.DESKTOP_TARGETS,host);const revision=Bun.spawnSync(["git","rev-parse","HEAD"],{cwd:root,stdout:"pipe",stderr:"ignore"});const sourceRevision=revision.exitCode===0?revision.stdout.toString().trim():undefined;function run(command,describe){const result=Bun.spawnSync(command,{cwd:root,stdout:"pipe",stderr:"pipe"});if(result.exitCode!==0)throw new Error(`${describe} failed:
4
- ${result.stderr.toString().trim()||result.stdout.toString().trim()}`)}const builtViews=join(work,"views");if(existsSync(viewsDir)){rmSync(builtViews,{recursive:true,force:true});const own=join(root,"app/Desktop/build-views.ts");if(existsSync(own)){const built=Bun.spawnSync(["bun",own],{cwd:root,env:{...process.env,DESKTOP_VIEWS_OUT:builtViews},stdio:["ignore","inherit","inherit"]});if(built.exitCode!==0)throw new Error("app/Desktop/build-views.ts failed")}else{const script=join(work,"build-views.ts");writeFileSync(script,renderViewsBuildScript({appName:config.appName,root,viewsDir,outDir:builtViews,components:config.agent.components}));const built=Bun.spawnSync(["bun",script],{cwd:root,stdio:["ignore","inherit","inherit"]});if(built.exitCode!==0)throw new Error(`Building the views in ${config.agent.views} failed`)}}const viewFiles=collectViewFiles(builtViews);if(!viewFiles["/index.html"]&&!agentEntry)throw new Error(`Nothing for the window to open: ${config.agent.views} has no index.stx, and there is no agent module to answer /.`);await log.info(`Built ${Object.keys(viewFiles).length} view file(s) from ${config.agent.views}`);const built=[];for(const target of targets){const{platform}=splitDesktopTarget(target);const directory=join(output,target);rmSync(directory,{recursive:true,force:true});mkdirSync(directory,{recursive:true});const runtime=webviewRuntimeFor(config,target,{root,hostRuntime});if(readFileSync(runtime).subarray(0,2).toString()==="#!")throw new Error(`The Craft runtime for ${target} is a script, not a native binary: ${runtime}`);const embedded=platform==="linux";const entry=join(work,`entry-${target}.ts`);writeFileSync(entry,renderWebviewEntry({manifest:webviewManifest(config,{runtime:embedded?"embedded":"beside",runtimeFlags:probeCraftFlags(runtime),sourceRevision}),agentEntry,viewFiles,...embedded?{embeddedRuntime:runtime}:{}}));const agent=join(work,platform==="win32"?`agent-${target}.exe`:`agent-${target}`);await log.info(`Compiling the agent for ${target}${target===host?"":" (cross-compiled by Bun)"}`);run(["bun",...webviewCompileArgs({entry,outfile:agent,target,host,minify:process.env.DESKTOP_MINIFY!=="false"})],`Compiling the agent for ${target}`);if(platform==="darwin"){if(process.platform!=="darwin"){copyFileSync(agent,join(directory,config.executable));copyFileSync(runtime,join(directory,"craft-runtime"));built.push({target,directory,artifacts:[config.executable,"craft-runtime"],remaining:nativeBuildSteps(target)});continue}const identity=process.env.DESKTOP_SIGNING_IDENTITY||findDevelopmentIdentity()||"-";const assembled=assembleWebviewMacosApp({config,root,agent,runtime,output:directory,signingIdentity:identity});for(const key of assembled.ignoredPlistKeys)await log.warn(`webview.macos.infoPlist: ${key} is set by the build and was ignored`);built.push({target,directory,artifacts:[basename(assembled.appPath)],...identity==="-"?{remaining:"Signed ad hoc: it runs on this Mac only. `buddy release:desktop` signs with a Developer ID and notarizes."}:{}});continue}const packages=join(directory,"packages");const icon=config.icon?resolve(root,config.icon):undefined;let packageConfig;const artifacts=[];if(platform==="win32"){const binary=join(directory,`${config.executable}.exe`);copyFileSync(agent,binary);const companions=[join(directory,"craft-runtime.exe")];copyFileSync(runtime,companions[0]);for(const file of config.windows?.additionalFiles??[]){const from=resolve(root,file);if(!existsSync(from))throw new Error(`webview.windows.additionalFiles: ${from} does not exist`);companions.push(join(directory,basename(from)));copyFileSync(from,companions.at(-1))}artifacts.push(basename(binary),...companions.map((file)=>basename(file)));packageConfig=webviewPackageConfig(config,target,{binary,additionalFiles:companions,outDir:packages,icon})}else{const binary=join(directory,config.slug);copyFileSync(agent,binary);chmodSync(binary,493);artifacts.push(basename(binary));packageConfig=webviewPackageConfig(config,target,{binary,outDir:packages,icon})}if(icon)copyFileSync(icon,join(directory,basename(icon)));writeFileSync(join(directory,"craft-package.json"),`${JSON.stringify(packageConfig,(_key,value)=>typeof value==="string"&&value.startsWith(`${directory}/`)?`./${relative(directory,value)}`:value===icon&&icon?`./${basename(icon)}`:value,2)}
4
+ ${result.stderr.toString().trim()||result.stdout.toString().trim()}`)}const builtViews=join(work,"views");if(existsSync(viewsDir)){rmSync(builtViews,{recursive:true,force:true});const own=join(root,"app/Desktop/build-views.ts");if(existsSync(own)){const built=Bun.spawnSync(["bun",own],{cwd:root,env:{...process.env,DESKTOP_VIEWS_OUT:builtViews},stdio:["ignore","inherit","inherit"]});if(built.exitCode!==0)throw new Error("app/Desktop/build-views.ts failed")}else{const script=join(work,"build-views.ts");writeFileSync(script,renderViewsBuildScript({appName:config.appName,root,viewsDir,outDir:builtViews,components:config.agent.components}));const built=Bun.spawnSync(["bun",script],{cwd:root,stdio:["ignore","inherit","inherit"]});if(built.exitCode!==0)throw new Error(`Building the views in ${config.agent.views} failed`)}}const viewFiles=collectViewFiles(builtViews);if(!viewFiles["/index.html"]&&!agentEntry)throw new Error(`Nothing for the window to open: ${config.agent.views} has no index.stx, and there is no agent module to answer /.`);await log.info(`Built ${Object.keys(viewFiles).length} view file(s) from ${config.agent.views}`);const built=[];async function runtimeFor(target){const configured=configuredWebviewRuntime(config,target,{root,hostRuntime});if(configured)return configured;const version=installedCraftVersion(root);if(process.env.DESKTOP_RUNTIME_FETCH==="0"||!version)return webviewRuntimeFor(config,target,{root,hostRuntime});const fetched=await fetchCraftRuntime({target,version,directory:join(root,"storage/framework/desktop/runtimes",target),onFetch:(url)=>{log.info(`Fetching ${url}`)}});if(fetched.fetched)await log.info(`Craft ${fetched.version} runtime for ${target}: ${relative(root,fetched.binary)}`);return fetched.binary}for(const target of targets){const{platform}=splitDesktopTarget(target);const directory=join(output,target);rmSync(directory,{recursive:true,force:true});mkdirSync(directory,{recursive:true});const runtime=await runtimeFor(target);if(readFileSync(runtime).subarray(0,2).toString()==="#!")throw new Error(`The Craft runtime for ${target} is a script, not a native binary: ${runtime}`);const embedded=platform==="linux";const entry=join(work,`entry-${target}.ts`);writeFileSync(entry,renderWebviewEntry({manifest:webviewManifest(config,{runtime:embedded?"embedded":"beside",runtimeFlags:probeCraftFlags(runtime),sourceRevision}),agentEntry,viewFiles,...embedded?{embeddedRuntime:runtime}:{}}));const agent=join(work,platform==="win32"?`agent-${target}.exe`:`agent-${target}`);await log.info(`Compiling the agent for ${target}${target===host?"":" (cross-compiled by Bun)"}`);run(["bun",...webviewCompileArgs({entry,outfile:agent,target,host,minify:process.env.DESKTOP_MINIFY!=="false"})],`Compiling the agent for ${target}`);if(platform==="darwin"){if(process.platform!=="darwin"){copyFileSync(agent,join(directory,config.executable));copyFileSync(runtime,join(directory,"craft-runtime"));built.push({target,directory,artifacts:[config.executable,"craft-runtime"],remaining:nativeBuildSteps(target)});continue}const identity=process.env.DESKTOP_SIGNING_IDENTITY||findDevelopmentIdentity()||"-";const assembled=assembleWebviewMacosApp({config,root,agent,runtime,output:directory,signingIdentity:identity});for(const key of assembled.ignoredPlistKeys)await log.warn(`webview.macos.infoPlist: ${key} is set by the build and was ignored`);built.push({target,directory,artifacts:[basename(assembled.appPath)],...identity==="-"?{remaining:"Signed ad hoc: it runs on this Mac only. `buddy release:desktop` signs with a Developer ID and notarizes."}:{}});continue}const packages=join(directory,"packages");const icon=config.icon?resolve(root,config.icon):undefined;let packageConfig;const artifacts=[];if(platform==="win32"){const binary=join(directory,`${config.executable}.exe`);copyFileSync(agent,binary);const companions=[join(directory,"craft-runtime.exe")];copyFileSync(runtime,companions[0]);for(const file of config.windows?.additionalFiles??[]){const from=resolve(root,file);if(!existsSync(from))throw new Error(`webview.windows.additionalFiles: ${from} does not exist`);companions.push(join(directory,basename(from)));copyFileSync(from,companions.at(-1))}for(const from of windowsRuntimeCompanions(runtime,config.windows?.additionalFiles)){companions.push(join(directory,basename(from)));copyFileSync(from,companions.at(-1))}artifacts.push(basename(binary),...companions.map((file)=>basename(file)));packageConfig=webviewPackageConfig(config,target,{binary,additionalFiles:companions,outDir:packages,icon})}else{const binary=join(directory,config.slug);copyFileSync(agent,binary);chmodSync(binary,493);artifacts.push(basename(binary));packageConfig=webviewPackageConfig(config,target,{binary,outDir:packages,icon})}if(icon)copyFileSync(icon,join(directory,basename(icon)));writeFileSync(join(directory,"craft-package.json"),`${JSON.stringify(packageConfig,(_key,value)=>typeof value==="string"&&value.startsWith(`${directory}/`)?`./${relative(directory,value)}`:value===icon&&icon?`./${basename(icon)}`:value,2)}
5
5
  `);artifacts.push("craft-package.json");const canPackage=process.platform===platform;if(process.env.DESKTOP_PACKAGE==="1"&&canPackage){const{packageApp}=await import("craft-native");const windows=packageConfig.windows;if(typeof windows?.certificatePath==="string"){const certificatePassword=process.env.DESKTOP_WINDOWS_CERTIFICATE_PASSWORD;if(certificatePassword)windows.certificatePassword=certificatePassword;for(const name of artifacts.filter((file)=>file.endsWith(".exe")))run(signtoolArgs({file:join(directory,name),certificatePath:resolve(root,windows.certificatePath),certificatePassword}),`Signing ${name}`)}for(const result of await packageApp(packageConfig)){if(!result.success)throw new Error(`Packaging ${result.format} for ${target} failed: ${result.error}`);if(result.outputPath)artifacts.push(relative(directory,result.outputPath))}built.push({target,directory,artifacts})}else{built.push({target,directory,artifacts,remaining:canPackage?"Pass --package to make the installers from craft-package.json.":nativeBuildSteps(target)})}}writeFileSync(join(output,"build.json"),`${JSON.stringify({appName:config.appName,appId:config.appId,version:config.version,sourceRevision:sourceRevision??null,builtOn:host,bun:Bun.version,targets:built.map((item)=>({target:item.target,directory:relative(output,item.directory),artifacts:item.artifacts.map((name)=>{const file=join(item.directory,name);return name.endsWith(".app")?{name}:{name,bytes:readFileSync(file).byteLength,sha256:createHash("sha256").update(readFileSync(file)).digest("hex")}}),...item.remaining?{remaining:item.remaining}:{}}))},null,2)}
6
6
  `);for(const item of built){await log.success(`${item.target}: ${item.artifacts.map((name)=>join(relative(root,item.directory),name)).join(", ")}`);if(item.remaining)await log.info(` ${item.remaining}`)}if(process.env.STACKS_DESKTOP_OPEN==="1"){const mine=built.find((item)=>item.target===host);const app=mine?.artifacts.find((name)=>name.endsWith(".app"));if(mine&&app)Bun.spawn(["open","-n",join(mine.directory,app)],{stdout:"inherit",stderr:"inherit"})}process.exitCode=0;
@@ -1 +1 @@
1
- import{capitalCase,plural}from"@stacksjs/strings";import{Glob}from"bun";import{randomUUID}from"node:crypto";import{existsSync,readFileSync,renameSync,unlinkSync,writeFileSync}from"node:fs";import{connect}from"node:net";import path from"node:path";import{pathToFileURL}from"node:url";export const iconMap={user:"person.fill",team:"person.2.fill",subscriber:"envelope.open.fill",subscriberemail:"envelope.fill",post:"doc.text.fill",page:"doc.fill",product:"cube.box.fill",productvariant:"cube.fill",productunit:"scalemass.fill",order:"list.clipboard.fill",orderitem:"list.bullet.clipboard.fill",customer:"person.crop.circle.fill",payment:"creditcard.fill",paymentmethod:"creditcard.and.123",paymentproduct:"creditcard.fill",paymenttransaction:"creditcard.fill",category:"tag.fill",tag:"tag",comment:"bubble.left.fill",author:"person.text.rectangle.fill",notification:"bell.fill",job:"briefcase.fill",log:"list.bullet.rectangle.portrait.fill",campaign:"megaphone.fill",review:"star.fill",coupon:"ticket.fill",giftcard:"giftcard.fill",cart:"cart.fill",cartitem:"cart.badge.plus",taxrate:"percent",transaction:"arrow.left.arrow.right.circle.fill",subscription:"repeat.circle.fill",emaillist:"envelope.badge.person.crop",socialpost:"bubble.left.and.bubble.right.fill",manufacturer:"building.2.fill",shippingmethod:"shippingbox.fill",shippingzone:"map.fill",shippingrate:"dollarsign.circle.fill",deliveryroute:"map.fill",driver:"car.fill",digitaldelivery:"arrow.down.doc.fill",licensekey:"key.fill",loyaltypoint:"star.circle.fill",loyaltyreward:"gift.fill",printdevice:"printer.fill",receipt:"doc.text.fill",waitlistproduct:"clock.fill",waitlistrestaurant:"clock.badge.checkmark.fill",websocket:"antenna.radiowaves.left.and.right",default:"tablecells.fill"};export const excludeModels=new Set(["activity","request","error","failedjob"]);export const dedicatedPages=new Set(["user","team","subscriber","post","page","product","order","customer","payment","coupon","category","tag","comment","author","notification","job","campaign","review","gift-card"]);const ROOT_MODEL_CATEGORY={user:"data",team:"data",subscriber:"data",activity:"data",campaign:"marketing",emaillist:"marketing",socialpost:"marketing",subscriberemail:"marketing",comment:"content",tag:"content",paymentmethod:"commerce",paymentproduct:"commerce",paymenttransaction:"commerce",subscription:"commerce",deployment:"system",error:"system",failedjob:"system",job:"system",log:"system",notification:"system",release:"system",request:"system"};export function modelsWithEnabledFeatures(models,featureOf,enabled){return models.filter((model)=>{if(model.dashboard?.access===false)return false;if(model.category==="userland")return true;const gate=featureOf(model.name);return gate===undefined||enabled(gate)})}export function modelNameToId(name){return name.replace(/([A-Z])/g,"-$1").toLowerCase().replace(/^-/,"")}export function getModelIcon(name){return iconMap[name.toLowerCase()]||iconMap.default||"database"}function categorizeModel(relativePath,modelId,defaultCategory){if(defaultCategory)return defaultCategory;const firstSeg=relativePath.includes("/")?(relativePath.split("/")[0]??"").toLowerCase():"";if(firstSeg==="commerce")return"commerce";if(firstSeg==="content")return"content";if(firstSeg==="realtime")return"system";return ROOT_MODEL_CATEGORY[modelId.replace(/-/g,"")]??"data"}async function readModelDashboardConfig(absolutePath){try{const modelUrl=pathToFileURL(absolutePath).href;const mod=await import(modelUrl);const def=mod.default??mod;const dashboard=def.dashboard;return dashboard}catch(error){throw new Error(`Could not discover dashboard model ${absolutePath}: ${error instanceof Error?error.message:String(error)}`)}}export async function scanModelsDir(dir,seenNames,models,defaultCategory){if(!existsSync(dir))return;const glob=new Glob("**/*.ts");for await(const file of glob.scan({cwd:dir})){if(file.includes("README")||file.includes(".d.ts"))continue;const name=file.replace(/\.ts$/,"").split("/").pop()||"";const nameLower=name.toLowerCase();if(name&&!seenNames.has(nameLower)&&!excludeModels.has(nameLower)){seenNames.add(nameLower);const id=modelNameToId(name);const absolutePath=path.resolve(dir,file);const dashboard=await readModelDashboardConfig(absolutePath);models.push({name,icon:dashboard?.icon??getModelIcon(name),id,category:categorizeModel(file,id,defaultCategory),dashboard})}}}export async function discoverModels(userModelsPath,defaultModelsPath){const models=[];const seenNames=new Set;await scanModelsDir(userModelsPath,seenNames,models,"userland");await scanModelsDir(defaultModelsPath,seenNames,models);return models.sort((a,b)=>a.name.localeCompare(b.name))}export async function discoverProjectModels(){const{overridesReady}=await import("@stacksjs/config");const{resolveModelSources}=await import("@stacksjs/database/model-sources");await overridesReady;const models=[];for(const model of resolveModelSources()?.models??[]){if(excludeModels.has(model.name.toLowerCase()))continue;const dashboard=await readModelDashboardConfig(model.file);models.push({name:model.name,id:modelNameToId(model.name),icon:dashboard?.icon??getModelIcon(model.name),category:categorizeModel(model.file,modelNameToId(model.name),model.origin==="framework"?undefined:"userland"),dashboard})}return models.sort((a,b)=>a.name.localeCompare(b.name))}export function buildManifest(models){return models.filter((model)=>model.dashboard?.access!==false).map((m)=>{const row={id:m.id,name:m.name,icon:m.icon,hasDedicatedPage:dedicatedPages.has(m.id),category:m.category??"data"};if(m.dashboard)row.dashboard=m.dashboard;return row})}export function writeFileIfChanged(file,content){try{if(readFileSync(file,"utf8")===content)return false}catch{}const temporary=`${file}.${process.pid}.${randomUUID()}.tmp`;try{writeFileSync(temporary,content,{flag:"wx"});renameSync(temporary,file)}finally{if(existsSync(temporary))unlinkSync(temporary)}return true}export async function isPortAvailable(port){try{const server=Bun.serve({port,fetch:()=>new Response});await server.stop(true);return true}catch{return false}}export async function findAvailablePort(preferred,maxAttempts=20){for(let i=0;i<maxAttempts;i++){const port=preferred+i;if(await isPortAvailable(port))return port}return preferred}function connectsWithin(port,timeoutMs){return new Promise((resolve)=>{const socket=connect({port,host:"127.0.0.1"});const finish=(connected)=>{clearTimeout(timer);try{socket.destroy()}catch{}resolve(connected)};const timer=setTimeout(()=>finish(false),timeoutMs);socket.once("connect",()=>finish(true));socket.once("error",()=>finish(false))})}export async function waitForServer(port,maxWait=500){const deadline=Date.now()+maxWait;while(true){const remaining=deadline-Date.now();if(remaining<=0)return false;if(await connectsWithin(port,Math.min(remaining,250)))return true;if(Date.now()>=deadline)return false;await new Promise((resolve)=>setTimeout(resolve,Math.min(25,Math.max(deadline-Date.now(),0))))}}function effectiveCategory(m){if(m.dashboard?.access===false||m.dashboard?.enabled===false)return;if(m.dashboard?.section)return m.dashboard.section;return m.category??"data"}function categoryRows(baseRoute,models,category,dedicated){return models.filter((m)=>effectiveCategory(m)===category).filter((m)=>!dedicatedPages.has(m.id)&&!dedicated.has(m.id)).map((m)=>({id:`model-${m.id}`,label:m.dashboard?.label??capitalCase(plural(m.name)),icon:m.icon,url:`${baseRoute}/models/${m.id}`,...m.dashboard?.roles&&m.dashboard.roles.length>0?{roles:m.dashboard.roles}:{}}))}export function buildSidebarConfig(baseRoute,discoveredModels,toggles={}){const enabled={library:toggles.library??true,content:toggles.content??true,commerce:toggles.commerce??true,marketing:toggles.marketing??true,analytics:toggles.analytics??true,management:toggles.management??true,utilities:toggles.utilities??true};const dataRow={dashboard:toggles.data?.dashboard??true,activity:toggles.data?.activity??true,users:toggles.data?.users??true,teams:toggles.data?.teams??true,subscribers:toggles.data?.subscribers??true,allModels:toggles.data?.allModels??true};const sections=[];const homeItems=[{id:"home",label:"Dashboard",icon:"house.fill",url:`${baseRoute}/`},{id:"dependencies",label:"Dependencies",icon:"shippingbox.fill",url:`${baseRoute}/dependencies`},{id:"health",label:"Health",icon:"heart.text.square.fill",url:`${baseRoute}/health`}];if(toggles.ci)homeItems.push({id:"ci",label:"CI",icon:"checkmark.seal.fill",url:`${baseRoute}/ci`});sections.push({id:"home",title:"Home",items:homeItems});if(enabled.library){sections.push({id:"library",title:"Library",items:[{id:"functions",label:"Functions",icon:"function",url:`${baseRoute}/functions`},{id:"packages",label:"Packages",icon:"shippingbox.fill",url:`${baseRoute}/packages`}]})}if(enabled.content){sections.push({id:"content",title:"Content",items:[{id:"content-dashboard",label:"Dashboard",icon:"gauge.with.dots.needle.33percent",url:`${baseRoute}/content/dashboard`},{id:"files",label:"Files",icon:"folder.fill",url:`${baseRoute}/content/files`},{id:"pages",label:"Pages",icon:"doc.fill",url:`${baseRoute}/content/pages`},{id:"posts",label:"Posts",icon:"text.bubble.fill",url:`${baseRoute}/content/posts`},{id:"categories",label:"Categories",icon:"tag.fill",url:`${baseRoute}/content/categories`},{id:"tags",label:"Tags",icon:"tag",url:`${baseRoute}/content/tags`},{id:"comments",label:"Comments",icon:"bubble.left.fill",url:`${baseRoute}/content/comments`},{id:"authors",label:"Authors",icon:"person.text.rectangle.fill",url:`${baseRoute}/content/authors`},{id:"seo",label:"SEO",icon:"magnifyingglass",url:`${baseRoute}/content/seo`},...categoryRows(baseRoute,discoveredModels,"content",new Set(["page","post","category","tag","comment","author"]))]})}sections.push({id:"app",title:"App",items:[{id:"deployments",label:"Deployments",icon:"rocket.fill",url:`${baseRoute}/deployments`},{id:"requests",label:"Requests",icon:"arrow.left.arrow.right",url:`${baseRoute}/requests`},{id:"realtime",label:"Realtime",icon:"link",url:`${baseRoute}/realtime`},{id:"actions",label:"Actions",icon:"bolt.fill",url:`${baseRoute}/actions`},{id:"commands",label:"Commands",icon:"terminal.fill",url:`${baseRoute}/commands`},{id:"search-engine",label:"Search Engine",icon:"magnifyingglass",url:`${baseRoute}/search-engine`},{id:"queue",label:"Queue",icon:"list.bullet.rectangle.fill",url:`${baseRoute}/queue`},{id:"jobs",label:"Jobs",icon:"briefcase.fill",url:`${baseRoute}/jobs`},{id:"inbox",label:"Inbox",icon:"tray.full.fill",url:`${baseRoute}/inbox`},{id:"queries",label:"Queries",icon:"magnifyingglass.circle.fill",url:`${baseRoute}/queries`},{id:"notifications",label:"Notifications",icon:"bell.fill",url:`${baseRoute}/notifications/dashboard`},...categoryRows(baseRoute,discoveredModels,"system",new Set)]});const dataItems=[];if(dataRow.dashboard)dataItems.push({id:"data-dashboard",label:"Dashboard",icon:"gauge.with.dots.needle.33percent",url:`${baseRoute}/data/dashboard`});if(dataRow.activity)dataItems.push({id:"activity",label:"Activity",icon:"waveform.path.ecg",url:`${baseRoute}/data/activity`});if(dataRow.users)dataItems.push({id:"users",label:"Users",icon:"person.crop.circle.fill",url:`${baseRoute}/data/users`});if(dataRow.teams)dataItems.push({id:"teams",label:"Teams",icon:"person.3.fill",url:`${baseRoute}/data/teams`});if(dataRow.subscribers)dataItems.push({id:"subscribers",label:"Subscribers",icon:"envelope.fill",url:`${baseRoute}/data/subscribers`});if(dataRow.allModels)dataItems.push({id:"data-models",label:"All Models",icon:"square.grid.2x2.fill",url:`${baseRoute}/models`});const dynamicRows=discoveredModels.filter((m)=>{const eff=effectiveCategory(m);return eff==="userland"||eff==="data"}).filter((m)=>!dedicatedPages.has(m.id)).map((model)=>({id:`model-${model.id}`,label:model.dashboard?.label??capitalCase(plural(model.name)),icon:model.icon,url:`${baseRoute}/models/${model.id}`,...model.dashboard?.roles&&model.dashboard.roles.length>0?{roles:model.dashboard.roles}:{}}));sections.push({id:"data",title:"Data",items:[...dataItems,...dynamicRows]});if(enabled.commerce){sections.push({id:"commerce",title:"Commerce",items:[{id:"commerce-dashboard",label:"Dashboard",icon:"gauge.with.dots.needle.33percent",url:`${baseRoute}/commerce/dashboard`},{id:"customers",label:"Customers",icon:"person.crop.circle.fill",url:`${baseRoute}/commerce/customers`},{id:"orders",label:"Orders",icon:"list.clipboard.fill",url:`${baseRoute}/commerce/orders`},{id:"products",label:"Products",icon:"cube.box.fill",url:`${baseRoute}/commerce/products`},{id:"coupons",label:"Coupons",icon:"ticket.fill",url:`${baseRoute}/commerce/coupons`},{id:"gift-cards",label:"Gift Cards",icon:"giftcard.fill",url:`${baseRoute}/commerce/gift-cards`},{id:"payments",label:"Payments",icon:"creditcard.fill",url:`${baseRoute}/commerce/payments`},{id:"delivery",label:"Delivery",icon:"truck.box.fill",url:`${baseRoute}/commerce/delivery`},{id:"taxes",label:"Taxes",icon:"percent",url:`${baseRoute}/commerce/taxes`},...categoryRows(baseRoute,discoveredModels,"commerce",new Set(["customer","order","product","coupon","gift-card","payment","review","category"]))]})}if(enabled.marketing){sections.push({id:"marketing",title:"Marketing",items:[{id:"lists",label:"Lists",icon:"list.bullet",url:`${baseRoute}/marketing/lists`},{id:"social-posts",label:"Social Posts",icon:"clock.fill",url:`${baseRoute}/marketing/social-posts`},{id:"campaigns",label:"Campaigns",icon:"megaphone.fill",url:`${baseRoute}/marketing/campaigns`},{id:"marketing-reviews",label:"Reviews",icon:"star.fill",url:`${baseRoute}/marketing/reviews`},...categoryRows(baseRoute,discoveredModels,"marketing",new Set(["campaign"]))]})}if(enabled.analytics){sections.push({id:"analytics",title:"Analytics",items:[{id:"analytics-web",label:"Web",icon:"globe",url:`${baseRoute}/analytics/web`},{id:"analytics-blog",label:"Blog",icon:"doc.text.fill",url:`${baseRoute}/analytics/blog`},{id:"analytics-commerce",label:"Commerce",icon:"cart.fill",url:`${baseRoute}/analytics/commerce/web`},{id:"analytics-marketing",label:"Marketing",icon:"megaphone.fill",url:`${baseRoute}/analytics/marketing`}]})}if(enabled.management){sections.push({id:"management",title:"Management",items:[{id:"cloud",label:"Cloud",icon:"cloud.fill",url:`${baseRoute}/cloud`},{id:"servers",label:"Servers",icon:"server.rack",url:`${baseRoute}/servers`},{id:"serverless",label:"Serverless",icon:"bolt.horizontal.circle.fill",url:`${baseRoute}/serverless`},{id:"dns",label:"DNS",icon:"network",url:`${baseRoute}/dns`},{id:"mailboxes",label:"Mailboxes",icon:"tray.full.fill",url:`${baseRoute}/mailboxes`},{id:"logs",label:"Logs",icon:"list.bullet.rectangle.portrait.fill",url:`${baseRoute}/logs`},{id:"kanban",label:"Kanban",icon:"rectangle.stack.fill",url:`${baseRoute}/kanban`,roles:["admin","dev"]}]})}if(enabled.utilities){sections.push({id:"utilities",title:"Utilities",items:[{id:"buddy",label:"AI Buddy",icon:"bubble.left.and.bubble.right.fill",url:`${baseRoute}/buddy`},{id:"environment",label:"Environment",icon:"key.fill",url:`${baseRoute}/environment`},{id:"access-tokens",label:"Access Tokens",icon:"key.horizontal.fill",url:`${baseRoute}/access-tokens`},{id:"settings",label:"Settings",icon:"gear",url:`${baseRoute}/settings/billing`}]})}return{sections,minWidth:200,maxWidth:280}}
1
+ import{capitalCase,plural}from"@stacksjs/strings";import{Glob}from"bun";import{randomUUID}from"node:crypto";import{existsSync,readFileSync,renameSync,unlinkSync,writeFileSync}from"node:fs";import{connect}from"node:net";import path from"node:path";import{pathToFileURL}from"node:url";export const iconMap={user:"person.fill",team:"person.2.fill",subscriber:"envelope.open.fill",subscriberemail:"envelope.fill",post:"doc.text.fill",page:"doc.fill",product:"cube.box.fill",productvariant:"cube.fill",productunit:"scalemass.fill",order:"list.clipboard.fill",orderitem:"list.bullet.clipboard.fill",customer:"person.crop.circle.fill",payment:"creditcard.fill",paymentmethod:"creditcard.and.123",paymentproduct:"creditcard.fill",paymenttransaction:"creditcard.fill",category:"tag.fill",tag:"tag",comment:"bubble.left.fill",author:"person.text.rectangle.fill",notification:"bell.fill",job:"briefcase.fill",log:"list.bullet.rectangle.portrait.fill",campaign:"megaphone.fill",review:"star.fill",coupon:"ticket.fill",giftcard:"giftcard.fill",cart:"cart.fill",cartitem:"cart.badge.plus",taxrate:"percent",transaction:"arrow.left.arrow.right.circle.fill",subscription:"repeat.circle.fill",emaillist:"envelope.badge.person.crop",socialpost:"bubble.left.and.bubble.right.fill",manufacturer:"building.2.fill",shippingmethod:"shippingbox.fill",shippingzone:"map.fill",shippingrate:"dollarsign.circle.fill",deliveryroute:"map.fill",driver:"car.fill",digitaldelivery:"arrow.down.doc.fill",licensekey:"key.fill",loyaltypoint:"star.circle.fill",loyaltyreward:"gift.fill",printdevice:"printer.fill",receipt:"doc.text.fill",waitlistproduct:"clock.fill",waitlistrestaurant:"clock.badge.checkmark.fill",websocket:"antenna.radiowaves.left.and.right",default:"tablecells.fill"};export const excludeModels=new Set(["activity","request","error","failedjob"]);export const dedicatedPages=new Set(["user","team","subscriber","post","page","product","order","customer","payment","coupon","category","tag","comment","author","notification","job","campaign","review","gift-card"]);const ROOT_MODEL_CATEGORY={user:"data",team:"data",subscriber:"data",activity:"data",campaign:"marketing",emaillist:"marketing",socialpost:"marketing",subscriberemail:"marketing",comment:"content",tag:"content",paymentmethod:"commerce",paymentproduct:"commerce",paymenttransaction:"commerce",subscription:"commerce",deployment:"system",error:"system",failedjob:"system",job:"system",log:"system",notification:"system",release:"system",request:"system"};export function modelsWithEnabledFeatures(models,featureOf,enabled){return models.filter((model)=>{if(model.dashboard?.access===false)return false;if(model.category==="userland")return true;const gate=featureOf(model.name);return gate===undefined||enabled(gate)})}export function modelNameToId(name){return name.replace(/([A-Z])/g,"-$1").toLowerCase().replace(/^-/,"")}export function getModelIcon(name){return iconMap[name.toLowerCase()]||iconMap.default||"database"}function categorizeModel(relativePath,modelId,defaultCategory){if(defaultCategory)return defaultCategory;const firstSeg=relativePath.includes("/")?(relativePath.split("/")[0]??"").toLowerCase():"";if(firstSeg==="commerce")return"commerce";if(firstSeg==="content")return"content";if(firstSeg==="realtime")return"system";return ROOT_MODEL_CATEGORY[modelId.replace(/-/g,"")]??"data"}async function readModelDashboardConfig(absolutePath){try{const modelUrl=pathToFileURL(absolutePath).href;const mod=await import(modelUrl);const def=mod.default??mod;const dashboard=def.dashboard;return dashboard}catch(error){throw new Error(`Could not discover dashboard model ${absolutePath}: ${error instanceof Error?error.message:String(error)}`)}}export async function scanModelsDir(dir,seenNames,models,defaultCategory){if(!existsSync(dir))return;const glob=new Glob("**/*.ts");for await(const file of glob.scan({cwd:dir})){if(file.includes("README")||file.includes(".d.ts"))continue;const name=file.replace(/\.ts$/,"").split("/").pop()||"";const nameLower=name.toLowerCase();if(name&&!seenNames.has(nameLower)&&!excludeModels.has(nameLower)){seenNames.add(nameLower);const id=modelNameToId(name);const absolutePath=path.resolve(dir,file);const dashboard=await readModelDashboardConfig(absolutePath);models.push({name,icon:dashboard?.icon??getModelIcon(name),id,category:categorizeModel(file,id,defaultCategory),dashboard})}}}export async function discoverModels(userModelsPath,defaultModelsPath){const models=[];const seenNames=new Set;await scanModelsDir(userModelsPath,seenNames,models,"userland");await scanModelsDir(defaultModelsPath,seenNames,models);return models.sort((a,b)=>a.name.localeCompare(b.name))}export async function discoverProjectModels(){const{overridesReady}=await import("@stacksjs/config");const{listModelSources}=await import("@stacksjs/database/model-sources");await overridesReady;const models=[];for(const model of listModelSources()??[]){if(excludeModels.has(model.name.toLowerCase()))continue;const dashboard=await readModelDashboardConfig(model.file);models.push({name:model.name,id:modelNameToId(model.name),icon:dashboard?.icon??getModelIcon(model.name),category:categorizeModel(model.file,modelNameToId(model.name),model.origin==="framework"?undefined:"userland"),dashboard})}return models.sort((a,b)=>a.name.localeCompare(b.name))}export function buildManifest(models){return models.filter((model)=>model.dashboard?.access!==false).map((m)=>{const row={id:m.id,name:m.name,icon:m.icon,hasDedicatedPage:dedicatedPages.has(m.id),category:m.category??"data"};if(m.dashboard)row.dashboard=m.dashboard;return row})}export function writeFileIfChanged(file,content){try{if(readFileSync(file,"utf8")===content)return false}catch{}const temporary=`${file}.${process.pid}.${randomUUID()}.tmp`;try{writeFileSync(temporary,content,{flag:"wx"});renameSync(temporary,file)}finally{if(existsSync(temporary))unlinkSync(temporary)}return true}export async function isPortAvailable(port){try{const server=Bun.serve({port,fetch:()=>new Response});await server.stop(true);return true}catch{return false}}export async function findAvailablePort(preferred,maxAttempts=20){for(let i=0;i<maxAttempts;i++){const port=preferred+i;if(await isPortAvailable(port))return port}return preferred}function connectsWithin(port,timeoutMs){return new Promise((resolve)=>{const socket=connect({port,host:"127.0.0.1"});const finish=(connected)=>{clearTimeout(timer);try{socket.destroy()}catch{}resolve(connected)};const timer=setTimeout(()=>finish(false),timeoutMs);socket.once("connect",()=>finish(true));socket.once("error",()=>finish(false))})}export async function waitForServer(port,maxWait=500){const deadline=Date.now()+maxWait;while(true){const remaining=deadline-Date.now();if(remaining<=0)return false;if(await connectsWithin(port,Math.min(remaining,250)))return true;if(Date.now()>=deadline)return false;await new Promise((resolve)=>setTimeout(resolve,Math.min(25,Math.max(deadline-Date.now(),0))))}}function effectiveCategory(m){if(m.dashboard?.access===false||m.dashboard?.enabled===false)return;if(m.dashboard?.section)return m.dashboard.section;return m.category??"data"}function categoryRows(baseRoute,models,category,dedicated){return models.filter((m)=>effectiveCategory(m)===category).filter((m)=>!dedicatedPages.has(m.id)&&!dedicated.has(m.id)).map((m)=>({id:`model-${m.id}`,label:m.dashboard?.label??capitalCase(plural(m.name)),icon:m.icon,url:`${baseRoute}/models/${m.id}`,...m.dashboard?.roles&&m.dashboard.roles.length>0?{roles:m.dashboard.roles}:{}}))}export function buildSidebarConfig(baseRoute,discoveredModels,toggles={}){const enabled={library:toggles.library??true,content:toggles.content??true,commerce:toggles.commerce??true,marketing:toggles.marketing??true,analytics:toggles.analytics??true,management:toggles.management??true,utilities:toggles.utilities??true};const dataRow={dashboard:toggles.data?.dashboard??true,activity:toggles.data?.activity??true,users:toggles.data?.users??true,teams:toggles.data?.teams??true,subscribers:toggles.data?.subscribers??true,allModels:toggles.data?.allModels??true};const sections=[];const homeItems=[{id:"home",label:"Dashboard",icon:"house.fill",url:`${baseRoute}/`},{id:"dependencies",label:"Dependencies",icon:"shippingbox.fill",url:`${baseRoute}/dependencies`},{id:"health",label:"Health",icon:"heart.text.square.fill",url:`${baseRoute}/health`}];if(toggles.ci)homeItems.push({id:"ci",label:"CI",icon:"checkmark.seal.fill",url:`${baseRoute}/ci`});sections.push({id:"home",title:"Home",items:homeItems});if(enabled.library){sections.push({id:"library",title:"Library",items:[{id:"functions",label:"Functions",icon:"function",url:`${baseRoute}/functions`},{id:"packages",label:"Packages",icon:"shippingbox.fill",url:`${baseRoute}/packages`}]})}if(enabled.content){sections.push({id:"content",title:"Content",items:[{id:"content-dashboard",label:"Dashboard",icon:"gauge.with.dots.needle.33percent",url:`${baseRoute}/content/dashboard`},{id:"files",label:"Files",icon:"folder.fill",url:`${baseRoute}/content/files`},{id:"pages",label:"Pages",icon:"doc.fill",url:`${baseRoute}/content/pages`},{id:"posts",label:"Posts",icon:"text.bubble.fill",url:`${baseRoute}/content/posts`},{id:"categories",label:"Categories",icon:"tag.fill",url:`${baseRoute}/content/categories`},{id:"tags",label:"Tags",icon:"tag",url:`${baseRoute}/content/tags`},{id:"comments",label:"Comments",icon:"bubble.left.fill",url:`${baseRoute}/content/comments`},{id:"authors",label:"Authors",icon:"person.text.rectangle.fill",url:`${baseRoute}/content/authors`},{id:"seo",label:"SEO",icon:"magnifyingglass",url:`${baseRoute}/content/seo`},...categoryRows(baseRoute,discoveredModels,"content",new Set(["page","post","category","tag","comment","author"]))]})}sections.push({id:"app",title:"App",items:[{id:"deployments",label:"Deployments",icon:"rocket.fill",url:`${baseRoute}/deployments`},{id:"requests",label:"Requests",icon:"arrow.left.arrow.right",url:`${baseRoute}/requests`},{id:"realtime",label:"Realtime",icon:"link",url:`${baseRoute}/realtime`},{id:"actions",label:"Actions",icon:"bolt.fill",url:`${baseRoute}/actions`},{id:"commands",label:"Commands",icon:"terminal.fill",url:`${baseRoute}/commands`},{id:"search-engine",label:"Search Engine",icon:"magnifyingglass",url:`${baseRoute}/search-engine`},{id:"queue",label:"Queue",icon:"list.bullet.rectangle.fill",url:`${baseRoute}/queue`},{id:"jobs",label:"Jobs",icon:"briefcase.fill",url:`${baseRoute}/jobs`},{id:"inbox",label:"Inbox",icon:"tray.full.fill",url:`${baseRoute}/inbox`},{id:"queries",label:"Queries",icon:"magnifyingglass.circle.fill",url:`${baseRoute}/queries`},{id:"notifications",label:"Notifications",icon:"bell.fill",url:`${baseRoute}/notifications/dashboard`},...categoryRows(baseRoute,discoveredModels,"system",new Set)]});const dataItems=[];if(dataRow.dashboard)dataItems.push({id:"data-dashboard",label:"Dashboard",icon:"gauge.with.dots.needle.33percent",url:`${baseRoute}/data/dashboard`});if(dataRow.activity)dataItems.push({id:"activity",label:"Activity",icon:"waveform.path.ecg",url:`${baseRoute}/data/activity`});if(dataRow.users)dataItems.push({id:"users",label:"Users",icon:"person.crop.circle.fill",url:`${baseRoute}/data/users`});if(dataRow.teams)dataItems.push({id:"teams",label:"Teams",icon:"person.3.fill",url:`${baseRoute}/data/teams`});if(dataRow.subscribers)dataItems.push({id:"subscribers",label:"Subscribers",icon:"envelope.fill",url:`${baseRoute}/data/subscribers`});if(dataRow.allModels)dataItems.push({id:"data-models",label:"All Models",icon:"square.grid.2x2.fill",url:`${baseRoute}/models`});const dynamicRows=discoveredModels.filter((m)=>{const eff=effectiveCategory(m);return eff==="userland"||eff==="data"}).filter((m)=>!dedicatedPages.has(m.id)).map((model)=>({id:`model-${model.id}`,label:model.dashboard?.label??capitalCase(plural(model.name)),icon:model.icon,url:`${baseRoute}/models/${model.id}`,...model.dashboard?.roles&&model.dashboard.roles.length>0?{roles:model.dashboard.roles}:{}}));sections.push({id:"data",title:"Data",items:[...dataItems,...dynamicRows]});if(enabled.commerce){sections.push({id:"commerce",title:"Commerce",items:[{id:"commerce-dashboard",label:"Dashboard",icon:"gauge.with.dots.needle.33percent",url:`${baseRoute}/commerce/dashboard`},{id:"customers",label:"Customers",icon:"person.crop.circle.fill",url:`${baseRoute}/commerce/customers`},{id:"orders",label:"Orders",icon:"list.clipboard.fill",url:`${baseRoute}/commerce/orders`},{id:"products",label:"Products",icon:"cube.box.fill",url:`${baseRoute}/commerce/products`},{id:"coupons",label:"Coupons",icon:"ticket.fill",url:`${baseRoute}/commerce/coupons`},{id:"gift-cards",label:"Gift Cards",icon:"giftcard.fill",url:`${baseRoute}/commerce/gift-cards`},{id:"payments",label:"Payments",icon:"creditcard.fill",url:`${baseRoute}/commerce/payments`},{id:"delivery",label:"Delivery",icon:"truck.box.fill",url:`${baseRoute}/commerce/delivery`},{id:"taxes",label:"Taxes",icon:"percent",url:`${baseRoute}/commerce/taxes`},...categoryRows(baseRoute,discoveredModels,"commerce",new Set(["customer","order","product","coupon","gift-card","payment","review","category"]))]})}if(enabled.marketing){sections.push({id:"marketing",title:"Marketing",items:[{id:"lists",label:"Lists",icon:"list.bullet",url:`${baseRoute}/marketing/lists`},{id:"social-posts",label:"Social Posts",icon:"clock.fill",url:`${baseRoute}/marketing/social-posts`},{id:"campaigns",label:"Campaigns",icon:"megaphone.fill",url:`${baseRoute}/marketing/campaigns`},{id:"marketing-reviews",label:"Reviews",icon:"star.fill",url:`${baseRoute}/marketing/reviews`},...categoryRows(baseRoute,discoveredModels,"marketing",new Set(["campaign"]))]})}if(enabled.analytics){sections.push({id:"analytics",title:"Analytics",items:[{id:"analytics-web",label:"Web",icon:"globe",url:`${baseRoute}/analytics/web`},{id:"analytics-blog",label:"Blog",icon:"doc.text.fill",url:`${baseRoute}/analytics/blog`},{id:"analytics-commerce",label:"Commerce",icon:"cart.fill",url:`${baseRoute}/analytics/commerce/web`},{id:"analytics-marketing",label:"Marketing",icon:"megaphone.fill",url:`${baseRoute}/analytics/marketing`}]})}if(enabled.management){sections.push({id:"management",title:"Management",items:[{id:"cloud",label:"Cloud",icon:"cloud.fill",url:`${baseRoute}/cloud`},{id:"servers",label:"Servers",icon:"server.rack",url:`${baseRoute}/servers`},{id:"serverless",label:"Serverless",icon:"bolt.horizontal.circle.fill",url:`${baseRoute}/serverless`},{id:"dns",label:"DNS",icon:"network",url:`${baseRoute}/dns`},{id:"mailboxes",label:"Mailboxes",icon:"tray.full.fill",url:`${baseRoute}/mailboxes`},{id:"logs",label:"Logs",icon:"list.bullet.rectangle.portrait.fill",url:`${baseRoute}/logs`},{id:"kanban",label:"Kanban",icon:"rectangle.stack.fill",url:`${baseRoute}/kanban`,roles:["admin","dev"]}]})}if(enabled.utilities){sections.push({id:"utilities",title:"Utilities",items:[{id:"buddy",label:"AI Buddy",icon:"bubble.left.and.bubble.right.fill",url:`${baseRoute}/buddy`},{id:"environment",label:"Environment",icon:"key.fill",url:`${baseRoute}/environment`},{id:"access-tokens",label:"Access Tokens",icon:"key.horizontal.fill",url:`${baseRoute}/access-tokens`},{id:"settings",label:"Settings",icon:"gear",url:`${baseRoute}/settings/billing`}]})}return{sections,minWidth:200,maxWidth:280}}
@@ -1,6 +1,6 @@
1
1
  import process from"node:process";import{existsSync,mkdirSync}from"node:fs";import{connect}from"node:net";import{bold,cyan,dim,green}from"@stacksjs/cli";import{defaultsPath,projectPath,publicPath,storagePath}from"@stacksjs/path";import{seedCsrfPageResponse,validateDevCsrfRequest}from"./csrf";import{resolveComponentsLibraryRoot}from"./defaults-resources";import{shouldDelegateDashboardRequest}from"./dashboard-request-routing";import{resolveDashboardCraftExecutable}from"./dashboard-native";import{resolveDashboardDomain,resolveDashboardProxyStrategy}from"./dashboard-proxy";import{buildManifest,discoverProjectModels,findAvailablePort,modelsWithEnabledFeatures,waitForServer,writeFileIfChanged}from"./dashboard-utils";import{runDashboardSupervisor}from"./dashboard-supervisor";import{ensureDiscoveredPackages}from"../discover-packages";import{resolveStxSource}from"../stx-source";if(process.env.STACKS_DASHBOARD_WORKER!=="1"){const exitCode=await runDashboardSupervisor(import.meta.path,process.argv.slice(2));process.exit(exitCode)}process.env.STX_DIR=storagePath("framework/runtime/dashboard-stx");const verboseIdx=process.argv.indexOf("--verbose");const verbose=verboseIdx!==-1&&process.argv[verboseIdx+1]!=="false";const startTime=Bun.nanoseconds();const originalConsoleLog=console.log;const originalConsoleWarn=console.warn;const bufferedLogs=[];console.log=(...args)=>{bufferedLogs.push(args.map(String).join(" "))};console.warn=(...args)=>{bufferedLogs.push(args.map(String).join(" "))};const dashboardPath=defaultsPath("views/dashboard");const userDashboardPath=projectPath("resources/views/dashboard");const dashboardComponentsPath=defaultsPath("resources/components/Dashboard");const userDashboardComponentsPath=projectPath("resources/components/Dashboard");const preferredPort=Number(process.env.PORT_ADMIN)||3002;const dashboardPort=await findAvailablePort(preferredPort);const appUrl=process.env.APP_URL||"";const dashboardDomain=resolveDashboardDomain(appUrl,process.env.STACKS_DEV_LOCALHOST==="1");const sslBasePath=`${process.env.HOME}/.stacks/ssl`;function restoreConsole(){console.log=originalConsoleLog;console.warn=(...args)=>{const msg=args.map(String).join(" ");if(msg.includes("[STX] DOM API violation")||msg.includes("unsafe expression"))return;originalConsoleWarn(...args)}}async function startStxServer(){const{overridesReady}=await import("@stacksjs/config");const{autoImportsAreStale,generateAutoImportFiles,injectGlobalAutoImports}=await import("@stacksjs/server");await overridesReady;await ensureDiscoveredPackages();if(!existsSync(storagePath("framework/auto-imports/models.ts"))||autoImportsAreStale())await generateAutoImportFiles();await injectGlobalAutoImports();const serveSource=resolveStxSource({value:process.env.BUN_PLUGIN_STX_SRC});if(serveSource.kind==="missing"){throw new Error(`BUN_PLUGIN_STX_SRC points at ${serveSource.path}, which does not exist. Unset it to use the installed bun-plugin-stx.`)}let serve;if(serveSource.kind==="override"){serve=(await import(serveSource.path)).serve;console.log(`[Dashboard] bun-plugin-stx from ${serveSource.path}`)}else{serve=(await import("bun-plugin-stx/serve")).serve}const stxSource=resolveStxSource({value:process.env.STX_SRC});if(stxSource.kind==="missing"){throw new Error(`STX_SRC points at ${stxSource.path}, which does not exist. Unset it to use the installed @stacksjs/stx.`)}let stxModule;if(stxSource.kind==="override"){stxModule=await import(stxSource.path);console.log(`[Dashboard] stx from ${stxSource.path}`)}const{listConfigFiles,readConfig,updateConfigKeys}=await import(defaultsPath("resources/functions/dashboard/config-io.ts"));const{disabledFeatureConfigs}=await import("./dashboard-feature-views");async function hiddenConfigs(){const{feature}=await import("@stacksjs/config");return disabledFeatureConfigs(feature)}const localTsChartsRoot=process.env.TS_CHARTS_SRC;const dependencyBundles=new Map;function resolveTsChartsSource(packageName){const candidates=[...localTsChartsRoot?[`${localTsChartsRoot}/packages/${packageName}/src/index.ts`]:[],projectPath(`node_modules/@ts-charts/${packageName}/src/index.ts`)];return candidates.find(existsSync)||null}const tsChartsEntry=[...localTsChartsRoot?[`${localTsChartsRoot}/packages/ts-charts/src/index.ts`]:[],projectPath("node_modules/ts-charts/src/index.ts")].find(existsSync);async function buildDashboardDependency(entrypoint){const cached=dependencyBundles.get(entrypoint);if(cached)return cached;const build=(async()=>{const result=await Bun.build({entrypoints:[entrypoint],target:"browser",format:"esm",minify:true,plugins:[{name:"dashboard-ts-charts-source",setup(builder){builder.onResolve({filter:/^@ts-charts\/[a-z0-9-]+$/},(args)=>{const packageName=args.path.slice("@ts-charts/".length);const source=resolveTsChartsSource(packageName);if(source)return{path:source};return null})}}]});if(!result.success){const errors=result.logs.filter((log)=>log.level==="error").map((log)=>log.message).join(`
2
2
  `);throw new Error(errors||`Failed to bundle ${entrypoint}`)}const output=result.outputs.find((file)=>file.path.endsWith(".js"));if(!output)throw new Error(`No JavaScript output produced for ${entrypoint}`);return output.text()})();dependencyBundles.set(entrypoint,build);return build}function browserDependencyRoute(entrypoint){return async()=>{try{return new Response(await buildDashboardDependency(entrypoint),{headers:{"content-type":"text/javascript; charset=utf-8","cache-control":"no-cache"}})}catch(error){dependencyBundles.delete(entrypoint);return new Response(`throw new Error(${JSON.stringify(error.message)})`,{status:500,headers:{"content-type":"text/javascript; charset=utf-8"}})}}}let dashboardIconCss=null;async function buildDashboardIconCss(){const{generateCss}=await import("@stacksjs/stx");const dirs=[dashboardPath,userDashboardPath,dashboardComponentsPath,userDashboardComponentsPath,projectPath("app/Models"),defaultsPath("app/Models"),defaultsPath("functions"),defaultsPath("resources/functions")];const icons=new Set;for(const dir of dirs){if(!existsSync(dir))continue;const glob=new Bun.Glob("**/*.{stx,ts}");for await(const file of glob.scan({cwd:dir,absolute:true})){const text=await Bun.file(file).text();for(const match of text.matchAll(/\bi-[a-z][a-z0-9]*(?:-[a-z0-9]+)+/g))icons.add(match[0])}}if(icons.size===0)return"";return generateCss(`<div class="${[...icons].join(" ")}"></div>`,process.cwd())}const configRoutes={"/__deps/charts.js":browserDependencyRoute(storagePath("framework/core/charts/src/index.ts")),"/__deps/ts-charts.js":browserDependencyRoute(tsChartsEntry||`${localTsChartsRoot}/packages/ts-charts/src/index.ts`),"/__deps/dashboard-icons.css":async()=>{if(!dashboardIconCss)dashboardIconCss=buildDashboardIconCss();return new Response(await dashboardIconCss,{headers:{"content-type":"text/css; charset=utf-8","cache-control":"no-cache"}})},"/api/config/list":async()=>{try{const hidden=await hiddenConfigs();return Response.json({ok:true,files:listConfigFiles().filter((file)=>!hidden.has(file.name.replace(/\.ts$/,"")))})}catch(e){return Response.json({ok:false,error:e?.message},{status:500})}},"/api/config/read":async(req)=>{try{const url=new URL(req.url);const name=url.searchParams.get("name")||"";if(!/^[\w-]+$/.test(name))return Response.json({ok:false,error:"Invalid config name"},{status:400});if((await hiddenConfigs()).has(name))return Response.json({ok:false,error:"Not found"},{status:404});const result=await readConfig(name);if(!result)return Response.json({ok:false,error:"Not found"},{status:404});return Response.json({ok:true,name,fields:result.fields})}catch(e){return Response.json({ok:false,error:e?.message},{status:500})}},"/api/config/source":async(req)=>{try{const url=new URL(req.url);const name=url.searchParams.get("name")||"";if(!/^[\w-]+$/.test(name))return Response.json({ok:false,error:"Invalid config name"},{status:400});if((await hiddenConfigs()).has(name))return Response.json({ok:false,error:"Not found"},{status:404});const result=await readConfig(name);if(!result)return Response.json({ok:false,error:"Not found"},{status:404});return new Response(result.source,{headers:{"content-type":"text/plain; charset=utf-8"}})}catch(e){return Response.json({ok:false,error:e?.message},{status:500})}},"/api/config/update":async(req)=>{if(req.method!=="POST")return Response.json({ok:false,error:"Method not allowed"},{status:405});try{await validateDevCsrfRequest(req);const body=await req.json();const file=body.file?.replace(/\.ts$/,"");if(!file||!/^[\w-]+$/.test(file))return Response.json({ok:false,error:"Invalid file"},{status:400});if((await hiddenConfigs()).has(file))return Response.json({ok:false,error:"Not found"},{status:404});const updates=[];if(Array.isArray(body.updates)){for(const u of body.updates){const k=u.key??u.path;if(typeof k==="string")updates.push({key:k,value:u.value})}}else if(body.key){updates.push({key:body.key,value:body.value})}if(updates.length===0)return Response.json({ok:false,error:"No updates supplied"},{status:400});const invalid=updates.find((update)=>!/^[A-Za-z_$][\w$]*$/.test(update.key)||typeof update.value!=="string"&&typeof update.value!=="number"&&typeof update.value!=="boolean"||typeof update.value==="number"&&!Number.isFinite(update.value));if(invalid)return Response.json({ok:false,error:`Invalid value for configuration key "${invalid.key}"`},{status:400});const typedUpdates=updates;try{await updateConfigKeys(file,typedUpdates)}catch(err){const error=err?.message||"Configuration values could not be updated.";const results=typedUpdates.map((update)=>({key:update.key,ok:false,error}));return Response.json({ok:false,file,results,error},{status:422})}const results=typedUpdates.map((update)=>({key:update.key,ok:true,newValue:update.value}));return Response.json({ok:true,file,results})}catch(e){if(e?.status===403)return Response.json({ok:false,error:"Forbidden",message:"CSRF token mismatch"},{status:403});return Response.json({ok:false,error:e?.message},{status:500})}}};const router=await import("@stacksjs/router");await router.loadRoutes(await router.appRouteRegistry());await router.route.register(defaultsPath("routes/dashboard-api.ts"));const stacksRoute=router.route;const{feature}=await import("@stacksjs/config");const{disabledFeatureViews}=await import("./dashboard-feature-views");const serverPromise=serve({root:projectPath("resources"),patterns:[userDashboardPath,dashboardPath],exclude:disabledFeatureViews(dashboardPath,feature),port:dashboardPort,componentsDir:userDashboardComponentsPath,additionalComponentsDirs:[dashboardComponentsPath],fallbackComponentsDir:resolveComponentsLibraryRoot(),layoutsDir:projectPath("resources/views/dashboard/layouts"),fallbackLayoutsDir:defaultsPath("views/dashboard/layouts"),partialsDir:dashboardPath,publicDir:publicPath(),renderCache:true,renderCacheVary:"source",prewarmRenderCache:false,renderCachePersist:true,watchDirs:[projectPath("resources/functions"),defaultsPath("resources/functions"),defaultsPath("functions"),projectPath("config"),storagePath("framework/runtime/dashboard")],quiet:true,routes:configRoutes,onRequest:async(req)=>{const url=new URL(req.url);const pathname=url.pathname;if(shouldDelegateDashboardRequest(pathname,req.method))return stacksRoute.handleRequest(req);return null},onResponse:seedCsrfPageResponse,auth:false,...stxModule&&{stxModule}});serverPromise.catch((err)=>{restoreConsole();console.error(`
3
3
  Failed to start dashboard server: ${err?.message||err}
4
- `);process.exit(1)})}function portAnswers(port,timeoutMs=800){return new Promise((resolve)=>{const socket=connect({port,host:"127.0.0.1"});const finish=(answered)=>{try{socket.destroy()}catch{}resolve(answered)};socket.once("connect",()=>finish(true));socket.once("error",()=>finish(false));setTimeout(()=>finish(false),timeoutMs).unref?.()})}async function registerWithRpxDaemon(domainToServe){const{writeEntry}=await import("@stacksjs/rpx");await writeEntry({id:`${domainToServe}-dashboard`,from:`localhost:${dashboardPort}`,to:domainToServe,cwd:process.cwd(),createdAt:new Date().toISOString(),pid:process.pid},undefined,verbose);return true}async function startReverseProxy(){if(!dashboardDomain)return false;try{let rpx;const loadRpx=async()=>rpx??=await import("@stacksjs/rpx");const strategy=await resolveDashboardProxyStrategy(dashboardDomain,{proxyManagedExternally:Boolean(process.env.STACKS_PROXY_MANAGED),isDaemonRunning:async()=>(await loadRpx()).isDaemonRunning(),httpsPortAnswers:()=>portAnswers(443)});if(strategy==="origin-only")return false;if(strategy==="parent-managed")return true;if(strategy==="daemon-route")return await registerWithRpxDaemon(dashboardDomain);await(await loadRpx()).startProxies({proxies:[{from:`localhost:${dashboardPort}`,to:dashboardDomain,cleanUrls:false}],https:{basePath:sslBasePath,validityDays:825},regenerateUntrustedCerts:false,verbose});return await portAnswers(443)}catch(error){if(verbose)originalConsoleLog(` ${dim(`Proxy: ${error}`)}`);return false}}const[,allDiscoveredModels]=await Promise.all([startStxServer(),discoverProjectModels()]);const{loadDashboardConfig}=await import(defaultsPath("resources/functions/dashboard/toggles.ts"));const{feature:featureEnabled}=await import("@stacksjs/config");const{toggles:dashboardToggles,nav:dashboardNav}=await loadDashboardConfig(projectPath("config/dashboard.ts"),featureEnabled);const{frameworkModelFeature}=await import("@stacksjs/orm");const discoveredModels=modelsWithEnabledFeatures(allDiscoveredModels,frameworkModelFeature,(name)=>featureEnabled(name));const manifestDir=storagePath("framework/runtime/dashboard");const manifestPath=storagePath("framework/runtime/dashboard/.discovered-models.json");mkdirSync(manifestDir,{recursive:true});const{resolveModelSources}=await import("@stacksjs/database/model-sources");const manifestPayload={models:buildManifest(discoveredModels),schemaModels:(resolveModelSources()?.models??[]).map((model)=>model.name),sections:dashboardToggles,nav:dashboardNav};writeFileIfChanged(manifestPath,JSON.stringify(manifestPayload,null,2));const serverReady=await waitForServer(dashboardPort);restoreConsole();const proxyStarted=await startReverseProxy().catch((err)=>{if(verbose)console.warn("[Dashboard] Reverse proxy failed:",err);return false});const dashboardHttpsUrl=dashboardDomain?`https://${dashboardDomain}`:null;const dashboardLocalUrl=`http://localhost:${dashboardPort}`;const initialUrl=dashboardHttpsUrl&&proxyStarted?`${dashboardHttpsUrl}/`:`${dashboardLocalUrl}/`;const elapsedMs=(Bun.nanoseconds()-startTime)/1e6;console.log();console.log(` ${bold(cyan("stacks dashboard"))}`);console.log();if(dashboardHttpsUrl&&proxyStarted){console.log(` ${green("➜")} ${bold("Local")}: ${cyan(dashboardHttpsUrl)}`);console.log(` ${dim("➜")} ${dim("Origin")}: ${dim(dashboardLocalUrl)}`)}else{console.log(` ${green("➜")} ${bold("Local")}: ${cyan(dashboardLocalUrl)}`);if(dashboardHttpsUrl)console.log(` ${dim("➜")} ${dim("Pretty")}: ${dim(`${dashboardHttpsUrl} needs the rpx proxy - run \`buddy dev\``)}`)}console.log(` ${green("➜")} ${bold("Window")}: ${dim("Stacks Dashboard")} ${dim("1400×900")}`);console.log(` ${green("➜")} ${bold("Models")}: ${dim(`${discoveredModels.length} discovered`)}`);if(dashboardPort!==preferredPort){console.log(` ${dim("➜")} ${dim(`Port ${preferredPort} in use, using ${dashboardPort}`)}`)}if(!serverReady){console.log(` ${dim("⚠")} ${dim("Dev server may not be ready yet")}`)}console.log();console.log(` ${dim(`ready in ${elapsedMs.toFixed(0)} ms`)}`);if(verbose){console.log();console.log(` ${dim("➜")} ${dim("URL")}: ${dim(initialUrl)}`);if(dashboardDomain){console.log(` ${dim("➜")} ${dim("SSL")}: ${dim(sslBasePath)}`);console.log(` ${dim("➜")} ${dim("Proxy")}: ${dim(`localhost:${dashboardPort} → ${dashboardDomain}`)}`)}if(bufferedLogs.length>0){console.log();for(const line of bufferedLogs){console.log(` ${dim(line)}`)}}}console.log();let createApp;let resolveCraftBinary;const nativeDisabled=process.env.STACKS_NO_NATIVE==="1";const explicitCraftSdk=process.env.CRAFT_SDK_SRC;if(!nativeDisabled&&explicitCraftSdk){if(!existsSync(explicitCraftSdk))throw new Error(`CRAFT_SDK_SRC not found: ${explicitCraftSdk}`);try{({createApp,resolveCraftBinary}=await import(explicitCraftSdk));if(!createApp||!resolveCraftBinary)throw new Error("CRAFT_SDK_SRC must export createApp and resolveCraftBinary")}catch(error){throw new Error(`Could not load CRAFT_SDK_SRC ${explicitCraftSdk}: ${error instanceof Error?error.message:String(error)}`)}}if(!nativeDisabled&&!explicitCraftSdk){try{({createApp,resolveCraftBinary}=await import("craft-native"))}catch{}}const craftBinaryPath=createApp&&resolveCraftBinary?resolveDashboardCraftExecutable(resolveCraftBinary):undefined;if(createApp&&craftBinaryPath){const userIconPath=projectPath("resources/assets/images/app-icon.png");const defaultIconPath=defaultsPath("resources/assets/images/app-icon.png");const appIconPath=await Bun.file(userIconPath).exists()?userIconPath:await Bun.file(defaultIconPath).exists()?defaultIconPath:undefined;const app=createApp({url:dashboardLocalUrl,quiet:!verbose,craftPath:craftBinaryPath,window:{title:"Stacks Dashboard",width:1400,height:900,titlebarHidden:true,webSidebarMaterial:true,webSidebarWidth:250,...appIconPath&&{icon:appIconPath}}});process.on("SIGINT",()=>{app.close();process.exit(0)});process.on("SIGTERM",()=>{app.close();process.exit(0)});try{await app.show();process.exit(0)}catch(error){const fallbackUrl=dashboardHttpsUrl||dashboardLocalUrl;console.log(` ${dim("Native Craft window failed:")} ${dim(error instanceof Error?error.message:String(error))}`);console.log(` ${dim("Dashboard available at:")} ${cyan(fallbackUrl)}
4
+ `);process.exit(1)})}function portAnswers(port,timeoutMs=800){return new Promise((resolve)=>{const socket=connect({port,host:"127.0.0.1"});const finish=(answered)=>{try{socket.destroy()}catch{}resolve(answered)};socket.once("connect",()=>finish(true));socket.once("error",()=>finish(false));setTimeout(()=>finish(false),timeoutMs).unref?.()})}async function registerWithRpxDaemon(domainToServe){const{writeEntry}=await import("@stacksjs/rpx");await writeEntry({id:`${domainToServe}-dashboard`,from:`localhost:${dashboardPort}`,to:domainToServe,cwd:process.cwd(),createdAt:new Date().toISOString(),pid:process.pid},undefined,verbose);return true}async function startReverseProxy(){if(!dashboardDomain)return false;try{let rpx;const loadRpx=async()=>rpx??=await import("@stacksjs/rpx");const strategy=await resolveDashboardProxyStrategy(dashboardDomain,{proxyManagedExternally:Boolean(process.env.STACKS_PROXY_MANAGED),isDaemonRunning:async()=>(await loadRpx()).isDaemonRunning(),httpsPortAnswers:()=>portAnswers(443)});if(strategy==="origin-only")return false;if(strategy==="parent-managed")return true;if(strategy==="daemon-route")return await registerWithRpxDaemon(dashboardDomain);await(await loadRpx()).startProxies({proxies:[{from:`localhost:${dashboardPort}`,to:dashboardDomain,cleanUrls:false}],https:{basePath:sslBasePath,validityDays:825},regenerateUntrustedCerts:false,verbose});return await portAnswers(443)}catch(error){if(verbose)originalConsoleLog(` ${dim(`Proxy: ${error}`)}`);return false}}const[,allDiscoveredModels]=await Promise.all([startStxServer(),discoverProjectModels()]);const{loadDashboardConfig}=await import(defaultsPath("resources/functions/dashboard/toggles.ts"));const{feature:featureEnabled}=await import("@stacksjs/config");const{toggles:dashboardToggles,nav:dashboardNav}=await loadDashboardConfig(projectPath("config/dashboard.ts"),featureEnabled);const{frameworkModelFeature}=await import("@stacksjs/orm");const discoveredModels=modelsWithEnabledFeatures(allDiscoveredModels,frameworkModelFeature,(name)=>featureEnabled(name));const manifestDir=storagePath("framework/runtime/dashboard");const manifestPath=storagePath("framework/runtime/dashboard/.discovered-models.json");mkdirSync(manifestDir,{recursive:true});const{listModelSources}=await import("@stacksjs/database/model-sources");const manifestPayload={models:buildManifest(discoveredModels),schemaModels:(listModelSources()??[]).map((model)=>model.name),sections:dashboardToggles,nav:dashboardNav};writeFileIfChanged(manifestPath,JSON.stringify(manifestPayload,null,2));const serverReady=await waitForServer(dashboardPort);restoreConsole();const proxyStarted=await startReverseProxy().catch((err)=>{if(verbose)console.warn("[Dashboard] Reverse proxy failed:",err);return false});const dashboardHttpsUrl=dashboardDomain?`https://${dashboardDomain}`:null;const dashboardLocalUrl=`http://localhost:${dashboardPort}`;const initialUrl=dashboardHttpsUrl&&proxyStarted?`${dashboardHttpsUrl}/`:`${dashboardLocalUrl}/`;const elapsedMs=(Bun.nanoseconds()-startTime)/1e6;console.log();console.log(` ${bold(cyan("stacks dashboard"))}`);console.log();if(dashboardHttpsUrl&&proxyStarted){console.log(` ${green("➜")} ${bold("Local")}: ${cyan(dashboardHttpsUrl)}`);console.log(` ${dim("➜")} ${dim("Origin")}: ${dim(dashboardLocalUrl)}`)}else{console.log(` ${green("➜")} ${bold("Local")}: ${cyan(dashboardLocalUrl)}`);if(dashboardHttpsUrl)console.log(` ${dim("➜")} ${dim("Pretty")}: ${dim(`${dashboardHttpsUrl} needs the rpx proxy - run \`buddy dev\``)}`)}console.log(` ${green("➜")} ${bold("Window")}: ${dim("Stacks Dashboard")} ${dim("1400×900")}`);console.log(` ${green("➜")} ${bold("Models")}: ${dim(`${discoveredModels.length} discovered`)}`);if(dashboardPort!==preferredPort){console.log(` ${dim("➜")} ${dim(`Port ${preferredPort} in use, using ${dashboardPort}`)}`)}if(!serverReady){console.log(` ${dim("⚠")} ${dim("Dev server may not be ready yet")}`)}console.log();console.log(` ${dim(`ready in ${elapsedMs.toFixed(0)} ms`)}`);if(verbose){console.log();console.log(` ${dim("➜")} ${dim("URL")}: ${dim(initialUrl)}`);if(dashboardDomain){console.log(` ${dim("➜")} ${dim("SSL")}: ${dim(sslBasePath)}`);console.log(` ${dim("➜")} ${dim("Proxy")}: ${dim(`localhost:${dashboardPort} → ${dashboardDomain}`)}`)}if(bufferedLogs.length>0){console.log();for(const line of bufferedLogs){console.log(` ${dim(line)}`)}}}console.log();let createApp;let resolveCraftBinary;const nativeDisabled=process.env.STACKS_NO_NATIVE==="1";const explicitCraftSdk=process.env.CRAFT_SDK_SRC;if(!nativeDisabled&&explicitCraftSdk){if(!existsSync(explicitCraftSdk))throw new Error(`CRAFT_SDK_SRC not found: ${explicitCraftSdk}`);try{({createApp,resolveCraftBinary}=await import(explicitCraftSdk));if(!createApp||!resolveCraftBinary)throw new Error("CRAFT_SDK_SRC must export createApp and resolveCraftBinary")}catch(error){throw new Error(`Could not load CRAFT_SDK_SRC ${explicitCraftSdk}: ${error instanceof Error?error.message:String(error)}`)}}if(!nativeDisabled&&!explicitCraftSdk){try{({createApp,resolveCraftBinary}=await import("craft-native"))}catch{}}const craftBinaryPath=createApp&&resolveCraftBinary?resolveDashboardCraftExecutable(resolveCraftBinary):undefined;if(createApp&&craftBinaryPath){const userIconPath=projectPath("resources/assets/images/app-icon.png");const defaultIconPath=defaultsPath("resources/assets/images/app-icon.png");const appIconPath=await Bun.file(userIconPath).exists()?userIconPath:await Bun.file(defaultIconPath).exists()?defaultIconPath:undefined;const app=createApp({url:dashboardLocalUrl,quiet:!verbose,craftPath:craftBinaryPath,window:{title:"Stacks Dashboard",width:1400,height:900,titlebarHidden:true,webSidebarMaterial:true,webSidebarWidth:250,...appIconPath&&{icon:appIconPath}}});process.on("SIGINT",()=>{app.close();process.exit(0)});process.on("SIGTERM",()=>{app.close();process.exit(0)});try{await app.show();process.exit(0)}catch(error){const fallbackUrl=dashboardHttpsUrl||dashboardLocalUrl;console.log(` ${dim("Native Craft window failed:")} ${dim(error instanceof Error?error.message:String(error))}`);console.log(` ${dim("Dashboard available at:")} ${cyan(fallbackUrl)}
5
5
  `);await new Promise(()=>{})}}else{const nativeMessage=nativeDisabled?"Native window disabled by STACKS_NO_NATIVE=1. Open the URL above in a browser.":"Native window unavailable. Run pantry install craft, set CRAFT_BIN, or open the URL above in a browser.";console.log(` ${dim(nativeMessage)}
6
6
  `);process.on("SIGINT",()=>process.exit(0));process.on("SIGTERM",()=>process.exit(0));await new Promise(()=>{})}
@@ -1,4 +1,4 @@
1
- import{dirname}from"node:path";import{MERMAID_MAX_TEXT_SIZE,renderErd,resolveModelSources,toDiagrammableModel}from"@stacksjs/database";import{log}from"@stacksjs/logging";import{path}from"@stacksjs/path";import{fs}from"@stacksjs/storage";const DETAIL_STEPS=["full","keys","none"];function fitDiagram(models,options){const only=options.only&&options.only.length>0?{only:options.only}:{};const asked=options.detail??(options.noColumns?"none":undefined);if(asked)return{diagram:renderErd(models,{detail:asked,...only}),detail:asked};let last="";for(const detail of DETAIL_STEPS){last=renderErd(models,{detail,...only});if(last.length<=MERMAID_MAX_TEXT_SIZE)return{diagram:last,detail}}return{diagram:last,detail:DETAIL_STEPS[DETAIL_STEPS.length-1]}}function tableNameFor(definition,fileName){if(definition?.table)return definition.table;const name=definition?.name??fileName;const snake=name.replace(/([a-z0-9])([A-Z])/g,"$1_$2").toLowerCase();if(/(?:s|x|z|ch|sh)$/.test(snake))return`${snake}es`;if(/[^aeiou]y$/.test(snake))return`${snake.slice(0,-1)}ies`;return`${snake}s`}export function wrapForTarget(diagram,outPath){return outPath.endsWith(".md")?`# Entity Relationships
1
+ import{dirname}from"node:path";import{listModelSources,MERMAID_MAX_TEXT_SIZE,renderErd,toDiagrammableModel}from"@stacksjs/database";import{log}from"@stacksjs/logging";import{path}from"@stacksjs/path";import{fs}from"@stacksjs/storage";const DETAIL_STEPS=["full","keys","none"];function fitDiagram(models,options){const only=options.only&&options.only.length>0?{only:options.only}:{};const asked=options.detail??(options.noColumns?"none":undefined);if(asked)return{diagram:renderErd(models,{detail:asked,...only}),detail:asked};let last="";for(const detail of DETAIL_STEPS){last=renderErd(models,{detail,...only});if(last.length<=MERMAID_MAX_TEXT_SIZE)return{diagram:last,detail}}return{diagram:last,detail:DETAIL_STEPS[DETAIL_STEPS.length-1]}}function tableNameFor(definition,fileName){if(definition?.table)return definition.table;const name=definition?.name??fileName;const snake=name.replace(/([a-z0-9])([A-Z])/g,"$1_$2").toLowerCase();if(/(?:s|x|z|ch|sh)$/.test(snake))return`${snake}es`;if(/[^aeiou]y$/.test(snake))return`${snake.slice(0,-1)}ies`;return`${snake}s`}export function wrapForTarget(diagram,outPath){return outPath.endsWith(".md")?`# Entity Relationships
2
2
 
3
3
  <!-- Generated by \`buddy generate:erd\`. Edit your models, not this. -->
4
4
 
@@ -6,4 +6,4 @@ import{dirname}from"node:path";import{MERMAID_MAX_TEXT_SIZE,renderErd,resolveMod
6
6
  ${diagram}
7
7
  \`\`\`
8
8
  `:`${diagram}
9
- `}export async function generateErd(options={}){const sources=resolveModelSources();if(!sources||sources.models.length===0)return{ok:false,error:"No models found. The diagram is derived from your models, so there is nothing to generate."};const models=[];const skipped=[];for(const source of sources.models){try{const definition=(await import(source.file)).default;if(!definition)continue;models.push(toDiagrammableModel(definition,tableNameFor(definition,source.name)))}catch(error){skipped.push(`${source.name}: ${error.message}`)}}for(const failure of skipped)log.warn(`[generate:erd] skipped ${failure}`);if(models.length===0)return{ok:false,error:"Every model failed to load; nothing to diagram."};const{diagram,detail}=fitDiagram(models,options);const truncated=diagram.length>MERMAID_MAX_TEXT_SIZE;if(truncated)log.warn(`[generate:erd] ${diagram.length} characters is past Mermaid's ${MERMAID_MAX_TEXT_SIZE} limit; it will draw an error box rather than a diagram. Narrow it with --only.`);else if(detail!=="full")log.info(`[generate:erd] drew ${detail==="keys"?"key columns only":"relationships only"}, so the diagram stays inside Mermaid's ${MERMAID_MAX_TEXT_SIZE}-character limit.`);const outPath=path.projectPath(options.out??"docs/erd.md");if(!options.dryRun){fs.mkdirSync(dirname(outPath),{recursive:true});await Bun.write(outPath,wrapForTarget(diagram,outPath))}return{ok:true,diagram,path:outPath,modelCount:models.length,skipped,detail,characters:diagram.length,truncated}}
9
+ `}export async function generateErd(options={}){const sources=listModelSources();if(!sources||sources.length===0)return{ok:false,error:"No models found. The diagram is derived from your models, so there is nothing to generate."};const models=[];const skipped=[];for(const source of sources){try{const definition=(await import(source.file)).default;if(!definition)continue;models.push(toDiagrammableModel(definition,tableNameFor(definition,source.name)))}catch(error){skipped.push(`${source.name}: ${error.message}`)}}for(const failure of skipped)log.warn(`[generate:erd] skipped ${failure}`);if(models.length===0)return{ok:false,error:"Every model failed to load; nothing to diagram."};const{diagram,detail}=fitDiagram(models,options);const truncated=diagram.length>MERMAID_MAX_TEXT_SIZE;if(truncated)log.warn(`[generate:erd] ${diagram.length} characters is past Mermaid's ${MERMAID_MAX_TEXT_SIZE} limit; it will draw an error box rather than a diagram. Narrow it with --only.`);else if(detail!=="full")log.info(`[generate:erd] drew ${detail==="keys"?"key columns only":"relationships only"}, so the diagram stays inside Mermaid's ${MERMAID_MAX_TEXT_SIZE}-character limit.`);const outPath=path.projectPath(options.out??"docs/erd.md");if(!options.dryRun){fs.mkdirSync(dirname(outPath),{recursive:true});await Bun.write(outPath,wrapForTarget(diagram,outPath))}return{ok:true,diagram,path:outPath,modelCount:models.length,skipped,detail,characters:diagram.length,truncated}}
@@ -1,2 +1,2 @@
1
- import{dirname}from"node:path";import{deriveVSchema,formatShardingReport,resolveModelSources,toShardableModel}from"@stacksjs/database";import{log}from"@stacksjs/logging";import{path}from"@stacksjs/path";import{fs}from"@stacksjs/storage";function tableNameFor(definition,fileName){if(definition?.table)return definition.table;const name=definition?.name??fileName;const snake=name.replace(/([a-z0-9])([A-Z])/g,"$1_$2").toLowerCase();if(/(?:s|x|z|ch|sh)$/.test(snake))return`${snake}es`;if(/[^aeiou]y$/.test(snake))return`${snake.slice(0,-1)}ies`;return`${snake}s`}export async function generateVSchema(options={}){const sources=resolveModelSources();if(!sources||sources.models.length===0)return{ok:false,error:"No models found. A VSchema is derived from your models, so there is nothing to generate."};const models=[];const failed=[];for(const source of sources.models){try{const definition=(await import(source.file)).default;if(!definition)continue;models.push(toShardableModel(definition,tableNameFor(definition,source.name)))}catch(error){failed.push(`${source.name}: ${error.message}`)}}for(const failure of failed)log.warn(`[generate:vschema] skipped ${failure}`);if(models.length===0)return{ok:false,error:"Every model failed to load; nothing to derive a VSchema from."};const{vschema,decisions}=deriveVSchema(models);const report=formatShardingReport(decisions);const outPath=path.projectPath(options.out??"database/vschema.json");if(!options.dryRun){fs.mkdirSync(dirname(outPath),{recursive:true});await Bun.write(outPath,`${JSON.stringify(vschema,null,2)}
1
+ import{dirname}from"node:path";import{deriveVSchema,formatShardingReport,listModelSources,toShardableModel}from"@stacksjs/database";import{log}from"@stacksjs/logging";import{path}from"@stacksjs/path";import{fs}from"@stacksjs/storage";function tableNameFor(definition,fileName){if(definition?.table)return definition.table;const name=definition?.name??fileName;const snake=name.replace(/([a-z0-9])([A-Z])/g,"$1_$2").toLowerCase();if(/(?:s|x|z|ch|sh)$/.test(snake))return`${snake}es`;if(/[^aeiou]y$/.test(snake))return`${snake.slice(0,-1)}ies`;return`${snake}s`}export async function generateVSchema(options={}){const sources=listModelSources();if(!sources||sources.length===0)return{ok:false,error:"No models found. A VSchema is derived from your models, so there is nothing to generate."};const models=[];const failed=[];for(const source of sources){try{const definition=(await import(source.file)).default;if(!definition)continue;models.push(toShardableModel(definition,tableNameFor(definition,source.name)))}catch(error){failed.push(`${source.name}: ${error.message}`)}}for(const failure of failed)log.warn(`[generate:vschema] skipped ${failure}`);if(models.length===0)return{ok:false,error:"Every model failed to load; nothing to derive a VSchema from."};const{vschema,decisions}=deriveVSchema(models);const report=formatShardingReport(decisions);const outPath=path.projectPath(options.out??"database/vschema.json");if(!options.dryRun){fs.mkdirSync(dirname(outPath),{recursive:true});await Bun.write(outPath,`${JSON.stringify(vschema,null,2)}
2
2
  `)}return{ok:true,vschema,report,path:outPath,tableCount:Object.keys(vschema.tables).length}}
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@stacksjs/actions",
3
3
  "type": "module",
4
4
  "sideEffects": false,
5
- "version": "0.75.557",
5
+ "version": "0.75.558",
6
6
  "description": "The Stacks actions.",
7
7
  "author": "Chris Breuer",
8
8
  "contributors": [
@@ -66,55 +66,55 @@
66
66
  "prepublishOnly": "bun run build"
67
67
  },
68
68
  "dependencies": {
69
- "@stacksjs/action-runner": "0.75.557",
70
- "@stacksjs/ai": "0.75.557",
71
- "@stacksjs/analytics": "0.75.557",
72
- "@stacksjs/api": "0.75.557",
73
- "@stacksjs/auth": "0.75.557",
74
- "@stacksjs/build": "0.75.557",
69
+ "@stacksjs/action-runner": "0.75.558",
70
+ "@stacksjs/ai": "0.75.558",
71
+ "@stacksjs/analytics": "0.75.558",
72
+ "@stacksjs/api": "0.75.558",
73
+ "@stacksjs/auth": "0.75.558",
74
+ "@stacksjs/build": "0.75.558",
75
75
  "@stacksjs/bumpx": "^0.2.26",
76
76
  "@stacksjs/bunpress": "^0.2.15",
77
- "@stacksjs/cli": "0.75.557",
78
- "@stacksjs/cloud": "0.75.557",
79
- "@stacksjs/cms": "0.75.557",
77
+ "@stacksjs/cli": "0.75.558",
78
+ "@stacksjs/cloud": "0.75.558",
79
+ "@stacksjs/cms": "0.75.558",
80
80
  "@stacksjs/components": "^0.2.864",
81
- "@stacksjs/config": "0.75.557",
82
- "@stacksjs/database": "0.75.557",
83
- "@stacksjs/desktop-build": "0.75.557",
84
- "@stacksjs/dns": "0.75.557",
85
- "@stacksjs/docs": "0.75.557",
86
- "@stacksjs/enums": "0.75.557",
87
- "@stacksjs/env": "0.75.557",
88
- "@stacksjs/error-handling": "0.75.557",
89
- "@stacksjs/github": "0.75.557",
81
+ "@stacksjs/config": "0.75.558",
82
+ "@stacksjs/database": "0.75.558",
83
+ "@stacksjs/desktop-build": "0.75.558",
84
+ "@stacksjs/dns": "0.75.558",
85
+ "@stacksjs/docs": "0.75.558",
86
+ "@stacksjs/enums": "0.75.558",
87
+ "@stacksjs/env": "0.75.558",
88
+ "@stacksjs/error-handling": "0.75.558",
89
+ "@stacksjs/github": "0.75.558",
90
90
  "@stacksjs/gitit": "^0.2.5",
91
- "@stacksjs/i18n": "0.75.557",
92
- "@stacksjs/image": "0.75.557",
93
- "@stacksjs/logging": "0.75.557",
91
+ "@stacksjs/i18n": "0.75.558",
92
+ "@stacksjs/image": "0.75.558",
93
+ "@stacksjs/logging": "0.75.558",
94
94
  "@stacksjs/logsmith": "^0.2.11",
95
- "@stacksjs/mobile": "0.75.557",
96
- "@stacksjs/orm": "0.75.557",
97
- "@stacksjs/path": "0.75.557",
98
- "@stacksjs/payments": "0.75.557",
99
- "@stacksjs/queue": "0.75.557",
100
- "@stacksjs/registry": "0.75.557",
101
- "@stacksjs/router": "0.75.557",
95
+ "@stacksjs/mobile": "0.75.558",
96
+ "@stacksjs/orm": "0.75.558",
97
+ "@stacksjs/path": "0.75.558",
98
+ "@stacksjs/payments": "0.75.558",
99
+ "@stacksjs/queue": "0.75.558",
100
+ "@stacksjs/registry": "0.75.558",
101
+ "@stacksjs/router": "0.75.558",
102
102
  "@stacksjs/rpx": "^0.11.54",
103
- "@stacksjs/scheduler": "0.75.557",
104
- "@stacksjs/search-engine": "0.75.557",
105
- "@stacksjs/security": "0.75.557",
106
- "@stacksjs/server": "0.75.557",
107
- "@stacksjs/sites": "0.75.557",
108
- "@stacksjs/storage": "0.75.557",
109
- "@stacksjs/strings": "0.75.557",
103
+ "@stacksjs/scheduler": "0.75.558",
104
+ "@stacksjs/search-engine": "0.75.558",
105
+ "@stacksjs/security": "0.75.558",
106
+ "@stacksjs/server": "0.75.558",
107
+ "@stacksjs/sites": "0.75.558",
108
+ "@stacksjs/storage": "0.75.558",
109
+ "@stacksjs/strings": "0.75.558",
110
110
  "@stacksjs/stx": "^0.2.864",
111
111
  "@stacksjs/tlsx": "^0.13.19",
112
112
  "@stacksjs/ts-cloud": "^0.16.125",
113
113
  "@stacksjs/ts-md": "^0.1.1",
114
- "@stacksjs/tunnel": "0.75.557",
115
- "@stacksjs/types": "0.75.557",
116
- "@stacksjs/utils": "0.75.557",
117
- "@stacksjs/whois": "0.75.557",
114
+ "@stacksjs/tunnel": "0.75.558",
115
+ "@stacksjs/types": "0.75.558",
116
+ "@stacksjs/utils": "0.75.558",
117
+ "@stacksjs/whois": "0.75.558",
118
118
  "bun-plugin-stx": "^0.2.864",
119
119
  "pickier": "^0.1.92"
120
120
  },
@@ -127,7 +127,7 @@
127
127
  }
128
128
  },
129
129
  "devDependencies": {
130
- "@stacksjs/validation": "0.75.557",
130
+ "@stacksjs/validation": "0.75.558",
131
131
  "better-dx": "^0.2.24"
132
132
  }
133
133
  }