incur 0.0.0 → 0.0.2

package/src/index.ts

@@ -0,0 +1,14 @@
+export { z } from 'zod'
+export * as Cli from './Cli.js'
+export * as Errors from './Errors.js'
+export * as Formatter from './Formatter.js'
+export * as Help from './Help.js'
+export * as Mcp from './Mcp.js'
+export * as Parser from './Parser.js'
+export type { Register } from './Register.js'
+export * as Schema from './Schema.js'
+export * as Skill from './Skill.js'
+export * as Skillgen from './Skillgen.js'
+export * as SyncMcp from './SyncMcp.js'
+export * as SyncSkills from './SyncSkills.js'
+export * as Typegen from './Typegen.js'

package/src/internal/pm.test.ts

@@ -0,0 +1,38 @@
+import { detectRunner } from './pm.js'
+
+test('detects pnpm from user agent', () => {
+  const saved = process.env.npm_config_user_agent
+  process.env.npm_config_user_agent = 'pnpm/10.0.0 node/v22.0.0'
+  expect(detectRunner()).toBe('pnpx')
+  process.env.npm_config_user_agent = saved
+})
+
+test('detects bun from user agent', () => {
+  const savedAgent = process.env.npm_config_user_agent
+  const savedExec = process.env.npm_execpath
+  process.env.npm_config_user_agent = 'bun/1.0.0'
+  delete process.env.npm_execpath
+  expect(detectRunner()).toBe('bunx')
+  process.env.npm_config_user_agent = savedAgent
+  process.env.npm_execpath = savedExec
+})
+
+test('detects pnpm from exec path', () => {
+  const savedAgent = process.env.npm_config_user_agent
+  const savedExec = process.env.npm_execpath
+  delete process.env.npm_config_user_agent
+  process.env.npm_execpath = '/usr/local/lib/node_modules/pnpm/bin/pnpm.cjs'
+  expect(detectRunner()).toBe('pnpx')
+  process.env.npm_config_user_agent = savedAgent
+  process.env.npm_execpath = savedExec
+})
+
+test('falls back to npx', () => {
+  const savedAgent = process.env.npm_config_user_agent
+  const savedExec = process.env.npm_execpath
+  delete process.env.npm_config_user_agent
+  delete process.env.npm_execpath
+  expect(detectRunner()).toBe('npx')
+  process.env.npm_config_user_agent = savedAgent
+  process.env.npm_execpath = savedExec
+})

package/src/internal/pm.ts

@@ -0,0 +1,8 @@
+/** Detects the package manager runner (`npx`, `pnpx`, `bunx`) from the current process environment. */
+export function detectRunner(): string {
+  const userAgent = process.env.npm_config_user_agent ?? ''
+  const execPath = process.env.npm_execpath ?? ''
+  if (userAgent.includes('pnpm') || execPath.includes('pnpm')) return 'pnpx'
+  if (userAgent.includes('bun') || execPath.includes('bun')) return 'bunx'
+  return 'npx'
+}

package/src/internal/types.ts

@@ -0,0 +1,22 @@
+/** Combines members of an intersection into a readable type. */
+export type Compute<type> = { [key in keyof type]: type[key] } & unknown
+
+/** Collects all keys across every member of a union. */
+export type KeyofUnion<type> = type extends type ? keyof type : never
+
+/** Creates a mutually exclusive union where each variant's missing keys are `?: undefined`. */
+export type OneOf<
+  union extends object,
+  fallback extends object | undefined = undefined,
+  keys extends KeyofUnion<union> = KeyofUnion<union>,
+> = union extends infer item
+  ? Compute<
+      item & {
+        [key in Exclude<keys, keyof item>]?: fallback extends object
+          ? key extends keyof fallback
+            ? fallback[key]
+            : undefined
+          : undefined
+      }
+    >
+  : never

package/src/internal/utils.ts

@@ -0,0 +1,50 @@
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import url from 'node:url'
+
+import * as Cli from '../Cli.js'
+
+/**
+ * Dynamically imports a module and extracts its default-exported CLI instance.
+ * Temporarily replaces `process.argv` and `process.exit` to prevent imported
+ * modules that call `.serve()` at the top level from interfering.
+ */
+export async function importCli(input: string): Promise<Cli.Cli> {
+  const resolved = path.resolve(input)
+  const stat = await fs.stat(resolved)
+  const file = stat.isDirectory() ? await resolveEntry(resolved) : resolved
+  const href = url.pathToFileURL(file).href
+
+  const savedArgv = process.argv
+  const savedExit = process.exit
+  const savedWrite = process.stdout.write
+  process.argv = [savedArgv[0]!]
+  process.exit = (() => {}) as never
+  process.stdout.write = (() => true) as never
+  try {
+    const mod = await import(href)
+    const cli = mod.default as Cli.Cli
+    if (!cli || !Cli.toCommands.has(cli))
+      throw new Error(`Expected default export to be a \`Cli\` instance: ${input}`)
+    return cli
+  } finally {
+    process.argv = savedArgv
+    process.exit = savedExit
+    process.stdout.write = savedWrite
+  }
+}
+
+/** Resolves the CLI entry file from a directory by checking `package.json` `bin`, then falling back to `cli.ts`. */
+async function resolveEntry(dir: string): Promise<string> {
+  try {
+    const pkg = JSON.parse(await fs.readFile(path.join(dir, 'package.json'), 'utf8'))
+    if (pkg.bin) {
+      const entries = typeof pkg.bin === 'string' ? [pkg.bin] : (Object.values(pkg.bin) as string[])
+      const src = entries.find((e) => e.endsWith('.ts'))
+      const entry = src ?? entries[0]
+      if (entry) return path.join(dir, entry)
+    }
+    if (pkg.main) return path.join(dir, pkg.main)
+  } catch {}
+  return path.join(dir, 'cli.ts')
+}

package/src/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "types": ["node"]
+  },
+  "include": ["./**/*.ts"],
+  "exclude": ["./**/*.test.ts", "./**/*.test-d.ts"]
+}