@cap-js/cds-types 0.0.1 → 0.2.0

package/apis/services.d.ts

@@ -1,118 +1,95 @@
+/* eslint-disable @typescript-eslint/ban-types */
 import { SELECT, INSERT, UPDATE, DELETE, Query, ConstructedQuery, UPSERT } from './ql'
 import { Awaitable } from './ql'
 import { ArrayConstructable, Constructable } from './internal/inference'
-import { LinkedCSN, LinkedDefinition, Definitions, LinkedEntity } from './linked'
+import { LinkedCSN, LinkedDefinition, Definitions as LinkedDefinitions, LinkedEntity } from './linked'
 import { CSN } from './csn'
 import { EventContext } from './events'
 import { Request } from './events'
+import { ReadableStream } from 'node:stream/web'
+
+type Key = number | string | any
 
 export class QueryAPI {
 
-  entities : LinkedCSN['entities']
+  entities: LinkedCSN['entities']
 
   /**
    * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#crud-style-api)
    */
   read: {
-    <T extends ArrayConstructable<any>>(entity: T, key?: any): Awaitable<SELECT<T>, InstanceType<T>>
-    <T>(entity: LinkedDefinition | string, key?: any): SELECT<T>
+    <T extends ArrayConstructable>(entity: T, key?: Key): Awaitable<SELECT<T>, InstanceType<T>>,
+    <T>(entity: LinkedDefinition | string, key?: Key): SELECT<T>,
   }
 
   /**
    * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#crud-style-api)
    */
   create: {
-    <T extends ArrayConstructable<any>>(entity: T, key?: any): INSERT<T>
-    <T>(entity: LinkedDefinition | string, key?: any): INSERT<T>
+    <T extends ArrayConstructable>(entity: T, key?: Key): INSERT<T>,
+    <T>(entity: LinkedDefinition | string, key?: Key): INSERT<T>,
   }
 
   /**
    * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#crud-style-api)
    */
   insert: {
-    <T extends ArrayConstructable<any>>(data: T): INSERT<T>
-    <T>(data: object | object[]): INSERT<T>
+    <T extends ArrayConstructable>(data: T): INSERT<T>,
+    <T>(data: object | object[]): INSERT<T>,
   }
 
   /**
    * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#crud-style-api)
    */
   upsert: {
-    <T extends ArrayConstructable<any>>(data: T): UPSERT<T>
-    <T>(data: object | object[]): UPSERT<T>
+    <T extends ArrayConstructable>(data: T): UPSERT<T>,
+    <T>(data: object | object[]): UPSERT<T>,
   }
 
   /**
    * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#crud-style-api)
    */
   update: {
-    <T extends ArrayConstructable<any>>(entity: T, key?: any): UPDATE<T>
-    <T>(entity: LinkedDefinition | string, key?: any): UPDATE<T>
+    <T extends ArrayConstructable>(entity: T, key?: Key): UPDATE<T>,
+    <T>(entity: LinkedDefinition | string, key?: Key): UPDATE<T>,
   }
 
   /**
    * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#crud-style-api)
    */
   run: {
-    (query: ConstructedQuery | ConstructedQuery[]): Promise<ResultSet | any>
-    (query: Query): Promise<ResultSet | any>
-    (query: string, args?: any[] | object): Promise<ResultSet | any>
+    (query: ConstructedQuery | ConstructedQuery[]): Promise<ResultSet | any>,
+    (query: Query): Promise<ResultSet | any>,
+    (query: string, args?: any[] | object): Promise<ResultSet | any>,
   }
 
-  /**
-   * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#crud-style-api)
-   */
-  delete<T>(entity: LinkedDefinition | string, key?: any): DELETE<T>
-
-  /**
-   * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#srv-foreach-entity)
-   */
-  foreach(query: Query, callback: (row: object) => void): this
-
   /**
    * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#srv-stream-column)
    */
   stream: {
     (column: string): {
       from(entity: LinkedDefinition | string): {
-        where(filter: any): ReadableStream
-      }
-    }
-    (query: Query): Promise<ReadableStream>
+        where(filter: any): ReadableStream,
+      },
+    },
+    (query: Query): Promise<ReadableStream>,
   }
 
   /**
-   * Starts or joins a transaction
-   * @see [docs](https://cap.cloud.sap/docs/node.js/cds-tx)
-   */
-
-  tx: {
-    (fn: (tx: Transaction) => {}): Promise<unknown>
-    (context?: object): Transaction
-    (context: object, fn: (tx: Transaction) => {}): Promise<unknown>
-  }
-
-  transaction: {
-    (fn: (tx: Transaction) => {}): Promise<unknown>
-    (context?: object): Transaction
-    (context: object, fn: (tx: Transaction) => {}): Promise<unknown>
-  }
-
-  /**
-   * @see [docs](https://cap.cloud.sap/docs/node.js/cds-tx#cds-spawn)
+   * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#crud-style-api)
    */
-  spawn(options: {
-    [key: string]: any
-    every?: number
-    after?: number
-  }, fn: (tx: Transaction) => {}): SpawnEventEmitter
+  delete<T>(entity: LinkedDefinition | string, key?: Key): DELETE<T>
 
   /**
-   * @see [docs](https://cap.cloud.sap/docs/node.js/cds-tx#event-contexts
+   * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#srv-foreach-entity)
    */
-  context?: EventContext
+  foreach (query: Query, callback: (row: object) => void): this
+  transaction: {
+    (fn: (tx: Transaction) => object): Promise<any>,
+    (context?: object): Transaction,
+    (context: object, fn: (tx: Transaction) => object): Promise<any>,
+  }
 
-  db: DatabaseService
 }
 
 
@@ -121,24 +98,25 @@ export class QueryAPI {
  * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services)
  */
 export class Service extends QueryAPI {
-  constructor(
+
+  constructor (
     name?: string,
     model?: CSN,
     options?: {
-      kind: string
-      impl: string | ServiceImpl
+      kind: string,
+      impl: string | ServiceImpl,
     }
   )
 
   /**
-   * The name of the service
+   * The kind of the service
    */
-  name: string
+  kind: string
 
   /**
-   * The kind of the service
+   * The name of the service
    */
-  kind: string
+  name: string
 
   /**
    * The model from which the service's definition was loaded
@@ -150,40 +128,40 @@ export class Service extends QueryAPI {
    * Provides access to the entities exposed by a service
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services)
    */
-  entities: Definitions & ((namespace: string) => Definitions)
+  entities: LinkedDefinitions & ((namespace: string) => LinkedDefinitions)
 
   /**
    * Provides access to the events declared by a service
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services)
    */
-  events: Definitions & ((namespace: string) => Definitions)
+  events: LinkedDefinitions & ((namespace: string) => LinkedDefinitions)
 
   /**
    * Provides access to the types exposed by a service
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services)
    */
-  types: Definitions & ((namespace: string) => Definitions)
+  types: LinkedDefinitions & ((namespace: string) => LinkedDefinitions)
 
   /**
    * Provides access to the operations, i.e. actions and functions, exposed by a service
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services)
    */
-  operations: Definitions & ((namespace: string) => Definitions)
+  operations: LinkedDefinitions & ((namespace: string) => LinkedDefinitions)
 
   /**
    * Acts like a parameter-less constructor. Ensure to call `await super.init()` to have the base class’s handlers added.
    * You may register own handlers before the base class’s ones, to intercept requests before the default handlers snap in.
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services#srv-init)
    */
-  init(): Promise<void>
+  init (): Promise<void>
 
   /**
    * Constructs and emits an asynchronous event.
    * @see [capire docs](https://cap.cloud.sap/docs/core-services#srv-emit-event)
    */
   emit: {
-    <T = any>(details: { event: types.event; data?: object; headers?: object }): Promise<T>
-    <T = any>(event: types.event, data?: object, headers?: object): Promise<T>
+    <T = any>(details: { event: types.event, data?: object, headers?: object }): Promise<T>,
+    <T = any>(event: types.event, data?: object, headers?: object): Promise<T>,
   }
 
   /**
@@ -191,12 +169,12 @@ export class Service extends QueryAPI {
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services#srv-send-request)
    */
   send: {
-    <T = any>(event: types.event, path: string, data?: object, headers?: object): Promise<T>
-    <T = any>(event: types.event, data?: object, headers?: object): Promise<T>
-    <T = any>(details: { event: types.event; data?: object; headers?: object }): Promise<T>
-    <T = any>(details: { query: ConstructedQuery; data?: object; headers?: object }): Promise<T>
-    <T = any>(details: { method: types.eventName; path: string; data?: object; headers?: object }): Promise<T>
-    <T = any>(details: { event: types.eventName; entity: LinkedDefinition | string; data?: object; params?: object }): Promise<T>
+    <T = any>(event: types.event, path: string, data?: object, headers?: object): Promise<T>,
+    <T = any>(event: types.event, data?: object, headers?: object): Promise<T>,
+    <T = any>(details: { event: types.event, data?: object, headers?: object }): Promise<T>,
+    <T = any>(details: { query: ConstructedQuery, data?: object, headers?: object }): Promise<T>,
+    <T = any>(details: { method: types.eventName, path: string, data?: object, headers?: object }): Promise<T>,
+    <T = any>(details: { event: types.eventName, entity: LinkedDefinition | string, data?: object, params?: object, headers?: object }): Promise<T>,
   }
 
   /**
@@ -204,40 +182,54 @@ export class Service extends QueryAPI {
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services#rest-style-api)
    */
   get<T = any>(entityOrPath: types.target, data?: object): Promise<T>
+
   /**
    * Constructs and sends a POST request.
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services#rest-style-api)
    */
   post<T = any>(entityOrPath: types.target, data?: object): Promise<T>
+
   /**
    * Constructs and sends a PUT request.
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services#rest-style-api)
    */
   put<T = any>(entityOrPath: types.target, data?: object): Promise<T>
+
   /**
    * Constructs and sends a PATCH request.
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services#rest-style-api)
    */
   patch<T = any>(entityOrPath: types.target, data?: object): Promise<T>
+
   /**
    * Constructs and sends a DELETE request.
    */
   delete: {
-    <T = any>(entityOrPath: types.target, data?: object): DELETE<T>
-    <T extends ArrayConstructable<any>>(entity: T, key?: any): DELETE<T>
-    <T>(entity: LinkedDefinition | string, key?: any): DELETE<T>
+    <T = any>(entityOrPath: types.target, data?: object): DELETE<T>,
+    <T extends ArrayConstructable>(entity: T, key?: Key): DELETE<T>,
+    <T>(entity: LinkedDefinition | string, key?: Key): DELETE<T>,
   }
 
   // The central method to dispatch events
-  dispatch(msg: types.event): Promise<any>
+  dispatch (msg: types.event): Promise<any>
+
+  // FIXME: not yet documented, will come in future version
+  // disconnect (tenant?: string): Promise<void>
 
   // Provider API
-  prepend(fn: ServiceImpl): Promise<this>
+  prepend (fn: ServiceImpl): Promise<this>
+
   on<T extends Constructable>(eve: types.event, entity: T, handler: CRUDEventHandler.On<InstanceType<T>, InstanceType<T> | void | Error>): this
+
   on<F extends CdsFunction>(boundAction: F, service: string, handler: ActionEventHandler<F['__parameters'], void | Error | F['__returns']>): this
+
   on<F extends CdsFunction>(unboundAction: F, handler: ActionEventHandler<F['__parameters'], void | Error | F['__returns']>): this
-  on(eve: types.event, entity: types.target, handler: OnEventHandler): this
-  on(eve: types.event, handler: OnEventHandler): this
+
+  on (eve: types.event, entity: types.target, handler: OnEventHandler): this
+
+  on (eve: types.event, handler: OnEventHandler): this
+
+  on (eve: 'error', handler: OnErrorHandler): this
 
 
   // onSucceeded (eve: types.Events, entity: types.Target, handler: types.EventHandler): this
@@ -245,26 +237,40 @@ export class Service extends QueryAPI {
   // onFailed (eve: types.Events, entity: types.Target, handler: types.EventHandler): this
   // onFailed (eve: types.Events, handler: types.EventHandler): this
   before<T extends Constructable>(eve: types.event, entity: T, handler: CRUDEventHandler.Before<InstanceType<T>, InstanceType<T> | void | Error>): this
-  before(eve: types.event, entity: types.target, handler: EventHandler): this
-  before(eve: types.event, handler: EventHandler): this
+
+  before (eve: types.event, entity: types.target, handler: EventHandler): this
+
+  before (eve: types.event, handler: EventHandler): this
+
   after<T extends Constructable>(eve: types.event, entity: T, handler: CRUDEventHandler.After<InstanceType<T>, InstanceType<T> | void | Error>): this
-  after(eve: types.event, entity: types.target, handler: ResultsHandler): this
-  after(eve: types.event, handler: ResultsHandler): this
-  reject(eves: types.event, ...entity: types.target[]): this
+
+  after (eve: types.event, entity: types.target, handler: ResultsHandler): this
+
+  after (eve: types.event, handler: ResultsHandler): this
+
+  reject (eves: types.event, ...entity: types.target[]): this
+
 }
 
 export class ApplicationService extends Service {}
 export class MessagingService extends Service {}
 export class RemoteService extends Service {}
 export class DatabaseService extends Service {
-  deploy(model?: CSN | string): Promise<CSN>
-  begin(): Promise<void>
-  commit(): Promise<void>
-  rollback(): Promise<void>
+
+  deploy (model?: CSN | string): Promise<CSN>
+
+  begin (): Promise<void>
+
+  commit (): Promise<void>
+
+  rollback (): Promise<void>
+
 }
 
 
 export default class cds {
+
+
   /**
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/core-services)
    */
@@ -289,15 +295,16 @@ export default class cds {
    * @see [capire docs](https://cap.cloud.sap/docs/node.js/databases)
    */
   DatabaseService: typeof DatabaseService
+
 }
 
 
-interface Transaction extends Service {
+export interface Transaction extends Service {
   commit(): Promise<void>
   rollback(): Promise<void>
 }
 
-interface ResultSet extends Array<{}> {}
+interface ResultSet extends Array<object> {}
 
 interface ServiceImpl {
   (this: Service, srv: Service): any
@@ -312,6 +319,10 @@ interface OnEventHandler {
   (req: Request, next: Function): Promise<any> | any | void
 }
 
+interface OnErrorHandler {
+  (err: Error, req: Request): any | void
+}
+
 // `Partial` wraps any type and allows all properties to be undefined
 // in addition to their actual type.
 // This is important in the context of CRUD events, where
@@ -322,7 +333,7 @@ type Partial<T> = { [Key in keyof T]: undefined | T[Key] }
 // Naming the first parameter in a handler `each` has special voodoo
 // semantic which makes it impossible for us to infer the exact behaviour on a type level.
 // So we always have to expect scalars as well as arrays in some callbacks.
-type OneOrMany<T> = T | T[];
+type OneOrMany<T> = T | T[]
 
 // functions generated by cds-typer explicitly carry types for
 // parameters and return type, as their names are not accessible from
@@ -331,23 +342,23 @@ type OneOrMany<T> = T | T[];
 type CdsFunction = {
   (...args: any[]): any,
   __parameters: object,
-  __returns: unknown
+  __returns: any,
 }
 
 type TypedRequest<T> = Omit<Request, 'data'> & { data: T }
 
 // https://cap.cloud.sap/docs/node.js/core-services#srv-on-before-after
 declare namespace CRUDEventHandler {
-  type Before<P,R> = (req: TypedRequest<P>) => Promise<R> | R
-  type On<P,R> = (req: TypedRequest<P>, next: (...args: any) => Promise<R> | R) => Promise<R> | R
-  type After<P,R> = (data: undefined | P, req: TypedRequest<P>) => Promise<R> | R
+  type Before<P, R> = (req: TypedRequest<P>) => Promise<R> | R
+  type On<P, R> = (req: TypedRequest<P>, next: (...args: any[]) => Promise<R> | R) => Promise<R> | R
+  type After<P, R> = (data: undefined | P, req: TypedRequest<P>) => Promise<R> | R
 }
 
 // Handlers for actions try to infer the passed .data property
 // as strictly as possible and therefore have to remove
 // { data: any } (inherited EventMessage} with a more restricted
 // type, based on the parameters of the action.
-interface ActionEventHandler<P,R> {
+interface ActionEventHandler<P, R> {
   (req: Omit<Request, 'data'> & { data: P }, next: Function): Promise<R> | R
 }
 
@@ -364,28 +375,75 @@ interface ResultsHandler {
 }
 
 interface SpawnEvents {
-  'succeeded': (res: any) => void
-  'failed': (error: any) => void
-  'done': () => void
+  succeeded: (res: any) => void
+  failed: (error: any) => void
+  done: () => void
 }
 
 declare class SpawnEventEmitter {
+
   on<U extends keyof SpawnEvents>(
     event: U, listener: SpawnEvents[U]
-  ): this;
+  ): this
 
   emit<U extends keyof SpawnEvents>(
     event: U, ...args: Parameters<SpawnEvents[U]>
-  ): boolean;
+  ): boolean
   timer: any
+
 }
 
 declare namespace types {
   type event = eventName | eventName[]
-  type eventName = (string & {})
+  type eventName = string
     | 'CREATE' | 'READ' | 'UPDATE' | 'DELETE'
     | 'NEW' | 'EDIT' | 'PATCH' | 'SAVE'
     | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
     | 'COMMIT' | 'ROLLBACK'
-  type target = string | LinkedDefinition | LinkedEntity | (string | LinkedDefinition | LinkedEntity)[] | ArrayConstructable<any>
+  type target = string | LinkedDefinition | LinkedEntity | (string | LinkedDefinition | LinkedEntity)[] | ArrayConstructable
+}
+
+type SpawnOptions = {
+  [key: string]: any,
+  every?: number,
+  after?: number,
+}
+
+// FIXME: this was ?: EventContext before. Is context supposed to not be present sometimes?
+// let, as apparently we can reassign?
+/**
+ * @see [docs](https://cap.cloud.sap/docs/node.js/cds-tx#event-contexts
+ */
+export let context: EventContext | undefined
+
+/**
+* @see [docs](https://cap.cloud.sap/docs/node.js/cds-tx#cds-spawn)
+*/
+export function spawn (options: SpawnOptions, fn: (tx: Transaction) => object): SpawnEventEmitter
+
+
+// facade proxies into cds.db, which is a Service
+/**
+* Starts or joins a transaction
+* @see [docs](https://cap.cloud.sap/docs/node.js/cds-tx)
+*/
+export const tx: {
+  (fn: (tx: Transaction) => object): Promise<any>,
+  (context?: object): Transaction,
+  (context: object, fn: (tx: Transaction) => object): Promise<any>,
 }
+export const entities: Service['entities']
+export const run: Service['run']
+export const foreach: Service['foreach']
+export const stream: Service['stream']
+export const read: Service['read']
+export const create: Service['create']
+export const insert: Service['insert']
+export const update: Service['update']
+// temporarily moved to cds.d.ts, as "delete" is a reserved keyword
+// export const delete: Service['delete']
+// FIXME: see Service.disconnect comment
+// export const disconnect: Service['disconnect']
+export const transaction: Service['transaction']
+export const db: DatabaseService
+// export const upsert: Service['upsert']

package/apis/test.d.ts

@@ -1,59 +1,91 @@
-import { AxiosInstance } from 'axios';
-import * as chai from 'chai';
-import * as http from 'http';
-import { Service } from './services';
+import { AxiosInstance } from 'axios'
+import chai from 'chai'
+import * as http from 'http'
+import { Service } from './services'
+import * as cds from './cds'
+
+type _cds = typeof cds
 
 declare class Axios {
-  get axios(): AxiosInstance;
-
-  get     : AxiosInstance['get'];
-  put     : AxiosInstance['put'];
-  post    : AxiosInstance['post'];
-  patch   : AxiosInstance['patch'];
-  delete  : AxiosInstance['delete'];
-  options : AxiosInstance['options'];
-
-  get GET()     : Axios['get'];
-  get PUT()     : Axios['put'];
-  get POST()    : Axios['post'];
-  get PATCH()   : Axios['patch'];
-  get DELETE()  : Axios['delete'];
-  get OPTIONS() : Axios['options'];
+
+  get axios (): AxiosInstance
+  get: AxiosInstance['get'];
+
+  put: AxiosInstance['put']
+
+  post: AxiosInstance['post']
+
+  patch: AxiosInstance['patch']
+
+  delete: AxiosInstance['delete']
+
+  options: AxiosInstance['options']
+
+  get GET (): Axios['get']
+
+  get PUT (): Axios['put']
+
+  get POST (): Axios['post']
+
+  get PATCH (): Axios['patch']
+
+  get DELETE (): Axios['delete']
+
+  get OPTIONS (): Axios['options']
+
 }
 
 declare class DataUtil {
-  delete(db?: Service): Promise<void>;
-  reset(db?: Service): Promise<void>;
-  /** @deprecated */ autoReset(enabled: boolean): this;
+
+  delete (db?: Service): Promise<void>
+
+  reset (db?: Service): Promise<void>
+
+  /**
+   * @deprecated if needed, call `reset()`, considering test performance
+   */
+  autoReset (enabled: boolean): this
+
 }
 
 declare class Test extends Axios {
 
-  test : Test
+  test: Test
+
+  run (cmd: string, ...args: string[]): this
+
+  in (...paths: string[]): this
+
+  silent (): this
+
+  /**
+   * @deprecated Server log is shown by default. Use `log()` to get control over it.
+   */
+  verbose (v: boolean): this
 
-  run(cmd: string, ...args: string[]): this;
-  in(...paths: string[]): this;
-  silent(): this;
-  /** @deprecated */ verbose(v: boolean): this;
+  get chai (): typeof chai
 
-  get chai(): typeof chai;
-  get expect(): typeof chai.expect;
-  get assert(): typeof chai.assert;
-  get data(): DataUtil;
-  get cds(): typeof import('./cds')
+  get expect (): typeof chai.expect
 
-  log() : {
-    output: string
-    clear(): void
-    release(): void
+  get assert (): typeof chai.assert
+
+  get data (): DataUtil
+
+  get cds (): _cds
+
+  log (): {
+    output: string,
+    clear(): void,
+    release(): void,
   }
 
-  then(r: (args: { server: http.Server, url: string }) => void): void;
+  then (r: (args: { server: http.Server, url: string }) => void): void
 
   // get sleep(): (ms: number) => Promise<void>;
   // get spy(): <T, K extends keyof T>(o: T, f: K) => T[K] extends (...args: infer TArgs) => infer TReturnValue
   //   ? Spy<TArgs, TReturnValue>
   //   : Spy;
+
 }
 
 // typings for spy inspired by @types/sinon
@@ -63,19 +95,18 @@ declare class Test extends Axios {
 //   restore(): (...args: TArgs) => TReturnValue;
 // }
 
-export = cds
+declare const test: {
+  Test: typeof Test,
 
-declare class cds {
-  test: {
-    Test: typeof Test
-    /**
-     * @see [capire docs](https://cap.cloud.sap/docs/node.js/cds-test?q=cds.test#run)
+  /**
+     * @see [capire docs](https://cap.cloud.sap/docs/node.js/cds-test#class-cds-test-test)
      */
-    (projectDir: string): Test;
-    /**
-     * @see [capire docs](https://cap.cloud.sap/docs/node.js/cds-test?q=cds.test#run-2)
+  (dirname: string): Test,
+
+  /**
+     * @see [capire docs](https://cap.cloud.sap/docs/node.js/cds-test#class-cds-test-test)
      */
-    (command: string, ...args: string[]): Test;
-    in (string) : Test
-  }
+  (command: string, ...args: string[]): Test,
+
+  in (dirname: string): Test,
 }