@foundation0/api 1.1.2 → 1.1.4

package/net.ts

@@ -0,0 +1,170 @@
+import { curl as curlImpl, type CurlResult, type CurlToolOptions } from './libs/curl'
+
+export type NetCurlResult = CurlResult
+
+type NetCurlRequest = {
+  url?: string | string[]
+  urls?: string[]
+  method?: string
+  headers?: Record<string, string>
+  body?: string
+  data?: string | string[]
+  json?: unknown
+  form?: Record<string, string>
+  followRedirects?: boolean
+  location?: boolean
+  maxRedirects?: number
+  includeHeaders?: boolean
+  head?: boolean
+  user?: string
+  output?: string
+  remoteName?: boolean
+  fail?: boolean
+  silent?: boolean
+  showError?: boolean
+  verbose?: boolean
+  writeOut?: string
+  maxTimeSeconds?: number
+  get?: boolean
+  timeoutMs?: number
+  cwd?: string
+  env?: Record<string, string>
+  stdin?: string | Uint8Array | number[]
+}
+
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === 'object' && value !== null && !Array.isArray(value)
+
+const toStringRecord = (value: unknown): Record<string, string> | null => {
+  if (!isRecord(value)) return null
+  const out: Record<string, string> = {}
+  for (const [k, v] of Object.entries(value)) {
+    if (v === undefined || v === null) continue
+    out[k] = String(v)
+  }
+  return out
+}
+
+const parseRequest = (value: unknown): NetCurlRequest | null => {
+  if (!isRecord(value)) return null
+  if ('args' in value) return null
+  if (!('url' in value) && !('urls' in value)) return null
+  return value as NetCurlRequest
+}
+
+const toUint8Array = (value: unknown): Uint8Array | undefined => {
+  if (value instanceof Uint8Array) return value
+  if (Array.isArray(value)) {
+    const bytes = value.map((entry) => Number(entry)).filter((n) => Number.isFinite(n) && n >= 0 && n <= 255)
+    return new Uint8Array(bytes)
+  }
+  return undefined
+}
+
+const buildCurlArgsFromRequest = (request: NetCurlRequest): { args: string[]; toolOptions: CurlToolOptions } => {
+  const args: string[] = []
+
+  const urls = (() => {
+    if (Array.isArray(request.urls)) return request.urls.map(String)
+    if (Array.isArray(request.url)) return request.url.map(String)
+    if (typeof request.url === 'string') return [request.url]
+    return []
+  })()
+
+  const method = typeof request.method === 'string' && request.method.trim().length > 0
+    ? request.method.trim().toUpperCase()
+    : null
+
+  if (request.includeHeaders === true) args.push('-i')
+  if (request.head === true || method === 'HEAD') args.push('-I')
+
+  if (request.followRedirects === true || request.location === true) args.push('-L')
+  if (typeof request.maxRedirects === 'number' && Number.isInteger(request.maxRedirects) && request.maxRedirects >= 0) {
+    args.push('--max-redirs', String(request.maxRedirects))
+  }
+
+  if (request.fail === true) args.push('-f')
+  if (request.silent === true) args.push('-s')
+  if (request.showError === true) args.push('-S')
+  if (request.verbose === true) args.push('-v')
+
+  if (request.get === true) args.push('-G')
+
+  if (typeof request.user === 'string' && request.user.trim().length > 0) {
+    args.push('-u', request.user.trim())
+  }
+
+  const headers = toStringRecord(request.headers)
+  if (headers) {
+    for (const [k, v] of Object.entries(headers)) {
+      args.push('-H', `${k}: ${v}`)
+    }
+  }
+
+  if (typeof request.writeOut === 'string') args.push('-w', request.writeOut)
+  if (typeof request.output === 'string' && request.output.trim().length > 0) args.push('-o', request.output.trim())
+  if (request.remoteName === true) args.push('-O')
+
+  if (typeof request.maxTimeSeconds === 'number' && Number.isFinite(request.maxTimeSeconds) && request.maxTimeSeconds > 0) {
+    args.push('--max-time', String(request.maxTimeSeconds))
+  }
+
+  if (method && method !== 'HEAD' && request.head !== true) {
+    args.push('-X', method)
+  }
+
+  if (typeof request.body === 'string') {
+    args.push('--data-raw', request.body)
+  }
+
+  const data = request.data
+  if (typeof data === 'string') {
+    args.push('-d', data)
+  } else if (Array.isArray(data)) {
+    for (const entry of data) args.push('-d', String(entry))
+  }
+
+  if (request.json !== undefined) {
+    const rendered = typeof request.json === 'string' ? request.json : JSON.stringify(request.json)
+    args.push('--json', rendered)
+  }
+
+  if (isRecord(request.form)) {
+    for (const [k, v] of Object.entries(request.form)) {
+      if (v === undefined || v === null) continue
+      args.push('-F', `${k}=${String(v)}`)
+    }
+  }
+
+  args.push(...urls)
+
+  const toolOptions: CurlToolOptions = {
+    timeoutMs: typeof request.timeoutMs === 'number' && Number.isFinite(request.timeoutMs) && request.timeoutMs > 0
+      ? request.timeoutMs
+      : undefined,
+    cwd: typeof request.cwd === 'string' && request.cwd.trim().length > 0 ? request.cwd.trim() : undefined,
+    env: toStringRecord(request.env) ?? undefined,
+    stdin: typeof request.stdin === 'string' ? request.stdin : toUint8Array(request.stdin),
+  }
+
+  return { args, toolOptions }
+}
+
+export const curl = async (...rawArgs: unknown[]): Promise<CurlResult> => {
+  const request = rawArgs.length === 1 ? parseRequest(rawArgs[0]) : null
+  if (request) {
+    const { args, toolOptions } = buildCurlArgsFromRequest(request)
+    return curlImpl(...args, toolOptions)
+  }
+
+  const stringArgCount = rawArgs.filter((arg) => typeof arg === 'string').length
+  if (stringArgCount === 0 && rawArgs.length === 1 && isRecord(rawArgs[0])) {
+    const maybe = rawArgs[0] as Record<string, unknown>
+    if ('method' in maybe || 'headers' in maybe || 'body' in maybe || 'data' in maybe || 'json' in maybe) {
+      const { args, toolOptions } = buildCurlArgsFromRequest(maybe as NetCurlRequest)
+      return curlImpl(...args, toolOptions)
+    }
+  }
+
+  return curlImpl(...rawArgs)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foundation0/api",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Foundation 0 API",
   "type": "module",
   "bin": {
@@ -18,8 +18,10 @@
   "files": [
     "agents.ts",
     "git.ts",
+    "net.ts",
     "taskgraph-parser.ts",
     "projects.ts",
+    "libs",
     "mcp"
   ],
   "publishConfig": {
@@ -27,12 +29,12 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@foundation0/git": "^1.0.0",
+    "@foundation0/git": "^1.2.5",
     "@modelcontextprotocol/sdk": "^1.13.0"
   },
   "scripts": {
     "mcp": "bun run mcp/cli.ts",
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "bun test",
     "deploy": "pnpm publish --access public",
     "version:patch": "pnpm version patch && git commit -am \"Bump version to %s\"",
     "version:minor": "pnpm version minor && git commit -am \"Bump version to %s\"",