qstd 0.3.26 → 0.3.27

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

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/shared/api/domain.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,140 @@
+import * as _t from "./types";
+/**
+ * Detect whether a request path is an absolute URL (external request).
+ *
+ * This module's domain layer uses this check to decide when **not** to apply
+ * app-configured defaults (like `baseUrl` and auth headers). That protects us
+ * from accidentally leaking credentials to third-party URLs (e.g. S3 presigned
+ * uploads, CDN downloads).
+ *
+ * Note: This is intentionally simple (`startsWith("http")`) because the only
+ * "external" URLs we care about are `http://` and `https://` fetch targets.
+ *
+ * @example
+ * ```ts
+ * isAbsolute("/users");                // false
+ * isAbsolute("https://example.com");   // true
+ * isAbsolute("http://localhost:8787"); // true
+ * ```
+ */
+export declare const isAbsolute: (path: string) => boolean;
+/**
+ * Build the final request URL from a path, a `baseUrl`, and optional query params.
+ *
+ * The app calls the API client with "internal" paths like `/entries` and expects
+ * the module to consistently:
+ * - Prefix `baseUrl` for internal paths
+ * - Leave absolute URLs untouched (for presigned URLs, third-party services)
+ * - Encode query params safely and skip `null`/`undefined` values
+ *
+ * Centralizing this avoids scattered string-concatenation bugs and keeps request
+ * construction consistent across the app.
+ *
+ * @example
+ * ```ts
+ * prepareUrl("/users", {
+ *   baseUrl: "https://api.example.com",
+ *   params: { limit: 10, q: "alice", includeInactive: false, empty: null },
+ * });
+ * // "https://api.example.com/users?limit=10&q=alice&includeInactive=false"
+ *
+ * prepareUrl("https://s3.amazonaws.com/bucket/key", { baseUrl: "ignored" });
+ * // "https://s3.amazonaws.com/bucket/key"
+ * ```
+ */
+export declare const prepareUrl: (path: string, props: {
+    baseUrl: string;
+    params?: _t.Params;
+}) => string;
+/**
+ * Produce the final request headers for a fetch call.
+ *
+ * This helper exists to keep `domain.ts` readable while enforcing a few
+ * non-obvious rules that prevent subtle integration bugs:
+ * - `headers: false` means **no headers at all** (escape hatch)
+ * - `FormData` must NOT set `Content-Type` (browser adds the multipart boundary)
+ * - `Blob` should use `blob.type` when present
+ * - `input: "json"`/`"text"` set the appropriate `Content-Type`
+ * - A header transform function can layer on top of module defaults
+ *
+ * Returning `undefined` (instead of `{}`) is intentional: it allows the caller
+ * to omit the `headers` field entirely in `fetch(...)`.
+ *
+ * @example
+ * ```ts
+ * // Default JSON request
+ * await prepareHeaders({
+ *   defaults: { Authorization: "Bearer token" },
+ *   headersOption: true,
+ *   input: "json",
+ *   body: { hello: "world" },
+ * });
+ * // { Authorization: "...", "Content-Type": "application/json" }
+ *
+ * // Escape hatch: no headers at all
+ * await prepareHeaders({
+ *   defaults: { Authorization: "Bearer token" },
+ *   headersOption: false,
+ *   input: "json",
+ *   body: { hello: "world" },
+ * });
+ * // undefined
+ * ```
+ */
+export declare const prepareHeaders: (props: {
+    defaults: _t.HeadersObject;
+    headersOption: true | false | _t.HeadersTransform | undefined;
+    input: _t.Input | undefined;
+    body: unknown;
+}) => Promise<_t.HeadersObject | undefined>;
+/**
+ * Convert a user-supplied body into a `fetch`-compatible `BodyInit`.
+ *
+ * The API client accepts `unknown` bodies to support multiple request styles
+ * (JSON APIs, multipart uploads, plain text payloads). This helper centralizes
+ * serialization rules so callers don't have to remember when to `JSON.stringify`
+ * or how to build `FormData`.
+ *
+ * @throws When `input: "text"` is specified but `body` is not a string.
+ *
+ * @example
+ * ```ts
+ * prepareBody({ a: 1 }, "json"); // '{"a":1}'
+ * prepareBody("hello", "text"); // "hello"
+ *
+ * // Convert a plain object to FormData
+ * const fd = prepareBody({ file, title: "cover" }, "form");
+ * fd instanceof FormData; // true
+ * ```
+ */
+export declare const prepareBody: (body: unknown, input: _t.Input | undefined) => BodyInit | undefined;
+/**
+ * Parse a `fetch` response into the configured output type.
+ *
+ * Why this exists:
+ * - Most app endpoints are JSON, but uploads/downloads need `blob`, `arrayBuffer`,
+ *   or raw streaming bodies.
+ * - Progress reporting for downloads requires manually reading the response
+ *   stream. When `onProgress` is provided, we buffer the response to compute
+ *   `loaded/total/percent`.
+ *
+ * Notes:
+ * - For `output: "json"`, an empty response body returns `null`.
+ * - For `output: "stream"`, we return `response.body` (no buffering/parsing).
+ *
+ * @example
+ * ```ts
+ * const data = await parseResponse<{ id: string }>(response, "json");
+ *
+ * const blob = await parseResponse<Blob>(response, "blob", (p) => {
+ *   console.log(p.percent);
+ * });
+ *
+ * const stream = await parseResponse<ReadableStream<Uint8Array> | null>(
+ *   response,
+ *   "stream"
+ * );
+ * ```
+ */
+export declare const parseResponse: <Res, O extends _t.Output | undefined = undefined>(response: Response, output?: O, onProgress?: (progress: _t.Progress) => void) => Promise<_t.DataForOutput<Res, O>>;
+//# sourceMappingURL=fns.d.ts.map

package/dist/shared/api/fns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fns.d.ts","sourceRoot":"","sources":["../../../src/shared/api/fns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAwB9B;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,YAA4B,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EACZ,OAAO;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAA;CAAE,KAC7C,MA+BF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,cAAc,GAAU,OAAO;IAC1C,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC;IAC3B,aAAa,EAAE,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAC9D,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC;CACf,KAAG,OAAO,CAAC,EAAE,CAAC,aAAa,GAAG,SAAS,CA6BvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,OAAO,EACb,OAAO,EAAE,CAAC,KAAK,GAAG,SAAS,KAC1B,QAAQ,GAAG,SAuBb,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,aAAa,GACxB,GAAG,EACH,CAAC,SAAS,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,SAAS,EAE3C,UAAU,QAAQ,EAClB,SAAS,CAAC,EACV,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,IAAI,KAC3C,OAAO,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,CAiDlC,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * REST API client module for making HTTP requests.
+ *
+ * This module wraps fetch with sensible defaults and type-safe options.
+ * It eliminates boilerplate: base URL handling, JSON serialization,
+ * Content-Type headers, error parsing, and response transformation.
+ *
+ * ### Types vs runtime decoding (important)
+ * - **Generics (`Req`/`Res`) are compile-time only** (they do not exist at runtime).
+ * - The **`output` option is runtime** and controls how we decode the `Response`:
+ *   - default / `"json"` → `response.text()` then `JSON.parse(...)`
+ *   - `"blob"` → `response.blob()`
+ *   - `"arrayBuffer"` → `response.arrayBuffer()`
+ *   - `"stream"` → `response.body`
+ *
+ * The return type is derived from `output`. If you try to use a non-JSON response
+ * type (like `Blob`) without setting `output`, TypeScript will surface a helpful
+ * error type to prevent "type says blob, runtime parses JSON" bugs.
+ *
+ * Body types are auto-detected:
+ * - Objects → JSON (Content-Type: application/json)
+ * - FormData → multipart (browser sets Content-Type with boundary)
+ * - Blob → uses blob.type for Content-Type
+ *
+ * @example
+ * ```ts
+ * // Configure once at app startup
+ * Api.configure({
+ *   baseUrl: import.meta.env.VITE_API_URL,
+ *   headers: () => ({ Authorization: `Bearer ${getToken()}` }),
+ * });
+ *
+ * // GET (JSON)
+ * const users = await Api.get<User[]>("/users"); // legacy shorthand
+ * const users2 = await Api.get<{ Res: User[] }>("/users"); // named type-args
+ *
+ * // POST (typed body + typed JSON response)
+ * const user = await Api.post<{ Req: { name: string }; Res: User }>(
+ *   "/users",
+ *   { name: "Alice" }
+ * );
+ *
+ * // Download (non-JSON) — use `output` (return type follows `output`)
+ * const image = await Api.get("/avatar.png", { output: "blob" }); // Blob
+ *
+ * // POST FormData (auto-detected)
+ * await Api.post("/upload", formData);
+ *
+ * // External URL (never includes configured default headers like auth)
+ * await Api.post(s3PresignedUrl, formData);
+ * ```
+ */
+export { RestError } from "./types";
+export type * from "./types";
+export * from "./domain";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,mBAAmB,SAAS,CAAC;AAC7B,cAAc,UAAU,CAAC"}

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

@@ -0,0 +1,102 @@
+export type Method = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export declare class RestError extends Error {
+    status: number;
+    body: string;
+    constructor(props: {
+        status: number;
+        body: string;
+    });
+}
+export type HeadersObject = Record<string, string>;
+export type HeadersGetter = () => HeadersObject | Promise<HeadersObject>;
+export type HeadersTransform = (defaults: HeadersObject) => HeadersObject | Promise<HeadersObject>;
+export type Config = {
+    baseUrl: string;
+    headers?: HeadersObject | HeadersGetter;
+};
+export type Params = Record<string, string | number | boolean | undefined | null>;
+export type Input = "json" | "form" | "text";
+export type Output = "json" | "text" | "blob" | "stream" | "arrayBuffer";
+/**
+ * Named generic type-args for API calls.
+ *
+ * This enables patterns like:
+ * - `Api.post<{ Req: CreateUser; Res: User }>("/users", body)`
+ * - `Api.post<{ Req: CreateUser }>("/users", body)` (response defaults to `unknown`)
+ * - `Api.get<{ Res: User[] }>("/users")`
+ *
+ * Calls can still use the legacy shorthand `Api.get<User[]>()` / `Api.post<User>()`
+ * where the generic is treated as the JSON response type.
+ *
+ * Important: these type arguments are compile-time only. For non-JSON responses
+ * (blob/arrayBuffer/stream), use the runtime `output` option (the return type
+ * is derived from `output`).
+ */
+export type TypeArgs = {
+    Req?: unknown;
+    Res?: unknown;
+};
+type IsTypeArgs<T> = T extends object ? "Req" extends keyof T ? true : "Res" extends keyof T ? true : false : false;
+/** Extract request/body type from either `TypeArgs` or legacy shorthand. */
+export type ReqFrom<T> = IsTypeArgs<T> extends true ? T extends {
+    Req?: infer Req;
+} ? Req : unknown : unknown;
+/** Extract JSON response type from either `TypeArgs` or legacy shorthand. */
+export type ResFrom<T> = IsTypeArgs<T> extends true ? "Res" extends keyof T ? T extends {
+    Res?: infer Res;
+} ? Res : unknown : unknown : T;
+/**
+ * Map the runtime `output` option to the parsed value type.
+ *
+ * - `output: "json"` (or omitted) → `Res`
+ * - `output: "blob"` → `Blob`
+ * - etc.
+ *
+ * This makes `output` the single source of truth for non-JSON response shapes,
+ * while `Res` describes the JSON-decoded shape when `output` is omitted/`"json"`.
+ */
+export type DataForOutput<Res, O extends Output | undefined> = O extends "text" ? string : O extends "blob" ? Blob : O extends "stream" ? ReadableStream<Uint8Array> | null : O extends "arrayBuffer" ? ArrayBuffer : Res;
+/**
+ * Types that cannot be produced by JSON parsing and therefore require an explicit `output`.
+ *
+ * (We intentionally do NOT include `string` here because JSON can legitimately parse to a
+ * string, e.g. `"hello"`.)
+ */
+export type NonJsonDecoded = Blob | ArrayBuffer | ReadableStream<Uint8Array>;
+/**
+ * A helpful compile-time error shape when a non-JSON decoded type is requested without
+ * specifying the matching `output` option.
+ */
+export type OutputRequiredError = {
+    __api_output_required: "Set opts.output to 'blob' | 'arrayBuffer' | 'stream' (or use the default JSON output).";
+};
+/** If `Res` contains a non-JSON decoded type, replace it with an error helper type. */
+export type JsonRes<Res> = [Extract<Res, NonJsonDecoded>] extends [never] ? Res : OutputRequiredError;
+export type Progress = {
+    loaded: number;
+    total: number;
+    percent: number;
+};
+export type Options<Res, Return = Res, O extends Output | undefined = undefined> = {
+    headers?: true | false | HeadersTransform;
+    params?: Params;
+    output?: O;
+    signal?: AbortSignal;
+    onProgress?: (progress: Progress) => void;
+    onSuccess?: (data: DataForOutput<Res, O>) => Return;
+    onError?: (error: RestError) => Return;
+};
+export type BodyOptions<Req = unknown, Res = unknown, Return = Res, O extends Output | undefined = undefined> = {
+    body?: Req;
+    input?: Input;
+    headers?: true | false | HeadersTransform;
+    params?: Params;
+    output?: O;
+    signal?: AbortSignal;
+    onProgress?: (progress: Progress) => void;
+    onSuccess?: (data: DataForOutput<Res, O>) => Return;
+    onError?: (error: RestError) => Return;
+};
+export type BodylessOptions<Req = unknown, Res = unknown, Return = Res, O extends Output | undefined = undefined> = Omit<BodyOptions<Req, Res, Return, O>, "body">;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/api/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAMjE,qBAAa,SAAU,SAAQ,KAAK;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;gBAED,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAMpD;AAMD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACnD,MAAM,MAAM,aAAa,GAAG,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AACzE,MAAM,MAAM,gBAAgB,GAAG,CAC7B,QAAQ,EAAE,aAAa,KACpB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,GAAG,aAAa,CAAC;CACzC,CAAC;AAMF,MAAM,MAAM,MAAM,GAAG,MAAM,CACzB,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAC7C,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7C,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;AAMzE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACjC,KAAK,SAAS,MAAM,CAAC,GACnB,IAAI,GACJ,KAAK,SAAS,MAAM,CAAC,GACnB,IAAI,GACJ,KAAK,GACT,KAAK,CAAC;AAEV,4EAA4E;AAC5E,MAAM,MAAM,OAAO,CAAC,CAAC,IACnB,UAAU,CAAC,CAAC,CAAC,SAAS,IAAI,GACtB,CAAC,SAAS;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAA;CAAE,GAC3B,GAAG,GACH,OAAO,GACT,OAAO,CAAC;AAEd,6EAA6E;AAC7E,MAAM,MAAM,OAAO,CAAC,CAAC,IACnB,UAAU,CAAC,CAAC,CAAC,SAAS,IAAI,GACtB,KAAK,SAAS,MAAM,CAAC,GACnB,CAAC,SAAS;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAA;CAAE,GAC3B,GAAG,GACH,OAAO,GACT,OAAO,GACT,CAAC,CAAC;AAER;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,SAAS,MAAM,GAAG,SAAS,IAAI,CAAC,SAAS,MAAM,GAC3E,MAAM,GACN,CAAC,SAAS,MAAM,GACd,IAAI,GACJ,CAAC,SAAS,QAAQ,GAChB,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,GACjC,CAAC,SAAS,aAAa,GACrB,WAAW,GACX,GAAG,CAAC;AAEd;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;AAE7E;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,qBAAqB,EAAE,wFAAwF,CAAC;CACjH,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACrE,GAAG,GACH,mBAAmB,CAAC;AAExB,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAMF,MAAM,MAAM,OAAO,CACjB,GAAG,EACH,MAAM,GAAG,GAAG,EACZ,CAAC,SAAS,MAAM,GAAG,SAAS,GAAG,SAAS,IACtC;IACF,OAAO,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,gBAAgB,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC1C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,MAAM,CAAC;CACxC,CAAC;AAYF,MAAM,MAAM,WAAW,CACrB,GAAG,GAAG,OAAO,EACb,GAAG,GAAG,OAAO,EACb,MAAM,GAAG,GAAG,EACZ,CAAC,SAAS,MAAM,GAAG,SAAS,GAAG,SAAS,IACtC;IACF,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,gBAAgB,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC1C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,MAAM,CAAC;CACxC,CAAC;AAMF,MAAM,MAAM,eAAe,CACzB,GAAG,GAAG,OAAO,EACb,GAAG,GAAG,OAAO,EACb,MAAM,GAAG,GAAG,EACZ,CAAC,SAAS,MAAM,GAAG,SAAS,GAAG,SAAS,IACtC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qstd",
-  "version": "0.3.26",
+  "version": "0.3.27",
   "description": "Standard Block component and utilities library with Panda CSS",
   "author": "malin1",
   "license": "MIT",