@kalutskii/foundation 0.7.8 → 0.7.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ilya Kalutskii
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,7 +1,7 @@
 # @kalutskii/foundation
 
 Shared TypeScript foundation for contracts, schemas, framework adapters, and reusable utilities.
-The package is designed for Bun, Node.js, Hono applications, and Cloudflare Workers environments.
+The package is designed for Bun, Node.js, and Hono applications.
 
 This repository is not intended to document every exported function through standalone usage snippets.
 Public JSDoc, generated declarations, colocated specifications, and editor inference are the API reference.
@@ -24,6 +24,7 @@ The package contains several deliberately isolated areas:
 | ---------------- | ----------------------------------------------------------------------------------------- |
 | `utilities`      | Framework-independent datetime, enum, execution, generation, logging, and type utilities. |
 | `http`           | Shared HTTP result contracts, factories, status constants, and result resolvers.          |
+| `upload`         | Shared upload presets, file-format metadata, validation, and reusable Zod schemas.        |
 | `zod-validation` | Generic Zod parsing, validation, refinement, and related type utilities.                  |
 | `zod-search`     | Reusable search and pagination contracts composed from lower-level Zod primitives.        |
 | `zod-bulk`       | Include/exclude selection contracts shared by frontend and backend bulk operations.       |
@@ -46,7 +47,7 @@ Framework adapters
             │
             ▼
 Contract composition
-  zod-search / zod-bulk
+  zod-search / zod-bulk / upload
             │
             ▼
 Contract primitives
@@ -88,6 +89,7 @@ src/
 ├── drizzle/
 ├── hono/
 ├── http/
+├── upload/
 ├── utilities/
 ├── zod-bulk/
 ├── zod-jwt/
@@ -111,20 +113,24 @@ single public API boundary and should export only symbols intentionally supporte
 
 ## File responsibilities
 
-| Suffix           | Expected content                                                              |
-| ---------------- | ----------------------------------------------------------------------------- |
-| `*.constants.ts` | Immutable values and literal collections without behavior.                    |
-| `*.schemas.ts`   | Runtime Zod schemas and factories whose result is a schema.                   |
-| `*.types.ts`     | Type aliases, interfaces, generic contracts, and schema-derived output types. |
-| `*.factory.ts`   | Functions whose primary responsibility is constructing non-schema values.     |
-| `*.resolvers.ts` | Functions that unwrap, normalize, or translate an existing result.            |
-| `*.utilities.ts` | Stateless reusable behavior that has no narrower architectural owner.         |
-| `*.parsing.ts`   | Input parsing and preprocessing before domain validation.                     |
-| `*.refiners.ts`  | Refinement logic that narrows or safely composes an existing value.           |
-| `*.execution.ts` | Framework lifecycle execution and error-boundary behavior.                    |
-| `*.logging.ts`   | Logging formatters, sinks, or middleware behavior.                            |
-| `*.respond.ts`   | Framework response construction and response-specific contracts.              |
-| `*.spec.ts`      | The single colocated runtime and compile-time specification for a module.     |
+| Suffix            | Expected content                                                          |
+| ----------------- | ------------------------------------------------------------------------- |
+| `*.constants.ts`  | Immutable configuration values and metadata without behavior.             |
+| `*.enums.ts`      | Literal collections, derived unions, ergonomic records, and aliases.      |
+| `*.schemas.ts`    | Runtime Zod schemas and factories whose result is a schema.               |
+| `*.types.ts`      | Type aliases, generic contracts, and schema-derived output types.         |
+| `*.services.ts`   | Stateful service classes that coordinate one external capability.         |
+| `*.validation.ts` | Ordered validation behavior returning stable domain error keys.           |
+| `*.factory.ts`    | Functions whose primary responsibility is constructing non-schema values. |
+| `*.presets.ts`    | Ready-to-use policies composed from public domain values.                 |
+| `*.resolvers.ts`  | Functions that unwrap, normalize, or translate an existing result.        |
+| `*.utilities.ts`  | Stateless reusable behavior that has no narrower architectural owner.     |
+| `*.parsing.ts`    | Input parsing and preprocessing before domain validation.                 |
+| `*.refiners.ts`   | Refinement logic that narrows or safely composes an existing value.       |
+| `*.execution.ts`  | Framework lifecycle execution and error-boundary behavior.                |
+| `*.logging.ts`    | Logging formatters, sinks, or middleware behavior.                        |
+| `*.respond.ts`    | Framework response construction and response-specific contracts.          |
+| `*.spec.ts`       | The single colocated runtime and compile-time specification for a module. |
 
 Do not place TypeScript-only contracts in a schema file when they can be separated without creating a circular
 responsibility. Do not split tiny files mechanically either: separation must communicate ownership, not line count.