@better-agnostic/handler 0.0.2

package/dist/Plugin.d.ts

@@ -0,0 +1,12 @@
+import type { SchemaContribution } from "@better-agnostic/schema";
+import type { Route } from "./types.js";
+export interface Plugin<THooks = Record<string, never>, TEngine = unknown> {
+    name: string;
+    version?: string;
+    routes?: Route<TEngine>[];
+    hooks?: Partial<THooks>;
+    createServices?: (engine: TEngine) => Record<string, unknown>;
+    init?(engine: TEngine): Promise<void> | void;
+    schemaContribution?: SchemaContribution;
+}
+//# sourceMappingURL=Plugin.d.ts.map

package/dist/Plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../src/Plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7C,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC"}

package/dist/Plugin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Plugin.js.map

package/dist/Plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../src/Plugin.ts"],"names":[],"mappings":""}

package/dist/dispatch.d.ts

@@ -0,0 +1,11 @@
+import type { CoreRequest, CoreResponse } from "./types.js";
+export interface DispatchableEngine<TAuth = unknown> {
+    getRoutes(): Array<{
+        method: string;
+        path: string;
+        handler: (ctx: unknown) => Promise<CoreResponse> | CoreResponse;
+    }>;
+    init?(): Promise<void>;
+}
+export declare function dispatch<TEngine extends DispatchableEngine>(engine: TEngine, req: CoreRequest, basePath?: string): Promise<CoreResponse>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG5D,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,OAAO;IACjD,SAAS,IAAI,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;KACjE,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,QAAQ,CAAC,OAAO,SAAS,kBAAkB,EAC/D,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,WAAW,EAChB,QAAQ,SAAK,GACZ,OAAO,CAAC,YAAY,CAAC,CA4BvB"}

package/dist/dispatch.js

@@ -0,0 +1,30 @@
+import { findRoute } from "./routes.js";
+import { errorToResponse } from "./utils.js";
+export async function dispatch(engine, req, basePath = "") {
+    if (typeof engine.init === "function") {
+        await engine.init();
+    }
+    const path = basePath
+        ? req.path.startsWith(basePath)
+            ? req.path.slice(basePath.length) || "/"
+            : req.path
+        : req.path;
+    const normalizedPath = path.replace(/\/$/, "") || "/";
+    const routes = engine.getRoutes();
+    const found = findRoute(routes, req.method, normalizedPath);
+    if (!found) {
+        return {
+            status: 404,
+            body: { code: "NOT_FOUND", message: "Route not found" },
+        };
+    }
+    const { route, params } = found;
+    const reqWithParams = { ...req, params };
+    try {
+        return await route.handler({ engine, req: reqWithParams });
+    }
+    catch (err) {
+        return errorToResponse(err);
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAW7C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAe,EACf,GAAgB,EAChB,QAAQ,GAAG,EAAE;IAEb,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC7B,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG;YACxC,CAAC,CAAC,GAAG,CAAC,IAAI;QACZ,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACb,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IAEtD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE;SACxD,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAChC,MAAM,aAAa,GAAG,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC;IAEzC,IAAI,CAAC;QACH,OAAO,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { CoreRequest, CoreResponse, Route, RouteHandler } from "./types.js";
+export { matchPath } from "./path.js";
+export type { PathMatch } from "./path.js";
+export { queryToRecord, parseJsonBody, errorToResponse, successResponse, parseLimit, streamResponse, } from "./utils.js";
+export { parseBody } from "./parseBody.js";
+export { buildRoutes, findRoute } from "./routes.js";
+export { dispatch } from "./dispatch.js";
+export type { DispatchableEngine } from "./dispatch.js";
+export type { Plugin } from "./Plugin.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,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { matchPath } from "./path.js";
+export { queryToRecord, parseJsonBody, errorToResponse, successResponse, parseLimit, streamResponse, } from "./utils.js";
+export { parseBody } from "./parseBody.js";
+export { buildRoutes, findRoute } from "./routes.js";
+export { dispatch } from "./dispatch.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/parseBody.d.ts

@@ -0,0 +1,8 @@
+import type { ZodType } from "zod";
+import type { CoreRequest } from "./types.js";
+/**
+ * Parses and validates request body against a Zod schema.
+ * Throws ValidationError (with issues) on failure.
+ */
+export declare function parseBody<T>(req: CoreRequest, schema: ZodType<T>): T;
+//# sourceMappingURL=parseBody.d.ts.map

package/dist/parseBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBody.d.ts","sourceRoot":"","sources":["../src/parseBody.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CA4BpE"}

package/dist/parseBody.js

@@ -0,0 +1,32 @@
+import { ValidationError } from "@better-agnostic/errors";
+/**
+ * Parses and validates request body against a Zod schema.
+ * Throws ValidationError (with issues) on failure.
+ */
+export function parseBody(req, schema) {
+    const raw = req.body;
+    if (raw === null || raw === undefined) {
+        throw new ValidationError("Request body is required", {
+            metadata: { issues: [{ message: "Body is null or undefined" }] },
+        });
+    }
+    if (typeof raw !== "object" || Array.isArray(raw)) {
+        throw new ValidationError("Request body must be an object", {
+            metadata: { issues: [{ message: "Expected object" }] },
+        });
+    }
+    const result = schema.safeParse(raw);
+    if (result.success) {
+        return result.data;
+    }
+    const zodError = result.error;
+    const issues = zodError.issues.map((issue) => ({
+        path: issue.path.join("."),
+        message: issue.message,
+        code: issue.code,
+    }));
+    throw new ValidationError(zodError.message, {
+        metadata: { issues },
+    });
+}
+//# sourceMappingURL=parseBody.js.map

package/dist/parseBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBody.js","sourceRoot":"","sources":["../src/parseBody.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI1D;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAI,GAAgB,EAAE,MAAkB;IAC/D,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC;IACrB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,eAAe,CAAC,0BAA0B,EAAE;YACpD,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,EAAE;SACjE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,eAAe,CAAC,gCAAgC,EAAE;YAC1D,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,EAAE;SACvD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAS,CAAC;IAC1B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;IAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7C,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC,CAAC,CAAC;IAEJ,MAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,EAAE;QAC1C,QAAQ,EAAE,EAAE,MAAM,EAAE;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/path.d.ts

@@ -0,0 +1,6 @@
+export interface PathMatch {
+    matches: boolean;
+    params: Record<string, string>;
+}
+export declare function matchPath(pattern: string, path: string): PathMatch;
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAmBlE"}

package/dist/path.js

@@ -0,0 +1,20 @@
+export function matchPath(pattern, path) {
+    const patternParts = pattern.split("/").filter(Boolean);
+    const pathParts = path.replace(/^\//, "").split("/").filter(Boolean);
+    if (patternParts.length !== pathParts.length) {
+        return { matches: false, params: {} };
+    }
+    const params = {};
+    for (let i = 0; i < patternParts.length; i++) {
+        const p = patternParts[i];
+        const v = pathParts[i];
+        if (p?.startsWith(":")) {
+            params[p.slice(1)] = v ?? "";
+        }
+        else if (p !== v) {
+            return { matches: false, params: {} };
+        }
+    }
+    return { matches: true, params };
+}
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,IAAY;IACrD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAErE,IAAI,YAAY,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC"}

package/dist/routes.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from "./Plugin.js";
+import type { Route } from "./types.js";
+export declare function buildRoutes<TEngine, TPlugin extends Plugin<Record<string, never>, TEngine>>(coreRoutes: Route<TEngine>[], plugins?: TPlugin[]): Route<TEngine>[];
+export declare function findRoute<TEngine>(routesToSearch: Route<TEngine>[], method: string, path: string): {
+    route: Route<TEngine>;
+    params: Record<string, string>;
+} | null;
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,EACzF,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,EAC5B,OAAO,CAAC,EAAE,OAAO,EAAE,GAClB,KAAK,CAAC,OAAO,CAAC,EAAE,CAGlB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAC/B,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,EAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAQlE"}

package/dist/routes.js

@@ -0,0 +1,17 @@
+import { matchPath } from "./path.js";
+export function buildRoutes(coreRoutes, plugins) {
+    const pluginRoutes = plugins?.flatMap((p) => p.routes ?? []) ?? [];
+    return [...coreRoutes, ...pluginRoutes];
+}
+export function findRoute(routesToSearch, method, path) {
+    const normalizedPath = path.replace(/\/$/, "") || "/";
+    for (const route of routesToSearch) {
+        if (route.method !== method)
+            continue;
+        const { matches, params } = matchPath(route.path, normalizedPath);
+        if (matches)
+            return { route, params };
+    }
+    return null;
+}
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,UAAU,WAAW,CACzB,UAA4B,EAC5B,OAAmB;IAEnB,MAAM,YAAY,GAAG,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IACnE,OAAO,CAAC,GAAG,UAAU,EAAE,GAAG,YAAY,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,cAAgC,EAChC,MAAc,EACd,IAAY;IAEZ,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IACtD,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS;QACtC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAClE,IAAI,OAAO;YAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+export interface CoreRequest<TAuth = unknown> {
+    method: string;
+    path: string;
+    params: Record<string, string>;
+    query: Record<string, string>;
+    body: unknown;
+    auth?: TAuth;
+}
+export interface CoreResponse {
+    status: number;
+    body?: unknown;
+    headers?: Record<string, string>;
+    stream?: ReadableStream;
+}
+export type RouteHandler<TEngine = unknown, TAuth = unknown> = (ctx: {
+    engine: TEngine;
+    req: CoreRequest<TAuth>;
+}) => Promise<CoreResponse> | CoreResponse;
+export interface Route<TEngine = unknown, TAuth = unknown> {
+    method: string;
+    path: string;
+    handler: RouteHandler<TEngine, TAuth>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW,CAAC,KAAK,GAAG,OAAO;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,CAAC,OAAO,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE;IACnE,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;CACzB,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAE3C,MAAM,WAAW,KAAK,CAAC,OAAO,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;CACvC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,8 @@
+import type { CoreResponse } from "./types.js";
+export declare function queryToRecord(q: Record<string, unknown> | null | undefined): Record<string, string>;
+export declare function parseJsonBody(raw: string | null): unknown;
+export declare function errorToResponse(err: unknown): CoreResponse;
+export declare function successResponse(data: unknown, status?: number): CoreResponse;
+export declare function parseLimit(queryLimit: string | undefined, defaultLimit?: number): number;
+export declare function streamResponse(stream: ReadableStream, headers?: Record<string, string>): CoreResponse;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,aAAa,CAC3B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC5C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAOzD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAY1D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAM,GAAG,YAAY,CAEzE;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,SAAK,GAAG,MAAM,CAIpF;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,YAAY,CAWd"}

package/dist/utils.js

@@ -0,0 +1,55 @@
+import { isBaseError, toJsonPayload } from "@better-agnostic/errors";
+export function queryToRecord(q) {
+    const out = {};
+    for (const [k, v] of Object.entries(q ?? {})) {
+        if (v !== undefined && v !== null) {
+            out[k] = Array.isArray(v) ? v[0] : String(v);
+        }
+    }
+    return out;
+}
+export function parseJsonBody(raw) {
+    if (!raw || raw.trim() === "")
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function errorToResponse(err) {
+    if (isBaseError(err) && err.expose) {
+        const payload = toJsonPayload(err);
+        return {
+            status: err.statusCode,
+            body: payload,
+        };
+    }
+    return {
+        status: 500,
+        body: { code: "INTERNAL_ERROR", message: "An unexpected error occurred" },
+    };
+}
+export function successResponse(data, status = 200) {
+    return { status, body: data };
+}
+export function parseLimit(queryLimit, defaultLimit = 50) {
+    const raw = queryLimit ? Number.parseInt(queryLimit, 10) : defaultLimit;
+    if (Number.isNaN(raw) || raw < 1)
+        return defaultLimit;
+    return Math.min(raw, 100);
+}
+export function streamResponse(stream, headers) {
+    return {
+        status: 200,
+        headers: {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+            ...headers,
+        },
+        stream,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGrE,MAAM,UAAU,aAAa,CAC3B,CAA6C;IAE7C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAClC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAkB;IAC9C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO;YACL,MAAM,EAAE,GAAG,CAAC,UAAU;YACtB,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,8BAA8B,EAAE;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAa,EAAE,MAAM,GAAG,GAAG;IACzD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,UAA8B,EAAE,YAAY,GAAG,EAAE;IAC1E,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IACxE,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,YAAY,CAAC;IACtD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAsB,EACtB,OAAgC;IAEhC,OAAO;QACL,MAAM,EAAE,GAAG;QACX,OAAO,EAAE;YACP,cAAc,EAAE,mBAAmB;YACnC,eAAe,EAAE,UAAU;YAC3B,UAAU,EAAE,YAAY;YACxB,GAAG,OAAO;SACX;QACD,MAAM;KACP,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@better-agnostic/handler",
+  "version": "0.0.2",
+  "description": "Core HTTP dispatch, routing, and utilities for better-agnostic handlers",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elydelva/better-agnostic",
+    "directory": "packages/handler"
+  },
+  "keywords": ["handler", "better-agnostic", "http", "dispatch", "routing"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@better-agnostic/errors": "workspace:*",
+    "@better-agnostic/schema": "workspace:*",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "files": ["dist"]
+}