@emeryld/manager 0.1.2 → 0.1.4

package/README.md

@@ -0,0 +1,33 @@
+# @emeryld/manager
+
+Interactive release helper for pnpm monorepos. Install it as a local dev dependency, then run `pnpm manager-cli` (or call a `scripts.manager-cli` alias) from your workspace root to walk through selecting packages, running updates/tests/builds, and publishing.
+
+## Installation
+
+1. Ensure your workspace has a `packages/` directory (or configure one via `packages.mjs`).
+2. Add the manager to your dev dependencies so its CLI and helpers are hoisted into the consuming repo:
+   ```sh
+   pnpm add -D @emeryld/manager
+   ```
+3. Include a script in your `package.json` so you can invoke it consistently:
+   ```json
+   {
+     "scripts": {
+       "manager-cli": "manager-cli"
+     }
+   }
+   ```
+4. Run `pnpm install` to fetch `ts-node`, `semver`, and other runtime deps.
+
+## Running the CLI
+
+- Always run `pnpm manager-cli` (or `pnpm run manager-cli`) from the **workspace root** where your `packages/` folder lives. The manager operates against the workspace you are in, not the package that ships the tool.
+- Each TypeScript helper script registers the bundled `ts-node/esm` loader with the exact script path, so the CLI works even from pnpm workspaces that hoist dependencies.
+- To avoid the warning/error you saw earlier, make sure:
+  - the workspace has `packages/` (or a configured manifest) so `loadPackages()` can find targets,
+  - `pnpm install` has already written `ts-node` into `node_modules`,
+  - you execute the CLI from the workspace that owns those packages.
+
+## Testing the loader registration
+
+Run `pnpm test` to ensure the helper CLI always generates a `--import data:text...` snippet that registers `ts-node/esm.mjs` with **the actual script file path**. This guards against regressions that would make Node reject the loader and crash before the interactive menu appears.

package/bin/manager-cli.js

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
 import { spawnSync } from 'node:child_process'
 import path from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { fileURLToPath, pathToFileURL } from 'node:url'
 import { createRequire } from 'node:module'
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = path.dirname(__filename)
 const packageRoot = path.resolve(__dirname, '..')
 const tsconfigPath = path.join(packageRoot, 'tsconfig.base.json')
-const entryPoint = path.join(packageRoot, 'src', 'publish.js')
+const entryPoint = path.join(packageRoot, 'src', 'publish.ts')
 
 const require = createRequire(import.meta.url)
 const tsNodeLoader = require.resolve('ts-node/esm.mjs')
 const registerCode = [
   'import { register } from "node:module";',
   'import { pathToFileURL } from "node:url";',
-  `register(${JSON.stringify(tsNodeLoader)}, pathToFileURL(${JSON.stringify(
-    path.dirname(entryPoint),
-  )}));`,
+  `register(${JSON.stringify(
+    tsNodeLoader,
+  )}, pathToFileURL(${JSON.stringify(entryPoint)}));`,
 ].join(' ')
 const registerImport = `data:text/javascript,${encodeURIComponent(registerCode)}`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/manager",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Interactive manager for pnpm monorepos (update/test/build/publish).",
   "license": "MIT",
   "type": "module",
@@ -29,7 +29,8 @@
   },
   "devDependencies": {
     "@types/node": "^20.17.0",
-    "@types/semver": "^7.7.1"
+    "@types/semver": "^7.7.1",
+    "cross-env": "^7.0.3"
   },
   "ts-node": {
     "esm": true,
@@ -39,6 +40,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.base.json",
-    "typecheck": "tsc -p tsconfig.base.json --noEmit"
+    "typecheck": "tsc -p tsconfig.base.json --noEmit",
+    "test": "cross-env TS_NODE_PROJECT=tsconfig.base.json node --loader ts-node/esm test/helper-cli.test.ts"
   }
 }

package/src/helper-cli.ts

@@ -16,14 +16,14 @@ function getTsNodeLoaderPath() {
   return tsNodeLoaderPath
 }
 
-function buildTsNodeRegisterImport(baseDir: string) {
+export function buildTsNodeRegisterImport(scriptPath: string) {
   const loader = getTsNodeLoaderPath()
   const code = [
     'import { register } from "node:module";',
     'import { pathToFileURL } from "node:url";',
     `register(${JSON.stringify(
       loader,
-    )}, pathToFileURL(${JSON.stringify(baseDir)}));`,
+    )}, pathToFileURL(${JSON.stringify(scriptPath)}));`,
   ].join(' ')
   return `data:text/javascript,${encodeURIComponent(code)}`
 }
@@ -329,7 +329,7 @@ function runEntry(entry: ResolvedScriptEntry, forwardedArgs: string[]) {
   const execArgs = isTypeScript
     ? [
         '--import',
-        buildTsNodeRegisterImport(path.dirname(scriptPath)),
+        buildTsNodeRegisterImport(scriptPath),
         scriptPath,
         ...forwardedArgs,
       ]

package/tsconfig.base.json

@@ -3,6 +3,7 @@
     "target": "ES2022",
     "module": "NodeNext",
     "moduleResolution": "NodeNext",
+    "allowImportingTsExtensions": true,
     "rootDir": "src",
     "outDir": "dist",
     "lib": ["ES2022"],