@tekki-forge/runtime-api 0.1.0

package/dist/dashboard.d.ts

@@ -0,0 +1,58 @@
+import type { ForgeRequestContext } from "./extension.js";
+import type { ForgeService } from "./service.js";
+type Row = Record<string, any>;
+/** "$today", "$today-30d", "$now", "$startOfMonth", "$me" → concrete values. */
+export declare function resolveTokens(where: Record<string, string>, userId: string | null, now?: Date): Record<string, string>;
+export declare function bucketKey(d: Date, by: "day" | "week" | "month" | "year"): string;
+export type ComparePeriod = "week" | "month" | "quarter" | "year";
+/** Periods in a metric's sparkline (the last one is the current period). */
+export declare const TREND_PERIODS = 12;
+/** `d` moved by `n` periods; months clamp to the month's last day (31 Mar − 1 month = 28/29 Feb). */
+export declare function shiftPeriod(d: Date, period: ComparePeriod, n: number): Date;
+/**
+ * Rolling windows ending with today (whole UTC days, so numbers are stable through the day and date-only fields
+ * compare cleanly), oldest first: with period "month" on 1 Oct the last window is [2 Sep, 2 Oct).
+ */
+export declare function trendWindows(now: Date, period: ComparePeriod, count?: number): {
+    start: Date;
+    end: Date;
+    asOf: Date;
+}[];
+export interface MetricTrend {
+    period: ComparePeriod;
+    trend: "up-is-good" | "down-is-good";
+    current: number | null;
+    previous: number | null;
+    /** (current − previous) / |previous|; null when there is nothing to compare with. */
+    change: number | null;
+    direction: "up" | "down" | "flat";
+    /** Whether the change is good news (null when flat). */
+    good: boolean | null;
+    /** One value per period, oldest first; `start`/`end` are ISO dates (end exclusive). */
+    series: {
+        start: string;
+        end: string;
+        value: number | null;
+    }[];
+}
+export declare class DashboardService {
+    private readonly service;
+    constructor(service: ForgeService);
+    private readable;
+    private fieldReadable;
+    /** `now` is injectable for tests; relative dates in filters ($today…) are resolved against it. */
+    compute(ctx: ForgeRequestContext, now?: Date): Promise<{
+        widgets: null;
+    } | {
+        widgets: Row[];
+    }>;
+    private aggregate;
+    /**
+     * The metric over each of the last TREND_PERIODS rolling periods, within exactly the same row-level, tenant and
+     * owner rules as the value itself; relative dates in the filter ($today…) are resolved as of each period.
+     */
+    private trend;
+    /** `label` is ready to show (default language); `key` is the raw group value so clients can localize it ("__other" = the rest). */
+    private series;
+}
+export {};

package/dist/dashboard.js

@@ -0,0 +1,258 @@
+import { authorize, evaluate } from "@tekki-forge/runtime-permissions";
+import { QueryError, parseListQuery, parseSort } from "./query.js";
+import { relationInclude } from "./serialize.js";
+const MAX_BUCKET_ROWS = 50_000;
+/** "$today", "$today-30d", "$now", "$startOfMonth", "$me" → concrete values. */
+export function resolveTokens(where, userId, now = new Date()) {
+    const today = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
+    const out = {};
+    for (const [k, v] of Object.entries(where)) {
+        out[k] = v.replace(/\$(today|now|startOfMonth|startOfYear|me)([+-]\d+[dwmy])?/g, (_, token, offset) => {
+            if (token === "me")
+                return userId ?? "__nobody__";
+            const d = token === "now" ? new Date(now) : token === "startOfMonth" ? new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1)) : token === "startOfYear" ? new Date(Date.UTC(now.getUTCFullYear(), 0, 1)) : new Date(today);
+            if (offset) {
+                const n = Number(offset.slice(0, -1));
+                const unit = offset.slice(-1);
+                if (unit === "d")
+                    d.setUTCDate(d.getUTCDate() + n);
+                if (unit === "w")
+                    d.setUTCDate(d.getUTCDate() + 7 * n);
+                if (unit === "m")
+                    d.setUTCMonth(d.getUTCMonth() + n);
+                if (unit === "y")
+                    d.setUTCFullYear(d.getUTCFullYear() + n);
+            }
+            return token === "now" ? d.toISOString() : d.toISOString().slice(0, 10);
+        });
+    }
+    return out;
+}
+export function bucketKey(d, by) {
+    const y = d.getUTCFullYear();
+    const m = String(d.getUTCMonth() + 1).padStart(2, "0");
+    if (by === "year")
+        return String(y);
+    if (by === "month")
+        return `${y}-${m}`;
+    if (by === "week") {
+        // ISO week start (Monday).
+        const monday = new Date(Date.UTC(y, d.getUTCMonth(), d.getUTCDate() - ((d.getUTCDay() + 6) % 7)));
+        return monday.toISOString().slice(0, 10);
+    }
+    return d.toISOString().slice(0, 10);
+}
+function nextBucket(key, by) {
+    if (by === "year")
+        return String(Number(key) + 1);
+    if (by === "month") {
+        const [y, m] = key.split("-").map(Number);
+        return m === 12 ? `${y + 1}-01` : `${y}-${String(m + 1).padStart(2, "0")}`;
+    }
+    const d = new Date(`${key}T00:00:00Z`);
+    d.setUTCDate(d.getUTCDate() + (by === "week" ? 7 : 1));
+    return d.toISOString().slice(0, 10);
+}
+/** Periods in a metric's sparkline (the last one is the current period). */
+export const TREND_PERIODS = 12;
+/** `d` moved by `n` periods; months clamp to the month's last day (31 Mar − 1 month = 28/29 Feb). */
+export function shiftPeriod(d, period, n) {
+    if (period === "week")
+        return new Date(d.getTime() + n * 7 * 86_400_000);
+    const months = n * (period === "month" ? 1 : period === "quarter" ? 3 : 12);
+    const first = new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + months, 1, d.getUTCHours(), d.getUTCMinutes(), d.getUTCSeconds(), d.getUTCMilliseconds()));
+    const last = new Date(Date.UTC(first.getUTCFullYear(), first.getUTCMonth() + 1, 0)).getUTCDate();
+    first.setUTCDate(Math.min(d.getUTCDate(), last));
+    return first;
+}
+/**
+ * Rolling windows ending with today (whole UTC days, so numbers are stable through the day and date-only fields
+ * compare cleanly), oldest first: with period "month" on 1 Oct the last window is [2 Sep, 2 Oct).
+ */
+export function trendWindows(now, period, count = TREND_PERIODS) {
+    const anchor = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate() + 1));
+    return Array.from({ length: count }, (_, k) => {
+        const i = count - 1 - k;
+        return { start: shiftPeriod(anchor, period, -(i + 1)), end: shiftPeriod(anchor, period, -i), asOf: shiftPeriod(now, period, -i) };
+    });
+}
+const toNumber = (v) => (v === null || v === undefined ? 0 : Number(typeof v === "object" ? String(v) : v));
+export class DashboardService {
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+    readable(entity, w, ctx) {
+        if (!authorize(entity, "read", ctx.principal).allowed)
+            return false;
+        if (entity.features.tenant && !ctx.principal?.organizationId)
+            return false;
+        for (const name of [w.field, w.groupBy?.field, ...Object.keys(w.where).map((k) => k.split(".")[0])]) {
+            if (!this.fieldReadable(entity, name, ctx))
+                return false;
+        }
+        return true;
+    }
+    fieldReadable(entity, name, ctx) {
+        const f = entity.fields.find((x) => x.name === name || x.apiName === name);
+        if (!f?.access?.read)
+            return true;
+        const d = evaluate(f.access.read, ctx.principal);
+        return d.allowed && d.scope === "all";
+    }
+    /** `now` is injectable for tests; relative dates in filters ($today…) are resolved against it. */
+    async compute(ctx, now = new Date()) {
+        const dashboard = this.service.app.dashboard;
+        if (!dashboard)
+            return { widgets: null };
+        const out = [];
+        for (const w of dashboard.widgets) {
+            const entity = this.service.entityByName(w.entity);
+            if (!this.readable(entity, w, ctx))
+                continue;
+            const base = { id: w.id, type: w.type, title: w.title, span: w.span, entity: entity.name, path: entity.path, ...(w.aggregate !== "count" && w.field ? { field: w.field } : {}) };
+            try {
+                const access = { ...this.service.queryAccess(entity, ctx), anyField: true };
+                const filters = parseListQuery(entity, resolveTokens(w.where, ctx.principal?.id ?? null, now), access).where;
+                const where = { AND: [...this.service.readWhere(entity, ctx), ...filters] };
+                if (w.type === "metric") {
+                    // The trend is dropped (not the widget) when the viewer can't read the date field it is based on.
+                    const withTrend = w.compare && this.fieldReadable(entity, w.compare.dateField, ctx);
+                    const [value, trend] = await Promise.all([this.aggregate(entity, where, w), withTrend ? this.trend(entity, w, ctx, now) : undefined]);
+                    out.push({ ...base, value, ...(trend ? { trend } : {}) });
+                }
+                else if (w.type === "chart")
+                    out.push({ ...base, chart: w.chart, groupBy: w.groupBy, data: await this.series(entity, where, w) });
+                else {
+                    const rows = await this.service.delegate(entity).findMany({
+                        where,
+                        orderBy: parseSort(entity, w.sort, access),
+                        take: w.limit,
+                        include: relationInclude(entity),
+                    });
+                    out.push({ ...base, columns: w.columns ?? [entity.display, ...entity.list.columns.filter((c) => c !== entity.display).slice(0, 2)], rows: await Promise.all(rows.map((r) => this.service.present(entity, r, ctx))) });
+                }
+            }
+            catch (e) {
+                // One broken widget (e.g. a filter on a renamed field) must not take the whole dashboard down.
+                if (!(e instanceof QueryError))
+                    console.error(`[forge] dashboard widget "${w.title}" failed`, e);
+                out.push({ ...base, error: e instanceof QueryError ? e.message : "This widget could not be loaded" });
+            }
+        }
+        return { widgets: out };
+    }
+    async aggregate(entity, where, w) {
+        const d = this.service.delegate(entity);
+        if (w.aggregate === "count")
+            return d.count({ where });
+        const op = `_${w.aggregate}`;
+        const r = await d.aggregate({ where, [op]: { [w.field]: true } });
+        const v = r[op]?.[w.field];
+        return v === null || v === undefined ? (w.aggregate === "sum" ? 0 : null) : typeof v === "object" ? String(v) : v;
+    }
+    /**
+     * The metric over each of the last TREND_PERIODS rolling periods, within exactly the same row-level, tenant and
+     * owner rules as the value itself; relative dates in the filter ($today…) are resolved as of each period.
+     */
+    async trend(entity, w, ctx, now) {
+        const { period, dateField, trend } = w.compare;
+        const access = { ...this.service.queryAccess(entity, ctx), anyField: true };
+        const scope = this.service.readWhere(entity, ctx);
+        const windows = trendWindows(now, period);
+        const values = await Promise.all(windows.map(async ({ start, end, asOf }) => {
+            const filters = parseListQuery(entity, resolveTokens(w.where, ctx.principal?.id ?? null, asOf), access).where;
+            const v = await this.aggregate(entity, { AND: [...scope, ...filters, { [dateField]: { gte: start, lt: end } }] }, w);
+            return v === null ? null : toNumber(v);
+        }));
+        const current = values.at(-1) ?? null;
+        const previous = values.at(-2) ?? null;
+        const delta = current !== null && previous !== null ? current - previous : null;
+        const direction = !delta ? "flat" : delta > 0 ? "up" : "down";
+        return {
+            period,
+            trend,
+            current,
+            previous,
+            change: delta !== null && previous ? delta / Math.abs(previous) : null,
+            direction,
+            good: direction === "flat" ? null : (direction === "up") === (trend === "up-is-good"),
+            series: windows.map((x, i) => ({ start: x.start.toISOString().slice(0, 10), end: x.end.toISOString().slice(0, 10), value: values[i] ?? null })),
+        };
+    }
+    /** `label` is ready to show (default language); `key` is the raw group value so clients can localize it ("__other" = the rest). */
+    async series(entity, where, w) {
+        const g = w.groupBy;
+        const d = this.service.delegate(entity);
+        const f = entity.fields.find((x) => x.name === g.field);
+        if (g.by) {
+            // Date buckets computed from the rows (keeps every permission rule in the Prisma where).
+            const rows = await d.findMany({ where: { AND: [where, { [g.field]: { not: null } }] }, select: { [g.field]: true, ...(w.field ? { [w.field]: true } : {}) }, orderBy: { [g.field]: "asc" }, take: MAX_BUCKET_ROWS });
+            const buckets = new Map();
+            for (const r of rows) {
+                const key = bucketKey(new Date(r[g.field]), g.by);
+                buckets.set(key, [...(buckets.get(key) ?? []), w.field ? toNumber(r[w.field]) : 1]);
+            }
+            const keys = [...buckets.keys()];
+            if (!keys.length)
+                return [];
+            const out = [];
+            for (let k = keys[0];; k = nextBucket(k, g.by)) {
+                const values = buckets.get(k) ?? [];
+                out.push({ label: k, key: k, value: reduce(values, w.aggregate) });
+                if (k >= keys[keys.length - 1] || out.length > 1000)
+                    break;
+            }
+            return out;
+        }
+        const column = f?.relation ? f.relation.foreignKey : g.field;
+        const grouped = await d.groupBy({
+            by: [column],
+            where,
+            _count: { _all: true },
+            ...(w.aggregate !== "count" ? { [`_${w.aggregate}`]: { [w.field]: true } } : {}),
+        });
+        const value = (r) => (w.aggregate === "count" ? r._count._all : toNumber(r[`_${w.aggregate}`]?.[w.field]));
+        let labels = new Map();
+        if (f?.relation) {
+            const ids = grouped.map((r) => r[column]).filter(Boolean);
+            const target = f.relation.entity === "User" ? this.service.prisma.user : this.service.prisma[f.relation.delegate];
+            const display = f.relation.targetDisplay;
+            const rows = ids.length ? await target.findMany({ where: { id: { in: ids } }, select: { id: true, [display]: true } }) : [];
+            labels = new Map(rows.map((r) => [r.id, String(r[display] ?? r.id)]));
+        }
+        const label = (v) => {
+            if (v === null || v === undefined)
+                return "None";
+            if (f?.enumValues)
+                return f.enumValues.find((e) => e.value === v)?.label ?? String(v);
+            if (f?.kind === "boolean")
+                return v ? "Yes" : "No";
+            return labels.get(String(v)) ?? String(v);
+        };
+        const data = grouped
+            .map((r) => ({ label: label(r[column]), key: r[column] === null || r[column] === undefined ? null : String(r[column]), value: value(r), href: `/${entity.path}?${encodeURIComponent(g.field)}=${r[column] === null ? "null" : encodeURIComponent(String(r[column]))}` }))
+            .sort((a, b) => b.value - a.value);
+        if (data.length <= w.limit)
+            return data;
+        const rest = data.slice(w.limit - 1);
+        return [...data.slice(0, w.limit - 1), { label: "Other", key: "__other", value: rest.reduce((s, x) => s + x.value, 0) }];
+    }
+}
+function reduce(values, aggregate) {
+    if (!values.length)
+        return 0;
+    switch (aggregate) {
+        case "count":
+            return values.length;
+        case "sum":
+            return values.reduce((a, b) => a + b, 0);
+        case "avg":
+            return values.reduce((a, b) => a + b, 0) / values.length;
+        case "min":
+            return Math.min(...values);
+        case "max":
+            return Math.max(...values);
+    }
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/dashboard.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,6 @@
+import { type ArgumentsHost, type ExceptionFilter } from "@nestjs/common";
+/** Normalizes every error into `{ statusCode, error, message, issues? }`, including Prisma errors. */
+export declare class ForgeExceptionFilter implements ExceptionFilter {
+    private readonly logger;
+    catch(exception: unknown, host: ArgumentsHost): void;
+}

package/dist/errors.js

@@ -0,0 +1,55 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Catch, HttpException, Logger } from "@nestjs/common";
+const STATUS_TEXT = { 400: "Bad Request", 404: "Not Found", 409: "Conflict", 500: "Internal Server Error" };
+/** Normalizes every error into `{ statusCode, error, message, issues? }`, including Prisma errors. */
+let ForgeExceptionFilter = class ForgeExceptionFilter {
+    logger = new Logger("Forge");
+    catch(exception, host) {
+        const res = host.switchToHttp().getResponse();
+        if (res.headersSent)
+            return;
+        if (exception instanceof HttpException) {
+            const status = exception.getStatus();
+            const body = exception.getResponse();
+            const payload = typeof body === "string"
+                ? { statusCode: status, error: STATUS_TEXT[status] ?? exception.name, message: body }
+                : { statusCode: status, error: STATUS_TEXT[status] ?? exception.name, ...body };
+            if (Array.isArray(payload.message))
+                payload.message = payload.message.join("; ");
+            res.status(status).json(payload);
+            return;
+        }
+        const code = exception?.code;
+        const meta = exception?.meta;
+        if (code === "P2002") {
+            const fields = Array.isArray(meta?.target) ? meta.target : (meta?.driverAdapterError?.cause?.constraint?.fields ?? (typeof meta?.target === "string" ? [meta.target] : []));
+            const target = fields.map((f) => f.replace(/"/g, "")).filter((t) => t !== "organizationId" && t !== "organization_id").join(", ") || undefined;
+            res.status(409).json({ statusCode: 409, error: "Conflict", message: `A record with this ${target ?? "value"} already exists`, issues: target ? [{ path: String(target), message: "Already taken" }] : [] });
+            return;
+        }
+        if (code === "P2003") {
+            res.status(409).json({ statusCode: 409, error: "Conflict", message: "This record is referenced by other records and cannot be changed or deleted" });
+            return;
+        }
+        if (code === "P2025") {
+            res.status(404).json({ statusCode: 404, error: "Not Found", message: "Record not found" });
+            return;
+        }
+        if (exception?.type === "entity.parse.failed") {
+            res.status(400).json({ statusCode: 400, error: "Bad Request", message: "Malformed JSON body" });
+            return;
+        }
+        this.logger.error(exception instanceof Error ? (exception.stack ?? exception.message) : String(exception));
+        res.status(500).json({ statusCode: 500, error: "Internal Server Error", message: "Something went wrong" });
+    }
+};
+ForgeExceptionFilter = __decorate([
+    Catch()
+], ForgeExceptionFilter);
+export { ForgeExceptionFilter };
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,39 @@
+type Row = Record<string, any>;
+export type ForgeEventAction = "created" | "updated" | "deleted" | "restored" | "transitioned" | "action";
+/**
+ * A domain event, emitted after the database transaction commits.
+ * `type` is "<Entity>.<action>", e.g. "Opportunity.transitioned".
+ */
+export interface ForgeEvent {
+    id: string;
+    type: string;
+    entity: string;
+    recordId: string;
+    action: ForgeEventAction;
+    /** Transition or action name for "transitioned" / "action" events. */
+    name?: string;
+    /** Full record (system view: every field, including ones some users cannot read). */
+    record: Row | null;
+    previous?: Row | null;
+    changes?: Record<string, {
+        from: unknown;
+        to: unknown;
+    }>;
+    actor: {
+        id: string;
+        name?: string;
+    } | null;
+    organizationId: string | null;
+    occurredAt: string;
+}
+export type EventHandler = (event: ForgeEvent) => void | Promise<void>;
+/** Matches "Opportunity.created", "Opportunity.*", "*.deleted" or "*". */
+export declare function eventMatches(pattern: string, type: string): boolean;
+/** In-process event bus. Handlers run sequentially; a failing handler is logged and never breaks the request. */
+export declare class EventBus {
+    private readonly handlers;
+    private readonly logger;
+    on(pattern: string, handler: EventHandler, name?: string): () => void;
+    emit(event: ForgeEvent): Promise<void>;
+}
+export {};

package/dist/events.js

@@ -0,0 +1,36 @@
+import { Logger } from "@nestjs/common";
+/** Matches "Opportunity.created", "Opportunity.*", "*.deleted" or "*". */
+export function eventMatches(pattern, type) {
+    if (pattern === "*" || pattern === type)
+        return true;
+    const [pe, pa] = pattern.split(".");
+    const [te, ta] = type.split(".");
+    return (pe === "*" || pe === te) && (pa === "*" || pa === ta);
+}
+/** In-process event bus. Handlers run sequentially; a failing handler is logged and never breaks the request. */
+export class EventBus {
+    handlers = [];
+    logger = new Logger("ForgeEvents");
+    on(pattern, handler, name = "handler") {
+        const entry = { pattern, handler, name };
+        this.handlers.push(entry);
+        return () => {
+            const i = this.handlers.indexOf(entry);
+            if (i >= 0)
+                this.handlers.splice(i, 1);
+        };
+    }
+    async emit(event) {
+        for (const h of this.handlers) {
+            if (!eventMatches(h.pattern, event.type))
+                continue;
+            try {
+                await h.handler(event);
+            }
+            catch (err) {
+                this.logger.error(`${h.name} failed for ${event.type} ${event.recordId}: ${err instanceof Error ? err.stack : String(err)}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AA6BxC,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,IAAY;IACxD,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,iHAAiH;AACjH,MAAM,OAAO,QAAQ;IACF,QAAQ,GAA+D,EAAE,CAAC;IAC1E,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;IAEpD,EAAE,CAAC,OAAe,EAAE,OAAqB,EAAE,IAAI,GAAG,SAAS;QACzD,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAiB;QAC1B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YACnD,IAAI,CAAC;gBACH,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,eAAe,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/H,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/extension.d.ts

@@ -0,0 +1,103 @@
+import type { EntityIR } from "@tekki-forge/compiler";
+import type { Principal } from "@tekki-forge/runtime-permissions";
+import type { ForgeEvent } from "./events.js";
+import type { MailSender, NotifyInput } from "./notifications.js";
+export interface ForgeRequestContext {
+    principal: Principal | null;
+    user: {
+        id: string;
+        name: string;
+        email: string;
+        role?: string | null;
+    } | null;
+    session: {
+        id: string;
+        activeOrganizationId?: string | null;
+        impersonatedBy?: string | null;
+    } | null;
+    ip?: string;
+    /** Set when the request authenticated with an API key (then `user` and `session` are null). */
+    apiKey?: {
+        id: string;
+        name: string;
+        prefix: string;
+        createdById: string | null;
+    };
+}
+export interface HookContext extends ForgeRequestContext {
+    entity: EntityIR;
+    /** Prisma client — inside before* hooks this is the transaction, so your writes commit or roll back with the record. */
+    prisma: any;
+    /** Create in-app notifications (and optionally emails) for users. */
+    notify(userIds: string[], input: NotifyInput): Promise<number>;
+    /** Templated email (see @tekki-forge/emails); undefined when the app has no mail service. */
+    mail?: MailSender;
+    /** Services shared by plugins, e.g. use<JobQueue>("jobs")?.enqueue("sendReport", { id }). */
+    use<T = unknown>(name: string): T | undefined;
+}
+type Row = Record<string, any>;
+type MaybePromise<T> = T | Promise<T>;
+export interface EntityHooks {
+    /** Return a new data object to replace the input, or nothing to keep it. Throw to reject. */
+    beforeCreate?(ctx: HookContext & {
+        data: Row;
+    }): MaybePromise<Row | void>;
+    afterCreate?(ctx: HookContext & {
+        record: Row;
+    }): MaybePromise<void>;
+    beforeUpdate?(ctx: HookContext & {
+        data: Row;
+        existing: Row;
+    }): MaybePromise<Row | void>;
+    afterUpdate?(ctx: HookContext & {
+        record: Row;
+        previous: Row;
+    }): MaybePromise<void>;
+    beforeDelete?(ctx: HookContext & {
+        record: Row;
+    }): MaybePromise<void>;
+    afterDelete?(ctx: HookContext & {
+        record: Row;
+    }): MaybePromise<void>;
+}
+export interface EntityPolicy {
+    /** Record-level decision for get/update/delete/actions. */
+    check(ctx: HookContext & {
+        record: Row;
+    }): MaybePromise<boolean>;
+    /** Prisma `where` used to filter lists. Without it, the policy grants nothing on lists. */
+    where?(ctx: HookContext): Row | undefined;
+}
+export type ActionHandler = (ctx: HookContext & {
+    record: Row;
+    input: Row;
+}) => MaybePromise<unknown>;
+export interface TransitionHandlers {
+    /** Return false or an explanation to block the transition (e.g. "Add at least one line first"). */
+    guard?(ctx: HookContext & {
+        record: Row;
+        input: Row;
+    }): MaybePromise<boolean | string | void>;
+    /** Runs after the transition is committed. */
+    after?(ctx: HookContext & {
+        record: Row;
+        previous: Row;
+        input: Row;
+    }): MaybePromise<void>;
+}
+export interface EntityExtension {
+    entity: string;
+    hooks?: EntityHooks;
+    actions?: Record<string, ActionHandler>;
+    policies?: Record<string, EntityPolicy>;
+    /** Business rules for workflow transitions declared in forge.config.ts. */
+    transitions?: Record<string, TransitionHandlers>;
+    /** Event subscriptions, e.g. { "Invoice.transitioned": ({ record }) => … } — run after commit. */
+    on?: Record<string, (event: ForgeEvent) => MaybePromise<void>>;
+}
+/**
+ * Developer-owned behavior for an entity. Lives in apps/api/src/modules/<entity>/<entity>.extension.ts
+ * and is never touched by `forge generate`.
+ */
+export declare function defineExtension(entity: string, extension: Omit<EntityExtension, "entity">): EntityExtension;
+export {};

package/dist/extension.js

@@ -0,0 +1,8 @@
+/**
+ * Developer-owned behavior for an entity. Lives in apps/api/src/modules/<entity>/<entity>.extension.ts
+ * and is never touched by `forge generate`.
+ */
+export function defineExtension(entity, extension) {
+    return { entity, ...extension };
+}
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAkEA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,SAA0C;IACxF,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;AAClC,CAAC"}