@aneuhold/core-ts-api-lib 3.0.0 → 3.0.2

package/lib/services/DOFunctionService/DOFunction.d.ts

@@ -1,109 +0,0 @@
-import type { APIResponse } from '../../types/APIResponse.js';
-/**
- * The input to a Digital Ocean function must always be an object.
- */
-export type DOFunctionInput = object;
-/**
- * The output from a Digital Ocean function must always be an object. This
- * is the data that actually matters and doesn't require parsing the `body`
- * property.
- */
-export type DOFunctionOutput = object;
-/**
- * Raw input to a Digital Ocean function. This is with the expectation that
- * `web: raw` is set in the `project.yml` file.
- */
-export interface DOFunctionRawInput {
-    http: {
-        /**
-         * The body to be parsed or deserialized.
-         */
-        body: string;
-        headers: {
-            accept?: string;
-            'accept-encoding'?: string;
-            /**
-             * This is important.
-             */
-            'content-type'?: string;
-            host?: string;
-            'user-agent'?: string;
-            'x-forwarded-for'?: string;
-            'x-forwarded-proto'?: string;
-            'x-request-id'?: string;
-        };
-        /**
-         * This needs to be used to determine if the body is base64 encoded.
-         */
-        isBase64Encoded: boolean;
-        method?: string;
-        path?: string;
-        queryString?: string;
-    };
-}
-/**
- * Raw output from a Digital Ocean function must always be an object with
- * a body property. The body property must be a string that is base64 encoded
- * or an object. With how this project is set up, it will always be base64
- * encoded to support BSON types.
- */
-export interface DOFunctionRawOutput {
-    /**
-     * The body is a base64 encoded string.
-     */
-    body: string;
-    statusCode: number;
-    headers: {
-        /**
-         * This is different than what gets passed in. This is on purpose. DO
-         * functions changes the header name when being passed in, but not when
-         * being passed out.
-         */
-        'Content-Type': string;
-    };
-}
-/**
- * Type guard to check if an input object conforms to the DOFunctionRawInput structure.
- *
- * @param input - The input object to check.
- * @returns True if the input is DOFunctionRawInput, false otherwise.
- */
-export declare function isDOFunctionRawInput(input: unknown): input is DOFunctionRawInput;
-/**
- * An abstract class representing a Digital Ocean Function.
- *
- * @template TInput - The type of the input to the function, extending {@link DOFunctionInput}.
- * @template TOutput - The type of the output from the function, extending {@link DOFunctionOutput}.
- */
-export default abstract class DOFunction<TInput extends DOFunctionInput, TOutput extends DOFunctionOutput> {
-    /**
-     * The URL of the digital ocean function.
-     */
-    protected url?: string;
-    protected functionName: string;
-    protected constructor();
-    /**
-     * Sets the URL of the Digital Ocean function.
-     *
-     * @param url - The URL to set.
-     */
-    setUrl(url: string): void;
-    /**
-     * A generic call method for any Digital Ocean Function from the client.
-     * This gets pretty crazy with the serialization logic. It has been tested
-     * heavily.
-     *
-     * @param input - The input to the function.
-     * @returns A promise that resolves to the output of the function call, wrapped in {@link DOFunctionCallOutput}.
-     * @throws {Error} Will throw an error if the URL is not set.
-     */
-    call(input: TInput): Promise<APIResponse<TOutput>>;
-    /**
-     * Decodes the response from the Digital Ocean function.
-     *
-     * @param response - The response to decode.
-     * @returns The decoded output.
-     */
-    private decodeResponse;
-}
-//# sourceMappingURL=DOFunction.d.ts.map

package/lib/services/DOFunctionService/DOFunction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DOFunction.d.ts","sourceRoot":"","sources":["../../../src/services/DOFunctionService/DOFunction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE;QACJ;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE;YACP,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAC3B;;eAEG;YACH,cAAc,CAAC,EAAE,MAAM,CAAC;YACxB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;YAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;SACzB,CAAC;QACF;;WAEG;QACH,eAAe,EAAE,OAAO,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QACP;;;;WAIG;QACH,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAShF;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,UAAU,CACtC,MAAM,SAAS,eAAe,EAC9B,OAAO,SAAS,gBAAgB;IAEhC;;OAEG;IACH,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEvB,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAE/B,SAAS;IAIT;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB;;;;;;;;OAQG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAgBxD;;;;;OAKG;YACW,cAAc;CAgB7B"}

package/lib/services/DOFunctionService/DOFunction.js

@@ -1,87 +0,0 @@
-import { BSON } from 'bson';
-/**
- * Type guard to check if an input object conforms to the DOFunctionRawInput structure.
- *
- * @param input - The input object to check.
- * @returns True if the input is DOFunctionRawInput, false otherwise.
- */
-export function isDOFunctionRawInput(input) {
-    return (!!input &&
-        typeof input === 'object' &&
-        'http' in input &&
-        typeof input.http === 'object' &&
-        'body' in input.http && // Check for essential http properties
-        'isBase64Encoded' in input.http);
-}
-/**
- * An abstract class representing a Digital Ocean Function.
- *
- * @template TInput - The type of the input to the function, extending {@link DOFunctionInput}.
- * @template TOutput - The type of the output from the function, extending {@link DOFunctionOutput}.
- */
-export default class DOFunction {
-    /**
-     * The URL of the digital ocean function.
-     */
-    url;
-    functionName;
-    constructor() {
-        this.functionName = this.constructor.name;
-    }
-    /**
-     * Sets the URL of the Digital Ocean function.
-     *
-     * @param url - The URL to set.
-     */
-    setUrl(url) {
-        this.url = url;
-    }
-    /**
-     * A generic call method for any Digital Ocean Function from the client.
-     * This gets pretty crazy with the serialization logic. It has been tested
-     * heavily.
-     *
-     * @param input - The input to the function.
-     * @returns A promise that resolves to the output of the function call, wrapped in {@link DOFunctionCallOutput}.
-     * @throws {Error} Will throw an error if the URL is not set.
-     */
-    async call(input) {
-        if (!this.url) {
-            throw new Error(`${this.functionName} URL is not set`);
-        }
-        const response = await fetch(this.url, {
-            method: 'POST',
-            headers: {
-                Connection: 'keep-alive',
-                'Content-Type': 'application/octet-stream',
-                Accept: 'application/octet-stream'
-            },
-            body: Buffer.from(BSON.serialize(input))
-        });
-        return await this.decodeResponse(response);
-    }
-    /**
-     * Decodes the response from the Digital Ocean function.
-     *
-     * @param response - The response to decode.
-     * @returns The decoded output.
-     */
-    async decodeResponse(response) {
-        const isBson = response.headers.get('Content-Type') === 'application/octet-stream';
-        if (isBson) {
-            const buffer = await response.arrayBuffer();
-            const uint8Array = new Uint8Array(buffer);
-            return BSON.deserialize(uint8Array);
-        }
-        else {
-            // This normally only happens if there is an error
-            const result = (await response.json());
-            return {
-                success: false,
-                errors: [JSON.stringify(result, null, 2)],
-                data: {}
-            };
-        }
-    }
-}
-//# sourceMappingURL=DOFunction.js.map

package/lib/services/DOFunctionService/DOFunction.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DOFunction.js","sourceRoot":"","sources":["../../../src/services/DOFunctionService/DOFunction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAsE5B;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,CACL,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,IAAI,KAAK;QACf,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ;QACtD,MAAM,IAAK,KAA4B,CAAC,IAAI,IAAI,sCAAsC;QACtF,iBAAiB,IAAK,KAA4B,CAAC,IAAI,CACxD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAgB,UAAU;IAItC;;OAEG;IACO,GAAG,CAAU;IAEb,YAAY,CAAS;IAE/B;QACE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,YAAY,iBAAiB,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;YACrC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,UAAU,EAAE,YAAY;gBACxB,cAAc,EAAE,0BAA0B;gBAC1C,MAAM,EAAE,0BAA0B;aACnC;YACD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;SACzC,CAAC,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,cAAc,CAAC,QAAkB;QAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,0BAA0B,CAAC;QACnF,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAyB,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,kDAAkD;YAClD,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAY,CAAC;YAClD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACzC,IAAI,EAAE,EAAa;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/lib/services/DOFunctionService/DOFunction.ts

@@ -1,165 +0,0 @@
-import { BSON } from 'bson';
-import type { APIResponse } from '../../types/APIResponse.js';
-
-/**
- * The input to a Digital Ocean function must always be an object.
- */
-export type DOFunctionInput = object;
-
-/**
- * The output from a Digital Ocean function must always be an object. This
- * is the data that actually matters and doesn't require parsing the `body`
- * property.
- */
-export type DOFunctionOutput = object;
-
-/**
- * Raw input to a Digital Ocean function. This is with the expectation that
- * `web: raw` is set in the `project.yml` file.
- */
-export interface DOFunctionRawInput {
-  http: {
-    /**
-     * The body to be parsed or deserialized.
-     */
-    body: string;
-    headers: {
-      accept?: string;
-      'accept-encoding'?: string;
-      /**
-       * This is important.
-       */
-      'content-type'?: string;
-      host?: string;
-      'user-agent'?: string;
-      'x-forwarded-for'?: string;
-      'x-forwarded-proto'?: string;
-      'x-request-id'?: string;
-    };
-    /**
-     * This needs to be used to determine if the body is base64 encoded.
-     */
-    isBase64Encoded: boolean;
-    method?: string;
-    path?: string;
-    queryString?: string;
-  };
-}
-
-/**
- * Raw output from a Digital Ocean function must always be an object with
- * a body property. The body property must be a string that is base64 encoded
- * or an object. With how this project is set up, it will always be base64
- * encoded to support BSON types.
- */
-export interface DOFunctionRawOutput {
-  /**
-   * The body is a base64 encoded string.
-   */
-  body: string;
-  statusCode: number;
-  headers: {
-    /**
-     * This is different than what gets passed in. This is on purpose. DO
-     * functions changes the header name when being passed in, but not when
-     * being passed out.
-     */
-    'Content-Type': string;
-  };
-}
-
-/**
- * Type guard to check if an input object conforms to the DOFunctionRawInput structure.
- *
- * @param input - The input object to check.
- * @returns True if the input is DOFunctionRawInput, false otherwise.
- */
-export function isDOFunctionRawInput(input: unknown): input is DOFunctionRawInput {
-  return (
-    !!input &&
-    typeof input === 'object' &&
-    'http' in input &&
-    typeof (input as DOFunctionRawInput).http === 'object' &&
-    'body' in (input as DOFunctionRawInput).http && // Check for essential http properties
-    'isBase64Encoded' in (input as DOFunctionRawInput).http
-  );
-}
-
-/**
- * An abstract class representing a Digital Ocean Function.
- *
- * @template TInput - The type of the input to the function, extending {@link DOFunctionInput}.
- * @template TOutput - The type of the output from the function, extending {@link DOFunctionOutput}.
- */
-export default abstract class DOFunction<
-  TInput extends DOFunctionInput,
-  TOutput extends DOFunctionOutput
-> {
-  /**
-   * The URL of the digital ocean function.
-   */
-  protected url?: string;
-
-  protected functionName: string;
-
-  protected constructor() {
-    this.functionName = this.constructor.name;
-  }
-
-  /**
-   * Sets the URL of the Digital Ocean function.
-   *
-   * @param url - The URL to set.
-   */
-  setUrl(url: string) {
-    this.url = url;
-  }
-
-  /**
-   * A generic call method for any Digital Ocean Function from the client.
-   * This gets pretty crazy with the serialization logic. It has been tested
-   * heavily.
-   *
-   * @param input - The input to the function.
-   * @returns A promise that resolves to the output of the function call, wrapped in {@link DOFunctionCallOutput}.
-   * @throws {Error} Will throw an error if the URL is not set.
-   */
-  async call(input: TInput): Promise<APIResponse<TOutput>> {
-    if (!this.url) {
-      throw new Error(`${this.functionName} URL is not set`);
-    }
-    const response = await fetch(this.url, {
-      method: 'POST',
-      headers: {
-        Connection: 'keep-alive',
-        'Content-Type': 'application/octet-stream',
-        Accept: 'application/octet-stream'
-      },
-      body: Buffer.from(BSON.serialize(input))
-    });
-    return await this.decodeResponse(response);
-  }
-
-  /**
-   * Decodes the response from the Digital Ocean function.
-   *
-   * @param response - The response to decode.
-   * @returns The decoded output.
-   */
-  private async decodeResponse(response: Response): Promise<APIResponse<TOutput>> {
-    const isBson = response.headers.get('Content-Type') === 'application/octet-stream';
-    if (isBson) {
-      const buffer = await response.arrayBuffer();
-      const uint8Array = new Uint8Array(buffer);
-      return BSON.deserialize(uint8Array) as APIResponse<TOutput>;
-    } else {
-      // This normally only happens if there is an error
-      const result = (await response.json()) as unknown;
-      return {
-        success: false,
-        errors: [JSON.stringify(result, null, 2)],
-        data: {} as TOutput
-      };
-    }
-  }
-}

package/lib/services/DOFunctionService/DOFunctionService.d.ts

@@ -1,54 +0,0 @@
-import type { APIResponse } from '../../types/APIResponse.js';
-import type { DOFunctionInput, DOFunctionOutput, DOFunctionRawInput, DOFunctionRawOutput } from './DOFunction.js';
-import AuthCheckPassword from './functions/authCheckPassword.js';
-import AuthValidateUser from './functions/authValidateUser.js';
-import ProjectDashboard from './functions/projectDashboard.js';
-/**
- * A service to provide some utility related to Digital Ocean functions.
- */
-export default class DOFunctionService {
-    /**
-     * {@link AuthCheckPassword} function instance.
-     */
-    static authCheckPassword: AuthCheckPassword;
-    /**
-     * {@link AuthValidateUser} function instance.
-     */
-    static authValidateUser: AuthValidateUser;
-    /**
-     * {@link ProjectDashboard} function instance.
-     */
-    static projectDashboard: ProjectDashboard;
-    /**
-     * A generic method to handle any API request on the backend. This has
-     * no use on the frontend.
-     *
-     * This will take care of returning the error if the handler throws, and
-     * managing tracing spans via the registered ITracer.
-     * Ideally the handler should not throw though unless something really
-     * unexpected happened.
-     *
-     * @param functionName - The name to use for the root tracing span.
-     * @param rawInputFromDO - The raw input for the function.
-     * @param handler - The handler function to process the input.
-     * @returns The raw output of the function call.
-     */
-    static handleApiRequest<TInput extends DOFunctionInput, TOutput extends DOFunctionOutput>(functionName: string, rawInputFromDO: DOFunctionRawInput | TInput, handler: (input: TInput) => Promise<APIResponse<TOutput>>): Promise<DOFunctionRawOutput>;
-    /**
-     * Deserializes the raw input into a typed input object using type guards.
-     * Handles raw HTTP input, the DO UI wrapper, or already deserialized input.
-     *
-     * @param inputFromDO - The raw input received from the DO environment.
-     * @returns The deserialized input object of type TInput.
-     */
-    private static deserializeInput;
-    /**
-     * Serializes the output object into a base64 string. This could be updated
-     * to support other serialization methods in the future.
-     *
-     * @param output - The output object to serialize.
-     * @returns The serialized output as a base64 string.
-     */
-    private static serializeOutput;
-}
-//# sourceMappingURL=DOFunctionService.d.ts.map

package/lib/services/DOFunctionService/DOFunctionService.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DOFunctionService.d.ts","sourceRoot":"","sources":["../../../src/services/DOFunctionService/DOFunctionService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,iBAAiB,MAAM,kCAAkC,CAAC;AACjE,OAAO,gBAAgB,MAAM,iCAAiC,CAAC;AAC/D,OAAO,gBAAgB,MAAM,iCAAiC,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC;;OAEG;IACH,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAmC;IAE9E;;OAEG;IACH,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,CAAkC;IAE3E;;OAEG;IACH,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,CAAkC;IAE3E;;;;;;;;;;;;;OAaG;WACU,gBAAgB,CAAC,MAAM,SAAS,eAAe,EAAE,OAAO,SAAS,gBAAgB,EAC5F,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,kBAAkB,GAAG,MAAM,EAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GACxD,OAAO,CAAC,mBAAmB,CAAC;IA2D/B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA4D/B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;CAM/B"}

package/lib/services/DOFunctionService/DOFunctionService.js

@@ -1,157 +0,0 @@
-import { DR } from '@aneuhold/core-ts-lib';
-import { BSON } from 'bson';
-import { isDOFunctionRawInput } from './DOFunction.js';
-import AuthCheckPassword from './functions/authCheckPassword.js';
-import AuthValidateUser from './functions/authValidateUser.js';
-import ProjectDashboard from './functions/projectDashboard.js';
-/**
- * A service to provide some utility related to Digital Ocean functions.
- */
-export default class DOFunctionService {
-    /**
-     * {@link AuthCheckPassword} function instance.
-     */
-    static authCheckPassword = AuthCheckPassword.getFunction();
-    /**
-     * {@link AuthValidateUser} function instance.
-     */
-    static authValidateUser = AuthValidateUser.getFunction();
-    /**
-     * {@link ProjectDashboard} function instance.
-     */
-    static projectDashboard = ProjectDashboard.getFunction();
-    /**
-     * A generic method to handle any API request on the backend. This has
-     * no use on the frontend.
-     *
-     * This will take care of returning the error if the handler throws, and
-     * managing tracing spans via the registered ITracer.
-     * Ideally the handler should not throw though unless something really
-     * unexpected happened.
-     *
-     * @param functionName - The name to use for the root tracing span.
-     * @param rawInputFromDO - The raw input for the function.
-     * @param handler - The handler function to process the input.
-     * @returns The raw output of the function call.
-     */
-    static async handleApiRequest(functionName, rawInputFromDO, handler) {
-        DR.logger.info(`[DOFunctionService] handleApiRequest called for "${functionName}".`); // Log entry
-        DR.logger.info(`[DOFunctionService] Calling DR.tracer.startSpan for "${functionName}"...`); // Log before startSpan
-        return DR.tracer.startSpan(functionName, async (span) => {
-            DR.logger.info(`[DOFunctionService] Tracer span callback started for "${functionName}".`); // Log span callback start
-            const rawOutput = {
-                body: '',
-                statusCode: 200,
-                headers: {
-                    'Content-Type': 'application/octet-stream'
-                }
-            };
-            const defaultOutput = {
-                success: false,
-                errors: [],
-                data: {}
-            };
-            try {
-                DR.logger.info(`[DOFunctionService] Deserializing input for "${functionName}"...`); // Log before deserialize
-                const input = this.deserializeInput(rawInputFromDO);
-                DR.logger.info(`[DOFunctionService] Calling handler function for "${functionName}"...`); // Log before handler
-                const output = await handler(input);
-                DR.logger.info(`[DOFunctionService] Handler function finished for "${functionName}".`); // Log after handler
-                DR.logger.info(`[DOFunctionService] Serializing output for "${functionName}"...`); // Log before serialize
-                rawOutput.body = this.serializeOutput(output);
-                if (!output.success) {
-                    DR.logger.warn(`[DOFunctionService] Handler reported failure for "${functionName}". Setting status code 400.`); // Log handler failure
-                    rawOutput.statusCode = 400;
-                    span?.setStatus({ code: 2, message: 'handler_error' });
-                }
-                else {
-                    DR.logger.success(`[DOFunctionService] Handler reported success for "${functionName}". Setting status code 200.`); // Log handler success
-                    span?.setStatus({ code: 1, message: 'ok' });
-                }
-            }
-            catch (e) {
-                DR.logger.error(`[DOFunctionService] Error caught in handleApiRequest for "${functionName}": ${String(e)}`); // Log error
-                DR.tracer.captureException(e);
-                span?.setStatus({ code: 2, message: 'internal_error' });
-                const error = e;
-                defaultOutput.errors.push(JSON.stringify(error, null, 2));
-                rawOutput.body = JSON.stringify(defaultOutput);
-                rawOutput.headers['Content-Type'] = 'application/json';
-                rawOutput.statusCode = 500;
-            }
-            DR.logger.info(`[DOFunctionService] Tracer span callback finished for "${functionName}". Returning rawOutput.`); // Log span callback end
-            return rawOutput;
-        });
-    }
-    /**
-     * Deserializes the raw input into a typed input object using type guards.
-     * Handles raw HTTP input, the DO UI wrapper, or already deserialized input.
-     *
-     * @param inputFromDO - The raw input received from the DO environment.
-     * @returns The deserialized input object of type TInput.
-     */
-    static deserializeInput(inputFromDO) {
-        DR.logger.info(`[DOFunctionService] deserializeInput received: ${JSON.stringify(inputFromDO)}`);
-        // 1. Check if it's the standard DOFunctionRawInput (from web: raw)
-        if (isDOFunctionRawInput(inputFromDO)) {
-            DR.logger.info('[DOFunctionService] Input matches DOFunctionRawInput (via type guard). Proceeding with raw deserialization.');
-            const { http } = inputFromDO;
-            const { body, isBase64Encoded, headers } = http;
-            let decodedBody;
-            if (isBase64Encoded) {
-                DR.logger.info('[DOFunctionService] Body is base64 encoded, decoding...');
-                decodedBody = Buffer.from(body, 'base64');
-            }
-            else {
-                DR.logger.info('[DOFunctionService] Body is not base64 encoded, using utf8.');
-                decodedBody = Buffer.from(body, 'utf8');
-            }
-            const isBson = headers['content-type'] === 'application/octet-stream';
-            let requestData;
-            if (isBson) {
-                DR.logger.info('[DOFunctionService] Deserializing BSON body.');
-                try {
-                    requestData = BSON.deserialize(decodedBody);
-                }
-                catch (bsonError) {
-                    DR.logger.error(`[DOFunctionService] BSON deserialization failed: ${String(bsonError)}. Falling back to JSON parse.`);
-                    try {
-                        requestData = JSON.parse(decodedBody.toString('utf8'));
-                    }
-                    catch (jsonError) {
-                        DR.logger.error(`[DOFunctionService] JSON fallback parse failed: ${String(jsonError)}`);
-                        throw new Error('Failed to deserialize input body as BSON or JSON.');
-                    }
-                }
-            }
-            else {
-                DR.logger.info('[DOFunctionService] Deserializing non-BSON body (assuming JSON).');
-                try {
-                    requestData = JSON.parse(decodedBody.toString('utf8'));
-                }
-                catch (jsonError) {
-                    DR.logger.error(`[DOFunctionService] JSON parse failed: ${String(jsonError)}`);
-                    throw new Error('Failed to deserialize input body as JSON.');
-                }
-            }
-            return requestData;
-        }
-        // 2. Assume it's already the correct TInput type
-        else {
-            DR.logger.info('[DOFunctionService] Input does not match RawInput. Assuming input is already deserialized TInput.');
-            return inputFromDO;
-        }
-    }
-    /**
-     * Serializes the output object into a base64 string. This could be updated
-     * to support other serialization methods in the future.
-     *
-     * @param output - The output object to serialize.
-     * @returns The serialized output as a base64 string.
-     */
-    static serializeOutput(output) {
-        const bsonBuffer = BSON.serialize(output);
-        return Buffer.from(bsonBuffer).toString('base64');
-    }
-}
-//# sourceMappingURL=DOFunctionService.js.map

package/lib/services/DOFunctionService/DOFunctionService.js.map

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