@betterportal/framework 0.0.1

package/lib/contracts/platformConfig.js

@@ -0,0 +1,256 @@
+import * as av from "anyvali";
+import { DeploymentModeSchema, HttpMethodSchema, PluginIdSchema, UuidV7Schema } from "./common.js";
+import { AppAuthConfigSchema } from "./auth.js";
+const NonEmptyStringSchema = av.string().minLength(1);
+export const BetterPortalBrandingSchema = av.object({
+    brandName: av.optional(NonEmptyStringSchema),
+    logoUrl: av.optional(av.string().format("url")),
+    primaryColor: av.optional(NonEmptyStringSchema),
+    secondaryColor: av.optional(NonEmptyStringSchema)
+}, { unknownKeys: "strip" }).default({});
+export const BetterPortalThemeBootstrapPaletteSchema = av.object({
+    primary: av.optional(NonEmptyStringSchema),
+    secondary: av.optional(NonEmptyStringSchema),
+    success: av.optional(NonEmptyStringSchema),
+    info: av.optional(NonEmptyStringSchema),
+    warning: av.optional(NonEmptyStringSchema),
+    danger: av.optional(NonEmptyStringSchema),
+    light: av.optional(NonEmptyStringSchema),
+    dark: av.optional(NonEmptyStringSchema)
+}, { unknownKeys: "strip" }).default({});
+export const BetterPortalThemeSurfaceSchema = av.object({
+    background: av.optional(NonEmptyStringSchema),
+    surface: av.optional(NonEmptyStringSchema),
+    surfaceAlt: av.optional(NonEmptyStringSchema),
+    text: av.optional(NonEmptyStringSchema),
+    textSoft: av.optional(NonEmptyStringSchema),
+    border: av.optional(NonEmptyStringSchema),
+    accentSoft: av.optional(NonEmptyStringSchema)
+}, { unknownKeys: "strip" }).default({});
+export const BetterPortalThemeConfigSchema = av.object({
+    brandName: av.optional(NonEmptyStringSchema),
+    mode: av.enum_(["light", "dark", "system"]).default("light"),
+    bootstrap: BetterPortalThemeBootstrapPaletteSchema,
+    light: BetterPortalThemeSurfaceSchema,
+    dark: BetterPortalThemeSurfaceSchema
+}, { unknownKeys: "strip" }).default({
+    mode: "light",
+    bootstrap: {},
+    light: {},
+    dark: {}
+});
+// -- Service registration (per-tenant owned) -------------------------
+export const TenantServiceRegistrationSchema = av.object({
+    id: UuidV7Schema,
+    hostname: av.string().format("url"),
+    apiKeyHash: av.string().default(""),
+    publicKeyPem: av.optional(NonEmptyStringSchema),
+    keyId: av.optional(NonEmptyStringSchema),
+    serviceId: av.optional(PluginIdSchema),
+    capabilities: av.array(NonEmptyStringSchema).default([]),
+    title: av.optional(NonEmptyStringSchema),
+    description: av.optional(NonEmptyStringSchema),
+    deploymentMode: DeploymentModeSchema.default("self-hosted"),
+    createdAt: av.string().format("date-time"),
+    lastSeenAt: av.optional(av.string().format("date-time")),
+    enabled: av.bool().default(true)
+}, { unknownKeys: "strip" });
+export const BetterPortalAppShellSchema = av.object({
+    serviceId: UuidV7Schema
+}, { unknownKeys: "strip" });
+// -- Platform service (BP-hosted marketplace) -------------------------
+export const PlatformServiceSchema = av.object({
+    id: UuidV7Schema,
+    hostname: av.string().format("url"),
+    apiKeyHash: av.string().default(""),
+    publicKeyPem: av.optional(NonEmptyStringSchema),
+    keyId: av.optional(NonEmptyStringSchema),
+    serviceId: av.optional(PluginIdSchema),
+    capabilities: av.array(NonEmptyStringSchema).default([]),
+    title: NonEmptyStringSchema,
+    description: av.optional(NonEmptyStringSchema),
+    category: av.optional(NonEmptyStringSchema),
+    createdAt: av.string().format("date-time"),
+    enabled: av.bool().default(true)
+}, { unknownKeys: "strip" });
+// -- Tenant -----------------------------------------------------------
+export const BetterPortalTenantSchema = av.object({
+    id: UuidV7Schema,
+    slug: NonEmptyStringSchema,
+    title: NonEmptyStringSchema,
+    active: av.bool().default(true),
+    branding: BetterPortalBrandingSchema,
+    services: av.array(TenantServiceRegistrationSchema).default([]),
+    activatedPlatformServices: av.array(UuidV7Schema).default([])
+}, { unknownKeys: "strip" });
+export const BetterPortalRouteChromeValueSchema = av.union([av.string(), av.number(), av.bool()]);
+export const BetterPortalRouteChromeSchema = av.intersection([
+    av.object({
+        hideMenu: av.optional(av.bool()),
+        hideHeader: av.optional(av.bool()),
+        hideFooter: av.optional(av.bool()),
+        fullScreen: av.optional(av.bool())
+    }, { unknownKeys: "allow" }),
+    av.record(BetterPortalRouteChromeValueSchema)
+]);
+export const BetterPortalRouteMountSchema = av.object({
+    id: UuidV7Schema,
+    path: NonEmptyStringSchema,
+    serviceId: UuidV7Schema,
+    viewId: NonEmptyStringSchema,
+    /** @deprecated Use resolvedServicePath (CP-injected). Kept one release for migration. */
+    targetPath: av.optional(NonEmptyStringSchema),
+    /** Service path resolved by control plane from manifest cache. Injected on sync delivery. */
+    resolvedServicePath: av.optional(NonEmptyStringSchema),
+    /** Optional query string appended to service request. */
+    query: av.optional(av.string()),
+    title: av.optional(NonEmptyStringSchema),
+    icon: av.optional(NonEmptyStringSchema),
+    enabled: av.bool().default(true),
+    methods: av.array(HttpMethodSchema).minItems(1).default(["GET"]),
+    chrome: av.optional(BetterPortalRouteChromeSchema)
+}, { unknownKeys: "strip" });
+// -- Menu (separate from routes) --------------------------------------
+export const BetterPortalMenuItemSchema = av.object({
+    id: UuidV7Schema,
+    type: av.enum_(["link", "group", "section", "divider", "external"]).default("link"),
+    title: av.optional(NonEmptyStringSchema),
+    icon: av.optional(NonEmptyStringSchema),
+    routeId: av.optional(UuidV7Schema),
+    href: av.optional(av.string()),
+    enabled: av.bool().default(true),
+    defaultExpanded: av.optional(av.bool()),
+    children: av.array(av.any()).default([])
+}, { unknownKeys: "strip" });
+export const BetterPortalSlotAssignmentSchema = av.object({
+    slotId: NonEmptyStringSchema,
+    serviceId: UuidV7Schema,
+    viewId: NonEmptyStringSchema,
+    renderer: av.optional(NonEmptyStringSchema),
+    enabled: av.bool().default(true)
+}, { unknownKeys: "strip" });
+export const BetterPortalFragmentAssignmentSchema = av.object({
+    serviceId: UuidV7Schema,
+    fragmentId: NonEmptyStringSchema,
+    targetPath: NonEmptyStringSchema,
+    enabled: av.bool().default(true)
+}, { unknownKeys: "strip" });
+export const BetterPortalAppSchema = av.object({
+    id: UuidV7Schema,
+    tenantId: UuidV7Schema,
+    slug: NonEmptyStringSchema,
+    title: NonEmptyStringSchema,
+    hostnames: av.array(NonEmptyStringSchema).minItems(1),
+    originOverrides: av.array(av.string().format("url")).default([]),
+    refererOverrides: av.array(av.string().format("url")).default([]),
+    shell: av.optional(BetterPortalAppShellSchema),
+    themeId: av.optional(NonEmptyStringSchema),
+    themeConfig: BetterPortalThemeConfigSchema,
+    layoutId: av.optional(NonEmptyStringSchema),
+    defaultRoute: NonEmptyStringSchema.default("/"),
+    routes: av.array(BetterPortalRouteMountSchema).default([]),
+    menu: av.array(BetterPortalMenuItemSchema).default([]),
+    slots: av.array(BetterPortalSlotAssignmentSchema).default([]),
+    fragments: av.record(av.array(BetterPortalFragmentAssignmentSchema)).default({}),
+    auth: av.optional(AppAuthConfigSchema),
+    statusViewIds: av.optional(av.record(NonEmptyStringSchema))
+}, { unknownKeys: "strip" });
+export const BetterPortalConfigManagementAuthSchema = av.object({
+    mechanism: av.enum_(["none", "dev-token", "jwt", "oidc"]).default("none"),
+    issuer: av.optional(NonEmptyStringSchema),
+    audience: av.optional(NonEmptyStringSchema),
+    requiredPermissions: av.array(NonEmptyStringSchema).default([])
+}, { unknownKeys: "strip" }).default({
+    mechanism: "none",
+    requiredPermissions: []
+});
+export const BetterPortalConfigManagementSchema = av.object({
+    adminTenantId: av.optional(NonEmptyStringSchema),
+    managementAppId: av.optional(NonEmptyStringSchema),
+    auth: BetterPortalConfigManagementAuthSchema
+}, { unknownKeys: "strip" }).default({
+    auth: {
+        mechanism: "none",
+        requiredPermissions: []
+    }
+});
+// -- Shared service catalog (BP-curated + 3rd-party marketplace) -----
+export const SharedServiceDefinitionSchema = av.object({
+    id: NonEmptyStringSchema,
+    serviceId: av.optional(PluginIdSchema),
+    title: NonEmptyStringSchema,
+    description: av.optional(av.string()),
+    logoUrl: av.optional(av.string().format("url")),
+    baseUrl: av.string().format("url"),
+    apiKeyHash: av.string().default(""),
+    publicKeyPem: av.optional(NonEmptyStringSchema),
+    keyId: av.optional(NonEmptyStringSchema),
+    supportedDeploymentModes: av.array(DeploymentModeSchema).default([]),
+    owner: av.enum_(["bp", "3p"]).default("bp"),
+    upgradeUrlTemplate: av.optional(av.string()),
+    category: av.optional(NonEmptyStringSchema),
+    tags: av.array(NonEmptyStringSchema).default([]),
+    pricingHint: av.optional(av.enum_(["free", "freemium", "paid"])),
+    publishedAt: av.optional(av.string().format("date-time")),
+    enabled: av.bool().default(true)
+}, { unknownKeys: "strip" });
+export const TenantSharedServiceActivationSchema = av.object({
+    id: UuidV7Schema,
+    tenantId: NonEmptyStringSchema,
+    appId: av.optional(NonEmptyStringSchema),
+    sharedServiceId: NonEmptyStringSchema,
+    activatedAt: av.string().format("date-time"),
+    enabled: av.bool().default(true)
+}, { unknownKeys: "strip" });
+// -- Manifest cache (CP-side per spec section P8) --------------------
+export const ServiceManifestCacheEntrySchema = av.object({
+    serviceId: NonEmptyStringSchema,
+    manifestVersion: NonEmptyStringSchema,
+    fetchedAt: av.string().format("date-time"),
+    viewIndex: av.record(av.object({
+        viewId: NonEmptyStringSchema,
+        path: NonEmptyStringSchema,
+        methods: av.array(NonEmptyStringSchema).default([]),
+        role: av.optional(NonEmptyStringSchema),
+        chrome: av.optional(BetterPortalRouteChromeSchema),
+        dependencies: av.array(NonEmptyStringSchema).default([]),
+        permissions: av.array(av.object({
+            serviceId: NonEmptyStringSchema,
+            viewId: NonEmptyStringSchema,
+            permissions: av.array(NonEmptyStringSchema).default([])
+        }, { unknownKeys: "strip" })).default([]),
+        renderable: av.bool().default(true),
+        schemas: av.optional(av.record(av.any())),
+        raw: av.optional(av.bool()),
+        demoScenarios: av.array(av.any()).default([])
+    }, { unknownKeys: "strip" })).default({})
+}, { unknownKeys: "strip" });
+export const WebhookTargetSchema = av.object({
+    id: UuidV7Schema,
+    tenantId: NonEmptyStringSchema,
+    appId: av.optional(NonEmptyStringSchema),
+    serviceId: NonEmptyStringSchema,
+    eventId: NonEmptyStringSchema,
+    url: av.string().format("url"),
+    secret: NonEmptyStringSchema,
+    createdAt: av.string().format("date-time"),
+    enabled: av.bool().default(true),
+    maxAttempts: av.int().min(1).max(20).default(10)
+}, { unknownKeys: "strip" });
+export const BetterPortalConfigSchema = av.object({
+    configManagement: BetterPortalConfigManagementSchema,
+    platformServices: av.array(PlatformServiceSchema).default([]),
+    tenants: av.array(BetterPortalTenantSchema).default([]),
+    apps: av.array(BetterPortalAppSchema).default([]),
+    sharedServiceCatalog: av.array(SharedServiceDefinitionSchema).default([]),
+    sharedServiceActivations: av.array(TenantSharedServiceActivationSchema).default([]),
+    manifestCache: av.array(ServiceManifestCacheEntrySchema).default([]),
+    webhooks: av.object({
+        targets: av.array(WebhookTargetSchema).default([])
+    }, { unknownKeys: "strip" }).default({ targets: [] })
+}, { unknownKeys: "strip" });
+export const BetterPortalOriginPolicySchema = av.object({
+    allowedOrigins: av.array(av.string().format("url")).default([]),
+    allowedReferers: av.array(av.string().format("url")).default([])
+}, { unknownKeys: "strip" });
+//# sourceMappingURL=platformConfig.js.map

package/lib/contracts/platformConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformConfig.js","sourceRoot":"","sources":["../../src/contracts/platformConfig.ts"],"names":[],"mappings":"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"}

package/lib/contracts/registry.d.ts

@@ -0,0 +1,104 @@
+import type { BaseSchema } from "anyvali";
+import type { HttpMethod } from "./common.js";
+import type { CacheHints } from "./view.js";
+import type { ApiAuthRequirement, DemoScenario, RawRouteHandler, RouteHandler, SSEHandler } from "./route.js";
+import type { BetterPortalRouteChrome } from "./platformConfig.js";
+import type { BpStreamHandler, StreamRendererSet } from "./streaming.js";
+import type { HtmlRenderable } from "../runtime/view.js";
+/** Type of view renderer within a _theme.* directory. */
+export type ThemeRendererType = "page" | "component" | "fragment";
+/** A single theme renderer - page, component, or fragment. */
+export interface RegisteredThemeRenderer {
+    readonly rendererId: string;
+    readonly type: ThemeRendererType;
+    /** HTTP method restriction (e.g., from index.GET.tsx). Undefined = all methods. */
+    readonly method?: HttpMethod;
+    /** Fragment location (e.g., "nav" from _nav.profile.tsx). Only for fragments. */
+    readonly fragmentLocation?: string;
+    /** Fragment id (e.g., "profile" from _nav.profile.tsx). Only for fragments. */
+    readonly fragmentId?: string;
+    /** The render function exported by the theme file. */
+    readonly render: (data: any) => HtmlRenderable;
+    /**
+     * SSE tick renderer - fragments only.
+     * Sourced from `_<location>.<fragmentId>.sse.tsx`'s `renderTick` export.
+     * Called once per SSE data item yielded by the route's `handleSSE` generator.
+     */
+    readonly sseRender?: (data: any) => HtmlRenderable;
+}
+/** All renderers for a single theme within a route. */
+export interface ThemeRendererSet {
+    readonly pages: ReadonlyArray<RegisteredThemeRenderer>;
+    readonly components: ReadonlyArray<RegisteredThemeRenderer>;
+    readonly fragments: ReadonlyArray<RegisteredThemeRenderer>;
+    /**
+     * Streaming-view frame renderers, sourced from `index.stream.tsx`.
+     * Present only on routes whose handler is a `createStreamHandler` stream.
+     */
+    readonly stream?: StreamRendererSet;
+}
+/**
+ * Status-specific renderers grouped by kind.
+ * `page` is single; `component` and `fragment` are keyed by id / location.id so the adapter
+ * can match the originally requested renderer (e.g. fragment `nav.profile`).
+ */
+export interface StatusRenderersByKind {
+    readonly page?: RegisteredThemeRenderer;
+    readonly components?: Readonly<Record<string, RegisteredThemeRenderer>>;
+    readonly fragments?: Readonly<Record<string, RegisteredThemeRenderer>>;
+}
+/** Schema references for a route - all optional except response. */
+export interface RouteSchemas {
+    readonly response?: BaseSchema<unknown, unknown>;
+    readonly query?: BaseSchema<unknown, unknown>;
+    readonly headers?: BaseSchema<unknown, unknown>;
+    readonly request?: BaseSchema<unknown, unknown>;
+    readonly multipart?: BaseSchema<unknown, unknown>;
+    /** Streaming views: per-frame item payload schema (canonical contract). */
+    readonly item?: BaseSchema<unknown, unknown>;
+    /** Streaming views: end-of-stream summary payload schema. */
+    readonly summary?: BaseSchema<unknown, unknown>;
+}
+/** A fully resolved route from the registry. */
+export interface RegisteredRoute {
+    readonly viewId: string;
+    /** HTTP path derived from filesystem (e.g., "/users/:userId"). */
+    readonly path: string;
+    /** HTTP methods derived from handler exports (e.g., ["GET", "POST"]). */
+    readonly methods: ReadonlyArray<HttpMethod>;
+    /** Parameter names derived from [param] directory names. */
+    readonly paramNames: ReadonlyArray<string>;
+    readonly schemas: RouteSchemas;
+    /** Handler functions keyed by HTTP method. Streaming routes register a branded BpStreamHandler object instead of a function. */
+    readonly handlers: Readonly<Partial<Record<HttpMethod, RouteHandler<any, any, any, any, any, any, any> | RawRouteHandler<any, any, any, any, any, any> | BpStreamHandler<any, any, any, any, any>>>>;
+    readonly raw?: boolean;
+    readonly title: string;
+    readonly description: string;
+    readonly auth: ApiAuthRequirement;
+    /** Optional view role hint (e.g., "auth.login"). Used by discovery flows. */
+    readonly role?: string;
+    /** ViewIds that should be mounted with this view for API/detail flows. */
+    readonly dependencies?: ReadonlyArray<string>;
+    /** Optional shell chrome hints declared by the service route. */
+    readonly chrome?: BetterPortalRouteChrome;
+    /**
+     * Status code -> renderer map (per theme), broken down by renderer kind.
+     * Adapter looks up by (themeId, statusCode, kind, optional rendererKey).
+     */
+    readonly statusRenderers?: Readonly<Record<string, Readonly<Record<number, StatusRenderersByKind>>>>;
+    readonly cacheHints: CacheHints;
+    readonly demoScenarios: ReadonlyArray<DemoScenario>;
+    /** Theme renderers keyed by themeId. */
+    readonly themeRenderers: Readonly<Record<string, ThemeRendererSet>>;
+    /** SSE handler, registered at `{path}/__sse`. */
+    readonly sse?: {
+        readonly handler: SSEHandler;
+        /** Optional schema validating each tick yielded by the generator handler. */
+        readonly tickSchema?: BaseSchema<unknown, unknown>;
+    };
+}
+/** The complete compiled registry - output of codegen. */
+export interface BetterPortalRegistry {
+    readonly routes: ReadonlyArray<RegisteredRoute>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/lib/contracts/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/contracts/registry.ts"],"names":[],"mappings":"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"}

package/lib/contracts/registry.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.js.map

package/lib/contracts/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/contracts/registry.ts"],"names":[],"mappings":""}

package/lib/contracts/route.d.ts

@@ -0,0 +1,199 @@
+import * as av from "anyvali";
+import type { Infer } from "anyvali";
+import type { HttpMethod } from "./common.js";
+import type { JsonValue } from "./json.js";
+import type { BetterPortalObservability } from "./observability.js";
+import type { BetterPortalApp, BetterPortalTenant } from "./platformConfig.js";
+import { type JwtClaims } from "./auth.js";
+/**
+ * Route-level (API-layer) auth requirement. Replaces ViewAuthRequirement at the API tier.
+ * Routes declare this to opt into framework-enforced authentication and authorization.
+ * Per spec section 0.5, validation runs in 8 steps before the handler is invoked.
+ */
+export declare const ApiAuthRequirementSchema: av.ObjectSchema<{
+    required: av.BoolSchema;
+    permissions: av.ArraySchema<av.ObjectSchema<{
+        serviceId: av.StringSchema;
+        viewId: av.StringSchema;
+        permissions: av.ArraySchema<av.EnumSchema<readonly ["read", "create", "update", "delete"]>>;
+    }>>;
+}>;
+export type ApiAuthRequirement = Infer<typeof ApiAuthRequirementSchema>;
+/**
+ * Interface the adapter uses to verify JWTs. Framework does not depend on a particular
+ * verifier impl - services or plugin-bsb inject one based on app.auth config.
+ */
+export interface JwtVerifier {
+    verify(token: string, context: {
+        tenantId: string;
+        appId: string;
+    }): Promise<JwtClaims>;
+}
+/**
+ * Validated user claims attached to the handler context when auth succeeds.
+ * Either fully populated or `undefined` - never partial.
+ */
+export type ValidatedUserClaims = JwtClaims;
+/**
+ * BP-managed header API on the handler context. Headers set here are emitted as
+ * BP-SetHeader / BP-RemoveHeader response headers and stored by the client BP shim.
+ */
+export interface BpHeadersApi {
+    set(name: string, value: string, options?: BpHeaderSetOptions): void;
+    remove(name: string): void;
+}
+export interface BpHeaderSetOptions {
+    /** Only the setting service may overwrite or remove. */
+    locked?: boolean;
+    /** Header only attached to subsequent requests to the service that set it. Default global. */
+    scopeToOwner?: boolean;
+    /** @deprecated Use scopeToOwner. Explicit cross-service header scope is not supported. */
+    scopeServiceId?: string;
+    /** Auto-remove on client after this many seconds. */
+    expiresInSeconds?: number;
+    /** Service-relative or absolute URL the shell may POST before expiry to refresh this header. */
+    refreshPath?: string;
+    /** Refresh this many seconds before expiry. Defaults to shell policy. */
+    refreshBeforeSeconds?: number;
+}
+export type RawResponseBody = BodyInit | null;
+export interface FileResponseOptions {
+    filename?: string;
+    contentType?: string;
+    size?: number;
+    disposition?: "attachment" | "inline";
+    headers?: HeadersInit;
+    status?: number;
+}
+export interface UploadedFile {
+    fieldName: string;
+    filename: string;
+    contentType: string;
+    size: number;
+    data: Uint8Array;
+}
+export interface MultipartRequest {
+    fields: Record<string, string | string[]>;
+    files: Record<string, UploadedFile | UploadedFile[]>;
+}
+export interface RouteUrlOptions {
+    /** Defaults to this handler's service id. Accepts either plugin id or service-instance UUID. */
+    serviceId?: string;
+    params?: Record<string, string | number | boolean | null | undefined>;
+    query?: Record<string, string | number | boolean | null | undefined>;
+    /** Defaults to false, returning a root-relative path. */
+    absolute?: boolean;
+    /** Overrides the resolved origin when absolute is true. */
+    origin?: string;
+}
+export interface WebhookEmitOptions {
+    tenantId?: string;
+    appId?: string;
+}
+/**
+ * Context provided to a route handler.
+ * TParams is auto-generated from [param] directory names - never hand-written.
+ */
+export interface RouteHandlerContext<TParams = Record<string, string>, TQuery = Record<string, unknown>, THeaders = Record<string, string>, TRequest = Record<string, unknown>, TPlugin = unknown, TServiceConfig = Record<string, unknown>> {
+    readonly params: TParams;
+    readonly query: TQuery;
+    readonly headers: THeaders;
+    readonly request: TRequest;
+    readonly multipart?: MultipartRequest;
+    readonly method: HttpMethod;
+    readonly path: string;
+    readonly rawEvent?: unknown;
+    readonly obs?: BetterPortalObservability;
+    /** Validated user claims when auth resolver succeeds. `undefined` for anonymous or invalid token. */
+    readonly user?: ValidatedUserClaims;
+    /** Resolved tenant for this request. Handlers are not invoked without it. */
+    readonly tenant: BetterPortalTenant;
+    /** Resolved app for this request. Handlers are not invoked without it. */
+    readonly app: BetterPortalApp;
+    /** Effective service config for this tenant/app: tenant defaults overridden by app config. */
+    readonly config?: TServiceConfig;
+    /** Direct plugin/service instance that owns this route. */
+    readonly plugin?: TPlugin;
+    /** Optional response model injected by services before generated view handlers run. */
+    readonly responseModel?: unknown;
+    /** BP-managed response header API. Always present when adapter wires it. */
+    readonly bpHeaders?: BpHeadersApi;
+    /** Response headers for HTMX/native headers without raw event reach-through. */
+    readonly responseHeaders?: Headers;
+    /** Set HTTP status without raw event reach-through. */
+    readonly setStatus?: (status: number) => void;
+    /** The service id this handler belongs to. Always present when adapter wires it. */
+    readonly serviceId?: string;
+    /** Build a service-facing URL for a registered view id. */
+    readonly routeUrl?: (viewId: string, options?: RouteUrlOptions) => string | null;
+    /** Build an app/UI-facing URL for a mounted route by view id. */
+    readonly uiRouteUrl?: (viewId: string, options?: RouteUrlOptions) => string | null;
+    /** Emit a dev-declared webhook event through the control plane. */
+    readonly webhook?: (eventId: string, payload: JsonValue, options?: WebhookEmitOptions) => Promise<void>;
+    readonly response: (body?: RawResponseBody, init?: ResponseInit) => Response;
+    readonly file: (body: RawResponseBody, options?: FileResponseOptions) => Response;
+}
+/**
+ * A route handler function. Return type is the response data.
+ */
+export type RouteHandler<TParams = Record<string, string>, TQuery = Record<string, unknown>, THeaders = Record<string, string>, TRequest = Record<string, unknown>, TResponse = unknown, TPlugin = unknown, TServiceConfig = Record<string, unknown>> = (ctx: RouteHandlerContext<TParams, TQuery, THeaders, TRequest, TPlugin, TServiceConfig>) => TResponse | Promise<TResponse>;
+export type RawRouteHandler<TParams = Record<string, string>, TQuery = Record<string, unknown>, THeaders = Record<string, string>, TRequest = Record<string, unknown>, TPlugin = unknown, TServiceConfig = Record<string, unknown>> = ((ctx: RouteHandlerContext<TParams, TQuery, THeaders, TRequest, TPlugin, TServiceConfig>) => Response | Promise<Response>) & {
+    readonly __bpRawHandler: true;
+};
+/**
+ * Match criteria for demo scenarios - used to match incoming request data
+ * against a scenario for preview/testing.
+ */
+export interface DemoScenarioMatch {
+    readonly query?: Record<string, unknown>;
+    readonly params?: Record<string, unknown>;
+    readonly headers?: Record<string, string>;
+    readonly request?: Record<string, unknown>;
+}
+export declare const DemoScenarioMatchSchema: av.ObjectSchema<{
+    query: av.OptionalSchema<av.RecordSchema<av.AnySchema>>;
+    params: av.OptionalSchema<av.RecordSchema<av.AnySchema>>;
+    headers: av.OptionalSchema<av.RecordSchema<av.StringSchema>>;
+    request: av.OptionalSchema<av.RecordSchema<av.AnySchema>>;
+}>;
+/**
+ * A demo scenario for a route - includes optional match criteria
+ * and the expected response data.
+ */
+export interface DemoScenario<TResponse = unknown> {
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly match?: DemoScenarioMatch;
+    readonly response: TResponse;
+}
+export declare const DemoScenarioSchema: av.ObjectSchema<{
+    id: av.StringSchema;
+    title: av.StringSchema;
+    description: av.OptionalSchema<av.StringSchema>;
+    match: av.OptionalSchema<av.ObjectSchema<{
+        query: av.OptionalSchema<av.RecordSchema<av.AnySchema>>;
+        params: av.OptionalSchema<av.RecordSchema<av.AnySchema>>;
+        headers: av.OptionalSchema<av.RecordSchema<av.StringSchema>>;
+        request: av.OptionalSchema<av.RecordSchema<av.AnySchema>>;
+    }>>;
+    response: av.AnySchema;
+}>;
+export type DemoScenarioInferred = Infer<typeof DemoScenarioSchema>;
+export interface SSEHandlerContext {
+    readonly event: unknown;
+    readonly params: Record<string, string>;
+    readonly query: Record<string, unknown>;
+    readonly obs?: BetterPortalObservability;
+}
+/**
+ * Two supported handler shapes:
+ *  - Legacy: returns BodyInit (e.g., from `createEventStream(event).send()`).
+ *            Handler manages stream lifecycle directly. Cannot be themed.
+ *  - Generator: returns AsyncIterable of data items. Framework drives the
+ *               stream, validates each item (if `tickSchema` exported), and
+ *               applies theme-specific `renderTick` when `?_f=loc.frag` is
+ *               present on the request.
+ */
+export type SSEHandler = ((ctx: SSEHandlerContext) => Promise<BodyInit> | BodyInit) | ((ctx: SSEHandlerContext) => AsyncIterable<unknown>);
+//# sourceMappingURL=route.d.ts.map

package/lib/contracts/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/contracts/route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;EAGT,CAAC;AAC7B,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACzF;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8FAA8F;IAC9F,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,IAAI,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;IACtC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,eAAe;IAC9B,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACrE,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAClC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,GAAG,OAAO,EACjB,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAExC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,yBAAyB,CAAC;IACzC,qGAAqG;IACrG,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;IAClC,gFAAgF;IAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,MAAM,GAAG,IAAI,CAAC;IACjF,iEAAiE;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,MAAM,GAAG,IAAI,CAAC;IACnF,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxG,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,QAAQ,CAAC;IAC7E,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,QAAQ,CAAC;CACnF;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,CACtB,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,SAAS,GAAG,OAAO,EACnB,OAAO,GAAG,OAAO,EACjB,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACtC,CAAC,GAAG,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAE/H,MAAM,MAAM,eAAe,CACzB,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,GAAG,OAAO,EACjB,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACtC,CAAC,CAAC,GAAG,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG;IAC/H,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;CAC/B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAID,eAAO,MAAM,uBAAuB;;;;;EAKR,CAAC;AAE7B;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,SAAS,GAAG,OAAO;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;EAMH,CAAC;AAC7B,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAIpE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,yBAAyB,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAClB,CAAC,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAC1D,CAAC,CAAC,GAAG,EAAE,iBAAiB,KAAK,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC"}

package/lib/contracts/route.js

@@ -0,0 +1,26 @@
+import * as av from "anyvali";
+import { AppAuthPermissionGrantSchema } from "./auth.js";
+/**
+ * Route-level (API-layer) auth requirement. Replaces ViewAuthRequirement at the API tier.
+ * Routes declare this to opt into framework-enforced authentication and authorization.
+ * Per spec section 0.5, validation runs in 8 steps before the handler is invoked.
+ */
+export const ApiAuthRequirementSchema = av.object({
+    required: av.bool().default(false),
+    permissions: av.array(AppAuthPermissionGrantSchema).default([])
+}, { unknownKeys: "strip" });
+const NonEmptyStringSchema = av.string().minLength(1);
+export const DemoScenarioMatchSchema = av.object({
+    query: av.optional(av.record(av.any())),
+    params: av.optional(av.record(av.any())),
+    headers: av.optional(av.record(av.string())),
+    request: av.optional(av.record(av.any()))
+}, { unknownKeys: "strip" });
+export const DemoScenarioSchema = av.object({
+    id: NonEmptyStringSchema,
+    title: NonEmptyStringSchema,
+    description: av.optional(av.string()),
+    match: av.optional(DemoScenarioMatchSchema),
+    response: av.any()
+}, { unknownKeys: "strip" });
+//# sourceMappingURL=route.js.map

package/lib/contracts/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/contracts/route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAM9B,OAAO,EAAE,4BAA4B,EAAkB,MAAM,WAAW,CAAC;AAEzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClC,WAAW,EAAE,EAAE,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAChE,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;AAuK7B,MAAM,oBAAoB,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IACxC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;CAC1C,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;AAc7B,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,oBAAoB;IACxB,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;IACrC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC3C,QAAQ,EAAE,EAAE,CAAC,GAAG,EAAE;CACnB,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC"}