@vertebr/admin 0.4.0 → 0.5.1

package/dist/runtime/services/environment.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveEnv = resolveEnv;
+exports.assertAuth = assertAuth;
+exports.withEnvContext = withEnvContext;
+exports.withPublicEnvContext = withPublicEnvContext;
+const constants_1 = require("../constants");
+const errors_1 = require("../errors");
+const auth_1 = require("../utils/auth");
+const http_1 = require("../utils/http");
+function resolveEnv(state, request) {
+    const headers = request.headers;
+    const header = (0, http_1.headerValue)(headers, constants_1.VERTEBR_ENV_HEADER);
+    const env = (header ?? state.defaultEnvironment).trim();
+    if (!state.environments.some((item) => item.id === env)) {
+        throw new errors_1.VertebrEnvError(`Unknown environment "${env}". Expected one of: ${state.environments
+            .map((item) => item.id)
+            .join(", ")}`);
+    }
+    return env;
+}
+async function assertAuth(state, request, envId) {
+    const environment = state.environments.find((item) => item.id === envId);
+    if (!environment) {
+        throw new errors_1.VertebrEnvError(`Unknown environment "${envId}"`);
+    }
+    const user = state.options.auth.getUser
+        ? await state.options.auth.getUser(request)
+        : null;
+    const envAuth = environment.auth;
+    if (envAuth?.required) {
+        if (!user) {
+            throw new errors_1.VertebrAuthError("Sign in required for this environment");
+        }
+        if (envAuth.claimKey) {
+            const expected = envAuth.claimIncludes ?? environment.id;
+            if (!(0, auth_1.claimSatisfied)(user.claims, envAuth.claimKey, expected)) {
+                throw new errors_1.VertebrAuthError(`Missing claim ${envAuth.claimKey}=${expected} for environment "${environment.id}"`);
+            }
+        }
+        if (envAuth.roles?.length) {
+            const roles = user.roles ?? [];
+            const ok = envAuth.roles.some((role) => roles.includes(role));
+            if (!ok) {
+                throw new errors_1.VertebrAuthError(`Requires one of roles: ${envAuth.roles.join(", ")}`);
+            }
+        }
+    }
+    const allowed = await state.options.auth.check(request, {
+        env: envId,
+        user,
+        environment,
+    });
+    if (!allowed) {
+        throw new errors_1.VertebrAuthError();
+    }
+}
+async function withEnvContext(state, request, run) {
+    const env = resolveEnv(state, request);
+    await assertAuth(state, request, env);
+    const ctx = { env, request, query: (0, http_1.requestQuery)(request) };
+    const execute = () => Promise.resolve(run(ctx));
+    if (state.options.onEnvironment) {
+        return state.options.onEnvironment(env, execute);
+    }
+    return execute();
+}
+/** Public storefront reads — resolve env, no auth. */
+async function withPublicEnvContext(state, request, run) {
+    const env = resolveEnv(state, request);
+    const ctx = { env, request, query: (0, http_1.requestQuery)(request) };
+    const execute = () => Promise.resolve(run(ctx));
+    if (state.options.onEnvironment) {
+        return state.options.onEnvironment(env, execute);
+    }
+    return execute();
+}
+//# sourceMappingURL=environment.js.map

package/dist/runtime/services/environment.js.map

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

package/dist/runtime/services/registry.d.ts

@@ -0,0 +1,6 @@
+import type { ConfigDefinition, ResourceDefinition } from "../types";
+import type { AdminState } from "./state";
+export declare function findResource(state: AdminState, id: string): ResourceDefinition;
+export declare function findConfig(state: AdminState, id: string): ConfigDefinition;
+export declare function readConfigValue(state: AdminState, id: string, env: string): Promise<Record<string, unknown>>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/runtime/services/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/runtime/services/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,MAAM,GACT,kBAAkB,CAMpB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAM1E;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAWlC"}

package/dist/runtime/services/registry.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findResource = findResource;
+exports.findConfig = findConfig;
+exports.readConfigValue = readConfigValue;
+const store_1 = require("../../store");
+const errors_1 = require("../errors");
+const config_1 = require("../utils/config");
+function findResource(state, id) {
+    const resource = state.resources.find((item) => item.id === id);
+    if (!resource) {
+        throw new errors_1.VertebrNotFoundError(`Resource "${id}" not found`);
+    }
+    return resource;
+}
+function findConfig(state, id) {
+    const config = state.configs.find((item) => item.id === id);
+    if (!config) {
+        throw new errors_1.VertebrNotFoundError(`Config "${id}" not found`);
+    }
+    return config;
+}
+async function readConfigValue(state, id, env) {
+    const meta = state.controlMeta.get(id);
+    if (meta) {
+        const stored = await meta.store.get(id, env);
+        return (0, store_1.mergeConfigValue)((0, config_1.resolveDefaults)(meta.schema, meta.defaults, env), stored);
+    }
+    const config = findConfig(state, id);
+    return config.get({ env, request: null });
+}
+//# sourceMappingURL=registry.js.map

package/dist/runtime/services/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/runtime/services/registry.ts"],"names":[],"mappings":";;AAMA,oCASC;AAED,gCAMC;AAED,0CAeC;AAxCD,uCAA+C;AAC/C,sCAAiD;AAEjD,4CAAkD;AAGlD,SAAgB,YAAY,CAC1B,KAAiB,EACjB,EAAU;IAEV,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,6BAAoB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,UAAU,CAAC,KAAiB,EAAE,EAAU;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,6BAAoB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAEM,KAAK,UAAU,eAAe,CACnC,KAAiB,EACjB,EAAU,EACV,GAAW;IAEX,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvC,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC7C,OAAO,IAAA,wBAAgB,EACrB,IAAA,wBAAe,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,EAChD,MAAM,CACP,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/runtime/services/state.d.ts

@@ -0,0 +1,25 @@
+import type { ConfigStore } from "../../store";
+import type { FieldSchema, GalleryDefinition } from "../../schema";
+import type { AdminEnvironment, ConfigDefinition, ControlDefinition, CreateAdminOptions, MetricsDefinition, ResourceDefinition, MailDefinition } from "../types";
+export type ControlMeta = {
+    public: boolean;
+    store: ConfigStore;
+    defaults?: ControlDefinition["defaults"];
+    schema: Record<string, FieldSchema>;
+};
+/** Mutable registry used by handlers after `createAdmin()`. */
+export type AdminState = {
+    options: CreateAdminOptions;
+    basePath: string;
+    apiBase: string;
+    resources: ResourceDefinition[];
+    configs: ConfigDefinition[];
+    environments: AdminEnvironment[];
+    defaultEnvironment: string;
+    staticDir: string | undefined;
+    controlMeta: Map<string, ControlMeta>;
+    metricsDef: MetricsDefinition | null;
+    galleryDef: GalleryDefinition | null;
+    mailDef: MailDefinition | null;
+};
+//# sourceMappingURL=state.d.ts.map

package/dist/runtime/services/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/runtime/services/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACf,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;CAChC,CAAC"}

package/dist/runtime/services/state.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=state.js.map

package/dist/runtime/services/state.js.map

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

package/dist/runtime/types/actions.d.ts

@@ -0,0 +1,15 @@
+import type { FieldSchema, FieldType, HandlerContext } from "../../schema";
+/** Action form field — plain type or full schema (enums, labels, …). */
+export type ActionInputField = FieldType | FieldSchema;
+export type ResourceAction<T = unknown> = {
+    label: string;
+    input?: Record<string, ActionInputField>;
+    run: (row: T, input: Record<string, unknown> | undefined, ctx: HandlerContext) => Promise<unknown> | unknown;
+};
+/** Resource-level action (no row) — e.g. seed test data. */
+export type CollectionWideAction = {
+    label: string;
+    input?: Record<string, ActionInputField>;
+    run: (input: Record<string, unknown> | undefined, ctx: HandlerContext) => Promise<unknown> | unknown;
+};
+//# sourceMappingURL=actions.d.ts.map

package/dist/runtime/types/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3E,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,CAAC;AAEvD,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACzC,GAAG,EAAE,CACH,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACzC,GAAG,EAAE,CACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC,CAAC"}

package/dist/runtime/types/actions.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=actions.js.map

package/dist/runtime/types/actions.js.map

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

package/dist/runtime/types/admin.d.ts

@@ -0,0 +1,83 @@
+import type { GalleryDefinition } from "../../schema";
+import type { AdminAuth, AdminEnvironment } from "./auth";
+import type { ConfigDefinition, ControlDefinition, PageDefinition } from "./config";
+import type { LayoutDefinition } from "./layout";
+import type { MailDefinition } from "./mail";
+import type { MetricsDefinition } from "./metrics";
+import type { ResourceDefinition } from "./resource";
+export type Connector = {
+    id: string;
+    register: (admin: Admin) => void;
+};
+export type CreateAdminOptions = {
+    auth: AdminAuth;
+    basePath?: string;
+    /** Directory of built dashboard SPA (index.html + assets). */
+    staticDir?: string;
+    /**
+     * Environments the owner can switch between.
+     * Omit or pass one entry for single-env apps.
+     */
+    environments?: AdminEnvironment[];
+    /** Fallback when the client sends no env header. */
+    defaultEnvironment?: string;
+    /**
+     * Run resource/config handlers inside host env scope
+     * (Firestore ALS, tenant context, etc.).
+     */
+    onEnvironment?: <T>(env: string, run: () => Promise<T> | T) => Promise<T> | T;
+};
+export type Admin = {
+    resource: <T = unknown>(def: ResourceDefinition<T>) => Admin;
+    config: (def: ConfigDefinition) => Admin;
+    /**
+     * Register a store-backed control (dashboard form + optional public read).
+     * Prefer this over raw `config()` for site flags and copy.
+     */
+    control: (def: ControlDefinition) => Admin;
+    /**
+     * Register page-specific content (appears under Pages in the sidebar).
+     * Equivalent to `control({ ...def, section: "page" })`.
+     */
+    page: (def: PageDefinition) => Admin;
+    /**
+     * Register an owner-reorderable layout (preset + ordered blocks).
+     * Appears under Pages by default; expose with `public: true` for the storefront.
+     */
+    layout: (def: LayoutDefinition) => Admin;
+    /** Register the overview metrics board. */
+    metrics: (def: MetricsDefinition) => Admin;
+    /**
+     * Register a media gallery (sidebar under Resources).
+     * Host lists/uploads/deletes assets; Vertebr renders the UI.
+     */
+    gallery: (def: GalleryDefinition) => Admin;
+    /**
+     * Register host outbound mail. Resources opt in with
+     * `mail: ["sendEmail", "sendPromo"]` (or a binding object).
+     */
+    mail: (def: MailDefinition) => Admin;
+    /** Server-side read of a registered config/control (auth not applied). */
+    readConfig: (id: string, env: string) => Promise<Record<string, unknown>>;
+    use: (connector: Connector) => Admin;
+    routes: () => AdminRoute[];
+    hapiRoutes: () => HapiCompatibleRoute[];
+    resources: () => ResourceDefinition[];
+    configs: () => ConfigDefinition[];
+    environments: () => AdminEnvironment[];
+};
+export type AdminRoute = {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    handler: (request: unknown) => Promise<unknown> | unknown;
+};
+export type HapiCompatibleRoute = {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    options?: {
+        auth?: false | string;
+        [key: string]: any;
+    };
+    handler: (request: unknown, h: unknown) => Promise<unknown> | unknown;
+};
+//# sourceMappingURL=admin.d.ts.map

package/dist/runtime/types/admin.d.ts.map

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

package/dist/runtime/types/admin.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=admin.js.map

package/dist/runtime/types/admin.js.map

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

package/dist/runtime/types/auth.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Per-environment auth — adjusted by the host app developer.
+ * Vertebr enforces these after resolving the user via `auth.getUser`.
+ */
+export type EnvironmentAuthConfig = {
+    /** Require a signed-in user for this environment. @default false */
+    required?: boolean;
+    /**
+     * Custom claim key (e.g. `allowedEnvs`).
+     * Array/string claims must include `claimIncludes` (defaults to env id).
+     */
+    claimKey?: string;
+    /** Value required in the claim. Defaults to this environment's id. */
+    claimIncludes?: string;
+    /** If set, user.roles must include at least one of these. */
+    roles?: string[];
+    /**
+     * Public browser auth configuration. Safe Firebase web config only;
+     * never put service-account credentials or secrets here.
+     */
+    client?: {
+        provider: "firebase";
+        config: {
+            apiKey: string;
+            authDomain: string;
+            projectId: string;
+            appId: string;
+            messagingSenderId?: string;
+        };
+        methods?: Array<"email" | "google">;
+    };
+};
+export type AdminEnvironment = {
+    id: string;
+    label: string;
+    /** Optional UI hint — e.g. production = danger. */
+    tone?: "neutral" | "warn" | "danger";
+    /** Auth rules for this environment (developer-configurable). */
+    auth?: EnvironmentAuthConfig;
+};
+/** Public auth summary returned to the dashboard (no secrets). */
+export type EnvironmentAuthPublic = {
+    required: boolean;
+    claimKey?: string;
+    roles?: string[];
+    client?: EnvironmentAuthConfig["client"];
+};
+export type VertebrUser = {
+    uid: string;
+    claims?: Record<string, unknown>;
+    roles?: string[];
+};
+export type AuthContext = {
+    env: string;
+    user: VertebrUser | null;
+    environment: AdminEnvironment;
+};
+export type AdminAuth = {
+    /** Resolve the current user (Firebase token, session, etc.). */
+    getUser?: (request: unknown) => Promise<VertebrUser | null> | VertebrUser | null;
+    /**
+     * Global gate after per-env auth rules.
+     * Return false to deny even when env auth passed.
+     */
+    check: (request: unknown, ctx: AuthContext) => Promise<boolean> | boolean;
+};
+//# sourceMappingURL=auth.d.ts.map

package/dist/runtime/types/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,UAAU,CAAC;QACrB,MAAM,EAAE;YACN,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;QACF,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;KACrC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrC,gEAAgE;IAChE,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,gEAAgE;IAChE,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC;IACtD;;;OAGG;IACH,KAAK,EAAE,CACL,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,WAAW,KACb,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC,CAAC"}

package/dist/runtime/types/auth.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=auth.js.map

package/dist/runtime/types/auth.js.map

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

package/dist/runtime/types/config.d.ts

@@ -0,0 +1,39 @@
+import type { ConfigStore } from "../../store";
+import type { FieldSchema, HandlerContext } from "../../schema";
+/** Sidebar group for configs / controls in the dashboard. */
+export type ConfigSection = "config" | "page";
+export type ConfigDefinition = {
+    id: string;
+    label: string;
+    schema: Record<string, FieldSchema>;
+    /** Sidebar group — use `"page"` for page-specific content. @default "config" */
+    section?: ConfigSection;
+    /** Sidebar heading. Defaults to `"Config"` or `"Pages"` from `section`. */
+    group?: string;
+    get: (ctx: HandlerContext) => Promise<Record<string, unknown>> | Record<string, unknown>;
+    set: (value: Record<string, unknown>, ctx: HandlerContext) => Promise<void> | void;
+};
+/**
+ * High-level control registration — store-backed config with optional
+ * public storefront read.
+ */
+export type ControlDefinition = {
+    id: string;
+    label: string;
+    schema: Record<string, FieldSchema>;
+    store: ConfigStore;
+    /** Sidebar group — use `"page"` for page-specific content. @default "config" */
+    section?: ConfigSection;
+    /** Sidebar heading. Defaults to `"Config"` or `"Pages"` from `section`. */
+    group?: string;
+    /** When true, exposed via `/api/public/controls` (no auth). */
+    public?: boolean;
+    /**
+     * Defaults merged under stored values.
+     * Schema `default` values are applied first, then this.
+     */
+    defaults?: Record<string, unknown> | ((env: string) => Record<string, unknown>);
+};
+/** Store-backed page content — same as `control()` with `section: "page"`. */
+export type PageDefinition = Omit<ControlDefinition, "section">;
+//# sourceMappingURL=config.d.ts.map

package/dist/runtime/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEhE,6DAA6D;AAC7D,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,gFAAgF;IAChF,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzF,GAAG,EAAE,CACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,KAAK,EAAE,WAAW,CAAC;IACnB,gFAAgF;IAChF,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EACL,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC"}

package/dist/runtime/types/config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/runtime/types/config.js.map

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

package/dist/runtime/types/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Public admin type surface — split by domain under `./types/`.
+ * Prefer importing from `@vertebr/admin` or `./types`.
+ */
+export type { ActionInputField, CollectionWideAction, ResourceAction, } from "./actions";
+export type { MailComposeResult, MailMessage, MailSendReceipt, MailSendResult, MailSentHandler, MailTemplate, } from "./mail/message";
+export type { MailCampaign, MailCampaignAudience, MailCampaignScheduleInput, MailCampaignStatus, MailDiscountOption, MailHistoryEntry, MailHistoryRecordInput, MailLibraryTemplate, MailProductOption, } from "./mail/catalog";
+export type { MailDefinition, ResourceMailBinding, ResourceMailConfig, } from "./mail/definition";
+export type { ResourceDefinition, ResourcePermissions, } from "./resource";
+export type { ConfigDefinition, ConfigSection, ControlDefinition, PageDefinition, } from "./config";
+export type { LayoutDefinition, LayoutPreset, LayoutSlot, } from "./layout";
+export type { MetricCard, MetricChart, MetricChartPoint, MetricsDefinition, MetricsPayload, } from "./metrics";
+export type { AdminAuth, AdminEnvironment, AuthContext, EnvironmentAuthConfig, EnvironmentAuthPublic, VertebrUser, } from "./auth";
+export type { Admin, AdminRoute, Connector, CreateAdminOptions, HapiCompatibleRoute, } from "./admin";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,GACf,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,UAAU,GACX,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,GACZ,MAAM,QAAQ,CAAC;AAEhB,YAAY,EACV,KAAK,EACL,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/dist/runtime/types/index.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Public admin type surface — split by domain under `./types/`.
+ * Prefer importing from `@vertebr/admin` or `./types`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/runtime/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/types/index.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/runtime/types/layout.d.ts

@@ -0,0 +1,29 @@
+import type { ConfigStore } from "../../store";
+import type { ConfigSection } from "./config";
+/** Named slot in a host-rendered page layout. */
+export type LayoutSlot = {
+    id: string;
+    label: string;
+};
+export type LayoutPreset = {
+    id: string;
+    label: string;
+};
+/**
+ * Owner-reorderable page layout. Vertebr stores the recipe; the host
+ * still owns CSS and rendering.
+ */
+export type LayoutDefinition = {
+    id: string;
+    label: string;
+    slots: LayoutSlot[];
+    /** @default slot ids in declaration order */
+    defaultOrder?: string[];
+    presets?: LayoutPreset[];
+    store: ConfigStore;
+    public?: boolean;
+    section?: ConfigSection;
+    /** Sidebar heading. Defaults to `"Pages"`. */
+    group?: string;
+};
+//# sourceMappingURL=layout.d.ts.map

package/dist/runtime/types/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/runtime/types/layout.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=layout.js.map

package/dist/runtime/types/layout.js.map

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

package/dist/runtime/types/mail/catalog.d.ts

@@ -0,0 +1,104 @@
+/** Scheduled / campaign send tracked on the Emails board. */
+export type MailCampaignStatus = "scheduled" | "sending" | "sent" | "cancelled" | "failed";
+export type MailCampaignAudience = {
+    mode: "all";
+} | {
+    mode: "ids";
+    rowIds: string[];
+} | {
+    mode: "emails";
+    emails: string[];
+};
+export type MailCampaign = {
+    id: string;
+    resourceId: string;
+    resourceLabel?: string;
+    templateId: string;
+    templateLabel?: string;
+    audience: MailCampaignAudience;
+    recipientCount?: number;
+    /** ISO timestamp — when to send. */
+    sendAt: string;
+    status: MailCampaignStatus;
+    createdAt?: string;
+    subject?: string;
+    error?: string;
+};
+export type MailCampaignScheduleInput = {
+    resourceId: string;
+    templateId: string;
+    input?: Record<string, unknown>;
+    audience: MailCampaignAudience;
+    sendAt: string;
+    /** Optional subject snapshot for the board list. */
+    subject?: string;
+};
+/** One outbound send logged on the Emails board. */
+export type MailHistoryEntry = {
+    id: string;
+    at: string;
+    resourceId: string;
+    resourceLabel?: string;
+    templateId: string;
+    templateLabel?: string;
+    subject?: string;
+    recipientCount: number;
+    sent: number;
+    failed?: number;
+    status: "sent" | "partial" | "failed" | "scheduled";
+    source: "board" | "row" | "campaign";
+    campaignId?: string;
+    productIds?: string[];
+    /** Sample of recipient emails (capped). */
+    recipients?: string[];
+    /** Compose preset id when present. */
+    preset?: string;
+    discountCode?: string;
+    discountOffer?: string;
+    /** Order / confirmation reference when present (e.g. `MM-PENDING`). */
+    reference?: string;
+};
+export type MailHistoryRecordInput = Omit<MailHistoryEntry, "id"> & {
+    id?: string;
+};
+/** Owner-saved copy of a system preset (or freeform). */
+export type MailLibraryTemplate = {
+    id: string;
+    label: string;
+    /** System preset this was duplicated from. */
+    fromPreset?: string;
+    subject: string;
+    body: string;
+    productIds?: string[];
+    /** Stripe coupon / promotion code id when discounts are wired. */
+    discountId?: string;
+    discountCode?: string;
+    discountOffer?: string;
+    discountExpires?: string;
+    kind?: "account" | "promo" | "discount" | "order";
+    /** Order confirmation extras (`kind: "order"`). */
+    eyebrow?: string;
+    headline?: string;
+    confirmationLabel?: string;
+    shippingNote?: string;
+    footer?: string;
+    signOff?: string;
+    createdAt?: string;
+    updatedAt?: string;
+};
+export type MailProductOption = {
+    id: string;
+    label: string;
+    imageUrl?: string;
+    priceLabel?: string;
+};
+/** Coupon / promo option for discount emails (e.g. Stripe). */
+export type MailDiscountOption = {
+    id: string;
+    label: string;
+    code?: string;
+    /** e.g. "20% off" or "$10 off" */
+    offerLabel?: string;
+    expiresLabel?: string;
+};
+//# sourceMappingURL=catalog.d.ts.map

package/dist/runtime/types/mail/catalog.d.ts.map

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

package/dist/runtime/types/mail/catalog.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=catalog.js.map