@dbos-inc/dbos-sdk 3.0.23-preview → 3.0.29-preview

package/dist/src/decorators.js

@@ -1,56 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DBOSInitializer = exports.OrmEntities = exports.configureInstance = exports.ArgName = exports.getRegistrationsForExternal = exports.associateParameterWithExternal = exports.associateMethodWithExternal = exports.associateMethodWithEventReceiver = exports.associateClassWithExternal = exports.associateClassWithEventReceiver = exports.getOrCreateClassRegistration = exports.getClassRegistrationByName = exports.getAllRegisteredClassNames = exports.getNameForClass = exports.registerAndWrapDBOSFunctionByName = exports.registerAndWrapDBOSFunction = exports.getOrCreateMethodArgsRegistration = exports.getTransactionalDataSource = exports.registerTransactionalDataSource = exports.transactionalDataSources = exports.getConfiguredInstance = exports.getRegisteredOperationsByClassname = exports.getRegisteredOperations = exports.getRegistrationForFunction = exports.registerFunctionWrapper = exports.getRegisteredMethodName = exports.getRegisteredMethodClassName = exports.ensureDBOSIsNotLaunched = exports.recordDBOSShutdown = exports.recordDBOSLaunch = exports.ClassRegistration = exports.ConfiguredInstance = exports.MethodRegistration = exports.DBOS_AUTH = exports.MethodParameter = exports.DBOSDataType = exports.insertAllMiddleware = exports.registerMiddlewareInstaller = exports.getLifecycleListeners = exports.registerLifecycleCallback = exports.DBOSLifecycleCallback = void 0;
+exports.DBOSInitializer = exports.OrmEntities = exports.ArgName = exports.getRegistrationsForExternal = exports.associateParameterWithExternal = exports.associateMethodWithExternal = exports.associateClassWithExternal = exports.getTransactionalDataSource = exports.registerTransactionalDataSource = exports.transactionalDataSources = exports.getConfiguredInstance = exports.getOrCreateClassRegistration = exports.getClassRegistrationByName = exports.getAllRegisteredFunctions = exports.getAllRegisteredClassNames = exports.getNameForClass = exports.registerAndWrapDBOSFunctionByName = exports.registerAndWrapDBOSFunction = exports.getOrCreateMethodArgsRegistration = exports.getRegisteredFunctionsByClassname = exports.getRegisteredOperations = exports.getFunctionRegistrationByName = exports.getFunctionRegistration = exports.registerFunctionWrapper = exports.getRegisteredFunctionName = exports.getRegisteredFunctionClassName = exports.getRegisteredFunctionQualifiedName = exports.getRegisteredFunctionFullName = exports.insertAllMiddleware = exports.registerMiddlewareInstaller = exports.getLifecycleListeners = exports.registerLifecycleCallback = exports.ensureDBOSIsNotLaunched = exports.recordDBOSShutdown = exports.recordDBOSLaunch = exports.ClassRegistration = exports.ConfiguredInstance = exports.MethodRegistration = exports.DBOS_AUTH = exports.MethodParameter = exports.DBOSDataType = void 0;
 require("reflect-metadata");
 const error_1 = require("./error");
-/**
- * Interface for integrating into the DBOS startup/shutdown lifecycle
- */
-class DBOSLifecycleCallback {
-    /** Called back during DBOS launch */
-    initialize() {
-        return Promise.resolve();
-    }
-    /** Called back upon shutdown (usually in tests) to close connections and free resources */
-    destroy() {
-        return Promise.resolve();
-    }
-    /** Called at launch; Implementers should emit a diagnostic list of all registrations */
-    logRegisteredEndpoints() { }
-}
-exports.DBOSLifecycleCallback = DBOSLifecycleCallback;
-const lifecycleListeners = [];
-function registerLifecycleCallback(lcl) {
-    if (!lifecycleListeners.includes(lcl))
-        lifecycleListeners.push(lcl);
-}
-exports.registerLifecycleCallback = registerLifecycleCallback;
-function getLifecycleListeners() {
-    return lifecycleListeners;
-}
-exports.getLifecycleListeners = getLifecycleListeners;
-let installedMiddleware = false;
-const middlewareInstallers = [];
-function registerMiddlewareInstaller(i) {
-    if (installedMiddleware)
-        throw new TypeError('Attempt to provide method middleware after insertion was performed');
-    if (!middlewareInstallers.includes(i))
-        middlewareInstallers.push(i);
-}
-exports.registerMiddlewareInstaller = registerMiddlewareInstaller;
-function insertAllMiddleware() {
-    if (installedMiddleware)
-        return;
-    installedMiddleware = true;
-    for (const [_cn, c] of classesByName) {
-        for (const [_fn, f] of c.reg.registeredOperations) {
-            for (const i of middlewareInstallers) {
-                i.installMiddleware(f);
-            }
-        }
-    }
-}
-exports.insertAllMiddleware = insertAllMiddleware;
 class DBOSDataType {
     dataType = 'text';
     length = -1;
@@ -238,9 +190,6 @@ class MethodParameter {
     }
 }
 exports.MethodParameter = MethodParameter;
-//////////////////////////////////////////
-/* REGISTRATION OBJECTS and read access */
-//////////////////////////////////////////
 exports.DBOS_AUTH = 'auth';
 class MethodRegistration {
     defaults;
@@ -253,11 +202,9 @@ class MethodRegistration {
         this.onEnter.sort((a, b) => a.seqNum - b.seqNum);
     }
     args = [];
-    passContext = false;
-    constructor(origFunc, isInstance, passContext) {
+    constructor(origFunc, isInstance) {
         this.origFunction = origFunc;
         this.isInstance = isInstance;
-        this.passContext = passContext;
     }
     needInitialized = true;
     isInstance;
@@ -269,7 +216,6 @@ class MethodRegistration {
     stepConfig;
     procConfig;
     regLocation;
-    eventReceiverInfo = new Map();
     externalRegInfo = new Map();
     getRegisteredInfo(reg) {
         if (!this.externalRegInfo.has(reg)) {
@@ -338,14 +284,6 @@ class MethodRegistration {
     }
 }
 exports.MethodRegistration = MethodRegistration;
-function registerClassInstance(inst, name) {
-    const creg = getOrCreateClassRegistration(inst.constructor);
-    if (creg.configuredInstances.has(name)) {
-        throw new error_1.DBOSConflictingRegistrationError(`An instance of class '${inst.constructor.name}' with name '${name}' was already registered.  Earlier registration occurred at:\n${(creg.configuredInstanceRegLocs.get(name) ?? []).join('\n')}`);
-    }
-    creg.configuredInstances.set(name, inst);
-    creg.configuredInstanceRegLocs.set(name, new StackGrabber().getCleanStack(3) ?? []);
-}
 class ConfiguredInstance {
     name;
     constructor(name) {
@@ -372,7 +310,6 @@ class ClassRegistration {
     registeredOperations = new Map();
     configuredInstances = new Map();
     configuredInstanceRegLocs = new Map();
-    eventReceiverInfo = new Map();
     externalRegInfo = new Map();
     getRegisteredInfo(reg) {
         if (!this.externalRegInfo.has(reg)) {
@@ -383,6 +320,8 @@ class ClassRegistration {
     constructor() { }
 }
 exports.ClassRegistration = ClassRegistration;
+// #endregion
+// #region Global registration structures and functions
 class StackGrabber extends Error {
     constructor() {
         super('StackGrabber');
@@ -395,6 +334,7 @@ class StackGrabber extends Error {
             .map((l) => '>>> ' + l.replace(/^\s*at\s*/, '')); // Remove the first lines
     }
 }
+// Track if DBOS is launched, and if so, from where
 let dbosLaunchPoint = undefined;
 function recordDBOSLaunch() {
     dbosLaunchPoint = new StackGrabber().getCleanStack(2); // Remove one for record, one for registerAndWrap...
@@ -410,32 +350,94 @@ function ensureDBOSIsNotLaunched() {
     }
 }
 exports.ensureDBOSIsNotLaunched = ensureDBOSIsNotLaunched;
-// This is a bit ugly, if we got the class / instance it would help avoid this auxiliary structure
-const methodToRegistration = new Map();
-function getRegisteredMethodClassName(func) {
-    let rv = '';
-    if (methodToRegistration.has(func)) {
-        rv = methodToRegistration.get(func).className;
+// DBOS launch lifecycle listener
+const lifecycleListeners = [];
+function registerLifecycleCallback(lcl) {
+    if (!lifecycleListeners.includes(lcl))
+        lifecycleListeners.push(lcl);
+}
+exports.registerLifecycleCallback = registerLifecycleCallback;
+function getLifecycleListeners() {
+    return lifecycleListeners;
+}
+exports.getLifecycleListeners = getLifecycleListeners;
+// Middleware installers - insert middleware in registered functions prior to launch
+let installedMiddleware = false;
+const middlewareInstallers = [];
+function registerMiddlewareInstaller(i) {
+    if (installedMiddleware)
+        throw new TypeError('Attempt to provide method middleware after insertion was performed');
+    if (!middlewareInstallers.includes(i))
+        middlewareInstallers.push(i);
+}
+exports.registerMiddlewareInstaller = registerMiddlewareInstaller;
+function insertAllMiddleware() {
+    if (installedMiddleware)
+        return;
+    installedMiddleware = true;
+    for (const [_cn, c] of classesByName) {
+        for (const [_fn, f] of c.reg.registeredOperations) {
+            for (const i of middlewareInstallers) {
+                i.installMiddleware(f);
+            }
+        }
+    }
+}
+exports.insertAllMiddleware = insertAllMiddleware;
+// Registration of functions, and classes
+const functionToRegistration = new Map();
+// Registration of instance, by constructor+name
+function registerClassInstance(inst, instname) {
+    const creg = getOrCreateClassRegistration(inst.constructor);
+    if (creg.configuredInstances.has(instname)) {
+        throw new error_1.DBOSConflictingRegistrationError(`An instance of class '${inst.constructor.name}' with name '${instname}' was already registered.  Earlier registration occurred at:\n${(creg.configuredInstanceRegLocs.get(instname) ?? []).join('\n')}`);
     }
-    return rv;
+    creg.configuredInstances.set(instname, inst);
+    creg.configuredInstanceRegLocs.set(instname, new StackGrabber().getCleanStack(3) ?? []);
 }
-exports.getRegisteredMethodClassName = getRegisteredMethodClassName;
-function getRegisteredMethodName(func) {
-    let rv = '';
-    if (methodToRegistration.has(func)) {
-        rv = methodToRegistration.get(func).name;
+function getRegisteredFunctionFullName(func) {
+    let className = '';
+    let funcName = func.name ?? '';
+    if (functionToRegistration.has(func)) {
+        const fr = functionToRegistration.get(func);
+        className = fr.className;
+        funcName = fr.name;
     }
-    return rv;
+    return { className, name: funcName };
+}
+exports.getRegisteredFunctionFullName = getRegisteredFunctionFullName;
+function getRegisteredFunctionQualifiedName(func) {
+    const fn = getRegisteredFunctionFullName(func);
+    return fn.className + '.' + fn.name;
+}
+exports.getRegisteredFunctionQualifiedName = getRegisteredFunctionQualifiedName;
+function getRegisteredFunctionClassName(func) {
+    return getRegisteredFunctionFullName(func).className;
 }
-exports.getRegisteredMethodName = getRegisteredMethodName;
+exports.getRegisteredFunctionClassName = getRegisteredFunctionClassName;
+function getRegisteredFunctionName(func) {
+    return getRegisteredFunctionFullName(func).name;
+}
+exports.getRegisteredFunctionName = getRegisteredFunctionName;
 function registerFunctionWrapper(func, reg) {
-    methodToRegistration.set(func, reg);
+    reg.wrappedFunction = func;
+    functionToRegistration.set(func, reg);
 }
 exports.registerFunctionWrapper = registerFunctionWrapper;
-function getRegistrationForFunction(func) {
-    return methodToRegistration.get(func);
+function getFunctionRegistration(func) {
+    return functionToRegistration.get(func);
+}
+exports.getFunctionRegistration = getFunctionRegistration;
+function getFunctionRegistrationByName(className, name) {
+    const clsreg = getClassRegistrationByName(className, false);
+    if (!clsreg)
+        return undefined;
+    const methReg = clsreg.registeredOperations.get(name);
+    if (!methReg)
+        return undefined;
+    return methReg;
 }
-exports.getRegistrationForFunction = getRegistrationForFunction;
+exports.getFunctionRegistrationByName = getFunctionRegistrationByName;
 function getRegisteredOperations(target) {
     const registeredOperations = [];
     if (typeof target === 'function') {
@@ -456,57 +458,23 @@ function getRegisteredOperations(target) {
     return registeredOperations;
 }
 exports.getRegisteredOperations = getRegisteredOperations;
-function getRegisteredOperationsByClassname(target) {
+function getRegisteredFunctionsByClassname(target) {
     const registeredOperations = [];
     const cls = getClassRegistrationByName(target);
-    cls.registeredOperations?.forEach((m) => registeredOperations.push(m));
+    cls?.registeredOperations?.forEach((m) => registeredOperations.push(m));
     return registeredOperations;
 }
-exports.getRegisteredOperationsByClassname = getRegisteredOperationsByClassname;
-function getConfiguredInstance(clsname, cfgname) {
-    const classReg = classesByName.get(clsname)?.reg;
-    if (!classReg)
-        return null;
-    return classReg.configuredInstances.get(cfgname) ?? null;
-}
-exports.getConfiguredInstance = getConfiguredInstance;
-/////
-// Transactional data source registration
-/////
-exports.transactionalDataSources = new Map();
-// Register data source (user version)
-function registerTransactionalDataSource(name, ds) {
-    if (exports.transactionalDataSources.has(name)) {
-        if (exports.transactionalDataSources.get(name) !== ds) {
-            throw new error_1.DBOSConflictingRegistrationError(`Data source with name ${name} is already registered`);
-        }
-        return;
-    }
-    ensureDBOSIsNotLaunched();
-    exports.transactionalDataSources.set(name, ds);
-}
-exports.registerTransactionalDataSource = registerTransactionalDataSource;
-function getTransactionalDataSource(name) {
-    if (exports.transactionalDataSources.has(name))
-        return exports.transactionalDataSources.get(name);
-    throw new error_1.DBOSNotRegisteredError(name, `Data source '${name}' is not registered`);
-}
-exports.getTransactionalDataSource = getTransactionalDataSource;
-////////////////////////////////////////////////////////////////////////////////
-// DECORATOR REGISTRATION
-// These manage registration objects, creating them at decorator evaluation time
-// and making wrapped methods available for function registration at runtime
-// initialization time.
-////////////////////////////////////////////////////////////////////////////////
+exports.getRegisteredFunctionsByClassname = getRegisteredFunctionsByClassname;
 const methodArgsByFunction = new Map();
-function getOrCreateMethodArgsRegistration(target, className, funcName, func) {
+function getOrCreateMethodArgsRegistration(target, funcName, origFunc) {
     let regtarget = target;
     if (regtarget && typeof regtarget !== 'function') {
         regtarget = regtarget.constructor;
     }
-    className = className ?? (target ? getNameForClass(target) : '');
-    const mkey = className + '|' + funcName.toString();
-    let mParameters = methodArgsByFunction.get(mkey);
+    if (!origFunc) {
+        origFunc = Object.getOwnPropertyDescriptor(target, funcName).value;
+    }
+    let mParameters = methodArgsByFunction.get(origFunc);
     if (mParameters === undefined) {
         // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
         let designParamTypes = undefined;
@@ -518,8 +486,8 @@ function getOrCreateMethodArgsRegistration(target, className, funcName, func) {
             mParameters = designParamTypes.map((value, index) => new MethodParameter(index, value));
         }
         else {
-            if (func) {
-                const argnames = getArgNames(func);
+            if (origFunc) {
+                const argnames = getArgNames(origFunc);
                 mParameters = argnames.map((_value, index) => new MethodParameter(index));
             }
             else {
@@ -529,12 +497,12 @@ function getOrCreateMethodArgsRegistration(target, className, funcName, func) {
                 mParameters = argnames.map((_value, index) => new MethodParameter(index));
             }
         }
-        methodArgsByFunction.set(mkey, mParameters);
+        methodArgsByFunction.set(origFunc, mParameters);
     }
     return mParameters;
 }
 exports.getOrCreateMethodArgsRegistration = getOrCreateMethodArgsRegistration;
-function getOrCreateMethodRegistration(target, className, propertyKey, func, passContext) {
+function getOrCreateMethodRegistration(target, className, propertyKey, func) {
     let regtarget = undefined;
     let isInstance = false;
     if (target) {
@@ -558,21 +526,15 @@ function getOrCreateMethodRegistration(target, className, propertyKey, func, pas
     const classReg = getClassRegistrationByName(className, true);
     const fname = propertyKey.toString();
     if (!classReg.registeredOperations.has(fname)) {
-        classReg.registeredOperations.set(fname, new MethodRegistration(func, isInstance, passContext));
+        classReg.registeredOperations.set(fname, new MethodRegistration(func, isInstance));
     }
     const methReg = classReg.registeredOperations.get(fname);
-    // Note: We cannot tell if the method takes a context or not.
-    //  Our @Workflow, @Transaction, and @Step decorators are the only ones that would know to set passContext.
-    // So, if passContext is indicated, add it to the registration.
-    if (passContext && !methReg.passContext) {
-        methReg.passContext = true;
-    }
     if (methReg.needInitialized) {
         methReg.needInitialized = false;
         methReg.name = fname;
         methReg.className = classReg.name;
         methReg.defaults = classReg;
-        methReg.args = getOrCreateMethodArgsRegistration(target, className, propertyKey, func);
+        methReg.args = getOrCreateMethodArgsRegistration(target, propertyKey, func);
         const argNames = getArgNames(func);
         methReg.args.forEach((e) => {
             if (!e.name) {
@@ -592,8 +554,8 @@ function getOrCreateMethodRegistration(target, className, propertyKey, func, pas
             value: methReg.name,
         });
         methReg.registeredFunction = wrappedMethod;
-        methodToRegistration.set(methReg.registeredFunction, methReg);
-        methodToRegistration.set(methReg.origFunction, methReg);
+        functionToRegistration.set(methReg.registeredFunction, methReg);
+        functionToRegistration.set(methReg.origFunction, methReg);
     }
     return methReg;
 }
@@ -602,14 +564,15 @@ function registerAndWrapDBOSFunction(target, propertyKey, descriptor) {
     if (!descriptor.value) {
         throw Error('Use of decorator when original method is undefined');
     }
-    const registration = getOrCreateMethodRegistration(target, undefined, propertyKey, descriptor.value, false);
+    const registration = getOrCreateMethodRegistration(target, undefined, propertyKey, descriptor.value);
     descriptor.value = registration.wrappedFunction ?? registration.registeredFunction;
     return { descriptor, registration };
 }
 exports.registerAndWrapDBOSFunction = registerAndWrapDBOSFunction;
 function registerAndWrapDBOSFunctionByName(target, className, funcName, func) {
     ensureDBOSIsNotLaunched();
-    const registration = getOrCreateMethodRegistration(target, className, funcName, func, false);
+    const freg = getFunctionRegistration(func);
+    const registration = freg ?? getOrCreateMethodRegistration(target, className, funcName, func);
     return { registration };
 }
 exports.registerAndWrapDBOSFunctionByName = registerAndWrapDBOSFunctionByName;
@@ -638,6 +601,18 @@ function getAllRegisteredClassNames() {
     return cnames;
 }
 exports.getAllRegisteredClassNames = getAllRegisteredClassNames;
+function getAllRegisteredFunctions() {
+    const s = new Set();
+    const fregs = [];
+    for (const [_f, reg] of functionToRegistration) {
+        if (s.has(reg))
+            continue;
+        fregs.push(reg);
+        s.add(reg);
+    }
+    return fregs;
+}
+exports.getAllRegisteredFunctions = getAllRegisteredFunctions;
 function getClassRegistrationByName(name, create = false) {
     if (!classesByName.has(name) && !create) {
         throw new error_1.DBOSNotRegisteredError(name, `Class '${name}' is not registered`);
@@ -666,48 +641,42 @@ function getOrCreateClassRegistration(ctor) {
     return clsReg;
 }
 exports.getOrCreateClassRegistration = getOrCreateClassRegistration;
-/**
- * Associates a class with a `DBOSEventReceiver`, which will be calling the class's DBOS methods.
- * Allows class-level default values or other storage to be associated with the class, rather than
- *   separately for each registered method.
- *
- * @param rcvr - Event receiver which will dispatch DBOS methods from the class specified by `ctor`
- * @param ctor - Constructor of the class that is being registered and associated with `rcvr`
- * @returns - Class-specific registration info cumulatively collected for `rcvr`
- */
-function associateClassWithEventReceiver(rcvr, ctor) {
-    const clsReg = getOrCreateClassRegistration(ctor);
-    if (!clsReg.eventReceiverInfo.has(rcvr)) {
-        clsReg.eventReceiverInfo.set(rcvr, {});
+function getConfiguredInstance(clsname, cfgname) {
+    const classReg = classesByName.get(clsname)?.reg;
+    if (!classReg)
+        return null;
+    return classReg.configuredInstances.get(cfgname) ?? null;
+}
+exports.getConfiguredInstance = getConfiguredInstance;
+// #endregion
+// #region Transactional data source registration
+exports.transactionalDataSources = new Map();
+// Register data source (user version)
+function registerTransactionalDataSource(name, ds) {
+    if (exports.transactionalDataSources.has(name)) {
+        if (exports.transactionalDataSources.get(name) !== ds) {
+            throw new error_1.DBOSConflictingRegistrationError(`Data source with name ${name} is already registered`);
+        }
+        return;
     }
-    return clsReg.eventReceiverInfo.get(rcvr);
+    ensureDBOSIsNotLaunched();
+    exports.transactionalDataSources.set(name, ds);
+}
+exports.registerTransactionalDataSource = registerTransactionalDataSource;
+function getTransactionalDataSource(name) {
+    if (exports.transactionalDataSources.has(name))
+        return exports.transactionalDataSources.get(name);
+    throw new error_1.DBOSNotRegisteredError(name, `Data source '${name}' is not registered`);
 }
-exports.associateClassWithEventReceiver = associateClassWithEventReceiver;
+exports.getTransactionalDataSource = getTransactionalDataSource;
+// #endregion
+// #region External (event receiver v3)
 function associateClassWithExternal(external, cls) {
     const clsn = typeof cls === 'string' ? cls : getNameForClass(cls);
     const clsreg = getClassRegistrationByName(clsn, true);
     return clsreg.getRegisteredInfo(external);
 }
 exports.associateClassWithExternal = associateClassWithExternal;
-/**
- * Associates a workflow method with a `DBOSEventReceiver` which will be in charge of calling the method
- *   in response to received events.
- * This version is to be used in "Stage 2" decorators, as it applies the DBOS wrapper to the registered method.
- *
- * @param rcvr - `DBOSEventReceiver` instance that should be informed of the `target` method's registration
- * @param target - A DBOS method to associate with the event receiver
- * @param propertyKey - For Stage 2 decorator use, this is the property key used for replacing the method with its wrapper
- * @param inDescriptor - For Stage 2 decorator use, this is the method descriptor used for replacing the method with its wrapper
- * @returns The new method descriptor, registration, and event receiver info
- */
-function associateMethodWithEventReceiver(rcvr, target, propertyKey, inDescriptor) {
-    const { descriptor, registration } = registerAndWrapDBOSFunction(target, propertyKey, inDescriptor);
-    if (!registration.eventReceiverInfo.has(rcvr)) {
-        registration.eventReceiverInfo.set(rcvr, {});
-    }
-    return { descriptor, registration, receiverInfo: registration.eventReceiverInfo.get(rcvr) };
-}
-exports.associateMethodWithEventReceiver = associateMethodWithEventReceiver;
 /*
  * Associates a DBOS function or method with an external class or object.
  *   Likely, this will be invoking or intercepting the method.
@@ -721,7 +690,7 @@ function associateMethodWithExternal(external, target, className, funcName, func
 }
 exports.associateMethodWithExternal = associateMethodWithExternal;
 /*
- * Associates a DBOS function or method with an external class or object.
+ * Associates a DBOS function or method parameters with an external class or object.
  *   Likely, this will be invoking or intercepting the method.
  */
 function associateParameterWithExternal(external, target, className, funcName, func, paramId) {
@@ -745,7 +714,7 @@ function associateParameterWithExternal(external, target, className, funcName, f
 }
 exports.associateParameterWithExternal = associateParameterWithExternal;
 function getRegistrationsForExternal(external, cls, funcName) {
-    const res = [];
+    const res = new Array();
     if (cls) {
         const clsname = typeof cls === 'string' ? cls : getNameForClass(cls);
         const c = classesByName.get(clsname);
@@ -792,26 +761,18 @@ function getRegistrationsForExternal(external, cls, funcName) {
     }
 }
 exports.getRegistrationsForExternal = getRegistrationsForExternal;
-//////////////////////////
-/* PARAMETER DECORATORS */
-//////////////////////////
+// #endregion
+// #region Parameter decorators
 function ArgName(name) {
     return function (target, propertyKey, parameterIndex) {
-        const existingParameters = getOrCreateMethodArgsRegistration(target, undefined, propertyKey);
+        const existingParameters = getOrCreateMethodArgsRegistration(target, propertyKey);
         const curParam = existingParameters[parameterIndex];
         curParam.name = name;
     };
 }
 exports.ArgName = ArgName;
-///////////////////////
-/* CLASS DECORATORS */
-///////////////////////
-/** @deprecated Use `new` */
-function configureInstance(cls, name, ...args) {
-    const inst = new cls(name, ...args);
-    return inst;
-}
-exports.configureInstance = configureInstance;
+// #endregion
+// #region Class decorators
 /**
  * @deprecated Use ORM DSs
  */
@@ -824,6 +785,8 @@ function OrmEntities(entities = []) {
     return clsdec;
 }
 exports.OrmEntities = OrmEntities;
+// #endregion
+// #region Method decorators
 function DBOSInitializer() {
     function decorator(target, propertyKey, inDescriptor) {
         const { descriptor, registration } = registerAndWrapDBOSFunction(target, propertyKey, inDescriptor);
@@ -833,4 +796,5 @@ function DBOSInitializer() {
     return decorator;
 }
 exports.DBOSInitializer = DBOSInitializer;
+// #endregion
 //# sourceMappingURL=decorators.js.map