ts-procedures 8.6.0 → 9.1.0

package/src/codegen/emit-scope.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it } from 'vitest'
 import { emitScopeFile } from './emit-scope.js'
 import type { ScopeGroup } from './group-routes.js'
-import type { RPCHttpRouteDoc, APIHttpRouteDoc, StreamHttpRouteDoc } from '../implementations/types.js'
+import type { RPCHttpRouteDoc, APIHttpRouteDoc, StreamHttpRouteDoc } from '../server/types.js'
 
 // ---------------------------------------------------------------------------
 // Fixtures
@@ -1151,7 +1151,7 @@ describe('emitScopeFile streams omit .safe sibling', () => {
 // API conditional return type (body-only, headers-only, both, void)
 // ---------------------------------------------------------------------------
 
-import type { HttpStreamRouteDoc } from '../implementations/types.js'
+import type { HttpStreamRouteDoc } from '../server/types.js'
 
 const apiGroupBodyOnly: ScopeGroup = {
   scopeKey: 'reports',
@@ -1676,3 +1676,76 @@ describe('emitScopeFile callable JSDoc surfaces options + errors', () => {
     expect(out).not.toContain('@throws')
   })
 })
+
+// ---------------------------------------------------------------------------
+// Errors-only routes: Errors must have a namespace home (DX #6)
+// ---------------------------------------------------------------------------
+
+const apiGroupErrorsOnly: ScopeGroup = {
+  scopeKey: 'auth',
+  camelCase: 'auth',
+  routes: [
+    {
+      kind: 'api',
+      name: 'Logout',
+      path: '/logout',
+      method: 'post',
+      fullPath: '/api/logout',
+      scope: 'auth',
+      successStatus: 204,
+      errors: ['Unauthorized'],
+      jsonSchema: {},
+    } satisfies APIHttpRouteDoc,
+  ],
+}
+
+const rpcGroupErrorsOnly: ScopeGroup = {
+  scopeKey: 'auth',
+  camelCase: 'auth',
+  routes: [
+    {
+      kind: 'rpc',
+      name: 'Logout',
+      path: '/auth/logout',
+      method: 'post',
+      scope: 'auth',
+      version: 1,
+      errors: ['Unauthorized'],
+      jsonSchema: {},
+    } satisfies RPCHttpRouteDoc,
+  ],
+}
+
+describe('emitScopeFile errors-only routes (DX #6)', () => {
+  it('namespace mode: API route with errors but no req/res emits a namespace housing Errors', async () => {
+    const out = await emitScopeFile(apiGroupErrorsOnly, {
+      namespaceTypes: true,
+      errorKeys: new Set(['Unauthorized']),
+      serviceName: 'Api',
+    })
+    expect(out).toContain('export namespace Logout')
+    expect(out).toContain('export type Errors = ApiErrors.Unauthorized')
+    expect(out).toContain('client.bindCallableTyped<void, void, Auth.Logout.Errors>')
+  })
+
+  it('namespace mode: RPC route with errors but no params/response emits a namespace housing Errors', async () => {
+    const out = await emitScopeFile(rpcGroupErrorsOnly, {
+      namespaceTypes: true,
+      errorKeys: new Set(['Unauthorized']),
+      serviceName: 'Api',
+    })
+    expect(out).toContain('export namespace Logout')
+    expect(out).toContain('export type Errors = ApiErrors.Unauthorized')
+    expect(out).toContain('client.bindCallableTyped<void, unknown, Auth.Logout.Errors>')
+  })
+
+  it('flat mode: API route with errors but no req/res emits a flat Errors alias (regression guard)', async () => {
+    const out = await emitScopeFile(apiGroupErrorsOnly, {
+      namespaceTypes: false,
+      errorKeys: new Set(['Unauthorized']),
+      serviceName: 'Api',
+    })
+    expect(out).toContain('export type LogoutErrors = _errors.Unauthorized')
+    expect(out).toContain('client.bindCallableTyped<void, void, LogoutErrors>')
+  })
+})