@zmdb/web 1.0.0-beta.1

package/dist/data/index.d.ts

@@ -0,0 +1,35 @@
+import { type CoreSchema } from '@zmdb/schema';
+import { type CodecRegistry, type Variant } from '@zmdb/schema/ir';
+/**
+ * Adapt a validator into a pipeline `validateBody` hook. Pass any function that
+ * returns the validated value or throws — e.g. `@zmdb/validator`'s
+ * `assert<CreateDTO<T>>`. The framework embeds no parser of its own.
+ */
+export declare function validateWith<T>(validator: (raw: unknown) => T): (raw: unknown) => T;
+/**
+ * The wire→app decode, at the boundary and nowhere else (plan D3).
+ *
+ * A column has three types, and two of them meet here: JSON carries a `timestamp` as an
+ * ISO-8601 string and a `bigint` as a decimal one, while a handler, a `CreateDTO<T>` and
+ * the repository all hold a `Date` and a `bigint`. Something has to convert, and if it is
+ * not one function at the edge then it is every handler, differently — which is the state
+ * in which nobody noticed that the repository accepted both and the DDL was wrong.
+ *
+ * Put it *before* validation in the chain: it decodes, the validator then checks the app
+ * type. It converts and never rejects — a string that is not a date survives as a string,
+ * so the validator reports it rather than the handler receiving `Invalid Date`.
+ *
+ * ```ts
+ * dtoChain({ decode: wireDecoder(OrderSchema, 'create'), validate: assert<CreateDTO<Order>> })
+ * ```
+ */
+export declare function wireDecoder(schema: CoreSchema<string>, variant?: Variant, codecs?: CodecRegistry): (raw: unknown) => unknown;
+/**
+ * The app→wire encode, for a response: the same crossing in the other direction.
+ *
+ * A `Date` does not survive `JSON.stringify` as anything the published document describes
+ * — it becomes an ISO string, which happens to be right — and a `bigint` does not survive
+ * it at all (`TypeError`). Both are the wire type of a column, so both come from here.
+ */
+export declare function wireEncoder(schema: CoreSchema<string>, codecs?: CodecRegistry): (result: unknown) => unknown;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAA0B,KAAK,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE3F;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAEnF;AAOD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAC1B,OAAO,GAAE,OAAkB,EAC3B,MAAM,GAAE,aAAkB,GACzB,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAG3B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAE,aAAkB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAMhH"}

package/dist/data/index.js

@@ -0,0 +1,58 @@
+// @zmdb/web — HTTP data-boundary adapters (epic #277, spec ./SPEC.md).
+// Repository injection is app-owned; this module converts wire values and
+// adapts validators for the request pipeline.
+//
+// "No runtime parser" still holds with `wireDecoder` here: it converts the two column
+// types JSON cannot carry (a `timestamp`, a `bigint`) into the values the app layer holds,
+// and it accepts and rejects nothing. Validation remains the consumer's AOT `assert`.
+import {} from '@zmdb/schema';
+import { decodeWire, encodeWire } from '@zmdb/schema/ir';
+/**
+ * Adapt a validator into a pipeline `validateBody` hook. Pass any function that
+ * returns the validated value or throws — e.g. `@zmdb/validator`'s
+ * `assert<CreateDTO<T>>`. The framework embeds no parser of its own.
+ */
+export function validateWith(validator) {
+    return validator;
+}
+/** A JSON object body — not an array, which is a valid JSON document and not a payload. */
+function isBody(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * The wire→app decode, at the boundary and nowhere else (plan D3).
+ *
+ * A column has three types, and two of them meet here: JSON carries a `timestamp` as an
+ * ISO-8601 string and a `bigint` as a decimal one, while a handler, a `CreateDTO<T>` and
+ * the repository all hold a `Date` and a `bigint`. Something has to convert, and if it is
+ * not one function at the edge then it is every handler, differently — which is the state
+ * in which nobody noticed that the repository accepted both and the DDL was wrong.
+ *
+ * Put it *before* validation in the chain: it decodes, the validator then checks the app
+ * type. It converts and never rejects — a string that is not a date survives as a string,
+ * so the validator reports it rather than the handler receiving `Invalid Date`.
+ *
+ * ```ts
+ * dtoChain({ decode: wireDecoder(OrderSchema, 'create'), validate: assert<CreateDTO<Order>> })
+ * ```
+ */
+export function wireDecoder(schema, variant = 'create', codecs = {}) {
+    const ir = schema.ir;
+    return (raw) => (isBody(raw) ? decodeWire(ir, variant, raw, codecs) : raw);
+}
+/**
+ * The app→wire encode, for a response: the same crossing in the other direction.
+ *
+ * A `Date` does not survive `JSON.stringify` as anything the published document describes
+ * — it becomes an ISO string, which happens to be right — and a `bigint` does not survive
+ * it at all (`TypeError`). Both are the wire type of a column, so both come from here.
+ */
+export function wireEncoder(schema, codecs = {}) {
+    const ir = schema.ir;
+    return (result) => {
+        if (Array.isArray(result))
+            return result.map(row => (isBody(row) ? encodeWire(ir, row, codecs) : row));
+        return isBody(result) ? encodeWire(ir, result, codecs) : result;
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,0EAA0E;AAC1E,8CAA8C;AAC9C,EAAE;AACF,sFAAsF;AACtF,2FAA2F;AAC3F,sFAAsF;AAEtF,OAAO,EAAmB,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAoC,MAAM,iBAAiB,CAAC;AAE3F;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAI,SAA8B;IAC5D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2FAA2F;AAC3F,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CACzB,MAA0B,EAC1B,OAAO,GAAY,QAAQ,EAC3B,MAAM,GAAkB,EAAE;IAE1B,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;IACrB,OAAO,CAAC,GAAY,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACtF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,MAA0B,EAAE,MAAM,GAAkB,EAAE;IAChF,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;IACrB,OAAO,CAAC,MAAe,EAAE,EAAE;QACzB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACvG,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAClE,CAAC,CAAC;AACJ,CAAC"}

package/dist/devtools/index.d.ts

@@ -0,0 +1,74 @@
+import type { Scope } from '@zmdb/app/di';
+import { type ModuleClass } from '@zmdb/app/modules';
+import { type HttpMethod } from '../routing/index.js';
+export interface ModuleNode {
+    readonly id: string;
+    readonly name: string;
+    readonly lazy: boolean;
+    readonly imports: readonly string[];
+}
+export type ProviderNode = {
+    readonly kind: 'value';
+    readonly id: string;
+    readonly token: string;
+    readonly module: string;
+} | {
+    readonly kind: 'factory';
+    readonly id: string;
+    readonly token: string;
+    readonly module: string;
+    readonly scope: Scope;
+    /** Factory bodies are opaque, so their dependency edges are unknowable. */
+    readonly dependencies: readonly string[] | null;
+};
+export interface RouteNode {
+    readonly method: HttpMethod;
+    readonly path: string;
+    readonly handler: string;
+}
+export interface ClassNode {
+    readonly id: string;
+    readonly name: string;
+    readonly module: string;
+    readonly routes: readonly RouteNode[];
+    readonly dependencies: readonly string[];
+}
+export type FindingKind = 'cycle' | 'unresolved-token' | 'eager-depends-on-lazy' | 'duplicate-provider' | 'shadowed-route' | 'duplicate-token-description' | 'anonymous-class';
+export interface Finding {
+    readonly kind: FindingKind;
+    readonly severity: 'error' | 'warning';
+    readonly message: string;
+    readonly subject: string;
+    readonly path?: readonly string[];
+}
+export interface GraphDescription {
+    readonly modules: readonly ModuleNode[];
+    readonly providers: readonly ProviderNode[];
+    readonly controllers: readonly ClassNode[];
+    readonly findings: readonly Finding[];
+}
+export interface GraphFilter {
+    readonly module?: string;
+    readonly token?: string;
+    readonly depth?: number;
+    readonly providers?: boolean;
+}
+/**
+ * Reconstruct the declared graph without constructing a provider or controller.
+ *
+ * A cycle is returned as a finding instead of thrown, so this remains useful for
+ * the graphs that `compileModule` correctly refuses to boot.
+ */
+export declare function describeGraph(rootModule: ModuleClass): GraphDescription;
+/**
+ * Return known direct reverse edges.
+ *
+ * Factory provider bodies are opaque. For a provider query, the sentinel keeps
+ * that incompleteness visible instead of returning an unsafe "nothing else".
+ */
+export declare function dependentsOf(graph: GraphDescription, id: string): readonly string[];
+/** Render a deterministic, readable module tree. */
+export declare function renderTree(graph: GraphDescription, filter?: GraphFilter): string;
+/** Render Graphviz DOT with every id and label quoted. */
+export declare function renderDot(graph: GraphDescription, filter?: GraphFilter): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/devtools/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAS,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAe,KAAK,WAAW,EAAoC,MAAM,mBAAmB,CAAC;AAEpG,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,MAAM,YAAY,GACpB;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CACjD,CAAC;AAEN,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,kBAAkB,GAClB,uBAAuB,GACvB,oBAAoB,GACpB,gBAAgB,GAChB,6BAA6B,GAC7B,iBAAiB,CAAC;AAEtB,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAoCD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,WAAW,GAAG,gBAAgB,CAoOvE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAYnF;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CA8ChF;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAyE/E"}