@resq-sw/http 0.1.0

package/README.md

@@ -0,0 +1,161 @@
+# @resq-sw/http
+
+> Effect-based HTTP client with retry, timeout, schema validation, and security middleware.
+
+## Installation
+
+```bash
+bun add @resq-sw/http effect
+```
+
+Peer dependency: `effect`.
+
+## Quick Start
+
+```ts
+import { get, post } from "@resq-sw/http";
+import { Effect } from "effect";
+import { HttpClient } from "effect/unstable/http";
+
+const program = Effect.gen(function* () {
+  const users = yield* get<User[]>("/api/users");
+  const created = yield* post<User>("/api/users", { name: "Alice" });
+  return { users, created };
+});
+
+// Run with the default HTTP client
+Effect.runPromise(program.pipe(Effect.provide(HttpClient.layer)));
+```
+
+## API Reference
+
+### `fetcher(url, method?, options?, params?, body?)`
+
+Core HTTP function. All convenience methods delegate to this.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `url` | `string` | required | URL path or absolute URL |
+| `method` | `HttpMethod` | `"GET"` | HTTP method |
+| `options` | `FetcherOptions<T>` | `{}` | Request options |
+| `params` | `QueryParams` | -- | Query parameters |
+| `body` | `RequestBody` | -- | Request body (POST/PUT/PATCH only) |
+
+Returns `Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>`.
+
+URL resolution: absolute URLs are used as-is; relative paths are prefixed with `VITE_SITE_URL`, `SITE_URL`, or `http://localhost:5173`.
+
+### FetcherOptions
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `retries` | `number` | `0` | Retry count on failure |
+| `retryDelay` | `number` | `1000` | Base delay between retries (exponential backoff) |
+| `timeout` | `number` | `10000` | Request timeout in ms |
+| `headers` | `Record<string, string>` | `{}` | Additional request headers |
+| `schema` | `Schema.Schema<T>` | -- | Effect Schema for response validation |
+| `onError` | `(error: unknown) => void` | -- | Error callback |
+| `signal` | `AbortSignal` | -- | Abort signal |
+| `bodyType` | `"json" \| "text" \| "form"` | `"json"` | Request body encoding |
+
+### Retry Behavior
+
+- Uses exponential backoff starting from `retryDelay`.
+- **Always retries**: 429 (rate limit), 5xx, network errors, timeouts.
+- **Never retries**: validation errors, 4xx (except 429).
+
+### Convenience Methods
+
+All return `Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>`.
+
+| Function | Signature |
+|----------|-----------|
+| `get` | `(url, options?, params?) => Effect` |
+| `post` | `(url, body?, options?, params?) => Effect` |
+| `put` | `(url, body?, options?, params?) => Effect` |
+| `patch` | `(url, body?, options?, params?) => Effect` |
+| `del` | `(url, options?, params?) => Effect` |
+| `options` | `(url, options?, params?) => Effect` |
+| `head` | `(url, options?, params?) => Effect` |
+
+All methods support schema overloads for compile-time type safety:
+
+```ts
+import { Schema } from "effect";
+
+const UserSchema = Schema.Struct({ id: Schema.Number, name: Schema.String });
+
+const user = get("/api/users/1", { schema: UserSchema });
+// Type: Effect<{ id: number; name: string }, ...>
+```
+
+### Schema Helpers
+
+#### `createPaginatedSchema(itemSchema)`
+
+Creates a schema for paginated API responses.
+
+```ts
+const PagedUsers = createPaginatedSchema(UserSchema);
+// { data: User[], pagination: { page, pageSize, total, totalPages } }
+```
+
+#### `createApiResponseSchema(dataSchema)`
+
+Creates a schema for standard API responses.
+
+```ts
+const ApiUser = createApiResponseSchema(UserSchema);
+// { success: boolean, data: User, message?: string, errors?: string[] }
+```
+
+### Error Types
+
+#### `FetcherError`
+
+Thrown on network errors, timeouts, and non-2xx responses.
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `message` | `string` | Error description |
+| `url` | `string` | Request URL |
+| `status` | `number?` | HTTP status code |
+| `responseData` | `unknown?` | Response body if available |
+| `attempt` | `number?` | Retry attempt number |
+
+#### `FetcherValidationError`
+
+Thrown when response data fails schema validation.
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `message` | `string` | Error description |
+| `url` | `string` | Request URL |
+| `problems` | `string` | Schema validation errors |
+| `responseData` | `unknown` | Raw response data |
+| `attempt` | `number?` | Retry attempt number |
+
+### Security Utilities
+
+#### `shouldRedirectToHttps(protocol, url, headers, nodeEnv?): string | null`
+
+Checks if a request should be redirected to HTTPS. Handles proxy headers (`x-forwarded-proto`, `x-forwarded-ssl`). Returns the HTTPS URL or `null`.
+
+- Skipped in `development` and `test` environments.
+
+```ts
+const redirect = shouldRedirectToHttps("http", req.url, req.headers);
+if (redirect) return Response.redirect(redirect, 301);
+```
+
+#### `getRequestId(existingId?): string`
+
+Returns the existing request ID or generates a new UUID.
+
+```ts
+const reqId = getRequestId(headers["x-request-id"]);
+```
+
+## License
+
+Apache-2.0

package/lib/fetcher.d.mts

@@ -0,0 +1,134 @@
+import { Effect, Schema } from "effect";
+import { HttpClient } from "effect/unstable/http";
+
+//#region src/fetcher.d.ts
+/**
+ * A Schema with DecodingServices constrained to `never`, allowing synchronous decoding.
+ * All standard built-in schemas (e.g. `Schema.Struct(...)`) satisfy this constraint.
+ */
+type SyncSchema<T> = Schema.Schema<T> & {
+  readonly DecodingServices: never;
+};
+/**
+ * Configuration options for the fetcher utility.
+ */
+interface FetcherOptions<T = unknown> {
+  /** Number of times to retry the request on failure */
+  retries?: number;
+  /** Delay in milliseconds between retries */
+  retryDelay?: number;
+  /** Optional callback invoked on error */
+  onError?: (error: unknown) => void;
+  /** Timeout in milliseconds for the request */
+  timeout?: number;
+  /** Additional headers to include in the request */
+  headers?: Record<string, string>;
+  /** Effect/Schema for runtime validation of the response */
+  schema?: SyncSchema<T>;
+  /** Abortsignal */
+  signal?: AbortSignal;
+  /** Body type - defaults to 'json', use 'text' for raw data, 'form' for FormData */
+  bodyType?: 'json' | 'text' | 'form';
+}
+/**
+ * Represents all supported HTTP methods for the fetcher utility.
+ */
+type HttpMethod = Schema.Schema.Type<typeof HttpMethod>;
+/**
+ * Represents a type-safe map of query parameters.
+ * Each value can be a string, number, boolean, null, undefined, or an array of those types.
+ */
+type QueryParams = Schema.Schema.Type<typeof QueryParams>;
+/**
+ * Represents a type-safe request body for HTTP methods that support a body.
+ * Can be an object, array, string, number, boolean, or null.
+ */
+type RequestBody = Schema.Schema.Type<typeof RequestBody>;
+/**
+ * Represents HTTP headers as key-value string pairs.
+ */
+type Headers = Schema.Schema.Type<typeof Headers>;
+declare const HttpMethod: any;
+declare const QueryParams: Schema.Record$<Schema.Schema.All, Schema.Schema.All>;
+declare const RequestBody: typeof Schema.Any;
+declare const Headers: Schema.Record$<Schema.Schema.All, Schema.Schema.All>;
+/**
+ * Custom error class for validation-specific errors.
+ */
+declare class FetcherValidationError extends Error {
+  readonly url: string;
+  readonly problems: string;
+  readonly responseData: unknown;
+  readonly attempt?: number | undefined;
+  constructor(message: string, url: string, problems: string, responseData: unknown, attempt?: number | undefined);
+  [Symbol.toStringTag]: string;
+  toString(): string;
+  getProblemsString(): string;
+}
+/**
+ * Custom error class for fetcher-specific errors.
+ */
+declare class FetcherError extends Error {
+  readonly url: string;
+  readonly status?: number | undefined;
+  readonly responseData?: unknown | undefined;
+  readonly attempt?: number | undefined;
+  constructor(message: string, url: string, status?: number | undefined, responseData?: unknown | undefined, attempt?: number | undefined);
+  [Symbol.toStringTag]: string;
+  toString(): string;
+}
+declare function fetcher<T = unknown>(input: string, method?: 'GET', options?: FetcherOptions<T>, params?: QueryParams): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function fetcher<S extends SyncSchema<Schema.Schema.Type<S>>>(input: string, method: 'GET', options: FetcherOptions<Schema.Schema.Type<S>> & {
+  schema: S;
+}, params?: QueryParams): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function fetcher<T = unknown>(input: string, method: 'POST' | 'PUT' | 'PATCH', options?: FetcherOptions<T>, params?: QueryParams, body?: RequestBody): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function fetcher<S extends SyncSchema<Schema.Schema.Type<S>>>(input: string, method: 'POST' | 'PUT' | 'PATCH', options: FetcherOptions<Schema.Schema.Type<S>> & {
+  schema: S;
+}, params?: QueryParams, body?: RequestBody): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function fetcher<T = unknown>(input: string, method: 'DELETE' | 'OPTIONS' | 'HEAD', options?: FetcherOptions<T>, params?: QueryParams): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function get<T = unknown>(url: string, options?: FetcherOptions<T>, params?: QueryParams): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function get<A>(url: string, options: FetcherOptions<A> & {
+  schema: Schema.Schema<A>;
+}, params?: QueryParams): Effect.Effect<A, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function post<T = unknown>(url: string, body?: RequestBody, options?: FetcherOptions<T>, params?: QueryParams): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function post<S extends SyncSchema<Schema.Schema.Type<S>>>(url: string, body: RequestBody, options: FetcherOptions<Schema.Schema.Type<S>> & {
+  schema: S;
+}, params?: QueryParams): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function put<T = unknown>(url: string, body?: RequestBody, options?: FetcherOptions<T>, params?: QueryParams): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function put<S extends SyncSchema<Schema.Schema.Type<S>>>(url: string, body: RequestBody, options: FetcherOptions<Schema.Schema.Type<S>> & {
+  schema: S;
+}, params?: QueryParams): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function patch<T = unknown>(url: string, body?: RequestBody, options?: FetcherOptions<T>, params?: QueryParams): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function patch<S extends SyncSchema<Schema.Schema.Type<S>>>(url: string, body: RequestBody, options: FetcherOptions<Schema.Schema.Type<S>> & {
+  schema: S;
+}, params?: QueryParams): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function del<T = unknown>(url: string, options?: FetcherOptions<T>, params?: QueryParams): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function del<S extends SyncSchema<Schema.Schema.Type<S>>>(url: string, options: FetcherOptions<Schema.Schema.Type<S>> & {
+  schema: S;
+}, params?: QueryParams): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function options<T = unknown>(url: string, options?: FetcherOptions<T>, params?: QueryParams): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function options<S extends SyncSchema<Schema.Schema.Type<S>>>(url: string, options: FetcherOptions<Schema.Schema.Type<S>> & {
+  schema: S;
+}, params?: QueryParams): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function head<T = unknown>(url: string, options?: FetcherOptions<T>, params?: QueryParams): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare function head<S extends SyncSchema<Schema.Schema.Type<S>>>(url: string, options: FetcherOptions<Schema.Schema.Type<S>> & {
+  schema: S;
+}, params?: QueryParams): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;
+declare const createPaginatedSchema: <T>(itemSchema: Schema.Schema<T>) => Schema.Struct<{
+  data: Schema.Array$<Schema.Schema<T, T, never>>;
+  pagination: Schema.Struct<{
+    page: typeof Schema.Number;
+    pageSize: typeof Schema.Number;
+    total: typeof Schema.Number;
+    totalPages: typeof Schema.Number;
+  }>;
+}>;
+declare const createApiResponseSchema: <T>(dataSchema: Schema.Schema<T>) => Schema.Struct<{
+  success: typeof Schema.Boolean;
+  data: Schema.Schema<T, T, never>;
+  message: Schema.optional<typeof Schema.String>;
+  errors: Schema.optional<Schema.Array$<typeof Schema.String>>;
+}>;
+//#endregion
+export { FetcherError, FetcherOptions, FetcherValidationError, Headers, HttpMethod, QueryParams, RequestBody, createApiResponseSchema, createPaginatedSchema, del, fetcher, get, head, options, patch, post, put };
+//# sourceMappingURL=fetcher.d.mts.map

package/lib/fetcher.d.mts.map

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

package/lib/fetcher.mjs

@@ -0,0 +1,264 @@
+import { Cause, Duration, Effect, Exit, Schedule, Schema, pipe } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+//#region src/fetcher.ts
+/**
+* Copyright 2026 ResQ
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+const EMPTY = "";
+const safeStringify = (error) => {
+	if (error instanceof Error) return error.message;
+	try {
+		return JSON.stringify(error);
+	} catch {
+		return String(error);
+	}
+};
+/**
+* Get the base URL for API requests.
+*/
+const getBaseURL = () => {
+	if (globalThis.window !== void 0) return "";
+	if (process.env["VITE_SITE_URL"]) return process.env["VITE_SITE_URL"].replace(/\/+$/, "");
+	if (process.env["SITE_URL"]) return process.env["SITE_URL"].replace(/\/+$/, "");
+	return "http://localhost:5173";
+};
+Schema.Literals([
+	"GET",
+	"POST",
+	"PUT",
+	"PATCH",
+	"DELETE",
+	"OPTIONS",
+	"HEAD"
+]);
+Schema.Record(Schema.String, Schema.Union([
+	Schema.String,
+	Schema.Number,
+	Schema.Boolean,
+	Schema.Undefined,
+	Schema.Null,
+	Schema.Array(Schema.Union([
+		Schema.String,
+		Schema.Number,
+		Schema.Boolean
+	]))
+]));
+Schema.Any;
+Schema.Record(Schema.String, Schema.String);
+/**
+* Custom error class for validation-specific errors.
+*/
+var FetcherValidationError = class FetcherValidationError extends Error {
+	constructor(message, url, problems, responseData, attempt) {
+		super(message);
+		this.url = url;
+		this.problems = problems;
+		this.responseData = responseData;
+		this.attempt = attempt;
+		this.name = "FetcherValidationError";
+		Object.setPrototypeOf(this, FetcherValidationError.prototype);
+	}
+	[Symbol.toStringTag] = "FetcherValidationError";
+	toString() {
+		const attemptStr = this.attempt ? `, Attempt: ${this.attempt}` : "";
+		return `FetcherValidationError: ${this.message} (URL: ${this.url}${attemptStr})`;
+	}
+	getProblemsString() {
+		return this.problems;
+	}
+};
+/**
+* Custom error class for fetcher-specific errors.
+*/
+var FetcherError = class FetcherError extends Error {
+	constructor(message, url, status, responseData, attempt) {
+		super(message);
+		this.url = url;
+		this.status = status;
+		this.responseData = responseData;
+		this.attempt = attempt;
+		this.name = "FetcherError";
+		Object.setPrototypeOf(this, FetcherError.prototype);
+	}
+	[Symbol.toStringTag] = "FetcherError";
+	toString() {
+		const statusStr = this.status ? `, Status: ${this.status}` : "";
+		const attemptStr = this.attempt ? `, Attempt: ${this.attempt}` : "";
+		return `FetcherError: ${this.message} (URL: ${this.url}${statusStr}${attemptStr})`;
+	}
+};
+/**
+* Builds a query string from the provided query parameters.
+*/
+const buildQueryString = (params) => {
+	if (!params) return EMPTY;
+	const urlParams = new URLSearchParams();
+	Object.entries(params).forEach(([key, value]) => {
+		if (value == null) return;
+		if (Array.isArray(value)) value.filter((item) => item != null).forEach((item) => {
+			urlParams.append(key, String(item));
+		});
+		else urlParams.append(key, String(value));
+	});
+	return urlParams.toString();
+};
+/**
+* Builds a type-safe HttpClientRequest for the given method and URL.
+*/
+const buildRequest = (method, url) => {
+	switch (method) {
+		case "GET": return HttpClientRequest.get(url);
+		case "POST": return HttpClientRequest.post(url);
+		case "PUT": return HttpClientRequest.put(url);
+		case "PATCH": return HttpClientRequest.patch(url);
+		case "DELETE": return HttpClientRequest.delete(url);
+		case "OPTIONS": return HttpClientRequest.options(url);
+		case "HEAD": return HttpClientRequest.head(url);
+	}
+};
+/**
+* Validates response data using the provided Effect schema.
+*/
+const validateResponse = (data, attempt, url, schema, onError) => {
+	if (!schema) return Effect.succeed(data);
+	const result = Schema.decodeUnknownExit(schema)(data);
+	if (Exit.isFailure(result)) {
+		const schemaError = Cause.squash(result.cause);
+		const validationError = new FetcherValidationError("Response validation failed", url, schemaError instanceof Error ? schemaError.message : String(schemaError), data, attempt);
+		if (onError) onError(validationError);
+		return Effect.fail(validationError);
+	}
+	return Effect.succeed(result.value);
+};
+/**
+* Wraps an Effect with a timeout, converting timeout errors to FetcherError.
+*/
+const withTimeout = (eff, timeout, url, attempt) => Effect.timeoutOrElse(eff, {
+	duration: Duration.millis(timeout),
+	orElse: () => Effect.fail(new FetcherError("Request timed out", url, void 0, void 0, attempt))
+});
+/**
+* Type guard: narrows unknown to FetcherError.
+*/
+const isFetcherError = (error) => error instanceof FetcherError;
+/**
+* Type guard: narrows unknown to FetcherValidationError.
+*/
+const isFetcherValidationError = (error) => error instanceof FetcherValidationError;
+/**
+* Creates a retry schedule with exponential backoff and error filtering.
+*/
+const createRetrySchedule = (retries, retryDelay) => pipe(Schedule.exponential(Duration.millis(retryDelay)), Schedule.both(Schedule.recurs(retries)), Schedule.while((metadata) => {
+	const error = metadata.input;
+	if (isFetcherValidationError(error)) return Effect.succeed(false);
+	if (isFetcherError(error) && error.status) {
+		if (error.status === 429) return Effect.succeed(true);
+		if (error.status >= 400 && error.status < 500) return Effect.succeed(false);
+	}
+	return Effect.succeed(true);
+}));
+/**
+* Parses the response, handling HTTP errors and JSON parsing.
+*/
+const parseResponse = (response, url, attempt) => {
+	if (response.status < 200 || response.status >= 300) return pipe(response.json, Effect.catch(() => Effect.succeed(void 0)), Effect.flatMap((errorData) => pipe(response.text, Effect.catch(() => Effect.succeed("Request failed")), Effect.flatMap((errorText) => {
+		const errorMessage = response.status === 429 ? `Rate limit exceeded (429). Please slow down requests to ${url}` : `HTTP ${response.status}: ${errorText}`;
+		return Effect.fail(new FetcherError(errorMessage, url, response.status, errorData, attempt));
+	}))));
+	return pipe(response.json, Effect.catch((error) => pipe(response.text, Effect.flatMap((text) => {
+		const errorMessage = `Failed to parse JSON response. Status: ${response.status}, Content-Type: ${response.headers["Content-Type"] || "unknown"}, Body: ${text.slice(0, 200)}${text.length > 200 ? "..." : ""}`;
+		return Effect.fail(new FetcherError(errorMessage, url, response.status, {
+			originalError: error,
+			responseText: text
+		}, attempt));
+	}), Effect.catch(() => Effect.fail(new FetcherError(`Failed to parse response: ${error.message}`, url, response.status, void 0, attempt))))));
+};
+function fetcher(input, method = "GET", options = {}, params, body) {
+	const { retries = 0, retryDelay = 1e3, onError, timeout = 1e4, headers = {}, schema, bodyType = "json" } = options;
+	const queryString = buildQueryString(params);
+	let url;
+	if (input.startsWith("http")) url = queryString ? `${input}?${queryString}` : input;
+	else {
+		const baseURL = getBaseURL();
+		const fullPath = baseURL ? `${baseURL}${input}` : input;
+		url = queryString ? `${fullPath}?${queryString}` : fullPath;
+	}
+	return Effect.gen(function* () {
+		const client = yield* HttpClient.HttpClient;
+		let attempt = 0;
+		let req = buildRequest(method, url);
+		if (body != null && (method === "POST" || method === "PUT" || method === "PATCH")) if (bodyType === "form" || body instanceof FormData) req = HttpClientRequest.bodyFormData(body)(req);
+		else if (bodyType === "text") {
+			const textBody = typeof body === "object" ? JSON.stringify(body) : String(body);
+			req = HttpClientRequest.bodyText(textBody)(req);
+		} else req = yield* pipe(HttpClientRequest.bodyJson(body)(req), Effect.mapError((error) => new FetcherError(`Failed to serialize request body: ${safeStringify(error)}`, url, void 0, void 0, attempt)));
+		req = HttpClientRequest.setHeaders(headers)(req);
+		const retrySchedule = createRetrySchedule(retries, retryDelay);
+		return yield* pipe(Effect.gen(function* () {
+			attempt++;
+			return yield* validateResponse(yield* parseResponse(yield* pipe(client.execute(req), (eff) => withTimeout(eff, timeout, url, attempt), Effect.mapError((error) => {
+				if (error instanceof FetcherError) return error;
+				return new FetcherError(error instanceof Error ? error.message : String(error), url, void 0, void 0, attempt);
+			})), url, attempt), attempt, url, schema, onError);
+		}), Effect.retry(retrySchedule), Effect.catch((error) => {
+			if (onError) onError(error);
+			return Effect.fail(error);
+		}));
+	});
+}
+function get(url, options, params) {
+	return fetcher(url, "GET", options, params);
+}
+function post(url, body, options, params) {
+	return fetcher(url, "POST", options, params, body);
+}
+function put(url, body, options, params) {
+	return fetcher(url, "PUT", options, params, body);
+}
+function patch(url, body, options, params) {
+	return fetcher(url, "PATCH", options, params, body);
+}
+function del(url, options, params) {
+	return fetcher(url, "DELETE", options, params);
+}
+function options(url, options, params) {
+	return fetcher(url, "OPTIONS", options, params);
+}
+function head(url, options, params) {
+	return fetcher(url, "HEAD", options, params);
+}
+const createPaginatedSchema = (itemSchema) => {
+	return Schema.Struct({
+		data: Schema.Array(itemSchema),
+		pagination: Schema.Struct({
+			page: Schema.Number,
+			pageSize: Schema.Number,
+			total: Schema.Number,
+			totalPages: Schema.Number
+		})
+	});
+};
+const createApiResponseSchema = (dataSchema) => {
+	return Schema.Struct({
+		success: Schema.Boolean,
+		data: dataSchema,
+		message: Schema.optional(Schema.String),
+		errors: Schema.optional(Schema.Array(Schema.String))
+	});
+};
+//#endregion
+export { FetcherError, FetcherValidationError, createApiResponseSchema, createPaginatedSchema, del, fetcher, get, head, options, patch, post, put };
+
+//# sourceMappingURL=fetcher.mjs.map

package/lib/fetcher.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.mjs","names":[],"sources":["../src/fetcher.ts"],"sourcesContent":["/**\n * Copyright 2026 ResQ\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Cause, Duration, Effect, Exit, pipe, Schedule, Schema } from 'effect';\nimport { HttpClient, HttpClientError, HttpClientRequest, type HttpClientResponse } from 'effect/unstable/http';\n\n/**\n * A Schema with DecodingServices constrained to `never`, allowing synchronous decoding.\n * All standard built-in schemas (e.g. `Schema.Struct(...)`) satisfy this constraint.\n */\ntype SyncSchema<T> = Schema.Schema<T> & { readonly DecodingServices: never };\n\n/**\n * Configuration options for the fetcher utility.\n */\nexport interface FetcherOptions<T = unknown> {\n  /** Number of times to retry the request on failure */\n  retries?: number;\n  /** Delay in milliseconds between retries */\n  retryDelay?: number;\n  /** Optional callback invoked on error */\n  onError?: (error: unknown) => void;\n  /** Timeout in milliseconds for the request */\n  timeout?: number;\n  /** Additional headers to include in the request */\n  headers?: Record<string, string>;\n  /** Effect/Schema for runtime validation of the response */\n  schema?: SyncSchema<T>;\n  /** Abortsignal */\n  signal?: AbortSignal;\n  /** Body type - defaults to 'json', use 'text' for raw data, 'form' for FormData */\n  bodyType?: 'json' | 'text' | 'form';\n}\n\n/**\n * Represents all supported HTTP methods for the fetcher utility.\n */\nexport type HttpMethod = Schema.Schema.Type<typeof HttpMethod>;\n/**\n * Represents a type-safe map of query parameters.\n * Each value can be a string, number, boolean, null, undefined, or an array of those types.\n */\nexport type QueryParams = Schema.Schema.Type<typeof QueryParams>;\n/**\n * Represents a type-safe request body for HTTP methods that support a body.\n * Can be an object, array, string, number, boolean, or null.\n */\nexport type RequestBody = Schema.Schema.Type<typeof RequestBody>;\n/**\n * Represents HTTP headers as key-value string pairs.\n */\nexport type Headers = Schema.Schema.Type<typeof Headers>;\n\nconst EMPTY = '';\n\nconst safeStringify = (error: unknown): string => {\n  if (error instanceof Error) {\n    return error.message;\n  }\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n};\n\n/**\n * Get the base URL for API requests.\n */\nconst getBaseURL = (): string => {\n  if (globalThis.window !== undefined) {\n    return '';\n  }\n  if (process.env['VITE_SITE_URL']) {\n    return process.env['VITE_SITE_URL'].replace(/\\/+$/, '');\n  }\n  if (process.env['SITE_URL']) {\n    return process.env['SITE_URL'].replace(/\\/+$/, '');\n  }\n  return 'http://localhost:5173';\n};\n\n// HTTP Method type definition\nconst HttpMethod = Schema.Literals(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS', 'HEAD']);\n// Query parameters type definition\nconst QueryParams = Schema.Record(\n  Schema.String,\n  Schema.Union([\n    Schema.String,\n    Schema.Number,\n    Schema.Boolean,\n    Schema.Undefined,\n    Schema.Null,\n    Schema.Array(Schema.Union([Schema.String, Schema.Number, Schema.Boolean])),\n  ]),\n);\n// Request body type definition\nconst RequestBody = Schema.Any;\n\n// Headers type definition\nconst Headers = Schema.Record(Schema.String, Schema.String);\n\n/**\n * Custom error class for validation-specific errors.\n */\nexport class FetcherValidationError extends Error {\n  constructor(\n    message: string,\n    public readonly url: string,\n    public readonly problems: string,\n    public readonly responseData: unknown,\n    public readonly attempt?: number,\n  ) {\n    super(message);\n    this.name = 'FetcherValidationError';\n    Object.setPrototypeOf(this, FetcherValidationError.prototype);\n  }\n\n  [Symbol.toStringTag] = 'FetcherValidationError';\n\n  override toString(): string {\n    const attemptStr = this.attempt ? `, Attempt: ${this.attempt}` : '';\n    return `FetcherValidationError: ${this.message} (URL: ${this.url}${attemptStr})`;\n  }\n\n  getProblemsString(): string {\n    return this.problems;\n  }\n}\n\n/**\n * Custom error class for fetcher-specific errors.\n */\nexport class FetcherError extends Error {\n  constructor(\n    message: string,\n    public readonly url: string,\n    public readonly status?: number,\n    public readonly responseData?: unknown,\n    public readonly attempt?: number,\n  ) {\n    super(message);\n    this.name = 'FetcherError';\n    Object.setPrototypeOf(this, FetcherError.prototype);\n  }\n\n  [Symbol.toStringTag] = 'FetcherError';\n\n  override toString(): string {\n    const statusStr = this.status ? `, Status: ${this.status}` : '';\n    const attemptStr = this.attempt ? `, Attempt: ${this.attempt}` : '';\n    return `FetcherError: ${this.message} (URL: ${this.url}${statusStr}${attemptStr})`;\n  }\n}\n\n/**\n * Builds a query string from the provided query parameters.\n */\nconst buildQueryString = (params?: QueryParams): string => {\n  if (!params) return EMPTY;\n  const urlParams = new URLSearchParams();\n\n  Object.entries(params).forEach(([key, value]) => {\n    if (value == null) return;\n\n    if (Array.isArray(value)) {\n      value\n        .filter((item): item is string | number | boolean => item != null)\n        .forEach((item) => {\n          urlParams.append(key, String(item));\n        });\n    } else {\n      urlParams.append(key, String(value));\n    }\n  });\n\n  return urlParams.toString();\n};\n\n/**\n * Builds a type-safe HttpClientRequest for the given method and URL.\n */\nconst buildRequest = (method: HttpMethod, url: string): HttpClientRequest.HttpClientRequest => {\n  switch (method) {\n    case 'GET':\n      return HttpClientRequest.get(url);\n    case 'POST':\n      return HttpClientRequest.post(url);\n    case 'PUT':\n      return HttpClientRequest.put(url);\n    case 'PATCH':\n      return HttpClientRequest.patch(url);\n    case 'DELETE':\n      return HttpClientRequest.delete(url);\n    case 'OPTIONS':\n      return HttpClientRequest.options(url);\n    case 'HEAD':\n      return HttpClientRequest.head(url);\n  }\n};\n\n/**\n * Validates response data using the provided Effect schema.\n */\nconst validateResponse = <T>(\n  data: unknown,\n  attempt: number,\n  url: string,\n  schema?: SyncSchema<T>,\n  onError?: (error: unknown) => void,\n): Effect.Effect<T, FetcherValidationError, never> => {\n  if (!schema) {\n    return Effect.succeed(data as T);\n  }\n\n  const result = Schema.decodeUnknownExit(schema as any)(data);\n\n  if (Exit.isFailure(result)) {\n    const schemaError = Cause.squash(result.cause);\n    const problems = schemaError instanceof Error ? schemaError.message : String(schemaError);\n    const validationError = new FetcherValidationError(\n      'Response validation failed',\n      url,\n      problems,\n      data,\n      attempt,\n    );\n\n    if (onError) onError(validationError);\n    return Effect.fail(validationError);\n  }\n\n  return Effect.succeed(result.value as T);\n};\n\n/**\n * Wraps an Effect with a timeout, converting timeout errors to FetcherError.\n */\nconst withTimeout = <A, E, R>(\n  eff: Effect.Effect<A, E, R>,\n  timeout: number,\n  url: string,\n  attempt: number,\n): Effect.Effect<A, FetcherError | E, R> =>\n  Effect.timeoutOrElse(eff, {\n    duration: Duration.millis(timeout),\n    orElse: () => Effect.fail(new FetcherError('Request timed out', url, undefined, undefined, attempt)),\n  });\n\n/**\n * Type guard: narrows unknown to FetcherError.\n */\nconst isFetcherError = (error: unknown): error is FetcherError => error instanceof FetcherError;\n\n/**\n * Type guard: narrows unknown to FetcherValidationError.\n */\nconst isFetcherValidationError = (error: unknown): error is FetcherValidationError =>\n  error instanceof FetcherValidationError;\n\n/**\n * Creates a retry schedule with exponential backoff and error filtering.\n */\nconst createRetrySchedule = (retries: number, retryDelay: number) =>\n  pipe(\n    Schedule.exponential(Duration.millis(retryDelay)),\n    Schedule.both(Schedule.recurs(retries)),\n    Schedule.while((metadata) => {\n      const error: unknown = metadata.input;\n      // Don't retry validation errors or client errors (except 429)\n      if (isFetcherValidationError(error)) return Effect.succeed(false);\n      if (isFetcherError(error) && error.status) {\n        if (error.status === 429) return Effect.succeed(true); // Always retry 429 rate limits\n        if (error.status >= 400 && error.status < 500) return Effect.succeed(false); // Don't retry other 4xx\n      }\n      return Effect.succeed(true);\n    }),\n  );\n\n/**\n * Parses the response, handling HTTP errors and JSON parsing.\n */\nconst parseResponse = (\n  response: HttpClientResponse.HttpClientResponse,\n  url: string,\n  attempt: number,\n): Effect.Effect<unknown, FetcherError, never> => {\n  // Check for HTTP errors (non-2xx status codes)\n  if (response.status < 200 || response.status >= 300) {\n    return pipe(\n      response.json,\n      Effect.catch(() => Effect.succeed(undefined as unknown)),\n      Effect.flatMap((errorData) =>\n        pipe(\n          response.text,\n          Effect.catch(() => Effect.succeed('Request failed')),\n          Effect.flatMap((errorText) => {\n            const errorMessage =\n              response.status === 429\n                ? `Rate limit exceeded (429). Please slow down requests to ${url}`\n                : `HTTP ${response.status}: ${errorText}`;\n            return Effect.fail(\n              new FetcherError(errorMessage, url, response.status, errorData, attempt),\n            );\n          }),\n        ),\n      ),\n    );\n  }\n\n  // Parse response data as JSON, with fallback to text and detailed error reporting\n  return pipe(\n    response.json,\n    Effect.catch((error: HttpClientError.HttpClientError) =>\n      pipe(\n        response.text,\n        Effect.flatMap((text: string) => {\n          const errorMessage = `Failed to parse JSON response. Status: ${response.status}, Content-Type: ${response.headers['Content-Type'] || 'unknown'}, Body: ${text.slice(0, 200)}${text.length > 200 ? '...' : ''}`;\n          return Effect.fail(\n            new FetcherError(\n              errorMessage,\n              url,\n              response.status,\n              { originalError: error, responseText: text },\n              attempt,\n            ),\n          );\n        }),\n        Effect.catch(() =>\n          Effect.fail(\n            new FetcherError(\n              `Failed to parse response: ${error.message}`,\n              url,\n              response.status,\n              undefined,\n              attempt,\n            ),\n          ),\n        ),\n      ),\n    ),\n  );\n};\n\n// --- Overloaded function signatures for type safety with effect/Schema ---\n\nexport function fetcher<T = unknown>(\n  input: string,\n  method?: 'GET',\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function fetcher<S extends SyncSchema<Schema.Schema.Type<S>>>(\n  input: string,\n  method: 'GET',\n  options: FetcherOptions<Schema.Schema.Type<S>> & { schema: S },\n  params?: QueryParams,\n): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function fetcher<T = unknown>(\n  input: string,\n  method: 'POST' | 'PUT' | 'PATCH',\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n  body?: RequestBody,\n): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function fetcher<S extends SyncSchema<Schema.Schema.Type<S>>>(\n  input: string,\n  method: 'POST' | 'PUT' | 'PATCH',\n  options: FetcherOptions<Schema.Schema.Type<S>> & { schema: S },\n  params?: QueryParams,\n  body?: RequestBody,\n): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function fetcher<T = unknown>(\n  input: string,\n  method: 'DELETE' | 'OPTIONS' | 'HEAD',\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function fetcher<T = unknown>(\n  input: string,\n  method: HttpMethod = 'GET',\n  options: FetcherOptions<T> = {},\n  params?: QueryParams,\n  body?: RequestBody,\n): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient> {\n  const {\n    retries = 0,\n    retryDelay = 1_000,\n    onError,\n    timeout = 10_000,\n    headers = {},\n    schema,\n    bodyType = 'json',\n  } = options;\n\n  const queryString = buildQueryString(params);\n\n  let url: string;\n  if (input.startsWith('http')) {\n    url = queryString ? `${input}?${queryString}` : input;\n  } else {\n    const baseURL = getBaseURL();\n    const fullPath = baseURL ? `${baseURL}${input}` : input;\n    url = queryString ? `${fullPath}?${queryString}` : fullPath;\n  }\n\n  return Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient;\n    let attempt = 0;\n\n    let req = buildRequest(method, url);\n\n    if (body != null && (method === 'POST' || method === 'PUT' || method === 'PATCH')) {\n      if (bodyType === 'form' || body instanceof FormData) {\n        req = HttpClientRequest.bodyFormData(body as FormData)(req);\n      } else if (bodyType === 'text') {\n        const textBody =\n          typeof body === 'object' ? JSON.stringify(body) : String(body);\n        req = HttpClientRequest.bodyText(textBody)(req);\n      } else {\n        req = yield* pipe(\n          HttpClientRequest.bodyJson(body)(req),\n          Effect.mapError(\n            (error: unknown) =>\n              new FetcherError(\n                `Failed to serialize request body: ${safeStringify(error)}`,\n                url,\n                undefined,\n                undefined,\n                attempt,\n              ),\n          ),\n        );\n      }\n    }\n\n    req = HttpClientRequest.setHeaders(headers)(req);\n\n    const retrySchedule = createRetrySchedule(retries, retryDelay);\n\n    const executeRequest: Effect.Effect<T, FetcherError | FetcherValidationError, never> =\n      Effect.gen(function* () {\n        attempt++;\n\n        const response = yield* pipe(\n          client.execute(req),\n          (eff) => withTimeout(eff, timeout, url, attempt),\n          Effect.mapError((error): FetcherError => {\n            if (error instanceof FetcherError) return error;\n\n            return new FetcherError(\n              error instanceof Error ? error.message : String(error),\n              url,\n              undefined,\n              undefined,\n              attempt,\n            );\n          }),\n        );\n\n        const rawData: unknown = yield* parseResponse(response, url, attempt);\n\n        const validatedData: T = yield* validateResponse(rawData, attempt, url, schema, onError);\n\n        return validatedData;\n      });\n\n    return yield* pipe(\n      executeRequest,\n      Effect.retry(retrySchedule),\n      Effect.catch(\n        (error: FetcherError | FetcherValidationError): Effect.Effect<never, FetcherError | FetcherValidationError> => {\n          if (onError) onError(error);\n          return Effect.fail(error);\n        },\n      ),\n    );\n  });\n}\n\nexport function get<T = unknown>(\n  url: string,\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function get<A>(\n  url: string,\n  options: FetcherOptions<A> & { schema: Schema.Schema<A> },\n  params?: QueryParams,\n): Effect.Effect<A, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function get<T = unknown>(url: string, options?: FetcherOptions<T>, params?: QueryParams) {\n  return fetcher<T>(url, 'GET', options, params);\n}\n\nexport function post<T = unknown>(\n  url: string,\n  body?: RequestBody,\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function post<S extends SyncSchema<Schema.Schema.Type<S>>>(\n  url: string,\n  body: RequestBody,\n  options: FetcherOptions<Schema.Schema.Type<S>> & { schema: S },\n  params?: QueryParams,\n): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function post<T = unknown>(\n  url: string,\n  body?: RequestBody,\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n) {\n  return fetcher<T>(url, 'POST', options, params, body);\n}\n\nexport function put<T = unknown>(\n  url: string,\n  body?: RequestBody,\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function put<S extends SyncSchema<Schema.Schema.Type<S>>>(\n  url: string,\n  body: RequestBody,\n  options: FetcherOptions<Schema.Schema.Type<S>> & { schema: S },\n  params?: QueryParams,\n): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function put<T = unknown>(\n  url: string,\n  body?: RequestBody,\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n) {\n  return fetcher<T>(url, 'PUT', options, params, body);\n}\n\nexport function patch<T = unknown>(\n  url: string,\n  body?: RequestBody,\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function patch<S extends SyncSchema<Schema.Schema.Type<S>>>(\n  url: string,\n  body: RequestBody,\n  options: FetcherOptions<Schema.Schema.Type<S>> & { schema: S },\n  params?: QueryParams,\n): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function patch<T = unknown>(\n  url: string,\n  body?: RequestBody,\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n) {\n  return fetcher<T>(url, 'PATCH', options, params, body);\n}\n\nexport function del<T = unknown>(\n  url: string,\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function del<S extends SyncSchema<Schema.Schema.Type<S>>>(\n  url: string,\n  options: FetcherOptions<Schema.Schema.Type<S>> & { schema: S },\n  params?: QueryParams,\n): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function del<T = unknown>(url: string, options?: FetcherOptions<T>, params?: QueryParams) {\n  return fetcher<T>(url, 'DELETE', options, params);\n}\n\nexport function options<T = unknown>(\n  url: string,\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function options<S extends SyncSchema<Schema.Schema.Type<S>>>(\n  url: string,\n  options: FetcherOptions<Schema.Schema.Type<S>> & { schema: S },\n  params?: QueryParams,\n): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function options<T = unknown>(\n  url: string,\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n) {\n  return fetcher<T>(url, 'OPTIONS', options, params);\n}\n\nexport function head<T = unknown>(\n  url: string,\n  options?: FetcherOptions<T>,\n  params?: QueryParams,\n): Effect.Effect<T, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function head<S extends SyncSchema<Schema.Schema.Type<S>>>(\n  url: string,\n  options: FetcherOptions<Schema.Schema.Type<S>> & { schema: S },\n  params?: QueryParams,\n): Effect.Effect<Schema.Schema.Type<S>, FetcherError | FetcherValidationError, HttpClient.HttpClient>;\n\nexport function head<T = unknown>(url: string, options?: FetcherOptions<T>, params?: QueryParams) {\n  return fetcher<T>(url, 'HEAD', options, params);\n}\n\nexport const createPaginatedSchema = <T>(itemSchema: Schema.Schema<T>) => {\n  return Schema.Struct({\n    data: Schema.Array(itemSchema),\n    pagination: Schema.Struct({\n      page: Schema.Number,\n      pageSize: Schema.Number,\n      total: Schema.Number,\n      totalPages: Schema.Number,\n    }),\n  });\n};\n\nexport const createApiResponseSchema = <T>(dataSchema: Schema.Schema<T>) => {\n  return Schema.Struct({\n    success: Schema.Boolean,\n    data: dataSchema,\n    message: Schema.optional(Schema.String),\n    errors: Schema.optional(Schema.Array(Schema.String)),\n  });\n};\n"],"mappings":"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"}

package/lib/index.d.mts

@@ -0,0 +1,3 @@
+import { FetcherError, FetcherOptions, FetcherValidationError, Headers, HttpMethod, QueryParams, RequestBody, createApiResponseSchema, createPaginatedSchema, del, fetcher, get, head, options, patch, post, put } from "./fetcher.mjs";
+import { getRequestId, shouldRedirectToHttps } from "./security.mjs";
+export { FetcherError, FetcherOptions, FetcherValidationError, Headers, HttpMethod, QueryParams, RequestBody, createApiResponseSchema, createPaginatedSchema, del, fetcher, get, getRequestId, head, options, patch, post, put, shouldRedirectToHttps };

package/lib/index.mjs

@@ -0,0 +1,3 @@
+import { FetcherError, FetcherValidationError, createApiResponseSchema, createPaginatedSchema, del, fetcher, get, head, options, patch, post, put } from "./fetcher.mjs";
+import { getRequestId, shouldRedirectToHttps } from "./security.mjs";
+export { FetcherError, FetcherValidationError, createApiResponseSchema, createPaginatedSchema, del, fetcher, get, getRequestId, head, options, patch, post, put, shouldRedirectToHttps };

package/lib/security.d.mts

@@ -0,0 +1,34 @@
+//#region src/security.d.ts
+/**
+ * Copyright 2026 ResQ
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @file Security Middleware Utilities
+ * @module @resq-sw/http/security
+ * @author ResQ
+ * @description Framework-agnostic security middleware logic.
+ * @compliance NIST 800-53 SC-8 (Transmission Confidentiality), SC-23 (Session Authenticity)
+ */
+/**
+ * Check if a request should be redirected to HTTPS
+ */
+declare function shouldRedirectToHttps(protocol: string, url: string, headers: Record<string, string | undefined>, nodeEnv?: string): string | null;
+/**
+ * Generate or retrieve a request ID
+ */
+declare function getRequestId(existingId?: string): string;
+//#endregion
+export { getRequestId, shouldRedirectToHttps };
+//# sourceMappingURL=security.d.mts.map

package/lib/security.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.mts","names":[],"sources":["../src/security.ts"],"mappings":";;AA2BA;;;;;;;;;;;AAiCA;;;;;;;;;;;;;iBAjCgB,qBAAA,CACd,QAAA,UACA,GAAA,UACA,OAAA,EAAS,MAAA,8BACT,OAAA;;;;iBA6Bc,YAAA,CAAa,UAAA"}

package/lib/security.mjs

@@ -0,0 +1,47 @@
+//#region src/security.ts
+/**
+* Copyright 2026 ResQ
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+/**
+* @file Security Middleware Utilities
+* @module @resq-sw/http/security
+* @author ResQ
+* @description Framework-agnostic security middleware logic.
+* @compliance NIST 800-53 SC-8 (Transmission Confidentiality), SC-23 (Session Authenticity)
+*/
+/**
+* Check if a request should be redirected to HTTPS
+*/
+function shouldRedirectToHttps(protocol, url, headers, nodeEnv = process.env["NODE_ENV"] || "development") {
+	if (nodeEnv === "development" || nodeEnv === "test") return null;
+	const forwardedProto = headers["x-forwarded-proto"];
+	const forwardedSsl = headers["x-forwarded-ssl"];
+	if (!(forwardedProto === "https" || forwardedSsl === "on" || protocol === "https" || url.startsWith("https://"))) {
+		const httpsUrl = new URL(url);
+		httpsUrl.protocol = "https:";
+		return httpsUrl.toString();
+	}
+	return null;
+}
+/**
+* Generate or retrieve a request ID
+*/
+function getRequestId(existingId) {
+	return existingId || crypto.randomUUID();
+}
+//#endregion
+export { getRequestId, shouldRedirectToHttps };
+
+//# sourceMappingURL=security.mjs.map

package/lib/security.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.mjs","names":[],"sources":["../src/security.ts"],"sourcesContent":["/**\n * Copyright 2026 ResQ\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * @file Security Middleware Utilities\n * @module @resq-sw/http/security\n * @author ResQ\n * @description Framework-agnostic security middleware logic.\n * @compliance NIST 800-53 SC-8 (Transmission Confidentiality), SC-23 (Session Authenticity)\n */\n\n/**\n * Check if a request should be redirected to HTTPS\n */\nexport function shouldRedirectToHttps(\n  protocol: string,\n  url: string,\n  headers: Record<string, string | undefined>,\n  nodeEnv: string = process.env['NODE_ENV'] || 'development'\n): string | null {\n  // Skip in development/test environments\n  if (nodeEnv === 'development' || nodeEnv === 'test') {\n    return null;\n  }\n\n  // Check for HTTPS via various headers (handles proxies/load balancers)\n  const forwardedProto = headers['x-forwarded-proto'];\n  const forwardedSsl = headers['x-forwarded-ssl'];\n  \n  const isSecure =\n    forwardedProto === 'https' ||\n    forwardedSsl === 'on' ||\n    protocol === 'https' ||\n    url.startsWith('https://');\n\n  if (!isSecure) {\n    const httpsUrl = new URL(url);\n    httpsUrl.protocol = 'https:';\n    return httpsUrl.toString();\n  }\n\n  return null;\n}\n\n/**\n * Generate or retrieve a request ID\n */\nexport function getRequestId(existingId?: string): string {\n  return existingId || crypto.randomUUID();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,sBACd,UACA,KACA,SACA,UAAkB,QAAQ,IAAI,eAAe,eAC9B;AAEf,KAAI,YAAY,iBAAiB,YAAY,OAC3C,QAAO;CAIT,MAAM,iBAAiB,QAAQ;CAC/B,MAAM,eAAe,QAAQ;AAQ7B,KAAI,EALF,mBAAmB,WACnB,iBAAiB,QACjB,aAAa,WACb,IAAI,WAAW,WAAW,GAEb;EACb,MAAM,WAAW,IAAI,IAAI,IAAI;AAC7B,WAAS,WAAW;AACpB,SAAO,SAAS,UAAU;;AAG5B,QAAO;;;;;AAMT,SAAgB,aAAa,YAA6B;AACxD,QAAO,cAAc,OAAO,YAAY"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@resq-sw/http",
+  "version": "0.1.0",
+  "description": "Effect-based HTTP client with retry, timeout, and schema validation",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.mts",
+      "import": "./lib/index.mjs",
+      "default": "./lib/index.mjs"
+    },
+    "./security": {
+      "types": "./lib/security.d.mts",
+      "import": "./lib/security.mjs",
+      "default": "./lib/security.mjs"
+    }
+  },
+  "main": "lib/index.mjs",
+  "types": "lib/index.d.mts",
+  "files": ["lib", "README.md"],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "effect": ">=3.0.0",
+    "@effect/platform": ">=0.60.0",
+    "@effect/platform-bun": ">=0.40.0"
+  },
+  "peerDependenciesMeta": {
+    "@effect/platform-bun": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@effect/platform-bun": "4.0.0-beta.43",
+    "effect": "4.0.0-beta.43",
+    "tsdown": "^0.21.7",
+    "typescript": "5.9.3",
+    "vitest": "3.2.4"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/resq-software/npm.git",
+    "directory": "packages/http"
+  },
+  "keywords": ["http", "fetch", "effect", "retry", "schema-validation"],
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}