qstd 0.3.26 → 0.3.28

package/dist/server/index.cjs

@@ -12,6 +12,7 @@ var clientS3 = require('@aws-sdk/client-s3');
 var s3RequestPresigner = require('@aws-sdk/s3-request-presigner');
 var s3PresignedPost = require('@aws-sdk/s3-presigned-post');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -636,6 +637,222 @@ var label = (name) => ({
   }
 });
 
+// src/shared/api/index.ts
+var api_exports = {};
+__export(api_exports, {
+  RestError: () => RestError,
+  configure: () => configure,
+  get: () => get,
+  patch: () => patch,
+  post: () => post,
+  put: () => put,
+  remove: () => remove
+});
+
+// src/shared/api/types.ts
+var RestError = class extends Error {
+  status;
+  body;
+  constructor(props) {
+    super(`REST ${props.status}: ${props.body}`);
+    this.name = "RestError";
+    this.status = props.status;
+    this.body = props.body;
+  }
+};
+
+// src/shared/api/fns.ts
+var isDev = () => {
+  if (typeof process !== "undefined" && process.env?.NODE_ENV) {
+    return process.env.NODE_ENV !== "production";
+  }
+  if (typeof ({ url: (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) }) !== "undefined" && undefined?.DEV !== void 0) {
+    return undefined.DEV;
+  }
+  return false;
+};
+var isAbsolute = (path) => path.startsWith("http");
+var prepareUrl = (path, props) => {
+  if (isDev() && !isAbsolute(path) && path.includes("?") && path.split("?")[1]?.split("#")[0]) {
+    console.warn(
+      `[api] Query params detected in path string. Prefer using the 'params' option instead: Api.get("/path", { params: { ... } }). Path: ${path}`
+    );
+  }
+  const base = isAbsolute(path) ? "" : props.baseUrl;
+  let url = `${base}${path}`;
+  if (props.params) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(props.params)) {
+      if (value != null) searchParams.set(key, String(value));
+    }
+    const qs = searchParams.toString();
+    if (qs) url += (url.includes("?") ? "&" : "?") + qs;
+  }
+  return url;
+};
+var prepareHeaders = async (props) => {
+  const { defaults, headersOption, input, body } = props;
+  if (headersOption === false) return void 0;
+  const headers = { ...defaults };
+  if (body instanceof FormData) ; else if (body instanceof Blob && body.type) {
+    headers["Content-Type"] = body.type;
+  } else if (input === "json") {
+    headers["Content-Type"] = "application/json";
+  } else if (input === "text") {
+    headers["Content-Type"] = "text/plain";
+  }
+  if (headersOption === void 0 || headersOption === true) {
+    return headers;
+  }
+  return await headersOption(headers);
+};
+var prepareBody = (body, input) => {
+  if (body === void 0) return void 0;
+  if (body instanceof FormData) return body;
+  if (body instanceof Blob) return body;
+  if (input === "json") return JSON.stringify(body);
+  if (input === "text") {
+    if (typeof body === "string") return body;
+    throw new Error("[api] input: 'text' requires a string body");
+  }
+  if (input === "form") {
+    const fd = new FormData();
+    for (const [k, v] of Object.entries(body)) {
+      fd.append(k, v);
+    }
+    return fd;
+  }
+  return body;
+};
+var parseResponse = async (response2, output, onProgress) => {
+  const out = output ?? "json";
+  if (out === "stream") {
+    return response2.body;
+  }
+  if (onProgress && response2.body) {
+    const total = Number(response2.headers.get("Content-Length")) || 0;
+    let loaded = 0;
+    const reader = response2.body.getReader();
+    const chunks = [];
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      chunks.push(value);
+      loaded += value.length;
+      onProgress({
+        loaded,
+        total,
+        percent: total ? Math.round(loaded / total * 100) : 0
+      });
+    }
+    const blob = new Blob(chunks);
+    if (out === "blob") return blob;
+    if (out === "arrayBuffer")
+      return await blob.arrayBuffer();
+    if (out === "text") return await blob.text();
+    const text2 = await blob.text();
+    return text2 ? JSON.parse(text2) : null;
+  }
+  if (out === "blob")
+    return await response2.blob();
+  if (out === "arrayBuffer")
+    return await response2.arrayBuffer();
+  if (out === "text")
+    return await response2.text();
+  const text = await response2.text();
+  return text ? JSON.parse(text) : null;
+};
+
+// src/shared/api/domain.ts
+var config = { baseUrl: "" };
+var configure = (c) => {
+  config = c;
+};
+var configHeaders = async () => {
+  if (!config.headers) return {};
+  return typeof config.headers === "function" ? await config.headers() : config.headers;
+};
+var request = async (method, path, options, defaultInput) => {
+  const opts = options;
+  const url = prepareUrl(path, {
+    baseUrl: config.baseUrl,
+    ...opts?.params ? { params: opts.params } : {}
+  });
+  const rawBody = opts?.body;
+  const isAutoDetect = rawBody instanceof FormData || rawBody instanceof Blob;
+  const input = opts && "input" in opts && opts.input !== void 0 ? opts.input : isAutoDetect ? void 0 : defaultInput;
+  const headersOption = opts?.headers;
+  const isExternal = isAbsolute(path);
+  const defaults = headersOption !== false && !isExternal ? await configHeaders() : {};
+  const headers = await prepareHeaders({
+    defaults,
+    headersOption,
+    input,
+    body: rawBody
+  });
+  const body = prepareBody(rawBody, input);
+  const response2 = await fetch(url, {
+    method,
+    ...headers && { headers },
+    ...body !== void 0 && { body },
+    ...opts?.signal && { signal: opts.signal }
+  });
+  if (!response2.ok) {
+    const error2 = new RestError({
+      status: response2.status,
+      body: await response2.text()
+    });
+    if (opts?.onError) return opts.onError(error2);
+    throw error2;
+  }
+  const data = await parseResponse(
+    response2,
+    opts?.output,
+    opts?.onProgress
+  );
+  return opts?.onSuccess ? opts.onSuccess(data) : data;
+};
+function get(path, opts) {
+  return request(
+    "GET",
+    path,
+    opts
+  );
+}
+function post(path, body, opts) {
+  return request(
+    "POST",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function put(path, body, opts) {
+  return request(
+    "PUT",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function patch(path, body, opts) {
+  return request(
+    "PATCH",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function remove(path, body, opts) {
+  const defaultInput = body !== void 0 ? "json" : void 0;
+  return request(
+    "DELETE",
+    path,
+    { ...opts, body },
+    defaultInput
+  );
+}
+
 // src/server/file/index.ts
 var file_exports = {};
 __export(file_exports, {
@@ -770,7 +987,7 @@ __export(ddb_exports, {
   lsiNormalized: () => lsiNormalized,
   lsiPhash: () => lsiPhash,
   lsiUsername: () => lsiUsername,
-  remove: () => remove,
+  remove: () => remove2,
   save: () => save,
   tableExists: () => tableExists
 });
@@ -1059,7 +1276,7 @@ async function find(ddb, props) {
     throw err;
   }
 }
-var remove = async (ddb, props) => {
+var remove2 = async (ddb, props) => {
   const TableName = getTableNameOrThrow(props.tableName, ddb.tableName);
   const command = new libDynamodb.DeleteCommand({ Key: props.key, TableName });
   return ddb.client.send(command);
@@ -1637,6 +1854,7 @@ var recordsFromSqs = (body) => {
   }
 };
 
+exports.Api = api_exports;
 exports.DDB = ddb_exports;
 exports.Dict = dict_exports;
 exports.File = file_exports;

package/dist/server/index.d.ts

@@ -7,6 +7,7 @@ export * as Time from "../shared/time";
 export * as Flow from "../shared/flow";
 export * as Random from "../shared/random";
 export * as Log from "../shared/log";
+export * as Api from "../shared/api";
 export * as File from "./file";
 export * as Lambda from "./aws/lambda";
 export * as DDB from "./aws/ddb";

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

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

package/dist/server/index.js

@@ -634,6 +634,222 @@ var label = (name) => ({
   }
 });
 
+// src/shared/api/index.ts
+var api_exports = {};
+__export(api_exports, {
+  RestError: () => RestError,
+  configure: () => configure,
+  get: () => get,
+  patch: () => patch,
+  post: () => post,
+  put: () => put,
+  remove: () => remove
+});
+
+// src/shared/api/types.ts
+var RestError = class extends Error {
+  status;
+  body;
+  constructor(props) {
+    super(`REST ${props.status}: ${props.body}`);
+    this.name = "RestError";
+    this.status = props.status;
+    this.body = props.body;
+  }
+};
+
+// src/shared/api/fns.ts
+var isDev = () => {
+  if (typeof process !== "undefined" && process.env?.NODE_ENV) {
+    return process.env.NODE_ENV !== "production";
+  }
+  if (typeof import.meta !== "undefined" && import.meta.env?.DEV !== void 0) {
+    return import.meta.env.DEV;
+  }
+  return false;
+};
+var isAbsolute = (path) => path.startsWith("http");
+var prepareUrl = (path, props) => {
+  if (isDev() && !isAbsolute(path) && path.includes("?") && path.split("?")[1]?.split("#")[0]) {
+    console.warn(
+      `[api] Query params detected in path string. Prefer using the 'params' option instead: Api.get("/path", { params: { ... } }). Path: ${path}`
+    );
+  }
+  const base = isAbsolute(path) ? "" : props.baseUrl;
+  let url = `${base}${path}`;
+  if (props.params) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(props.params)) {
+      if (value != null) searchParams.set(key, String(value));
+    }
+    const qs = searchParams.toString();
+    if (qs) url += (url.includes("?") ? "&" : "?") + qs;
+  }
+  return url;
+};
+var prepareHeaders = async (props) => {
+  const { defaults, headersOption, input, body } = props;
+  if (headersOption === false) return void 0;
+  const headers = { ...defaults };
+  if (body instanceof FormData) ; else if (body instanceof Blob && body.type) {
+    headers["Content-Type"] = body.type;
+  } else if (input === "json") {
+    headers["Content-Type"] = "application/json";
+  } else if (input === "text") {
+    headers["Content-Type"] = "text/plain";
+  }
+  if (headersOption === void 0 || headersOption === true) {
+    return headers;
+  }
+  return await headersOption(headers);
+};
+var prepareBody = (body, input) => {
+  if (body === void 0) return void 0;
+  if (body instanceof FormData) return body;
+  if (body instanceof Blob) return body;
+  if (input === "json") return JSON.stringify(body);
+  if (input === "text") {
+    if (typeof body === "string") return body;
+    throw new Error("[api] input: 'text' requires a string body");
+  }
+  if (input === "form") {
+    const fd = new FormData();
+    for (const [k, v] of Object.entries(body)) {
+      fd.append(k, v);
+    }
+    return fd;
+  }
+  return body;
+};
+var parseResponse = async (response2, output, onProgress) => {
+  const out = output ?? "json";
+  if (out === "stream") {
+    return response2.body;
+  }
+  if (onProgress && response2.body) {
+    const total = Number(response2.headers.get("Content-Length")) || 0;
+    let loaded = 0;
+    const reader = response2.body.getReader();
+    const chunks = [];
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      chunks.push(value);
+      loaded += value.length;
+      onProgress({
+        loaded,
+        total,
+        percent: total ? Math.round(loaded / total * 100) : 0
+      });
+    }
+    const blob = new Blob(chunks);
+    if (out === "blob") return blob;
+    if (out === "arrayBuffer")
+      return await blob.arrayBuffer();
+    if (out === "text") return await blob.text();
+    const text2 = await blob.text();
+    return text2 ? JSON.parse(text2) : null;
+  }
+  if (out === "blob")
+    return await response2.blob();
+  if (out === "arrayBuffer")
+    return await response2.arrayBuffer();
+  if (out === "text")
+    return await response2.text();
+  const text = await response2.text();
+  return text ? JSON.parse(text) : null;
+};
+
+// src/shared/api/domain.ts
+var config = { baseUrl: "" };
+var configure = (c) => {
+  config = c;
+};
+var configHeaders = async () => {
+  if (!config.headers) return {};
+  return typeof config.headers === "function" ? await config.headers() : config.headers;
+};
+var request = async (method, path, options, defaultInput) => {
+  const opts = options;
+  const url = prepareUrl(path, {
+    baseUrl: config.baseUrl,
+    ...opts?.params ? { params: opts.params } : {}
+  });
+  const rawBody = opts?.body;
+  const isAutoDetect = rawBody instanceof FormData || rawBody instanceof Blob;
+  const input = opts && "input" in opts && opts.input !== void 0 ? opts.input : isAutoDetect ? void 0 : defaultInput;
+  const headersOption = opts?.headers;
+  const isExternal = isAbsolute(path);
+  const defaults = headersOption !== false && !isExternal ? await configHeaders() : {};
+  const headers = await prepareHeaders({
+    defaults,
+    headersOption,
+    input,
+    body: rawBody
+  });
+  const body = prepareBody(rawBody, input);
+  const response2 = await fetch(url, {
+    method,
+    ...headers && { headers },
+    ...body !== void 0 && { body },
+    ...opts?.signal && { signal: opts.signal }
+  });
+  if (!response2.ok) {
+    const error2 = new RestError({
+      status: response2.status,
+      body: await response2.text()
+    });
+    if (opts?.onError) return opts.onError(error2);
+    throw error2;
+  }
+  const data = await parseResponse(
+    response2,
+    opts?.output,
+    opts?.onProgress
+  );
+  return opts?.onSuccess ? opts.onSuccess(data) : data;
+};
+function get(path, opts) {
+  return request(
+    "GET",
+    path,
+    opts
+  );
+}
+function post(path, body, opts) {
+  return request(
+    "POST",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function put(path, body, opts) {
+  return request(
+    "PUT",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function patch(path, body, opts) {
+  return request(
+    "PATCH",
+    path,
+    { ...opts, body },
+    "json"
+  );
+}
+function remove(path, body, opts) {
+  const defaultInput = body !== void 0 ? "json" : void 0;
+  return request(
+    "DELETE",
+    path,
+    { ...opts, body },
+    defaultInput
+  );
+}
+
 // src/server/file/index.ts
 var file_exports = {};
 __export(file_exports, {
@@ -768,7 +984,7 @@ __export(ddb_exports, {
   lsiNormalized: () => lsiNormalized,
   lsiPhash: () => lsiPhash,
   lsiUsername: () => lsiUsername,
-  remove: () => remove,
+  remove: () => remove2,
   save: () => save,
   tableExists: () => tableExists
 });
@@ -1057,7 +1273,7 @@ async function find(ddb, props) {
     throw err;
   }
 }
-var remove = async (ddb, props) => {
+var remove2 = async (ddb, props) => {
   const TableName = getTableNameOrThrow(props.tableName, ddb.tableName);
   const command = new DeleteCommand({ Key: props.key, TableName });
   return ddb.client.send(command);
@@ -1635,4 +1851,4 @@ var recordsFromSqs = (body) => {
   }
 };
 
-export { ddb_exports as DDB, dict_exports as Dict, file_exports as File, flow_exports as Flow, int_exports as Int, lambda_exports as Lambda, list_exports as List, log_exports as Log, money_exports as Money, random_exports as Random, s3_exports as S3, ses_exports as SES, sns_exports as SNS, sqs_exports as SQS, str_exports as Str, time_exports as Time };
+export { api_exports as Api, ddb_exports as DDB, dict_exports as Dict, file_exports as File, flow_exports as Flow, int_exports as Int, lambda_exports as Lambda, list_exports as List, log_exports as Log, money_exports as Money, random_exports as Random, s3_exports as S3, ses_exports as SES, sns_exports as SNS, sqs_exports as SQS, str_exports as Str, time_exports as Time };

package/dist/shared/api/domain.d.ts

@@ -0,0 +1,181 @@
+import type { BodylessOptions, Config, DataForOutput, JsonRes, Options, Output, ReqFrom, ResFrom } from "./types";
+/**
+ * Configure the API client with base URL and default headers.
+ *
+ * Call this once at app startup before making any requests. The headers
+ * option can be a static object or an async function that returns headers,
+ * useful for dynamic auth tokens that refresh periodically.
+ *
+ * @example
+ * ```ts
+ * // Static headers
+ * Api.configure({
+ *   baseUrl: "https://api.example.com",
+ *   headers: { "X-API-Key": "secret" },
+ * });
+ *
+ * // Dynamic headers (called fresh on each request)
+ * Api.configure({
+ *   baseUrl: import.meta.env.VITE_API_URL,
+ *   headers: async () => ({
+ *     Authorization: `Bearer ${await getAuthToken()}`,
+ *   }),
+ * });
+ * ```
+ */
+export declare const configure: (c: Config) => void;
+/**
+ * Make a GET request to fetch data.
+ *
+ * GET requests don't have a body. Use `params` for query parameters.
+ * Response is parsed as JSON by default; use `output` for other formats.
+ *
+ * Notes:
+ * - Generics are compile-time only; `output` is what decides runtime decoding.
+ * - The return type is derived from `output` (e.g. `output: "blob"` returns `Blob`).
+ * - If you try to use a non-JSON decoded response type (like `Blob`) without setting
+ *   `output`, TypeScript will raise a helpful error type to prevent mismatches.
+ *
+ * If the response is not ok, this throws a `RestError` unless you provide
+ * an `onError` handler to convert the error into a return value.
+ *
+ * @example
+ * ```ts
+ * // Simple GET
+ * const users = await Api.get<User[]>("/users");
+ *
+ * // With query params
+ * const users = await Api.get<User[]>("/users", {
+ *   params: { limit: 10, status: "active" },
+ * });
+ * // → GET /users?limit=10&status=active
+ *
+ * // Transform response
+ * const names = await Api.get("/users", {
+ *   onSuccess: (users: User[]) => users.map(u => u.name),
+ * });
+ *
+ * // Download as blob
+ * const image = await Api.get("/avatar.png", { output: "blob" });
+ * ```
+ *
+ * @throws {RestError} When the response is not ok and no `onError` handler is provided.
+ */
+export declare function get<TTypes = unknown, O extends Output | undefined = undefined, Return = unknown>(path: string, opts: Options<JsonRes<ResFrom<TTypes>>, Return, O> & {
+    onSuccess: (data: DataForOutput<JsonRes<ResFrom<TTypes>>, O>) => Return;
+}): Promise<Return>;
+export declare function get<TTypes = unknown, O extends Output | undefined = undefined, Return = never>(path: string, opts?: Options<JsonRes<ResFrom<TTypes>>, Return, O> & {
+    onSuccess?: undefined;
+}): Promise<DataForOutput<JsonRes<ResFrom<TTypes>>, O> | Return>;
+/**
+ * Make a POST request to create a resource.
+ *
+ * Body handling:
+ * - Objects are JSON-serialized by default (Content-Type: application/json)
+ * - FormData is auto-detected (browser sets Content-Type with boundary)
+ * - Blob is auto-detected (uses blob.type for Content-Type)
+ * - Use `input` option to override: "json" | "form" | "text"
+ *
+ * Notes:
+ * - Use named type-args to type both request and response:
+ *   `Api.post<{ Req: CreateReq; Res: CreateRes }>(...)`
+ * - `output` controls runtime decoding and therefore the return type.
+ *
+ * If the response is not ok, this throws a `RestError` unless you provide
+ * an `onError` handler to convert the error into a return value.
+ *
+ * @example
+ * ```ts
+ * // JSON body (default for objects)
+ * const user = await Api.post<User>("/users", { name: "Alice" });
+ *
+ * // FormData auto-detected
+ * const result = await Api.post("/upload", formData);
+ *
+ * // External URL (never includes configured default headers like auth)
+ * await Api.post(presignedUrl, formData);
+ * ```
+ *
+ * @throws {RestError} When the response is not ok and no `onError` handler is provided.
+ */
+export declare function post<TTypes = unknown, O extends Output | undefined = undefined, Return = unknown>(path: string, body: ReqFrom<TTypes>, opts: BodylessOptions<ReqFrom<TTypes>, JsonRes<ResFrom<TTypes>>, Return, O> & {
+    onSuccess: (data: DataForOutput<JsonRes<ResFrom<TTypes>>, O>) => Return;
+}): Promise<Return>;
+export declare function post<TTypes = unknown, O extends Output | undefined = undefined, Return = never>(path: string, body?: ReqFrom<TTypes>, opts?: BodylessOptions<ReqFrom<TTypes>, JsonRes<ResFrom<TTypes>>, Return, O> & {
+    onSuccess?: undefined;
+}): Promise<DataForOutput<JsonRes<ResFrom<TTypes>>, O> | Return>;
+/**
+ * Make a PUT request to replace a resource.
+ *
+ * Body is JSON-serialized by default. See `post` for `input` options.
+ *
+ * If the response is not ok, this throws a `RestError` unless you provide
+ * an `onError` handler to convert the error into a return value.
+ *
+ * @example
+ * ```ts
+ * const user = await Api.put<User>(`/users/${id}`, {
+ *   name: "Alice",
+ *   email: "alice@example.com",
+ * });
+ * ```
+ *
+ * @throws {RestError} When the response is not ok and no `onError` handler is provided.
+ */
+export declare function put<TTypes = unknown, O extends Output | undefined = undefined, Return = unknown>(path: string, body: ReqFrom<TTypes>, opts: BodylessOptions<ReqFrom<TTypes>, JsonRes<ResFrom<TTypes>>, Return, O> & {
+    onSuccess: (data: DataForOutput<JsonRes<ResFrom<TTypes>>, O>) => Return;
+}): Promise<Return>;
+export declare function put<TTypes = unknown, O extends Output | undefined = undefined, Return = never>(path: string, body?: ReqFrom<TTypes>, opts?: BodylessOptions<ReqFrom<TTypes>, JsonRes<ResFrom<TTypes>>, Return, O> & {
+    onSuccess?: undefined;
+}): Promise<DataForOutput<JsonRes<ResFrom<TTypes>>, O> | Return>;
+/**
+ * Make a PATCH request to partially update a resource.
+ *
+ * Body is JSON-serialized by default. See `post` for `input` options.
+ *
+ * If the response is not ok, this throws a `RestError` unless you provide
+ * an `onError` handler to convert the error into a return value.
+ *
+ * @example
+ * ```ts
+ * const user = await Api.patch<User>(`/users/${id}`, { name: "New Name" });
+ * ```
+ *
+ * @throws {RestError} When the response is not ok and no `onError` handler is provided.
+ */
+export declare function patch<TTypes = unknown, O extends Output | undefined = undefined, Return = unknown>(path: string, body: ReqFrom<TTypes>, opts: BodylessOptions<ReqFrom<TTypes>, JsonRes<ResFrom<TTypes>>, Return, O> & {
+    onSuccess: (data: DataForOutput<JsonRes<ResFrom<TTypes>>, O>) => Return;
+}): Promise<Return>;
+export declare function patch<TTypes = unknown, O extends Output | undefined = undefined, Return = never>(path: string, body?: ReqFrom<TTypes>, opts?: BodylessOptions<ReqFrom<TTypes>, JsonRes<ResFrom<TTypes>>, Return, O> & {
+    onSuccess?: undefined;
+}): Promise<DataForOutput<JsonRes<ResFrom<TTypes>>, O> | Return>;
+/**
+ * Make a DELETE request to remove a resource.
+ *
+ * Supports an optional body for batch deletes or similar use cases.
+ * Body is JSON-serialized by default when provided.
+ *
+ * If the response is not ok, this throws a `RestError` unless you provide
+ * an `onError` handler to convert the error into a return value.
+ *
+ * @example
+ * ```ts
+ * // Simple delete
+ * await Api.remove(`/users/${id}`);
+ *
+ * // With confirmation response
+ * const result = await Api.remove<{ deleted: boolean }>(`/users/${id}`);
+ *
+ * // Batch delete with body
+ * await Api.remove("/users", { ids: ["1", "2", "3"] });
+ * ```
+ *
+ * @throws {RestError} When the response is not ok and no `onError` handler is provided.
+ */
+export declare function remove<TTypes = unknown, O extends Output | undefined = undefined, Return = unknown>(path: string, body: ReqFrom<TTypes>, opts: BodylessOptions<ReqFrom<TTypes>, JsonRes<ResFrom<TTypes>>, Return, O> & {
+    onSuccess: (data: DataForOutput<JsonRes<ResFrom<TTypes>>, O>) => Return;
+}): Promise<Return>;
+export declare function remove<TTypes = unknown, O extends Output | undefined = undefined, Return = never>(path: string, body?: ReqFrom<TTypes>, opts?: BodylessOptions<ReqFrom<TTypes>, JsonRes<ResFrom<TTypes>>, Return, O> & {
+    onSuccess?: undefined;
+}): Promise<DataForOutput<JsonRes<ResFrom<TTypes>>, O> | Return>;
+//# sourceMappingURL=domain.d.ts.map