@vertebr/admin 0.4.0 → 0.5.0

package/dist/types/actions.js

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

package/dist/types/actions.js.map

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

package/dist/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/types/admin.d.ts.map

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

package/dist/types/admin.js

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

package/dist/types/admin.js.map

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

package/dist/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/types/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/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/types/auth.js

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

package/dist/types/auth.js.map

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

package/dist/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/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE7D,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/types/config.js

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

package/dist/types/config.js.map

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

package/dist/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/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/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/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/types/index.js.map

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

package/dist/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/types/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/types/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,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/types/layout.js

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

package/dist/types/layout.js.map

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

package/dist/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/types/mail/catalog.d.ts.map

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

package/dist/types/mail/catalog.js

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

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

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

package/dist/types/mail/definition.d.ts

@@ -0,0 +1,68 @@
+import type { HandlerContext } from "../../schema";
+import type { MailCampaign, MailCampaignScheduleInput, MailDiscountOption, MailHistoryEntry, MailHistoryRecordInput, MailLibraryTemplate, MailProductOption } from "./catalog";
+import type { MailMessage, MailSendReceipt, MailSentHandler, MailTemplate } from "./message";
+/**
+ * Host-owned outbound mail. Vertebr turns templates into row actions
+ * on resources that opt in via `mail`, and exposes an Emails board when
+ * `label` / campaigns are configured.
+ *
+ * @example
+ * vertebrAdmin.mail({
+ *   label: "Emails",
+ *   group: "Growth",
+ *   send: (message) => enqueueEmail(message),
+ *   templates: {
+ *     sendEmail: {
+ *       label: "Email",
+ *       input: { subject: "string", body: "string" },
+ *       compose: (_row, input) => branded(input),
+ *     },
+ *   },
+ * });
+ */
+export type MailDefinition = {
+    /** Sidebar label for the Emails board. @default `"Emails"` */
+    label?: string;
+    /** Sidebar group. @default `"Growth"` */
+    group?: string;
+    send: (message: MailMessage, ctx: HandlerContext) => Promise<MailSendReceipt | void> | MailSendReceipt | void;
+    /** Row field used when compose omits `to`. @default `"email"` */
+    toField?: string;
+    prepare?: (message: MailMessage, ctx: HandlerContext) => MailMessage | Promise<MailMessage>;
+    templates: Record<string, MailTemplate>;
+    /**
+     * Optional host-backed schedule store. Without this, the Emails board
+     * can still send now (bulk / single) but cannot schedule drops.
+     */
+    campaigns?: {
+        list: (ctx: HandlerContext) => Promise<MailCampaign[]>;
+        schedule: (input: MailCampaignScheduleInput, ctx: HandlerContext) => Promise<MailCampaign>;
+        cancel?: (id: string, ctx: HandlerContext) => Promise<void>;
+    };
+    /** Optional send log for the Emails board Activity tab. */
+    history?: {
+        list: (ctx: HandlerContext) => Promise<MailHistoryEntry[]>;
+        record: (entry: MailHistoryRecordInput, ctx: HandlerContext) => Promise<MailHistoryEntry>;
+    };
+    /** Optional saved template copies (duplicate / edit). */
+    library?: {
+        list: (ctx: HandlerContext) => Promise<MailLibraryTemplate[]>;
+        save: (template: MailLibraryTemplate, ctx: HandlerContext) => Promise<MailLibraryTemplate>;
+        remove?: (id: string, ctx: HandlerContext) => Promise<void>;
+    };
+    /** Optional catalog products for compose (drop / promo emails). */
+    products?: (ctx: HandlerContext) => Promise<MailProductOption[]> | MailProductOption[];
+    /**
+     * Optional discount / coupon options for compose (Stripe promotion codes).
+     * Until wired, hosts can leave this empty and accept manual code fields.
+     */
+    discounts?: (ctx: HandlerContext) => Promise<MailDiscountOption[]> | MailDiscountOption[];
+};
+export type ResourceMailBinding = {
+    templates: string[];
+    toField?: string;
+    onSent?: MailSentHandler;
+};
+/** Opt a resource into host mail templates. */
+export type ResourceMailConfig = string[] | ResourceMailBinding;
+//# sourceMappingURL=definition.d.ts.map

package/dist/types/mail/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/types/mail/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,YAAY,EACb,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CACJ,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,eAAe,GAAG,IAAI,CAAC;IAC9D,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,cAAc,KAChB,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE;QACV,IAAI,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACvD,QAAQ,EAAE,CACR,KAAK,EAAE,yBAAyB,EAChC,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,YAAY,CAAC,CAAC;QAC3B,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7D,CAAC;IACF,2DAA2D;IAC3D,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,CACN,KAAK,EAAE,sBAAsB,EAC7B,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,gBAAgB,CAAC,CAAC;KAChC,CAAC;IACF,yDAAyD;IACzD,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAC9D,IAAI,EAAE,CACJ,QAAQ,EAAE,mBAAmB,EAC7B,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7D,CAAC;IACF,mEAAmE;IACnE,QAAQ,CAAC,EAAE,CACT,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,iBAAiB,EAAE,CAAC,GAAG,iBAAiB,EAAE,CAAC;IACxD;;;OAGG;IACH,SAAS,CAAC,EAAE,CACV,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG,MAAM,EAAE,GAAG,mBAAmB,CAAC"}

package/dist/types/mail/definition.js

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

package/dist/types/mail/definition.js.map

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

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

@@ -0,0 +1,4 @@
+export type { MailComposeResult, MailMessage, MailSendReceipt, MailSendResult, MailSentHandler, MailTemplate, } from "./message";
+export type { MailCampaign, MailCampaignAudience, MailCampaignScheduleInput, MailCampaignStatus, MailDiscountOption, MailHistoryEntry, MailHistoryRecordInput, MailLibraryTemplate, MailProductOption, } from "./catalog";
+export type { MailDefinition, ResourceMailBinding, ResourceMailConfig, } from "./definition";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/mail/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/types/mail/index.js

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

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

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

package/dist/types/mail/message.d.ts

@@ -0,0 +1,45 @@
+import type { HandlerContext } from "../../schema";
+import type { ActionInputField } from "../actions";
+/** Outbound message the host `mail().send` handler receives. */
+export type MailMessage = {
+    to: string | string[];
+    subject: string;
+    text?: string;
+    html?: string;
+    replyTo?: string;
+    template?: string;
+    templateData?: Record<string, unknown>;
+};
+/** Compose may omit `to` — Vertebr fills it from the row's email field. */
+export type MailComposeResult = Omit<MailMessage, "to"> & {
+    to?: string | string[];
+};
+export type MailSendResult = {
+    template: string;
+    id?: string;
+    message: MailMessage;
+    /** Host-provided reference after send (e.g. order confirmation). */
+    reference?: string;
+};
+/** Optional fields `mail.send` may return after delivery. */
+export type MailSendReceipt = {
+    id?: string;
+    /** Final subject if the host rewrote it (tokens, confirmations, …). */
+    subject?: string;
+    /** Durable reference to store on history (confirmation number, …). */
+    reference?: string;
+};
+export type MailSentHandler = (row: Record<string, unknown>, result: MailSendResult, ctx: HandlerContext) => Promise<unknown> | unknown;
+export type MailTemplate = {
+    label: string;
+    /**
+     * Include on the Emails board for bulk / schedule.
+     * Row actions still appear when a resource opts in.
+     * @default true
+     */
+    bulk?: boolean;
+    /** Form fields — use FieldSchema for enums / labels / optional copy. */
+    input?: Record<string, ActionInputField>;
+    compose: (row: Record<string, unknown>, input: Record<string, unknown> | undefined, ctx: HandlerContext) => MailComposeResult | Promise<MailComposeResult>;
+};
+//# sourceMappingURL=message.d.ts.map

package/dist/types/mail/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/types/mail/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG;IACxD,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,WAAW,CAAC;IACrB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEhC,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACzC,OAAO,EAAE,CACP,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,GAAG,EAAE,cAAc,KAChB,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACrD,CAAC"}

package/dist/types/mail/message.js

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

package/dist/types/mail/message.js.map

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