@auldrant/api 0.0.4 → 0.1.1

package/README.md

@@ -1,19 +1,76 @@
 # @auldrant/api
 
-@auldrant/api is a client-side library intended to simplify working with Web APIs so you can focus on your core application logic. It also provides some content useful for server-side applications as well. We recommend using [Bun](https://bun.sh) to work with @auldrant/api. To install
+@auldrant/api is a client-side library that makes REST API calls simple and correct. It wraps the [Fetch API][fetch] with ergonomic method helpers, automatic JSON serialization, and a discriminated union response type so you always know whether a request succeeded.
+
+We recommend using [Bun](https://bun.sh) to work with @auldrant/api.
 
 ```bash
 bun install
 ```
 
-## Static Content
+## Usage
+
+```ts
+import { api } from '@auldrant/api';
+
+const result = await api.get<User[]>('/api/users');
+if (result.ok) {
+  console.log(result.data); // User[]
+} else {
+  console.error(result.status); // HTTP status code, or 0 for network errors
+}
+```
+
+## API
+
+### Method helpers
+
+All helpers return `Promise<ApiResponse<T>>`.
+
+| Method | Signature |
+|--------|-----------|
+| `api.get` | `(url, options?)` |
+| `api.post` | `(url, body?, options?)` |
+| `api.put` | `(url, body?, options?)` |
+| `api.patch` | `(url, body?, options?)` |
+| `api.delete` | `(url, options?)` |
+| `api.head` | `(url, options?)` |
+| `api.options` | `(url, options?)` |
+
+Plain objects passed as `body` are automatically serialized to JSON.
 
-@auldrant/api is designed to provide simple, reusable code for common work with APIs. All static content can be found in [static.ts][static]. This includes common content like HTTP methods and status codes, as well as many types for the most common HTTP headers including MIME types and encodings, and some helper typings for working with requests and responses.
+### ApiResponse
+
+```ts
+type ApiResponse<T> =
+  | { ok: true;  data: T;    status: number }
+  | { ok: false; data: null; status: number };
+```
+
+Use `ok` to narrow the type. Status `0` means a network error or aborted request.
+
+### Options
+
+```ts
+interface RequestOptions {
+  accept?: MimeType;      // Default: MimeType.JSON
+  headers?: HeadersInit;
+  signal?: AbortSignal;
+}
+
+interface RequestBodyOptions extends RequestOptions {
+  contentType?: MimeType;           // Default: MimeType.JSON
+  compression?: CompressionMethod;  // gzip or deflate
+}
+```
+
+## Static Content
 
-## Methods
+All enums and types are re-exported from the package root:
 
-@auldrant/api's main feature is [apiCall], which aims to provide a simpler interface for working with [fetch] that handles some of the technical operations automatically, behind the scenes. For example, it will automatically perform supported compression on content upon request and set the appropriate `Content-Encoding` header.
+- `HttpMethod` — GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
+- `HttpStatus` — common HTTP status codes
+- `MimeType` — common MIME type strings
+- `CompressionMethod` — gzip, deflate
 
-[static]: ./src/static.ts
-[apiCall]: ./src/apiCall.ts
 [fetch]: https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API

package/dist/api.d.ts

@@ -0,0 +1,59 @@
+import { ApiResponse, RequestBodyOptions, RequestOptions } from './static.ts';
+/**
+ * RESTful API client with method helpers.
+ *
+ * @example
+ * ```ts
+ * const result = await api.get<User[]>('/api/users');
+ * if (result.ok) {
+ *   console.log(result.data); // User[]
+ * }
+ * ```
+ */
+export declare const api: {
+    /**
+     * Sends a GET request.
+     * @param url - Request URL
+     * @param options - Request options (accept, headers, signal)
+     */
+    get<T>(url: string | URL, options?: RequestOptions): Promise<ApiResponse<T>>;
+    /**
+     * Sends a POST request.
+     * @param url - Request URL
+     * @param body - Request body (auto-serialized to JSON if plain object)
+     * @param options - Request options (contentType, accept, headers, signal, compression)
+     */
+    post<T>(url: string | URL, body?: BodyInit | object, options?: RequestBodyOptions): Promise<ApiResponse<T>>;
+    /**
+     * Sends a PUT request.
+     * @param url - Request URL
+     * @param body - Request body (auto-serialized to JSON if plain object)
+     * @param options - Request options (contentType, accept, headers, signal, compression)
+     */
+    put<T>(url: string | URL, body?: BodyInit | object, options?: RequestBodyOptions): Promise<ApiResponse<T>>;
+    /**
+     * Sends a PATCH request.
+     * @param url - Request URL
+     * @param body - Request body (auto-serialized to JSON if plain object)
+     * @param options - Request options (contentType, accept, headers, signal, compression)
+     */
+    patch<T>(url: string | URL, body?: BodyInit | object, options?: RequestBodyOptions): Promise<ApiResponse<T>>;
+    /**
+     * Sends a DELETE request.
+     * @param url - Request URL
+     * @param options - Request options (accept, headers, signal)
+     */
+    delete<T>(url: string | URL, options?: RequestOptions): Promise<ApiResponse<T>>;
+    /**
+     * Sends a HEAD request. Returns status and headers only (no body).
+     * @param url - Request URL
+     * @param options - Request options (headers, signal)
+     */
+    head(url: string | URL, options?: RequestOptions): Promise<ApiResponse<null>>;
+    /**
+     * Sends an OPTIONS request. Returns allowed methods and CORS info.
+     * @param url - Request URL
+     * @param options - Request options (accept, headers, signal)
+     */
+    options<T>(url: string | URL, options?: RequestOptions): Promise<ApiResponse<T>>;
+};

package/dist/auldrant-api.js

@@ -0,0 +1,134 @@
+var l = /* @__PURE__ */ ((E) => (E[E.OK = 200] = "OK", E[E.CREATED = 201] = "CREATED", E[E.ACCEPTED = 202] = "ACCEPTED", E[E.NO_CONTENT = 204] = "NO_CONTENT", E[E.PARTIAL_CONTENT = 206] = "PARTIAL_CONTENT", E[E.MOVED_PERMANENTLY = 301] = "MOVED_PERMANENTLY", E[E.FOUND = 302] = "FOUND", E[E.SEE_OTHER = 303] = "SEE_OTHER", E[E.NOT_MODIFIED = 304] = "NOT_MODIFIED", E[E.TEMPORARY_REDIRECT = 307] = "TEMPORARY_REDIRECT", E[E.PERMANENT_REDIRECT = 308] = "PERMANENT_REDIRECT", E[E.BAD_REQUEST = 400] = "BAD_REQUEST", E[E.UNAUTHORIZED = 401] = "UNAUTHORIZED", E[E.PAYMENT_REQUIRED = 402] = "PAYMENT_REQUIRED", E[E.FORBIDDEN = 403] = "FORBIDDEN", E[E.NOT_FOUND = 404] = "NOT_FOUND", E[E.METHOD_NOT_ALLOWED = 405] = "METHOD_NOT_ALLOWED", E[E.NOT_ACCEPTABLE = 406] = "NOT_ACCEPTABLE", E[E.PROXY_AUTHENTICATION_REQUIRED = 407] = "PROXY_AUTHENTICATION_REQUIRED", E[E.REQUEST_TIMEOUT = 408] = "REQUEST_TIMEOUT", E[E.CONFLICT = 409] = "CONFLICT", E[E.GONE = 410] = "GONE", E[E.LENGTH_REQUIRED = 411] = "LENGTH_REQUIRED", E[E.PRECONDITION_FAILED = 412] = "PRECONDITION_FAILED", E[E.PAYLOAD_TOO_LARGE = 413] = "PAYLOAD_TOO_LARGE", E[E.URI_TOO_LONG = 414] = "URI_TOO_LONG", E[E.UNSUPPORTED_MEDIA_TYPE = 415] = "UNSUPPORTED_MEDIA_TYPE", E[E.RANGE_NOT_SATISFIABLE = 416] = "RANGE_NOT_SATISFIABLE", E[E.EXPECTATION_FAILED = 417] = "EXPECTATION_FAILED", E[E.IM_A_TEAPOT = 418] = "IM_A_TEAPOT", E[E.MISDIRECTED_REQUEST = 421] = "MISDIRECTED_REQUEST", E[E.UNPROCESSABLE_ENTITY = 422] = "UNPROCESSABLE_ENTITY", E[E.LOCKED = 423] = "LOCKED", E[E.FAILED_DEPENDENCY = 424] = "FAILED_DEPENDENCY", E[E.TOO_EARLY = 425] = "TOO_EARLY", E[E.UPGRADE_REQUIRED = 426] = "UPGRADE_REQUIRED", E[E.PRECONDITION_REQUIRED = 428] = "PRECONDITION_REQUIRED", E[E.TOO_MANY_REQUESTS = 429] = "TOO_MANY_REQUESTS", E[E.REQUEST_HEADER_FIELDS_TOO_LARGE = 431] = "REQUEST_HEADER_FIELDS_TOO_LARGE", E[E.UNAVAILABLE_FOR_LEGAL_REASONS = 451] = "UNAVAILABLE_FOR_LEGAL_REASONS", E[E.INTERNAL_SERVER_ERROR = 500] = "INTERNAL_SERVER_ERROR", E[E.NOT_IMPLEMENTED = 501] = "NOT_IMPLEMENTED", E[E.BAD_GATEWAY = 502] = "BAD_GATEWAY", E[E.SERVICE_UNAVAILABLE = 503] = "SERVICE_UNAVAILABLE", E[E.GATEWAY_TIMEOUT = 504] = "GATEWAY_TIMEOUT", E[E.HTTP_VERSION_NOT_SUPPORTED = 505] = "HTTP_VERSION_NOT_SUPPORTED", E[E.VARIANT_ALSO_NEGOTIATES = 506] = "VARIANT_ALSO_NEGOTIATES", E[E.INSUFFICIENT_STORAGE = 507] = "INSUFFICIENT_STORAGE", E[E.LOOP_DETECTED = 508] = "LOOP_DETECTED", E[E.NOT_EXTENDED = 510] = "NOT_EXTENDED", E[E.NETWORK_AUTHENTICATION_REQUIRED = 511] = "NETWORK_AUTHENTICATION_REQUIRED", E))(l || {}), R = /* @__PURE__ */ ((E) => (E.HTML = "text/html", E.PLAIN = "text/plain", E.CSV = "text/csv", E.CSS = "text/css", E.JAVASCRIPT = "text/javascript", E.JSON = "application/json", E.XML = "application/xml", E.PDF = "application/pdf", E.ZIP = "application/zip", E.GZIP = "application/gzip", E.OCTET_STREAM = "application/octet-stream", E.FORM_DATA = "multipart/form-data", E.URL_ENCODED = "application/x-www-form-urlencoded", E.JPEG = "image/jpeg", E.PNG = "image/png", E.GIF = "image/gif", E.SVG = "image/svg+xml", E.WEBP = "image/webp", E.ICO = "image/x-icon", E.MP4 = "video/mp4", E.WEBM = "video/webm", E.MP3 = "audio/mpeg", E.OGG = "audio/ogg", E.WAV = "audio/wav", E.TAR = "application/x-tar", E))(R || {}), A = /* @__PURE__ */ ((E) => (E.GET = "GET", E.POST = "POST", E.PUT = "PUT", E.DELETE = "DELETE", E.PATCH = "PATCH", E.OPTIONS = "OPTIONS", E.HEAD = "HEAD", E))(A || {}), c = /* @__PURE__ */ ((E) => (E.GZIP = "gzip", E.DEFLATE = "deflate", E))(c || {});
+const o = 1024;
+function f(E, T) {
+  return T == null || E instanceof FormData || E instanceof URLSearchParams ? E : E instanceof ReadableStream ? E.pipeThrough(new CompressionStream(T)) : (typeof E == "string" ? E.length : E instanceof Blob ? E.size : E.byteLength) < o ? E : new Blob([E]).stream().pipeThrough(new CompressionStream(T));
+}
+function G(E, T, O, n, r) {
+  const _ = new Headers(n);
+  _.has("Accept") || _.set("Accept", T);
+  const D = r instanceof FormData || r instanceof URLSearchParams;
+  return E != null && !D && !_.has("Content-Type") && _.set("Content-Type", E), O != null && !_.has("Content-Encoding") && _.set("Content-Encoding", O), _;
+}
+async function a(E, T) {
+  switch (T) {
+    case R.JSON:
+      return await E.json();
+    case R.PLAIN:
+    case R.HTML:
+    case R.CSV:
+    case R.XML:
+    case R.CSS:
+    case R.JAVASCRIPT:
+      return await E.text();
+    default:
+      return await E.blob();
+  }
+}
+async function N(E, T, O, n = {}) {
+  const {
+    accept: r = R.JSON,
+    contentType: _ = R.JSON,
+    compression: D,
+    headers: C,
+    signal: i
+  } = n;
+  try {
+    const L = O != null && T !== A.GET && T !== A.HEAD ? f(O, D) : null, U = G(
+      O != null ? _ : void 0,
+      r,
+      O != null ? D : void 0,
+      C,
+      O
+    ), e = {
+      method: T,
+      body: L,
+      headers: U
+    };
+    i != null && (e.signal = i);
+    const I = await fetch(E, e);
+    return I.ok ? T === A.HEAD || I.status === 204 ? { ok: !0, data: null, status: I.status } : { ok: !0, data: await a(I, r), status: I.status } : { ok: !1, data: null, status: I.status };
+  } catch {
+    return { ok: !1, data: null, status: 0 };
+  }
+}
+function P(E) {
+  return E instanceof FormData || E instanceof URLSearchParams || E instanceof Blob || E instanceof ArrayBuffer || E instanceof ReadableStream || typeof E == "string" ? E : JSON.stringify(E);
+}
+const g = {
+  /**
+   * Sends a GET request.
+   * @param url - Request URL
+   * @param options - Request options (accept, headers, signal)
+   */
+  get(E, T) {
+    return N(E, A.GET, void 0, T);
+  },
+  /**
+   * Sends a POST request.
+   * @param url - Request URL
+   * @param body - Request body (auto-serialized to JSON if plain object)
+   * @param options - Request options (contentType, accept, headers, signal, compression)
+   */
+  post(E, T, O) {
+    return N(
+      E,
+      A.POST,
+      T != null ? P(T) : void 0,
+      O
+    );
+  },
+  /**
+   * Sends a PUT request.
+   * @param url - Request URL
+   * @param body - Request body (auto-serialized to JSON if plain object)
+   * @param options - Request options (contentType, accept, headers, signal, compression)
+   */
+  put(E, T, O) {
+    return N(E, A.PUT, T != null ? P(T) : void 0, O);
+  },
+  /**
+   * Sends a PATCH request.
+   * @param url - Request URL
+   * @param body - Request body (auto-serialized to JSON if plain object)
+   * @param options - Request options (contentType, accept, headers, signal, compression)
+   */
+  patch(E, T, O) {
+    return N(
+      E,
+      A.PATCH,
+      T != null ? P(T) : void 0,
+      O
+    );
+  },
+  /**
+   * Sends a DELETE request.
+   * @param url - Request URL
+   * @param options - Request options (accept, headers, signal)
+   */
+  delete(E, T) {
+    return N(E, A.DELETE, void 0, T);
+  },
+  /**
+   * Sends a HEAD request. Returns status and headers only (no body).
+   * @param url - Request URL
+   * @param options - Request options (headers, signal)
+   */
+  head(E, T) {
+    return N(E, A.HEAD, void 0, T);
+  },
+  /**
+   * Sends an OPTIONS request. Returns allowed methods and CORS info.
+   * @param url - Request URL
+   * @param options - Request options (accept, headers, signal)
+   */
+  options(E, T) {
+    return N(E, A.OPTIONS, void 0, T);
+  }
+};
+export {
+  c as CompressionMethod,
+  A as HttpMethod,
+  l as HttpStatus,
+  R as MimeType,
+  g as api
+};

package/dist/index.d.ts

@@ -1,110 +1,2 @@
-// Generated by dts-bundle-generator v9.5.1
-
-export declare const enum HttpStatus {
-	OK = 200,
-	CREATED = 201,
-	ACCEPTED = 202,
-	NO_CONTENT = 204,
-	PARTIAL_CONTENT = 206,
-	MOVED_PERMANENTLY = 301,
-	FOUND = 302,
-	SEE_OTHER = 303,
-	NOT_MODIFIED = 304,
-	TEMPORARY_REDIRECT = 307,
-	PERMANENT_REDIRECT = 308,
-	BAD_REQUEST = 400,
-	UNAUTHORIZED = 401,
-	PAYMENT_REQUIRED = 402,
-	FORBIDDEN = 403,
-	NOT_FOUND = 404,
-	METHOD_NOT_ALLOWED = 405,
-	NOT_ACCEPTABLE = 406,
-	PROXY_AUTHENTICATION_REQUIRED = 407,
-	REQUEST_TIMEOUT = 408,
-	CONFLICT = 409,
-	GONE = 410,
-	LENGTH_REQUIRED = 411,
-	PRECONDITION_FAILED = 412,
-	PAYLOAD_TOO_LARGE = 413,
-	URI_TOO_LONG = 414,
-	UNSUPPORTED_MEDIA_TYPE = 415,
-	RANGE_NOT_SATISFIABLE = 416,
-	EXPECTATION_FAILED = 417,
-	IM_A_TEAPOT = 418,
-	MISDIRECTED_REQUEST = 421,
-	UNPROCESSABLE_ENTITY = 422,
-	LOCKED = 423,
-	FAILED_DEPENDENCY = 424,
-	TOO_EARLY = 425,
-	UPGRADE_REQUIRED = 426,
-	PRECONDITION_REQUIRED = 428,
-	TOO_MANY_REQUESTS = 429,
-	REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
-	UNAVAILABLE_FOR_LEGAL_REASONS = 451,
-	INTERNAL_SERVER_ERROR = 500,
-	NOT_IMPLEMENTED = 501,
-	BAD_GATEWAY = 502,
-	SERVICE_UNAVAILABLE = 503,
-	GATEWAY_TIMEOUT = 504,
-	HTTP_VERSION_NOT_SUPPORTED = 505,
-	VARIANT_ALSO_NEGOTIATES = 506,
-	INSUFFICIENT_STORAGE = 507,
-	LOOP_DETECTED = 508,
-	NOT_EXTENDED = 510,
-	NETWORK_AUTHENTICATION_REQUIRED = 511
-}
-declare const enum MimeType$1 {
-	HTML = "text/html",
-	PLAIN = "text/plain",
-	CSV = "text/csv",
-	CSS = "text/css",
-	JAVASCRIPT = "text/javascript",
-	JSON = "application/json",
-	XML = "application/xml",
-	PDF = "application/pdf",
-	ZIP = "application/zip",
-	GZIP = "application/gzip",
-	OCTET_STREAM = "application/octet-stream",
-	JPEG = "image/jpeg",
-	PNG = "image/png",
-	GIF = "image/gif",
-	SVG = "image/svg+xml",
-	WEBP = "image/webp",
-	MP4 = "video/mp4",
-	WEBM = "video/webm",
-	MP3 = "audio/mpeg",
-	OGG = "audio/ogg",
-	WAV = "audio/wav",
-	ICO = "image/x-icon",
-	TAR = "application/x-tar"
-}
-export declare const enum HttpMethod {
-	GET = "GET",
-	POST = "POST",
-	PUT = "PUT",
-	DELETE = "DELETE",
-	PATCH = "PATCH",
-	OPTIONS = "OPTIONS",
-	HEAD = "HEAD"
-}
-export declare const enum CompressionMethod {
-	GZIP = "gzip",
-	DEFLATE = "deflate"
-}
-export interface IRequestArgs {
-	body?: BodyInit;
-	contentType?: MimeType$1;
-	accept?: MimeType$1;
-	compression?: CompressionMethod;
-}
-export declare const apiCall: <T>(url: string | URL, method: HttpMethod, requestArgs: IRequestArgs, controller: AbortController) => Promise<{
-	data: T | null;
-	status: HttpStatus;
-}>;
-export declare function logRequest(req: Request): void;
-
-export {
-	MimeType$1 as MimeType,
-};
-
-export {};
+export { api } from './api.ts';
+export { type ApiResponse, CompressionMethod, HttpMethod, HttpStatus, MimeType, type RequestBodyOptions, type RequestOptions, } from './static.ts';

package/dist/static.d.ts

@@ -0,0 +1,122 @@
+export declare enum HttpStatus {
+    OK = 200,
+    CREATED = 201,
+    ACCEPTED = 202,
+    NO_CONTENT = 204,
+    PARTIAL_CONTENT = 206,
+    MOVED_PERMANENTLY = 301,
+    FOUND = 302,
+    SEE_OTHER = 303,
+    NOT_MODIFIED = 304,
+    TEMPORARY_REDIRECT = 307,
+    PERMANENT_REDIRECT = 308,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    PAYMENT_REQUIRED = 402,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    METHOD_NOT_ALLOWED = 405,
+    NOT_ACCEPTABLE = 406,
+    PROXY_AUTHENTICATION_REQUIRED = 407,
+    REQUEST_TIMEOUT = 408,
+    CONFLICT = 409,
+    GONE = 410,
+    LENGTH_REQUIRED = 411,
+    PRECONDITION_FAILED = 412,
+    PAYLOAD_TOO_LARGE = 413,
+    URI_TOO_LONG = 414,
+    UNSUPPORTED_MEDIA_TYPE = 415,
+    RANGE_NOT_SATISFIABLE = 416,
+    EXPECTATION_FAILED = 417,
+    IM_A_TEAPOT = 418,
+    MISDIRECTED_REQUEST = 421,
+    UNPROCESSABLE_ENTITY = 422,
+    LOCKED = 423,
+    FAILED_DEPENDENCY = 424,
+    TOO_EARLY = 425,
+    UPGRADE_REQUIRED = 426,
+    PRECONDITION_REQUIRED = 428,
+    TOO_MANY_REQUESTS = 429,
+    REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
+    UNAVAILABLE_FOR_LEGAL_REASONS = 451,
+    INTERNAL_SERVER_ERROR = 500,
+    NOT_IMPLEMENTED = 501,
+    BAD_GATEWAY = 502,
+    SERVICE_UNAVAILABLE = 503,
+    GATEWAY_TIMEOUT = 504,
+    HTTP_VERSION_NOT_SUPPORTED = 505,
+    VARIANT_ALSO_NEGOTIATES = 506,
+    INSUFFICIENT_STORAGE = 507,
+    LOOP_DETECTED = 508,
+    NOT_EXTENDED = 510,
+    NETWORK_AUTHENTICATION_REQUIRED = 511
+}
+export declare enum MimeType {
+    HTML = "text/html",
+    PLAIN = "text/plain",
+    CSV = "text/csv",
+    CSS = "text/css",
+    JAVASCRIPT = "text/javascript",
+    JSON = "application/json",
+    XML = "application/xml",
+    PDF = "application/pdf",
+    ZIP = "application/zip",
+    GZIP = "application/gzip",
+    OCTET_STREAM = "application/octet-stream",
+    FORM_DATA = "multipart/form-data",
+    URL_ENCODED = "application/x-www-form-urlencoded",
+    JPEG = "image/jpeg",
+    PNG = "image/png",
+    GIF = "image/gif",
+    SVG = "image/svg+xml",
+    WEBP = "image/webp",
+    ICO = "image/x-icon",
+    MP4 = "video/mp4",
+    WEBM = "video/webm",
+    MP3 = "audio/mpeg",
+    OGG = "audio/ogg",
+    WAV = "audio/wav",
+    TAR = "application/x-tar"
+}
+export declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE",
+    PATCH = "PATCH",
+    OPTIONS = "OPTIONS",
+    HEAD = "HEAD"
+}
+export declare enum CompressionMethod {
+    GZIP = "gzip",
+    DEFLATE = "deflate"
+}
+/** Options for requests that do not carry a body (GET, HEAD, OPTIONS, DELETE). */
+export interface RequestOptions {
+    /** Expected response MIME type. Defaults to `MimeType.JSON`. */
+    accept?: MimeType;
+    /** Additional headers to include in the request. */
+    headers?: HeadersInit;
+    /** AbortSignal to cancel the request. */
+    signal?: AbortSignal;
+}
+/** Options for requests that carry a body (POST, PUT, PATCH). */
+export interface RequestBodyOptions extends RequestOptions {
+    /** Request body content type. Defaults to `MimeType.JSON`. */
+    contentType?: MimeType;
+    /** Compress the request body before sending. */
+    compression?: CompressionMethod;
+}
+/**
+ * Discriminated union for API responses.
+ * Use `ok` to narrow: if `ok` is true, `data` is `T`; otherwise `data` is `null`.
+ */
+export type ApiResponse<T> = {
+    ok: true;
+    data: T | null;
+    status: number;
+} | {
+    ok: false;
+    data: null;
+    status: number;
+};

package/package.json

@@ -1,30 +1,24 @@
 {
 	"name": "@auldrant/api",
-	"version": "0.0.4",
+	"version": "0.1.1",
+	"description": "Simple library for working with APIs",
 	"author": "Colonel Jade <colonel.jade@proton.me> (https://github.com/coloneljade/)",
-	"repository": "github:coloneljade/auldrant-api",
-	"homepage": "https://github.com/coloneljade/auldrant-api#readme",
 	"license": "MIT",
-	"type": "module",
-	"module": "dist/index.js",
-	"devDependencies": {
-		"@types/bun": "^1.1.14",
-		"bun-plugin-dts": "^0.3.0",
-		"fs": "^0.0.1-security",
-		"oxc-transform": "^0.43.0",
-		"path": "^0.12.7",
-		"typescript": "^5.7.2",
-		"yargs": "^17.7.2"
-	},
-	"exports": {
-		".": "./dist/index.js"
-	},
-	"types": "./dist/index.d.ts",
+	"homepage": "https://github.com/coloneljade/auldrant-api#readme",
+	"repository": "github:coloneljade/auldrant-api",
 	"bugs": {
 		"url": "https://github.com/coloneljade/auldrant-api/issues",
 		"email": "colonel.jade@proton.me"
 	},
-	"description": "Simple library for working with APIs",
+	"type": "module",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/auldrant-api.js"
+		}
+	},
+	"module": "dist/auldrant-api.js",
+	"types": "./dist/index.d.ts",
 	"files": [
 		"dist/**/*.js",
 		"dist/**/*.d.ts",
@@ -33,9 +27,23 @@
 	"publishConfig": {
 		"access": "public"
 	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.4",
+		"@types/bun": "^1.1.14",
+		"lefthook": "^2.1.1",
+		"typescript": "^5.7.2",
+		"vite": "^7.3.1",
+		"vite-plugin-dts": "^4.5.4"
+	},
 	"scripts": {
-		"build": "bun clean && bun ./build.ts",
-		"clean": "bun ./clean.ts --dir dist",
-		"publish": "bun test && bun publish --frozen-lockfile"
+		"build": "vite build",
+		"check": "biome check .",
+		"check:fix": "biome check --fix .",
+		"format": "biome format --fix .",
+		"lint": "biome lint .",
+		"test": "bun test",
+		"test:watch": "bun test --watch",
+		"typecheck": "tsc --noEmit",
+		"prepare": "test -n \"$CI\" || lefthook install"
 	}
 }

package/dist/index.js

@@ -1 +0,0 @@
-var D;((E)=>{E[E.OK=200]="OK";E[E.CREATED=201]="CREATED";E[E.ACCEPTED=202]="ACCEPTED";E[E.NO_CONTENT=204]="NO_CONTENT";E[E.PARTIAL_CONTENT=206]="PARTIAL_CONTENT";E[E.MOVED_PERMANENTLY=301]="MOVED_PERMANENTLY";E[E.FOUND=302]="FOUND";E[E.SEE_OTHER=303]="SEE_OTHER";E[E.NOT_MODIFIED=304]="NOT_MODIFIED";E[E.TEMPORARY_REDIRECT=307]="TEMPORARY_REDIRECT";E[E.PERMANENT_REDIRECT=308]="PERMANENT_REDIRECT";E[E.BAD_REQUEST=400]="BAD_REQUEST";E[E.UNAUTHORIZED=401]="UNAUTHORIZED";E[E.PAYMENT_REQUIRED=402]="PAYMENT_REQUIRED";E[E.FORBIDDEN=403]="FORBIDDEN";E[E.NOT_FOUND=404]="NOT_FOUND";E[E.METHOD_NOT_ALLOWED=405]="METHOD_NOT_ALLOWED";E[E.NOT_ACCEPTABLE=406]="NOT_ACCEPTABLE";E[E.PROXY_AUTHENTICATION_REQUIRED=407]="PROXY_AUTHENTICATION_REQUIRED";E[E.REQUEST_TIMEOUT=408]="REQUEST_TIMEOUT";E[E.CONFLICT=409]="CONFLICT";E[E.GONE=410]="GONE";E[E.LENGTH_REQUIRED=411]="LENGTH_REQUIRED";E[E.PRECONDITION_FAILED=412]="PRECONDITION_FAILED";E[E.PAYLOAD_TOO_LARGE=413]="PAYLOAD_TOO_LARGE";E[E.URI_TOO_LONG=414]="URI_TOO_LONG";E[E.UNSUPPORTED_MEDIA_TYPE=415]="UNSUPPORTED_MEDIA_TYPE";E[E.RANGE_NOT_SATISFIABLE=416]="RANGE_NOT_SATISFIABLE";E[E.EXPECTATION_FAILED=417]="EXPECTATION_FAILED";E[E.IM_A_TEAPOT=418]="IM_A_TEAPOT";E[E.MISDIRECTED_REQUEST=421]="MISDIRECTED_REQUEST";E[E.UNPROCESSABLE_ENTITY=422]="UNPROCESSABLE_ENTITY";E[E.LOCKED=423]="LOCKED";E[E.FAILED_DEPENDENCY=424]="FAILED_DEPENDENCY";E[E.TOO_EARLY=425]="TOO_EARLY";E[E.UPGRADE_REQUIRED=426]="UPGRADE_REQUIRED";E[E.PRECONDITION_REQUIRED=428]="PRECONDITION_REQUIRED";E[E.TOO_MANY_REQUESTS=429]="TOO_MANY_REQUESTS";E[E.REQUEST_HEADER_FIELDS_TOO_LARGE=431]="REQUEST_HEADER_FIELDS_TOO_LARGE";E[E.UNAVAILABLE_FOR_LEGAL_REASONS=451]="UNAVAILABLE_FOR_LEGAL_REASONS";E[E.INTERNAL_SERVER_ERROR=500]="INTERNAL_SERVER_ERROR";E[E.NOT_IMPLEMENTED=501]="NOT_IMPLEMENTED";E[E.BAD_GATEWAY=502]="BAD_GATEWAY";E[E.SERVICE_UNAVAILABLE=503]="SERVICE_UNAVAILABLE";E[E.GATEWAY_TIMEOUT=504]="GATEWAY_TIMEOUT";E[E.HTTP_VERSION_NOT_SUPPORTED=505]="HTTP_VERSION_NOT_SUPPORTED";E[E.VARIANT_ALSO_NEGOTIATES=506]="VARIANT_ALSO_NEGOTIATES";E[E.INSUFFICIENT_STORAGE=507]="INSUFFICIENT_STORAGE";E[E.LOOP_DETECTED=508]="LOOP_DETECTED";E[E.NOT_EXTENDED=510]="NOT_EXTENDED";E[E.NETWORK_AUTHENTICATION_REQUIRED=511]="NETWORK_AUTHENTICATION_REQUIRED"})(D||={});var P;((O)=>{O.HTML="text/html";O.PLAIN="text/plain";O.CSV="text/csv";O.CSS="text/css";O.JAVASCRIPT="text/javascript";O.JSON="application/json";O.XML="application/xml";O.PDF="application/pdf";O.ZIP="application/zip";O.GZIP="application/gzip";O.OCTET_STREAM="application/octet-stream";O.JPEG="image/jpeg";O.PNG="image/png";O.GIF="image/gif";O.SVG="image/svg+xml";O.WEBP="image/webp";O.MP4="video/mp4";O.WEBM="video/webm";O.MP3="audio/mpeg";O.OGG="audio/ogg";O.WAV="audio/wav";O.ICO="image/x-icon";O.TAR="application/x-tar"})(P||={});var C;((R)=>{R.GET="GET";R.POST="POST";R.PUT="PUT";R.DELETE="DELETE";R.PATCH="PATCH";R.OPTIONS="OPTIONS";R.HEAD="HEAD"})(C||={});var L;((_)=>{_.GZIP="gzip";_.DEFLATE="deflate"})(L||={});function Y(A,I){switch(I){case"gzip":case"deflate":return new Blob([JSON.stringify(A)]).stream().pipeThrough(new CompressionStream(I));default:return A}}var Q=async(A,I,_,G)=>{try{let{body:N,contentType:g,accept:U,compression:R}=_,F=N?Y(N,R):void 0,{signal:x}=G,T=await fetch(A,{signal:x,method:I,body:F,headers:new Headers({"Content-Type":g,Accept:U,"Content-Encoding":R})});if(!T.ok)return console.error(`Encountered error ${T.status}`),{data:null,status:T.status};switch(U){case"application/json":return await T.json();case"text/plain":case"text/html":case"text/csv":case"application/xml":case"text/css":case"text/javascript":return{data:await T.text(),status:T.status};default:return{data:await T.blob(),status:T.status}}}catch(N){return console.error(N.message),{data:null,status:500}}},V=Q;function B(A){console.log(`Path: ${new URL(A.url).pathname}`),console.log(`Method: ${A.method}`),console.log("Headers:"),A.headers.forEach((I,_)=>console.log(`${_}=${I}`))}export{B as logRequest,V as apiCall,P as MimeType,D as HttpStatus,C as HttpMethod,L as CompressionMethod};