@metaobjectsdev/runtime-ts 0.7.0-rc.8 → 0.7.0-rc.9

package/dist/hono/index.d.ts

@@ -0,0 +1,44 @@
+import type { Hono, Context } from "hono";
+import type { ZodTypeAny } from "zod";
+import type { FilterAllowlist, SortAllowlist } from "../drizzle-fastify/filter-allowlist.js";
+export type { FilterAllowlist, SortAllowlist, } from "../drizzle-fastify/filter-allowlist.js";
+type AnyDrizzle = any;
+type AnyTable = any;
+type AnyHono = Hono<any, any, any>;
+export type CrudVerb = "list" | "get" | "create" | "update" | "delete";
+export interface CrudRoutesOptions {
+    /** Hono app instance. Bindings type is the consumer's — kept generic here. */
+    app: AnyHono;
+    /** REST resource path, e.g. "/subscribers". */
+    path: string;
+    /** User's Drizzle instance. */
+    db: AnyDrizzle;
+    /** Drizzle table const. Must expose an `id` column. */
+    table: AnyTable;
+    /** Zod schema for create payloads (typically `<Entity>InsertSchema`). */
+    insertSchema: ZodTypeAny;
+    /** Zod schema for update payloads (typically `<Entity>UpdateSchema`). */
+    updateSchema: ZodTypeAny;
+    /** Limit which verbs are mounted. Defaults to all five. */
+    expose?: readonly CrudVerb[];
+    /**
+     * HTTP method for the update verb. Defaults to "patch". Set to "put" to
+     * preserve a legacy API contract that already uses PUT for updates.
+     */
+    updateMethod?: "patch" | "put";
+    filterAllowlist?: FilterAllowlist;
+    sortAllowlist?: SortAllowlist;
+    /** Dialect — required if filterAllowlist or sortAllowlist is set (for like/ilike dispatch). */
+    dialect?: "sqlite" | "postgres";
+}
+export declare function mountCrudRoutes(opts: CrudRoutesOptions): void;
+type VerbOptions = Omit<CrudRoutesOptions, "expose">;
+export declare function parseHonoFilterParams(c: Context): Record<string, unknown>;
+export declare function mountListRoute(opts: VerbOptions): void;
+export declare function mountGetRoute(opts: VerbOptions): void;
+export declare function mountCreateRoute(opts: VerbOptions): void;
+export declare function mountUpdateRoute(opts: VerbOptions): void;
+export declare function mountDeleteRoute(opts: VerbOptions): void;
+export declare function parseId(raw: string): number | string;
+export { mountReadOnlyCrudRoutes, type MountReadOnlyOptions } from "./mount-read-only.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hono/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hono/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAQtC,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACd,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,eAAe,EACf,aAAa,GACd,MAAM,wCAAwC,CAAC;AAShD,KAAK,UAAU,GAAG,GAAG,CAAC;AAEtB,KAAK,QAAQ,GAAG,GAAG,CAAC;AAEpB,KAAK,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAEnC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,GAAG,EAAE,OAAO,CAAC;IACb,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,uDAAuD;IACvD,KAAK,EAAE,QAAQ,CAAC;IAChB,yEAAyE;IACzE,YAAY,EAAE,UAAU,CAAC;IACzB,yEAAyE;IACzE,YAAY,EAAE,UAAU,CAAC;IACzB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC/B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,aAAa,CAAC,EAAI,aAAa,CAAC;IAChC,+FAA+F;IAC/F,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACjC;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAO7D;AAED,KAAK,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AAWrD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CA+CtD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAUrD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAWxD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAsBxD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAaxD;AAcD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAGpD;AAED,OAAO,EAAE,uBAAuB,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/hono/index.js

@@ -0,0 +1,188 @@
+// Drizzle-direct Hono adapter — Hono parallel of the drizzle-fastify mount
+// helpers. Aimed at Workers / Bun / Node consumers running Hono on top of
+// a Drizzle instance.
+//
+// Wire-format-identical to the Fastify flavor:
+//
+//   GET    {path}      list with ?filter / ?sort / ?limit / ?offset / ?withCount=1
+//   GET    {path}/:id  findById, 404 if missing
+//   POST   {path}      create, 400 on Zod validation error, 201 on success
+//   PATCH  {path}/:id  update (default), 400 / 404 envelopes
+//   PUT    {path}/:id  update (when updateMethod === "put")
+//   DELETE {path}/:id  delete, 204 on success, 404 if missing
+//
+// Filter / sort / withCount semantics are shared with drizzle-fastify via
+// parseFilterParams and parseHonoFilterParams (qs.parse on the raw URL),
+// so the two flavors emit byte-identical wire responses for the cross-port
+// API-contract corpus.
+import { eq, count, and } from "drizzle-orm";
+import qs from "qs";
+import { parseFilterParams, FilterParseError, } from "../drizzle-fastify/filter-parser.js";
+import { isTruthyFlag } from "../drizzle-fastify/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);
+}
+// ---------------------------------------------------------------------------
+// Hono-flavored qs.parse — analogue of Fastify's qs.parse(req.raw.url ...).
+//
+// Hono exposes the raw URL via c.req.url; we strip the prefix and feed the
+// raw query string to qs so the bracketed filter notation (filter[a][eq]=...)
+// is recognised. The plain c.req.query() helper drops bracket structure, so
+// it can't replace this.
+// ---------------------------------------------------------------------------
+export function parseHonoFilterParams(c) {
+    const url = c.req.url;
+    const qIdx = url.indexOf("?");
+    const queryString = qIdx >= 0 ? url.slice(qIdx + 1) : "";
+    return qs.parse(queryString);
+}
+export function mountListRoute(opts) {
+    opts.app.get(opts.path, async (c) => {
+        try {
+            let q = opts.db.select().from(opts.table).$dynamic();
+            const qsParsed = parseHonoFilterParams(c);
+            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 {
+                // No allowlists configured. Only limit/offset.
+                const flat = c.req.query();
+                if (flat.limit !== undefined)
+                    q = q.limit(Number(flat.limit));
+                if (flat.offset !== undefined)
+                    q = q.offset(Number(flat.offset));
+            }
+            const rows = await q.all();
+            if (!withCount)
+                return c.json(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 c.json({ rows, total });
+        }
+        catch (err) {
+            if (err instanceof FilterParseError) {
+                return c.json({ error: err.code, ...(err.details ?? {}) }, 400);
+            }
+            throw err;
+        }
+    });
+}
+export function mountGetRoute(opts) {
+    opts.app.get(`${opts.path}/:id`, async (c) => {
+        const id = c.req.param("id") ?? "";
+        const row = await opts.db
+            .select()
+            .from(opts.table)
+            .where(eq(opts.table.id, parseId(id)))
+            .get();
+        return row ? c.json(row) : c.json({ error: "not_found" }, 404);
+    });
+}
+export function mountCreateRoute(opts) {
+    opts.app.post(opts.path, async (c) => {
+        const body = await c.req.json().catch(() => undefined);
+        const parsed = opts.insertSchema.safeParse(body);
+        if (!parsed.success) {
+            return c.json({ error: "validation", issues: parsed.error.issues }, 400);
+        }
+        const result = await opts.db.insert(opts.table).values(parsed.data).returning();
+        const row = result[0];
+        return c.json(row, 201);
+    });
+}
+export function mountUpdateRoute(opts) {
+    const handler = async (c) => {
+        const id = c.req.param("id") ?? "";
+        const body = await c.req.json().catch(() => undefined);
+        const parsed = opts.updateSchema.safeParse(body);
+        if (!parsed.success) {
+            return c.json({ error: "validation", issues: parsed.error.issues }, 400);
+        }
+        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 ? c.json(row) : c.json({ error: "not_found" }, 404);
+    };
+    const path = `${opts.path}/:id`;
+    if (opts.updateMethod === "put") {
+        opts.app.put(path, handler);
+    }
+    else {
+        opts.app.patch(path, handler);
+    }
+}
+export function mountDeleteRoute(opts) {
+    opts.app.delete(`${opts.path}/:id`, async (c) => {
+        const id = c.req.param("id") ?? "";
+        const result = await opts.db
+            .delete(opts.table)
+            .where(eq(opts.table.id, parseId(id)));
+        const affected = extractRowCount(result);
+        if (affected > 0) {
+            // 204 No Content — body must be empty.
+            return c.body(null, 204);
+        }
+        return c.json({ error: "not_found" }, 404);
+    });
+}
+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/hono/index.js.map

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

package/dist/hono/mount-read-only.d.ts

@@ -0,0 +1,18 @@
+import type { Hono } from "hono";
+import type { FilterAllowlist, SortAllowlist } from "../drizzle-fastify/filter-allowlist.js";
+type AnyView = any;
+type AnyHono = Hono<any, any, any>;
+export interface MountReadOnlyOptions {
+    readonly app: AnyHono;
+    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/hono/mount-read-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-read-only.d.ts","sourceRoot":"","sources":["../../src/hono/mount-read-only.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAIjC,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACd,MAAM,wCAAwC,CAAC;AAIhD,KAAK,OAAO,GAAG,GAAG,CAAC;AAEnB,KAAK,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AASnC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,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;AA6CD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CA0GxE"}

package/dist/hono/mount-read-only.js

@@ -0,0 +1,151 @@
+// Hono read-only mount — projection (view-backed) entities. GET list +
+// GET :id only. POST/PATCH/DELETE return 405. Mirrors the drizzle-fastify
+// equivalent so the cross-port API contract holds for projection endpoints.
+import { sql, eq, and, count } from "drizzle-orm";
+import qs from "qs";
+import { parseFilterParams, FilterParseError } from "../drizzle-fastify/filter-parser.js";
+import { isTruthyFlag } from "../drizzle-fastify/util.js";
+/**
+ * Drizzle v0.45 stores view config under this well-known Symbol. Mirrors
+ * the same workaround the Fastify mount uses — accessing `view._` on a
+ * proxy-wrapped view throws.
+ */
+const VIEW_BASE_CONFIG = Symbol.for("drizzle:ViewBaseConfig");
+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"];
+    }
+    const v = view;
+    return ((typeof v["__tableName"] === "string" ? v["__tableName"] : undefined) ??
+        (typeof v["_name"] === "string" ? v["_name"] : undefined));
+}
+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());
+}
+function camelizeRow(row) {
+    const out = {};
+    for (const [k, v] of Object.entries(row)) {
+        out[snakeToCamel(k)] = v;
+    }
+    return out;
+}
+export function mountReadOnlyCrudRoutes(opts) {
+    const { app, path, db, view, filterAllowlist, sortAllowlist, dialect } = opts;
+    const idCol = opts.idColumn ?? "id";
+    const viewName = resolveViewName(view);
+    const useRawSql = isEmptyColumnView(view) && !!viewName;
+    // ── List ──────────────────────────────────────────────────────────────────
+    app.get(path, async (c) => {
+        try {
+            if (useRawSql) {
+                const url = c.req.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 c.json(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 c.json({ rows: camelRows, total });
+            }
+            const url = c.req.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 c.json(rows);
+            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 c.json({ rows, total });
+        }
+        catch (err) {
+            if (err instanceof FilterParseError) {
+                return c.json({ error: err.code, message: err.message }, 400);
+            }
+            throw err;
+        }
+    });
+    // ── Get by ID ─────────────────────────────────────────────────────────────
+    app.get(`${path}/:id`, async (c) => {
+        const id = c.req.param("id") ?? "";
+        if (useRawSql) {
+            const numericId = Number(id);
+            if (!Number.isFinite(numericId)) {
+                return c.json({ error: "invalid_id" }, 400);
+            }
+            // 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 ? c.json(row) : c.json({ error: "not_found" }, 404);
+        }
+        // biome-ignore lint/suspicious/noExplicitAny: Drizzle 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 ? c.json(row) : c.json({ error: "not_found" }, 404);
+    });
+    // ── Mutations explicitly rejected (405) ───────────────────────────────────
+    const reject = (c) => c.json({ error: "method_not_allowed", message: `${c.req.method} is not supported on a projection (read-only).` }, 405);
+    // biome-ignore lint/suspicious/noExplicitAny: cross-version Hono typing
+    app.post(path, reject);
+    // biome-ignore lint/suspicious/noExplicitAny: cross-version Hono typing
+    app.patch(`${path}/:id`, reject);
+    // biome-ignore lint/suspicious/noExplicitAny: cross-version Hono typing
+    app.delete(`${path}/:id`, reject);
+}
+//# sourceMappingURL=mount-read-only.js.map

package/dist/hono/mount-read-only.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/runtime-ts",
-  "version": "0.7.0-rc.8",
+  "version": "0.7.0-rc.9",
   "description": "Node-side runtime helpers for MetaObjects: Fastify route builders, Drizzle filter/sort integration, Kysely drivers.",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,6 +25,11 @@
       "bun": "./src/drizzle-fastify/index.ts",
       "types": "./dist/drizzle-fastify/index.d.ts",
       "default": "./dist/drizzle-fastify/index.js"
+    },
+    "./hono": {
+      "bun": "./src/hono/index.ts",
+      "types": "./dist/hono/index.d.ts",
+      "default": "./dist/hono/index.js"
     }
   },
   "files": ["dist", "src", "README.md", "LICENSE"],
@@ -48,12 +53,13 @@
 "access": "public"
 },
 "dependencies": {
-  "@metaobjectsdev/metadata": "0.7.0-rc.8",
+  "@metaobjectsdev/metadata": "0.7.0-rc.9",
   "qs": "^6.13.0"
 },
 "peerDependencies": {
   "drizzle-orm": ">=0.36.0",
   "fastify": ">=5.0.0",
+  "hono": ">=4.0.0",
   "kysely": ">=0.27.0",
   "zod": ">=3.23.0"
 },
@@ -64,6 +70,9 @@
   "fastify": {
     "optional": true
   },
+  "hono": {
+    "optional": true
+  },
   "kysely": {
     "optional": true
   },
@@ -78,6 +87,7 @@
   "bun-types": "latest",
   "drizzle-orm": "^0.45.1",
   "fastify": "^5.6.2",
+  "hono": "^4.6.0",
   "jsdom": "^29.1.1",
   "kysely": "^0.27.0",
   "pg-mem": "^3.0.4",

package/src/hono/index.ts

@@ -0,0 +1,237 @@
+// Drizzle-direct Hono adapter — Hono parallel of the drizzle-fastify mount
+// helpers. Aimed at Workers / Bun / Node consumers running Hono on top of
+// a Drizzle instance.
+//
+// Wire-format-identical to the Fastify flavor:
+//
+//   GET    {path}      list with ?filter / ?sort / ?limit / ?offset / ?withCount=1
+//   GET    {path}/:id  findById, 404 if missing
+//   POST   {path}      create, 400 on Zod validation error, 201 on success
+//   PATCH  {path}/:id  update (default), 400 / 404 envelopes
+//   PUT    {path}/:id  update (when updateMethod === "put")
+//   DELETE {path}/:id  delete, 204 on success, 404 if missing
+//
+// Filter / sort / withCount semantics are shared with drizzle-fastify via
+// parseFilterParams and parseHonoFilterParams (qs.parse on the raw URL),
+// so the two flavors emit byte-identical wire responses for the cross-port
+// API-contract corpus.
+
+import type { Hono, Context } from "hono";
+import type { ZodTypeAny } from "zod";
+import { eq, count, and } from "drizzle-orm";
+import qs from "qs";
+import {
+  parseFilterParams,
+  FilterParseError,
+  type ParseFilterResult,
+} from "../drizzle-fastify/filter-parser.js";
+import type {
+  FilterAllowlist,
+  SortAllowlist,
+} from "../drizzle-fastify/filter-allowlist.js";
+export type {
+  FilterAllowlist,
+  SortAllowlist,
+} from "../drizzle-fastify/filter-allowlist.js";
+import { isTruthyFlag } from "../drizzle-fastify/util.js";
+
+// ---------------------------------------------------------------------------
+// Loose types — we don't bind to a specific Drizzle backend so the helper
+// works across libsql / better-sqlite3 / D1 / pg / etc.
+// ---------------------------------------------------------------------------
+
+// biome-ignore lint/suspicious/noExplicitAny: dynamic dispatch over user's Drizzle instance
+type AnyDrizzle = any;
+// biome-ignore lint/suspicious/noExplicitAny: dynamic dispatch over user's Drizzle table
+type AnyTable = any;
+// biome-ignore lint/suspicious/noExplicitAny: generic Hono app — bindings/variables are the consumer's
+type AnyHono = Hono<any, any, any>;
+
+export type CrudVerb = "list" | "get" | "create" | "update" | "delete";
+
+export interface CrudRoutesOptions {
+  /** Hono app instance. Bindings type is the consumer's — kept generic here. */
+  app: AnyHono;
+  /** REST resource path, e.g. "/subscribers". */
+  path: string;
+  /** User's Drizzle instance. */
+  db: AnyDrizzle;
+  /** Drizzle table const. Must expose an `id` column. */
+  table: AnyTable;
+  /** Zod schema for create payloads (typically `<Entity>InsertSchema`). */
+  insertSchema: ZodTypeAny;
+  /** Zod schema for update payloads (typically `<Entity>UpdateSchema`). */
+  updateSchema: ZodTypeAny;
+  /** Limit which verbs are mounted. Defaults to all five. */
+  expose?: readonly CrudVerb[];
+  /**
+   * HTTP method for the update verb. Defaults to "patch". Set to "put" to
+   * preserve a legacy API contract that already uses PUT for updates.
+   */
+  updateMethod?: "patch" | "put";
+  filterAllowlist?: FilterAllowlist;
+  sortAllowlist?:   SortAllowlist;
+  /** Dialect — required if filterAllowlist or sortAllowlist is set (for like/ilike dispatch). */
+  dialect?: "sqlite" | "postgres";
+}
+
+const ALL_VERBS: readonly CrudVerb[] = ["list", "get", "create", "update", "delete"];
+
+export function mountCrudRoutes(opts: CrudRoutesOptions): void {
+  const verbs = new Set<CrudVerb>(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);
+}
+
+type VerbOptions = Omit<CrudRoutesOptions, "expose">;
+
+// ---------------------------------------------------------------------------
+// Hono-flavored qs.parse — analogue of Fastify's qs.parse(req.raw.url ...).
+//
+// Hono exposes the raw URL via c.req.url; we strip the prefix and feed the
+// raw query string to qs so the bracketed filter notation (filter[a][eq]=...)
+// is recognised. The plain c.req.query() helper drops bracket structure, so
+// it can't replace this.
+// ---------------------------------------------------------------------------
+
+export function parseHonoFilterParams(c: Context): Record<string, unknown> {
+  const url = c.req.url;
+  const qIdx = url.indexOf("?");
+  const queryString = qIdx >= 0 ? url.slice(qIdx + 1) : "";
+  return qs.parse(queryString) as Record<string, unknown>;
+}
+
+export function mountListRoute(opts: VerbOptions): void {
+  opts.app.get(opts.path, async (c) => {
+    try {
+      let q = opts.db.select().from(opts.table).$dynamic();
+      const qsParsed = parseHonoFilterParams(c);
+      const withCount = isTruthyFlag(qsParsed.withCount);
+
+      let where: ParseFilterResult["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 {
+        // No allowlists configured. Only limit/offset.
+        const flat = c.req.query();
+        if (flat.limit  !== undefined) q = q.limit(Number(flat.limit));
+        if (flat.offset !== undefined) q = q.offset(Number(flat.offset));
+      }
+
+      const rows = await q.all();
+
+      if (!withCount) return c.json(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] as { c: number } | undefined;
+      const total = countRow?.c ?? 0;
+      return c.json({ rows, total });
+    } catch (err) {
+      if (err instanceof FilterParseError) {
+        return c.json({ error: err.code, ...(err.details ?? {}) }, 400);
+      }
+      throw err;
+    }
+  });
+}
+
+export function mountGetRoute(opts: VerbOptions): void {
+  opts.app.get(`${opts.path}/:id`, async (c) => {
+    const id = c.req.param("id") ?? "";
+    const row = await opts.db
+      .select()
+      .from(opts.table)
+      .where(eq(opts.table.id, parseId(id)))
+      .get();
+    return row ? c.json(row) : c.json({ error: "not_found" }, 404);
+  });
+}
+
+export function mountCreateRoute(opts: VerbOptions): void {
+  opts.app.post(opts.path, async (c) => {
+    const body = await c.req.json().catch(() => undefined);
+    const parsed = opts.insertSchema.safeParse(body);
+    if (!parsed.success) {
+      return c.json({ error: "validation", issues: parsed.error.issues }, 400);
+    }
+    const result = await opts.db.insert(opts.table).values(parsed.data).returning();
+    const row = (result as unknown[])[0];
+    return c.json(row, 201);
+  });
+}
+
+export function mountUpdateRoute(opts: VerbOptions): void {
+  const handler = async (c: Context) => {
+    const id = c.req.param("id") ?? "";
+    const body = await c.req.json().catch(() => undefined);
+    const parsed = opts.updateSchema.safeParse(body);
+    if (!parsed.success) {
+      return c.json({ error: "validation", issues: parsed.error.issues }, 400);
+    }
+    const result = await opts.db
+      .update(opts.table)
+      .set(parsed.data)
+      .where(eq(opts.table.id, parseId(id)))
+      .returning();
+    const row = (result as unknown[])[0];
+    return row ? c.json(row) : c.json({ error: "not_found" }, 404);
+  };
+  const path = `${opts.path}/:id`;
+  if (opts.updateMethod === "put") {
+    opts.app.put(path, handler);
+  } else {
+    opts.app.patch(path, handler);
+  }
+}
+
+export function mountDeleteRoute(opts: VerbOptions): void {
+  opts.app.delete(`${opts.path}/:id`, async (c) => {
+    const id = c.req.param("id") ?? "";
+    const result = await opts.db
+      .delete(opts.table)
+      .where(eq(opts.table.id, parseId(id)));
+    const affected = extractRowCount(result);
+    if (affected > 0) {
+      // 204 No Content — body must be empty.
+      return c.body(null, 204);
+    }
+    return c.json({ error: "not_found" }, 404);
+  });
+}
+
+function extractRowCount(result: unknown): number {
+  if (typeof result === "number") return result;
+  if (Array.isArray(result)) return result.length;
+  if (result && typeof result === "object") {
+    const obj = result as { rowsAffected?: number | bigint; rowCount?: number };
+    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: string): number | string {
+  const n = Number(raw);
+  return Number.isFinite(n) && raw.trim() !== "" ? n : raw;
+}
+
+export { mountReadOnlyCrudRoutes, type MountReadOnlyOptions } from "./mount-read-only.js";

package/src/hono/mount-read-only.ts

@@ -0,0 +1,189 @@
+// Hono read-only mount — projection (view-backed) entities. GET list +
+// GET :id only. POST/PATCH/DELETE return 405. Mirrors the drizzle-fastify
+// equivalent so the cross-port API contract holds for projection endpoints.
+
+import type { Hono } from "hono";
+import { sql, eq, and, count } from "drizzle-orm";
+import qs from "qs";
+import { parseFilterParams, FilterParseError } from "../drizzle-fastify/filter-parser.js";
+import type {
+  FilterAllowlist,
+  SortAllowlist,
+} from "../drizzle-fastify/filter-allowlist.js";
+import { isTruthyFlag } from "../drizzle-fastify/util.js";
+
+// biome-ignore lint/suspicious/noExplicitAny: dynamic dispatch over user-supplied views
+type AnyView = any;
+// biome-ignore lint/suspicious/noExplicitAny: generic Hono app
+type AnyHono = Hono<any, any, any>;
+
+/**
+ * Drizzle v0.45 stores view config under this well-known Symbol. Mirrors
+ * the same workaround the Fastify mount uses — accessing `view._` on a
+ * proxy-wrapped view throws.
+ */
+const VIEW_BASE_CONFIG = Symbol.for("drizzle:ViewBaseConfig");
+
+export interface MountReadOnlyOptions {
+  readonly app: AnyHono;
+  readonly path: string;
+  // biome-ignore lint/suspicious/noExplicitAny: dynamic Drizzle client
+  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;
+}
+
+function getViewConfig(view: AnyView): Record<string, unknown> | undefined {
+  try {
+    const cfg = (view as Record<symbol, unknown>)[VIEW_BASE_CONFIG];
+    if (cfg && typeof cfg === "object") return cfg as Record<string, unknown>;
+  } catch {
+    // ignore — proxy handler may throw on unexpected shapes
+  }
+  return undefined;
+}
+
+function resolveViewName(view: AnyView): string | undefined {
+  const cfg = getViewConfig(view);
+  if (cfg) {
+    if (typeof cfg["name"] === "string") return cfg["name"] as string;
+  }
+  const v = view as Record<string, unknown>;
+  return (
+    (typeof v["__tableName"] === "string" ? v["__tableName"] as string : undefined) ??
+    (typeof v["_name"] === "string" ? v["_name"] as string : undefined)
+  );
+}
+
+function isEmptyColumnView(view: AnyView): boolean {
+  const cfg = getViewConfig(view);
+  if (cfg) {
+    const fields = cfg["selectedFields"] as Record<string, unknown> | undefined;
+    return fields !== undefined && Object.keys(fields).length === 0;
+  }
+  return false;
+}
+
+function snakeToCamel(s: string): string {
+  return s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+
+function camelizeRow(row: Record<string, unknown>): Record<string, unknown> {
+  const out: Record<string, unknown> = {};
+  for (const [k, v] of Object.entries(row)) {
+    out[snakeToCamel(k)] = v;
+  }
+  return out;
+}
+
+export function mountReadOnlyCrudRoutes(opts: MountReadOnlyOptions): void {
+  const { app, path, db, view, filterAllowlist, sortAllowlist, dialect } = opts;
+  const idCol = opts.idColumn ?? "id";
+
+  const viewName = resolveViewName(view);
+  const useRawSql = isEmptyColumnView(view) && !!viewName;
+
+  // ── List ──────────────────────────────────────────────────────────────────
+  app.get(path, async (c) => {
+    try {
+      if (useRawSql) {
+        const url = c.req.url;
+        const qIdx = url.indexOf("?");
+        const queryString = qIdx >= 0 ? url.slice(qIdx + 1) : "";
+        const parsed = qs.parse(queryString) as Record<string, unknown>;
+        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}`))) as any[];
+        const camelRows = rows.map((r: Record<string, unknown>) => camelizeRow(r));
+        if (!withCount) return c.json(camelRows);
+        // biome-ignore lint/suspicious/noExplicitAny: dynamic raw result
+        const countRows = (await db.all(sql.raw(`SELECT COUNT(*) AS c FROM "${viewName}"`))) as any[];
+        const total: number = Number(countRows[0]?.c ?? 0);
+        return c.json({ rows: camelRows, total });
+      }
+
+      const url = c.req.url;
+      const qIdx = url.indexOf("?");
+      const queryString = qIdx >= 0 ? url.slice(qIdx + 1) : "";
+      const parsed = qs.parse(queryString) as Record<string, unknown>;
+      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 c.json(rows);
+
+      let cq = db.select({ c: count() }).from(view);
+      if (combinedWhere) cq = cq.where(combinedWhere);
+      const countRow = (await cq.all())[0] as { c: number } | undefined;
+      const total = countRow?.c ?? 0;
+      return c.json({ rows, total });
+    } catch (err) {
+      if (err instanceof FilterParseError) {
+        return c.json({ error: err.code, message: err.message }, 400);
+      }
+      throw err;
+    }
+  });
+
+  // ── Get by ID ─────────────────────────────────────────────────────────────
+  app.get(`${path}/:id`, async (c) => {
+    const id = c.req.param("id") ?? "";
+    if (useRawSql) {
+      const numericId = Number(id);
+      if (!Number.isFinite(numericId)) {
+        return c.json({ error: "invalid_id" }, 400);
+      }
+      // biome-ignore lint/suspicious/noExplicitAny: dynamic raw result
+      const rows = (await db.all(sql.raw(`SELECT * FROM "${viewName}" WHERE "${idCol}" = ${numericId} LIMIT 1`))) as any[];
+      const row = rows[0] ? camelizeRow(rows[0]) : undefined;
+      return row ? c.json(row) : c.json({ error: "not_found" }, 404);
+    }
+    // biome-ignore lint/suspicious/noExplicitAny: Drizzle view column ref
+    const colRef = (view as any)[idCol];
+    const row = await db
+      .select()
+      .from(view)
+      .where(colRef !== undefined ? eq(colRef, Number(id)) : undefined)
+      .get();
+    return row ? c.json(row) : c.json({ error: "not_found" }, 404);
+  });
+
+  // ── Mutations explicitly rejected (405) ───────────────────────────────────
+  const reject = (c: { req: { method: string }; json: (body: unknown, status: number) => unknown }) =>
+    c.json(
+      { error: "method_not_allowed", message: `${c.req.method} is not supported on a projection (read-only).` },
+      405,
+    );
+  // biome-ignore lint/suspicious/noExplicitAny: cross-version Hono typing
+  app.post(path, reject as any);
+  // biome-ignore lint/suspicious/noExplicitAny: cross-version Hono typing
+  app.patch(`${path}/:id`, reject as any);
+  // biome-ignore lint/suspicious/noExplicitAny: cross-version Hono typing
+  app.delete(`${path}/:id`, reject as any);
+}