@objectql/types 1.2.0 → 1.3.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @objectql/core
 
+## 1.3.1
+
+## 1.3.0
+
+### Minor Changes
+
+- Refactor core architecture: split logic into modules (driver, remote, action, hook, object, plugin).
+  Rename `ObjectRegistry` to `MetadataRegistry` to support generic metadata.
+  Add `addLoader` API to support custom metadata loaders in plugins.
+  Update initialization lifecycle to allow plugins to register loaders before source scanning.
+
 ## 1.2.0
 
 ### Minor Changes

package/dist/app.d.ts

@@ -0,0 +1,22 @@
+import { ObjectConfig } from "./object";
+import { Driver } from "./driver";
+import { MetadataRegistry } from "./registry";
+import { HookName, HookHandler, HookContext } from "./hook";
+import { ActionHandler, ActionContext } from "./action";
+import { LoaderPlugin } from "./loader";
+export interface IObjectQL {
+    getObject(name: string): ObjectConfig | undefined;
+    getConfigs(): Record<string, ObjectConfig>;
+    datasource(name: string): Driver;
+    init(): Promise<void>;
+    addPackage(name: string): void;
+    removePackage(name: string): void;
+    metadata: MetadataRegistry;
+    registerObject(object: ObjectConfig): void;
+    loadFromDirectory(dir: string): void;
+    addLoader(plugin: LoaderPlugin): void;
+    on(event: HookName, objectName: string, handler: HookHandler): void;
+    triggerHook(event: HookName, objectName: string, ctx: HookContext): Promise<void>;
+    registerAction(objectName: string, actionName: string, handler: ActionHandler): void;
+    executeAction(objectName: string, actionName: string, ctx: ActionContext): Promise<any>;
+}

package/dist/app.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":""}

package/dist/config.d.ts

@@ -0,0 +1,36 @@
+import { MetadataRegistry } from "./registry";
+import { Driver } from "./driver";
+import { ObjectConfig } from "./object";
+import { ObjectQLPlugin } from "./plugin";
+export interface ObjectQLConfig {
+    registry?: MetadataRegistry;
+    datasources?: Record<string, Driver>;
+    /**
+     * Optional connection string for auto-configuration.
+     * e.g. "sqlite://dev.db", "postgres://localhost/db", "mongodb://localhost/db"
+     */
+    connection?: string;
+    /**
+     * Path(s) to the directory containing schema files (*.object.yml).
+     */
+    source?: string | string[];
+    objects?: Record<string, ObjectConfig>;
+    /**
+     * @deprecated Use 'presets' instead.
+     */
+    packages?: string[];
+    /**
+     * List of npm packages or presets to load.
+     */
+    presets?: string[];
+    /**
+     * List of plugins to load.
+     * Can be an instance of ObjectQLPlugin or a package name string.
+     */
+    plugins?: (ObjectQLPlugin | string)[];
+    /**
+     * List of remote ObjectQL instances to connect to.
+     * e.g. ["http://user-service:3000", "http://order-service:3000"]
+     */
+    remotes?: string[];
+}

package/dist/config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":""}

package/dist/context.d.ts

@@ -0,0 +1,35 @@
+import { IObjectRepository } from './repository';
+export interface ObjectQLContext {
+    userId?: string;
+    spaceId?: string;
+    roles: string[];
+    /**
+     * Sudo Mode / System Bypass.
+     */
+    isSystem?: boolean;
+    /**
+     * Returns a repository proxy bound to this context.
+     * All operations performed via this proxy inherit userId, spaceId, and transaction.
+     */
+    object(entityName: string): IObjectRepository;
+    /**
+     * Execute a function within a transaction.
+     * The callback receives a new context 'trxCtx' which inherits userId, spaceId from this context.
+     */
+    transaction(callback: (trxCtx: ObjectQLContext) => Promise<any>): Promise<any>;
+    /**
+     * Returns a new context with system privileges (isSystem: true).
+     * It shares the same transaction scope as the current context.
+     */
+    sudo(): ObjectQLContext;
+    /**
+     * Internal: Driver-specific transaction handle.
+     */
+    transactionHandle?: any;
+}
+export interface ObjectQLContextOptions {
+    userId?: string;
+    spaceId?: string;
+    roles?: string[];
+    isSystem?: boolean;
+}

package/dist/context.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,8 +1,13 @@
 export * from './field';
 export * from './object';
-export * from './types';
 export * from './driver';
 export * from './query';
 export * from './registry';
 export * from './hook';
 export * from './action';
+export * from './repository';
+export * from './app';
+export * from './plugin';
+export * from './config';
+export * from './context';
+export * from './loader';

package/dist/index.js

@@ -16,10 +16,15 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./field"), exports);
 __exportStar(require("./object"), exports);
-__exportStar(require("./types"), exports);
 __exportStar(require("./driver"), exports);
 __exportStar(require("./query"), exports);
 __exportStar(require("./registry"), exports);
 __exportStar(require("./hook"), exports);
 __exportStar(require("./action"), exports);
+__exportStar(require("./repository"), exports);
+__exportStar(require("./app"), exports);
+__exportStar(require("./plugin"), exports);
+__exportStar(require("./config"), exports);
+__exportStar(require("./context"), exports);
+__exportStar(require("./loader"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB;AACzB,+CAA6B;AAC7B,wCAAsB;AACtB,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAG1B,2CAAyB"}

package/dist/loader.d.ts

@@ -0,0 +1,14 @@
+import { MetadataRegistry } from './registry';
+export interface LoaderHandlerContext {
+    file: string;
+    content: string;
+    registry: MetadataRegistry;
+    packageName?: string;
+}
+export type LoaderHandler = (ctx: LoaderHandlerContext) => void;
+export interface LoaderPlugin {
+    name: string;
+    glob: string[];
+    handler: LoaderHandler;
+    options?: any;
+}

package/dist/loader.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":""}

package/dist/plugin.d.ts

@@ -0,0 +1,5 @@
+import { IObjectQL } from './app';
+export interface ObjectQLPlugin {
+    name: string;
+    setup(app: IObjectQL): void | Promise<void>;
+}

package/dist/plugin.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":""}

package/dist/registry.d.ts

@@ -5,7 +5,7 @@ export interface Metadata {
     package?: string;
     content: any;
 }
-export declare class ObjectRegistry {
+export declare class MetadataRegistry {
     private store;
     register(type: string, metadata: Metadata): void;
     unregister(type: string, id: string): void;

package/dist/registry.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObjectRegistry = void 0;
-class ObjectRegistry {
+exports.MetadataRegistry = void 0;
+class MetadataRegistry {
     constructor() {
         // Map<type, Map<id, Metadata>>
         this.store = new Map();
@@ -42,5 +42,5 @@ class ObjectRegistry {
         return this.store.get(type)?.get(id);
     }
 }
-exports.ObjectRegistry = ObjectRegistry;
+exports.MetadataRegistry = MetadataRegistry;
 //# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":";;;AAQA,MAAa,cAAc;IAA3B;QACI,+BAA+B;QACvB,UAAK,GAAuC,IAAI,GAAG,EAAE,CAAC;IA2ClE,CAAC;IAzCG,QAAQ,CAAC,IAAY,EAAE,QAAkB;QACrC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,EAAU;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,iBAAiB,CAAC,WAAmB;QACjC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7C,MAAM,eAAe,GAAa,EAAE,CAAC;YAErC,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;gBACrC,IAAI,IAAI,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;oBAC/B,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC7B,CAAC;YACL,CAAC;YAED,+BAA+B;YAC/B,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;gBAC/B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnB,CAAC;QACL,CAAC;IACL,CAAC;IAED,GAAG,CAAU,IAAY,EAAE,EAAU;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,OAAY,CAAC;IACvD,CAAC;IAED,IAAI,CAAU,IAAY;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAY,CAAC,CAAC;IAC7D,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,EAAU;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC;CACJ;AA7CD,wCA6CC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":";;;AAQA,MAAa,gBAAgB;IAA7B;QACI,+BAA+B;QACvB,UAAK,GAAuC,IAAI,GAAG,EAAE,CAAC;IA2ClE,CAAC;IAzCG,QAAQ,CAAC,IAAY,EAAE,QAAkB;QACrC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,EAAU;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,iBAAiB,CAAC,WAAmB;QACjC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7C,MAAM,eAAe,GAAa,EAAE,CAAC;YAErC,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;gBACrC,IAAI,IAAI,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;oBAC/B,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC7B,CAAC;YACL,CAAC;YAED,+BAA+B;YAC/B,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;gBAC/B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnB,CAAC;QACL,CAAC;IACL,CAAC;IAED,GAAG,CAAU,IAAY,EAAE,EAAU;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,OAAY,CAAC;IACvD,CAAC;IAED,IAAI,CAAU,IAAY;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAY,CAAC,CAAC;IAC7D,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,EAAU;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC;CACJ;AA7CD,4CA6CC"}

package/dist/repository.d.ts

@@ -0,0 +1,16 @@
+import { UnifiedQuery } from "./query";
+export interface IObjectRepository {
+    find(query?: UnifiedQuery): Promise<any[]>;
+    findOne(idOrQuery: string | number | UnifiedQuery): Promise<any>;
+    count(filters: any): Promise<number>;
+    create(doc: any): Promise<any>;
+    update(id: string | number, doc: any, options?: any): Promise<any>;
+    delete(id: string | number): Promise<any>;
+    aggregate(query: any): Promise<any>;
+    distinct(field: string, filters?: any): Promise<any[]>;
+    findOneAndUpdate?(filters: any, update: any, options?: any): Promise<any>;
+    createMany(data: any[]): Promise<any>;
+    updateMany(filters: any, data: any): Promise<any>;
+    deleteMany(filters: any): Promise<any>;
+    execute(actionName: string, id: string | number | undefined, params: any): Promise<any>;
+}

package/dist/repository.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=repository.js.map

package/dist/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@objectql/types",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {},
   "scripts": {
     "build": "tsc",
-    "test": "jest"
+    "test": "jest --passWithNoTests"
   }
 }

package/src/app.ts

@@ -0,0 +1,26 @@
+import { ObjectConfig } from "./object";
+import { Driver } from "./driver";
+import { MetadataRegistry } from "./registry";
+import { HookName, HookHandler, HookContext } from "./hook";
+import { ActionHandler, ActionContext } from "./action";
+import { LoaderPlugin } from "./loader";
+
+export interface IObjectQL {
+    getObject(name: string): ObjectConfig | undefined;
+    getConfigs(): Record<string, ObjectConfig>;
+    datasource(name: string): Driver;
+    init(): Promise<void>;
+    addPackage(name: string): void;
+    removePackage(name: string): void;
+    metadata: MetadataRegistry; 
+
+    registerObject(object: ObjectConfig): void;
+    loadFromDirectory(dir: string): void;
+    addLoader(plugin: LoaderPlugin): void;
+
+    on(event: HookName, objectName: string, handler: HookHandler): void;
+    triggerHook(event: HookName, objectName: string, ctx: HookContext): Promise<void>;
+
+    registerAction(objectName: string, actionName: string, handler: ActionHandler): void;
+    executeAction(objectName: string, actionName: string, ctx: ActionContext): Promise<any>;
+}

package/src/config.ts

@@ -0,0 +1,37 @@
+import { MetadataRegistry } from "./registry";
+import { Driver } from "./driver";
+import { ObjectConfig } from "./object";
+import { ObjectQLPlugin } from "./plugin";
+
+export interface ObjectQLConfig {
+    registry?: MetadataRegistry;
+    datasources?: Record<string, Driver>;
+    /**
+     * Optional connection string for auto-configuration.
+     * e.g. "sqlite://dev.db", "postgres://localhost/db", "mongodb://localhost/db"
+     */
+    connection?: string;
+    /**
+     * Path(s) to the directory containing schema files (*.object.yml).
+     */
+    source?: string | string[];
+    objects?: Record<string, ObjectConfig>;
+    /**
+     * @deprecated Use 'presets' instead.
+     */
+    packages?: string[];
+    /**
+     * List of npm packages or presets to load.
+     */
+    presets?: string[];
+    /**
+     * List of plugins to load. 
+     * Can be an instance of ObjectQLPlugin or a package name string.
+     */
+    plugins?: (ObjectQLPlugin | string)[];
+    /**
+     * List of remote ObjectQL instances to connect to.
+     * e.g. ["http://user-service:3000", "http://order-service:3000"]
+     */
+    remotes?: string[];
+}

package/src/context.ts

@@ -0,0 +1,45 @@
+import { IObjectRepository } from './repository';
+
+export interface ObjectQLContext {
+    // === Identity & Isolation ===
+    userId?: string;                        // Current User ID
+    spaceId?: string;                       // Multi-tenancy Isolation (Organization ID)
+    roles: string[];                        // RBAC Roles
+
+    // === Execution Flags ===
+    /**
+     * Sudo Mode / System Bypass.
+     */
+    isSystem?: boolean;
+
+    // === Data Entry Point ===
+    /**
+     * Returns a repository proxy bound to this context.
+     * All operations performed via this proxy inherit userId, spaceId, and transaction.
+     */
+    object(entityName: string): IObjectRepository;
+
+    /**
+     * Execute a function within a transaction.
+     * The callback receives a new context 'trxCtx' which inherits userId, spaceId from this context.
+     */
+    transaction(callback: (trxCtx: ObjectQLContext) => Promise<any>): Promise<any>;
+
+    /**
+     * Returns a new context with system privileges (isSystem: true).
+     * It shares the same transaction scope as the current context.
+     */
+    sudo(): ObjectQLContext;
+
+    /**
+     * Internal: Driver-specific transaction handle.
+     */
+    transactionHandle?: any;
+}
+
+export interface ObjectQLContextOptions {
+    userId?: string;
+    spaceId?: string;
+    roles?: string[];
+    isSystem?: boolean;
+}

package/src/index.ts

@@ -1,10 +1,15 @@
 export * from './field';
 export * from './object';
-export * from './types';
 export * from './driver';
 export * from './query';
 export * from './registry';
 export * from './hook';
 export * from './action';
+export * from './repository';
+export * from './app';
+export * from './plugin';
+export * from './config';
+export * from './context';
 
 
+export * from './loader';

package/src/loader.ts

@@ -0,0 +1,17 @@
+import { MetadataRegistry } from './registry';
+
+export interface LoaderHandlerContext {
+    file: string;
+    content: string;
+    registry: MetadataRegistry;
+    packageName?: string;
+}
+
+export type LoaderHandler = (ctx: LoaderHandlerContext) => void;
+
+export interface LoaderPlugin {
+    name: string;
+    glob: string[];
+    handler: LoaderHandler;
+    options?: any;
+}

package/src/plugin.ts

@@ -0,0 +1,6 @@
+import { IObjectQL } from './app';
+
+export interface ObjectQLPlugin {
+    name: string;
+    setup(app: IObjectQL): void | Promise<void>;
+}

package/src/registry.ts

@@ -6,7 +6,7 @@ export interface Metadata {
     content: any;
 }
 
-export class ObjectRegistry {
+export class MetadataRegistry {
     // Map<type, Map<id, Metadata>>
     private store: Map<string, Map<string, Metadata>> = new Map();
 

package/src/repository.ts

@@ -0,0 +1,17 @@
+import { UnifiedQuery } from "./query";
+
+export interface IObjectRepository {
+    find(query?: UnifiedQuery): Promise<any[]>;
+    findOne(idOrQuery: string | number | UnifiedQuery): Promise<any>;
+    count(filters: any): Promise<number>;
+    create(doc: any): Promise<any>;
+    update(id: string | number, doc: any, options?: any): Promise<any>;
+    delete(id: string | number): Promise<any>;
+    aggregate(query: any): Promise<any>;
+    distinct(field: string, filters?: any): Promise<any[]>;
+    findOneAndUpdate?(filters: any, update: any, options?: any): Promise<any>;
+    createMany(data: any[]): Promise<any>;
+    updateMany(filters: any, data: any): Promise<any>;
+    deleteMany(filters: any): Promise<any>;
+    execute(actionName: string, id: string | number | undefined, params: any): Promise<any>;
+}