@emeryld/rrroutes-client 2.2.15 → 2.2.17

package/dist/index.cjs

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  HttpError: () => HttpError,
   SocketClient: () => SocketClient,
   buildRoomPayloadSchema: () => buildRoomPayloadSchema,
   buildRouter: () => buildRouter,
@@ -44,6 +45,19 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/routesV3.client.fetch.ts
+var HttpError = class extends Error {
+  constructor(args) {
+    const { res, url, body } = args;
+    super(`[${res.status}] ${res.statusText}${body ? ` - ${body}` : ""}`);
+    this.message = `${this.message}`;
+    this.name = "HttpError";
+    this.status = res.status;
+    this.statusText = res.statusText;
+    this.url = url;
+    this.body = body;
+    this.headers = res.headers ? Object.fromEntries(res.headers.entries()) : {};
+  }
+};
 var defaultFetcher = async (req) => {
   const headers = { ...req.headers ?? {} };
   const isFormData = typeof FormData !== "undefined" && req.body instanceof FormData;
@@ -58,13 +72,24 @@ var defaultFetcher = async (req) => {
   });
   const text = await res.text();
   if (!res.ok) {
-    const snippet = text.slice(0, 400);
-    throw new Error(`[${res.status}] ${res.statusText} \u2014 ${snippet}`);
+    throw new HttpError({
+      res,
+      url: req.url,
+      body: text
+    });
   }
   try {
-    return JSON.parse(text);
+    return {
+      data: JSON.parse(text),
+      headers: res.headers ? Object.fromEntries(res.headers.entries()) : {},
+      status: res.status
+    };
   } catch {
-    return text;
+    return {
+      data: text,
+      headers: res.headers ? Object.fromEntries(res.headers.entries()) : {},
+      status: res.status
+    };
   }
 };
 
@@ -189,7 +214,9 @@ function getZodShape(schema) {
 function augmentFeedQuerySchema(schema) {
   if (!schema) return defaultFeedQuerySchema;
   if (!(schema instanceof import_zod.z.ZodObject)) {
-    console.warn("Feed queries must be a ZodObject; default pagination applied.");
+    console.warn(
+      "Feed queries must be a ZodObject; default pagination applied."
+    );
     return defaultFeedQuerySchema;
   }
   return schema.extend(paginationQueryShape);
@@ -554,9 +581,77 @@ function createRouteClient(opts) {
       fetch: fetchMutation
     };
   }
+  const fetchRaw = async (input) => {
+    const { path, method, query, body, params } = input;
+    if (!path || typeof path !== "string") {
+      throw new Error("fetch(path, ...) requires a non-empty string path.");
+    }
+    if (!method) {
+      throw new Error("fetch(path, method, ...) requires an HTTP method.");
+    }
+    const methodLower = String(method).toLowerCase();
+    const methodUpper = toUpper(methodLower);
+    const flatQuery = normalizeFlatQuery(query);
+    const search = toSearchString(flatQuery);
+    const compiledPath = compileRawPath(path, params);
+    const url = `${baseUrl ?? ""}${compiledPath}${search}`;
+    const leafLabel = `${methodUpper} ${path}`;
+    const startedAt = Date.now();
+    const detail = isVerboseDebug ? { params, query: flatQuery } : void 0;
+    emitDebug(
+      decorateDebugEvent(
+        {
+          type: "fetch",
+          stage: "start",
+          method: methodUpper,
+          url,
+          leaf: leafLabel,
+          ...body !== void 0 ? { body } : {}
+        },
+        detail
+      )
+    );
+    try {
+      const out = await fetcher(
+        body === void 0 ? { url, method: methodUpper } : { url, method: methodUpper, body }
+      );
+      emitDebug(
+        decorateDebugEvent(
+          {
+            type: "fetch",
+            stage: "success",
+            method: methodUpper,
+            url,
+            leaf: leafLabel,
+            durationMs: Date.now() - startedAt
+          },
+          isVerboseDebug ? { params, query: flatQuery, output: out } : void 0
+        )
+      );
+      return out;
+    } catch (error) {
+      emitDebug(
+        decorateDebugEvent(
+          {
+            type: "fetch",
+            stage: "error",
+            method: methodUpper,
+            url,
+            leaf: leafLabel,
+            durationMs: Date.now() - startedAt,
+            ...body !== void 0 ? { body } : {},
+            error
+          },
+          detail
+        )
+      );
+      throw error;
+    }
+  };
   return {
     queryClient,
     invalidate,
+    fetch: fetchRaw,
     build: buildInternal
   };
 }
@@ -578,6 +673,71 @@ function toFormData(body) {
   }
   return fd;
 }
+function getPathParamNames(path) {
+  const names = /* @__PURE__ */ new Set();
+  const re = /:([A-Za-z0-9_]+)/g;
+  let match;
+  while ((match = re.exec(path)) !== null) {
+    names.add(match[1]);
+  }
+  return names;
+}
+function normalizeFlatQuery(query) {
+  if (query == null) return void 0;
+  if (typeof query !== "object" || Array.isArray(query)) {
+    throw new Error("Query must be a plain object (Record<string, string>).");
+  }
+  const result = {};
+  for (const [k, v] of Object.entries(query)) {
+    if (v == null) continue;
+    if (typeof v !== "string") {
+      throw new Error(
+        `Query param "${k}" must be a string; received type "${typeof v}".`
+      );
+    }
+    result[k] = v;
+  }
+  return Object.keys(result).length > 0 ? result : void 0;
+}
+function compileRawPath(path, params) {
+  const placeholders = getPathParamNames(path);
+  if (!params || typeof params !== "object" || Array.isArray(params)) {
+    if (placeholders.size > 0) {
+      throw new Error(
+        `Missing path parameters for "${path}": ${[...placeholders].join(
+          ", "
+        )}`
+      );
+    }
+    return path;
+  }
+  const paramObj = params;
+  const providedNames = new Set(Object.keys(paramObj));
+  for (const name of providedNames) {
+    if (!placeholders.has(name)) {
+      throw new Error(
+        `Unexpected path parameter "${name}" for template "${path}".`
+      );
+    }
+    const value = paramObj[name];
+    if (value != null && (typeof value === "object" || Array.isArray(value))) {
+      throw new Error(
+        `Path parameter "${name}" must be a primitive; received "${typeof value}".`
+      );
+    }
+  }
+  for (const name of placeholders) {
+    if (!providedNames.has(name)) {
+      throw new Error(
+        `Missing value for path parameter "${name}" in template "${path}".`
+      );
+    }
+  }
+  if (placeholders.size === 0) {
+    return path;
+  }
+  return (0, import_rrroutes_contract.compilePath)(path, paramObj);
+}
 
 // src/sockets/socket.client.sys.ts
 var import_zod2 = require("zod");
@@ -1599,6 +1759,7 @@ var SocketClient = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  HttpError,
   SocketClient,
   buildRoomPayloadSchema,
   buildRouter,