@randajan/api-kit 1.2.0 → 3.0.0

package/dist/esm/chunk-4NYBELZF.js

@@ -0,0 +1,309 @@
+import {
+  FetchError,
+  Functionable,
+  HttpError,
+  __export,
+  configTrait,
+  end,
+  info,
+  info_default,
+  isFn,
+  mrgObj,
+  mrgStr,
+  start,
+  toStr
+} from "./chunk-K7ZQO3VB.js";
+
+// src/client/class/static.js
+import { solid } from "@randajan/props";
+
+// src/arc/types/kinds/json.js
+var json_exports = {};
+__export(json_exports, {
+  decode: () => decode,
+  encode: () => encode,
+  mime: () => mime
+});
+var mime = "application/json";
+var decode = (body) => JSON.parse(body);
+var encode = (body) => JSON.stringify(body);
+
+// src/arc/types/kinds/form.js
+var form_exports = {};
+__export(form_exports, {
+  decode: () => decode2,
+  encode: () => encode2,
+  mime: () => mime2
+});
+var mime2 = "application/x-www-form-urlencoded";
+var decode2 = (body) => Object.fromEntries(new URLSearchParams(body));
+var encode2 = (body) => new URLSearchParams(body);
+
+// src/arc/types/index.js
+var _types = { json: json_exports, form: form_exports };
+var joinTypeNames = (types = {}) => {
+  const native = Object.keys(_types);
+  const custom = typeof types === "object" ? Object.keys(types) : [];
+  return `'${[.../* @__PURE__ */ new Set([...native, ...custom])].join("', '")}'`;
+};
+var getType = (propertyName, reqFnName, opt) => {
+  const tn = opt[propertyName] || opt.type;
+  if (!tn) {
+    return json_exports;
+  }
+  const customType = opt.types?.[tn];
+  const type = customType || _types[tn];
+  if (!type) {
+    throw new Error(`Unknown config.${propertyName} '${tn}'. Must be one of: ${joinTypeNames(opt.types)}`);
+  }
+  if (!customType) {
+    return type;
+  }
+  if (!type.mime || typeof type.mime !== "string") {
+    throw new Error(`Type definition '${tn}' requires 'mime' to be a string`);
+  }
+  if (!isFn(type[reqFnName])) {
+    throw new Error(`Type definition '${tn}' requires '${reqFnName}' to be a function`);
+  }
+  return type;
+};
+var encodeBody = (opt) => {
+  const type = getType("requestType", "encode", opt);
+  opt.headers["Content-Type"] = type.mime;
+  opt.body = type.encode(opt.body);
+};
+var attachBodyDecoder = (opt) => {
+  const type = getType("responseType", "decode", opt);
+  opt.headers["Accept"] = type.mime;
+  opt.decodeBody = type.decode;
+};
+
+// src/client/url.js
+var _regexp = /^https?:\/\//i;
+var buildUrl = (inputUrl, params) => {
+  if (!params) {
+    return inputUrl;
+  }
+  const hasHost = _regexp.test(inputUrl);
+  const url = new URL(inputUrl, hasHost ? void 0 : "http://thisisonlyplaceholder.xyz");
+  url.hash = "";
+  for (const [key, value] of Object.entries(params)) {
+    if (value != null) {
+      url.searchParams.append(key, value);
+    }
+  }
+  ;
+  return hasHost ? url.toString() : url.pathname + url.search;
+};
+
+// src/client/tool.js
+var diffVersion = (version) => {
+  const v1 = toStr(info.version);
+  const v2 = toStr(version);
+  if (v1 === v2) {
+    return;
+  }
+  const f1 = v1.split(".");
+  const f2 = v2.split(".");
+  if (f1[0] !== f2[0]) {
+    return "major";
+  }
+  if (f1[1] !== f2[1]) {
+    return "minor";
+  }
+  if (f1[2] !== f2[2]) {
+    return "patch";
+  }
+};
+var failedError = (cause) => FetchError.code(1, "Failed", { cause });
+var timeoutError = (_) => FetchError.code(2, "Timeout");
+var abortError = (_) => FetchError.code(3, "Aborted");
+var statusError = (resp) => HttpError.code(4, resp.statusText, resp.status, { exposeCause: true });
+var unreadableError = (resp, cause) => resp.ok ? FetchError.code(5, "Unreadable", { cause }) : statusError(resp);
+var undecodableError = (resp, cause, detail) => resp.ok ? FetchError.code(6, "Undecodable", { cause, detail }) : statusError(resp);
+var parseHeaders = (resp, opt) => {
+  if (!resp || !opt.parseHeaders) {
+    return;
+  }
+  return Object.freeze(Object.fromEntries(resp.headers.entries()));
+};
+var readText = async (resp) => {
+  try {
+    return await resp.text();
+  } catch (err) {
+    throw unreadableError(resp, err);
+  }
+};
+var decodeText = (resp, opt, text) => {
+  try {
+    return opt.decodeBody(text);
+  } catch (err) {
+    throw undecodableError(resp, err, text);
+  }
+};
+var normalizeClientError = (any, opt) => {
+  let err = any;
+  if (!FetchError.is(err)) {
+    let custom = isFn(opt.normalizeError);
+    if (custom) {
+      try {
+        err = opt.normalizeError(err, opt);
+      } catch {
+        custom = false;
+      }
+    }
+    if (!custom || !FetchError.is(err)) {
+      err = FetchError.code(0, "Unknown", { cause: any });
+    }
+  }
+  return err.rise(0).rise(0);
+};
+var reconstructApiError = (remoteErr) => {
+  if (!remoteErr) {
+    return;
+  }
+  const { message, code, httpStatusCode, cause, detail } = remoteErr;
+  return HttpError.code(code, message, httpStatusCode, { cause, detail, exposeCause: true });
+};
+var mrgOpt = (a, b) => {
+  const opt = mrgObj(a, b);
+  opt.body = mrgObj(a?.body, b?.body);
+  opt.params = mrgObj(a?.params, b?.params);
+  opt.headers = mrgObj(a?.headers, b?.headers, {});
+  return opt;
+};
+var prepareOpt = (url, opt, method) => {
+  start(opt);
+  opt.url = buildUrl(mrgStr(opt.url, url), opt.params);
+  if (method) {
+    opt.method = method;
+  }
+  if (opt.body) {
+    encodeBody(opt);
+  }
+  attachBodyDecoder(opt);
+  const hasTimeout = opt.timeout > 0;
+  if (opt.isAbortable || hasTimeout) {
+    opt.abortController = new AbortController();
+    opt.signal = opt.abortController.signal;
+  }
+  if (hasTimeout) {
+    opt.timeoutId = setTimeout(() => opt.abortController?.abort(timeoutError()), opt.timeout);
+  }
+  if (isFn(opt.trait)) {
+    opt = opt.trait(opt) || opt;
+  }
+  return opt;
+};
+
+// src/client/class/static.js
+var localReject = (err, opt) => ({ error: normalizeClientError(FetchError.is(err) ? err : failedError(err), opt) });
+var remoteReject = (err, opt) => ({ isRemote: true, error: normalizeClientError(err, opt) });
+var remoteResolve = async (resp, opt) => {
+  const text = await readText(resp);
+  if (!text) {
+    if (resp.ok || resp.status === 304) {
+      return { isRemote: true };
+    }
+    throw statusError(resp);
+  }
+  const body = decodeText(resp, opt, text);
+  const ver = body?.[info_default.name];
+  if (!ver) {
+    if (resp.ok) {
+      return { isRemote: true, result: body };
+    }
+    throw statusError(resp);
+  }
+  body.isRemote = true;
+  body.isApiKit = true;
+  body.apiKitDiff = diffVersion(ver);
+  body.error = reconstructApiError(body.error);
+  return body;
+};
+var fetchBody = async (_fetch, opt) => {
+  let resp, body;
+  try {
+    resp = await _fetch(opt.url, opt);
+  } catch (err2) {
+    body = localReject(err2, opt);
+  }
+  try {
+    body = body || await remoteResolve(resp, opt);
+  } catch (err2) {
+    body = remoteReject(err2, opt);
+  }
+  const err = body.error;
+  body.isOk = !err;
+  body.isRemote = !!body.isRemote;
+  body.isApiKit = !!body.isApiKit;
+  body.statusCode = err?.httpStatusCode || resp?.status;
+  body.headers = parseHeaders(resp, opt);
+  body = end(body, opt);
+  return opt.resultOnly ? body.result : body;
+};
+var executeFetch = (_fetch, url, opt, method) => {
+  opt = prepareOpt(url, opt, method);
+  const prom = fetchBody(_fetch, opt);
+  if (opt.timeoutId) {
+    prom.finally((_) => clearTimeout(opt.timeoutId));
+  }
+  if (!opt.isAbortable) {
+    return prom;
+  }
+  return solid(prom, "abort", (_) => opt.abortController?.abort(abortError()));
+};
+
+// src/client/class/Fetch.js
+import { solid as solid2 } from "@randajan/props";
+var Fetch = class _Fetch extends Functionable {
+  static create(config = {}) {
+    return new _Fetch(config);
+  }
+  constructor(config = {}) {
+    const _fetch = config.fetch || globalThis.fetch;
+    if (!_fetch) {
+      throw new Error("Missing fetch function. Please provide it in config");
+    }
+    configTrait(config);
+    delete config.fetch;
+    super((url, opt, method) => executeFetch(_fetch, url, mrgOpt(config, opt), method));
+    Object.freeze(config);
+    solid2(this, "config", config);
+  }
+  extend(config) {
+    return new _Fetch(mrgOpt(this.config, config));
+  }
+  get(url, opt) {
+    return this(url, opt, "GET");
+  }
+  post(url, opt) {
+    return this(url, opt, "POST");
+  }
+  put(url, opt) {
+    return this(url, opt, "PUT");
+  }
+  delete(url, opt) {
+    return this(url, opt, "DELETE");
+  }
+  patch(url, opt) {
+    return this(url, opt, "PATCH");
+  }
+  head(url, opt) {
+    return this(url, opt, "HEAD");
+  }
+  options(url, opt) {
+    return this(url, opt, "OPTIONS");
+  }
+};
+
+// src/client/index.js
+var createFetch = Fetch.create;
+var client_default = createFetch;
+
+export {
+  Fetch,
+  createFetch,
+  client_default
+};
+//# sourceMappingURL=chunk-4NYBELZF.js.map

package/dist/esm/chunk-4NYBELZF.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/client/class/static.js", "../../src/arc/types/kinds/json.js", "../../src/arc/types/kinds/form.js", "../../src/arc/types/index.js", "../../src/client/url.js", "../../src/client/tool.js", "../../src/client/class/Fetch.js", "../../src/client/index.js"],
+  "sourcesContent": ["import info from \"@randajan/simple-lib/info\";\nimport { solid } from \"@randajan/props\";\nimport { end } from \"../../arc/opt\";\nimport { diffVersion, abortError, decodeText, failedError, normalizeClientError, parseHeaders, prepareOpt, readText, reconstructApiError, statusError } from \"../tool\";\nimport { FetchError } from \"../../arc/class/FetchError\";\n\n\nconst localReject = (err, opt)=>({ error:normalizeClientError(FetchError.is(err) ? err : failedError(err), opt) });\nconst remoteReject = (err, opt)=>({ isRemote:true, error:normalizeClientError(err, opt) });\n\nconst remoteResolve = async (resp, opt)=>{\n    const text = await readText(resp);\n\n    //empty response\n    if (!text) {\n        if (resp.ok || resp.status === 304) { return { isRemote:true }; }\n        throw statusError(resp);\n    }\n\n    const body = decodeText(resp, opt, text);\n    const ver = body?.[info.name];\n\n    //foreign response\n    if (!ver) {\n        if (resp.ok) { return { isRemote:true, result:body } }\n        throw statusError(resp);\n    }\n\n    //apikit response\n    body.isRemote = true;\n    body.isApiKit = true;\n    body.apiKitDiff = diffVersion(ver);\n    body.error = reconstructApiError(body.error);\n\n    return body;\n}\n\n\nconst fetchBody = async (_fetch, opt) => {\n    let resp, body;\n\n    try { resp = await _fetch(opt.url, opt); }\n    catch (err) { body = localReject(err, opt); }\n\n    try { body = body || await remoteResolve(resp, opt); }\n    catch (err) { body = remoteReject(err, opt); }\n\n    const err = body.error;\n\n    body.isOk = !err;\n    body.isRemote = !!body.isRemote;\n    body.isApiKit = !!body.isApiKit;\n    body.statusCode = err?.httpStatusCode || resp?.status;\n    body.headers = parseHeaders(resp, opt);\n\n    body = end(body, opt);\n\n    return opt.resultOnly ? body.result : body;\n};\n\n\nexport const executeFetch = (_fetch, url, opt, method)=>{\n    opt = prepareOpt(url, opt, method);\n\n    const prom = fetchBody(_fetch, opt);\n\n    if (opt.timeoutId) { prom.finally(_=>clearTimeout(opt.timeoutId)); }\n    if (!opt.isAbortable) { return prom; }\n\n    return solid(prom, \"abort\", _=>opt.abortController?.abort(abortError()));\n}\n", "\r\n\r\nexport const mime = \"application/json\";\r\nexport const decode = body=>JSON.parse(body);\r\nexport const encode = body=>JSON.stringify(body);", "\r\n\r\nexport const mime = 'application/x-www-form-urlencoded';\r\nexport const decode = body=>Object.fromEntries(new URLSearchParams(body));\r\nexport const encode = body=>new URLSearchParams(body);\r\n\r\n", "import * as json from \"./kinds/json\";\r\nimport * as form from \"./kinds/form\";\r\nimport { isFn } from \"../tool\";\r\n\r\n\r\nconst _types = { json, form };\r\n\r\nconst joinTypeNames = (types={})=>{\n    const native = Object.keys(_types);\n    const custom = typeof types === \"object\" ? Object.keys(types) : [];\n\n    return `'${[...(new Set([...native, ...custom]))].join(\"', '\")}'`;\n}\n\r\n\r\nconst getType = (propertyName, reqFnName, opt)=>{\r\n    const tn = (opt[propertyName] || opt.type);\r\n    if (!tn) { return json; }\r\n\r\n    const customType = opt.types?.[tn];\r\n    const type = customType || _types[tn];\n\n    if (!type) {\n        throw new Error(`Unknown config.${propertyName} '${tn}'. Must be one of: ${joinTypeNames(opt.types)}`);\n    }\n\n    if (!customType) { return type; }\n\n    if (!type.mime || typeof type.mime !== \"string\") {\r\n        throw new Error(`Type definition '${tn}' requires 'mime' to be a string`);\r\n    }\r\n\r\n    if (!isFn(type[reqFnName])) { throw new Error(`Type definition '${tn}' requires '${reqFnName}' to be a function`); }\r\n\r\n    return type;\r\n}\r\n\r\n\r\nexport const encodeBody = (opt)=>{\n    const type = getType(\"requestType\", \"encode\", opt);\n\n    opt.headers[\"Content-Type\"] = type.mime;\n    opt.body = type.encode(opt.body);\n}\n\nexport const attachBodyDecoder = (opt)=>{\n    const type = getType(\"responseType\", \"decode\", opt);\n\r\n    opt.headers['Accept'] = type.mime;\r\n    opt.decodeBody = type.decode;\r\n}\n", "let _regexp = /^https?:\\/\\//i;\r\n\r\nexport const buildUrl = (inputUrl, params)=>{\r\n    if (!params) { return inputUrl; }\r\n\r\n    const hasHost = _regexp.test(inputUrl);\r\n    const url = new URL(inputUrl, hasHost ? undefined : \"http://thisisonlyplaceholder.xyz\");\r\n    url.hash = \"\";\r\n\r\n    for (const [key, value] of Object.entries(params)) {\r\n        if (value != null) { url.searchParams.append(key, value); }\r\n    };\r\n\r\n    return hasHost ? url.toString() : url.pathname + url.search;\r\n}", "import { info } from \"@randajan/simple-lib/info\";\nimport { FetchError } from \"../arc/class/FetchError\";\nimport { HttpError } from \"../arc/class/HttpError\";\nimport { start } from \"../arc/opt\";\nimport { isFn, mrgObj, mrgStr, toStr } from \"../arc/tool\";\nimport { attachBodyDecoder, encodeBody } from \"../arc/types\";\nimport { buildUrl } from \"./url\";\n\nexport const diffVersion = (version)=>{\n    const v1 = toStr(info.version);\n    const v2 = toStr(version);\n\n    if (v1 === v2) { return }\n\n    const f1 = v1.split(\".\");\n    const f2 = v2.split(\".\");\n\n    if (f1[0] !== f2[0]) { return \"major\"; }\n    if (f1[1] !== f2[1]) { return \"minor\"; }\n    if (f1[2] !== f2[2]) { return \"patch\"; }\n}\n\n\nexport const failedError = cause=>FetchError.code(1, \"Failed\", { cause });\nexport const timeoutError = _=>FetchError.code(2, \"Timeout\");\nexport const abortError = _=>FetchError.code(3, \"Aborted\");\nexport const statusError = resp=>HttpError.code(4, resp.statusText, resp.status, { exposeCause:true });\nexport const unreadableError = (resp, cause)=>resp.ok ? FetchError.code(5, \"Unreadable\", { cause }) : statusError(resp);\nexport const undecodableError = (resp, cause, detail)=>resp.ok ? FetchError.code(6, \"Undecodable\", { cause, detail }) : statusError(resp);\n\nexport const parseHeaders = (resp, opt)=>{\n    if (!resp || !opt.parseHeaders) { return; }\n    return Object.freeze(Object.fromEntries(resp.headers.entries()));\n}\n\nexport const readText = async resp=>{\n    try { return await resp.text(); }\n    catch(err) { throw unreadableError(resp, err); }\n}\n\nexport const decodeText = (resp, opt, text)=>{\n    try { return opt.decodeBody(text); }\n    catch(err) { throw undecodableError(resp, err, text); }\n}\n\nexport const normalizeClientError = (any, opt)=>{\n    let err = any;\n\n    if (!FetchError.is(err)) {\n        let custom = isFn(opt.normalizeError);\n        if (custom) {\n            try { err = opt.normalizeError(err, opt); }\n            catch { custom = false; }\n        }\n        if (!custom || !FetchError.is(err)) {\n             err = FetchError.code(0, \"Unknown\", { cause:any });\n        }\n    }\n\n    return err.rise(0).rise(0);\n}\n\nexport const reconstructApiError = (remoteErr)=>{\n    if (!remoteErr) { return; }\n    const { message, code, httpStatusCode, cause, detail } = remoteErr;\n    return HttpError.code(code, message, httpStatusCode, { cause, detail, exposeCause:true });\n}\n\nexport const mrgOpt = (a, b)=>{\n    const opt = mrgObj(a, b);\n\n    opt.body = mrgObj(a?.body, b?.body);\n    opt.params = mrgObj(a?.params, b?.params);\n    opt.headers = mrgObj(a?.headers, b?.headers, {});\n\n    return opt;\n}\n\nexport const prepareOpt = (url, opt, method)=>{\n\n    start(opt);\n\n    opt.url = buildUrl( mrgStr(opt.url, url), opt.params);\n    if (method) { opt.method = method; }\n\n    if (opt.body) { encodeBody(opt); }\n\n    attachBodyDecoder(opt);\n\n    const hasTimeout = opt.timeout > 0;\n    if (opt.isAbortable || hasTimeout) {\n        opt.abortController = new AbortController();\n        opt.signal = opt.abortController.signal;\n    }\n\n    if (hasTimeout) {\n        opt.timeoutId = setTimeout(() => opt.abortController?.abort(timeoutError()), opt.timeout);\n    }\n\n    if (isFn(opt.trait)) { opt = opt.trait(opt) || opt; }\n\n    return opt;\n}\n", "import { executeFetch } from \"./static\";\r\nimport { Functionable } from \"../../arc/class/Functionable\";\r\nimport { solid } from \"@randajan/props\";\r\nimport { mrgOpt } from \"../tool\";\r\nimport { configTrait } from \"../../arc/opt\";\r\n\r\n\r\nexport class Fetch extends Functionable {\r\n\r\n    static create(config={}) { return new Fetch(config) }\r\n\r\n    constructor(config = {}) {\r\n        \r\n        const _fetch = config.fetch || globalThis.fetch;\r\n\r\n        if (!_fetch) { throw new Error(\"Missing fetch function. Please provide it in config\"); }\n\r\n        configTrait(config);\r\n\r\n        delete config.fetch;\r\n\r\n        super((url, opt, method) =>executeFetch(_fetch, url, mrgOpt(config, opt), method));\r\n\r\n        Object.freeze(config);\r\n        solid(this, \"config\", config);\r\n    }\r\n\r\n    extend(config) { return new Fetch(mrgOpt(this.config, config)); }\r\n\r\n    get(url, opt) { return this(url, opt, \"GET\"); }\r\n    post(url, opt) { return this(url, opt, \"POST\"); }\r\n    put(url, opt) { return this(url, opt, \"PUT\"); }\r\n    delete(url, opt) { return this(url, opt, \"DELETE\"); }\r\n    patch(url, opt) { return this(url, opt, \"PATCH\"); }\r\n    head(url, opt) { return this(url, opt, \"HEAD\"); }\r\n    options(url, opt) { return this(url, opt, \"OPTIONS\"); }\r\n}\n", "import { FetchError } from \"../arc/class/FetchError\";\nimport { Fetch } from \"./class/Fetch\";\n\nexport const createFetch = Fetch.create;\nexport default createFetch;\n\nexport {\n    Fetch,\n    FetchError\n}\n"],
+  "mappings": "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",
+  "names": ["decode", "encode", "mime", "mime", "decode", "encode", "err", "solid", "solid"]
+}

package/dist/esm/{chunk-R2VELUR6.js → chunk-IUVT7Q4N.js}

@@ -1,15 +1,16 @@
 import {
-  ApiError,
   Functionable,
+  HttpError,
   configTrait,
   doFn,
   end,
   info_default,
   isErr,
+  isFn,
   isProm,
   mrgObj,
   start
-} from "./chunk-HYSF3GMO.js";
+} from "./chunk-K7ZQO3VB.js";
 
 // src/server/class/Api.js
 import { solid } from "@randajan/props";
@@ -38,11 +39,32 @@ var tryFn = (any) => {
   }
   return r.result.then(wrapResult).catch(wrapError);
 };
+var normalizeServerError = (any, opt) => {
+  let err = any;
+  if (!HttpError.is(err)) {
+    let custom = isFn(opt.normalizeError);
+    if (custom) {
+      try {
+        err = opt.normalizeError(err, opt);
+      } catch {
+        custom = false;
+      }
+    }
+    if (!custom || !HttpError.is(err)) {
+      err = HttpError.code(0, "Unknown", 500, { cause: any });
+    }
+  }
+  return err.rise(1).rise(opt.code);
+};
 
 // src/server/class/static.js
 var apiExit = (resp, opt) => {
+  const { exposeCause } = opt;
+  resp.statusCode = 200;
   if (resp.error) {
-    resp.error = ApiError.to(0, resp.error).rise(1).rise(opt.code);
+    resp.error = normalizeServerError(resp.error, opt);
+    resp.statusCode = resp.error.httpStatusCode;
+    resp.error.exposeCause(!!exposeCause);
   }
   resp[info_default.name] = info_default.version;
   return end(resp, opt);
@@ -90,4 +112,4 @@ export {
   createApi,
   server_default
 };
-//# sourceMappingURL=chunk-R2VELUR6.js.map
+//# sourceMappingURL=chunk-IUVT7Q4N.js.map

package/dist/esm/chunk-IUVT7Q4N.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/server/class/Api.js", "../../src/server/tool.js", "../../src/server/class/static.js", "../../src/server/index.js"],
+  "sourcesContent": ["import { solid } from \"@randajan/props\";\r\nimport { Functionable } from \"../../arc/class/Functionable\";\r\nimport { apiResolve } from \"./static\";\r\nimport { mrgObj } from \"../../arc/tool\";\r\nimport { configTrait } from \"../../arc/opt\";\r\n\r\nexport class Api extends Functionable {\r\n\r\n    static create(config={}) { return new Api(config); }\r\n\r\n    constructor(config={}) {\r\n\r\n        configTrait(config);\r\n        \r\n        super((exe, opt)=>apiResolve(exe, mrgObj(config, opt)));\r\n\r\n        Object.freeze(config);\r\n        solid(this, \"config\", config);\r\n    }\r\n\r\n    code(code, exe, opt={}) {\r\n        opt.code = code;\r\n        return this(exe, opt);\r\n    }\r\n\r\n    extend(config) { return new Api(mrgObj(this.config, config)); }\r\n}", "import { HttpError } from \"../arc/class/HttpError\";\r\nimport { doFn, isErr, isFn, isProm } from \"../arc/tool\";\r\n\r\nconst wrapResult = r=>({[isErr(r) ? \"error\" : \"result\"]:r});\r\nconst wrapError = error=>({error});\r\n\r\nexport const tryFnSync = any=>{\r\n    try { return wrapResult(doFn(any)); }\r\n    catch(error) { return {error}; }\r\n}\r\n\r\nexport const tryFnAsync = async any=>{\r\n    try { return wrapResult(await doFn(any)); }\r\n    catch(error) { return {error}; }\r\n}\r\n\r\nexport const tryFn = any=>{\r\n    const r = tryFnSync(any);\r\n    if (!isProm(r.result)) { return r; }\r\n    return r.result.then(wrapResult).catch(wrapError);\r\n}\r\n\r\n\r\nexport const normalizeServerError = (any, opt)=>{\r\n    let err = any;\r\n\r\n    if (!HttpError.is(err)) {\r\n        let custom = isFn(opt.normalizeError);\r\n        if (custom) {\r\n            try { err = opt.normalizeError(err, opt); }\r\n            catch { custom = false; }\r\n        }\r\n        if (!custom || !HttpError.is(err)) {\r\n             err = HttpError.code(0, \"Unknown\", 500, { cause:any });\r\n        }\r\n    }\r\n\r\n    return err.rise(1).rise(opt.code);\r\n}\r\n", "import info from \"@randajan/simple-lib/info\";\r\nimport { start, end } from \"../../arc/opt\";\r\nimport { isProm } from \"../../arc/tool\";\r\nimport { normalizeServerError, tryFn, tryFnAsync } from \"../tool\";\r\n\r\n\r\n\r\nconst apiExit = (resp, opt)=>{\r\n    const { exposeCause } = opt;\r\n\r\n    resp.statusCode = 200;\r\n\r\n    if (resp.error) {\r\n        resp.error = normalizeServerError(resp.error, opt);\r\n        resp.statusCode = resp.error.httpStatusCode;\r\n        resp.error.exposeCause(!!exposeCause);\r\n    }\r\n\r\n    resp[info.name] = info.version;\r\n\r\n    return end(resp, opt);\r\n}\r\n\r\nconst apiAsync = async (exe, opt)=>apiExit(await tryFnAsync(exe), opt);\r\n\r\nexport const apiResolve = (exe, opt)=>{\r\n    start(opt);\r\n\r\n    opt = opt.trait(opt) || opt;\r\n\r\n    if (opt.isAsync) { return apiAsync(exe, opt); }\r\n\r\n    const resp = tryFn(exe);\r\n    if (!isProm(resp)) { return apiExit(resp, opt); }\r\n    return resp.then((resp)=>apiExit(resp, opt));\r\n}\r\n", "import { HttpError } from \"../arc/class/HttpError\";\r\nimport { Api } from \"./class/Api\";\r\n\r\nexport const createApi = Api.create;\r\nexport default createApi;\r\nexport {\r\n    Api,\r\n    HttpError\r\n}"],
+  "mappings": "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",
+  "names": ["resp"]
+}

package/dist/esm/{chunk-HYSF3GMO.js → chunk-K7ZQO3VB.js}

@@ -5,10 +5,10 @@ var __export = (target, all) => {
 };
 
 // <define:__slib_info>
-var define_slib_info_default = { isBuild: true, name: "@randajan/api-kit", description: "A lightweight wrapper around fetch that always returns a structured JSON response, handling errors and network issues gracefully", version: "1.1.1", author: { name: "Jan Randa", email: "jnranda@gmail.com", url: "https://www.linkedin.com/in/randajan/" }, env: "development", mode: "web", port: 3e3, dir: { root: "C:\\dev\\lib\\api-kit", dist: "dist" } };
+var define_slib_info_default = { isBuild: true, name: "@randajan/api-kit", description: "A lightweight wrapper around fetch that always returns a structured JSON response, handling errors and network issues gracefully", version: "2.0.0", author: { name: "Jan Randa", email: "jnranda@gmail.com", url: "https://www.linkedin.com/in/randajan/" }, env: "development", mode: "web", port: 3e3, dir: { root: "C:\\dev\\lib\\api-kit", dist: "dist" } };
 
-// src/arc/class/ApiError.js
-import { safe, solid } from "@randajan/props";
+// src/arc/class/FetchError.js
+import { safe } from "@randajan/props";
 
 // src/arc/tool.js
 var mrgObj = (a, b, def) => {
@@ -34,34 +34,36 @@ var doFn = (any) => isFn(any) ? any() : any;
 var isProm = (any) => any instanceof Promise;
 var isErr = (any) => any instanceof Error;
 
-// src/arc/class/ApiError.js
-var ApiError = class _ApiError extends Error {
-  static create(code, message) {
-    return new _ApiError(code, message);
-  }
+// src/arc/class/FetchError.js
+var FetchError = class _FetchError extends Error {
   static is(any) {
-    return any instanceof _ApiError;
+    return any && any instanceof _FetchError;
   }
-  static to(code, any) {
-    if (_ApiError.is(any)) {
-      return any;
-    }
-    const msg = toStr(any?.message || any) || "Unknown";
-    const apierr = _ApiError.create(code, msg);
-    return solid(apierr, "stack", any.stack, false);
+  static code(code, message, opt = {}) {
+    opt.code = code;
+    return new _FetchError(message, opt);
   }
-  constructor(code, message) {
-    super(message);
+  constructor(message, options = {}) {
+    const { code, ...opt } = options || {};
+    super(message, opt);
     safe(this, {}, "code", (t, f) => mrgStr(t, f, "."));
     this.rise(code);
   }
-  rise(code = 0) {
-    this.code = code || 0;
+  rise(code) {
+    if (code == null) {
+      return this;
+    }
+    this.code = code;
     return this;
   }
   toJSON() {
-    const { message } = this;
-    return { message, ...this };
+    const { message, cause } = this;
+    const body = { message, ...this };
+    if (cause) {
+      const { message: message2, stack } = cause;
+      body.cause = { message: message2, stack };
+    }
+    return body;
   }
   toString() {
     const { message, code } = this;
@@ -69,6 +71,45 @@ var ApiError = class _ApiError extends Error {
   }
 };
 
+// src/arc/class/HttpError.js
+import { safe as safe2 } from "@randajan/props";
+var HttpError = class _HttpError extends FetchError {
+  static is(any) {
+    return any && any instanceof _HttpError;
+  }
+  static code(code, message, httpStatusCode = 400, opt = {}) {
+    opt.code = code;
+    return new _HttpError(message, httpStatusCode, opt);
+  }
+  constructor(message, httpStatusCode = 400, options = {}) {
+    const { detail, exposeCause, ...opt } = options || {};
+    const http = httpStatusCode ?? 400;
+    const msg = message || `HTTP:${http}`;
+    super(msg, opt);
+    safe2(this, {}, "_exposeCause", (t) => !!t, void 0, false);
+    this.detail = detail;
+    this.httpStatusCode = http;
+    this._exposeCause = exposeCause;
+  }
+  exposeCause(exposeCause = true) {
+    this._exposeCause = exposeCause;
+    return this;
+  }
+  toJSON() {
+    const { message, cause, _exposeCause } = this;
+    const body = { message, ...this };
+    if (_exposeCause && cause) {
+      const { message: message2, stack } = cause;
+      body.cause = { message: message2, stack, ...cause };
+    }
+    return body;
+  }
+  toString() {
+    const { httpStatusCode } = this;
+    return super.toString() + ` [${httpStatusCode}]`;
+  }
+};
+
 // src/arc/class/Functionable.js
 var Functionable = class extends Function {
   constructor(self) {
@@ -78,45 +119,9 @@ var Functionable = class extends Function {
 };
 
 // src/arc/opt.js
-var createTrait = (trait) => {
-  if (!trait) {
-    return (opt) => opt;
-  }
-  if (isFn(trait)) {
-    return trait;
-  }
-  throw new Error("config.trait should be a function");
-};
-var configTrait = (config) => {
-  config.trait = createTrait(config.trait);
-};
-
-// node_modules/@randajan/simple-lib/dist/chunk-XM4YD4K6.js
-var enumerable = true;
-var lockObject = (o) => {
-  if (typeof o !== "object") {
-    return o;
-  }
-  const r = {};
-  for (const i in o) {
-    const descriptor = { enumerable };
-    let val = o[i];
-    if (val instanceof Array) {
-      descriptor.get = (_) => [...val];
-    } else {
-      descriptor.value = lockObject(val);
-    }
-    Object.defineProperty(r, i, descriptor);
-  }
-  return r;
-};
-var info = lockObject(define_slib_info_default);
-var info_default = info;
-
-// src/arc/main.js
 import { solids } from "@randajan/props";
 var start = (opt) => {
-  if (opt.timestamp) {
+  if (opt.timetrack) {
     return opt.startAt = Date.now();
   }
 };
@@ -138,7 +143,9 @@ var endTime = (body, startAt) => {
   body.time = solids({}, time);
 };
 var end = (body, opt) => {
-  if (!body.error) {
+  const hasError = !!body.error;
+  endTime(body, opt.startAt);
+  if (!hasError) {
     if (isFn(opt.onOk)) {
       opt.onOk(body, opt);
     }
@@ -150,43 +157,59 @@ var end = (body, opt) => {
       throw body.error;
     }
   }
-  endTime(body, opt.startAt);
-  return opt.resultOnly ? body.result : Object.freeze(body);
+  return Object.freeze(body);
 };
-var diffVersion = (version) => {
-  const v1 = toStr(info.version);
-  const v2 = toStr(version);
-  if (v1 === v2) {
-    return;
+var createTrait = (trait) => {
+  if (!trait) {
+    return (opt) => opt;
   }
-  const f1 = v1.split(".");
-  const f2 = v2.split(".");
-  if (f1[0] !== f2[0]) {
-    return "major";
+  if (isFn(trait)) {
+    return trait;
   }
-  if (f1[1] !== f2[1]) {
-    return "minor";
+  throw new Error("config.trait should be a function");
+};
+var configTrait = (config) => {
+  config.trait = createTrait(config.trait);
+};
+
+// node_modules/@randajan/simple-lib/dist/chunk-XM4YD4K6.js
+var enumerable = true;
+var lockObject = (o) => {
+  if (typeof o !== "object") {
+    return o;
   }
-  if (f1[2] !== f2[2]) {
-    return "patch";
+  const r = {};
+  for (const i in o) {
+    const descriptor = { enumerable };
+    let val = o[i];
+    if (val instanceof Array) {
+      descriptor.get = (_) => [...val];
+    } else {
+      descriptor.value = lockObject(val);
+    }
+    Object.defineProperty(r, i, descriptor);
   }
+  return r;
 };
+var info = lockObject(define_slib_info_default);
+var info_default = info;
 
 export {
   __export,
   mrgObj,
+  toStr,
   mrgStr,
   isFn,
   doFn,
   isProm,
   isErr,
-  ApiError,
+  FetchError,
+  HttpError,
   Functionable,
+  info,
   info_default,
   start,
   end,
-  diffVersion,
-  createTrait,
   configTrait
 };
-//# sourceMappingURL=chunk-HYSF3GMO.js.map
+//# sourceMappingURL=chunk-K7ZQO3VB.js.map