@betterportal/framework 0.0.1
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 +13 -0
- package/lib/adapters/h3.d.ts +51 -0
- package/lib/adapters/h3.d.ts.map +1 -0
- package/lib/adapters/h3.js +1120 -0
- package/lib/adapters/h3.js.map +1 -0
- package/lib/codegen/cli.d.ts +3 -0
- package/lib/codegen/cli.d.ts.map +1 -0
- package/lib/codegen/cli.js +82 -0
- package/lib/codegen/cli.js.map +1 -0
- package/lib/codegen/emitter.d.ts +7 -0
- package/lib/codegen/emitter.d.ts.map +1 -0
- package/lib/codegen/emitter.js +453 -0
- package/lib/codegen/emitter.js.map +1 -0
- package/lib/codegen/init.d.ts +3 -0
- package/lib/codegen/init.d.ts.map +1 -0
- package/lib/codegen/init.js +90 -0
- package/lib/codegen/init.js.map +1 -0
- package/lib/codegen/scanner.d.ts +56 -0
- package/lib/codegen/scanner.d.ts.map +1 -0
- package/lib/codegen/scanner.js +484 -0
- package/lib/codegen/scanner.js.map +1 -0
- package/lib/codegen/validate.d.ts +14 -0
- package/lib/codegen/validate.d.ts.map +1 -0
- package/lib/codegen/validate.js +166 -0
- package/lib/codegen/validate.js.map +1 -0
- package/lib/contracts/auth.d.ts +160 -0
- package/lib/contracts/auth.d.ts.map +1 -0
- package/lib/contracts/auth.js +123 -0
- package/lib/contracts/auth.js.map +1 -0
- package/lib/contracts/binding.d.ts +169 -0
- package/lib/contracts/binding.d.ts.map +1 -0
- package/lib/contracts/binding.js +69 -0
- package/lib/contracts/binding.js.map +1 -0
- package/lib/contracts/common.d.ts +23 -0
- package/lib/contracts/common.d.ts.map +1 -0
- package/lib/contracts/common.js +18 -0
- package/lib/contracts/common.js.map +1 -0
- package/lib/contracts/config.d.ts +93 -0
- package/lib/contracts/config.d.ts.map +1 -0
- package/lib/contracts/config.js +62 -0
- package/lib/contracts/config.js.map +1 -0
- package/lib/contracts/controlPlane.d.ts +63 -0
- package/lib/contracts/controlPlane.d.ts.map +1 -0
- package/lib/contracts/controlPlane.js +2 -0
- package/lib/contracts/controlPlane.js.map +1 -0
- package/lib/contracts/json.d.ts +9 -0
- package/lib/contracts/json.d.ts.map +1 -0
- package/lib/contracts/json.js +6 -0
- package/lib/contracts/json.js.map +1 -0
- package/lib/contracts/manifest.d.ts +158 -0
- package/lib/contracts/manifest.d.ts.map +1 -0
- package/lib/contracts/manifest.js +40 -0
- package/lib/contracts/manifest.js.map +1 -0
- package/lib/contracts/observability.d.ts +77 -0
- package/lib/contracts/observability.d.ts.map +1 -0
- package/lib/contracts/observability.js +99 -0
- package/lib/contracts/observability.js.map +1 -0
- package/lib/contracts/platformConfig.d.ts +635 -0
- package/lib/contracts/platformConfig.d.ts.map +1 -0
- package/lib/contracts/platformConfig.js +256 -0
- package/lib/contracts/platformConfig.js.map +1 -0
- package/lib/contracts/registry.d.ts +104 -0
- package/lib/contracts/registry.d.ts.map +1 -0
- package/lib/contracts/registry.js +2 -0
- package/lib/contracts/registry.js.map +1 -0
- package/lib/contracts/route.d.ts +199 -0
- package/lib/contracts/route.d.ts.map +1 -0
- package/lib/contracts/route.js +26 -0
- package/lib/contracts/route.js.map +1 -0
- package/lib/contracts/serviceConfig.d.ts +88 -0
- package/lib/contracts/serviceConfig.d.ts.map +1 -0
- package/lib/contracts/serviceConfig.js +45 -0
- package/lib/contracts/serviceConfig.js.map +1 -0
- package/lib/contracts/streaming.d.ts +76 -0
- package/lib/contracts/streaming.d.ts.map +1 -0
- package/lib/contracts/streaming.js +31 -0
- package/lib/contracts/streaming.js.map +1 -0
- package/lib/contracts/view.d.ts +149 -0
- package/lib/contracts/view.d.ts.map +1 -0
- package/lib/contracts/view.js +82 -0
- package/lib/contracts/view.js.map +1 -0
- package/lib/controlPlane/store.d.ts +24 -0
- package/lib/controlPlane/store.d.ts.map +1 -0
- package/lib/controlPlane/store.js +70 -0
- package/lib/controlPlane/store.js.map +1 -0
- package/lib/controlPlane/sync.d.ts +8 -0
- package/lib/controlPlane/sync.d.ts.map +1 -0
- package/lib/controlPlane/sync.js +24 -0
- package/lib/controlPlane/sync.js.map +1 -0
- package/lib/controlPlane/types.d.ts +15 -0
- package/lib/controlPlane/types.d.ts.map +1 -0
- package/lib/controlPlane/types.js +2 -0
- package/lib/controlPlane/types.js.map +1 -0
- package/lib/index.d.ts +40 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +40 -0
- package/lib/index.js.map +1 -0
- package/lib/runtime/auth/envelope.d.ts +32 -0
- package/lib/runtime/auth/envelope.d.ts.map +1 -0
- package/lib/runtime/auth/envelope.js +123 -0
- package/lib/runtime/auth/envelope.js.map +1 -0
- package/lib/runtime/auth/issuer.d.ts +44 -0
- package/lib/runtime/auth/issuer.d.ts.map +1 -0
- package/lib/runtime/auth/issuer.js +82 -0
- package/lib/runtime/auth/issuer.js.map +1 -0
- package/lib/runtime/auth/jwks.d.ts +7 -0
- package/lib/runtime/auth/jwks.d.ts.map +1 -0
- package/lib/runtime/auth/jwks.js +69 -0
- package/lib/runtime/auth/jwks.js.map +1 -0
- package/lib/runtime/auth/keypair.d.ts +21 -0
- package/lib/runtime/auth/keypair.d.ts.map +1 -0
- package/lib/runtime/auth/keypair.js +50 -0
- package/lib/runtime/auth/keypair.js.map +1 -0
- package/lib/runtime/auth/tokens.d.ts +25 -0
- package/lib/runtime/auth/tokens.d.ts.map +1 -0
- package/lib/runtime/auth/tokens.js +137 -0
- package/lib/runtime/auth/tokens.js.map +1 -0
- package/lib/runtime/auth/verifier.d.ts +45 -0
- package/lib/runtime/auth/verifier.d.ts.map +1 -0
- package/lib/runtime/auth/verifier.js +76 -0
- package/lib/runtime/auth/verifier.js.map +1 -0
- package/lib/runtime/bpHeaders.d.ts +10 -0
- package/lib/runtime/bpHeaders.d.ts.map +1 -0
- package/lib/runtime/bpHeaders.js +53 -0
- package/lib/runtime/bpHeaders.js.map +1 -0
- package/lib/runtime/configProvider.d.ts +41 -0
- package/lib/runtime/configProvider.d.ts.map +1 -0
- package/lib/runtime/configProvider.js +232 -0
- package/lib/runtime/configProvider.js.map +1 -0
- package/lib/runtime/configStore.d.ts +34 -0
- package/lib/runtime/configStore.d.ts.map +1 -0
- package/lib/runtime/configStore.js +197 -0
- package/lib/runtime/configStore.js.map +1 -0
- package/lib/runtime/configTicket.d.ts +49 -0
- package/lib/runtime/configTicket.d.ts.map +1 -0
- package/lib/runtime/configTicket.js +168 -0
- package/lib/runtime/configTicket.js.map +1 -0
- package/lib/runtime/h3.d.ts +28 -0
- package/lib/runtime/h3.d.ts.map +1 -0
- package/lib/runtime/h3.js +199 -0
- package/lib/runtime/h3.js.map +1 -0
- package/lib/runtime/handler.d.ts +55 -0
- package/lib/runtime/handler.d.ts.map +1 -0
- package/lib/runtime/handler.js +51 -0
- package/lib/runtime/handler.js.map +1 -0
- package/lib/runtime/http.d.ts +13 -0
- package/lib/runtime/http.d.ts.map +1 -0
- package/lib/runtime/http.js +114 -0
- package/lib/runtime/http.js.map +1 -0
- package/lib/runtime/jsonSchema.d.ts +4 -0
- package/lib/runtime/jsonSchema.d.ts.map +1 -0
- package/lib/runtime/jsonSchema.js +28 -0
- package/lib/runtime/jsonSchema.js.map +1 -0
- package/lib/runtime/manifest.d.ts +3 -0
- package/lib/runtime/manifest.d.ts.map +1 -0
- package/lib/runtime/manifest.js +5 -0
- package/lib/runtime/manifest.js.map +1 -0
- package/lib/runtime/media.d.ts +20 -0
- package/lib/runtime/media.d.ts.map +1 -0
- package/lib/runtime/media.js +70 -0
- package/lib/runtime/media.js.map +1 -0
- package/lib/runtime/registry.d.ts +67 -0
- package/lib/runtime/registry.d.ts.map +1 -0
- package/lib/runtime/registry.js +290 -0
- package/lib/runtime/registry.js.map +1 -0
- package/lib/runtime/serviceConfig.d.ts +38 -0
- package/lib/runtime/serviceConfig.d.ts.map +1 -0
- package/lib/runtime/serviceConfig.js +152 -0
- package/lib/runtime/serviceConfig.js.map +1 -0
- package/lib/runtime/statusViews.d.ts +23 -0
- package/lib/runtime/statusViews.d.ts.map +1 -0
- package/lib/runtime/statusViews.js +48 -0
- package/lib/runtime/statusViews.js.map +1 -0
- package/lib/runtime/stream.d.ts +41 -0
- package/lib/runtime/stream.d.ts.map +1 -0
- package/lib/runtime/stream.js +92 -0
- package/lib/runtime/stream.js.map +1 -0
- package/lib/runtime/streamHandler.d.ts +48 -0
- package/lib/runtime/streamHandler.d.ts.map +1 -0
- package/lib/runtime/streamHandler.js +49 -0
- package/lib/runtime/streamHandler.js.map +1 -0
- package/lib/runtime/tenantResolution.d.ts +4 -0
- package/lib/runtime/tenantResolution.d.ts.map +1 -0
- package/lib/runtime/tenantResolution.js +19 -0
- package/lib/runtime/tenantResolution.js.map +1 -0
- package/lib/runtime/uuid.d.ts +6 -0
- package/lib/runtime/uuid.d.ts.map +1 -0
- package/lib/runtime/uuid.js +27 -0
- package/lib/runtime/uuid.js.map +1 -0
- package/lib/runtime/view.d.ts +48 -0
- package/lib/runtime/view.d.ts.map +1 -0
- package/lib/runtime/view.js +111 -0
- package/lib/runtime/view.js.map +1 -0
- package/package.json +56 -0
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { randomBytes } from "node:crypto";
|
|
2
|
+
/**
|
|
3
|
+
* Generate a UUIDv7 (RFC 9562) - timestamp-sortable, globally unique.
|
|
4
|
+
* Layout: 48-bit unix_ts_ms | 4-bit version(7) | 12-bit rand_a | 2-bit variant(10) | 62-bit rand_b
|
|
5
|
+
*/
|
|
6
|
+
export function uuidv7() {
|
|
7
|
+
const now = Date.now();
|
|
8
|
+
const rand = randomBytes(16);
|
|
9
|
+
// 48-bit timestamp
|
|
10
|
+
const tsHigh = Math.floor(now / 0x10000) & 0xffff_ffff;
|
|
11
|
+
const tsLow = now & 0xffff;
|
|
12
|
+
// Byte 0-3: upper 32 bits of timestamp
|
|
13
|
+
rand[0] = (tsHigh >>> 24) & 0xff;
|
|
14
|
+
rand[1] = (tsHigh >>> 16) & 0xff;
|
|
15
|
+
rand[2] = (tsHigh >>> 8) & 0xff;
|
|
16
|
+
rand[3] = tsHigh & 0xff;
|
|
17
|
+
// Byte 4-5: lower 16 bits of timestamp
|
|
18
|
+
rand[4] = (tsLow >>> 8) & 0xff;
|
|
19
|
+
rand[5] = tsLow & 0xff;
|
|
20
|
+
// Byte 6: version 7 (0111xxxx)
|
|
21
|
+
rand[6] = (rand[6] & 0x0f) | 0x70;
|
|
22
|
+
// Byte 8: variant 10 (10xxxxxx)
|
|
23
|
+
rand[8] = (rand[8] & 0x3f) | 0x80;
|
|
24
|
+
const hex = Array.from(rand).map((b) => b.toString(16).padStart(2, "0")).join("");
|
|
25
|
+
return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
|
|
26
|
+
}
|
|
27
|
+
//# sourceMappingURL=uuid.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/runtime/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,MAAM;IACpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAE7B,mBAAmB;IACnB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,WAAW,CAAC;IACvD,MAAM,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC;IAE3B,uCAAuC;IACvC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAExB,uCAAuC;IACvC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;IAEvB,+BAA+B;IAC/B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAElC,gCAAgC;IAChC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAElC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClF,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7G,CAAC"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import * as av from "anyvali";
|
|
2
|
+
import type { Infer } from "anyvali";
|
|
3
|
+
import { RenderMode } from "../contracts/common.js";
|
|
4
|
+
import { JsonValue } from "../contracts/json.js";
|
|
5
|
+
import { CacheHints, HtmlRepresentationSupport, ViewMetadata } from "../contracts/view.js";
|
|
6
|
+
import type { ApiAuthRequirement } from "../contracts/route.js";
|
|
7
|
+
import { RequestedRepresentation } from "./media.js";
|
|
8
|
+
type AnySchema = av.BaseSchema<unknown, unknown>;
|
|
9
|
+
export interface HtmlRenderableLike {
|
|
10
|
+
toString(): string;
|
|
11
|
+
}
|
|
12
|
+
export type HtmlRenderable = string | HtmlRenderableLike;
|
|
13
|
+
export interface ViewSchemas<ParamsSchema extends AnySchema, QuerySchema extends AnySchema, HeadersSchema extends AnySchema, BodySchema extends AnySchema, ResponseSchema extends AnySchema> {
|
|
14
|
+
params: ParamsSchema;
|
|
15
|
+
query: QuerySchema;
|
|
16
|
+
headers: HeadersSchema;
|
|
17
|
+
body: BodySchema;
|
|
18
|
+
response: ResponseSchema;
|
|
19
|
+
}
|
|
20
|
+
export interface CreateViewDefinitionInput<ParamsSchema extends AnySchema, QuerySchema extends AnySchema, HeadersSchema extends AnySchema, BodySchema extends AnySchema, ResponseSchema extends AnySchema> {
|
|
21
|
+
viewId: string;
|
|
22
|
+
title: string;
|
|
23
|
+
description: string;
|
|
24
|
+
path: string;
|
|
25
|
+
methods: ReadonlyArray<"GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS">;
|
|
26
|
+
schemas: ViewSchemas<ParamsSchema, QuerySchema, HeadersSchema, BodySchema, ResponseSchema>;
|
|
27
|
+
html: HtmlRepresentationSupport;
|
|
28
|
+
auth: ApiAuthRequirement;
|
|
29
|
+
demoScenarios?: ReadonlyArray<{
|
|
30
|
+
id: string;
|
|
31
|
+
title: string;
|
|
32
|
+
response: Infer<ResponseSchema>;
|
|
33
|
+
}>;
|
|
34
|
+
cacheHints: CacheHints;
|
|
35
|
+
}
|
|
36
|
+
export interface BetterPortalViewDefinition<ParamsSchema extends AnySchema, QuerySchema extends AnySchema, HeadersSchema extends AnySchema, BodySchema extends AnySchema, ResponseSchema extends AnySchema> extends CreateViewDefinitionInput<ParamsSchema, QuerySchema, HeadersSchema, BodySchema, ResponseSchema> {
|
|
37
|
+
toMetadata(): ViewMetadata;
|
|
38
|
+
}
|
|
39
|
+
export interface NegotiatedViewResponse {
|
|
40
|
+
status: number;
|
|
41
|
+
contentType: string;
|
|
42
|
+
body: JsonValue | HtmlRenderable;
|
|
43
|
+
}
|
|
44
|
+
export declare function createViewDefinition<ParamsSchema extends AnySchema, QuerySchema extends AnySchema, HeadersSchema extends AnySchema, BodySchema extends AnySchema, ResponseSchema extends AnySchema>(input: CreateViewDefinitionInput<ParamsSchema, QuerySchema, HeadersSchema, BodySchema, ResponseSchema>): BetterPortalViewDefinition<ParamsSchema, QuerySchema, HeadersSchema, BodySchema, ResponseSchema>;
|
|
45
|
+
export declare function negotiateViewResponse<ResponseSchema extends AnySchema>(view: BetterPortalViewDefinition<AnySchema, AnySchema, AnySchema, AnySchema, ResponseSchema>, acceptHeader: string | undefined, jsonBody: Infer<ResponseSchema>, renderHtml: ((theme: string, mode: RenderMode, body: Infer<ResponseSchema>) => HtmlRenderable) | undefined): NegotiatedViewResponse;
|
|
46
|
+
export declare function resolveRepresentationFromAccept(acceptHeader?: string): RequestedRepresentation;
|
|
47
|
+
export {};
|
|
48
|
+
//# sourceMappingURL=view.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/runtime/view.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
import { ViewMetadataSchema } from "../contracts/view.js";
|
|
2
|
+
import { resolveRequestedRepresentation } from "./media.js";
|
|
3
|
+
import { toJsonSchemaDocument } from "./jsonSchema.js";
|
|
4
|
+
export function createViewDefinition(input) {
|
|
5
|
+
const metadata = ViewMetadataSchema.parse({
|
|
6
|
+
viewId: input.viewId,
|
|
7
|
+
title: input.title,
|
|
8
|
+
description: input.description,
|
|
9
|
+
path: input.path,
|
|
10
|
+
methods: [...input.methods],
|
|
11
|
+
paramsSchema: toJsonSchemaDocument(input.schemas.params),
|
|
12
|
+
querySchema: toJsonSchemaDocument(input.schemas.query),
|
|
13
|
+
headersSchema: toJsonSchemaDocument(input.schemas.headers),
|
|
14
|
+
bodySchema: toJsonSchemaDocument(input.schemas.body),
|
|
15
|
+
jsonResponseSchema: toJsonSchemaDocument(input.schemas.response),
|
|
16
|
+
metadataResponseSchema: toJsonSchemaDocument(ViewMetadataSchema),
|
|
17
|
+
html: input.html,
|
|
18
|
+
auth: input.auth,
|
|
19
|
+
demoScenarios: (input.demoScenarios ?? []).map((scenario) => ({
|
|
20
|
+
...scenario,
|
|
21
|
+
response: input.schemas.response.parse(scenario.response)
|
|
22
|
+
})),
|
|
23
|
+
cacheHints: input.cacheHints
|
|
24
|
+
});
|
|
25
|
+
return {
|
|
26
|
+
...input,
|
|
27
|
+
toMetadata() {
|
|
28
|
+
return metadata;
|
|
29
|
+
}
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
function resolveTheme(html, requestedTheme) {
|
|
33
|
+
if (!requestedTheme)
|
|
34
|
+
return null;
|
|
35
|
+
return requestedTheme in html.themeRenderers ? requestedTheme : null;
|
|
36
|
+
}
|
|
37
|
+
function resolveMode(html, theme, requestedMode) {
|
|
38
|
+
const renderer = html.themeRenderers[theme];
|
|
39
|
+
if (!renderer)
|
|
40
|
+
return null;
|
|
41
|
+
if (!requestedMode)
|
|
42
|
+
return renderer.renderModes[0] ?? null;
|
|
43
|
+
return renderer.renderModes.includes(requestedMode) ? requestedMode : null;
|
|
44
|
+
}
|
|
45
|
+
export function negotiateViewResponse(view, acceptHeader, jsonBody, renderHtml) {
|
|
46
|
+
const requested = resolveRequestedRepresentation(acceptHeader);
|
|
47
|
+
const validatedJsonBody = view.schemas.response.parse(jsonBody);
|
|
48
|
+
if (requested.kind === "metadata") {
|
|
49
|
+
return {
|
|
50
|
+
status: 200,
|
|
51
|
+
contentType: "application/vnd.betterportal.metadata+json",
|
|
52
|
+
body: view.toMetadata()
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
if (requested.kind === "json") {
|
|
56
|
+
return {
|
|
57
|
+
status: 200,
|
|
58
|
+
contentType: "application/json",
|
|
59
|
+
body: validatedJsonBody
|
|
60
|
+
};
|
|
61
|
+
}
|
|
62
|
+
// NDJSON streaming is only supported by streaming routes (spec/streaming.md),
|
|
63
|
+
// which negotiate in the adapter - never through this buffered path.
|
|
64
|
+
if (requested.kind === "ndjson") {
|
|
65
|
+
return {
|
|
66
|
+
status: 406,
|
|
67
|
+
contentType: "application/json",
|
|
68
|
+
body: {
|
|
69
|
+
error: "NDJSON streaming is not supported by this view"
|
|
70
|
+
}
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
if (!renderHtml) {
|
|
74
|
+
return {
|
|
75
|
+
status: 406,
|
|
76
|
+
contentType: "application/json",
|
|
77
|
+
body: {
|
|
78
|
+
error: "HTML rendering is not available for this view"
|
|
79
|
+
}
|
|
80
|
+
};
|
|
81
|
+
}
|
|
82
|
+
const theme = resolveTheme(view.html, requested.theme);
|
|
83
|
+
if (!theme) {
|
|
84
|
+
return {
|
|
85
|
+
status: 406,
|
|
86
|
+
contentType: "application/json",
|
|
87
|
+
body: {
|
|
88
|
+
error: "Requested HTML representation is not supported"
|
|
89
|
+
}
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
const mode = resolveMode(view.html, theme, requested.mode);
|
|
93
|
+
if (!mode) {
|
|
94
|
+
return {
|
|
95
|
+
status: 406,
|
|
96
|
+
contentType: "application/json",
|
|
97
|
+
body: {
|
|
98
|
+
error: "Requested HTML representation is not supported"
|
|
99
|
+
}
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
return {
|
|
103
|
+
status: 200,
|
|
104
|
+
contentType: `text/html; theme=${theme}; mode=${mode}`,
|
|
105
|
+
body: renderHtml(theme, mode, jsonBody)
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
export function resolveRepresentationFromAccept(acceptHeader) {
|
|
109
|
+
return resolveRequestedRepresentation(acceptHeader);
|
|
110
|
+
}
|
|
111
|
+
//# sourceMappingURL=view.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/runtime/view.ts"],"names":[],"mappings":"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"}
|
package/package.json
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@betterportal/framework",
|
|
3
|
+
"version": "0.0.1",
|
|
4
|
+
"description": "BetterPortal v10 core library for Node.js",
|
|
5
|
+
"main": "lib/index.js",
|
|
6
|
+
"types": "lib/index.d.ts",
|
|
7
|
+
"bin": {
|
|
8
|
+
"bp-codegen": "lib/codegen/cli.js",
|
|
9
|
+
"bp-init": "lib/codegen/init.js"
|
|
10
|
+
},
|
|
11
|
+
"scripts": {
|
|
12
|
+
"build": "tsc -p tsconfig.json",
|
|
13
|
+
"clean": "cmd /c if exist lib rmdir /s /q lib",
|
|
14
|
+
"test": "tsx --test tests/*.test.ts",
|
|
15
|
+
"prepublishOnly": "npm run build",
|
|
16
|
+
"prepare": "npm run build"
|
|
17
|
+
},
|
|
18
|
+
"keywords": [
|
|
19
|
+
"betterportal",
|
|
20
|
+
"framework",
|
|
21
|
+
"htmx",
|
|
22
|
+
"h3",
|
|
23
|
+
"codegen"
|
|
24
|
+
],
|
|
25
|
+
"author": "BetterCorp",
|
|
26
|
+
"license": "(AGPL-3.0-only OR Commercial)",
|
|
27
|
+
"type": "module",
|
|
28
|
+
"devDependencies": {
|
|
29
|
+
"@types/jsonwebtoken": "^9.0.7",
|
|
30
|
+
"tsx": "^4.21.0"
|
|
31
|
+
},
|
|
32
|
+
"files": [
|
|
33
|
+
"lib/**/*",
|
|
34
|
+
"README.md"
|
|
35
|
+
],
|
|
36
|
+
"dependencies": {
|
|
37
|
+
"anyvali": "^1.0.6",
|
|
38
|
+
"h3": "^2.0.1-rc.20",
|
|
39
|
+
"jsonwebtoken": "^9.0.2",
|
|
40
|
+
"jwks-rsa": "^3.1.0",
|
|
41
|
+
"typescript": "^5.9.3",
|
|
42
|
+
"yaml": "^2.8.3"
|
|
43
|
+
},
|
|
44
|
+
"homepage": "https://github.com/BetterCorp/BetterPortal#readme",
|
|
45
|
+
"repository": {
|
|
46
|
+
"type": "git",
|
|
47
|
+
"url": "git+https://github.com/BetterCorp/BetterPortal.git",
|
|
48
|
+
"directory": "framework/nodejs"
|
|
49
|
+
},
|
|
50
|
+
"bugs": {
|
|
51
|
+
"url": "https://github.com/BetterCorp/BetterPortal/issues"
|
|
52
|
+
},
|
|
53
|
+
"publishConfig": {
|
|
54
|
+
"access": "public"
|
|
55
|
+
}
|
|
56
|
+
}
|