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

package/lib/background/background-dynamo-log-table-handler.d.ts

@@ -0,0 +1,11 @@
+import { BackgroundExecutionListener } from './background-execution-listener.js';
+import { BackgroundExecutionEvent } from './background-execution-event.js';
+import { DynamoRatchetLike } from '@bitblit/ratchet-aws/dynamodb/dynamo-ratchet-like';
+export declare class BackgroundDynamoLogTableHandler<T> implements BackgroundExecutionListener<T> {
+    private dynamo;
+    private tableName;
+    private env;
+    private backgroundQueueName;
+    constructor(dynamo: DynamoRatchetLike, tableName: string, env: string, backgroundQueueName: string);
+    onEvent(event: BackgroundExecutionEvent<T>): Promise<void>;
+}

package/lib/background/background-dynamo-log-table-handler.js

@@ -0,0 +1,38 @@
+import { BackgroundExecutionEventType } from './background-execution-event-type.js';
+import { ContextUtil } from '../util/context-util.js';
+export class BackgroundDynamoLogTableHandler {
+    dynamo;
+    tableName;
+    env;
+    backgroundQueueName;
+    constructor(dynamo, tableName, env, backgroundQueueName) {
+        this.dynamo = dynamo;
+        this.tableName = tableName;
+        this.env = env;
+        this.backgroundQueueName = backgroundQueueName;
+    }
+    async onEvent(event) {
+        const entry = {
+            env: this.env,
+            backgroundQueueName: this.backgroundQueueName,
+            requestId: ContextUtil.currentRequestId(),
+            guid: event.guid,
+            processTypeName: event.processorType,
+            state: event.type.toString(),
+            timestampEpochMs: new Date().getTime(),
+        };
+        if (event.type == BackgroundExecutionEventType.DataValidationError) {
+            const errors = event?.errors?.length ? event.errors : ['No-Error'];
+            entry.errors = errors;
+        }
+        else if (event.type == BackgroundExecutionEventType.ProcessStarting) {
+            entry.params = event.data;
+        }
+        else if (event.type == BackgroundExecutionEventType.ExecutionFailedError) {
+            const errors = event?.errors?.length ? event.errors : ['No-Error'];
+            entry.errors = errors;
+        }
+        await this.dynamo.simplePut(this.tableName, entry);
+    }
+}
+//# sourceMappingURL=background-dynamo-log-table-handler.js.map

package/lib/background/background-dynamo-log-table-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-dynamo-log-table-handler.js","sourceRoot":"","sources":["../../src/background/background-dynamo-log-table-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AAGpF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAOtD,MAAM,OAAO,+BAA+B;IAEhC;IACA;IACA;IACA;IAJV,YACU,MAAyB,EACzB,SAAiB,EACjB,GAAW,EACX,mBAA2B;QAH3B,WAAM,GAAN,MAAM,CAAmB;QACzB,cAAS,GAAT,SAAS,CAAQ;QACjB,QAAG,GAAH,GAAG,CAAQ;QACX,wBAAmB,GAAnB,mBAAmB,CAAQ;IAClC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,KAAkC;QAC9C,MAAM,KAAK,GAAmC;YAC5C,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,SAAS,EAAE,WAAW,CAAC,gBAAgB,EAAE;YACzC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,eAAe,EAAE,KAAK,CAAC,aAAa;YACpC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC5B,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE;SACvC,CAAC;QAEF,IAAI,KAAK,CAAC,IAAI,IAAI,4BAA4B,CAAC,mBAAmB,EAAE,CAAC;YACnE,MAAM,MAAM,GAAa,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YAC7E,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACxB,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,IAAI,4BAA4B,CAAC,eAAe,EAAE,CAAC;YACtE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC;QAC5B,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,IAAI,4BAA4B,CAAC,oBAAoB,EAAE,CAAC;YAC3E,MAAM,MAAM,GAAa,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YAC7E,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACxB,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;CACF"}

package/lib/background/background-entry.d.ts

@@ -0,0 +1,4 @@
+export interface BackgroundEntry<T> {
+    type: string;
+    data: T;
+}

package/lib/background/background-entry.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=background-entry.js.map

package/lib/background/background-entry.js.map

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

package/lib/background/background-execution-event-type.d.ts

@@ -0,0 +1,8 @@
+export declare const BackgroundExecutionEventType: {
+    ProcessStarting: string;
+    DataValidationError: string;
+    ExecutionSuccessfullyComplete: string;
+    ExecutionFailedError: string;
+    NoMatchProcessorName: string;
+};
+export type BackgroundExecutionEventType = (typeof BackgroundExecutionEventType)[keyof typeof BackgroundExecutionEventType];

package/lib/background/background-execution-event-type.js

@@ -0,0 +1,8 @@
+export const BackgroundExecutionEventType = {
+    ProcessStarting: 'ProcessStarting',
+    DataValidationError: 'DataValidationError',
+    ExecutionSuccessfullyComplete: 'ExecutionSuccessfullyComplete',
+    ExecutionFailedError: 'ExecutionRuntimeError',
+    NoMatchProcessorName: 'NoMatchProcessorName',
+};
+//# sourceMappingURL=background-execution-event-type.js.map

package/lib/background/background-execution-event-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-execution-event-type.js","sourceRoot":"","sources":["../../src/background/background-execution-event-type.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,eAAe,EAAE,iBAAiB;IAClC,mBAAmB,EAAE,qBAAqB;IAC1C,6BAA6B,EAAE,+BAA+B;IAC9D,oBAAoB,EAAE,uBAAuB;IAC7C,oBAAoB,EAAE,sBAAsB;CAC7C,CAAC"}

package/lib/background/background-execution-event.d.ts

@@ -0,0 +1,8 @@
+import { BackgroundExecutionEventType } from './background-execution-event-type.js';
+export interface BackgroundExecutionEvent<T> {
+    type: BackgroundExecutionEventType;
+    guid: string;
+    processorType: string;
+    data: T;
+    errors?: string[];
+}

package/lib/background/background-execution-event.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=background-execution-event.js.map

package/lib/background/background-execution-event.js.map

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

package/lib/background/background-execution-listener.d.ts

@@ -0,0 +1,5 @@
+import { BackgroundExecutionEvent } from './background-execution-event.js';
+export interface BackgroundExecutionListener<T> {
+    label?: string;
+    onEvent(event: BackgroundExecutionEvent<T>): Promise<void>;
+}

package/lib/background/background-execution-listener.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=background-execution-listener.js.map

package/lib/background/background-execution-listener.js.map

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

package/lib/background/background-handler.d.ts

@@ -0,0 +1,29 @@
+import { Context, ProxyResult, SNSEvent } from 'aws-lambda';
+import { ModelValidator } from '@bitblit/ratchet-misc/model-validator/model-validator';
+import { BackgroundConfig } from '../config/background/background-config.js';
+import { InternalBackgroundEntry } from './internal-background-entry.js';
+import { EpsilonLambdaEventHandler } from '../config/epsilon-lambda-event-handler.js';
+import { BackgroundManagerLike } from './manager/background-manager-like.js';
+export declare class BackgroundHandler implements EpsilonLambdaEventHandler<SNSEvent> {
+    private cfg;
+    private mgr;
+    private modelValidator?;
+    private processors;
+    private validator;
+    constructor(cfg: BackgroundConfig, mgr: BackgroundManagerLike, modelValidator?: ModelValidator);
+    extractLabel(evt: SNSEvent, context: Context): string;
+    handlesEvent(evt: any): boolean;
+    isBackgroundSNSEvent(event: any): boolean;
+    isBackgroundStartSnsEvent(event: any): boolean;
+    isBackgroundImmediateFireEvent(event: any): boolean;
+    parseImmediateFireBackgroundEntry(event: any): InternalBackgroundEntry<any>;
+    processEvent(event: any, context: Context): Promise<ProxyResult>;
+    private takeAndProcessSingleBackgroundQueueEntry;
+    private safeWriteToLogger;
+    private conditionallyStartTransactionLog;
+    private conditionallyCompleteTransactionLog;
+    private conditionallyRunErrorProcessor;
+    private fireListenerEvent;
+    processSingleBackgroundEntry(inE: InternalBackgroundEntry<any>): Promise<boolean>;
+    getConfig(): BackgroundConfig;
+}

package/lib/background/background-handler.js

@@ -0,0 +1,280 @@
+import { Logger } from '@bitblit/ratchet-common/logger/logger';
+import { ErrorRatchet } from '@bitblit/ratchet-common/lang/error-ratchet';
+import { StringRatchet } from '@bitblit/ratchet-common/lang/string-ratchet';
+import { StopWatch } from '@bitblit/ratchet-common/lang/stop-watch';
+import { LambdaEventDetector } from '@bitblit/ratchet-aws/lambda/lambda-event-detector';
+import { EpsilonConstants } from '../epsilon-constants.js';
+import { BackgroundValidator } from './background-validator.js';
+import { BackgroundExecutionEventType } from './background-execution-event-type.js';
+import { ContextUtil } from '../util/context-util.js';
+import { AbstractBackgroundManager } from './manager/abstract-background-manager.js';
+export class BackgroundHandler {
+    cfg;
+    mgr;
+    modelValidator;
+    processors;
+    validator;
+    constructor(cfg, mgr, modelValidator) {
+        this.cfg = cfg;
+        this.mgr = mgr;
+        this.modelValidator = modelValidator;
+        const cfgErrors = BackgroundValidator.validateConfig(cfg);
+        if (cfgErrors.length > 0) {
+            ErrorRatchet.throwFormattedErr('Invalid background config : %j', cfgErrors);
+        }
+        Logger.silly('Starting Background processor, %d processors', cfg.processors.length);
+        this.validator = new BackgroundValidator(cfg, modelValidator);
+        this.processors = BackgroundValidator.validateAndMapProcessors(cfg.processors, modelValidator);
+        if (mgr?.immediateProcessQueue && mgr.immediateProcessQueue()) {
+            Logger.info('Attaching to immediate processing queue');
+            mgr.immediateProcessQueue().subscribe(async (evt) => {
+                Logger.debug('Processing local background entry : %j', evt);
+                const rval = await this.processSingleBackgroundEntry(evt);
+                Logger.info('Processor returned %s', rval);
+            });
+        }
+    }
+    extractLabel(evt, context) {
+        let rval = null;
+        if (this.isBackgroundStartSnsEvent(evt)) {
+            rval = 'BG:START-EVT';
+        }
+        else if (this.isBackgroundImmediateFireEvent(evt)) {
+            const pEvt = this.parseImmediateFireBackgroundEntry(evt);
+            rval = 'BG:' + pEvt.type + ':' + pEvt.guid;
+        }
+        else {
+            rval = 'BG:UNKNOWN';
+        }
+        return rval;
+    }
+    handlesEvent(evt) {
+        return LambdaEventDetector.isValidSnsEvent(evt) && this.isBackgroundSNSEvent(evt);
+    }
+    isBackgroundSNSEvent(event) {
+        return this.isBackgroundStartSnsEvent(event) || this.isBackgroundImmediateFireEvent(event);
+    }
+    isBackgroundStartSnsEvent(event) {
+        let rval = false;
+        if (event) {
+            if (LambdaEventDetector.isSingleSnsEvent(event)) {
+                const cast = event;
+                rval = cast.Records[0].Sns.Message === EpsilonConstants.BACKGROUND_SNS_START_MARKER;
+            }
+        }
+        return rval;
+    }
+    isBackgroundImmediateFireEvent(event) {
+        let rval = false;
+        if (event) {
+            if (LambdaEventDetector.isSingleSnsEvent(event)) {
+                const cast = event;
+                const msg = cast.Records[0].Sns.Message;
+                if (StringRatchet.trimToNull(msg)) {
+                    const parsed = JSON.parse(msg);
+                    rval = !!parsed && parsed['type'] === EpsilonConstants.BACKGROUND_SNS_IMMEDIATE_RUN_FLAG;
+                }
+            }
+        }
+        return rval;
+    }
+    parseImmediateFireBackgroundEntry(event) {
+        let rval = null;
+        try {
+            if (event) {
+                if (LambdaEventDetector.isSingleSnsEvent(event)) {
+                    const cast = event;
+                    const msg = cast.Records[0].Sns.Message;
+                    if (StringRatchet.trimToNull(msg)) {
+                        const parsed = JSON.parse(msg);
+                        if (!!parsed && parsed['type'] === EpsilonConstants.BACKGROUND_SNS_IMMEDIATE_RUN_FLAG) {
+                            rval = parsed['backgroundEntry'];
+                        }
+                    }
+                }
+            }
+        }
+        catch (err) {
+            Logger.error('Could not parse %j as an immediate run event : %s', event, err, err);
+        }
+        return rval;
+    }
+    async processEvent(event, context) {
+        let procd = null;
+        if (!this.isBackgroundStartSnsEvent(event)) {
+            const backgroundEntry = this.parseImmediateFireBackgroundEntry(event);
+            if (backgroundEntry) {
+                Logger.silly('Processing immediate fire event : %j', backgroundEntry);
+                const result = await this.processSingleBackgroundEntry(backgroundEntry);
+                Logger.silly('Result was : %s', result);
+                procd = 1;
+            }
+            else {
+                Logger.warn('Tried to process non-background start / immediate event : %j returning false', event);
+            }
+        }
+        else {
+            Logger.info('Reading task from background queue');
+            procd = await this.takeAndProcessSingleBackgroundQueueEntry();
+            if (procd > 0) {
+                Logger.info('Processed %d elements from background queue, refiring', procd);
+                const refire = await this.mgr.fireStartProcessingRequest();
+                Logger.info('Refire returned %s', refire);
+            }
+            else {
+                Logger.info('No items processed - stopping');
+            }
+        }
+        const rval = {
+            statusCode: 200,
+            body: StringRatchet.safeString(procd),
+            isBase64Encoded: false,
+        };
+        return rval;
+    }
+    async takeAndProcessSingleBackgroundQueueEntry() {
+        let rval = null;
+        const entries = await this.mgr.takeEntryFromBackgroundQueue();
+        Logger.info('Found %d entries - processing', entries.length);
+        for (let i = 0; i < entries.length; i++) {
+            const e = entries[i];
+            const result = await this.processSingleBackgroundEntry(e);
+            rval += result ? 1 : 0;
+        }
+        Logger.debug('Returning %d', rval);
+        return rval;
+    }
+    async safeWriteToLogger(entry) {
+        if (this.cfg.transactionLogger) {
+            try {
+                await this.cfg.transactionLogger.logTransaction(entry);
+            }
+            catch (err) {
+                Logger.error('Failed to write to transaction logger : %j : %s', entry, err, err);
+            }
+        }
+        else {
+            Logger.silly('Skipping - no logger defined');
+        }
+    }
+    async conditionallyStartTransactionLog(e) {
+        if (!StringRatchet.trimToNull(e.guid)) {
+            Logger.warn('No guid found - creating');
+            e.guid = AbstractBackgroundManager.generateBackgroundGuid();
+            const log = {
+                request: e,
+                running: true,
+            };
+            await this.safeWriteToLogger(log);
+        }
+        Logger.debug('Starting transaction log');
+    }
+    async conditionallyCompleteTransactionLog(e, result, error, runtimeMS) {
+        Logger.debug('Completing transaction log');
+        const log = {
+            request: e,
+            result: result,
+            error: error ? ErrorRatchet.safeStringifyErr(error) : null,
+            running: false,
+            runtimeMS: runtimeMS,
+        };
+        await this.safeWriteToLogger(log);
+    }
+    async conditionallyRunErrorProcessor(e, error) {
+        try {
+            if (this.cfg.errorProcessor) {
+                Logger.info('Running error processor');
+                await this.cfg.errorProcessor.handleError(e, error);
+            }
+        }
+        catch (err) {
+            Logger.error('Background : BAD - Failed to run error processor : %s', err, err);
+        }
+    }
+    async fireListenerEvent(event) {
+        const listeners = this.cfg.executionListeners || [];
+        for (const listener of listeners) {
+            try {
+                await listener.onEvent(event);
+            }
+            catch (err) {
+                Logger.error('Failure triggering handler %s : %s', StringRatchet.trimToNull(listener?.label) || 'No-name', err);
+            }
+        }
+    }
+    async processSingleBackgroundEntry(inE) {
+        let e = inE;
+        ContextUtil.setOverrideTraceFromInternalBackgroundEntry(e);
+        Logger.info('Background Process Start: %j', e);
+        const sw = new StopWatch();
+        await this.conditionallyStartTransactionLog(e);
+        if (this?.mgr?.modifyPayloadPreProcess) {
+            Logger.silly('Firing payload pre-process');
+            e = await this.mgr.modifyPayloadPreProcess(e);
+        }
+        let rval = false;
+        try {
+            await this.fireListenerEvent({
+                type: BackgroundExecutionEventType.ProcessStarting,
+                processorType: e.type,
+                data: e.data,
+                guid: e.guid,
+            });
+            const processorInput = this.processors.get(e.type);
+            if (!processorInput) {
+                ErrorRatchet.throwFormattedErr('Found no processor for background entry : %j (returning false)', e);
+                await this.fireListenerEvent({
+                    type: BackgroundExecutionEventType.NoMatchProcessorName,
+                    processorType: e.type,
+                    data: e.data,
+                    guid: e.guid,
+                });
+            }
+            let dataValidationErrors = [];
+            if (StringRatchet.trimToNull(processorInput.dataSchemaName)) {
+                dataValidationErrors = this.modelValidator.validate(processorInput.dataSchemaName, e.data, false, false);
+            }
+            if (dataValidationErrors.length > 0) {
+                await this.fireListenerEvent({
+                    type: BackgroundExecutionEventType.DataValidationError,
+                    processorType: e.type,
+                    data: e.data,
+                    errors: dataValidationErrors,
+                    guid: e.guid,
+                });
+                ErrorRatchet.throwFormattedErr('Not processing, data failed validation; entry was %j : errors : %j', e, dataValidationErrors);
+            }
+            else {
+                let result = await processorInput.handleEvent(e.data, this.mgr);
+                result = result || 'SUCCESSFUL COMPLETION : NO RESULT RETURNED';
+                await this.conditionallyCompleteTransactionLog(e, result, null, sw.elapsedMS());
+                await this.fireListenerEvent({
+                    type: BackgroundExecutionEventType.ExecutionSuccessfullyComplete,
+                    processorType: e.type,
+                    data: result,
+                    guid: e.guid,
+                });
+                rval = true;
+            }
+        }
+        catch (err) {
+            Logger.error('Background Process Error: %j : %s', e, err, err);
+            await this.conditionallyRunErrorProcessor(e, err);
+            await this.conditionallyCompleteTransactionLog(e, null, err, sw.elapsedMS());
+            await this.fireListenerEvent({
+                type: BackgroundExecutionEventType.ExecutionFailedError,
+                processorType: e.type,
+                data: e.data,
+                errors: [ErrorRatchet.safeStringifyErr(err)],
+                guid: e.guid,
+            });
+        }
+        Logger.info('Background Process Stop: %j : %s', e, sw.dump());
+        return rval;
+    }
+    getConfig() {
+        const rval = Object.assign({}, this.cfg);
+        return rval;
+    }
+}
+//# sourceMappingURL=background-handler.js.map

package/lib/background/background-handler.js.map

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

package/lib/background/background-http-adapter-handler.d.ts

@@ -0,0 +1,22 @@
+import { Context } from 'aws-lambda';
+import { ExtendedAPIGatewayEvent } from '../config/http/extended-api-gateway-event.js';
+import { BackgroundQueueResponseInternal } from './background-queue-response-internal.js';
+import { BackgroundConfig } from '../config/background/background-config.js';
+import { ModelValidator } from '@bitblit/ratchet-misc/model-validator/model-validator';
+import { BackgroundMetaResponseInternal } from './background-meta-response-internal.js';
+import { BackgroundTransactionLog } from '../config/background/background-transaction-log.js';
+import { BackgroundManagerLike } from './manager/background-manager-like.js';
+export declare class BackgroundHttpAdapterHandler {
+    private backgroundConfig;
+    private modelValidator;
+    private backgroundManager;
+    private maxWaitInMsForBackgroundJobToStart;
+    constructor(backgroundConfig: BackgroundConfig, modelValidator: ModelValidator, backgroundManager: BackgroundManagerLike, maxWaitInMsForBackgroundJobToStart?: number);
+    get httpMetaEndpoint(): string;
+    get httpSubmissionPath(): string;
+    get httpStatusPath(): string;
+    get implyTypeFromPathSuffix(): boolean;
+    handleBackgroundStatusRequest(evt: ExtendedAPIGatewayEvent, context: Context): Promise<BackgroundTransactionLog>;
+    handleBackgroundMetaRequest(evt: ExtendedAPIGatewayEvent, context: Context): Promise<BackgroundMetaResponseInternal>;
+    handleBackgroundSubmission(evt: ExtendedAPIGatewayEvent, context: Context): Promise<BackgroundQueueResponseInternal>;
+}

package/lib/background/background-http-adapter-handler.js

@@ -0,0 +1,129 @@
+import { Logger } from '@bitblit/ratchet-common/logger/logger';
+import { BackgroundProcessHandling } from './background-process-handling.js';
+import { BadRequestError } from '../http/error/bad-request-error.js';
+import { NotFoundError } from '../http/error/not-found-error.js';
+import { PromiseRatchet } from '@bitblit/ratchet-common/lang/promise-ratchet';
+import { StringRatchet } from '@bitblit/ratchet-common/lang/string-ratchet';
+import { StopWatch } from '@bitblit/ratchet-common/lang/stop-watch';
+import { BooleanRatchet } from '@bitblit/ratchet-common/lang/boolean-ratchet';
+export class BackgroundHttpAdapterHandler {
+    backgroundConfig;
+    modelValidator;
+    backgroundManager;
+    maxWaitInMsForBackgroundJobToStart;
+    constructor(backgroundConfig, modelValidator, backgroundManager, maxWaitInMsForBackgroundJobToStart = 10_000) {
+        this.backgroundConfig = backgroundConfig;
+        this.modelValidator = modelValidator;
+        this.backgroundManager = backgroundManager;
+        this.maxWaitInMsForBackgroundJobToStart = maxWaitInMsForBackgroundJobToStart;
+    }
+    get httpMetaEndpoint() {
+        return this.backgroundConfig.httpMetaEndpoint;
+    }
+    get httpSubmissionPath() {
+        return this.backgroundConfig.httpSubmissionPath;
+    }
+    get httpStatusPath() {
+        return this.backgroundConfig.httpStatusEndpoint;
+    }
+    get implyTypeFromPathSuffix() {
+        return this.backgroundConfig.implyTypeFromPathSuffix;
+    }
+    async handleBackgroundStatusRequest(evt, context) {
+        Logger.info('handleBackgroundStatusRequest called');
+        if (!this.backgroundConfig.transactionLogger) {
+            throw new BadRequestError('Process logging not enabled');
+        }
+        else {
+            const guid = StringRatchet.trimToNull(evt.pathParameters['guid']) || StringRatchet.trimToNull(evt.queryStringParameters['guid']);
+            if (guid) {
+                const sw = new StopWatch();
+                let log = null;
+                while (!log && sw.elapsedMS() < this.maxWaitInMsForBackgroundJobToStart) {
+                    log = await this.backgroundConfig.transactionLogger.readTransactionLog(guid);
+                    if (!log) {
+                        Logger.debug('No log found yet, waiting 500 ms and retrying (%s of %d waited so far)', sw.dump(), this.maxWaitInMsForBackgroundJobToStart);
+                        await PromiseRatchet.wait(500);
+                    }
+                }
+                if (!log) {
+                    throw new NotFoundError().withFormattedErrorMessage('No background result found for guid %s', guid);
+                }
+                return log;
+            }
+            else {
+                throw new BadRequestError('No guid specified');
+            }
+        }
+    }
+    async handleBackgroundMetaRequest(evt, context) {
+        Logger.info('handleBackgroundMetaRequest called');
+        const currentCount = await this.backgroundManager.fetchApproximateNumberOfQueueEntries();
+        const valid = this.backgroundConfig.processors.map((b) => b.typeName).filter((a) => !!a);
+        valid.sort((a, b) => a.localeCompare(b));
+        const rval = {
+            currentQueueLength: currentCount,
+            validTypes: valid,
+            backgroundManagerName: this.backgroundManager.backgroundManagerName,
+        };
+        return rval;
+    }
+    async handleBackgroundSubmission(evt, context) {
+        Logger.info('handleBackgroundSubmission : %j (mgr:%s)', evt.parsedBody, this.backgroundManager.backgroundManagerName);
+        let rval = null;
+        const startIdx = evt.path.indexOf(this.httpSubmissionPath) + this.httpSubmissionPath.length;
+        let pathSuppliedBackgroundType = this.backgroundConfig.implyTypeFromPathSuffix
+            ? evt.path.substring(startIdx).split('-').join('').toLowerCase()
+            : '';
+        if (pathSuppliedBackgroundType.includes('?')) {
+            pathSuppliedBackgroundType = pathSuppliedBackgroundType.substring(0, pathSuppliedBackgroundType.indexOf('?'));
+        }
+        if (pathSuppliedBackgroundType.includes('#')) {
+            pathSuppliedBackgroundType = pathSuppliedBackgroundType.substring(0, pathSuppliedBackgroundType.indexOf('#'));
+        }
+        const entry = evt.parsedBody || {};
+        if (StringRatchet.trimToNull(pathSuppliedBackgroundType)) {
+            if (StringRatchet.trimToNull(entry?.type) && entry.type.toLocaleLowerCase() !== pathSuppliedBackgroundType.toLocaleLowerCase()) {
+                throw new BadRequestError('Background submission has type but does not match path supplied type');
+            }
+            else {
+                entry.type = pathSuppliedBackgroundType;
+            }
+        }
+        else {
+            if (!StringRatchet.trimToNull(entry?.type)) {
+                throw new BadRequestError('Background submission missing type and not configured in pathed mode');
+            }
+        }
+        const foundProc = this.backgroundConfig.processors.find((s) => s.typeName.toLowerCase() === entry.type.toLowerCase());
+        const immediate = BooleanRatchet.parseBool(evt.queryStringParameters['immediate']);
+        const startProcessor = BooleanRatchet.parseBool(evt.queryStringParameters['startProcessor']);
+        if (foundProc) {
+            if (StringRatchet.trimToNull(foundProc.dataSchemaName)) {
+                const errors = this.modelValidator.validate(foundProc.dataSchemaName, entry.data, false, false);
+                if (errors.length > 0) {
+                    throw new BadRequestError().withErrors(errors);
+                }
+            }
+            let result = null;
+            if (immediate) {
+                result = await this.backgroundManager.fireImmediateProcessRequest(entry);
+            }
+            else {
+                result = await this.backgroundManager.addEntryToQueue(entry, startProcessor);
+            }
+            rval = {
+                processHandling: immediate ? BackgroundProcessHandling.Immediate : BackgroundProcessHandling.Queued,
+                startProcessorRequested: startProcessor,
+                success: true,
+                resultId: result,
+                error: null,
+            };
+        }
+        else {
+            throw new BadRequestError().withFormattedErrorMessage('Could not find target background processor : %s', entry.type);
+        }
+        return rval;
+    }
+}
+//# sourceMappingURL=background-http-adapter-handler.js.map

package/lib/background/background-http-adapter-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-http-adapter-handler.js","sourceRoot":"","sources":["../../src/background/background-http-adapter-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAK/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAIrE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAM9E,MAAM,OAAO,4BAA4B;IAE7B;IACA;IACA;IACA;IAJV,YACU,gBAAkC,EAClC,cAA8B,EAC9B,iBAAwC,EACxC,qCAA6C,MAAM;QAHnD,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,mBAAc,GAAd,cAAc,CAAgB;QAC9B,sBAAiB,GAAjB,iBAAiB,CAAuB;QACxC,uCAAkC,GAAlC,kCAAkC,CAAiB;IAC1D,CAAC;IAEJ,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC;IAChD,CAAC;IAED,IAAW,kBAAkB;QAC3B,OAAO,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC;IAClD,CAAC;IAED,IAAW,cAAc;QACvB,OAAO,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC;IAClD,CAAC;IAED,IAAW,uBAAuB;QAChC,OAAO,IAAI,CAAC,gBAAgB,CAAC,uBAAuB,CAAC;IACvD,CAAC;IAEM,KAAK,CAAC,6BAA6B,CAAC,GAA4B,EAAE,OAAgB;QACvF,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,CAAC;YAC7C,MAAM,IAAI,eAAe,CAAC,6BAA6B,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GACR,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;YACtH,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,EAAE,GAAc,IAAI,SAAS,EAAE,CAAC;gBACtC,IAAI,GAAG,GAA6B,IAAI,CAAC;gBACzC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,kCAAkC,EAAE,CAAC;oBACxE,GAAG,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;oBAC7E,IAAI,CAAC,GAAG,EAAE,CAAC;wBACT,MAAM,CAAC,KAAK,CACV,wEAAwE,EACxE,EAAE,CAAC,IAAI,EAAE,EACT,IAAI,CAAC,kCAAkC,CACxC,CAAC;wBACF,MAAM,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,MAAM,IAAI,aAAa,EAAE,CAAC,yBAAyB,CAAC,wCAAwC,EAAE,IAAI,CAAC,CAAC;gBACtG,CAAC;gBACD,OAAO,GAAG,CAAC;YACb,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,eAAe,CAAC,mBAAmB,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,2BAA2B,CAAC,GAA4B,EAAE,OAAgB;QACrF,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAClD,MAAM,YAAY,GAAW,MAAM,IAAI,CAAC,iBAAiB,CAAC,oCAAoC,EAAE,CAAC;QACjG,MAAM,KAAK,GAAa,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,IAAI,GAAmC;YAC3C,kBAAkB,EAAE,YAAY;YAChC,UAAU,EAAE,KAAK;YACjB,qBAAqB,EAAE,IAAI,CAAC,iBAAiB,CAAC,qBAAqB;SACpE,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,0BAA0B,CAAC,GAA4B,EAAE,OAAgB;QACpF,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;QAEtH,IAAI,IAAI,GAAoC,IAAI,CAAC;QAEjD,MAAM,QAAQ,GAAW,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC;QACpG,IAAI,0BAA0B,GAAW,IAAI,CAAC,gBAAgB,CAAC,uBAAuB;YACpF,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;YAChE,CAAC,CAAC,EAAE,CAAC;QAEP,IAAI,0BAA0B,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,0BAA0B,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAChH,CAAC;QACD,IAAI,0BAA0B,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,0BAA0B,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAChH,CAAC;QAED,MAAM,KAAK,GAAyB,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QAMzD,IAAI,aAAa,CAAC,UAAU,CAAC,0BAA0B,CAAC,EAAE,CAAC;YACzD,IAAI,aAAa,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,0BAA0B,CAAC,iBAAiB,EAAE,EAAE,CAAC;gBAC/H,MAAM,IAAI,eAAe,CAAC,sEAAsE,CAAC,CAAC;YACpG,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,GAAG,0BAA0B,CAAC;YAC1C,CAAC;QACH,CAAC;aAAM,CAAC;YAEN,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,eAAe,CAAC,sEAAsE,CAAC,CAAC;YACpG,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAA6B,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAC/E,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAC7D,CAAC;QACF,MAAM,SAAS,GAAY,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC;QAC5F,MAAM,cAAc,GAAY,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAEtG,IAAI,SAAS,EAAE,CAAC;YAGd,IAAI,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;gBAEvD,MAAM,MAAM,GAAa,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC1G,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtB,MAAM,IAAI,eAAe,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;YAED,IAAI,MAAM,GAAW,IAAI,CAAC;YAC1B,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;YAC/E,CAAC;YAED,IAAI,GAAG;gBACL,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,MAAM;gBACnG,uBAAuB,EAAE,cAAc;gBACvC,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,eAAe,EAAE,CAAC,yBAAyB,CAAC,iDAAiD,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/background/background-meta-response-internal.d.ts

@@ -0,0 +1,5 @@
+export interface BackgroundMetaResponseInternal {
+    backgroundManagerName: string;
+    currentQueueLength: number;
+    validTypes: string[];
+}

package/lib/background/background-meta-response-internal.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=background-meta-response-internal.js.map

package/lib/background/background-meta-response-internal.js.map

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

package/lib/background/background-process-handling.d.ts

@@ -0,0 +1,5 @@
+export declare const BackgroundProcessHandling: {
+    Queued: string;
+    Immediate: string;
+};
+export type BackgroundProcessHandling = (typeof BackgroundProcessHandling)[keyof typeof BackgroundProcessHandling];