@gridframe/server 1.0.0 → 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+import { type CardDeeplinkConfig, type DashboardCardLayout, type DashboardFooterConfig, type DashboardLayoutItem, type DashboardSummary, type PanelCardDataResponse, type VisualizationType } from "@gridframe/core";
+type MaybePromise<T> = T | Promise<T>;
+type CardLibraryTemplate = {
+    key: string;
+    name: string;
+    description?: string;
+    visualization: VisualizationType;
+    defaultLayout: {
+        width: number;
+        height: number;
+    };
+    deeplinkLabel?: string;
+};
+type DashboardSeedCard = {
+    libraryItemKey: string;
+    layout?: DashboardCardLayout;
+};
+type DashboardSeed = {
+    title: string;
+    description?: string;
+    footer?: DashboardFooterConfig;
+    cards: DashboardSeedCard[];
+};
+type PersistedDashboardCard = {
+    id: string;
+    dashboardId: string;
+    libraryItemKey?: string;
+    name: string;
+    visualization: VisualizationType;
+    deeplink?: Omit<CardDeeplinkConfig, "href">;
+    layout: DashboardCardLayout;
+    sortOrder: number;
+};
+type PersistedDashboard = {
+    id: string;
+    ownerUserId: string;
+    title: string;
+    description?: string;
+    footer?: DashboardFooterConfig;
+    isDefault: boolean;
+    revision: number;
+    cards: PersistedDashboardCard[];
+};
+type DashboardBootstrap = {
+    dashboards: DashboardSummary[];
+    dashboard: PersistedDashboard;
+};
+type DashboardCardCreate = Omit<PersistedDashboardCard, "id" | "dashboardId" | "sortOrder">;
+interface DashboardRepository {
+    bootstrap(ownerUserId: string, dashboardId: string | undefined, seed: DashboardSeed, cardLibrary: readonly CardLibraryTemplate[]): MaybePromise<DashboardBootstrap>;
+    loadDashboard(ownerUserId: string, dashboardId: string): MaybePromise<PersistedDashboard>;
+    updateLayout(ownerUserId: string, dashboardId: string, revision: number, cards: DashboardLayoutItem[]): MaybePromise<PersistedDashboard>;
+    updateCardName(ownerUserId: string, dashboardId: string, cardId: string, revision: number, name: string): MaybePromise<PersistedDashboard>;
+    addCard(ownerUserId: string, dashboardId: string, revision: number, card: DashboardCardCreate): MaybePromise<PersistedDashboard>;
+    removeCard(ownerUserId: string, dashboardId: string, cardId: string, revision: number): MaybePromise<PersistedDashboard>;
+    findOwnedCard(ownerUserId: string, dashboardId: string, cardId: string): MaybePromise<PersistedDashboardCard | undefined>;
+}
+type DashboardHandlerOptions = {
+    repository: DashboardRepository;
+    cardLibrary: readonly CardLibraryTemplate[] | ((context: DashboardContext) => MaybePromise<readonly CardLibraryTemplate[]>);
+    defaultDashboard: (context: DashboardContext) => MaybePromise<DashboardSeed>;
+    resolveCardData: (input: CardDataResolverInput) => MaybePromise<PanelCardDataResponse>;
+    urls?: DashboardUrlOptions;
+};
+type DashboardUrlOptions = {
+    apiBasePath?: string;
+    dashboardBasePath?: string;
+};
+type DashboardContext = {
+    userId: string;
+};
+type DashboardIdentity = DashboardContext & {
+    dashboardId: string;
+};
+type CardIdentity = DashboardIdentity & {
+    cardId: string;
+};
+type CardDataResolverInput = CardIdentity & {
+    card: PersistedDashboardCard;
+    request: Request;
+};
+declare class DashboardNotFoundError extends Error {
+    constructor();
+}
+declare class DashboardRevisionConflictError extends Error {
+    constructor();
+}
+declare class DashboardInvalidLayoutError extends Error {
+    readonly errors: string[];
+    constructor(errors: string[]);
+}
+declare class DashboardCardAlreadyAddedError extends Error {
+    constructor();
+}
+declare class DashboardInvalidLibraryItemError extends Error {
+    constructor();
+}
+declare function createDashboardHandlers(options: DashboardHandlerOptions): {
+    bootstrap: (request: Request, context: DashboardContext) => Promise<Response>;
+    updateLayout: (request: Request, identity: DashboardIdentity) => Promise<Response>;
+    updateCard: (request: Request, identity: CardIdentity) => Promise<Response>;
+    listCardLibrary: (_request: Request, identity: DashboardIdentity) => Promise<Response>;
+    addCard: (request: Request, identity: DashboardIdentity) => Promise<Response>;
+    removeCard: (request: Request, identity: CardIdentity) => Promise<Response>;
+    fetchCardData: (request: Request, identity: CardIdentity) => Promise<Response>;
+};
+export { DashboardCardAlreadyAddedError, DashboardInvalidLayoutError, DashboardInvalidLibraryItemError, DashboardNotFoundError, DashboardRevisionConflictError, createDashboardHandlers, };
+export type { CardDataResolverInput, CardLibraryTemplate, DashboardBootstrap, DashboardHandlerOptions, DashboardRepository, DashboardSeed, DashboardSeedCard, PersistedDashboard, PersistedDashboardCard, };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,346 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DashboardRevisionConflictError = exports.DashboardNotFoundError = exports.DashboardInvalidLibraryItemError = exports.DashboardInvalidLayoutError = exports.DashboardCardAlreadyAddedError = void 0;
+exports.createDashboardHandlers = createDashboardHandlers;
+const core_1 = require("@gridframe/core");
+const core_2 = require("@gridframe/core");
+class DashboardNotFoundError extends Error {
+    constructor() {
+        super("Dashboard not found");
+        this.name = "DashboardNotFoundError";
+    }
+}
+exports.DashboardNotFoundError = DashboardNotFoundError;
+class DashboardRevisionConflictError extends Error {
+    constructor() {
+        super("Dashboard revision conflict");
+        this.name = "DashboardRevisionConflictError";
+    }
+}
+exports.DashboardRevisionConflictError = DashboardRevisionConflictError;
+class DashboardInvalidLayoutError extends Error {
+    errors;
+    constructor(errors) {
+        super(errors.join("; "));
+        this.errors = errors;
+        this.name = "DashboardInvalidLayoutError";
+    }
+}
+exports.DashboardInvalidLayoutError = DashboardInvalidLayoutError;
+class DashboardCardAlreadyAddedError extends Error {
+    constructor() {
+        super("Card is already on this Dashboard");
+        this.name = "DashboardCardAlreadyAddedError";
+    }
+}
+exports.DashboardCardAlreadyAddedError = DashboardCardAlreadyAddedError;
+class DashboardInvalidLibraryItemError extends Error {
+    constructor() {
+        super("Unknown Card library item");
+        this.name = "DashboardInvalidLibraryItemError";
+    }
+}
+exports.DashboardInvalidLibraryItemError = DashboardInvalidLibraryItemError;
+function createDashboardHandlers(options) {
+    const urls = {
+        apiBasePath: options.urls?.apiBasePath ?? "/api/gridframe",
+        dashboardBasePath: options.urls?.dashboardBasePath ?? "/gridframe",
+    };
+    return {
+        bootstrap: async (request, context) => {
+            const parsedRequest = core_1.DashboardBootstrapRequestSchema.safeParse(await readJson(request));
+            if (!parsedRequest.success || !isIdentitySegment(context.userId)) {
+                return errorResponse(400, "INVALID_REQUEST", "Invalid bootstrap request");
+            }
+            try {
+                const [seed, cardLibrary] = await Promise.all([
+                    options.defaultDashboard(context),
+                    resolveCardLibrary(options.cardLibrary, context),
+                ]);
+                const result = await options.repository.bootstrap(context.userId, parsedRequest.data.dashboardId, seed, cardLibrary);
+                return Response.json(serializeDashboardBootstrap(result, urls));
+            }
+            catch (error) {
+                if (error instanceof DashboardNotFoundError) {
+                    return errorResponse(404, "DASHBOARD_NOT_FOUND", "Dashboard not found");
+                }
+                if (error instanceof DashboardInvalidLibraryItemError) {
+                    return errorResponse(400, "INVALID_REQUEST", "Unknown Card library item");
+                }
+                return errorResponse(500, "DASHBOARD_LOAD_FAILED", "Dashboard could not be loaded");
+            }
+        },
+        updateLayout: async (request, identity) => {
+            const parsed = core_1.UpdateDashboardLayoutRequestSchema.safeParse(await readJson(request));
+            const revision = parsed.success
+                ? parseRevision(parsed.data.revision)
+                : undefined;
+            if (!parsed.success || revision === undefined || !isDashboard(identity)) {
+                return errorResponse(400, "INVALID_REQUEST", "Invalid Dashboard layout request");
+            }
+            try {
+                const dashboard = await options.repository.loadDashboard(identity.userId, identity.dashboardId);
+                const validation = (0, core_2.validateDashboardLayout)(parsed.data.cards, dashboard.cards.map((card) => card.id));
+                if (!validation.valid) {
+                    throw new DashboardInvalidLayoutError(validation.errors);
+                }
+                const updated = await options.repository.updateLayout(identity.userId, identity.dashboardId, revision, parsed.data.cards);
+                return Response.json(serializeDashboardDocument(updated, urls));
+            }
+            catch (error) {
+                return mutationError(error, "Invalid Dashboard layout");
+            }
+        },
+        updateCard: async (request, identity) => {
+            const parsed = core_1.UpdateDashboardCardRequestSchema.safeParse(await readJson(request));
+            const revision = parsed.success
+                ? parseRevision(parsed.data.revision)
+                : undefined;
+            const name = parsed.success ? parsed.data.name.trim() : "";
+            if (!parsed.success ||
+                revision === undefined ||
+                !name ||
+                !isCard(identity)) {
+                return errorResponse(400, "INVALID_REQUEST", "Invalid Card update request");
+            }
+            try {
+                const updated = await options.repository.updateCardName(identity.userId, identity.dashboardId, identity.cardId, revision, name);
+                return Response.json(serializeDashboardDocument(updated, urls));
+            }
+            catch (error) {
+                return mutationError(error, "Invalid Card update request");
+            }
+        },
+        listCardLibrary: async (_request, identity) => {
+            if (!isDashboard(identity)) {
+                return errorResponse(400, "INVALID_REQUEST", "Invalid Card library request");
+            }
+            try {
+                const [dashboard, cardLibrary] = await Promise.all([
+                    options.repository.loadDashboard(identity.userId, identity.dashboardId),
+                    resolveCardLibrary(options.cardLibrary, identity),
+                ]);
+                return Response.json(buildCardLibraryResponse(dashboard, cardLibrary));
+            }
+            catch (error) {
+                return libraryError(error);
+            }
+        },
+        addCard: async (request, identity) => {
+            const parsed = core_1.AddDashboardCardRequestSchema.safeParse(await readJson(request));
+            const revision = parsed.success
+                ? parseRevision(parsed.data.revision)
+                : undefined;
+            if (!parsed.success || revision === undefined || !isDashboard(identity)) {
+                return errorResponse(400, "INVALID_REQUEST", "Invalid Card add request");
+            }
+            try {
+                const [dashboard, cardLibrary] = await Promise.all([
+                    options.repository.loadDashboard(identity.userId, identity.dashboardId),
+                    resolveCardLibrary(options.cardLibrary, identity),
+                ]);
+                const template = cardLibrary.find((item) => item.key === parsed.data.libraryItemKey);
+                if (!template) {
+                    throw new DashboardInvalidLibraryItemError();
+                }
+                if (dashboard.cards.some((card) => card.libraryItemKey === parsed.data.libraryItemKey)) {
+                    throw new DashboardCardAlreadyAddedError();
+                }
+                const updated = await options.repository.addCard(identity.userId, identity.dashboardId, revision, {
+                    libraryItemKey: template.key,
+                    name: template.name,
+                    visualization: template.visualization,
+                    deeplink: template.deeplinkLabel
+                        ? { label: template.deeplinkLabel }
+                        : undefined,
+                    layout: firstAvailableLayout(dashboard.cards, template.defaultLayout),
+                });
+                return Response.json({
+                    dashboard: serializeDashboardDocument(updated, urls),
+                    cardLibrary: buildCardLibraryResponse(updated, cardLibrary),
+                });
+            }
+            catch (error) {
+                return libraryError(error);
+            }
+        },
+        removeCard: async (request, identity) => {
+            const parsed = core_1.RemoveDashboardCardRequestSchema.safeParse(await readJson(request));
+            const revision = parsed.success
+                ? parseRevision(parsed.data.revision)
+                : undefined;
+            if (!parsed.success || revision === undefined || !isCard(identity)) {
+                return errorResponse(400, "INVALID_REQUEST", "Invalid Card remove request");
+            }
+            try {
+                const cardLibrary = await resolveCardLibrary(options.cardLibrary, identity);
+                const updated = await options.repository.removeCard(identity.userId, identity.dashboardId, identity.cardId, revision);
+                return Response.json({
+                    dashboard: serializeDashboardDocument(updated, urls),
+                    cardLibrary: buildCardLibraryResponse(updated, cardLibrary),
+                });
+            }
+            catch (error) {
+                return libraryError(error);
+            }
+        },
+        fetchCardData: async (request, identity) => {
+            if (!isCard(identity)) {
+                return errorResponse(400, "INVALID_REQUEST", "Invalid Card data request");
+            }
+            try {
+                const card = await options.repository.findOwnedCard(identity.userId, identity.dashboardId, identity.cardId);
+                if (!card) {
+                    return errorResponse(404, "DASHBOARD_CARD_NOT_FOUND", "Dashboard Card not found");
+                }
+                const result = await options.resolveCardData({
+                    ...identity,
+                    card,
+                    request,
+                });
+                const parsed = core_1.PanelCardDataResponseSchema.safeParse(result);
+                if (!parsed.success) {
+                    return cardQueryFailed();
+                }
+                return Response.json(parsed.data);
+            }
+            catch {
+                return cardQueryFailed();
+            }
+        },
+    };
+}
+function serializeDashboardBootstrap(result, urls) {
+    return {
+        dashboards: result.dashboards,
+        dashboard: serializeDashboardDocument(result.dashboard, urls),
+    };
+}
+function serializeDashboardDocument(dashboard, urls) {
+    const ownerId = encodeURIComponent(dashboard.ownerUserId);
+    const dashboardId = encodeURIComponent(dashboard.id);
+    return core_1.DashboardDocumentSchema.parse({
+        id: dashboard.id,
+        revision: String(dashboard.revision),
+        config: {
+            title: dashboard.title,
+            description: dashboard.description,
+            footer: dashboard.footer,
+            cards: dashboard.cards.map((card) => {
+                const cardId = encodeURIComponent(card.id);
+                return {
+                    id: card.id,
+                    name: card.name,
+                    visualization: card.visualization,
+                    query: `${urls.apiBasePath}/users/${ownerId}` +
+                        `/dashboards/${dashboardId}/cards/${cardId}/data`,
+                    deeplink: card.deeplink
+                        ? {
+                            href: `${urls.dashboardBasePath}/users/${ownerId}` +
+                                `/dashboards/${dashboardId}/cards/${cardId}`,
+                            label: card.deeplink.label,
+                        }
+                        : undefined,
+                    layout: card.layout,
+                };
+            }),
+        },
+    });
+}
+function buildCardLibraryResponse(dashboard, cardLibrary) {
+    const installed = new Map(dashboard.cards.map((card) => [card.libraryItemKey, card.id]));
+    return core_1.CardLibraryResponseSchema.parse({
+        items: cardLibrary.map((template) => ({
+            key: template.key,
+            name: template.name,
+            description: template.description,
+            visualization: template.visualization,
+            defaultLayout: template.defaultLayout,
+            addedCardId: installed.get(template.key),
+        })),
+    });
+}
+function firstAvailableLayout(cards, size) {
+    if (size.width > core_1.DASHBOARD_GRID_COLUMNS) {
+        throw new DashboardInvalidLayoutError([
+            `Card width ${size.width} exceeds the ${core_1.DASHBOARD_GRID_COLUMNS}-column grid`,
+        ]);
+    }
+    for (let y = 0;; y += 1) {
+        for (let x = 0; x + size.width <= core_1.DASHBOARD_GRID_COLUMNS; x += 1) {
+            const candidate = { x, y, ...size };
+            if (!cards.some((card) => layoutsOverlap(candidate, card.layout))) {
+                return candidate;
+            }
+        }
+    }
+}
+function layoutsOverlap(a, b) {
+    return (a.x < b.x + b.width &&
+        a.x + a.width > b.x &&
+        a.y < b.y + b.height &&
+        a.y + a.height > b.y);
+}
+async function resolveCardLibrary(cardLibrary, context) {
+    return typeof cardLibrary === "function"
+        ? cardLibrary(context)
+        : cardLibrary;
+}
+function mutationError(error, invalidMessage) {
+    if (error instanceof DashboardRevisionConflictError) {
+        return errorResponse(409, "REVISION_CONFLICT", "Dashboard was changed by another request");
+    }
+    if (error instanceof DashboardNotFoundError) {
+        return errorResponse(404, "DASHBOARD_NOT_FOUND", "Dashboard not found");
+    }
+    if (error instanceof DashboardInvalidLayoutError) {
+        return errorResponse(400, "INVALID_REQUEST", invalidMessage);
+    }
+    return errorResponse(500, "DASHBOARD_LOAD_FAILED", "Dashboard could not be updated");
+}
+function libraryError(error) {
+    if (error instanceof DashboardRevisionConflictError) {
+        return errorResponse(409, "REVISION_CONFLICT", "Dashboard was changed by another request");
+    }
+    if (error instanceof DashboardCardAlreadyAddedError) {
+        return errorResponse(409, "CARD_ALREADY_ADDED", "Card is already on this Dashboard");
+    }
+    if (error instanceof DashboardInvalidLibraryItemError) {
+        return errorResponse(400, "INVALID_REQUEST", "Unknown Card library item");
+    }
+    if (error instanceof DashboardNotFoundError) {
+        return errorResponse(404, "DASHBOARD_NOT_FOUND", "Dashboard not found");
+    }
+    return errorResponse(500, "DASHBOARD_LOAD_FAILED", "Dashboard could not be updated");
+}
+function errorResponse(status, code, message) {
+    return Response.json(core_1.DashboardApiErrorSchema.parse({ error: { code, message } }), { status });
+}
+async function readJson(request) {
+    try {
+        return await request.json();
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseRevision(revision) {
+    if (!/^[1-9]\d*$/.test(revision)) {
+        return undefined;
+    }
+    const value = Number(revision);
+    return Number.isSafeInteger(value) ? value : undefined;
+}
+function isDashboard(identity) {
+    return (isIdentitySegment(identity.userId) &&
+        isIdentitySegment(identity.dashboardId));
+}
+function isCard(identity) {
+    return isDashboard(identity) && isIdentitySegment(identity.cardId);
+}
+function isIdentitySegment(value) {
+    return value.trim().length > 0 && value.length <= 256;
+}
+function cardQueryFailed() {
+    return errorResponse(502, "CARD_QUERY_FAILED", "Card data could not be loaded");
+}

package/package.json

@@ -1,11 +1,18 @@
 {
   "name": "@gridframe/server",
-  "version": "1.0.0",
+  "version": "1.0.1",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
   "files": [
-    "src",
+    "dist",
     "README.md"
   ],
   "publishConfig": {
@@ -19,9 +26,10 @@
     "@gridframe/typescript-config": "0.0.0"
   },
   "dependencies": {
-    "@gridframe/core": "^1.0.0"
+    "@gridframe/core": "1.0.1"
   },
   "scripts": {
+    "build": "rm -rf dist && tsc",
     "lint": "eslint . --max-warnings 0",
     "test": "vitest run src",
     "check-types": "tsc --noEmit"