sdk-logs 0.6.13 → 0.8.0

package/dist/domain.operations/outlets/cloudwatch/asLambdaStyleLogGroupName.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asLambdaStyleLogGroupName = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * .what = generates a lambda-style log group name
+ * .why = CloudWatch log groups follow `/aws/lambda/{service}-{env}` pattern
+ *
+ * .note = performs I/O when service is not provided:
+ *         - reads package.json from cwd for service name
+ *         - reads env vars (ENVIRONMENT_ACCESS, ENV_ACCESS, STAGE, NODE_ENV) for env.access
+ *         for pure usage, pass both service and env.access explicitly.
+ *
+ * @param service - service name (default: reads from package.json)
+ * @param env.access - environment access level (default: from env vars, fallback 'local')
+ */
+const asLambdaStyleLogGroupName = ({ service, env, } = {}) => {
+    const serviceName = service ?? getPackageJsonName();
+    const envAccess = env?.access ?? getEnvironmentAccessFromEnvVar();
+    return `/aws/lambda/${serviceName}-${envAccess}`;
+};
+exports.asLambdaStyleLogGroupName = asLambdaStyleLogGroupName;
+/**
+ * .what = reads package name from package.json in cwd
+ * .why = service name defaults to package name for consistency
+ */
+const getPackageJsonName = () => {
+    try {
+        const pkgPath = (0, path_1.join)(process.cwd(), 'package.json');
+        const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, 'utf-8'));
+        return pkg.name ?? 'unknown-service';
+    }
+    catch (error) {
+        // allowlist: file not found or parse errors are expected in some environments
+        if (error instanceof Error &&
+            (error.message.includes('ENOENT') ||
+                error.message.includes('Unexpected token') ||
+                error.message.includes('JSON'))) {
+            return 'unknown-service';
+        }
+        throw error;
+    }
+};
+/**
+ * .what = reads environment access from env var
+ * .why = enables environment-specific log groups (test, prep, prod)
+ */
+const getEnvironmentAccessFromEnvVar = () => {
+    // check common env var patterns
+    return (process.env.ENVIRONMENT_ACCESS ??
+        process.env.ENV_ACCESS ??
+        process.env.STAGE ??
+        process.env.NODE_ENV ??
+        'local');
+};
+//# sourceMappingURL=asLambdaStyleLogGroupName.js.map

package/dist/domain.operations/outlets/cloudwatch/asLambdaStyleLogGroupName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asLambdaStyleLogGroupName.js","sourceRoot":"","sources":["../../../../src/domain.operations/outlets/cloudwatch/asLambdaStyleLogGroupName.ts"],"names":[],"mappings":";;;AAAA,2BAAkC;AAClC,+BAA4B;AAE5B;;;;;;;;;;;GAWG;AACI,MAAM,yBAAyB,GAAG,CAAC,EACxC,OAAO,EACP,GAAG,MAID,EAAE,EAAU,EAAE;IAChB,MAAM,WAAW,GAAG,OAAO,IAAI,kBAAkB,EAAE,CAAC;IACpD,MAAM,SAAS,GAAG,GAAG,EAAE,MAAM,IAAI,8BAA8B,EAAE,CAAC;IAClE,OAAO,eAAe,WAAW,IAAI,SAAS,EAAE,CAAC;AACnD,CAAC,CAAC;AAVW,QAAA,yBAAyB,6BAUpC;AAEF;;;GAGG;AACH,MAAM,kBAAkB,GAAG,GAAW,EAAE;IACtC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,OAAO,GAAG,CAAC,IAAI,IAAI,iBAAiB,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,8EAA8E;QAC9E,IACE,KAAK,YAAY,KAAK;YACtB,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC/B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBAC1C,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EACjC,CAAC;YACD,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,8BAA8B,GAAG,GAAW,EAAE;IAClD,gCAAgC;IAChC,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAC9B,OAAO,CAAC,GAAG,CAAC,UAAU;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK;QACjB,OAAO,CAAC,GAAG,CAAC,QAAQ;QACpB,OAAO,CACR,CAAC;AACJ,CAAC,CAAC"}

package/dist/domain.operations/outlets/cloudwatch/assertAwsCredentialsPresent.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = validates AWS credentials are available via common sources
+ * .why = fail-fast at outlet creation rather than on first flush
+ *
+ * .note = checks env vars and shared credentials file.
+ *         async credential providers (SSO, IAM roles) are validated on first flush.
+ */
+export declare const assertAwsCredentialsPresent: () => void;

package/dist/domain.operations/outlets/cloudwatch/assertAwsCredentialsPresent.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertAwsCredentialsPresent = void 0;
+const error_fns_1 = require("@ehmpathy/error-fns");
+/**
+ * .what = validates AWS credentials are available via common sources
+ * .why = fail-fast at outlet creation rather than on first flush
+ *
+ * .note = checks env vars and shared credentials file.
+ *         async credential providers (SSO, IAM roles) are validated on first flush.
+ */
+const assertAwsCredentialsPresent = () => {
+    // check env var credentials (most common in non-Lambda environments)
+    const hasEnvCredentials = process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY;
+    // check if profile is specified (indicates shared credentials or SSO)
+    const hasProfile = process.env.AWS_PROFILE;
+    // check if role ARN is specified (indicates assume-role config)
+    const hasRoleArn = process.env.AWS_ROLE_ARN;
+    // check if web identity is configured (EKS/IRSA)
+    const hasWebIdentity = process.env.AWS_WEB_IDENTITY_TOKEN_FILE && process.env.AWS_ROLE_ARN;
+    // check if container credentials are configured (ECS/Fargate)
+    const hasContainerCredentials = process.env.AWS_CONTAINER_CREDENTIALS_RELATIVE_URI ||
+        process.env.AWS_CONTAINER_CREDENTIALS_FULL_URI;
+    // check if in EC2/Lambda (metadata service provides credentials)
+    const hasMetadataService = process.env.AWS_EXECUTION_ENV;
+    // if none of the common credential sources are present, fail fast
+    if (!hasEnvCredentials &&
+        !hasProfile &&
+        !hasRoleArn &&
+        !hasWebIdentity &&
+        !hasContainerCredentials &&
+        !hasMetadataService) {
+        throw new error_fns_1.BadRequestError('AWS credentials not configured. genCloudwatchOutlet requires valid AWS credentials.', {
+            hint: [
+                'configure credentials via one of:',
+                '  - env: AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY',
+                '  - env: AWS_PROFILE (for shared credentials or SSO)',
+                '  - env: AWS_WEB_IDENTITY_TOKEN_FILE + AWS_ROLE_ARN (for EKS/IRSA)',
+                '  - container: execute in ECS/Fargate with task role',
+                '  - metadata: execute in EC2/Lambda with instance/execution role',
+            ].join('\n'),
+        });
+    }
+};
+exports.assertAwsCredentialsPresent = assertAwsCredentialsPresent;
+//# sourceMappingURL=assertAwsCredentialsPresent.js.map

package/dist/domain.operations/outlets/cloudwatch/assertAwsCredentialsPresent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertAwsCredentialsPresent.js","sourceRoot":"","sources":["../../../../src/domain.operations/outlets/cloudwatch/assertAwsCredentialsPresent.ts"],"names":[],"mappings":";;;AAAA,mDAAsD;AAEtD;;;;;;GAMG;AACI,MAAM,2BAA2B,GAAG,GAAS,EAAE;IACpD,qEAAqE;IACrE,MAAM,iBAAiB,GACrB,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IAErE,sEAAsE;IACtE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAE3C,gEAAgE;IAChE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAE5C,iDAAiD;IACjD,MAAM,cAAc,GAClB,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAEtE,8DAA8D;IAC9D,MAAM,uBAAuB,GAC3B,OAAO,CAAC,GAAG,CAAC,sCAAsC;QAClD,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC;IAEjD,iEAAiE;IACjE,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAEzD,kEAAkE;IAClE,IACE,CAAC,iBAAiB;QAClB,CAAC,UAAU;QACX,CAAC,UAAU;QACX,CAAC,cAAc;QACf,CAAC,uBAAuB;QACxB,CAAC,kBAAkB,EACnB,CAAC;QACD,MAAM,IAAI,2BAAe,CACvB,qFAAqF,EACrF;YACE,IAAI,EAAE;gBACJ,mCAAmC;gBACnC,oDAAoD;gBACpD,sDAAsD;gBACtD,oEAAoE;gBACpE,sDAAsD;gBACtD,kEAAkE;aACnE,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CACF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AA9CW,QAAA,2BAA2B,+BA8CtC"}

package/dist/domain.operations/outlets/cloudwatch/computeLogEventSize.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = computes the serialized size of a log event
+ * .why = enables amortized O(1) buffer size checks via incremental sum
+ *
+ * .note = this function is O(n) where n = serialized size.
+ *         call once per send() and track sum to avoid full buffer re-serialize.
+ */
+export declare const computeLogEventSize: (event: object) => number;

package/dist/domain.operations/outlets/cloudwatch/computeLogEventSize.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeLogEventSize = void 0;
+/**
+ * .what = computes the serialized size of a log event
+ * .why = enables amortized O(1) buffer size checks via incremental sum
+ *
+ * .note = this function is O(n) where n = serialized size.
+ *         call once per send() and track sum to avoid full buffer re-serialize.
+ */
+const computeLogEventSize = (event) => {
+    return JSON.stringify(event).length + 1; // +1 for array comma separator
+};
+exports.computeLogEventSize = computeLogEventSize;
+//# sourceMappingURL=computeLogEventSize.js.map

package/dist/domain.operations/outlets/cloudwatch/computeLogEventSize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeLogEventSize.js","sourceRoot":"","sources":["../../../../src/domain.operations/outlets/cloudwatch/computeLogEventSize.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACI,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAU,EAAE;IAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,+BAA+B;AAC1E,CAAC,CAAC;AAFW,QAAA,mBAAmB,uBAE9B"}

package/dist/domain.operations/outlets/cloudwatch/drainBuffer.d.ts

@@ -0,0 +1,6 @@
+import type { LogEvent } from '../../../domain.objects/LogOutlet';
+/**
+ * .what = extracts all events from buffer and clears it
+ * .why = extracts decode-friction from orchestrator (splice atomically removes and returns)
+ */
+export declare const drainBuffer: (buffer: LogEvent[]) => LogEvent[];

package/dist/domain.operations/outlets/cloudwatch/drainBuffer.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.drainBuffer = void 0;
+/**
+ * .what = extracts all events from buffer and clears it
+ * .why = extracts decode-friction from orchestrator (splice atomically removes and returns)
+ */
+const drainBuffer = (buffer) => {
+    return buffer.splice(0, buffer.length);
+};
+exports.drainBuffer = drainBuffer;
+//# sourceMappingURL=drainBuffer.js.map

package/dist/domain.operations/outlets/cloudwatch/drainBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drainBuffer.js","sourceRoot":"","sources":["../../../../src/domain.operations/outlets/cloudwatch/drainBuffer.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACI,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAc,EAAE;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC,CAAC;AAFW,QAAA,WAAW,eAEtB"}

package/dist/domain.operations/outlets/cloudwatch/genCloudwatchOutlet.d.ts

@@ -0,0 +1,24 @@
+import type { LogOutlet } from '../../../domain.objects/LogOutlet';
+/**
+ * .what = generates a CloudWatch outlet for log events
+ * .why = enables log events to flow to CloudWatch in environments without automatic collection
+ *
+ * .note = explicit opt-in: add this outlet only when automatic log collection is absent.
+ *         AWS Lambda and CloudWatch Agent environments auto-collect console.log output.
+ *         in those environments, omit this outlet to avoid duplicate logs.
+ *
+ * @param region - AWS region (required: from option or AWS_REGION/AWS_DEFAULT_REGION env)
+ * @param logGroup - CloudWatch log group name (default: /aws/lambda/{service}-{env})
+ * @param logStream - CloudWatch log stream name (default: Lambda-style YYYY/MM/DD/[$LATEST]uuid)
+ * @param skipLogGroupCreation - skip log group findsert (default: false)
+ * @param flushInterval - auto-flush interval in ms (default: 5000)
+ * @param maxBufferSize - buffer size threshold in bytes for force-flush (default: 256000)
+ */
+export declare const genCloudwatchOutlet: ({ region: regionOverride, logGroup, logStream, skipLogGroupCreation, flushInterval, maxBufferSize, }?: {
+    region?: string;
+    logGroup?: string;
+    logStream?: string;
+    skipLogGroupCreation?: boolean;
+    flushInterval?: number;
+    maxBufferSize?: number;
+}) => LogOutlet;

package/dist/domain.operations/outlets/cloudwatch/genCloudwatchOutlet.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genCloudwatchOutlet = void 0;
+const client_cloudwatch_logs_1 = require("@aws-sdk/client-cloudwatch-logs");
+const asCloudWatchBatches_1 = require("./asCloudWatchBatches");
+const asCloudWatchLogEvents_1 = require("./asCloudWatchLogEvents");
+const asDefaultLogStreamName_1 = require("./asDefaultLogStreamName");
+const asLambdaStyleLogGroupName_1 = require("./asLambdaStyleLogGroupName");
+const assertAwsCredentialsPresent_1 = require("./assertAwsCredentialsPresent");
+const computeLogEventSize_1 = require("./computeLogEventSize");
+const drainBuffer_1 = require("./drainBuffer");
+/**
+ * .what = generates a CloudWatch outlet for log events
+ * .why = enables log events to flow to CloudWatch in environments without automatic collection
+ *
+ * .note = explicit opt-in: add this outlet only when automatic log collection is absent.
+ *         AWS Lambda and CloudWatch Agent environments auto-collect console.log output.
+ *         in those environments, omit this outlet to avoid duplicate logs.
+ *
+ * @param region - AWS region (required: from option or AWS_REGION/AWS_DEFAULT_REGION env)
+ * @param logGroup - CloudWatch log group name (default: /aws/lambda/{service}-{env})
+ * @param logStream - CloudWatch log stream name (default: Lambda-style YYYY/MM/DD/[$LATEST]uuid)
+ * @param skipLogGroupCreation - skip log group findsert (default: false)
+ * @param flushInterval - auto-flush interval in ms (default: 5000)
+ * @param maxBufferSize - buffer size threshold in bytes for force-flush (default: 256000)
+ */
+const genCloudwatchOutlet = ({ region: regionOverride, logGroup, logStream, skipLogGroupCreation, flushInterval, maxBufferSize, } = {}) => {
+    // validate AWS credentials are present (fail-fast)
+    (0, assertAwsCredentialsPresent_1.assertAwsCredentialsPresent)();
+    // derive region (explicit > env > fail-fast)
+    const region = regionOverride ?? process.env.AWS_REGION ?? process.env.AWS_DEFAULT_REGION;
+    if (!region) {
+        throw new Error('CloudWatch outlet requires AWS region. Set AWS_REGION env var or pass region option.');
+    }
+    // derive defaults
+    const logGroupName = logGroup ?? (0, asLambdaStyleLogGroupName_1.asLambdaStyleLogGroupName)();
+    const logStreamName = logStream ?? (0, asDefaultLogStreamName_1.asDefaultLogStreamName)();
+    // create client
+    const client = new client_cloudwatch_logs_1.CloudWatchLogsClient({ region });
+    // buffer for events
+    const buffer = [];
+    let bufferSize = 0; // track size incrementally for O(1) checks
+    let initialized = false;
+    let flushPromise = null;
+    // setup auto-flush with explicit crash on error
+    const intervalMs = flushInterval ?? 5000; // 5s default for faster emission
+    const bufferLimit = maxBufferSize ?? 256000; // 256KB default for frequent flushes
+    const flushTimer = setInterval(() => {
+        flush().catch((error) => {
+            console.error('CloudWatch flush failed:', error);
+            process.exit(1);
+        });
+    }, intervalMs);
+    flushTimer.unref(); // allow process to exit despite timer
+    // register process exit hooks (beforeExit keeps event loop alive for promises)
+    const handleExitFlush = () => {
+        flush()
+            .catch((error) => {
+            console.error('CloudWatch flush failed during exit:', error);
+        })
+            .finally(() => {
+            close();
+        });
+    };
+    process.once('beforeExit', handleExitFlush);
+    // signal handlers: flush then exit (promise chain keeps event loop alive)
+    let exitInProgress = false;
+    const handleSignalExit = (exitCode) => {
+        if (exitInProgress)
+            return;
+        exitInProgress = true;
+        flush()
+            .catch((error) => {
+            console.error('CloudWatch flush failed during signal exit:', error);
+        })
+            .finally(() => {
+            close();
+            process.exit(exitCode);
+        });
+    };
+    const handleSigterm = () => handleSignalExit(143); // 128 + 15 (SIGTERM)
+    const handleSigint = () => handleSignalExit(130); // 128 + 2 (SIGINT)
+    process.once('SIGTERM', handleSigterm);
+    process.once('SIGINT', handleSigint);
+    /**
+     * .what = close the outlet and release resources
+     * .why = cleans up timers and process listeners to prevent leaks in tests
+     */
+    const close = () => {
+        clearInterval(flushTimer);
+        process.removeListener('beforeExit', handleExitFlush);
+        process.removeListener('SIGTERM', handleSigterm);
+        process.removeListener('SIGINT', handleSigint);
+    };
+    /**
+     * .what = findsert log group
+     * .why = idempotent creation via ResourceAlreadyExistsException
+     */
+    const findsertLogGroup = async () => {
+        try {
+            await client.send(new client_cloudwatch_logs_1.CreateLogGroupCommand({ logGroupName }));
+        }
+        catch (error) {
+            if (error instanceof client_cloudwatch_logs_1.ResourceAlreadyExistsException)
+                return;
+            throw error;
+        }
+    };
+    /**
+     * .what = findsert log stream
+     * .why = idempotent creation via ResourceAlreadyExistsException
+     */
+    const findsertLogStream = async () => {
+        try {
+            await client.send(new client_cloudwatch_logs_1.CreateLogStreamCommand({ logGroupName, logStreamName }));
+        }
+        catch (error) {
+            if (error instanceof client_cloudwatch_logs_1.ResourceAlreadyExistsException)
+                return;
+            throw error;
+        }
+    };
+    /**
+     * .what = initialize log group and stream
+     * .why = lazy initialization on first flush
+     */
+    const init = async () => {
+        if (initialized)
+            return;
+        if (!skipLogGroupCreation)
+            await findsertLogGroup();
+        await findsertLogStream();
+        initialized = true;
+    };
+    /**
+     * .what = flush buffered events to CloudWatch
+     * .why = batch send for efficiency (max 1MB, 10k events per CloudWatch limits)
+     *
+     * .invariant = single-flush-at-a-time via flushPromise
+     *   - concurrent flush() calls wait on extant flushPromise
+     *   - after wait, recheck buffer for events added mid-flush
+     *   - recursive call handles events that arrived while awaited
+     *   - prevents concurrent PutLogEvents calls (CloudWatch sequence token issues)
+     */
+    const flush = async () => {
+        // if no events, skip
+        if (buffer.length === 0)
+            return;
+        // if flush in progress, wait then recheck for new events
+        if (flushPromise) {
+            await flushPromise;
+            if (buffer.length > 0)
+                return flush(); // recheck for events added while wait
+            return;
+        }
+        // start flush
+        flushPromise = (async () => {
+            // extract events from buffer (restore on failure)
+            const events = (0, drainBuffer_1.drainBuffer)(buffer);
+            const eventsSizeSnapshot = bufferSize;
+            bufferSize = 0;
+            try {
+                await init();
+                // split into CloudWatch-compliant batches (max 1MB, 10k events each)
+                const batches = (0, asCloudWatchBatches_1.asCloudWatchBatches)(events);
+                for (const batch of batches) {
+                    await client.send(new client_cloudwatch_logs_1.PutLogEventsCommand({
+                        logGroupName,
+                        logStreamName,
+                        logEvents: (0, asCloudWatchLogEvents_1.asCloudWatchLogEvents)(batch),
+                    }));
+                }
+            }
+            catch (error) {
+                // restore events to buffer on failure (prepend to preserve order)
+                buffer.unshift(...events);
+                bufferSize += eventsSizeSnapshot;
+                throw error;
+            }
+            finally {
+                flushPromise = null;
+            }
+        })();
+        await flushPromise;
+    };
+    return {
+        send: (event) => {
+            // track size incrementally (O(1) vs O(n) for full buffer stringify)
+            const eventSize = (0, computeLogEventSize_1.computeLogEventSize)(event);
+            bufferSize += eventSize;
+            buffer.push(event);
+            // force-flush if buffer exceeds size limit (explicit crash on error)
+            if (bufferSize > bufferLimit) {
+                flush().catch((error) => {
+                    console.error('CloudWatch flush failed:', error);
+                    process.exit(1);
+                });
+            }
+        },
+        flush,
+        close,
+    };
+};
+exports.genCloudwatchOutlet = genCloudwatchOutlet;
+//# sourceMappingURL=genCloudwatchOutlet.js.map

package/dist/domain.operations/outlets/cloudwatch/genCloudwatchOutlet.js.map

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

package/dist/domain.operations/withLogTrail.d.ts

@@ -1,5 +1,5 @@
 import { type IsoDuration } from 'iso-time';
-import type { LogLevel } from '../domain.objects/constants';
+import { LogLevel } from '../domain.objects/constants';
 import type { ContextLogTrail } from '../domain.objects/LogTrail';
 /**
  * enables input output logging and tracing for a method

package/dist/domain.operations/withLogTrail.js

@@ -4,6 +4,8 @@ exports.withLogTrail = void 0;
 const helpful_errors_1 = require("helpful-errors");
 const iso_time_1 = require("iso-time");
 const type_fns_1 = require("type-fns");
+const constants_1 = require("../domain.objects/constants");
+const generateLogMethod_1 = require("./generateLogMethod");
 const noOp = (...input) => input;
 const omitContext = (...input) => input[0]; // standard pattern for args = [input, context]
 const pickErrorMessage = (input) => ({
@@ -58,17 +60,53 @@ const withLogTrail = (logic, { name: declaredName, log: logOptions, duration = {
         });
         // begin tracking duration
         const startTimeInMilliseconds = new Date().getTime();
+        // build the updated trail: preserve exid, append name to stack
+        const updatedTrail = {
+            exid: context.log.trail?.exid ?? null,
+            stack: [...(context.log.trail?.stack ?? []), name],
+        };
+        // extract env from context (top-level property)
+        const env = context.log.env;
+        // use level from context
+        const minimalLogLevel = context.log._.level;
+        // create base log methods with updated trail
+        const baseDebug = (0, generateLogMethod_1.generateLogMethod)({
+            level: constants_1.LogLevel.DEBUG,
+            minimalLogLevel,
+            trail: updatedTrail,
+            env,
+        });
+        const baseInfo = (0, generateLogMethod_1.generateLogMethod)({
+            level: constants_1.LogLevel.INFO,
+            minimalLogLevel,
+            trail: updatedTrail,
+            env,
+        });
+        const baseWarn = (0, generateLogMethod_1.generateLogMethod)({
+            level: constants_1.LogLevel.WARN,
+            minimalLogLevel,
+            trail: updatedTrail,
+            env,
+        });
+        const baseError = (0, generateLogMethod_1.generateLogMethod)({
+            level: constants_1.LogLevel.ERROR,
+            minimalLogLevel,
+            trail: updatedTrail,
+            env,
+        });
         // define the context.log method that will be given to the logic
         const logMethodsWithContext = {
-            // add the trail
-            trail: [...(context.log.trail ?? []), name],
+            // add the trail, env, and config
+            trail: updatedTrail,
+            env,
+            _: Object.freeze({ level: minimalLogLevel }),
             // track the orig logger
             _orig: context.log?._orig ?? context.log,
-            // add the scoped methods
-            debug: (message, metadata) => context.log.debug(`${name}.progress: ${message}`, metadata),
-            info: (message, metadata) => context.log.info(`${name}.progress: ${message}`, metadata),
-            warn: (message, metadata) => context.log.warn(`${name}.progress: ${message}`, metadata),
-            error: (message, metadata) => context.log.error(`${name}.progress: ${message}`, metadata),
+            // add the scoped methods with message prefix
+            debug: (message, metadata) => baseDebug(`${name}.progress: ${message}`, metadata),
+            info: (message, metadata) => baseInfo(`${name}.progress: ${message}`, metadata),
+            warn: (message, metadata) => baseWarn(`${name}.progress: ${message}`, metadata),
+            error: (message, metadata) => baseError(`${name}.progress: ${message}`, metadata),
         };
         // define what to do when we have an error
         const logError = (error) => {
@@ -97,22 +135,6 @@ const withLogTrail = (logic, { name: declaredName, log: logOptions, duration = {
                 logError(error);
             throw error;
         }
-        // if the result was a promise, log when that method crosses the reporting threshold, to identify which procedures are slow
-        if ((0, type_fns_1.isAPromise)(result)) {
-            // define how to log the breach, on breach
-            const onDurationBreach = () => context.log[logLevelOutput](`${name}.duration.breach`, {
-                input: logInputMethod(input, context),
-                already: { duration: `${durationReportingThresholdInSeconds} sec` },
-            });
-            // define a timeout which will trigger on duration threshold
-            const onBreachTrigger = setTimeout(onDurationBreach, durationReportingThresholdInSeconds * 1000);
-            // remove the timeout when the operation completes, to prevent logging if completes before duration
-            void result
-                .finally(() => clearTimeout(onBreachTrigger))
-                .catch(() => {
-                // do nothing when there's an error; just catch it, to ensure it doesn't get propagated further as an uncaught exception
-            });
-        }
         // define what to do when we have output
         const logOutput = (output) => {
             const endTimeInMilliseconds = new Date().getTime();
@@ -126,9 +148,18 @@ const withLogTrail = (logic, { name: declaredName, log: logOptions, duration = {
                     : {}),
             });
         };
-        // if result is a promise, ensure we log after the output resolves
-        if ((0, type_fns_1.isAPromise)(result))
+        // if the result was a promise, log when that method crosses the threshold, to identify which procedures are slow
+        if ((0, type_fns_1.isAPromise)(result)) {
+            // define how to log the breach, on breach
+            const onDurationBreach = () => context.log[logLevelOutput](`${name}.duration.breach`, {
+                input: logInputMethod(input, context),
+                already: { duration: `${durationReportingThresholdInSeconds} sec` },
+            });
+            // define a timeout which will trigger on duration threshold
+            const onBreachTrigger = setTimeout(onDurationBreach, durationReportingThresholdInSeconds * 1000);
+            // clear timeout when promise settles, then log output or error
             return result
+                .finally(() => clearTimeout(onBreachTrigger))
                 .then((output) => {
                 logOutput(output);
                 return output;
@@ -137,7 +168,8 @@ const withLogTrail = (logic, { name: declaredName, log: logOptions, duration = {
                 logError(error);
                 throw error;
             });
-        // otherwise, its not a promise, so its done, so log now and return the result
+        }
+        // otherwise, not a promise, so done now — log and return the result
         logOutput(result);
         return result;
     };

package/dist/domain.operations/withLogTrail.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,11 @@
 export { LogLevel } from './domain.objects/constants';
+export type { LogEvent, LogOutlet } from './domain.objects/LogOutlet';
 export type { ContextLogTrail, HasContextLogTrail, LogTrail, } from './domain.objects/LogTrail';
+export { genContextLogTrail } from './domain.operations/genContextLogTrail';
 export type { LogMethod } from './domain.operations/generateLogMethod';
-export type { LogMethods } from './domain.operations/generateLogMethods';
-export { generateLogMethods } from './domain.operations/generateLogMethods';
+export type { LogMethods } from './domain.operations/genLogMethods';
+export { genLogMethods } from './domain.operations/genLogMethods';
+export { asDefaultLogStreamName } from './domain.operations/outlets/cloudwatch/asDefaultLogStreamName';
+export { asLambdaStyleLogGroupName } from './domain.operations/outlets/cloudwatch/asLambdaStyleLogGroupName';
+export { genCloudwatchOutlet } from './domain.operations/outlets/cloudwatch/genCloudwatchOutlet';
 export { withLogTrail } from './domain.operations/withLogTrail';

package/dist/index.js

@@ -1,10 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withLogTrail = exports.generateLogMethods = exports.LogLevel = void 0;
+exports.withLogTrail = exports.genCloudwatchOutlet = exports.asLambdaStyleLogGroupName = exports.asDefaultLogStreamName = exports.genLogMethods = exports.genContextLogTrail = exports.LogLevel = void 0;
 var constants_1 = require("./domain.objects/constants");
 Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return constants_1.LogLevel; } });
-var generateLogMethods_1 = require("./domain.operations/generateLogMethods");
-Object.defineProperty(exports, "generateLogMethods", { enumerable: true, get: function () { return generateLogMethods_1.generateLogMethods; } });
+var genContextLogTrail_1 = require("./domain.operations/genContextLogTrail");
+Object.defineProperty(exports, "genContextLogTrail", { enumerable: true, get: function () { return genContextLogTrail_1.genContextLogTrail; } });
+var genLogMethods_1 = require("./domain.operations/genLogMethods");
+Object.defineProperty(exports, "genLogMethods", { enumerable: true, get: function () { return genLogMethods_1.genLogMethods; } });
+var asDefaultLogStreamName_1 = require("./domain.operations/outlets/cloudwatch/asDefaultLogStreamName");
+Object.defineProperty(exports, "asDefaultLogStreamName", { enumerable: true, get: function () { return asDefaultLogStreamName_1.asDefaultLogStreamName; } });
+var asLambdaStyleLogGroupName_1 = require("./domain.operations/outlets/cloudwatch/asLambdaStyleLogGroupName");
+Object.defineProperty(exports, "asLambdaStyleLogGroupName", { enumerable: true, get: function () { return asLambdaStyleLogGroupName_1.asLambdaStyleLogGroupName; } });
+var genCloudwatchOutlet_1 = require("./domain.operations/outlets/cloudwatch/genCloudwatchOutlet");
+Object.defineProperty(exports, "genCloudwatchOutlet", { enumerable: true, get: function () { return genCloudwatchOutlet_1.genCloudwatchOutlet; } });
 var withLogTrail_1 = require("./domain.operations/withLogTrail");
 Object.defineProperty(exports, "withLogTrail", { enumerable: true, get: function () { return withLogTrail_1.withLogTrail; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,wDAAsD;AAA7C,qGAAA,QAAQ,OAAA;AAQjB,6EAA4E;AAAnE,wHAAA,kBAAkB,OAAA;AAC3B,iEAAgE;AAAvD,4GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,wDAAsD;AAA7C,qGAAA,QAAQ,OAAA;AAOjB,6EAA4E;AAAnE,wHAAA,kBAAkB,OAAA;AAG3B,mEAAkE;AAAzD,8GAAA,aAAa,OAAA;AACtB,wGAAuG;AAA9F,gIAAA,sBAAsB,OAAA;AAC/B,8GAA6G;AAApG,sIAAA,yBAAyB,OAAA;AAClC,kGAAiG;AAAxF,0HAAA,mBAAmB,OAAA;AAC5B,iEAAgE;AAAvD,4GAAA,YAAY,OAAA"}