@bitblit/ratchet-epsilon-common 4.0.419-alpha → 4.0.421-alpha

package/lib/built-in/http/built-in-filters.d.ts

@@ -0,0 +1,26 @@
+import { FilterFunction } from '../../config/http/filter-function.js';
+import { FilterChainContext } from '../../config/http/filter-chain-context.js';
+export declare class BuiltInFilters {
+    static readonly MAXIMUM_LAMBDA_BODY_SIZE_BYTES: number;
+    static combineFilters(fCtx: FilterChainContext, filters: FilterFunction[]): Promise<boolean>;
+    static applyGzipIfPossible(fCtx: FilterChainContext): Promise<boolean>;
+    static addConstantHeaders(fCtx: FilterChainContext, headers: Record<string, string>): Promise<boolean>;
+    static addAWSRequestIdHeader(fCtx: FilterChainContext, headerName?: string): Promise<boolean>;
+    static addAllowEverythingCORSHeaders(fCtx: FilterChainContext): Promise<boolean>;
+    static addAllowReflectionCORSHeaders(fCtx: FilterChainContext): Promise<boolean>;
+    static uriDecodeQueryParams(fCtx: FilterChainContext): Promise<boolean>;
+    private static decodeUriComponentAndReplacePlus;
+    static fixStillEncodedQueryParams(fCtx: FilterChainContext): Promise<boolean>;
+    static disallowStringNullAsPathParameter(fCtx: FilterChainContext): Promise<boolean>;
+    static disallowStringNullAsQueryStringParameter(fCtx: FilterChainContext): Promise<boolean>;
+    static ensureEventMaps(fCtx: FilterChainContext): Promise<boolean>;
+    static parseJsonBodyToObject(fCtx: FilterChainContext): Promise<boolean>;
+    static checkMaximumLambdaBodySize(fCtx: FilterChainContext): Promise<boolean>;
+    static validateInboundBody(fCtx: FilterChainContext): Promise<boolean>;
+    static validateInboundQueryParams(fCtx: FilterChainContext): Promise<boolean>;
+    static validateInboundPathParams(fCtx: FilterChainContext): Promise<boolean>;
+    static validateOutboundResponse(fCtx: FilterChainContext): Promise<boolean>;
+    static autoRespondToOptionsRequestWithCors(fCtx: FilterChainContext): Promise<boolean>;
+    static autoRespond(fCtx: FilterChainContext, inBody: any): Promise<boolean>;
+    static secureOutboundServerErrorForProduction(fCtx: FilterChainContext, errorMessage: string, errCode: number): Promise<boolean>;
+}

package/lib/built-in/http/built-in-filters.js

@@ -0,0 +1,212 @@
+import { Logger } from '@bitblit/ratchet-common/logger/logger';
+import { StringRatchet } from '@bitblit/ratchet-common/lang/string-ratchet';
+import { RestfulApiHttpError } from '@bitblit/ratchet-common/network/restful-api-http-error';
+import { MapRatchet } from '@bitblit/ratchet-common/lang/map-ratchet';
+import { EventUtil } from '../../http/event-util.js';
+import { BadRequestError } from '../../http/error/bad-request-error.js';
+import { ResponseUtil } from '../../http/response-util.js';
+import { MisconfiguredError } from '../../http/error/misconfigured-error.js';
+export class BuiltInFilters {
+    static MAXIMUM_LAMBDA_BODY_SIZE_BYTES = 1024 * 1024 * 5 - 1024 * 100;
+    static async combineFilters(fCtx, filters) {
+        let cont = true;
+        if (filters && filters.length > 0) {
+            for (let i = 0; i < filters.length && cont; i++) {
+                cont = await filters[i](fCtx);
+            }
+        }
+        return cont;
+    }
+    static async applyGzipIfPossible(fCtx) {
+        if (fCtx.event?.headers && fCtx.result) {
+            const encodingHeader = fCtx.event && fCtx.event.headers ? MapRatchet.extractValueFromMapIgnoreCase(fCtx.event.headers, 'accept-encoding') : null;
+            fCtx.result = await ResponseUtil.applyGzipIfPossible(encodingHeader, fCtx.result);
+        }
+        return true;
+    }
+    static async addConstantHeaders(fCtx, headers) {
+        if (headers && fCtx.result) {
+            fCtx.result.headers = Object.assign({}, headers, fCtx.result.headers);
+        }
+        else {
+            Logger.warn('Could not add headers - either result or headers were missing');
+        }
+        return true;
+    }
+    static async addAWSRequestIdHeader(fCtx, headerName = 'X-REQUEST-ID') {
+        if (fCtx.result && StringRatchet.trimToNull(headerName) && headerName.startsWith('X-')) {
+            fCtx.result.headers = fCtx.result.headers || {};
+            fCtx.result.headers[headerName] = fCtx.context?.awsRequestId || 'Request-Id-Missing';
+        }
+        else {
+            Logger.warn('Could not add request id header - either result or context were missing or name was invalid');
+        }
+        return true;
+    }
+    static async addAllowEverythingCORSHeaders(fCtx) {
+        return BuiltInFilters.addConstantHeaders(fCtx, {
+            'Access-Control-Allow-Origin': '*',
+            'Access-Control-Allow-Methods': '*',
+            'Access-Control-Allow-Headers': '*',
+        });
+    }
+    static async addAllowReflectionCORSHeaders(fCtx) {
+        return BuiltInFilters.addConstantHeaders(fCtx, {
+            'Access-Control-Allow-Origin': MapRatchet.caseInsensitiveAccess(fCtx.event.headers, 'Origin') || '*',
+            'Access-Control-Allow-Methods': MapRatchet.caseInsensitiveAccess(fCtx.event.headers, 'Access-Control-Request-Method') || '*',
+            'Access-Control-Allow-Headers': MapRatchet.caseInsensitiveAccess(fCtx.event.headers, 'Access-Control-Request-Headers') || '*',
+        });
+    }
+    static async uriDecodeQueryParams(fCtx) {
+        if (fCtx?.event?.queryStringParameters) {
+            Object.keys(fCtx.event.queryStringParameters).forEach((k) => {
+                const val = fCtx.event.queryStringParameters[k];
+                if (val) {
+                    fCtx.event.queryStringParameters[k] = BuiltInFilters.decodeUriComponentAndReplacePlus(val);
+                }
+            });
+        }
+        if (fCtx?.event?.multiValueQueryStringParameters) {
+            Object.keys(fCtx.event.multiValueQueryStringParameters).forEach((k) => {
+                const val = fCtx.event.multiValueQueryStringParameters[k];
+                if (val && val.length) {
+                    const cleaned = val.map((v) => BuiltInFilters.decodeUriComponentAndReplacePlus(v));
+                    fCtx.event.multiValueQueryStringParameters[k] = cleaned;
+                }
+            });
+        }
+        return true;
+    }
+    static decodeUriComponentAndReplacePlus(val) {
+        return decodeURIComponent(val.replace(/\+/g, ' '));
+    }
+    static async fixStillEncodedQueryParams(fCtx) {
+        EventUtil.fixStillEncodedQueryParams(fCtx.event);
+        return true;
+    }
+    static async disallowStringNullAsPathParameter(fCtx) {
+        if (fCtx?.event?.pathParameters) {
+            Object.keys(fCtx.event.pathParameters).forEach((k) => {
+                if ('null' === StringRatchet.trimToEmpty(fCtx.event.pathParameters[k]).toLowerCase()) {
+                    throw new BadRequestError().withFormattedErrorMessage('Path parameter %s was string -null-', k);
+                }
+            });
+        }
+        return true;
+    }
+    static async disallowStringNullAsQueryStringParameter(fCtx) {
+        if (fCtx?.event?.queryStringParameters) {
+            Object.keys(fCtx.event.queryStringParameters).forEach((k) => {
+                if ('null' === StringRatchet.trimToEmpty(fCtx.event.queryStringParameters[k]).toLowerCase()) {
+                    throw new BadRequestError().withFormattedErrorMessage('Query parameter %s was string -null-', k);
+                }
+            });
+        }
+        return true;
+    }
+    static async ensureEventMaps(fCtx) {
+        fCtx.event.queryStringParameters = fCtx.event.queryStringParameters || {};
+        fCtx.event.headers = fCtx.event.headers || {};
+        fCtx.event.pathParameters = fCtx.event.pathParameters || {};
+        return true;
+    }
+    static async parseJsonBodyToObject(fCtx) {
+        if (fCtx.event?.body) {
+            try {
+                fCtx.event.parsedBody = EventUtil.jsonBodyToObject(fCtx.event);
+            }
+            catch (err) {
+                throw new RestfulApiHttpError('Supplied body was not parsable as valid JSON').withHttpStatusCode(400);
+            }
+        }
+        return true;
+    }
+    static async checkMaximumLambdaBodySize(fCtx) {
+        if (fCtx.result?.body && fCtx.result.body.length > BuiltInFilters.MAXIMUM_LAMBDA_BODY_SIZE_BYTES) {
+            const delta = fCtx.result.body.length - BuiltInFilters.MAXIMUM_LAMBDA_BODY_SIZE_BYTES;
+            throw new RestfulApiHttpError('Response size is ' + fCtx.result.body.length + ' bytes, which is ' + delta + ' bytes too large for this handler').withHttpStatusCode(500);
+        }
+        return true;
+    }
+    static async validateInboundBody(fCtx) {
+        if (fCtx?.event?.parsedBody && fCtx.routeAndParse) {
+            if (fCtx.routeAndParse.mapping.validation) {
+                if (!fCtx.modelValidator) {
+                    throw new MisconfiguredError('Requested body validation but supplied no validator');
+                }
+                const errors = fCtx.modelValidator.validate(fCtx.routeAndParse.mapping.validation.modelName, fCtx.event.parsedBody, fCtx.routeAndParse.mapping.validation.emptyAllowed, fCtx.routeAndParse.mapping.validation.extraPropertiesAllowed);
+                if (errors.length > 0) {
+                    Logger.info('Found errors while validating %s object %j', fCtx.routeAndParse.mapping.validation.modelName, errors);
+                    const newError = new BadRequestError(...errors);
+                    throw newError;
+                }
+            }
+        }
+        else {
+            Logger.debug('No validation since no route specified or no parsed body');
+        }
+        return true;
+    }
+    static async validateInboundQueryParams(fCtx) {
+        return true;
+    }
+    static async validateInboundPathParams(fCtx) {
+        return true;
+    }
+    static async validateOutboundResponse(fCtx) {
+        if (fCtx?.rawResult) {
+            if (fCtx.routeAndParse.mapping.outboundValidation) {
+                Logger.debug('Applying outbound check to %j', fCtx.rawResult);
+                const errors = fCtx.modelValidator.validate(fCtx.routeAndParse.mapping.outboundValidation.modelName, fCtx.rawResult, fCtx.routeAndParse.mapping.outboundValidation.emptyAllowed, fCtx.routeAndParse.mapping.outboundValidation.extraPropertiesAllowed);
+                if (errors.length > 0) {
+                    Logger.error('Found outbound errors while validating %s object %j', fCtx.routeAndParse.mapping.outboundValidation.modelName, errors);
+                    errors.unshift('Server sent object invalid according to spec');
+                    throw new RestfulApiHttpError().withErrors(errors).withHttpStatusCode(500).withDetails(fCtx.rawResult);
+                }
+            }
+            else {
+                Logger.debug('Applied no outbound validation because none set');
+            }
+        }
+        else {
+            Logger.debug('No validation since no outbound body or disabled');
+        }
+        return true;
+    }
+    static async autoRespondToOptionsRequestWithCors(fCtx) {
+        if (StringRatchet.trimToEmpty(fCtx?.event?.httpMethod).toLowerCase() === 'options') {
+            fCtx.result = {
+                statusCode: 200,
+                body: '{"cors":true, "m":2}',
+            };
+            await BuiltInFilters.addAllowReflectionCORSHeaders(fCtx);
+            return false;
+        }
+        else {
+            return true;
+        }
+    }
+    static async autoRespond(fCtx, inBody) {
+        const body = inBody || {
+            message: 'Not Implemented',
+        };
+        fCtx.result = {
+            statusCode: 200,
+            body: JSON.stringify(body),
+        };
+        return false;
+    }
+    static async secureOutboundServerErrorForProduction(fCtx, errorMessage, errCode) {
+        if (fCtx?.result?.statusCode) {
+            if (errCode === null || fCtx.result.statusCode === errCode) {
+                Logger.warn('Securing outbound error info (was : %j)', fCtx.result.body);
+                fCtx.rawResult = new RestfulApiHttpError(errorMessage).withHttpStatusCode(fCtx.result.statusCode);
+                const oldResult = fCtx.result;
+                fCtx.result = ResponseUtil.errorResponse(fCtx.rawResult);
+                fCtx.result.headers = Object.assign({}, oldResult.headers || {}, fCtx.result.headers || {});
+            }
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=built-in-filters.js.map

package/lib/built-in/http/built-in-filters.js.map

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

package/lib/built-in/http/built-in-handlers.d.ts

@@ -0,0 +1,9 @@
+import { APIGatewayEvent, Context } from 'aws-lambda';
+import { ExtendedAPIGatewayEvent } from '../../config/http/extended-api-gateway-event.js';
+import { EpsilonRouter } from '../../http/route/epsilon-router.js';
+export declare class BuiltInHandlers {
+    static expectedHandledByFilter(evt: ExtendedAPIGatewayEvent, flag?: string): Promise<any>;
+    static handleNotImplemented(evt: ExtendedAPIGatewayEvent, flag?: string): Promise<any>;
+    static sample(evt: ExtendedAPIGatewayEvent, flag?: string, context?: Context): Promise<any>;
+    static defaultErrorProcessor(event: APIGatewayEvent, err: Error, cfg: EpsilonRouter): Promise<void>;
+}

package/lib/built-in/http/built-in-handlers.js

@@ -0,0 +1,70 @@
+import { Logger } from '@bitblit/ratchet-common/logger/logger';
+import { StringRatchet } from '@bitblit/ratchet-common/lang/string-ratchet';
+import { RestfulApiHttpError } from '@bitblit/ratchet-common/network/restful-api-http-error';
+import { NumberRatchet } from '@bitblit/ratchet-common/lang/number-ratchet';
+import { BadRequestError } from '../../http/error/bad-request-error.js';
+import { UnauthorizedError } from '../../http/error/unauthorized-error.js';
+import { NotFoundError } from '../../http/error/not-found-error.js';
+import { ForbiddenError } from '../../http/error/forbidden-error.js';
+import { NotImplemented } from '../../http/error/not-implemented.js';
+import { MisconfiguredError } from '../../http/error/misconfigured-error.js';
+export class BuiltInHandlers {
+    static async expectedHandledByFilter(evt, flag) {
+        throw new MisconfiguredError().withFormattedErrorMessage('Should not happen - it was expected that route %s would be handled by a filter', evt.path);
+    }
+    static async handleNotImplemented(evt, flag) {
+        Logger.info('A request was made to %s with body %j - not yet implemented', evt.path, evt.body);
+        const rval = {
+            time: new Date().toLocaleString(),
+            path: evt.path,
+            message: 'NOT IMPLEMENTED YET',
+        };
+        return rval;
+    }
+    static async sample(evt, flag, context) {
+        const rval = {
+            time: new Date().toLocaleString(),
+            evt: evt,
+            pad: StringRatchet.createRandomHexString(2000),
+            flag: flag,
+        };
+        if (context) {
+            rval['context'] = context;
+        }
+        const errNumber = NumberRatchet.safeNumber(evt.queryStringParameters['error']);
+        if (errNumber) {
+            switch (errNumber) {
+                case -1:
+                    throw new Error('Test random failure');
+                case 400:
+                    throw new BadRequestError('Bad request error');
+                case 401:
+                    throw new UnauthorizedError('Unauthorized error');
+                case 403:
+                    throw new ForbiddenError('Forbidden error');
+                case 404:
+                    throw new NotFoundError('Not Found error');
+                case 501:
+                    throw new NotImplemented('Not Implemented');
+                default:
+                    throw new RestfulApiHttpError()
+                        .withFormattedErrorMessage('Default error - %s', errNumber)
+                        .withHttpStatusCode(500)
+                        .withDetails({ src: errNumber })
+                        .withEndUserErrors(['msg1', 'msg2']);
+            }
+        }
+        let test = StringRatchet.trimToNull(evt.queryStringParameters['test']);
+        if (test) {
+            test = test.toLowerCase();
+            if (test === 'null') {
+                return null;
+            }
+        }
+        return rval;
+    }
+    static async defaultErrorProcessor(event, err, cfg) {
+        Logger.warn('Unhandled error (in promise catch) : %s \nStack was: %s\nEvt was: %j\nConfig was: %j', err.message, err.stack, event, cfg);
+    }
+}
+//# sourceMappingURL=built-in-handlers.js.map

package/lib/built-in/http/built-in-handlers.js.map

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

package/lib/built-in/http/log-level-manipulation-filter.d.ts

@@ -0,0 +1,6 @@
+import { FilterChainContext } from '../../config/http/filter-chain-context.js';
+export declare class LogLevelManipulationFilter {
+    private static LOG_LEVEL_BEFORE_CHANGE;
+    static setLogLevelForTransaction(fCtx: FilterChainContext): Promise<boolean>;
+    static clearLogLevelForTransaction(fCtx: FilterChainContext): Promise<boolean>;
+}

package/lib/built-in/http/log-level-manipulation-filter.js

@@ -0,0 +1,17 @@
+import { Logger } from '@bitblit/ratchet-common/logger/logger';
+export class LogLevelManipulationFilter {
+    static LOG_LEVEL_BEFORE_CHANGE = null;
+    static async setLogLevelForTransaction(fCtx) {
+        LogLevelManipulationFilter.LOG_LEVEL_BEFORE_CHANGE = Logger.getLevel();
+        return true;
+    }
+    static async clearLogLevelForTransaction(fCtx) {
+        if (LogLevelManipulationFilter.LOG_LEVEL_BEFORE_CHANGE) {
+            Logger.setLevel(LogLevelManipulationFilter.LOG_LEVEL_BEFORE_CHANGE);
+            LogLevelManipulationFilter.LOG_LEVEL_BEFORE_CHANGE = null;
+            Logger.updateTracePrefix(null);
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=log-level-manipulation-filter.js.map

package/lib/built-in/http/log-level-manipulation-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-level-manipulation-filter.js","sourceRoot":"","sources":["../../../src/built-in/http/log-level-manipulation-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAO/D,MAAM,OAAO,0BAA0B;IAC7B,MAAM,CAAC,uBAAuB,GAAoB,IAAI,CAAC;IAGxD,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,IAAwB;QACpE,0BAA0B,CAAC,uBAAuB,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAEvE,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,IAAwB;QACtE,IAAI,0BAA0B,CAAC,uBAAuB,EAAE,CAAC;YACvD,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAC,uBAAuB,CAAC,CAAC;YACpE,0BAA0B,CAAC,uBAAuB,GAAG,IAAI,CAAC;YAC1D,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC"}

package/lib/built-in/http/run-handler-as-filter.d.ts

@@ -0,0 +1,14 @@
+import { Context } from 'aws-lambda';
+import { ExtendedAPIGatewayEvent } from '../../config/http/extended-api-gateway-event.js';
+import { RouteAndParse } from '../../http/web-handler.js';
+import { NullReturnedObjectHandling } from '../../config/http/null-returned-object-handling.js';
+import { FilterFunction } from '../../config/http/filter-function.js';
+import { FilterChainContext } from '../../config/http/filter-chain-context.js';
+export declare class RunHandlerAsFilter {
+    static runHandler(fCtx: FilterChainContext, rm: RouteAndParse): Promise<boolean>;
+    static applyNullReturnedObjectHandling(result: any, handling: NullReturnedObjectHandling): any;
+    static findHandler(rm: RouteAndParse, event: ExtendedAPIGatewayEvent, context: Context, add404OnMissing?: boolean): Promise<any>;
+    static addRunHandlerAsFilterToList(filters: FilterFunction[], rm: RouteAndParse): void;
+    private static eventToStringForLog;
+    static redact(input: string): string;
+}

package/lib/built-in/http/run-handler-as-filter.js

@@ -0,0 +1,79 @@
+import { Logger } from '@bitblit/ratchet-common/logger/logger';
+import { PromiseRatchet } from '@bitblit/ratchet-common/lang/promise-ratchet';
+import { StringRatchet } from '@bitblit/ratchet-common/lang/string-ratchet';
+import { TimeoutToken } from '@bitblit/ratchet-common/lang/timeout-token';
+import { RestfulApiHttpError } from '@bitblit/ratchet-common/network/restful-api-http-error';
+import { RequestTimeoutError } from '../../http/error/request-timeout-error.js';
+import { ResponseUtil } from '../../http/response-util.js';
+import { NotFoundError } from '../../http/error/not-found-error.js';
+import { NullReturnedObjectHandling } from '../../config/http/null-returned-object-handling.js';
+export class RunHandlerAsFilter {
+    static async runHandler(fCtx, rm) {
+        const handler = RunHandlerAsFilter.findHandler(rm, fCtx.event, fCtx.context);
+        Logger.debug('Processing event with epsilon: %j', RunHandlerAsFilter.eventToStringForLog(fCtx.event));
+        let tmp = await handler;
+        if (TimeoutToken.isTimeoutToken(tmp)) {
+            tmp.writeToLog();
+            throw new RequestTimeoutError('Timed out');
+        }
+        Logger.debug('Initial return value : %j', tmp);
+        tmp = RunHandlerAsFilter.applyNullReturnedObjectHandling(tmp, rm.mapping.metaProcessingConfig.nullReturnedObjectHandling);
+        fCtx.rawResult = tmp;
+        fCtx.result = ResponseUtil.coerceToProxyResult(tmp);
+        return true;
+    }
+    static applyNullReturnedObjectHandling(result, handling) {
+        let rval = result;
+        if (result === null || result === undefined) {
+            if (handling === NullReturnedObjectHandling.Error) {
+                Logger.error('Null object returned and Error specified, throwing 500');
+                throw new RestfulApiHttpError('Null object').withHttpStatusCode(500);
+            }
+            else if (handling === NullReturnedObjectHandling.Return404NotFoundResponse) {
+                throw new NotFoundError('Resource not found');
+            }
+            else if (handling === NullReturnedObjectHandling.ConvertToEmptyString) {
+                Logger.warn('Null object returned from handler and convert not specified, converting to empty string');
+                rval = '';
+            }
+            else {
+                throw new RestfulApiHttpError('Cant happen - failed enum check').withHttpStatusCode(500);
+            }
+        }
+        return rval;
+    }
+    static async findHandler(rm, event, context, add404OnMissing = true) {
+        let rval = null;
+        if (rm) {
+            event.pathParameters = Object.assign({}, event.pathParameters, rm.parsed);
+            rval = PromiseRatchet.timeout(rm.mapping.function(event, context), 'Timed out after ' +
+                rm.mapping.metaProcessingConfig.timeoutMS +
+                ' ms.  Request was ' +
+                RunHandlerAsFilter.eventToStringForLog(event), rm.mapping.metaProcessingConfig.timeoutMS);
+        }
+        else if (add404OnMissing) {
+            throw new NotFoundError('No such endpoint');
+        }
+        return rval;
+    }
+    static addRunHandlerAsFilterToList(filters, rm) {
+        if (filters) {
+            filters.push((fCtx) => RunHandlerAsFilter.runHandler(fCtx, rm));
+        }
+    }
+    static eventToStringForLog(event) {
+        const eventToLog = structuredClone(event);
+        if (eventToLog?.authorization?.raw) {
+            eventToLog.authorization.raw = RunHandlerAsFilter.redact(eventToLog.authorization.raw);
+        }
+        if (eventToLog?.headers?.authorization) {
+            eventToLog.headers.authorization = RunHandlerAsFilter.redact(eventToLog.headers.authorization);
+        }
+        return JSON.stringify(eventToLog);
+    }
+    static redact(input) {
+        const rval = input ? StringRatchet.obscure(input, 1, 1) : input;
+        return rval;
+    }
+}
+//# sourceMappingURL=run-handler-as-filter.js.map

package/lib/built-in/http/run-handler-as-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-handler-as-filter.js","sourceRoot":"","sources":["../../../src/built-in/http/run-handler-as-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAG7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oDAAoD,CAAC;AAIhG,MAAM,OAAO,kBAAkB;IACtB,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAwB,EAAE,EAAiB;QAGxE,MAAM,OAAO,GAAiB,kBAAkB,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3F,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACtG,IAAI,GAAG,GAAQ,MAAM,OAAO,CAAC;QAC7B,IAAI,YAAY,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,GAAoB,CAAC,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;QAC/C,GAAG,GAAG,kBAAkB,CAAC,+BAA+B,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC,0BAA0B,CAAC,CAAC;QAC1H,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAEpD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,+BAA+B,CAAC,MAAW,EAAE,QAAoC;QAC7F,IAAI,IAAI,GAAQ,MAAM,CAAC;QACvB,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5C,IAAI,QAAQ,KAAK,0BAA0B,CAAC,KAAK,EAAE,CAAC;gBAClD,MAAM,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;gBACvE,MAAM,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACvE,CAAC;iBAAM,IAAI,QAAQ,KAAK,0BAA0B,CAAC,yBAAyB,EAAE,CAAC;gBAC7E,MAAM,IAAI,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAChD,CAAC;iBAAM,IAAI,QAAQ,KAAK,0BAA0B,CAAC,oBAAoB,EAAE,CAAC;gBACxE,MAAM,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;gBACvG,IAAI,GAAG,EAAE,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,mBAAmB,CAAC,iCAAiC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,WAAW,CAC7B,EAAiB,EACjB,KAA8B,EAC9B,OAAgB,EAChB,kBAA2B,IAAI;QAE/B,IAAI,IAAI,GAAiB,IAAI,CAAC;QAE9B,IAAI,EAAE,EAAE,CAAC;YAEP,KAAK,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;YAE1E,IAAI,GAAG,cAAc,CAAC,OAAO,CAC3B,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,EACnC,kBAAkB;gBAChB,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC,SAAS;gBACzC,oBAAoB;gBACpB,kBAAkB,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAC/C,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC,SAAS,CAC1C,CAAC;QACJ,CAAC;aAAM,IAAI,eAAe,EAAE,CAAC;YAC3B,MAAM,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,2BAA2B,CAAC,OAAyB,EAAE,EAAiB;QACpF,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,mBAAmB,CAAC,KAAU;QAC3C,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAE1C,IAAI,UAAU,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;YACnC,UAAU,CAAC,aAAa,CAAC,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;YACvC,UAAU,CAAC,OAAO,CAAC,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACjG,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,KAAa;QAChC,MAAM,IAAI,GAAW,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/built-in/index.d.ts

@@ -0,0 +1,26 @@
+export * from './built-in-trace-id-generators.js';
+export * from './background/echo-processor.js';
+export * from './background/log-and-enqueue-echo-processor.js';
+export * from './background/log-message-background-error-processor.js';
+export * from './background/no-op-processor.js';
+export * from './background/retry-processor.js';
+export * from './background/sample-delay-processor.js';
+export * from './background/sample-input-validated-processor-data.js';
+export * from './background/sample-input-validated-processor.js';
+export * from './daemon/daemon-authorizer-function.js';
+export * from './daemon/daemon-config.js';
+export * from './daemon/daemon-group-selection-function.js';
+export * from './daemon/daemon-handler.js';
+export * from './daemon/daemon-process-state-list.js';
+export * from './http/apollo-filter.js';
+export * from './http/built-in-auth-filters.js';
+export * from './http/built-in-authorizers.js';
+export * from './http/built-in-filters.js';
+export * from './http/built-in-handlers.js';
+export * from './http/log-level-manipulation-filter.js';
+export * from './http/run-handler-as-filter.js';
+export * from './http/apollo/apollo-util.js';
+export * from './http/apollo/default-epsilon-apollo-context.js';
+export * from './http/apollo/epsilon-apollo-cors-method.js';
+export * from './http/apollo/epsilon-lambda-apollo-context-function-argument.js';
+export * from './http/apollo/epsilon-lambda-apollo-options.js';

package/lib/built-in/index.js

@@ -0,0 +1,27 @@
+export * from './built-in-trace-id-generators.js';
+export * from './background/echo-processor.js';
+export * from './background/log-and-enqueue-echo-processor.js';
+export * from './background/log-message-background-error-processor.js';
+export * from './background/no-op-processor.js';
+export * from './background/retry-processor.js';
+export * from './background/sample-delay-processor.js';
+export * from './background/sample-input-validated-processor-data.js';
+export * from './background/sample-input-validated-processor.js';
+export * from './daemon/daemon-authorizer-function.js';
+export * from './daemon/daemon-config.js';
+export * from './daemon/daemon-group-selection-function.js';
+export * from './daemon/daemon-handler.js';
+export * from './daemon/daemon-process-state-list.js';
+export * from './http/apollo-filter.js';
+export * from './http/built-in-auth-filters.js';
+export * from './http/built-in-authorizers.js';
+export * from './http/built-in-filters.js';
+export * from './http/built-in-handlers.js';
+export * from './http/log-level-manipulation-filter.js';
+export * from './http/run-handler-as-filter.js';
+export * from './http/apollo/apollo-util.js';
+export * from './http/apollo/default-epsilon-apollo-context.js';
+export * from './http/apollo/epsilon-apollo-cors-method.js';
+export * from './http/apollo/epsilon-lambda-apollo-context-function-argument.js';
+export * from './http/apollo/epsilon-lambda-apollo-options.js';
+//# sourceMappingURL=index.js.map

package/lib/built-in/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/built-in/index.ts"],"names":[],"mappings":"AAIA,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gDAAgD,CAAC;AAC/D,cAAc,wDAAwD,CAAC;AACvE,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uDAAuD,CAAC;AACtE,cAAc,kDAAkD,CAAC;AACjE,cAAc,wCAAwC,CAAC;AACvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uCAAuC,CAAC;AACtD,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yCAAyC,CAAC;AACxD,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iDAAiD,CAAC;AAChE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,kEAAkE,CAAC;AACjF,cAAc,gDAAgD,CAAC"}

package/lib/cli/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ratchet-cli-handler.js';
+export * from './run-background-process-from-command-line.js';

package/lib/cli/index.js

@@ -0,0 +1,3 @@
+export * from './ratchet-cli-handler.js';
+export * from './run-background-process-from-command-line.js';
+//# sourceMappingURL=index.js.map

package/lib/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAIA,cAAc,0BAA0B,CAAC;AACzC,cAAc,+CAA+C,CAAC"}

package/lib/cli/ratchet-cli-handler.d.ts

@@ -0,0 +1,6 @@
+import { AbstractRatchetCliHandler } from '@bitblit/ratchet-node-only/cli/abstract-ratchet-cli-handler';
+import { BuildInformation } from '@bitblit/ratchet-common/build/build-information';
+export declare class RatchetCliHandler extends AbstractRatchetCliHandler {
+    fetchHandlerMap(): Record<string, any>;
+    fetchVersionInfo(): BuildInformation;
+}

package/lib/cli/ratchet-cli-handler.js

@@ -0,0 +1,21 @@
+import { AbstractRatchetCliHandler } from '@bitblit/ratchet-node-only/cli/abstract-ratchet-cli-handler';
+import { RunBackgroundProcessFromCommandLine } from './run-background-process-from-command-line.js';
+import { TestErrorServer } from '../sample/test-error-server.js';
+import { LocalContainerServer } from '../local-container-server.js';
+import { RatchetEpsilonCommonInfo } from '../build/ratchet-epsilon-common-info.js';
+import { LocalServer } from '../local-server.js';
+export class RatchetCliHandler extends AbstractRatchetCliHandler {
+    fetchHandlerMap() {
+        return {
+            'run-background-process': RunBackgroundProcessFromCommandLine.runFromCliArgs,
+            'run-test-error-server': TestErrorServer.runFromCliArgs,
+            'run-local-container-server': LocalContainerServer.runFromCliArgs,
+            'run-sample-local-server': LocalServer.runSampleLocalServerFromCliArgs,
+            'run-sample-local-batch-server': LocalServer.runSampleLocalServerFromCliArgs,
+        };
+    }
+    fetchVersionInfo() {
+        return RatchetEpsilonCommonInfo.buildInformation();
+    }
+}
+//# sourceMappingURL=ratchet-cli-handler.js.map

package/lib/cli/ratchet-cli-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratchet-cli-handler.js","sourceRoot":"","sources":["../../src/cli/ratchet-cli-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6DAA6D,CAAC;AAExG,OAAO,EAAE,mCAAmC,EAAE,MAAM,+CAA+C,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,iBAAkB,SAAQ,yBAAyB;IAC9D,eAAe;QACb,OAAO;YACL,wBAAwB,EAAE,mCAAmC,CAAC,cAAc;YAC5E,uBAAuB,EAAE,eAAe,CAAC,cAAc;YACvD,4BAA4B,EAAE,oBAAoB,CAAC,cAAc;YACjE,yBAAyB,EAAE,WAAW,CAAC,+BAA+B;YACtE,+BAA+B,EAAE,WAAW,CAAC,+BAA+B;SAC7E,CAAC;IACJ,CAAC;IAED,gBAAgB;QACd,OAAO,wBAAwB,CAAC,gBAAgB,EAAE,CAAC;IACrD,CAAC;CACF"}

package/lib/cli/run-background-process-from-command-line.d.ts

@@ -0,0 +1,3 @@
+export declare class RunBackgroundProcessFromCommandLine {
+    static runFromCliArgs(args: string[]): Promise<void>;
+}

package/lib/cli/run-background-process-from-command-line.js

@@ -0,0 +1,23 @@
+import { Logger } from '@bitblit/ratchet-common/logger/logger';
+import { BooleanRatchet } from '@bitblit/ratchet-common/lang/boolean-ratchet';
+export class RunBackgroundProcessFromCommandLine {
+    static async runFromCliArgs(args) {
+        if (args.length > 1) {
+            const procName = args[0];
+            const dryRun = args.length > 1 && BooleanRatchet.parseBool(args[1]);
+            const data = args.length > 2 ? JSON.parse(args[2]) : null;
+            const meta = args.length > 3 ? JSON.parse(args[3]) : null;
+            const epsilon = null;
+            if (dryRun) {
+                Logger.info('Dry-Run, would have sent : %s %j %j', procName, data, meta);
+            }
+            else {
+                await epsilon.processSingleBackgroundByParts(procName, data, meta);
+            }
+        }
+        else {
+            console.log('Usage : run-background-process {processName} {dryRun true/false} {dataJson} {metaJson}');
+        }
+    }
+}
+//# sourceMappingURL=run-background-process-from-command-line.js.map

package/lib/cli/run-background-process-from-command-line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-background-process-from-command-line.js","sourceRoot":"","sources":["../../src/cli/run-background-process-from-command-line.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAW9E,MAAM,OAAO,mCAAmC;IACvC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,IAAc;QAC/C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAW,IAAI,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,MAAM,GAAY,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7E,MAAM,IAAI,GAAQ,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/D,MAAM,IAAI,GAAQ,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/D,MAAM,OAAO,GAAyB,IAAI,CAAC;YAE3C,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,CAAC,8BAA8B,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,wFAAwF,CAAC,CAAC;QACxG,CAAC;IACH,CAAC;CACF"}