@farm.js/core 0.1.0-beta.0

package/dist/query/parsers.d.mts

@@ -0,0 +1,25 @@
+/**
+ * Farm.js Query State Parsers
+ *
+ * Shared parsers that can be used in both client and server contexts
+ */
+interface Parser<T> {
+    parse: (value: string) => T | null;
+    serialize: (value: T) => string;
+    withDefault?: (defaultValue: T) => Parser<T>;
+}
+declare const asString: Parser<string>;
+declare const asInteger: Parser<number>;
+declare const asFloat: Parser<number>;
+declare const asBoolean: Parser<boolean>;
+declare function asArrayOf<T>(itemParser: Parser<T>): Parser<T[]>;
+declare function asJson<T>(): Parser<T>;
+declare const asIsoDate: Parser<Date>;
+declare const asIsoDateTime: Parser<Date>;
+declare function createParser<T>(config: {
+    parse: (value: string) => T | null;
+    serialize: (value: T) => string;
+}): Parser<T>;
+type inferParserType<T> = T extends Parser<infer U> ? U : never;
+
+export { type Parser, asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, type inferParserType };

package/dist/query/parsers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Farm.js Query State Parsers
+ *
+ * Shared parsers that can be used in both client and server contexts
+ */
+interface Parser<T> {
+    parse: (value: string) => T | null;
+    serialize: (value: T) => string;
+    withDefault?: (defaultValue: T) => Parser<T>;
+}
+declare const asString: Parser<string>;
+declare const asInteger: Parser<number>;
+declare const asFloat: Parser<number>;
+declare const asBoolean: Parser<boolean>;
+declare function asArrayOf<T>(itemParser: Parser<T>): Parser<T[]>;
+declare function asJson<T>(): Parser<T>;
+declare const asIsoDate: Parser<Date>;
+declare const asIsoDateTime: Parser<Date>;
+declare function createParser<T>(config: {
+    parse: (value: string) => T | null;
+    serialize: (value: T) => string;
+}): Parser<T>;
+type inferParserType<T> = T extends Parser<infer U> ? U : never;
+
+export { type Parser, asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, type inferParserType };

package/dist/query/parsers.mjs

@@ -0,0 +1,24 @@
+import {
+  asArrayOf,
+  asBoolean,
+  asFloat,
+  asInteger,
+  asIsoDate,
+  asIsoDateTime,
+  asJson,
+  asString,
+  createParser
+} from "../chunk-E2MPIBRE.mjs";
+import "../chunk-CGILA3WO.mjs";
+export {
+  asArrayOf,
+  asBoolean,
+  asFloat,
+  asInteger,
+  asIsoDate,
+  asIsoDateTime,
+  asJson,
+  asString,
+  createParser
+};
+//# sourceMappingURL=parsers.mjs.map

package/dist/query/parsers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/query/server.cjs

@@ -0,0 +1,301 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/query/server.ts
+var server_exports = {};
+__export(server_exports, {
+  asArrayOf: () => asArrayOf,
+  asBoolean: () => asBoolean,
+  asFloat: () => asFloat,
+  asInteger: () => asInteger,
+  asIsoDate: () => asIsoDate,
+  asIsoDateTime: () => asIsoDateTime,
+  asJson: () => asJson,
+  asString: () => asString,
+  createPaginationMeta: () => createPaginationMeta,
+  createParser: () => createParser,
+  loadRouteParams: () => loadRouteParams,
+  loadSearchParams: () => loadSearchParams,
+  parseRouteParams: () => parseRouteParams
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/query/params.ts
+function normalizeParams(input) {
+  if (input instanceof URLSearchParams) {
+    const params = {};
+    input.forEach((value, key) => {
+      params[key] = value;
+    });
+    return params;
+  }
+  return input;
+}
+__name(normalizeParams, "normalizeParams");
+async function loadRouteParams(input, parsers, options = {}) {
+  const resolved = await Promise.resolve(input);
+  const params = normalizeParams(resolved);
+  const result = {};
+  for (const [key, parser] of Object.entries(parsers)) {
+    const raw = params[key] ?? "";
+    const parsed = parser.parse(raw);
+    if (parsed === null && options.strict) {
+      throw new Error(`Failed to parse route param "${key}" with value "${raw}"`);
+    }
+    result[key] = parsed;
+  }
+  return result;
+}
+__name(loadRouteParams, "loadRouteParams");
+function parseRouteParams(input, parsers, options = {}) {
+  const params = normalizeParams(input);
+  const result = {};
+  for (const [key, parser] of Object.entries(parsers)) {
+    const raw = params[key] ?? "";
+    const parsed = parser.parse(raw);
+    if (parsed === null && options.strict) {
+      throw new Error(`Failed to parse route param "${key}" with value "${raw}"`);
+    }
+    result[key] = parsed;
+  }
+  return result;
+}
+__name(parseRouteParams, "parseRouteParams");
+
+// src/query/parsers.ts
+var asString = {
+  parse: /* @__PURE__ */ __name((value) => value && value.trim() || null, "parse"),
+  serialize: /* @__PURE__ */ __name((value) => value, "serialize"),
+  withDefault: /* @__PURE__ */ __name((defaultValue) => ({
+    parse: /* @__PURE__ */ __name((value) => value && value.trim() || defaultValue, "parse"),
+    serialize: /* @__PURE__ */ __name((value) => value || defaultValue, "serialize")
+  }), "withDefault")
+};
+var asInteger = {
+  parse: /* @__PURE__ */ __name((value) => {
+    const parsed = Number.parseInt(value, 10);
+    return isNaN(parsed) ? null : parsed;
+  }, "parse"),
+  serialize: /* @__PURE__ */ __name((value) => value.toString(), "serialize"),
+  withDefault: /* @__PURE__ */ __name((defaultValue) => ({
+    parse: /* @__PURE__ */ __name((value) => {
+      const parsed = Number.parseInt(value, 10);
+      return isNaN(parsed) ? defaultValue : parsed;
+    }, "parse"),
+    serialize: /* @__PURE__ */ __name((value) => value.toString(), "serialize")
+  }), "withDefault")
+};
+var asFloat = {
+  parse: /* @__PURE__ */ __name((value) => {
+    const parsed = Number.parseFloat(value);
+    return isNaN(parsed) ? null : parsed;
+  }, "parse"),
+  serialize: /* @__PURE__ */ __name((value) => value.toString(), "serialize"),
+  withDefault: /* @__PURE__ */ __name((defaultValue) => ({
+    parse: /* @__PURE__ */ __name((value) => {
+      const parsed = Number.parseFloat(value);
+      return isNaN(parsed) ? defaultValue : parsed;
+    }, "parse"),
+    serialize: /* @__PURE__ */ __name((value) => value.toString(), "serialize")
+  }), "withDefault")
+};
+var asBoolean = {
+  parse: /* @__PURE__ */ __name((value) => {
+    if (value === "true") return true;
+    if (value === "false") return false;
+    return null;
+  }, "parse"),
+  serialize: /* @__PURE__ */ __name((value) => value.toString(), "serialize"),
+  withDefault: /* @__PURE__ */ __name((defaultValue) => ({
+    parse: /* @__PURE__ */ __name((value) => {
+      if (value === "true") return true;
+      if (value === "false") return false;
+      return defaultValue;
+    }, "parse"),
+    serialize: /* @__PURE__ */ __name((value) => value.toString(), "serialize")
+  }), "withDefault")
+};
+function asArrayOf(itemParser) {
+  return {
+    parse: /* @__PURE__ */ __name((value) => {
+      if (!value) return null;
+      return value.split(",").filter(Boolean).map((item) => itemParser.parse(item.trim())).filter((item) => item !== null);
+    }, "parse"),
+    serialize: /* @__PURE__ */ __name((value) => value.map((item) => itemParser.serialize(item)).join(","), "serialize"),
+    withDefault: /* @__PURE__ */ __name((defaultValue) => ({
+      parse: /* @__PURE__ */ __name((value) => {
+        if (!value) return defaultValue;
+        return value.split(",").filter(Boolean).map((item) => itemParser.parse(item.trim())).filter((item) => item !== null);
+      }, "parse"),
+      serialize: /* @__PURE__ */ __name((value) => value.map((item) => itemParser.serialize(item)).join(","), "serialize")
+    }), "withDefault")
+  };
+}
+__name(asArrayOf, "asArrayOf");
+function asJson() {
+  return {
+    parse: /* @__PURE__ */ __name((value) => {
+      try {
+        return JSON.parse(value);
+      } catch {
+        return null;
+      }
+    }, "parse"),
+    serialize: /* @__PURE__ */ __name((value) => JSON.stringify(value), "serialize"),
+    withDefault: /* @__PURE__ */ __name((defaultValue) => ({
+      parse: /* @__PURE__ */ __name((value) => {
+        try {
+          return JSON.parse(value);
+        } catch {
+          return defaultValue;
+        }
+      }, "parse"),
+      serialize: /* @__PURE__ */ __name((value) => JSON.stringify(value), "serialize")
+    }), "withDefault")
+  };
+}
+__name(asJson, "asJson");
+var asIsoDate = {
+  parse: /* @__PURE__ */ __name((value) => {
+    const date = new Date(value);
+    return isNaN(date.getTime()) ? null : date;
+  }, "parse"),
+  serialize: /* @__PURE__ */ __name((value) => value.toISOString(), "serialize"),
+  withDefault: /* @__PURE__ */ __name((defaultValue) => ({
+    parse: /* @__PURE__ */ __name((value) => {
+      const date = new Date(value);
+      return isNaN(date.getTime()) ? defaultValue : date;
+    }, "parse"),
+    serialize: /* @__PURE__ */ __name((value) => value.toISOString(), "serialize")
+  }), "withDefault")
+};
+var asIsoDateTime = {
+  parse: /* @__PURE__ */ __name((value) => {
+    const date = new Date(value);
+    return isNaN(date.getTime()) ? null : date;
+  }, "parse"),
+  serialize: /* @__PURE__ */ __name((value) => value.toISOString(), "serialize"),
+  withDefault: /* @__PURE__ */ __name((defaultValue) => ({
+    parse: /* @__PURE__ */ __name((value) => {
+      const date = new Date(value);
+      return isNaN(date.getTime()) ? defaultValue : date;
+    }, "parse"),
+    serialize: /* @__PURE__ */ __name((value) => value.toISOString(), "serialize")
+  }), "withDefault")
+};
+function createParser(config) {
+  return {
+    parse: config.parse,
+    serialize: config.serialize,
+    withDefault: /* @__PURE__ */ __name((defaultValue) => ({
+      parse: /* @__PURE__ */ __name((value) => config.parse(value) ?? defaultValue, "parse"),
+      serialize: config.serialize
+    }), "withDefault")
+  };
+}
+__name(createParser, "createParser");
+
+// src/query/server.ts
+async function loadSearchParams(searchParams, parsers) {
+  const params = await searchParams;
+  let urlParams;
+  if (params instanceof URLSearchParams) {
+    urlParams = params;
+  } else {
+    urlParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (Array.isArray(value)) {
+        for (const v of value) {
+          urlParams.append(key, v);
+        }
+      } else if (value !== void 0 && value !== null) {
+        urlParams.set(key, String(value));
+      }
+    }
+  }
+  const result = {};
+  for (const [key, parser] of Object.entries(parsers)) {
+    const value = urlParams.get(key);
+    if (value !== null && value !== "") {
+      try {
+        result[key] = parser.parse(value);
+      } catch (error) {
+        console.error(`Failed to parse parameter "${key}":`, error);
+        throw error;
+      }
+    } else {
+      result[key] = parser.parse("");
+    }
+  }
+  return result;
+}
+__name(loadSearchParams, "loadSearchParams");
+async function createPaginationMeta(searchParams, options) {
+  const params = await searchParams;
+  let urlParams;
+  if (params instanceof URLSearchParams) {
+    urlParams = params;
+  } else {
+    urlParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (Array.isArray(value)) {
+        for (const v of value) {
+          urlParams.append(key, v);
+        }
+      } else if (value !== void 0 && value !== null) {
+        urlParams.set(key, String(value));
+      }
+    }
+  }
+  const pageParam = options.pageParam || "page";
+  const itemsPerPage = options.itemsPerPage || 10;
+  const currentPage = Number.parseInt(urlParams.get(pageParam) || "1", 10);
+  const totalPages = Math.ceil(options.totalItems / itemsPerPage);
+  const offset = (currentPage - 1) * itemsPerPage;
+  const limit = itemsPerPage;
+  return {
+    currentPage,
+    itemsPerPage,
+    totalItems: options.totalItems,
+    totalPages,
+    offset,
+    limit,
+    hasNextPage: currentPage < totalPages,
+    hasPreviousPage: currentPage > 1
+  };
+}
+__name(createPaginationMeta, "createPaginationMeta");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  asArrayOf,
+  asBoolean,
+  asFloat,
+  asInteger,
+  asIsoDate,
+  asIsoDateTime,
+  asJson,
+  asString,
+  createPaginationMeta,
+  createParser,
+  loadRouteParams,
+  loadSearchParams,
+  parseRouteParams
+});
+//# sourceMappingURL=server.cjs.map

package/dist/query/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/query/server.ts","../../src/query/params.ts","../../src/query/parsers.ts"],"sourcesContent":["/**\n * Farm.js Server-Side Query State Management\n *\n * Server-side utilities for parsing and handling URL search parameters\n */\n\nimport type { Parser } from \"./parsers\";\nexport { parseRouteParams, loadRouteParams, type RouteParamsInput } from \"./params\";\n\nexport {\n  asString,\n  asInteger,\n  asFloat,\n  asBoolean,\n  asArrayOf,\n  asJson,\n  asIsoDate,\n  asIsoDateTime,\n  createParser,\n  type Parser,\n  type inferParserType,\n} from \"./parsers\";\n\nexport type SearchParams = Record<string, string | string[] | undefined>;\n\n/**\n * Server-side utility to load and parse search parameters\n *\n * @example\n * ```tsx\n * // In a server component\n * import { loadSearchParams, parseAsString, parseAsInteger } from 'farm/query/server';\n *\n * export default async function MyPage({ searchParams }: PageProps) {\n *   const params = await loadSearchParams(searchParams, {\n *     search: parseAsString.withDefault!(''),\n *     page: parseAsInteger.withDefault!(1),\n *   });\n *\n *   return <div>Search: {params.search}, Page: {params.page}</div>;\n * }\n * ```\n */\nexport async function loadSearchParams<T extends Record<string, Parser<any>>>(\n  searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>,\n  parsers: T,\n): Promise<{ [K in keyof T]: ReturnType<T[K][\"parse\"]> }> {\n  const params = await searchParams;\n\n  let urlParams: URLSearchParams;\n  if (params instanceof URLSearchParams) {\n    urlParams = params;\n  } else {\n    urlParams = new URLSearchParams();\n    for (const [key, value] of Object.entries(params)) {\n      if (Array.isArray(value)) {\n        for (const v of value) {\n          urlParams.append(key, v);\n        }\n      } else if (value !== undefined && value !== null) {\n        urlParams.set(key, String(value));\n      }\n    }\n  }\n\n  const result = {} as { [K in keyof T]: ReturnType<T[K][\"parse\"]> };\n\n  for (const [key, parser] of Object.entries(parsers)) {\n    const value = urlParams.get(key);\n\n    if (value !== null && value !== \"\") {\n      try {\n        result[key as keyof T] = parser.parse(value);\n      } catch (error) {\n        console.error(`Failed to parse parameter \"${key}\":`, error);\n        throw error;\n      }\n    } else {\n      result[key as keyof T] = parser.parse(\"\");\n    }\n  }\n\n  return result;\n}\n\n/**\n * Creates pagination metadata for server components.\n *\n * @param searchParams The search parameters promise.\n * @param options Configuration options for pagination.\n * @returns Pagination metadata.\n */\nexport async function createPaginationMeta(\n  searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>,\n  options: {\n    totalItems: number;\n    itemsPerPage?: number;\n    pageParam?: string;\n  },\n) {\n  const params = await searchParams;\n\n  let urlParams: URLSearchParams;\n  if (params instanceof URLSearchParams) {\n    urlParams = params;\n  } else {\n    urlParams = new URLSearchParams();\n    for (const [key, value] of Object.entries(params)) {\n      if (Array.isArray(value)) {\n        for (const v of value) {\n          urlParams.append(key, v);\n        }\n      } else if (value !== undefined && value !== null) {\n        urlParams.set(key, String(value));\n      }\n    }\n  }\n\n  const pageParam = options.pageParam || \"page\";\n  const itemsPerPage = options.itemsPerPage || 10;\n  const currentPage = Number.parseInt(urlParams.get(pageParam) || \"1\", 10);\n\n  const totalPages = Math.ceil(options.totalItems / itemsPerPage);\n  const offset = (currentPage - 1) * itemsPerPage;\n  const limit = itemsPerPage;\n\n  return {\n    currentPage,\n    itemsPerPage,\n    totalItems: options.totalItems,\n    totalPages,\n    offset,\n    limit,\n    hasNextPage: currentPage < totalPages,\n    hasPreviousPage: currentPage > 1,\n  };\n}\n","import type { Parser } from \"./parsers\";\n\nexport type RouteParamsInput =\n  | Record<string, string | undefined>\n  | URLSearchParams\n  | Promise<Record<string, string | undefined> | URLSearchParams>;\n\nfunction normalizeParams(input: Record<string, string | undefined> | URLSearchParams) {\n  if (input instanceof URLSearchParams) {\n    const params: Record<string, string | undefined> = {};\n    input.forEach((value, key) => {\n      params[key] = value;\n    });\n    return params;\n  }\n  return input;\n}\n\nexport async function loadRouteParams<T extends Record<string, Parser<any>>>(\n  input: RouteParamsInput,\n  parsers: T,\n  options: { strict?: boolean } = {},\n): Promise<{ [K in keyof T]: ReturnType<T[K][\"parse\"]> }> {\n  const resolved = await Promise.resolve(input);\n  const params = normalizeParams(resolved);\n  const result = {} as { [K in keyof T]: ReturnType<T[K][\"parse\"]> };\n\n  for (const [key, parser] of Object.entries(parsers)) {\n    const raw = params[key] ?? \"\";\n    const parsed = parser.parse(raw);\n    if (parsed === null && options.strict) {\n      throw new Error(`Failed to parse route param \"${key}\" with value \"${raw}\"`);\n    }\n    result[key as keyof T] = parsed as ReturnType<T[typeof key][\"parse\"]>;\n  }\n\n  return result;\n}\n\nexport function parseRouteParams<T extends Record<string, Parser<any>>>(\n  input: Record<string, string | undefined> | URLSearchParams,\n  parsers: T,\n  options: { strict?: boolean } = {},\n): { [K in keyof T]: ReturnType<T[K][\"parse\"]> } {\n  const params = normalizeParams(input);\n  const result = {} as { [K in keyof T]: ReturnType<T[K][\"parse\"]> };\n\n  for (const [key, parser] of Object.entries(parsers)) {\n    const raw = params[key] ?? \"\";\n    const parsed = parser.parse(raw);\n    if (parsed === null && options.strict) {\n      throw new Error(`Failed to parse route param \"${key}\" with value \"${raw}\"`);\n    }\n    result[key as keyof T] = parsed as ReturnType<T[typeof key][\"parse\"]>;\n  }\n\n  return result;\n}\n","/**\n * Farm.js Query State Parsers\n *\n * Shared parsers that can be used in both client and server contexts\n */\n\nexport interface Parser<T> {\n  parse: (value: string) => T | null;\n  serialize: (value: T) => string;\n  withDefault?: (defaultValue: T) => Parser<T>;\n}\n\n// String parser\nexport const asString: Parser<string> = {\n  parse: (value: string) => (value && value.trim()) || null,\n  serialize: (value: string) => value,\n  withDefault: (defaultValue: string) => ({\n    parse: (value: string) => (value && value.trim()) || defaultValue,\n    serialize: (value: string) => value || defaultValue,\n  }),\n};\n\n// Integer parser\nexport const asInteger: Parser<number> = {\n  parse: (value: string) => {\n    const parsed = Number.parseInt(value, 10);\n    return isNaN(parsed) ? null : parsed;\n  },\n  serialize: (value: number) => value.toString(),\n  withDefault: (defaultValue: number) => ({\n    parse: (value: string) => {\n      const parsed = Number.parseInt(value, 10);\n      return isNaN(parsed) ? defaultValue : parsed;\n    },\n    serialize: (value: number) => value.toString(),\n  }),\n};\n\n// Float parser\nexport const asFloat: Parser<number> = {\n  parse: (value: string) => {\n    const parsed = Number.parseFloat(value);\n    return isNaN(parsed) ? null : parsed;\n  },\n  serialize: (value: number) => value.toString(),\n  withDefault: (defaultValue: number) => ({\n    parse: (value: string) => {\n      const parsed = Number.parseFloat(value);\n      return isNaN(parsed) ? defaultValue : parsed;\n    },\n    serialize: (value: number) => value.toString(),\n  }),\n};\n\n// Boolean parser\nexport const asBoolean: Parser<boolean> = {\n  parse: (value: string) => {\n    if (value === \"true\") return true;\n    if (value === \"false\") return false;\n    return null;\n  },\n  serialize: (value: boolean) => value.toString(),\n  withDefault: (defaultValue: boolean) => ({\n    parse: (value: string) => {\n      if (value === \"true\") return true;\n      if (value === \"false\") return false;\n      return defaultValue;\n    },\n    serialize: (value: boolean) => value.toString(),\n  }),\n};\n\n// Array parser\nexport function asArrayOf<T>(itemParser: Parser<T>): Parser<T[]> {\n  return {\n    parse: (value: string) => {\n      if (!value) return null;\n      return value\n        .split(\",\")\n        .filter(Boolean)\n        .map((item) => itemParser.parse(item.trim()))\n        .filter((item) => item !== null) as T[];\n    },\n    serialize: (value: T[]) => value.map((item) => itemParser.serialize(item)).join(\",\"),\n    withDefault: (defaultValue: T[]) => ({\n      parse: (value: string) => {\n        if (!value) return defaultValue;\n        return value\n          .split(\",\")\n          .filter(Boolean)\n          .map((item) => itemParser.parse(item.trim()))\n          .filter((item) => item !== null) as T[];\n      },\n      serialize: (value: T[]) => value.map((item) => itemParser.serialize(item)).join(\",\"),\n    }),\n  };\n}\n\n// JSON parser\nexport function asJson<T>(): Parser<T> {\n  return {\n    parse: (value: string) => {\n      try {\n        return JSON.parse(value);\n      } catch {\n        return null;\n      }\n    },\n    serialize: (value: T) => JSON.stringify(value),\n    withDefault: (defaultValue: T) => ({\n      parse: (value: string) => {\n        try {\n          return JSON.parse(value);\n        } catch {\n          return defaultValue;\n        }\n      },\n      serialize: (value: T) => JSON.stringify(value),\n    }),\n  };\n}\n\n// ISO Date parser\nexport const asIsoDate: Parser<Date> = {\n  parse: (value: string) => {\n    const date = new Date(value);\n    return isNaN(date.getTime()) ? null : date;\n  },\n  serialize: (value: Date) => value.toISOString(),\n  withDefault: (defaultValue: Date) => ({\n    parse: (value: string) => {\n      const date = new Date(value);\n      return isNaN(date.getTime()) ? defaultValue : date;\n    },\n    serialize: (value: Date) => value.toISOString(),\n  }),\n};\n\n// ISO DateTime parser\nexport const asIsoDateTime: Parser<Date> = {\n  parse: (value: string) => {\n    const date = new Date(value);\n    return isNaN(date.getTime()) ? null : date;\n  },\n  serialize: (value: Date) => value.toISOString(),\n  withDefault: (defaultValue: Date) => ({\n    parse: (value: string) => {\n      const date = new Date(value);\n      return isNaN(date.getTime()) ? defaultValue : date;\n    },\n    serialize: (value: Date) => value.toISOString(),\n  }),\n};\n\n// Custom parser creator\nexport function createParser<T>(config: {\n  parse: (value: string) => T | null;\n  serialize: (value: T) => string;\n}): Parser<T> {\n  return {\n    parse: config.parse,\n    serialize: config.serialize,\n    withDefault: (defaultValue: T) => ({\n      parse: (value: string) => config.parse(value) ?? defaultValue,\n      serialize: config.serialize,\n    }),\n  };\n}\n\n// Type inference helper\nexport type inferParserType<T> = T extends Parser<infer U> ? U : never;\n"],"mappings":"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","names":[]}

package/dist/query/server.d.mts

@@ -0,0 +1,55 @@
+import { Parser } from './parsers.mjs';
+export { asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, inferParserType } from './parsers.mjs';
+export { R as RouteParamsInput, l as loadRouteParams, p as parseRouteParams } from '../params-ry-lxqmy.mjs';
+
+/**
+ * Farm.js Server-Side Query State Management
+ *
+ * Server-side utilities for parsing and handling URL search parameters
+ */
+
+type SearchParams = Record<string, string | string[] | undefined>;
+/**
+ * Server-side utility to load and parse search parameters
+ *
+ * @example
+ * ```tsx
+ * // In a server component
+ * import { loadSearchParams, parseAsString, parseAsInteger } from 'farm/query/server';
+ *
+ * export default async function MyPage({ searchParams }: PageProps) {
+ *   const params = await loadSearchParams(searchParams, {
+ *     search: parseAsString.withDefault!(''),
+ *     page: parseAsInteger.withDefault!(1),
+ *   });
+ *
+ *   return <div>Search: {params.search}, Page: {params.page}</div>;
+ * }
+ * ```
+ */
+declare function loadSearchParams<T extends Record<string, Parser<any>>>(searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>, parsers: T): Promise<{
+    [K in keyof T]: ReturnType<T[K]["parse"]>;
+}>;
+/**
+ * Creates pagination metadata for server components.
+ *
+ * @param searchParams The search parameters promise.
+ * @param options Configuration options for pagination.
+ * @returns Pagination metadata.
+ */
+declare function createPaginationMeta(searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>, options: {
+    totalItems: number;
+    itemsPerPage?: number;
+    pageParam?: string;
+}): Promise<{
+    currentPage: number;
+    itemsPerPage: number;
+    totalItems: number;
+    totalPages: number;
+    offset: number;
+    limit: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+}>;
+
+export { Parser, type SearchParams, createPaginationMeta, loadSearchParams };

package/dist/query/server.d.ts

@@ -0,0 +1,55 @@
+import { Parser } from './parsers.js';
+export { asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, inferParserType } from './parsers.js';
+export { R as RouteParamsInput, l as loadRouteParams, p as parseRouteParams } from '../params-BALtrRim.js';
+
+/**
+ * Farm.js Server-Side Query State Management
+ *
+ * Server-side utilities for parsing and handling URL search parameters
+ */
+
+type SearchParams = Record<string, string | string[] | undefined>;
+/**
+ * Server-side utility to load and parse search parameters
+ *
+ * @example
+ * ```tsx
+ * // In a server component
+ * import { loadSearchParams, parseAsString, parseAsInteger } from 'farm/query/server';
+ *
+ * export default async function MyPage({ searchParams }: PageProps) {
+ *   const params = await loadSearchParams(searchParams, {
+ *     search: parseAsString.withDefault!(''),
+ *     page: parseAsInteger.withDefault!(1),
+ *   });
+ *
+ *   return <div>Search: {params.search}, Page: {params.page}</div>;
+ * }
+ * ```
+ */
+declare function loadSearchParams<T extends Record<string, Parser<any>>>(searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>, parsers: T): Promise<{
+    [K in keyof T]: ReturnType<T[K]["parse"]>;
+}>;
+/**
+ * Creates pagination metadata for server components.
+ *
+ * @param searchParams The search parameters promise.
+ * @param options Configuration options for pagination.
+ * @returns Pagination metadata.
+ */
+declare function createPaginationMeta(searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>, options: {
+    totalItems: number;
+    itemsPerPage?: number;
+    pageParam?: string;
+}): Promise<{
+    currentPage: number;
+    itemsPerPage: number;
+    totalItems: number;
+    totalPages: number;
+    offset: number;
+    limit: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+}>;
+
+export { Parser, type SearchParams, createPaginationMeta, loadSearchParams };

package/dist/query/server.mjs

@@ -0,0 +1,105 @@
+import {
+  loadRouteParams,
+  parseRouteParams
+} from "../chunk-H2FA2SBS.mjs";
+import {
+  asArrayOf,
+  asBoolean,
+  asFloat,
+  asInteger,
+  asIsoDate,
+  asIsoDateTime,
+  asJson,
+  asString,
+  createParser
+} from "../chunk-E2MPIBRE.mjs";
+import {
+  __name
+} from "../chunk-CGILA3WO.mjs";
+
+// src/query/server.ts
+async function loadSearchParams(searchParams, parsers) {
+  const params = await searchParams;
+  let urlParams;
+  if (params instanceof URLSearchParams) {
+    urlParams = params;
+  } else {
+    urlParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (Array.isArray(value)) {
+        for (const v of value) {
+          urlParams.append(key, v);
+        }
+      } else if (value !== void 0 && value !== null) {
+        urlParams.set(key, String(value));
+      }
+    }
+  }
+  const result = {};
+  for (const [key, parser] of Object.entries(parsers)) {
+    const value = urlParams.get(key);
+    if (value !== null && value !== "") {
+      try {
+        result[key] = parser.parse(value);
+      } catch (error) {
+        console.error(`Failed to parse parameter "${key}":`, error);
+        throw error;
+      }
+    } else {
+      result[key] = parser.parse("");
+    }
+  }
+  return result;
+}
+__name(loadSearchParams, "loadSearchParams");
+async function createPaginationMeta(searchParams, options) {
+  const params = await searchParams;
+  let urlParams;
+  if (params instanceof URLSearchParams) {
+    urlParams = params;
+  } else {
+    urlParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (Array.isArray(value)) {
+        for (const v of value) {
+          urlParams.append(key, v);
+        }
+      } else if (value !== void 0 && value !== null) {
+        urlParams.set(key, String(value));
+      }
+    }
+  }
+  const pageParam = options.pageParam || "page";
+  const itemsPerPage = options.itemsPerPage || 10;
+  const currentPage = Number.parseInt(urlParams.get(pageParam) || "1", 10);
+  const totalPages = Math.ceil(options.totalItems / itemsPerPage);
+  const offset = (currentPage - 1) * itemsPerPage;
+  const limit = itemsPerPage;
+  return {
+    currentPage,
+    itemsPerPage,
+    totalItems: options.totalItems,
+    totalPages,
+    offset,
+    limit,
+    hasNextPage: currentPage < totalPages,
+    hasPreviousPage: currentPage > 1
+  };
+}
+__name(createPaginationMeta, "createPaginationMeta");
+export {
+  asArrayOf,
+  asBoolean,
+  asFloat,
+  asInteger,
+  asIsoDate,
+  asIsoDateTime,
+  asJson,
+  asString,
+  createPaginationMeta,
+  createParser,
+  loadRouteParams,
+  loadSearchParams,
+  parseRouteParams
+};
+//# sourceMappingURL=server.mjs.map

package/dist/query/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/query/server.ts"],"sourcesContent":["/**\n * Farm.js Server-Side Query State Management\n *\n * Server-side utilities for parsing and handling URL search parameters\n */\n\nimport type { Parser } from \"./parsers\";\nexport { parseRouteParams, loadRouteParams, type RouteParamsInput } from \"./params\";\n\nexport {\n  asString,\n  asInteger,\n  asFloat,\n  asBoolean,\n  asArrayOf,\n  asJson,\n  asIsoDate,\n  asIsoDateTime,\n  createParser,\n  type Parser,\n  type inferParserType,\n} from \"./parsers\";\n\nexport type SearchParams = Record<string, string | string[] | undefined>;\n\n/**\n * Server-side utility to load and parse search parameters\n *\n * @example\n * ```tsx\n * // In a server component\n * import { loadSearchParams, parseAsString, parseAsInteger } from 'farm/query/server';\n *\n * export default async function MyPage({ searchParams }: PageProps) {\n *   const params = await loadSearchParams(searchParams, {\n *     search: parseAsString.withDefault!(''),\n *     page: parseAsInteger.withDefault!(1),\n *   });\n *\n *   return <div>Search: {params.search}, Page: {params.page}</div>;\n * }\n * ```\n */\nexport async function loadSearchParams<T extends Record<string, Parser<any>>>(\n  searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>,\n  parsers: T,\n): Promise<{ [K in keyof T]: ReturnType<T[K][\"parse\"]> }> {\n  const params = await searchParams;\n\n  let urlParams: URLSearchParams;\n  if (params instanceof URLSearchParams) {\n    urlParams = params;\n  } else {\n    urlParams = new URLSearchParams();\n    for (const [key, value] of Object.entries(params)) {\n      if (Array.isArray(value)) {\n        for (const v of value) {\n          urlParams.append(key, v);\n        }\n      } else if (value !== undefined && value !== null) {\n        urlParams.set(key, String(value));\n      }\n    }\n  }\n\n  const result = {} as { [K in keyof T]: ReturnType<T[K][\"parse\"]> };\n\n  for (const [key, parser] of Object.entries(parsers)) {\n    const value = urlParams.get(key);\n\n    if (value !== null && value !== \"\") {\n      try {\n        result[key as keyof T] = parser.parse(value);\n      } catch (error) {\n        console.error(`Failed to parse parameter \"${key}\":`, error);\n        throw error;\n      }\n    } else {\n      result[key as keyof T] = parser.parse(\"\");\n    }\n  }\n\n  return result;\n}\n\n/**\n * Creates pagination metadata for server components.\n *\n * @param searchParams The search parameters promise.\n * @param options Configuration options for pagination.\n * @returns Pagination metadata.\n */\nexport async function createPaginationMeta(\n  searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>,\n  options: {\n    totalItems: number;\n    itemsPerPage?: number;\n    pageParam?: string;\n  },\n) {\n  const params = await searchParams;\n\n  let urlParams: URLSearchParams;\n  if (params instanceof URLSearchParams) {\n    urlParams = params;\n  } else {\n    urlParams = new URLSearchParams();\n    for (const [key, value] of Object.entries(params)) {\n      if (Array.isArray(value)) {\n        for (const v of value) {\n          urlParams.append(key, v);\n        }\n      } else if (value !== undefined && value !== null) {\n        urlParams.set(key, String(value));\n      }\n    }\n  }\n\n  const pageParam = options.pageParam || \"page\";\n  const itemsPerPage = options.itemsPerPage || 10;\n  const currentPage = Number.parseInt(urlParams.get(pageParam) || \"1\", 10);\n\n  const totalPages = Math.ceil(options.totalItems / itemsPerPage);\n  const offset = (currentPage - 1) * itemsPerPage;\n  const limit = itemsPerPage;\n\n  return {\n    currentPage,\n    itemsPerPage,\n    totalItems: options.totalItems,\n    totalPages,\n    offset,\n    limit,\n    hasNextPage: currentPage < totalPages,\n    hasPreviousPage: currentPage > 1,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2CA,eAAsB,iBACpB,cACA,SACwD;AACxD,QAAM,SAAS,MAAM;AAErB,MAAI;AACJ,MAAI,kBAAkB,iBAAiB;AACrC,gBAAY;AAAA,EACd,OAAO;AACL,gBAAY,IAAI,gBAAgB;AAChC,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,UAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,mBAAW,KAAK,OAAO;AACrB,oBAAU,OAAO,KAAK,CAAC;AAAA,QACzB;AAAA,MACF,WAAW,UAAU,UAAa,UAAU,MAAM;AAChD,kBAAU,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,MAClC;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SAAS,CAAC;AAEhB,aAAW,CAAC,KAAK,MAAM,KAAK,OAAO,QAAQ,OAAO,GAAG;AACnD,UAAM,QAAQ,UAAU,IAAI,GAAG;AAE/B,QAAI,UAAU,QAAQ,UAAU,IAAI;AAClC,UAAI;AACF,eAAO,GAAc,IAAI,OAAO,MAAM,KAAK;AAAA,MAC7C,SAAS,OAAO;AACd,gBAAQ,MAAM,8BAA8B,GAAG,MAAM,KAAK;AAC1D,cAAM;AAAA,MACR;AAAA,IACF,OAAO;AACL,aAAO,GAAc,IAAI,OAAO,MAAM,EAAE;AAAA,IAC1C;AAAA,EACF;AAEA,SAAO;AACT;AAxCsB;AAiDtB,eAAsB,qBACpB,cACA,SAKA;AACA,QAAM,SAAS,MAAM;AAErB,MAAI;AACJ,MAAI,kBAAkB,iBAAiB;AACrC,gBAAY;AAAA,EACd,OAAO;AACL,gBAAY,IAAI,gBAAgB;AAChC,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,UAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,mBAAW,KAAK,OAAO;AACrB,oBAAU,OAAO,KAAK,CAAC;AAAA,QACzB;AAAA,MACF,WAAW,UAAU,UAAa,UAAU,MAAM;AAChD,kBAAU,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,MAClC;AAAA,IACF;AAAA,EACF;AAEA,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,eAAe,QAAQ,gBAAgB;AAC7C,QAAM,cAAc,OAAO,SAAS,UAAU,IAAI,SAAS,KAAK,KAAK,EAAE;AAEvE,QAAM,aAAa,KAAK,KAAK,QAAQ,aAAa,YAAY;AAC9D,QAAM,UAAU,cAAc,KAAK;AACnC,QAAM,QAAQ;AAEd,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,YAAY,QAAQ;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa,cAAc;AAAA,IAC3B,iBAAiB,cAAc;AAAA,EACjC;AACF;AA5CsB;","names":[]}

package/dist/request-BrFBuc8G.d.mts

@@ -0,0 +1,6 @@
+import './types-BH1lhg5G.mjs';
+
+declare function _runWithCurrentRequest<T>(request: Request, fn: () => Promise<T> | T): Promise<T>;
+declare function getCurrentRequest(): Request;
+
+export { _runWithCurrentRequest as _, getCurrentRequest as g };

package/dist/request-BslSZIRz.d.ts

@@ -0,0 +1,6 @@
+import './types-BH1lhg5G.js';
+
+declare function _runWithCurrentRequest<T>(request: Request, fn: () => Promise<T> | T): Promise<T>;
+declare function getCurrentRequest(): Request;
+
+export { _runWithCurrentRequest as _, getCurrentRequest as g };