@nattyjs/client 0.0.1-beta.67

package/dist/index.cjs

@@ -0,0 +1,166 @@
+'use strict';
+
+class NattyClientError extends Error {
+  constructor(message, status, body, responseHeaders = {}) {
+    super(message);
+    this.name = "NattyClientError";
+    this.status = status;
+    this.body = body;
+    this.responseHeaders = responseHeaders;
+  }
+}
+function isEndpoint(value) {
+  return !!value && typeof value === "object" && typeof value.method === "string" && typeof value.path === "string";
+}
+function trimSlashes(value) {
+  return String(value || "").replace(/^\/+|\/+$/g, "");
+}
+function joinUrl(baseUrl, pathName) {
+  const normalizedPath = trimSlashes(pathName);
+  if (!baseUrl) {
+    return normalizedPath ? `/${normalizedPath}` : "/";
+  }
+  const normalizedBase = trimSlashes(baseUrl);
+  if (!normalizedBase) {
+    return normalizedPath ? `/${normalizedPath}` : "/";
+  }
+  return normalizedPath ? `/${normalizedBase}/${normalizedPath}` : `/${normalizedBase}`;
+}
+function applyPathParams(pathName, params) {
+  return pathName.replace(/:([A-Za-z0-9_]+)/g, (_, key) => {
+    if (!params || params[key] === void 0 || params[key] === null) {
+      throw new Error(`Missing path param "${key}" for ${pathName}`);
+    }
+    return encodeURIComponent(String(params[key]));
+  });
+}
+function appendQueryParams(url, query) {
+  if (!query || Object.keys(query).length === 0) {
+    return url;
+  }
+  const searchParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value === void 0 || value === null) {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        searchParams.append(key, String(item));
+      }
+      continue;
+    }
+    searchParams.set(key, String(value));
+  }
+  const queryString = searchParams.toString();
+  if (!queryString) {
+    return url;
+  }
+  return `${url}${url.includes("?") ? "&" : "?"}${queryString}`;
+}
+function isBodyPassthrough(value) {
+  if (value == null) {
+    return true;
+  }
+  if (typeof value === "string") {
+    return true;
+  }
+  if (typeof URLSearchParams !== "undefined" && value instanceof URLSearchParams) {
+    return true;
+  }
+  if (typeof FormData !== "undefined" && value instanceof FormData) {
+    return true;
+  }
+  if (typeof Blob !== "undefined" && value instanceof Blob) {
+    return true;
+  }
+  if (typeof ArrayBuffer !== "undefined" && value instanceof ArrayBuffer) {
+    return true;
+  }
+  return false;
+}
+async function resolveDefaultHeaders(options) {
+  if (!options?.headers) {
+    return {};
+  }
+  if (typeof options.headers === "function") {
+    return await options.headers() || {};
+  }
+  return options.headers;
+}
+function readResponseHeaders(response) {
+  const headers = {};
+  response.headers?.forEach?.((value, key) => {
+    headers[key] = value;
+  });
+  return headers;
+}
+async function readResponseBody(response) {
+  const text = await response.text();
+  if (!text) {
+    return void 0;
+  }
+  const contentType = response.headers?.get?.("content-type") || "";
+  if (contentType.includes("application/json")) {
+    try {
+      return JSON.parse(text);
+    } catch {
+      return text;
+    }
+  }
+  return text;
+}
+async function invokeEndpoint(endpoint, input, options) {
+  const fetcher = options.fetch || globalThis.fetch;
+  if (!fetcher) {
+    throw new Error(
+      "No fetch implementation is available. Pass options.fetch to createNattyClient."
+    );
+  }
+  const pathWithParams = applyPathParams(endpoint.path, input?.params);
+  const url = appendQueryParams(joinUrl(options.baseUrl, pathWithParams), input?.query);
+  const defaultHeaders = await resolveDefaultHeaders(options);
+  const headers = {
+    ...defaultHeaders,
+    ...input?.headers || {}
+  };
+  let body = input?.body;
+  if (!isBodyPassthrough(body) && body !== void 0) {
+    body = JSON.stringify(body);
+    if (!headers["Content-Type"]) {
+      headers["Content-Type"] = "application/json";
+    }
+  }
+  const response = await fetcher(url, {
+    method: endpoint.method,
+    headers,
+    body,
+    signal: input?.signal
+  });
+  const responseBody = await readResponseBody(response);
+  if (!response.ok) {
+    throw new NattyClientError(
+      `Natty client request failed with status ${response.status}`,
+      response.status,
+      responseBody,
+      readResponseHeaders(response)
+    );
+  }
+  return responseBody;
+}
+function createContractNode(node, options) {
+  const clientNode = {};
+  for (const [key, value] of Object.entries(node)) {
+    if (isEndpoint(value)) {
+      clientNode[key] = (input) => invokeEndpoint(value, input, options);
+      continue;
+    }
+    clientNode[key] = createContractNode(value, options);
+  }
+  return clientNode;
+}
+function createNattyClient(contract, options = {}) {
+  return createContractNode(contract, options);
+}
+
+exports.NattyClientError = NattyClientError;
+exports.createNattyClient = createNattyClient;

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+interface NattyFetchRequestInit {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    signal?: unknown;
+}
+interface NattyFetchResponse {
+    ok: boolean;
+    status: number;
+    headers?: {
+        get?(name: string): string | null;
+        forEach?(callback: (value: string, key: string) => void): void;
+    };
+    text(): Promise<string>;
+}
+type NattyFetch = (input: string, init?: NattyFetchRequestInit) => Promise<NattyFetchResponse>;
+interface NattyClientOptions {
+    baseUrl?: string;
+    fetch?: NattyFetch;
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+}
+interface NattyRequestOptions {
+    headers?: Record<string, string>;
+    signal?: unknown;
+    params?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    body?: unknown;
+}
+interface NattyClientEndpoint {
+    method: string;
+    path: string;
+}
+type NattyClientContract = {
+    [key: string]: NattyClientContract | NattyClientEndpoint;
+};
+declare class NattyClientError extends Error {
+    status: number;
+    body: unknown;
+    responseHeaders: Record<string, string>;
+    constructor(message: string, status: number, body: unknown, responseHeaders?: Record<string, string>);
+}
+declare function createNattyClient<TClient = any>(contract: NattyClientContract, options?: NattyClientOptions): TClient;
+
+export { NattyClientContract, NattyClientEndpoint, NattyClientError, NattyClientOptions, NattyFetch, NattyFetchRequestInit, NattyFetchResponse, NattyRequestOptions, createNattyClient };

package/dist/index.mjs

@@ -0,0 +1,163 @@
+class NattyClientError extends Error {
+  constructor(message, status, body, responseHeaders = {}) {
+    super(message);
+    this.name = "NattyClientError";
+    this.status = status;
+    this.body = body;
+    this.responseHeaders = responseHeaders;
+  }
+}
+function isEndpoint(value) {
+  return !!value && typeof value === "object" && typeof value.method === "string" && typeof value.path === "string";
+}
+function trimSlashes(value) {
+  return String(value || "").replace(/^\/+|\/+$/g, "");
+}
+function joinUrl(baseUrl, pathName) {
+  const normalizedPath = trimSlashes(pathName);
+  if (!baseUrl) {
+    return normalizedPath ? `/${normalizedPath}` : "/";
+  }
+  const normalizedBase = trimSlashes(baseUrl);
+  if (!normalizedBase) {
+    return normalizedPath ? `/${normalizedPath}` : "/";
+  }
+  return normalizedPath ? `/${normalizedBase}/${normalizedPath}` : `/${normalizedBase}`;
+}
+function applyPathParams(pathName, params) {
+  return pathName.replace(/:([A-Za-z0-9_]+)/g, (_, key) => {
+    if (!params || params[key] === void 0 || params[key] === null) {
+      throw new Error(`Missing path param "${key}" for ${pathName}`);
+    }
+    return encodeURIComponent(String(params[key]));
+  });
+}
+function appendQueryParams(url, query) {
+  if (!query || Object.keys(query).length === 0) {
+    return url;
+  }
+  const searchParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value === void 0 || value === null) {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        searchParams.append(key, String(item));
+      }
+      continue;
+    }
+    searchParams.set(key, String(value));
+  }
+  const queryString = searchParams.toString();
+  if (!queryString) {
+    return url;
+  }
+  return `${url}${url.includes("?") ? "&" : "?"}${queryString}`;
+}
+function isBodyPassthrough(value) {
+  if (value == null) {
+    return true;
+  }
+  if (typeof value === "string") {
+    return true;
+  }
+  if (typeof URLSearchParams !== "undefined" && value instanceof URLSearchParams) {
+    return true;
+  }
+  if (typeof FormData !== "undefined" && value instanceof FormData) {
+    return true;
+  }
+  if (typeof Blob !== "undefined" && value instanceof Blob) {
+    return true;
+  }
+  if (typeof ArrayBuffer !== "undefined" && value instanceof ArrayBuffer) {
+    return true;
+  }
+  return false;
+}
+async function resolveDefaultHeaders(options) {
+  if (!options?.headers) {
+    return {};
+  }
+  if (typeof options.headers === "function") {
+    return await options.headers() || {};
+  }
+  return options.headers;
+}
+function readResponseHeaders(response) {
+  const headers = {};
+  response.headers?.forEach?.((value, key) => {
+    headers[key] = value;
+  });
+  return headers;
+}
+async function readResponseBody(response) {
+  const text = await response.text();
+  if (!text) {
+    return void 0;
+  }
+  const contentType = response.headers?.get?.("content-type") || "";
+  if (contentType.includes("application/json")) {
+    try {
+      return JSON.parse(text);
+    } catch {
+      return text;
+    }
+  }
+  return text;
+}
+async function invokeEndpoint(endpoint, input, options) {
+  const fetcher = options.fetch || globalThis.fetch;
+  if (!fetcher) {
+    throw new Error(
+      "No fetch implementation is available. Pass options.fetch to createNattyClient."
+    );
+  }
+  const pathWithParams = applyPathParams(endpoint.path, input?.params);
+  const url = appendQueryParams(joinUrl(options.baseUrl, pathWithParams), input?.query);
+  const defaultHeaders = await resolveDefaultHeaders(options);
+  const headers = {
+    ...defaultHeaders,
+    ...input?.headers || {}
+  };
+  let body = input?.body;
+  if (!isBodyPassthrough(body) && body !== void 0) {
+    body = JSON.stringify(body);
+    if (!headers["Content-Type"]) {
+      headers["Content-Type"] = "application/json";
+    }
+  }
+  const response = await fetcher(url, {
+    method: endpoint.method,
+    headers,
+    body,
+    signal: input?.signal
+  });
+  const responseBody = await readResponseBody(response);
+  if (!response.ok) {
+    throw new NattyClientError(
+      `Natty client request failed with status ${response.status}`,
+      response.status,
+      responseBody,
+      readResponseHeaders(response)
+    );
+  }
+  return responseBody;
+}
+function createContractNode(node, options) {
+  const clientNode = {};
+  for (const [key, value] of Object.entries(node)) {
+    if (isEndpoint(value)) {
+      clientNode[key] = (input) => invokeEndpoint(value, input, options);
+      continue;
+    }
+    clientNode[key] = createContractNode(value, options);
+  }
+  return clientNode;
+}
+function createNattyClient(contract, options = {}) {
+  return createContractNode(contract, options);
+}
+
+export { NattyClientError, createNattyClient };

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@nattyjs/client",
+  "version": "0.0.1-beta.67",
+  "description": "Generic runtime client for NattyJS generated SDKs",
+  "keywords": [],
+  "author": "ajayojha <ojhaajay@outlook.com>",
+  "license": "MIT",
+  "module": "./dist/index.mjs",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "unbuild"
+  },
+  "devDependencies": {
+    "unbuild": "1.2.1"
+  }
+}