flowingts 0.0.0 → 0.19.0

package/dist/core/context.js

@@ -0,0 +1,460 @@
+import { Readable } from 'node:stream';
+import { ReadStream } from 'node:fs';
+import { HttpError } from './errors.js';
+import { parseCustomQuery, parseQuery } from '../utils/query.js';
+import { parseCookies, serializeCookie } from '../utils/cookie.js';
+import { hostnameOf, isValidHost, pickForwarded, splitRequestTarget } from '../utils/request-target.js';
+import { silentLogger } from './logger.js';
+import { sendResult } from './response/pipeline.js';
+import { RequestAbortedError } from './abort.js';
+import { parseTraceparent } from '../utils/trace-context.js';
+import { kAbort, kBindResponse, kContracts, kError, kHooks, kPendingSend, kPhase, kRawSend, kRoute, kRouted, kTelemetry, kFiles, } from './symbols.js';
+import { sendFile } from '../server/static.js';
+import { openSse } from './streaming/sse.js';
+import { NATIVE_CONTRACTS } from './contracts.js';
+export { kAbort, kBindResponse, kPendingSend, kRawSend } from './symbols.js';
+/** Erros de stream que só significam que o cliente foi embora (P-12). */
+const CLIENT_GONE = new Set(['ECONNRESET', 'EPIPE', 'ERR_STREAM_PREMATURE_CLOSE', 'ERR_STREAM_UNABLE_TO_PIPE', 'ERR_STREAM_DESTROYED']);
+function isClientDisconnect(err) {
+    return typeof err === 'object' && err !== null && CLIENT_GONE.has(err.code ?? '');
+}
+/**
+ * Envia um stream para a resposta (F-45). `.pipe()` em vez do `pipeline()`: o `pipeline()` alocava promessas e
+ * listeners por resposta que, num download em andamento, sobreviviam às coletas rápidas do V8 e eram promovidos;
+ * no cenário de arquivos estáticos, era o maior responsável pelo RSS de pico. O que o `pipeline()` fazia continua:
+ * erro na origem loga e destrói a resposta; resposta fechada antes do fim (cliente desistiu) destrói a origem,
+ * liberando o descritor do arquivo.
+ */
+function pipeStream(ctx, body) {
+    const res = ctx.res;
+    body.once('error', (err) => {
+        // P-12: o cliente desistir é normal e não é erro do servidor.
+        const clientGone = isClientDisconnect(err);
+        ctx.log[clientGone ? 'debug' : 'error']({ err, method: ctx.method, path: ctx.path }, clientGone ? 'client disconnected during stream' : 'stream failed');
+        res.destroy(err);
+    });
+    res.once('close', () => {
+        if (res.writableFinished || body.destroyed)
+            return;
+        ctx.log.debug({ method: ctx.method, path: ctx.path }, 'client disconnected during stream');
+        body.destroy();
+    });
+    body.pipe(res);
+}
+export class Context {
+    req;
+    res;
+    method;
+    path;
+    /** Id da requisição, também enviado no header `X-Request-Id` (F-06). */
+    id;
+    /** Parâmetros de rota; tipados pelo schema `params` quando informado em `Context<S>`. */
+    get params() {
+        this.routeParams ??= {};
+        return this.routeParams;
+    }
+    set params(value) {
+        this.routeParams = value;
+    }
+    routeParams;
+    /**
+     * A rota que atende esta requisição (F-38): template com o prefixo, classe, método e a regra de host que
+     * venceu. `undefined` antes do roteamento e quando nenhuma rota atende (404, 405, healthcheck, OpenAPI).
+     * Use `ctx.route.path` como rótulo de métrica, nunca `ctx.path`.
+     */
+    get route() {
+        return this[kRoute];
+    }
+    /** @internal */
+    [kRoute];
+    /** @internal O motor dos contratos do app (F-27). */
+    get [kContracts]() {
+        return this.opts.contracts ?? NATIVE_CONTRACTS;
+    }
+    /** @internal Etapa atual do pipeline, para a fase do `onError` (F-38). */
+    [kPhase] = 'middleware';
+    /** @internal A cadeia global chegou ao roteamento (o último middleware chamou `next()`). */
+    [kRouted] = false;
+    /** @internal O erro tratado pelo pipeline de erros, para o `onResponse` (F-38). */
+    [kError];
+    /** @internal Estado do `telemetry` desta requisição; só o módulo do telemetry lê e escreve (F-38). */
+    [kTelemetry];
+    /** @internal Arquivos do upload (F-46); definido só nas rotas com `files`, e então o body veio de um formulário. */
+    [kFiles];
+    /** Query string; tipada pelo schema `query` (já com coerção e defaults aplicados). Lida no primeiro acesso. */
+    get query() {
+        if (this.parsedQuery === undefined) {
+            const custom = this.opts.queryParser;
+            if (custom) {
+                try {
+                    this.parsedQuery = parseCustomQuery(custom, this.target.search);
+                }
+                catch {
+                    // A mensagem do parser pode expor detalhes internos: o cliente recebe só o motivo genérico.
+                    throw new HttpError(400, 'Invalid query string', 'INVALID_QUERY');
+                }
+            }
+            else {
+                this.parsedQuery = parseQuery(new URLSearchParams(this.target.search), this.opts.queryMaxKeys);
+            }
+        }
+        return this.parsedQuery;
+    }
+    set query(value) {
+        this.parsedQuery = value;
+    }
+    /** URL completa da requisição, com o host validado (S-09). Criada no primeiro acesso. */
+    get url() {
+        this.fullUrl ??= new URL(`${this.protocol}://${this.host || 'localhost'}${this.target.pathname}${this.target.search}`);
+        return this.fullUrl;
+    }
+    /** Logger da requisição, já com `reqId` (F-06). Criado no primeiro acesso. */
+    get log() {
+        if (!this.requestLog) {
+            // Com `telemetry`, os ids do span desta requisição; sem, o `traceId` recebido no `traceparent`.
+            const ids = this.opts.spanIds?.(this);
+            const traceId = ids?.traceId ?? this.trace?.traceId;
+            const base = this.opts.logger ?? silentLogger;
+            this.requestLog = base.child(ids ? { reqId: this.id, traceId: ids.traceId, spanId: ids.spanId } : traceId ? { reqId: this.id, traceId } : { reqId: this.id });
+        }
+        return this.requestLog;
+    }
+    /**
+     * Contexto de trace W3C recebido no `traceparent` (F-38), já validado: `{ traceId, parentSpanId, sampled,
+     * tracestate }`, ou `undefined` se não veio ou é inválido. Os logs do `ctx.log` levam o `traceId`.
+     */
+    get trace() {
+        if (this.traceContext === null) {
+            this.traceContext = parseTraceparent(this.req.headers.traceparent, this.req.headers.tracestate);
+        }
+        return this.traceContext;
+    }
+    traceContext = null;
+    // Campos preguiçosos (F-39, fase 2): calculados no primeiro acesso e guardados. Dependem só da
+    // requisição e da configuração do app, que não mudam durante a requisição.
+    /**
+     * Configuração do app, **a mesma referência** para todas as requisições (Flyweight, F-41): o `Context` lê
+     * dela em vez de copiar `trustProxy`, `onSend`, `queryMaxKeys` e o logger campo a campo.
+     */
+    opts;
+    target;
+    parsedQuery;
+    fullUrl;
+    requestLog;
+    memoHost;
+    memoHostname;
+    memoProtocol;
+    /**
+     * Um arquivo do upload, já recebido e validado pelo contrato `files` (F-46). Com `required: true`, nunca é
+     * `undefined`. Para campos com `maxCount` maior que 1, use `files()`.
+     */
+    file(name) {
+        return this[kFiles]?.get(name)?.[0];
+    }
+    /** Todos os arquivos de um campo do upload (F-46), na ordem em que chegaram; vazio se nenhum veio. */
+    files(name) {
+        return this[kFiles]?.get(name) ?? [];
+    }
+    /** Body; tipado pelo schema `body`. */
+    body = undefined;
+    /** Estado por requisição, criado no primeiro acesso (F-41). */
+    get state() {
+        this.requestState ??= {};
+        return this.requestState;
+    }
+    set state(value) {
+        this.requestState = value;
+    }
+    requestState;
+    /** `true` quando o handler chamou `ctx.status()`. Usado para escolher o schema de resposta (B-05). */
+    statusExplicit = false;
+    streaming = false;
+    abortController;
+    /**
+     * Cancelado quando o cliente desconecta antes do fim da resposta, ou quando o app está encerrando
+     * (F-13). Passe para consultas e `fetch` longos: `db.query(sql, { signal: ctx.signal })`.
+     */
+    get signal() {
+        if (!this.abortController) {
+            const controller = new AbortController();
+            this.abortController = controller;
+            if (this.res.writableEnded)
+                return controller.signal;
+            // O cliente pode ter desconectado antes do primeiro acesso ao signal (num `await` anterior):
+            // o evento 'close' já passou, então o estado precisa ser conferido agora.
+            if (this.res.destroyed || this.req.destroyed || this.req.socket?.destroyed) {
+                controller.abort(new RequestAbortedError('CLIENT_DISCONNECTED'));
+                return controller.signal;
+            }
+            this.res.once('close', () => {
+                // `writableEnded`: a resposta foi encerrada pelo app. `writableFinished` dependeria de o socket ter
+                // recebido tudo, e no inject (sem socket) uma resposta bem-sucedida pareceria uma desconexão.
+                if (!this.res.writableEnded)
+                    controller.abort(new RequestAbortedError('CLIENT_DISCONNECTED'));
+            });
+        }
+        return this.abortController.signal;
+    }
+    /**
+     * Por que esta requisição foi cancelada (`CLIENT_DISCONNECTED`, `SHUTDOWN`), ou `undefined` se não foi.
+     * Atalho tipado para `ctx.signal.reason.code` (F-38).
+     */
+    get abortReason() {
+        const reason = this.abortController?.signal.reason;
+        return reason instanceof RequestAbortedError ? reason.code : undefined;
+    }
+    /** @internal `true` em respostas de streaming (SSE, NDJSON, `Readable`) já iniciadas. */
+    get streamingResponse() {
+        return this.streaming;
+    }
+    markStreaming() {
+        if (this.streaming)
+            return;
+        this.streaming = true;
+        this.opts.onStream?.(this);
+    }
+    /** @internal */
+    [kAbort](code) {
+        void this.signal;
+        this.abortController?.abort(new RequestAbortedError(code));
+    }
+    /**
+     * Abre uma conexão de Server-Sent Events (F-13). A resposta fica aberta até `close()`, a desconexão do
+     * cliente ou o encerramento do app, que fecha estas conexões primeiro para o shutdown não esperar por elas.
+     *
+     * ```ts
+     * const stream = ctx.sse();
+     * const off = bus.on('order', (o) => stream.send({ event: 'order', id: o.id, data: o }));
+     * stream.onClose(off);
+     * ```
+     */
+    sse(opts = {}) {
+        return openSse(this, opts, () => this.markStreaming());
+    }
+    /**
+     * Envia um arquivo com `Content-Type`, `ETag`/`Last-Modified` (304) e `Range` (206), em stream (F-13).
+     * Com `root`, o path é relativo e não pode sair dela; sem `root`, precisa ser absoluto.
+     * Arquivo inexistente responde 404.
+     */
+    sendFile(path, opts) {
+        // O app aguarda este envio mesmo que o handler esqueça o `await`/`return`: sem isso, a resposta sairia
+        // vazia e um erro (404, por exemplo) viraria um unhandledRejection.
+        const pending = sendFile(this, path, opts);
+        this[kPendingSend] = pending;
+        return pending;
+    }
+    /** @internal */
+    [kPendingSend];
+    /**
+     * Corpo exatamente como foi escrito (F-04), depois do envio. Fica `undefined` em streams e em
+     * respostas sem corpo. Útil para cache: `await next(); store.set(key, ctx.sentBody)`.
+     */
+    get sentBody() {
+        // Convertido só se alguém ler (F-39): antes, toda resposta copiava o corpo para um Buffer.
+        if (this.sentBuffer === undefined && this.sentRaw !== undefined) {
+            this.sentBuffer = typeof this.sentRaw === 'string' ? Buffer.from(this.sentRaw) : Buffer.from(this.sentRaw);
+        }
+        return this.sentBuffer;
+    }
+    set sentBody(value) {
+        this.sentBuffer = value;
+        this.sentRaw = undefined;
+    }
+    sentRaw;
+    sentBuffer;
+    /** `Content-Type` da resposta enviada, junto com `sentBody`. */
+    sentType;
+    bound;
+    /**
+     * @param opts configuração; o app passa **o mesmo objeto** para todas as requisições (Flyweight), e o
+     *   que muda por requisição (`id`) vem à parte.
+     */
+    constructor(req, res, opts = {}, id) {
+        this.req = req;
+        this.res = res;
+        this.method = req.method ?? 'GET';
+        this.opts = opts;
+        // S-09: o path vem do request-target com base fixa; o host do cliente nunca entra no parsing.
+        this.target = splitRequestTarget(req.url);
+        this.path = this.target.pathname;
+        this.id = id ?? opts.id ?? '';
+    }
+    /**
+     * IP do cliente. Por padrão, o do socket. Com `trustProxy`, vem do `X-Forwarded-For`, que só deve
+     * ser ligado atrás de um proxy que reescreve esse header (S-09).
+     */
+    get ip() {
+        return pickForwarded(this.req.headers['x-forwarded-for'], this.opts.trustProxy ?? false) ?? this.req.socket.remoteAddress ?? '';
+    }
+    /**
+     * Host da requisição (`api.exemplo.com:8080`), **validado**: um valor inválido vira `''`.
+     * Com `trustProxy`, vem do `X-Forwarded-Host`. Para links absolutos, prefira uma URL base
+     * configurada em vez do host pedido pelo cliente (S-09).
+     */
+    get host() {
+        if (this.memoHost === undefined) {
+            const forwarded = pickForwarded(this.req.headers['x-forwarded-host'], this.opts.trustProxy ?? false);
+            const raw = forwarded !== undefined ? forwarded : this.req.headers.host;
+            this.memoHost = isValidHost(raw) ? raw : '';
+        }
+        return this.memoHost;
+    }
+    /** `host` sem a porta. */
+    get hostname() {
+        this.memoHostname ??= this.host ? hostnameOf(this.host) : '';
+        return this.memoHostname;
+    }
+    /** `https` se a conexão for TLS ou, com `trustProxy`, se o `X-Forwarded-Proto` disser; senão `http`. */
+    get protocol() {
+        if (this.memoProtocol === undefined) {
+            const forwarded = pickForwarded(this.req.headers['x-forwarded-proto'], this.opts.trustProxy ?? false)?.toLowerCase();
+            this.memoProtocol =
+                forwarded === 'https' || forwarded === 'http'
+                    ? forwarded
+                    : this.req.socket.encrypted
+                        ? 'https'
+                        : 'http';
+        }
+        return this.memoProtocol;
+    }
+    /**
+     * Define o status. Com schemas de resposta, aceita só os status declarados e o encadeamento tipa o
+     * corpo: `ctx.status(202).json({ jobId })` (F-32).
+     */
+    status(code) {
+        this.res.statusCode = code;
+        this.statusExplicit = true;
+        return this;
+    }
+    /**
+     * `true` quando a resposta já foi enviada (ou está sendo, no caso de streams).
+     * Depois disso o framework não escreve mais nada na resposta.
+     */
+    get sent() {
+        return this.streaming || this.res.writableEnded;
+    }
+    /** Lê um header da requisição (case-insensitive). Headers repetidos são unidos com `, `. */
+    get(name) {
+        const value = this.req.headers[name.toLowerCase()];
+        return Array.isArray(value) ? value.join(', ') : value;
+    }
+    parsedCookies;
+    /** Cookies da requisição (objeto sem protótipo; em nomes repetidos vale o primeiro). */
+    get cookies() {
+        return (this.parsedCookies ??= parseCookies(this.get('cookie')));
+    }
+    /**
+     * Adiciona um `Set-Cookie`. Padrões: `HttpOnly`, `Secure`, `SameSite=Lax` e `Path=/`.
+     * Se usar cookies para autenticar, ative também o middleware `csrf()`.
+     */
+    setCookie(name, value, opts) {
+        this.res.appendHeader('Set-Cookie', serializeCookie(name, value, opts));
+        return this;
+    }
+    /** Remove um cookie. Informe o mesmo `path` e `domain` usados ao criá-lo. */
+    clearCookie(name, opts = {}) {
+        return this.setCookie(name, '', { ...opts, maxAge: 0, expires: new Date(0) });
+    }
+    /** Define um header da resposta. */
+    header(name, value) {
+        this.res.setHeader(name, value);
+        return this;
+    }
+    /**
+     * Envia JSON. No handler, passa pelo mesmo pipeline do `return`: schema do status, remoção de
+     * campos não declarados e status padrão (F-32).
+     */
+    json(data) {
+        return this.dispatch(data, 'json');
+    }
+    /** Resposta em texto puro (`text/plain; charset=utf-8`), pelo mesmo pipeline do `return`. */
+    text(data) {
+        return this.dispatch(data, 'text');
+    }
+    /**
+     * Envia o corpo pelo mesmo pipeline do `return` (F-32): com `contentType` informado, usa esse tipo;
+     * senão, a negociação do `Accept` ou o tipo do valor (string, Buffer, stream, objeto → JSON).
+     * Para HTML, faça o escape do conteúdo dinâmico antes: o framework não faz isso por você (S-02).
+     */
+    send(body, contentType) {
+        if (this.sent)
+            return this;
+        if (contentType)
+            this.res.setHeader('Content-Type', contentType);
+        return this.dispatch(body, 'auto');
+    }
+    dispatch(body, mode) {
+        if (this.sent)
+            return this;
+        // Antes do handler (middlewares, guards) não há schema ligado: vale só o tipo do conteúdo.
+        const plan = this.bound;
+        if (plan)
+            sendResult(this, plan.response, body, plan.serializers, mode, plan.defaultStatus);
+        else
+            sendResult(this, undefined, body, undefined, mode);
+        return this;
+    }
+    /** @internal Liga os schemas de resposta da rota (o app chama antes do handler). */
+    [kBindResponse](plan) {
+        this.bound = plan;
+    }
+    /** @internal Envio cru, sem schema: string, bytes ou stream. */
+    [kRawSend](body, contentType) {
+        if (this.sent)
+            return this;
+        const type = contentType ?? this.res.getHeader('Content-Type') ?? 'application/octet-stream';
+        if (body instanceof Readable) {
+            this.res.setHeader('Content-Type', type);
+            // Arquivo do disco termina sozinho: fica fora do conjunto que o `close()` cancela (F-45).
+            if (body instanceof ReadStream)
+                this.streaming = true;
+            else
+                this.markStreaming();
+            pipeStream(this, body);
+            return this;
+        }
+        // Content-Type escrito uma vez só, depois do onSend (antes: duas vezes por resposta).
+        const global = this.opts.onSend;
+        const scoped = this[kRoute]?.[kHooks]?.onSend;
+        const payload = (global && global.length > 0) || scoped ? this.runOnSend({ body, contentType: type }, scoped) : { body, contentType: type };
+        this.res.setHeader('Content-Type', payload.contentType);
+        this.sentRaw = payload.body;
+        this.sentBuffer = undefined;
+        this.sentType = payload.contentType;
+        this.res.end(payload.body);
+        return this;
+    }
+    /** Aplica os `onSend` do app e depois os da rota (F-43); se algum lançar, loga e envia o payload original (F-04). */
+    runOnSend(original, scoped) {
+        let payload = original;
+        try {
+            for (const hook of this.opts.onSend ?? [])
+                payload = hook(this, payload) ?? payload;
+            if (scoped)
+                for (const hook of scoped)
+                    payload = hook(this, payload) ?? payload;
+            return payload;
+        }
+        catch (err) {
+            this.log.error({ err, method: this.method, path: this.path }, 'onSend hook failed; sending original response');
+            return original;
+        }
+    }
+    /**
+     * Redireciona (padrão 302). Não use `url` vinda do usuário sem validar: isso abre um
+     * open redirect. Prefira caminhos relativos ou uma lista de destinos permitidos.
+     */
+    redirect(url, status = 302) {
+        if (this.sent)
+            return this;
+        this.res.statusCode = status;
+        this.statusExplicit = true;
+        this.res.setHeader('Location', url);
+        this.res.end();
+        return this;
+    }
+    throw(status, message, code) {
+        throw new HttpError(status, message, code);
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

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

package/dist/core/contracts.d.ts

@@ -0,0 +1,76 @@
+import { type ValidationIssue, type ValidationTarget } from '../schema/validation.ts';
+/**
+ * O motor dos contratos das rotas (F-27): quem valida a entrada, filtra a saída e descreve o schema para o OpenAPI.
+ * Um por app, explícito: `createApp({ contracts: contracts.standard() })`. Sem a opção, vale o `contracts.native()`.
+ * Um schema que não pertence ao motor do app é recusado no registro da rota: não há mistura.
+ */
+export interface Contracts {
+    /** `native` (o padrão do FlowingTS) ou `standard` (Zod, Valibot, ArkType). */
+    readonly kind: 'native' | 'standard';
+    /** O schema é deste motor? Conferido no registro de cada rota. */
+    owns(schema: unknown): boolean;
+    /**
+     * Valida uma parte da entrada. `value` é o valor a usar daí em diante (o motor pode convertê-lo ou aplicar
+     * valores padrão). Pode ser assíncrono no motor `standard`.
+     */
+    check(schema: unknown, data: unknown, target: ValidationTarget): CheckResult | Promise<CheckResult>;
+    /** Serializa uma resposta JSON pelo schema, sem campos não declarados. Lança se a saída não corresponde. */
+    serialize(schema: unknown, data: unknown): string;
+    /** Valida a saída e devolve uma cópia sem campos não declarados (respostas em outros formatos). */
+    strip(schema: unknown, data: unknown): CheckResult;
+    /** O JSON Schema do schema, para o OpenAPI; `undefined` se o motor não sabe convertê-lo. */
+    toJsonSchema(schema: unknown): object | undefined;
+}
+export type CheckResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    issues: ValidationIssue[];
+};
+/** O mínimo da especificação Standard Schema v1 que o FlowingTS usa. */
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly '~standard': {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => StandardResult<Output> | Promise<StandardResult<Output>>;
+        readonly types?: {
+            readonly input: Input;
+            readonly output: Output;
+        } | undefined;
+    };
+}
+type StandardResult<Output> = {
+    readonly value: Output;
+    readonly issues?: undefined;
+} | {
+    readonly issues: ReadonlyArray<{
+        readonly message: string;
+        readonly path?: ReadonlyArray<PropertyKey | {
+            readonly key: PropertyKey;
+        }> | undefined;
+    }>;
+};
+export interface StandardContractsOptions {
+    /**
+     * Converte um schema em JSON Schema, para o OpenAPI. Com Zod 4: `{ toJSONSchema: (s) => z.toJSONSchema(s) }`.
+     * Sem esta opção, as rotas aparecem no OpenAPI sem os schemas.
+     */
+    toJSONSchema?: (schema: StandardSchemaV1) => object;
+}
+declare function standard(opts?: StandardContractsOptions): Contracts;
+/**
+ * Os motores de contrato do FlowingTS (F-27):
+ * - `contracts.native()`: o padrão (schemas TypeBox / JSON Schema, validados pelo Ajv, saída pelo serializador
+ *   compilado). Usado quando o app não declara nada.
+ * - `contracts.standard()`: schemas Standard Schema (Zod, Valibot, ArkType). Sem coerção automática: em `params`
+ *   e `query`, use os conversores da biblioteca (`z.coerce.number()`).
+ */
+export declare const contracts: {
+    native: () => Contracts;
+    standard: typeof standard;
+};
+/** O motor padrão, para quem não configurou nada. */
+export declare const NATIVE_CONTRACTS: Contracts;
+export {};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/core/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/core/contracts.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE/G;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IACrC,kEAAkE;IAClE,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC/B;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpG,4GAA4G;IAC5G,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IAClD,mGAAmG;IACnG,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IACnD,4FAA4F;IAC5F,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AA6BlG,wEAAwE;AACxE,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;IAC/D,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,cAAc,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QAChG,QAAQ,CAAC,KAAK,CAAC,EAAE;YAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAC;KACjF,CAAC;CACH;AAED,KAAK,cAAc,CAAC,MAAM,IACtB;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,GACvD;IACE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,WAAW,GAAG;YAAE,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;SAAE,CAAC,GAAG,SAAS,CAAC;KACxF,CAAC,CAAC;CACJ,CAAC;AA+BN,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,MAAM,CAAC;CACrD;AAED,iBAAS,QAAQ,CAAC,IAAI,GAAE,wBAA6B,GAAG,SAAS,CA0BhE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;kBACR,SAAS;;CAEtB,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,WAAS,CAAC"}

package/dist/core/contracts.js

@@ -0,0 +1,87 @@
+import { serialize } from '../schema/serialization.js';
+import { stripToSchema, validate } from '../schema/validation.js';
+// ---------------------------------------------------------------------------------------------------------------
+// Nativo: o comportamento de sempre (JSON Schema, que o TypeBox gera).
+// ---------------------------------------------------------------------------------------------------------------
+const isStandard = (schema) => typeof schema === 'object' &&
+    schema !== null &&
+    typeof schema['~standard']?.validate === 'function';
+const NATIVE = {
+    kind: 'native',
+    owns: (schema) => typeof schema === 'object' && schema !== null && !isStandard(schema),
+    check(schema, data, target) {
+        // O Ajv converte e aplica os padrões no próprio objeto: o valor validado é o mesmo.
+        const issues = validate(schema, data, target);
+        return issues ? { ok: false, issues } : { ok: true, value: data };
+    },
+    serialize: (schema, data) => serialize(schema, data),
+    strip: (schema, data) => stripToSchema(schema, data),
+    toJsonSchema: (schema) => schema,
+};
+/** O caminho de uma issue no formato das demais (JSON Pointer): `['items', 0, 'id']` → `/items/0/id`. */
+function pointer(path) {
+    if (!path || path.length === 0)
+        return '/';
+    return `/${path
+        .map((seg) => String(typeof seg === 'object' && seg !== null ? seg.key : seg)
+        .replace(/~/g, '~0')
+        .replace(/\//g, '~1'))
+        .join('/')}`;
+}
+function toCheck(result) {
+    if (result.issues)
+        return { ok: false, issues: result.issues.map((i) => ({ path: pointer(i.path), message: i.message })) };
+    return { ok: true, value: result.value };
+}
+const isThenable = (value) => typeof value === 'object' && value !== null && typeof value.then === 'function';
+/** A resposta é síncrona: um schema com validação assíncrona não serve para a saída. */
+function checkSync(schema, data) {
+    const result = schema['~standard'].validate(data);
+    if (isThenable(result)) {
+        throw new Error('[flowing] contracts.standard(): response schemas must validate synchronously (no async refinements).');
+    }
+    return toCheck(result);
+}
+function standard(opts = {}) {
+    return {
+        kind: 'standard',
+        owns: isStandard,
+        check(schema, data) {
+            const result = schema['~standard'].validate(data);
+            return isThenable(result) ? Promise.resolve(result).then(toCheck) : toCheck(result);
+        },
+        serialize(schema, data) {
+            const checked = checkSync(schema, data);
+            if (!checked.ok) {
+                throw new Error(`response does not match its schema: ${checked.issues.map((i) => `${i.path} ${i.message}`).join('; ')}`);
+            }
+            // O schema devolve o valor sem os campos não declarados (o z.object faz isso por padrão).
+            return JSON.stringify(checked.value);
+        },
+        strip: (schema, data) => checkSync(schema, data),
+        toJsonSchema(schema) {
+            if (!opts.toJSONSchema)
+                return undefined;
+            try {
+                return opts.toJSONSchema(schema);
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+/**
+ * Os motores de contrato do FlowingTS (F-27):
+ * - `contracts.native()`: o padrão (schemas TypeBox / JSON Schema, validados pelo Ajv, saída pelo serializador
+ *   compilado). Usado quando o app não declara nada.
+ * - `contracts.standard()`: schemas Standard Schema (Zod, Valibot, ArkType). Sem coerção automática: em `params`
+ *   e `query`, use os conversores da biblioteca (`z.coerce.number()`).
+ */
+export const contracts = {
+    native: () => NATIVE,
+    standard,
+};
+/** O motor padrão, para quem não configurou nada. */
+export const NATIVE_CONTRACTS = NATIVE;
+//# sourceMappingURL=contracts.js.map

package/dist/core/contracts.js.map

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