@xfcfam/xf-server-http 0.1.0

package/dist/src/api/general/ObjectRestService.d.ts

@@ -0,0 +1,196 @@
+import { RestService } from './RestService.js';
+import type { HttpRequest } from '../../business/transfers/HttpRequest.js';
+import type { HttpResponse } from '../../business/transfers/HttpResponse.js';
+import type { HttpHandler } from '../../business/transfers/Route.js';
+/**
+ * Body parser: given the raw bytes of a request and the value of the
+ * `Content-Type` header, produce the parsed JS object. May throw on
+ * invalid input; the pipeline wraps the failure in a
+ * `BadRequestException`.
+ */
+export type BodyParser = (bytes: Uint8Array, contentType: string) => unknown;
+/**
+ * Body serializer: given a JS value and the negotiated media type,
+ * produce the byte buffer to send on the wire. Mirror of
+ * {@link BodyParser}.
+ */
+export type BodySerializer = (value: unknown, mediaType: string) => Uint8Array;
+/**
+ * Configuration accepted by {@link ObjectRestService}'s constructor.
+ * All keys are optional — sensible JSON defaults are wired
+ * automatically.
+ */
+export interface ObjectRestOptions {
+    /**
+     * Content-Type → parser map. Keys are matched case-insensitively
+     * against the request's `Content-Type` (the media type before any
+     * `;` parameters). User entries override the built-in JSON parser.
+     *
+     * To support XML / CSV / YAML, supply the parser yourself and let
+     * the consumer choose the underlying library:
+     *
+     * ```ts
+     * new MyService({
+     *   parsers: new Map([
+     *     ['application/xml', (bytes) => xmlParser(decode(bytes))],
+     *   ]),
+     * })
+     * ```
+     */
+    readonly parsers?: ReadonlyMap<string, BodyParser>;
+    /**
+     * Media-type → serializer map. Selected by the response's
+     * `Content-Type` (defaulting to `application/json`).
+     */
+    readonly serializers?: ReadonlyMap<string, BodySerializer>;
+    /**
+     * Media type to use for serialisation when the response does not
+     * carry an explicit `Content-Type`. Default `'application/json'`.
+     */
+    readonly defaultMediaType?: string;
+    /**
+     * When `true`, the built-in JSON parser revives ISO-8601 date strings
+     * into `Date` objects (via {@link ObjectRestService.dateReviver}), so
+     * handlers receive real `Date`s on the request side. Serialising
+     * `Date`s back to string is automatic — see {@link formatDate} — so
+     * dates round-trip with this single flag. Default `false`.
+     */
+    readonly reviveDates?: boolean;
+    /**
+     * How a `Date` is rendered to text when serialising the response body.
+     * The developer decides the wire format: the default is ISO-8601
+     * (`date.toISOString()`), but any function works — date-only, epoch
+     * millis, a locale string, or a custom formatter.
+     *
+     * ```ts
+     * new MyService({ formatDate: (d) => d.toISOString().slice(0, 10) }) // YYYY-MM-DD
+     * new MyService({ formatDate: (d) => String(d.getTime()) })          // epoch ms
+     * ```
+     *
+     * Applied to every `Date` found anywhere in the response body (nested
+     * objects and arrays included). Default: ISO-8601.
+     */
+    readonly formatDate?: (date: Date) => string;
+}
+/**
+ * Generalization for Interaction Layer components that operate on
+ * **parsed JS objects** on both sides of the wire — the typical REST
+ * service.
+ *
+ * Extends {@link RestService} with automatic body parsing and
+ * serialisation. Use `this.object(handler)` when registering a route
+ * to wrap the handler in the full parse → handle → serialize pipeline:
+ *
+ * ```ts
+ * B.server.post('/users', this.object(this.createUser))
+ * ```
+ *
+ * Combine with `this.wrap(this.object(handler))` to add the
+ * per-service `onRequest` / `onResponse` hooks on top.
+ *
+ * **Built-in**: JSON parse + serialize, with developer-chosen date
+ * handling (see {@link ObjectRestService.dateReviver}, the `reviveDates`
+ * option, and `formatDate` in {@link ObjectRestOptions}). XML/CSV/YAML
+ * parsing and any other serializers are wired by passing them in
+ * {@link ObjectRestOptions}, keeping the package zero-dependency.
+ *
+ * Stream bodies (request or response) bypass parsing/serialisation:
+ * if the request body is a `ReadableStream` the handler may consume
+ * it directly; if the handler returns a `ReadableStream` or a
+ * `Uint8Array` it is sent verbatim.
+ *
+ * @example
+ * ```ts
+ * import { ObjectRestService, HttpStatusUtils } from '@xfcfam/xf-server'
+ * import { B } from '../../business/B.js'
+ *
+ * export class UsersRestService extends ObjectRestService {
+ *   override async init(): Promise<void> {
+ *     B.server.get('/users/:id', this.wrap(this.getUser))
+ *     B.server.post('/users',    this.object(this.createUser))
+ *   }
+ *
+ *   private async getUser(req: HttpRequest): Promise<HttpResponse> {
+ *     const user = await B.usersBusiness.findById(req.params.id!)
+ *     return { status: HttpStatusUtils.OK, body: user }
+ *   }
+ *
+ *   private async createUser(req: HttpRequest): Promise<HttpResponse> {
+ *     const body = req.body as { name: string; email: string }
+ *     const user = await B.usersBusiness.create(body)
+ *     return { status: HttpStatusUtils.CREATED, body: user }
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class ObjectRestService extends RestService {
+    protected readonly parsers: ReadonlyMap<string, BodyParser>;
+    protected readonly serializers: ReadonlyMap<string, BodySerializer>;
+    protected readonly defaultMediaType: string;
+    /** Developer-chosen `Date` → text formatter for the JSON serializer. */
+    protected readonly formatDate: (date: Date) => string;
+    constructor(options?: ObjectRestOptions);
+    /**
+     * Wrap a handler in the body parse → handle → serialize pipeline,
+     * plus the per-service `onRequest` / `onResponse` / `onError` hooks.
+     *
+     * This is the recommended registration method for
+     * `ObjectRestService` handlers:
+     *
+     * ```ts
+     * B.server.post('/users', this.object(this.createUser))
+     * ```
+     *
+     * The pipeline runs:
+     *   1. `onRequest(req)` (per-service hook)
+     *   2. parse request body (bytes → object, by Content-Type)
+     *   3. handler
+     *   4. `onResponse(req, res)` (per-service hook)
+     *   5. serialize response body (object → bytes, by Content-Type)
+     *
+     * `onResponse` fires before serialisation so envelope wrappers see
+     * the original payload.
+     *
+     * Use `this.wrap(handler)` instead when the handler already manages
+     * its own bytes (upload / download / SSE endpoints).
+     */
+    protected object<TReqBody = unknown, TResBody = unknown>(handler: HttpHandler<TReqBody, TResBody>): HttpHandler;
+    /**
+     * Decode the request body to a JS value using the registered
+     * parser for `Content-Type`. Stream bodies are buffered first.
+     * Exposed as `protected` so subclasses can call it directly when
+     * composing custom pipelines.
+     */
+    protected parseRequestBody(request: HttpRequest): Promise<HttpRequest>;
+    /**
+     * Encode the response body to bytes using the registered serializer
+     * for the response's `Content-Type` (or the default media type).
+     * Streams and Uint8Arrays are passed through unchanged. Exposed as
+     * `protected` so subclasses can call it directly when composing
+     * custom pipelines.
+     */
+    protected serializeResponseBody(response: HttpResponse): HttpResponse;
+    private static parseJson;
+    private static serializeJson;
+    private static toIsoString;
+    /**
+     * Deep-copy `value`, replacing every `Date` with `formatDate(date)` so
+     * a developer-chosen date format survives `JSON.stringify` (which would
+     * otherwise call `Date.toJSON` and force ISO-8601).
+     */
+    private static applyDateFormat;
+    /**
+     * JSON reviver that turns ISO-8601 date strings into `Date` objects —
+     * the developer shortcut for date handling. Use it directly with
+     * `JSON.parse(text, ObjectRestService.dateReviver)`, or set
+     * `reviveDates: true` in {@link ObjectRestOptions} to apply it to the
+     * built-in JSON parser. The inverse is automatic: a `Date` serializes
+     * back to text via the `formatDate` option (ISO-8601 by default).
+     */
+    static dateReviver(_key: string, value: unknown): unknown;
+    private static readonly ISO_DATE_RE;
+    private static mediaTypeOf;
+    private static isReadableStream;
+    private static collect;
+}
+//# sourceMappingURL=ObjectRestService.d.ts.map

package/dist/src/api/general/ObjectRestService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectRestService.d.ts","sourceRoot":"","sources":["../../../../src/api/general/ObjectRestService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAA;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAGpE;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAA;AAE5E;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,UAAU,CAAA;AAE9E;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAClD;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC1D;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAA;CAC7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,8BAAsB,iBAAkB,SAAQ,WAAW;IACzD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC3D,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACnE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IAC3C,wEAAwE;IACxE,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAA;gBAEzC,OAAO,GAAE,iBAAsB;IA2B3C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,CAAC,MAAM,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EACrD,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,GACvC,WAAW;IAiBd;;;;;OAKG;cACa,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAgC5E;;;;;;OAMG;IACH,SAAS,CAAC,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY;IA6BrE,OAAO,CAAC,MAAM,CAAC,SAAS;IAKxB,OAAO,CAAC,MAAM,CAAC,aAAa;IAS5B,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAe9B;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO;IAQzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CACqC;IAExE,OAAO,CAAC,MAAM,CAAC,WAAW;IAO1B,OAAO,CAAC,MAAM,CAAC,gBAAgB;mBAMV,OAAO;CAc7B"}

package/dist/src/api/general/ObjectRestService.js

@@ -0,0 +1,289 @@
+import { RestService } from './RestService.js';
+import { BadRequestException } from '../../business/transfers/BadRequestException.js';
+/**
+ * Generalization for Interaction Layer components that operate on
+ * **parsed JS objects** on both sides of the wire — the typical REST
+ * service.
+ *
+ * Extends {@link RestService} with automatic body parsing and
+ * serialisation. Use `this.object(handler)` when registering a route
+ * to wrap the handler in the full parse → handle → serialize pipeline:
+ *
+ * ```ts
+ * B.server.post('/users', this.object(this.createUser))
+ * ```
+ *
+ * Combine with `this.wrap(this.object(handler))` to add the
+ * per-service `onRequest` / `onResponse` hooks on top.
+ *
+ * **Built-in**: JSON parse + serialize, with developer-chosen date
+ * handling (see {@link ObjectRestService.dateReviver}, the `reviveDates`
+ * option, and `formatDate` in {@link ObjectRestOptions}). XML/CSV/YAML
+ * parsing and any other serializers are wired by passing them in
+ * {@link ObjectRestOptions}, keeping the package zero-dependency.
+ *
+ * Stream bodies (request or response) bypass parsing/serialisation:
+ * if the request body is a `ReadableStream` the handler may consume
+ * it directly; if the handler returns a `ReadableStream` or a
+ * `Uint8Array` it is sent verbatim.
+ *
+ * @example
+ * ```ts
+ * import { ObjectRestService, HttpStatusUtils } from '@xfcfam/xf-server'
+ * import { B } from '../../business/B.js'
+ *
+ * export class UsersRestService extends ObjectRestService {
+ *   override async init(): Promise<void> {
+ *     B.server.get('/users/:id', this.wrap(this.getUser))
+ *     B.server.post('/users',    this.object(this.createUser))
+ *   }
+ *
+ *   private async getUser(req: HttpRequest): Promise<HttpResponse> {
+ *     const user = await B.usersBusiness.findById(req.params.id!)
+ *     return { status: HttpStatusUtils.OK, body: user }
+ *   }
+ *
+ *   private async createUser(req: HttpRequest): Promise<HttpResponse> {
+ *     const body = req.body as { name: string; email: string }
+ *     const user = await B.usersBusiness.create(body)
+ *     return { status: HttpStatusUtils.CREATED, body: user }
+ *   }
+ * }
+ * ```
+ */
+export class ObjectRestService extends RestService {
+    parsers;
+    serializers;
+    defaultMediaType;
+    /** Developer-chosen `Date` → text formatter for the JSON serializer. */
+    formatDate;
+    constructor(options = {}) {
+        super();
+        this.formatDate = options.formatDate ?? ObjectRestService.toIsoString;
+        const jsonParser = options.reviveDates === true
+            ? (bytes) => JSON.parse(new TextDecoder('utf-8').decode(bytes), ObjectRestService.dateReviver)
+            : ObjectRestService.parseJson;
+        const parsers = new Map([
+            ['application/json', jsonParser],
+        ]);
+        if (options.parsers !== undefined) {
+            for (const [k, v] of options.parsers)
+                parsers.set(k.toLowerCase(), v);
+        }
+        this.parsers = parsers;
+        const formatDate = this.formatDate;
+        const serializers = new Map([
+            ['application/json', (value) => ObjectRestService.serializeJson(value, formatDate)],
+        ]);
+        if (options.serializers !== undefined) {
+            for (const [k, v] of options.serializers)
+                serializers.set(k.toLowerCase(), v);
+        }
+        this.serializers = serializers;
+        this.defaultMediaType = options.defaultMediaType ?? 'application/json';
+    }
+    /**
+     * Wrap a handler in the body parse → handle → serialize pipeline,
+     * plus the per-service `onRequest` / `onResponse` / `onError` hooks.
+     *
+     * This is the recommended registration method for
+     * `ObjectRestService` handlers:
+     *
+     * ```ts
+     * B.server.post('/users', this.object(this.createUser))
+     * ```
+     *
+     * The pipeline runs:
+     *   1. `onRequest(req)` (per-service hook)
+     *   2. parse request body (bytes → object, by Content-Type)
+     *   3. handler
+     *   4. `onResponse(req, res)` (per-service hook)
+     *   5. serialize response body (object → bytes, by Content-Type)
+     *
+     * `onResponse` fires before serialisation so envelope wrappers see
+     * the original payload.
+     *
+     * Use `this.wrap(handler)` instead when the handler already manages
+     * its own bytes (upload / download / SSE endpoints).
+     */
+    object(handler) {
+        const bound = handler.bind(this);
+        return async (req) => {
+            let r = await this.onRequest(req);
+            try {
+                r = await this.parseRequestBody(r);
+                const res = await bound(r);
+                const afterHook = await this.onResponse(r, res);
+                return this.serializeResponseBody(afterHook);
+            }
+            catch (err) {
+                const resolved = await this.onError(r, err);
+                if (resolved !== undefined)
+                    return resolved;
+                throw err;
+            }
+        };
+    }
+    /**
+     * Decode the request body to a JS value using the registered
+     * parser for `Content-Type`. Stream bodies are buffered first.
+     * Exposed as `protected` so subclasses can call it directly when
+     * composing custom pipelines.
+     */
+    async parseRequestBody(request) {
+        const body = request.body;
+        if (body === null || body === undefined)
+            return request;
+        // Multipart bodies are already an array of MultipartPart (the
+        // server adapter produced them before the parser ran). Pass
+        // through unchanged.
+        if (Array.isArray(body))
+            return request;
+        // Pass through non-bytes (e.g. already-parsed, or handler chose to consume the stream directly).
+        if (!(body instanceof Uint8Array) && !ObjectRestService.isReadableStream(body))
+            return request;
+        const bytes = body instanceof Uint8Array
+            ? body
+            : await ObjectRestService.collect(body);
+        if (bytes.byteLength === 0)
+            return { ...request, body: null };
+        const contentType = ObjectRestService.mediaTypeOf(request.headers['content-type']);
+        const parser = this.parsers.get(contentType.toLowerCase());
+        if (parser === undefined) {
+            // Unknown content-type → leave the bytes as-is; the handler may
+            // know what to do with them. Common case for binary uploads
+            // that bypass parsing.
+            return { ...request, body: bytes };
+        }
+        try {
+            const parsed = parser(bytes, contentType);
+            return { ...request, body: parsed };
+        }
+        catch (err) {
+            throw new BadRequestException(`Invalid ${contentType} body`, { detail: err.message });
+        }
+    }
+    /**
+     * Encode the response body to bytes using the registered serializer
+     * for the response's `Content-Type` (or the default media type).
+     * Streams and Uint8Arrays are passed through unchanged. Exposed as
+     * `protected` so subclasses can call it directly when composing
+     * custom pipelines.
+     */
+    serializeResponseBody(response) {
+        const body = response.body;
+        if (body === null || body === undefined)
+            return response;
+        if (body instanceof Uint8Array)
+            return response;
+        if (typeof body === 'string')
+            return response;
+        if (ObjectRestService.isReadableStream(body))
+            return response;
+        const headers = response.headers ?? {};
+        const explicit = headers['content-type'];
+        const mediaType = ObjectRestService.mediaTypeOf(explicit) || this.defaultMediaType;
+        const serializer = this.serializers.get(mediaType.toLowerCase());
+        if (serializer === undefined) {
+            // Fall back to JSON serialisation if the explicit media type
+            // is unknown — a sensible default rather than a 500.
+            return {
+                status: response.status,
+                headers: { ...headers, 'content-type': this.defaultMediaType },
+                body: ObjectRestService.serializeJson(body, this.formatDate),
+            };
+        }
+        return {
+            status: response.status,
+            headers: { ...headers, 'content-type': mediaType },
+            body: serializer(body, mediaType),
+        };
+    }
+    // ─── Helpers ────────────────────────────────────────────────
+    static parseJson(bytes, _ct) {
+        const text = new TextDecoder('utf-8').decode(bytes);
+        return JSON.parse(text);
+    }
+    static serializeJson(value, formatDate) {
+        // Fast path: the default ISO formatter matches `Date.toJSON`, so
+        // `JSON.stringify` already produces the right text — skip the walk.
+        const prepared = formatDate === ObjectRestService.toIsoString
+            ? value
+            : ObjectRestService.applyDateFormat(value, formatDate);
+        return new TextEncoder().encode(JSON.stringify(prepared));
+    }
+    static toIsoString(date) {
+        return date.toISOString();
+    }
+    /**
+     * Deep-copy `value`, replacing every `Date` with `formatDate(date)` so
+     * a developer-chosen date format survives `JSON.stringify` (which would
+     * otherwise call `Date.toJSON` and force ISO-8601).
+     */
+    static applyDateFormat(value, formatDate) {
+        if (value instanceof Date)
+            return formatDate(value);
+        if (Array.isArray(value)) {
+            return value.map(v => ObjectRestService.applyDateFormat(v, formatDate));
+        }
+        if (value !== null && typeof value === 'object') {
+            const out = {};
+            for (const [k, v] of Object.entries(value)) {
+                out[k] = ObjectRestService.applyDateFormat(v, formatDate);
+            }
+            return out;
+        }
+        return value;
+    }
+    /**
+     * JSON reviver that turns ISO-8601 date strings into `Date` objects —
+     * the developer shortcut for date handling. Use it directly with
+     * `JSON.parse(text, ObjectRestService.dateReviver)`, or set
+     * `reviveDates: true` in {@link ObjectRestOptions} to apply it to the
+     * built-in JSON parser. The inverse is automatic: a `Date` serializes
+     * back to text via the `formatDate` option (ISO-8601 by default).
+     */
+    static dateReviver(_key, value) {
+        if (typeof value === 'string' && ObjectRestService.ISO_DATE_RE.test(value)) {
+            const ms = Date.parse(value);
+            if (!Number.isNaN(ms))
+                return new Date(ms);
+        }
+        return value;
+    }
+    static ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?)?$/;
+    static mediaTypeOf(contentType) {
+        const ct = Array.isArray(contentType) ? contentType[0] : contentType;
+        if (typeof ct !== 'string' || ct.length === 0)
+            return '';
+        const semi = ct.indexOf(';');
+        return (semi < 0 ? ct : ct.substring(0, semi)).trim().toLowerCase();
+    }
+    static isReadableStream(value) {
+        return typeof value === 'object'
+            && value !== null
+            && typeof value.getReader === 'function';
+    }
+    static async collect(stream) {
+        const reader = stream.getReader();
+        const chunks = [];
+        let total = 0;
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (value !== undefined) {
+                chunks.push(value);
+                total += value.byteLength;
+            }
+        }
+        const out = new Uint8Array(total);
+        let offset = 0;
+        for (const chunk of chunks) {
+            out.set(chunk, offset);
+            offset += chunk.byteLength;
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=ObjectRestService.js.map

package/dist/src/api/general/ObjectRestService.js.map

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

package/dist/src/api/general/RestService.d.ts

@@ -0,0 +1,62 @@
+import { EntryService } from '@xfcfam/xf-server';
+import type { HttpRequest } from '../../business/transfers/HttpRequest.js';
+import type { HttpResponse } from '../../business/transfers/HttpResponse.js';
+/**
+ * Interaction-Layer Generalization for components that expose a set of
+ * HTTP endpoints over the Business-Layer server.
+ *
+ * The HTTP specialisation of {@link EntryService} (from
+ * `@xfcfam/xf-server`): it fixes the request/response types to
+ * `HttpRequest` / `HttpResponse` and adds HTTP response builders. The
+ * per-service pipeline (`wrap`, `onRequest` / `onResponse` / `onError`)
+ * is inherited unchanged.
+ *
+ * Concrete subclasses register their endpoints by calling
+ * `B.server.get(path, this.wrap(handler))` (or `post`, `put`, …) from
+ * within `init()`. The server (`HttpServerBusiness`) holds the route
+ * registry and starts Fastify; `RestService` contributes handlers via
+ * the push registration API.
+ *
+ * Body handling is **raw**: the request body arrives either as a
+ * `Uint8Array` (when fully buffered) or as a `ReadableStream<Uint8Array>`
+ * (when streamed). For the common case of JSON REST APIs that work with
+ * parsed objects on both sides, extend {@link ObjectRestService} — it
+ * adds automatic content-negotiation parsing and serialisation.
+ *
+ * @example
+ * ```ts
+ * import { RestService, HttpStatusUtils } from '@xfcfam/xf-server-http'
+ * import { B } from '../../business/B.js'
+ *
+ * export class HealthRestService extends RestService {
+ *   override async init(): Promise<void> {
+ *     B.server.get('/health', this.wrap(this.health))
+ *   }
+ *
+ *   private async health(_req: HttpRequest): Promise<HttpResponse> {
+ *     return { status: HttpStatusUtils.OK, body: { status: 'ok' } }
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class RestService extends EntryService<HttpRequest, HttpResponse> {
+    /**
+     * Convenience: build a successful response. Default status 200.
+     */
+    protected ok<T>(body: T, headers?: Record<string, string>): HttpResponse<T>;
+    /**
+     * Convenience: build a failure response. Default status 500.
+     */
+    protected ko<T>(body: T, status?: number, headers?: Record<string, string>): HttpResponse<T>;
+    /**
+     * Convenience: build a no-body 204. Use after successful mutations
+     * that don't return a payload.
+     */
+    protected empty(headers?: Record<string, string>): HttpResponse;
+    /**
+     * Convenience: throw an `InternalServerException`. Use only when no
+     * more specific HttpException applies.
+     */
+    protected fail(message: string, body?: unknown): never;
+}
+//# sourceMappingURL=RestService.d.ts.map

package/dist/src/api/general/RestService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestService.d.ts","sourceRoot":"","sources":["../../../../src/api/general/RestService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAA;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAA;AAG5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,8BAAsB,WAAY,SAAQ,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC;IAC/E;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAO3E;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,SAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAOzF;;;OAGG;IACH,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY;IAI/D;;;OAGG;IACH,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK;CAGvD"}

package/dist/src/api/general/RestService.js

@@ -0,0 +1,75 @@
+import { EntryService } from '@xfcfam/xf-server';
+import { InternalServerException } from '../../business/transfers/InternalServerException.js';
+/**
+ * Interaction-Layer Generalization for components that expose a set of
+ * HTTP endpoints over the Business-Layer server.
+ *
+ * The HTTP specialisation of {@link EntryService} (from
+ * `@xfcfam/xf-server`): it fixes the request/response types to
+ * `HttpRequest` / `HttpResponse` and adds HTTP response builders. The
+ * per-service pipeline (`wrap`, `onRequest` / `onResponse` / `onError`)
+ * is inherited unchanged.
+ *
+ * Concrete subclasses register their endpoints by calling
+ * `B.server.get(path, this.wrap(handler))` (or `post`, `put`, …) from
+ * within `init()`. The server (`HttpServerBusiness`) holds the route
+ * registry and starts Fastify; `RestService` contributes handlers via
+ * the push registration API.
+ *
+ * Body handling is **raw**: the request body arrives either as a
+ * `Uint8Array` (when fully buffered) or as a `ReadableStream<Uint8Array>`
+ * (when streamed). For the common case of JSON REST APIs that work with
+ * parsed objects on both sides, extend {@link ObjectRestService} — it
+ * adds automatic content-negotiation parsing and serialisation.
+ *
+ * @example
+ * ```ts
+ * import { RestService, HttpStatusUtils } from '@xfcfam/xf-server-http'
+ * import { B } from '../../business/B.js'
+ *
+ * export class HealthRestService extends RestService {
+ *   override async init(): Promise<void> {
+ *     B.server.get('/health', this.wrap(this.health))
+ *   }
+ *
+ *   private async health(_req: HttpRequest): Promise<HttpResponse> {
+ *     return { status: HttpStatusUtils.OK, body: { status: 'ok' } }
+ *   }
+ * }
+ * ```
+ */
+export class RestService extends EntryService {
+    /**
+     * Convenience: build a successful response. Default status 200.
+     */
+    ok(body, headers) {
+        const out = headers === undefined
+            ? { status: 200, body }
+            : { status: 200, body, headers };
+        return out;
+    }
+    /**
+     * Convenience: build a failure response. Default status 500.
+     */
+    ko(body, status = 500, headers) {
+        const out = headers === undefined
+            ? { status, body }
+            : { status, body, headers };
+        return out;
+    }
+    /**
+     * Convenience: build a no-body 204. Use after successful mutations
+     * that don't return a payload.
+     */
+    empty(headers) {
+        return headers === undefined ? { status: 204 } : { status: 204, headers };
+    }
+    /**
+     * Convenience: throw an `InternalServerException`. Use only when no
+     * more specific HttpException applies.
+     */
+    fail(message, body) {
+        throw new InternalServerException(message, body);
+    }
+}
+//# sourceMappingURL=RestService.js.map

package/dist/src/api/general/RestService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestService.js","sourceRoot":"","sources":["../../../../src/api/general/RestService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qDAAqD,CAAA;AAE7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,OAAgB,WAAY,SAAQ,YAAuC;IAC/E;;OAEG;IACO,EAAE,CAAI,IAAO,EAAE,OAAgC;QACvD,MAAM,GAAG,GAAoB,OAAO,KAAK,SAAS;YAChD,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE;YACvB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;QAClC,OAAO,GAAG,CAAA;IACZ,CAAC;IAED;;OAEG;IACO,EAAE,CAAI,IAAO,EAAE,MAAM,GAAG,GAAG,EAAE,OAAgC;QACrE,MAAM,GAAG,GAAoB,OAAO,KAAK,SAAS;YAChD,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;YAClB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;QAC7B,OAAO,GAAG,CAAA;IACZ,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,OAAgC;QAC9C,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAA;IAC3E,CAAC;IAED;;;OAGG;IACO,IAAI,CAAC,OAAe,EAAE,IAAc;QAC5C,MAAM,IAAI,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAClD,CAAC;CACF"}