@leanstacks/lambda-utils 0.1.0-alpha.4 → 0.1.0-alpha.5

package/.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: Continuous Integration
+
+on:
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  ci:
+    name: Build, Lint, and Test
+
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint code
+        run: npm run lint
+
+      - name: Check code formatting
+        run: npm run format:check
+
+      - name: Build
+        run: npm run build
+
+      - name: Run tests with coverage
+        run: npm run test:coverage

package/.github/workflows/publish.yml

@@ -0,0 +1,51 @@
+name: Publish
+
+on:
+  release:
+    types:
+      - published
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}
+  cancel-in-progress: false
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  build:
+    name: Build and Publish
+
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint code
+        run: npm run lint
+
+      - name: Check code formatting
+        run: npm run format:check
+
+      - name: Run tests
+        run: npm run test
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish
+        run: npm publish

package/.husky/pre-commit

@@ -0,0 +1,3 @@
+npm test
+npm run format:check
+npm run lint

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { Logger, LoggerConfig, withRequestTracking } from './logging/logger';

package/dist/index.esm.js

@@ -0,0 +1,2 @@
+import e from"pino";import{lambdaRequestTracker as n,StructuredLogFormatter as t,CloudwatchLogFormatter as o,pinoLambdaDestination as i}from"pino-lambda";const l=n();class r{constructor(n){this._loggerConfig={enabled:!0,level:"info",format:"json"},this._instance=null,this._createLogger=()=>{const n="json"===this._loggerConfig.format?new t:new o,l=i({formatter:n});return e({enabled:this._loggerConfig.enabled,level:this._loggerConfig.level},l)},n&&(this._loggerConfig={enabled:n.enabled??!0,level:n.level??"info",format:n.format??"json"})}get instance(){return null===this._instance&&(this._instance=this._createLogger()),this._instance}}export{r as Logger,l as withRequestTracking};
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,2 @@
+"use strict";var e=require("pino"),t=require("pino-lambda");const n=t.lambdaRequestTracker();exports.Logger=class{constructor(n){this._loggerConfig={enabled:!0,level:"info",format:"json"},this._instance=null,this._createLogger=()=>{const n="json"===this._loggerConfig.format?new t.StructuredLogFormatter:new t.CloudwatchLogFormatter,r=t.pinoLambdaDestination({formatter:n});return e({enabled:this._loggerConfig.enabled,level:this._loggerConfig.level},r)},n&&(this._loggerConfig={enabled:n.enabled??!0,level:n.level??"info",format:n.format??"json"})}get instance(){return null===this._instance&&(this._instance=this._createLogger()),this._instance}},exports.withRequestTracking=n;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/logging/logger.d.ts

@@ -0,0 +1,59 @@
+import pino from 'pino';
+/**
+ * Logger middleware which adds AWS Lambda attributes to log messages.
+ *
+ * @example
+ * ```typescript
+ * import { withRequestTracking } from '@leanstacks/lambda-utils';
+ *
+ * export const handler = async (event, context) => {
+ *   withRequestTracking(event, context);
+ *
+ *   // Your Lambda handler logic here
+ * };
+ * ```
+ */
+export declare const withRequestTracking: (event: import("pino-lambda").LambdaEvent, context: import("pino-lambda").LambdaContext) => void;
+/**
+ * Configuration options for the Logger
+ */
+export interface LoggerConfig {
+    /** Whether logging is enabled */
+    enabled?: boolean;
+    /** Minimum log level (e.g., 'debug', 'info', 'warn', 'error') */
+    level?: 'debug' | 'info' | 'warn' | 'error';
+    /** Output format: 'json' for StructuredLogFormatter, 'text' for CloudwatchLogFormatter */
+    format?: 'json' | 'text';
+}
+/**
+ * Logger class which provides a Pino logger instance with AWS Lambda attributes.
+ *
+ * @example
+ * ```typescript
+ * import { Logger } from '@leanstacks/lambda-utils';
+ * const logger = new Logger().instance;
+ *
+ * logger.info('Hello, world!');
+ * ```
+ */
+export declare class Logger {
+    private _loggerConfig;
+    private _instance;
+    constructor(config?: LoggerConfig);
+    /**
+     * Creates a new, fully configured Pino logger instance.
+     */
+    private _createLogger;
+    /**
+     * Get the logger instance.
+     *
+     * @example
+     * ```typescript
+     * import { Logger } from '@leanstacks/lambda-utils';
+     * const logger = new Logger().instance;
+     *
+     * logger.info('Hello, world!');
+     * ```
+     */
+    get instance(): pino.Logger;
+}

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@leanstacks/lambda-utils",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.5",
   "description": "A collection of utilities and helper functions designed to streamline the development of AWS Lambda functions using TypeScript.",
   "main": "dist/index.js",
+  "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "rollup -c",
@@ -12,6 +13,7 @@
     "format:check": "prettier --check \"src/**/*.ts\"",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
+    "prepare": "husky",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage"
@@ -27,16 +29,21 @@
   "license": "MIT",
   "devDependencies": {
     "@eslint/js": "9.39.2",
+    "@rollup/plugin-commonjs": "29.0.0",
+    "@rollup/plugin-node-resolve": "16.0.3",
+    "@rollup/plugin-terser": "0.4.4",
     "@types/aws-lambda": "8.10.159",
     "@types/jest": "30.0.0",
     "@types/node": "25.0.3",
     "@typescript-eslint/eslint-plugin": "8.50.0",
     "@typescript-eslint/parser": "8.50.0",
     "eslint": "9.39.2",
+    "husky": "9.1.7",
     "jest": "30.2.0",
     "prettier": "3.7.4",
     "rimraf": "6.1.2",
     "rollup": "4.53.5",
+    "rollup-plugin-peer-deps-external": "2.2.4",
     "rollup-plugin-typescript2": "0.36.0",
     "ts-jest": "29.4.6",
     "ts-node": "10.9.2",

package/rollup.config.js

@@ -1,18 +1,34 @@
+import commonjs from '@rollup/plugin-commonjs';
+import { nodeResolve } from '@rollup/plugin-node-resolve';
+import terser from '@rollup/plugin-terser';
+import peerDepsExternal from 'rollup-plugin-peer-deps-external';
 import typescript from 'rollup-plugin-typescript2';
 
+import packageJson from './package.json' with { type: 'json' };
+
 export default {
   input: 'src/index.ts',
   output: [
     {
-      file: 'dist/index.js',
+      file: packageJson.main,
+      format: 'cjs',
+      sourcemap: true,
+    },
+    {
+      file: packageJson.module,
       format: 'esm',
+      sourcemap: true,
     },
   ],
-  external: ['pino', 'pino-lambda', 'zod', '@aws-sdk/client-dynamodb', '@aws-sdk/client-lambda'],
   plugins: [
+    peerDepsExternal(),
+    nodeResolve(),
+    commonjs(),
     typescript({
       tsconfig: 'tsconfig.json',
       clean: true,
     }),
+    terser(),
   ],
+  external: [...Object.keys(packageJson.dependencies || {})],
 };