@vertebr/admin 0.3.0 → 0.5.0

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

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

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

package/dist/types/metrics.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/types/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,wBAAwB,EACzB,MAAM,WAAW,CAAC;AACnB,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/types/resource.js

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

package/dist/types/resource.js.map

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

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

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

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

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

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

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

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

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

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

package/dist/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/utils/sidebar.d.ts.map

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

package/dist/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

package/dist/utils/sidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.js","sourceRoot":"","sources":["../../src/utils/sidebar.ts"],"names":[],"mappings":";;AAAA,oCAMC;AAND,SAAgB,YAAY,CAC1B,KAAyB,EACzB,QAAgB;IAEhB,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,OAAO,OAAO,IAAI,QAAQ,CAAC;AAC7B,CAAC"}

package/dist/utils/staticDir.d.ts

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

package/dist/utils/staticDir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticDir.d.ts","sourceRoot":"","sources":["../../src/utils/staticDir.ts"],"names":[],"mappings":"AAGA,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAMrD"}

package/dist/utils/staticDir.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultStaticDir = defaultStaticDir;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+function defaultStaticDir() {
+    const candidate = node_path_1.default.join(__dirname, "..", "..", "static");
+    if (node_fs_1.default.existsSync(node_path_1.default.join(candidate, "index.html"))) {
+        return candidate;
+    }
+    return undefined;
+}
+//# sourceMappingURL=staticDir.js.map

package/dist/utils/staticDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticDir.js","sourceRoot":"","sources":["../../src/utils/staticDir.ts"],"names":[],"mappings":";;;;;AAGA,4CAMC;AATD,sDAAyB;AACzB,0DAA6B;AAE7B,SAAgB,gBAAgB;IAC9B,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7D,IAAI,iBAAE,CAAC,UAAU,CAAC,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/uploads.d.ts

@@ -0,0 +1,6 @@
+import type { ResourceUploadFile, ResourceUploadMeta } from "../schema";
+import type { ResourceDefinition } from "../types";
+export declare function publicUploads(resource: ResourceDefinition): Record<string, ResourceUploadMeta> | undefined;
+export declare function mimeAllowed(type: string, accept: string[]): boolean;
+export declare function decodeUploadPayload(entry: unknown): ResourceUploadFile;
+//# sourceMappingURL=uploads.d.ts.map

package/dist/utils/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["../../src/utils/uploads.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,kBAAkB,GAC3B,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,SAAS,CAahD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAWnE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CA4BtE"}

package/dist/utils/uploads.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publicUploads = publicUploads;
+exports.mimeAllowed = mimeAllowed;
+exports.decodeUploadPayload = decodeUploadPayload;
+const constants_1 = require("../constants");
+const errors_1 = require("../errors");
+function publicUploads(resource) {
+    if (!resource.uploads)
+        return undefined;
+    const entries = Object.entries(resource.uploads).map(([field, def]) => [
+        field,
+        {
+            field,
+            accept: def.accept?.length ? def.accept : constants_1.DEFAULT_UPLOAD_ACCEPT,
+            maxBytes: def.maxBytes ?? constants_1.DEFAULT_UPLOAD_MAX_BYTES,
+        },
+    ]);
+    return entries.length > 0
+        ? Object.fromEntries(entries)
+        : undefined;
+}
+function mimeAllowed(type, accept) {
+    if (accept.length === 0)
+        return true;
+    const normalized = type.toLowerCase() || "application/octet-stream";
+    return accept.some((rule) => {
+        const pattern = rule.toLowerCase().trim();
+        if (!pattern || pattern === "*/*")
+            return true;
+        if (pattern.endsWith("/*")) {
+            return normalized.startsWith(pattern.slice(0, -1));
+        }
+        return normalized === pattern;
+    });
+}
+function decodeUploadPayload(entry) {
+    if (!entry || typeof entry !== "object") {
+        throw new errors_1.VertebrBadRequestError("Invalid upload payload");
+    }
+    const body = entry;
+    const name = typeof body.name === "string" ? body.name.trim() : "";
+    const type = typeof body.type === "string" && body.type.trim()
+        ? body.type.trim()
+        : "application/octet-stream";
+    const data = typeof body.data === "string" ? body.data : "";
+    if (!name) {
+        throw new errors_1.VertebrBadRequestError("Upload is missing a file name");
+    }
+    if (!data) {
+        throw new errors_1.VertebrBadRequestError("Upload is missing file data");
+    }
+    const base64 = data.includes(",") ? data.slice(data.indexOf(",") + 1) : data;
+    let buffer;
+    try {
+        buffer = Buffer.from(base64, "base64");
+    }
+    catch {
+        throw new errors_1.VertebrBadRequestError("Upload data is not valid base64");
+    }
+    if (!buffer.length) {
+        throw new errors_1.VertebrBadRequestError("Upload file is empty");
+    }
+    return { name, type, size: buffer.byteLength, buffer };
+}
+//# sourceMappingURL=uploads.js.map

package/dist/utils/uploads.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertebr/admin",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Schema-driven admin control plane — wire resources once, let owners run the app.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",