@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.
Files changed (194) hide show
  1. package/README.md +13 -0
  2. package/lib/adapters/h3.d.ts +51 -0
  3. package/lib/adapters/h3.d.ts.map +1 -0
  4. package/lib/adapters/h3.js +1120 -0
  5. package/lib/adapters/h3.js.map +1 -0
  6. package/lib/codegen/cli.d.ts +3 -0
  7. package/lib/codegen/cli.d.ts.map +1 -0
  8. package/lib/codegen/cli.js +82 -0
  9. package/lib/codegen/cli.js.map +1 -0
  10. package/lib/codegen/emitter.d.ts +7 -0
  11. package/lib/codegen/emitter.d.ts.map +1 -0
  12. package/lib/codegen/emitter.js +453 -0
  13. package/lib/codegen/emitter.js.map +1 -0
  14. package/lib/codegen/init.d.ts +3 -0
  15. package/lib/codegen/init.d.ts.map +1 -0
  16. package/lib/codegen/init.js +90 -0
  17. package/lib/codegen/init.js.map +1 -0
  18. package/lib/codegen/scanner.d.ts +56 -0
  19. package/lib/codegen/scanner.d.ts.map +1 -0
  20. package/lib/codegen/scanner.js +484 -0
  21. package/lib/codegen/scanner.js.map +1 -0
  22. package/lib/codegen/validate.d.ts +14 -0
  23. package/lib/codegen/validate.d.ts.map +1 -0
  24. package/lib/codegen/validate.js +166 -0
  25. package/lib/codegen/validate.js.map +1 -0
  26. package/lib/contracts/auth.d.ts +160 -0
  27. package/lib/contracts/auth.d.ts.map +1 -0
  28. package/lib/contracts/auth.js +123 -0
  29. package/lib/contracts/auth.js.map +1 -0
  30. package/lib/contracts/binding.d.ts +169 -0
  31. package/lib/contracts/binding.d.ts.map +1 -0
  32. package/lib/contracts/binding.js +69 -0
  33. package/lib/contracts/binding.js.map +1 -0
  34. package/lib/contracts/common.d.ts +23 -0
  35. package/lib/contracts/common.d.ts.map +1 -0
  36. package/lib/contracts/common.js +18 -0
  37. package/lib/contracts/common.js.map +1 -0
  38. package/lib/contracts/config.d.ts +93 -0
  39. package/lib/contracts/config.d.ts.map +1 -0
  40. package/lib/contracts/config.js +62 -0
  41. package/lib/contracts/config.js.map +1 -0
  42. package/lib/contracts/controlPlane.d.ts +63 -0
  43. package/lib/contracts/controlPlane.d.ts.map +1 -0
  44. package/lib/contracts/controlPlane.js +2 -0
  45. package/lib/contracts/controlPlane.js.map +1 -0
  46. package/lib/contracts/json.d.ts +9 -0
  47. package/lib/contracts/json.d.ts.map +1 -0
  48. package/lib/contracts/json.js +6 -0
  49. package/lib/contracts/json.js.map +1 -0
  50. package/lib/contracts/manifest.d.ts +158 -0
  51. package/lib/contracts/manifest.d.ts.map +1 -0
  52. package/lib/contracts/manifest.js +40 -0
  53. package/lib/contracts/manifest.js.map +1 -0
  54. package/lib/contracts/observability.d.ts +77 -0
  55. package/lib/contracts/observability.d.ts.map +1 -0
  56. package/lib/contracts/observability.js +99 -0
  57. package/lib/contracts/observability.js.map +1 -0
  58. package/lib/contracts/platformConfig.d.ts +635 -0
  59. package/lib/contracts/platformConfig.d.ts.map +1 -0
  60. package/lib/contracts/platformConfig.js +256 -0
  61. package/lib/contracts/platformConfig.js.map +1 -0
  62. package/lib/contracts/registry.d.ts +104 -0
  63. package/lib/contracts/registry.d.ts.map +1 -0
  64. package/lib/contracts/registry.js +2 -0
  65. package/lib/contracts/registry.js.map +1 -0
  66. package/lib/contracts/route.d.ts +199 -0
  67. package/lib/contracts/route.d.ts.map +1 -0
  68. package/lib/contracts/route.js +26 -0
  69. package/lib/contracts/route.js.map +1 -0
  70. package/lib/contracts/serviceConfig.d.ts +88 -0
  71. package/lib/contracts/serviceConfig.d.ts.map +1 -0
  72. package/lib/contracts/serviceConfig.js +45 -0
  73. package/lib/contracts/serviceConfig.js.map +1 -0
  74. package/lib/contracts/streaming.d.ts +76 -0
  75. package/lib/contracts/streaming.d.ts.map +1 -0
  76. package/lib/contracts/streaming.js +31 -0
  77. package/lib/contracts/streaming.js.map +1 -0
  78. package/lib/contracts/view.d.ts +149 -0
  79. package/lib/contracts/view.d.ts.map +1 -0
  80. package/lib/contracts/view.js +82 -0
  81. package/lib/contracts/view.js.map +1 -0
  82. package/lib/controlPlane/store.d.ts +24 -0
  83. package/lib/controlPlane/store.d.ts.map +1 -0
  84. package/lib/controlPlane/store.js +70 -0
  85. package/lib/controlPlane/store.js.map +1 -0
  86. package/lib/controlPlane/sync.d.ts +8 -0
  87. package/lib/controlPlane/sync.d.ts.map +1 -0
  88. package/lib/controlPlane/sync.js +24 -0
  89. package/lib/controlPlane/sync.js.map +1 -0
  90. package/lib/controlPlane/types.d.ts +15 -0
  91. package/lib/controlPlane/types.d.ts.map +1 -0
  92. package/lib/controlPlane/types.js +2 -0
  93. package/lib/controlPlane/types.js.map +1 -0
  94. package/lib/index.d.ts +40 -0
  95. package/lib/index.d.ts.map +1 -0
  96. package/lib/index.js +40 -0
  97. package/lib/index.js.map +1 -0
  98. package/lib/runtime/auth/envelope.d.ts +32 -0
  99. package/lib/runtime/auth/envelope.d.ts.map +1 -0
  100. package/lib/runtime/auth/envelope.js +123 -0
  101. package/lib/runtime/auth/envelope.js.map +1 -0
  102. package/lib/runtime/auth/issuer.d.ts +44 -0
  103. package/lib/runtime/auth/issuer.d.ts.map +1 -0
  104. package/lib/runtime/auth/issuer.js +82 -0
  105. package/lib/runtime/auth/issuer.js.map +1 -0
  106. package/lib/runtime/auth/jwks.d.ts +7 -0
  107. package/lib/runtime/auth/jwks.d.ts.map +1 -0
  108. package/lib/runtime/auth/jwks.js +69 -0
  109. package/lib/runtime/auth/jwks.js.map +1 -0
  110. package/lib/runtime/auth/keypair.d.ts +21 -0
  111. package/lib/runtime/auth/keypair.d.ts.map +1 -0
  112. package/lib/runtime/auth/keypair.js +50 -0
  113. package/lib/runtime/auth/keypair.js.map +1 -0
  114. package/lib/runtime/auth/tokens.d.ts +25 -0
  115. package/lib/runtime/auth/tokens.d.ts.map +1 -0
  116. package/lib/runtime/auth/tokens.js +137 -0
  117. package/lib/runtime/auth/tokens.js.map +1 -0
  118. package/lib/runtime/auth/verifier.d.ts +45 -0
  119. package/lib/runtime/auth/verifier.d.ts.map +1 -0
  120. package/lib/runtime/auth/verifier.js +76 -0
  121. package/lib/runtime/auth/verifier.js.map +1 -0
  122. package/lib/runtime/bpHeaders.d.ts +10 -0
  123. package/lib/runtime/bpHeaders.d.ts.map +1 -0
  124. package/lib/runtime/bpHeaders.js +53 -0
  125. package/lib/runtime/bpHeaders.js.map +1 -0
  126. package/lib/runtime/configProvider.d.ts +41 -0
  127. package/lib/runtime/configProvider.d.ts.map +1 -0
  128. package/lib/runtime/configProvider.js +232 -0
  129. package/lib/runtime/configProvider.js.map +1 -0
  130. package/lib/runtime/configStore.d.ts +34 -0
  131. package/lib/runtime/configStore.d.ts.map +1 -0
  132. package/lib/runtime/configStore.js +197 -0
  133. package/lib/runtime/configStore.js.map +1 -0
  134. package/lib/runtime/configTicket.d.ts +49 -0
  135. package/lib/runtime/configTicket.d.ts.map +1 -0
  136. package/lib/runtime/configTicket.js +168 -0
  137. package/lib/runtime/configTicket.js.map +1 -0
  138. package/lib/runtime/h3.d.ts +28 -0
  139. package/lib/runtime/h3.d.ts.map +1 -0
  140. package/lib/runtime/h3.js +199 -0
  141. package/lib/runtime/h3.js.map +1 -0
  142. package/lib/runtime/handler.d.ts +55 -0
  143. package/lib/runtime/handler.d.ts.map +1 -0
  144. package/lib/runtime/handler.js +51 -0
  145. package/lib/runtime/handler.js.map +1 -0
  146. package/lib/runtime/http.d.ts +13 -0
  147. package/lib/runtime/http.d.ts.map +1 -0
  148. package/lib/runtime/http.js +114 -0
  149. package/lib/runtime/http.js.map +1 -0
  150. package/lib/runtime/jsonSchema.d.ts +4 -0
  151. package/lib/runtime/jsonSchema.d.ts.map +1 -0
  152. package/lib/runtime/jsonSchema.js +28 -0
  153. package/lib/runtime/jsonSchema.js.map +1 -0
  154. package/lib/runtime/manifest.d.ts +3 -0
  155. package/lib/runtime/manifest.d.ts.map +1 -0
  156. package/lib/runtime/manifest.js +5 -0
  157. package/lib/runtime/manifest.js.map +1 -0
  158. package/lib/runtime/media.d.ts +20 -0
  159. package/lib/runtime/media.d.ts.map +1 -0
  160. package/lib/runtime/media.js +70 -0
  161. package/lib/runtime/media.js.map +1 -0
  162. package/lib/runtime/registry.d.ts +67 -0
  163. package/lib/runtime/registry.d.ts.map +1 -0
  164. package/lib/runtime/registry.js +290 -0
  165. package/lib/runtime/registry.js.map +1 -0
  166. package/lib/runtime/serviceConfig.d.ts +38 -0
  167. package/lib/runtime/serviceConfig.d.ts.map +1 -0
  168. package/lib/runtime/serviceConfig.js +152 -0
  169. package/lib/runtime/serviceConfig.js.map +1 -0
  170. package/lib/runtime/statusViews.d.ts +23 -0
  171. package/lib/runtime/statusViews.d.ts.map +1 -0
  172. package/lib/runtime/statusViews.js +48 -0
  173. package/lib/runtime/statusViews.js.map +1 -0
  174. package/lib/runtime/stream.d.ts +41 -0
  175. package/lib/runtime/stream.d.ts.map +1 -0
  176. package/lib/runtime/stream.js +92 -0
  177. package/lib/runtime/stream.js.map +1 -0
  178. package/lib/runtime/streamHandler.d.ts +48 -0
  179. package/lib/runtime/streamHandler.d.ts.map +1 -0
  180. package/lib/runtime/streamHandler.js +49 -0
  181. package/lib/runtime/streamHandler.js.map +1 -0
  182. package/lib/runtime/tenantResolution.d.ts +4 -0
  183. package/lib/runtime/tenantResolution.d.ts.map +1 -0
  184. package/lib/runtime/tenantResolution.js +19 -0
  185. package/lib/runtime/tenantResolution.js.map +1 -0
  186. package/lib/runtime/uuid.d.ts +6 -0
  187. package/lib/runtime/uuid.d.ts.map +1 -0
  188. package/lib/runtime/uuid.js +27 -0
  189. package/lib/runtime/uuid.js.map +1 -0
  190. package/lib/runtime/view.d.ts +48 -0
  191. package/lib/runtime/view.d.ts.map +1 -0
  192. package/lib/runtime/view.js +111 -0
  193. package/lib/runtime/view.js.map +1 -0
  194. 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
+ }