esi-cap 1.7.38 → 1.7.40

package/types/lib/impl/index.d.ts

@@ -1,56 +1,151 @@
+export type CDSService = {
+    /**
+     * - Collection of entities served by this service.
+     */
+    entities: Record<string, any>;
+    /**
+     * - Executes a given query against the service.
+     */
+    run: (query: any) => Promise<any>;
+    /**
+     * - Starts a new transaction.
+     */
+    tx: (req: any) => CDSServiceTx;
+    /**
+     * - Alias for the tx method.
+     */
+    transaction: (req: any) => CDSServiceTx;
+    /**
+     * - Registers a handler for specific events.
+     */
+    on: CDSMethod;
+    /**
+     * - Registers a handler to run before the standard logic.
+     */
+    before: CDSMethod;
+    /**
+     * - Registers a handler to run after the standard logic.
+     */
+    after: CDSAfterMethod;
+    /**
+     * - Synchronously or asynchronously triggers an event.
+     */
+    emit: (event: string, data?: any) => Promise<void>;
+    /**
+     * - Sends a custom action or function call to the service.
+     */
+    send: (action: string, params?: any) => Promise<any>;
+    /**
+     * - Deletes records matching the given criteria.
+     */
+    delete: (entity: string, where: any) => Promise<number>;
+};
 /**
- * impl module
+ * Handles 'on' and 'before' event registrations.
+ * Supports both signatures: (event, entities, handler) AND (event, handler).
  */
-export type Service = typeof import("../service").service;
+export type CDSMethod = (event: string | string[], entitiesOrHandler: any | CDSHandler, handler?: CDSHandler) => void;
 /**
- * impl module
+ * Handles 'after' event registrations.
+ * Supports both signatures: (event, entities, handler) AND (event, handler).
  */
+export type CDSAfterMethod = (event: string | string[], entitiesOrHandler: any | CDSAfterHandler, handler?: CDSAfterHandler) => void;
+export type CDSHandler = (req: any) => any | Promise<any>;
+export type CDSAfterHandler = (results: any, req: any) => any | Promise<any>;
+export type CDSServiceTx = CDSService;
+export type ServiceEventInterceptor = (oService: CDSService) => Promise<void>;
+export type Service = typeof import("../service").service;
 export type ServiceEvents = Service["events"];
-/**
- * impl module
- */
 export type ServiceEventsKey = keyof ServiceEvents;
-export type ServiceEventInterceptor = (oService: object) => Promise<void>;
+export type ServieEventsHandler = Partial<Record<ServiceEventsKey, ServiceEventInterceptor>>;
 /**
  * impl module
  * @class
  * @public
- * @typedef {typeof import('../service').service} Service
- * @typedef {Service['events']} ServiceEvents
- * @typedef {keyof ServiceEvents} ServiceEventsKey
+ */
+/**
+ * @typedef {Object} CDSService
+ * @property {Record<string, any>} entities - Collection of entities served by this service.
+ * @property {(query: any) => Promise<any>} run - Executes a given query against the service.
+ * @property {(req: any) => CDSServiceTx} tx - Starts a new transaction.
+ * @property {(req: any) => CDSServiceTx} transaction - Alias for the tx method.
+ * @property {CDSMethod} on - Registers a handler for specific events.
+ * @property {CDSMethod} before - Registers a handler to run before the standard logic.
+ * @property {CDSAfterMethod} after - Registers a handler to run after the standard logic.
+ * @property {(event: string, data?: any) => Promise<void>} emit - Synchronously or asynchronously triggers an event.
+ * @property {(action: string, params?: any) => Promise<any>} send - Sends a custom action or function call to the service.
+ * @property {(entity: string, where: any) => Promise<number>} delete - Deletes records matching the given criteria.
+ */
+/**
+ * Handles 'on' and 'before' event registrations.
+ * Supports both signatures: (event, entities, handler) AND (event, handler).
+ * @callback CDSMethod
+ * @param {string | string[]} event - The name of the event (e.g., 'READ', 'UPDATE').
+ * @param {any | CDSHandler} entitiesOrHandler - Either the target entity/entities or the handler function.
+ * @param {CDSHandler} [handler] - The handler function if an entity was provided as the second argument.
+ * @returns {void}
+ */
+/**
+ * Handles 'after' event registrations.
+ * Supports both signatures: (event, entities, handler) AND (event, handler).
+ * @callback CDSAfterMethod
+ * @param {string | string[]} event - The name of the event.
+ * @param {any | CDSAfterHandler} entitiesOrHandler - Either the target entity or the handler function.
+ * @param {CDSAfterHandler} [handler] - The handler function if an entity was provided.
+ * @returns {void}
+ */
+/**
+ * @callback CDSHandler
+ * @param {any} req - The incoming request object.
+ * @returns {any | Promise<any>}
+ */
+/**
+ * @callback CDSAfterHandler
+ * @param {any} results - The results from the primary execution.
+ * @param {any} req - The incoming request object.
+ * @returns {any | Promise<any>}
+ */
+/**
+ * @typedef {CDSService} CDSServiceTx
  */
 /**
  * @callback ServiceEventInterceptor
- * @param {object} oService - Service object for which request to be executed
+ * @param {CDSService} oService - Service object for which request to be executed
  * @returns {Promise<void>}
  */
+/**
+ * @typedef {typeof import('../service').service} Service
+ * @typedef {Service['events']} ServiceEvents
+ * @typedef {keyof ServiceEvents} ServiceEventsKey
+ * @typedef {Partial<Record<ServiceEventsKey, ServiceEventInterceptor>>} ServieEventsHandler
+ */
 export class impl {
     /**
      * @param {object} oService - Service object for which request to be executed
-     * @param {Partial<Record<ServiceEventsKey, ServiceEventInterceptor>>} oEvent
+     * @param {ServieEventsHandler} oEvent
      * @returns {Promise<void>}
      */
-    static DBService(oService: object, oEvent: Partial<Record<ServiceEventsKey, ServiceEventInterceptor>>): Promise<void>;
+    static DBService(oService: object, oEvent: ServieEventsHandler): Promise<void>;
     /**
      * @param {object} oService - Service object for which request to be executed
      * @param {string} sServiceName - Service Name
-     * @param {Partial<Record<ServiceEventsKey, ServiceEventInterceptor>>} oEvent
+     * @param {ServieEventsHandler} oEvent
      * @param {string|any[]} oLocalEntities
-     * @param {Partial<Record<ServiceEventsKey, ServiceEventInterceptor>>} oRemoteEvent
+     * @param {ServieEventsHandler} oRemoteEvent
      * @param {string|any[]} [oRemoteEntities]
      * @param {any[]} [oRemoteHandlers]
      * @param {boolean} bRefreshUserContext
      * @returns {Promise<void>}
      */
-    static LocalService(oService: object, sServiceName: string, oEvent?: Partial<Record<ServiceEventsKey, ServiceEventInterceptor>>, oLocalEntities?: string | any[], oRemoteEvent?: Partial<Record<ServiceEventsKey, ServiceEventInterceptor>>, oRemoteEntities?: string | any[], oRemoteHandlers?: any[], bRefreshUserContext?: boolean): Promise<void>;
+    static LocalService(oService: object, sServiceName: string, oEvent?: ServieEventsHandler, oLocalEntities?: string | any[], oRemoteEvent?: ServieEventsHandler, oRemoteEntities?: string | any[], oRemoteHandlers?: any[], bRefreshUserContext?: boolean): Promise<void>;
     /**
      * @param {object} oService - Service object for which request to be executed
-     * @param {Partial<Record<ServiceEventsKey, ServiceEventInterceptor>>} oEvent
+     * @param {ServieEventsHandler} oEvent
      * @param {string|any[]} oEntities
      * @param {any[]} [oHandlers]
      * @param {boolean} bRefreshUserContext
      * @returns {Promise<void>}
      */
-    static RemoteService(oService: object, oEvent?: Partial<Record<ServiceEventsKey, ServiceEventInterceptor>>, oEntities?: string | any[], oHandlers?: any[], bRefreshUserContext?: boolean): Promise<void>;
+    static RemoteService(oService: object, oEvent?: ServieEventsHandler, oEntities?: string | any[], oHandlers?: any[], bRefreshUserContext?: boolean): Promise<void>;
 }
 //# sourceMappingURL=index.d.ts.map

package/types/lib/impl/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../.types/lib/impl/index.js"],"names":[],"mappings":";;;sBAmBa,cAAc,YAAY,EAAE,OAAO;;;;4BACnC,OAAO,CAAC,QAAQ,CAAC;;;;+BACjB,MAAM,aAAa;iDAKrB,MAAM,KACJ,OAAO,CAAC,IAAI,CAAC;AAZ1B;;;;;;;GAOG;AAEH;;;;GAIG;AACH;IACI;;;;OAIG;IACH,2BAJW,MAAM,UACN,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAAC,GACxD,OAAO,CAAC,IAAI,CAAC,CAMzB;IAED;;;;;;;;;;OAUG;IACH,8BAVW,MAAM,gBACN,MAAM,WACN,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAAC,mBAC1D,MAAM,GAAC,GAAG,EAAE,iBACZ,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAAC,oBAC1D,MAAM,GAAC,GAAG,EAAE,oBACZ,GAAG,EAAE,wBACL,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CA0BzB;IAED;;;;;;;OAOG;IACH,+BAPW,MAAM,WACN,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAAC,cAC1D,MAAM,GAAC,GAAG,EAAE,cACZ,GAAG,EAAE,wBACL,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CA8EzB;CACJ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../.types/lib/impl/index.js"],"names":[],"mappings":";;;;cAuBc,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;SACnB,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC;;;;QAC5B,CAAC,GAAG,EAAE,GAAG,KAAK,YAAY;;;;iBAC1B,CAAC,GAAG,EAAE,GAAG,KAAK,YAAY;;;;QAC1B,SAAS;;;;YACT,SAAS;;;;WACT,cAAc;;;;UACd,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC;;;;UAC5C,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC;;;;YAC9C,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC;;;;;;gCAOlD,MAAM,GAAG,MAAM,EAAE,qBACjB,GAAG,GAAG,UAAU,YAChB,UAAU,KACR,IAAI;;;;;qCAON,MAAM,GAAG,MAAM,EAAE,qBACjB,GAAG,GAAG,eAAe,YACrB,eAAe,KACb,IAAI;+BAKN,GAAG,KACD,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;wCAKpB,GAAG,OACH,GAAG,KACD,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;2BAIlB,UAAU;iDAKZ,UAAU,KACR,OAAO,CAAC,IAAI,CAAC;sBAIb,cAAc,YAAY,EAAE,OAAO;4BACnC,OAAO,CAAC,QAAQ,CAAC;+BACjB,MAAM,aAAa;kCACnB,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;AAnEvE;;;;GAIG;AAEH;;;;;;;;;;;;GAYG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AAEH;;;;GAIG;AAEH;;;;;GAKG;AAEH;;GAEG;AAEH;;;;GAIG;AAEH;;;;;GAKG;AAEH;IACI;;;;OAIG;IACH,2BAJW,MAAM,UACN,mBAAmB,GACjB,OAAO,CAAC,IAAI,CAAC,CAMzB;IAED;;;;;;;;;;OAUG;IACH,8BAVW,MAAM,gBACN,MAAM,WACN,mBAAmB,mBACnB,MAAM,GAAC,GAAG,EAAE,iBACZ,mBAAmB,oBACnB,MAAM,GAAC,GAAG,EAAE,oBACZ,GAAG,EAAE,wBACL,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CA0BzB;IAED;;;;;;;OAOG;IACH,+BAPW,MAAM,WACN,mBAAmB,cACnB,MAAM,GAAC,GAAG,EAAE,cACZ,GAAG,EAAE,wBACL,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CA8EzB;CACJ"}

package/types/lib/log/index.d.ts

@@ -1,9 +1,18 @@
-export function log(sServiceName?: any): {
-    trace: (oEvent: any, oRequest: any, ...oArgs: any[]) => void;
-    debug: (oEvent: any, oRequest: any, ...oArgs: any[]) => void;
-    info: (oEvent: any, oRequest: any, ...oArgs: any[]) => void;
-    warn: (oEvent: any, oRequest: any, ...oArgs: any[]) => void;
-    error: (oEvent: any, oRequest: any, ...oArgs: any[]) => void;
-    fatal: (oEvent: any, oRequest: any, ...oArgs: any[]) => void;
-};
+declare namespace _exports {
+    export { Service, ServiceEvents, ServiceEventsValue };
+}
+declare namespace _exports {
+    function log(sServiceName?: string | undefined): {
+        trace: (oEvent: ServiceEventsValue, oRequest: object, ...oArgs: any[]) => void;
+        debug: (oEvent: ServiceEventsValue, oRequest: object, ...oArgs: any[]) => void;
+        info: (oEvent: ServiceEventsValue, oRequest: object, ...oArgs: any[]) => void;
+        warn: (oEvent: ServiceEventsValue, oRequest: object, ...oArgs: any[]) => void;
+        error: (oEvent: ServiceEventsValue, oRequest: object, ...oArgs: any[]) => void;
+        fatal: (oEvent: ServiceEventsValue, oRequest: object, ...oArgs: any[]) => void;
+    };
+}
+export = _exports;
+type Service = typeof import("../service").service;
+type ServiceEvents = Service["events"];
+type ServiceEventsValue = ServiceEvents[keyof ServiceEvents];
 //# sourceMappingURL=index.d.ts.map

package/types/lib/log/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../.types/lib/log/index.js"],"names":[],"mappings":"AAMS;;;;;;;EAwBJ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../.types/lib/log/index.js"],"names":[],"mappings":";;;;IAaS,4BAAY,MAAM,GAAC,SAAS;wBAEe,kBAAkB,YAAuB,MAAM;wBAA/C,kBAAkB,YAAuB,MAAM;uBAA/C,kBAAkB,YAAuB,MAAM;uBAA/C,kBAAkB,YAAuB,MAAM;wBAA/C,kBAAkB,YAAuB,MAAM;wBAA/C,kBAAkB,YAAuB,MAAM;MAsB9F;;;eA9BQ,cAAc,YAAY,EAAE,OAAO;qBACnC,OAAO,CAAC,QAAQ,CAAC;0BACjB,aAAa,CAAC,MAAM,aAAa,CAAC"}