@teever/ez-hook-effect 0.4.4 → 0.5.1

package/README.md

@@ -25,17 +25,14 @@ npx jsr add @teever/ez-hook-effect
 ## Quick Start
 
 ```typescript
-import { Effect, Layer, pipe } from 'effect'
-import { sendWebhook, makeConfigLayer, HttpClientLive, WebhookServiceLive, Webhook } from '@teever/ez-hook-effect'
+import { Effect, pipe } from 'effect'
+import { makeDefaultLayer, sendWebhook, Webhook } from '@teever/ez-hook-effect'
 
 // Configure your webhook
 const WEBHOOK_URL = 'https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN'
 
-// Create service layers
-const AppLayer = WebhookServiceLive.pipe(
-  Layer.provide(makeConfigLayer(WEBHOOK_URL)),
-  Layer.provide(HttpClientLive)
-)
+// Create service layer
+const AppLayer = makeDefaultLayer(WEBHOOK_URL)
 
 // Send a simple message
 const program = pipe(
@@ -47,7 +44,7 @@ const program = pipe(
 )
 
 // Run the program
-Effect.runPromise(Effect.provide(program, AppLayer))
+Effect.runPromise(program.pipe(Effect.provide(AppLayer)))
 ```
 
 ### Pipe-First API (Recommended)
@@ -105,7 +102,7 @@ const embedProgram = pipe(
 
 ## Error Handling
 
-Retries for rate limits (429) and transient errors (5xx) are handled automatically using configurable exponential backoff. You only need to handle errors that persist after retries are exhausted:
+Retries for rate limits (429) and transient errors (5xx) are handled automatically using configurable exponential backoff. `sendWebhook` fails the Effect on any non-204 response, so errors always surface to your error handling paths.
 
 ```typescript
 import { Effect, pipe } from 'effect'
@@ -144,6 +141,54 @@ Effect.catchTag('ValidationError', (error) =>
 )
 ```
 
+### Error Helpers
+
+```typescript
+import { Effect, pipe } from 'effect'
+import { Webhook, sendWebhook, formatWebhookError, webhookErrorToLogObject } from '@teever/ez-hook-effect'
+
+const program = pipe(
+  Webhook.make,
+  Webhook.setContent('Hello!'),
+  Webhook.build,
+  Effect.flatMap(sendWebhook),
+  Effect.catchAll((error) =>
+    Effect.logError(formatWebhookError(error)).pipe(
+      Effect.tap(() => Effect.log(JSON.stringify(webhookErrorToLogObject(error))))
+    )
+  )
+)
+```
+
+## Raw Response
+
+When you need status/body, use `sendWebhookRaw`:
+
+```typescript
+import { Effect, pipe } from 'effect'
+import { sendWebhookRaw, Webhook } from '@teever/ez-hook-effect'
+
+const program = pipe(
+  Webhook.make,
+  Webhook.setContent('Hello!'),
+  Webhook.build,
+  Effect.flatMap(sendWebhookRaw),
+  Effect.tap((res) => Effect.log(`Status: ${res.status}`))
+)
+```
+
+## Validate Only
+
+```typescript
+import { Effect, pipe } from 'effect'
+import { Webhook } from '@teever/ez-hook-effect'
+
+const program = pipe(
+  Webhook.validate({ content: 'Hello!' }),
+  Effect.tap(() => Effect.log('Valid payload'))
+)
+```
+
 ## Configuration Options
 
 ### Programmatic Configuration
@@ -160,6 +205,17 @@ const AppLayer = WebhookServiceLive.pipe(
 )
 ```
 
+### One-Liner Configuration
+
+```typescript
+import { makeDefaultLayer } from '@teever/ez-hook-effect'
+
+const AppLayer = makeDefaultLayer(WEBHOOK_URL, {
+  maxRetries: 5,
+  baseDelayMs: 1000,
+})
+```
+
 ### Environment Variables
 
 ```typescript
@@ -198,7 +254,7 @@ Beyond sending messages, the library supports full webhook CRUD:
 
 ```typescript
 import { Effect, Layer, pipe } from 'effect'
-import { getWebhook, modifyWebhook, deleteWebhook, validateWebhook, WebhookServiceLive, makeConfigLayer, HttpClientLive } from '@teever/ez-hook-effect'
+import { getWebhook, modifyWebhook, deleteWebhook, validateWebhook, WebhookService, WebhookServiceLive, makeConfigLayer, HttpClientLive } from '@teever/ez-hook-effect'
 
 const AppLayer = WebhookServiceLive.pipe(
   Layer.provide(makeConfigLayer(WEBHOOK_URL)),
@@ -226,6 +282,28 @@ const program = Effect.gen(function* () {
 Effect.runPromise(Effect.provide(program, AppLayer))
 ```
 
+## Testing Utilities
+
+```typescript
+import { Effect, Layer, pipe } from 'effect'
+import { makeTestHttpClient, WebhookServiceLive, makeConfigLayer } from '@teever/ez-hook-effect'
+
+const TestHttpClient = makeTestHttpClient((_req) =>
+  Effect.succeed({
+    status: 204,
+    statusText: 'No Content',
+    headers: {},
+    body: null,
+    text: '',
+  })
+)
+
+const AppLayer = WebhookServiceLive.pipe(
+  Layer.provide(makeConfigLayer('https://discord.com/api/webhooks/123/abc')),
+  Layer.provide(TestHttpClient)
+)
+```
+
 ## Development
 
 ```bash

package/dist/errors/WebhookError.d.ts

@@ -1,4 +1,4 @@
-import { type ParseResult } from "effect";
+import { type Schema } from "effect";
 declare const WebhookError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
     readonly _tag: "WebhookError";
 } & Readonly<A>;
@@ -28,7 +28,7 @@ export interface ValidationIssue {
 /**
  * Convert Effect Schema ParseError to ValidationIssue array
  */
-export declare const parseErrorToIssues: (error: ParseResult.ParseError) => ValidationIssue[];
+export declare const parseErrorToIssues: (error: Schema.SchemaError) => ValidationIssue[];
 /**
  * Create a single ValidationIssue from simple field validation
  */
@@ -62,7 +62,7 @@ export declare class ValidationError extends ValidationError_base<{
     /**
      * Create ValidationError from Effect Schema ParseError
      */
-    static fromParseError(parseError: ParseResult.ParseError, context?: {
+    static fromParseError(parseError: Schema.SchemaError, context?: {
         field?: string;
         value?: unknown;
     }): ValidationError;
@@ -153,4 +153,143 @@ export declare class HttpError extends HttpError_base<{
  * All possible webhook errors
  */
 export type WebhookErrors = WebhookError | ValidationError | NetworkError | RateLimitError | ConfigError | FileError | HttpError;
+/**
+ * Create a readable message for any webhook error.
+ */
+export declare const formatWebhookError: (error: WebhookErrors, options?: {
+    maxIssues?: number;
+}) => string;
+/**
+ * Produce a structured log object for any webhook error.
+ */
+export declare const webhookErrorToLogObject: (error: WebhookErrors) => {
+    tag: "ValidationError";
+    message: string;
+    issues: readonly ValidationIssue[];
+    field: string;
+    value: unknown;
+    retryAfter?: undefined;
+    limit?: undefined;
+    remaining?: undefined;
+    reset?: undefined;
+    request?: undefined;
+    response?: undefined;
+    statusCode?: undefined;
+    parameter?: undefined;
+    filename?: undefined;
+    size?: undefined;
+    maxSize?: undefined;
+    cause?: undefined;
+} | {
+    tag: "RateLimitError";
+    message: string;
+    retryAfter: number;
+    limit: number;
+    remaining: number;
+    reset: Date;
+    issues?: undefined;
+    field?: undefined;
+    value?: undefined;
+    request?: undefined;
+    response?: undefined;
+    statusCode?: undefined;
+    parameter?: undefined;
+    filename?: undefined;
+    size?: undefined;
+    maxSize?: undefined;
+    cause?: undefined;
+} | {
+    tag: "HttpError";
+    message: string;
+    request: {
+        method: string;
+        url: string;
+    };
+    response: HttpErrorResponse;
+    issues?: undefined;
+    field?: undefined;
+    value?: undefined;
+    retryAfter?: undefined;
+    limit?: undefined;
+    remaining?: undefined;
+    reset?: undefined;
+    statusCode?: undefined;
+    parameter?: undefined;
+    filename?: undefined;
+    size?: undefined;
+    maxSize?: undefined;
+    cause?: undefined;
+} | {
+    tag: "NetworkError";
+    message: string;
+    statusCode: number;
+    response: unknown;
+    issues?: undefined;
+    field?: undefined;
+    value?: undefined;
+    retryAfter?: undefined;
+    limit?: undefined;
+    remaining?: undefined;
+    reset?: undefined;
+    request?: undefined;
+    parameter?: undefined;
+    filename?: undefined;
+    size?: undefined;
+    maxSize?: undefined;
+    cause?: undefined;
+} | {
+    tag: "ConfigError";
+    message: string;
+    parameter: string;
+    issues?: undefined;
+    field?: undefined;
+    value?: undefined;
+    retryAfter?: undefined;
+    limit?: undefined;
+    remaining?: undefined;
+    reset?: undefined;
+    request?: undefined;
+    response?: undefined;
+    statusCode?: undefined;
+    filename?: undefined;
+    size?: undefined;
+    maxSize?: undefined;
+    cause?: undefined;
+} | {
+    tag: "FileError";
+    message: string;
+    filename: string;
+    size: number;
+    maxSize: number;
+    issues?: undefined;
+    field?: undefined;
+    value?: undefined;
+    retryAfter?: undefined;
+    limit?: undefined;
+    remaining?: undefined;
+    reset?: undefined;
+    request?: undefined;
+    response?: undefined;
+    statusCode?: undefined;
+    parameter?: undefined;
+    cause?: undefined;
+} | {
+    tag: "WebhookError";
+    message: string;
+    cause: unknown;
+    issues?: undefined;
+    field?: undefined;
+    value?: undefined;
+    retryAfter?: undefined;
+    limit?: undefined;
+    remaining?: undefined;
+    reset?: undefined;
+    request?: undefined;
+    response?: undefined;
+    statusCode?: undefined;
+    parameter?: undefined;
+    filename?: undefined;
+    size?: undefined;
+    maxSize?: undefined;
+};
 export {};

package/dist/errors/WebhookError.js

@@ -0,0 +1,322 @@
+/* c8 ignore start */
+import { Data } from "effect";
+/**
+ * Base error class for all webhook-related errors
+ */
+/* c8 ignore stop */
+export class WebhookError extends Data.TaggedError("WebhookError") {
+}
+/**
+ * Extract constraint name from Effect Schema error message
+ */
+const extractConstraint = (message) => {
+    if (message.includes("at most") || message.includes("maximum"))
+        return "MaxLength";
+    if (message.includes("at least") || message.includes("minimum"))
+        return "MinLength";
+    if (message.includes("required") || message.includes("missing"))
+        return "Required";
+    if (message.includes("expected") && message.includes("to be"))
+        return "Type";
+    if (message.includes("URL") || message.includes("url"))
+        return "URL";
+    if (message.includes("integer") || message.includes("number"))
+        return "Number";
+    return undefined;
+};
+/**
+ * Truncate large values for error display
+ */
+const truncateValue = (value, maxLength = 100) => {
+    if (typeof value === "string" && value.length > maxLength) {
+        return `${value.slice(0, maxLength)}... (${value.length} chars)`;
+    }
+    if (Array.isArray(value) && value.length > 5) {
+        return `[Array with ${value.length} items]`;
+    }
+    if (typeof value === "object" && value !== null) {
+        const keys = Object.keys(value);
+        if (keys.length > 5) {
+            return `{Object with ${keys.length} keys}`;
+        }
+    }
+    return value;
+};
+/**
+ * Convert Effect Schema ParseIssue path to JSONPath string
+ */
+const pathToString = (path) => {
+    if (path.length === 0)
+        return "$";
+    return path.reduce((acc, segment) => {
+        if (typeof segment === "number") {
+            return `${acc}[${segment}]`;
+        }
+        return `${acc}.${String(segment)}`;
+    }, "$");
+};
+const toArray = (value) => Array.isArray(value) ? value : [value];
+// Helper to safely access issue properties via unknown
+const getIssueProp = (issue, key) => issue[key];
+const extractIssuesFromParseIssue = (issue, currentPath = []) => {
+    const issues = [];
+    switch (issue._tag) {
+        case "InvalidType": {
+            const ast = getIssueProp(issue, "ast");
+            const message = getIssueProp(issue, "message") ?? `Expected ${ast?._tag}`;
+            issues.push({
+                path: pathToString(currentPath),
+                message,
+                constraint: extractConstraint(message) ?? "Type",
+                actual: truncateValue(getIssueProp(issue, "actual")),
+            });
+            break;
+        }
+        case "Forbidden": {
+            issues.push({
+                path: pathToString(currentPath),
+                message: getIssueProp(issue, "message") ?? "Value is forbidden",
+                constraint: "Forbidden",
+            });
+            break;
+        }
+        case "MissingKey": {
+            issues.push({
+                path: pathToString(currentPath),
+                message: "Required field is missing",
+                constraint: "Required",
+            });
+            break;
+        }
+        case "UnexpectedKey": {
+            issues.push({
+                path: pathToString(currentPath),
+                message: getIssueProp(issue, "message") ?? "Unexpected field",
+                constraint: "Unexpected",
+                actual: truncateValue(getIssueProp(issue, "actual")),
+            });
+            break;
+        }
+        case "Pointer": {
+            const pathSegments = getIssueProp(issue, "path") ?? [];
+            const newPath = [...currentPath, ...pathSegments];
+            const nested = getIssueProp(issue, "issue");
+            if (nested)
+                issues.push(...extractIssuesFromParseIssue(nested, newPath));
+            break;
+        }
+        case "Composite": {
+            const rawIssues = getIssueProp(issue, "issues");
+            const subIssues = rawIssues ? toArray(rawIssues) : [];
+            for (const subIssue of subIssues) {
+                issues.push(...extractIssuesFromParseIssue(subIssue, currentPath));
+            }
+            break;
+        }
+        case "Filter":
+        case "Encoding": {
+            const nested = getIssueProp(issue, "issue");
+            if (nested)
+                issues.push(...extractIssuesFromParseIssue(nested, currentPath));
+            break;
+        }
+        case "InvalidValue":
+        case "OneOf":
+        case "AnyOf": {
+            issues.push({
+                path: pathToString(currentPath),
+                message: getIssueProp(issue, "message") ?? "Invalid value",
+                constraint: "Value",
+                actual: truncateValue(getIssueProp(issue, "actual")),
+            });
+            break;
+        }
+        default: {
+            const message = getIssueProp(issue, "message") ?? "Invalid value";
+            const constraint = extractConstraint(message);
+            issues.push({
+                path: pathToString(currentPath),
+                message,
+                ...(constraint !== undefined && { constraint }),
+                ...(getIssueProp(issue, "actual") !== undefined && {
+                    actual: truncateValue(getIssueProp(issue, "actual")),
+                }),
+            });
+            break;
+        }
+    }
+    return issues;
+};
+/**
+ * Convert Effect Schema ParseError to ValidationIssue array
+ */
+export const parseErrorToIssues = (error) => {
+    return extractIssuesFromParseIssue(error.issue);
+};
+/**
+ * Create a single ValidationIssue from simple field validation
+ */
+export const makeIssue = (field, message, options) => {
+    const constraint = options?.constraint ?? extractConstraint(message);
+    return {
+        path: field.startsWith("$") ? field : `$.${field}`,
+        message,
+        ...(constraint !== undefined && { constraint }),
+        ...(options?.expected !== undefined && { expected: options.expected }),
+        ...(options?.actual !== undefined && {
+            actual: truncateValue(options.actual),
+        }),
+    };
+};
+/**
+ * Validation errors for webhook data with structured issues
+ */
+export class ValidationError extends Data.TaggedError("ValidationError") {
+    /**
+     * Format issues as a human-readable string
+     */
+    format(options) {
+        const maxIssues = options?.maxIssues ?? 10;
+        const displayIssues = this.issues.slice(0, maxIssues);
+        const lines = displayIssues.map((issue) => {
+            let line = `  - ${issue.path}: ${issue.message}`;
+            if (issue.constraint) {
+                line += ` [${issue.constraint}]`;
+            }
+            return line;
+        });
+        if (this.issues.length > maxIssues) {
+            lines.push(`  ... and ${this.issues.length - maxIssues} more issues`);
+        }
+        return `${this.message}\n${lines.join("\n")}`;
+    }
+    /**
+     * Create ValidationError from Effect Schema ParseError
+     */
+    static fromParseError(parseError, context) {
+        const issues = parseErrorToIssues(parseError);
+        const firstIssue = issues[0];
+        const message = issues.length === 1 && firstIssue
+            ? firstIssue.message
+            : `Validation failed (${issues.length} issues)`;
+        return new ValidationError({
+            message,
+            issues,
+            ...(context?.field !== undefined && { field: context.field }),
+            ...(context?.value !== undefined && { value: context.value }),
+        });
+    }
+    /**
+     * Create ValidationError from a single issue
+     */
+    static fromIssue(field, message, options) {
+        const issue = makeIssue(field, message, options);
+        return new ValidationError({
+            message,
+            issues: [issue],
+            field,
+            value: options?.actual,
+        });
+    }
+}
+/**
+ * Network-related errors
+ */
+export class NetworkError extends Data.TaggedError("NetworkError") {
+}
+/**
+ * Rate limit errors
+ */
+export class RateLimitError extends Data.TaggedError("RateLimitError") {
+}
+/**
+ * Configuration errors
+ */
+export class ConfigError extends Data.TaggedError("ConfigError") {
+}
+/**
+ * File-related errors
+ */
+export class FileError extends Data.TaggedError("FileError") {
+}
+/**
+ * HTTP errors with detailed response information
+ */
+export class HttpError extends Data.TaggedError("HttpError") {
+}
+/**
+ * Create a readable message for any webhook error.
+ */
+export const formatWebhookError = (error, options) => {
+    switch (error._tag) {
+        case "ValidationError":
+            return error.format(options);
+        case "RateLimitError":
+            return `${error.message} (retryAfter=${error.retryAfter}ms)`;
+        case "HttpError": {
+            const status = error.response?.status;
+            return status ? `${error.message} (status=${status})` : error.message;
+        }
+        default:
+            return error.message;
+    }
+};
+/**
+ * Produce a structured log object for any webhook error.
+ */
+export const webhookErrorToLogObject = (error) => {
+    switch (error._tag) {
+        case "ValidationError":
+            return {
+                tag: error._tag,
+                message: error.message,
+                issues: error.issues,
+                field: error.field,
+                value: error.value,
+            };
+        case "RateLimitError":
+            return {
+                tag: error._tag,
+                message: error.message,
+                retryAfter: error.retryAfter,
+                limit: error.limit,
+                remaining: error.remaining,
+                reset: error.reset,
+            };
+        case "HttpError":
+            return {
+                tag: error._tag,
+                message: error.message,
+                request: error.request,
+                response: error.response,
+            };
+        case "NetworkError":
+            return {
+                tag: error._tag,
+                message: error.message,
+                statusCode: error.statusCode,
+                response: error.response,
+            };
+        case "ConfigError":
+            return {
+                tag: error._tag,
+                message: error.message,
+                parameter: error.parameter,
+            };
+        case "FileError":
+            return {
+                tag: error._tag,
+                message: error.message,
+                filename: error.filename,
+                size: error.size,
+                maxSize: error.maxSize,
+            };
+        default:
+            return {
+                tag: error._tag,
+                message: error.message,
+                cause: error.cause,
+            };
+    }
+};
+//# sourceMappingURL=WebhookError.js.map

package/dist/errors/WebhookError.js.map

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

package/dist/errors/index.js

@@ -0,0 +1,2 @@
+export * from "./WebhookError";
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/index.d.ts

@@ -28,7 +28,7 @@
  * @packageDocumentation
  */
 /** Error types for handling webhook failures */
-export { ConfigError, FileError, HttpError, type HttpErrorResponse, makeIssue, NetworkError, parseErrorToIssues, RateLimitError, ValidationError, type ValidationIssue, WebhookError, type WebhookErrors, } from "./errors";
+export { ConfigError, FileError, formatWebhookError, HttpError, type HttpErrorResponse, makeIssue, NetworkError, parseErrorToIssues, RateLimitError, ValidationError, type ValidationIssue, webhookErrorToLogObject, WebhookError, type WebhookErrors, } from "./errors";
 /**
  * Configuration service and layers.
  * Use makeConfigLayer for programmatic config or ConfigFromEnv for environment variables.
@@ -38,7 +38,11 @@ export { Config, ConfigFromEnv, makeConfig, makeConfigLayer, parseWebhookUrl, ty
  * HTTP client service and layers.
  * Provides fetch-based HTTP client with retry and rate limit support.
  */
-export { createRetrySchedule, defaultRetryConfig, FetchHttpClient, HttpClient, HttpClientLive, type HttpRequest, type HttpResponse, makeHttpClientLayer, parseRateLimitHeaders, type RateLimitInfo, type RetryConfig, } from "./layers/HttpClient";
+export { createRetrySchedule, defaultRetryConfig, FetchHttpClient, HttpClient, HttpClientLive, type HttpRequest, type HttpResponse, makeHttpClientLayer, makeTestHttpClient, parseRateLimitHeaders, type RateLimitInfo, type RetryConfig, } from "./layers/HttpClient";
+/**
+ * Convenience layer to wire Config + HttpClient + WebhookService.
+ */
+export { makeDefaultLayer } from "./layers/Default";
 /**
  * Embed builder namespace.
  * Pipe-first API for building Discord embed objects.
@@ -82,4 +86,4 @@ export * from "./schemas";
  * Webhook service and module-level accessors.
  * Use these with Effect.flatMap or Effect.gen for sending webhooks.
  */
-export { deleteWebhook, getWebhook, makeWebhookService, modifyWebhook, sendWebhook, validateWebhook, WebhookService, WebhookServiceLive, } from "./services/WebhookService";
+export { deleteWebhook, getWebhook, makeWebhookService, modifyWebhook, sendWebhook, sendWebhookRaw, validateWebhook, type SendWebhookRawResult, WebhookService, WebhookServiceLive, } from "./services/WebhookService";