@betterportal/framework 0.0.1

package/lib/contracts/serviceConfig.d.ts

@@ -0,0 +1,88 @@
+import * as av from "anyvali";
+import type { Infer } from "anyvali";
+export declare const ServiceConfigActionSchema: av.EnumSchema<readonly ["schema.read", "config.read", "config.write"]>;
+export type ServiceConfigAction = Infer<typeof ServiceConfigActionSchema>;
+export declare const ServiceConfigManagementModeSchema: av.EnumSchema<readonly ["static", "bp-managed", "hybrid"]>;
+export type ServiceConfigManagementMode = Infer<typeof ServiceConfigManagementModeSchema>;
+export declare const ServiceConfigTicketClaimsSchema: av.ObjectSchema<{
+    iss: av.StringSchema;
+    aud: av.UnionSchema<[av.StringSchema, av.ArraySchema<av.StringSchema>]>;
+    sub: av.StringSchema;
+    exp: av.IntSchema;
+    iat: av.IntSchema;
+    jti: av.StringSchema;
+    realm: av.LiteralSchema<"control-plane">;
+    tenantId: av.StringSchema;
+    serviceId: av.StringSchema;
+    bindingId: av.OptionalSchema<av.StringSchema>;
+    actions: av.ArraySchema<av.EnumSchema<readonly ["schema.read", "config.read", "config.write"]>>;
+}>;
+export type ServiceConfigTicketClaims = Infer<typeof ServiceConfigTicketClaimsSchema>;
+export declare const ServiceConfigStateSchema: av.ObjectSchema<{
+    tenant: av.RecordSchema<av.BaseSchema<unknown, import("./json.js").JsonValue>>;
+    app: av.RecordSchema<av.RecordSchema<av.BaseSchema<unknown, import("./json.js").JsonValue>>>;
+}>;
+export type ServiceConfigState = Infer<typeof ServiceConfigStateSchema>;
+export declare const ServiceConfigWriteRequestSchema: av.ObjectSchema<{
+    tenantId: av.StringSchema;
+    appId: av.OptionalSchema<av.StringSchema>;
+    values: av.BaseSchema<unknown, import("./json.js").JsonObject>;
+    clearKeys: av.ArraySchema<av.StringSchema>;
+}>;
+export type ServiceConfigWriteRequest = Infer<typeof ServiceConfigWriteRequestSchema>;
+export declare const ServiceConfigSchemaResponseSchema: av.ObjectSchema<{
+    serviceId: av.StringSchema;
+    mode: av.EnumSchema<readonly ["static", "bp-managed", "hybrid"]>;
+    configSchemas: av.ArraySchema<av.ObjectSchema<{
+        id: av.StringSchema;
+        title: av.StringSchema;
+        description: av.StringSchema;
+        scope: av.EnumSchema<readonly ["tenant", "app"]>;
+        jsonSchema: av.BaseSchema<unknown, import("./json.js").JsonObject>;
+        groups: av.OptionalSchema<av.ArraySchema<av.ObjectSchema<{
+            id: av.StringSchema;
+            title: av.StringSchema;
+            description: av.OptionalSchema<av.StringSchema>;
+            order: av.OptionalSchema<av.IntSchema>;
+            optional: av.OptionalSchema<av.BoolSchema>;
+        }>>>;
+        fields: av.ArraySchema<av.ObjectSchema<{
+            key: av.StringSchema;
+            title: av.StringSchema;
+            description: av.StringSchema;
+            scope: av.EnumSchema<readonly ["tenant", "app"]>;
+            visibility: av.EnumSchema<readonly ["public", "protected", "secret"]>;
+            ownership: av.EnumSchema<readonly ["bp", "plugin", "mixed"]>;
+            sourceOfTruth: av.EnumSchema<readonly ["bp", "plugin", "external"]>;
+            groupId: av.OptionalSchema<av.StringSchema>;
+            order: av.OptionalSchema<av.IntSchema>;
+            defaultValue: av.OptionalSchema<av.BaseSchema<unknown, import("./json.js").JsonValue>>;
+            ui: av.OptionalSchema<av.ObjectSchema<{
+                control: av.OptionalSchema<av.EnumSchema<readonly ["text", "textarea", "password", "number", "checkbox", "select", "multiselect", "color", "date", "time", "datetime-local", "url", "email"]>>;
+                placeholder: av.OptionalSchema<av.StringSchema>;
+                options: av.OptionalSchema<av.ArraySchema<av.ObjectSchema<{
+                    value: av.StringSchema;
+                    label: av.StringSchema;
+                }>>>;
+                optionsSource: av.OptionalSchema<av.EnumSchema<readonly ["app.routes"]>>;
+                min: av.OptionalSchema<av.UnionSchema<[av.NumberSchema, av.StringSchema]>>;
+                max: av.OptionalSchema<av.UnionSchema<[av.NumberSchema, av.StringSchema]>>;
+                step: av.OptionalSchema<av.NumberSchema>;
+                rows: av.OptionalSchema<av.IntSchema>;
+            }>>;
+            required: av.BoolSchema;
+        }>>;
+    }>>;
+    supportsCustomUi: av.BoolSchema;
+    customUiPath: av.OptionalSchema<av.StringSchema>;
+    supportsWrite: av.BoolSchema;
+}>;
+export type ServiceConfigSchemaResponse = Infer<typeof ServiceConfigSchemaResponseSchema>;
+export declare const ServiceConfigReadResponseSchema: av.ObjectSchema<{
+    serviceId: av.StringSchema;
+    tenantId: av.StringSchema;
+    appId: av.OptionalSchema<av.StringSchema>;
+    values: av.BaseSchema<unknown, import("./json.js").JsonObject>;
+}>;
+export type ServiceConfigReadResponse = Infer<typeof ServiceConfigReadResponseSchema>;
+//# sourceMappingURL=serviceConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serviceConfig.d.ts","sourceRoot":"","sources":["../../src/contracts/serviceConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAOrC,eAAO,MAAM,yBAAyB,wEAAoE,CAAC;AAC3G,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE1E,eAAO,MAAM,iCAAiC,4DAAwD,CAAC;AACvG,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE1F,eAAO,MAAM,+BAA+B;;;;;;;;;;;;EAYhB,CAAC;AAC7B,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEtF,eAAO,MAAM,wBAAwB;;;EAGT,CAAC;AAC7B,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAExE,eAAO,MAAM,+BAA+B;;;;;EAKhB,CAAC;AAC7B,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEtF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOlB,CAAC;AAC7B,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE1F,eAAO,MAAM,+BAA+B;;;;;EAKhB,CAAC;AAC7B,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/lib/contracts/serviceConfig.js

@@ -0,0 +1,45 @@
+import * as av from "anyvali";
+import { ConfigSchemaDescriptorSchema } from "./config.js";
+import { JsonObjectSchema, JsonValueSchema } from "./json.js";
+const NonEmptyStringSchema = av.string().minLength(1);
+const NonEmptyStringArraySchema = av.array(NonEmptyStringSchema).minItems(1);
+export const ServiceConfigActionSchema = av.enum_(["schema.read", "config.read", "config.write"]);
+export const ServiceConfigManagementModeSchema = av.enum_(["static", "bp-managed", "hybrid"]);
+export const ServiceConfigTicketClaimsSchema = av.object({
+    iss: NonEmptyStringSchema,
+    aud: av.union([NonEmptyStringSchema, NonEmptyStringArraySchema]),
+    sub: NonEmptyStringSchema,
+    exp: av.int().min(1),
+    iat: av.int().min(0),
+    jti: NonEmptyStringSchema,
+    realm: av.literal("control-plane"),
+    tenantId: NonEmptyStringSchema,
+    serviceId: NonEmptyStringSchema,
+    bindingId: av.optional(NonEmptyStringSchema),
+    actions: av.array(ServiceConfigActionSchema).minItems(1)
+}, { unknownKeys: "strip" });
+export const ServiceConfigStateSchema = av.object({
+    tenant: av.record(JsonValueSchema).default({}),
+    app: av.record(av.record(JsonValueSchema)).default({})
+}, { unknownKeys: "strip" });
+export const ServiceConfigWriteRequestSchema = av.object({
+    tenantId: NonEmptyStringSchema,
+    appId: av.optional(NonEmptyStringSchema),
+    values: JsonObjectSchema,
+    clearKeys: av.array(NonEmptyStringSchema).default([])
+}, { unknownKeys: "strip" });
+export const ServiceConfigSchemaResponseSchema = av.object({
+    serviceId: NonEmptyStringSchema,
+    mode: ServiceConfigManagementModeSchema,
+    configSchemas: av.array(ConfigSchemaDescriptorSchema).default([]),
+    supportsCustomUi: av.bool().default(false),
+    customUiPath: av.optional(NonEmptyStringSchema),
+    supportsWrite: av.bool().default(false)
+}, { unknownKeys: "strip" });
+export const ServiceConfigReadResponseSchema = av.object({
+    serviceId: NonEmptyStringSchema,
+    tenantId: NonEmptyStringSchema,
+    appId: av.optional(NonEmptyStringSchema),
+    values: JsonObjectSchema
+}, { unknownKeys: "strip" });
+//# sourceMappingURL=serviceConfig.js.map

package/lib/contracts/serviceConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceConfig.js","sourceRoot":"","sources":["../../src/contracts/serviceConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE9D,MAAM,oBAAoB,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AACtD,MAAM,yBAAyB,GAAG,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,cAAc,CAAU,CAAC,CAAC;AAG3G,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC,CAAC;AAGvG,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC,MAAM,CAAC;IACvD,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,oBAAoB,EAAE,yBAAyB,CAAC,CAAC;IAChE,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpB,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpB,GAAG,EAAE,oBAAoB;IACzB,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC;IAClC,QAAQ,EAAE,oBAAoB;IAC9B,SAAS,EAAE,oBAAoB;IAC/B,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC5C,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;CACzD,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;AAG7B,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvD,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;AAG7B,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC,MAAM,CAAC;IACvD,QAAQ,EAAE,oBAAoB;IAC9B,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACxC,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACtD,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;AAG7B,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC,MAAM,CAAC;IACzD,SAAS,EAAE,oBAAoB;IAC/B,IAAI,EAAE,iCAAiC;IACvC,aAAa,EAAE,EAAE,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACjE,gBAAgB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC1C,YAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC/C,aAAa,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACxC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;AAG7B,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC,MAAM,CAAC;IACvD,SAAS,EAAE,oBAAoB;IAC/B,QAAQ,EAAE,oBAAoB;IAC9B,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACxC,MAAM,EAAE,gBAAgB;CACzB,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC"}

package/lib/contracts/streaming.d.ts

@@ -0,0 +1,76 @@
+import * as av from "anyvali";
+import type { BaseSchema, Infer } from "anyvali";
+import type { RouteHandlerContext } from "./route.js";
+import type { HtmlRenderable } from "../runtime/view.js";
+export declare const StreamErrorFrameSchema: av.ObjectSchema<{
+    kind: av.EnumSchema<readonly ["error"]>;
+    error: av.StringSchema;
+    message: av.StringSchema;
+    issues: av.OptionalSchema<av.ArraySchema<av.ObjectSchema<{
+        code: av.StringSchema;
+        path: av.OptionalSchema<av.StringSchema>;
+        message: av.StringSchema;
+    }>>>;
+}>;
+export type StreamErrorFrame = Infer<typeof StreamErrorFrameSchema>;
+export declare const StreamEndFrameSchema: av.ObjectSchema<{
+    kind: av.EnumSchema<readonly ["end"]>;
+    count: av.IntSchema;
+}>;
+export type StreamEndFrame = Infer<typeof StreamEndFrameSchema>;
+export interface StreamItemFrame<TItem = unknown> {
+    readonly kind: "item";
+    readonly data: TItem;
+}
+export interface StreamSummaryFrame<TSummary = unknown> {
+    readonly kind: "summary";
+    readonly data: TSummary;
+}
+export type StreamFrame<TItem = unknown, TSummary = unknown> = StreamItemFrame<TItem> | StreamSummaryFrame<TSummary> | StreamErrorFrame | StreamEndFrame;
+/**
+ * Brand key identifying a stream handler in the registry's `handlers` map.
+ * Stream handlers are objects (not callables); the adapter detects the brand
+ * at request time and diverts to the streaming pipeline.
+ */
+export declare const BP_STREAM_HANDLER: unique symbol;
+/**
+ * A streaming route handler. The generator yields validated-shape items and
+ * MAY return a summary value. The adapter (not the generator) drives frame
+ * encoding, per-frame validation, and representation negotiation.
+ */
+export interface BpStreamHandler<TItem = unknown, TSummary = unknown, TParams = Record<string, string>, TQuery = Record<string, unknown>, THeaders = Record<string, string>> {
+    readonly [BP_STREAM_HANDLER]: true;
+    readonly itemSchema: BaseSchema<unknown, unknown>;
+    readonly summarySchema?: BaseSchema<unknown, unknown>;
+    /**
+     * Derived buffered-JSON response schema: `{ items: array(itemSchema), summary? }`.
+     * Used as the route's `schemas.response` and the manifest's `jsonResponseSchema`
+     * so streaming views never hand-author a second response shape.
+     */
+    readonly responseSchema: BaseSchema<unknown, unknown>;
+    run(ctx: RouteHandlerContext<TParams, TQuery, THeaders, Record<string, unknown>>): AsyncGenerator<TItem, TSummary | void, void>;
+}
+export declare function isStreamHandler(value: unknown): value is BpStreamHandler<any, any, any, any, any>;
+/**
+ * Context passed to a streaming view's shell renderer.
+ * `sseConnectPath` is the relative SSE URL (path + original query string) the
+ * shell should wire via `hx-sse:connect` - the client rewriter absolutizes it.
+ */
+export interface StreamShellContext {
+    readonly sseConnectPath: string;
+    readonly params: Record<string, string>;
+    readonly query: Record<string, unknown>;
+}
+/**
+ * Per-theme renderers for a streaming view, sourced from
+ * `_theme.<themeId>/index.stream.tsx` exports.
+ * Each function renders ONE frame; the buffered HTML page render uses the
+ * regular `index.tsx` page renderer over the derived `{ items, summary }` data.
+ */
+export interface StreamRendererSet {
+    readonly renderShell: (ctx: StreamShellContext) => HtmlRenderable;
+    readonly renderItem: (item: any) => HtmlRenderable;
+    readonly renderSummary?: (summary: any) => HtmlRenderable;
+    readonly renderError?: (error: StreamErrorFrame) => HtmlRenderable;
+}
+//# sourceMappingURL=streaming.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/contracts/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD,eAAO,MAAM,sBAAsB;;;;;;;;;EASP,CAAC;AAC7B,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;;;EAGL,CAAC;AAC7B,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEhE,MAAM,WAAW,eAAe,CAAC,KAAK,GAAG,OAAO;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ,GAAG,OAAO;IACpD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,CAAC,KAAK,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,IACvD,eAAe,CAAC,KAAK,CAAC,GACtB,kBAAkB,CAAC,QAAQ,CAAC,GAC5B,gBAAgB,GAChB,cAAc,CAAC;AAInB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,eAA2C,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAC9B,KAAK,GAAG,OAAO,EACf,QAAQ,GAAG,OAAO,EAClB,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;IAEjC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtD;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtD,GAAG,CACD,GAAG,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC3E,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;CACjD;AAGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAIjG;AAID;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,cAAc,CAAC;IAElE,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,cAAc,CAAC;IAEnD,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,cAAc,CAAC;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,cAAc,CAAC;CACpE"}

package/lib/contracts/streaming.js

@@ -0,0 +1,31 @@
+import * as av from "anyvali";
+// -- Frame envelope (spec/streaming.md section 1) ---------------------------
+// Protocol-defined wire shape. Payload (`data`) schemas are view-defined.
+export const StreamErrorFrameSchema = av.object({
+    kind: av.enum_(["error"]),
+    error: av.string().minLength(1),
+    message: av.string().minLength(1),
+    issues: av.optional(av.array(av.object({
+        code: av.string().minLength(1),
+        path: av.optional(av.string()),
+        message: av.string().minLength(1)
+    }, { unknownKeys: "strip" })))
+}, { unknownKeys: "strip" });
+export const StreamEndFrameSchema = av.object({
+    kind: av.enum_(["end"]),
+    count: av.int().min(0)
+}, { unknownKeys: "strip" });
+// -- Stream handler (branded, produced by createStreamHandler) --------
+/**
+ * Brand key identifying a stream handler in the registry's `handlers` map.
+ * Stream handlers are objects (not callables); the adapter detects the brand
+ * at request time and diverts to the streaming pipeline.
+ */
+export const BP_STREAM_HANDLER = Symbol.for("betterportal.streamHandler");
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function isStreamHandler(value) {
+    return typeof value === "object"
+        && value !== null
+        && value[BP_STREAM_HANDLER] === true;
+}
+//# sourceMappingURL=streaming.js.map

package/lib/contracts/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/contracts/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAK9B,8EAA8E;AAC9E,0EAA0E;AAE1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAU,CAAC;IAClC,KAAK,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/B,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IACjC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC;QACrC,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9B,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;QAC9B,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;KAClC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;CAC/B,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;AAG7B,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,CAAU,CAAC;IAChC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACvB,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;AAmB7B,wEAAwE;AAExE;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AA4B1E,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ;WAC3B,KAAK,KAAK,IAAI;WACb,KAAiC,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;AACtE,CAAC"}

package/lib/contracts/view.d.ts

@@ -0,0 +1,149 @@
+import * as av from "anyvali";
+import type { Infer } from "anyvali";
+export declare const CacheHintsSchema: av.ObjectSchema<{
+    ttlSeconds: av.IntSchema;
+    varyBy: av.ArraySchema<av.StringSchema>;
+}>;
+export type CacheHints = Infer<typeof CacheHintsSchema>;
+export declare const ViewRendererVariantSchema: av.ObjectSchema<{
+    id: av.StringSchema;
+    title: av.StringSchema;
+    slotId: av.StringSchema;
+    renderModes: av.ArraySchema<av.EnumSchema<readonly ["page", "fragment", "embed"]>>;
+}>;
+export type ViewRendererVariant = Infer<typeof ViewRendererVariantSchema>;
+export declare const ThemeRendererSupportSchema: av.ObjectSchema<{
+    defaultRenderer: av.StringSchema;
+    renderModes: av.ArraySchema<av.EnumSchema<readonly ["page", "fragment", "embed"]>>;
+    slots: av.ArraySchema<av.StringSchema>;
+    renderers: av.ArraySchema<av.ObjectSchema<{
+        id: av.StringSchema;
+        title: av.StringSchema;
+        slotId: av.StringSchema;
+        renderModes: av.ArraySchema<av.EnumSchema<readonly ["page", "fragment", "embed"]>>;
+    }>>;
+}>;
+export type ThemeRendererSupport = Infer<typeof ThemeRendererSupportSchema>;
+export declare const HtmlRepresentationSupportSchema: av.ObjectSchema<{
+    themeRenderers: av.RecordSchema<av.ObjectSchema<{
+        defaultRenderer: av.StringSchema;
+        renderModes: av.ArraySchema<av.EnumSchema<readonly ["page", "fragment", "embed"]>>;
+        slots: av.ArraySchema<av.StringSchema>;
+        renderers: av.ArraySchema<av.ObjectSchema<{
+            id: av.StringSchema;
+            title: av.StringSchema;
+            slotId: av.StringSchema;
+            renderModes: av.ArraySchema<av.EnumSchema<readonly ["page", "fragment", "embed"]>>;
+        }>>;
+    }>>;
+}>;
+export type HtmlRepresentationSupport = Infer<typeof HtmlRepresentationSupportSchema>;
+export declare const ViewDemoScenarioMatchSchema: 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>>;
+}>;
+export type ViewDemoScenarioMatch = Infer<typeof ViewDemoScenarioMatchSchema>;
+export declare const ViewDemoScenarioSchema: 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.BaseSchema<unknown, import("./json.js").JsonValue>;
+}>;
+export type ViewDemoScenario = Infer<typeof ViewDemoScenarioSchema>;
+/**
+ * Optional role hint for a view. Used by discovery flows to auto-fill app config.
+ * Examples: "auth.login", "auth.logout", "auth.refresh", "nav.profile", "footer.brand".
+ * Not enforced - pure metadata.
+ */
+export declare const ViewRoleSchema: av.StringSchema;
+export type ViewRole = Infer<typeof ViewRoleSchema>;
+/**
+ * Streaming declaration for a view (spec/streaming.md section 5). Present only on
+ * streaming views; `jsonResponseSchema` then holds the derived buffered shape.
+ */
+export declare const ViewStreamingSupportSchema: av.ObjectSchema<{
+    itemSchema: av.BaseSchema<unknown, import("./json.js").JsonObject>;
+    summarySchema: av.OptionalSchema<av.BaseSchema<unknown, import("./json.js").JsonObject>>;
+}>;
+export type ViewStreamingSupport = Infer<typeof ViewStreamingSupportSchema>;
+export declare const ViewMetadataSchema: av.ObjectSchema<{
+    viewId: av.StringSchema;
+    title: av.StringSchema;
+    description: av.StringSchema;
+    path: av.StringSchema;
+    methods: av.ArraySchema<av.EnumSchema<readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"]>>;
+    paramsSchema: av.BaseSchema<unknown, import("./json.js").JsonObject>;
+    querySchema: av.BaseSchema<unknown, import("./json.js").JsonObject>;
+    headersSchema: av.BaseSchema<unknown, import("./json.js").JsonObject>;
+    bodySchema: av.BaseSchema<unknown, import("./json.js").JsonObject>;
+    jsonResponseSchema: av.BaseSchema<unknown, import("./json.js").JsonObject>;
+    metadataResponseSchema: av.BaseSchema<unknown, import("./json.js").JsonObject>;
+    renderable: av.BoolSchema;
+    raw: av.OptionalSchema<av.BoolSchema>;
+    streaming: av.OptionalSchema<av.ObjectSchema<{
+        itemSchema: av.BaseSchema<unknown, import("./json.js").JsonObject>;
+        summarySchema: av.OptionalSchema<av.BaseSchema<unknown, import("./json.js").JsonObject>>;
+    }>>;
+    html: av.ObjectSchema<{
+        themeRenderers: av.RecordSchema<av.ObjectSchema<{
+            defaultRenderer: av.StringSchema;
+            renderModes: av.ArraySchema<av.EnumSchema<readonly ["page", "fragment", "embed"]>>;
+            slots: av.ArraySchema<av.StringSchema>;
+            renderers: av.ArraySchema<av.ObjectSchema<{
+                id: av.StringSchema;
+                title: av.StringSchema;
+                slotId: av.StringSchema;
+                renderModes: av.ArraySchema<av.EnumSchema<readonly ["page", "fragment", "embed"]>>;
+            }>>;
+        }>>;
+    }>;
+    auth: 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"]>>;
+        }>>;
+    }>;
+    role: av.OptionalSchema<av.StringSchema>;
+    dependencies: av.ArraySchema<av.StringSchema>;
+    chrome: av.OptionalSchema<av.IntersectionSchema<[av.ObjectSchema<{
+        hideMenu: av.OptionalSchema<av.BoolSchema>;
+        hideHeader: av.OptionalSchema<av.BoolSchema>;
+        hideFooter: av.OptionalSchema<av.BoolSchema>;
+        fullScreen: av.OptionalSchema<av.BoolSchema>;
+    }>, av.RecordSchema<av.UnionSchema<[av.StringSchema, av.NumberSchema, av.BoolSchema]>>]>>;
+    demoScenarios: av.ArraySchema<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.BaseSchema<unknown, import("./json.js").JsonValue>;
+    }>>;
+    cacheHints: av.ObjectSchema<{
+        ttlSeconds: av.IntSchema;
+        varyBy: av.ArraySchema<av.StringSchema>;
+    }>;
+}>;
+export type ViewMetadata = Infer<typeof ViewMetadataSchema>;
+export declare const ViewPermissionDefinitionSchema: av.ObjectSchema<{
+    id: av.StringSchema;
+    title: av.StringSchema;
+    description: av.StringSchema;
+    defaultRoles: av.ArraySchema<av.StringSchema>;
+}>;
+export type ViewPermissionDefinition = Infer<typeof ViewPermissionDefinitionSchema>;
+//# sourceMappingURL=view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/contracts/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAQrC,eAAO,MAAM,gBAAgB;;;EAGD,CAAC;AAC7B,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAExD,eAAO,MAAM,yBAAyB;;;;;EAKV,CAAC;AAC7B,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE1E,eAAO,MAAM,0BAA0B;;;;;;;;;;EAKX,CAAC;AAC7B,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE5E,eAAO,MAAM,+BAA+B;;;;;;;;;;;;EAEhB,CAAC;AAC7B,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEtF,eAAO,MAAM,2BAA2B;;;;;EAKZ,CAAC;AAC7B,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE9E,eAAO,MAAM,sBAAsB;;;;;;;;;;;EAMP,CAAC;AAC7B,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,cAAc,iBAA2B,CAAC;AACvD,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;EAGX,CAAC;AAC7B,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE5E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBH,CAAC;AAC7B,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE5D,eAAO,MAAM,8BAA8B;;;;;EAKf,CAAC;AAC7B,MAAM,MAAM,wBAAwB,GAAG,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/lib/contracts/view.js

@@ -0,0 +1,82 @@
+import * as av from "anyvali";
+import { HttpMethodSchema, RenderModeSchema } from "./common.js";
+import { JsonObjectSchema, JsonValueSchema } from "./json.js";
+import { BetterPortalRouteChromeSchema } from "./platformConfig.js";
+import { ApiAuthRequirementSchema } from "./route.js";
+const NonEmptyStringSchema = av.string().minLength(1);
+export const CacheHintsSchema = av.object({
+    ttlSeconds: av.int().min(0).default(0),
+    varyBy: av.array(NonEmptyStringSchema).default([])
+}, { unknownKeys: "strip" });
+export const ViewRendererVariantSchema = av.object({
+    id: NonEmptyStringSchema,
+    title: NonEmptyStringSchema,
+    slotId: NonEmptyStringSchema,
+    renderModes: av.array(RenderModeSchema).default([])
+}, { unknownKeys: "strip" });
+export const ThemeRendererSupportSchema = av.object({
+    defaultRenderer: NonEmptyStringSchema.default("default"),
+    renderModes: av.array(RenderModeSchema).default([]),
+    slots: av.array(NonEmptyStringSchema).default([]),
+    renderers: av.array(ViewRendererVariantSchema).default([])
+}, { unknownKeys: "strip" });
+export const HtmlRepresentationSupportSchema = av.object({
+    themeRenderers: av.record(ThemeRendererSupportSchema).default({})
+}, { unknownKeys: "strip" });
+export const ViewDemoScenarioMatchSchema = 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 ViewDemoScenarioSchema = av.object({
+    id: NonEmptyStringSchema,
+    title: NonEmptyStringSchema,
+    description: av.optional(av.string()),
+    match: av.optional(ViewDemoScenarioMatchSchema),
+    response: JsonValueSchema
+}, { unknownKeys: "strip" });
+/**
+ * Optional role hint for a view. Used by discovery flows to auto-fill app config.
+ * Examples: "auth.login", "auth.logout", "auth.refresh", "nav.profile", "footer.brand".
+ * Not enforced - pure metadata.
+ */
+export const ViewRoleSchema = av.string().minLength(1);
+/**
+ * Streaming declaration for a view (spec/streaming.md section 5). Present only on
+ * streaming views; `jsonResponseSchema` then holds the derived buffered shape.
+ */
+export const ViewStreamingSupportSchema = av.object({
+    itemSchema: JsonObjectSchema,
+    summarySchema: av.optional(JsonObjectSchema)
+}, { unknownKeys: "strip" });
+export const ViewMetadataSchema = av.object({
+    viewId: NonEmptyStringSchema,
+    title: NonEmptyStringSchema,
+    description: NonEmptyStringSchema,
+    path: NonEmptyStringSchema,
+    methods: av.array(HttpMethodSchema).minItems(1),
+    paramsSchema: JsonObjectSchema,
+    querySchema: JsonObjectSchema,
+    headersSchema: JsonObjectSchema,
+    bodySchema: JsonObjectSchema,
+    jsonResponseSchema: JsonObjectSchema,
+    metadataResponseSchema: JsonObjectSchema,
+    renderable: av.bool().default(true),
+    raw: av.optional(av.bool()),
+    streaming: av.optional(ViewStreamingSupportSchema),
+    html: HtmlRepresentationSupportSchema,
+    auth: ApiAuthRequirementSchema,
+    role: av.optional(ViewRoleSchema),
+    dependencies: av.array(NonEmptyStringSchema).default([]),
+    chrome: av.optional(BetterPortalRouteChromeSchema),
+    demoScenarios: av.array(ViewDemoScenarioSchema).default([]),
+    cacheHints: CacheHintsSchema
+}, { unknownKeys: "strip" });
+export const ViewPermissionDefinitionSchema = av.object({
+    id: NonEmptyStringSchema,
+    title: NonEmptyStringSchema,
+    description: NonEmptyStringSchema,
+    defaultRoles: av.array(NonEmptyStringSchema).default([])
+}, { unknownKeys: "strip" });
+//# sourceMappingURL=view.js.map

package/lib/contracts/view.js.map

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

package/lib/controlPlane/store.d.ts

@@ -0,0 +1,24 @@
+import { App, BindingRecord, ServiceCatalogEntry, Tenant } from "../contracts/binding.js";
+import { PluginManifest } from "../contracts/manifest.js";
+import { ImportedManifestRecord, ControlPlaneSnapshot } from "./types.js";
+export declare class BetterPortalControlPlaneStore {
+    private readonly catalog;
+    private readonly tenants;
+    private readonly apps;
+    private readonly bindings;
+    private readonly manifests;
+    registerCatalogEntry(entry: ServiceCatalogEntry): ServiceCatalogEntry;
+    upsertTenant(tenant: Tenant): Tenant;
+    upsertApp(app: App): App;
+    upsertBinding(binding: BindingRecord): BindingRecord;
+    recordImportedManifest(bindingId: string, manifest: PluginManifest): ImportedManifestRecord;
+    getCatalogEntry(serviceId: string): ServiceCatalogEntry | null;
+    getTenant(tenantId: string): Tenant | null;
+    getApp(appId: string): App | null;
+    getBinding(bindingId: string): BindingRecord | null;
+    getImportedManifest(bindingId: string): ImportedManifestRecord | null;
+    getAppsForTenant(tenantId: string): App[];
+    getBindingsForTenant(tenantId: string): BindingRecord[];
+    getSnapshot(): ControlPlaneSnapshot;
+}
+//# sourceMappingURL=store.d.ts.map

package/lib/controlPlane/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/controlPlane/store.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EAEH,aAAa,EAEb,mBAAmB,EAEnB,MAAM,EAEP,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAwB,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE1E,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6C;IAEhE,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB;IAMrE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAMpC,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG;IAMxB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa;IAMpD,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,sBAAsB;IAW3F,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAI9D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI1C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAIjC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAInD,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAIrE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,EAAE;IAIzC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAIvD,WAAW,IAAI,oBAAoB;CAS3C"}

package/lib/controlPlane/store.js

@@ -0,0 +1,70 @@
+import { AppSchema, BindingRecordSchema, ServiceCatalogEntrySchema, TenantSchema } from "../contracts/binding.js";
+import { PluginManifestSchema } from "../contracts/manifest.js";
+export class BetterPortalControlPlaneStore {
+    catalog = new Map();
+    tenants = new Map();
+    apps = new Map();
+    bindings = new Map();
+    manifests = new Map();
+    registerCatalogEntry(entry) {
+        const parsed = ServiceCatalogEntrySchema.parse(entry);
+        this.catalog.set(parsed.serviceId, parsed);
+        return parsed;
+    }
+    upsertTenant(tenant) {
+        const parsed = TenantSchema.parse(tenant);
+        this.tenants.set(parsed.id, parsed);
+        return parsed;
+    }
+    upsertApp(app) {
+        const parsed = AppSchema.parse(app);
+        this.apps.set(parsed.id, parsed);
+        return parsed;
+    }
+    upsertBinding(binding) {
+        const parsed = BindingRecordSchema.parse(binding);
+        this.bindings.set(parsed.bindingId, parsed);
+        return parsed;
+    }
+    recordImportedManifest(bindingId, manifest) {
+        const parsedManifest = PluginManifestSchema.parse(manifest);
+        const record = {
+            bindingId,
+            manifest: parsedManifest,
+            importedAtIso: new Date().toISOString()
+        };
+        this.manifests.set(bindingId, record);
+        return record;
+    }
+    getCatalogEntry(serviceId) {
+        return this.catalog.get(serviceId) ?? null;
+    }
+    getTenant(tenantId) {
+        return this.tenants.get(tenantId) ?? null;
+    }
+    getApp(appId) {
+        return this.apps.get(appId) ?? null;
+    }
+    getBinding(bindingId) {
+        return this.bindings.get(bindingId) ?? null;
+    }
+    getImportedManifest(bindingId) {
+        return this.manifests.get(bindingId) ?? null;
+    }
+    getAppsForTenant(tenantId) {
+        return [...this.apps.values()].filter((app) => app.tenantId === tenantId);
+    }
+    getBindingsForTenant(tenantId) {
+        return [...this.bindings.values()].filter((binding) => binding.tenantId === tenantId);
+    }
+    getSnapshot() {
+        return {
+            catalog: [...this.catalog.values()],
+            tenants: [...this.tenants.values()],
+            apps: [...this.apps.values()],
+            bindings: [...this.bindings.values()],
+            importedManifests: [...this.manifests.values()]
+        };
+    }
+}
+//# sourceMappingURL=store.js.map

package/lib/controlPlane/store.js.map

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

package/lib/controlPlane/sync.d.ts

@@ -0,0 +1,8 @@
+import { BindingRecord } from "../contracts/binding.js";
+import { PluginManifest } from "../contracts/manifest.js";
+import { BetterPortalControlPlaneStore } from "./store.js";
+import { ImportedManifestRecord } from "./types.js";
+export type ManifestProvider = (binding: BindingRecord) => Promise<PluginManifest>;
+export declare function importBindingManifest(store: BetterPortalControlPlaneStore, bindingId: string, provider: ManifestProvider): Promise<ImportedManifestRecord>;
+export declare function syncAllBindingManifests(store: BetterPortalControlPlaneStore, provider: ManifestProvider): Promise<ImportedManifestRecord[]>;
+//# sourceMappingURL=sync.d.ts.map

package/lib/controlPlane/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/controlPlane/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAwB,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAEnF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,6BAA6B,EACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAejC;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,6BAA6B,EACpC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CASnC"}