@dbos-inc/koa-serve 2.11.6-preview.gcb74958171

package/README.md

@@ -0,0 +1 @@
+# DBOS HTTP Integration

package/dist/src/dboshttp.d.ts

@@ -0,0 +1,76 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node/http" />
+import { IncomingHttpHeaders } from 'http';
+import { ParsedUrlQuery } from 'querystring';
+import { DBOSLifecycleCallback, MethodParameter } from '@dbos-inc/dbos-sdk';
+export declare enum APITypes {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    PATCH = "PATCH",
+    DELETE = "DELETE"
+}
+export declare enum ArgSources {
+    AUTO = "AUTO",// Look both places
+    DEFAULT = "DEFAULT",// Look in the standard place for the method
+    BODY = "BODY",// Look in body only
+    QUERY = "QUERY"
+}
+export interface DBOSHTTPAuthReturn {
+    authenticatedUser: string;
+    authenticatedRoles: string[];
+}
+export interface DBOSHTTPReg {
+    apiURL: string;
+    apiType: APITypes;
+}
+export interface DBOSHTTPMethodInfo {
+    registrations?: DBOSHTTPReg[];
+}
+export interface DBOSHTTPArgInfo {
+    argSource?: ArgSources;
+}
+/**
+ * HTTPRequest includes useful information from http.IncomingMessage and parsed body,
+ *   URL parameters, and parsed query string.
+ * In essence, it is the serializable part of the request.
+ */
+export interface DBOSHTTPRequest {
+    readonly headers?: IncomingHttpHeaders;
+    readonly rawHeaders?: string[];
+    readonly params?: unknown;
+    readonly body?: unknown;
+    readonly rawBody?: string;
+    readonly query?: ParsedUrlQuery;
+    readonly querystring?: string;
+    readonly url?: string;
+    readonly method?: string;
+    readonly ip?: string;
+    readonly requestID?: string;
+}
+export declare const DBOSHTTP = "dboshttp";
+export declare const WorkflowIDHeader = "dbos-idempotency-key";
+export declare const RequestIDHeader = "X-Request-ID";
+export declare function getOrGenerateRequestID(headers: IncomingHttpHeaders): string;
+export declare function isClientRequestError(e: Error): boolean;
+export declare class DBOSHTTPBase extends DBOSLifecycleCallback {
+    static HTTP_OPERATION_TYPE: string;
+    static get httpRequest(): DBOSHTTPRequest;
+    httpApiDec(verb: APITypes, url: string): <This, Args extends unknown[], Return>(target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>) => TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>;
+    /** Decorator indicating that the method is the target of HTTP GET operations for `url` */
+    getApi(url: string): <This, Args extends unknown[], Return>(target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>) => TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>;
+    /** Decorator indicating that the method is the target of HTTP POST operations for `url` */
+    postApi(url: string): <This, Args extends unknown[], Return>(target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>) => TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>;
+    /** Decorator indicating that the method is the target of HTTP PUT operations for `url` */
+    putApi(url: string): <This, Args extends unknown[], Return>(target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>) => TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>;
+    /** Decorator indicating that the method is the target of HTTP PATCH operations for `url` */
+    patchApi(url: string): <This, Args extends unknown[], Return>(target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>) => TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>;
+    /** Decorator indicating that the method is the target of HTTP DELETE operations for `url` */
+    deleteApi(url: string): <This, Args extends unknown[], Return>(target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>) => TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>;
+    /** Parameter decorator indicating which source to use (URL, BODY, etc) for arg data */
+    argSource(source: ArgSources): (target: object, propertyKey: string | symbol, parameterIndex: number) => void;
+    getArgSource(arg: MethodParameter): ArgSources;
+    logRegisteredEndpoints(): void;
+}
+//# sourceMappingURL=dboshttp.d.ts.map

package/dist/src/dboshttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dboshttp.d.ts","sourceRoot":"","sources":["../../src/dboshttp.ts"],"names":[],"mappings":";;;AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAEL,qBAAqB,EAErB,eAAe,EAEhB,MAAM,oBAAoB,CAAC;AAE5B,oBAAY,QAAQ;IAClB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,oBAAY,UAAU;IACpB,IAAI,SAAS,CAAE,mBAAmB;IAClC,OAAO,YAAY,CAAE,4CAA4C;IACjE,IAAI,SAAS,CAAE,oBAAoB;IACnC,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,QAAQ,aAAa,CAAC;AAEnC,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAC9C,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAQ3E;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,WAE5C;AAED,qBAAa,YAAa,SAAQ,qBAAqB;IACrD,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAU;IAE5C,MAAM,KAAK,WAAW,IAAI,eAAe,CAMxC;IAED,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,kDAI1B,MAAM,eACD,MAAM,cACP,wBAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,QAAQ,MAAM,CAAC,CAAC,oCAAxC,IAAI,WAAW,IAAI,KAAK,QAAQ,MAAM,CAAC;IAkBtF,0FAA0F;IAC1F,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB,2FAA2F;IAC3F,OAAO,CAAC,GAAG,EAAE,MAAM;IAInB,0FAA0F;IAC1F,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB,4FAA4F;IAC5F,QAAQ,CAAC,GAAG,EAAE,MAAM;IAIpB,6FAA6F;IAC7F,SAAS,CAAC,GAAG,EAAE,MAAM;IAIrB,uFAAuF;IACvF,SAAS,CAAC,MAAM,EAAE,UAAU,YACD,MAAM,eAAe,MAAM,GAAG,MAAM,kBAAkB,MAAM;IAgBvF,YAAY,CAAC,GAAG,EAAE,eAAe;IAKxB,sBAAsB,IAAI,IAAI;CAkBxC"}

package/dist/src/dboshttp.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DBOSHTTPBase = exports.isClientRequestError = exports.getOrGenerateRequestID = exports.RequestIDHeader = exports.WorkflowIDHeader = exports.DBOSHTTP = exports.ArgSources = exports.APITypes = void 0;
+const node_crypto_1 = require("node:crypto");
+const dbos_sdk_1 = require("@dbos-inc/dbos-sdk");
+var APITypes;
+(function (APITypes) {
+    APITypes["GET"] = "GET";
+    APITypes["POST"] = "POST";
+    APITypes["PUT"] = "PUT";
+    APITypes["PATCH"] = "PATCH";
+    APITypes["DELETE"] = "DELETE";
+})(APITypes || (exports.APITypes = APITypes = {}));
+var ArgSources;
+(function (ArgSources) {
+    ArgSources["AUTO"] = "AUTO";
+    ArgSources["DEFAULT"] = "DEFAULT";
+    ArgSources["BODY"] = "BODY";
+    ArgSources["QUERY"] = "QUERY";
+})(ArgSources || (exports.ArgSources = ArgSources = {}));
+exports.DBOSHTTP = 'dboshttp';
+exports.WorkflowIDHeader = 'dbos-idempotency-key';
+exports.RequestIDHeader = 'X-Request-ID';
+function getOrGenerateRequestID(headers) {
+    const reqID = headers[exports.RequestIDHeader.toLowerCase()]; // RequestIDHeader is expected to be a single value, so we dismiss the possible string[] returned type.
+    if (reqID) {
+        return reqID;
+    }
+    const newID = (0, node_crypto_1.randomUUID)();
+    headers[exports.RequestIDHeader.toLowerCase()] = newID; // This does not carry through the response
+    return newID;
+}
+exports.getOrGenerateRequestID = getOrGenerateRequestID;
+function isClientRequestError(e) {
+    return dbos_sdk_1.Error.isDataValidationError(e);
+}
+exports.isClientRequestError = isClientRequestError;
+class DBOSHTTPBase extends dbos_sdk_1.DBOSLifecycleCallback {
+    static HTTP_OPERATION_TYPE = 'http';
+    static get httpRequest() {
+        const req = dbos_sdk_1.DBOS.requestObject();
+        if (req === undefined) {
+            throw new TypeError('`DBOSHTTP.httpRequest` accessed from outside of HTTP requests');
+        }
+        return req;
+    }
+    httpApiDec(verb, url) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const er = this;
+        return function apidec(target, propertyKey, descriptor) {
+            const { registration, regInfo } = dbos_sdk_1.DBOS.associateFunctionWithInfo(er, descriptor.value, {
+                classOrInst: target,
+                name: propertyKey,
+            });
+            const handlerRegistration = regInfo;
+            if (!handlerRegistration.registrations)
+                handlerRegistration.registrations = [];
+            handlerRegistration.registrations.push({
+                apiURL: url,
+                apiType: verb,
+            });
+            (0, dbos_sdk_1.requestArgValidation)(registration);
+            return descriptor;
+        };
+    }
+    /** Decorator indicating that the method is the target of HTTP GET operations for `url` */
+    getApi(url) {
+        return this.httpApiDec(APITypes.GET, url);
+    }
+    /** Decorator indicating that the method is the target of HTTP POST operations for `url` */
+    postApi(url) {
+        return this.httpApiDec(APITypes.POST, url);
+    }
+    /** Decorator indicating that the method is the target of HTTP PUT operations for `url` */
+    putApi(url) {
+        return this.httpApiDec(APITypes.PUT, url);
+    }
+    /** Decorator indicating that the method is the target of HTTP PATCH operations for `url` */
+    patchApi(url) {
+        return this.httpApiDec(APITypes.PATCH, url);
+    }
+    /** Decorator indicating that the method is the target of HTTP DELETE operations for `url` */
+    deleteApi(url) {
+        return this.httpApiDec(APITypes.DELETE, url);
+    }
+    /** Parameter decorator indicating which source to use (URL, BODY, etc) for arg data */
+    argSource(source) {
+        return function (target, propertyKey, parameterIndex) {
+            const curParam = dbos_sdk_1.DBOS.associateParamWithInfo(exports.DBOSHTTP, 
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+            Object.getOwnPropertyDescriptor(target, propertyKey).value, {
+                classOrInst: target,
+                name: propertyKey.toString(),
+                param: parameterIndex,
+            });
+            curParam.argSource = source;
+        };
+    }
+    getArgSource(arg) {
+        const arginfo = arg.getRegisteredInfo(exports.DBOSHTTP);
+        return arginfo?.argSource ?? ArgSources.AUTO;
+    }
+    logRegisteredEndpoints() {
+        dbos_sdk_1.DBOS.logger.info('HTTP endpoints supported:');
+        const eps = dbos_sdk_1.DBOS.getAssociatedInfo(this);
+        for (const e of eps) {
+            const { methodConfig, methodReg } = e;
+            const httpmethod = methodConfig;
+            for (const ro of httpmethod.registrations ?? []) {
+                if (ro.apiURL) {
+                    dbos_sdk_1.DBOS.logger.info('    ' + ro.apiType.padEnd(6) + '  :  ' + ro.apiURL);
+                    const roles = methodReg.getRequiredRoles();
+                    if (roles.length > 0) {
+                        dbos_sdk_1.DBOS.logger.info('        Required Roles: ' + JSON.stringify(roles));
+                    }
+                }
+            }
+        }
+    }
+}
+exports.DBOSHTTPBase = DBOSHTTPBase;
+//# sourceMappingURL=dboshttp.js.map

package/dist/src/dboshttp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dboshttp.js","sourceRoot":"","sources":["../../src/dboshttp.ts"],"names":[],"mappings":"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"}

package/dist/src/dboskoa.d.ts

@@ -0,0 +1,54 @@
+/// <reference types="koa__router" />
+import Koa from 'koa';
+import Router from '@koa/router';
+import { DBOSHTTPAuthReturn, DBOSHTTPBase } from './dboshttp';
+export interface DBOSKoaAuthContext {
+    readonly koaContext: Koa.Context;
+    readonly name: string;
+    readonly requiredRole: string[];
+}
+/**
+ * Authentication middleware that executes before a request reaches a function.
+ * This is expected to:
+ *   - Validate the request found in the handler context and extract auth information from the request.
+ *   - Map the HTTP request to the user identity and roles defined in app.
+ * If this succeeds, return the current authenticated user and a list of roles.
+ * If any step fails, throw an error.
+ */
+export type DBOSKoaAuthMiddleware = (ctx: DBOSKoaAuthContext) => Promise<DBOSHTTPAuthReturn | void>;
+export interface DBOSKoaConfig {
+    corsMiddleware?: boolean;
+    credentials?: boolean;
+    allowedOrigins?: string[];
+}
+export interface DBOSKoaClassReg {
+    authMiddleware?: DBOSKoaAuthMiddleware;
+    koaBodyParser?: Koa.Middleware;
+    koaCors?: Koa.Middleware;
+    koaMiddlewares?: Koa.Middleware[];
+    koaGlobalMiddlewares?: Koa.Middleware[];
+}
+export declare class DBOSKoa extends DBOSHTTPBase {
+    static get koaContext(): Koa.Context;
+    /**
+     * Define an authentication function for each endpoint in this class.
+     */
+    authentication(authMiddleware: DBOSKoaAuthMiddleware): <T extends new (...args: unknown[]) => object>(ctor: T) => void;
+    koaBodyParser(koaBodyParser: Koa.Middleware): <T extends new (...args: unknown[]) => object>(ctor: T) => void;
+    koaCors(koaCors: Koa.Middleware): <T extends new (...args: unknown[]) => object>(ctor: T) => void;
+    /**
+     * Define Koa middleware that is applied in order to each endpoint in this class.
+     */
+    koaMiddleware(...koaMiddleware: Koa.Middleware[]): <T extends new (...args: unknown[]) => object>(ctor: T) => void;
+    /**
+     * Define Koa middleware that is applied to all requests, including this class, other classes,
+     *   or requests that do not end up in DBOS handlers at all.
+     * @deprecated Apply global middleware to your application router directly
+     */
+    koaGlobalMiddleware(...koaMiddleware: Koa.Middleware[]): <T extends new (...args: unknown[]) => object>(ctor: T) => void;
+    app?: Koa;
+    appRouter?: Router;
+    createApp(config?: DBOSKoaConfig): void;
+    registerWithApp(app: Koa, appRouter: Router, config?: DBOSKoaConfig): void;
+}
+//# sourceMappingURL=dboskoa.d.ts.map

package/dist/src/dboskoa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dboskoa.d.ts","sourceRoot":"","sources":["../../src/dboskoa.ts"],"names":[],"mappings":";AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,MAAM,MAAM,aAAa,CAAC;AASjC,OAAO,EAGL,kBAAkB,EAClB,YAAY,EAMb,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;AAEpG,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,aAAa,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC;IAC/B,OAAO,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC;IACzB,cAAc,CAAC,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;IAClC,oBAAoB,CAAC,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;CACzC;AAqBD,qBAAa,OAAQ,SAAQ,YAAY;IACvC,MAAM,KAAK,UAAU,IAAI,GAAG,CAAC,OAAO,CAEnC;IAED;;OAEG;IACH,cAAc,CAAC,cAAc,EAAE,qBAAqB,4BAGR,OAAO,EAAE,KAAG,MAAM,QAAU,CAAC;IAOzE,aAAa,CAAC,aAAa,EAAE,GAAG,CAAC,UAAU,4BAGC,OAAO,EAAE,KAAG,MAAM,QAAU,CAAC;IAOzE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,UAAU,4BAGa,OAAO,EAAE,KAAG,MAAM,QAAU,CAAC;IAOzE;;OAEG;IACH,aAAa,CAAC,GAAG,aAAa,EAAE,GAAG,CAAC,UAAU,EAAE,4BAQJ,OAAO,EAAE,KAAG,MAAM,QAAU,CAAC;IAOzE;;;;OAIG;IACH,mBAAmB,CAAC,GAAG,aAAa,EAAE,GAAG,CAAC,UAAU,EAAE,4BAQV,OAAO,EAAE,KAAG,MAAM,QAAU,CAAC;IAOzE,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,MAAM,CAAC,EAAE,aAAa;IAMhC,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa;CAgQpE"}

package/dist/src/dboskoa.js

@@ -0,0 +1,333 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DBOSKoa = void 0;
+const koa_1 = __importDefault(require("koa"));
+const router_1 = __importDefault(require("@koa/router"));
+const bodyparser_1 = __importDefault(require("@koa/bodyparser"));
+const cors_1 = __importDefault(require("@koa/cors"));
+const core_1 = require("@opentelemetry/core");
+const api_1 = require("@opentelemetry/api");
+const dbos_sdk_1 = require("@dbos-inc/dbos-sdk");
+const dboshttp_1 = require("./dboshttp");
+const async_hooks_1 = require("async_hooks");
+function exhaustiveCheckGuard(_) {
+    throw new Error('Exaustive matching is not applied');
+}
+const asyncLocalCtx = new async_hooks_1.AsyncLocalStorage();
+function getCurrentKoaContextStore() {
+    return asyncLocalCtx.getStore();
+}
+function assertCurrentKoaContextStore() {
+    const ctx = getCurrentKoaContextStore();
+    if (!ctx)
+        throw new TypeError('Invalid use of `DBOSKoa.koaContext` outside of a handler function');
+    return ctx;
+}
+class DBOSKoa extends dboshttp_1.DBOSHTTPBase {
+    static get koaContext() {
+        return assertCurrentKoaContextStore().koaCtxt;
+    }
+    /**
+     * Define an authentication function for each endpoint in this class.
+     */
+    authentication(authMiddleware) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const er = this;
+        function clsdec(ctor) {
+            const clsreg = dbos_sdk_1.DBOS.associateClassWithInfo(er, ctor);
+            clsreg.authMiddleware = authMiddleware;
+        }
+        return clsdec;
+    }
+    koaBodyParser(koaBodyParser) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const er = this;
+        function clsdec(ctor) {
+            const clsreg = dbos_sdk_1.DBOS.associateClassWithInfo(er, ctor);
+            clsreg.koaBodyParser = koaBodyParser;
+        }
+        return clsdec;
+    }
+    koaCors(koaCors) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const er = this;
+        function clsdec(ctor) {
+            const clsreg = dbos_sdk_1.DBOS.associateClassWithInfo(er, ctor);
+            clsreg.koaCors = koaCors;
+        }
+        return clsdec;
+    }
+    /**
+     * Define Koa middleware that is applied in order to each endpoint in this class.
+     */
+    koaMiddleware(...koaMiddleware) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const er = this;
+        koaMiddleware.forEach((i) => {
+            if (i === undefined) {
+                throw new TypeError('undefined argument passed to koaMiddleware');
+            }
+        });
+        function clsdec(ctor) {
+            const clsreg = dbos_sdk_1.DBOS.associateClassWithInfo(er, ctor);
+            clsreg.koaMiddlewares = [...(clsreg.koaMiddlewares ?? []), ...koaMiddleware];
+        }
+        return clsdec;
+    }
+    /**
+     * Define Koa middleware that is applied to all requests, including this class, other classes,
+     *   or requests that do not end up in DBOS handlers at all.
+     * @deprecated Apply global middleware to your application router directly
+     */
+    koaGlobalMiddleware(...koaMiddleware) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const er = this;
+        koaMiddleware.forEach((i) => {
+            if (i === undefined) {
+                throw new TypeError('undefined argument passed to koaMiddleware');
+            }
+        });
+        function clsdec(ctor) {
+            const clsreg = dbos_sdk_1.DBOS.associateClassWithInfo(er, ctor);
+            clsreg.koaGlobalMiddlewares = [...(clsreg.koaGlobalMiddlewares ?? []), ...koaMiddleware];
+        }
+        return clsdec;
+    }
+    app;
+    appRouter;
+    createApp(config) {
+        this.app = new koa_1.default();
+        this.appRouter = new router_1.default();
+        this.registerWithApp(this.app, this.appRouter, config);
+    }
+    registerWithApp(app, appRouter, config) {
+        const globalMiddlewares = new Set();
+        const eps = dbos_sdk_1.DBOS.getAssociatedInfo(this);
+        for (const e of eps) {
+            const { methodConfig, classConfig, methodReg } = e;
+            const defaults = classConfig;
+            const httpmethod = methodConfig;
+            for (const ro of httpmethod?.registrations ?? []) {
+                // What about instance methods?
+                //   Those would have to be registered another way that accepted the instances.
+                if (methodReg.isInstance) {
+                    dbos_sdk_1.DBOS.logger.warn(`Operation ${methodReg.className}/${methodReg.name} is registered with an endpoint (${ro.apiURL}) but cannot be invoked without an instance.`);
+                    continue;
+                }
+                // Apply CORS, bodyParser, and other middlewares
+                // Check if we need to apply a custom CORS
+                if (defaults.koaCors) {
+                    appRouter.all(ro.apiURL, defaults.koaCors); // Use router.all to register with all methods including preflight requests
+                }
+                else {
+                    if (config?.corsMiddleware ?? true) {
+                        appRouter.all(ro.apiURL, (0, cors_1.default)({
+                            credentials: config?.credentials ?? true,
+                            origin: (o) => {
+                                const whitelist = config?.allowedOrigins;
+                                const origin = o.request.header.origin ?? '*';
+                                if (whitelist && whitelist.length > 0) {
+                                    return whitelist.includes(origin) ? origin : '';
+                                }
+                                return o.request.header.origin || '*';
+                            },
+                            allowMethods: 'GET,HEAD,PUT,POST,DELETE,PATCH,OPTIONS',
+                            allowHeaders: ['Origin', 'X-Requested-With', 'Content-Type', 'Accept', 'Authorization'],
+                        }));
+                    }
+                }
+                // Check if we need to apply any Koa global middleware.
+                if (defaults?.koaGlobalMiddlewares) {
+                    defaults.koaGlobalMiddlewares.forEach((koaMiddleware) => {
+                        if (globalMiddlewares.has(koaMiddleware)) {
+                            return;
+                        }
+                        dbos_sdk_1.DBOS.logger.debug(`DBOS Koa Server applying middleware ${koaMiddleware.name} globally`);
+                        globalMiddlewares.add(koaMiddleware);
+                        app.use(koaMiddleware);
+                    });
+                }
+                const wrappedHandler = async (koaCtxt, koaNext) => {
+                    let authenticatedUser = undefined;
+                    let authenticatedRoles = undefined;
+                    let span;
+                    const httpTracer = new core_1.W3CTraceContextPropagator();
+                    try {
+                        // Auth first
+                        if (defaults?.authMiddleware) {
+                            const res = await defaults.authMiddleware({
+                                name: methodReg.name,
+                                requiredRole: methodReg.getRequiredRoles(),
+                                koaContext: koaCtxt,
+                            });
+                            if (res) {
+                                authenticatedUser = res.authenticatedUser;
+                                authenticatedRoles = res.authenticatedRoles;
+                            }
+                        }
+                        // Parse the arguments.
+                        const args = [];
+                        methodReg.args.forEach((marg) => {
+                            let foundArg = undefined;
+                            const isQueryMethod = ro.apiType === dboshttp_1.APITypes.GET || ro.apiType === dboshttp_1.APITypes.DELETE;
+                            const isBodyMethod = ro.apiType === dboshttp_1.APITypes.POST || ro.apiType === dboshttp_1.APITypes.PUT || ro.apiType === dboshttp_1.APITypes.PATCH;
+                            const argSource = this.getArgSource(marg);
+                            if ((isQueryMethod && argSource !== dboshttp_1.ArgSources.BODY) || argSource === dboshttp_1.ArgSources.QUERY) {
+                                foundArg = koaCtxt.request.query[marg.name];
+                                if (foundArg !== undefined) {
+                                    args.push(foundArg);
+                                }
+                                else if (argSource === dboshttp_1.ArgSources.AUTO) {
+                                    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment
+                                    foundArg = koaCtxt.request.body?.[marg.name];
+                                    if (foundArg !== undefined) {
+                                        args.push(foundArg);
+                                    }
+                                }
+                            }
+                            else if (isBodyMethod || argSource === dboshttp_1.ArgSources.BODY) {
+                                // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment
+                                foundArg = koaCtxt.request.body?.[marg.name];
+                                if (foundArg !== undefined) {
+                                    args.push(foundArg);
+                                }
+                                else if (argSource === dboshttp_1.ArgSources.AUTO) {
+                                    foundArg = koaCtxt.request.query[marg.name];
+                                    if (foundArg !== undefined) {
+                                        args.push(foundArg);
+                                    }
+                                    else {
+                                        if (!koaCtxt.request.body) {
+                                            throw new dbos_sdk_1.Error.DBOSDataValidationError(`Argument ${marg.name} requires a method body.`);
+                                        }
+                                    }
+                                }
+                            }
+                            // Try to parse the argument from the URL if nothing found.
+                            if (foundArg === undefined) {
+                                // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+                                args.push(koaCtxt.params[marg.name]);
+                            }
+                            //console.log(`found arg ${marg.name} ${idx} ${args[idx-1]}`);
+                        });
+                        // Extract workflow ID from headers (if any).
+                        // We pass in the specified workflow ID in for any workflow started, should handler happen to do so.
+                        const headerWorkflowID = koaCtxt.get(dboshttp_1.WorkflowIDHeader);
+                        // Retrieve or generate the tracing request ID
+                        const requestID = (0, dboshttp_1.getOrGenerateRequestID)(koaCtxt.request.headers);
+                        koaCtxt.set(dboshttp_1.RequestIDHeader, requestID);
+                        // If present, retrieve the trace context from the request
+                        const extractedSpanContext = api_1.trace.getSpanContext(httpTracer.extract(api_1.ROOT_CONTEXT, koaCtxt.request.headers, api_1.defaultTextMapGetter));
+                        const spanAttributes = {
+                            operationType: dboshttp_1.DBOSHTTPBase.HTTP_OPERATION_TYPE,
+                            requestID: requestID,
+                            requestIP: koaCtxt.request.ip,
+                            requestURL: koaCtxt.request.url,
+                            requestMethod: koaCtxt.request.method,
+                        };
+                        if (extractedSpanContext === undefined) {
+                            span = dbos_sdk_1.DBOS.tracer?.startSpan(koaCtxt.url, spanAttributes);
+                        }
+                        else {
+                            extractedSpanContext.isRemote = true;
+                            span = dbos_sdk_1.DBOS.tracer?.startSpanWithContext(extractedSpanContext, koaCtxt.url, spanAttributes);
+                        }
+                        // Finally, invoke the function and properly set HTTP response.
+                        // If functions return successfully and hasn't set the body, we set the body to the function return value.
+                        //   The status code will be automatically set to 200 or 204 (if the body is null/undefined).
+                        // In case of an exception:
+                        // - If a client-side error is thrown, we return 400.
+                        // - If an error contains a `status` field, we return the specified status code.
+                        // - Otherwise, we return 500.
+                        const cresult = await asyncLocalCtx.run({ koaCtxt }, async () => {
+                            return await dbos_sdk_1.DBOS.runWithContext({
+                                authenticatedUser,
+                                authenticatedRoles,
+                                idAssignedForNextWorkflow: headerWorkflowID,
+                                span,
+                                request: koaCtxt.request,
+                            }, async () => {
+                                return await methodReg.invoke(undefined, args);
+                            });
+                        });
+                        const retValue = cresult;
+                        // Set the body to the return value unless the body is already set by the handler.
+                        if (koaCtxt.body === undefined) {
+                            koaCtxt.body = retValue;
+                        }
+                        span?.setStatus({ code: api_1.SpanStatusCode.OK });
+                    }
+                    catch (e) {
+                        if (e instanceof Error) {
+                            span?.setStatus({ code: api_1.SpanStatusCode.ERROR, message: e.message });
+                            let st = e?.status || 500;
+                            if ((0, dboshttp_1.isClientRequestError)(e)) {
+                                st = 400; // Set to 400: client-side error.
+                            }
+                            koaCtxt.status = st;
+                            koaCtxt.message = e.message;
+                            koaCtxt.body = {
+                                status: st,
+                                message: e.message,
+                                details: e,
+                            };
+                        }
+                        else {
+                            // Thrown item was not an Error, which is poor form.
+                            // using stringify() will not produce a pretty output, because our format function uses stringify() too.
+                            dbos_sdk_1.DBOS.logger.error(e);
+                            span?.setStatus({ code: api_1.SpanStatusCode.ERROR, message: JSON.stringify(e) });
+                            koaCtxt.body = e;
+                            koaCtxt.status = 500;
+                        }
+                    }
+                    finally {
+                        if (span) {
+                            httpTracer.inject(api_1.trace.setSpanContext(api_1.ROOT_CONTEXT, span.spanContext()), {
+                                context: koaCtxt,
+                            }, {
+                                set: (carrier, key, value) => {
+                                    carrier.context.set(key, value);
+                                },
+                            });
+                            dbos_sdk_1.DBOS.tracer?.endSpan(span);
+                        }
+                        await koaNext();
+                    }
+                };
+                // Middleware functions are applied directly to router verb methods to prevent duplicate calls.
+                const routeMiddlewares = [defaults.koaBodyParser ?? (0, bodyparser_1.default)()].concat(defaults.koaMiddlewares ?? []);
+                switch (ro.apiType) {
+                    case dboshttp_1.APITypes.GET:
+                        appRouter.get(ro.apiURL, ...routeMiddlewares, wrappedHandler);
+                        dbos_sdk_1.DBOS.logger.debug(`DBOS Server Registered GET ${ro.apiURL}`);
+                        break;
+                    case dboshttp_1.APITypes.POST:
+                        appRouter.post(ro.apiURL, ...routeMiddlewares, wrappedHandler);
+                        dbos_sdk_1.DBOS.logger.debug(`DBOS Server Registered POST ${ro.apiURL}`);
+                        break;
+                    case dboshttp_1.APITypes.PUT:
+                        appRouter.put(ro.apiURL, ...routeMiddlewares, wrappedHandler);
+                        dbos_sdk_1.DBOS.logger.debug(`DBOS Server Registered PUT ${ro.apiURL}`);
+                        break;
+                    case dboshttp_1.APITypes.PATCH:
+                        appRouter.patch(ro.apiURL, ...routeMiddlewares, wrappedHandler);
+                        dbos_sdk_1.DBOS.logger.debug(`DBOS Server Registered PATCH ${ro.apiURL}`);
+                        break;
+                    case dboshttp_1.APITypes.DELETE:
+                        appRouter.delete(ro.apiURL, ...routeMiddlewares, wrappedHandler);
+                        dbos_sdk_1.DBOS.logger.debug(`DBOS Server Registered DELETE ${ro.apiURL}`);
+                        break;
+                    default:
+                        exhaustiveCheckGuard(ro.apiType);
+                }
+            }
+        }
+        app.use(appRouter.routes()).use(appRouter.allowedMethods());
+    }
+}
+exports.DBOSKoa = DBOSKoa;
+//# sourceMappingURL=dboskoa.js.map

package/dist/src/dboskoa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dboskoa.js","sourceRoot":"","sources":["../../src/dboskoa.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export { ArgSources, DBOSHTTP, DBOSHTTPArgInfo, DBOSHTTPAuthReturn, DBOSHTTPBase, DBOSHTTPMethodInfo, DBOSHTTPReg, DBOSHTTPRequest, RequestIDHeader, WorkflowIDHeader, } from './dboshttp';
+export { DBOSKoa, DBOSKoaAuthContext, DBOSKoaClassReg, DBOSKoaAuthMiddleware, DBOSKoaConfig } from './dboskoa';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}