@emulates/cloudcontrol 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog — @emulates/cloudcontrol
+
+## 0.1.1 (2026-10-06)
+
+Initial release.
+
+### Dependencies
+
+- `@emulates/sqlite`

package/DISCOVERY.md

@@ -0,0 +1,55 @@
+# @emulates/cloudcontrol discovery
+
+This is the installed-package index for coding agents and tooling. All relative links resolve
+inside `node_modules/@emulates/cloudcontrol/`; no repository checkout is needed to discover the emulator's
+supported surface or documented behavior.
+
+## Capability and behavior sources
+
+| Question | Authoritative file | What it contains |
+| --- | --- | --- |
+| Behaviour and integration | [`README.md`](README.md) | Routes, state transitions, auth, webhooks, controls, presets and deliberate omissions. |
+| Exact capabilities | [`SUPPORT.md`](SUPPORT.md) | Supported, unsupported and parity-covered operations or commands, including reasons for gaps. |
+| Wire contract | [`openapi.yaml`](openapi.yaml) | Machine-readable paths, methods, schemas, responses and parity annotations. |
+| Public API | [`dist/index.d.ts`](dist/index.d.ts) | The installed package's exact TypeScript exports and signatures. |
+| Package metadata | [`package.json`](package.json) | Runtime/entry-point claims, vendor links, parity scope/tier and `emulates.discovery`. |
+
+Read these together: the contract/capability matrix says *what* is available, while the README
+defines stateful behavior, lifecycle rules, test controls, and intentional oracle differences.
+If prose and an executable surface disagree, report a parity mismatch instead of adding a
+consumer-side workaround.
+
+## Parity and oracle
+
+- Declared parity surface: **Scaffold only; no vendor operations implemented or verified**.
+- Parity tier: **cold** (the repository controls when live checks run).
+- Oracle: **Live vendor API or sandbox**.
+- Repository command: `bun run parity:service -- cloudcontrol`.
+- Evidence model: Run from an Emulates checkout; credentials come only from .env.local or GitHub Actions secrets. Missing credentials exit 2.
+
+The npm package contains evidence summaries and the exact contract, not credentials or the
+repository-only parity harness. Self-parity/property and acceptance tests run in the Emulates
+repository; live parity is an additional oracle check, not a substitute for the packaged matrix.
+
+## Runtime introspection
+
+- `GET /__admin/health`
+- `GET /__admin`
+- `GET /__admin/state`
+- `GET /__admin/requests`
+- `GET /__admin/metrics`
+- `GET /__admin/faults/presets`
+- `GET /__admin/ui`
+
+For HTTP services, use `x-emulates-namespace` (or the documented credential/path carrier) so
+parallel tests do not share state. Admin state, journal, metrics and fault-preset endpoints are
+designed for assertions and diagnosis by consuming test suites.
+
+## Report a mismatch or missing capability
+
+Follow the [agent reporting contract](https://github.com/crvouga/emulators/blob/main/docs/REPORTING_ISSUES.md). Include package version,
+operation/command, a minimal redacted request, actual emulator result, expected oracle result or vendor
+documentation, and whether the mismatch appears in the matrix. Never include keys, tokens,
+customer data, prompts, PHI, card data, or unredacted recordings.
+
+Service key: `cloudcontrol`.

package/README.md

@@ -0,0 +1,44 @@
+# @emulates/cloudcontrol
+
+> Part of [Emulates](https://github.com/crvouga/emulators): high-fidelity, in-process emulators for APIs and databases.
+
+Transport scaffold for Amazon Cloud Control API. ESM; Node 22+ or Bun 1.2+.
+
+## Usage
+
+```ts
+import { createServer } from "@emulates/cloudcontrol/server"
+const mock = await createServer()
+// AWS SDK: endpoint: mock.url, region: "us-east-1", fixture credentials.
+// Await mock.close() after the test.
+```
+
+State lives in SQLite collections and participates in the shared runtime's namespace isolation,
+reset, timeline, clock, journal, metrics and fault controls. No AWS account is needed.
+
+**Planned, not implemented**, AWS operations: `CreateResource`, `GetResource`, `ListResources`, `UpdateResource`, `DeleteResource`, `GetResourceRequestStatus`, `ListResourceRequests`, `CancelResourceRequest`.
+
+Operations outside this list fail explicitly. This package emulates API state, not AWS infrastructure,
+production quotas, billing, IAM enforcement, or provider consoles. Service-specific omissions and
+oracle evidence are recorded in [the AWS coverage ledger](../../../docs/AWS_COVERAGE.md).
+
+Run `bun run parity` with LocalStack on `http://127.0.0.1:4566`; an unavailable oracle fails the run.
+No LocalStack run is recorded for this integration. The parity command is a bounded read-only SDK envelope probe, not proof of full vendor equivalence.
+
+## Implementation status
+
+No vendor operations are implemented. Requests fail explicitly with `UnknownOperationException`; transport tests cover this boundary and malformed input. This package is not a usable vendor replacement yet. No LocalStack or live AWS parity is claimed.
+
+## Install
+
+```sh
+bun add @emulates/cloudcontrol
+```
+
+## API
+
+- `CloudcontrolAPI(options?)`: low-level AWS transport instance with `fetch` and `reset`.
+
+- `createRuntime(options?)`: in-process Fetch API and shared state controls.
+- `createServer(options?)` from the `/server` entry: HTTP listener with `url`, `runtime`, and `close()`.
+- `document`, `operationIds`, and `supportedOperationIds`: generated transport contract metadata.

package/SUPPORT.md

@@ -0,0 +1,17 @@
+# Amazon Cloud Control API (Emulates subset) — operation support
+
+Generated from `openapi.yaml`; do not edit by hand.
+
+- operations in spec: **7**
+- supported by the emulator: **0**
+- parity enabled: **0**
+
+| operationId | route | emulator | parity | notes |
+| --- | --- | --- | --- | --- |
+| `AwsQuery` | `GET /` | ❌ unsupported | — | Vendor operations are not implemented in this scaffold. |
+| `AwsRpc` | `POST /` | ❌ unsupported | — | Vendor operations are not implemented in this scaffold. |
+| `AwsRestGet` | `GET /{path}` | ❌ unsupported | — | Vendor operations are not implemented in this scaffold. |
+| `AwsRestPut` | `PUT /{path}` | ❌ unsupported | — | Vendor operations are not implemented in this scaffold. |
+| `AwsRestPost` | `POST /{path}` | ❌ unsupported | — | Vendor operations are not implemented in this scaffold. |
+| `AwsRestDelete` | `DELETE /{path}` | ❌ unsupported | — | Vendor operations are not implemented in this scaffold. |
+| `AwsRestPatch` | `PATCH /{path}` | ❌ unsupported | — | Vendor operations are not implemented in this scaffold. |