@metaobjectsdev/runtime-ts 0.5.0-rc.1

package/dist/drizzle-fastify/index.js

@@ -0,0 +1,181 @@
+// Drizzle-direct Fastify adapter — replaces the ObjectManager-flavored
+// mountCrudRoutes for consumers that already use Drizzle directly.
+//
+// Why: most TS apps stay on Drizzle for SQL queries. Routing CRUD through
+// ObjectManager + a Drizzle driver was indirection for no real win — generated
+// routes can just call Drizzle directly and stay self-evident as Drizzle code.
+//
+// What this gives you: one helper, same surface as before, but the runtime
+// dependency is Drizzle + Zod, not ObjectManager.
+//
+//   GET    {path}      list with ?limit / ?offset
+//   GET    {path}/:id  findById, 404 if missing
+//   POST   {path}      create, 400 on Zod validation error
+//   PATCH  {path}/:id  update, 400 on validation, 404 if missing
+//   DELETE {path}/:id  delete, 204 on success, 404 if missing
+import { eq, count, and } from "drizzle-orm";
+import qs from "qs";
+import { parseFilterParams, FilterParseError } from "./filter-parser.js";
+import { isTruthyFlag } from "./util.js";
+export { isTruthyFlag } from "./util.js";
+const ALL_VERBS = ["list", "get", "create", "update", "delete"];
+export function mountCrudRoutes(opts) {
+    const verbs = new Set(opts.expose ?? ALL_VERBS);
+    if (verbs.has("list"))
+        mountListRoute(opts);
+    if (verbs.has("get"))
+        mountGetRoute(opts);
+    if (verbs.has("create"))
+        mountCreateRoute(opts);
+    if (verbs.has("update"))
+        mountUpdateRoute(opts);
+    if (verbs.has("delete"))
+        mountDeleteRoute(opts);
+}
+function routeOpts(opts) {
+    return opts.routeOptions ?? {};
+}
+export function mountListRoute(opts) {
+    opts.fastify.get(opts.path, routeOpts(opts), async (req, reply) => {
+        try {
+            let q = opts.db.select().from(opts.table).$dynamic();
+            // Re-parse the raw URL with qs so bracketed filter notation and the
+            // top-level withCount flag are available.
+            const rawSearch = req.raw.url?.includes("?")
+                ? req.raw.url.slice(req.raw.url.indexOf("?") + 1)
+                : "";
+            const qsParsed = qs.parse(rawSearch);
+            const withCount = isTruthyFlag(qsParsed.withCount);
+            let where;
+            if (opts.filterAllowlist && opts.sortAllowlist) {
+                const parsed = parseFilterParams({
+                    query: qsParsed,
+                    table: opts.table,
+                    allowlist: opts.filterAllowlist,
+                    sortAllowlist: opts.sortAllowlist,
+                    dialect: opts.dialect ?? "sqlite",
+                });
+                const combinedWhere = parsed.where && parsed.searchWhere
+                    ? and(parsed.where, parsed.searchWhere)
+                    : (parsed.where ?? parsed.searchWhere);
+                if (combinedWhere) {
+                    q = q.where(combinedWhere);
+                    where = combinedWhere;
+                }
+                if (parsed.orderBy)
+                    q = q.orderBy(...parsed.orderBy);
+                if (parsed.limit !== undefined)
+                    q = q.limit(parsed.limit);
+                if (parsed.offset !== undefined)
+                    q = q.offset(parsed.offset);
+            }
+            else {
+                // Legacy path — no allowlists configured. Only limit/offset.
+                const { limit, offset } = req.query;
+                if (limit !== undefined)
+                    q = q.limit(Number(limit));
+                if (offset !== undefined)
+                    q = q.offset(Number(offset));
+            }
+            const rows = await q.all();
+            if (!withCount)
+                return rows;
+            // Count query: same WHERE, no limit/offset/orderBy.
+            let cq = opts.db.select({ c: count() }).from(opts.table).$dynamic();
+            if (where)
+                cq = cq.where(where);
+            const countRow = (await cq.all())[0];
+            const total = countRow?.c ?? 0;
+            return { rows, total };
+        }
+        catch (err) {
+            if (err instanceof FilterParseError) {
+                return reply.code(400).send({ error: err.code, ...(err.details ?? {}) });
+            }
+            throw err;
+        }
+    });
+}
+export function mountGetRoute(opts) {
+    opts.fastify.get(`${opts.path}/:id`, routeOpts(opts), async (req, reply) => {
+        const { id } = req.params;
+        const row = await opts.db
+            .select()
+            .from(opts.table)
+            .where(eq(opts.table.id, parseId(id)))
+            .get();
+        return row ?? reply.code(404).send({ error: "not_found" });
+    });
+}
+export function mountCreateRoute(opts) {
+    opts.fastify.post(opts.path, routeOpts(opts), async (req, reply) => {
+        const parsed = opts.insertSchema.safeParse(req.body);
+        if (!parsed.success) {
+            return reply.code(400).send({ error: "validation", issues: parsed.error.issues });
+        }
+        const result = await opts.db.insert(opts.table).values(parsed.data).returning();
+        const row = result[0];
+        return reply.code(201).send(row);
+    });
+}
+export function mountUpdateRoute(opts) {
+    const handler = async (req, reply) => {
+        const { id } = req.params;
+        const parsed = opts.updateSchema.safeParse(req.body);
+        if (!parsed.success) {
+            return reply.code(400).send({ error: "validation", issues: parsed.error.issues });
+        }
+        const result = await opts.db
+            .update(opts.table)
+            .set(parsed.data)
+            .where(eq(opts.table.id, parseId(id)))
+            .returning();
+        const row = result[0];
+        return row ?? reply.code(404).send({ error: "not_found" });
+    };
+    const path = `${opts.path}/:id`;
+    const ro = routeOpts(opts);
+    // biome-ignore lint/suspicious/noExplicitAny: handler signature is generic
+    if (opts.updateMethod === "put") {
+        opts.fastify.put(path, ro, handler);
+    }
+    else {
+        opts.fastify.patch(path, ro, handler);
+    }
+}
+export function mountDeleteRoute(opts) {
+    opts.fastify.delete(`${opts.path}/:id`, routeOpts(opts), async (req, reply) => {
+        const { id } = req.params;
+        const result = await opts.db
+            .delete(opts.table)
+            .where(eq(opts.table.id, parseId(id)));
+        // Both libsql and pg drivers expose a rows-affected counter, in different
+        // shapes. Treat anything > 0 as "found and deleted."
+        const affected = extractRowCount(result);
+        return affected > 0
+            ? reply.code(204).send()
+            : reply.code(404).send({ error: "not_found" });
+    });
+}
+function extractRowCount(result) {
+    if (typeof result === "number")
+        return result;
+    if (Array.isArray(result))
+        return result.length;
+    if (result && typeof result === "object") {
+        const obj = result;
+        if (typeof obj.rowsAffected === "number")
+            return obj.rowsAffected;
+        if (typeof obj.rowsAffected === "bigint")
+            return Number(obj.rowsAffected);
+        if (typeof obj.rowCount === "number")
+            return obj.rowCount;
+    }
+    return 0;
+}
+export function parseId(raw) {
+    const n = Number(raw);
+    return Number.isFinite(n) && raw.trim() !== "" ? n : raw;
+}
+export { mountReadOnlyCrudRoutes } from "./mount-read-only.js";
+//# sourceMappingURL=index.js.map

package/dist/drizzle-fastify/index.js.map

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

package/dist/drizzle-fastify/mount-read-only.d.ts

@@ -0,0 +1,17 @@
+import type { FastifyInstance } from "fastify";
+import type { FilterAllowlist, SortAllowlist } from "./filter-allowlist.js";
+type AnyView = any;
+export interface MountReadOnlyOptions {
+    readonly fastify: FastifyInstance;
+    readonly path: string;
+    readonly db: any;
+    readonly view: AnyView;
+    readonly filterAllowlist: FilterAllowlist;
+    readonly sortAllowlist: SortAllowlist;
+    readonly dialect: "postgres" | "sqlite";
+    /** Override default ID column name (defaults to "id"). */
+    readonly idColumn?: string;
+}
+export declare function mountReadOnlyCrudRoutes(opts: MountReadOnlyOptions): void;
+export {};
+//# sourceMappingURL=mount-read-only.d.ts.map

package/dist/drizzle-fastify/mount-read-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-read-only.d.ts","sourceRoot":"","sources":["../../src/drizzle-fastify/mount-read-only.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI5E,KAAK,OAAO,GAAG,GAAG,CAAC;AAUnB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AA6DD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAgGxE"}

package/dist/drizzle-fastify/mount-read-only.js

@@ -0,0 +1,159 @@
+import { sql, eq, and, count } from "drizzle-orm";
+import qs from "qs";
+import { parseFilterParams, FilterParseError } from "./filter-parser.js";
+import { isTruthyFlag } from "./util.js";
+/**
+ * Drizzle v0.45 stores view config under this well-known Symbol.
+ * Accessing `view._` on a proxy-wrapped view (empty-column .existing()) throws
+ * because the proxy tries to spread `subquery._.selectedFields` which is undefined.
+ * Using the symbol bypasses the proxy entirely.
+ */
+const VIEW_BASE_CONFIG = Symbol.for("drizzle:ViewBaseConfig");
+const REJECT_MUTATION = async (request, reply) => {
+    reply
+        .code(405)
+        .send({ error: "method_not_allowed", message: `${request.method} is not supported on a projection (read-only).` });
+};
+function getViewConfig(view) {
+    try {
+        const cfg = view[VIEW_BASE_CONFIG];
+        if (cfg && typeof cfg === "object")
+            return cfg;
+    }
+    catch {
+        // ignore — proxy handler may throw on unexpected shapes
+    }
+    return undefined;
+}
+function resolveViewName(view) {
+    const cfg = getViewConfig(view);
+    if (cfg) {
+        if (typeof cfg["name"] === "string")
+            return cfg["name"];
+    }
+    // Fallback for non-proxy shapes
+    const v = view;
+    return ((typeof v["__tableName"] === "string" ? v["__tableName"] : undefined) ??
+        (typeof v["_name"] === "string" ? v["_name"] : undefined));
+}
+/**
+ * Detect whether a Drizzle view was declared with `.existing()` and an empty
+ * column schema (`{}`). In that case, `db.select().from(view)` generates
+ * `SELECT  FROM ...` (invalid SQL), and we must fall back to raw SQL.
+ */
+function isEmptyColumnView(view) {
+    const cfg = getViewConfig(view);
+    if (cfg) {
+        const fields = cfg["selectedFields"];
+        return fields !== undefined && Object.keys(fields).length === 0;
+    }
+    return false;
+}
+function snakeToCamel(s) {
+    return s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+/** Normalise a raw SQL result row's keys from snake_case to camelCase. */
+function camelizeRow(row) {
+    const out = {};
+    for (const [k, v] of Object.entries(row)) {
+        out[snakeToCamel(k)] = v;
+    }
+    return out;
+}
+export function mountReadOnlyCrudRoutes(opts) {
+    const { fastify, path, db, view, filterAllowlist, sortAllowlist, dialect } = opts;
+    const idCol = opts.idColumn ?? "id";
+    const viewName = resolveViewName(view);
+    const useRawSql = isEmptyColumnView(view) && !!viewName;
+    // ── List ──────────────────────────────────────────────────────────────────
+    fastify.get(path, async (req, reply) => {
+        try {
+            if (useRawSql) {
+                // .existing() view with no column schema — use raw SQL.
+                // Simple limit/offset only; filter/sort via allowlist is not available
+                // because column refs don't exist. This is sufficient for projection
+                // endpoints that return small full-table results.
+                const url = req.raw.url ?? "";
+                const qIdx = url.indexOf("?");
+                const queryString = qIdx >= 0 ? url.slice(qIdx + 1) : "";
+                const parsed = qs.parse(queryString);
+                const limitVal = Math.min(1000, Math.max(1, Number(typeof parsed["limit"] === "string" ? parsed["limit"] : 1000)));
+                const offsetVal = Math.max(0, Number(typeof parsed["offset"] === "string" ? parsed["offset"] : 0));
+                const withCount = isTruthyFlag(parsed["withCount"]);
+                // biome-ignore lint/suspicious/noExplicitAny: dynamic raw result
+                const rows = await db.all(sql.raw(`SELECT * FROM "${viewName}" LIMIT ${limitVal} OFFSET ${offsetVal}`));
+                const camelRows = rows.map((r) => camelizeRow(r));
+                if (!withCount)
+                    return camelRows;
+                // biome-ignore lint/suspicious/noExplicitAny: dynamic raw result
+                const countRows = await db.all(sql.raw(`SELECT COUNT(*) AS c FROM "${viewName}"`));
+                const total = Number(countRows[0]?.c ?? 0);
+                return { rows: camelRows, total };
+            }
+            const url = req.raw.url ?? "";
+            const qIdx = url.indexOf("?");
+            const queryString = qIdx >= 0 ? url.slice(qIdx + 1) : "";
+            const parsed = qs.parse(queryString);
+            const withCount = isTruthyFlag(parsed["withCount"]);
+            const result = parseFilterParams({
+                query: parsed,
+                table: view,
+                allowlist: filterAllowlist,
+                sortAllowlist,
+                dialect,
+            });
+            const combinedWhere = result.where && result.searchWhere
+                ? and(result.where, result.searchWhere)
+                : (result.where ?? result.searchWhere);
+            let q = db.select().from(view);
+            if (combinedWhere)
+                q = q.where(combinedWhere);
+            if (result.orderBy)
+                q = q.orderBy(...result.orderBy);
+            if (result.limit !== undefined)
+                q = q.limit(result.limit);
+            if (result.offset !== undefined)
+                q = q.offset(result.offset);
+            const rows = await q.all();
+            if (!withCount)
+                return rows;
+            // Count query: same WHERE, no limit/offset/orderBy.
+            let cq = db.select({ c: count() }).from(view);
+            if (combinedWhere)
+                cq = cq.where(combinedWhere);
+            const countRow = (await cq.all())[0];
+            const total = countRow?.c ?? 0;
+            return { rows, total };
+        }
+        catch (err) {
+            if (err instanceof FilterParseError) {
+                reply.code(400).send({ error: err.code, message: err.message });
+                return;
+            }
+            throw err;
+        }
+    });
+    // ── Get by ID ─────────────────────────────────────────────────────────────
+    fastify.get(`${path}/:id`, async (req, reply) => {
+        const { id } = req.params;
+        if (useRawSql) {
+            const numericId = Number(id);
+            if (!Number.isFinite(numericId)) {
+                return reply.code(400).send({ error: "invalid_id" });
+            }
+            // biome-ignore lint/suspicious/noExplicitAny: dynamic raw result
+            const rows = await db.all(sql.raw(`SELECT * FROM "${viewName}" WHERE "${idCol}" = ${numericId} LIMIT 1`));
+            const row = rows[0] ? camelizeRow(rows[0]) : undefined;
+            return row ?? reply.code(404).send({ error: "not_found" });
+        }
+        // biome-ignore lint/suspicious/noExplicitAny: Drizzle table/view column ref
+        const colRef = view[idCol];
+        const row = await db.select().from(view).where(colRef !== undefined ? eq(colRef, Number(id)) : undefined).get();
+        return row ?? reply.code(404).send({ error: "not_found" });
+    });
+    // ── Mutations explicitly rejected (405) ───────────────────────────────────
+    fastify.post(path, REJECT_MUTATION);
+    fastify.patch(`${path}/:id`, REJECT_MUTATION);
+    fastify.delete(`${path}/:id`, REJECT_MUTATION);
+}
+//# sourceMappingURL=mount-read-only.js.map

package/dist/drizzle-fastify/mount-read-only.js.map

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

package/dist/drizzle-fastify/util.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared utilities for drizzle-fastify route helpers.
+ */
+export declare function isTruthyFlag(v: unknown): boolean;
+//# sourceMappingURL=util.d.ts.map

package/dist/drizzle-fastify/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/drizzle-fastify/util.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAIhD"}

package/dist/drizzle-fastify/util.js

@@ -0,0 +1,12 @@
+/**
+ * Shared utilities for drizzle-fastify route helpers.
+ */
+// Accepts "1" or boolean true (the qs serialization of withCount: 1 from buildFilterQs).
+export function isTruthyFlag(v) {
+    if (v === undefined || v === null)
+        return false;
+    if (typeof v === "boolean")
+        return v;
+    return String(v) === "1";
+}
+//# sourceMappingURL=util.js.map

package/dist/drizzle-fastify/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/drizzle-fastify/util.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;AAC3B,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,68 @@
+export interface ValidationFailure {
+    field: string;
+    rule: string;
+    message: string;
+    expected?: unknown;
+    received?: unknown;
+}
+interface BaseOpts {
+    code?: string;
+    entity?: string;
+    cause?: unknown;
+}
+export declare class RuntimeError extends Error {
+    readonly code: string;
+    readonly entity?: string;
+    readonly cause?: unknown;
+    constructor(message: string, opts: BaseOpts & {
+        code: string;
+    });
+    toJSON(): Record<string, unknown>;
+}
+export declare class ValidationError extends RuntimeError {
+    readonly errors: ValidationFailure[];
+    constructor(message: string, opts: {
+        entity?: string;
+        errors: ValidationFailure[];
+        cause?: unknown;
+    });
+    toJSON(): Record<string, unknown>;
+}
+export declare class NotFoundError extends RuntimeError {
+    readonly id: unknown;
+    constructor(message: string, opts: {
+        entity: string;
+        id: unknown;
+        cause?: unknown;
+    });
+    toJSON(): Record<string, unknown>;
+}
+export declare class ConstraintViolationError extends RuntimeError {
+    readonly kind: "unique" | "foreign_key" | "not_null" | "check";
+    readonly table: string;
+    readonly field?: string;
+    readonly detail?: string;
+    constructor(message: string, opts: {
+        kind: "unique" | "foreign_key" | "not_null" | "check";
+        table: string;
+        field?: string;
+        detail?: string;
+        cause?: unknown;
+    });
+    toJSON(): Record<string, unknown>;
+}
+export declare class MetadataError extends RuntimeError {
+    constructor(message: string, opts?: {
+        entity?: string;
+        cause?: unknown;
+    });
+}
+export declare class UnsafeNameError extends RuntimeError {
+    readonly value: string;
+    constructor(message: string, opts: {
+        value: string;
+    });
+    toJSON(): Record<string, unknown>;
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,QAAQ;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAQ9D,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKlC;AAED,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;gBAEzB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;IAM3F,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG3C;AAED,qBAAa,aAAc,SAAQ,YAAY;IAC7C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;gBAET,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;IAM1E,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG3C;AAED,qBAAa,wBAAyB,SAAQ,YAAY;IACxD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QACjC,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC;QACtD,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;IASQ,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM3C;AAED,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAI7E;AAED,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAM3C,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG3C"}

package/dist/errors.js

@@ -0,0 +1,86 @@
+// All errors extend RuntimeError and JSON-serialize via toJSON() — admin UIs and MCP tools
+// surface them as structured JSON, not Error.message strings.
+export class RuntimeError extends Error {
+    code;
+    entity;
+    cause;
+    constructor(message, opts) {
+        super(message);
+        this.name = "RuntimeError";
+        this.code = opts.code;
+        if (opts.entity !== undefined)
+            this.entity = opts.entity;
+        if (opts.cause !== undefined)
+            this.cause = opts.cause;
+    }
+    toJSON() {
+        const out = { name: this.name, code: this.code, message: this.message };
+        if (this.entity !== undefined)
+            out.entity = this.entity;
+        return out;
+    }
+}
+export class ValidationError extends RuntimeError {
+    errors;
+    constructor(message, opts) {
+        super(message, { code: "validation_failed", ...(opts.entity !== undefined ? { entity: opts.entity } : {}), ...(opts.cause !== undefined ? { cause: opts.cause } : {}) });
+        this.name = "ValidationError";
+        this.errors = opts.errors;
+    }
+    toJSON() {
+        return { ...super.toJSON(), errors: this.errors };
+    }
+}
+export class NotFoundError extends RuntimeError {
+    id;
+    constructor(message, opts) {
+        super(message, { code: "not_found", entity: opts.entity, ...(opts.cause !== undefined ? { cause: opts.cause } : {}) });
+        this.name = "NotFoundError";
+        this.id = opts.id;
+    }
+    toJSON() {
+        return { ...super.toJSON(), id: this.id };
+    }
+}
+export class ConstraintViolationError extends RuntimeError {
+    kind;
+    table;
+    field;
+    detail;
+    constructor(message, opts) {
+        super(message, { code: "constraint_violation", ...(opts.cause !== undefined ? { cause: opts.cause } : {}) });
+        this.name = "ConstraintViolationError";
+        this.kind = opts.kind;
+        this.table = opts.table;
+        if (opts.field !== undefined)
+            this.field = opts.field;
+        if (opts.detail !== undefined)
+            this.detail = opts.detail;
+    }
+    toJSON() {
+        const out = { ...super.toJSON(), kind: this.kind, table: this.table };
+        if (this.field !== undefined)
+            out.field = this.field;
+        if (this.detail !== undefined)
+            out.detail = this.detail;
+        return out;
+    }
+}
+export class MetadataError extends RuntimeError {
+    constructor(message, opts = {}) {
+        super(message, { code: "metadata_error", ...(opts.entity !== undefined ? { entity: opts.entity } : {}), ...(opts.cause !== undefined ? { cause: opts.cause } : {}) });
+        this.name = "MetadataError";
+    }
+}
+export class UnsafeNameError extends RuntimeError {
+    value;
+    constructor(message, opts) {
+        super(message, { code: "unsafe_name" });
+        this.name = "UnsafeNameError";
+        this.value = opts.value;
+    }
+    toJSON() {
+        return { ...super.toJSON(), value: this.value };
+    }
+}
+//# 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/fastify/index.d.ts

@@ -0,0 +1,65 @@
+import type { FastifyInstance } from "fastify";
+import type { ZodTypeAny } from "zod";
+import type { ObjectManager } from "../object-manager.js";
+import type { RouteShorthandOptions } from "fastify";
+export type CrudVerb = "list" | "get" | "create" | "update" | "delete";
+export interface CrudRoutesOptions {
+    fastify: FastifyInstance;
+    /** REST resource path, e.g. "/subscribers". */
+    path: string;
+    /** Entity name from metadata, e.g. "Subscriber". */
+    entity: string;
+    /** Zod schema for create payloads (typically `<Entity>InsertSchema`). */
+    insertSchema: ZodTypeAny;
+    /** Zod schema for update payloads (typically `<Entity>UpdateSchema`). */
+    updateSchema: ZodTypeAny;
+    /**
+     * ObjectManager accessor. A function rather than the instance so callers
+     * can keep their lazy-init pattern (load metadata once at startup).
+     */
+    om: () => Promise<ObjectManager>;
+    /**
+     * Limit which verbs are mounted. Defaults to all five. Useful for
+     * read-only resources (`expose: ["list", "get"]`).
+     */
+    expose?: readonly CrudVerb[];
+    /**
+     * Fastify route-level hooks applied to every mounted verb. The most common
+     * use is `preHandler` for auth/authz:
+     *
+     *   routeOptions: { preHandler: requireAdminAuth }
+     *
+     * Anything Fastify accepts on a route options object is valid here
+     * (preHandler, onRequest, preValidation, preParsing, schema, etc.).
+     */
+    routeOptions?: RouteShorthandOptions;
+    /**
+     * HTTP method for the update verb. Defaults to "patch" (semantic partial-
+     * update). Set to "put" to preserve a legacy API contract that already
+     * uses PUT for updates.
+     */
+    updateMethod?: "patch" | "put";
+}
+/**
+ * Mount the 5 standard REST endpoints for an entity:
+ *
+ *   GET    {path}      → list, with ?limit & ?offset query params
+ *   GET    {path}/:id  → findById
+ *   POST   {path}      → create (validated via insertSchema)
+ *   PATCH  {path}/:id  → partial update (validated via updateSchema)
+ *   DELETE {path}/:id  → delete
+ */
+export declare function mountCrudRoutes(opts: CrudRoutesOptions): void;
+type SingleVerbOptions = Omit<CrudRoutesOptions, "expose">;
+export declare function mountListRoute(opts: SingleVerbOptions): void;
+export declare function mountGetRoute(opts: SingleVerbOptions): void;
+export declare function mountCreateRoute(opts: SingleVerbOptions): void;
+export declare function mountUpdateRoute(opts: SingleVerbOptions): void;
+export declare function mountDeleteRoute(opts: SingleVerbOptions): void;
+/**
+ * Coerce a `:id` path param. Numeric strings parse as Number (covers long/int
+ * PKs); anything else passes through as a string (UUIDs, string keys).
+ */
+export declare function parseId(raw: string): number | string;
+export {};
+//# sourceMappingURL=index.d.ts.map