@vertebr/admin 0.4.0 → 0.5.1

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,46 @@
+import type { HandlerContext } from "../../schema";
+/** Dashboard KPI card returned by `metrics()`. */
+export type MetricCard = {
+    id: string;
+    label: string;
+    value: string | number;
+    hint?: string;
+    tone?: "neutral" | "ok" | "warn" | "danger";
+    /** Percent change vs the previous window (e.g. 12.5). */
+    delta?: number;
+    /** Sparkline, oldest first. */
+    series?: number[];
+    /** Section heading on the overview board. */
+    section?: string;
+    /** Promote to the top KPI row. */
+    featured?: boolean;
+};
+export type MetricChartPoint = {
+    label: string;
+    value: number;
+};
+export type MetricChart = {
+    id: string;
+    label: string;
+    /** `usd` formats the axis as currency. */
+    unit?: "usd" | "count";
+    points: MetricChartPoint[];
+    /** Previous-period overlay, aligned to `points`. */
+    comparePoints?: MetricChartPoint[];
+};
+export type MetricsPayload = {
+    metrics: MetricCard[];
+    charts?: MetricChart[];
+    /** e.g. `"Aug 2 – Aug 15 vs Jul 19 – Aug 1"`. */
+    windowLabel?: string;
+    /** e.g. `"Previous period"`. */
+    compareLabel?: string;
+};
+export type MetricsDefinition = {
+    id?: string;
+    label?: string;
+    /** Sidebar heading. Defaults to `"Analytics"`. */
+    group?: string;
+    load: (ctx: HandlerContext) => Promise<MetricCard[] | MetricsPayload> | MetricCard[] | MetricsPayload;
+};
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC5C,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;IACvB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,oDAAoD;IACpD,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CACJ,GAAG,EAAE,cAAc,KAEjB,OAAO,CAAC,UAAU,EAAE,GAAG,cAAc,CAAC,GACtC,UAAU,EAAE,GACZ,cAAc,CAAC;CACpB,CAAC"}

package/dist/runtime/types/metrics.js

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

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

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

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

@@ -0,0 +1,41 @@
+import type { FieldSchema, HandlerContext, ResourceUploadDefinition } from "../../schema";
+import type { CollectionWideAction, ResourceAction } from "./actions";
+import type { ResourceMailConfig } from "./mail";
+export type ResourcePermissions = {
+    create?: boolean;
+    update?: boolean;
+    delete?: boolean;
+};
+export type ResourceDefinition<T = unknown> = {
+    id: string;
+    label: string;
+    schema: Record<string, FieldSchema>;
+    list?: (ctx: HandlerContext) => Promise<T[]> | T[];
+    get?: (id: string, ctx: HandlerContext) => Promise<T | undefined> | T | undefined;
+    create?: (input: Partial<T>, ctx: HandlerContext) => Promise<T> | T;
+    update?: (id: string, input: Partial<T>, ctx: HandlerContext) => Promise<T> | T;
+    remove?: (id: string, ctx: HandlerContext) => Promise<void> | void;
+    actions?: Record<string, ResourceAction<T>>;
+    /**
+     * Host mail templates to expose as row actions (Email, Promo, …).
+     * Requires `admin.mail({ send, templates })`.
+     */
+    mail?: ResourceMailConfig;
+    collectionActions?: Record<string, CollectionWideAction> | ((ctx: HandlerContext) => Record<string, CollectionWideAction> | Promise<Record<string, CollectionWideAction>>);
+    /**
+     * Field-keyed upload handlers. Keys must match schema fields
+     * (typically image URL strings).
+     */
+    uploads?: Record<string, ResourceUploadDefinition>;
+    permissions?: ResourcePermissions;
+    resolvePermissions?: (ctx: HandlerContext) => ResourcePermissions | Promise<ResourcePermissions>;
+    /**
+     * When true, storefront can list this resource via
+     * `/api/public/resources/{id}` (no auth). Rows with `active: false`
+     * are omitted.
+     */
+    public?: boolean;
+    /** Sidebar heading. Defaults to `"Resources"`. */
+    group?: string;
+};
+//# sourceMappingURL=resource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,wBAAwB,EACzB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IACnD,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAClF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpE,MAAM,CAAC,EAAE,CACP,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C;;;OAGG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,iBAAiB,CAAC,EACd,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GACpC,CAAC,CACC,GAAG,EAAE,cAAc,KAEjB,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACvD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IACnD,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,kBAAkB,CAAC,EAAE,CACnB,GAAG,EAAE,cAAc,KAChB,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACxD;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/runtime/types/resource.js

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

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

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

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

@@ -0,0 +1,4 @@
+import type { AdminEnvironment, EnvironmentAuthPublic } from "../types";
+export declare function publicAuth(env: AdminEnvironment): EnvironmentAuthPublic;
+export declare function claimSatisfied(claims: Record<string, unknown> | undefined, key: string, expected: string): boolean;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/runtime/utils/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAElB,wBAAgB,UAAU,CAAC,GAAG,EAAE,gBAAgB,GAAG,qBAAqB,CAOvE;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAgBT"}

package/dist/runtime/utils/auth.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publicAuth = publicAuth;
+exports.claimSatisfied = claimSatisfied;
+function publicAuth(env) {
+    return {
+        required: Boolean(env.auth?.required),
+        ...(env.auth?.claimKey ? { claimKey: env.auth.claimKey } : {}),
+        ...(env.auth?.roles?.length ? { roles: [...env.auth.roles] } : {}),
+        ...(env.auth?.client ? { client: env.auth.client } : {}),
+    };
+}
+function claimSatisfied(claims, key, expected) {
+    const value = claims?.[key];
+    if (value == null)
+        return false;
+    if (Array.isArray(value)) {
+        return value.map(String).includes(expected);
+    }
+    if (typeof value === "string") {
+        return (value === expected ||
+            value
+                .split(",")
+                .map((part) => part.trim())
+                .includes(expected));
+    }
+    return false;
+}
+//# sourceMappingURL=auth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/runtime/utils/auth.ts"],"names":[],"mappings":";;AAKA,gCAOC;AAED,wCAoBC;AA7BD,SAAgB,UAAU,CAAC,GAAqB;IAC9C,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC;QACrC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,SAAgB,cAAc,CAC5B,MAA2C,EAC3C,GAAW,EACX,QAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CACL,KAAK,KAAK,QAAQ;YAClB,KAAK;iBACF,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;iBAC1B,QAAQ,CAAC,QAAQ,CAAC,CACtB,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { FieldSchema } from "../../schema";
+import type { ControlDefinition } from "../types";
+export declare function resolveDefaults(schema: Record<string, FieldSchema>, defaults: ControlDefinition["defaults"] | undefined, env: string): Record<string, unknown>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/runtime/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,GAAG,SAAS,EACnD,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB"}

package/dist/runtime/utils/config.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDefaults = resolveDefaults;
+function resolveDefaults(schema, defaults, env) {
+    const fromSchema = {};
+    for (const [key, field] of Object.entries(schema)) {
+        if (field.default !== undefined) {
+            fromSchema[key] = field.default;
+        }
+    }
+    const fromDef = typeof defaults === "function" ? defaults(env) : (defaults ?? {});
+    return { ...fromSchema, ...fromDef };
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/runtime/utils/config.ts"],"names":[],"mappings":";;AAGA,0CAcC;AAdD,SAAgB,eAAe,CAC7B,MAAmC,EACnC,QAAmD,EACnD,GAAW;IAEX,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;QAClC,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GACX,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACpE,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,EAAE,CAAC;AACvC,CAAC"}

package/dist/runtime/utils/http.d.ts

@@ -0,0 +1,7 @@
+type HeaderMap = Record<string, string | string[] | undefined>;
+export declare function headerValue(headers: HeaderMap | undefined, name: string): string | undefined;
+/** Flatten Hapi/Express query values to a string map. */
+export declare function requestQuery(request: unknown): Record<string, string>;
+export declare function contentTypeFor(filePath: string): string;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/runtime/utils/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/runtime/utils/http.ts"],"names":[],"mappings":"AAEA,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAE/D,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAKpB;AASD,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASrE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoBvD"}

package/dist/runtime/utils/http.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.headerValue = headerValue;
+exports.requestQuery = requestQuery;
+exports.contentTypeFor = contentTypeFor;
+const node_path_1 = __importDefault(require("node:path"));
+function headerValue(headers, name) {
+    if (!headers)
+        return undefined;
+    const raw = headers[name] ?? headers[name.toLowerCase()];
+    if (Array.isArray(raw))
+        return raw[0];
+    return typeof raw === "string" ? raw : undefined;
+}
+function queryValue(value) {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" && Number.isFinite(value))
+        return String(value);
+    if (Array.isArray(value) && value.length > 0)
+        return queryValue(value[0]);
+    return undefined;
+}
+/** Flatten Hapi/Express query values to a string map. */
+function requestQuery(request) {
+    const raw = request.query;
+    if (!raw || typeof raw !== "object")
+        return {};
+    const query = {};
+    for (const [key, value] of Object.entries(raw)) {
+        const parsed = queryValue(value);
+        if (parsed != null)
+            query[key] = parsed;
+    }
+    return query;
+}
+function contentTypeFor(filePath) {
+    const ext = node_path_1.default.extname(filePath).toLowerCase();
+    switch (ext) {
+        case ".html":
+            return "text/html; charset=utf-8";
+        case ".js":
+            return "text/javascript; charset=utf-8";
+        case ".css":
+            return "text/css; charset=utf-8";
+        case ".svg":
+            return "image/svg+xml";
+        case ".json":
+            return "application/json";
+        case ".png":
+            return "image/png";
+        case ".woff2":
+            return "font/woff2";
+        default:
+            return "application/octet-stream";
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/runtime/utils/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/runtime/utils/http.ts"],"names":[],"mappings":";;;;;AAIA,kCAQC;AAUD,oCASC;AAED,wCAoBC;AArDD,0DAA6B;AAI7B,SAAgB,WAAW,CACzB,OAA8B,EAC9B,IAAY;IAEZ,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;IACtC,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,yDAAyD;AACzD,SAAgB,YAAY,CAAC,OAAgB;IAC3C,MAAM,GAAG,GAAI,OAA+C,CAAC,KAAK,CAAC;IACnE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,MAAM,IAAI,IAAI;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,cAAc,CAAC,QAAgB;IAC7C,MAAM,GAAG,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,0BAA0B,CAAC;QACpC,KAAK,KAAK;YACR,OAAO,gCAAgC,CAAC;QAC1C,KAAK,MAAM;YACT,OAAO,yBAAyB,CAAC;QACnC,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,kBAAkB,CAAC;QAC5B,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,YAAY,CAAC;QACtB;YACE,OAAO,0BAA0B,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/runtime/utils/metricsRange.d.ts

@@ -0,0 +1,34 @@
+export declare const METRICS_RANGES: readonly [{
+    readonly id: "7d";
+    readonly label: "Last 7 days";
+}, {
+    readonly id: "14d";
+    readonly label: "Last 14 days";
+}, {
+    readonly id: "30d";
+    readonly label: "Last 30 days";
+}, {
+    readonly id: "this_month";
+    readonly label: "This month";
+}, {
+    readonly id: "last_month";
+    readonly label: "Last month";
+}];
+export type MetricsRangeId = (typeof METRICS_RANGES)[number]["id"];
+export type ResolvedMetricsRange = {
+    id: MetricsRangeId;
+    label: string;
+    currentKeys: string[];
+    /** Same length as `currentKeys`; `null` when the prior month has no matching day. */
+    previousKeys: Array<string | null>;
+    previousStartMs: number;
+    windowLabel: string;
+    compareLabel: string;
+};
+export declare function parseMetricsRange(raw: unknown): MetricsRangeId;
+export declare function utcDayKey(ms: number): string;
+export declare function keysFrom(startMs: number, count: number): string[];
+/** Same calendar day in another month, or `null` if that month is shorter. */
+export declare function correspondingDay(isoDay: string, deltaMonths: number): string | null;
+export declare function resolveMetricsRange(range: MetricsRangeId, now?: Date): ResolvedMetricsRange;
+//# sourceMappingURL=metricsRange.d.ts.map

package/dist/runtime/utils/metricsRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsRange.d.ts","sourceRoot":"","sources":["../../../src/runtime/utils/metricsRange.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAMjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAInE,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,cAAc,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qFAAqF;IACrF,YAAY,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAK9D;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAIjE;AA4BD,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAYf;AAMD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,GAAG,OAAa,GACf,oBAAoB,CAiDtB"}

package/dist/runtime/utils/metricsRange.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.METRICS_RANGES = void 0;
+exports.parseMetricsRange = parseMetricsRange;
+exports.utcDayKey = utcDayKey;
+exports.keysFrom = keysFrom;
+exports.correspondingDay = correspondingDay;
+exports.resolveMetricsRange = resolveMetricsRange;
+const DAY_MS = 86_400_000;
+exports.METRICS_RANGES = [
+    { id: "7d", label: "Last 7 days" },
+    { id: "14d", label: "Last 14 days" },
+    { id: "30d", label: "Last 30 days" },
+    { id: "this_month", label: "This month" },
+    { id: "last_month", label: "Last month" },
+];
+const RANGE_IDS = new Set(exports.METRICS_RANGES.map((item) => item.id));
+function parseMetricsRange(raw) {
+    if (typeof raw === "string" && RANGE_IDS.has(raw)) {
+        return raw;
+    }
+    return "14d";
+}
+function utcDayKey(ms) {
+    return new Date(ms).toISOString().slice(0, 10);
+}
+function keysFrom(startMs, count) {
+    return Array.from({ length: Math.max(0, count) }, (_, index) => utcDayKey(startMs + index * DAY_MS));
+}
+function utcMidnight(ms) {
+    const date = new Date(ms);
+    return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
+}
+function daysInMonth(year, monthIndex) {
+    return new Date(Date.UTC(year, monthIndex + 1, 0)).getUTCDate();
+}
+function shortDayLabel(isoDay) {
+    return new Date(`${isoDay}T00:00:00Z`).toLocaleDateString("en-US", {
+        month: "short",
+        day: "numeric",
+        timeZone: "UTC",
+    });
+}
+function shortRange(keys) {
+    const first = keys[0];
+    const last = keys[keys.length - 1];
+    if (!first || !last)
+        return "";
+    const a = shortDayLabel(first);
+    const b = shortDayLabel(last);
+    return a === b ? a : `${a} – ${b}`;
+}
+/** Same calendar day in another month, or `null` if that month is shorter. */
+function correspondingDay(isoDay, deltaMonths) {
+    const [yearRaw, monthRaw, dayRaw] = isoDay.split("-");
+    const year = Number(yearRaw);
+    const month = Number(monthRaw) - 1;
+    const day = Number(dayRaw);
+    if (!Number.isFinite(year) || !Number.isFinite(month) || !Number.isFinite(day)) {
+        return null;
+    }
+    const probe = new Date(Date.UTC(year, month + deltaMonths, 1));
+    const last = daysInMonth(probe.getUTCFullYear(), probe.getUTCMonth());
+    if (day > last)
+        return null;
+    return utcDayKey(Date.UTC(probe.getUTCFullYear(), probe.getUTCMonth(), day));
+}
+function rangeLabel(id) {
+    return exports.METRICS_RANGES.find((item) => item.id === id)?.label ?? "Last 14 days";
+}
+function resolveMetricsRange(range, now = new Date()) {
+    const label = rangeLabel(range);
+    const today = utcMidnight(now.getTime());
+    const tomorrow = today + DAY_MS;
+    let currentKeys;
+    let previousKeys;
+    let previousStartMs;
+    if (range === "7d" || range === "14d" || range === "30d") {
+        const days = range === "7d" ? 7 : range === "30d" ? 30 : 14;
+        const currentStart = tomorrow - days * DAY_MS;
+        currentKeys = keysFrom(currentStart, days);
+        previousStartMs = currentStart - days * DAY_MS;
+        previousKeys = keysFrom(previousStartMs, days);
+    }
+    else if (range === "this_month") {
+        const year = now.getUTCFullYear();
+        const month = now.getUTCMonth();
+        const day = now.getUTCDate();
+        const currentStart = Date.UTC(year, month, 1);
+        currentKeys = keysFrom(currentStart, day);
+        previousKeys = currentKeys.map((key) => correspondingDay(key, -1));
+        const firstPrev = previousKeys.find((key) => key != null);
+        previousStartMs = firstPrev
+            ? Date.parse(`${firstPrev}T00:00:00Z`)
+            : currentStart - day * DAY_MS;
+    }
+    else {
+        const year = now.getUTCFullYear();
+        const month = now.getUTCMonth();
+        const currentStart = Date.UTC(year, month - 1, 1);
+        const start = new Date(currentStart);
+        const count = daysInMonth(start.getUTCFullYear(), start.getUTCMonth());
+        currentKeys = keysFrom(currentStart, count);
+        previousKeys = currentKeys.map((key) => correspondingDay(key, -1));
+        const firstPrev = previousKeys.find((key) => key != null);
+        previousStartMs = firstPrev
+            ? Date.parse(`${firstPrev}T00:00:00Z`)
+            : Date.UTC(year, month - 2, 1);
+    }
+    const previousLabelKeys = previousKeys.filter((key) => key != null);
+    return {
+        id: range,
+        label,
+        currentKeys,
+        previousKeys,
+        previousStartMs,
+        windowLabel: `${shortRange(currentKeys)} vs ${shortRange(previousLabelKeys)}`,
+        compareLabel: "Previous period",
+    };
+}
+//# sourceMappingURL=metricsRange.js.map

package/dist/runtime/utils/metricsRange.js.map

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

package/dist/runtime/utils/sidebar.d.ts

@@ -0,0 +1,2 @@
+export declare function sidebarGroup(value: string | undefined, fallback: string): string;
+//# sourceMappingURL=sidebar.d.ts.map

package/dist/runtime/utils/sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../../src/runtime/utils/sidebar.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR"}

package/dist/runtime/utils/sidebar.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sidebarGroup = sidebarGroup;
+function sidebarGroup(value, fallback) {
+    const trimmed = value?.trim();
+    return trimmed || fallback;
+}
+//# sourceMappingURL=sidebar.js.map