exisjs 0.9.2 → 0.10.0-alpha.0

package/README.md

@@ -14,8 +14,11 @@ Install `exisjs` via npm:
 
 ```bash
 npm install exisjs
+npm install -D @exisjs/cli typescript
 ```
 
+The `exisjs` command (`dev`, `build`, `test`) is in [`@exisjs/cli`](https://www.npmjs.com/package/@exisjs/cli), a development dependency; production installs only need `exisjs`.
+
 Or initialize a new project using the scaffolding CLI:
 
 ```bash

package/bin/exis.js

@@ -1,2 +1,77 @@
 #!/usr/bin/env node
-require('../dist/cli/index.js');
+// `exisjs start` runs here, from the runtime, so production installs need no
+// development tools. Every other command is in @exisjs/cli; this binary
+// forwards to it.
+const fs = require('node:fs')
+const path = require('node:path')
+
+const [command, ...args] = process.argv.slice(2)
+
+if (command === 'start') {
+  const options = {}
+  const names = {
+    '-p': 'port',
+    '--port': 'port',
+    '-H': 'host',
+    '--host': 'host',
+    '-e': 'entry',
+    '--entry': 'entry',
+  }
+  for (let i = 0; i < args.length; i++) {
+    const [flag, inline] = args[i].split('=')
+    if (flag === '-h' || flag === '--help') {
+      console.log(
+        'Usage: exisjs start [--port <port>] [--host <host>] [--entry <file>]'
+      )
+      process.exit(0)
+    }
+    const name = names[flag]
+    if (!name) {
+      console.error(`Unknown option for exisjs start: ${args[i]}`)
+      process.exit(1)
+    }
+    options[name] = inline ?? args[++i]
+  }
+  require('../dist/lib/start-command.js')
+    .startBuiltServer(options)
+    .catch((err) => {
+      console.error(err)
+      process.exit(1)
+    })
+  return
+}
+
+let cli
+try {
+  cli = require.resolve('@exisjs/cli/bin/exisjs.js', {
+    paths: [process.cwd(), __dirname],
+  })
+} catch {
+  console.error(
+    `\n  \`exisjs ${command ?? ''}\` is in the @exisjs/cli package, which is not installed.\n` +
+      '  Install it as a development dependency:\n\n' +
+      '    npm install -D @exisjs/cli\n\n' +
+      '  (`exisjs start` needs only exisjs, so production installs can leave it out.)\n'
+  )
+  process.exit(1)
+}
+
+// One line, only for projects that rely on the package installed through
+// the runtime instead of listing it themselves
+try {
+  const pkg = JSON.parse(
+    fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8')
+  )
+  const listed =
+    pkg.devDependencies?.['@exisjs/cli'] || pkg.dependencies?.['@exisjs/cli']
+  if (!listed && command !== 'migrate' && !process.env.EXIS_NO_CLI_NOTICE) {
+    console.error(
+      '\x1b[33m[exis]\x1b[0m The CLI moved to @exisjs/cli; exisjs 0.11 stops installing it. ' +
+        'Run \x1b[36mnpx exisjs migrate\x1b[0m to update this project.'
+    )
+  }
+} catch {
+  // no package.json: nothing to suggest
+}
+
+require(cli)

package/dist/config/types.d.ts

@@ -143,11 +143,20 @@ export interface ExisConfig {
      * 'auto' will use Bun if detected, otherwise Node.
      */
     server?: 'auto' | 'node' | 'bun' | 'uws';
+    /**
+     * Limits how many requests the app handles at once. Requests over
+     * `maxConcurrent` wait in this process (up to `maxQueue`, for at most
+     * `timeoutMs`), then get 503. Unknown keys and drivers stop the start.
+     */
     queue?: {
-        driver?: 'memory' | 'redis' | string;
+        /** Only `'memory'`: waiting requests live in this process */
+        driver?: 'memory';
+        /** Requests handled at once. Default 1000 */
         maxConcurrent?: number;
+        /** Requests allowed to wait. Default 500 */
         maxQueue?: number;
-        [key: string]: any;
+        /** How long a request may wait, in ms. Default 10000 */
+        timeoutMs?: number;
     };
     watch?: WatchConfig;
     dev?: DevConfig;

package/dist/config/types.d.ts.map

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

package/dist/docs/content/README.md

@@ -33,6 +33,7 @@ Documentation follows the [Diátaxis Framework](https://diataxis.fr/), separatin
 - [`cron.mdx`](./cron.mdx): Background task scheduling (`cron()` and `@Cron()`) with drift correction and overlap protection.
 - [`swagger.mdx`](./swagger.mdx): Automatic OpenAPI 3.1 schema extraction, Swagger UI (`/docs`), and JSON documentation endpoints.
 - [`testing.mdx`](./testing.mdx): Test harness (`createTestContext`, `createTestApp`), mocking utilities (`ex`), and CLI test runner.
+- [`deployment.mdx`](./deployment.mdx): Docker images, build-time secrets (`--skip-env-check`), graceful shutdown, health checks and migrations.
 - [`config.mdx`](./config.mdx): Global configuration options in `exis.config.ts`, lifecycle phases, clustering, and file watcher settings.
 - [`exisjs-mcp.mdx`](./exisjs-mcp.mdx): Model Context Protocol (MCP) server integration for IDE AI assistants.
 

package/dist/docs/content/cli/commands.mdx

@@ -55,6 +55,10 @@ npx exisjs build [options]
 ### Type-checking on deployment hosts
 Some hosts (Render, Heroku and others) install with `NODE_ENV=production`, which leaves out `devDependencies` such as `@types/node`. When `@types/*` packages listed in your `devDependencies` are not installed, `exisjs build` skips the type-check with a warning and still compiles. To keep the type-check on the host, set the install command to `npm install --include=dev`.
 
+The same applies to the CLI itself: `exisjs build` comes from `@exisjs/cli`, a development dependency. Build where development dependencies are installed (a Docker build stage, or `npm install --include=dev` on the host), then install production dependencies only for the running server.
+
+`exisjs build` also writes `.exis/server/main.js`, the production entry: `node .exis/server/main.js` starts the server in that one process, with `NODE_ENV=production` unless set otherwise.
+
 ### Build Outputs
 - Compiles application source code into the specified `outDir`.
 - Emits pre-computed route manifests (`.exis/routes-manifest.js`) for O(1) route discovery at runtime.
@@ -81,7 +85,9 @@ npx exisjs cl [options]
 
 ## `exisjs start`
 
-Starts the compiled production server from the build output directory.
+Starts the built server in the current process (the same as `node .exis/server/main.js`), with `NODE_ENV=production`. The server receives `SIGINT` / `SIGTERM` itself and shuts down gracefully.
+
+`exisjs start` is part of the `exisjs` runtime package, not of `@exisjs/cli`: it works in production installs that leave out development dependencies (`npm ci --omit=dev`), so `"start": "exisjs start"` and `npm start` work on every platform. The other commands need `@exisjs/cli`.
 
 ```bash
 npx exisjs start [options]
@@ -97,6 +103,22 @@ npx exisjs start [options]
 
 ---
 
+## `exisjs migrate`
+
+Updates a project created before 0.10 to the current layout:
+
+- adds `@exisjs/cli` to `devDependencies` (and `typescript`, if the project has a `tsconfig.json` but did not list it);
+- lists the `Dockerfile` lines to change (it does not edit the `Dockerfile`).
+
+```bash
+npx exisjs migrate            # writes package.json
+npx exisjs migrate --dry-run  # only shows the changes
+```
+
+Then run `npm install`. Running it again changes nothing.
+
+---
+
 ## `exisjs generate`
 
 Scaffolds framework components and files according to ExisJS file conventions.

package/dist/docs/content/cli/usage.mdx

@@ -68,6 +68,7 @@ Applications initialized with `npx exisjs init` include standard npm lifecycle s
     "exisjs": "^1.0.0"
   },
   "devDependencies": {
+    "@exisjs/cli": "^0.10.0",
     "typescript": "^5.0.0"
   }
 }
@@ -82,7 +83,7 @@ npm run dev
 # Compile TypeScript and build route manifests
 npm run build
 
-# Start production server
+# Start the production server (one process, no CLI needed)
 npm run start
 
 # Run native test runner

package/dist/docs/content/config.mdx

@@ -1,8 +1,8 @@
 ---
 title: "Configuration"
 description: "Global runtime configuration, phases, environment loading, server engine selection, and cluster options in exis.config.ts."
-nextUrl: "/docs/exisjs-mcp"
-nextTitle: "AI Integration (MCP)"
+nextUrl: "/docs/deployment"
+nextTitle: "Deploying with Docker"
 ---
 
 # Configuration (`exis.config.ts`)
@@ -166,7 +166,7 @@ export default defineConfig({
 | `asyncContext` | `boolean` | `false` | Enables `AsyncLocalStorage` context tracking (`getContext()`). |
 | `docs` / `swagger` | `boolean \| SwaggerConfig` | `{ enabled: false }` | OpenAPI 3.1 specification and Swagger UI endpoint generation. Served in every environment when enabled; the project template uses `enabled: process.env.NODE_ENV !== 'production'` so published API docs do not help attackers. |
 | `healthcheck` | `boolean \| HealthCheckConfig` | `{ enabled: false }` | `path` (`/_health`): liveness, runs `checks`. `readyPath` (`/_ready`, `false` to disable): readiness, `503` unless `checks` pass, registered databases are healthy and the app is not shutting down. |
-| `metrics` | `boolean \| MetricsConfig` | `{ enabled: false }` | Prometheus metrics endpoint (`path: '/metrics'`). |
+| `metrics` | `boolean \| MetricsConfig` | `{ enabled: false }` | Prometheus metrics endpoint (`path: '/metrics'`). See [Prometheus Metrics](#prometheus-metrics). |
 | `telemetry` | `boolean \| TelemetryConfig` | `{ enabled: false }` | OpenTelemetry tracing and metrics export. |
 
 ### Concurrency & Clustering
@@ -182,6 +182,24 @@ export default defineConfig({
 })
 ```
 
+#### Limiting concurrent requests (`queue`)
+
+`queue` caps how many requests the app handles at once, so a traffic spike slows down instead of exhausting memory or the database pool:
+
+```typescript filename="exis.config.ts"
+export default defineConfig({
+  queue: {
+    maxConcurrent: 500, // handled at once (default 1000)
+    maxQueue: 200, // may wait for a free slot (default 500)
+    timeoutMs: 10_000, // longest wait (default 10 s)
+  },
+})
+```
+
+A request over the limit waits in this process; when `maxQueue` is full, or the wait exceeds `timeoutMs`, it gets `503 Service Unavailable`. A client that disconnects frees its place. The limit is per process (per worker in cluster mode).
+
+The only `driver` is `'memory'`. Any other driver, unknown keys and invalid numbers stop the server at start-up with a message naming the option. ExisJS has no shared or durable queue yet, so a setting that pretended to provide one would be silently ignored.
+
 ---
 
 ## File Watcher & Development Configuration
@@ -215,6 +233,32 @@ ExisJS automatically excludes build output and temp folders from triggering watc
 
 ---
 
+## Prometheus Metrics
+
+Set `metrics: { enabled: true }` (or `metrics: true`) to serve request and process metrics in the Prometheus text format at `GET /metrics` (change it with `path`).
+
+```typescript filename="exis.config.ts"
+export default defineConfig({
+  metrics: { enabled: true, path: '/metrics' },
+})
+```
+
+| Metric | Type | Labels |
+| :--- | :--- | :--- |
+| `http_requests_total` | counter | `method`, `route`, `status` |
+| `http_request_duration_seconds` | histogram (5 ms to 10 s) | `method`, `route` |
+| `http_requests_in_flight` | gauge | |
+| `process_resident_memory_bytes`, `nodejs_heap_used_bytes` | gauge | `worker` in cluster mode |
+| `nodejs_eventloop_lag_p99_seconds` | gauge | `worker` in cluster mode |
+| `process_start_time_seconds` | gauge | `worker` in cluster mode |
+
+- **`route` is the route pattern** (`/users/:id`), never the requested URL, so the number of series stays bounded. Requests that match no route are counted under `(unmatched)`.
+- **Status `499`** counts requests whose client disconnected before the response finished.
+- **Cluster mode:** a scrape can reach any worker; that worker collects the numbers of every worker through the primary process, so the request counters are always the whole server's. Memory and event-loop lag are reported per worker.
+- **Keep the endpoint private.** It lists every route of the API. Expose it only on an internal network, or block it at the proxy for public traffic.
+
+---
+
 ## Plugin Integration
 
 Plugins extend framework capabilities by intercepting server configuration or registering global routes:

package/dist/docs/content/deployment.mdx

@@ -0,0 +1,163 @@
+---
+title: "Deploying with Docker"
+description: "Build an ExisJS app into a small production image, keep secrets out of the build, run the server as one process that shuts down gracefully, and wire up health checks."
+nextUrl: "/docs/exisjs-mcp"
+nextTitle: "AI Integration (MCP)"
+---
+
+# Deploying with Docker
+
+This page builds an ExisJS app into a production image that:
+
+- builds without secrets, because container platforms provide them only when the container runs;
+- refuses to start when a required secret is missing;
+- runs the server as one process that stops gracefully on `docker stop` and on every redeploy;
+- contains no build tools: no TypeScript, esbuild or CLI.
+
+The Dockerfile below was tested end to end with an app created by `npm create exisjs`.
+
+---
+
+## The Dockerfile
+
+```dockerfile filename="Dockerfile"
+# syntax=docker/dockerfile:1
+
+# ── Build: full toolchain ────────────────────────────────────────────────────
+FROM node:24-slim AS build
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+# Secrets are injected when the container runs, not while the image builds
+RUN npx exisjs build --skip-env-check
+
+# ── Runtime: production dependencies only ────────────────────────────────────
+FROM node:24-slim
+WORKDIR /app
+ENV NODE_ENV=production PORT=3000
+COPY package*.json ./
+RUN npm ci --omit=dev --omit=optional && npm cache clean --force
+COPY --from=build /app/.exis ./.exis
+USER node
+EXPOSE 3000
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s \
+  CMD node -e "fetch('http://127.0.0.1:3000/health').then(r => process.exit(r.ok ? 0 : 1), () => process.exit(1))"
+CMD ["node_modules/.bin/exisjs", "start"]
+```
+
+`exisjs build` writes everything the server needs into `.exis/`: the compiled code, the route manifest, the compiled `exis.config` and `main.js`, the entry that starts the server. The runtime image needs only `.exis/`, `package.json` and the production dependencies; it contains no source files.
+
+- **`--omit=optional`** keeps the CLI out of the image. Until 0.11, `exisjs` lists `@exisjs/cli` as an optional dependency so that projects created before 0.10 keep working. If you use the uWebSockets.js engine (`server: 'uws'`), list `uWebSockets.js` in your own `dependencies`, since it is optional too.
+- **`npm ci`** in the build stage installs `devDependencies`, which include `@exisjs/cli` and `typescript`.
+
+Add a `.dockerignore`, so local files never reach the image. **`.env` must be in it**, or your local secrets are copied into every image layer:
+
+```text filename=".dockerignore"
+node_modules
+.exis
+dist
+.git
+.env
+.env.*
+!.env.example
+*.log
+coverage
+```
+
+---
+
+## Secrets: `--skip-env-check`
+
+`exisjs build` loads your route files to check them, and a route that imports `tex.env` validates the environment while it loads. In a Docker build the secrets don't exist yet, so a plain `RUN npx exisjs build` fails:
+
+```text
+✗ BUILD_VALIDATION_FAILED: Validation Error: DATABASE_URL: Expected value, received undefined
+```
+
+`--skip-env-check` skips that check **for the build only**. When the container starts, `tex.env` validates the real environment, and a missing or invalid value stops the server with exit code 1:
+
+```text
+[ExisJS] the routes manifest failed to load, so the server will not start:
+Validation Error: DATABASE_URL: Expected value, received undefined
+```
+
+Pass the secrets when you run the container (`docker run -e DATABASE_URL=...`, or your platform's environment settings). Never set `EXIS_SKIP_ENV_CHECK` in the runtime environment: it is the build flag, and would let the server start with placeholder values.
+
+---
+
+## One process, graceful shutdown
+
+`exisjs start` comes with the `exisjs` runtime, so the image needs no CLI, and it runs the server in its own process: Node is PID 1 in the container and receives `SIGTERM` directly. (`node .exis/server/main.js`, written by `exisjs build`, does the same.)
+
+In the `CMD`, call the binary itself rather than `npm start`: with npm in between, a redeploy's `SIGTERM` shows up as `npm error signal SIGTERM`, and some platforms stop the container early when they detach its input. `npm start` with `"start": "exisjs start"` works too, for platforms that only run npm scripts.
+
+On `docker stop`:
+
+1. The server stops accepting new connections, and the readiness probe (`/_ready`, if enabled) answers `503`.
+2. Requests in progress finish.
+3. `onClose` hooks run and registered databases disconnect.
+4. The process exits with code 0.
+
+ExisJS waits up to 10 seconds for this, and Docker also waits 10 seconds by default before it kills the container. If your requests can take longer, raise both: `docker stop -t 60` / `stop_grace_period: 60s` in Compose, and the platform's equivalent.
+
+With `cluster: { workers }` set, that process is the cluster primary and forks the workers itself.
+
+---
+
+## Health checks
+
+The project template has a `GET /health` route, which the `HEALTHCHECK` above calls. `node:24-slim` has no `curl`, so the check uses Node's `fetch`.
+
+For a load balancer or Kubernetes, turn on the built-in probes instead:
+
+```typescript filename="exis.config.ts"
+export default defineConfig({
+  healthcheck: { enabled: true }, // GET /_health (liveness) and GET /_ready (readiness)
+})
+```
+
+Point the load balancer, or the Kubernetes `readinessProbe`, at `/_ready`: it answers `503` while a registered database is down and during shutdown. Use `/_health` only to decide whether to restart the container.
+
+---
+
+## Database migrations and scripts
+
+The runtime image has no source files and no CLI, so run one-off tasks from the build stage, which has the whole project and toolchain:
+
+```sh
+docker build --target build -t my-api:build .
+docker run --rm -e DATABASE_URL="$DATABASE_URL" my-api:build npx exisjs run scripts/migrate.ts
+```
+
+Run it as a separate step of your deployment, before the new version starts.
+
+---
+
+## Projects created before 0.10
+
+Run `npx exisjs migrate` once. It adds `@exisjs/cli` to `devDependencies` and lists the Dockerfile lines to change (`--omit=optional`, and a `CMD` that goes through `npm start`). `"start": "exisjs start"` stays as it is: it now runs the server in its own process, without the CLI.
+
+---
+
+## Platform notes
+
+- **Pin the Node.js version.** Use an explicit image (`node:24-slim`). Builders that pick Node for you, such as Nixpacks, may default to an older version than your dependencies need; set it explicitly (for Nixpacks, `nodejs_22` or later in `nixpacks.toml`).
+- **Builds on the host.** Platforms that build without a Dockerfile must install `devDependencies` for the build (`npm install --include=dev`), because `exisjs build` comes from `@exisjs/cli`.
+- **Start command.** On platforms that ask for a start command instead of a Dockerfile `CMD`, enter `npx exisjs start` or `npm start`.
+- **Long requests behind a CDN.** A proxy such as Cloudflare ends requests after about 100 seconds, whatever the server allows. Serve long-running endpoints from a hostname that is not proxied.
+
+---
+
+## Image size
+
+Measured with an app created by `npm create exisjs`, on `node:24-slim`:
+
+| | Before 0.10 | 0.10 |
+| :--- | ---: | ---: |
+| Production `node_modules` | 45 MB | 8 MB |
+| Build tooling in it (`typescript`, `esbuild`, `tsx`, the CLI) | 34 MB | none |
+| Image | 274 MB | 237 MB |
+| Node processes in the container | 2 | 1 |
+
+Most of the remaining image is the `node:24-slim` base. The production install is checked in CI on every change, against a size budget that fails if build tooling returns.

package/dist/docs/content/installation.mdx

@@ -139,7 +139,7 @@ To install ExisJS into an existing repository without scaffolding:
 
 ```bash
 npm install exisjs
-npm install -D typescript @types/node prettier
+npm install -D @exisjs/cli typescript @types/node prettier
 ```
 
 ### Step 2: Configure `tsconfig.json`

package/dist/docs/content/introduction.mdx

@@ -224,8 +224,11 @@ Install the framework into an existing Node.js project:
 
 ```bash
 npm install exisjs
+npm install -D @exisjs/cli typescript
 ```
 
+`exisjs` is the runtime your server needs in production; `@exisjs/cli` is the `exisjs` command (dev server, build, tests), a development tool.
+
 Create an application configuration file:
 
 ```typescript filename="exis.config.ts"

package/dist/docs/content/validation.mdx

@@ -63,7 +63,7 @@ ExisJS provides type-safe primitives that accept modifier options and configurat
 | `tex.record()` | `tex.record(valueSchema, options?)` | Validates dynamic key-value dictionaries (`Record<string, T>`). |
 | `tex.any()` | `tex.any(options?)` | Pass-through validator without schema constraints. |
 | `tex.file()` | `tex.file(options?)` | Validates multipart file uploads. Supports `{ maxSize, mimeTypes }`. |
-| `tex.object()` | `tex.object(shape, options?)` | Compiles an object schema. Supports `{ strict: true }` to reject unlisted keys. |
+| `tex.object()` | `tex.object(shape, options?)` | Compiles an object schema. Supports `{ strict, optional, nullable, nullish }`: `strict: true` rejects unlisted keys; the others work as for fields when the object is nested. An unknown option throws. |
 | `tex.coerce.*` | `tex.coerce.number() \| boolean() \| date() \| string()` | Explicit coercion namespace for query strings, route parameters, and form inputs. |
 | `tex.pagination()` | `tex.pagination(options?)` | Predefined schema for `page`, `limit`, `sort`, and `order` query parameters. |
 | `tex.env()` | `tex.env(shape, options?)` | Environment variable schema parser with automatic type coercion from string values. |

package/dist/docs/reference/config.mdx

@@ -172,6 +172,7 @@ The root configuration schema accepted by `exis.config.ts`:
 | `host` | `string` | `'0.0.0.0'` | Network interface binding. |
 | `server` | `'auto' \| 'node' \| 'bun' \| 'uws'` | `'auto'` | HTTP server backend. Automatically selects Bun or Node when detected. |
 | `cluster` | `{ workers?: number \| 'auto' \| 'safe' \| 'max' }` | `{ workers: 1 }` | Multi-process worker clustering. `'safe'` uses available CPU cores minus 1; `'max'` uses all available cores. |
+| `queue` | `{ driver?: 'memory', maxConcurrent?, maxQueue?, timeoutMs? }` | not set | Limits concurrent requests per process; extra requests wait, then get `503`. Unknown keys or another driver stop the start. |
 | `trustProxy` | `boolean \| number` | `false` | `true`: trust all proxy headers (`X-Forwarded-For`, `CF-Connecting-IP`, `True-Client-IP`, `X-Real-IP`). `N`: trust only the N closest hops in `X-Forwarded-For`, counting the socket peer; CDN headers are ignored. |
 | `bodyLimit` | `number` | `10485760` (10MB) | Maximum payload size in bytes for JSON and URL-encoded request bodies. |
 | `compression` | `boolean` | `false` | Enables gzip and Brotli response compression. |
@@ -195,7 +196,7 @@ The root configuration schema accepted by `exis.config.ts`:
 | Property | Type | Default | Description |
 | :--- | :--- | :--- | :--- |
 | `telemetry` | `boolean \| TelemetryConfig` | `{ enabled: false, exporter: 'console' }` | OpenTelemetry tracing and span reporting (`'otlp'` or `'console'`). |
-| `metrics` | `boolean \| MetricsConfig` | `{ enabled: false, path: '/metrics' }` | Prometheus-compatible metrics endpoint. |
+| `metrics` | `boolean \| MetricsConfig` | `{ enabled: false, path: '/metrics' }` | Prometheus text-format endpoint: request counts and duration histograms by route pattern, in-flight requests, memory and event-loop lag; aggregated across cluster workers. |
 | `healthcheck` | `boolean \| HealthCheckConfig` | `{ enabled: false, path: '/_health' }` | Liveness and readiness health probe route. |
 | `docs` | `boolean \| SwaggerConfig` | `{ enabled: false, path: '/docs' }` | Interactive OpenAPI / Swagger UI documentation generation. |
 

package/dist/docs/reference/validator.mdx

@@ -39,6 +39,8 @@ import type {
   TexFileOptions,
   TexPasswordOptions,
   TexObjectOptions,
+  TexUrlOptions,
+  SafeParseResult,
   ValidationErrorDescriptor,
   PaginationMeta,
   PaginatedResult,
@@ -93,6 +95,8 @@ The `tex.coerce` namespace provides explicit coercion primitives for query param
 
 Validates an object against a structured field schema.
 
+Options: `strict` (reject keys not in the schema), and `optional`, `nullable`, `nullish` for an object used as a field (the same as calling `.optional()`, `.nullable()` or `.nullish()`). Any other option throws, so a misspelled option in plain JavaScript is not silently ignored.
+
 ```typescript
 const UserSchema = tex.object({
   id: tex.string(),

package/dist/internal.d.ts

@@ -0,0 +1,16 @@
+export { loadConfig } from './config/config';
+export { loadEnv, parseEnv } from './config/env';
+export { App, setActiveAppInstance } from './server/app';
+export { RouteScanner, routeParadigm, mixedParadigmMessage, } from './router/route-scanner';
+export { describeAccess } from './router/authorize';
+export { formatCliError, formatDevError } from './error/overlay';
+export { registerPathAliasLoader, resolvePathAliases, } from './lib/resolve-aliases';
+export { getFormattedTime } from './utils/time';
+export { startBuiltServer, type StartOptions } from './lib/start-command';
+/** The production server entry (`exisjs/start`) */
+export declare const START_SERVER_PATH: string;
+/** The `node:test` reporter used by `exisjs test` */
+export declare const TEST_REPORTER_PATH: string;
+/** The installed runtime version, which the CLI must match */
+export declare const RUNTIME_VERSION: string;
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EACL,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EACL,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEzE,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,QAAiD,CAAA;AAE/E,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,QAI9B,CAAA;AAED,8DAA8D;AAE9D,eAAO,MAAM,eAAe,EAAE,MAA2C,CAAA"}

package/dist/internal.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RUNTIME_VERSION = exports.TEST_REPORTER_PATH = exports.START_SERVER_PATH = exports.startBuiltServer = exports.getFormattedTime = exports.resolvePathAliases = exports.registerPathAliasLoader = exports.formatDevError = exports.formatCliError = exports.describeAccess = exports.mixedParadigmMessage = exports.routeParadigm = exports.RouteScanner = exports.setActiveAppInstance = exports.App = exports.parseEnv = exports.loadEnv = exports.loadConfig = void 0;
+/**
+ * Runtime pieces used by `@exisjs/cli` (`exisjs/internal`).
+ *
+ * Not part of the public API: names and signatures may change in any
+ * release. The CLI is versioned together with this package.
+ */
+const node_path_1 = __importDefault(require("node:path"));
+var config_1 = require("./config/config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+var env_1 = require("./config/env");
+Object.defineProperty(exports, "loadEnv", { enumerable: true, get: function () { return env_1.loadEnv; } });
+Object.defineProperty(exports, "parseEnv", { enumerable: true, get: function () { return env_1.parseEnv; } });
+var app_1 = require("./server/app");
+Object.defineProperty(exports, "App", { enumerable: true, get: function () { return app_1.App; } });
+Object.defineProperty(exports, "setActiveAppInstance", { enumerable: true, get: function () { return app_1.setActiveAppInstance; } });
+var route_scanner_1 = require("./router/route-scanner");
+Object.defineProperty(exports, "RouteScanner", { enumerable: true, get: function () { return route_scanner_1.RouteScanner; } });
+Object.defineProperty(exports, "routeParadigm", { enumerable: true, get: function () { return route_scanner_1.routeParadigm; } });
+Object.defineProperty(exports, "mixedParadigmMessage", { enumerable: true, get: function () { return route_scanner_1.mixedParadigmMessage; } });
+var authorize_1 = require("./router/authorize");
+Object.defineProperty(exports, "describeAccess", { enumerable: true, get: function () { return authorize_1.describeAccess; } });
+var overlay_1 = require("./error/overlay");
+Object.defineProperty(exports, "formatCliError", { enumerable: true, get: function () { return overlay_1.formatCliError; } });
+Object.defineProperty(exports, "formatDevError", { enumerable: true, get: function () { return overlay_1.formatDevError; } });
+var resolve_aliases_1 = require("./lib/resolve-aliases");
+Object.defineProperty(exports, "registerPathAliasLoader", { enumerable: true, get: function () { return resolve_aliases_1.registerPathAliasLoader; } });
+Object.defineProperty(exports, "resolvePathAliases", { enumerable: true, get: function () { return resolve_aliases_1.resolvePathAliases; } });
+var time_1 = require("./utils/time");
+Object.defineProperty(exports, "getFormattedTime", { enumerable: true, get: function () { return time_1.getFormattedTime; } });
+var start_command_1 = require("./lib/start-command");
+Object.defineProperty(exports, "startBuiltServer", { enumerable: true, get: function () { return start_command_1.startBuiltServer; } });
+/** The production server entry (`exisjs/start`) */
+exports.START_SERVER_PATH = node_path_1.default.join(__dirname, 'lib', 'start-server.js');
+/** The `node:test` reporter used by `exisjs test` */
+exports.TEST_REPORTER_PATH = node_path_1.default.join(__dirname, 'testing', 'reporter.mjs');
+/** The installed runtime version, which the CLI must match */
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+exports.RUNTIME_VERSION = require('../package.json').version;
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;GAKG;AACH,0DAA4B;AAE5B,0CAA4C;AAAnC,oGAAA,UAAU,OAAA;AACnB,oCAAgD;AAAvC,8FAAA,OAAO,OAAA;AAAE,+FAAA,QAAQ,OAAA;AAC1B,oCAAwD;AAA/C,0FAAA,GAAG,OAAA;AAAE,2GAAA,oBAAoB,OAAA;AAClC,wDAI+B;AAH7B,6GAAA,YAAY,OAAA;AACZ,8GAAA,aAAa,OAAA;AACb,qHAAA,oBAAoB,OAAA;AAEtB,gDAAmD;AAA1C,2GAAA,cAAc,OAAA;AACvB,2CAAgE;AAAvD,yGAAA,cAAc,OAAA;AAAE,yGAAA,cAAc,OAAA;AACvC,yDAG8B;AAF5B,0HAAA,uBAAuB,OAAA;AACvB,qHAAA,kBAAkB,OAAA;AAEpB,qCAA+C;AAAtC,wGAAA,gBAAgB,OAAA;AACzB,qDAAyE;AAAhE,iHAAA,gBAAgB,OAAA;AAEzB,mDAAmD;AACtC,QAAA,iBAAiB,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAA;AAE/E,qDAAqD;AACxC,QAAA,kBAAkB,GAAG,mBAAI,CAAC,IAAI,CACzC,SAAS,EACT,SAAS,EACT,cAAc,CACf,CAAA;AAED,8DAA8D;AAC9D,iEAAiE;AACpD,QAAA,eAAe,GAAW,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAA"}

package/dist/{cli → lib}/resolve-aliases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-aliases.d.ts","sourceRoot":"","sources":["../../src/cli/resolve-aliases.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CAyDxD;AAMD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA+BzD;AAiKD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CA8CjB"}
+{"version":3,"file":"resolve-aliases.d.ts","sourceRoot":"","sources":["../../src/lib/resolve-aliases.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CAyDxD;AAMD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA+BzD;AAiKD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CA8CjB"}