@stacksjs/actions 0.74.5 → 0.74.6

package/dist/discover-packages.d.ts

@@ -1,5 +1,32 @@
 import type { StackDirectory } from '@stacksjs/types';
-export declare function discoverPackages(): Promise<DiscoveredPackagesManifest>;
+export declare function discoverPackages(options?: DiscoverPackagesOptions): Promise<DiscoveredPackagesManifest>;
+/**
+ * Find the installed packages that extend this application.
+ *
+ * Stacks' answer to Laravel's package auto-discovery: a package declares a
+ * `stacks` key in its package.json, and the framework registers what it brings
+ * without the application wiring anything up.
+ *
+ * Two roots are searched, in this order:
+ *
+ *   `node_modules/`  where a package manager puts what an application asked
+ *                    for, so this is the one that matters for `bun add loghq`.
+ *                    Only DIRECT dependencies are considered, read from the
+ *                    application's own package.json. A transitive dependency
+ *                    has no business injecting models or routes into an app
+ *                    that never named it, and walking the whole tree would
+ *                    mean reading thousands of manifests on every boot.
+ *
+ *   `pantry/`        this repository's own package tree, and the root the
+ *                    scan was originally written against. Globbed rather than
+ *                    read from dependencies, because it is a small tree that
+ *                    is not always reflected in a package.json.
+ *
+ * A package found in both is taken from `node_modules`, and its other location
+ * is reported in {@link DiscoveredPackagesManifest.shadowed} rather than
+ * silently dropped: the two copies are frequently different versions, and
+ * which one won is the first thing worth knowing when a package misbehaves.
+ */
 export declare interface PackageStacksMeta {
   providers?: string[]
   routes?: string[]
@@ -11,8 +38,23 @@ export declare interface PackageStacksMeta {
   name?: string
   description?: string
   directories?: StackDirectory[]
+  routePrefix?: string
+  routeMiddleware?: string | string[]
+  root?: string
+}
+/** A package that was found in more than one root. */
+export declare interface ShadowedPackage {
+  name: string
+  used: string
+  ignored: string
 }
 export declare interface DiscoveredPackagesManifest {
   generated_at: string
   packages: Record<string, PackageStacksMeta>
+  shadowed?: ShadowedPackage[]
+}
+export declare interface DiscoverPackagesOptions {
+  projectRoot?: string
+  manifestPath?: string
+  dryRun?: boolean
 }

package/dist/discover-packages.js

@@ -1 +1,2 @@
-import{projectPath,storagePath}from"@stacksjs/path";export async function discoverPackages(){const manifest={generated_at:new Date().toISOString(),packages:{}},dontDiscover=new Set;try{const list=(await Bun.file(projectPath("package.json")).json())?.stacks?.["dont-discover"];if(Array.isArray(list))for(const name of list)dontDiscover.add(name)}catch{}const pantryDir=projectPath("pantry"),patterns=["*/package.json","@*/*/package.json"];for(const pattern of patterns){const glob=new Bun.Glob(pattern);for await(const file of glob.scan({cwd:pantryDir,absolute:!0,onlyFiles:!0}))try{const pkg=await Bun.file(file).json(),name=pkg?.name;if(!name||!pkg.stacks||dontDiscover.has(name))continue;manifest.packages[name]=pkg.stacks}catch{}}const manifestPath=storagePath("framework/discovered-packages.json");try{const current=await Bun.file(manifestPath).json();if(JSON.stringify(current.packages??{})===JSON.stringify(manifest.packages))return current}catch{}await Bun.write(manifestPath,JSON.stringify(manifest,null,2));return manifest}
+import{existsSync}from"node:fs";import{isAbsolute,join,relative}from"node:path";import{projectPath,storagePath}from"@stacksjs/path";async function readManifest(file){try{return await Bun.file(file).json()}catch{return null}}async function directDependencies(projectRoot){const pkg=await readManifest(join(projectRoot,"package.json"));if(!pkg)return[];const names=new Set;for(const field of["dependencies","devDependencies","peerDependencies"]){const block=pkg[field];if(block&&typeof block==="object")for(const name of Object.keys(block))names.add(name)}return[...names].sort()}async function fromNodeModules(projectRoot){const root=join(projectRoot,"node_modules");if(!existsSync(root))return[];const out=[];for(const name of await directDependencies(projectRoot)){const dir=join(root,name),pkg=await readManifest(join(dir,"package.json"));if(!pkg?.name||!pkg.stacks||typeof pkg.stacks!=="object")continue;out.push({name:pkg.name,meta:pkg.stacks,dir})}return out}async function fromPantry(projectRoot){const root=join(projectRoot,"pantry");if(!existsSync(root))return[];const out=[];for(const pattern of["*/package.json","@*/*/package.json"]){const glob=new Bun.Glob(pattern);for await(const file of glob.scan({cwd:root,absolute:!0,onlyFiles:!0})){const pkg=await readManifest(file);if(!pkg?.name||!pkg.stacks||typeof pkg.stacks!=="object")continue;out.push({name:pkg.name,meta:pkg.stacks,dir:join(file,"..")})}}return out.sort((a,b)=>a.name.localeCompare(b.name))}async function dontDiscover(projectRoot){const list=(await readManifest(join(projectRoot,"package.json")))?.stacks?.["dont-discover"];return new Set(Array.isArray(list)?list:[])}export async function discoverPackages(options={}){const projectRoot=options.projectRoot??projectPath(),manifestPath=options.manifestPath??storagePath("framework/discovered-packages.json"),excluded=await dontDiscover(projectRoot),found=[...await fromNodeModules(projectRoot),...await fromPantry(projectRoot)],packages={},shadowed=[],chosen=new Map;for(const candidate of found){if(excluded.has(candidate.name))continue;const root=toRelative(projectRoot,candidate.dir),already=chosen.get(candidate.name);if(already!==void 0){shadowed.push({name:candidate.name,used:already,ignored:root});continue}chosen.set(candidate.name,root);packages[candidate.name]={...candidate.meta,root}}const manifest={generated_at:new Date().toISOString(),packages,...shadowed.length>0?{shadowed}:{}};if(options.dryRun)return manifest;try{const current=await Bun.file(manifestPath).json();if(JSON.stringify(current.packages??{})===JSON.stringify(manifest.packages)&&JSON.stringify(current.shadowed??[])===JSON.stringify(shadowed))return current}catch{}await Bun.write(manifestPath,`${JSON.stringify(manifest,null,2)}
+`);return manifest}function toRelative(projectRoot,dir){const rel=relative(projectRoot,dir);return rel&&!rel.startsWith("..")&&!isAbsolute(rel)?rel:dir}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/actions",
   "type": "module",
   "sideEffects": false,
-  "version": "0.74.5",
+  "version": "0.74.6",
   "description": "The Stacks actions.",
   "author": "Chris Breuer",
   "contributors": [
@@ -60,51 +60,51 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/action-runner": "0.74.5",
-    "@stacksjs/ai": "0.74.5",
-    "@stacksjs/analytics": "0.74.5",
-    "@stacksjs/api": "0.74.5",
-    "@stacksjs/auth": "0.74.5",
-    "@stacksjs/build": "0.74.5",
+    "@stacksjs/action-runner": "0.74.6",
+    "@stacksjs/ai": "0.74.6",
+    "@stacksjs/analytics": "0.74.6",
+    "@stacksjs/api": "0.74.6",
+    "@stacksjs/auth": "0.74.6",
+    "@stacksjs/build": "0.74.6",
     "@stacksjs/bumpx": "^0.2.6",
     "@stacksjs/bunpress": "^0.2.8",
-    "@stacksjs/cli": "0.74.5",
-    "@stacksjs/cloud": "0.74.5",
-    "@stacksjs/cms": "0.74.5",
-    "@stacksjs/config": "0.74.5",
-    "@stacksjs/database": "0.74.5",
-    "@stacksjs/desktop-build": "0.74.5",
-    "@stacksjs/dns": "0.74.5",
-    "@stacksjs/enums": "0.74.5",
-    "@stacksjs/env": "0.74.5",
-    "@stacksjs/error-handling": "0.74.5",
+    "@stacksjs/cli": "0.74.6",
+    "@stacksjs/cloud": "0.74.6",
+    "@stacksjs/cms": "0.74.6",
+    "@stacksjs/config": "0.74.6",
+    "@stacksjs/database": "0.74.6",
+    "@stacksjs/desktop-build": "0.74.6",
+    "@stacksjs/dns": "0.74.6",
+    "@stacksjs/enums": "0.74.6",
+    "@stacksjs/env": "0.74.6",
+    "@stacksjs/error-handling": "0.74.6",
     "@stacksjs/gitit": "^0.2.5",
-    "@stacksjs/i18n": "0.74.5",
-    "@stacksjs/image": "0.74.5",
-    "@stacksjs/logging": "0.74.5",
+    "@stacksjs/i18n": "0.74.6",
+    "@stacksjs/image": "0.74.6",
+    "@stacksjs/logging": "0.74.6",
     "@stacksjs/logsmith": "^0.2.3",
-    "@stacksjs/orm": "0.74.5",
-    "@stacksjs/path": "0.74.5",
-    "@stacksjs/payments": "0.74.5",
-    "@stacksjs/queue": "0.74.5",
-    "@stacksjs/registry": "0.74.5",
-    "@stacksjs/router": "0.74.5",
+    "@stacksjs/orm": "0.74.6",
+    "@stacksjs/path": "0.74.6",
+    "@stacksjs/payments": "0.74.6",
+    "@stacksjs/queue": "0.74.6",
+    "@stacksjs/registry": "0.74.6",
+    "@stacksjs/router": "0.74.6",
     "@stacksjs/rpx": "^0.11.42",
-    "@stacksjs/scheduler": "0.74.5",
-    "@stacksjs/search-engine": "0.74.5",
-    "@stacksjs/security": "0.74.5",
-    "@stacksjs/server": "0.74.5",
-    "@stacksjs/sites": "0.74.5",
-    "@stacksjs/storage": "0.74.5",
-    "@stacksjs/strings": "0.74.5",
+    "@stacksjs/scheduler": "0.74.6",
+    "@stacksjs/search-engine": "0.74.6",
+    "@stacksjs/security": "0.74.6",
+    "@stacksjs/server": "0.74.6",
+    "@stacksjs/sites": "0.74.6",
+    "@stacksjs/storage": "0.74.6",
+    "@stacksjs/strings": "0.74.6",
     "@stacksjs/stx": "^0.2.253",
     "@stacksjs/tlsx": "^0.13.19",
     "@stacksjs/ts-cloud": "^0.12.10",
     "@stacksjs/ts-md": "^0.1.1",
-    "@stacksjs/tunnel": "0.74.5",
-    "@stacksjs/types": "0.74.5",
-    "@stacksjs/utils": "0.74.5",
-    "@stacksjs/whois": "0.74.5",
+    "@stacksjs/tunnel": "0.74.6",
+    "@stacksjs/types": "0.74.6",
+    "@stacksjs/utils": "0.74.6",
+    "@stacksjs/whois": "0.74.6",
     "bun-plugin-stx": "^0.2.246"
   },
   "peerDependencies": {
@@ -120,7 +120,7 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.74.5",
+    "@stacksjs/validation": "0.74.6",
     "better-dx": "^0.2.24"
   }
 }