uql-orm 0.9.5 → 0.10.1

package/dist/http/contract.d.ts

@@ -0,0 +1,99 @@
+import type { Type } from '../type/index.js';
+/**
+ * Single source of truth for the CRUD-over-HTTP surface, shared by server adapters and the browser client.
+ * Keys are constrained to {@link UniversalQuerier} method names, so renaming a querier method
+ * (or routing a non-existent one) is a compile error.
+ */
+export declare const CRUD_ROUTES: {
+    readonly findMany: {
+        readonly method: "GET";
+        readonly path: "";
+    };
+    readonly findOne: {
+        readonly method: "GET";
+        readonly path: "/one";
+    };
+    readonly count: {
+        readonly method: "GET";
+        readonly path: "/count";
+    };
+    readonly findOneById: {
+        readonly method: "GET";
+        readonly path: "/:id";
+    };
+    readonly insertOne: {
+        readonly method: "POST";
+        readonly path: "";
+    };
+    readonly insertMany: {
+        readonly method: "POST";
+        readonly path: "/many";
+    };
+    readonly saveOne: {
+        readonly method: "PUT";
+        readonly path: "";
+    };
+    readonly saveMany: {
+        readonly method: "PUT";
+        readonly path: "/many";
+    };
+    readonly updateMany: {
+        readonly method: "PATCH";
+        readonly path: "";
+    };
+    readonly updateOneById: {
+        readonly method: "PATCH";
+        readonly path: "/:id";
+    };
+    readonly deleteOneById: {
+        readonly method: "DELETE";
+        readonly path: "/:id";
+    };
+    readonly deleteMany: {
+        readonly method: "DELETE";
+        readonly path: "";
+    };
+};
+export type CrudOperation = keyof typeof CRUD_ROUTES;
+export type CrudRoute = (typeof CRUD_ROUTES)[CrudOperation];
+/**
+ * `QUERY` (RFC 10008) is an alternate transport for the read operations: same semantics as the
+ * GET routes, but the JSON query travels in the request body instead of the query string,
+ * avoiding URL-length limits for large queries.
+ */
+export type HttpMethod = CrudRoute['method'] | 'QUERY';
+/**
+ * URL segment for an entity, e.g. `entityPath(UserProfile) === 'user-profile'`.
+ */
+export declare function entityPath<E>(entity: Type<E>): string;
+export type RouteMatch = {
+    readonly op: CrudOperation;
+    /**
+     * the resolved transport method — differs from the op's canonical route method for QUERY.
+     */
+    readonly method: HttpMethod;
+    readonly id?: string;
+};
+/**
+ * Resolve a (method, sub-path) pair to a CRUD operation. Literal sub-paths win over `:id`.
+ */
+export declare function matchRoute(method: string, subPath: string | undefined): RouteMatch | undefined;
+export type RequestSuccessResponse<E> = {
+    data: E;
+    count?: number;
+};
+export type RequestErrorResponse = {
+    readonly error: {
+        readonly message: string;
+        readonly code: number;
+    };
+};
+/**
+ * Map a thrown error to the wire error envelope. Honors a numeric `status` on the error
+ * (e.g. hooks throwing 403), defaults to 500; `code` mirrors the HTTP status.
+ */
+export declare function toErrorResponse(err: unknown): {
+    status: number;
+    body: RequestErrorResponse;
+};
+//# sourceMappingURL=contract.d.ts.map

package/dist/http/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/http/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAoB,MAAM,kBAAkB,CAAC;AAW/D;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAagD,CAAC;AAEzE,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,WAAW,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,aAAa,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;AAYvD;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAErD;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAuB9F;AAED,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IACtC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,CAI5F"}

package/dist/http/contract.js

@@ -0,0 +1,72 @@
+// import from the specific util modules (not the barrel) to keep entity
+// metadata and reflect-metadata out of the browser bundle
+import { getKeys } from '../util/object.util.js';
+import { kebabCase } from '../util/string.util.js';
+/**
+ * Single source of truth for the CRUD-over-HTTP surface, shared by server adapters and the browser client.
+ * Keys are constrained to {@link UniversalQuerier} method names, so renaming a querier method
+ * (or routing a non-existent one) is a compile error.
+ */
+export const CRUD_ROUTES = {
+    findMany: { method: 'GET', path: '' },
+    findOne: { method: 'GET', path: '/one' },
+    count: { method: 'GET', path: '/count' },
+    findOneById: { method: 'GET', path: '/:id' },
+    insertOne: { method: 'POST', path: '' },
+    insertMany: { method: 'POST', path: '/many' },
+    saveOne: { method: 'PUT', path: '' },
+    saveMany: { method: 'PUT', path: '/many' },
+    updateMany: { method: 'PATCH', path: '' },
+    updateOneById: { method: 'PATCH', path: '/:id' },
+    deleteOneById: { method: 'DELETE', path: '/:id' },
+    deleteMany: { method: 'DELETE', path: '' },
+};
+const CRUD_OPS = getKeys(CRUD_ROUTES);
+// derived from CRUD_ROUTES (the literal-path GET routes) so the sub-paths live in exactly one place
+const QUERY_READ_OPS = new Map(CRUD_OPS.filter((op) => CRUD_ROUTES[op].method === 'GET' && CRUD_ROUTES[op].path !== '/:id').map((op) => [
+    CRUD_ROUTES[op].path,
+    op,
+]));
+/**
+ * URL segment for an entity, e.g. `entityPath(UserProfile) === 'user-profile'`.
+ */
+export function entityPath(entity) {
+    return kebabCase(entity.name);
+}
+/**
+ * Resolve a (method, sub-path) pair to a CRUD operation. Literal sub-paths win over `:id`.
+ */
+export function matchRoute(method, subPath) {
+    const raw = method.toUpperCase();
+    const literal = subPath === undefined ? '' : `/${subPath}`;
+    if (raw === 'QUERY') {
+        const op = QUERY_READ_OPS.get(literal);
+        return op ? { op, method: 'QUERY' } : undefined;
+    }
+    // HEAD reads like GET per HTTP semantics; the server runtime omits the response body
+    const verb = raw === 'HEAD' ? 'GET' : raw;
+    let idOp;
+    for (const op of CRUD_OPS) {
+        const route = CRUD_ROUTES[op];
+        if (route.method !== verb) {
+            continue;
+        }
+        if (route.path === literal) {
+            return { op, method: route.method };
+        }
+        if (route.path === '/:id') {
+            idOp = op;
+        }
+    }
+    return idOp && subPath !== undefined ? { op: idOp, method: CRUD_ROUTES[idOp].method, id: subPath } : undefined;
+}
+/**
+ * Map a thrown error to the wire error envelope. Honors a numeric `status` on the error
+ * (e.g. hooks throwing 403), defaults to 500; `code` mirrors the HTTP status.
+ */
+export function toErrorResponse(err) {
+    const status = err instanceof Error && 'status' in err && typeof err.status === 'number' ? err.status : 500;
+    const message = err instanceof Error ? err.message : 'Internal Server Error';
+    return { status, body: { error: { message, code: status } } };
+}
+//# sourceMappingURL=contract.js.map

package/dist/http/contract.js.map

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

package/dist/http/fetchHandler.d.ts

@@ -0,0 +1,14 @@
+import { type RequestHandlerOptions } from './handler.js';
+export type FetchHandlerOptions = RequestHandlerOptions<Request> & {
+    /**
+     * URL prefix to strip before matching entity routes, e.g. '/api'. Defaults to ''.
+     */
+    readonly basePath?: string;
+};
+/**
+ * Web-standard adapter over {@link createRequestHandler}: mount the returned
+ * `(request: Request) => Promise<Response>` in any fetch-native runtime
+ * (Hono, Next.js route handlers, Bun.serve, Deno.serve, Cloudflare Workers, SvelteKit).
+ */
+export declare function createFetchHandler(opts?: FetchHandlerOptions): (request: Request) => Promise<Response>;
+//# sourceMappingURL=fetchHandler.d.ts.map

package/dist/http/fetchHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchHandler.d.ts","sourceRoot":"","sources":["../../src/http/fetchHandler.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEhF,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,OAAO,CAAC,GAAG;IACjE;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAmC1G"}

package/dist/http/fetchHandler.js

@@ -0,0 +1,63 @@
+import { toErrorResponse } from './contract.js';
+import { createRequestHandler } from './handler.js';
+/**
+ * Web-standard adapter over {@link createRequestHandler}: mount the returned
+ * `(request: Request) => Promise<Response>` in any fetch-native runtime
+ * (Hono, Next.js route handlers, Bun.serve, Deno.serve, Cloudflare Workers, SvelteKit).
+ */
+export function createFetchHandler(opts = {}) {
+    const { basePath = '', ...handlerOpts } = opts;
+    const handle = createRequestHandler(handlerOpts);
+    return async (request) => {
+        try {
+            const url = new URL(request.url);
+            let path = url.pathname;
+            if (basePath && (path === basePath || path.startsWith(`${basePath}/`))) {
+                path = path.slice(basePath.length);
+            }
+            const segments = path.split('/').filter((segment) => segment.length);
+            if (segments.length === 0 || segments.length > 2) {
+                return notFound();
+            }
+            const [entityPath, subPath] = segments;
+            const method = request.method.toUpperCase();
+            const pending = handle({
+                method,
+                entityPath,
+                subPath,
+                query: Object.fromEntries(url.searchParams),
+                body: await parseBody(request, method),
+                context: request,
+            });
+            if (!pending) {
+                return notFound();
+            }
+            const { status, body } = await pending;
+            return Response.json(body, { status });
+        }
+        catch (err) {
+            const { status, body } = toErrorResponse(err);
+            return Response.json(body, { status });
+        }
+    };
+}
+async function parseBody(request, method) {
+    if (method !== 'POST' && method !== 'PUT' && method !== 'PATCH' && method !== 'QUERY') {
+        return undefined;
+    }
+    const text = await request.text();
+    if (!text) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw Object.assign(new SyntaxError('invalid JSON body'), { status: 400 });
+    }
+}
+function notFound() {
+    const body = { error: { message: 'not found', code: 404 } };
+    return Response.json(body, { status: 404 });
+}
+//# sourceMappingURL=fetchHandler.js.map

package/dist/http/fetchHandler.js.map

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

package/dist/http/handler.d.ts

@@ -0,0 +1,77 @@
+import type { EntityMeta, Query, Type } from '../type/index.js';
+import { type CrudOperation, type HttpMethod, type RequestSuccessResponse } from './contract.js';
+/**
+ * Framework-normalized request: adapters (express, fetch, ...) reduce their native
+ * request to this shape and get back a status + JSON body.
+ */
+export type HandlerRequest<Ctx = unknown> = {
+    readonly method: string;
+    readonly entityPath: string;
+    readonly subPath?: string;
+    /**
+     * raw query-string entries; JSON values may still be stringified.
+     */
+    readonly query?: Record<string, unknown>;
+    /**
+     * parsed JSON body.
+     */
+    readonly body?: unknown;
+    /**
+     * adapter-supplied request context (express `req`, fetch `Request`, ...), passed through to hooks.
+     */
+    readonly context: Ctx;
+};
+export type HandlerResponse = {
+    readonly status: number;
+    readonly body: unknown;
+};
+export type HookContext<E extends object, Ctx = unknown> = {
+    readonly meta: EntityMeta<E>;
+    readonly op: CrudOperation;
+    readonly method: HttpMethod;
+    /**
+     * parsed query — mutate in place or reassign to enforce filters (tenant scoping, row-level rules).
+     */
+    query: Query<E>;
+    /**
+     * request payload — reassignable for sanitization or field injection.
+     */
+    body?: unknown;
+    /**
+     * adapter-supplied request context — the auth/tenant source (e.g. `req.user`).
+     */
+    readonly context: Ctx;
+};
+export type Hook<Ctx = unknown> = <E extends object>(ctx: HookContext<E, Ctx>) => void | Promise<void>;
+export type ResponseHook<Ctx = unknown> = <E extends object>(ctx: HookContext<E, Ctx>, envelope: RequestSuccessResponse<unknown>) => void | Promise<void>;
+export type RequestHandlerOptions<Ctx = unknown> = {
+    include?: Type<any>[];
+    exclude?: Type<any>[];
+    /**
+     * Allow augment any kind of request before it runs. Hooks may be async
+     * and abort the request by throwing (a numeric `status` on the error is honored).
+     */
+    pre?: Hook<Ctx>;
+    /**
+     * Allow augment a save request (POST | PUT | PATCH) before it runs.
+     */
+    preSave?: Hook<Ctx>;
+    /**
+     * Allow augment a filter request (GET | DELETE) before it runs.
+     */
+    preFilter?: Hook<Ctx>;
+    /**
+     * Shape the successful response before it is sent: strip sensitive fields,
+     * derive presentation fields, or coerce null data. Mutate `envelope.data` in place
+     * or reassign it. Runs after the operation (and after commit for writes).
+     */
+    post?: ResponseHook<Ctx>;
+};
+/**
+ * Returns `undefined` synchronously for an unknown entity or route so adapters can fall through
+ * (e.g. express `next()`); rejects with the original error on failure so adapters map it
+ * (e.g. `toErrorResponse`).
+ */
+export type RequestHandler<Ctx = unknown> = (req: HandlerRequest<Ctx>) => Promise<HandlerResponse> | undefined;
+export declare function createRequestHandler<Ctx = unknown>(opts?: RequestHandlerOptions<Ctx>): RequestHandler<Ctx>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/http/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/http/handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAoB,KAAK,EAAe,IAAI,EAAiB,MAAM,kBAAkB,CAAC;AAC9G,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,UAAU,EAEf,KAAK,sBAAsB,EAE5B,MAAM,eAAe,CAAC;AAGvB;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,GAAG,GAAG,OAAO,IAAI;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,CAAC;AAWF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,GAAG,OAAO,IAAI;IACzD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,IAAI,CAAC,GAAG,GAAG,OAAO,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvG,MAAM,MAAM,YAAY,CAAC,GAAG,GAAG,OAAO,IAAI,CAAC,CAAC,SAAS,MAAM,EACzD,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,EACxB,QAAQ,EAAE,sBAAsB,CAAC,OAAO,CAAC,KACtC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,MAAM,qBAAqB,CAAC,GAAG,GAAG,OAAO,IAAI;IAEjD,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAEtB,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACtB;;;OAGG;IACH,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;CAC1B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,CAAC;AAE/G,wBAAgB,oBAAoB,CAAC,GAAG,GAAG,OAAO,EAAE,IAAI,GAAE,qBAAqB,CAAC,GAAG,CAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CA0I9G"}

package/dist/http/handler.js

@@ -0,0 +1,172 @@
+import { getEntities, getMeta } from '../entity/index.js';
+import { getQuerier } from '../options.js';
+import { entityPath, matchRoute, } from './contract.js';
+import { parseQueryParams } from './query.js';
+export function createRequestHandler(opts = {}) {
+    const { include, exclude, pre, preSave, preFilter, post } = opts;
+    let entities = include ?? getEntities();
+    if (exclude) {
+        entities = entities.filter((entity) => !exclude.includes(entity));
+    }
+    if (!entities.length) {
+        throw new TypeError('no entities for the uql middleware');
+    }
+    // biome-ignore lint/suspicious/noExplicitAny: heterogeneous entity map
+    const entityByPath = new Map(entities.map((entity) => [entityPath(entity), entity]));
+    return (req) => {
+        const entity = entityByPath.get(req.entityPath);
+        if (!entity) {
+            return undefined;
+        }
+        const match = matchRoute(req.method, req.subPath);
+        if (!match) {
+            return undefined;
+        }
+        return run(entity, match, req);
+    };
+    async function run(entity, { op, method, id }, req) {
+        const meta = getMeta(entity);
+        // QUERY (RFC 10008) carries the JSON query in the body instead of the query string
+        const rawQuery = method === 'QUERY' ? req.body : req.query;
+        const hookCtx = {
+            meta,
+            op,
+            method,
+            query: parseQueryParams(rawQuery),
+            body: req.body,
+            context: req.context,
+        };
+        await pre?.(hookCtx);
+        if (method === 'POST' || method === 'PUT' || method === 'PATCH') {
+            await preSave?.(hookCtx);
+        }
+        else {
+            await preFilter?.(hookCtx);
+        }
+        const resp = await dispatch();
+        if (post) {
+            await post(hookCtx, resp.body);
+        }
+        return resp;
+        function dispatch() {
+            // read post-hooks so both in-place mutation and reassignment of hookCtx.query apply
+            const query = hookCtx.query;
+            const flags = query;
+            const softDelete = flags.softDelete === 'true' || flags.softDelete === true;
+            switch (op) {
+                case 'findOne':
+                    return withQuerier(async (querier) => {
+                        const data = await querier.findOne(entity, query);
+                        return ok({ data, count: data ? 1 : 0 });
+                    });
+                case 'count':
+                    return withQuerier(async (querier) => {
+                        const count = await querier.count(entity, query);
+                        return ok({ data: count, count });
+                    });
+                case 'findOneById':
+                    return withQuerier(async (querier) => {
+                        const data = await querier.findOne(entity, buildIdQuery(meta, id, query));
+                        return ok({ data, count: data ? 1 : 0 });
+                    });
+                case 'findMany':
+                    return withQuerier(async (querier) => {
+                        const findManyPromise = querier.findMany(entity, query);
+                        const countPromise = flags.count ? querier.count(entity, query) : undefined;
+                        const [data, count] = await Promise.all([findManyPromise, countPromise]);
+                        return ok({ data, count });
+                    });
+                case 'insertOne':
+                    return withTransaction(async (querier) => {
+                        const data = await querier.insertOne(entity, hookCtx.body);
+                        return ok({ data, count: 1 });
+                    });
+                case 'insertMany':
+                    return withTransaction(async (querier) => {
+                        const data = await querier.insertMany(entity, hookCtx.body);
+                        return ok({ data, count: data.length });
+                    });
+                case 'saveOne':
+                    return withTransaction(async (querier) => {
+                        const data = await querier.saveOne(entity, hookCtx.body);
+                        return ok({ data, count: 1 });
+                    });
+                case 'saveMany':
+                    return withTransaction(async (querier) => {
+                        const data = await querier.saveMany(entity, hookCtx.body);
+                        return ok({ data, count: data.length });
+                    });
+                case 'updateOneById':
+                    return withTransaction(async (querier) => {
+                        const count = await querier.updateMany(entity, buildIdQuery(meta, id, query), hookCtx.body);
+                        return ok({ data: id, count });
+                    });
+                case 'updateMany':
+                    return withTransaction(async (querier) => {
+                        const count = await querier.updateMany(entity, query, hookCtx.body);
+                        return ok({ data: count, count });
+                    });
+                case 'deleteOneById':
+                    return withTransaction(async (querier) => {
+                        const count = await querier.deleteMany(entity, buildIdQuery(meta, id, query), { softDelete });
+                        return ok({ data: id, count });
+                    });
+                case 'deleteMany':
+                    return withTransaction(async (querier) => {
+                        const founds = await querier.findMany(entity, query);
+                        let ids = [];
+                        let count = 0;
+                        if (founds.length && meta.id) {
+                            const idKey = meta.id;
+                            ids = founds.map((found) => found[idKey]);
+                            count = await querier.deleteMany(entity, { $where: ids }, { softDelete });
+                        }
+                        return ok({ data: ids, count });
+                    });
+            }
+        }
+    }
+}
+function ok(body) {
+    return { status: 200, body };
+}
+async function withQuerier(fn) {
+    const querier = await getQuerier();
+    try {
+        return await fn(querier);
+    }
+    finally {
+        await querier.release();
+    }
+}
+async function withTransaction(fn) {
+    const querier = await getQuerier();
+    try {
+        await querier.beginTransaction();
+        const resp = await fn(querier);
+        await querier.commitTransaction();
+        return resp;
+    }
+    catch (err) {
+        await querier.rollbackTransaction().catch(() => { });
+        throw err;
+    }
+    finally {
+        await querier.release();
+    }
+}
+function buildIdQuery(meta, id, query) {
+    const idKey = meta.id;
+    const where = query.$where;
+    if (Array.isArray(where)) {
+        query.$where = { $and: [{ [idKey]: { $in: where } }, { [idKey]: id }] };
+    }
+    else if (typeof where === 'object' && where !== null) {
+        query.$where = { ...where, [idKey]: id };
+    }
+    else {
+        query.$where = { [idKey]: id };
+    }
+    return query;
+}
+//# sourceMappingURL=handler.js.map

package/dist/http/handler.js.map

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

package/dist/http/index.d.ts

@@ -0,0 +1,5 @@
+export * from './contract.js';
+export * from './fetchHandler.js';
+export * from './handler.js';
+export * from './query.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/http/index.js

@@ -0,0 +1,5 @@
+export * from './contract.js';
+export * from './fetchHandler.js';
+export * from './handler.js';
+export * from './query.js';
+//# sourceMappingURL=index.js.map

package/dist/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/http/query.d.ts

@@ -0,0 +1,12 @@
+import type { Query } from '../type/index.js';
+/**
+ * Parse raw query-string entries (with JSON-stringified values) into a UQL query object.
+ * Symmetric counterpart of {@link stringifyQuery}.
+ */
+export declare function parseQueryParams(params?: Record<string, unknown>): Query<unknown>;
+/**
+ * Serialize a UQL query object into a percent-encoded query string where object values
+ * are JSON-stringified. Symmetric counterpart of {@link parseQueryParams}.
+ */
+export declare function stringifyQuery(query?: Record<string, unknown>): string;
+//# sourceMappingURL=query.d.ts.map

package/dist/http/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/http/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAM9C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAwBrF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CActE"}

package/dist/http/query.js

@@ -0,0 +1,49 @@
+// specific util module (not the barrel) to keep reflect-metadata out of the browser bundle
+import { getKeys } from '../util/object.util.js';
+const JSON_QUERY_KEYS = ['$select', '$populate', '$exclude', '$where', '$sort'];
+/**
+ * Parse raw query-string entries (with JSON-stringified values) into a UQL query object.
+ * Symmetric counterpart of {@link stringifyQuery}.
+ */
+export function parseQueryParams(params = {}) {
+    const query = { ...params };
+    for (const key of JSON_QUERY_KEYS) {
+        const value = query[key];
+        if (typeof value === 'string') {
+            try {
+                query[key] = JSON.parse(value);
+            }
+            catch {
+                throw Object.assign(new SyntaxError(`invalid JSON in '${key}'`), { status: 400 });
+            }
+        }
+    }
+    query['$where'] ??= {};
+    if (query['$skip']) {
+        query['$skip'] = Number(query['$skip']);
+    }
+    if (query['$limit']) {
+        query['$limit'] = Number(query['$limit']);
+    }
+    return query;
+}
+/**
+ * Serialize a UQL query object into a percent-encoded query string where object values
+ * are JSON-stringified. Symmetric counterpart of {@link parseQueryParams}.
+ */
+export function stringifyQuery(query) {
+    if (!query) {
+        return '';
+    }
+    const params = new URLSearchParams();
+    for (const key of getKeys(query)) {
+        const value = query[key];
+        if (value === undefined) {
+            continue;
+        }
+        params.append(key, typeof value === 'object' && value !== null ? JSON.stringify(value) : String(value));
+    }
+    const qs = params.toString();
+    return qs ? `?${qs}` : '';
+}
+//# sourceMappingURL=query.js.map

package/dist/http/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/http/query.ts"],"names":[],"mappings":"AACA,2FAA2F;AAC3F,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAEzF;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAkC,EAAE;IACnE,MAAM,KAAK,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IAErD,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,oBAAoB,GAAG,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAEvB,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnB,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,KAAuB,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAA+B;IAC5D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1G,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './dialect/index.js';
+export * from './entity/index.js';
+export * from './namingStrategy/index.js';
+export * from './options.js';
+export * from './querier/index.js';
+export * from './type/index.js';
+export * from './util/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}