@stacksjs/actions 0.75.174 → 0.75.176

package/dist/build/ios-toolchain.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Where Pantry keeps installed packages, most specific first: the project's
+ * own `pantry/`, the user install (`pantry install --user`, which `setup:ios`
+ * uses), then a system-wide one.
+ */
+export declare function pantryPackageRoots(projectRoot: string, env?: Env): string[];
+/**
+ * The highest installed version of `pkg` under `roots` that satisfies
+ * `constraint` and ships `program`, searching the roots in order.
+ */
+export declare function findPantryProgram(pkg: string, constraint: string, program: string, roots: string[], fs?: Filesystem): PantryTool | null;
+/**
+ * `iosDependencies` from config/deps.ts over the framework default, so an app
+ * that pins one tool still gets the others.
+ */
+export declare function loadIosDependencies(projectRoot: string): Promise<Record<string, string>>;
+/** `pantry install` arguments for the iOS tools, into the user install. */
+export declare function pantryInstallArgs(dependencies: Record<string, string>): string[];
+/** The Pantry executable: PANTRY_BIN, the project's, the user's, else `pantry` on PATH. */
+export declare function pantryExecutable(projectRoot: string, env?: Env, exists?: (path: string) => boolean): string;
+export declare function missingToolMessage(pkg: string, constraint: string, program: string): string;
+/** xcodegen from Pantry, or an {@link IosToolchainError} that says how to install it. */
+export declare function resolveXcodegen(projectRoot: string, options?: { env?: Env, fs?: Filesystem }): Promise<PantryTool>;
+/** The preset file xcodegen needs beside its binary, at `<prefix>/share/xcodegen`. */
+export declare function xcodegenPresets(tool: PantryTool): string;
+/*.xcodeproj` from its project.yml with the given xcodegen. */
+export declare function generateXcodeProject(xcodegen: PantryTool, output: string): void;
+/** The selected Xcode's developer directory, or null when there is none. */
+export declare function xcodeDeveloperDir(): string | null;
+export declare const XCODEGEN_PACKAGE: 'github.com/yonaskolb/XcodeGen';
+/** The tools `build:ios` runs, when config/deps.ts declares no `iosDependencies`. */
+export declare const DEFAULT_IOS_DEPENDENCIES: Readonly<Record<string, string>>;
+export declare const XCODE_NOTE: 'Xcode itself does not come from Pantry: install it from the Mac App Store or developer.apple.com, then select it with `sudo xcode-select --switch /Applications/Xcode.app`.';
+export declare interface PantryTool {
+  pkg: string
+  constraint: string
+  version: string
+  path: string
+}
+declare interface Filesystem {
+  exists: (path: string) => boolean
+  list: (path: string) => string[]
+}
+declare type Env = Record<string, string | undefined>;
+export declare class IosToolchainError extends Error {
+  name: string;
+}

package/dist/build/ios-toolchain.js

@@ -0,0 +1,2 @@
+import{existsSync,readdirSync}from"node:fs";import{homedir}from"node:os";import{dirname,join}from"node:path";import process from"node:process";import{pathToFileURL}from"node:url";export const XCODEGEN_PACKAGE="github.com/yonaskolb/XcodeGen",DEFAULT_IOS_DEPENDENCIES={[XCODEGEN_PACKAGE]:"^2.46.0"},XCODE_NOTE="Xcode itself does not come from Pantry: install it from the Mac App Store or developer.apple.com, then select it with `sudo xcode-select --switch /Applications/Xcode.app`.";export class IosToolchainError extends Error{name="IosToolchainError"}const realFilesystem={exists:existsSync,list:(path)=>{try{return readdirSync(path)}catch{return[]}}};export function pantryPackageRoots(projectRoot,env=process.env){const home=env.HOME||homedir(),data=env.XDG_DATA_HOME||join(home,".local","share");return[join(projectRoot,"pantry"),join(data,"pantry","global","packages"),"/usr/local/packages"]}export function findPantryProgram(pkg,constraint,program,roots,fs=realFilesystem){for(const root of roots){const versions=fs.list(join(root,pkg)).filter((entry)=>/^v\d+\.\d+\.\d+$/.test(entry)).map((entry)=>entry.slice(1)).filter((version)=>Bun.semver.satisfies(version,constraint)).sort((a,b)=>Bun.semver.order(b,a));for(const version of versions){const path=join(root,pkg,`v${version}`,"bin",program);if(fs.exists(path))return{pkg,constraint,version,path}}}return null}export async function loadIosDependencies(projectRoot){const depsPath=join(projectRoot,"config","deps.ts");if(!existsSync(depsPath))return{...DEFAULT_IOS_DEPENDENCIES};const deps=await import(pathToFileURL(depsPath).href);return{...DEFAULT_IOS_DEPENDENCIES,...deps.iosDependencies??{}}}export function pantryInstallArgs(dependencies){return["install","--user","--no-save",...Object.entries(dependencies).map(([pkg,constraint])=>`${pkg}@${constraint}`)]}export function pantryExecutable(projectRoot,env=process.env,exists=existsSync){const home=env.HOME||homedir(),data=env.XDG_DATA_HOME||join(home,".local","share");return[env.PANTRY_BIN,join(projectRoot,"pantry",".bin","pantry"),join(home,".local","bin","pantry"),join(data,"pantry","global","bin","pantry")].find((candidate)=>candidate&&exists(candidate))??"pantry"}export function missingToolMessage(pkg,constraint,program){return`${program} ${constraint} is not installed through Pantry, and the iOS build only runs the version config/deps.ts pins (\`iosDependencies\`, else the framework default). Run \`buddy setup:ios\`, or \`pantry install --user ${pkg}@${constraint}\`, then build again. `+XCODE_NOTE}export async function resolveXcodegen(projectRoot,options={}){const constraint=(await loadIosDependencies(projectRoot))[XCODEGEN_PACKAGE],tool=findPantryProgram(XCODEGEN_PACKAGE,constraint,"xcodegen",pantryPackageRoots(projectRoot,options.env),options.fs);if(!tool)throw new IosToolchainError(missingToolMessage(XCODEGEN_PACKAGE,constraint,"xcodegen"));const presets=xcodegenPresets(tool);if(!(options.fs??realFilesystem).exists(presets))throw new IosToolchainError(`xcodegen ${tool.version} at ${tool.path} has no setting presets (${presets}), so the project it generates would lose its base build settings. Reinstall it: \`pantry install --user --force ${XCODEGEN_PACKAGE}@${tool.version}\` (or \`buddy setup:ios\` after removing ${dirname(dirname(tool.path))}).`);return tool}export function xcodegenPresets(tool){return join(dirname(dirname(tool.path)),"share","xcodegen","SettingPresets","base.yml")}export function generateXcodeProject(xcodegen,output){const result=Bun.spawnSync([xcodegen.path,"generate","--quiet"],{cwd:output,stdout:"pipe",stderr:"pipe"});if(result.exitCode!==0){const detail=`${result.stderr.toString()}${result.stdout.toString()}`.trim();throw new IosToolchainError(`xcodegen ${xcodegen.version} (${xcodegen.path}) could not generate the Xcode project in ${output}${detail?`:
+${detail}`:""}`)}}export function xcodeDeveloperDir(){try{const result=Bun.spawnSync(["xcode-select","--print-path"],{stdout:"pipe",stderr:"ignore"}),path=result.stdout.toString().trim();return result.exitCode===0&&path&&!path.includes("CommandLineTools")?path:null}catch{return null}}

package/dist/build/ios.js

@@ -1,3 +1,3 @@
-import{existsSync,readFileSync,writeFileSync}from"node:fs";import{pathToFileURL}from"node:url";import process from"node:process";import{log}from"@stacksjs/cli";import{projectPath,storagePath}from"@stacksjs/path";import{craftBuilderSpecifier,craftBuilderVersion}from"./craft-entry";import{resolveCraftBuilderProvenance}from"./craft-provenance";import{assertCraftSupportsCapabilities,portablePaths,resolveMobilePath,toCraftIosConfig,validateIosMobileConfig,writeIosActivityTypes}from"./ios-config";import{compileNativeScreens}from"./native-screens";import{writeIosShellSupport}from"./ios-shell";process.exitCode=1;function craftIosEntry(){const explicit=process.env.CRAFT_IOS_SRC;return explicit?pathToFileURL(explicit).href:craftBuilderSpecifier("ios",projectPath())}async function loadCraftIosBuilder(){try{return await import(craftIosEntry())}catch(error){throw Error("Craft iOS builder is unavailable. Install the current craft-native package or set CRAFT_IOS_SRC to packages/ios/src/index.ts in a Craft checkout.",{cause:error})}}const configPath=projectPath("config/mobile.ts");if(!existsSync(configPath))throw Error("Missing config/mobile.ts. Add an ios section before running `buddy build:ios`.");const configModule=await import(`${pathToFileURL(configPath).href}?t=${Date.now()}`),mobile=configModule.default,config=mobile.ios;validateIosMobileConfig(config);if(config.swipeNavigation===!0&&config.swipeBack!=="webview")log.warn("ios.swipeNavigation turns on WebKit's edge swipe alongside the stx router's own. Remove it, or set ios.swipeBack: 'webview' for an app not on the router.");const output=resolveMobilePath(projectPath(),config.output)??storagePath("framework/mobile/ios"),webAssets=resolveMobilePath(projectPath(),config.webAssets),fallbackWebAssets=resolveMobilePath(projectPath(),config.fallbackWebAssets),craftConfig=toCraftIosConfig(config);craftConfig.appIconPath=resolveMobilePath(projectPath(),config.appIcon);craftConfig.splashImagePath=resolveMobilePath(projectPath(),config.splash?.image);craftConfig.splashImagePathDark=resolveMobilePath(projectPath(),config.splash?.imageDark);const nativeBundle=await compileNativeScreens(config,projectPath(),output);if(nativeBundle){craftConfig.nativeBundle=nativeBundle.outFile;for(const diagnostic of nativeBundle.diagnostics??[])log.warn(`${diagnostic.file?`${diagnostic.file}: `:""}${diagnostic.message}`);log.info(`Compiled ${Object.keys(config.nativeScreens??{}).length} native screen path(s) into ${nativeBundle.outFile}`)}const builder=await loadCraftIosBuilder(),craftVersion=craftBuilderVersion(craftIosEntry(),projectPath());if(craftVersion)assertCraftSupportsCapabilities(config.capabilities,craftVersion.version,craftVersion.manifest);else log.warn(`Could not read the craft-native version behind ${craftIosEntry()}, so the build cannot check that it supports every capability config/mobile.ts turns on.`);await builder.init({name:config.appName,bundleId:config.bundleId,teamId:config.teamId,output,config:craftConfig});const native=config.renderer==="native";if(native&&!nativeBundle)throw Error("ios.renderer 'native' needs native screens to draw: list them in ios.nativeScreens");await builder.build(native?{output,nativeBundlePath:nativeBundle.outFile,generateProject:process.env.STACKS_IOS_SKIP_XCODEGEN!=="1"}:{output,htmlPath:webAssets??fallbackWebAssets,devServer:craftConfig.devServerURL,generateProject:process.env.STACKS_IOS_SKIP_XCODEGEN!=="1"});writeIosShellSupport(output,config);const activityTypes=writeIosActivityTypes(output,mobile);if(activityTypes)log.info(`Declared ${activityTypes.length} activity types, so a tapped Spotlight or Siri entry reaches the app`);const sourceRevision=Bun.spawnSync(["git","rev-parse","HEAD"],{cwd:projectPath()}).stdout.toString().trim(),craftConfigPath=`${output}/craft.config.json`,generatedConfig=portablePaths(JSON.parse(readFileSync(craftConfigPath,"utf8")),output,projectPath());writeFileSync(craftConfigPath,`${JSON.stringify(generatedConfig,null,2)}
+import{existsSync,readFileSync,writeFileSync}from"node:fs";import{pathToFileURL}from"node:url";import process from"node:process";import{log}from"@stacksjs/cli";import{projectPath,storagePath}from"@stacksjs/path";import{craftBuilderSpecifier,craftBuilderVersion}from"./craft-entry";import{resolveCraftBuilderProvenance}from"./craft-provenance";import{assertCraftSupportsCapabilities,portablePaths,resolveMobilePath,toCraftIosConfig,validateIosMobileConfig,writeIosActivityTypes}from"./ios-config";import{generateXcodeProject,resolveXcodegen}from"./ios-toolchain";import{compileNativeScreens}from"./native-screens";import{writeIosShellSupport}from"./ios-shell";process.exitCode=1;function craftIosEntry(){const explicit=process.env.CRAFT_IOS_SRC;return explicit?pathToFileURL(explicit).href:craftBuilderSpecifier("ios",projectPath())}async function loadCraftIosBuilder(){try{return await import(craftIosEntry())}catch(error){throw Error("Craft iOS builder is unavailable. Install the current craft-native package or set CRAFT_IOS_SRC to packages/ios/src/index.ts in a Craft checkout.",{cause:error})}}const configPath=projectPath("config/mobile.ts");if(!existsSync(configPath))throw Error("Missing config/mobile.ts. Add an ios section before running `buddy build:ios`.");const configModule=await import(`${pathToFileURL(configPath).href}?t=${Date.now()}`),mobile=configModule.default,config=mobile.ios;validateIosMobileConfig(config);if(config.swipeNavigation===!0&&config.swipeBack!=="webview")log.warn("ios.swipeNavigation turns on WebKit's edge swipe alongside the stx router's own. Remove it, or set ios.swipeBack: 'webview' for an app not on the router.");const output=resolveMobilePath(projectPath(),config.output)??storagePath("framework/mobile/ios"),generateProject=process.env.STACKS_IOS_SKIP_XCODEGEN!=="1",xcodegen=generateProject?await resolveXcodegen(projectPath()):null,webAssets=resolveMobilePath(projectPath(),config.webAssets),fallbackWebAssets=resolveMobilePath(projectPath(),config.fallbackWebAssets),craftConfig=toCraftIosConfig(config);craftConfig.appIconPath=resolveMobilePath(projectPath(),config.appIcon);craftConfig.splashImagePath=resolveMobilePath(projectPath(),config.splash?.image);craftConfig.splashImagePathDark=resolveMobilePath(projectPath(),config.splash?.imageDark);const nativeBundle=await compileNativeScreens(config,projectPath(),output);if(nativeBundle){craftConfig.nativeBundle=nativeBundle.outFile;for(const diagnostic of nativeBundle.diagnostics??[])log.warn(`${diagnostic.file?`${diagnostic.file}: `:""}${diagnostic.message}`);log.info(`Compiled ${Object.keys(config.nativeScreens??{}).length} native screen path(s) into ${nativeBundle.outFile}`)}const builder=await loadCraftIosBuilder(),craftVersion=craftBuilderVersion(craftIosEntry(),projectPath());if(craftVersion)assertCraftSupportsCapabilities(config.capabilities,craftVersion.version,craftVersion.manifest);else log.warn(`Could not read the craft-native version behind ${craftIosEntry()}, so the build cannot check that it supports every capability config/mobile.ts turns on.`);await builder.init({name:config.appName,bundleId:config.bundleId,teamId:config.teamId,output,config:craftConfig});const native=config.renderer==="native";if(native&&!nativeBundle)throw Error("ios.renderer 'native' needs native screens to draw: list them in ios.nativeScreens");await builder.build(native?{output,nativeBundlePath:nativeBundle.outFile,generateProject:!1}:{output,htmlPath:webAssets??fallbackWebAssets,devServer:craftConfig.devServerURL,generateProject:!1});if(xcodegen){generateXcodeProject(xcodegen,output);log.info(`Generated the Xcode project with xcodegen ${xcodegen.version} from Pantry`)}writeIosShellSupport(output,config);const activityTypes=writeIosActivityTypes(output,mobile);if(activityTypes)log.info(`Declared ${activityTypes.length} activity types, so a tapped Spotlight or Siri entry reaches the app`);const sourceRevision=Bun.spawnSync(["git","rev-parse","HEAD"],{cwd:projectPath()}).stdout.toString().trim(),craftConfigPath=`${output}/craft.config.json`,generatedConfig=portablePaths(JSON.parse(readFileSync(craftConfigPath,"utf8")),output,projectPath());writeFileSync(craftConfigPath,`${JSON.stringify(generatedConfig,null,2)}
 `);writeFileSync(`${output}/stacks-mobile.json`,`${JSON.stringify(portablePaths({schemaVersion:"1.0.0",platform:"ios",sourceRevision,source:native?{kind:"native",site:craftConfig.devServerURL}:webAssets?{kind:"bundled",path:webAssets}:{kind:"remote",url:craftConfig.devServerURL,fallback:fallbackWebAssets?{kind:"bundled",path:fallbackWebAssets}:void 0},capabilities:config.capabilities??{},builder:resolveCraftBuilderProvenance(process.env.CRAFT_IOS_SRC),craft:generatedConfig},output,projectPath()),null,2)}
 `);log.success(`Built the Craft iOS project in ${output}`);await log.flush();process.exitCode=0;

package/dist/bump.js

@@ -1,4 +1,4 @@
-import{execSync,log,parseOptions}from"@stacksjs/cli";import{path as p}from"@stacksjs/path";import{incrementVersion,isReleaseType,isValidVersion,versionBump}from"@stacksjs/bumpx";import{isCalendarBump,nextCalendarVersion}from"./calendar-version";import{pantryLockViolations}from"./pantry-lock";import{generateChangelog,loadLogsmithConfig}from"@stacksjs/logsmith";import{existsSync,readdirSync,readFileSync,unlinkSync,writeFileSync}from"node:fs";import{join,relative}from"node:path";const options=parseOptions(),rawBump=options?.bump?.toString(),bumpArg=rawBump?isReleaseType(rawBump)||isCalendarBump(rawBump)||isValidVersion(rawBump)?rawBump:null:null;if(rawBump&&!bumpArg)throw Error(`Invalid --bump "${rawBump}"; expected a Bumpx release type, calendar, or semantic version`);const isDryRun=options?.dryRun===!0,isVerbose=options?.verbose===!0;async function readPackage(file){if(!existsSync(file))return;return await Bun.file(file).json()}const rootManifest=p.projectPath("package.json"),rootPkg=await readPackage(rootManifest),isFrameworkRelease=rootPkg?.name==="stacks"&&existsSync(p.frameworkPath("core/package.json")),bumpCwd=isFrameworkRelease?p.frameworkPath("core"):p.projectPath(),primaryManifest=isFrameworkRelease?p.frameworkPath("core/package.json"):rootManifest;async function resolveBumpArg(bump){if(!bump)return bump;if(isCalendarBump(bump)){const pkg=await readPackage(primaryManifest);return nextCalendarVersion(pkg?.version)}const pkg=await readPackage(primaryManifest);if(!pkg?.version)throw Error(`${primaryManifest} declares no version`);return incrementVersion(pkg.version,bump,options?.preid)}const resolvedBumpArg=await resolveBumpArg(bumpArg);async function git(args,cwd=p.projectPath(),options={}){return await execSync(["git",...args],{cwd,stdin:"inherit",stderr:"pipe",throwOnError:options.throwOnError??!0})}async function isGitIgnored(file){return(await git(["check-ignore","--",file],p.projectPath(),{throwOnError:!1})).trim().length>0}async function readVersion(file){const pkg=await readPackage(file);if(!pkg?.version||!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(pkg.version))throw Error(`Invalid version in ${file}: ${pkg?.version??"<missing>"}`);return pkg.version}function lockfileVersion(contents){const match=contents.match(/"lockfileVersion"\s*:\s*(\d+)/);return match?Number(match[1]):null}async function packageFilesFor(pattern,cwd){const glob=new Bun.Glob(pattern),files=[];for await(const file of glob.scan({cwd,absolute:!0,onlyFiles:!0})){if(file.includes("/node_modules/")||file.includes("/dist/")||file.includes("/pantry/"))continue;files.push(`./${relative(bumpCwd,file)}`)}return files}async function existingPackageFiles(files){const existing=[];for(const file of files){const absolutePath=join(bumpCwd,file);if(await Bun.file(absolutePath).exists())existing.push(file)}return existing}async function frameworkBumpFiles(){return Array.from(new Set([...await packageFilesFor("package.json",bumpCwd),...await packageFilesFor("*/package.json",bumpCwd),...await packageFilesFor("*/*/package.json",bumpCwd),...await existingPackageFiles(["../package.json","../defaults/ide/vscode/package.json","../api/package.json","../cloud/package.json","../docs/package.json","../orm/package.json","../server/package.json"]),...await packageFilesFor("../libs/**/package.json",bumpCwd)]))}const bumpFiles=isFrameworkRelease?await frameworkBumpFiles():["./package.json"];log.debug(`Release mode: ${isFrameworkRelease?"framework monorepo":"consumer app"} (${rootPkg?.name??"unknown"})`);log.debug(`Bumping ${bumpFiles.length} package manifest(s) in ${bumpCwd}`);await versionBump({release:resolvedBumpArg??void 0,preid:options?.preid,files:bumpFiles,cwd:bumpCwd,recursive:!1,commit:!1,tag:!1,push:!1,changelog:!1,noGitCheck:!0,dryRun:isDryRun,yes:Boolean(resolvedBumpArg),verbose:isVerbose});const nextVersion=isDryRun&&resolvedBumpArg&&isValidVersion(resolvedBumpArg)?resolvedBumpArg:await readVersion(primaryManifest),latestTag=(await git(["describe","--abbrev=0","--tags"],p.projectPath(),{throwOnError:!1}).catch(()=>"")).trim();async function writeChangelog(){const config=await loadLogsmithConfig({dir:p.projectPath(),from:latestTag||void 0,to:"HEAD",output:isDryRun?!1:"CHANGELOG.md",theme:"github",verbose:isVerbose}),result=await generateChangelog(config);if(isDryRun){log.info(result.content);return}const changelogPath=p.projectPath("CHANGELOG.md");if(!existsSync(changelogPath))return;let content=readFileSync(changelogPath,"utf-8");const versionSeen=new RegExp(`\\bv?${nextVersion.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}\\b`);if(/\/compare\/[^)\s]+\.\.\.HEAD\)/.test(content))content=content.replace(/(\/compare\/[^)\s]+\.\.\.)HEAD(\))/,`$1v${nextVersion}$2`);else if(!versionSeen.test(content.split(`
+import{execSync,log,parseOptions}from"@stacksjs/cli";import{path as p}from"@stacksjs/path";import{incrementVersion,isReleaseType,isValidVersion,versionBump}from"@stacksjs/bumpx";import{isCalendarBump,nextCalendarVersion}from"./calendar-version";import{describeGitHubRelease,publishGitHubRelease}from"./github-release";import{pantryLockViolations}from"./pantry-lock";import{generateChangelog,loadLogsmithConfig}from"@stacksjs/logsmith";import{existsSync,readdirSync,readFileSync,unlinkSync,writeFileSync}from"node:fs";import{join,relative}from"node:path";const options=parseOptions(),rawBump=options?.bump?.toString(),bumpArg=rawBump?isReleaseType(rawBump)||isCalendarBump(rawBump)||isValidVersion(rawBump)?rawBump:null:null;if(rawBump&&!bumpArg)throw Error(`Invalid --bump "${rawBump}"; expected a Bumpx release type, calendar, or semantic version`);const isDryRun=options?.dryRun===!0,isVerbose=options?.verbose===!0;async function readPackage(file){if(!existsSync(file))return;return await Bun.file(file).json()}const rootManifest=p.projectPath("package.json"),rootPkg=await readPackage(rootManifest),isFrameworkRelease=rootPkg?.name==="stacks"&&existsSync(p.frameworkPath("core/package.json")),bumpCwd=isFrameworkRelease?p.frameworkPath("core"):p.projectPath(),primaryManifest=isFrameworkRelease?p.frameworkPath("core/package.json"):rootManifest;async function resolveBumpArg(bump){if(!bump)return bump;if(isCalendarBump(bump)){const pkg=await readPackage(primaryManifest);return nextCalendarVersion(pkg?.version)}const pkg=await readPackage(primaryManifest);if(!pkg?.version)throw Error(`${primaryManifest} declares no version`);return incrementVersion(pkg.version,bump,options?.preid)}const resolvedBumpArg=await resolveBumpArg(bumpArg);async function git(args,cwd=p.projectPath(),options={}){return await execSync(["git",...args],{cwd,stdin:"inherit",stderr:"pipe",throwOnError:options.throwOnError??!0})}async function isGitIgnored(file){return(await git(["check-ignore","--",file],p.projectPath(),{throwOnError:!1})).trim().length>0}async function readVersion(file){const pkg=await readPackage(file);if(!pkg?.version||!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(pkg.version))throw Error(`Invalid version in ${file}: ${pkg?.version??"<missing>"}`);return pkg.version}function lockfileVersion(contents){const match=contents.match(/"lockfileVersion"\s*:\s*(\d+)/);return match?Number(match[1]):null}async function packageFilesFor(pattern,cwd){const glob=new Bun.Glob(pattern),files=[];for await(const file of glob.scan({cwd,absolute:!0,onlyFiles:!0})){if(file.includes("/node_modules/")||file.includes("/dist/")||file.includes("/pantry/"))continue;files.push(`./${relative(bumpCwd,file)}`)}return files}async function existingPackageFiles(files){const existing=[];for(const file of files){const absolutePath=join(bumpCwd,file);if(await Bun.file(absolutePath).exists())existing.push(file)}return existing}async function frameworkBumpFiles(){return Array.from(new Set([...await packageFilesFor("package.json",bumpCwd),...await packageFilesFor("*/package.json",bumpCwd),...await packageFilesFor("*/*/package.json",bumpCwd),...await existingPackageFiles(["../package.json","../defaults/ide/vscode/package.json","../api/package.json","../cloud/package.json","../docs/package.json","../orm/package.json","../server/package.json"]),...await packageFilesFor("../libs/**/package.json",bumpCwd)]))}const bumpFiles=isFrameworkRelease?await frameworkBumpFiles():["./package.json"];log.debug(`Release mode: ${isFrameworkRelease?"framework monorepo":"consumer app"} (${rootPkg?.name??"unknown"})`);log.debug(`Bumping ${bumpFiles.length} package manifest(s) in ${bumpCwd}`);await versionBump({release:resolvedBumpArg??void 0,preid:options?.preid,files:bumpFiles,cwd:bumpCwd,recursive:!1,commit:!1,tag:!1,push:!1,changelog:!1,noGitCheck:!0,dryRun:isDryRun,yes:Boolean(resolvedBumpArg),verbose:isVerbose});const nextVersion=isDryRun&&resolvedBumpArg&&isValidVersion(resolvedBumpArg)?resolvedBumpArg:await readVersion(primaryManifest),latestTag=(await git(["describe","--abbrev=0","--tags"],p.projectPath(),{throwOnError:!1}).catch(()=>"")).trim();async function writeChangelog(){const config=await loadLogsmithConfig({dir:p.projectPath(),from:latestTag||void 0,to:"HEAD",output:isDryRun?!1:"CHANGELOG.md",theme:"github",verbose:isVerbose}),result=await generateChangelog(config);if(isDryRun){log.info(result.content);return}const changelogPath=p.projectPath("CHANGELOG.md");if(!existsSync(changelogPath))return;let content=readFileSync(changelogPath,"utf-8");const versionSeen=new RegExp(`\\bv?${nextVersion.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}\\b`);if(/\/compare\/[^)\s]+\.\.\.HEAD\)/.test(content))content=content.replace(/(\/compare\/[^)\s]+\.\.\.)HEAD(\))/,`$1v${nextVersion}$2`);else if(!versionSeen.test(content.split(`
 `).slice(0,4).join(`
 `)))content=content.replace(/^(#\s.*\n+)?/,(match)=>`${match??""}## v${nextVersion}
 
@@ -9,4 +9,6 @@ import{execSync,log,parseOptions}from"@stacksjs/cli";import{path as p}from"@stac
 `).map((line)=>line.trimEnd()).filter((line)=>line&&!line.startsWith("A ")&&!line.startsWith("M "));if(leftover.length)log.warn(`Kept ${leftover.length} change(s) out of the release commit:
   ${leftover.slice(0,20).join(`
   `)}${leftover.length>20?`
-  \u2026 and ${leftover.length-20} more`:""}`)}if(!isDryRun){await stageReleaseArtifacts();await git(["commit","-m",`chore: release v${nextVersion}`]);await git(["tag",`v${nextVersion}`]);const branch=(await git(["symbolic-ref","--short","HEAD"])).trim();await git(["push","--atomic","origin",`HEAD:refs/heads/${branch}`,`refs/tags/v${nextVersion}`])}
+  \u2026 and ${leftover.length-20} more`:""}`)}if(!isDryRun){await stageReleaseArtifacts();await git(["commit","-m",`chore: release v${nextVersion}`]);await git(["tag",`v${nextVersion}`]);const branch=(await git(["symbolic-ref","--short","HEAD"])).trim();await git(["push","--atomic","origin",`HEAD:refs/heads/${branch}`,`refs/tags/v${nextVersion}`])}if(!isFrameworkRelease&&options?.skipGithubRelease!==!0){const tag=`v${nextVersion}`,result=await publishGitHubRelease({cwd:p.projectPath(),tag,ref:isDryRun?"HEAD":void 0,dryRun:isDryRun});if(isDryRun&&result.draft)log.info(`Would create the GitHub release ${tag}:
+
+${result.draft.body}`);else if(result.status==="failed")log.warn(describeGitHubRelease(tag,result));else log.info(describeGitHubRelease(tag,result))}

package/dist/github-release.d.ts

@@ -0,0 +1,65 @@
+/** The GitHub repository a remote URL points at, or null for any other host. */
+export declare function parseGitHubRemote(url: string | undefined): GitHubRepository | null;
+/**
+ * A token that can create releases: the environment's, then the GitHub CLI's,
+ * then the git credential the push itself used.
+ */
+export declare function resolveGitHubToken(env?: Record<string, string | undefined>, run?: RunCommand): string | null;
+/** The body cut to GitHub's limit, pointing at the full comparison when cut. */
+export declare function fitReleaseBody(body: string, compareUrl?: string): string;
+/**
+ * Create the release for `draft.tag`, unless that tag already has one.
+ * Throws on an API error; {@link publishGitHubRelease} turns that into a warning.
+ */
+export declare function createGitHubRelease(repository: GitHubRepository, draft: GitHubReleaseDraft, options: CreateGitHubReleaseOptions): Promise<{ url: string, created: boolean }>;
+/** The tag before `tag` in its history, or undefined for the first release. */
+export declare function previousTag(cwd: string, tag: string): string | undefined;
+/** The newest tag at or before `ref`, or undefined when there is none. */
+export declare function latestTag(cwd: string, ref?: string): string | undefined;
+/** The GitHub repository `origin` points at, or null. */
+export declare function originRepository(cwd: string): GitHubRepository | null;
+/** The commits between the previous tag and `tag`, as logsmith renders them. */
+export declare function releaseNotes(options: { cwd: string, tag: string, from?: string, repository: GitHubRepository }): Promise<string>;
+/**
+ * Create the GitHub release for a pushed tag, with the changes since the tag
+ * before it. Never throws: the result says what happened and why.
+ */
+export declare function publishGitHubRelease(options: PublishGitHubReleaseOptions): Promise<GitHubReleaseResult & { draft?: GitHubReleaseDraft }>;
+/** One line for the release log, with the retry command when it failed. */
+export declare function describeGitHubRelease(tag: string, result: GitHubReleaseResult): string;
+export declare const GITHUB_API_URL: 'https://api.github.com';
+/** GitHub's limit on a release body is 125,000 characters; stay clear of it. */
+export declare const MAX_RELEASE_BODY: unknown;
+export declare interface GitHubRepository {
+  owner: string
+  repo: string
+}
+export declare interface GitHubReleaseDraft {
+  tag: string
+  name: string
+  body: string
+  prerelease?: boolean
+}
+export declare interface GitHubReleaseResult {
+  status: 'created' | 'exists' | 'skipped' | 'failed'
+  url?: string
+  reason?: string
+}
+export declare interface CreateGitHubReleaseOptions {
+  token: string
+  apiUrl?: string
+  fetch?: typeof globalThis.fetch
+}
+export declare interface PublishGitHubReleaseOptions {
+  cwd: string
+  tag: string
+  name?: string
+  summary?: string
+  prerelease?: boolean
+  ref?: string
+  dryRun?: boolean
+  env?: Record<string, string | undefined>
+  fetch?: typeof globalThis.fetch
+  run?: RunCommand
+}
+declare type RunCommand = (cmd: string[], input?: string) => { exitCode: number, stdout: string }

package/dist/github-release.js

@@ -0,0 +1,11 @@
+import process from"node:process";export const GITHUB_API_URL="https://api.github.com",MAX_RELEASE_BODY=120000;function runCommand(cmd,input){try{const result=Bun.spawnSync(cmd,{stdin:input===void 0?"ignore":Buffer.from(input),stdout:"pipe",stderr:"ignore",env:{...process.env,GIT_TERMINAL_PROMPT:"0",GH_PROMPT_DISABLED:"1"}});return{exitCode:result.exitCode??1,stdout:result.stdout?.toString()??""}}catch{return{exitCode:127,stdout:""}}}export function parseGitHubRemote(url){const match=url?.trim().match(/^(?:https?:\/\/(?:[^@/]+@)?github\.com\/|(?:ssh:\/\/)?git@github\.com[:/])([\w.-]+)\/([\w.-]+?)(?:\.git)?\/?$/);if(!match)return null;return{owner:match[1],repo:match[2]}}export function resolveGitHubToken(env=process.env,run=runCommand){for(const key of["GITHUB_TOKEN","GH_TOKEN"]){const value=env[key]?.trim();if(value)return value}const gh=run(["gh","auth","token","--hostname","github.com"]);if(gh.exitCode===0&&gh.stdout.trim())return gh.stdout.trim();const credential=run(["git","credential","fill"],`protocol=https
+host=github.com
+
+`);if(credential.exitCode===0){const password=credential.stdout.split(`
+`).find((line)=>line.startsWith("password="))?.slice(9).trim();if(password)return password}return null}export function fitReleaseBody(body,compareUrl){if(body.length<=MAX_RELEASE_BODY)return body;const note=`
+
+\u2026the notes were longer than GitHub allows${compareUrl?`; see [every change](${compareUrl})`:""}.
+`,cut=body.slice(0,MAX_RELEASE_BODY-note.length);return`${cut.slice(0,Math.max(0,cut.lastIndexOf(`
+`)))}${note}`}export async function createGitHubRelease(repository,draft,options){const fetcher=options.fetch??globalThis.fetch,base=`${(options.apiUrl??GITHUB_API_URL).replace(/\/$/,"")}/repos/${repository.owner}/${repository.repo}/releases`,headers={Authorization:`Bearer ${options.token}`,Accept:"application/vnd.github+json","X-GitHub-Api-Version":"2022-11-28"},existing=await fetcher(`${base}/tags/${encodeURIComponent(draft.tag)}`,{headers});if(existing.ok)return{url:(await existing.json()).html_url,created:!1};if(existing.status!==404)throw Error(`GitHub API ${existing.status} looking up the release for ${draft.tag}: ${await apiMessage(existing)}`);const response=await fetcher(base,{method:"POST",headers:{...headers,"Content-Type":"application/json"},body:JSON.stringify({tag_name:draft.tag,name:draft.name,body:draft.body,draft:!1,prerelease:draft.prerelease??!1})});if(!response.ok)throw Error(`GitHub API ${response.status} creating the release for ${draft.tag}: ${await apiMessage(response)}`);return{url:(await response.json()).html_url,created:!0}}async function apiMessage(response){const text=await response.text().catch(()=>"");try{return JSON.parse(text).message||text||response.statusText}catch{return text||response.statusText}}function git(cwd,args){const result=Bun.spawnSync(["git",...args],{cwd,stdout:"pipe",stderr:"ignore"});return result.exitCode===0?result.stdout.toString().trim():null}export function previousTag(cwd,tag){return git(cwd,["describe","--tags","--abbrev=0",`${tag}^`])||void 0}export function latestTag(cwd,ref="HEAD"){return git(cwd,["describe","--tags","--abbrev=0",ref])||void 0}export function originRepository(cwd){return parseGitHubRemote(git(cwd,["remote","get-url","origin"])??void 0)}export async function releaseNotes(options){const{generateChangelog,loadLogsmithConfig}=await import("@stacksjs/logsmith"),repoUrl=`https://github.com/${options.repository.owner}/${options.repository.repo}`,config=await loadLogsmithConfig({dir:options.cwd,from:options.from,to:options.tag,output:!1,theme:"github",repo:repoUrl,hideAuthorEmail:!0});return(await generateChangelog(config)).content.trim()||`No changes since ${options.from??"the start of the history"}.`}export async function publishGitHubRelease(options){const repository=originRepository(options.cwd);if(!repository)return{status:"skipped",reason:"origin is not a GitHub repository"};try{const from=options.ref?latestTag(options.cwd,options.ref):previousTag(options.cwd,options.tag),notes=await releaseNotes({cwd:options.cwd,tag:options.ref??options.tag,from,repository}),compareUrl=from?`https://github.com/${repository.owner}/${repository.repo}/compare/${from}...${options.tag}`:void 0,draft={tag:options.tag,name:options.name??options.tag,body:fitReleaseBody(options.summary?`${options.summary.trim()}
+
+${notes}`:notes,compareUrl),prerelease:options.prerelease};if(options.dryRun)return{status:"skipped",reason:"dry run",draft};const token=resolveGitHubToken(options.env,options.run);if(!token)return{status:"failed",reason:"no GitHub token (set GITHUB_TOKEN, or sign in with `gh auth login`)",draft};const release=await createGitHubRelease(repository,draft,{token,fetch:options.fetch});return{status:release.created?"created":"exists",url:release.url,draft}}catch(error){return{status:"failed",reason:error instanceof Error?error.message:String(error)}}}export function describeGitHubRelease(tag,result){switch(result.status){case"created":return`Created the GitHub release ${result.url}`;case"exists":return`${tag} already has a GitHub release: ${result.url}`;case"skipped":return`No GitHub release for ${tag}: ${result.reason}`;case"failed":return`Could not create the GitHub release for ${tag} (${result.reason}). The tag is pushed; run \`buddy release:github ${tag}\` to finish it.`}}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export type { GitHubReleaseResult, PublishGitHubReleaseOptions } from './github-release';
+export type { PantryTool } from './build/ios-toolchain';
 export type { StxLintConfig, StxLintReport, StxLintResult } from './lint/stx-gate';
 export type { RouteActionReference } from './upgrade/route-actions';
 export type { ProjectStructureChange } from './upgrade/package-project';
@@ -31,6 +33,10 @@ export * from './library/index';
 // spawning a deep dist path. Exported from ./lint/lint — the pure module — so
 // importing the barrel never pulls the process-exiting ./lint/index script.
 export { formatProject, lintFix, lintProject } from './lint/lint';
+// Release helpers the release commands call in-process: the GitHub release a
+// pushed tag gets, and the Pantry-managed tools behind `build:ios`.
+export { describeGitHubRelease, parseGitHubRemote, publishGitHubRelease } from './github-release';
+export { DEFAULT_IOS_DEPENDENCIES, IosToolchainError, loadIosDependencies, pantryExecutable, pantryInstallArgs, resolveXcodegen, XCODE_NOTE, xcodeDeveloperDir } from './build/ios-toolchain';
 // stx conformance checks behind `buddy lint --stx`. Pure - returns a report
 // and never exits, so the command owns rendering and the exit code.
 export { DEFAULT_STX_LINT_CONFIG, loadStxLintConfig, runStxLint } from './lint/stx-gate';

package/dist/index.js

@@ -1 +1 @@
-import{setActionRunner}from"@stacksjs/action-runner";import{runAction}from"./helpers";setActionRunner((action,options)=>runAction(action,options));export*from"./action";export{add as runAdd}from"./add";export{BlogAdminError,deleteBlogPost,getBlogPost,listBlogPosts,saveBlogPost,slugify as blogSlugify}from"./blog-admin";export{commit as runCommit}from"./commit";export*from"./dev";export*from"./generate";export*from"./helpers";export*from"./library";export{formatProject,lintFix,lintProject}from"./lint/lint";export{DEFAULT_STX_LINT_CONFIG,loadStxLintConfig,runStxLint}from"./lint/stx-gate";export{measureDefaultsDrift,summarizeStructureChanges}from"./upgrade/package-project";export{describeDanglingRouteActions,findDanglingRouteActions}from"./upgrade/route-actions";export*from"./setup";export{createComponent,createDatabase,createFactory,createFunction,createLanguage,createMiddleware,createMigration,createModel,createMail,createNotification,createPage,isDryRunActive,makeAction,makeCertificate,makeComponent,makeDatabase,makeFunction,makeLanguage,makeMail,makeNotification,makePage,makeQueueTable,makeStack,make as runMake,setDryRun}from"./make";export{discoverPackages,ensureDiscoveredPackages}from"./discover-packages";export{parseFields,scaffoldCrud}from"./scaffold-crud";export{installStack,uninstallStack,listStacks}from"./stacks";export{makeJob}from"./make-job";export{makeCommand}from"./make-command";export{makePolicy}from"./make-policy";export{makeResource}from"./make-resource";
+import{setActionRunner}from"@stacksjs/action-runner";import{runAction}from"./helpers";setActionRunner((action,options)=>runAction(action,options));export*from"./action";export{add as runAdd}from"./add";export{BlogAdminError,deleteBlogPost,getBlogPost,listBlogPosts,saveBlogPost,slugify as blogSlugify}from"./blog-admin";export{commit as runCommit}from"./commit";export*from"./dev";export*from"./generate";export*from"./helpers";export*from"./library";export{formatProject,lintFix,lintProject}from"./lint/lint";export{describeGitHubRelease,parseGitHubRemote,publishGitHubRelease}from"./github-release";export{DEFAULT_IOS_DEPENDENCIES,IosToolchainError,loadIosDependencies,pantryExecutable,pantryInstallArgs,resolveXcodegen,XCODE_NOTE,xcodeDeveloperDir}from"./build/ios-toolchain";export{DEFAULT_STX_LINT_CONFIG,loadStxLintConfig,runStxLint}from"./lint/stx-gate";export{measureDefaultsDrift,summarizeStructureChanges}from"./upgrade/package-project";export{describeDanglingRouteActions,findDanglingRouteActions}from"./upgrade/route-actions";export*from"./setup";export{createComponent,createDatabase,createFactory,createFunction,createLanguage,createMiddleware,createMigration,createModel,createMail,createNotification,createPage,isDryRunActive,makeAction,makeCertificate,makeComponent,makeDatabase,makeFunction,makeLanguage,makeMail,makeNotification,makePage,makeQueueTable,makeStack,make as runMake,setDryRun}from"./make";export{discoverPackages,ensureDiscoveredPackages}from"./discover-packages";export{parseFields,scaffoldCrud}from"./scaffold-crud";export{installStack,uninstallStack,listStacks}from"./stacks";export{makeJob}from"./make-job";export{makeCommand}from"./make-command";export{makePolicy}from"./make-policy";export{makeResource}from"./make-resource";

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/actions",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.174",
+  "version": "0.75.176",
   "description": "The Stacks actions.",
   "author": "Chris Breuer",
   "contributors": [
@@ -66,53 +66,53 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/action-runner": "0.75.174",
-    "@stacksjs/ai": "0.75.174",
-    "@stacksjs/analytics": "0.75.174",
-    "@stacksjs/api": "0.75.174",
-    "@stacksjs/auth": "0.75.174",
-    "@stacksjs/build": "0.75.174",
+    "@stacksjs/action-runner": "0.75.176",
+    "@stacksjs/ai": "0.75.176",
+    "@stacksjs/analytics": "0.75.176",
+    "@stacksjs/api": "0.75.176",
+    "@stacksjs/auth": "0.75.176",
+    "@stacksjs/build": "0.75.176",
     "@stacksjs/bumpx": "^0.2.21",
     "@stacksjs/bunpress": "^0.2.15",
-    "@stacksjs/cli": "0.75.174",
-    "@stacksjs/cloud": "0.75.174",
-    "@stacksjs/cms": "0.75.174",
+    "@stacksjs/cli": "0.75.176",
+    "@stacksjs/cloud": "0.75.176",
+    "@stacksjs/cms": "0.75.176",
     "@stacksjs/components": "^0.2.483",
-    "@stacksjs/config": "0.75.174",
-    "@stacksjs/database": "0.75.174",
-    "@stacksjs/desktop-build": "0.75.174",
-    "@stacksjs/dns": "0.75.174",
-    "@stacksjs/enums": "0.75.174",
-    "@stacksjs/env": "0.75.174",
-    "@stacksjs/error-handling": "0.75.174",
+    "@stacksjs/config": "0.75.176",
+    "@stacksjs/database": "0.75.176",
+    "@stacksjs/desktop-build": "0.75.176",
+    "@stacksjs/dns": "0.75.176",
+    "@stacksjs/enums": "0.75.176",
+    "@stacksjs/env": "0.75.176",
+    "@stacksjs/error-handling": "0.75.176",
     "@stacksjs/gitit": "^0.2.5",
-    "@stacksjs/i18n": "0.75.174",
-    "@stacksjs/image": "0.75.174",
-    "@stacksjs/logging": "0.75.174",
+    "@stacksjs/i18n": "0.75.176",
+    "@stacksjs/image": "0.75.176",
+    "@stacksjs/logging": "0.75.176",
     "@stacksjs/logsmith": "^0.2.11",
-    "@stacksjs/mobile": "0.75.174",
-    "@stacksjs/orm": "0.75.174",
-    "@stacksjs/path": "0.75.174",
-    "@stacksjs/payments": "0.75.174",
-    "@stacksjs/queue": "0.75.174",
-    "@stacksjs/registry": "0.75.174",
-    "@stacksjs/router": "0.75.174",
+    "@stacksjs/mobile": "0.75.176",
+    "@stacksjs/orm": "0.75.176",
+    "@stacksjs/path": "0.75.176",
+    "@stacksjs/payments": "0.75.176",
+    "@stacksjs/queue": "0.75.176",
+    "@stacksjs/registry": "0.75.176",
+    "@stacksjs/router": "0.75.176",
     "@stacksjs/rpx": "^0.11.54",
-    "@stacksjs/scheduler": "0.75.174",
-    "@stacksjs/search-engine": "0.75.174",
-    "@stacksjs/security": "0.75.174",
-    "@stacksjs/server": "0.75.174",
-    "@stacksjs/sites": "0.75.174",
-    "@stacksjs/storage": "0.75.174",
-    "@stacksjs/strings": "0.75.174",
+    "@stacksjs/scheduler": "0.75.176",
+    "@stacksjs/search-engine": "0.75.176",
+    "@stacksjs/security": "0.75.176",
+    "@stacksjs/server": "0.75.176",
+    "@stacksjs/sites": "0.75.176",
+    "@stacksjs/storage": "0.75.176",
+    "@stacksjs/strings": "0.75.176",
     "@stacksjs/stx": "^0.2.483",
     "@stacksjs/tlsx": "^0.13.19",
     "@stacksjs/ts-cloud": "^0.16.52",
     "@stacksjs/ts-md": "^0.1.1",
-    "@stacksjs/tunnel": "0.75.174",
-    "@stacksjs/types": "0.75.174",
-    "@stacksjs/utils": "0.75.174",
-    "@stacksjs/whois": "0.75.174",
+    "@stacksjs/tunnel": "0.75.176",
+    "@stacksjs/types": "0.75.176",
+    "@stacksjs/utils": "0.75.176",
+    "@stacksjs/whois": "0.75.176",
     "bun-plugin-stx": "^0.2.483"
   },
   "peerDependencies": {
@@ -128,7 +128,7 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.75.174",
+    "@stacksjs/validation": "0.75.176",
     "better-dx": "^0.2.24"
   }
 }