incur 0.1.17 → 0.2.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}

package/package.json

@@ -1,9 +1,11 @@
 {
   "devDependencies": {
     "@changesets/cli": "latest",
+    "@hono/zod-openapi": "^1.2.2",
     "@types/node": "latest",
     "@vitest/coverage-v8": "^4.0.18",
     "bun": "^1.3.10",
+    "hono": "^4.12.5",
     "oxfmt": "^0.35.0",
     "oxlint": "^1.50.0",
     "tsx": "^4.21.0",
@@ -14,7 +16,7 @@
   "[!start-pkg]": "",
   "name": "incur",
   "type": "module",
-  "version": "0.1.17",
+  "version": "0.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -28,6 +30,7 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "@readme/openapi-parser": "^6.0.0",
     "@toon-format/toon": "^2.1.0",
     "yaml": "^2.8.2",
     "zod": "^4.3.6"

package/src/Cli.test-d.ts

@@ -47,9 +47,9 @@ test('output constrains run return type', () => {
     },
   })
 
+  // @ts-expect-error — return doesn't match output schema
   cli.command('greet', {
     output: z.object({ message: z.string() }),
-    // @ts-expect-error — return doesn't match output schema
     run() {
       return { wrong: 123 }
     },
@@ -64,9 +64,9 @@ test('alias keys are constrained to option keys', () => {
     run: () => ({}),
   })
 
+  // @ts-expect-error — 'foo' is not an option key
   cli.command('list', {
     options: z.object({ state: z.string() }),
-    // @ts-expect-error — 'foo' is not an option key
     alias: { foo: 'f' },
     run: () => ({}),
   })

package/src/Cli.test.ts

@@ -2435,3 +2435,208 @@ test('--llms includes hint in skill output', async () => {
   const { output } = await serve(cli, ['--llms'])
   expect(output).toContain('Always confirm before deploying to production')
 })
+
+describe('fetch', async () => {
+  const { app } = await import('../test/fixtures/hono-api.js')
+
+  test('command with fetch: GET /users', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      description: 'Hono API',
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, ['api', 'users'])
+    expect(output).toMatchInlineSnapshot(`
+      "users[1]{id,name}:
+        1,Alice
+      limit: 10
+      "
+    `)
+  })
+
+  test('GET with query params', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, ['api', 'users', '--limit', '5'])
+    expect(output).toMatchInlineSnapshot(`
+      "users[1]{id,name}:
+        1,Alice
+      limit: 5
+      "
+    `)
+  })
+
+  test('GET /users/:id via path segments', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, ['api', 'users', '42'])
+    expect(output).toMatchInlineSnapshot(`
+      "id: 42
+      name: Alice
+      "
+    `)
+  })
+
+  test('POST with -X and -d', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, [
+      'api',
+      'users',
+      '-X',
+      'POST',
+      '-d',
+      '{"name":"Bob"}',
+    ])
+    expect(output).toMatchInlineSnapshot(`
+      "created: true
+      name: Bob
+      "
+    `)
+  })
+
+  test('implicit POST with --body', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, [
+      'api',
+      'users',
+      '--body',
+      '{"name":"Eve"}',
+    ])
+    expect(output).toMatchInlineSnapshot(`
+      "created: true
+      name: Eve
+      "
+    `)
+  })
+
+  test('DELETE with --method', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, [
+      'api',
+      'users',
+      '1',
+      '--method',
+      'DELETE',
+    ])
+    expect(output).toMatchInlineSnapshot(`
+      "deleted: true
+      id: 1
+      "
+    `)
+  })
+
+  test('error response → exit code 1', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      fetch: app.fetch,
+    })
+    const { exitCode, output } = await serve(cli, ['api', 'error'])
+    expect(exitCode).toBe(1)
+    expect(output).toContain('HTTP_404')
+  })
+
+  test('--format json', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, ['api', 'health', '--format', 'json'])
+    expect(JSON.parse(output)).toEqual({ ok: true })
+  })
+
+  test('--verbose includes request/response meta', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, ['api', 'health', '--verbose', '--format', 'json'])
+    const parsed = JSON.parse(output)
+    expect(parsed.ok).toBe(true)
+    expect(parsed.data).toEqual({ ok: true })
+    expect(parsed.meta.command).toBe('api')
+  })
+
+  test('native + fetch commands coexist', async () => {
+    const cli = Cli.create('test', { description: 'test' })
+      .command('api', { fetch: app.fetch })
+      .command('ping', { run: () => ({ pong: true }) })
+    const { output: fetchOut } = await serve(cli, ['api', 'health'])
+    expect(fetchOut).toContain('ok: true')
+    const { output: nativeOut } = await serve(cli, ['ping'])
+    expect(nativeOut).toContain('pong: true')
+  })
+
+  test('root-level fetch', async () => {
+    const cli = Cli.create('api', { description: 'API', fetch: app.fetch })
+    const { output } = await serve(cli, ['users'])
+    expect(output).toMatchInlineSnapshot(`
+      "users[1]{id,name}:
+        1,Alice
+      limit: 10
+      "
+    `)
+  })
+
+  test('root-level fetch with no args → root path', async () => {
+    const cli = Cli.create('api', { description: 'API', fetch: app.fetch })
+    // Hono returns 404 for / since we don't have a root route
+    const { exitCode } = await serve(cli, [])
+    expect(exitCode).toBe(1)
+  })
+
+  test('--help on fetch command', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      description: 'Proxy to Hono API',
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, ['api', '--help'])
+    expect(output).toContain('Proxy to Hono API')
+    expect(output).toContain('--method')
+    expect(output).toContain('--header')
+    expect(output).toContain('--body')
+  })
+
+  test('text response', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, ['api', 'text'])
+    expect(output).toContain('hello world')
+  })
+
+  test('middleware runs before fetch handler', async () => {
+    let middlewareRan = false
+    const cli = Cli.create('test', { description: 'test' })
+      .use(async (_c, next) => {
+        middlewareRan = true
+        await next()
+      })
+      .command('api', { fetch: app.fetch })
+    await serve(cli, ['api', 'health'])
+    expect(middlewareRan).toBe(true)
+  })
+
+  test('fetch command appears in --llms', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      description: 'Proxy to API',
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, ['--llms'])
+    expect(output).toContain('api')
+    expect(output).toContain('Proxy to API')
+  })
+
+  test('fetch command appears in --help root', async () => {
+    const cli = Cli.create('test', { description: 'test' }).command('api', {
+      description: 'Proxy to API',
+      fetch: app.fetch,
+    })
+    const { output } = await serve(cli, ['--help'])
+    expect(output).toContain('api')
+    expect(output).toContain('Proxy to API')
+  })
+})