@cap-js/cds-types 0.0.1 → 0.1.0

package/apis/models.d.ts

@@ -1,6 +1,7 @@
 import { Query as CQN, expr, _xpr } from "./cqn"
 import { LinkedCSN } from "./linked"
 import { CSN } from "./csn"
+import * as cds from './cds'
 
 type _flavor = 'parsed' | 'xtended' | 'inferred'
 type _odata_options = {
@@ -27,154 +28,144 @@ type EDMX = XML
 type filename = string
 
 
-export default class cds {
-
-	/**
-	 * The effective CDS model loaded during bootstrapping, which contains all service and entity definitions,
-	 * including required services.
-	 */
-	model?: LinkedCSN
-
-    /**
-     * Provides a set of methods to parse a given model, query or expression.
-     * You can also use `cds.parse()` as a shortcut to `cds.parse.cdl()`.
-     */
-    parse : {
-        /** Shortcut to `cds.parse.cdl()` */
-        (cdl:CDL) : CSN
-        cdl (cdl:CDL) : CSN
-        cql (src:string) : CQN
-        expr (src:string) : expr
-        xpr (src:string) : _xpr
-        ref (src:string) : string[]
-    }
-
-
-    /**
-     * Provides a set of methods to parse a given model, query or expression.
-     * You can also use `cds.compile(csn).to('<output>')` as a fluent variant.
-     */
-    compile : {
-        /** Shortcut for `cds.compile.to.csn()` */
-        cdl (model:CDL, o?:_options) : CSN,
-
-        for: {
-            odata (model:CSN, o?:_options) : CSN
-            sql (model:CSN, o?:_options) : CSN
-        },
-        to: {
-            parsed:{
-                csn (files:filename[], o?:_options) : Promise<CSN>
-                csn (model:CDL, o?:_options) : CSN
-            }
-            xtended:{
-                csn (files:filename[], o?:_options) : Promise<CSN>
-                csn (model:CDL, o?:_options) : CSN
-            }
-            inferred:{
-                csn (files:filename[], o?:_options) : Promise<CSN>
-                csn (model:CDL, o?:_options) : CSN
-            }
-            csn (files:filename[], o?:_options) : Promise<CSN>
-            csn (model:CDL, o?:_options) : CSN
-            yml (model:CSN, o?:_options) : YAML
-            yaml (model:CSN, o?:_options) : YAML
-            json (model:CSN, o?:_options) : JSON
-            sql (model:CSN, o?:_options) : SQL[]
-            cdl (model:CSN, o?:_options) : CDL | Iterable<[CDL,{file:filename}]>
-            edm (model:CSN, o?:_options|_odata_options) : EDM | string
-            edmx (model:CSN, o?:_options|_odata_options) : EDMX | Iterable<[EDMX,{file:filename}]>
-            hdbcds (model:CSN, o?:_options) : SQL | Iterable<[SQL,{file:filename}]>
-            hdbtable (model:CSN, o?:_options) : SQL | Iterable<[SQL,{file:filename}]>
-        }
-
-        /** Fluent API variant */
-        (model: CSN | CDL) : {
-            for: {
-                odata (o?:_options) : CSN
-                sql (o?:_options) : CSN
-            },
-            to: {
-                parsed:{ csn (o?:_options) : CSN }
-                xtended:{ csn (o?:_options) : CSN }
-                inferred:{ csn (o?:_options) : CSN }
-                csn (o?:_options) : CSN
-                yml (o?:_options) : YAML
-                yaml (o?:_options) : YAML
-                json (o?:_options) : JSON
-                sql (o?:_options) : SQL[]
-                cdl (o?:_options) : CDL | Iterable<[CDL,{file:filename}]>
-                edm (o?:_options|_odata_options) : EDM | string
-                edmx (o?:_options|_odata_options) : EDMX | Iterable<[EDMX,{file:filename}]>
-                hdbcds (o?:_options) : SQL | Iterable<[SQL,{file:filename}]>
-                hdbtable (o?:_options) : SQL | Iterable<[SQL,{file:filename}]>
-            }
-        }
-
-        /** Async fluent variant reading from files */
-        (files: filename[]) : {
-            for: {
-                odata (o?:_options) : Promise<CSN>
-                sql (o?:_options) : Promise<CSN>
-            },
-            to: {
-                parsed:{ csn (o?:_options) : Promise <CSN> }
-                xtended:{ csn (o?:_options) : Promise <CSN> }
-                inferred:{ csn (o?:_options) : Promise <CSN> }
-                csn (o?:_options) : Promise <CSN>
-                yml (o?:_options) : Promise <YAML>
-                yaml (o?:_options) : Promise <YAML>
-                json (o?:_options) : Promise <JSON>
-                sql (o?:_options) : Promise <SQL[]>
-                cdl (o?:_options) : Promise <CDL | Iterable<[CDL,{file:filename}]>>
-                edm (o?:_options|_odata_options) : Promise <EDM | string>
-                edmx (o?:_options|_odata_options) : Promise <EDMX | Iterable<[EDMX,{file:filename}]>>
-                hdbcds (o?:_options) : Promise <SQL | Iterable<[SQL,{file:filename}]>>
-                hdbtable (o?:_options) : Promise <SQL | Iterable<[SQL,{file:filename}]>>
-            }
-        }
-    }
-
-    /**
-     * Loads and parses models from the specified files.
-     * Uses `cds.resolve` to fetch the respective models.
-     * Essentially a shortcut for `cds.compile.to.csn(files)`
-     * @param {string} files - filenames of models or if folder containing models
-     */
-    get(files: '*' | filename | filename[], o?:_options) : Promise<CSN>
-
-    /**
-     * Shortcut for `cds.get(files, 'inferred')`
-     * @param {string} files - filenames of models or if folder containing models
-     */
-    load(files: '*' | filename | filename[], o?:_options) : Promise<CSN>
-
-    /**
-	 * Emitted whenever a model is loaded using cds.load().
-	 */
-	on (event : 'loaded', listener : (model : CSN) => void) : this
-
-
-    /**
-     * Resolves given file or module name(s) to an array of absolute file names.
-     * Uses Node's `require.resolve` internally with the following additions:
-     * - relative names are resolved relative to the current working directory instead of the current JavaScript module; hence, use __dirname if you want to find or load models relative to the current module.
-     * - if no file extension is given, `.csn` and `.cds` will be appended in that order.
-     * @param files - The file or module name(s) of a model or a folder containing models. Specify `'*'` to fetch moels from default locations, i.e. `[ 'db/', 'srv/', 'app/' ]`
-     * @returns An array of absolute file names or `undefined` if none could be resolved.
-     */
-    resolve (files: '*' | filename | filename[]) : filename[] | undefined
-
-    	/**
-	 * Turns the given plain CSN model into a linked model
-	 * @see [capire](https://cap.cloud.sap/docs/node.js/cds-reflect)
-	 */
-	linked(model: CSN): LinkedCSN
-
-	/**
-	 * Turns the given plain CSN model into a reflected model
-	 * @see [capire](https://cap.cloud.sap/docs/node.js/cds-reflect)
-	 */
-	reflect(model: CSN): LinkedCSN
+/**
+ * The effective CDS model loaded during bootstrapping, which contains all service and entity definitions,
+ * including required services.
+ */
+export const model : LinkedCSN | undefined  // was ?: LinkedCSN
+
+/**
+ * Provides a set of methods to parse a given model, query or expression.
+ * You can also use `cds.parse()` as a shortcut to `cds.parse.cdl()`.
+ */
+export const parse : {
+    /** Shortcut to `cds.parse.cdl()` */
+    (cdl:CDL) : CSN
+    cdl (cdl:CDL) : CSN
+    cql (src:string) : CQN
+    expr (src:string) : expr
+    xpr (src:string) : _xpr
+    ref (src:string) : string[]
+}
 
+/**
+ * Loads and parses models from the specified files.
+ * Uses `cds.resolve` to fetch the respective models.
+ * Essentially a shortcut for `cds.compile.to.csn(files)`
+ * @param files - filenames of models or if folder containing models
+ */
+export function get (files: '*' | filename | filename[], o?:_options): Promise<CSN>
+
+/**
+ * Shortcut for `cds.get(files, 'inferred')`
+ * @param files - filenames of models or if folder containing models
+ */
+export function load (files: '*' | filename | filename[], o?:_options): Promise<CSN>
+
+
+/**
+ * Resolves given file or module name(s) to an array of absolute file names.
+ * Uses Node's `require.resolve` internally with the following additions:
+ * - relative names are resolved relative to the current working directory instead of the current JavaScript module; hence, use __dirname if you want to find or load models relative to the current module.
+ * - if no file extension is given, `.csn` and `.cds` will be appended in that order.
+ * @param files - The file or module name(s) of a model or a folder containing models. Specify `'*'` to fetch moels from default locations, i.e. `[ 'db/', 'srv/', 'app/' ]`
+ * @returns An array of absolute file names or `undefined` if none could be resolved.
+ */
+export function resolve (files: '*' | filename | filename[]): filename[] | undefined
+
+/**
+ * Turns the given plain CSN model into a linked model
+ * @see [capire](https://cap.cloud.sap/docs/node.js/cds-reflect)
+ */
+declare const linked: (model: CSN) => LinkedCSN
+
+/**
+ * Turns the given plain CSN model into a reflected model
+ * @see [capire](https://cap.cloud.sap/docs/node.js/cds-reflect)
+ */
+export const reflect: (model: CSN) => LinkedCSN
+
+/**
+* Provides a set of methods to parse a given model, query or expression.
+* You can also use `cds.compile(csn).to('<output>')` as a fluent variant.
+*/
+export const compile: {
+   /** Shortcut for `cds.compile.to.csn()` */
+   cdl (model:CDL, o?:_options) : CSN,
+
+   for: {
+       odata (model:CSN, o?:_options) : CSN
+       sql (model:CSN, o?:_options) : CSN
+   },
+   to: {
+       parsed:{
+           csn (files:filename[], o?:_options) : Promise<CSN>
+           csn (model:CDL, o?:_options) : CSN
+       }
+       xtended:{
+           csn (files:filename[], o?:_options) : Promise<CSN>
+           csn (model:CDL, o?:_options) : CSN
+       }
+       inferred:{
+           csn (files:filename[], o?:_options) : Promise<CSN>
+           csn (model:CDL, o?:_options) : CSN
+       }
+       csn (files:filename[], o?:_options) : Promise<CSN>
+       csn (model:CDL, o?:_options) : CSN
+       yml (model:CSN, o?:_options) : YAML
+       yaml (model:CSN, o?:_options) : YAML
+       json (model:CSN, o?:_options) : JSON
+       sql (model:CSN, o?:_options) : SQL[]
+       cdl (model:CSN, o?:_options) : CDL | Iterable<[CDL,{file:filename}]>
+       edm (model:CSN, o?:_options|_odata_options) : EDM | string
+       edmx (model:CSN, o?:_options|_odata_options) : EDMX | Iterable<[EDMX,{file:filename}]>
+       hdbcds (model:CSN, o?:_options) : SQL | Iterable<[SQL,{file:filename}]>
+       hdbtable (model:CSN, o?:_options) : SQL | Iterable<[SQL,{file:filename}]>
+   }
+
+   /** Fluent API variant */
+   (model: CSN | CDL) : {
+       for: {
+           odata (o?:_options) : CSN
+           sql (o?:_options) : CSN
+       },
+       to: {
+           parsed:{ csn (o?:_options) : CSN }
+           xtended:{ csn (o?:_options) : CSN }
+           inferred:{ csn (o?:_options) : CSN }
+           csn (o?:_options) : CSN
+           yml (o?:_options) : YAML
+           yaml (o?:_options) : YAML
+           json (o?:_options) : JSON
+           sql (o?:_options) : SQL[]
+           cdl (o?:_options) : CDL | Iterable<[CDL,{file:filename}]>
+           edm (o?:_options|_odata_options) : EDM | string
+           edmx (o?:_options|_odata_options) : EDMX | Iterable<[EDMX,{file:filename}]>
+           hdbcds (o?:_options) : SQL | Iterable<[SQL,{file:filename}]>
+           hdbtable (o?:_options) : SQL | Iterable<[SQL,{file:filename}]>
+       }
+   }
+
+   /** Async fluent variant reading from files */
+   (files: filename[]) : {
+       for: {
+           odata (o?:_options) : Promise<CSN>
+           sql (o?:_options) : Promise<CSN>
+       },
+       to: {
+           parsed:{ csn (o?:_options) : Promise <CSN> }
+           xtended:{ csn (o?:_options) : Promise <CSN> }
+           inferred:{ csn (o?:_options) : Promise <CSN> }
+           csn (o?:_options) : Promise <CSN>
+           yml (o?:_options) : Promise <YAML>
+           yaml (o?:_options) : Promise <YAML>
+           json (o?:_options) : Promise <JSON>
+           sql (o?:_options) : Promise <SQL[]>
+           cdl (o?:_options) : Promise <CDL | Iterable<[CDL,{file:filename}]>>
+           edm (o?:_options|_odata_options) : Promise <EDM | string>
+           edmx (o?:_options|_odata_options) : Promise <EDMX | Iterable<[EDMX,{file:filename}]>>
+           hdbcds (o?:_options) : Promise <SQL | Iterable<[SQL,{file:filename}]>>
+           hdbtable (o?:_options) : Promise <SQL | Iterable<[SQL,{file:filename}]>>
+       }
+   }
 }

package/apis/ql.d.ts

@@ -10,9 +10,6 @@ export class ConstructedQuery {
 	then(_resolved:(x:any)=>any, _rejected:(e:Error)=>any) : any
 }
 
-export class cds_ql {
-	ql:QL<any> & ((context:object) => QL<any>)
-}
 
 export type PK = number | string | object
 

package/apis/server.d.ts

@@ -1,11 +1,12 @@
 import { Service, ServiceImpl } from "./services"
 import { CSN } from "./csn"
 import * as http from "http"
+import * as cds from './cds'
 import { Application } from "express"
 
-export default class cds {
+type _cds = typeof cds
 
-	connect: {
+	export const connect: {
 		/**
 		 * Connects to a specific datasource.
 		 * @see [capire](https://cap.cloud.sap/docs/node.js/cds-connect#cds-connect-to)
@@ -22,29 +23,36 @@ export default class cds {
 		 * Connects the primary datasource.
 		 * @see [capire](https://cap.cloud.sap/docs/node.js/cds-connect)
 		 */
-		(options?: string | cds_connect_options): Promise<typeof cds>  //> cds.connect(<options>)
+                // API extractor cannot handle the direct usages of the cds namespace in typeof cds, so add an indirection.
+		(options?: string | cds_connect_options): Promise<_cds>  //> cds.connect(<options>)
 	}
 
 	/**
 	 * The default bootstrap function as loaded from server.js
 	 */
-	server: Function
+	export const server: Function
 
 	/**
 	 * Constructs service providers from respective service definitions
 	 * @see [capire](https://cap.cloud.sap/docs/node.js/cds-serve)
 	 */
-	serve (service : string, options?: {
+	export const serve: (service : string, options?: {
 		service?: string,
 		from?: '*' | 'all' | string,
 		[key: string]: unknown
-	}) : Promise<cds_services> & cds_serve_fluent
+	}) => Promise<cds_services> & cds_serve_fluent
 
+	/**
+	 * Emitted whenever a model is loaded using cds.load().
+	 */
+	// FIXME: this is actually supposed to be part of models.d.ts
+	// but had to be moved here so export * would not clash their definitions
+	export function on (event : 'loaded', listener : (model : CSN) => void): _cds
 
 	/**
 	 * Emitted whenever a specific service is connected for the first time.
 	 */
-	on(event: 'connect', listener: (srv: Service) => void): this
+	export function on(event: 'connect', listener: (srv: Service) => void):  _cds
 
 
 	/**
@@ -52,53 +60,53 @@ export default class cds {
 	 * express application has been constructed but no middlewares or routes
 	 * added yet.
 	 */
-	on (event : 'bootstrap', listener : (app : Application) => void) : this
-	once (event : 'bootstrap', listener : (app : Application) => void) : this
+	export function on (event : 'bootstrap', listener : (app : Application) => void) : _cds
+	export function once (event : 'bootstrap', listener : (app : Application) => void) :  _cds
 
 	/**
 	 * Emitted for each service served by cds.serve().
 	 */
-	on (event : 'serving', listener : (srv : Service) => void) : this
+	export function on (event : 'serving', listener : (srv : Service) => void) :  _cds
 
 	/**
 	 * Emitted by the default, built-in `server.js` when all services are
 	 * constructed and mounted by cds.serve().
 	 */
-	on   (event : 'served', listener : (all : cds_services) => void) : this
-	once (event : 'served', listener : (all : cds_services) => void) : this
+	export function on   (event : 'served', listener : (all : cds_services) => void) :  _cds
+	export function once (event : 'served', listener : (all : cds_services) => void) :  _cds
 
 	/**
 	 * Emitted by the default, built-in `server.js` when the http server
 	 * is started and listening for incoming requests.
 	 */
-	on   (event : 'listening', listener : (args : { server: http.Server, url:string }) => void) : this
-	once (event : 'listening', listener : (args : { server: http.Server, url:string }) => void) : this
+	export function on   (event : 'listening', listener : (args : { server: http.Server, url:string }) => void) :  _cds
+	export function once (event : 'listening', listener : (args : { server: http.Server, url:string }) => void) :  _cds
 
 	/**
 	 * Emitted by the default, built-in `server.js` when the http server
 	 * is shutdown.
 	 */
-	on (event : 'shutdown', listener : () => void) : this
-	once (event : 'shutdown', listener : () => void) : this
+	export function on (event : 'shutdown', listener : () => void) :  _cds
+	export function once (event : 'shutdown', listener : () => void) :  _cds
 
 	/**
 	 * Dictionary of all services constructed and/or connected.
 	 */
-	services : cds_services
+	export const services : cds_services
 
 	/**
 	 * Shortcut to base class for all service definitions from linked models.
 	 * Plus accessors to impl functions and constructed providers.
 	 */
-	service : service
+	export const service : service
 
   /**
    * Provides a graceful shutdown for running servers, by first emitting `cds.emit('shutdown')`.
    * @see [capire](https://cap.cloud.sap/docs/node.js/cds-facade#cds-exit)
    */
-  exit(): void
+  export function exit(): void
+
 
-}
 
 export type service = {
 	/**
@@ -106,7 +114,7 @@ export type service = {
 	 * Use that in modules to get IntelliSense.
 	 */
 	impl (impl: ServiceImpl) : typeof impl
-	// impl <T> (srv:T, impl: ( this: T, srv: (T) ) => any) : typeof impl
+	// impl <T> (srv:T, impl: (  _cds: T, srv: (T) ) => any) : typeof impl
 
 	/**
 	 * Array of all services constructed.
@@ -118,11 +126,11 @@ export type service = {
 type cds_services = { [name:string]: Service }
 
 interface cds_serve_fluent {
-	from (model : string | CSN) : this
-	to (protocol: string) : this
-	at (path: string) : this
-	in (app: Application) : this
-	with (impl: ServiceImpl | string) : this
+	from (model : string | CSN) :  cds_serve_fluent
+	to (protocol: string) :  cds_serve_fluent
+	at (path: string) :  cds_serve_fluent
+	in (app: Application) :  cds_serve_fluent
+	with (impl: ServiceImpl | string) :  cds_serve_fluent
 	// (req,res) : void
 }
 

package/apis/services.d.ts

@@ -1,10 +1,12 @@
 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'
+
 
 export class QueryAPI {
 
@@ -59,16 +61,6 @@ export class QueryAPI {
     (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)
    */
@@ -82,37 +74,20 @@ export class QueryAPI {
   }
 
   /**
-   * Starts or joins a transaction
-   * @see [docs](https://cap.cloud.sap/docs/node.js/cds-tx)
+   * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#crud-style-api)
    */
+  delete<T>(entity: LinkedDefinition | string, key?: any): DELETE<T>
 
-  tx: {
-    (fn: (tx: Transaction) => {}): Promise<unknown>
-    (context?: object): Transaction
-    (context: object, fn: (tx: Transaction) => {}): Promise<unknown>
-  }
+  /**
+   * @see [docs](https://cap.cloud.sap/docs/node.js/core-services#srv-foreach-entity)
+   */
+  foreach(query: Query, callback: (row: object) => void): this
 
   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)
-   */
-  spawn(options: {
-    [key: string]: any
-    every?: number
-    after?: number
-  }, fn: (tx: Transaction) => {}): SpawnEventEmitter
-
-  /**
-   * @see [docs](https://cap.cloud.sap/docs/node.js/cds-tx#event-contexts
-   */
-  context?: EventContext
-
-  db: DatabaseService
 }
 
 
@@ -131,14 +106,14 @@ export class Service extends QueryAPI {
   )
 
   /**
-   * 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,25 +125,25 @@ 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.
@@ -231,6 +206,9 @@ export class Service extends QueryAPI {
   // The central method to dispatch events
   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>
   on<T extends Constructable>(eve: types.event, entity: T, handler: CRUDEventHandler.On<InstanceType<T>, InstanceType<T> | void | Error>): this
@@ -292,7 +270,7 @@ export default class cds {
 }
 
 
-interface Transaction extends Service {
+export interface Transaction extends Service {
   commit(): Promise<void>
   rollback(): Promise<void>
 }
@@ -389,3 +367,48 @@ declare namespace types {
     | 'COMMIT' | 'ROLLBACK'
   type target = string | LinkedDefinition | LinkedEntity | (string | LinkedDefinition | LinkedEntity)[] | ArrayConstructable<any>
 }
+
+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) => {}): 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) => {}): Promise<unknown>
+  (context?: object): Transaction
+  (context: object, fn: (tx: Transaction) => {}): Promise<unknown>
+}
+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']