@tekki-forge/runtime-api 0.2.0 → 0.3.2

package/dist/settings.d.ts

@@ -0,0 +1,88 @@
+import type { AppIR } from "@tekki-forge/compiler";
+import type { ForgeRequestContext } from "./extension.js";
+/** Settings stored in the `system_settings` table, edited by global admins in Administration → System settings. */
+export interface SystemSettings {
+    /** Shown instead of the config's `name` in the navigation and the browser tab. */
+    appName: string | null;
+    /** Where users can write; shown on the Help & support page. */
+    supportEmail: string | null;
+    /** Banner for everyone; only global admins can write while it is on. */
+    maintenance: boolean;
+    maintenanceMessage: string | null;
+    /**
+     * Self-service sign-up. `null` follows `auth.registration` in forge.config.ts; `false` closes it at runtime.
+     * It can't be opened when the config disables it (staff-only apps stay closed).
+     */
+    registrationOpen: boolean | null;
+    /** Role given to people who sign up (apps without organizations; never "admin"). `null`: "user". */
+    defaultRole: string | null;
+    /** Sender of every email ("Acme <hello@acme.com>"); `null` uses EMAIL_FROM. */
+    emailFrom: string | null;
+    /** Runtime values of the flags declared in `featureFlags` (missing = the config's default). */
+    featureFlags: Record<string, boolean>;
+}
+/** What every visitor may know (served by GET /config). */
+export interface PublicSettings {
+    appName: string | null;
+    supportEmail: string | null;
+    maintenance: {
+        enabled: boolean;
+        message: string | null;
+    };
+    registration: boolean;
+    featureFlags: Record<string, boolean>;
+}
+/** Feature flags for extensions and jobs: `ctx.use<FeatureFlags>("featureFlags")?.enabled("newEditor")`. */
+export interface FeatureFlags {
+    enabled(name: string): Promise<boolean>;
+    all(): Promise<Record<string, boolean>>;
+}
+export interface EnvironmentCheck {
+    key: "email" | "storage" | "redis" | "stripe" | "database";
+    ok: boolean;
+    /** Short non-secret description, e.g. "SMTP", "S3 bucket forge-uploads", "test mode". */
+    detail: string;
+}
+export declare function isGlobalAdminRole(role: string | null | undefined): boolean;
+/** Global admins: the `admin` role on the account itself (not an organization role). */
+export declare function requireGlobalAdmin(ctx: ForgeRequestContext, what?: string): void;
+export declare class SettingsService {
+    private readonly app;
+    private readonly prisma;
+    private cache;
+    private loading;
+    constructor(app: AppIR, prisma: any);
+    private get available();
+    private load;
+    invalidate(): void;
+    all(): Promise<SystemSettings>;
+    /** Sign-up is open when the config allows it and no admin closed it. */
+    registrationOpen(settings: SystemSettings): boolean;
+    publicSettings(): Promise<PublicSettings>;
+    /** Roles that may be given on sign-up: app roles except admin; without organizations only (roles are per organization otherwise). */
+    assignableDefaultRoles(): string[];
+    featureFlags(): FeatureFlags;
+    /** Global admins only. Validates every key, writes the changed ones and records each change in the audit log. */
+    update(body: unknown, ctx: ForgeRequestContext): Promise<SystemSettings>;
+    /** GET/PATCH /admin/settings: stored values, the config defaults they override, assignable roles and the environment. */
+    adminView(shared?: Map<string, unknown>): Promise<{
+        settings: SystemSettings;
+        defaults: {
+            appName: string;
+            registration: boolean;
+            featureFlags: Record<string, boolean>;
+        };
+        roles: string[];
+        environment: EnvironmentCheck[];
+    }>;
+    /** Read-only status of the services the app depends on (never exposes secrets). */
+    environment(env?: NodeJS.ProcessEnv, shared?: Map<string, unknown>): EnvironmentCheck[];
+}
+/**
+ * Maintenance mode: refuses writes (POST/PUT/PATCH/DELETE) with HTTP 503 unless the caller is a global admin.
+ * `path` is relative to the API prefix; `extraExempt` lists plugin raw-body paths (signed webhooks).
+ */
+export declare function maintenanceBlock(settings: SettingsService, method: string, path: string, resolve: () => Promise<ForgeRequestContext>, extraExempt?: string[]): Promise<{
+    status: 503;
+    message: string;
+} | null>;

package/dist/settings.js

@@ -0,0 +1,252 @@
+import { BadRequestException, ForbiddenException, NotFoundException, UnauthorizedException } from "@nestjs/common";
+const KEYS = ["appName", "supportEmail", "maintenance", "maintenanceMessage", "registrationOpen", "defaultRole", "emailFrom", "featureFlags"];
+const CACHE_MS = 5_000;
+const EMAIL = /^[^\s@<>]+@[^\s@<>]+\.[^\s@<>]+$/;
+/** `hello@acme.com` or `Acme <hello@acme.com>`. */
+const SENDER = /^(?:[^<>\r\n]{1,100}\s)?<?[^\s@<>]+@[^\s@<>]+\.[^\s@<>]+>?$/;
+export function isGlobalAdminRole(role) {
+    return (role ?? "").split(",").map((r) => r.trim()).includes("admin");
+}
+/** Global admins: the `admin` role on the account itself (not an organization role). */
+export function requireGlobalAdmin(ctx, what = "this") {
+    if (!ctx.principal)
+        throw new UnauthorizedException("Sign in to continue");
+    if (ctx.apiKey)
+        throw new ForbiddenException("API keys cannot use the administration API");
+    if (!isGlobalAdminRole(ctx.user?.role))
+        throw new ForbiddenException(`Only global administrators can use ${what}`);
+}
+/** Process-wide sender override read by the mailers of @tekki-forge/runtime-auth (kept decoupled through a symbol). */
+const SENDER_SLOT = Symbol.for("forge.emailSender");
+export class SettingsService {
+    app;
+    prisma;
+    cache = null;
+    loading = null;
+    constructor(app, prisma) {
+        this.app = app;
+        this.prisma = prisma;
+        // Mail goes out with the configured sender; refreshed in the background (never blocks a send).
+        globalThis[SENDER_SLOT] = () => {
+            if (!this.cache || Date.now() - this.cache.at > CACHE_MS)
+                void this.load().catch(() => undefined);
+            const from = this.cache?.stored.emailFrom;
+            return typeof from === "string" && from ? from : undefined;
+        };
+    }
+    get available() {
+        return !!this.prisma?.systemSetting;
+    }
+    async load() {
+        if (this.cache && Date.now() - this.cache.at <= CACHE_MS)
+            return this.cache.stored;
+        if (!this.available)
+            return {};
+        this.loading ??= (async () => {
+            try {
+                const rows = await this.prisma.systemSetting.findMany({ where: { key: { in: [...KEYS] } } });
+                const stored = Object.fromEntries(rows.map((r) => [r.key, r.value]));
+                this.cache = { at: Date.now(), stored };
+                return stored;
+            }
+            catch {
+                // Table missing (app not migrated yet): behave as if nothing was set.
+                this.cache = { at: Date.now(), stored: {} };
+                return {};
+            }
+            finally {
+                this.loading = null;
+            }
+        })();
+        return this.loading;
+    }
+    invalidate() {
+        this.cache = null;
+    }
+    async all() {
+        const s = await this.load();
+        const str = (v) => (typeof v === "string" && v.trim() ? v : null);
+        const flags = this.app.featureFlags ?? {};
+        const storedFlags = (s.featureFlags && typeof s.featureFlags === "object" ? s.featureFlags : {});
+        return {
+            appName: str(s.appName),
+            supportEmail: str(s.supportEmail),
+            maintenance: s.maintenance === true,
+            maintenanceMessage: str(s.maintenanceMessage),
+            registrationOpen: typeof s.registrationOpen === "boolean" ? s.registrationOpen : null,
+            defaultRole: str(s.defaultRole),
+            emailFrom: str(s.emailFrom),
+            featureFlags: Object.fromEntries(Object.entries(flags).map(([name, def]) => [name, typeof storedFlags[name] === "boolean" ? storedFlags[name] : def])),
+        };
+    }
+    /** Sign-up is open when the config allows it and no admin closed it. */
+    registrationOpen(settings) {
+        return this.app.auth.registration && settings.registrationOpen !== false;
+    }
+    async publicSettings() {
+        const s = await this.all();
+        return {
+            appName: s.appName,
+            supportEmail: s.supportEmail,
+            maintenance: { enabled: s.maintenance, message: s.maintenanceMessage },
+            registration: this.registrationOpen(s),
+            featureFlags: s.featureFlags,
+        };
+    }
+    /** Roles that may be given on sign-up: app roles except admin; without organizations only (roles are per organization otherwise). */
+    assignableDefaultRoles() {
+        return this.app.tenancy.enabled ? [] : this.app.roles.filter((r) => r !== "admin");
+    }
+    featureFlags() {
+        return {
+            enabled: async (name) => (await this.all()).featureFlags[name] === true,
+            all: async () => (await this.all()).featureFlags,
+        };
+    }
+    /** Global admins only. Validates every key, writes the changed ones and records each change in the audit log. */
+    async update(body, ctx) {
+        requireGlobalAdmin(ctx, "system settings");
+        if (!this.available)
+            throw new NotFoundException("System settings need the system_settings table — run forge generate and forge db migrate");
+        if (!body || typeof body !== "object" || Array.isArray(body))
+            throw new BadRequestException("Expected an object of settings");
+        const input = body;
+        const issues = [];
+        const next = {};
+        const text = (key, max, check) => {
+            if (!(key in input))
+                return;
+            const v = input[key];
+            if (v === null || v === "")
+                return void (next[key] = null);
+            if (typeof v !== "string")
+                return void issues.push({ path: key, message: "Must be text" });
+            const value = v.trim();
+            if (value.length > max)
+                return void issues.push({ path: key, message: `At most ${max} characters` });
+            const problem = check?.(value);
+            if (problem)
+                return void issues.push({ path: key, message: problem });
+            next[key] = value || null;
+        };
+        text("appName", 80);
+        text("supportEmail", 254, (v) => (EMAIL.test(v) ? null : "Must be an email address"));
+        text("maintenanceMessage", 500);
+        text("emailFrom", 200, (v) => (SENDER.test(v) ? null : 'Use "name@example.com" or "Name <name@example.com>"'));
+        text("defaultRole", 50, (v) => (this.assignableDefaultRoles().includes(v) ? null : `Must be one of: ${this.assignableDefaultRoles().join(", ") || "(none — roles are given per organization)"}`));
+        if ("maintenance" in input) {
+            if (typeof input.maintenance !== "boolean")
+                issues.push({ path: "maintenance", message: "Must be true or false" });
+            else
+                next.maintenance = input.maintenance;
+        }
+        if ("registrationOpen" in input) {
+            const v = input.registrationOpen;
+            if (v !== null && typeof v !== "boolean")
+                issues.push({ path: "registrationOpen", message: "Must be true, false or null" });
+            else if (v === true && !this.app.auth.registration)
+                issues.push({ path: "registrationOpen", message: "Sign-up is disabled in forge.config.ts (auth.registration: false)" });
+            else
+                next.registrationOpen = v;
+        }
+        if ("featureFlags" in input) {
+            const flags = input.featureFlags;
+            const declared = this.app.featureFlags ?? {};
+            if (!flags || typeof flags !== "object" || Array.isArray(flags))
+                issues.push({ path: "featureFlags", message: "Must be an object of flag names and booleans" });
+            else {
+                const current = (await this.all()).featureFlags;
+                const out = { ...current };
+                for (const [name, value] of Object.entries(flags)) {
+                    if (!(name in declared))
+                        issues.push({ path: `featureFlags.${name}`, message: "Unknown flag — declare it in featureFlags in forge.config.ts" });
+                    else if (typeof value !== "boolean")
+                        issues.push({ path: `featureFlags.${name}`, message: "Must be true or false" });
+                    else
+                        out[name] = value;
+                }
+                next.featureFlags = out;
+            }
+        }
+        for (const key of Object.keys(input))
+            if (!KEYS.includes(key))
+                issues.push({ path: key, message: "Unknown setting" });
+        if (issues.length)
+            throw new BadRequestException({ statusCode: 400, error: "Bad Request", message: "Validation failed", issues });
+        const before = await this.all();
+        const changes = {};
+        await this.prisma.$transaction(async (db) => {
+            for (const [key, value] of Object.entries(next)) {
+                const from = before[key];
+                if (JSON.stringify(from ?? null) === JSON.stringify(value ?? null))
+                    continue;
+                changes[key] = { from, to: value };
+                if (value === null)
+                    await db.systemSetting.deleteMany({ where: { key } });
+                else
+                    await db.systemSetting.upsert({ where: { key }, create: { key, value, updatedById: ctx.principal.id }, update: { value, updatedById: ctx.principal.id } });
+                await db.auditLog.create({
+                    data: {
+                        entity: "SystemSetting",
+                        recordId: key,
+                        action: "update",
+                        userId: ctx.principal.id,
+                        ...(this.app.tenancy.enabled ? { organizationId: null } : {}),
+                        changes: { [key]: { from: from ?? null, to: value ?? null }, ...(ctx.session?.impersonatedBy ? { _impersonatedBy: ctx.session.impersonatedBy } : {}) },
+                        ipAddress: ctx.ip ?? null,
+                    },
+                });
+            }
+        });
+        this.invalidate();
+        return this.all();
+    }
+    /** GET/PATCH /admin/settings: stored values, the config defaults they override, assignable roles and the environment. */
+    async adminView(shared) {
+        return {
+            settings: await this.all(),
+            defaults: { appName: this.app.name, registration: this.app.auth.registration, featureFlags: this.app.featureFlags ?? {} },
+            roles: this.assignableDefaultRoles(),
+            environment: this.environment(process.env, shared),
+        };
+    }
+    /** Read-only status of the services the app depends on (never exposes secrets). */
+    environment(env = process.env, shared) {
+        const plugin = (name) => this.app.plugins.some((p) => p.name === name);
+        const out = [{ key: "database", ok: true, detail: "PostgreSQL" }];
+        out.push(env.SMTP_URL
+            ? { key: "email", ok: true, detail: "SMTP" }
+            : env.RESEND_API_KEY
+                ? { key: "email", ok: true, detail: "Resend" }
+                : { key: "email", ok: false, detail: "console" });
+        if (plugin("storage"))
+            out.push(env.S3_BUCKET ? { key: "storage", ok: true, detail: `S3 · ${env.S3_BUCKET}` } : { key: "storage", ok: true, detail: `disk · ${env.STORAGE_DIR ?? ".forge-uploads"}` });
+        if (plugin("jobs"))
+            out.push({ key: "redis", ok: !!env.REDIS_URL && !!shared?.get("jobsQueue"), detail: env.REDIS_URL ? "BullMQ" : "REDIS_URL" });
+        if (plugin("payments")) {
+            const key = env.STRIPE_SECRET_KEY ?? "";
+            out.push({ key: "stripe", ok: !!key && !!env.STRIPE_WEBHOOK_SECRET, detail: !key ? "STRIPE_SECRET_KEY" : !env.STRIPE_WEBHOOK_SECRET ? "STRIPE_WEBHOOK_SECRET" : key.startsWith("sk_live_") ? "live" : "test" });
+        }
+        return out;
+    }
+}
+/** Writes allowed while maintenance mode is on: sign-in, reading notifications, contacting support, the admin API (global admins only anyway). */
+const MAINTENANCE_EXEMPT = [/^\/auth\//, /^\/notifications\/read$/, /^\/admin\//, /^\/support\//];
+/**
+ * Maintenance mode: refuses writes (POST/PUT/PATCH/DELETE) with HTTP 503 unless the caller is a global admin.
+ * `path` is relative to the API prefix; `extraExempt` lists plugin raw-body paths (signed webhooks).
+ */
+export async function maintenanceBlock(settings, method, path, resolve, extraExempt = []) {
+    if (["GET", "HEAD", "OPTIONS"].includes(method.toUpperCase()))
+        return null;
+    if (MAINTENANCE_EXEMPT.some((re) => re.test(path)) || extraExempt.includes(path))
+        return null;
+    const s = await settings.all();
+    if (!s.maintenance)
+        return null;
+    const ctx = await resolve().catch(() => null);
+    if (ctx && !ctx.apiKey && isGlobalAdminRole(ctx.user?.role))
+        return null;
+    return { status: 503, message: s.maintenanceMessage ? `Maintenance in progress: ${s.maintenanceMessage}` : "Maintenance in progress — changes are paused for a moment. Please try again later." };
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/site-controller.d.ts

@@ -0,0 +1,115 @@
+import type { Request, Response } from "express";
+import type { ForgeRequestContext } from "./extension.js";
+import type { ForgeService } from "./service.js";
+type ForgeRequest = Request & {
+    forgeContext?: Promise<ForgeRequestContext>;
+};
+type Q = Record<string, unknown>;
+/**
+ * The public website (`site` in forge.config.ts) under /api/site: rendering, posts, sitemap and forms for visitors,
+ * and the Content admin of site editors. Registered before the generic `:resource` routes.
+ */
+export declare class SiteController {
+    private readonly forge;
+    private readonly site;
+    constructor(forge: ForgeService);
+    /** 404 before anything else when the app has no website. */
+    private ctx;
+    /** `?path=/pricing[&preview=1]` — drafts and hidden sections only in preview, for site editors. */
+    render(query: Q, req: ForgeRequest): Promise<import("./site.js").SiteRender>;
+    posts(query: Q): Promise<{
+        data: import("./site.js").SitePostSummary[];
+        total: number;
+    }>;
+    sitemap(): Promise<{
+        pages: {
+            path: string;
+            updatedAt: string;
+        }[];
+        posts: {
+            path: string;
+            updatedAt: string;
+        }[];
+    }>;
+    contact(body: unknown, req: ForgeRequest): Promise<{
+        ok: true;
+    }>;
+    newsletter(body: unknown, req: ForgeRequest): Promise<{
+        ok: true;
+    }>;
+    overview(req: ForgeRequest): Promise<{
+        pages: import("./site.js").SitePageListItem[];
+        conflicts: number;
+        messages: {
+            new: number;
+        };
+        subscribers: number;
+        storage: boolean;
+        payments: boolean;
+        blogKinds: {
+            post?: string | undefined;
+            guide?: string | undefined;
+            webinar?: string | undefined;
+            "case-study"?: string | undefined;
+        };
+    }>;
+    preview(body: unknown, req: ForgeRequest): Promise<{
+        data: (import("./site.js").SectionData | null)[];
+    }>;
+    createPage(body: unknown, req: ForgeRequest): Promise<import("./site.js").SitePageDetail>;
+    page(id: string, req: ForgeRequest): Promise<import("./site.js").SitePageDetail>;
+    updatePage(id: string, body: unknown, req: ForgeRequest): Promise<import("./site.js").SitePageDetail>;
+    deletePage(id: string, req: ForgeRequest): Promise<void>;
+    revertPage(id: string, req: ForgeRequest): Promise<import("./site.js").SitePageDetail>;
+    addSection(id: string, body: unknown, req: ForgeRequest): Promise<import("./site.js").SitePageDetail>;
+    reorder(id: string, body: unknown, req: ForgeRequest): Promise<import("./site.js").SitePageDetail>;
+    updateSection(id: string, body: unknown, req: ForgeRequest): Promise<import("./site.js").SiteSectionDetail>;
+    deleteSection(id: string, req: ForgeRequest): Promise<void>;
+    revertSection(id: string, req: ForgeRequest): Promise<import("./site.js").SiteSectionDetail>;
+    listPosts(query: Q, req: ForgeRequest): Promise<{
+        data: import("./site.js").SitePostAdmin[];
+        total: number;
+    }>;
+    createPost(body: unknown, req: ForgeRequest): Promise<import("./site.js").SitePostAdmin>;
+    getPost(id: string, req: ForgeRequest): Promise<import("./site.js").SitePostAdmin>;
+    updatePost(id: string, body: unknown, req: ForgeRequest): Promise<import("./site.js").SitePostAdmin>;
+    deletePost(id: string, req: ForgeRequest): Promise<void>;
+    messages(query: Q, req: ForgeRequest): Promise<{
+        data: {
+            id: any;
+            name: any;
+            email: any;
+            company: any;
+            message: any;
+            page: any;
+            status: any;
+            createdAt: string;
+        }[];
+        total: number;
+    }>;
+    updateMessage(id: string, body: unknown, req: ForgeRequest): Promise<{
+        id: any;
+        name: any;
+        email: any;
+        company: any;
+        message: any;
+        page: any;
+        status: any;
+        createdAt: string;
+    }>;
+    deleteMessage(id: string, req: ForgeRequest): Promise<void>;
+    subscribers(query: Q, req: ForgeRequest): Promise<{
+        data: {
+            id: any;
+            email: any;
+            status: any;
+            source: any;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        total: number;
+    }>;
+    exportSubscribers(req: ForgeRequest, res: Response): Promise<string>;
+    deleteSubscriber(id: string, req: ForgeRequest): Promise<void>;
+}
+export {};