@stacksjs/actions 0.75.515 → 0.75.519

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.
Files changed (151) hide show
  1. package/dist/action.js +1 -1
  2. package/dist/auth/client-options.js +1 -1
  3. package/dist/auth/client.js +1 -1
  4. package/dist/auth/prune.js +1 -1
  5. package/dist/auth/setup.js +2 -2
  6. package/dist/blog-admin.js +3 -3
  7. package/dist/blog.js +23 -23
  8. package/dist/build/android-config.js +1 -1
  9. package/dist/build/android-icons.js +1 -1
  10. package/dist/build/android.js +1 -1
  11. package/dist/build/component-library.js +1 -1
  12. package/dist/build/core.js +1 -1
  13. package/dist/build/craft-entry.js +1 -1
  14. package/dist/build/craft-provenance.js +1 -1
  15. package/dist/build/desktop-macos.js +2 -2
  16. package/dist/build/desktop.js +2 -2
  17. package/dist/build/dmg-macos.js +1 -1
  18. package/dist/build/dmg.js +1 -1
  19. package/dist/build/docs.js +1 -1
  20. package/dist/build/frontend-static.js +5 -5
  21. package/dist/build/ios-config.js +3 -3
  22. package/dist/build/ios-shell.js +3 -3
  23. package/dist/build/ios-toolchain.js +2 -2
  24. package/dist/build/ios.js +2 -2
  25. package/dist/build/macos-native.js +3 -3
  26. package/dist/build/mobile-splash.js +1 -1
  27. package/dist/build/mobile-target.js +1 -1
  28. package/dist/build/native-screens.js +1 -1
  29. package/dist/build/native-sensors.js +1 -1
  30. package/dist/build/notarize.js +2 -2
  31. package/dist/build/run-build-step.js +1 -1
  32. package/dist/build/stacks.js +1 -1
  33. package/dist/build/views.js +1 -1
  34. package/dist/build.js +1 -1
  35. package/dist/bump.js +7 -7
  36. package/dist/calendar-version.js +1 -1
  37. package/dist/changelog.js +1 -1
  38. package/dist/check/ports.js +1 -1
  39. package/dist/commit.js +1 -1
  40. package/dist/database/seed.js +1 -1
  41. package/dist/deploy/create-receipt-rule.js +1 -1
  42. package/dist/deploy/hooks.js +1 -1
  43. package/dist/deploy/index.js +17 -17
  44. package/dist/deploy/stack.js +6 -6
  45. package/dist/dev/api.js +1 -1
  46. package/dist/dev/components.js +1 -1
  47. package/dist/dev/csrf.js +1 -1
  48. package/dist/dev/dashboard-native.js +1 -1
  49. package/dist/dev/dashboard-request-routing.js +1 -1
  50. package/dist/dev/dashboard-supervisor.js +2 -2
  51. package/dist/dev/dashboard-utils.js +1 -1
  52. package/dist/dev/dashboard.js +4 -4
  53. package/dist/dev/defaults-resources.js +1 -1
  54. package/dist/dev/docs.js +1 -1
  55. package/dist/dev/exit-with-parent.js +1 -1
  56. package/dist/dev/migrate-watcher.js +1 -1
  57. package/dist/dev/system-tray.js +2 -2
  58. package/dist/dev/tray-origin.js +1 -1
  59. package/dist/dev/views.js +1 -1
  60. package/dist/discover-packages.js +1 -1
  61. package/dist/domains/add.js +1 -1
  62. package/dist/domains/purchase.js +1 -1
  63. package/dist/domains/remove.js +1 -1
  64. package/dist/examples.js +1 -1
  65. package/dist/find-projects.js +1 -1
  66. package/dist/generate/action-types.js +3 -3
  67. package/dist/generate/erd.js +2 -2
  68. package/dist/generate/ide-helpers.js +1 -1
  69. package/dist/generate/images.js +1 -1
  70. package/dist/generate/index.js +1 -1
  71. package/dist/generate/lib-entries.js +1 -1
  72. package/dist/generate/vschema.js +2 -2
  73. package/dist/github-release.js +5 -5
  74. package/dist/helpers/api-host.js +3 -3
  75. package/dist/helpers/api-shutdown.js +1 -1
  76. package/dist/helpers/component-meta.js +3 -3
  77. package/dist/helpers/utils.js +1 -1
  78. package/dist/helpers/vscode-custom-data.js +1 -1
  79. package/dist/key-generate.js +1 -1
  80. package/dist/library/build.js +2 -2
  81. package/dist/library/entries.js +1 -1
  82. package/dist/library/globals.js +1 -1
  83. package/dist/library/manifest.js +2 -2
  84. package/dist/library/packages.js +1 -1
  85. package/dist/library/publish.js +2 -2
  86. package/dist/library-publish.js +1 -1
  87. package/dist/lint/files.js +1 -1
  88. package/dist/lint/lint.js +1 -1
  89. package/dist/lint/stx-gate.js +3 -3
  90. package/dist/make-command.js +2 -2
  91. package/dist/make-job.js +2 -2
  92. package/dist/make-policy.js +2 -2
  93. package/dist/make-resource.js +1 -1
  94. package/dist/make.js +7 -7
  95. package/dist/migrate/database.js +1 -1
  96. package/dist/migrate/fresh.js +1 -1
  97. package/dist/pantry-lock.js +1 -1
  98. package/dist/pantry-toolchain.js +1 -1
  99. package/dist/project-scripts.js +1 -1
  100. package/dist/publication-preflight.js +1 -1
  101. package/dist/queue/clear.js +1 -1
  102. package/dist/queue/dlq-purge.js +1 -1
  103. package/dist/queue/dlq-retry.js +1 -1
  104. package/dist/queue/dlq.js +2 -2
  105. package/dist/queue/failed.js +2 -2
  106. package/dist/queue/flush.js +1 -1
  107. package/dist/queue/inspect.js +6 -6
  108. package/dist/queue/list.js +2 -2
  109. package/dist/queue/monitor.js +5 -5
  110. package/dist/queue/options.js +1 -1
  111. package/dist/queue/pause.js +1 -1
  112. package/dist/queue/quarantine.js +1 -1
  113. package/dist/queue/resume.js +1 -1
  114. package/dist/queue/retry.js +1 -1
  115. package/dist/queue/schedule-list.js +2 -2
  116. package/dist/queue/status.js +2 -2
  117. package/dist/queue/unquarantine.js +1 -1
  118. package/dist/queue/work.js +1 -1
  119. package/dist/release-evidence.js +1 -1
  120. package/dist/release-notes.js +5 -5
  121. package/dist/release-preflight.js +2 -2
  122. package/dist/release-push-target.js +3 -3
  123. package/dist/release.js +1 -1
  124. package/dist/reviewos-evidence.js +1 -1
  125. package/dist/route/list.js +1 -1
  126. package/dist/saas/setup.js +1 -1
  127. package/dist/scaffold-crud.js +7 -7
  128. package/dist/search/flush.js +1 -1
  129. package/dist/search/import.js +1 -1
  130. package/dist/search/settings-list.js +1 -1
  131. package/dist/seo.js +4 -4
  132. package/dist/serve/api.js +1 -1
  133. package/dist/serve/dashboard-gate.js +1 -1
  134. package/dist/serve/dashboard.js +1 -1
  135. package/dist/setup/ssl.js +2 -2
  136. package/dist/stacks.js +1 -1
  137. package/dist/stx-source.js +1 -1
  138. package/dist/test/feature.js +1 -1
  139. package/dist/test/runner.js +1 -1
  140. package/dist/test/unit.js +1 -1
  141. package/dist/upgrade/binary.js +1 -1
  142. package/dist/upgrade/framework-hooks.d.ts +6 -0
  143. package/dist/upgrade/framework-hooks.js +1 -1
  144. package/dist/upgrade/framework-utils.js +2 -2
  145. package/dist/upgrade/framework.js +10 -10
  146. package/dist/upgrade/package-project.js +2 -2
  147. package/dist/upgrade/packages.js +23 -22
  148. package/dist/upgrade/route-actions.js +3 -3
  149. package/dist/upgrade/shell.js +4 -4
  150. package/dist/upgrade.js +1 -1
  151. package/package.json +40 -40
@@ -1,2 +1,2 @@
1
- import{existsSync}from"node:fs";import{relative,resolve}from"node:path";import{log}from"@stacksjs/logging";import{projectPath}from"@stacksjs/path";import{configuredLibrary,LibraryConfigError,resolveLibraryPackages}from"./packages";export async function planLibraryPublish(config){const publishable=(await resolveLibraryPackages(config??await configuredLibrary())).filter((pkg)=>!pkg.private);if(!publishable.length)throw new LibraryConfigError("Every configured library package is marked private. Nothing to publish.");const plans=[],missing=[];for(const pkg of publishable){const manifestPath=resolve(pkg.dir,"package.json"),distDir=resolve(pkg.dir,"dist");if(!existsSync(manifestPath)||!existsSync(distDir)){missing.push(pkg.name);continue}const built=await Array.fromAsync(new Bun.Glob("**/*.{js,css,json,d.ts}").scan({cwd:distDir}));if(!built.length){missing.push(pkg.name);continue}const manifest=await Bun.file(manifestPath).json();plans.push({name:pkg.name,version:manifest.version??"0.0.0",dir:pkg.dir,access:pkg.access,registry:pkg.registry,tarballFiles:built.length})}if(missing.length)throw new LibraryConfigError(`These packages have no build output: ${missing.join(", ")}.
2
- Run \`buddy build:libs\` before publishing.`);return plans}export function publishCommand(registry="pantry",which=Bun.which){if(which("pantry"))return registry==="npm"?["pantry","publish","--npm"]:["pantry","publish"];if(registry==="pantry")throw Error("This package publishes to the Pantry registry, which only `pantry publish` reaches, and `pantry` is not on PATH. Install pantry, or set `registry: 'npm'` on the package in config/library.ts.");if(which("bun"))return["bun","publish"];if(which("npm"))return["npm","publish"];throw Error("None of `pantry`, `bun` or `npm` is on PATH, so there is nothing to publish with.")}export async function publishLibraryPackages(options={}){const plans=await planLibraryPublish(options.config);for(const plan of plans){const args=[...publishCommand(plan.registry),"--access",plan.access];if(options.dryRun)args.push("--dry-run");log.info(`${options.dryRun?"[dry run] ":""}${args.join(" ")} (${plan.name}@${plan.version}, ${relative(projectPath(),plan.dir)})`);const proc=Bun.spawnSync({cmd:args,cwd:plan.dir,stdout:"inherit",stderr:"inherit"});if(proc.exitCode!==0)throw Error(`Publishing ${plan.name}@${plan.version} failed with exit code ${proc.exitCode}.`)}return plans}
1
+ import{existsSync}from"node:fs";import{relative,resolve}from"node:path";import{log}from"@stacksjs/logging";import{projectPath}from"@stacksjs/path";import{configuredLibrary,LibraryConfigError,resolveLibraryPackages}from"./packages";export async function planLibraryPublish(config){const packages=await resolveLibraryPackages(config??await configuredLibrary());const publishable=packages.filter((pkg)=>!pkg.private);if(!publishable.length)throw new LibraryConfigError("Every configured library package is marked private. Nothing to publish.");const plans=[];const missing=[];for(const pkg of publishable){const manifestPath=resolve(pkg.dir,"package.json");const distDir=resolve(pkg.dir,"dist");if(!existsSync(manifestPath)||!existsSync(distDir)){missing.push(pkg.name);continue}const built=await Array.fromAsync(new Bun.Glob("**/*.{js,css,json,d.ts}").scan({cwd:distDir}));if(!built.length){missing.push(pkg.name);continue}const manifest=await Bun.file(manifestPath).json();plans.push({name:pkg.name,version:manifest.version??"0.0.0",dir:pkg.dir,access:pkg.access,registry:pkg.registry,tarballFiles:built.length})}if(missing.length){throw new LibraryConfigError(`These packages have no build output: ${missing.join(", ")}.
2
+ Run \`buddy build:libs\` before publishing.`)}return plans}export function publishCommand(registry="pantry",which=Bun.which){if(which("pantry"))return registry==="npm"?["pantry","publish","--npm"]:["pantry","publish"];if(registry==="pantry")throw new Error("This package publishes to the Pantry registry, which only `pantry publish` reaches, and `pantry` is not on PATH. Install pantry, or set `registry: 'npm'` on the package in config/library.ts.");if(which("bun"))return["bun","publish"];if(which("npm"))return["npm","publish"];throw new Error("None of `pantry`, `bun` or `npm` is on PATH, so there is nothing to publish with.")}export async function publishLibraryPackages(options={}){const plans=await planLibraryPublish(options.config);for(const plan of plans){const args=[...publishCommand(plan.registry),"--access",plan.access];if(options.dryRun)args.push("--dry-run");log.info(`${options.dryRun?"[dry run] ":""}${args.join(" ")} (${plan.name}@${plan.version}, ${relative(projectPath(),plan.dir)})`);const proc=Bun.spawnSync({cmd:args,cwd:plan.dir,stdout:"inherit",stderr:"inherit"});if(proc.exitCode!==0)throw new Error(`Publishing ${plan.name}@${plan.version} failed with exit code ${proc.exitCode}.`)}return plans}
@@ -1 +1 @@
1
- import{parseOptions}from"@stacksjs/cli";import{log}from"@stacksjs/logging";import{publishLibraryPackages}from"./library/publish";const options=parseOptions(),dryRun=options?.dryRun===!0||String(options?.dryRun)==="true",plans=await publishLibraryPackages({dryRun});log.success(dryRun?`Dry run complete. ${plans.length} package(s) would publish: ${plans.map((plan)=>`${plan.name}@${plan.version}`).join(", ")}`:`Published ${plans.map((plan)=>`${plan.name}@${plan.version}`).join(", ")}`);
1
+ import{parseOptions}from"@stacksjs/cli";import{log}from"@stacksjs/logging";import{publishLibraryPackages}from"./library/publish";const options=parseOptions();const dryRun=options?.dryRun===true||String(options?.dryRun)==="true";const plans=await publishLibraryPackages({dryRun});log.success(dryRun?`Dry run complete. ${plans.length} package(s) would publish: ${plans.map((plan)=>`${plan.name}@${plan.version}`).join(", ")}`:`Published ${plans.map((plan)=>`${plan.name}@${plan.version}`).join(", ")}`);
@@ -1 +1 @@
1
- const lintableFile=/\.(?:ts|js|stx|json|md|yaml|yml)$/i,ignoredPath=/(?:^|\/)(?:node_modules|dist|pantry|storage\/framework\/cache|\.git|\.stx|\.stx-serve)(?:\/|$)/;export function isLintablePath(file){return isLintableExtension(file)&&!isIgnoredLocation(file)}export function isLintableExtension(file){return lintableFile.test(file)}export function isIgnoredLocation(file){return ignoredPath.test(file)}
1
+ const lintableFile=/\.(?:ts|js|stx|json|md|yaml|yml)$/i;const ignoredPath=/(?:^|\/)(?:node_modules|dist|pantry|storage\/framework\/cache|\.git|\.stx|\.stx-serve)(?:\/|$)/;export function isLintablePath(file){return isLintableExtension(file)&&!isIgnoredLocation(file)}export function isLintableExtension(file){return lintableFile.test(file)}export function isIgnoredLocation(file){return ignoredPath.test(file)}
package/dist/lint/lint.js CHANGED
@@ -1 +1 @@
1
- import process from"node:process";import{log}from"@stacksjs/cli";import{spawnSync}from"node:child_process";import{existsSync,statSync}from"node:fs";import{join,relative,resolve}from"node:path";import{runFormat,runLint}from"pickier";import{isIgnoredLocation,isLintableExtension,isLintablePath}from"./files";export function lintableFiles(cwd){const listed=spawnSync("git",["ls-files","-z","--cached","--others","--exclude-standard"],{cwd,encoding:"utf8",maxBuffer:268435456});if(listed.status===0)return listed.stdout.split("\x00").filter(isLintablePath);const notInstalled=listed.error?.code==="ENOENT",stderr=(listed.stderr??"").trim();if(notInstalled&&!existsSync(join(cwd,".git"))||/not a git repository/i.test(stderr))return walkLintableFiles(cwd);const reason=listed.error?.message||stderr||`exit code ${listed.status??listed.signal}`;throw Error(`Could not list the files to lint: \`git ls-files\` failed in ${cwd} (${reason})`)}export function selectLintableFiles(cwd,paths){const all=lintableFiles(cwd),pool=new Set(all),selected=new Set;for(const named of paths){const rel=projectRelative(cwd,named);if(rel===null)throw Error(`Cannot lint ${named}: it is outside the project at ${cwd}`);if(rel===""){for(const file of all)selected.add(file);continue}if(pool.has(rel)){selected.add(rel);continue}const under=all.filter((file)=>file.startsWith(`${rel}/`));if(under.length===0)throw Error(whyNotLintable(cwd,named,rel));for(const file of under)selected.add(file)}return[...selected].sort()}function projectRelative(cwd,named){const rel=relative(cwd,resolve(cwd,named)).split("\\").join("/").replace(/\/+$/,"");if(rel===".."||rel.startsWith("../"))return null;return rel==="."?"":rel}function whyNotLintable(cwd,named,rel){const onDisk=join(cwd,rel);if(!existsSync(onDisk))return`Cannot lint ${named}: no such file or directory`;if(isIgnoredLocation(rel))return`Cannot lint ${named}: it is dependency, build or cache output, which buddy lint never reads`;if(statSync(onDisk).isDirectory())return`Cannot lint ${named}: it holds no files buddy lint handles`;if(!isLintableExtension(rel))return`Cannot lint ${named}: buddy lint handles .ts, .js, .stx, .json, .md, .yaml and .yml files`;return`Cannot lint ${named}: it is not one of the project's files, so .gitignore excludes it`}function walkLintableFiles(cwd){return Array.from(new Bun.Glob("**/*").scanSync({cwd,onlyFiles:!0,dot:!0})).map((file)=>file.split("\\").join("/")).filter(isLintablePath).sort()}export async function lintProject(options={}){const cwd=options.cwd??process.cwd();log.info(options.fix?"Ensuring Code Style...":"Checking Code Style...");const maxWarnings=options.maxWarnings??9999;if(!Number.isInteger(maxWarnings)||maxWarnings<-1){await log.error("maxWarnings must be an integer of -1 or greater");return{ok:!1}}let files;try{files=options.paths?.length?selectLintableFiles(cwd,options.paths):lintableFiles(cwd)}catch(error){await log.error(error instanceof Error?error.message:String(error));return{ok:!1}}if(!files.length){log.success("Linted: no lintable files");return{ok:!0}}const ok=await runLint(files,{maxWarnings,fix:options.fix})===0;if(ok)log.success("Linted");return{ok}}export function lintFix(options={}){return lintProject({...options,fix:!0})}export async function formatProject(options={}){const cwd=options.cwd??process.cwd();let files;try{files=options.paths?.length?selectLintableFiles(cwd,options.paths):lintableFiles(cwd)}catch(error){await log.error(error instanceof Error?error.message:String(error));return{ok:!1}}if(!files.length)return{ok:!0};return{ok:await runFormat(files,{write:options.write,check:options.check})===0}}
1
+ import process from"node:process";import{log}from"@stacksjs/cli";import{spawnSync}from"node:child_process";import{existsSync,statSync}from"node:fs";import{join,relative,resolve}from"node:path";import{runFormat,runLint}from"pickier";import{isIgnoredLocation,isLintableExtension,isLintablePath}from"./files";export function lintableFiles(cwd){const listed=spawnSync("git",["ls-files","-z","--cached","--others","--exclude-standard"],{cwd,encoding:"utf8",maxBuffer:256*1024*1024});if(listed.status===0)return listed.stdout.split("\x00").filter(isLintablePath);const notInstalled=listed.error?.code==="ENOENT";const stderr=(listed.stderr??"").trim();if(notInstalled&&!existsSync(join(cwd,".git"))||/not a git repository/i.test(stderr))return walkLintableFiles(cwd);const reason=listed.error?.message||stderr||`exit code ${listed.status??listed.signal}`;throw new Error(`Could not list the files to lint: \`git ls-files\` failed in ${cwd} (${reason})`)}export function selectLintableFiles(cwd,paths){const all=lintableFiles(cwd);const pool=new Set(all);const selected=new Set;for(const named of paths){const rel=projectRelative(cwd,named);if(rel===null)throw new Error(`Cannot lint ${named}: it is outside the project at ${cwd}`);if(rel===""){for(const file of all)selected.add(file);continue}if(pool.has(rel)){selected.add(rel);continue}const under=all.filter((file)=>file.startsWith(`${rel}/`));if(under.length===0)throw new Error(whyNotLintable(cwd,named,rel));for(const file of under)selected.add(file)}return[...selected].sort()}function projectRelative(cwd,named){const rel=relative(cwd,resolve(cwd,named)).split("\\").join("/").replace(/\/+$/,"");if(rel===".."||rel.startsWith("../"))return null;return rel==="."?"":rel}function whyNotLintable(cwd,named,rel){const onDisk=join(cwd,rel);if(!existsSync(onDisk))return`Cannot lint ${named}: no such file or directory`;if(isIgnoredLocation(rel))return`Cannot lint ${named}: it is dependency, build or cache output, which buddy lint never reads`;if(statSync(onDisk).isDirectory())return`Cannot lint ${named}: it holds no files buddy lint handles`;if(!isLintableExtension(rel))return`Cannot lint ${named}: buddy lint handles .ts, .js, .stx, .json, .md, .yaml and .yml files`;return`Cannot lint ${named}: it is not one of the project's files, so .gitignore excludes it`}function walkLintableFiles(cwd){return Array.from(new Bun.Glob("**/*").scanSync({cwd,onlyFiles:true,dot:true})).map((file)=>file.split("\\").join("/")).filter(isLintablePath).sort()}export async function lintProject(options={}){const cwd=options.cwd??process.cwd();log.info(options.fix?"Ensuring Code Style...":"Checking Code Style...");const maxWarnings=options.maxWarnings??9999;if(!Number.isInteger(maxWarnings)||maxWarnings<-1){await log.error("maxWarnings must be an integer of -1 or greater");return{ok:false}}let files;try{files=options.paths?.length?selectLintableFiles(cwd,options.paths):lintableFiles(cwd)}catch(error){await log.error(error instanceof Error?error.message:String(error));return{ok:false}}if(!files.length){log.success("Linted: no lintable files");return{ok:true}}const code=await runLint(files,{maxWarnings,fix:options.fix});const ok=code===0;if(ok)log.success("Linted");return{ok}}export function lintFix(options={}){return lintProject({...options,fix:true})}export async function formatProject(options={}){const cwd=options.cwd??process.cwd();let files;try{files=options.paths?.length?selectLintableFiles(cwd,options.paths):lintableFiles(cwd)}catch(error){await log.error(error instanceof Error?error.message:String(error));return{ok:false}}if(!files.length)return{ok:true};const code=await runFormat(files,{write:options.write,check:options.check});return{ok:code===0}}
@@ -1,3 +1,3 @@
1
- import{existsSync}from"node:fs";import{join}from"node:path";import process from"node:process";import{Glob}from"bun";export const DEFAULT_STX_LINT_CONFIG={stxGlob:"resources/**/*.stx",distGlob:"dist/**/*.html",baselines:{},doctypeExempt:[],styleExempt:["resources/emails/"],staleRules:{}};const REQUIRED_STX_CONFIG_KEYS=[["strict","DOM guard (ch. 12.1) - without it script-validation discards every finding"],["root","pins project topology; absent, resolveStxRoot sniffs it and double-prefixes dirs"],["pagesDir",'must accompany root - resolveStxRoot falls back to a non-existent "pages"']];export async function loadStxLintConfig(root){const found=["config/lint.ts","config/lint.js"].find((c)=>existsSync(join(root,c)));if(!found)return{...DEFAULT_STX_LINT_CONFIG};try{const stx=(await import(join(root,found))).default?.stx??{};return{...DEFAULT_STX_LINT_CONFIG,...stx,baselines:{...stx.baselines},styleExempt:stx.styleExempt??DEFAULT_STX_LINT_CONFIG.styleExempt,doctypeExempt:stx.doctypeExempt??[],staleRules:stx.staleRules??{}}}catch(error){throw Error(`Could not read ${found}: ${error.message}`)}}async function scanGlob(pattern,root){const out=[];try{for await(const f of new Glob(pattern).scan(root))out.push(f)}catch{}return out.sort()}const ROUTED_ANCHOR=/\bdata-stx-link\b|\bdata-no-router\b/;async function grepLines(re,files,root,ignore){const hits=[];for(const f of files){let src="";try{src=await Bun.file(join(root,f)).text()}catch{continue}src.split(`
2
- `).forEach((line,i)=>{re.lastIndex=0;if(!re.test(line))return;if(ignore){ignore.lastIndex=0;if(ignore.test(line))return}hits.push(`${f}:${i+1} ${line.trim().slice(0,90)}`)})}return hits}async function scanSources(files,root,config){const{lintStxStrict}=await import("@stacksjs/stx"),{PROHIBITED_DOM_PATTERNS}=await import("@stacksjs/stx/script-validation"),{scanScriptTags}=await import("@stacksjs/stx/signal-processing"),domPatterns=PROHIBITED_DOM_PATTERNS,scan={domGuard:[],strictLint:[],balance:[],commentLandmine:[],doctype:[]};for(const f of files){let src="";try{src=await Bun.file(join(root,f)).text()}catch{continue}for(const d of lintStxStrict(src,{filePath:f,rules:config.staleRules})??[])scan.strictLint.push(`${f}:${d.line}:${d.column} ${d.ruleId} ${d.message}`);for(const s of scanScriptTags(src,{skipAttrs:/\bserver\b|\bsrc\s*=/}))for(const{pattern,message,suggestion}of domPatterns){pattern.lastIndex=0;const m=s.body.match(pattern);if(m)scan.domGuard.push(`${f} ${message} x${m.length} -> ${suggestion}`)}const open=(src.match(/<script\b/gi)??[]).length,close=(src.match(/<\/script\s*>/gi)??[]).length;if(open!==close)scan.balance.push(`${f} ${open} <script> vs ${close} </script> - a "</script" sits inside a script body`);for(const m of src.matchAll(/<!--([\s\S]*?)-->/g))if(/<\/?html\b|<!DOCTYPE\b|<\/?script\b/i.test(m[1]??"")){const line=src.slice(0,m.index).split(`
3
- `).length;scan.commentLandmine.push(`${f}:${line} banned token inside <!-- -->`)}const exempt=config.doctypeExempt.some((p)=>f.startsWith(p)||f===p);if(/<!DOCTYPE\s/i.test(src)&&!/@nolayout\b/.test(src)&&!exempt)scan.doctype.push(`${f} <!DOCTYPE> with no @nolayout - layout resolution is silently skipped`)}return scan}async function missingStxConfigKeys(root){const found=["config/ui.ts","config/ui.js"].find((c)=>existsSync(join(root,c)));if(!found)return[];let ui;try{ui=(await import(join(root,found))).default??{}}catch{return[]}return REQUIRED_STX_CONFIG_KEYS.filter(([key])=>ui[key]==null).map(([key,why])=>`${found} is missing "${key}" - ${why}`)}export async function runStxLint(options={}){const root=options.root??process.cwd(),config=options.config??await loadStxLintConfig(root),stxAll=await scanGlob(config.stxGlob,root),dist=await scanGlob(config.distGlob,root),styled=stxAll.filter((f)=>!config.styleExempt.some((p)=>f.startsWith(p))),scan=await scanSources(stxAll,root,config),configErrors=await missingStxConfigKeys(root),definitions=[{id:"stx-config-keys",label:"stx config sets every key the standards require",why:"pinning root/pagesDir changes topology resolution, so it is a deliberate move",detail:()=>configErrors},{id:"style-block",label:"no <style> block in a .stx file (rule 11.1)",detail:()=>grepLines(/<style/,stxAll,root)},{id:"doctype-no-nolayout",label:"no <!DOCTYPE> outside the exempt list (rule 2.2)",detail:()=>scan.doctype},{id:"script-tag-balance",label:'no "</script" inside a script body',detail:()=>scan.balance},{id:"comment-landmine",label:"no html/DOCTYPE/script token inside an HTML comment",detail:()=>scan.commentLandmine},{id:"strict-lint",label:"stx's own strict linter",detail:()=>scan.strictLint},{id:"dom-guard",label:"prohibited DOM access in client scripts",why:"imperative views clear these as they move to signals",detail:()=>scan.domGuard},{id:"inline-style-attr",label:'no style="" attribute (rule 11.5)',why:"pre-hydration display:none; the sanctioned form is a :class with literal branches",detail:()=>grepLines(/style="/,styled,root)},{id:"plain-internal-anchor",label:'no unrouted internal <a href="/"> (rule 9 - use StxLink)',why:"converting marketing pages is usually its own pass",detail:()=>grepLines(/<a [^>]*href="\//,styled,root,ROUTED_ANCHOR)},{id:"unmanaged-timer",label:"no bare setTimeout/setInterval (rule 6.7)",why:"useTimeout()/useDebounce() unsubscribe on destroy; bare timers outlive the SPA swap",detail:()=>grepLines(/(^|[^.\w])(setTimeout|setInterval)\s*\(/,stxAll,root)},{id:"dist-component-error",label:"no unresolved component in built HTML",detail:()=>grepLines(/Error loading component/,dist,root)},{id:"dist-path-leak",label:"no absolute filesystem path in built HTML",detail:()=>grepLines(/\/(Users|home)\/[a-z]/i,dist,root)},{id:"dist-layout-published",label:"no layout emitted as a public page",detail:()=>dist.filter((f)=>f.startsWith("layouts/")||f.includes("/layouts/"))}],results=[];for(const def of definitions){const detail=await def.detail(),count=detail.length,baseline=config.baselines[def.id]??0;results.push({id:def.id,label:def.label,why:def.why,count,baseline,detail,status:count>baseline?"fail":count<baseline?"loosened":"pass"})}return{root,results,distMissing:dist.length===0,failed:results.filter((r)=>r.status==="fail").length,loosened:results.filter((r)=>r.status==="loosened").length,counts:Object.fromEntries(results.map((r)=>[r.id,r.count]))}}
1
+ import{existsSync}from"node:fs";import{join}from"node:path";import process from"node:process";import{Glob}from"bun";export const DEFAULT_STX_LINT_CONFIG={stxGlob:"resources/**/*.stx",distGlob:"dist/**/*.html",baselines:{},doctypeExempt:[],styleExempt:["resources/emails/"],staleRules:{}};const REQUIRED_STX_CONFIG_KEYS=[["strict","DOM guard (ch. 12.1) - without it script-validation discards every finding"],["root","pins project topology; absent, resolveStxRoot sniffs it and double-prefixes dirs"],["pagesDir",'must accompany root - resolveStxRoot falls back to a non-existent "pages"']];export async function loadStxLintConfig(root){const candidates=["config/lint.ts","config/lint.js"];const found=candidates.find((c)=>existsSync(join(root,c)));if(!found)return{...DEFAULT_STX_LINT_CONFIG};try{const mod=await import(join(root,found));const stx=mod.default?.stx??{};return{...DEFAULT_STX_LINT_CONFIG,...stx,baselines:{...stx.baselines},styleExempt:stx.styleExempt??DEFAULT_STX_LINT_CONFIG.styleExempt,doctypeExempt:stx.doctypeExempt??[],staleRules:stx.staleRules??{}}}catch(error){throw new Error(`Could not read ${found}: ${error.message}`)}}async function scanGlob(pattern,root){const out=[];try{for await(const f of new Glob(pattern).scan(root))out.push(f)}catch{}return out.sort()}const ROUTED_ANCHOR=/\bdata-stx-link\b|\bdata-no-router\b/;async function grepLines(re,files,root,ignore){const hits=[];for(const f of files){let src="";try{src=await Bun.file(join(root,f)).text()}catch{continue}src.split(`
2
+ `).forEach((line,i)=>{re.lastIndex=0;if(!re.test(line))return;if(ignore){ignore.lastIndex=0;if(ignore.test(line))return}hits.push(`${f}:${i+1} ${line.trim().slice(0,90)}`)})}return hits}async function scanSources(files,root,config){const{lintStxStrict}=await import("@stacksjs/stx");const{PROHIBITED_DOM_PATTERNS}=await import("@stacksjs/stx/script-validation");const{scanScriptTags}=await import("@stacksjs/stx/signal-processing");const domPatterns=PROHIBITED_DOM_PATTERNS;const scan={domGuard:[],strictLint:[],balance:[],commentLandmine:[],doctype:[]};for(const f of files){let src="";try{src=await Bun.file(join(root,f)).text()}catch{continue}for(const d of lintStxStrict(src,{filePath:f,rules:config.staleRules})??[])scan.strictLint.push(`${f}:${d.line}:${d.column} ${d.ruleId} ${d.message}`);for(const s of scanScriptTags(src,{skipAttrs:/\bserver\b|\bsrc\s*=/})){for(const{pattern,message,suggestion}of domPatterns){pattern.lastIndex=0;const m=s.body.match(pattern);if(m)scan.domGuard.push(`${f} ${message} x${m.length} -> ${suggestion}`)}}const open=(src.match(/<script\b/gi)??[]).length;const close=(src.match(/<\/script\s*>/gi)??[]).length;if(open!==close)scan.balance.push(`${f} ${open} <script> vs ${close} </script> - a "</script" sits inside a script body`);for(const m of src.matchAll(/<!--([\s\S]*?)-->/g)){if(/<\/?html\b|<!DOCTYPE\b|<\/?script\b/i.test(m[1]??"")){const line=src.slice(0,m.index).split(`
3
+ `).length;scan.commentLandmine.push(`${f}:${line} banned token inside <!-- -->`)}}const exempt=config.doctypeExempt.some((p)=>f.startsWith(p)||f===p);if(/<!DOCTYPE\s/i.test(src)&&!/@nolayout\b/.test(src)&&!exempt)scan.doctype.push(`${f} <!DOCTYPE> with no @nolayout - layout resolution is silently skipped`)}return scan}async function missingStxConfigKeys(root){const candidates=["config/ui.ts","config/ui.js"];const found=candidates.find((c)=>existsSync(join(root,c)));if(!found)return[];let ui;try{ui=(await import(join(root,found))).default??{}}catch{return[]}return REQUIRED_STX_CONFIG_KEYS.filter(([key])=>ui[key]==null).map(([key,why])=>`${found} is missing "${key}" - ${why}`)}export async function runStxLint(options={}){const root=options.root??process.cwd();const config=options.config??await loadStxLintConfig(root);const stxAll=await scanGlob(config.stxGlob,root);const dist=await scanGlob(config.distGlob,root);const styled=stxAll.filter((f)=>!config.styleExempt.some((p)=>f.startsWith(p)));const scan=await scanSources(stxAll,root,config);const configErrors=await missingStxConfigKeys(root);const definitions=[{id:"stx-config-keys",label:"stx config sets every key the standards require",why:"pinning root/pagesDir changes topology resolution, so it is a deliberate move",detail:()=>configErrors},{id:"style-block",label:"no <style> block in a .stx file (rule 11.1)",detail:()=>grepLines(/<style/,stxAll,root)},{id:"doctype-no-nolayout",label:"no <!DOCTYPE> outside the exempt list (rule 2.2)",detail:()=>scan.doctype},{id:"script-tag-balance",label:'no "</script" inside a script body',detail:()=>scan.balance},{id:"comment-landmine",label:"no html/DOCTYPE/script token inside an HTML comment",detail:()=>scan.commentLandmine},{id:"strict-lint",label:"stx's own strict linter",detail:()=>scan.strictLint},{id:"dom-guard",label:"prohibited DOM access in client scripts",why:"imperative views clear these as they move to signals",detail:()=>scan.domGuard},{id:"inline-style-attr",label:'no style="" attribute (rule 11.5)',why:"pre-hydration display:none; the sanctioned form is a :class with literal branches",detail:()=>grepLines(/style="/,styled,root)},{id:"plain-internal-anchor",label:'no unrouted internal <a href="/"> (rule 9 - use StxLink)',why:"converting marketing pages is usually its own pass",detail:()=>grepLines(/<a [^>]*href="\//,styled,root,ROUTED_ANCHOR)},{id:"unmanaged-timer",label:"no bare setTimeout/setInterval (rule 6.7)",why:"useTimeout()/useDebounce() unsubscribe on destroy; bare timers outlive the SPA swap",detail:()=>grepLines(/(^|[^.\w])(setTimeout|setInterval)\s*\(/,stxAll,root)},{id:"dist-component-error",label:"no unresolved component in built HTML",detail:()=>grepLines(/Error loading component/,dist,root)},{id:"dist-path-leak",label:"no absolute filesystem path in built HTML",detail:()=>grepLines(/\/(Users|home)\/[a-z]/i,dist,root)},{id:"dist-layout-published",label:"no layout emitted as a public page",detail:()=>dist.filter((f)=>f.startsWith("layouts/")||f.includes("/layouts/"))}];const results=[];for(const def of definitions){const detail=await def.detail();const count=detail.length;const baseline=config.baselines[def.id]??0;results.push({id:def.id,label:def.label,why:def.why,count,baseline,detail,status:count>baseline?"fail":count<baseline?"loosened":"pass"})}return{root,results,distMissing:dist.length===0,failed:results.filter((r)=>r.status==="fail").length,loosened:results.filter((r)=>r.status==="loosened").length,counts:Object.fromEntries(results.map((r)=>[r.id,r.count]))}}
@@ -1,4 +1,4 @@
1
- import{log}from"@stacksjs/logging";import*as p from"@stacksjs/path";import{get,writeFile}from"@stacksjs/storage";export async function makeCommand(options){const name=options.name;if(!name){log.error("Command name is required");return!1}const commandName=toPascalCase(name),content=generateCommandContent(commandName,options),filePath=p.commandsPath(`${commandName}.ts`),signature=options.signature||toKebabCase(name);try{await writeFile(filePath,content);log.success(`Created command: ${filePath}`);if(options.register)await registerCommand(commandName,signature);else log.info(`Run it with: buddy ${signature}`);return!0}catch(error){log.error(`Failed to create command: ${error.message}`);return!1}}function generateCommandContent(name,options){const signature=options.signature||toKebabCase(name),description=options.description||`The ${signature} command`;return`import { defineCommand, log } from '@stacksjs/cli'
1
+ import{log}from"@stacksjs/logging";import*as p from"@stacksjs/path";import{get,writeFile}from"@stacksjs/storage";export async function makeCommand(options){const name=options.name;if(!name){log.error("Command name is required");return false}const commandName=toPascalCase(name);const content=generateCommandContent(commandName,options);const filePath=p.commandsPath(`${commandName}.ts`);const signature=options.signature||toKebabCase(name);try{await writeFile(filePath,content);log.success(`Created command: ${filePath}`);if(options.register)await registerCommand(commandName,signature);else log.info(`Run it with: buddy ${signature}`);return true}catch(error){log.error(`Failed to create command: ${error.message}`);return false}}function generateCommandContent(name,options){const signature=options.signature||toKebabCase(name);const description=options.description||`The ${signature} command`;return`import { defineCommand, log } from '@stacksjs/cli'
2
2
 
3
3
  /**
4
4
  * ${name} Command
@@ -30,6 +30,6 @@ export default defineCommand({
30
30
  }
31
31
  },
32
32
  })
33
- `}async function registerCommand(name,signature){const commandsPath=p.appPath("Commands.ts"),patterns=[{match:/export default \{([\s\S]*)\} satisfies/,open:"export default {",close:"} satisfies"},{match:/export default defineCommands\(\{([\s\S]*)\}\)/,open:"export default defineCommands({",close:"})"}];try{const content=await get(commandsPath),pattern=patterns.find((candidate)=>candidate.match.test(content));if(!pattern){log.info(`Command '${signature}' is live without a registry entry.`);return}const existingCommands=content.match(pattern.match)?.[1]??"";if(existingCommands.includes(`'${signature}'`)){log.info(`Command '${signature}' already registered in Commands.ts`);return}const updatedCommands=`${existingCommands.trimEnd()}
33
+ `}async function registerCommand(name,signature){const commandsPath=p.appPath("Commands.ts");const patterns=[{match:/export default \{([\s\S]*)\} satisfies/,open:"export default {",close:"} satisfies"},{match:/export default defineCommands\(\{([\s\S]*)\}\)/,open:"export default defineCommands({",close:"})"}];try{const content=await get(commandsPath);const pattern=patterns.find((candidate)=>candidate.match.test(content));if(!pattern){log.info(`Command '${signature}' is live without a registry entry.`);return}const existingCommands=content.match(pattern.match)?.[1]??"";if(existingCommands.includes(`'${signature}'`)){log.info(`Command '${signature}' already registered in Commands.ts`);return}const updatedCommands=`${existingCommands.trimEnd()}
34
34
  '${signature}': '${name}',
35
35
  `;await writeFile(commandsPath,content.replace(pattern.match,`${pattern.open}${updatedCommands}${pattern.close}`));log.success(`Registered command '${signature}' in Commands.ts`)}catch{log.info(`Command '${signature}' is live without a registry entry.`)}}function toPascalCase(str){return str.replace(/[-_](.)/g,(_,char)=>char.toUpperCase()).replace(/^(.)/,(_,char)=>char.toUpperCase())}function toKebabCase(str){return str.replace(/([a-z])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase()}
package/dist/make-job.js CHANGED
@@ -1,4 +1,4 @@
1
- import{log}from"@stacksjs/logging";import*as p from"@stacksjs/path";import{writeFile}from"@stacksjs/storage";export async function makeJob(options){const jobOptions=options,name=options.name;if(!name){log.error("Job name is required");return!1}const jobName=name.endsWith("Job")?name:`${name}Job`,content=jobOptions.class??!1?generateClassBasedJob(jobName,jobOptions):generateFunctionBasedJob(jobName,jobOptions),filePath=p.userJobsPath(`${jobName}.ts`);try{await writeFile(filePath,content);log.success(`Created job: ${filePath}`);return!0}catch(error){log.error(`Failed to create job: ${error.message}`);return!1}}function generateFunctionBasedJob(name,options){const queue=options.queue??"default",tries=options.tries??3,backoff=options.backoff??3;return`import { Job } from '@stacksjs/queue'
1
+ import{log}from"@stacksjs/logging";import*as p from"@stacksjs/path";import{writeFile}from"@stacksjs/storage";export async function makeJob(options){const jobOptions=options;const name=options.name;if(!name){log.error("Job name is required");return false}const jobName=name.endsWith("Job")?name:`${name}Job`;const isClassBased=jobOptions.class??false;const content=isClassBased?generateClassBasedJob(jobName,jobOptions):generateFunctionBasedJob(jobName,jobOptions);const filePath=p.userJobsPath(`${jobName}.ts`);try{await writeFile(filePath,content);log.success(`Created job: ${filePath}`);return true}catch(error){log.error(`Failed to create job: ${error.message}`);return false}}function generateFunctionBasedJob(name,options){const queue=options.queue??"default";const tries=options.tries??3;const backoff=options.backoff??3;return`import { Job } from '@stacksjs/queue'
2
2
 
3
3
  export default new Job({
4
4
  /**
@@ -57,7 +57,7 @@ export default new Job({
57
57
  return { success: true }
58
58
  },
59
59
  })
60
- `}function generateClassBasedJob(name,options){const queue=options.queue??"default",tries=options.tries??3;return`import { log } from '@stacksjs/logging'
60
+ `}function generateClassBasedJob(name,options){const queue=options.queue??"default";const tries=options.tries??3;return`import { log } from '@stacksjs/logging'
61
61
 
62
62
  /**
63
63
  * ${name}
@@ -1,4 +1,4 @@
1
- import{log}from"@stacksjs/logging";import*as p from"@stacksjs/path";import{doesExist,get,writeFile}from"@stacksjs/storage";export async function makePolicy(options){const name=options.name;if(!name){log.error("Policy name is required");return!1}const policyName=name.endsWith("Policy")?name:`${name}Policy`,modelName=options.model||policyName.replace("Policy",""),content=generatePolicyContent(policyName,modelName),filePath=p.appPath(`Policies/${policyName}.ts`);try{const policiesDir=p.appPath("Policies");if(!doesExist(policiesDir)){const{mkdirSync}=await import("@stacksjs/storage");mkdirSync(policiesDir,{recursive:!0})}await writeFile(filePath,content);log.success(`Created policy: ${filePath}`);if(options.register!==!1)await registerPolicy(modelName,policyName);return!0}catch(error){log.error(`Failed to create policy: ${error.message}`);return!1}}function generatePolicyContent(policyName,modelName){return`import type _User from '../models/User'
1
+ import{log}from"@stacksjs/logging";import*as p from"@stacksjs/path";import{doesExist,get,writeFile}from"@stacksjs/storage";export async function makePolicy(options){const name=options.name;if(!name){log.error("Policy name is required");return false}const policyName=name.endsWith("Policy")?name:`${name}Policy`;const modelName=options.model||policyName.replace("Policy","");const content=generatePolicyContent(policyName,modelName);const filePath=p.appPath(`Policies/${policyName}.ts`);try{const policiesDir=p.appPath("Policies");if(!doesExist(policiesDir)){const{mkdirSync}=await import("@stacksjs/storage");mkdirSync(policiesDir,{recursive:true})}await writeFile(filePath,content);log.success(`Created policy: ${filePath}`);if(options.register!==false){await registerPolicy(modelName,policyName)}return true}catch(error){log.error(`Failed to create policy: ${error.message}`);return false}}function generatePolicyContent(policyName,modelName){return`import type _User from '../models/User'
2
2
  import { BasePolicy } from '@stacksjs/auth'
3
3
 
4
4
  type UserModel = _User
@@ -89,5 +89,5 @@ export default class ${policyName} extends BasePolicy<${modelName}> {
89
89
  }
90
90
  }
91
91
  `}async function registerPolicy(modelName,policyName){const gatesPath=p.appPath("Gates.ts");try{let content=await get(gatesPath);const policiesMatch=content.match(/export const policies[^{]*\{([^}]*)\}/);if(policiesMatch){const existingPolicies=policiesMatch[1]??"";if(existingPolicies.includes(`'${modelName}'`)){log.info(`Policy for '${modelName}' already registered in Gates.ts`);return}const newPolicy=` '${modelName}': '${policyName}',
92
- `,updatedPolicies=`${existingPolicies.trimEnd()}
92
+ `;const updatedPolicies=`${existingPolicies.trimEnd()}
93
93
  ${newPolicy}`;content=content.replace(/export const policies[^{]*\{([^}]*)\}/,`export const policies: Record<string, string | { policy: string, model?: string }> = {${updatedPolicies}}`);await writeFile(gatesPath,content);log.success(`Registered policy '${policyName}' for '${modelName}' in Gates.ts`)}}catch(error){log.warn(`Could not register policy in Gates.ts: ${error.message}`);log.info("You may need to manually add it to app/Gates.ts")}}
@@ -1,4 +1,4 @@
1
- import{log}from"@stacksjs/logging";import*as p from"@stacksjs/path";import{doesExist,writeFile}from"@stacksjs/storage";export async function makeResource(options){const name=options.name;if(!name){log.error("Resource name is required");return!1}const resourceName=name.endsWith("Resource")?name:`${name}Resource`,modelName=options.model||resourceName.replace("Resource",""),content=options.collection?generateCollectionResourceContent(resourceName,modelName):generateResourceContent(resourceName,modelName),resourcesDir=p.appPath("Resources");if(!doesExist(resourcesDir)){const{mkdirSync}=await import("@stacksjs/storage");mkdirSync(resourcesDir,{recursive:!0})}const filePath=p.appPath(`Resources/${resourceName}.ts`);try{await writeFile(filePath,content);log.success(`Created resource: ${filePath}`);return!0}catch(error){log.error(`Failed to create resource: ${error.message}`);return!1}}function generateResourceContent(resourceName,modelName){return`import type { Request } from '@stacksjs/router'
1
+ import{log}from"@stacksjs/logging";import*as p from"@stacksjs/path";import{doesExist,writeFile}from"@stacksjs/storage";export async function makeResource(options){const name=options.name;if(!name){log.error("Resource name is required");return false}const resourceName=name.endsWith("Resource")?name:`${name}Resource`;const modelName=options.model||resourceName.replace("Resource","");const content=options.collection?generateCollectionResourceContent(resourceName,modelName):generateResourceContent(resourceName,modelName);const resourcesDir=p.appPath("Resources");if(!doesExist(resourcesDir)){const{mkdirSync}=await import("@stacksjs/storage");mkdirSync(resourcesDir,{recursive:true})}const filePath=p.appPath(`Resources/${resourceName}.ts`);try{await writeFile(filePath,content);log.success(`Created resource: ${filePath}`);return true}catch(error){log.error(`Failed to create resource: ${error.message}`);return false}}function generateResourceContent(resourceName,modelName){return`import type { Request } from '@stacksjs/router'
2
2
  import { JsonResource } from '@stacksjs/api'
3
3
 
4
4
  /**
package/dist/make.js CHANGED
@@ -1,9 +1,9 @@
1
- import process from"node:process";import{existsSync}from"node:fs";import{italic,runCommand}from"@stacksjs/cli";import{ExitCode}from"@stacksjs/types";import{localUrl}from"@stacksjs/config";import{Action}from"@stacksjs/enums";import{handleError}from"@stacksjs/error-handling";import{log}from"@stacksjs/logging";import{path as p,resolve}from"@stacksjs/path";import{createFolder,doesFolderExist,writeTextFile}from"@stacksjs/storage";import{camelCase,kebabCase,pascalCase,template}from"@stacksjs/strings";import{runAction}from"./helpers";import{CODE_TEMPLATES}from"./templates";let isDryRun=!1;export function setDryRun(enabled){isDryRun=Boolean(enabled)}export function isDryRunActive(){return isDryRun}function generateCode(templateKey,...args){return template(CODE_TEMPLATES[templateKey],...args)}async function writeOrPreview(path,data){if(isDryRun){const lines=data.split(`
2
- `),preview=lines.slice(0,60).map((l)=>` ${l}`).join(`
3
- `),truncated=lines.length>60?`
4
- ${italic(`\u2026 ${lines.length-60} more lines elided`)}`:"";log.info(`[dry-run] would write ${path} (${lines.length} lines)`);process.stdout.write(`${preview}${truncated}
1
+ import process from"node:process";import{existsSync}from"node:fs";import{italic,runCommand}from"@stacksjs/cli";import{ExitCode}from"@stacksjs/types";import{localUrl}from"@stacksjs/config";import{Action}from"@stacksjs/enums";import{handleError}from"@stacksjs/error-handling";import{log}from"@stacksjs/logging";import{path as p,resolve}from"@stacksjs/path";import{createFolder,doesFolderExist,writeTextFile}from"@stacksjs/storage";import{camelCase,kebabCase,pascalCase,template}from"@stacksjs/strings";import{runAction}from"./helpers";import{CODE_TEMPLATES}from"./templates";let isDryRun=false;export function setDryRun(enabled){isDryRun=Boolean(enabled)}export function isDryRunActive(){return isDryRun}function generateCode(templateKey,...args){return template(CODE_TEMPLATES[templateKey],...args)}async function writeOrPreview(path,data){if(isDryRun){const lines=data.split(`
2
+ `);const preview=lines.slice(0,60).map((l)=>` ${l}`).join(`
3
+ `);const truncated=lines.length>60?`
4
+ ${italic(`… ${lines.length-60} more lines elided`)}`:"";log.info(`[dry-run] would write ${path} (${lines.length} lines)`);process.stdout.write(`${preview}${truncated}
5
5
 
6
- `);return}await writeTextFile({path,data})}async function createFileWithTemplate(path,templateKey,...args){await writeOrPreview(path,generateCode(templateKey,...args))}export async function invoke(options){if(options.component)await makeComponent(options);if(options.database)makeDatabase(options);if(options.function)await makeFunction(options);if(options.language)await makeLanguage(options);if(options.middleware)await createMiddleware(options);if(options.notification)await makeNotification(options);if(options.page)await makePage(options);if(options.stack)await makeStack(options)}export async function make(options){return await invoke(options)}function requireName(options,what){const name=options.name?.trim();if(!name){console.error(`A name is required to create a ${what}. Pass one with --name.`);process.exit(ExitCode.InvalidArgument)}return name}export async function makeAction(options){try{const name=requireName(options,"action");log.info("Creating your action...");await createAction(options);log.success(`Created ${italic(name)} action`)}catch(error){await log.error("There was an error creating your action",error);process.exit(ExitCode.FatalError)}}export async function makeComponent(options){try{const name=requireName(options,"component");log.info("Creating your component...");await createComponent(options);log.success(`Created ${italic(name)} component`)}catch(error){await log.error("There was an error creating your component",error);process.exit(ExitCode.FatalError)}}export async function createAction(options){const name=requireName(options,"action"),opts=options,wantsValidation=Boolean(opts.withValidation||options["with-validation"]),wantsAuth=Boolean(opts.withAuth||options["with-auth"]),templateKey=wantsValidation&&wantsAuth?"actionWithBoth":wantsValidation?"actionWithValidation":wantsAuth?"actionWithAuth":"action";await createFileWithTemplate(p.userActionsPath(`${name}.ts`),templateKey,name)}export async function createComponent(options){const name=requireName(options,"component");await createFileWithTemplate(p.userComponentsPath(componentFileName(name)),"component",name)}export function componentFileName(name){return`${name}.stx`}export function makeDatabase(options){try{createDatabase(options)}catch(error){console.error("There was an error creating your database",error);process.exit(ExitCode.FatalError)}}export function createDatabase(options){const name=pascalCase(options.name||"MyModel");console.log(`
6
+ `);return}await writeTextFile({path,data})}async function createFileWithTemplate(path,templateKey,...args){await writeOrPreview(path,generateCode(templateKey,...args))}export async function invoke(options){if(options.component)await makeComponent(options);if(options.database)makeDatabase(options);if(options.function)await makeFunction(options);if(options.language)await makeLanguage(options);if(options.middleware)await createMiddleware(options);if(options.notification)await makeNotification(options);if(options.page)await makePage(options);if(options.stack)await makeStack(options)}export async function make(options){return await invoke(options)}function requireName(options,what){const name=options.name?.trim();if(!name){console.error(`A name is required to create a ${what}. Pass one with --name.`);process.exit(ExitCode.InvalidArgument)}return name}export async function makeAction(options){try{const name=requireName(options,"action");log.info("Creating your action...");await createAction(options);log.success(`Created ${italic(name)} action`)}catch(error){await log.error("There was an error creating your action",error);process.exit(ExitCode.FatalError)}}export async function makeComponent(options){try{const name=requireName(options,"component");log.info("Creating your component...");await createComponent(options);log.success(`Created ${italic(name)} component`)}catch(error){await log.error("There was an error creating your component",error);process.exit(ExitCode.FatalError)}}export async function createAction(options){const name=requireName(options,"action");const opts=options;const wantsValidation=Boolean(opts.withValidation||options["with-validation"]);const wantsAuth=Boolean(opts.withAuth||options["with-auth"]);const templateKey=wantsValidation&&wantsAuth?"actionWithBoth":wantsValidation?"actionWithValidation":wantsAuth?"actionWithAuth":"action";await createFileWithTemplate(p.userActionsPath(`${name}.ts`),templateKey,name)}export async function createComponent(options){const name=requireName(options,"component");await createFileWithTemplate(p.userComponentsPath(componentFileName(name)),"component",name)}export function componentFileName(name){return`${name}.stx`}export function makeDatabase(options){try{createDatabase(options)}catch(error){console.error("There was an error creating your database",error);process.exit(ExitCode.FatalError)}}export function createDatabase(options){const name=pascalCase(options.name||"MyModel");console.log(`
7
7
  Stacks manages the database through models and migrations, so there is no separate database to create.
8
8
 
9
9
  To add a "${name}" table:
@@ -12,7 +12,7 @@ import process from"node:process";import{existsSync}from"node:fs";import{italic,
12
12
  3. buddy migrate
13
13
 
14
14
  To use a different database engine or file, edit the connections in \`config/database.ts\`.
15
- `)}export async function factory(options){try{const name=requireName(options,"component");log.info(`Creating your ${italic(name)} factory...`);await createFactory(options)}catch(error){await log.error("There was an error creating your factory",error);process.exit(ExitCode.FatalError)}}export async function createFactory(options){const name=options.name||"MyFactory",factoryName=name.endsWith("Factory")?name:`${name}Factory`;try{const{path:p}=await import("@stacksjs/path"),factoryPath=`${p.userDatabasePath("factories")}/${factoryName}.ts`;if(await Bun.file(factoryPath).exists()){log.warn(`Factory ${factoryName} already exists at ${factoryPath}`);return}const modelName=name.replace(/Factory$/,""),content=`import type { ${modelName}Model } from '@stacksjs/orm'
15
+ `)}export async function factory(options){try{const name=requireName(options,"component");log.info(`Creating your ${italic(name)} factory...`);await createFactory(options)}catch(error){await log.error("There was an error creating your factory",error);process.exit(ExitCode.FatalError)}}export async function createFactory(options){const name=options.name||"MyFactory";const factoryName=name.endsWith("Factory")?name:`${name}Factory`;try{const{path:p}=await import("@stacksjs/path");const factoryDir=p.userDatabasePath("factories");const factoryPath=`${factoryDir}/${factoryName}.ts`;const file=Bun.file(factoryPath);if(await file.exists()){log.warn(`Factory ${factoryName} already exists at ${factoryPath}`);return}const modelName=name.replace(/Factory$/,"");const content=`import type { ${modelName}Model } from '@stacksjs/orm'
16
16
 
17
17
  export function ${factoryName}(): Partial<${modelName}Model> {
18
18
  return {
@@ -21,4 +21,4 @@ export function ${factoryName}(): Partial<${modelName}Model> {
21
21
  }
22
22
 
23
23
  export default ${factoryName}
24
- `;await writeOrPreview(factoryPath,content);log.success(`Created factory: ${factoryPath}`)}catch(error){log.error(`Failed to create factory ${factoryName}`,error);throw error}}export async function makeNotification(options){try{const name=requireName(options,"notification");log.info(`Creating your ${italic(name)} notification...`);await createNotification(options);log.success(`Created ${italic(name)} notification`)}catch(error){await log.error("There was an error creating your notification",error);process.exit(ExitCode.FatalError)}}export async function createMail(options){const rawName=String(options.name||"").trim();if(!rawName){log.error("A mail name is required (e.g. `buddy make:mail OrderShipped`).");return!1}const className=pascalCase(rawName),kebabName=kebabCase(rawName),mailPath=p.userMailPath(`${className}.ts`),templatePath=p.userEmailsPath(`${kebabName}.stx`);await log.flush();if(!options.force){if(existsSync(mailPath)){console.error(`${italic(mailPath)} already exists - re-run with --force to overwrite.`);return!1}if(existsSync(templatePath)){console.error(`${italic(templatePath)} already exists - re-run with --force to overwrite.`);return!1}}if(!doesFolderExist(p.userMailPath()))await createFolder(p.userMailPath());if(!doesFolderExist(p.userEmailsPath()))await createFolder(p.userEmailsPath());try{await createFileWithTemplate(mailPath,"mail",className,kebabName);await createFileWithTemplate(templatePath,"mailTemplate",className,kebabName);return!0}catch(error){handleError("Error creating mailable",error);return!1}}export async function makeMail(options){try{const name=requireName(options,"mail");log.info(`Creating your ${italic(name)} mailable...`);if(!await createMail(options))process.exit(ExitCode.FatalError);log.success(`Created ${italic(pascalCase(name))} mailable + ${italic(kebabCase(name))}.stx template`)}catch(error){await log.error("There was an error creating your mailable",error);process.exit(ExitCode.FatalError)}}export async function makePage(options){try{const name=requireName(options,"page");log.info("Creating your page...");await createPage(options);log.success(`Created ${name} page`)}catch(error){await log.error("There was an error creating your page",error);process.exit(ExitCode.FatalError)}}export async function createPage(options){const name=requireName(options,"page");await createFileWithTemplate(p.userViewsPath(pageFileName(name)),"page",name)}export function pageFileName(name){return`${name}.stx`}export async function makeFunction(options){try{const name=requireName(options,"function");log.info("Creating your function...");await createFunction(options);log.success(`Created ${name} function`)}catch(error){await log.error("There was an error creating your function",error);process.exit(ExitCode.FatalError)}}export async function createFunction(options){const name=requireName(options,"function");await createFileWithTemplate(p.userFunctionsPath(`${name}.ts`),"function",camelCase(name))}export async function makeLanguage(options){try{const name=requireName(options,"language");log.info("Creating your translation file...");await createLanguage(options);log.success(`Created ${name} translation file`)}catch(error){await log.error("There was an error creating your language.",error);process.exit(ExitCode.FatalError)}}export async function createLanguage(options){const name=requireName(options,"language");await createFileWithTemplate(p.resourcesPath(`lang/${name}.yml`),"language",name)}export async function makeStack(options){try{const name=requireName(options,"stack");log.info(`Creating your ${name} stack...`);const stackDir=resolve(process.cwd(),name);if(doesFolderExist(stackDir)){await log.error(`Directory "${name}" already exists`);process.exit(ExitCode.FatalError)}await createFolder(stackDir);const dirs=["app/Actions","app/Models","config","database/migrations","resources/views","resources/components","resources/functions","resources/partials","routes","public"];for(const dir of dirs)await createFolder(resolve(stackDir,dir));const shortName=name.replace(/^@[^/]+\//,"").replace(/-stack$/,"");await createFileWithTemplate(resolve(stackDir,"package.json"),"stackPackageJson",name,shortName);log.success(`Successfully scaffolded your "${name}" stack`);log.info("");log.info(` cd ${name}`);log.info(" # Add your models, actions, views, etc.");log.info(" # Push the repository, then submit its GitHub source to the Stacks registry.");log.info("");log.info(" Users install it with:");log.info(` buddy add ${shortName}`)}catch(error){await log.error("There was an error creating your stack",error);process.exit(ExitCode.FatalError)}}export async function createNotification(options){const name=requireName(options,"stack");try{let importOption="EmailOptions";if(!doesFolderExist("notifications"))await createFolder("./notifications");if(options.chat)importOption="ChatOptions";if(options.sms)importOption="SMSOptions";await createFileWithTemplate(p.userNotificationsPath(`${name}.ts`),"notification",importOption);return!0}catch(error){handleError("Error creating notification",error);return!1}}export async function createMigration(options){const optionName=options.name;if(!optionName)throw Error("options.name is required and cannot be empty");const fileName=`${Date.now()}-${kebabCase(optionName)}.sql`,path=p.userMigrationsPath(fileName),snake=kebabCase(optionName).replace(/-/g,"_"),table=/^create_(.+)_table$/.exec(snake)?.[1]??"table_name",driver=(process.env.DB_CONNECTION||"sqlite").toLowerCase(),mysqlLike=driver==="mysql"||driver==="singlestore",tableIdentifier=mysqlLike?`\`${table}\``:`"${table}"`,primaryKey=driver==="postgres"?'"id" BIGSERIAL PRIMARY KEY':mysqlLike?"`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY":'"id" INTEGER PRIMARY KEY AUTOINCREMENT';try{await createFileWithTemplate(path,"migration",tableIdentifier,primaryKey);log.success(`Migration created: ${italic(`database/migrations/${fileName}`)}`);const{findIgnoredMigrations,formatIgnoredMigrations}=await import("@stacksjs/database");if(findIgnoredMigrations().includes(fileName))log.warn(formatIgnoredMigrations([fileName]))}catch(error){log.error(error)}}export async function makeQueueTable(){await runAction(Action.QueueTable)}export async function makeCertificate(){const domain=await localUrl();log.info("Creating SSL certificate...");await runCommand(`tlsx ${domain}`,{cwd:p.storagePath("keys")});log.success("Certificate created");log.info("Installing SSL certificate...");await runCommand("tlsx -install",{cwd:p.storagePath("keys")});log.success("Certificate installed")}export async function createModel(options){const optionName=options.name;if(!optionName)throw Error("options.name is required and cannot be empty");const name=optionName.charAt(0).toUpperCase()+optionName.slice(1),tableName=name.replace(/([A-Z])/g,"_$1").toLowerCase().replace(/^_/,"").replace(/([^s])$/,"$1s"),path=p.userModelsPath(`${name}.ts`);try{await createFileWithTemplate(path,"model",name,tableName);log.success(`Model created: ${italic(`app/Models/${name}.ts`)}`)}catch(error){log.error(error)}}export async function createMiddleware(options){const name=requireName(options,"certificate");await createFileWithTemplate(p.userMiddlewarePath(`${name}.ts`),"middleware",name)}
24
+ `;await writeOrPreview(factoryPath,content);log.success(`Created factory: ${factoryPath}`)}catch(error){log.error(`Failed to create factory ${factoryName}`,error);throw error}}export async function makeNotification(options){try{const name=requireName(options,"notification");log.info(`Creating your ${italic(name)} notification...`);await createNotification(options);log.success(`Created ${italic(name)} notification`)}catch(error){await log.error("There was an error creating your notification",error);process.exit(ExitCode.FatalError)}}export async function createMail(options){const rawName=String(options.name||"").trim();if(!rawName){log.error("A mail name is required (e.g. `buddy make:mail OrderShipped`).");return false}const className=pascalCase(rawName);const kebabName=kebabCase(rawName);const mailPath=p.userMailPath(`${className}.ts`);const templatePath=p.userEmailsPath(`${kebabName}.stx`);await log.flush();if(!options.force){if(existsSync(mailPath)){console.error(`${italic(mailPath)} already exists - re-run with --force to overwrite.`);return false}if(existsSync(templatePath)){console.error(`${italic(templatePath)} already exists - re-run with --force to overwrite.`);return false}}if(!doesFolderExist(p.userMailPath()))await createFolder(p.userMailPath());if(!doesFolderExist(p.userEmailsPath()))await createFolder(p.userEmailsPath());try{await createFileWithTemplate(mailPath,"mail",className,kebabName);await createFileWithTemplate(templatePath,"mailTemplate",className,kebabName);return true}catch(error){handleError("Error creating mailable",error);return false}}export async function makeMail(options){try{const name=requireName(options,"mail");log.info(`Creating your ${italic(name)} mailable...`);const ok=await createMail(options);if(!ok)process.exit(ExitCode.FatalError);log.success(`Created ${italic(pascalCase(name))} mailable + ${italic(kebabCase(name))}.stx template`)}catch(error){await log.error("There was an error creating your mailable",error);process.exit(ExitCode.FatalError)}}export async function makePage(options){try{const name=requireName(options,"page");log.info("Creating your page...");await createPage(options);log.success(`Created ${name} page`)}catch(error){await log.error("There was an error creating your page",error);process.exit(ExitCode.FatalError)}}export async function createPage(options){const name=requireName(options,"page");await createFileWithTemplate(p.userViewsPath(pageFileName(name)),"page",name)}export function pageFileName(name){return`${name}.stx`}export async function makeFunction(options){try{const name=requireName(options,"function");log.info("Creating your function...");await createFunction(options);log.success(`Created ${name} function`)}catch(error){await log.error("There was an error creating your function",error);process.exit(ExitCode.FatalError)}}export async function createFunction(options){const name=requireName(options,"function");await createFileWithTemplate(p.userFunctionsPath(`${name}.ts`),"function",camelCase(name))}export async function makeLanguage(options){try{const name=requireName(options,"language");log.info("Creating your translation file...");await createLanguage(options);log.success(`Created ${name} translation file`)}catch(error){await log.error("There was an error creating your language.",error);process.exit(ExitCode.FatalError)}}export async function createLanguage(options){const name=requireName(options,"language");await createFileWithTemplate(p.resourcesPath(`lang/${name}.yml`),"language",name)}export async function makeStack(options){try{const name=requireName(options,"stack");log.info(`Creating your ${name} stack...`);const stackDir=resolve(process.cwd(),name);if(doesFolderExist(stackDir)){await log.error(`Directory "${name}" already exists`);process.exit(ExitCode.FatalError)}await createFolder(stackDir);const dirs=["app/Actions","app/Models","config","database/migrations","resources/views","resources/components","resources/functions","resources/partials","routes","public"];for(const dir of dirs){await createFolder(resolve(stackDir,dir))}const shortName=name.replace(/^@[^/]+\//,"").replace(/-stack$/,"");await createFileWithTemplate(resolve(stackDir,"package.json"),"stackPackageJson",name,shortName);log.success(`Successfully scaffolded your "${name}" stack`);log.info("");log.info(` cd ${name}`);log.info(" # Add your models, actions, views, etc.");log.info(" # Push the repository, then submit its GitHub source to the Stacks registry.");log.info("");log.info(" Users install it with:");log.info(` buddy add ${shortName}`)}catch(error){await log.error("There was an error creating your stack",error);process.exit(ExitCode.FatalError)}}export async function createNotification(options){const name=requireName(options,"stack");try{let importOption="EmailOptions";if(!doesFolderExist("notifications"))await createFolder("./notifications");if(options.chat)importOption="ChatOptions";if(options.sms)importOption="SMSOptions";await createFileWithTemplate(p.userNotificationsPath(`${name}.ts`),"notification",importOption);return true}catch(error){handleError("Error creating notification",error);return false}}export async function createMigration(options){const optionName=options.name;if(!optionName)throw new Error("options.name is required and cannot be empty");const fileName=`${Date.now()}-${kebabCase(optionName)}.sql`;const path=p.userMigrationsPath(fileName);const snake=kebabCase(optionName).replace(/-/g,"_");const table=/^create_(.+)_table$/.exec(snake)?.[1]??"table_name";const driver=(process.env.DB_CONNECTION||"sqlite").toLowerCase();const mysqlLike=driver==="mysql"||driver==="singlestore";const tableIdentifier=mysqlLike?`\`${table}\``:`"${table}"`;const primaryKey=driver==="postgres"?'"id" BIGSERIAL PRIMARY KEY':mysqlLike?"`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY":'"id" INTEGER PRIMARY KEY AUTOINCREMENT';try{await createFileWithTemplate(path,"migration",tableIdentifier,primaryKey);log.success(`Migration created: ${italic(`database/migrations/${fileName}`)}`);const{findIgnoredMigrations,formatIgnoredMigrations}=await import("@stacksjs/database");if(findIgnoredMigrations().includes(fileName))log.warn(formatIgnoredMigrations([fileName]))}catch(error){log.error(error)}}export async function makeQueueTable(){await runAction(Action.QueueTable)}export async function makeCertificate(){const domain=await localUrl();log.info(`Creating SSL certificate...`);await runCommand(`tlsx ${domain}`,{cwd:p.storagePath("keys")});log.success("Certificate created");log.info(`Installing SSL certificate...`);await runCommand(`tlsx -install`,{cwd:p.storagePath("keys")});log.success("Certificate installed")}export async function createModel(options){const optionName=options.name;if(!optionName)throw new Error("options.name is required and cannot be empty");const name=optionName.charAt(0).toUpperCase()+optionName.slice(1);const tableName=name.replace(/([A-Z])/g,"_$1").toLowerCase().replace(/^_/,"").replace(/([^s])$/,"$1s");const path=p.userModelsPath(`${name}.ts`);try{await createFileWithTemplate(path,"model",name,tableName);log.success(`Model created: ${italic(`app/Models/${name}.ts`)}`)}catch(error){log.error(error)}}export async function createMiddleware(options){const name=requireName(options,"certificate");await createFileWithTemplate(p.userMiddlewarePath(`${name}.ts`),"middleware",name)}
@@ -1 +1 @@
1
- import process from"node:process";import{generateMigrations,runDatabaseMigration}from"@stacksjs/database";import{log}from"@stacksjs/logging";const skipGeneration=process.env.STACKS_MIGRATE_NO_GENERATE==="1",generated=skipGeneration?void 0:await generateMigrations();if(skipGeneration)log.debug("[stacks] migration generation skipped (--no-generate); applying committed files only");if(generated?.isErr){console.error("Generating migrations failed. The model diff could not be turned into SQL.");console.error(String(generated.error?.message??generated.error));await log.error("[stacks] generateMigrations failed",generated.error);process.exit(1)}const migrated=await runDatabaseMigration();if(migrated.isErr){console.error("Running migrations failed. The files were written; applying them to the database did not succeed.");console.error(String(migrated.error?.message??migrated.error));await log.error("[stacks] runDatabaseMigration failed",migrated.error);process.exit(1)}process.exit(0);
1
+ import process from"node:process";import{generateMigrations,runDatabaseMigration}from"@stacksjs/database";import{log}from"@stacksjs/logging";const skipGeneration=process.env.STACKS_MIGRATE_NO_GENERATE==="1";const generated=skipGeneration?undefined:await generateMigrations();if(skipGeneration)log.debug("[stacks] migration generation skipped (--no-generate); applying committed files only");if(generated?.isErr){console.error("Generating migrations failed. The model diff could not be turned into SQL.");console.error(String(generated.error?.message??generated.error));await log.error("[stacks] generateMigrations failed",generated.error);process.exit(1)}const migrated=await runDatabaseMigration();if(migrated.isErr){console.error("Running migrations failed. The files were written; applying them to the database did not succeed.");console.error(String(migrated.error?.message??migrated.error));await log.error("[stacks] runDatabaseMigration failed",migrated.error);process.exit(1)}process.exit(0);
@@ -1 +1 @@
1
- import process from"node:process";import{ensureUtcDatetimeColumns,generateMigrations,migrateAuthTables,migrateNotificationTables,migrateRbacTables,migrateTraitTables,resetDatabase,runDatabaseMigration}from"@stacksjs/database";import{log}from"@stacksjs/logging";const includeAuth=process.env.STACKS_MIGRATE_NO_AUTH!=="1",resetResult=await resetDatabase();if(resetResult?.isErr){console.error(resetResult.error);await log.error("resetDatabase failed",resetResult.error);process.exit(1)}const genResult=await generateMigrations();if(genResult?.isErr){console.error(genResult.error);await log.error("generateMigrations failed",genResult.error);process.exit(1)}const authResult=includeAuth?await migrateAuthTables():void 0;if(authResult&&!authResult.success)log.error(`Failed to migrate auth tables: ${authResult.error}`);const migrateResult=await runDatabaseMigration(),notifResult=includeAuth?await migrateNotificationTables():void 0;if(notifResult&&!notifResult.success)log.error(`Failed to migrate notification tables: ${notifResult.error}`);const rbacResult=includeAuth?await migrateRbacTables():void 0;if(rbacResult&&!rbacResult.success)log.error(`Failed to migrate RBAC tables: ${rbacResult.error}`);const traitResult=includeAuth?await migrateTraitTables():void 0;if(traitResult&&!traitResult.success)log.error(`Failed to migrate polymorphic trait tables: ${traitResult.error}`);const datetimeResult=await ensureUtcDatetimeColumns();if(!datetimeResult.success)log.error(`Failed to convert TIMESTAMP columns to DATETIME: ${datetimeResult.error}`);if(migrateResult.isErr){await log.error("runDatabaseMigration failed");await log.error(migrateResult.error);await log.flush();process.exit(1)}if(traitResult&&!traitResult.success){await log.flush();process.exit(1)}process.exit(0);
1
+ import process from"node:process";import{ensureUtcDatetimeColumns,generateMigrations,migrateAuthTables,migrateNotificationTables,migrateRbacTables,migrateTraitTables,resetDatabase,runDatabaseMigration}from"@stacksjs/database";import{log}from"@stacksjs/logging";const includeAuth=process.env.STACKS_MIGRATE_NO_AUTH!=="1";const resetResult=await resetDatabase();if(resetResult?.isErr){console.error(resetResult.error);await log.error("resetDatabase failed",resetResult.error);process.exit(1)}const genResult=await generateMigrations();if(genResult?.isErr){console.error(genResult.error);await log.error("generateMigrations failed",genResult.error);process.exit(1)}const authResult=includeAuth?await migrateAuthTables():undefined;if(authResult&&!authResult.success)log.error(`Failed to migrate auth tables: ${authResult.error}`);const migrateResult=await runDatabaseMigration();const notifResult=includeAuth?await migrateNotificationTables():undefined;if(notifResult&&!notifResult.success)log.error(`Failed to migrate notification tables: ${notifResult.error}`);const rbacResult=includeAuth?await migrateRbacTables():undefined;if(rbacResult&&!rbacResult.success)log.error(`Failed to migrate RBAC tables: ${rbacResult.error}`);const traitResult=includeAuth?await migrateTraitTables():undefined;if(traitResult&&!traitResult.success)log.error(`Failed to migrate polymorphic trait tables: ${traitResult.error}`);const datetimeResult=await ensureUtcDatetimeColumns();if(!datetimeResult.success)log.error(`Failed to convert TIMESTAMP columns to DATETIME: ${datetimeResult.error}`);if(migrateResult.isErr){await log.error("runDatabaseMigration failed");await log.error(migrateResult.error);await log.flush();process.exit(1)}if(traitResult&&!traitResult.success){await log.flush();process.exit(1)}process.exit(0);
@@ -1 +1 @@
1
- const DEPENDENCY_FIELDS=["dependencies","devDependencies","peerDependencies","optionalDependencies"],UNCOMPARABLE_RANGE=/^(?:workspace|file|link|git|github|npm|catalog):/;function splitPackageKey(key){const at=key.lastIndexOf("@");if(at<=0)return null;return{name:key.slice(0,at),version:key.slice(at+1)}}function resolvedVersions(packages){const resolved=new Map;for(const key of Object.keys(packages)){const parsed=splitPackageKey(key);if(!parsed)continue;const versions=resolved.get(parsed.name);if(versions)versions.push(parsed.version);else resolved.set(parsed.name,[parsed.version])}return resolved}function systemBlockProblems(root,baseline){if(!baseline)return[];let baselineSystem;try{baselineSystem=JSON.parse(baseline).workspaces?.[""]?.system}catch{return[]}if(!baselineSystem||typeof baselineSystem!=="object")return[];const expected=baselineSystem,system=root?.system;if(!system||typeof system!=="object")return[`the root "system" block was dropped (it pinned ${Object.keys(expected).join(", ")}), so CI would have no toolchain to provision`];const present=system;return Object.keys(expected).filter((pin)=>!(pin in present)).map((pin)=>`the root "system" block lost its "${pin}" pin`)}export function pantryLockViolations(lock,baseline,declarations){let parsed;try{parsed=JSON.parse(lock)}catch(error){return[`it is not valid JSON (${error instanceof Error?error.message:String(error)})`]}const problems=[],workspaces=parsed.workspaces??{},resolved=resolvedVersions(parsed.packages??{});if(declarations){for(const[workspacePath,current]of Object.entries(declarations)){const recorded=workspaces[workspacePath],label=workspacePath||"the workspace root";if(!recorded){problems.push(`${label}: current workspace is missing from pantry.lock`);continue}for(const field of["name","version"])if(current[field]!==recorded[field])problems.push(`${label}: ${field} is ${JSON.stringify(current[field])} but pantry.lock records ${JSON.stringify(recorded[field])}`);for(const field of["dependencies","devDependencies"]){const expected=current[field]??{},locked=recorded[field]??{};for(const[name,range]of Object.entries(expected))if(range!==locked[name])problems.push(`${label}: ${field}.${name} is ${JSON.stringify(range)} but pantry.lock records ${JSON.stringify(locked[name])}`);for(const name of Object.keys(locked))if(!(name in expected))problems.push(`${label}: pantry.lock records undeclared ${field}.${name}`)}}for(const workspacePath of Object.keys(workspaces))if(!(workspacePath in declarations))problems.push(`${workspacePath||"the workspace root"}: pantry.lock records a workspace absent from current declarations`)}for(const[workspacePath,workspace]of Object.entries(workspaces))for(const field of DEPENDENCY_FIELDS){const declared=workspace[field];if(!declared||typeof declared!=="object")continue;for(const[name,range]of Object.entries(declared)){if(typeof range!=="string"||UNCOMPARABLE_RANGE.test(range))continue;const versions=resolved.get(name);if(!versions)continue;if(!versions.some((version)=>Bun.semver.satisfies(version,range)))problems.push(`${name} is pinned at ${versions.join(", ")}, which does not satisfy "${range}" declared by ${workspacePath||"the workspace root"} (${field})`)}}problems.push(...systemBlockProblems(workspaces[""],baseline));return problems}
1
+ const DEPENDENCY_FIELDS=["dependencies","devDependencies","peerDependencies","optionalDependencies"];const UNCOMPARABLE_RANGE=/^(?:workspace|file|link|git|github|npm|catalog):/;function splitPackageKey(key){const at=key.lastIndexOf("@");if(at<=0)return null;return{name:key.slice(0,at),version:key.slice(at+1)}}function resolvedVersions(packages){const resolved=new Map;for(const key of Object.keys(packages)){const parsed=splitPackageKey(key);if(!parsed)continue;const versions=resolved.get(parsed.name);if(versions)versions.push(parsed.version);else resolved.set(parsed.name,[parsed.version])}return resolved}function systemBlockProblems(root,baseline){if(!baseline)return[];let baselineSystem;try{baselineSystem=JSON.parse(baseline).workspaces?.[""]?.system}catch{return[]}if(!baselineSystem||typeof baselineSystem!=="object")return[];const expected=baselineSystem;const system=root?.system;if(!system||typeof system!=="object"){return[`the root "system" block was dropped (it pinned ${Object.keys(expected).join(", ")}), `+"so CI would have no toolchain to provision"]}const present=system;return Object.keys(expected).filter((pin)=>!(pin in present)).map((pin)=>`the root "system" block lost its "${pin}" pin`)}export function pantryLockViolations(lock,baseline,declarations){let parsed;try{parsed=JSON.parse(lock)}catch(error){return[`it is not valid JSON (${error instanceof Error?error.message:String(error)})`]}const problems=[];const workspaces=parsed.workspaces??{};const resolved=resolvedVersions(parsed.packages??{});if(declarations){for(const[workspacePath,current]of Object.entries(declarations)){const recorded=workspaces[workspacePath];const label=workspacePath||"the workspace root";if(!recorded){problems.push(`${label}: current workspace is missing from pantry.lock`);continue}for(const field of["name","version"]){if(current[field]!==recorded[field])problems.push(`${label}: ${field} is ${JSON.stringify(current[field])} but pantry.lock records ${JSON.stringify(recorded[field])}`)}for(const field of["dependencies","devDependencies"]){const expected=current[field]??{};const locked=recorded[field]??{};for(const[name,range]of Object.entries(expected)){if(range!==locked[name])problems.push(`${label}: ${field}.${name} is ${JSON.stringify(range)} but pantry.lock records ${JSON.stringify(locked[name])}`)}for(const name of Object.keys(locked)){if(!(name in expected))problems.push(`${label}: pantry.lock records undeclared ${field}.${name}`)}}}for(const workspacePath of Object.keys(workspaces)){if(!(workspacePath in declarations))problems.push(`${workspacePath||"the workspace root"}: pantry.lock records a workspace absent from current declarations`)}}for(const[workspacePath,workspace]of Object.entries(workspaces)){for(const field of DEPENDENCY_FIELDS){const declared=workspace[field];if(!declared||typeof declared!=="object")continue;for(const[name,range]of Object.entries(declared)){if(typeof range!=="string"||UNCOMPARABLE_RANGE.test(range))continue;const versions=resolved.get(name);if(!versions)continue;if(!versions.some((version)=>Bun.semver.satisfies(version,range))){problems.push(`${name} is pinned at ${versions.join(", ")}, which does not satisfy "${range}" `+`declared by ${workspacePath||"the workspace root"} (${field})`)}}}}problems.push(...systemBlockProblems(workspaces[""],baseline));return problems}
@@ -1 +1 @@
1
- import{existsSync,readFileSync}from"node:fs";import{join}from"node:path";export function parsePantryVersion(output){return/\bpantry\s+v?(\d+\.\d+\.\d+(?:-[\w.]+)?)/i.exec(output)?.[1]}export function declaredPantryRange(cwd){for(const file of["storage/framework/core/buddy/package.json","package.json"]){const path=join(cwd,file);if(!existsSync(path))continue;try{const manifest=JSON.parse(readFileSync(path,"utf8")),range=manifest.dependencies?.["ts-pantry"]??manifest.devDependencies?.["ts-pantry"];if(range)return{range,file}}catch{}}return}export function declaredPantryWorkflowVersions(cwd){const versions=[];for(const file of[".github/workflows/ci.yml",".github/workflows/release.yml"]){const path=join(cwd,file);if(!existsSync(path))continue;const workflow=Bun.YAML.parse(readFileSync(path,"utf8"));for(const[job,config]of Object.entries(workflow.jobs??{}))for(const step of config.steps??[])if(step.uses?.startsWith("pantry-pm/pantry/packages/action@"))versions.push({file,job,version:String(step.with?.version??"")})}return versions}function probeVersion(bin){try{const result=Bun.spawnSync([bin,"--version"],{stdout:"pipe",stderr:"pipe"});return{exitCode:result.exitCode??1,stdout:`${result.stdout.toString()}${result.stderr.toString()}`}}catch{return{exitCode:127,stdout:""}}}export function resolvePantryToolchain(options){const env=options.env??process.env,allowOverride=options.allowOverride!==!1,bin=allowOverride&&env.PANTRY_BIN?.trim()||"pantry",result=(options.probe??probeVersion)(bin),version=result.exitCode===0?parsePantryVersion(result.stdout):void 0;if(!version)return{ok:!1,bin,message:`Release aborted: could not run \`${bin} --version\`, so the Pantry that would regenerate pantry.lock is unknown. `+(allowOverride?"Install the declared Pantry, or set PANTRY_BIN to it, then re-run.":"Install the declared Pantry and put it first on PATH, then re-run.")};const declared=declaredPantryRange(options.cwd);if(declared&&!Bun.semver.satisfies(version,declared.range))return{ok:!1,bin,message:`Release aborted before any file changed: \`${bin}\` is Pantry ${version}, but ${declared.file} declares ts-pantry ${declared.range}. A different Pantry writes a different pantry.lock than the one CI validates. `+(allowOverride?"Set PANTRY_BIN to a Pantry that satisfies the declared range (or put one first on PATH), then re-run.":"Install a Pantry that satisfies the declared range and put it first on PATH, then re-run.")};if(declared?.file==="storage/framework/core/buddy/package.json")try{const pins=declaredPantryWorkflowVersions(options.cwd),bootstrap="storage/framework/scripts/pantry-install",bootstrapPath=join(options.cwd,bootstrap);if(existsSync(bootstrapPath))pins.push({file:bootstrap,job:"bootstrap",version:readFileSync(bootstrapPath,"utf8").match(/PANTRY_VERSION:-([0-9.]+)/)?.[1]??""});const mismatches=pins.filter((pin)=>!/^\d+\.\d+\.\d+$/.test(pin.version)||!Bun.semver.satisfies(pin.version,declared.range));if(mismatches.length)return{ok:!1,bin,message:`Release aborted before any file changed: Pantry toolchain pins do not satisfy ts-pantry ${declared.range}: `+mismatches.map((pin)=>`${pin.file} (${pin.job}): ${pin.version||"missing version"}`).join("; ")+". Update the pinned Pantry action and CLI together before releasing."}}catch(error){return{ok:!1,bin,message:`Could not validate CI Pantry versions before release: ${error instanceof Error?error.message:String(error)}`}}return{ok:!0,bin,version,declared:declared?.range,declaredIn:declared?.file}}
1
+ import{existsSync,readFileSync}from"node:fs";import{join}from"node:path";export function parsePantryVersion(output){return/\bpantry\s+v?(\d+\.\d+\.\d+(?:-[\w.]+)?)/i.exec(output)?.[1]}export function declaredPantryRange(cwd){for(const file of["storage/framework/core/buddy/package.json","package.json"]){const path=join(cwd,file);if(!existsSync(path))continue;try{const manifest=JSON.parse(readFileSync(path,"utf8"));const range=manifest.dependencies?.["ts-pantry"]??manifest.devDependencies?.["ts-pantry"];if(range)return{range,file}}catch{}}return}export function declaredPantryWorkflowVersions(cwd){const versions=[];for(const file of[".github/workflows/ci.yml",".github/workflows/release.yml"]){const path=join(cwd,file);if(!existsSync(path))continue;const workflow=Bun.YAML.parse(readFileSync(path,"utf8"));for(const[job,config]of Object.entries(workflow.jobs??{})){for(const step of config.steps??[]){if(step.uses?.startsWith("pantry-pm/pantry/packages/action@"))versions.push({file,job,version:String(step.with?.version??"")})}}}return versions}function probeVersion(bin){try{const result=Bun.spawnSync([bin,"--version"],{stdout:"pipe",stderr:"pipe"});return{exitCode:result.exitCode??1,stdout:`${result.stdout.toString()}${result.stderr.toString()}`}}catch{return{exitCode:127,stdout:""}}}export function resolvePantryToolchain(options){const env=options.env??process.env;const allowOverride=options.allowOverride!==false;const bin=allowOverride&&env.PANTRY_BIN?.trim()||"pantry";const result=(options.probe??probeVersion)(bin);const version=result.exitCode===0?parsePantryVersion(result.stdout):undefined;if(!version){return{ok:false,bin,message:`Release aborted: could not run \`${bin} --version\`, so the Pantry that would regenerate pantry.lock is unknown. `+(allowOverride?"Install the declared Pantry, or set PANTRY_BIN to it, then re-run.":"Install the declared Pantry and put it first on PATH, then re-run.")}}const declared=declaredPantryRange(options.cwd);if(declared&&!Bun.semver.satisfies(version,declared.range)){return{ok:false,bin,message:`Release aborted before any file changed: \`${bin}\` is Pantry ${version}, but ${declared.file} declares ts-pantry ${declared.range}. `+"A different Pantry writes a different pantry.lock than the one CI validates. "+(allowOverride?"Set PANTRY_BIN to a Pantry that satisfies the declared range (or put one first on PATH), then re-run.":"Install a Pantry that satisfies the declared range and put it first on PATH, then re-run.")}}if(declared?.file==="storage/framework/core/buddy/package.json"){try{const pins=declaredPantryWorkflowVersions(options.cwd);const bootstrap="storage/framework/scripts/pantry-install";const bootstrapPath=join(options.cwd,bootstrap);if(existsSync(bootstrapPath))pins.push({file:bootstrap,job:"bootstrap",version:readFileSync(bootstrapPath,"utf8").match(/PANTRY_VERSION:-([0-9.]+)/)?.[1]??""});const mismatches=pins.filter((pin)=>!/^\d+\.\d+\.\d+$/.test(pin.version)||!Bun.semver.satisfies(pin.version,declared.range));if(mismatches.length)return{ok:false,bin,message:`Release aborted before any file changed: Pantry toolchain pins do not satisfy ts-pantry ${declared.range}: `+mismatches.map((pin)=>`${pin.file} (${pin.job}): ${pin.version||"missing version"}`).join("; ")+". Update the pinned Pantry action and CLI together before releasing."}}catch(error){return{ok:false,bin,message:`Could not validate CI Pantry versions before release: ${error instanceof Error?error.message:String(error)}`}}}return{ok:true,bin,version,declared:declared?.range,declaredIn:declared?.file}}
@@ -1 +1 @@
1
- import{createHash}from"node:crypto";import{readFileSync}from"node:fs";import{spawnOwnedProcess}from"@stacksjs/cli/owned-process";import{join}from"node:path";function fail(message){throw Error(message)}export async function runProjectScripts(options){const timeoutMs=options.timeoutMs??300000;if(!Number.isSafeInteger(timeoutMs)||timeoutMs<=0||!options.scripts.length||options.scripts.some((name)=>!/^[a-z0-9][\w:.-]*$/i.test(name))||new Set(options.scripts).size!==options.scripts.length)fail("Project checks need unique script names and a positive execution budget");const receipt={bunVersion:"",checks:[]},manifestPath=join(options.cwd,"package.json"),originalManifest=readFileSync(manifestPath,"utf8"),manifest=JSON.parse(originalManifest),bun=Bun.which("bun",{cwd:options.cwd});if(!bun)fail("Consumer Bun executable is unavailable");const probe=Bun.spawnSync([bun,"--version"],{cwd:options.cwd,stdout:"pipe",stderr:"pipe",timeout:1e4}),bunVersion=probe.stdout.toString().trim();if(probe.exitCode!==0||!/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(bunVersion)||!Bun.semver.satisfies(bunVersion,manifest.engines?.bun??">=1.3.0"))fail("Consumer Bun executable does not satisfy the declared toolchain");receipt.bunVersion=bunVersion;for(const script of options.scripts){if(!Object.hasOwn(manifest.scripts??{},script)||typeof manifest.scripts?.[script]!=="string"||!manifest.scripts[script].trim())fail(`Consumer script ${script} is not declared`);options.signal?.throwIfAborted();const command=[bun,"run",script];let reportExit=()=>{},reportFailure=()=>{};const reported=new Promise((resolve,reject)=>{reportExit=resolve;reportFailure=reject});let interrupted=!1;const child=spawnOwnedProcess(command,{ownerRuntime:bun,cwd:options.cwd,env:{...process.env,...options.env},stdin:"ignore",stdout:"pipe",stderr:"pipe",stopGraceMs:500});child.exited.then((exit)=>reportExit(exit.code),reportFailure);const pipes=[child.stdout,child.stderr].map((stream,index)=>({reader:stream.getReader(),done:!1,source:index===0?"stdout":"stderr"}));let teardown,announceStop=()=>{};const stopped=new Promise((resolve)=>{announceStop=resolve}),waitWithin=async(promise,milliseconds)=>{let timer;try{return await Promise.race([promise,new Promise((_,reject)=>{timer=setTimeout(()=>reject(Error("Process or output cleanup did not finish within its grace period")),milliseconds)})])}finally{if(timer)clearTimeout(timer)}};let draining;const dispose=(preserveOutput)=>{if(teardown)return teardown;teardown=(async()=>{const errors=[];try{await child.stop()}catch(error){errors.push(`Native process cleanup failed: ${String(error)}`)}if(preserveOutput)try{await waitWithin(draining,1000)}catch{errors.push("Output draining exceeded its cleanup grace period")}const close=Promise.all([...pipes.filter((pipe)=>!pipe.done).map(async(pipe)=>{try{await pipe.reader.cancel()}catch{errors.push("Output reader cancellation failed")}}),child.exited]);try{await waitWithin(close,1000)}catch{errors.push("Process or output cleanup exceeded its grace period")}if(errors.length)fail(`Consumer script ${script} cleanup failed: ${errors.join("; ")}`)})();teardown.catch(()=>{});return teardown},stop=()=>{if(interrupted)return;interrupted=!0;dispose(!1);announceStop()},deadline=setTimeout(stop,timeoutMs);options.signal?.addEventListener("abort",stop,{once:!0});if(options.signal?.aborted)stop();const output=createHash("sha256");async function drain(pipe){try{while(!0){const next=await pipe.reader.read();if(next.done)break;output.update(next.value);options.onOutput?.(next.value.slice(),pipe.source)}}finally{pipe.done=!0;pipe.reader.releaseLock()}}let exitCode;try{draining=Promise.all(pipes.map(drain)).then(()=>{});draining.catch(reportFailure);const completion=reported.then((exitCode)=>({kind:"completed",exitCode})),result=await Promise.race([completion,stopped.then(()=>({kind:"interrupted"}))]);if(result.kind==="interrupted"||interrupted){await teardown;fail(`Consumer script ${script} was interrupted or exceeded its execution budget`)}exitCode=result.exitCode;await dispose(!0)}catch(error){const wasInterrupted=interrupted;stop();try{await teardown}catch(cleanupError){if(wasInterrupted)fail(`Consumer script ${script} was interrupted or exceeded its execution budget; ${cleanupError instanceof Error?cleanupError.message:String(cleanupError)}`);throw cleanupError}throw error}finally{clearTimeout(deadline);options.signal?.removeEventListener("abort",stop)}if(interrupted||options.signal?.aborted)fail(`Consumer script ${script} was interrupted or exceeded its execution budget`);if(exitCode!==0)fail(`Consumer script ${script} failed with exit code ${exitCode}`);if(readFileSync(manifestPath,"utf8")!==originalManifest)fail(`Consumer script ${script} changed the project manifest`);receipt.checks.push({script,exitCode:0,outputSha256:output.digest("hex")})}return receipt}
1
+ import{createHash}from"node:crypto";import{readFileSync}from"node:fs";import{spawnOwnedProcess}from"@stacksjs/cli/owned-process";import{join}from"node:path";function fail(message){throw new Error(message)}export async function runProjectScripts(options){const timeoutMs=options.timeoutMs??300000;if(!Number.isSafeInteger(timeoutMs)||timeoutMs<=0||!options.scripts.length||options.scripts.some((name)=>!/^[a-z0-9][\w:.-]*$/i.test(name))||new Set(options.scripts).size!==options.scripts.length)fail("Project checks need unique script names and a positive execution budget");const receipt={bunVersion:"",checks:[]};const manifestPath=join(options.cwd,"package.json");const originalManifest=readFileSync(manifestPath,"utf8");const manifest=JSON.parse(originalManifest);const bun=Bun.which("bun",{cwd:options.cwd});if(!bun)fail("Consumer Bun executable is unavailable");const probe=Bun.spawnSync([bun,"--version"],{cwd:options.cwd,stdout:"pipe",stderr:"pipe",timeout:1e4});const bunVersion=probe.stdout.toString().trim();if(probe.exitCode!==0||!/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(bunVersion)||!Bun.semver.satisfies(bunVersion,manifest.engines?.bun??">=1.3.0"))fail("Consumer Bun executable does not satisfy the declared toolchain");receipt.bunVersion=bunVersion;for(const script of options.scripts){if(!Object.hasOwn(manifest.scripts??{},script)||typeof manifest.scripts?.[script]!=="string"||!manifest.scripts[script].trim())fail(`Consumer script ${script} is not declared`);options.signal?.throwIfAborted();const command=[bun,"run",script];let reportExit=()=>{};let reportFailure=()=>{};const reported=new Promise((resolve,reject)=>{reportExit=resolve;reportFailure=reject});let interrupted=false;const child=spawnOwnedProcess(command,{ownerRuntime:bun,cwd:options.cwd,env:{...process.env,...options.env},stdin:"ignore",stdout:"pipe",stderr:"pipe",stopGraceMs:500});child.exited.then((exit)=>reportExit(exit.code),reportFailure);const pipes=[child.stdout,child.stderr].map((stream,index)=>({reader:stream.getReader(),done:false,source:index===0?"stdout":"stderr"}));let teardown;let announceStop=()=>{};const stopped=new Promise((resolve)=>{announceStop=resolve});const waitWithin=async(promise,milliseconds)=>{let timer;try{return await Promise.race([promise,new Promise((_,reject)=>{timer=setTimeout(()=>reject(new Error("Process or output cleanup did not finish within its grace period")),milliseconds)})])}finally{if(timer)clearTimeout(timer)}};let draining;const dispose=(preserveOutput)=>{if(teardown)return teardown;teardown=(async()=>{const errors=[];try{await child.stop()}catch(error){errors.push(`Native process cleanup failed: ${String(error)}`)}if(preserveOutput){try{await waitWithin(draining,1000)}catch{errors.push("Output draining exceeded its cleanup grace period")}}const close=Promise.all([...pipes.filter((pipe)=>!pipe.done).map(async(pipe)=>{try{await pipe.reader.cancel()}catch{errors.push("Output reader cancellation failed")}}),child.exited]);try{await waitWithin(close,1000)}catch{errors.push("Process or output cleanup exceeded its grace period")}if(errors.length)fail(`Consumer script ${script} cleanup failed: ${errors.join("; ")}`)})();teardown.catch(()=>{});return teardown};const stop=()=>{if(interrupted)return;interrupted=true;dispose(false);announceStop()};const deadline=setTimeout(stop,timeoutMs);options.signal?.addEventListener("abort",stop,{once:true});if(options.signal?.aborted)stop();const output=createHash("sha256");async function drain(pipe){try{while(true){const next=await pipe.reader.read();if(next.done)break;output.update(next.value);options.onOutput?.(next.value.slice(),pipe.source)}}finally{pipe.done=true;pipe.reader.releaseLock()}}let exitCode;try{draining=Promise.all(pipes.map(drain)).then(()=>{});draining.catch(reportFailure);const completion=reported.then((exitCode)=>({kind:"completed",exitCode}));const result=await Promise.race([completion,stopped.then(()=>({kind:"interrupted"}))]);if(result.kind==="interrupted"||interrupted){await teardown;fail(`Consumer script ${script} was interrupted or exceeded its execution budget`)}exitCode=result.exitCode;await dispose(true)}catch(error){const wasInterrupted=interrupted;stop();try{await teardown}catch(cleanupError){if(wasInterrupted)fail(`Consumer script ${script} was interrupted or exceeded its execution budget; ${cleanupError instanceof Error?cleanupError.message:String(cleanupError)}`);throw cleanupError}throw error}finally{clearTimeout(deadline);options.signal?.removeEventListener("abort",stop)}if(interrupted||options.signal?.aborted)fail(`Consumer script ${script} was interrupted or exceeded its execution budget`);if(exitCode!==0)fail(`Consumer script ${script} failed with exit code ${exitCode}`);if(readFileSync(manifestPath,"utf8")!==originalManifest)fail(`Consumer script ${script} changed the project manifest`);receipt.checks.push({script,exitCode:0,outputSha256:output.digest("hex")})}return receipt}
@@ -1 +1 @@
1
- import{readFileSync}from"node:fs";import{join}from"node:path";import{runProjectScripts}from"./project-scripts";export const publicationChannels=["web","preview","desktop","ios","android","github-release"],PUBLICATION_CHECK_SCRIPT="publication:check";export async function assertPublicationAllowed(options){if(!publicationChannels.includes(options.channel))throw Error("Unknown publication channel");const pkg=JSON.parse(readFileSync(join(options.cwd,"package.json"),"utf8"));if(!Object.hasOwn(pkg.scripts??{},PUBLICATION_CHECK_SCRIPT))return{status:"not-configured",channel:options.channel};if(typeof pkg.scripts?.[PUBLICATION_CHECK_SCRIPT]!=="string"||!pkg.scripts[PUBLICATION_CHECK_SCRIPT].trim())throw Error("publication:check must declare a nonempty application policy");const checks=await runProjectScripts({cwd:options.cwd,scripts:[PUBLICATION_CHECK_SCRIPT],signal:options.signal,env:{STACKS_PUBLICATION_CHANNEL:options.channel}});return{status:"passed",channel:options.channel,...checks}}
1
+ import{readFileSync}from"node:fs";import{join}from"node:path";import{runProjectScripts}from"./project-scripts";export const publicationChannels=["web","preview","desktop","ios","android","github-release"];export const PUBLICATION_CHECK_SCRIPT="publication:check";export async function assertPublicationAllowed(options){if(!publicationChannels.includes(options.channel))throw new Error("Unknown publication channel");const pkg=JSON.parse(readFileSync(join(options.cwd,"package.json"),"utf8"));if(!Object.hasOwn(pkg.scripts??{},PUBLICATION_CHECK_SCRIPT))return{status:"not-configured",channel:options.channel};if(typeof pkg.scripts?.[PUBLICATION_CHECK_SCRIPT]!=="string"||!pkg.scripts[PUBLICATION_CHECK_SCRIPT].trim())throw new Error("publication:check must declare a nonempty application policy");const checks=await runProjectScripts({cwd:options.cwd,scripts:[PUBLICATION_CHECK_SCRIPT],signal:options.signal,env:{STACKS_PUBLICATION_CHANNEL:options.channel}});return{status:"passed",channel:options.channel,...checks}}
@@ -1 +1 @@
1
- import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";const options=queueActionOptions(),queueName=options.queue,force=options.force==="true";try{if(!force){log.warn("This will delete all jobs from the queue. Use --force to confirm.");await log.flush();process.exit(1)}let query=db.deleteFrom("jobs");if(queueName)query=query.where("queue","=",queueName);const result=await query.executeTakeFirst(),deletedCount=Number(result.numDeletedRows??0);log.success(`Cleared ${deletedCount} job(s)`);await log.flush();process.exit(0)}catch(error){await log.error("Failed to clear jobs",error);process.exit(1)}
1
+ import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";const options=queueActionOptions();const queueName=options.queue;const force=options.force==="true";try{if(!force){log.warn("This will delete all jobs from the queue. Use --force to confirm.");await log.flush();process.exit(1)}let query=db.deleteFrom("jobs");if(queueName)query=query.where("queue","=",queueName);const result=await query.executeTakeFirst();const deletedCount=Number(result.numDeletedRows??0);log.success(`Cleared ${deletedCount} job(s)`);await log.flush();process.exit(0)}catch(error){await log.error("Failed to clear jobs",error);process.exit(1)}
@@ -1 +1 @@
1
- import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{purgeDeadLetterJobs}from"@stacksjs/queue";const options=queueActionOptions(),days=options.olderThanDays?Number.parseInt(options.olderThanDays,10):options["older-than-days"]?Number.parseInt(options["older-than-days"],10):30;if(!Number.isFinite(days)||days<1){await log.error(`Invalid --older-than-days value '${options.olderThanDays??options["older-than-days"]}'`);process.exit(1)}try{log.info(`Pruning dead-letter rows older than ${days} day(s)...`);const deleted=await purgeDeadLetterJobs(days);log.success(`Deleted ${deleted} dead-letter row(s)`);await log.flush();process.exit(0)}catch(error){await log.error("Failed to purge dead-letter jobs",error);process.exit(1)}
1
+ import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{purgeDeadLetterJobs}from"@stacksjs/queue";const options=queueActionOptions();const days=options.olderThanDays?Number.parseInt(options.olderThanDays,10):options["older-than-days"]?Number.parseInt(options["older-than-days"],10):30;if(!Number.isFinite(days)||days<1){await log.error(`Invalid --older-than-days value '${options.olderThanDays??options["older-than-days"]}'`);process.exit(1)}try{log.info(`Pruning dead-letter rows older than ${days} day(s)...`);const deleted=await purgeDeadLetterJobs(days);log.success(`Deleted ${deleted} dead-letter row(s)`);await log.flush();process.exit(0)}catch(error){await log.error("Failed to purge dead-letter jobs",error);process.exit(1)}
@@ -1 +1 @@
1
- import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{retryDeadLetterJob}from"@stacksjs/queue";const options=queueActionOptions(),idArg=options.id;if(!idArg){await log.error("Usage: buddy queue:dlq:retry --id=<id>");process.exit(1)}const id=Number.parseInt(idArg,10);if(Number.isNaN(id)){await log.error("Invalid id provided");process.exit(1)}try{if(!await retryDeadLetterJob(id)){await log.error(`Dead-letter job ${id} not found (or DLQ table missing)`);process.exit(1)}log.success(`Re-enqueued dead-letter job ${id}`);await log.flush();process.exit(0)}catch(error){await log.error("Failed to re-enqueue dead-letter job",error);process.exit(1)}
1
+ import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{retryDeadLetterJob}from"@stacksjs/queue";const options=queueActionOptions();const idArg=options.id;if(!idArg){await log.error("Usage: buddy queue:dlq:retry --id=<id>");process.exit(1)}const id=Number.parseInt(idArg,10);if(Number.isNaN(id)){await log.error("Invalid id provided");process.exit(1)}try{const ok=await retryDeadLetterJob(id);if(!ok){await log.error(`Dead-letter job ${id} not found (or DLQ table missing)`);process.exit(1)}log.success(`Re-enqueued dead-letter job ${id}`);await log.flush();process.exit(0)}catch(error){await log.error("Failed to re-enqueue dead-letter job",error);process.exit(1)}
package/dist/queue/dlq.js CHANGED
@@ -1,4 +1,4 @@
1
- import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{listDeadLetterJobs}from"@stacksjs/queue";const options=queueActionOptions(),queueName=options.queue||void 0,reason=options.reason||void 0,sinceArg=options.since,limit=options.limit?Number.parseInt(options.limit,10):100;try{log.info(`Fetching dead-letter jobs...
2
- `);const sinceCutoffMs=sinceArg?parseSinceDuration(sinceArg)??void 0:void 0,rows=await listDeadLetterJobs({queue:queueName,reason,sinceCutoffMs,limit});if(rows.length===0){console.log("\u2713 No dead-letter jobs found");process.exit(0)}console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");console.log("\u2502 ID \u2502 Queue \u2502 Reason \u2502 Failures \u2502 Dead-Lettered At \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");for(const row of rows){const id=String(row.id).padEnd(3),q=(row.queue||"default").substring(0,32).padEnd(32),r=(row.reason||"unknown").substring(0,16).padEnd(16),f=String(row.total_failures??1).padEnd(8),dt=(row.dead_lettered_at||"N/A").substring(0,24).padEnd(24);console.log(`\u2502 ${id} \u2502 ${q} \u2502 ${r} \u2502 ${f} \u2502 ${dt} \u2502`)}console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");console.log(`
1
+ import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{listDeadLetterJobs}from"@stacksjs/queue";const options=queueActionOptions();const queueName=options.queue||undefined;const reason=options.reason||undefined;const sinceArg=options.since;const limit=options.limit?Number.parseInt(options.limit,10):100;try{log.info(`Fetching dead-letter jobs...
2
+ `);const sinceCutoffMs=sinceArg?parseSinceDuration(sinceArg)??undefined:undefined;const rows=await listDeadLetterJobs({queue:queueName,reason,sinceCutoffMs,limit});if(rows.length===0){console.log("✓ No dead-letter jobs found");process.exit(0)}console.log("┌─────┬──────────────────────────────────┬──────────────────┬──────────┬──────────────────────────┐");console.log("│ ID │ Queue │ Reason │ Failures │ Dead-Lettered At │");console.log("├─────┼──────────────────────────────────┼──────────────────┼──────────┼──────────────────────────┤");for(const row of rows){const id=String(row.id).padEnd(3);const q=(row.queue||"default").substring(0,32).padEnd(32);const r=(row.reason||"unknown").substring(0,16).padEnd(16);const f=String(row.total_failures??1).padEnd(8);const dt=(row.dead_lettered_at||"N/A").substring(0,24).padEnd(24);console.log(`│ ${id} │ ${q} │ ${r} │ ${f} │ ${dt} │`)}console.log("└─────┴──────────────────────────────────┴──────────────────┴──────────┴──────────────────────────┘");console.log(`
3
3
  Showing ${rows.length} dead-letter job(s)`);process.exit(0)}catch(error){const message=error instanceof Error?error.message:String(error);if(/no such table:\s*dead_letter_jobs\b/i.test(message)){process.stdout.write(`Dead-letter queue table is not set up yet.
4
4
  `);process.stdout.write("Run `buddy queue:table` to create the migrations, then `buddy migrate` to apply them.\n");process.exit(0)}await log.error("Failed to fetch dead-letter jobs",error);process.exit(1)}function parseSinceDuration(input){const m=/^(\d+)([smhd])$/.exec(input.trim());if(!m)return null;const n=Number(m[1]);if(!Number.isFinite(n)||n<=0)return null;const mult=m[2]==="s"?1000:m[2]==="m"?60000:m[2]==="h"?3600000:86400000;return Date.now()-n*mult}
@@ -1,4 +1,4 @@
1
- import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";const options=queueActionOptions(),{queue:queueName,since:sinceArg}=options,sinceCutoff=sinceArg?parseSinceDuration(sinceArg):null;try{log.info(`Fetching failed jobs...
2
- `);let failedJobs;if(queueName)failedJobs=await db.selectFrom("failed_jobs").selectAll().where("queue","=",queueName).execute();else failedJobs=await db.selectFrom("failed_jobs").selectAll().execute();if(sinceCutoff)failedJobs=failedJobs.filter((j)=>{if(!j.failed_at)return!1;const ts=Date.parse(String(j.failed_at));return Number.isFinite(ts)&&ts>=sinceCutoff});if(failedJobs.length===0){if(sinceCutoff)console.log(`\u2713 No failed jobs found since ${sinceArg}`);else console.log("\u2713 No failed jobs found");process.exit(0)}console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");console.log("\u2502 ID \u2502 Queue \u2502 Failed At \u2502 Exception \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");for(const job of failedJobs){const id=String(job.id).padEnd(3),queue=(job.queue||"default").substring(0,48).padEnd(48),failedAt=String(job.failed_at||"N/A").substring(0,21).padEnd(21),exception=String(job.exception||"Unknown error").substring(0,31).padEnd(31);console.log(`\u2502 ${id} \u2502 ${queue} \u2502 ${failedAt} \u2502 ${exception} \u2502`)}console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");console.log(`
1
+ import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";const options=queueActionOptions();const queueName=options.queue;const sinceArg=options.since;const sinceCutoff=sinceArg?parseSinceDuration(sinceArg):null;try{log.info(`Fetching failed jobs...
2
+ `);let failedJobs;if(queueName){failedJobs=await db.selectFrom("failed_jobs").selectAll().where("queue","=",queueName).execute()}else{failedJobs=await db.selectFrom("failed_jobs").selectAll().execute()}if(sinceCutoff){failedJobs=failedJobs.filter((j)=>{if(!j.failed_at)return false;const ts=Date.parse(String(j.failed_at));return Number.isFinite(ts)&&ts>=sinceCutoff})}if(failedJobs.length===0){if(sinceCutoff){console.log(`✓ No failed jobs found since ${sinceArg}`)}else{console.log("✓ No failed jobs found")}process.exit(0)}console.log("┌─────┬──────────────────────────────────────────────────┬───────────────────────┬─────────────────────────────────┐");console.log("│ ID │ Queue │ Failed At │ Exception │");console.log("├─────┼──────────────────────────────────────────────────┼───────────────────────┼─────────────────────────────────┤");for(const job of failedJobs){const id=String(job.id).padEnd(3);const queue=(job.queue||"default").substring(0,48).padEnd(48);const failedAt=String(job.failed_at||"N/A").substring(0,21).padEnd(21);const exception=String(job.exception||"Unknown error").substring(0,31).padEnd(31);console.log(`│ ${id} │ ${queue} │ ${failedAt} │ ${exception} │`)}console.log("└─────┴──────────────────────────────────────────────────┴───────────────────────┴─────────────────────────────────┘");console.log(`
3
3
  Total: ${failedJobs.length} failed job(s)`);process.exit(0)}catch(error){const message=error instanceof Error?error.message:String(error);if(/no such table:\s*(?:jobs|failed_jobs)\b/i.test(message)){process.stdout.write(`Queue tables are not set up yet.
4
4
  `);process.stdout.write("Run `buddy queue:table` to create the migrations, then `buddy migrate` to apply them.\n");process.exit(0)}await log.error("Failed to fetch failed jobs",error);process.exit(1)}function parseSinceDuration(input){const m=/^(\d+)([smhd])$/.exec(input.trim());if(!m)return null;const n=Number(m[1]);if(!Number.isFinite(n)||n<=0)return null;const mult=m[2]==="s"?1000:m[2]==="m"?60000:m[2]==="h"?3600000:86400000;return Date.now()-n*mult}
@@ -1,2 +1,2 @@
1
- import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";const options=queueActionOptions(),queueName=options.queue,force=options.force==="true";try{if(!force){log.warn("This will permanently delete all failed jobs. Use --force to confirm.");await log.flush();process.exit(1)}let query=db.deleteFrom("failed_jobs");if(queueName)query=query.where("queue","=",queueName);const result=await query.executeTakeFirst(),deletedCount=Number(result.numDeletedRows??0);log.success(`Flushed ${deletedCount} failed job(s)`);await log.flush();process.exit(0)}catch(error){const message=error instanceof Error?error.message:String(error);if(/no such table:\s*(?:jobs|failed_jobs)\b/i.test(message)){process.stdout.write(`Queue tables are not set up yet.
1
+ import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";const options=queueActionOptions();const queueName=options.queue;const force=options.force==="true";try{if(!force){log.warn("This will permanently delete all failed jobs. Use --force to confirm.");await log.flush();process.exit(1)}let query=db.deleteFrom("failed_jobs");if(queueName)query=query.where("queue","=",queueName);const result=await query.executeTakeFirst();const deletedCount=Number(result.numDeletedRows??0);log.success(`Flushed ${deletedCount} failed job(s)`);await log.flush();process.exit(0)}catch(error){const message=error instanceof Error?error.message:String(error);if(/no such table:\s*(?:jobs|failed_jobs)\b/i.test(message)){process.stdout.write(`Queue tables are not set up yet.
2
2
  `);process.stdout.write("Run `buddy queue:table` to create the migrations, then `buddy migrate` to apply them.\n");process.exit(0)}await log.error("Failed to flush failed jobs",error);process.exit(1)}
@@ -1,7 +1,7 @@
1
- import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";const options=queueActionOptions(),jobId=options.id,failedFlag=options.failed==="true";try{if(!jobId){await log.error("Please provide a job ID");log.info("Usage: buddy queue:inspect --id=<jobId> [--failed]");await log.flush();process.exit(1)}const id=Number.parseInt(jobId,10);if(Number.isNaN(id)){await log.error("Invalid job ID provided");process.exit(1)}if(failedFlag){const failedResult=await db.selectFrom("failed_jobs").selectAll().where("id","=",id).executeTakeFirst();if(!failedResult){await log.error(`Failed job with ID ${id} not found`);process.exit(1)}const job=failedResult;console.log(`
2
- \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510`);console.log("\u2502 Failed Job Details \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");console.log(`\u2502 ID: ${String(job.id).padEnd(52)} \u2502`);console.log(`\u2502 Queue: ${(job.queue||"default").padEnd(52)} \u2502`);console.log(`\u2502 Connection: ${(job.connection||"database").padEnd(52)} \u2502`);console.log(`\u2502 Failed At: ${String(job.failed_at||"N/A").padEnd(52)} \u2502`);console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");console.log("\u2502 Exception: \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");const exception=job.exception||"Unknown error",lines=exception.match(/.{1,62}/g)||[exception];for(const line of lines.slice(0,20))console.log(`\u2502 ${line.padEnd(62)} \u2502`);if(lines.length>20)console.log(`\u2502 ... (${lines.length-20} more lines)`.padEnd(64)+" \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");console.log("\u2502 Payload: \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");if(job.payload)try{const payload=JSON.parse(job.payload);console.log(`\u2502 Name: ${payload.name.padEnd(52)} \u2502`);console.log(`\u2502 Path: ${payload.path.padEnd(52)} \u2502`);console.log(`\u2502 Max Tries: ${String(payload.maxTries).padEnd(52)} \u2502`);console.log("\u2502 Parameters: \u2502");const paramLines=JSON.stringify(payload.params,null,2).split(`
3
- `);for(const line of paramLines.slice(0,15))console.log(`\u2502 ${line.substring(0,60).padEnd(60)} \u2502`);if(paramLines.length>15)console.log(`\u2502 ... (${paramLines.length-15} more lines)`.padEnd(64)+" \u2502")}catch{console.log(`\u2502 Raw: ${job.payload.substring(0,58).padEnd(58)} \u2502`)}else console.log("\u2502 (No payload) \u2502");console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");console.log(`
4
- Actions:`);console.log(` Retry this job: buddy queue:retry --id=${id}`);console.log(` Delete this job: buddy queue:flush --id=${id}`)}else{const jobResult=await db.selectFrom("jobs").selectAll().where("id","=",id).executeTakeFirst();if(!jobResult){await log.error(`Job with ID ${id} not found`);log.info("Tip: Use --failed flag to inspect failed jobs");await log.flush();process.exit(1)}const job=jobResult,now=Math.floor(Date.now()/1000);let status="Pending";if(job.reserved_at)status="Processing";else if(job.available_at&&job.available_at>now)status="Delayed";console.log(`
5
- \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510`);console.log("\u2502 Job Details \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");console.log(`\u2502 ID: ${String(job.id).padEnd(50)} \u2502`);console.log(`\u2502 Queue: ${(job.queue||"default").padEnd(50)} \u2502`);console.log(`\u2502 Status: ${status.padEnd(50)} \u2502`);console.log(`\u2502 Attempts: ${String(job.attempts||0).padEnd(50)} \u2502`);console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");if(job.available_at){const availableDate=new Date(job.available_at*1000);console.log(`\u2502 Available At: ${availableDate.toISOString().padEnd(50)} \u2502`)}if(job.reserved_at){const reservedDate=new Date(job.reserved_at*1000);console.log(`\u2502 Reserved At: ${reservedDate.toISOString().padEnd(50)} \u2502`)}if(job.created_at)console.log(`\u2502 Created At: ${String(job.created_at).padEnd(50)} \u2502`);console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");console.log("\u2502 Payload: \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");if(job.payload)try{const payload=JSON.parse(job.payload);console.log(`\u2502 Name: ${payload.name.padEnd(52)} \u2502`);console.log(`\u2502 Path: ${payload.path.padEnd(52)} \u2502`);console.log(`\u2502 Max Tries: ${String(payload.maxTries).padEnd(52)} \u2502`);console.log(`\u2502 Timeout: ${String(payload.timeOut||"N/A").padEnd(52)} \u2502`);console.log("\u2502 Parameters: \u2502");const paramLines=JSON.stringify(payload.params,null,2).split(`
6
- `);for(const line of paramLines.slice(0,15))console.log(`\u2502 ${line.substring(0,60).padEnd(60)} \u2502`);if(paramLines.length>15)console.log(`\u2502 ... (${paramLines.length-15} more lines)`.padEnd(64)+" \u2502");if(payload.classPayload)try{const classConfig=JSON.parse(payload.classPayload);console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");console.log("\u2502 Job Configuration: \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");console.log(`\u2502 Tries: ${String(classConfig.tries||3).padEnd(52)} \u2502`);console.log(`\u2502 Timeout: ${String(classConfig.timeout||60).padEnd(52)} \u2502`);if(classConfig.backoff)console.log(`\u2502 Backoff: ${String(JSON.stringify(classConfig.backoff)).substring(0,52).padEnd(52)} \u2502`)}catch{}}catch{console.log(`\u2502 Raw: ${job.payload.substring(0,58).padEnd(58)} \u2502`)}else console.log("\u2502 (No payload) \u2502");console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");if(status==="Delayed"&&job.available_at){const waitTime=job.available_at-now;console.log(`
1
+ import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";const options=queueActionOptions();const jobId=options.id;const failedFlag=options.failed==="true";try{if(!jobId){await log.error("Please provide a job ID");log.info("Usage: buddy queue:inspect --id=<jobId> [--failed]");await log.flush();process.exit(1)}const id=Number.parseInt(jobId,10);if(Number.isNaN(id)){await log.error("Invalid job ID provided");process.exit(1)}if(failedFlag){const failedResult=await db.selectFrom("failed_jobs").selectAll().where("id","=",id).executeTakeFirst();if(!failedResult){await log.error(`Failed job with ID ${id} not found`);process.exit(1)}const job=failedResult;console.log(`
2
+ ┌────────────────────────────────────────────────────────────────┐`);console.log("│ Failed Job Details │");console.log("├────────────────────────────────────────────────────────────────┤");console.log(`│ ID: ${String(job.id).padEnd(52)} │`);console.log(`│ Queue: ${(job.queue||"default").padEnd(52)} │`);console.log(`│ Connection: ${(job.connection||"database").padEnd(52)} │`);console.log(`│ Failed At: ${String(job.failed_at||"N/A").padEnd(52)} │`);console.log("├────────────────────────────────────────────────────────────────┤");console.log("│ Exception: │");console.log("├────────────────────────────────────────────────────────────────┤");const exception=job.exception||"Unknown error";const lines=exception.match(/.{1,62}/g)||[exception];for(const line of lines.slice(0,20)){console.log(`│ ${line.padEnd(62)} │`)}if(lines.length>20){console.log(`│ ... (${lines.length-20} more lines)`.padEnd(64)+" │")}console.log("├────────────────────────────────────────────────────────────────┤");console.log("│ Payload: │");console.log("├────────────────────────────────────────────────────────────────┤");if(job.payload){try{const payload=JSON.parse(job.payload);console.log(`│ Name: ${payload.name.padEnd(52)} │`);console.log(`│ Path: ${payload.path.padEnd(52)} │`);console.log(`│ Max Tries: ${String(payload.maxTries).padEnd(52)} │`);console.log("│ Parameters: │");const paramsJson=JSON.stringify(payload.params,null,2);const paramLines=paramsJson.split(`
3
+ `);for(const line of paramLines.slice(0,15)){console.log(`│ ${line.substring(0,60).padEnd(60)} │`)}if(paramLines.length>15){console.log(`│ ... (${paramLines.length-15} more lines)`.padEnd(64)+" │")}}catch{console.log(`│ Raw: ${job.payload.substring(0,58).padEnd(58)} │`)}}else{console.log("│ (No payload) │")}console.log("└────────────────────────────────────────────────────────────────┘");console.log(`
4
+ Actions:`);console.log(` Retry this job: buddy queue:retry --id=${id}`);console.log(` Delete this job: buddy queue:flush --id=${id}`)}else{const jobResult=await db.selectFrom("jobs").selectAll().where("id","=",id).executeTakeFirst();if(!jobResult){await log.error(`Job with ID ${id} not found`);log.info("Tip: Use --failed flag to inspect failed jobs");await log.flush();process.exit(1)}const job=jobResult;const now=Math.floor(Date.now()/1000);let status="Pending";if(job.reserved_at){status="Processing"}else if(job.available_at&&job.available_at>now){status="Delayed"}console.log(`
5
+ ┌────────────────────────────────────────────────────────────────┐`);console.log("│ Job Details │");console.log("├────────────────────────────────────────────────────────────────┤");console.log(`│ ID: ${String(job.id).padEnd(50)} │`);console.log(`│ Queue: ${(job.queue||"default").padEnd(50)} │`);console.log(`│ Status: ${status.padEnd(50)} │`);console.log(`│ Attempts: ${String(job.attempts||0).padEnd(50)} │`);console.log("├────────────────────────────────────────────────────────────────┤");if(job.available_at){const availableDate=new Date(job.available_at*1000);console.log(`│ Available At: ${availableDate.toISOString().padEnd(50)} │`)}if(job.reserved_at){const reservedDate=new Date(job.reserved_at*1000);console.log(`│ Reserved At: ${reservedDate.toISOString().padEnd(50)} │`)}if(job.created_at){console.log(`│ Created At: ${String(job.created_at).padEnd(50)} │`)}console.log("├────────────────────────────────────────────────────────────────┤");console.log("│ Payload: │");console.log("├────────────────────────────────────────────────────────────────┤");if(job.payload){try{const payload=JSON.parse(job.payload);console.log(`│ Name: ${payload.name.padEnd(52)} │`);console.log(`│ Path: ${payload.path.padEnd(52)} │`);console.log(`│ Max Tries: ${String(payload.maxTries).padEnd(52)} │`);console.log(`│ Timeout: ${String(payload.timeOut||"N/A").padEnd(52)} │`);console.log("│ Parameters: │");const paramsJson=JSON.stringify(payload.params,null,2);const paramLines=paramsJson.split(`
6
+ `);for(const line of paramLines.slice(0,15)){console.log(`│ ${line.substring(0,60).padEnd(60)} │`)}if(paramLines.length>15){console.log(`│ ... (${paramLines.length-15} more lines)`.padEnd(64)+" │")}if(payload.classPayload){try{const classConfig=JSON.parse(payload.classPayload);console.log("├────────────────────────────────────────────────────────────────┤");console.log("│ Job Configuration: │");console.log("├────────────────────────────────────────────────────────────────┤");console.log(`│ Tries: ${String(classConfig.tries||3).padEnd(52)} │`);console.log(`│ Timeout: ${String(classConfig.timeout||60).padEnd(52)} │`);if(classConfig.backoff){console.log(`│ Backoff: ${String(JSON.stringify(classConfig.backoff)).substring(0,52).padEnd(52)} │`)}}catch{}}}catch{console.log(`│ Raw: ${job.payload.substring(0,58).padEnd(58)} │`)}}else{console.log("│ (No payload) │")}console.log("└────────────────────────────────────────────────────────────────┘");if(status==="Delayed"&&job.available_at){const waitTime=job.available_at-now;console.log(`
7
7
  This job will be available in ${waitTime} second(s)`)}}process.exit(0)}catch(error){await log.error("Failed to inspect job",error);process.exit(1)}
@@ -1,4 +1,4 @@
1
- import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";const options=queueActionOptions(),{queue:queueName,status:statusFilter}=options,limit=options.limit?Number.parseInt(options.limit,10):50;try{log.info(`Fetching queued jobs...
2
- `);let jobs=queueName?await db.selectFrom("jobs").selectAll().where("queue","=",queueName).execute():await db.selectFrom("jobs").selectAll().execute();const nowSec=Math.floor(Date.now()/1000);if(statusFilter==="pending")jobs=jobs.filter((j)=>!j.reserved_at&&(j.available_at??0)<=nowSec);else if(statusFilter==="reserved")jobs=jobs.filter((j)=>Boolean(j.reserved_at));else if(statusFilter==="delayed")jobs=jobs.filter((j)=>!j.reserved_at&&(j.available_at??0)>nowSec);if(Number.isFinite(limit)&&limit>0)jobs=jobs.slice(0,limit);if(jobs.length===0){console.log("\u2713 No queued jobs found");process.exit(0)}console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");console.log("\u2502 ID \u2502 Queue \u2502 Job \u2502 Attempts \u2502 Status \u2502 Available At \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");for(const j of jobs){const jobAny=j,id=String(jobAny.id??"").padEnd(3),queue=String(jobAny.queue??"default").substring(0,18).padEnd(18),jobName=extractJobName(jobAny.payload).substring(0,32).padEnd(32),attempts=String(jobAny.attempts??0).padEnd(8),status=(jobAny.reserved_at?"reserved":(jobAny.available_at??0)>nowSec?"delayed":"pending").padEnd(8),avail=formatUnixTime(jobAny.available_at).padEnd(19);console.log(`\u2502 ${id} \u2502 ${queue} \u2502 ${jobName} \u2502 ${attempts} \u2502 ${status} \u2502 ${avail} \u2502`)}console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");console.log(`
1
+ import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";const options=queueActionOptions();const queueName=options.queue;const statusFilter=options.status;const limit=options.limit?Number.parseInt(options.limit,10):50;try{log.info(`Fetching queued jobs...
2
+ `);let jobs=queueName?await db.selectFrom("jobs").selectAll().where("queue","=",queueName).execute():await db.selectFrom("jobs").selectAll().execute();const nowSec=Math.floor(Date.now()/1000);if(statusFilter==="pending"){jobs=jobs.filter((j)=>!j.reserved_at&&(j.available_at??0)<=nowSec)}else if(statusFilter==="reserved"){jobs=jobs.filter((j)=>Boolean(j.reserved_at))}else if(statusFilter==="delayed"){jobs=jobs.filter((j)=>!j.reserved_at&&(j.available_at??0)>nowSec)}if(Number.isFinite(limit)&&limit>0){jobs=jobs.slice(0,limit)}if(jobs.length===0){console.log("✓ No queued jobs found");process.exit(0)}console.log("┌─────┬────────────────────┬──────────────────────────────────┬──────────┬──────────┬─────────────────────┐");console.log("│ ID │ Queue │ Job │ Attempts │ Status │ Available At │");console.log("├─────┼────────────────────┼──────────────────────────────────┼──────────┼──────────┼─────────────────────┤");for(const j of jobs){const jobAny=j;const id=String(jobAny.id??"").padEnd(3);const queue=String(jobAny.queue??"default").substring(0,18).padEnd(18);const jobName=extractJobName(jobAny.payload).substring(0,32).padEnd(32);const attempts=String(jobAny.attempts??0).padEnd(8);const status=(jobAny.reserved_at?"reserved":(jobAny.available_at??0)>nowSec?"delayed":"pending").padEnd(8);const avail=formatUnixTime(jobAny.available_at).padEnd(19);console.log(`│ ${id} │ ${queue} │ ${jobName} │ ${attempts} │ ${status} │ ${avail} │`)}console.log("└─────┴────────────────────┴──────────────────────────────────┴──────────┴──────────┴─────────────────────┘");console.log(`
3
3
  Showing ${jobs.length} job(s)${queueName?` on queue '${queueName}'`:""}${statusFilter?` (status=${statusFilter})`:""}`);process.exit(0)}catch(error){const message=error instanceof Error?error.message:String(error);if(/no such table:\s*jobs\b/i.test(message)){process.stdout.write(`Queue tables are not set up yet.
4
4
  `);process.stdout.write("Run `buddy queue:table` to create the migrations, then `buddy migrate` to apply them.\n");process.exit(0)}await log.error("Failed to list queued jobs",error);process.exit(1)}function extractJobName(payload){if(typeof payload!=="string")return"unknown";try{const parsed=JSON.parse(payload);return parsed.jobName??parsed.name??"unknown"}catch{return"unknown"}}function formatUnixTime(seconds){if(typeof seconds!=="number"||!Number.isFinite(seconds))return"N/A";return new Date(seconds*1000).toISOString().slice(0,19).replace("T"," ")}
@@ -1,6 +1,6 @@
1
- import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";import{getActiveJobCount,isWorkerRunning}from"@stacksjs/queue";const options=queueActionOptions(),queueName=options.queue,refreshInterval=Number(options.interval)||2000;let isRunning=!0;process.on("SIGINT",()=>{isRunning=!1;console.log(`
1
+ import{queueActionOptions}from"./options";import process from"node:process";import{log}from"@stacksjs/logging";import{db}from"@stacksjs/database";import{getActiveJobCount,isWorkerRunning}from"@stacksjs/queue";const options=queueActionOptions();const queueName=options.queue;const refreshInterval=Number(options.interval)||2000;let isRunning=true;process.on("SIGINT",()=>{isRunning=false;console.log(`
2
2
 
3
- Monitoring stopped.`);process.exit(0)});process.on("SIGTERM",()=>{isRunning=!1;process.exit(0)});async function getStats(){const allJobs=queueName?await db.selectFrom("jobs").selectAll().where("queue","=",queueName).execute():await db.selectFrom("jobs").selectAll().execute(),failedJobs=queueName?await db.selectFrom("failed_jobs").selectAll().where("queue","=",queueName).execute():await db.selectFrom("failed_jobs").selectAll().execute(),now=Math.floor(Date.now()/1000);let pending=0,processing=0,delayed=0;for(const job of allJobs)if(job.reserved_at)processing++;else if(job.available_at&&Number(job.available_at)>now)delayed++;else pending++;return{pending,processing,delayed,failed:failedJobs.length,total:allJobs.length,workerRunning:isWorkerRunning(),activeJobs:getActiveJobCount()}}async function displayStats(){const stats=await getStats(),timestamp=new Date().toLocaleTimeString();console.clear();console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");console.log("\u2502 Queue Monitor \u2502");console.log("\u2502 Press Ctrl+C to exit \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");console.log(`\u2502 Last Updated: ${timestamp.padEnd(48)} \u2502`);console.log(`\u2502 Queue Filter: ${(queueName||"All Queues").padEnd(48)} \u2502`);console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");console.log("\u2502 \u2502");console.log(`\u2502 Pending Jobs: ${String(stats.pending).padStart(8)} \u2502`);console.log(`\u2502 Processing Jobs: ${String(stats.processing).padStart(8)} \u2502`);console.log(`\u2502 Delayed Jobs: ${String(stats.delayed).padStart(8)} \u2502`);console.log(`\u2502 Failed Jobs: ${String(stats.failed).padStart(8)} \u2502`);console.log("\u2502 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 \u2502");console.log(`\u2502 Total Jobs: ${String(stats.total).padStart(8)} \u2502`);console.log("\u2502 \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");console.log("\u2502 Worker Status \u2502");console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");console.log(`\u2502 Worker Running: ${(stats.workerRunning?"Yes":"No").padEnd(8)} \u2502`);console.log(`\u2502 Active Jobs: ${String(stats.activeJobs).padStart(8)} \u2502`);console.log("\u2502 \u2502");console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");if(stats.failed>0)console.log(`
4
- \u26A0\uFE0F Warning: ${stats.failed} failed job(s) - run 'buddy queue:failed' for details`);if(!stats.workerRunning&&stats.pending>0)console.log(`
5
- \u26A0\uFE0F Warning: Worker not running but ${stats.pending} job(s) pending - run 'buddy queue:work'`)}try{log.info(`Starting queue monitor...
6
- `);await displayStats();while(isRunning){await new Promise((resolve)=>setTimeout(resolve,refreshInterval));if(isRunning)await displayStats()}}catch(error){await log.error("Monitor error:",error);process.exit(1)}
3
+ Monitoring stopped.`);process.exit(0)});process.on("SIGTERM",()=>{isRunning=false;process.exit(0)});async function getStats(){const allJobs=queueName?await db.selectFrom("jobs").selectAll().where("queue","=",queueName).execute():await db.selectFrom("jobs").selectAll().execute();const failedJobs=queueName?await db.selectFrom("failed_jobs").selectAll().where("queue","=",queueName).execute():await db.selectFrom("failed_jobs").selectAll().execute();const now=Math.floor(Date.now()/1000);let pending=0;let processing=0;let delayed=0;for(const job of allJobs){if(job.reserved_at){processing++}else if(job.available_at&&Number(job.available_at)>now){delayed++}else{pending++}}return{pending,processing,delayed,failed:failedJobs.length,total:allJobs.length,workerRunning:isWorkerRunning(),activeJobs:getActiveJobCount()}}async function displayStats(){const stats=await getStats();const timestamp=new Date().toLocaleTimeString();console.clear();console.log("┌────────────────────────────────────────────────────────────────┐");console.log("│ Queue Monitor │");console.log("│ Press Ctrl+C to exit │");console.log("├────────────────────────────────────────────────────────────────┤");console.log(`│ Last Updated: ${timestamp.padEnd(48)} │`);console.log(`│ Queue Filter: ${(queueName||"All Queues").padEnd(48)} │`);console.log("├────────────────────────────────────────────────────────────────┤");console.log("│ │");console.log(`│ Pending Jobs: ${String(stats.pending).padStart(8)} │`);console.log(`│ Processing Jobs: ${String(stats.processing).padStart(8)} │`);console.log(`│ Delayed Jobs: ${String(stats.delayed).padStart(8)} │`);console.log(`│ Failed Jobs: ${String(stats.failed).padStart(8)} │`);console.log("│ ──────── │");console.log(`│ Total Jobs: ${String(stats.total).padStart(8)} │`);console.log("│ │");console.log("├────────────────────────────────────────────────────────────────┤");console.log("│ Worker Status │");console.log("├────────────────────────────────────────────────────────────────┤");console.log(`│ Worker Running: ${(stats.workerRunning?"Yes":"No").padEnd(8)} │`);console.log(`│ Active Jobs: ${String(stats.activeJobs).padStart(8)} │`);console.log("│ │");console.log("└────────────────────────────────────────────────────────────────┘");if(stats.failed>0){console.log(`
4
+ ⚠️ Warning: ${stats.failed} failed job(s) - run 'buddy queue:failed' for details`)}if(!stats.workerRunning&&stats.pending>0){console.log(`
5
+ ⚠️ Warning: Worker not running but ${stats.pending} job(s) pending - run 'buddy queue:work'`)}}try{log.info(`Starting queue monitor...
6
+ `);await displayStats();while(isRunning){await new Promise((resolve)=>setTimeout(resolve,refreshInterval));if(isRunning){await displayStats()}}}catch(error){await log.error("Monitor error:",error);process.exit(1)}
@@ -1 +1 @@
1
- import{parseArgv}from"@stacksjs/cli";export function queueActionOptions(argv=process.argv.slice(2)){const{options}=parseArgv(argv,{coerceValues:!1}),values=new Set(["add","queue","id","for","concurrency","interval","limit","name","olderThanDays","reason","since","status"]);for(const[key,value]of Object.entries(options))if(values.has(key)&&typeof value!=="string")throw TypeError(`--${key} requires a value`);return Object.fromEntries(Object.entries(options).map(([key,value])=>[key,String(value)]))}
1
+ import{parseArgv}from"@stacksjs/cli";export function queueActionOptions(argv=process.argv.slice(2)){const{options}=parseArgv(argv,{coerceValues:false});const values=new Set(["add","queue","id","for","concurrency","interval","limit","name","olderThanDays","reason","since","status"]);for(const[key,value]of Object.entries(options)){if(values.has(key)&&typeof value!=="string")throw new TypeError(`--${key} requires a value`)}return Object.fromEntries(Object.entries(options).map(([key,value])=>[key,String(value)]))}