@betterportal/framework 0.0.1

package/README.md

@@ -0,0 +1,13 @@
+# BetterPortal Framework for Node.js
+
+This package is the BetterPortal v10 core library for Node.js.
+
+It provides:
+
+- strict platform contracts
+- observability contracts
+- media type negotiation helpers
+- view and manifest builders
+- tenant/app resolution helpers
+
+The framework package does not implement auth, theme, BSB integration, or business logic directly. Those live in separate packages.

package/lib/adapters/h3.d.ts

@@ -0,0 +1,51 @@
+import type { JsonValue } from "../contracts/json.js";
+import type { PluginManifest } from "../contracts/manifest.js";
+import type { BetterPortalObservability, ObservabilityAttributes } from "../contracts/observability.js";
+import type { BetterPortalRegistry } from "../contracts/registry.js";
+import type { JwtVerifier, RouteHandlerContext } from "../contracts/route.js";
+import type { AppAuthConfig } from "../contracts/auth.js";
+import { type BetterPortalEvent, type BetterPortalH3App } from "../runtime/h3.js";
+import { type BpSchemaOutput } from "../runtime/registry.js";
+export interface H3RouterObservabilityOptions {
+    createRequestObservability?: (name: string, attributes: ObservabilityAttributes) => BetterPortalObservability;
+    /** Identifier of the service hosting this router (used by ctx.serviceId). */
+    serviceId?: string;
+    /** Resolve auth context for a request. Returning undefined disables auth enforcement for the request. */
+    resolveAuth?: (event: BetterPortalEvent) => Promise<H3AuthContext | undefined> | H3AuthContext | undefined;
+    /**
+     * Validate that the resolved (tenantId, appId) is allowed to use this service.
+     * Returning { allowed: false } emits 426 Upgrade Required with optional upgradeUrl.
+     * Called for every request after tenant/app context is resolved.
+     */
+    validateTenantApp?: (tenantId: string, appId: string) => Promise<import("../contracts/auth.js").TenantAppValidation> | import("../contracts/auth.js").TenantAppValidation;
+    /** Extra per-request context supplied by the host service/plugin. */
+    resolveContext?: (event: BetterPortalEvent) => Promise<Partial<RouteHandlerContext>> | Partial<RouteHandlerContext>;
+}
+export interface H3AuthContext {
+    readonly verifier: JwtVerifier;
+    readonly tenantId: string;
+    readonly appId: string;
+    readonly appAuthConfig?: AppAuthConfig;
+    /**
+     * Service-id alias map: tenant service-instance id (UUIDv7) -> pluginId.
+     * Role grants in app.auth reference instance ids; route auth requirements
+     * are authored against pluginIds. The permission check accepts either.
+     */
+    readonly serviceIdAliases?: Readonly<Record<string, string>>;
+}
+/**
+ * Register all routes from a BetterPortalRegistry onto an H3 app.
+ *
+ * For each registered route and method, the adapter:
+ * 1. Parses and validates input (query, headers, body) against route schemas.
+ * 2. Calls the route handler to produce response data.
+ * 3. Content-negotiates the response (JSON, HTML page/fragment/component, or metadata).
+ */
+export declare function createH3Router(registry: BetterPortalRegistry, app: BetterPortalH3App, options?: H3RouterObservabilityOptions): void;
+/**
+ * Register BetterPortal well-known discovery and health endpoints.
+ */
+export declare function registerBpWellKnownRoutes(app: BetterPortalH3App, manifest: PluginManifest, bpSchema: BpSchemaOutput, options?: {
+    health?: () => Response | JsonValue;
+}): void;
+//# sourceMappingURL=h3.d.ts.map

package/lib/adapters/h3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"h3.d.ts","sourceRoot":"","sources":["../../src/adapters/h3.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxG,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,0BAA0B,CAAC;AACtF,OAAO,KAAK,EAGV,WAAW,EAIX,mBAAmB,EAGpB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAqBhC,MAAM,WAAW,4BAA4B;IAC3C,0BAA0B,CAAC,EAAE,CAC3B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,uBAAuB,KAChC,yBAAyB,CAAC;IAC/B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yGAAyG;IACzG,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,GAAG,aAAa,GAAG,SAAS,CAAC;IAC3G;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,sBAAsB,EAAE,mBAAmB,CAAC,GAAG,OAAO,sBAAsB,EAAE,mBAAmB,CAAC;IAC1K,qEAAqE;IACrE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACrH;AAOD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9D;AAwID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,oBAAoB,EAC9B,GAAG,EAAE,iBAAiB,EACtB,OAAO,GAAE,4BAAiC,GACzC,IAAI,CAqIN;AAogCD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,iBAAiB,EACtB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,QAAQ,GAAG,SAAS,CAAC;CAChC,GACL,IAAI,CAeN"}