@randajan/api-kit 1.0.4

package/README.md

@@ -0,0 +1,60 @@
+# @randajan/api-kit
+
+[![NPM](https://img.shields.io/npm/v/@randajan/api-kit.svg)](https://www.npmjs.com/package/@randajan/api-kit) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
+
+JavaScript library for rendering structured data in HTML format. It supports automatic detection of tabular structures and visualization of deeply nested objects. It is ideal for debugging, admin interfaces, or displaying API responses.
+
+## Installation
+
+
+## Usage
+
+### Server
+You can use the library as an ES module:
+
+```javascript
+import createApi from "@randajan/api-kit/server";
+
+const apiReponder = ({
+    code:0,
+    isAsync:false,
+    timestamp:false,
+    trait:(opt)=>opt,
+    onError:(resp, opt)=>{ },
+    throwError:false
+});
+
+
+```
+
+### Client
+You can use the library as an ES module:
+
+```javascript
+import createFetch from "@randajan/api-kit/client";
+
+const apiFetch = createFetch({
+    code:0,
+    url:"",
+    fetch:globalThis.fetch,
+    query:{},
+    parseHeaders:false,
+    timestamp:false,
+    trait:(opt)=>opt,
+    onError:(resp, opt)=>{ },
+    throwError:false
+});
+
+
+```
+
+
+
+## Support
+
+If you have any questions or suggestions for improvements, feel free to open an issue in the repository.
+
+
+## License
+
+MIT © [randajan](https://github.com/randajan)

package/dist/chunk-ZGHBV6IS.js

@@ -0,0 +1,125 @@
+// src/arc/class/ApiError.js
+import { safe, solid } from "@randajan/props";
+
+// src/arc/tool.js
+var mrgObj = (a, b, def) => {
+  if (!a && !b) {
+    return def;
+  }
+  if (!a) {
+    return { ...b };
+  }
+  if (!b) {
+    return { ...a };
+  }
+  return { ...a, ...b };
+};
+var toStr = (s) => s == null ? "" : String(s);
+var mrgStr = (a, b, sep = "") => {
+  a = toStr(a);
+  b = toStr(b);
+  return a && b ? a + sep + b : a + b;
+};
+var isFn = (any) => typeof any === "function";
+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 extends Error {
+  static create(code, message) {
+    return new ApiError(code, message);
+  }
+  static is(any) {
+    return any instanceof ApiError;
+  }
+  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);
+  }
+  constructor(code, message) {
+    super(message);
+    safe(this, {}, "code", (t, f) => mrgStr(t, f, "."));
+    this.rise(code);
+  }
+  rise(code = 0) {
+    this.code = code || 0;
+    return this;
+  }
+  toJSON() {
+    const { message } = this;
+    return { message, ...this };
+  }
+  toString() {
+    const { message, code } = this;
+    return message + (code == null ? "" : ` (${code})`);
+  }
+};
+
+// src/arc/class/Functionable.js
+var Functionable = class extends Function {
+  constructor(self) {
+    super();
+    return Object.setPrototypeOf(self, this);
+  }
+};
+
+// src/arc/main.js
+import { solids } from "@randajan/props";
+var start = (opt) => {
+  if (opt.timestamp) {
+    return opt.startAt = Date.now();
+  }
+};
+var endTime = (body, startAt) => {
+  if (!startAt) {
+    return;
+  }
+  const endAt = Date.now();
+  const time = {
+    startAt,
+    endAt,
+    run: endAt - startAt
+  };
+  if (body.time) {
+    time.srvRun = body.time.run;
+    time.netIn = body.time.startAt - startAt;
+    time.netOut = endAt - body.time.endAt;
+  }
+  body.time = solids({}, time);
+};
+var end = (body, opt) => {
+  if (body.error) {
+    if (isFn(opt.onError)) {
+      opt.onError(body, opt);
+    }
+    if (opt.throwError) {
+      console.log(body.error.stack);
+      throw body.error;
+    }
+  } else {
+    if (isFn(opt.onOk)) {
+      opt.onError(body, opt);
+    }
+  }
+  endTime(body, opt.startAt);
+  return Object.freeze(body);
+};
+
+export {
+  mrgObj,
+  mrgStr,
+  isFn,
+  doFn,
+  isProm,
+  isErr,
+  ApiError,
+  start,
+  end,
+  Functionable
+};
+//# sourceMappingURL=chunk-ZGHBV6IS.js.map

package/dist/chunk-ZGHBV6IS.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/arc/class/ApiError.js", "../src/arc/tool.js", "../src/arc/class/Functionable.js", "../src/arc/main.js"],
+  "sourcesContent": ["import { safe, solid } from \"@randajan/props\";\r\nimport { mrgStr, toStr } from \"../tool\";\r\n\r\n\r\n\r\nexport class ApiError extends Error {\r\n\r\n    static create(code, message) { return new ApiError(code, message); }\r\n\r\n    static is(any) { return any instanceof ApiError; }\r\n\r\n    static to(code, any) {\r\n        if (ApiError.is(any)) { return any; }\r\n       \r\n        const msg = toStr(any?.message || any) || \"Unknown\";\r\n        const apierr = ApiError.create(code, msg);\r\n        return solid(apierr, \"stack\", any.stack, false);\r\n    }\r\n\r\n    constructor(code, message) {\r\n        super(message);\r\n\r\n        safe(this, {}, \"code\", (t, f)=>mrgStr(t, f, \".\"));\r\n\r\n        this.rise(code);\r\n    }\r\n\r\n    rise(code=0) {\r\n        this.code = (code || 0);\r\n        return this;\r\n    }\r\n\r\n    toJSON() {\r\n        const { message } = this;\r\n        return {message, ...this};\r\n    }\r\n\r\n    toString() {\r\n        const { message, code } = this;\r\n        return message + (code == null ? \"\" : ` (${code})`);\r\n    }\r\n\r\n}", "\r\n\r\nexport const mrgObj = (a, b, def)=>{\r\n    if (!a && !b) { return def; }\r\n    if (!a) { return {...b}; }\r\n    if (!b) { return {...a}; }\r\n    return {...a, ...b};\r\n}\r\n\r\nexport const toStr = s=>s == null ? \"\" : String(s);\r\nexport const mrgStr = (a, b, sep=\"\")=>{\r\n    a = toStr(a); b = toStr(b);\r\n    return (a && b) ? a+sep+b : a+b;\r\n};\r\n\r\nexport const isFn = any=>typeof any === \"function\";\r\nexport const doFn = any=>isFn(any) ? any() : any;\r\nexport const isProm = any=>any instanceof Promise;\r\nexport const isErr = any=>any instanceof Error;", "\r\n\r\n\r\nexport class Functionable extends Function {\r\n    constructor(self) {\r\n        super();\r\n        return Object.setPrototypeOf(self, this);\r\n    }\r\n}", "import { solids } from \"@randajan/props\";\r\nimport { isFn } from \"./tool\";\r\n\r\n\r\nexport const start = (opt)=>{\r\n    if (opt.timestamp) { return opt.startAt = Date.now(); }\r\n}\r\n\r\nconst endTime = (body, startAt)=>{\r\n    if (!startAt) { return; }\r\n\r\n    const endAt = Date.now();\r\n    const time = {\r\n        startAt,\r\n        endAt,\r\n        run:endAt-startAt\r\n    }\r\n\r\n    if (body.time) {\r\n        time.srvRun = body.time.run;\r\n        time.netIn = body.time.startAt - startAt;\r\n        time.netOut = endAt - body.time.endAt;\r\n    }\r\n\r\n    body.time = solids({}, time);\r\n}\r\n\r\nexport const end = (body, opt)=>{\r\n    if (body.error) {\r\n        if (isFn(opt.onError)) { opt.onError(body, opt); }\r\n        if (opt.throwError) { console.log(body.error.stack); throw body.error; }\r\n    } else {\r\n        if (isFn(opt.onOk)) { opt.onError(body, opt); }\r\n    }\r\n\r\n    endTime(body, opt.startAt);\r\n    return Object.freeze(body);\r\n}"],
+  "mappings": "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",
+  "names": []
+}

package/dist/client/index.js

@@ -0,0 +1,170 @@
+import {
+  ApiError,
+  Functionable,
+  end,
+  isFn,
+  mrgObj,
+  mrgStr,
+  start
+} from "../chunk-ZGHBV6IS.js";
+
+// src/client/class/static.js
+import { solid } from "@randajan/props";
+
+// src/arc/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/class/static.js
+var prepareOpt = (opt, method) => {
+  start(opt);
+  if (method) {
+    opt.method = method;
+  }
+  opt.headers["Accept"] = "application/json";
+  if (opt.body) {
+    opt.headers["Content-Type"] = "application/json";
+    opt.body = JSON.stringify(opt.body);
+  }
+  const hasTimeout = opt.timeout > 0;
+  if (opt.abortable || hasTimeout) {
+    opt.abortController = new AbortController();
+    opt.signal = opt.abortController.signal;
+  }
+  if (hasTimeout) {
+    opt.timeoutId = setTimeout(() => opt.abortController?.abort(new ApiError(1, "Timeout")), opt.timeout);
+  }
+  if (isFn(opt.trait)) {
+    opt = opt.trait(opt) || opt;
+  }
+  return opt;
+};
+var localReject = (opt, error, http) => {
+  const { code } = error;
+  if (code == 0) {
+    http = 503;
+  } else if (code == 1) {
+    http = 408;
+  } else if (code == 2) {
+    http = 499;
+  } else if (code == 3) {
+    http = 415;
+  } else if (!http) {
+    http = 400;
+  }
+  error.rise(0).rise(opt.code || 0);
+  return end({ ok: false, http, error }, opt);
+};
+var fetchExe = async (_fetch, url, opt) => {
+  let resp, body;
+  try {
+    resp = await _fetch(buildUrl(url, opt.query), opt);
+  } catch (err) {
+    return localReject(opt, ApiError.is(err) ? err : ApiError.to(0, "Failed"));
+  }
+  const { ok, status, headers, statusText } = resp;
+  try {
+    body = await resp.json();
+  } catch {
+    return localReject(opt, new ApiError(ok ? 3 : 4, ok ? "Unreadable" : statusText || status), status);
+  }
+  if (body.error) {
+    const { code, message } = body.error;
+    body.error = new ApiError(code || mrgStr(opt.code || 0, "1.0", "."), message || body.error);
+  }
+  body.ok = !body.error;
+  body.http = status;
+  if (opt.parseHeaders) {
+    body.headers = Object.freeze(Object.fromEntries(headers.entries()));
+  }
+  return end(body, opt);
+};
+var fetchResolve = (_fetch, url, opt, method) => {
+  const prom = fetchExe(_fetch, url, prepareOpt(opt, method));
+  if (opt.timeoutId) {
+    prom.finally((_) => clearTimeout(opt.timeoutId));
+  }
+  if (!opt.abortable) {
+    return prom;
+  }
+  return solid(prom, "abort", (_) => opt.abortController?.abort(new ApiError(2, "Aborted")));
+};
+
+// src/client/class/Fetch.js
+import { solid as solid2 } from "@randajan/props";
+
+// src/client/tool.js
+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;
+};
+
+// src/client/class/Fetch.js
+var Fetch = class extends Functionable {
+  static create(config = {}) {
+    return new Fetch(config);
+  }
+  constructor(config = {}) {
+    const _url = config.url || "";
+    const _fetch = config.fetch || globalThis.fetch;
+    if (!_fetch) {
+      throw new Error("Missing fetch function. Please provide it inconfig");
+    }
+    if (config) {
+      delete config.fetch;
+    }
+    super((url, opt, method) => fetchResolve(_fetch, mrgStr(_url, url), mrgOpt(config, opt), method));
+    Object.freeze(config);
+    solid2(this, "config", config);
+  }
+  extend(config) {
+    return new Fetch(mrgOpt(this.config, config));
+  }
+  async get(url, opt) {
+    return this(url, opt, "GET");
+  }
+  async post(url, opt) {
+    return this(url, opt, "POST");
+  }
+  async put(url, opt) {
+    return this(url, opt, "PUT");
+  }
+  async delete(url, opt) {
+    return this(url, opt, "DELETE");
+  }
+  async patch(url, opt) {
+    return this(url, opt, "PATCH");
+  }
+  async head(url, opt) {
+    return this(url, opt, "HEAD");
+  }
+  async options(url, opt) {
+    return this(url, opt, "OPTIONS");
+  }
+};
+
+// src/client/index.js
+var client_default = Fetch.create;
+export {
+  ApiError,
+  Fetch,
+  client_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/client/class/static.js", "../../src/arc/url.js", "../../src/client/class/Fetch.js", "../../src/client/tool.js", "../../src/client/index.js"],
+  "sourcesContent": ["import { solid } from \"@randajan/props\";\r\nimport { isFn, mrgStr } from \"../../arc/tool\";\r\nimport { ApiError } from \"../../arc/class/ApiError\";\r\nimport { buildUrl } from \"../../arc/url\";\r\nimport { end, start } from \"../../arc/main\";\r\n\r\nconst prepareOpt = (opt, method)=>{\r\n    start(opt);\r\n\r\n    if (method) { opt.method = method; }\r\n    opt.headers['Accept'] = 'application/json';\r\n\r\n    if (opt.body) {\r\n        opt.headers[\"Content-Type\"] = \"application/json\";\r\n        opt.body = JSON.stringify(opt.body);\r\n    }\r\n\r\n    const hasTimeout = opt.timeout > 0;\r\n    if (opt.abortable || hasTimeout) {\r\n        opt.abortController = new AbortController();\r\n        opt.signal = opt.abortController.signal;\r\n    }\r\n\r\n    if (hasTimeout) {\r\n        opt.timeoutId = setTimeout(() => opt.abortController?.abort(new ApiError(1, \"Timeout\")), opt.timeout);\r\n    }\r\n\r\n    if (isFn(opt.trait)) { opt = opt.trait(opt) || opt; }\r\n\r\n    return opt;\r\n}\r\n\r\nconst localReject = (opt, error, http)=>{\r\n    const { code } = error;\r\n\r\n    if (code == 0) { http = 503 } //failed\r\n    else if (code == 1) { http = 408; } //timeout\r\n    else if (code == 2) { http = 499; } //aborted\r\n    else if (code == 3) { http = 415; } //unreadable\r\n    else if (!http) { http = 400; }\r\n\r\n    error.rise(0).rise(opt.code || 0);\r\n\r\n    return end({ ok:false, http, error }, opt);\r\n}\r\n\r\nconst fetchExe = async (_fetch, url, opt) => {\r\n\r\n    let resp, body;\r\n\r\n    try { resp = await _fetch(buildUrl(url, opt.query), opt); }\r\n    catch (err) { return localReject(opt, ApiError.is(err) ? err : ApiError.to(0, \"Failed\")); }\r\n\r\n    const { ok, status, headers, statusText } = resp;\r\n\r\n    try { body = await resp.json(); }\r\n    catch { return localReject(opt, new ApiError(ok?3:4, ok?\"Unreadable\" : (statusText || status)), status); }\r\n\r\n    if (body.error) {\r\n        const { code, message } = body.error;\r\n        body.error = new ApiError(code || mrgStr(opt.code || 0, \"1.0\", \".\"), message || body.error );\r\n    }\r\n\r\n    body.ok = !body.error;\r\n    body.http = status;\r\n\r\n    if (opt.parseHeaders) {\r\n        body.headers = Object.freeze(Object.fromEntries(headers.entries()));\r\n    }\r\n    \r\n    return end(body, opt);\r\n};\r\n\r\nexport const fetchResolve = (_fetch, url, opt, method)=>{\r\n    const prom = fetchExe(_fetch, url, prepareOpt(opt, method));\r\n\r\n    if (opt.timeoutId) { prom.finally(_=>clearTimeout(opt.timeoutId)); }\r\n    if (!opt.abortable) { return prom; }\r\n\r\n    return solid(prom, \"abort\", _=>opt.abortController?.abort(new ApiError(2, \"Aborted\")));\r\n}", "let _regexp = /^https?:\\/\\//i;\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 { fetchResolve } from \"./static\";\r\nimport { mrgStr } from \"../../arc/tool\";\r\nimport { Functionable } from \"../../arc/class/Functionable\";\r\nimport { solid } from \"@randajan/props\";\r\nimport { mrgOpt } from \"../tool\";\r\n\r\n//config: code, url, fetch, query, parseHeaders, trait, timestamp, onError\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 _url = config.url || \"\";\r\n        const _fetch = config.fetch || globalThis.fetch;\r\n\r\n        if (!_fetch) { throw new Error(\"Missing fetch function. Please provide it inconfig\"); }\r\n\r\n        if (config) { delete config.fetch;}\r\n\r\n        super((url, opt, method) =>fetchResolve(_fetch, mrgStr(_url, 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    async get(url, opt) { return this(url, opt, \"GET\"); }\r\n    async post(url, opt) { return this(url, opt, \"POST\"); }\r\n    async put(url, opt) { return this(url, opt, \"PUT\"); }\r\n    async delete(url, opt) { return this(url, opt, \"DELETE\"); }\r\n    async patch(url, opt) { return this(url, opt, \"PATCH\"); }\r\n    async head(url, opt) { return this(url, opt, \"HEAD\"); }\r\n    async options(url, opt) { return this(url, opt, \"OPTIONS\"); }\r\n}", "import { mrgObj } from \"../arc/tool\";\r\n\r\nexport const mrgOpt = (a, b)=>{\r\n    const opt = mrgObj(a, b);\r\n\r\n    opt.body = mrgObj(a?.body, b?.body);\r\n    opt.params = mrgObj(a?.params, b?.params);\r\n    opt.headers = mrgObj(a?.headers, b?.headers, {});\r\n\r\n    return opt;\r\n}", "import { ApiError } from \"../arc/class/ApiError\";\nimport { Fetch } from \"./class/Fetch\";\n\nexport default Fetch.create;\n\nexport {\n    Fetch,\n    ApiError\n}\n"],
+  "mappings": "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",
+  "names": ["solid", "solid"]
+}

package/dist/server/index.js

@@ -0,0 +1,90 @@
+import {
+  ApiError,
+  Functionable,
+  doFn,
+  end,
+  isErr,
+  isFn,
+  isProm,
+  mrgObj,
+  start
+} from "../chunk-ZGHBV6IS.js";
+
+// src/server/class/Api.js
+import { solid } from "@randajan/props";
+
+// src/server/tool.js
+var wrapResult = (r) => ({ [isErr(r) ? "error" : "result"]: r });
+var wrapError = (error) => ({ error });
+var tryFnSync = (any) => {
+  try {
+    return wrapResult(doFn(any));
+  } catch (error) {
+    return { error };
+  }
+};
+var tryFnAsync = async (any) => {
+  try {
+    return wrapResult(await doFn(any));
+  } catch (error) {
+    return { error };
+  }
+};
+var tryFn = (any) => {
+  const r = tryFnSync(any);
+  if (!isProm(r.result)) {
+    return r;
+  }
+  return r.result.then(wrapResult).catch(wrapError);
+};
+
+// src/server/class/static.js
+var apiExit = (resp, opt) => {
+  if (resp.error) {
+    resp.error = ApiError.to(0, resp.error).rise(1).rise(opt.code);
+  }
+  return end(resp, opt);
+};
+var apiAsync = async (exe, opt) => apiExit(await tryFnAsync(exe), opt);
+var apiResolve = (exe, opt) => {
+  start(opt);
+  if (isFn(opt.trait)) {
+    opt = opt.trait(opt) || opt;
+  }
+  if (opt.isAsync) {
+    return apiAsync(exe, opt);
+  }
+  const resp = tryFn(exe);
+  if (!isProm(resp)) {
+    return apiExit(resp, opt);
+  }
+  return resp.then((resp2) => apiExit(resp2, opt));
+};
+
+// src/server/class/Api.js
+var Api = class extends Functionable {
+  static create(config = {}) {
+    return new Api(config);
+  }
+  constructor(config = {}) {
+    super((exe, opt) => apiResolve(exe, mrgObj(config, opt)));
+    Object.freeze(config);
+    solid(this, "config", config);
+  }
+  code(code, exe, opt = {}) {
+    opt.code = code;
+    return this(exe, opt);
+  }
+  extend(config) {
+    return new Api(mrgObj(this.config, config));
+  }
+};
+
+// src/server/index.js
+var server_default = Api.create;
+export {
+  Api,
+  ApiError,
+  server_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/server/index.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\n\r\n//options: code, isAsync, timestamp, trait, onError, throwError\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        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 { doFn, isErr, 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}", "import { ApiError } from \"../../arc/class/ApiError\"\r\nimport { start, end } from \"../../arc/main\";\r\nimport { isFn, isProm } from \"../../arc/tool\";\r\nimport { tryFn, tryFnAsync } from \"../tool\";\r\n\r\n\r\nconst apiExit = (resp, opt)=>{\r\n    if (resp.error) { resp.error = ApiError.to(0, resp.error).rise(1).rise(opt.code); }\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    if (isFn(opt.trait)) { 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}", "import { ApiError } from \"../arc/class/ApiError\";\r\nimport { Api } from \"./class/Api\";\r\n\r\n\r\n\r\nexport default Api.create;\r\nexport {\r\n    Api,\r\n    ApiError\r\n}"],
+  "mappings": ";;;;;;;;;;;;;AAAA,SAAS,aAAa;;;ACEtB,IAAM,aAAa,QAAI,EAAC,CAAC,MAAM,CAAC,IAAI,UAAU,QAAQ,GAAE,EAAC;AACzD,IAAM,YAAY,YAAQ,EAAC,MAAK;AAEzB,IAAM,YAAY,SAAK;AAC1B,MAAI;AAAE,WAAO,WAAW,KAAK,GAAG,CAAC;AAAA,EAAG,SAC9B,OAAN;AAAe,WAAO,EAAC,MAAK;AAAA,EAAG;AACnC;AAEO,IAAM,aAAa,OAAM,QAAK;AACjC,MAAI;AAAE,WAAO,WAAW,MAAM,KAAK,GAAG,CAAC;AAAA,EAAG,SACpC,OAAN;AAAe,WAAO,EAAC,MAAK;AAAA,EAAG;AACnC;AAEO,IAAM,QAAQ,SAAK;AACtB,QAAM,IAAI,UAAU,GAAG;AACvB,MAAI,CAAC,OAAO,EAAE,MAAM,GAAG;AAAE,WAAO;AAAA,EAAG;AACnC,SAAO,EAAE,OAAO,KAAK,UAAU,EAAE,MAAM,SAAS;AACpD;;;ACbA,IAAM,UAAU,CAAC,MAAM,QAAM;AACzB,MAAI,KAAK,OAAO;AAAE,SAAK,QAAQ,SAAS,GAAG,GAAG,KAAK,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,IAAI,IAAI;AAAA,EAAG;AAElF,SAAO,IAAI,MAAM,GAAG;AACxB;AAEA,IAAM,WAAW,OAAO,KAAK,QAAM,QAAQ,MAAM,WAAW,GAAG,GAAG,GAAG;AAE9D,IAAM,aAAa,CAAC,KAAK,QAAM;AAClC,QAAM,GAAG;AAET,MAAI,KAAK,IAAI,KAAK,GAAG;AAAE,UAAM,IAAI,MAAM,GAAG,KAAK;AAAA,EAAK;AAEpD,MAAI,IAAI,SAAS;AAAE,WAAO,SAAS,KAAK,GAAG;AAAA,EAAG;AAE9C,QAAM,OAAO,MAAM,GAAG;AACtB,MAAI,CAAC,OAAO,IAAI,GAAG;AAAE,WAAO,QAAQ,MAAM,GAAG;AAAA,EAAG;AAChD,SAAO,KAAK,KAAK,CAACA,UAAO,QAAQA,OAAM,GAAG,CAAC;AAC/C;;;AFjBO,IAAM,MAAN,cAAkB,aAAa;AAAA,EAElC,OAAO,OAAO,SAAO,CAAC,GAAG;AAAE,WAAO,IAAI,IAAI,MAAM;AAAA,EAAG;AAAA,EAEnD,YAAY,SAAO,CAAC,GAAG;AAEnB,UAAM,CAAC,KAAK,QAAM,WAAW,KAAK,OAAO,QAAQ,GAAG,CAAC,CAAC;AAEtD,WAAO,OAAO,MAAM;AACpB,UAAM,MAAM,UAAU,MAAM;AAAA,EAChC;AAAA,EAEA,KAAK,MAAM,KAAK,MAAI,CAAC,GAAG;AACpB,QAAI,OAAO;AACX,WAAO,KAAK,KAAK,GAAG;AAAA,EACxB;AAAA,EAEA,OAAO,QAAQ;AAAE,WAAO,IAAI,IAAI,OAAO,KAAK,QAAQ,MAAM,CAAC;AAAA,EAAG;AAClE;;;AGpBA,IAAO,iBAAQ,IAAI;",
+  "names": ["resp"]
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@randajan/api-kit",
+  "version": "1.0.4",
+  "description": "A lightweight wrapper around fetch that always returns a structured JSON response, handling errors and network issues gracefully",
+  "repository": "randajan/api-kit",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "license": "MIT",
+  "peerDependencies": {},
+  "devDependencies": {
+    "@randajan/simple-lib": "^2.4.0",
+    "cors": "^2.8.5",
+    "express": "^4.21.2"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "fetch",
+    "json",
+    "http",
+    "api",
+    "network",
+    "request",
+    "rest",
+    "ajax",
+    "wrapper",
+    "error-handling"
+  ],
+  "homepage": "https://github.com/randajan/api-kit",
+  "bugs": {
+    "url": "https://github.com/randajan/api-kit/issues"
+  },
+  "author": {
+    "name": "Jan Randa",
+    "email": "jnranda@gmail.com",
+    "url": "https://www.linkedin.com/in/randajan/"
+  },
+  "dependencies": {
+    "@randajan/props": "^0.1.3"
+  }
+}