@hideyukimori/nene2-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hideyuki MORI
+
+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

@@ -0,0 +1,138 @@
+# nene2-js
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![Node](https://img.shields.io/badge/Node-%3E%3D22%20LTS-339933)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178C6)](https://www.typescriptlang.org/)
+
+TypeScript ecosystem for [NENE2](https://github.com/hideyukiMORI/NENE2): OpenAPI-aligned types, HTTP client helpers, and Problem Details utilities for apps that consume NENE2 JSON APIs.
+
+**This repository is not a Node.js port of the PHP framework.** The PHP runtime stays in [NENE2](https://github.com/hideyukiMORI/NENE2). MCP stdio servers in PHP live in [nene-mcp](https://github.com/hideyukiMORI/nene-mcp).
+
+## What this repo is for
+
+- Typed fetch wrappers and shared client boundaries derived from NENE2 OpenAPI
+- RFC 9457 Problem Details parsing and validation-error helpers for TypeScript consumers
+- Optional codegen scripts and published npm packages (`@hideyukimori/nene2-client`, scoped subpackages later)
+- Documentation and tooling that follow the same Issue-driven workflow as NENE2
+
+## What this repo is not for
+
+- Replacing NENE2 PHP HTTP runtime, routing, middleware, or DI
+- Duplicating [nene-mcp](https://github.com/hideyukiMORI/nene-mcp) (stdio MCP server in PHP)
+- React/Vite starter UI (that remains in NENE2 `frontend/` unless explicitly extracted later)
+- Direct database access from AI tools or SDK code
+- Application-specific business logic (belongs in consumer projects and [NENE2-FT](https://github.com/hideyukiMORI/NENE2-FT) style trials)
+
+See [docs/scope.md](docs/scope.md) for the full in-scope / out-of-scope matrix.
+
+## Install (npm)
+
+```bash
+npm install @hideyukimori/nene2-client
+```
+
+Requires **Node 22+** (native `fetch`) or a browser with `fetch`. TypeScript consumers get `.d.ts` from the package.
+
+**Monorepo / contributors:** clone this repo and use `npm run check` (builds `dist/` and runs pack smoke).
+
+## Local layout (sibling of NENE2)
+
+```text
+../docker/
+├── NENE2/          # PHP framework (contract source: docs/openapi/openapi.yaml)
+├── nene2-js/       # this repository
+├── nene-mcp/       # PHP MCP stdio library (separate concern)
+└── NENE2-FT/       # field-trial reference apps
+```
+
+Clone next to your existing NENE2 checkout:
+
+```bash
+cd /path/to/parent-of-NENE2
+git clone git@github.com:hideyukiMORI/nene2-js.git
+cd nene2-js
+npm install
+npm run check
+```
+
+Point local development at a running NENE2 API when needed:
+
+```bash
+cp .env.example .env
+# NENE2_JS_API_BASE_URL=http://localhost:8080
+```
+
+## Usage (typed client)
+
+```ts
+import { createNene2Client, Nene2ClientError } from '@hideyukimori/nene2-client';
+
+const client = createNene2Client({
+  baseUrl: 'http://localhost:8080',
+  // apiKey: process.env.NENE2_MACHINE_API_KEY,
+  // bearer: process.env.NENE2_BEARER_TOKEN,
+});
+
+const { health, ping } = await client.smoke();
+const root = await client.frameworkSmoke();
+const notes = await client.listNotes({ limit: 20 });
+
+// Load balancers may return 503 with status "degraded" — opt in:
+const degraded = await client.health({ allowDegraded: true });
+
+try {
+  await client.getNote(1);
+} catch (err) {
+  if (err instanceof Nene2ClientError && err.problem) {
+    console.error(err.problem.title, err.problem.detail);
+  }
+}
+```
+
+Works in Node 22+ and browsers that provide `fetch`.
+
+### Verify the API before live smoke
+
+Port `8080` is not always NENE2. Confirm the canonical health shape:
+
+```bash
+curl -sS http://localhost:8080/health | jq .
+# expect: { "status": "ok", "service": "NENE2" }
+```
+
+If you see a different JSON wrapper, point `NENE2_JS_API_BASE_URL` at a running NENE2 PHP instance (sibling `../NENE2`).
+
+**Multi-backend live smoke** (same client, OpenAPI contract — see [ADR 0003](docs/adr/0003-multi-backend-live-verification.md)):
+
+```bash
+export NENE2_JS_API_BASE_URL=http://localhost:8080      # NENE2 PHP
+export NENE2_JS_PYTHON_BASE_URL=http://localhost:8000   # optional: nene2-python
+# export NENE2_JS_NODE_BASE_URL=http://localhost:3000   # optional: nene2-node
+
+npm test -- tests/client/live-smoke-matrix.test.ts
+```
+
+Unset URLs are skipped; CI runs fixture tests only. Field-trial friction: [ADR 0004](docs/adr/0004-field-trial-friction-resolution-cycle.md).
+
+## Contributing
+
+Work is **GitHub Issue driven**. Read [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) and [docs/workflow.md](docs/workflow.md) before opening a PR.
+
+AI agents: start at [AGENTS.md](AGENTS.md).
+
+Consumer DX evidence: [field trials](docs/field-trials/INDEX.md) (FT1–129; see [methodology](docs/development/field-trials.md)). Quick start: [howto/consume-client.md](docs/howto/consume-client.md).
+
+**Release:** [docs/development/publish.md](docs/development/publish.md) · Phase history: [docs/phase-2.md](docs/phase-2.md).
+
+## Related projects
+
+| Project                                                                 | Role                                                     |
+| ----------------------------------------------------------------------- | -------------------------------------------------------- |
+| [NENE2](https://github.com/hideyukiMORI/NENE2)                          | PHP API framework, OpenAPI contract, MCP catalog in-repo |
+| [nene2-node](https://github.com/hideyukiMORI/nene2-node)                | Node.js framework port (`@hideyukimori/nene2-framework`) |
+| [nene-mcp](https://github.com/hideyukiMORI/nene-mcp)                    | Standalone PHP stdio MCP server                          |
+| [hideyukimori/nene2](https://packagist.org/packages/hideyukimori/nene2) | Composer package for PHP consumers                       |
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/client/config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Configuration for {@link createNene2Client}.
+ */
+export interface Nene2ClientConfig {
+    /** API origin without trailing slash (e.g. `http://localhost:8080`). */
+    readonly baseUrl: string;
+    /** Machine client API key (`X-NENE2-API-Key`). */
+    readonly apiKey?: string | undefined;
+    /** Bearer JWT for protected routes. */
+    readonly bearer?: string | undefined;
+    /** Custom fetch implementation (tests, Node 18 polyfill). */
+    readonly fetch?: typeof fetch | undefined;
+    /** Optional abort signal forwarded to every request (Persona A: cancel in-flight calls). */
+    readonly signal?: AbortSignal | undefined;
+}
+/** @internal */
+export interface ResolvedNene2ClientConfig {
+    readonly baseUrl: string;
+    readonly apiKey: string | undefined;
+    readonly bearer: string | undefined;
+    readonly fetch: typeof fetch;
+    readonly signal: AbortSignal | undefined;
+}
+/** @internal */
+export declare function resolveConfig(config: Nene2ClientConfig): ResolvedNene2ClientConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/client/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,uCAAuC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IAC1C,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED,gBAAgB;AAChB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;CAC1C;AAED,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,yBAAyB,CAgBlF"}

package/dist/client/config.js

@@ -0,0 +1,19 @@
+/** @internal */
+export function resolveConfig(config) {
+    const baseUrl = config.baseUrl.replace(/\/+$/, '');
+    if (baseUrl.length === 0) {
+        throw new Error('Nene2ClientConfig.baseUrl must not be empty');
+    }
+    const fetchFn = config.fetch ?? globalThis.fetch;
+    if (typeof fetchFn !== 'function') {
+        throw new Error('fetch is not available; pass config.fetch');
+    }
+    return {
+        baseUrl,
+        apiKey: config.apiKey,
+        bearer: config.bearer,
+        fetch: fetchFn,
+        signal: config.signal,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/client/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/client/config.ts"],"names":[],"mappings":"AAyBA,gBAAgB;AAChB,MAAM,UAAU,aAAa,CAAC,MAAyB;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IACjD,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO;QACL,OAAO;QACP,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

package/dist/client/create-nene2-client.d.ts

@@ -0,0 +1,92 @@
+import { type Nene2ClientConfig } from './config.js';
+import { type CreateNoteRequest, type CreateTagRequest, type ExampleTag, type ExampleTagListResponse, type ListTagsParams, type ExampleNote, type ExampleNoteListResponse, type ListNotesParams, type ProtectedResponse } from '../types/examples/index.js';
+import { type ExamplePingResponse, type FrameworkSmokeResponse, type HealthResponse, type MachineHealthResponse, type SmokeCheckResult } from '../types/system.js';
+export type HealthOptions = {
+    /**
+     * When true, HTTP 503 with a valid {@link HealthResponse} body (`status: degraded`) is returned instead of throwing.
+     * Matches OpenAPI `getHealth` degraded response.
+     */
+    readonly allowDegraded?: boolean;
+};
+/**
+ * Typed NENE2 HTTP client (Phase 2 surface).
+ */
+export interface Nene2Client {
+    /**
+     * `GET /` — framework smoke (OpenAPI `getFrameworkSmoke`).
+     */
+    frameworkSmoke(): Promise<FrameworkSmokeResponse>;
+    /**
+     * `GET /health` — operational health (OpenAPI `getHealth`).
+     * By default, non-2xx (including 503 degraded) throws {@link Nene2ClientError}.
+     */
+    health(options?: HealthOptions): Promise<HealthResponse>;
+    /**
+     * `GET /machine/health` — API-key protected health (OpenAPI `getMachineHealth`). Requires `apiKey`.
+     */
+    machineHealth(): Promise<MachineHealthResponse>;
+    /**
+     * `GET /examples/ping` — example scaffold ping (OpenAPI `getExamplePing`).
+     */
+    ping(): Promise<ExamplePingResponse>;
+    /**
+     * Parallel `health()` + `ping()` for dashboards (FT2 Persona B: single smoke helper).
+     */
+    smoke(): Promise<SmokeCheckResult>;
+    /**
+     * `GET /examples/notes` — paginated list (OpenAPI `listExampleNotes`).
+     */
+    listNotes(params?: ListNotesParams): Promise<ExampleNoteListResponse>;
+    /**
+     * `GET /examples/notes/{id}` — single note (OpenAPI `getExampleNoteById`).
+     */
+    getNote(id: number): Promise<ExampleNote>;
+    /**
+     * `POST /examples/notes` — create note (OpenAPI `createExampleNote`).
+     */
+    createNote(body: CreateNoteRequest): Promise<ExampleNote>;
+    /**
+     * `PUT /examples/notes/{id}` — update note (OpenAPI `updateExampleNoteById`).
+     */
+    updateNote(id: number, body: CreateNoteRequest): Promise<ExampleNote>;
+    /**
+     * `DELETE /examples/notes/{id}` — delete note (OpenAPI `deleteExampleNoteById`, 204).
+     */
+    deleteNote(id: number): Promise<void>;
+    /**
+     * `GET /examples/tags` — paginated list (OpenAPI `listExampleTags`).
+     */
+    listTags(params?: ListTagsParams): Promise<ExampleTagListResponse>;
+    /**
+     * `GET /examples/tags/{id}` — single tag (OpenAPI `getExampleTagById`).
+     */
+    getTag(id: number): Promise<ExampleTag>;
+    /**
+     * `POST /examples/tags` — create tag (OpenAPI `createExampleTag`).
+     */
+    createTag(body: CreateTagRequest): Promise<ExampleTag>;
+    /**
+     * `PUT /examples/tags/{id}` — update tag (OpenAPI `updateExampleTagById`).
+     */
+    updateTag(id: number, body: CreateTagRequest): Promise<ExampleTag>;
+    /**
+     * `DELETE /examples/tags/{id}` — delete tag (OpenAPI `deleteExampleTagById`, 204).
+     */
+    deleteTag(id: number): Promise<void>;
+    /**
+     * `GET /examples/protected` — JWT claims demo (OpenAPI `getProtected`). Requires `bearer` in config.
+     */
+    getProtected(): Promise<ProtectedResponse>;
+}
+/**
+ * Create a typed client for documented NENE2 system endpoints.
+ *
+ * @example
+ * ```ts
+ * const client = createNene2Client({ baseUrl: 'http://localhost:8080' });
+ * const health = await client.health();
+ * const notes = await client.listNotes({ limit: 10 });
+ * ```
+ */
+export declare function createNene2Client(config: Nene2ClientConfig): Nene2Client;
+//# sourceMappingURL=create-nene2-client.d.ts.map

package/dist/client/create-nene2-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-nene2-client.d.ts","sourceRoot":"","sources":["../../src/client/create-nene2-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAKL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAElD;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEzD;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAEhD;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAErC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEnC;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEtE;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1D;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEtE;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnE;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAExC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvD;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEnE;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAkDxE"}

package/dist/client/create-nene2-client.js

@@ -0,0 +1,54 @@
+import { resolveConfig } from './config.js';
+import { withQuery } from './path.js';
+import { deleteNoContent, getJson, postJson, putJson } from './request.js';
+import { isExampleNoteListResponse, isExampleNoteResponse, isProtectedResponse, isExampleTagListResponse, isExampleTagResponse, } from '../types/examples/index.js';
+import { isExamplePingResponse, isFrameworkSmokeResponse, isHealthResponse, isMachineHealthResponse, } from '../types/system.js';
+/**
+ * Create a typed client for documented NENE2 system endpoints.
+ *
+ * @example
+ * ```ts
+ * const client = createNene2Client({ baseUrl: 'http://localhost:8080' });
+ * const health = await client.health();
+ * const notes = await client.listNotes({ limit: 10 });
+ * ```
+ */
+export function createNene2Client(config) {
+    const resolved = resolveConfig(config);
+    return {
+        frameworkSmoke: () => getJson(resolved, '/', isFrameworkSmokeResponse),
+        health: (options) => {
+            if (options?.allowDegraded) {
+                return getJson(resolved, '/health', isHealthResponse, { alsoOkStatuses: [503] });
+            }
+            return getJson(resolved, '/health', isHealthResponse);
+        },
+        machineHealth: () => getJson(resolved, '/machine/health', isMachineHealthResponse),
+        ping: () => getJson(resolved, '/examples/ping', isExamplePingResponse),
+        smoke: async () => {
+            const [health, ping] = await Promise.all([
+                getJson(resolved, '/health', isHealthResponse),
+                getJson(resolved, '/examples/ping', isExamplePingResponse),
+            ]);
+            return { health, ping };
+        },
+        listNotes: (params) => getJson(resolved, withQuery('/examples/notes', {
+            limit: params?.limit,
+            offset: params?.offset,
+        }), isExampleNoteListResponse),
+        getNote: (id) => getJson(resolved, `/examples/notes/${String(id)}`, isExampleNoteResponse),
+        createNote: (body) => postJson(resolved, '/examples/notes', body, isExampleNoteResponse),
+        updateNote: (id, body) => putJson(resolved, `/examples/notes/${String(id)}`, body, isExampleNoteResponse),
+        deleteNote: (id) => deleteNoContent(resolved, `/examples/notes/${String(id)}`),
+        listTags: (params) => getJson(resolved, withQuery('/examples/tags', {
+            limit: params?.limit,
+            offset: params?.offset,
+        }), isExampleTagListResponse),
+        getTag: (id) => getJson(resolved, `/examples/tags/${String(id)}`, isExampleTagResponse),
+        createTag: (body) => postJson(resolved, '/examples/tags', body, isExampleTagResponse),
+        updateTag: (id, body) => putJson(resolved, `/examples/tags/${String(id)}`, body, isExampleTagResponse),
+        deleteTag: (id) => deleteNoContent(resolved, `/examples/tags/${String(id)}`),
+        getProtected: () => getJson(resolved, '/examples/protected', isProtectedResponse),
+    };
+}
+//# sourceMappingURL=create-nene2-client.js.map

package/dist/client/create-nene2-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-nene2-client.js","sourceRoot":"","sources":["../../src/client/create-nene2-client.ts"],"names":[],"mappings":"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"}

package/dist/client/errors.d.ts

@@ -0,0 +1,17 @@
+import type { ProblemDetailsDocument } from '../problem/types.js';
+/**
+ * Error thrown when the NENE2 API returns a non-success HTTP status or an unexpected body.
+ */
+/** Type guard for {@link Nene2ClientError}. */
+export declare function isNene2ClientError(error: unknown): error is Nene2ClientError;
+export declare class Nene2ClientError extends Error {
+    readonly status: number;
+    readonly problem: ProblemDetailsDocument | undefined;
+    readonly url: string;
+    constructor(message: string, options: {
+        status: number;
+        url: string;
+        problem?: ProblemDetailsDocument | undefined;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/client/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE;;GAEG;AACH,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAGnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAA;KAAE;CAQzF"}

package/dist/client/errors.js

@@ -0,0 +1,20 @@
+/**
+ * Error thrown when the NENE2 API returns a non-success HTTP status or an unexpected body.
+ */
+/** Type guard for {@link Nene2ClientError}. */
+export function isNene2ClientError(error) {
+    return error instanceof Nene2ClientError;
+}
+export class Nene2ClientError extends Error {
+    status;
+    problem;
+    url;
+    constructor(message, options) {
+        super(message);
+        this.name = 'Nene2ClientError';
+        this.status = options.status;
+        this.url = options.url;
+        this.problem = options.problem;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/client/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,+CAA+C;AAC/C,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,gBAAgB,CAAC;AAC3C,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,MAAM,CAAS;IACf,OAAO,CAAqC;IAC5C,GAAG,CAAS;IAErB,YACE,OAAe,EACf,OAAsF;QAEtF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;CACF"}

package/dist/client/index.d.ts

@@ -0,0 +1,5 @@
+export { createNene2Client, type Nene2Client, type HealthOptions } from './create-nene2-client.js';
+export { isNene2ClientError, Nene2ClientError } from './errors.js';
+export type { Nene2ClientConfig } from './config.js';
+export { validationErrorsByField, validationErrorsFromClientError } from './validation-errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,4 @@
+export { createNene2Client } from './create-nene2-client.js';
+export { isNene2ClientError, Nene2ClientError } from './errors.js';
+export { validationErrorsByField, validationErrorsFromClientError } from './validation-errors.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAwC,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/client/path.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Append optional query parameters to a path (no leading `?` duplication).
+ */
+export declare function withQuery(path: string, query?: Readonly<Record<string, number | string | undefined>>): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/client/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/client/path.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,GAC5D,MAAM,CAYR"}

package/dist/client/path.js

@@ -0,0 +1,17 @@
+/**
+ * Append optional query parameters to a path (no leading `?` duplication).
+ */
+export function withQuery(path, query) {
+    if (query === undefined) {
+        return path;
+    }
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined) {
+            params.set(key, String(value));
+        }
+    }
+    const qs = params.toString();
+    return qs.length > 0 ? `${path}?${qs}` : path;
+}
+//# sourceMappingURL=path.js.map

package/dist/client/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/client/path.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,KAA6D;IAE7D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC"}

package/dist/client/request.d.ts

@@ -0,0 +1,23 @@
+import type { ResolvedNene2ClientConfig } from './config.js';
+export declare function buildAuthHeaders(config: ResolvedNene2ClientConfig): Headers;
+export type JsonRequestOptions = {
+    /** HTTP status codes to treat as success (e.g. 503 degraded health). */
+    readonly alsoOkStatuses?: readonly number[];
+};
+/**
+ * GET JSON and validate the body with a type guard. Throws {@link Nene2ClientError} on failure.
+ */
+export declare function getJson<T>(config: ResolvedNene2ClientConfig, path: string, isValid: (value: unknown) => value is T, options?: JsonRequestOptions): Promise<T>;
+/**
+ * POST JSON and validate the response body. Throws {@link Nene2ClientError} on failure.
+ */
+export declare function postJson<T>(config: ResolvedNene2ClientConfig, path: string, payload: unknown, isValid: (value: unknown) => value is T, options?: JsonRequestOptions): Promise<T>;
+/**
+ * PUT JSON and validate the response body. Throws {@link Nene2ClientError} on failure.
+ */
+export declare function putJson<T>(config: ResolvedNene2ClientConfig, path: string, payload: unknown, isValid: (value: unknown) => value is T, options?: JsonRequestOptions): Promise<T>;
+/**
+ * DELETE with no response body (204). Throws {@link Nene2ClientError} on failure.
+ */
+export declare function deleteNoContent(config: ResolvedNene2ClientConfig, path: string, options?: JsonRequestOptions): Promise<void>;
+//# sourceMappingURL=request.d.ts.map

package/dist/client/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/client/request.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAS7D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAS3E;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C,CAAC;AAwDF;;GAEG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,yBAAyB,EACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACvC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,MAAM,EAAE,yBAAyB,EACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACvC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,yBAAyB,EACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACvC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,yBAAyB,EACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/client/request.js

@@ -0,0 +1,99 @@
+import { parseProblemDetailsResponse } from '../problem/guards.js';
+import { Nene2ClientError } from './errors.js';
+function withSignal(config, init) {
+    if (config.signal === undefined) {
+        return init;
+    }
+    return { ...init, signal: config.signal };
+}
+export function buildAuthHeaders(config) {
+    const headers = new Headers({ Accept: 'application/json' });
+    if (config.apiKey !== undefined) {
+        headers.set('X-NENE2-API-Key', config.apiKey);
+    }
+    if (config.bearer !== undefined) {
+        headers.set('Authorization', `Bearer ${config.bearer}`);
+    }
+    return headers;
+}
+function isSuccessStatus(response, options) {
+    if (response.ok) {
+        return true;
+    }
+    return options?.alsoOkStatuses?.includes(response.status) ?? false;
+}
+async function parseJsonBody(response, url, isValid) {
+    const contentType = response.headers.get('content-type') ?? '';
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        const hint = contentType.includes('text/html') || contentType.includes('text/plain')
+            ? ' — response looks like HTML/text; check baseUrl points at NENE2 JSON API'
+            : '';
+        throw new Nene2ClientError(`NENE2 response is not valid JSON${hint}`, {
+            status: response.status,
+            url,
+        });
+    }
+    if (!isValid(body)) {
+        throw new Nene2ClientError('NENE2 response body does not match expected shape', {
+            status: response.status,
+            url,
+        });
+    }
+    return body;
+}
+async function throwOnErrorResponse(response, url, options) {
+    if (isSuccessStatus(response, options)) {
+        return;
+    }
+    const problem = await parseProblemDetailsResponse(response);
+    const detail = problem?.detail ?? problem?.title ?? response.statusText;
+    throw new Nene2ClientError(`NENE2 request failed: ${detail}`, {
+        status: response.status,
+        url,
+        problem,
+    });
+}
+/**
+ * GET JSON and validate the body with a type guard. Throws {@link Nene2ClientError} on failure.
+ */
+export async function getJson(config, path, isValid, options) {
+    const url = `${config.baseUrl}${path}`;
+    const response = await config.fetch(url, withSignal(config, { method: 'GET', headers: buildAuthHeaders(config) }));
+    await throwOnErrorResponse(response, url, options);
+    return parseJsonBody(response, url, isValid);
+}
+/**
+ * POST JSON and validate the response body. Throws {@link Nene2ClientError} on failure.
+ */
+export async function postJson(config, path, payload, isValid, options) {
+    const url = `${config.baseUrl}${path}`;
+    const headers = buildAuthHeaders(config);
+    headers.set('Content-Type', 'application/json');
+    const response = await config.fetch(url, withSignal(config, { method: 'POST', headers, body: JSON.stringify(payload) }));
+    await throwOnErrorResponse(response, url, options);
+    return parseJsonBody(response, url, isValid);
+}
+/**
+ * PUT JSON and validate the response body. Throws {@link Nene2ClientError} on failure.
+ */
+export async function putJson(config, path, payload, isValid, options) {
+    const url = `${config.baseUrl}${path}`;
+    const headers = buildAuthHeaders(config);
+    headers.set('Content-Type', 'application/json');
+    const response = await config.fetch(url, withSignal(config, { method: 'PUT', headers, body: JSON.stringify(payload) }));
+    await throwOnErrorResponse(response, url, options);
+    return parseJsonBody(response, url, isValid);
+}
+/**
+ * DELETE with no response body (204). Throws {@link Nene2ClientError} on failure.
+ */
+export async function deleteNoContent(config, path, options) {
+    const url = `${config.baseUrl}${path}`;
+    const response = await config.fetch(url, withSignal(config, { method: 'DELETE', headers: buildAuthHeaders(config) }));
+    await throwOnErrorResponse(response, url, options);
+}
+//# sourceMappingURL=request.js.map

package/dist/client/request.js.map

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

package/dist/client/validation-errors.d.ts

@@ -0,0 +1,11 @@
+import type { ValidationError } from '../problem/types.js';
+/**
+ * Extract RFC 9457 validation `errors` from a {@link Nene2ClientError} when present.
+ * Useful for mapping API validation failures to form fields (Persona A DX).
+ */
+export declare function validationErrorsFromClientError(error: unknown): readonly ValidationError[] | undefined;
+/**
+ * Map validation errors to a plain object keyed by field name (first error per field).
+ */
+export declare function validationErrorsByField(errors: readonly ValidationError[]): Readonly<Record<string, string>>;
+//# sourceMappingURL=validation-errors.d.ts.map

package/dist/client/validation-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-errors.d.ts","sourceRoot":"","sources":["../../src/client/validation-errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,GACb,SAAS,eAAe,EAAE,GAAG,SAAS,CAQxC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,eAAe,EAAE,GACjC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQlC"}