qstd 0.3.26 → 0.3.27

package/dist/client/index.cjs

@@ -2,6 +2,7 @@
 
 var dateFns = require('date-fns');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -626,6 +627,222 @@ var label = (name) => ({
   }
 });
 
+// src/shared/api/index.ts
+var api_exports = {};
+__export(api_exports, {
+  RestError: () => RestError,
+  configure: () => configure,
+  get: () => get,
+  patch: () => patch,
+  post: () => post,
+  put: () => put,
+  remove: () => remove
+});
+
+// src/shared/api/types.ts
+var RestError = class extends Error {
+  status;
+  body;
+  constructor(props) {
+    super(`REST ${props.status}: ${props.body}`);
+    this.name = "RestError";
+    this.status = props.status;
+    this.body = props.body;
+  }
+};
+
+// src/shared/api/fns.ts
+var isDev = () => {
+  if (typeof process !== "undefined" && process.env?.NODE_ENV) {
+    return process.env.NODE_ENV !== "production";
+  }
+  if (typeof ({ url: (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) }) !== "undefined" && undefined?.DEV !== void 0) {
+    return undefined.DEV;
+  }
+  return false;
+};
+var isAbsolute = (path) => path.startsWith("http");
+var prepareUrl = (path, props) => {
+  if (isDev() && !isAbsolute(path) && path.includes("?") && path.split("?")[1]?.split("#")[0]) {
+    console.warn(
+      `[api] Query params detected in path string. Prefer using the 'params' option instead: Api.get("/path", { params: { ... } }). Path: ${path}`
+    );
+  }
+  const base = isAbsolute(path) ? "" : props.baseUrl;
+  let url = `${base}${path}`;
+  if (props.params) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(props.params)) {
+      if (value != null) searchParams.set(key, String(value));
+    }
+    const qs = searchParams.toString();
+    if (qs) url += (url.includes("?") ? "&" : "?") + qs;
+  }
+  return url;
+};
+var prepareHeaders = async (props) => {
+  const { defaults, headersOption, input, body } = props;
+  if (headersOption === false) return void 0;
+  const headers = { ...defaults };
+  if (body instanceof FormData) ; else if (body instanceof Blob && body.type) {
+    headers["Content-Type"] = body.type;
+  } else if (input === "json") {
+    headers["Content-Type"] = "application/json";
+  } else if (input === "text") {
+    headers["Content-Type"] = "text/plain";
+  }
+  if (headersOption === void 0 || headersOption === true) {
+    return headers;
+  }
+  return await headersOption(headers);
+};
+var prepareBody = (body, input) => {
+  if (body === void 0) return void 0;
+  if (body instanceof FormData) return body;
+  if (body instanceof Blob) return body;
+  if (input === "json") return JSON.stringify(body);
+  if (input === "text") {
+    if (typeof body === "string") return body;
+    throw new Error("[api] input: 'text' requires a string body");
+  }
+  if (input === "form") {
+    const fd = new FormData();
+    for (const [k, v] of Object.entries(body)) {
+      fd.append(k, v);
+    }
+    return fd;
+  }
+  return body;
+};
+var parseResponse = async (response, output, onProgress) => {
+  const out = output ?? "json";
+  if (out === "stream") {
+    return response.body;
+  }
+  if (onProgress && response.body) {
+    const total = Number(response.headers.get("Content-Length")) || 0;
+    let loaded = 0;
+    const reader = response.body.getReader();
+    const chunks = [];
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      chunks.push(value);
+      loaded += value.length;
+      onProgress({
+        loaded,
+        total,
+        percent: total ? Math.round(loaded / total * 100) : 0
+      });
+    }
+    const blob = new Blob(chunks);
+    if (out === "blob") return blob;
+    if (out === "arrayBuffer")
+      return await blob.arrayBuffer();
+    if (out === "text") return await blob.text();
+    const text2 = await blob.text();
+    return text2 ? JSON.parse(text2) : null;
+  }
+  if (out === "blob")
+    return await response.blob();
+  if (out === "arrayBuffer")
+    return await response.arrayBuffer();
+  if (out === "text")
+    return await response.text();
+  const text = await response.text();
+  return text ? JSON.parse(text) : null;
+};
+
+// src/shared/api/domain.ts
+var config = { baseUrl: "" };
+var configure = (c) => {
+  config = c;
+};
+var configHeaders = async () => {
+  if (!config.headers) return {};
+  return typeof config.headers === "function" ? await config.headers() : config.headers;
+};
+var request = async (method, path, options, defaultInput) => {
+  const opts = options;
+  const url = prepareUrl(path, {
+    baseUrl: config.baseUrl,
+    ...opts?.params ? { params: opts.params } : {}
+  });
+  const rawBody = opts?.body;
+  const isAutoDetect = rawBody instanceof FormData || rawBody instanceof Blob;
+  const input = opts && "input" in opts && opts.input !== void 0 ? opts.input : isAutoDetect ? void 0 : defaultInput;
+  const headersOption = opts?.headers;
+  const isExternal = isAbsolute(path);
+  const defaults = headersOption !== false && !isExternal ? await configHeaders() : {};
+  const headers = await prepareHeaders({
+    defaults,
+    headersOption,
+    input,
+    body: rawBody
+  });
+  const body = prepareBody(rawBody, input);
+  const response = await fetch(url, {
+    method,
+    ...headers && { headers },
+    ...body !== void 0 && { body },
+    ...opts?.signal && { signal: opts.signal }
+  });
+  if (!response.ok) {
+    const error3 = new RestError({
+      status: response.status,
+      body: await response.text()
+    });
+    if (opts?.onError) return opts.onError(error3);
+    throw error3;
+  }
+  const data = await parseResponse(
+    response,
+    opts?.output,
+    opts?.onProgress
+  );
+  return opts?.onSuccess ? opts.onSuccess(data) : data;
+};
+function get(path, opts) {
+  return request(
+    "GET",
+    path,
+    opts
+  );
+}
+function post(path, body, opts) {
+  return request(
+    "POST",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function put(path, body, opts) {
+  return request(
+    "PUT",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function patch(path, body, opts) {
+  return request(
+    "PATCH",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function remove(path, body, opts) {
+  const defaultInput = body !== void 0 ? "json" : void 0;
+  return request(
+    "DELETE",
+    path,
+    { ...opts, body },
+    defaultInput
+  );
+}
+
 // src/client/haptics.ts
 var haptics_exports = {};
 __export(haptics_exports, {
@@ -718,6 +935,7 @@ var copy = async (text) => {
   }
 };
 
+exports.Api = api_exports;
 exports.Dict = dict_exports;
 exports.Dom = dom_exports;
 exports.Flow = flow_exports;

package/dist/client/index.d.ts

@@ -7,6 +7,7 @@ export * as Time from "../shared/time";
 export * as Flow from "../shared/flow";
 export * as Random from "../shared/random";
 export * as Log from "../shared/log";
+export * as Api from "../shared/api";
 export * as Haptics from "./haptics";
 export * as Dom from "./dom";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AAGrC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AAGrC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC"}

package/dist/client/index.js

@@ -624,6 +624,222 @@ var label = (name) => ({
   }
 });
 
+// src/shared/api/index.ts
+var api_exports = {};
+__export(api_exports, {
+  RestError: () => RestError,
+  configure: () => configure,
+  get: () => get,
+  patch: () => patch,
+  post: () => post,
+  put: () => put,
+  remove: () => remove
+});
+
+// src/shared/api/types.ts
+var RestError = class extends Error {
+  status;
+  body;
+  constructor(props) {
+    super(`REST ${props.status}: ${props.body}`);
+    this.name = "RestError";
+    this.status = props.status;
+    this.body = props.body;
+  }
+};
+
+// src/shared/api/fns.ts
+var isDev = () => {
+  if (typeof process !== "undefined" && process.env?.NODE_ENV) {
+    return process.env.NODE_ENV !== "production";
+  }
+  if (typeof import.meta !== "undefined" && import.meta.env?.DEV !== void 0) {
+    return import.meta.env.DEV;
+  }
+  return false;
+};
+var isAbsolute = (path) => path.startsWith("http");
+var prepareUrl = (path, props) => {
+  if (isDev() && !isAbsolute(path) && path.includes("?") && path.split("?")[1]?.split("#")[0]) {
+    console.warn(
+      `[api] Query params detected in path string. Prefer using the 'params' option instead: Api.get("/path", { params: { ... } }). Path: ${path}`
+    );
+  }
+  const base = isAbsolute(path) ? "" : props.baseUrl;
+  let url = `${base}${path}`;
+  if (props.params) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(props.params)) {
+      if (value != null) searchParams.set(key, String(value));
+    }
+    const qs = searchParams.toString();
+    if (qs) url += (url.includes("?") ? "&" : "?") + qs;
+  }
+  return url;
+};
+var prepareHeaders = async (props) => {
+  const { defaults, headersOption, input, body } = props;
+  if (headersOption === false) return void 0;
+  const headers = { ...defaults };
+  if (body instanceof FormData) ; else if (body instanceof Blob && body.type) {
+    headers["Content-Type"] = body.type;
+  } else if (input === "json") {
+    headers["Content-Type"] = "application/json";
+  } else if (input === "text") {
+    headers["Content-Type"] = "text/plain";
+  }
+  if (headersOption === void 0 || headersOption === true) {
+    return headers;
+  }
+  return await headersOption(headers);
+};
+var prepareBody = (body, input) => {
+  if (body === void 0) return void 0;
+  if (body instanceof FormData) return body;
+  if (body instanceof Blob) return body;
+  if (input === "json") return JSON.stringify(body);
+  if (input === "text") {
+    if (typeof body === "string") return body;
+    throw new Error("[api] input: 'text' requires a string body");
+  }
+  if (input === "form") {
+    const fd = new FormData();
+    for (const [k, v] of Object.entries(body)) {
+      fd.append(k, v);
+    }
+    return fd;
+  }
+  return body;
+};
+var parseResponse = async (response, output, onProgress) => {
+  const out = output ?? "json";
+  if (out === "stream") {
+    return response.body;
+  }
+  if (onProgress && response.body) {
+    const total = Number(response.headers.get("Content-Length")) || 0;
+    let loaded = 0;
+    const reader = response.body.getReader();
+    const chunks = [];
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      chunks.push(value);
+      loaded += value.length;
+      onProgress({
+        loaded,
+        total,
+        percent: total ? Math.round(loaded / total * 100) : 0
+      });
+    }
+    const blob = new Blob(chunks);
+    if (out === "blob") return blob;
+    if (out === "arrayBuffer")
+      return await blob.arrayBuffer();
+    if (out === "text") return await blob.text();
+    const text2 = await blob.text();
+    return text2 ? JSON.parse(text2) : null;
+  }
+  if (out === "blob")
+    return await response.blob();
+  if (out === "arrayBuffer")
+    return await response.arrayBuffer();
+  if (out === "text")
+    return await response.text();
+  const text = await response.text();
+  return text ? JSON.parse(text) : null;
+};
+
+// src/shared/api/domain.ts
+var config = { baseUrl: "" };
+var configure = (c) => {
+  config = c;
+};
+var configHeaders = async () => {
+  if (!config.headers) return {};
+  return typeof config.headers === "function" ? await config.headers() : config.headers;
+};
+var request = async (method, path, options, defaultInput) => {
+  const opts = options;
+  const url = prepareUrl(path, {
+    baseUrl: config.baseUrl,
+    ...opts?.params ? { params: opts.params } : {}
+  });
+  const rawBody = opts?.body;
+  const isAutoDetect = rawBody instanceof FormData || rawBody instanceof Blob;
+  const input = opts && "input" in opts && opts.input !== void 0 ? opts.input : isAutoDetect ? void 0 : defaultInput;
+  const headersOption = opts?.headers;
+  const isExternal = isAbsolute(path);
+  const defaults = headersOption !== false && !isExternal ? await configHeaders() : {};
+  const headers = await prepareHeaders({
+    defaults,
+    headersOption,
+    input,
+    body: rawBody
+  });
+  const body = prepareBody(rawBody, input);
+  const response = await fetch(url, {
+    method,
+    ...headers && { headers },
+    ...body !== void 0 && { body },
+    ...opts?.signal && { signal: opts.signal }
+  });
+  if (!response.ok) {
+    const error3 = new RestError({
+      status: response.status,
+      body: await response.text()
+    });
+    if (opts?.onError) return opts.onError(error3);
+    throw error3;
+  }
+  const data = await parseResponse(
+    response,
+    opts?.output,
+    opts?.onProgress
+  );
+  return opts?.onSuccess ? opts.onSuccess(data) : data;
+};
+function get(path, opts) {
+  return request(
+    "GET",
+    path,
+    opts
+  );
+}
+function post(path, body, opts) {
+  return request(
+    "POST",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function put(path, body, opts) {
+  return request(
+    "PUT",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function patch(path, body, opts) {
+  return request(
+    "PATCH",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function remove(path, body, opts) {
+  const defaultInput = body !== void 0 ? "json" : void 0;
+  return request(
+    "DELETE",
+    path,
+    { ...opts, body },
+    defaultInput
+  );
+}
+
 // src/client/haptics.ts
 var haptics_exports = {};
 __export(haptics_exports, {
@@ -716,4 +932,4 @@ var copy = async (text) => {
   }
 };
 
-export { dict_exports as Dict, dom_exports as Dom, flow_exports as Flow, haptics_exports as Haptics, int_exports as Int, list_exports as List, log_exports as Log, money_exports as Money, random_exports as Random, str_exports as Str, time_exports as Time };
+export { api_exports as Api, dict_exports as Dict, dom_exports as Dom, flow_exports as Flow, haptics_exports as Haptics, int_exports as Int, list_exports as List, log_exports as Log, money_exports as Money, random_exports as Random, str_exports as Str, time_exports as Time };