@karmaniverous/smoz 0.1.2

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Jason Williscroft
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,66 @@
+<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 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 @middy/core \
+  @middy/http-header-normalizer \
+  @middy/http-event-normalizer \
+  @middy/http-json-body-parser \
+  @middy/http-content-negotiation \
+  @middy/http-error-handler \
+  @middy/http-cors \
+  @middy/http-response-serializer
+```
+
+## 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/)