@arkyn/server 3.0.1-beta.99 → 3.0.2

package/dist/modules/validations/validateDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateDate.js","names":[],"sources":["../../../src/validations/validateDate.ts"],"sourcesContent":["import { ValidateDateService } from \"@arkyn/shared\";\n\n/**\n * Validates a date string against a format and optional year bounds.\n *\n * @param date - The date string to validate.\n * @param config.inputFormat - Parsing format: `\"brazilianDate\"` (DD/MM/YYYY, default), `\"isoDate\"` (MM-DD-YYYY), or `\"timestamp\"` (YYYY-MM-DD).\n * @param config.minYear - Minimum allowed year. Defaults to 1900.\n * @param config.maxYear - Maximum allowed year. Defaults to 3000.\n * @returns `true` if the date is valid according to the format and bounds, otherwise `false`.\n *\n * @example\n * ```typescript\n * validateDate(\"31/12/2023\"); // true\n * validateDate(\"2023-12-31\", { inputFormat: \"timestamp\", minYear: 2000, maxYear: 2100 }); // true\n * validateDate(\"29/02/2023\"); // false (not a leap year)\n * ```\n */\n\nfunction validateDate(\n\tdate: string,\n\tconfig?: {\n\t\tinputFormat?: \"brazilianDate\" | \"isoDate\" | \"timestamp\";\n\t\tminYear?: number;\n\t\tmaxYear?: number;\n\t},\n): boolean {\n\tconst inputFormat = config?.inputFormat || \"brazilianDate\";\n\tconst minYear = config?.minYear || 1900;\n\tconst maxYear = config?.maxYear || 3000;\n\n\tconst validateDateService = new ValidateDateService();\n\tvalidateDateService.validateInputFormat(inputFormat);\n\n\tlet day: number, month: number, year: number;\n\tconst dateParts = date.split(/[-/]/).map(Number);\n\n\tif (dateParts.length !== 3) return false;\n\n\ttry {\n\t\tswitch (inputFormat) {\n\t\t\tcase \"brazilianDate\":\n\t\t\t\t[day, month, year] = dateParts;\n\t\t\t\tvalidateDateService.validateDateParts(year, month, day);\n\t\t\t\tbreak;\n\t\t\tcase \"isoDate\":\n\t\t\t\t[month, day, year] = dateParts;\n\t\t\t\tvalidateDateService.validateDateParts(year, month, day);\n\t\t\t\tbreak;\n\t\t\tcase \"timestamp\":\n\t\t\t\t[year, month, day] = dateParts;\n\t\t\t\tvalidateDateService.validateDateParts(year, month, day);\n\t\t\t\tbreak;\n\t\t}\n\t\tif (year < minYear || year > maxYear) return false;\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nexport { validateDate };\n"],"mappings":";;AAmBA,SAAS,EACR,GACA,GAKU;CACV,IAAM,IAAc,GAAQ,eAAe,iBACrC,IAAU,GAAQ,WAAW,MAC7B,IAAU,GAAQ,WAAW,KAE7B,IAAsB,IAAI,EAAoB;CACpD,EAAoB,oBAAoB,CAAW;CAEnD,IAAI,GAAa,GAAe,GAC1B,IAAY,EAAK,MAAM,MAAM,CAAC,CAAC,IAAI,MAAM;CAE/C,IAAI,EAAU,WAAW,GAAG,OAAO;CAEnC,IAAI;EACH,QAAQ,GAAR;GACC,KAAK;IAEJ,AADA,CAAC,GAAK,GAAO,KAAQ,GACrB,EAAoB,kBAAkB,GAAM,GAAO,CAAG;IACtD;GACD,KAAK;IAEJ,AADA,CAAC,GAAO,GAAK,KAAQ,GACrB,EAAoB,kBAAkB,GAAM,GAAO,CAAG;IACtD;GACD,KAAK;IAEJ,AADA,CAAC,GAAM,GAAO,KAAO,GACrB,EAAoB,kBAAkB,GAAM,GAAO,CAAG;IACtD;EACF;EAEA,OADA,EAAI,IAAO,KAAW,IAAO;CAE9B,QAAQ;EACP,OAAO;CACR;AACD"}

package/dist/modules/validations/validateEmail.js

@@ -0,0 +1,56 @@
+import e from "node:dns";
+//#region src/validations/validateEmail.ts
+function t(e) {
+	return /^[a-zA-Z0-9.!$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/.test(e);
+}
+function n(e) {
+	return !(e.length === 0 || e.length > 64 || e.startsWith(".") || e.endsWith(".") || e.includes("..") || !/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+$/.test(e));
+}
+function r(e) {
+	return !(e.length === 0 || e.length > 63 || e.startsWith("-") || e.endsWith("-") || !/^[a-zA-Z0-9-]+$/.test(e));
+}
+function i(e) {
+	if (e.length === 0 || e.length > 253 || e.startsWith(".") || e.endsWith(".") || e.startsWith("-") || e.endsWith("-")) return !1;
+	let t = e.split(".");
+	if (t.length < 2) return !1;
+	for (let e of t) if (!r(e)) return !1;
+	let n = t[t.length - 1];
+	return !(n.length < 2 || !/^[a-zA-Z]+$/.test(n));
+}
+function a(e) {
+	let t = e.split("@");
+	if (t.length !== 2) return !1;
+	let [r, a] = t;
+	return !(!n(r) || !i(a));
+}
+function o(e) {
+	let t = e.split("@");
+	return t.length === 2 ? t[1].toLowerCase() : null;
+}
+var s = [
+	"MX",
+	"A",
+	"AAAA"
+];
+async function c(t, n) {
+	try {
+		return await e?.promises?.resolve(t, n), !0;
+	} catch {
+		return !1;
+	}
+}
+async function l(e) {
+	for (let t of s) if (await c(e, t)) return !0;
+	return !1;
+}
+async function u(e) {
+	if (!e || typeof e != "string") return !1;
+	let n = e.trim();
+	if (!t(n) || !a(n)) return !1;
+	let r = o(n);
+	return r ? await l(r) : !1;
+}
+//#endregion
+export { u as validateEmail };
+
+//# sourceMappingURL=validateEmail.js.map

package/dist/modules/validations/validateEmail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateEmail.js","names":[],"sources":["../../../src/validations/validateEmail.ts"],"sourcesContent":["import dns from \"node:dns\";\n\nfunction isValidBasicFormat(email: string): boolean {\n\tconst emailRegex =\n\t\t/^[a-zA-Z0-9.!$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;\n\n\treturn emailRegex.test(email);\n}\n\nfunction isValidLocalPart(localPart: string): boolean {\n\tif (localPart.length === 0 || localPart.length > 64) return false;\n\tif (localPart.startsWith(\".\") || localPart.endsWith(\".\")) return false;\n\tif (localPart.includes(\"..\")) return false;\n\n\tconst validLocalRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+$/;\n\tif (!validLocalRegex.test(localPart)) return false;\n\n\treturn true;\n}\n\nfunction isValidDomainLabel(label: string): boolean {\n\tif (label.length === 0 || label.length > 63) return false;\n\tif (label.startsWith(\"-\") || label.endsWith(\"-\")) return false;\n\tif (!/^[a-zA-Z0-9-]+$/.test(label)) return false;\n\treturn true;\n}\n\nfunction isValidDomainPart(domainPart: string): boolean {\n\tif (domainPart.length === 0 || domainPart.length > 253) return false;\n\n\tif (\n\t\tdomainPart.startsWith(\".\") ||\n\t\tdomainPart.endsWith(\".\") ||\n\t\tdomainPart.startsWith(\"-\") ||\n\t\tdomainPart.endsWith(\"-\")\n\t) {\n\t\treturn false;\n\t}\n\n\tconst labels = domainPart.split(\".\");\n\tif (labels.length < 2) return false;\n\n\tfor (const label of labels) if (!isValidDomainLabel(label)) return false;\n\n\tconst tld = labels[labels.length - 1];\n\tif (tld.length < 2 || !/^[a-zA-Z]+$/.test(tld)) return false;\n\n\treturn true;\n}\n\nfunction isValidAdvancedSyntax(email: string): boolean {\n\tconst parts = email.split(\"@\");\n\tif (parts.length !== 2) return false;\n\n\tconst [localPart, domainPart] = parts;\n\n\tif (!isValidLocalPart(localPart)) return false;\n\tif (!isValidDomainPart(domainPart)) return false;\n\treturn true;\n}\n\nfunction extractDomain(email: string): string | null {\n\tconst parts = email.split(\"@\");\n\treturn parts.length === 2 ? parts[1].toLowerCase() : null;\n}\n\nconst DNS_RECORD_TYPES = [\"MX\", \"A\", \"AAAA\"] as const;\n\nasync function tryResolveDnsRecord(\n\tdomain: string,\n\trecordType: string,\n): Promise<boolean> {\n\ttry {\n\t\tawait dns?.promises?.resolve(domain, recordType);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nasync function isValidDns(domain: string): Promise<boolean> {\n\tfor (const recordType of DNS_RECORD_TYPES) {\n\t\tconst hasRecord = await tryResolveDnsRecord(domain, recordType);\n\t\tif (hasRecord) return true;\n\t}\n\treturn false;\n}\n\n/**\n * Validates if an email address is valid in all possible ways, including DNS validation.\n *\n * This function performs comprehensive email validation by:\n * - Checking basic email format and syntax\n * - Validating advanced RFC 5322 compliance rules\n * - Verifying that the domain has valid MX or A records in DNS\n *\n * @param rawEmail - The email address to validate.\n * @returns `true` if the email passes format checks and its domain resolves in DNS, otherwise `false`.\n *\n * @example\n * ```typescript\n * await validateEmail(\"user@gmail.com\"); // true\n * await validateEmail(\"user@gmil.com\"); // false (invalid domain)\n * await validateEmail(\"invalid-email\"); // false (invalid format)\n * ```\n */\n\nasync function validateEmail(rawEmail: string): Promise<boolean> {\n\tif (!rawEmail || typeof rawEmail !== \"string\") return false;\n\tconst email = rawEmail.trim();\n\n\tif (!isValidBasicFormat(email)) return false;\n\tif (!isValidAdvancedSyntax(email)) return false;\n\n\tconst domain = extractDomain(email);\n\tif (!domain) return false;\n\n\treturn await isValidDns(domain);\n}\n\nexport { validateEmail };\n"],"mappings":";;AAEA,SAAS,EAAmB,GAAwB;CAInD,OAAO,sIAAW,KAAK,CAAK;AAC7B;AAEA,SAAS,EAAiB,GAA4B;CAQrD,OAFA,EALI,EAAU,WAAW,KAAK,EAAU,SAAS,MAC7C,EAAU,WAAW,GAAG,KAAK,EAAU,SAAS,GAAG,KACnD,EAAU,SAAS,IAAI,KAGvB,CAAC,qCAAgB,KAAK,CAAS;AAGpC;AAEA,SAAS,EAAmB,GAAwB;CAInD,OADA,EAFI,EAAM,WAAW,KAAK,EAAM,SAAS,MACrC,EAAM,WAAW,GAAG,KAAK,EAAM,SAAS,GAAG,KAC3C,CAAC,kBAAkB,KAAK,CAAK;AAElC;AAEA,SAAS,EAAkB,GAA6B;CAGvD,IAFI,EAAW,WAAW,KAAK,EAAW,SAAS,OAGlD,EAAW,WAAW,GAAG,KACzB,EAAW,SAAS,GAAG,KACvB,EAAW,WAAW,GAAG,KACzB,EAAW,SAAS,GAAG,GAEvB,OAAO;CAGR,IAAM,IAAS,EAAW,MAAM,GAAG;CACnC,IAAI,EAAO,SAAS,GAAG,OAAO;CAE9B,KAAK,IAAM,KAAS,GAAQ,IAAI,CAAC,EAAmB,CAAK,GAAG,OAAO;CAEnE,IAAM,IAAM,EAAO,EAAO,SAAS;CAGnC,OAFA,EAAI,EAAI,SAAS,KAAK,CAAC,cAAc,KAAK,CAAG;AAG9C;AAEA,SAAS,EAAsB,GAAwB;CACtD,IAAM,IAAQ,EAAM,MAAM,GAAG;CAC7B,IAAI,EAAM,WAAW,GAAG,OAAO;CAE/B,IAAM,CAAC,GAAW,KAAc;CAIhC,OADA,EADI,CAAC,EAAiB,CAAS,KAC3B,CAAC,EAAkB,CAAU;AAElC;AAEA,SAAS,EAAc,GAA8B;CACpD,IAAM,IAAQ,EAAM,MAAM,GAAG;CAC7B,OAAO,EAAM,WAAW,IAAI,EAAM,EAAE,CAAC,YAAY,IAAI;AACtD;AAEA,IAAM,IAAmB;CAAC;CAAM;CAAK;AAAM;AAE3C,eAAe,EACd,GACA,GACmB;CACnB,IAAI;EAEH,OADA,MAAM,GAAK,UAAU,QAAQ,GAAQ,CAAU,GACxC;CACR,QAAQ;EACP,OAAO;CACR;AACD;AAEA,eAAe,EAAW,GAAkC;CAC3D,KAAK,IAAM,KAAc,GAExB,IAAI,MADoB,EAAoB,GAAQ,CAAU,GAC/C,OAAO;CAEvB,OAAO;AACR;AAqBA,eAAe,EAAc,GAAoC;CAChE,IAAI,CAAC,KAAY,OAAO,KAAa,UAAU,OAAO;CACtD,IAAM,IAAQ,EAAS,KAAK;CAG5B,IADI,CAAC,EAAmB,CAAK,KACzB,CAAC,EAAsB,CAAK,GAAG,OAAO;CAE1C,IAAM,IAAS,EAAc,CAAK;CAGlC,OAFK,IAEE,MAAM,EAAW,CAAM,IAFV;AAGrB"}

package/dist/modules/validations/validatePassword.js

@@ -0,0 +1,14 @@
+//#region src/validations/validatePassword.ts
+function e(e) {
+	return e ? [
+		e.length >= 8,
+		/[A-Z]/.test(e),
+		/[a-z]/.test(e),
+		/\d/.test(e),
+		/[!@#$%^&*(),.?":;{}|<>_\-+=~`[\]\\/]/.test(e)
+	].every((e) => e) : !1;
+}
+//#endregion
+export { e as validatePassword };
+
+//# sourceMappingURL=validatePassword.js.map

package/dist/modules/validations/validatePassword.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatePassword.js","names":[],"sources":["../../../src/validations/validatePassword.ts"],"sourcesContent":["/**\n * Validates a password based on the following rules:\n * - At least 8 characters\n * - At least 1 uppercase letter\n * - At least 1 letter (any case)\n * - At least 1 number\n * - At least 1 special character\n *\n * @param rawPassword - The password string to validate.\n * @returns `true` if the password meets all rules, otherwise `false`.\n *\n * @example\n * ```ts\n * validatePassword(\"Senha@123\"); // true\n * validatePassword(\"senha123\");  // false (no uppercase, no special char)\n * ```\n */\n\nfunction validatePassword(rawPassword: string): boolean {\n\tif (!rawPassword) return false;\n\n\tconst hasMinLength = rawPassword.length >= 8;\n\tconst hasUppercase = /[A-Z]/.test(rawPassword);\n\tconst hasLetter = /[a-z]/.test(rawPassword);\n\tconst hasNumber = /\\d/.test(rawPassword);\n\tconst hasSpecialChar = /[!@#$%^&*(),.?\":;{}|<>_\\-+=~`[\\]\\\\/]/.test(\n\t\trawPassword,\n\t);\n\n\treturn [\n\t\thasMinLength,\n\t\thasUppercase,\n\t\thasLetter,\n\t\thasNumber,\n\t\thasSpecialChar,\n\t].every((condition) => condition);\n}\n\nexport { validatePassword };\n"],"mappings":";AAkBA,SAAS,EAAiB,GAA8B;CAWvD,OAVK,IAUE;EARc,EAAY,UAAU;EACtB,QAAQ,KAAK,CASjC;EARiB,QAAQ,KAAK,CAS9B;EARiB,KAAK,KAAK,CAS3B;EARsB,uCAAuC,KAC7D,CAQA;CACD,CAAC,CAAC,OAAO,MAAc,CAAS,IAhBP;AAiB1B"}

package/dist/modules/validations/validatePhone.js

@@ -0,0 +1,12 @@
+import { countries as e } from "@arkyn/templates";
+import { isValidPhoneNumber as t, parsePhoneNumberWithError as n } from "libphonenumber-js";
+//#region src/validations/validatePhone.ts
+function r(r) {
+	if (!t(r)) return !1;
+	let i = n(r)?.country;
+	return !(!i || !e.find((e) => e.iso === i));
+}
+//#endregion
+export { r as validatePhone };
+
+//# sourceMappingURL=validatePhone.js.map

package/dist/modules/validations/validatePhone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatePhone.js","names":[],"sources":["../../../src/validations/validatePhone.ts"],"sourcesContent":["import { countries } from \"@arkyn/templates\";\nimport {\n\tisValidPhoneNumber,\n\tparsePhoneNumberWithError,\n} from \"libphonenumber-js\";\n\n/**\n * Validates an international phone number using `libphonenumber-js`, then confirms\n * the parsed country code is present in the supported countries list.\n *\n * @param rawPhone - Phone number in E.164 format (e.g. `\"+5532912345678\"`).\n * @returns `true` if the number is valid and the country is supported, otherwise `false`.\n *\n * @example\n * ```typescript\n * validatePhone(\"+5532912345678\"); // true (Brazil)\n * validatePhone(\"+55329123456178\"); // false (invalid)\n * ```\n */\n\nfunction validatePhone(rawPhone: string): boolean {\n\tif (!isValidPhoneNumber(rawPhone)) return false;\n\n\tconst parsedPhone = parsePhoneNumberWithError(rawPhone);\n\n\tconst countryCode = parsedPhone?.country;\n\tif (!countryCode) return false;\n\n\tconst country = countries.find((c) => c.iso === countryCode);\n\tif (!country) return false;\n\n\treturn true;\n}\n\nexport { validatePhone };\n"],"mappings":";;;AAoBA,SAAS,EAAc,GAA2B;CACjD,IAAI,CAAC,EAAmB,CAAQ,GAAG,OAAO;CAI1C,IAAM,IAFc,EAA0B,CAE1B,CAAA,EAAa;CAMjC,OAFA,EAHI,CAAC,KAGD,CADY,EAAU,MAAM,MAAM,EAAE,QAAQ,CAC3C;AAGN"}

package/dist/modules/validations/validateRg.js

@@ -0,0 +1,10 @@
+//#region src/validations/validateRg.ts
+function e(e) {
+	if (!e || !/^[0-9a-zA-Z.-]+$/.test(e)) return !1;
+	let t = e.replace(/[^a-zA-Z0-9]/g, "");
+	return t.length < 7 || t.length > 9 ? !1 : /^[0-9]{7,8}[0-9Xx]?$/.test(t);
+}
+//#endregion
+export { e as validateRg };
+
+//# sourceMappingURL=validateRg.js.map

package/dist/modules/validations/validateRg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateRg.js","names":[],"sources":["../../../src/validations/validateRg.ts"],"sourcesContent":["/**\n * Validates a Brazilian RG (Registro Geral) in a generic way.\n *\n * This function does a basic structure validation:\n * - Removes non-alphanumeric characters.\n * - Ensures length is reasonable (7–9 digits).\n * - Optionally allows for a final letter (verifier).\n *\n * @param rawRg - RG string, possibly formatted.\n * @returns `true` if format seems valid, otherwise `false`.\n *\n * @example\n * ```ts\n * validateRg(\"12.345.678-9\"); // true\n * validateRg(\"MG-12.345.678\"); // false (not supported)\n * validateRg(\"12345678X\"); // true\n * ```\n */\n\nfunction validateRg(rawRg: string): boolean {\n\tif (!rawRg) return false;\n\n\tconst validFormat = /^[0-9a-zA-Z.-]+$/.test(rawRg);\n\tif (!validFormat) return false;\n\n\tconst rg = rawRg.replace(/[^a-zA-Z0-9]/g, \"\");\n\n\tif (rg.length < 7 || rg.length > 9) return false;\n\n\tconst isValidFormat = /^[0-9]{7,8}[0-9Xx]?$/.test(rg);\n\n\treturn isValidFormat;\n}\n\nexport { validateRg };\n"],"mappings":";AAmBA,SAAS,EAAW,GAAwB;CAI3C,IAHI,CAAC,KAGD,CADgB,mBAAmB,KAAK,CACvC,GAAa,OAAO;CAEzB,IAAM,IAAK,EAAM,QAAQ,iBAAiB,EAAE;CAM5C,OAJI,EAAG,SAAS,KAAK,EAAG,SAAS,IAAU,KAErB,uBAAuB,KAAK,CAE3C;AACR"}

package/dist/services/apiService.d.ts

@@ -1,48 +1,47 @@
 type ApiServiceConstructorProps = {
+    /** Base URL prepended to every request path (e.g. `"https://api.example.com"`). */
     baseUrl: string;
+    /** Default headers merged into every request. */
     baseHeaders?: HeadersInit;
+    /** Default Bearer token; can be overridden per request via `data.token`. */
     baseToken?: string | null;
+    /** When `true`, logs each request and response to the console in development. */
     enableDebug?: boolean;
 };
 type ApiRequestDataWithoutBodyProps = {
     headers?: HeadersInit;
     token?: string;
+    urlParams?: Record<string, string>;
 };
 type ApiRequestDataWithBodyProps = {
     body?: any;
     headers?: HeadersInit;
     token?: string;
+    urlParams?: Record<string, string>;
 };
 /**
- * Class representing an API instance to handle HTTP requests with base configurations.
+ * HTTP client for external API calls. Wraps fetch with base URL, default headers, optional auth token,
+ * and per-request overrides for all standard HTTP methods.
+ *
+ * @example
+ * ```typescript
+ * const api = new ApiService({
+ *   baseUrl: "https://api.example.com",
+ *   baseToken: session.token,
+ *   enableDebug: true,
+ * });
+ *
+ * const { data } = await api.get("/users/me");
+ * const { data: created } = await api.post("/orders", { body: { productId: 1 } });
+ * ```
  */
 declare class ApiService {
     private baseUrl;
     private baseHeaders?;
     private baseToken?;
     private enableDebug?;
-    /**
-     * Creates an instance of ApiService.
-     * @param props - The configuration properties for the API instance.
-     * @param props.baseUrl - The base URL for the API.
-     * @param props.baseHeaders - Optional base headers to include in all requests.
-     * @param props.baseToken - Optional base token for authorization.
-     * @param props.enableDebug - Optional flag to enable debug logging for requests.
-     */
     constructor(props: ApiServiceConstructorProps);
-    /**
-     * Generates the full URL by appending the route to the base URL.
-     * @param route - The route to append to the base URL.
-     * @returns The full URL as a string.
-     */
     private onDebug;
-    private generateURL;
-    /**
-     * Generates the headers for a request by merging base headers, provided headers, and tokens.
-     * @param initHeaders - Initial headers to include in the request.
-     * @param token - Optional token to override the base token.
-     * @returns The merged headers as a HeadersInit object.
-     */
     private generateHeaders;
     /**
      * Sends a get request to the specified endpoint.
@@ -50,35 +49,35 @@ declare class ApiService {
      * @param data - The request data, including optional headers and token.
      * @returns The API response data.
      */
-    get(endpoint: string, data?: ApiRequestDataWithoutBodyProps): Promise<import("../types/ApiResponseDTO").ApiResponseDTO<any>>;
+    get(endpoint: string, data?: ApiRequestDataWithoutBodyProps): Promise<import("../http/api/_makeRequest").ApiResponseDTO<any>>;
     /**
      * Sends a post request to the specified endpoint.
      * @param endpoint - The API endpoint to send the post request to.
      * @param data - The request data, including body, optional headers, and token.
      * @returns The API response data.
      */
-    post(endpoint: string, data?: ApiRequestDataWithBodyProps): Promise<import("../types/ApiResponseDTO").ApiResponseDTO<any>>;
+    post(endpoint: string, data?: ApiRequestDataWithBodyProps): Promise<import("../http/api/_makeRequest").ApiResponseDTO<any>>;
     /**
      * Sends a put request to the specified endpoint.
      * @param endpoint - The API endpoint to send the put request to.
      * @param data - The request data, including body, optional headers, and token.
      * @returns The API response data.
      */
-    put(endpoint: string, data?: ApiRequestDataWithBodyProps): Promise<import("../types/ApiResponseDTO").ApiResponseDTO<any>>;
+    put(endpoint: string, data?: ApiRequestDataWithBodyProps): Promise<import("../http/api/_makeRequest").ApiResponseDTO<any>>;
     /**
      * Sends a patch request to the specified endpoint.
      * @param endpoint - The API endpoint to send the patch request to.
      * @param data - The request data, including body, optional headers, and token.
      * @returns The API response data.
      */
-    patch(endpoint: string, data?: ApiRequestDataWithBodyProps): Promise<import("../types/ApiResponseDTO").ApiResponseDTO<any>>;
+    patch(endpoint: string, data?: ApiRequestDataWithBodyProps): Promise<import("../http/api/_makeRequest").ApiResponseDTO<any>>;
     /**
      * Sends a delete request to the specified endpoint.
      * @param endpoint - The API endpoint to send the delete request to.
      * @param data - The request data, including body, optional headers, and token.
      * @returns The API response data.
      */
-    delete(endpoint: string, data?: ApiRequestDataWithBodyProps): Promise<import("../types/ApiResponseDTO").ApiResponseDTO<any>>;
+    delete(endpoint: string, data?: ApiRequestDataWithBodyProps): Promise<import("../http/api/_makeRequest").ApiResponseDTO<any>>;
 }
 export { ApiService };
 //# sourceMappingURL=apiService.d.ts.map

package/dist/services/apiService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apiService.d.ts","sourceRoot":"","sources":["../../src/services/apiService.ts"],"names":[],"mappings":"AAOA,KAAK,0BAA0B,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,KAAK,8BAA8B,GAAG;IACpC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,2BAA2B,GAAG;IACjC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AAEH,cAAM,UAAU;IACd,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAU;IAE9B;;;;;;;OAOG;gBAES,KAAK,EAAE,0BAA0B;IAO7C;;;;OAIG;IAEH,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,WAAW;IAInB;;;;;OAKG;IAEH,OAAO,CAAC,eAAe;IAcvB;;;;;OAKG;IAEG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,8BAA8B;IAQjE;;;;;OAKG;IAEG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,2BAA2B;IAS/D;;;;;OAKG;IAEG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,2BAA2B;IAS9D;;;;;OAKG;IAEG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,2BAA2B;IAShE;;;;;OAKG;IAEG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,2BAA2B;CAQlE;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"apiService.d.ts","sourceRoot":"","sources":["../../src/services/apiService.ts"],"names":[],"mappings":"AAOA,KAAK,0BAA0B,GAAG;IACjC,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,KAAK,8BAA8B,GAAG;IACrC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,KAAK,2BAA2B,GAAG;IAElC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAUF;;;;;;;;;;;;;;;GAeG;AACH,cAAM,UAAU;IACf,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAU;gBAElB,KAAK,EAAE,0BAA0B;IAO7C,OAAO,CAAC,OAAO;IAiBf,OAAO,CAAC,eAAe;IAcvB;;;;;OAKG;IAEG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,8BAA8B;IAkBjE;;;;;OAKG;IAEG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,2BAA2B;IAqB/D;;;;;OAKG;IAEG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,2BAA2B;IAqB9D;;;;;OAKG;IAEG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,2BAA2B;IAqBhE;;;;;OAKG;IAEG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,2BAA2B;CAoBjE;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/services/debugService.d.ts

@@ -1,17 +1,11 @@
 /**
- * Service for managing HTTP debug configuration and behavior.
- *
- * This service provides functionality to configure how the `getCaller` function
- * identifies the actual caller in the stack trace by allowing specific files
- * to be ignored during stack trace analysis.
+ * Manages stack-trace configuration for debug output, allowing specific adapter/wrapper files
+ * to be skipped so logs show the actual business-logic caller.
  *
  * @example
  * ```typescript
- * // Configure to ignore httpAdapter.ts in stack traces
- * HttpDebugService.setIgnoreFile("httpAdapter.ts");
- *
- * // Now when httpDebug is called from within httpAdapter.ts,
- * // it will show the actual caller (e.g., cart.ts) instead
+ * // Skip httpAdapter.ts so debug output shows the calling route instead
+ * DebugService.setIgnoreFile("httpAdapter.ts");
  * ```
  */
 declare class DebugService {
@@ -21,34 +15,23 @@ declare class DebugService {
      */
     static ignoreFiles: string[];
     /**
-     * Sets the file name to be ignored during stack trace analysis.
-     *
-     * This method configures the debug service to skip specific files when
-     * determining the actual caller of a function. This is useful when you have
-     * adapter or wrapper functions that you want to be transparent in the debug output.
-     *
-     * @param file - The name of the file to ignore in stack traces (e.g., "httpAdapter.ts")
+     * Adds a file name to the ignore list so it is skipped when resolving the caller in stack traces.
      *
-     * @example
-     * ```typescript
-     * // Ignore the HTTP adapter file so debug shows the actual business logic caller
-     * DebugService.setIgnoreFile("httpAdapter.ts");
-     * ```
+     * @param file - File name to ignore (e.g. `"httpAdapter.ts"`).
      */
     static setIgnoreFile(file: string): void;
+    /** Resets the ignore list, restoring full stack trace analysis. */
+    static clearIgnoreFiles(): void;
     /**
-     * Clears all configured ignore files.
-     *
-     * This method resets the ignore file configuration, allowing all files to be
-     * considered in stack trace analysis again.
+     * Resolves the file path and function name of the code that triggered the current debug call,
+     * skipping internal node modules and any files registered with `setIgnoreFile`.
      *
-     * @example
-     * ```typescript
-     * // Clear all ignore file configurations
-     * DebugService.clearIgnoreFiles();
-     * ```
+     * @returns `{ functionName, callerInfo }` — caller function name and file path relative to `process.cwd()`.
      */
-    static clearIgnoreFiles(): void;
+    static getCaller(): {
+        functionName: string;
+        callerInfo: string;
+    };
 }
 export { DebugService };
 //# sourceMappingURL=debugService.d.ts.map

package/dist/services/debugService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debugService.d.ts","sourceRoot":"","sources":["../../src/services/debugService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAM,YAAY;IAChB;;;OAGG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAAM;IAElC;;;;;;;;;;;;;;OAcG;IAEH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM;IAIjC;;;;;;;;;;;OAWG;IAEH,MAAM,CAAC,gBAAgB;CAGxB;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"debugService.d.ts","sourceRoot":"","sources":["../../src/services/debugService.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,cAAM,YAAY;IACjB;;;OAGG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAAM;IAElC;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxC,mEAAmE;IACnE,MAAM,CAAC,gBAAgB,IAAI,IAAI;IAI/B;;;;;OAKG;IACH,MAAM,CAAC,SAAS;;;;CAgEhB;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/services/logService.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Static service for log endpoint configuration and access.
+ *
+ * Stores a singleton configuration containing the traffic source identifier,
+ * user token, and log ingestion URL.
+ */
+declare class LogService {
+    private static config?;
+    /**
+     * Sets the log service configuration once. Subsequent calls are ignored.
+     *
+     * @param config.trafficSourceId - Traffic source identifier.
+     * @param config.userToken - User token for authentication.
+     * @param config.logBaseApiUrl - Override the default log ingestion base URL.
+     */
+    static setConfig(config: {
+        trafficSourceId: string;
+        userToken: string;
+        logBaseApiUrl?: string;
+    }): void;
+    /** Returns the stored configuration, or `undefined` if `setConfig` has not been called. */
+    static getConfig(): {
+        trafficSourceId: string;
+        userToken: string;
+        apiUrl: string;
+    } | undefined;
+    /**
+     * Resets the stored configuration, allowing a new initialization.
+     */
+    static resetConfig(): void;
+}
+export { LogService };
+//# sourceMappingURL=logService.d.ts.map

package/dist/services/logService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logService.d.ts","sourceRoot":"","sources":["../../src/services/logService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAM,UAAU;IACf,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAIpB;IAEF;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,IAAI;IAUR,2FAA2F;IAC3F,MAAM,CAAC,SAAS,IACb;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC9D,SAAS;IAIZ;;OAEG;IACH,MAAM,CAAC,WAAW;CAGlB;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/utilities/decodeRequestBody.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Decodes a request body into a plain object, trying JSON first then URL-encoded form data.
+ * Throws `BadRequest` if neither format can be parsed.
+ *
+ * @param request - The incoming request whose body will be decoded.
+ * @returns The decoded body as a plain object.
+ *
+ * @example
+ * ```typescript
+ * export async function action({ request }: ActionFunctionArgs) {
+ *   const body = await decodeRequestBody(request);
+ *   // body is now a plain JS object
+ * }
+ * ```
+ */
+declare function decodeRequestBody(request: Request): Promise<any>;
+export { decodeRequestBody };
+//# sourceMappingURL=decodeRequestBody.d.ts.map

package/dist/utilities/decodeRequestBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeRequestBody.d.ts","sourceRoot":"","sources":["../../src/utilities/decodeRequestBody.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAGH,iBAAe,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAuB/D;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/utilities/decodeRequestErrorMessage.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Extracts a human-readable error message from an API response body or a `Response` object.
+ * Checks `data.message`, `data.operator_erro_message`, `data.error`, `data.error.message`,
+ * and `response.statusText` in that order. Falls back to `"Missing error message"`.
+ *
+ * @param data - Parsed response body that may contain error info.
+ * @param response - The raw `Response` object, used as a fallback for `statusText`.
+ * @returns The first non-empty string error message found.
+ *
+ * @example
+ * ```typescript
+ * const res = await fetch("/api/orders");
+ * const data = await res.json().catch(() => null);
+ * const message = decodeRequestErrorMessage(data, res);
+ * ```
+ */
+declare function decodeRequestErrorMessage(data: any, response: Response): string;
+export { decodeRequestErrorMessage };
+//# sourceMappingURL=decodeRequestErrorMessage.d.ts.map

package/dist/utilities/decodeRequestErrorMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeRequestErrorMessage.d.ts","sourceRoot":"","sources":["../../src/utilities/decodeRequestErrorMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,iBAAS,yBAAyB,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAyBxE;AAED,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/utilities/errorHandler.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Converts any thrown value into a `Response`. Recognizes all `@arkyn/server` success and error
+ * response classes, native `Response` objects, and falls back to a 500 `ServerError` for anything else.
+ *
+ * Intended to be used as the catch handler of a route action or loader:
+ *
+ * @param error - The thrown value to convert.
+ * @returns A `Response` with the appropriate HTTP status, headers, and JSON body.
+ *
+ * @example
+ * ```typescript
+ * export async function action({ request }: ActionFunctionArgs) {
+ *   try {
+ *     const user = await findUser(id);
+ *     if (!user) throw new NotFound("User not found");
+ *     return new Success("User retrieved", { user }).toJson();
+ *   } catch (error) {
+ *     return errorHandler(error);
+ *   }
+ * }
+ * ```
+ */
+declare function errorHandler(error: any): Response;
+export { errorHandler };
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/utilities/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/utilities/errorHandler.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,iBAAS,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,QAAQ,CAsC1C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/utilities/flushDebugLogs.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Writes colored `[name] message` lines to the console, but only when
+ * `NODE_ENV === "development"` or `DEBUG_MODE === "true"`. No-op in production.
+ *
+ * @param props.name - Label shown before each line (e.g. `"API"`, `"Auth"`).
+ * @param props.scheme - Color of the label tag: `"cyan"` info, `"green"` success, `"yellow"` warning, `"red"` error.
+ * @param props.debugs - Lines of text to print, one per console entry.
+ *
+ * @example
+ * ```typescript
+ * flushDebugLogs({
+ *   name: "API",
+ *   scheme: "cyan",
+ *   debugs: ["POST /api/users", "Status: 201"],
+ * });
+ * ```
+ */
+declare function flushDebugLogs(props: {
+    scheme: "yellow" | "cyan" | "red" | "green";
+    name: string;
+    debugs: string[];
+}): void;
+export { flushDebugLogs };
+//# sourceMappingURL=flushDebugLogs.d.ts.map

package/dist/utilities/flushDebugLogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flushDebugLogs.d.ts","sourceRoot":"","sources":["../../src/utilities/flushDebugLogs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,iBAAS,cAAc,CAAC,KAAK,EAAE;IAC9B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB,GAAG,IAAI,CAyBP;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/utilities/formAsyncParse.d.ts

@@ -0,0 +1,38 @@
+import type { ZodType } from "zod";
+type SuccessResponse<T extends FormParseProps> = {
+    success: true;
+    data: T[1] extends ZodType<infer U> ? U : never;
+};
+type ErrorResponse = {
+    success: false;
+    fields: {
+        [x: string]: string;
+    };
+    fieldErrors: {
+        [x: string]: string;
+    };
+};
+type FormParseProps = [formData: {
+    [k: string]: any;
+}, schema: ZodType];
+type FormParseReturnType<T extends FormParseProps> = SuccessResponse<T> | ErrorResponse;
+/**
+ * Async variant of `formParse` — uses `safeParseAsync` to support Zod schemas with async refinements.
+ * Returns `{ success: true, data }` on success or `{ success: false, fieldErrors, fields }` on failure.
+ *
+ * @param formData - The raw form data object to validate.
+ * @param schema - The Zod schema to validate against.
+ *
+ * @example
+ * ```typescript
+ * const schema = z.object({ email: z.string().email() });
+ * const result = await formAsyncParse([{ email: "bad" }, schema]);
+ *
+ * if (!result.success) {
+ *   console.log(result.fieldErrors); // { email: "Invalid email" }
+ * }
+ * ```
+ */
+declare function formAsyncParse<T extends FormParseProps>([formData, schema,]: T): Promise<FormParseReturnType<T>>;
+export { formAsyncParse };
+//# sourceMappingURL=formAsyncParse.d.ts.map

package/dist/utilities/formAsyncParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formAsyncParse.d.ts","sourceRoot":"","sources":["../../src/utilities/formAsyncParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,KAAK,eAAe,CAAC,CAAC,SAAS,cAAc,IAAI;IAChD,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;CAChD,CAAC;AAEF,KAAK,aAAa,GAAG;IACpB,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAChC,WAAW,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACrC,CAAC;AAGF,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAExE,KAAK,mBAAmB,CAAC,CAAC,SAAS,cAAc,IAC9C,eAAe,CAAC,CAAC,CAAC,GAClB,aAAa,CAAC;AAEjB;;;;;;;;;;;;;;;;GAgBG;AAEH,iBAAe,cAAc,CAAC,CAAC,SAAS,cAAc,EAAE,CACvD,QAAQ,EACR,MAAM,EACN,EAAE,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAqBrC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/utilities/formParse.d.ts

@@ -0,0 +1,38 @@
+import type { ZodType } from "zod";
+type SuccessResponse<T extends FormParseProps> = {
+    success: true;
+    data: T[1] extends ZodType<infer U> ? U : never;
+};
+type ErrorResponse = {
+    success: false;
+    fields: {
+        [x: string]: string;
+    };
+    fieldErrors: {
+        [x: string]: string;
+    };
+};
+type FormParseProps = [formData: {
+    [k: string]: any;
+}, schema: ZodType];
+type FormParseReturnType<T extends FormParseProps> = SuccessResponse<T> | ErrorResponse;
+/**
+ * Validates form data against a Zod schema synchronously.
+ * Returns `{ success: true, data }` on success or `{ success: false, fieldErrors, fields }` on failure.
+ *
+ * @param formData - The raw form data object to validate.
+ * @param schema - The Zod schema to validate against.
+ *
+ * @example
+ * ```typescript
+ * const schema = z.object({ name: z.string().min(1, "Required"), age: z.number().min(18) });
+ * const result = formParse([{ name: "", age: 15 }, schema]);
+ *
+ * if (!result.success) {
+ *   console.log(result.fieldErrors); // { name: "Required", age: "..." }
+ * }
+ * ```
+ */
+declare function formParse<T extends FormParseProps>([formData, schema,]: T): FormParseReturnType<T>;
+export { formParse };
+//# sourceMappingURL=formParse.d.ts.map

package/dist/utilities/formParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formParse.d.ts","sourceRoot":"","sources":["../../src/utilities/formParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,KAAK,eAAe,CAAC,CAAC,SAAS,cAAc,IAAI;IAChD,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;CAChD,CAAC;AAEF,KAAK,aAAa,GAAG;IACpB,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAChC,WAAW,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACrC,CAAC;AAGF,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAExE,KAAK,mBAAmB,CAAC,CAAC,SAAS,cAAc,IAC9C,eAAe,CAAC,CAAC,CAAC,GAClB,aAAa,CAAC;AAEjB;;;;;;;;;;;;;;;;GAgBG;AAEH,iBAAS,SAAS,CAAC,CAAC,SAAS,cAAc,EAAE,CAC5C,QAAQ,EACR,MAAM,EACN,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAqB5B;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/utilities/getScopedParams.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Extracts URL search parameters from a request, optionally filtered by a namespace prefix
+ * (e.g. `scope:key` → `key`). Without a scope, returns all search params as-is.
+ *
+ * @param request - The incoming request whose URL will be parsed.
+ * @param scope - Namespace prefix to filter by (e.g. `"table"` matches `table:page`, `table:sort`).
+ * @returns A `URLSearchParams` object with the matching params, stripped of the scope prefix.
+ *
+ * @example
+ * ```typescript
+ * // URL: /products?table:page=2&table:sort=asc&other=1
+ * const params = getScopedParams(request, "table");
+ * params.get("page");  // "2"
+ * params.get("sort");  // "asc"
+ * ```
+ */
+declare function getScopedParams(request: Request, scope?: string): URLSearchParams;
+export { getScopedParams };
+//# sourceMappingURL=getScopedParams.d.ts.map

package/dist/utilities/getScopedParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getScopedParams.d.ts","sourceRoot":"","sources":["../../src/utilities/getScopedParams.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,iBAAS,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,GAAE,MAAW,mBAW5D;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}