@stdy/cli 0.4.2

package/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,247 @@
+# Steady
+
+OpenAPI 3.0/3.1 mock server built with Deno. Validates requests against specs
+and generates responses from schemas or examples.
+
+## Installation
+
+```bash
+# npm (recommended)
+npm install -g @stdy/cli
+
+# Or with Deno
+deno install -gAn steady jsr:@steady/cli
+```
+
+## Usage
+
+```bash
+# Start mock server
+steady api.yaml
+
+# Validate spec without starting server
+steady validate api.yaml
+
+# Watch for spec changes
+steady -r api.yaml
+
+# Interactive mode with expandable request logs
+steady -i api.yaml
+```
+
+### Options
+
+```
+steady [command] [options] <spec-file>
+
+Commands:
+  validate <spec>    Validate an OpenAPI spec (doesn't start server)
+  <spec>             Start mock server (default)
+
+Options:
+  -p, --port <port>       Override server port (default: from spec or 3000)
+  -r, --auto-reload       Restart on spec file changes
+  -i, --interactive       Interactive TUI with expandable logs
+  --log-level <level>     summary | details | full (default: summary)
+  --log-bodies            Show request/response bodies
+  --log=false             Disable request logging
+  --strict                Reject invalid requests (default)
+  --relaxed               Log warnings but return responses anyway
+  -h, --help              Show help
+
+Generator Options:
+  --generator-array-size=<n>   Exact size for all generated arrays
+  --generator-array-min=<n>    Minimum array size (default: 1)
+  --generator-array-max=<n>    Maximum array size (default: 1)
+  --generator-seed=<n>         Seed for deterministic generation (-1 for random)
+```
+
+### Port Configuration
+
+The server port is determined in this order:
+
+1. `-p, --port` CLI flag
+2. `servers[0].url` port in your spec
+3. Default: 3000
+
+```yaml
+# Option 1: CLI flag takes precedence
+steady -p 8080 api.yaml
+
+# Option 2: Set in spec
+servers:
+  - url: http://localhost:8080
+```
+
+## Response Generation
+
+Steady generates responses in this order:
+
+1. `example` field on the media type
+2. First entry from `examples` map
+3. Generated from `schema` (if present)
+
+```yaml
+responses:
+  200:
+    content:
+      application/json:
+        # Option 1: explicit example (preferred)
+        example:
+          id: 123
+          name: "Alice"
+
+        # Option 2: multiple examples
+        examples:
+          success:
+            value: { id: 123, name: "Alice" }
+
+        # Option 3: generate from schema
+        schema:
+          $ref: "#/components/schemas/User"
+```
+
+## Request Validation
+
+In `--strict` mode (default), requests are validated against:
+
+- **Path parameters** - type coercion and schema validation
+- **Query parameters** - required check, type validation
+- **Headers** - required headers, schema validation
+- **Cookies** - required cookies, schema validation
+- **Request body** - JSON Schema validation, content-type check
+
+Invalid requests return 400 with validation errors. In `--relaxed` mode,
+validation errors are logged but responses are still returned.
+
+### Request Headers
+
+Override server behavior for individual requests:
+
+| Header                | Description                                       |
+| --------------------- | ------------------------------------------------- |
+| `X-Steady-Mode`       | Override validation mode: `strict` or `relaxed`   |
+| `X-Steady-Array-Size` | Override array size (sets both min and max)       |
+| `X-Steady-Array-Min`  | Override minimum array size                       |
+| `X-Steady-Array-Max`  | Override maximum array size                       |
+| `X-Steady-Seed`       | Override random seed (`-1` for non-deterministic) |
+
+```bash
+# Force strict validation
+curl -H "X-Steady-Mode: strict" http://localhost:3000/users
+
+# Request 50 items in arrays
+curl -H "X-Steady-Array-Size: 50" http://localhost:3000/users
+
+# Get random (non-deterministic) responses
+curl -H "X-Steady-Seed: -1" http://localhost:3000/users
+```
+
+### Response Headers
+
+Informational headers returned by the server:
+
+| Header                    | Description                                           |
+| ------------------------- | ----------------------------------------------------- |
+| `X-Steady-Mode`           | The validation mode used for this request             |
+| `X-Steady-Matched-Path`   | The OpenAPI path pattern that matched                 |
+| `X-Steady-Example-Source` | How the response was generated: `generated` or `none` |
+
+## Special Endpoints
+
+- `GET /_x-steady/health` - Health check with schema stats
+- `GET /_x-steady/spec` - Returns the loaded OpenAPI spec as JSON
+
+## JSON Schema Support
+
+Supports JSON Schema draft 2020-12 with ~91% compliance.
+
+**Supported:**
+
+- Types: `string`, `number`, `integer`, `boolean`, `null`, `array`, `object`
+- String: `minLength`, `maxLength`, `pattern`, `format`
+- Number: `minimum`, `maximum`, `exclusiveMinimum`, `exclusiveMaximum`,
+  `multipleOf`
+- Array: `items`, `prefixItems`, `minItems`, `maxItems`, `uniqueItems`,
+  `contains`, `unevaluatedItems`
+- Object: `properties`, `required`, `additionalProperties`, `patternProperties`,
+  `propertyNames`, `minProperties`, `maxProperties`, `unevaluatedProperties`
+- Composition: `allOf`, `anyOf`, `oneOf`, `not`
+- Conditional: `if`/`then`/`else`
+- References: `$ref`, `$defs`, `$anchor`
+- `const`, `enum`, `default`
+
+**Not supported:**
+
+- `$dynamicRef` / `$dynamicAnchor`
+- External `$ref` (http://, file://)
+
+## Error Attribution
+
+Errors indicate whether the issue is likely in the spec or the client request:
+
+```
+POST /users → 400 Bad Request
+
+Validation errors:
+  1. Required parameter missing
+     Path: query.limit
+     Expected: integer
+
+Attribution: SDK issue (high confidence)
+Suggestion: Check SDK implementation - required parameter not sent
+```
+
+## Development
+
+```bash
+git clone https://github.com/dgellow/steady.git
+cd steady
+git submodule update --init  # fetch test fixtures
+
+# Run tests
+deno task test
+
+# Type check
+deno task check
+
+# Lint + format
+deno task lint
+deno task fmt
+
+# Run all checks
+deno task test-all
+```
+
+### Project Structure
+
+```
+steady/
+├── cmd/steady.ts              # CLI entry point
+├── src/
+│   ├── server.ts              # HTTP server, route matching
+│   ├── validator.ts           # Request validation
+│   ├── errors.ts              # Error types with attribution
+│   └── logging/               # Request logging utilities
+├── packages/
+│   ├── json-pointer/          # @steady/json-pointer - RFC 6901
+│   ├── json-schema/           # @steady/json-schema - JSON Schema processor
+│   └── openapi/               # @steady/openapi - OpenAPI 3.x parser
+└── tests/
+    └── edge-cases/            # Edge case tests
+```
+
+### Tasks
+
+```bash
+deno task dev               # Dev server with watch
+deno task start             # Production server
+deno task test              # Run all tests
+deno task test:json-schema  # JSON Schema tests only
+deno task test:parser       # OpenAPI parser tests only
+deno task test:json-pointer # JSON Pointer tests only
+deno task check             # Type check
+deno task lint              # Lint
+deno task fmt               # Format
+deno task check-boundaries  # Verify package dependencies
+```

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@stdy/cli",
+  "version": "0.4.2",
+  "description": "OpenAPI 3 mock server. Validates SDKs against OpenAPI specs with clear error attribution.",
+  "license": "Elastic-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stainless-api/steady.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stainless-api/steady/issues"
+  },
+  "homepage": "https://github.com/stainless-api/steady#readme",
+  "keywords": [
+    "openapi",
+    "mock-server",
+    "api-testing",
+    "sdk-testing",
+    "json-schema",
+    "validation"
+  ],
+  "bin": {
+    "steady": "./steady.js"
+  },
+  "files": [
+    "steady.js"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "optionalDependencies": {
+    "@stdy/cli-linux-x64": "0.4.2",
+    "@stdy/cli-linux-arm64": "0.4.2",
+    "@stdy/cli-darwin-x64": "0.4.2",
+    "@stdy/cli-darwin-arm64": "0.4.2",
+    "@stdy/cli-win32-x64": "0.4.2"
+  }
+}

package/steady.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+const { execFileSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const platform = process.platform;
+const arch = process.arch;
+
+const PLATFORMS = {
+  "linux-x64": "cli-linux-x64",
+  "linux-arm64": "cli-linux-arm64",
+  "darwin-x64": "cli-darwin-x64",
+  "darwin-arm64": "cli-darwin-arm64",
+  "win32-x64": "cli-win32-x64",
+};
+
+const key = `${platform}-${arch}`;
+const pkgSuffix = PLATFORMS[key];
+
+if (!pkgSuffix) {
+  console.error(`Unsupported platform: ${key}`);
+  console.error("Please use Deno directly: deno run -A jsr:@steady/cli");
+  process.exit(1);
+}
+
+const binName = platform === "win32" ? "steady.exe" : "steady";
+let binPath;
+
+// Try multiple locations:
+// 1. Sibling directory (for local dev/testing)
+// 2. node_modules (for installed package)
+const locations = [
+  // Local dev: ../cli-linux-x64/bin/steady
+  path.join(__dirname, "..", pkgSuffix, "bin", binName),
+  // Installed: node_modules/@stdy/cli-linux-x64/bin/steady
+  path.join(__dirname, "..", "..", pkgSuffix, "bin", binName),
+];
+
+for (const loc of locations) {
+  if (fs.existsSync(loc)) {
+    binPath = loc;
+    break;
+  }
+}
+
+if (!binPath) {
+  // Try require.resolve as fallback
+  try {
+    const pkgPath = require.resolve(`@stdy/${pkgSuffix}/package.json`);
+    const pkgDir = path.dirname(pkgPath);
+    binPath = path.join(pkgDir, "bin", binName);
+  } catch (e) {
+    console.error(`Failed to find binary for ${key}`);
+    console.error("Try reinstalling: npm install @stdy/cli");
+    process.exit(1);
+  }
+}
+
+try {
+  execFileSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+} catch (e) {
+  if (e.status !== undefined) {
+    process.exit(e.status);
+  }
+  throw e;
+}