@37signals/fizzy 0.1.0

package/dist/hooks.js

@@ -0,0 +1,130 @@
+/**
+ * Observability hooks system for the Fizzy SDK.
+ *
+ * Provides a way to observe API operations and HTTP requests
+ * without modifying the core client logic.
+ */
+/**
+ * Combines multiple hooks into a single hooks object.
+ */
+export function chainHooks(...hooks) {
+    const activeHooks = hooks.filter(Boolean);
+    if (activeHooks.length === 0)
+        return {};
+    if (activeHooks.length === 1)
+        return activeHooks[0];
+    return {
+        onOperationStart: (info) => {
+            for (const h of activeHooks) {
+                try {
+                    h.onOperationStart?.(info);
+                }
+                catch { /* hooks must not interrupt */ }
+            }
+        },
+        onOperationEnd: (info, result) => {
+            for (const h of activeHooks) {
+                try {
+                    h.onOperationEnd?.(info, result);
+                }
+                catch { /* hooks must not interrupt */ }
+            }
+        },
+        onRequestStart: (info) => {
+            for (const h of activeHooks) {
+                try {
+                    h.onRequestStart?.(info);
+                }
+                catch { /* hooks must not interrupt */ }
+            }
+        },
+        onRequestEnd: (info, result) => {
+            for (const h of activeHooks) {
+                try {
+                    h.onRequestEnd?.(info, result);
+                }
+                catch { /* hooks must not interrupt */ }
+            }
+        },
+        onRetry: (info, attempt, error, delayMs) => {
+            for (const h of activeHooks) {
+                try {
+                    h.onRetry?.(info, attempt, error, delayMs);
+                }
+                catch { /* hooks must not interrupt */ }
+            }
+        },
+    };
+}
+/**
+ * Creates hooks that log to the console.
+ */
+export function consoleHooks(options = {}) {
+    const { logOperations = true, logRequests = false, logRetries = true, minDurationMs = 0, logger = console, } = options;
+    return {
+        onOperationStart: logOperations
+            ? (info) => {
+                const mutation = info.isMutation ? " [mutation]" : "";
+                const resource = info.resourceId ? ` #${info.resourceId}` : "";
+                const board = info.boardId ? ` (board: ${info.boardId})` : "";
+                logger.log(`[Fizzy] ${info.service}.${info.operation}${resource}${board}${mutation}`);
+            }
+            : undefined,
+        onOperationEnd: logOperations
+            ? (info, result) => {
+                if (result.durationMs < minDurationMs)
+                    return;
+                const duration = `${result.durationMs}ms`;
+                if (result.error) {
+                    logger.error(`[Fizzy] ${info.service}.${info.operation} failed (${duration}):`, result.error.message);
+                }
+                else {
+                    logger.log(`[Fizzy] ${info.service}.${info.operation} completed (${duration})`);
+                }
+            }
+            : undefined,
+        onRequestStart: logRequests
+            ? (info) => {
+                const retry = info.attempt > 1 ? ` (attempt ${info.attempt})` : "";
+                logger.log(`[Fizzy] -> ${info.method} ${info.url}${retry}`);
+            }
+            : undefined,
+        onRequestEnd: logRequests
+            ? (info, result) => {
+                if (result.durationMs < minDurationMs)
+                    return;
+                const cache = result.fromCache ? " (cached)" : "";
+                const status = result.error ? "error" : result.statusCode;
+                logger.log(`[Fizzy] <- ${info.method} ${info.url} ${status} (${result.durationMs}ms)${cache}`);
+            }
+            : undefined,
+        onRetry: logRetries
+            ? (info, attempt, error, delayMs) => {
+                logger.warn(`[Fizzy] Retrying ${info.method} ${info.url} (attempt ${attempt + 1}, waiting ${delayMs}ms): ${error.message}`);
+            }
+            : undefined,
+    };
+}
+/**
+ * Creates a no-op hooks object.
+ */
+export function noopHooks() {
+    return {};
+}
+/**
+ * Internal helper to safely invoke a hook.
+ */
+export function safeInvoke(hooks, hookName, ...args) {
+    if (!hooks)
+        return;
+    const hook = hooks[hookName];
+    if (!hook)
+        return;
+    try {
+        hook(...args);
+    }
+    catch (err) {
+        console.error(`Hook ${hookName} error:`, err);
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Fizzy TypeScript SDK
+ *
+ * Type-safe client for the Fizzy API.
+ *
+ * @example
+ * ```ts
+ * import { createFizzyClient } from "@37signals/fizzy";
+ *
+ * const client = createFizzyClient({
+ *   accessToken: process.env.FIZZY_TOKEN!,
+ * });
+ *
+ * // High-level service methods
+ * const boards = await client.boards.list();
+ * const card = await client.cards.create(boardId, {
+ *   title: "Ship the feature",
+ * });
+ *
+ * // Or use low-level typed API calls
+ * const { data, error } = await client.GET("/boards.json");
+ *
+ * if (data) {
+ *   console.log(data.map(b => b.name));
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createFizzyClient, VERSION, API_VERSION, type FizzyClient, type FizzyClientOptions, type TokenProvider, type RawClient, } from "./client.js";
+export { type AuthStrategy, BearerAuth, bearerAuth } from "./auth-strategy.js";
+export { CookieAuth, cookieAuth, type CookieProvider } from "./auth/cookie-auth.js";
+export { MagicLinkFlow, type MagicLinkFlowOptions, type MagicLinkRequestResult, type MagicLinkRedeemResult } from "./auth/magic-link.js";
+export { fetchAllPages, paginateAll } from "./client.js";
+export { ListResult, type ListMeta, type PaginationOptions } from "./pagination.js";
+export { parseNextLink, resolveURL, isSameOrigin } from "./pagination-utils.js";
+export { FizzyError, Errors, errorFromResponse, isFizzyError, isErrorCode, type ErrorCode, type FizzyErrorOptions, } from "./errors.js";
+export { chainHooks, consoleHooks, noopHooks, safeInvoke, type FizzyHooks, type OperationInfo, type RequestInfo, type RequestResult, type OperationResult, type ConsoleHooksOptions, } from "./hooks.js";
+export { BaseService, type FetchResponse } from "./services/base.js";
+export { IdentityService, type Identity, } from "./generated/services/identity.js";
+export { BoardsService, type Board, type CreateBoardRequest, type UpdateBoardRequest, } from "./generated/services/boards.js";
+export { ColumnsService, type Column, type CreateColumnRequest, type UpdateColumnRequest, } from "./generated/services/columns.js";
+export { CardsService, type Card, type CreateCardRequest, type UpdateCardRequest, type MoveCardRequest, type AssignCardRequest, type TagCardRequest, } from "./generated/services/cards.js";
+export { CommentsService, type Comment, type CreateCommentRequest, type UpdateCommentRequest, } from "./generated/services/comments.js";
+export { StepsService, type Step, type CreateStepRequest, type UpdateStepRequest, } from "./generated/services/steps.js";
+export { ReactionsService, type Reaction, type CreateCardReactionRequest, type CreateCommentReactionRequest, } from "./generated/services/reactions.js";
+export { NotificationsService, type Notification, } from "./generated/services/notifications.js";
+export { TagsService, type Tag, } from "./generated/services/tags.js";
+export { UsersService, type User, type UpdateUserRequest, } from "./generated/services/users.js";
+export { PinsService, } from "./generated/services/pins.js";
+export { UploadsService, type DirectUpload, type CreateDirectUploadRequest, } from "./generated/services/uploads.js";
+export { WebhooksService, type Webhook, type CreateWebhookRequest, type UpdateWebhookRequest, } from "./generated/services/webhooks.js";
+export { SessionsService, type CreateSessionRequest, type RedeemMagicLinkRequest, type CompleteSignupRequest, } from "./generated/services/sessions.js";
+export { DevicesService, type RegisterDeviceRequest, } from "./generated/services/devices.js";
+export { MiscellaneousService, type CreateAccessTokenRequest, type UpdateAccountEntropyRequest, type UpdateJoinCodeRequest, type UpdateAccountSettingsRequest, type UpdateBoardEntropyRequest, type UpdateBoardInvolvementRequest, type UpdateNotificationSettingsRequest, type CreatePushSubscriptionRequest, type UpdateUserRoleRequest, } from "./generated/services/miscellaneous.js";
+export { WebhookReceiver, WebhookVerificationError, type WebhookEvent, type WebhookEventHandler, type WebhookMiddleware, type WebhookReceiverOptions, type HeaderAccessor, } from "./webhooks/handler.js";
+export { verifyWebhookSignature, signWebhookPayload } from "./webhooks/verify.js";
+export { ETagCache, type ETagCacheOptions } from "./cache/etag-cache.js";
+export { CircuitBreaker, type CircuitBreakerOptions, Bulkhead, type BulkheadOptions, RateLimiter, type RateLimiterOptions, type ResilienceConfig, createResilienceComponents, resilienceHooks, } from "./resilience/index.js";
+export { gatingHooks, type GatingHooks, } from "./hooks/gating.js";
+export { otelHooks, type OtelHooksOptions, } from "./hooks/otel.js";
+export { redactHeaders, redactHeadersRecord, } from "./security.js";
+export type { paths } from "./generated/schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,97 @@
+/**
+ * Fizzy TypeScript SDK
+ *
+ * Type-safe client for the Fizzy API.
+ *
+ * @example
+ * ```ts
+ * import { createFizzyClient } from "@37signals/fizzy";
+ *
+ * const client = createFizzyClient({
+ *   accessToken: process.env.FIZZY_TOKEN!,
+ * });
+ *
+ * // High-level service methods
+ * const boards = await client.boards.list();
+ * const card = await client.cards.create(boardId, {
+ *   title: "Ship the feature",
+ * });
+ *
+ * // Or use low-level typed API calls
+ * const { data, error } = await client.GET("/boards.json");
+ *
+ * if (data) {
+ *   console.log(data.map(b => b.name));
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Main client factory
+export { createFizzyClient, VERSION, API_VERSION, } from "./client.js";
+// Authentication strategies
+export { BearerAuth, bearerAuth } from "./auth-strategy.js";
+export { CookieAuth, cookieAuth } from "./auth/cookie-auth.js";
+export { MagicLinkFlow } from "./auth/magic-link.js";
+// Pagination helpers
+export { fetchAllPages, paginateAll } from "./client.js";
+// Pagination types and utilities
+export { ListResult } from "./pagination.js";
+export { parseNextLink, resolveURL, isSameOrigin } from "./pagination-utils.js";
+// Errors
+export { FizzyError, Errors, errorFromResponse, isFizzyError, isErrorCode, } from "./errors.js";
+// Hooks
+export { chainHooks, consoleHooks, noopHooks, safeInvoke, } from "./hooks.js";
+// =============================================================================
+// Services - Generated from OpenAPI spec (spec-driven)
+// =============================================================================
+// Base service (for extending)
+export { BaseService } from "./services/base.js";
+// Identity service
+export { IdentityService, } from "./generated/services/identity.js";
+// Core services
+export { BoardsService, } from "./generated/services/boards.js";
+export { ColumnsService, } from "./generated/services/columns.js";
+export { CardsService, } from "./generated/services/cards.js";
+export { CommentsService, } from "./generated/services/comments.js";
+export { StepsService, } from "./generated/services/steps.js";
+export { ReactionsService, } from "./generated/services/reactions.js";
+export { NotificationsService, } from "./generated/services/notifications.js";
+export { TagsService, } from "./generated/services/tags.js";
+export { UsersService, } from "./generated/services/users.js";
+export { PinsService, } from "./generated/services/pins.js";
+export { UploadsService, } from "./generated/services/uploads.js";
+// Webhooks management service
+export { WebhooksService, } from "./generated/services/webhooks.js";
+// Sessions service
+export { SessionsService, } from "./generated/services/sessions.js";
+// Devices service
+export { DevicesService, } from "./generated/services/devices.js";
+// Miscellaneous service (access tokens, account/board settings, entropy, etc.)
+export { MiscellaneousService, } from "./generated/services/miscellaneous.js";
+// =============================================================================
+// Webhook Receiving Infrastructure (hand-written, framework-agnostic)
+// =============================================================================
+export { WebhookReceiver, WebhookVerificationError, } from "./webhooks/handler.js";
+export { verifyWebhookSignature, signWebhookPayload } from "./webhooks/verify.js";
+// =============================================================================
+// Cache
+// =============================================================================
+export { ETagCache } from "./cache/etag-cache.js";
+// =============================================================================
+// Resilience
+// =============================================================================
+export { CircuitBreaker, Bulkhead, RateLimiter, createResilienceComponents, resilienceHooks, } from "./resilience/index.js";
+// =============================================================================
+// Gating hooks (circuit breaker, rate limiter integration)
+// =============================================================================
+export { gatingHooks, } from "./hooks/gating.js";
+// =============================================================================
+// OpenTelemetry hooks
+// =============================================================================
+export { otelHooks, } from "./hooks/otel.js";
+// =============================================================================
+// Security Utilities
+// =============================================================================
+export { redactHeaders, redactHeadersRecord, } from "./security.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/pagination-utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Pagination utility functions.
+ *
+ * Extracted to its own module to avoid circular dependencies between
+ * client.ts (which imports generated services) and base.ts (which
+ * generated services extend).
+ */
+/**
+ * Parses the next URL from a Link header.
+ * Looks for rel="next" in the header value.
+ */
+export declare function parseNextLink(linkHeader: string | null): string | null;
+/**
+ * Resolves a possibly-relative URL against a base URL.
+ * If target is already absolute, it is returned unchanged.
+ */
+export declare function resolveURL(base: string, target: string): string;
+/**
+ * Checks whether two absolute URLs share the same origin (scheme + host + port).
+ */
+export declare function isSameOrigin(a: string, b: string): boolean;
+//# sourceMappingURL=pagination-utils.d.ts.map

package/dist/pagination-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-utils.d.ts","sourceRoot":"","sources":["../src/pagination-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CActE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAQ1D"}

package/dist/pagination-utils.js

@@ -0,0 +1,52 @@
+/**
+ * Pagination utility functions.
+ *
+ * Extracted to its own module to avoid circular dependencies between
+ * client.ts (which imports generated services) and base.ts (which
+ * generated services extend).
+ */
+/**
+ * Parses the next URL from a Link header.
+ * Looks for rel="next" in the header value.
+ */
+export function parseNextLink(linkHeader) {
+    if (!linkHeader)
+        return null;
+    for (const part of linkHeader.split(",")) {
+        const trimmed = part.trim();
+        if (trimmed.includes('rel="next"')) {
+            const start = trimmed.indexOf("<");
+            const end = trimmed.indexOf(">", start);
+            if (start !== -1 && end !== -1)
+                return trimmed.slice(start + 1, end);
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Resolves a possibly-relative URL against a base URL.
+ * If target is already absolute, it is returned unchanged.
+ */
+export function resolveURL(base, target) {
+    try {
+        return new URL(target, base).href;
+    }
+    catch {
+        return target;
+    }
+}
+/**
+ * Checks whether two absolute URLs share the same origin (scheme + host + port).
+ */
+export function isSameOrigin(a, b) {
+    try {
+        const urlA = new URL(a);
+        const urlB = new URL(b);
+        return urlA.origin === urlB.origin;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=pagination-utils.js.map

package/dist/pagination-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-utils.js","sourceRoot":"","sources":["../src/pagination-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,UAAyB;IACrD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;gBAAE,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YACrE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAc;IACrD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,CAAS;IAC/C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/pagination.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Pagination types and utilities for the Fizzy SDK.
+ *
+ * Provides ListResult (an Array subclass with metadata) and pagination options.
+ * Fizzy does not emit X-Total-Count headers — totalCount is not available.
+ */
+/**
+ * Metadata about a paginated list response.
+ * Note: Fizzy does not provide a total count header.
+ */
+export interface ListMeta {
+    /** True when results were truncated (by maxItems or page safety cap). */
+    readonly truncated: boolean;
+}
+/**
+ * Options for controlling pagination behavior.
+ */
+export interface PaginationOptions {
+    /**
+     * Maximum number of items to return across all pages.
+     * When undefined or 0, all pages are fetched.
+     */
+    maxItems?: number;
+}
+/**
+ * An array of results with pagination metadata.
+ *
+ * Extends Array<T> so it's fully backwards-compatible: works with
+ * .forEach(), .map(), spread, .length, indexing, and Array.isArray().
+ * Additional metadata is accessible via the `.meta` property.
+ */
+export declare class ListResult<T> extends Array<T> {
+    readonly meta: ListMeta;
+    static get [Symbol.species](): ArrayConstructor;
+    constructor(items: T[], meta: ListMeta);
+}
+//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAExB,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAE9C;gBAEW,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ;CAUvC"}

package/dist/pagination.js

@@ -0,0 +1,30 @@
+/**
+ * Pagination types and utilities for the Fizzy SDK.
+ *
+ * Provides ListResult (an Array subclass with metadata) and pagination options.
+ * Fizzy does not emit X-Total-Count headers — totalCount is not available.
+ */
+/**
+ * An array of results with pagination metadata.
+ *
+ * Extends Array<T> so it's fully backwards-compatible: works with
+ * .forEach(), .map(), spread, .length, indexing, and Array.isArray().
+ * Additional metadata is accessible via the `.meta` property.
+ */
+export class ListResult extends Array {
+    meta;
+    static get [Symbol.species]() {
+        return Array;
+    }
+    constructor(items, meta) {
+        super(0);
+        if (items.length > 0) {
+            this.length = items.length;
+            for (let i = 0; i < items.length; i++) {
+                this[i] = items[i];
+            }
+        }
+        this.meta = meta;
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH;;;;;;GAMG;AACH,MAAM,OAAO,UAAc,SAAQ,KAAQ;IAChC,IAAI,CAAW;IAExB,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,YAAY,KAAU,EAAE,IAAc;QACpC,KAAK,CAAC,CAAC,CAAC,CAAC;QACT,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACtB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/resilience/bulkhead.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Bulkhead (concurrency limiter) for the Fizzy SDK.
+ *
+ * Limits the number of concurrent in-flight requests to prevent
+ * resource exhaustion and provide backpressure.
+ */
+export interface BulkheadOptions {
+    /** Maximum concurrent executions (default: 10) */
+    maxConcurrent?: number;
+    /** Maximum queue size for waiting requests (default: 100, 0 = no queue) */
+    maxQueue?: number;
+}
+/**
+ * Concurrency limiter that queues excess requests.
+ */
+export declare class Bulkhead {
+    private active;
+    private readonly queue;
+    private readonly maxConcurrent;
+    private readonly maxQueue;
+    constructor(options?: BulkheadOptions);
+    /** Number of currently active executions. */
+    get activeCount(): number;
+    /** Number of requests waiting in the queue. */
+    get queueLength(): number;
+    /**
+     * Execute a function with concurrency limiting.
+     * If at capacity, queues the request. If the queue is full, rejects immediately.
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    private acquire;
+    private release;
+}
+//# sourceMappingURL=bulkhead.d.ts.map

package/dist/resilience/bulkhead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkhead.d.ts","sourceRoot":"","sources":["../../src/resilience/bulkhead.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,CAAC,EAAE,eAAe;IAKrC,6CAA6C;IAC7C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,+CAA+C;IAC/C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;OAGG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASlD,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,OAAO;CAQhB"}

package/dist/resilience/bulkhead.js

@@ -0,0 +1,65 @@
+/**
+ * Bulkhead (concurrency limiter) for the Fizzy SDK.
+ *
+ * Limits the number of concurrent in-flight requests to prevent
+ * resource exhaustion and provide backpressure.
+ */
+import { FizzyError } from "../errors.js";
+/**
+ * Concurrency limiter that queues excess requests.
+ */
+export class Bulkhead {
+    active = 0;
+    queue = [];
+    maxConcurrent;
+    maxQueue;
+    constructor(options) {
+        this.maxConcurrent = options?.maxConcurrent ?? 10;
+        this.maxQueue = options?.maxQueue ?? 100;
+    }
+    /** Number of currently active executions. */
+    get activeCount() {
+        return this.active;
+    }
+    /** Number of requests waiting in the queue. */
+    get queueLength() {
+        return this.queue.length;
+    }
+    /**
+     * Execute a function with concurrency limiting.
+     * If at capacity, queues the request. If the queue is full, rejects immediately.
+     */
+    async execute(fn) {
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+    acquire() {
+        if (this.active < this.maxConcurrent) {
+            this.active++;
+            return Promise.resolve();
+        }
+        if (this.queue.length >= this.maxQueue) {
+            return Promise.reject(new FizzyError("api_error", "Bulkhead queue full — too many concurrent requests", {
+                hint: "Reduce concurrency or increase bulkhead limits",
+            }));
+        }
+        return new Promise((resolve, reject) => {
+            this.queue.push({ resolve, reject });
+        });
+    }
+    release() {
+        const next = this.queue.shift();
+        if (next) {
+            next.resolve();
+        }
+        else {
+            this.active--;
+        }
+    }
+}
+//# sourceMappingURL=bulkhead.js.map

package/dist/resilience/bulkhead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkhead.js","sourceRoot":"","sources":["../../src/resilience/bulkhead.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc1C;;GAEG;AACH,MAAM,OAAO,QAAQ;IACX,MAAM,GAAG,CAAC,CAAC;IACF,KAAK,GAAiB,EAAE,CAAC;IACzB,aAAa,CAAS;IACtB,QAAQ,CAAS;IAElC,YAAY,OAAyB;QACnC,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC;IAC3C,CAAC;IAED,6CAA6C;IAC7C,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,+CAA+C;IAC/C,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAI,EAAoB;QACnC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvC,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,UAAU,CAAC,WAAW,EAAE,oDAAoD,EAAE;gBAChF,IAAI,EAAE,gDAAgD;aACvD,CAAC,CACH,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;CACF"}

package/dist/resilience/circuit-breaker.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Circuit breaker for the Fizzy SDK.
+ *
+ * Prevents cascading failures by tracking error rates and temporarily
+ * stopping requests when the failure threshold is exceeded.
+ */
+export type CircuitState = "closed" | "open" | "half-open";
+export interface CircuitBreakerOptions {
+    /** Number of failures before opening the circuit (default: 5) */
+    failureThreshold?: number;
+    /** Time in ms before attempting to half-open (default: 30000) */
+    resetTimeoutMs?: number;
+    /** Number of successful requests to close from half-open (default: 1) */
+    successThreshold?: number;
+}
+/**
+ * Circuit breaker implementation using the standard closed/open/half-open pattern.
+ */
+export declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private successCount;
+    private lastFailureTime;
+    private readonly failureThreshold;
+    private readonly resetTimeoutMs;
+    private readonly successThreshold;
+    constructor(options?: CircuitBreakerOptions);
+    /** Current circuit state. */
+    get currentState(): CircuitState;
+    /**
+     * Check if a request is allowed through the circuit.
+     * Returns true if the circuit is closed or half-open.
+     */
+    allowRequest(): boolean;
+    /**
+     * Record a successful request.
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed request.
+     */
+    recordFailure(): void;
+    /**
+     * Reset the circuit breaker to closed state.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/resilience/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/resilience/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,OAAO,CAAC,EAAE,qBAAqB;IAM3C,6BAA6B;IAC7B,IAAI,YAAY,IAAI,YAAY,CAK/B;IAED;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,aAAa,IAAI,IAAI;IAarB;;OAEG;IACH,aAAa,IAAI,IAAI;IAUrB;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd"}