@karmaniverous/smoz 0.2.8 → 0.2.10

package/README.md

@@ -1,81 +1,82 @@
-<div align="center">
-
-# SMOZ
-
-[Serverless](https://www.serverless.com/) · [Middy](https://middy.js.org/) · [OpenAPI 3.1](https://spec.openapis.org/oas/latest.html) · [Zod](https://zod.dev/)
-
-[![npm version](https://img.shields.io/npm/v/@karmaniverous/smoz.svg)](https://www.npmjs.com/package/@karmaniverous/smoz)
-![Node Current](https://img.shields.io/node/v/@karmaniverous/smoz)
-[![docs](https://img.shields.io/badge/docs-website-blue)](https://docs.karmanivero.us/smoz)
-[![changelog](https://img.shields.io/badge/changelog-latest-blue.svg)](https://github.com/karmaniverous/smoz/tree/main/CHANGELOG.md)
-[![license](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](https://github.com/karmaniverous/smoz/tree/main/LICENSE.md)
-
-</div>
-
-SMOZ is a small, pragmatic toolkit for authoring AWS Lambda handlers with [Middy] and [Zod], then aggregating Serverless functions and hand‑crafted OpenAPI 3.1 paths from a single, schema‑first application definition.
-
-- Keep prod code testable and framework‑agnostic
-- HTTP middleware with validation, shaping, errors, CORS, negotiation, and HEAD
-- Non‑HTTP flows stay lean (no middleware overhead)
-
-## Quick start (from zero)
-
-From an empty directory:
-
-```bash
-npx @karmaniverous/smoz init -i
-npx smoz dev -p 3000
-```
-
-- The first command scaffolds a new app and installs dependencies (including a local `smoz` bin).
-- The second command starts the inline local backend and keeps registers + OpenAPI fresh.
-- Open http://localhost:3000/openapi in your browser.
-
-Prefer `serverless‑offline`?
-
-```bash
-npx smoz dev -l offline -p 3000
-```
-
-Add your first endpoint (avoid clashing with the template’s hello):
-
-```bash
-npx smoz add rest/foo/get
-```
-
-## Quick links
- 
-- [Overview](https://docs.karmanivero.us/smoz/documents/Overview.html)
-- [Why smoz?](https://docs.karmanivero.us/smoz/documents/Why_smoz_.html)
-- [Getting started](https://docs.karmanivero.us/smoz/documents/Getting_started.html)
-- [10-minute tour](https://docs.karmanivero.us/smoz/documents/10%E2%80%91minute_tour.html)
-- [HTTP Middleware](https://docs.karmanivero.us/smoz/documents/HTTP_middleware.html)
-- [Recipes](https://docs.karmanivero.us/smoz/documents/Recipes.html)
-  - [SQS function](https://docs.karmanivero.us/smoz/documents/Recipes.SQS_function.html)
-  - [Contexts + Cognito authorizer](https://docs.karmanivero.us/smoz/documents/Recipes.Contexts_+_Cognito_authorizer.html)  - [Custom middleware insertion](https://docs.karmanivero.us/smoz/documents/Recipes.Custom_middleware_insertion.html)
-  - [Per‑function env](<https://docs.karmanivero.us/smoz/documents/Recipes.Per%E2%80%91function_env_(fnEnvKeys).html>)
-  - [Observability](<https://docs.karmanivero.us/smoz/documents/Recipes.Observability_(requestId_header).html>)
-  - [Troubleshooting](https://docs.karmanivero.us/smoz/documents/Recipes.Troubleshooting.html)
-- [Templates](https://docs.karmanivero.us/smoz/documents/Templates.html)
-- [CLI](https://docs.karmanivero.us/smoz/documents/CLI.html)
-- [Contributing](https://docs.karmanivero.us/smoz/documents/Contributing.html)
-
-## Install
-
-```bash
-npm i @karmaniverous/smoz zod zod-openapi
-```
-
-## Dev tooling (recommended):
-
-```bash
-npm i -D typescript typescript-eslint eslint prettier typedoc
-```
-
-## Docs and reference
-
-- [Docs site](https://docs.karmanivero.us/smoz)
-- [Changelog](https://github.com/karmaniverous/smoz/tree/main/CHANGELOG.md)
-- [License](https://github.com/karmaniverous/smoz/tree/main/LICENSE.md)
-- [Middy](https://middy.js.org/)
-- [Zod](https://zod.dev/)
+<div align="center">
+
+# SMOZ
+
+[Serverless](https://www.serverless.com/) · [Middy](https://middy.js.org/) · [OpenAPI 3.1](https://spec.openapis.org/oas/latest.html) · [Zod](https://zod.dev/)
+
+[![npm version](https://img.shields.io/npm/v/@karmaniverous/smoz.svg)](https://www.npmjs.com/package/@karmaniverous/smoz)
+![Node Current](https://img.shields.io/node/v/@karmaniverous/smoz)
+[![docs](https://img.shields.io/badge/docs-website-blue)](https://docs.karmanivero.us/smoz)
+[![changelog](https://img.shields.io/badge/changelog-latest-blue.svg)](https://github.com/karmaniverous/smoz/tree/main/CHANGELOG.md)
+[![license](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](https://github.com/karmaniverous/smoz/tree/main/LICENSE.md)
+
+</div>
+
+SMOZ is a small, pragmatic toolkit for authoring AWS Lambda handlers with [Middy] and [Zod], then aggregating Serverless functions and hand‑crafted OpenAPI 3.1 paths from a single, schema‑first application definition.
+
+- Keep prod code testable and framework‑agnostic
+- HTTP middleware with validation, shaping, errors, CORS, negotiation, and HEAD
+- Non‑HTTP flows stay lean (no middleware overhead)
+
+## Quick start (from zero)
+
+From an empty directory:
+
+```bash
+npx @karmaniverous/smoz init -i
+npx smoz dev -p 3000
+```
+
+- The first command scaffolds a new app and installs dependencies (including a local `smoz` bin).
+- The second command starts the inline local backend and keeps registers + OpenAPI fresh.
+- Open http://localhost:3000/openapi in your browser.
+
+Prefer `serverless‑offline`?
+
+```bash
+npx smoz dev -l offline -p 3000
+```
+
+Add your first endpoint (avoid clashing with the template’s hello):
+
+```bash
+npx smoz add rest/foo/get
+```
+
+## Quick links
+
+- [Overview](https://docs.karmanivero.us/smoz/documents/Overview.html)
+- [Why smoz?](https://docs.karmanivero.us/smoz/documents/Why_smoz_.html)
+- [Getting started](https://docs.karmanivero.us/smoz/documents/Getting_started.html)
+- [10-minute tour](https://docs.karmanivero.us/smoz/documents/10%E2%80%91minute_tour.html)
+- [HTTP Middleware](https://docs.karmanivero.us/smoz/documents/HTTP_middleware.html)
+- [Recipes](https://docs.karmanivero.us/smoz/documents/Recipes.html)
+  - [SQS function](https://docs.karmanivero.us/smoz/documents/Recipes.SQS_function.html)
+  - [Step Functions function](https://docs.karmanivero.us/smoz/documents/Recipes.Step_function.html)
+  - [Contexts + Cognito authorizer](https://docs.karmanivero.us/smoz/documents/Recipes.Contexts_+_Cognito_authorizer.html) - [Custom middleware insertion](https://docs.karmanivero.us/smoz/documents/Recipes.Custom_middleware_insertion.html)
+  - [Per‑function env](<https://docs.karmanivero.us/smoz/documents/Recipes.Per%E2%80%91function_env_(fnEnvKeys).html>)
+  - [Observability](<https://docs.karmanivero.us/smoz/documents/Recipes.Observability_(requestId_header).html>)
+  - [Troubleshooting](https://docs.karmanivero.us/smoz/documents/Recipes.Troubleshooting.html)
+- [Templates](https://docs.karmanivero.us/smoz/documents/Templates.html)
+- [CLI](https://docs.karmanivero.us/smoz/documents/CLI.html)
+- [Contributing](https://docs.karmanivero.us/smoz/documents/Contributing.html)
+
+## Install
+
+```bash
+npm i @karmaniverous/smoz zod zod-openapi
+```
+
+## Dev tooling (recommended):
+
+```bash
+npm i -D typescript typescript-eslint eslint prettier typedoc
+```
+
+## Docs and reference
+
+- [Docs site](https://docs.karmanivero.us/smoz)
+- [Changelog](https://github.com/karmaniverous/smoz/tree/main/CHANGELOG.md)
+- [License](https://github.com/karmaniverous/smoz/tree/main/LICENSE.md)
+- [Middy](https://middy.js.org/)
+- [Zod](https://zod.dev/)

package/dist/cjs/index.js

@@ -30,12 +30,23 @@ const baseEventTypeMapSchema = zod.z.object({
     firehose: zod.z.custom(),
     // eslint-disable-next-line @typescript-eslint/no-deprecated -- Upstream AWS types mark this as deprecated; we retain the token for compatibility with existing apps.
     'cognito-userpool': zod.z.custom(),
+    /**
+     * Step Functions → Lambda (Service Integration: Lambda Invoke)
+     *
+     * When Step Functions invokes Lambda via the AWS SDK integration
+     * (e.g., "arn:aws:states:::lambda:invoke"), the event received by the
+     * Lambda handler is an object that wraps the original input under a
+     * "Payload" key. The Payload is already parsed JSON.
+     *
+     * Notes:
+     * - We accept additional keys (e.g., StatusCode/ExecutedVersion in some
+     *   patterns) via passthrough.
+     * - For the common “request/response” integration where Step Functions
+     *   passes state directly, apps can still treat the event via their
+     *   own app-local event map if needed.
+     */
+    step: zod.z.object({ Payload: zod.z.unknown().optional() }).catchall(zod.z.unknown()),
 });
-// Notes:
-// - This list intentionally includes widely used, generic AWS events.
-// - Apps can extend the schema with custom or specialized tokens:
-//     const EventMap = baseEventTypeMapSchema.extend({ step: z.custom<MyStepEvent>() })
-// - Only tokens listed in your App's httpEventTypeTokens are treated as HTTP by the runtime.
 
 /**
  * Stage artifacts factory.
@@ -1043,10 +1054,10 @@ const buildAllServerlessFunctions = (registry, serverless, buildFnEnv) => {
 /**
  * App (schema‑first)
  *
+ * Overloads on create() preserve strong inference when eventTypeMapSchema is omitted.
  * Central orchestrator for a SMOZ application. You provide:
  * - Global/stage parameter schemas and env exposure keys
- * - Serverless defaults (handler filename/export and context map)
- * - Event‑type map schema (extendable: e.g., add 'step')
+ * - Serverless defaults (handler filename/export and context map) * - Event‑type map schema (extendable: e.g., add 'step')
  *
  * The instance:
  * - Validates configuration
@@ -1130,6 +1141,7 @@ const buildAllServerlessFunctions = (registry, serverless, buildFnEnv) => {
      * @param init - initialization object (schemas, serverless defaults, params/envKeys)
      * @returns a new App instance
      */
+    // Implementation (must come after overload signatures)
     static create(init) {
         return new App(init);
     }
@@ -1137,9 +1149,7 @@ const buildAllServerlessFunctions = (registry, serverless, buildFnEnv) => {
      * Register a function (HTTP or non‑HTTP).
      *
      * @typeParam EventType      - A key from your eventTypeMapSchema (e.g., 'rest' | 'http' | 'sqs' | 'step')
-     * @typeParam EventSchema    - Optional Zod schema validated BEFORE the handler (refines event shape)
-     * @typeParam ResponseSchema - Optional Zod schema validated AFTER the handler (refines response shape)
-     * @param options - per‑function configuration (method/basePath/httpContexts for HTTP; serverless extras for non‑HTTP)
+     * @typeParam EventSchema    - Optional Zod schema validated BEFORE the handler (refines event shape)   * @typeParam ResponseSchema - Optional Zod schema validated AFTER the handler (refines response shape)   * @param options - per‑function configuration (method/basePath/httpContexts for HTTP; serverless extras for non‑HTTP)
      * @returns a per‑function API: { handler(business), openapi(baseOperation), serverless(extras) }
      */
     defineFunction(options) {

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { ZodOpenApiOperationObject, ZodOpenApiPathItemObject, ZodOpenApiPathsObject } from 'zod-openapi';
 import * as aws_lambda from 'aws-lambda';
-import { APIGatewayProxyEvent, Context, APIGatewayProxyEventV2, ALBEvent, SQSEvent, SNSEvent, S3Event, DynamoDBStreamEvent, KinesisStreamEvent, EventBridgeEvent, CloudWatchLogsEvent, SESEvent, CloudFrontRequestEvent, FirehoseTransformationEvent, CognitoUserPoolTriggerEvent } from 'aws-lambda';
+import { APIGatewayProxyEvent, APIGatewayProxyEventV2, ALBEvent, SQSEvent, SNSEvent, S3Event, DynamoDBStreamEvent, KinesisStreamEvent, EventBridgeEvent, CloudWatchLogsEvent, SESEvent, CloudFrontRequestEvent, FirehoseTransformationEvent, CognitoUserPoolTriggerEvent, Context } from 'aws-lambda';
 import { AWS } from '@serverless/typescript';
-import { ZodObject, ZodRawShape, z } from 'zod';
+import { z, ZodObject, ZodRawShape } from 'zod';
 import { MiddlewareObj } from '@middy/core';
 import httpContentNegotiation from '@middy/http-content-negotiation';
 import httpCors from '@middy/http-cors';
@@ -35,6 +35,39 @@ type MakeRequired<T extends object, U extends keyof T> = {
  */
 type BaseOperation = MakeRequired<Omit<ZodOpenApiOperationObject, 'operationId'>, 'summary'>;
 
+/**
+ * baseEventTypeMapSchema
+ * - Schema-first companion to BaseEventTypeMap.
+ * - Now includes a Step Functions event with an optional Payload wrapper.
+ * - Ensures z.infer<typeof baseEventTypeMapSchema> === BaseEventTypeMap.
+ *
+ * @remarks * Consumers typically extend this schema when creating an App to add
+ * project‑local event tokens (e.g., 'step').
+ * Only tokens listed in the app’s `httpEventTypeTokens` are treated as HTTP at runtime.
+ */
+
+declare const baseEventTypeMapSchema: z.ZodObject<{
+    rest: z.ZodCustom<APIGatewayProxyEvent, APIGatewayProxyEvent>;
+    http: z.ZodCustom<APIGatewayProxyEventV2, APIGatewayProxyEventV2>;
+    alb: z.ZodCustom<ALBEvent, ALBEvent>;
+    sqs: z.ZodCustom<SQSEvent, SQSEvent>;
+    sns: z.ZodCustom<SNSEvent, SNSEvent>;
+    s3: z.ZodCustom<S3Event, S3Event>;
+    dynamodb: z.ZodCustom<DynamoDBStreamEvent, DynamoDBStreamEvent>;
+    kinesis: z.ZodCustom<KinesisStreamEvent, KinesisStreamEvent>;
+    eventbridge: z.ZodCustom<EventBridgeEvent<string, unknown>, EventBridgeEvent<string, unknown>>;
+    'cloudwatch-logs': z.ZodCustom<CloudWatchLogsEvent, CloudWatchLogsEvent>;
+    ses: z.ZodCustom<SESEvent, SESEvent>;
+    cloudfront: z.ZodCustom<CloudFrontRequestEvent, CloudFrontRequestEvent>;
+    firehose: z.ZodCustom<FirehoseTransformationEvent, FirehoseTransformationEvent>;
+    'cognito-userpool': z.ZodCustom<CognitoUserPoolTriggerEvent, CognitoUserPoolTriggerEvent>;
+    step: z.ZodObject<{
+        Payload: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;
+/** Canonical base event map type (schema‑first). Extend the schema in your App. */
+type BaseEventTypeMap = z.infer<typeof baseEventTypeMapSchema>;
+
 type Dict<T> = Record<string, T>;
 type StagesFactoryInput<GlobalParams extends Record<string, unknown>, StageParams extends Record<string, unknown>> = {
     globalParamsSchema: ZodObject<ZodRawShape>;
@@ -327,36 +360,6 @@ declare const buildSafeDefaults: (args: BuildSafeDefaultsArgs) => {
     onError: M[];
 };
 
-/**
- * baseEventTypeMapSchema
- * - Schema-first companion to BaseEventTypeMap.
- * - Ensures z.infer<typeof baseEventTypeMapSchema> === BaseEventTypeMap.
- *
- * @remarks
- * Consumers typically extend this schema when creating an App to add
- * project‑local event tokens (e.g., 'step').
- * Only tokens listed in the app’s `httpEventTypeTokens` are treated as HTTP at runtime.
- */
-
-declare const baseEventTypeMapSchema: z.ZodObject<{
-    rest: z.ZodCustom<APIGatewayProxyEvent, APIGatewayProxyEvent>;
-    http: z.ZodCustom<APIGatewayProxyEventV2, APIGatewayProxyEventV2>;
-    alb: z.ZodCustom<ALBEvent, ALBEvent>;
-    sqs: z.ZodCustom<SQSEvent, SQSEvent>;
-    sns: z.ZodCustom<SNSEvent, SNSEvent>;
-    s3: z.ZodCustom<S3Event, S3Event>;
-    dynamodb: z.ZodCustom<DynamoDBStreamEvent, DynamoDBStreamEvent>;
-    kinesis: z.ZodCustom<KinesisStreamEvent, KinesisStreamEvent>;
-    eventbridge: z.ZodCustom<EventBridgeEvent<string, unknown>, EventBridgeEvent<string, unknown>>;
-    'cloudwatch-logs': z.ZodCustom<CloudWatchLogsEvent, CloudWatchLogsEvent>;
-    ses: z.ZodCustom<SESEvent, SESEvent>;
-    cloudfront: z.ZodCustom<CloudFrontRequestEvent, CloudFrontRequestEvent>;
-    firehose: z.ZodCustom<FirehoseTransformationEvent, FirehoseTransformationEvent>;
-    'cognito-userpool': z.ZodCustom<CognitoUserPoolTriggerEvent, CognitoUserPoolTriggerEvent>;
-}, z.core.$strip>;
-/** Canonical base event map type (schema‑first). Extend the schema in your App. */
-type BaseEventTypeMap = z.infer<typeof baseEventTypeMapSchema>;
-
 /** HTTP methods supported from zod-openapi's PathItem shape (excluding helper 'id'). */
 type MethodKey = keyof Omit<ZodOpenApiPathItemObject, 'id'>;
 /**
@@ -462,13 +465,14 @@ interface AppInit<GlobalParamsSchema extends ZodObj, StageParamsSchema extends Z
      * @returns a new App instance
      */
     static create<GlobalParamsSchema extends ZodObj, StageParamsSchema extends ZodObj, EventTypeMapSchema extends ZodObj>(init: AppInit<GlobalParamsSchema, StageParamsSchema, EventTypeMapSchema>): App<GlobalParamsSchema, StageParamsSchema, EventTypeMapSchema>;
+    static create<GlobalParamsSchema extends ZodObj, StageParamsSchema extends ZodObj>(init: Omit<AppInit<GlobalParamsSchema, StageParamsSchema, typeof baseEventTypeMapSchema>, 'eventTypeMapSchema'> & {
+        eventTypeMapSchema?: undefined;
+    }): App<GlobalParamsSchema, StageParamsSchema, typeof baseEventTypeMapSchema>;
     /**
      * Register a function (HTTP or non‑HTTP).
      *
      * @typeParam EventType      - A key from your eventTypeMapSchema (e.g., 'rest' | 'http' | 'sqs' | 'step')
-     * @typeParam EventSchema    - Optional Zod schema validated BEFORE the handler (refines event shape)
-     * @typeParam ResponseSchema - Optional Zod schema validated AFTER the handler (refines response shape)
-     * @param options - per‑function configuration (method/basePath/httpContexts for HTTP; serverless extras for non‑HTTP)
+     * @typeParam EventSchema    - Optional Zod schema validated BEFORE the handler (refines event shape)   * @typeParam ResponseSchema - Optional Zod schema validated AFTER the handler (refines response shape)   * @param options - per‑function configuration (method/basePath/httpContexts for HTTP; serverless extras for non‑HTTP)
      * @returns a per‑function API: { handler(business), openapi(baseOperation), serverless(extras) }
      */
     defineFunction<EventType extends Extract<keyof z.infer<EventTypeMapSchema>, string>, EventSchema extends z.ZodType | undefined, ResponseSchema extends z.ZodType | undefined>(options: {
@@ -499,6 +503,10 @@ interface AppInit<GlobalParamsSchema extends ZodObj, StageParamsSchema extends Z
             cloudfront: aws_lambda.CloudFrontRequestEvent;
             firehose: aws_lambda.FirehoseTransformationEvent;
             'cognito-userpool': aws_lambda.CognitoUserPoolTriggerEvent;
+            step: {
+                [x: string]: unknown;
+                Payload?: unknown;
+            };
         })[EventType]>) => (event: unknown, context: aws_lambda.Context) => Promise<ResponseSchema extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>> ? z.core.output<ResponseSchema> : unknown>;
         openapi: (baseOperation: BaseOperation) => void;
         serverless: (extras: unknown) => void;

package/dist/mjs/index.js

@@ -28,12 +28,23 @@ const baseEventTypeMapSchema = z.object({
     firehose: z.custom(),
     // eslint-disable-next-line @typescript-eslint/no-deprecated -- Upstream AWS types mark this as deprecated; we retain the token for compatibility with existing apps.
     'cognito-userpool': z.custom(),
+    /**
+     * Step Functions → Lambda (Service Integration: Lambda Invoke)
+     *
+     * When Step Functions invokes Lambda via the AWS SDK integration
+     * (e.g., "arn:aws:states:::lambda:invoke"), the event received by the
+     * Lambda handler is an object that wraps the original input under a
+     * "Payload" key. The Payload is already parsed JSON.
+     *
+     * Notes:
+     * - We accept additional keys (e.g., StatusCode/ExecutedVersion in some
+     *   patterns) via passthrough.
+     * - For the common “request/response” integration where Step Functions
+     *   passes state directly, apps can still treat the event via their
+     *   own app-local event map if needed.
+     */
+    step: z.object({ Payload: z.unknown().optional() }).catchall(z.unknown()),
 });
-// Notes:
-// - This list intentionally includes widely used, generic AWS events.
-// - Apps can extend the schema with custom or specialized tokens:
-//     const EventMap = baseEventTypeMapSchema.extend({ step: z.custom<MyStepEvent>() })
-// - Only tokens listed in your App's httpEventTypeTokens are treated as HTTP by the runtime.
 
 /**
  * Stage artifacts factory.
@@ -1041,10 +1052,10 @@ const buildAllServerlessFunctions = (registry, serverless, buildFnEnv) => {
 /**
  * App (schema‑first)
  *
+ * Overloads on create() preserve strong inference when eventTypeMapSchema is omitted.
  * Central orchestrator for a SMOZ application. You provide:
  * - Global/stage parameter schemas and env exposure keys
- * - Serverless defaults (handler filename/export and context map)
- * - Event‑type map schema (extendable: e.g., add 'step')
+ * - Serverless defaults (handler filename/export and context map) * - Event‑type map schema (extendable: e.g., add 'step')
  *
  * The instance:
  * - Validates configuration
@@ -1128,6 +1139,7 @@ const buildAllServerlessFunctions = (registry, serverless, buildFnEnv) => {
      * @param init - initialization object (schemas, serverless defaults, params/envKeys)
      * @returns a new App instance
      */
+    // Implementation (must come after overload signatures)
     static create(init) {
         return new App(init);
     }
@@ -1135,9 +1147,7 @@ const buildAllServerlessFunctions = (registry, serverless, buildFnEnv) => {
      * Register a function (HTTP or non‑HTTP).
      *
      * @typeParam EventType      - A key from your eventTypeMapSchema (e.g., 'rest' | 'http' | 'sqs' | 'step')
-     * @typeParam EventSchema    - Optional Zod schema validated BEFORE the handler (refines event shape)
-     * @typeParam ResponseSchema - Optional Zod schema validated AFTER the handler (refines response shape)
-     * @param options - per‑function configuration (method/basePath/httpContexts for HTTP; serverless extras for non‑HTTP)
+     * @typeParam EventSchema    - Optional Zod schema validated BEFORE the handler (refines event shape)   * @typeParam ResponseSchema - Optional Zod schema validated AFTER the handler (refines response shape)   * @param options - per‑function configuration (method/basePath/httpContexts for HTTP; serverless extras for non‑HTTP)
      * @returns a per‑function API: { handler(business), openapi(baseOperation), serverless(extras) }
      */
     defineFunction(options) {

package/package.json

@@ -39,38 +39,42 @@
     "@types/aws-lambda": "^8.10.152",
     "@types/fs-extra": "^11.0.4",
     "@types/http-errors": "^2.0.5",
+    "@types/node": "^22",
     "@types/serverless": "^3.12.27",
     "@vitest/coverage-v8": "^3.2.4",
     "auto-changelog": "^2.5.0",
-    "eslint": "^9.35.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint": "^9.35.0",
     "fs-extra": "^11.3.1",
     "knip": "^5.63.1",
     "lefthook": "^1.13.0",
     "prettier": "^3.6.2",
     "release-it": "^19.0.4",
     "rimraf": "^6.0.1",
-    "rollup": "^4.50.1",
     "rollup-plugin-dts": "^6.2.3",
-    "serverless": "^4.18.2",
+    "rollup": "^4.50.1",
     "serverless-apigateway-log-retention": "^1.1.0",
     "serverless-deployment-bucket": "^1.6.0",
     "serverless-domain-manager": "^8.0.0",
     "serverless-offline": "^14.4.0",
     "serverless-plugin-common-excludes": "^4.0.0",
+    "serverless": "^4.18.2",
     "tsx": "^4.20.5",
-    "typedoc": "^0.28.12",
     "typedoc-plugin-mdn-links": "^5.0.9",
     "typedoc-plugin-replace-text": "^4.2.0",
     "typedoc-plugin-zod": "^1.4.2",
-    "typescript": "^5.9.2",
+    "typedoc": "^0.28.13",
     "typescript-eslint": "^8.43.0",
+    "typescript": "^5.9.2",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^3.2.4",
     "zod-openapi": "^5.4.1"
   },
+  "engines": {
+    "node": ">=22.19.0 <23"
+  },
   "exports": {
     ".": {
       "import": {
@@ -181,5 +185,8 @@
     "templates:lint": "eslint --fix -c templates/default/eslint.config.ts \"templates/default/**/*.{ts,tsx,js,jsx}\" \"templates/default/eslint.config.ts\""
   },
   "type": "module",
-  "version": "0.2.8"
+  "version": "0.2.10",
+  "volta": {
+    "node": "22.19.0"
+  }
 }

package/templates/default/.node-version

@@ -0,0 +1 @@
+22.19.0

package/templates/default/.nvmrc

@@ -0,0 +1 @@
+22.19.0

package/templates/default/app/config/app.config.ts

@@ -1,7 +1,7 @@
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import { App, baseEventTypeMapSchema, toPosixPath } from '@karmaniverous/smoz';
+import { App, toPosixPath } from '@karmaniverous/smoz';
 import { z } from 'zod';
 
 // Derive the app root as the parent directory of app/config/
@@ -23,7 +23,6 @@ export const app = App.create({
     DOMAIN_NAME: z.string(),
     STAGE: z.string(),
   }),
-  eventTypeMapSchema: baseEventTypeMapSchema,
   serverless: {
     httpContextEventMap: {
       my: {}, // place a Cognito authorizer here if needed

package/templates/default/package.json

@@ -1,47 +1,52 @@
-{
-  "name": "smoz-template-default",
-  "private": true,
-  "type": "module",
-  "version": "0.0.0",
-  "dependencies": {
-    "@middy/core": "^6.4.5",
-    "fs-extra": "^11.3.1",
-    "package-directory": "^8.1.0",
-    "zod": "^4.1.6"
-  },
-  "devDependencies": {
-    "@serverless/typescript": "^4.18.2",
-    "@types/fs-extra": "^11.0.4",
-    "@types/node": "^22",
-    "eslint": "^9.35.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
-    "eslint-plugin-simple-import-sort": "^12.1.1",
-    "jiti": "^2.5.1",
-    "prettier": "^3.6.2",
-    "serverless": "^4.18.2",
-    "serverless-apigateway-log-retention": "^1.1.0",
-    "serverless-deployment-bucket": "^1.6.0",
-    "serverless-domain-manager": "^8.0.0",
-    "serverless-offline": "^14.4.0",
-    "serverless-plugin-common-excludes": "^4.0.0",
-    "tsx": "^4.20.5",
-    "typedoc": "^0.28.12",
-    "typescript": "^5.9.2",
-    "typescript-eslint": "^8.43.0",
-    "vitest": "^3.2.4",
-    "zod-openapi": "^5.4.1"
-  },
-  "scripts": {
-    "register": "smoz register",
-    "openapi": "smoz register && tsx app/config/openapi && prettier -w app/generated/openapi.json",
-    "package": "smoz register && serverless package",
-    "dev": "smoz dev",
-    "dev:offline": "smoz dev --local offline",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "lint": "eslint .",
-    "lint:fix": "eslint --fix .",
-    "test": "vitest run",
-    "docs": "typedoc"
-  }
-}
+{
+  "engines": {
+    "node": ">=22.19.0 <23"
+  },
+  "dependencies": {
+    "@middy/core": "^6.4.5",
+    "fs-extra": "^11.3.1",
+    "package-directory": "^8.1.0",
+    "zod": "^4.1.6"
+  },
+  "devDependencies": {
+    "@serverless/typescript": "^4.18.2",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint": "^9.35.0",
+    "jiti": "^2.5.1",
+    "prettier": "^3.6.2",
+    "serverless-apigateway-log-retention": "^1.1.0",
+    "serverless-deployment-bucket": "^1.6.0",
+    "serverless-domain-manager": "^8.0.0",
+    "serverless-offline": "^14.4.0",
+    "serverless-plugin-common-excludes": "^4.0.0",
+    "serverless": "^4.18.2",
+    "tsx": "^4.20.5",
+    "typedoc": "^0.28.12",
+    "typescript-eslint": "^8.43.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4",
+    "zod-openapi": "^5.4.1"
+  },
+  "name": "smoz-template-default",
+  "scripts": {
+    "register": "smoz register",
+    "openapi": "smoz register && tsx app/config/openapi && prettier -w app/generated/openapi.json",
+    "package": "smoz register && serverless package",
+    "dev": "smoz dev",
+    "dev:offline": "smoz dev --local offline",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
+    "test": "vitest run",
+    "docs": "typedoc"
+  },
+  "type": "module",
+  "version": "0.0.0",
+  "volta": {
+    "node": "22.19.0"
+  }
+}