@lovrozagar/honey 0.5.1 → 0.5.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -9
- package/dist/codegen-route-tree-intern.d.ts +29 -0
- package/dist/codegen-route-tree-intern.d.ts.map +1 -0
- package/dist/codegen.d.ts +5 -22
- package/dist/codegen.d.ts.map +1 -1
- package/dist/openapi/collect.d.ts +17 -0
- package/dist/openapi/collect.d.ts.map +1 -0
- package/dist/openapi/document.d.ts +29 -0
- package/dist/openapi/document.d.ts.map +1 -0
- package/dist/openapi/json-schema-slot.d.ts +5 -0
- package/dist/openapi/json-schema-slot.d.ts.map +1 -0
- package/dist/openapi/spec-factory.d.ts +1 -0
- package/dist/openapi/spec-factory.d.ts.map +1 -1
- package/dist/openapi/spec.d.ts +1 -1
- package/dist/openapi/spec.d.ts.map +1 -1
- package/dist/tree.d.ts +5 -39
- package/dist/tree.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/codegen-route-tree-intern.ts +171 -0
- package/src/codegen.ts +210 -728
- package/src/index.ts +7 -7
- package/src/openapi/collect.ts +75 -0
- package/src/openapi/document.ts +614 -0
- package/src/openapi/json-schema-slot.ts +13 -0
- package/src/openapi/spec-factory.ts +4 -0
- package/src/openapi/spec.ts +21 -11
- package/src/tree.ts +5 -398
package/README.md
CHANGED
|
@@ -1094,11 +1094,12 @@ Adapters if you wire them yourself: `bunWebSocket` (`honey/ws/bun`), `nodeWebSoc
|
|
|
1094
1094
|
|
|
1095
1095
|
`honey()` stays fetch-only until you opt in:
|
|
1096
1096
|
|
|
1097
|
-
| Call or import | Loads
|
|
1098
|
-
| -------------------------------------------------------------------------- |
|
|
1099
|
-
| `app.serve()` or `import "@lovrozagar/honey/serve"` | Listen adapters
|
|
1100
|
-
| `app.openapi()` / `app.manifest()` or `import "@lovrozagar/honey/openapi"` | Spec + docs
|
|
1101
|
-
| `
|
|
1097
|
+
| Call or import | Loads |
|
|
1098
|
+
| -------------------------------------------------------------------------- | -------------------------------------------- |
|
|
1099
|
+
| `app.serve()` or `import "@lovrozagar/honey/serve"` | Listen adapters |
|
|
1100
|
+
| `app.openapi()` / `app.manifest()` or `import "@lovrozagar/honey/openapi"` | Spec + docs (codegen; live Zod) |
|
|
1101
|
+
| `import { spec } from "@lovrozagar/honey/openapi/spec"` | Spec walker (intern JSON Schema; no codegen) |
|
|
1102
|
+
| `app.errorI18n()` or `import "@lovrozagar/honey/i18n"` | Error i18n |
|
|
1102
1103
|
|
|
1103
1104
|
Production bundles that only call `app.fetch` do not pull listen, OpenAPI, or i18n code. The load uses an opaque `import(["@lovrozagar/honey", name].join("/"))` so bundlers do not follow unused feature entries.
|
|
1104
1105
|
|
|
@@ -1512,7 +1513,7 @@ import { requestToCurl } from "@lovrozagar/honey/request-to-curl"
|
|
|
1512
1513
|
await requestToCurl(req, { excludeHeader: (n) => n === "authorization" })
|
|
1513
1514
|
```
|
|
1514
1515
|
|
|
1515
|
-
`honey/openapi/spec
|
|
1516
|
+
`honey/openapi/spec` walks intern JSON Schema without codegen. `honey/openapi/scalar` and `honey/openapi/swagger` are the docs UIs `app.openapi()` loads. `honey/cli` is the generate/init binary. `honey/codegen/extract` is the ts-morph extractor used by `--types`.
|
|
1516
1517
|
|
|
1517
1518
|
## Package exports
|
|
1518
1519
|
|
|
@@ -1523,8 +1524,9 @@ Import features from their path.
|
|
|
1523
1524
|
| `@lovrozagar/honey` | `honey`, `defineErrors`, `HoneyError`, `createMiddleware`, `HoneyRes`, Infer* types, `mergeTree`, `detectRuntime` |
|
|
1524
1525
|
| `honey/serve` | Register Node/Bun/Deno listen |
|
|
1525
1526
|
| `honey/node` | Low-level Node `serve()` |
|
|
1526
|
-
| `honey/openapi` | Register spec generation
|
|
1527
|
-
| `honey/openapi/spec`
|
|
1527
|
+
| `honey/openapi` | Register live spec generation (pulls codegen) |
|
|
1528
|
+
| `honey/openapi/spec` | Runtime spec walker — intern JSON Schema, no codegen |
|
|
1529
|
+
| `honey/openapi/scalar` `honey/openapi/swagger` | Docs UI |
|
|
1528
1530
|
| `honey/i18n` | Register error i18n |
|
|
1529
1531
|
| `@lovrozagar/honey/plugin` | Vite plugin + `generateFromApp` |
|
|
1530
1532
|
| `honey/client` / `honey/client/sdk` | Typed TS client runtime / generated-SDK helpers |
|
|
@@ -1539,7 +1541,7 @@ Import features from their path.
|
|
|
1539
1541
|
| `honey/codegen-go-cli` | `generateGoCLI` |
|
|
1540
1542
|
| `honey/codegen/extract` | ts-morph chain extractor |
|
|
1541
1543
|
| `honey/build` | `createBuildPlugin` |
|
|
1542
|
-
| `honey/tree` | Tree types + `mergeTree`
|
|
1544
|
+
| `honey/tree` | Tree types + `mergeTree` |
|
|
1543
1545
|
| `honey/cli` | `honey` binary |
|
|
1544
1546
|
| `honey/errors` | `defineErrors` (also on the root export) |
|
|
1545
1547
|
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Structural intern for generated route-tree modules.
|
|
3
|
+
*
|
|
4
|
+
* Handler objects stay unique (`.routeTree()` patches `fn`/`mw`/`iv`/`os` onto each
|
|
5
|
+
* `H*`). Values they point at — JSON Schema subtrees, meta objects, selector strings,
|
|
6
|
+
* error-key arrays — are shared by identity when their JSON is identical.
|
|
7
|
+
*/
|
|
8
|
+
export type ForcedPrefix = "I" | "M" | "O" | "P";
|
|
9
|
+
export declare class InternPool {
|
|
10
|
+
private readonly counts;
|
|
11
|
+
private readonly firstSeen;
|
|
12
|
+
private readonly forced;
|
|
13
|
+
private readonly forcedPrefix;
|
|
14
|
+
private readonly ids;
|
|
15
|
+
private readonly prefixCounters;
|
|
16
|
+
private readonly values;
|
|
17
|
+
private sealed;
|
|
18
|
+
count(v: unknown): void;
|
|
19
|
+
force(v: unknown, prefix: ForcedPrefix): void;
|
|
20
|
+
seal(): void;
|
|
21
|
+
id(v: unknown): string | undefined;
|
|
22
|
+
expr(v: unknown): string;
|
|
23
|
+
emitConstLines(): string[];
|
|
24
|
+
private shouldIntern;
|
|
25
|
+
private prefixFor;
|
|
26
|
+
private bump;
|
|
27
|
+
private printExpanded;
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=codegen-route-tree-intern.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codegen-route-tree-intern.d.ts","sourceRoot":"","sources":["../src/codegen-route-tree-intern.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;AA4BhD,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,MAAM,CAAQ;IAEtB,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAsBtB;IAED,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAU5C;IAED,IAAI,IAAI,IAAI,CAWX;IAED,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGjC;IAED,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAKvB;IAED,cAAc,IAAI,MAAM,EAAE,CAczB;IAED,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,aAAa;CAerB"}
|
package/dist/codegen.d.ts
CHANGED
|
@@ -1,9 +1,12 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import type { InvalidateCheckConfig } from "./invalidate-check.ts";
|
|
2
2
|
import type { Honey } from "./index.ts";
|
|
3
|
-
import { type
|
|
3
|
+
import { type OpenApiInfo, type OpenApiRouteInfo, type OpenApiSpec } from "./openapi/document.ts";
|
|
4
|
+
import type { TreeNode } from "./tree.ts";
|
|
4
5
|
export { prepareCodegen } from "./codegen-loaders.ts";
|
|
5
6
|
export type { InvalidateCheckConfig, InvalidateCheckLevel } from "./invalidate-check.ts";
|
|
6
7
|
export { toYaml, yamlSiblingPath } from "./yaml.ts";
|
|
8
|
+
export { DEFAULT_ERROR_JSON_SCHEMA } from "./openapi/document.ts";
|
|
9
|
+
export type { OpenApiInfo, OpenApiRouteInfo, OpenApiSpec };
|
|
7
10
|
type ErrorEntry = {
|
|
8
11
|
errorKey: string;
|
|
9
12
|
status: number;
|
|
@@ -23,21 +26,6 @@ type RouteManifest = {
|
|
|
23
26
|
errors: ErrorEntry[];
|
|
24
27
|
routes: RouteManifestEntry[];
|
|
25
28
|
};
|
|
26
|
-
type OpenApiInfo = {
|
|
27
|
-
description?: string;
|
|
28
|
-
title: string;
|
|
29
|
-
version: string;
|
|
30
|
-
};
|
|
31
|
-
export type OpenApiSpec = {
|
|
32
|
-
components?: {
|
|
33
|
-
schemas?: Record<string, Record<string, unknown>>;
|
|
34
|
-
securitySchemes?: Record<string, unknown>;
|
|
35
|
-
};
|
|
36
|
-
info: OpenApiInfo;
|
|
37
|
-
openapi: string;
|
|
38
|
-
paths: Record<string, Record<string, Record<string, unknown>>>;
|
|
39
|
-
};
|
|
40
|
-
export declare const DEFAULT_ERROR_JSON_SCHEMA: Record<string, unknown>;
|
|
41
29
|
export { normalizeSecurity } from "./meta-spec.ts";
|
|
42
30
|
export declare function canonicalizeSchema(schema: Record<string, unknown>): string;
|
|
43
31
|
export declare function deduplicateSchemas(spec: OpenApiSpec): OpenApiSpec;
|
|
@@ -49,11 +37,6 @@ export type OpenApiSanitizeOptions = {
|
|
|
49
37
|
export declare function sanitizeOpenApiSpec(spec: OpenApiSpec, options: OpenApiSanitizeOptions): OpenApiSpec;
|
|
50
38
|
export declare function resolveRefs(spec: OpenApiSpecInput): OpenApiSpecInput;
|
|
51
39
|
export declare function generateManifest<TEnv, TCtx>(app: Honey<TEnv, TCtx, unknown, unknown, unknown, string, string>): RouteManifest;
|
|
52
|
-
export type OpenApiRouteInfo<TMeta = unknown> = {
|
|
53
|
-
meta: TMeta;
|
|
54
|
-
method: string;
|
|
55
|
-
path: string;
|
|
56
|
-
};
|
|
57
40
|
export declare function generateOpenApi<TEnv, TCtx, TMeta = unknown>(app: Honey<TEnv, TCtx, unknown, TMeta, unknown, string, string>, options: {
|
|
58
41
|
filterRoutes?: (route: OpenApiRouteInfo<TMeta>) => boolean;
|
|
59
42
|
info: OpenApiInfo;
|
package/dist/codegen.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { RouteHandler, TreeNode, WSRouteHandler } from "../tree.ts";
|
|
2
|
+
import type { InputSchemaEntry, StandardSchemaLike } from "../types.ts";
|
|
3
|
+
export type CollectedRoute = {
|
|
4
|
+
handler: RouteHandler;
|
|
5
|
+
method: string;
|
|
6
|
+
path: string;
|
|
7
|
+
};
|
|
8
|
+
export type CollectedWSRoute = {
|
|
9
|
+
handler: WSRouteHandler;
|
|
10
|
+
path: string;
|
|
11
|
+
};
|
|
12
|
+
export declare function extractParams(path: string): string[];
|
|
13
|
+
export declare function toOpenApiPath(path: string): string;
|
|
14
|
+
export declare function walkTree(node: TreeNode, currentPath: string, routes: CollectedRoute[], includeSkipped?: boolean): void;
|
|
15
|
+
export declare function walkWSRoutes(node: TreeNode, currentPath: string, routes: CollectedWSRoute[]): void;
|
|
16
|
+
export declare function unwrapEntry(entry: InputSchemaEntry): StandardSchemaLike;
|
|
17
|
+
//# sourceMappingURL=collect.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/openapi/collect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEvE,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,YAAY,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,cAAc,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,QAAQ,CACvB,IAAI,EAAE,QAAQ,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EAAE,EACxB,cAAc,CAAC,EAAE,OAAO,GACtB,IAAI,CAsBN;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAUlG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,kBAAkB,CAKvE"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { InvalidateCheckConfig } from "../invalidate-check.ts";
|
|
2
|
+
export type OpenApiRouteInfo<TMeta = unknown> = {
|
|
3
|
+
meta: TMeta;
|
|
4
|
+
method: string;
|
|
5
|
+
path: string;
|
|
6
|
+
};
|
|
7
|
+
export type OpenApiInfo = {
|
|
8
|
+
description?: string;
|
|
9
|
+
title: string;
|
|
10
|
+
version: string;
|
|
11
|
+
};
|
|
12
|
+
export type OpenApiSpec = {
|
|
13
|
+
components?: {
|
|
14
|
+
schemas?: Record<string, Record<string, unknown>>;
|
|
15
|
+
securitySchemes?: Record<string, unknown>;
|
|
16
|
+
};
|
|
17
|
+
info: OpenApiInfo;
|
|
18
|
+
openapi: string;
|
|
19
|
+
paths: Record<string, Record<string, Record<string, unknown>>>;
|
|
20
|
+
};
|
|
21
|
+
export declare const DEFAULT_ERROR_JSON_SCHEMA: Record<string, unknown>;
|
|
22
|
+
export declare function generateOpenApiFromTree<TMeta = unknown>(app: unknown, options: {
|
|
23
|
+
filterRoutes?: (route: OpenApiRouteInfo<TMeta>) => boolean;
|
|
24
|
+
info: OpenApiInfo;
|
|
25
|
+
invalidate?: InvalidateCheckConfig;
|
|
26
|
+
profile?: string;
|
|
27
|
+
securitySchemes?: Record<string, unknown>;
|
|
28
|
+
}): OpenApiSpec;
|
|
29
|
+
//# sourceMappingURL=document.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/openapi/document.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAA4B,MAAM,wBAAwB,CAAA;AAsB7F,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IAAI;IAC/C,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACzB,UAAU,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;QACjD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACzC,CAAA;IACD,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAC9D,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAyB7D,CAAA;AAwND,wBAAgB,uBAAuB,CAAC,KAAK,GAAG,OAAO,EACtD,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE;IACR,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,OAAO,CAAA;IAC1D,IAAI,EAAE,WAAW,CAAA;IACjB,UAAU,CAAC,EAAE,qBAAqB,CAAA;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC,GACC,WAAW,CA4Tb"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { StandardSchemaLike } from "../types.ts";
|
|
2
|
+
export type JsonSchemaConverter = (schema: StandardSchemaLike, io?: "input" | "output") => Record<string, unknown>;
|
|
3
|
+
export declare function setJsonSchemaConverter(next: JsonSchemaConverter | undefined): void;
|
|
4
|
+
export declare function getJsonSchemaConverter(): JsonSchemaConverter | undefined;
|
|
5
|
+
//# sourceMappingURL=json-schema-slot.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"json-schema-slot.d.ts","sourceRoot":"","sources":["../../src/openapi/json-schema-slot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,EAAE,OAAO,GAAG,QAAQ,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAIlH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAElF;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,SAAS,CAExE"}
|
|
@@ -32,4 +32,5 @@ export type OpenApiRuntime = {
|
|
|
32
32
|
export declare function registerOpenApiRuntime(next: OpenApiRuntime): void;
|
|
33
33
|
export declare function resetOpenApiRuntime(): void;
|
|
34
34
|
export declare function getOpenApiRuntime(): OpenApiRuntime;
|
|
35
|
+
export declare function tryGetOpenApiRuntime(): OpenApiRuntime | undefined;
|
|
35
36
|
//# sourceMappingURL=spec-factory.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"spec-factory.d.ts","sourceRoot":"","sources":["../../src/openapi/spec-factory.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAEjG,MAAM,MAAM,eAAe,GAAG,CAC7B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE;IACR,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAA;IAClF,IAAI,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9D,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;KAAE,CAAA;IAChG,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC,KACG,OAAO,CAAC,OAAO,CAAC,CAAA;AAErB,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAEjE,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,MAAM,MAAM,MAAM,GAAG,CACpB,IAAI,EAAE,QAAQ,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,KACX,CAAC,GAAG,EAAE;IAAE,GAAG,EAAE,QAAQ,CAAA;CAAE,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,eAAe,EAAE,eAAe,CAAA;IAChC,MAAM,EAAE,YAAY,CAAA;CACpB,CAAA;AAMD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAEjE;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAGlD"}
|
|
1
|
+
{"version":3,"file":"spec-factory.d.ts","sourceRoot":"","sources":["../../src/openapi/spec-factory.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAEjG,MAAM,MAAM,eAAe,GAAG,CAC7B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE;IACR,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAA;IAClF,IAAI,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9D,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;KAAE,CAAA;IAChG,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC,KACG,OAAO,CAAC,OAAO,CAAC,CAAA;AAErB,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAEjE,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,MAAM,MAAM,MAAM,GAAG,CACpB,IAAI,EAAE,QAAQ,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,KACX,CAAC,GAAG,EAAE;IAAE,GAAG,EAAE,QAAQ,CAAA;CAAE,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,eAAe,EAAE,eAAe,CAAA;IAChC,MAAM,EAAE,YAAY,CAAA;CACpB,CAAA;AAMD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAEjE;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAGlD;AAED,wBAAgB,oBAAoB,IAAI,cAAc,GAAG,SAAS,CAEjE"}
|
package/dist/openapi/spec.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import type { OpenApiRouteInfo } from "../codegen.ts";
|
|
2
1
|
import type { DefaultMeta } from "../types.ts";
|
|
3
2
|
import type { TypedResponse } from "../response.ts";
|
|
3
|
+
import { type OpenApiRouteInfo } from "./document.ts";
|
|
4
4
|
type SpecOptions<TMeta = Record<string, unknown> | null> = {
|
|
5
5
|
description?: string;
|
|
6
6
|
filterRoutes?: (route: OpenApiRouteInfo<DefaultMeta & TMeta>) => boolean;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/openapi/spec.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/openapi/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAG9E,KAAK,WAAW,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,IAAI;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,WAAW,GAAG,KAAK,CAAC,KAAK,OAAO,CAAA;IACxE,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAgB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC1D,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,GACzB,CAAC,GAAG,EAAE;IAAE,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,GAAG,aAAa,CAAA;KAAE,CAAA;CAAE,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAgC5G"}
|
package/dist/tree.d.ts
CHANGED
|
@@ -9,8 +9,8 @@ export type RouteHandler = {
|
|
|
9
9
|
_skip?: boolean;
|
|
10
10
|
/** boundary error key — wraps undeclared/unexpected errors (null = use default or internal_server_error) */
|
|
11
11
|
bek: string | null;
|
|
12
|
-
/** pre-computed error factory subset (null = use global factory) */
|
|
13
|
-
ef
|
|
12
|
+
/** pre-computed error factory subset (omit/`null` = use global factory) */
|
|
13
|
+
ef?: Record<string, (...args: never[]) => unknown> | null;
|
|
14
14
|
/** declared error keys for this route — used for runtime enforcement */
|
|
15
15
|
ek: Set<string>;
|
|
16
16
|
/** handler function */
|
|
@@ -24,9 +24,9 @@ export type RouteHandler = {
|
|
|
24
24
|
/** output schemas by content-type (null = no output validation) */
|
|
25
25
|
os: OutputSchemaDef | null;
|
|
26
26
|
/** output validator function — validates response body against schema */
|
|
27
|
-
ov
|
|
28
|
-
/** registered path pattern (e.g. "/users/:id") */
|
|
29
|
-
rp
|
|
27
|
+
ov?: OutputValidator | null;
|
|
28
|
+
/** registered path pattern (e.g. "/users/:id"); intern trees omit this */
|
|
29
|
+
rp?: string;
|
|
30
30
|
};
|
|
31
31
|
export type { OutputSchemaDef };
|
|
32
32
|
export type WSRouteHandler = {
|
|
@@ -76,40 +76,6 @@ export type RouteTree = {
|
|
|
76
76
|
root: TreeNode;
|
|
77
77
|
};
|
|
78
78
|
export declare function createNode(): TreeNode;
|
|
79
|
-
/** Dense array, or unique-value table + per-row indices when that JSON is smaller. */
|
|
80
|
-
export type PackedColumn<T> = readonly T[] | {
|
|
81
|
-
readonly t: readonly T[];
|
|
82
|
-
readonly x: readonly number[];
|
|
83
|
-
};
|
|
84
|
-
/** Columnar packed route table consumed by `assembleRouteTree`. */
|
|
85
|
-
export type PackedRouteTable = {
|
|
86
|
-
/** Boundary error key. A string applies to every route. */
|
|
87
|
-
b?: Array<string | null> | string;
|
|
88
|
-
/** Per-route error-key lists. When `k` is set, each row is the extras beyond `k`. */
|
|
89
|
-
e?: PackedColumn<readonly string[] | null>;
|
|
90
|
-
/** Per-route input schemas. */
|
|
91
|
-
i?: PackedColumn<unknown>;
|
|
92
|
-
/** Error keys shared by every route; prepended onto each `e` row at inflate. */
|
|
93
|
-
k?: readonly string[];
|
|
94
|
-
/** Per-route meta objects. Keys are `u` indices when `u` is set. */
|
|
95
|
-
m?: PackedColumn<Record<string, unknown> | null>;
|
|
96
|
-
/** Per-route output schemas. */
|
|
97
|
-
o?: PackedColumn<unknown>;
|
|
98
|
-
/** Route selectors (`METHOD /path`), same order as the other columns. */
|
|
99
|
-
s: readonly string[];
|
|
100
|
-
/** Meta key dictionary; packed meta objects use decimal index keys. */
|
|
101
|
-
u?: readonly string[];
|
|
102
|
-
};
|
|
103
|
-
export declare function packInputSchemas(iv: unknown): unknown;
|
|
104
|
-
export declare function unpackInputSchemas(iv: unknown): unknown;
|
|
105
|
-
export declare function packOutputSchemas(os: unknown): unknown;
|
|
106
|
-
export declare function unpackOutputSchemas(os: unknown): unknown;
|
|
107
|
-
/**
|
|
108
|
-
* Inflate a packed route table into a live route tree.
|
|
109
|
-
* Each handler and each `ek` Set is a unique object so `.routeTree()` patches
|
|
110
|
-
* cannot cross-wire routes.
|
|
111
|
-
*/
|
|
112
|
-
export declare function assembleRouteTree(table: PackedRouteTable): RouteTree;
|
|
113
79
|
export declare function insertRoute(root: TreeNode, method: HttpMethod | "ALL", path: string, handler: RouteHandler): void;
|
|
114
80
|
export declare function matchRoute(root: TreeNode, method: HttpMethod, path: string): MatchResult;
|
|
115
81
|
export declare function insertWsRoute(root: TreeNode, path: string, handler: WSRouteHandler): void;
|
package/dist/tree.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEnD,YAAY,EAAE,UAAU,EAAE,CAAA;AAE1B,MAAM,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEjF,MAAM,MAAM,YAAY,GAAG;IAC1B,qEAAqE;IACrE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzD,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,4GAA4G;IAC5G,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,
|
|
1
|
+
{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Structural intern for generated route-tree modules.
|
|
3
|
+
*
|
|
4
|
+
* Handler objects stay unique (`.routeTree()` patches `fn`/`mw`/`iv`/`os` onto each
|
|
5
|
+
* `H*`). Values they point at — JSON Schema subtrees, meta objects, selector strings,
|
|
6
|
+
* error-key arrays — are shared by identity when their JSON is identical.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
export type ForcedPrefix = "I" | "M" | "O" | "P"
|
|
10
|
+
|
|
11
|
+
const STRING_MIN = 8
|
|
12
|
+
const NUMBER_MIN = 8
|
|
13
|
+
|
|
14
|
+
function canonical(v: unknown): string {
|
|
15
|
+
if (v === undefined) return "__undefined__"
|
|
16
|
+
return JSON.stringify(v) as string
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
function valueDepth(v: unknown): number {
|
|
20
|
+
if (v === null || typeof v !== "object") return 0
|
|
21
|
+
let max = 0
|
|
22
|
+
if (Array.isArray(v)) {
|
|
23
|
+
for (const x of v) {
|
|
24
|
+
const d = valueDepth(x)
|
|
25
|
+
if (d > max) max = d
|
|
26
|
+
}
|
|
27
|
+
return max + 1
|
|
28
|
+
}
|
|
29
|
+
for (const x of Object.values(v as Record<string, unknown>)) {
|
|
30
|
+
if (x === undefined) continue
|
|
31
|
+
const d = valueDepth(x)
|
|
32
|
+
if (d > max) max = d
|
|
33
|
+
}
|
|
34
|
+
return max + 1
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export class InternPool {
|
|
38
|
+
private readonly counts = new Map<string, number>()
|
|
39
|
+
private readonly firstSeen: string[] = []
|
|
40
|
+
private readonly forced = new Set<string>()
|
|
41
|
+
private readonly forcedPrefix = new Map<string, ForcedPrefix>()
|
|
42
|
+
private readonly ids = new Map<string, string>()
|
|
43
|
+
private readonly prefixCounters = new Map<string, number>()
|
|
44
|
+
private readonly values = new Map<string, unknown>()
|
|
45
|
+
private sealed = false
|
|
46
|
+
|
|
47
|
+
count(v: unknown): void {
|
|
48
|
+
if (v === null || v === undefined) return
|
|
49
|
+
const t = typeof v
|
|
50
|
+
if (t === "boolean") return
|
|
51
|
+
if (t === "number") {
|
|
52
|
+
if (Number.isFinite(v) && String(v).length >= NUMBER_MIN) this.bump(v)
|
|
53
|
+
return
|
|
54
|
+
}
|
|
55
|
+
if (t === "string") {
|
|
56
|
+
if ((v as string).length >= STRING_MIN) this.bump(v)
|
|
57
|
+
return
|
|
58
|
+
}
|
|
59
|
+
if (t === "object") {
|
|
60
|
+
this.bump(v)
|
|
61
|
+
if (Array.isArray(v)) {
|
|
62
|
+
for (const x of v) this.count(x)
|
|
63
|
+
return
|
|
64
|
+
}
|
|
65
|
+
for (const x of Object.values(v as Record<string, unknown>)) {
|
|
66
|
+
if (x !== undefined) this.count(x)
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
force(v: unknown, prefix: ForcedPrefix): void {
|
|
72
|
+
if (v === null || v === undefined) return
|
|
73
|
+
const c = canonical(v)
|
|
74
|
+
if (!this.values.has(c)) {
|
|
75
|
+
this.values.set(c, v)
|
|
76
|
+
this.firstSeen.push(c)
|
|
77
|
+
this.counts.set(c, this.counts.get(c) ?? 1)
|
|
78
|
+
}
|
|
79
|
+
this.forced.add(c)
|
|
80
|
+
if (!this.forcedPrefix.has(c)) this.forcedPrefix.set(c, prefix)
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
seal(): void {
|
|
84
|
+
if (this.sealed) return
|
|
85
|
+
this.sealed = true
|
|
86
|
+
for (const c of this.firstSeen) {
|
|
87
|
+
const v = this.values.get(c)
|
|
88
|
+
if (!this.shouldIntern(v)) continue
|
|
89
|
+
const prefix = this.prefixFor(c, v)
|
|
90
|
+
const n = this.prefixCounters.get(prefix) ?? 0
|
|
91
|
+
this.prefixCounters.set(prefix, n + 1)
|
|
92
|
+
this.ids.set(c, `${prefix}${n}`)
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
id(v: unknown): string | undefined {
|
|
97
|
+
if (v === undefined) return undefined
|
|
98
|
+
return this.ids.get(canonical(v))
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
expr(v: unknown): string {
|
|
102
|
+
if (v === undefined) return "undefined"
|
|
103
|
+
const ref = this.ids.get(canonical(v))
|
|
104
|
+
if (ref !== undefined) return ref
|
|
105
|
+
return this.printExpanded(v)
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
emitConstLines(): string[] {
|
|
109
|
+
const items: Array<{ c: string; depth: number; id: string; seen: number; v: unknown }> = []
|
|
110
|
+
for (const [c, id] of this.ids) {
|
|
111
|
+
const v = this.values.get(c)
|
|
112
|
+
items.push({ c, depth: valueDepth(v), id, seen: this.firstSeen.indexOf(c), v })
|
|
113
|
+
}
|
|
114
|
+
items.sort((a, b) => a.depth - b.depth || a.seen - b.seen || a.id.localeCompare(b.id))
|
|
115
|
+
return items.map((it) => {
|
|
116
|
+
const kind = this.forcedPrefix.get(it.c)
|
|
117
|
+
let rhs = this.printExpanded(it.v)
|
|
118
|
+
if (kind === "I") rhs += ' as unknown as RouteHandler["iv"]'
|
|
119
|
+
else if (kind === "O") rhs += ' as unknown as RouteHandler["os"]'
|
|
120
|
+
return `const ${it.id} = ${rhs}`
|
|
121
|
+
})
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
private shouldIntern(v: unknown): boolean {
|
|
125
|
+
if (v === null || v === undefined) return false
|
|
126
|
+
const c = canonical(v)
|
|
127
|
+
if (this.forced.has(c)) return true
|
|
128
|
+
const n = this.counts.get(c) ?? 0
|
|
129
|
+
if (n < 2) return false
|
|
130
|
+
const t = typeof v
|
|
131
|
+
if (t === "string") return (v as string).length >= STRING_MIN
|
|
132
|
+
if (t === "number") return Number.isFinite(v) && String(v).length >= NUMBER_MIN
|
|
133
|
+
if (Array.isArray(v) && v.length === 0) return false
|
|
134
|
+
return t === "object"
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
private prefixFor(c: string, v: unknown): string {
|
|
138
|
+
const forced = this.forcedPrefix.get(c)
|
|
139
|
+
if (forced !== undefined) return forced
|
|
140
|
+
if (typeof v === "string") return "T"
|
|
141
|
+
if (typeof v === "number") return "U"
|
|
142
|
+
if (Array.isArray(v)) return "A"
|
|
143
|
+
return "J"
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
private bump(v: unknown): void {
|
|
147
|
+
const c = canonical(v)
|
|
148
|
+
const n = (this.counts.get(c) ?? 0) + 1
|
|
149
|
+
this.counts.set(c, n)
|
|
150
|
+
if (n === 1) {
|
|
151
|
+
this.values.set(c, v)
|
|
152
|
+
this.firstSeen.push(c)
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
private printExpanded(v: unknown): string {
|
|
157
|
+
if (v === null) return "null"
|
|
158
|
+
if (v === true) return "true"
|
|
159
|
+
if (v === false) return "false"
|
|
160
|
+
const t = typeof v
|
|
161
|
+
if (t === "string") return JSON.stringify(v)
|
|
162
|
+
if (t === "number") return String(v)
|
|
163
|
+
if (Array.isArray(v)) return `[${v.map((x) => this.expr(x)).join(",")}]`
|
|
164
|
+
if (t === "object") {
|
|
165
|
+
const obj = v as Record<string, unknown>
|
|
166
|
+
const keys = Object.keys(obj).filter((k) => obj[k] !== undefined)
|
|
167
|
+
return `{${keys.map((k) => `${JSON.stringify(k)}:${this.expr(obj[k])}`).join(",")}}`
|
|
168
|
+
}
|
|
169
|
+
return JSON.stringify(v) ?? "undefined"
|
|
170
|
+
}
|
|
171
|
+
}
|