@buenojs/bueno 0.8.5 → 0.8.7

package/dist/graphql/metadata.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GraphQL Metadata Storage
+ *
+ * Isolated metadata storage using WeakMap, following the same pattern
+ * as src/openapi/metadata.ts and src/modules/metadata.ts.
+ * Fully self-contained — no imports from openapi/ or modules/.
+ */
+import type { Constructor, FieldMetadata, ResolverFieldMetadata, ResolverClassMetadata, TypeClassMetadata, ParamMetadata } from "./types";
+export declare function setGqlClassMetadata(target: Constructor, key: string, value: unknown): void;
+export declare function getGqlClassMetadata<T>(target: Constructor, key: string): T | undefined;
+export declare function setGqlPrototypeMetadata(target: object, key: string, value: unknown): void;
+export declare function getGqlPrototypeMetadata<T>(target: object, key: string): T | undefined;
+export declare function setGqlPropertyMetadata(target: object, propertyKey: string | symbol, value: FieldMetadata): void;
+export declare function getGqlPropertyMetadata(target: object, propertyKey: string | symbol): FieldMetadata | undefined;
+export declare function getGqlPropertyKeys(target: object): string[];
+export declare function getAllGqlPropertyMetadata(target: object): FieldMetadata[];
+export declare const GQL_RESOLVER_KEY = "gql:resolver";
+export declare const GQL_OBJECTTYPE_KEY = "gql:objecttype";
+export declare const GQL_INPUTTYPE_KEY = "gql:inputtype";
+export declare const GQL_QUERIES_KEY = "gql:queries";
+export declare const GQL_MUTATIONS_KEY = "gql:mutations";
+export declare const GQL_SUBSCRIPTIONS_KEY = "gql:subscriptions";
+export declare const GQL_PARAMS_PREFIX = "gql:params:";
+export declare function getResolverMetadata(target: Constructor): ResolverClassMetadata | undefined;
+export declare function setResolverMetadata(target: Constructor, metadata: ResolverClassMetadata): void;
+export declare function getTypeMetadata(target: Constructor): TypeClassMetadata | undefined;
+export declare function setObjectTypeMetadata(target: Constructor, metadata: TypeClassMetadata): void;
+export declare function setInputTypeMetadata(target: Constructor, metadata: TypeClassMetadata): void;
+export declare function addQueryField(prototype: object, field: ResolverFieldMetadata): void;
+export declare function addMutationField(prototype: object, field: ResolverFieldMetadata): void;
+export declare function addSubscriptionField(prototype: object, field: ResolverFieldMetadata): void;
+export declare function getQueryFields(prototype: object): ResolverFieldMetadata[];
+export declare function getMutationFields(prototype: object): ResolverFieldMetadata[];
+export declare function getSubscriptionFields(prototype: object): ResolverFieldMetadata[];
+export declare function setParamMetadata(prototype: object, methodName: string, paramIndex: number, meta: ParamMetadata): void;
+export declare function getParamMetadata(prototype: object, methodName: string): ParamMetadata[];
+//# sourceMappingURL=metadata.d.ts.map

package/dist/graphql/metadata.d.ts.map

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

package/dist/graphql/schema-builder.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Schema Builder
+ *
+ * Reads GraphQL decorator metadata from resolver and type classes,
+ * generates SDL (Schema Definition Language), and builds the internal
+ * ResolvedSchema used by the built-in engine.
+ */
+import type { Constructor, TypeFn, FieldMetadata, ResolvedSchema, ResolverFieldsByType } from "./types";
+/** Map JS constructors to GraphQL scalar names */
+export declare function typeFnToScalarName(typeFn: TypeFn): string | null;
+/** Convert a TypeFn to an SDL type string */
+export declare function typeFnToSDL(typeFn: TypeFn, nullable: boolean): string;
+export interface BuiltSchema {
+    sdl: string;
+    resolvedSchema: ResolvedSchema;
+    resolverFields: ResolverFieldsByType;
+    typeFields: Map<string, FieldMetadata[]>;
+}
+export declare class SchemaBuilder {
+    private resolverClasses;
+    private resolverInstances;
+    private typeClasses;
+    constructor(resolverClasses: Constructor[], resolverInstances: Map<Constructor, unknown>);
+    build(): BuiltSchema;
+    private toResolvedField;
+    private collectReturnType;
+    private collectNestedTypes;
+    private buildTypeFields;
+    private generateSDL;
+    private buildArgsSDL;
+}
+export declare function registerTypeClass(ctor: Constructor): void;
+export declare function getRegisteredTypeClasses(): Constructor[];
+//# sourceMappingURL=schema-builder.d.ts.map

package/dist/graphql/schema-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.d.ts","sourceRoot":"","sources":["../../src/graphql/schema-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,MAAM,EACN,aAAa,EAGb,cAAc,EACd,oBAAoB,EAIpB,MAAM,SAAS,CAAC;AAejB,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYhE;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAkBrE;AAID,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,oBAAoB,CAAC;IACrC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CACzC;AAED,qBAAa,aAAa;IAKxB,OAAO,CAAC,eAAe;IAJxB,OAAO,CAAC,iBAAiB,CAA4B;IACrD,OAAO,CAAC,WAAW,CAA+B;gBAGzC,eAAe,EAAE,WAAW,EAAE,EACtC,iBAAiB,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC;IAK7C,KAAK,IAAI,WAAW;IAoDpB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,WAAW;IA6EnB,OAAO,CAAC,YAAY;CA6BpB;AAOD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAEzD;AAED,wBAAgB,wBAAwB,IAAI,WAAW,EAAE,CAExD"}

package/dist/graphql/subscription-handler.d.ts

@@ -0,0 +1,47 @@
+/**
+ * GraphQL Subscription Handler
+ *
+ * Implements the graphql-transport-ws protocol over Bun's native WebSocket.
+ * Registered via app.setWebSocketHandler() so subscriptions run on the same
+ * port as the HTTP server — no separate port needed.
+ *
+ * Protocol spec: https://github.com/enisdenjo/graphql-ws/blob/master/PROTOCOL.md
+ *
+ * ## Usage
+ * Automatically configured by GraphQLModule.setup() when subscriptions: true.
+ * Requires an engine with supportsSubscriptions = true (e.g. GraphQLJsAdapter).
+ */
+import type { GraphQLEngine } from "./types";
+import type { Container } from "../container";
+import type { Guard, Interceptor } from "./execution-pipeline";
+interface WsData {
+    connectionId: string;
+}
+export declare class SubscriptionHandler {
+    private engine;
+    private engineSchema;
+    private graphqlPath;
+    private container;
+    private globalGuards;
+    private globalInterceptors;
+    private connections;
+    constructor(engine: GraphQLEngine, engineSchema: unknown, graphqlPath: string, container: Container, globalGuards: Guard[], globalInterceptors: Interceptor[]);
+    /**
+     * Returns a Bun WebSocketHandler to register on the server via app.setWebSocketHandler().
+     * Attaches an __upgradeHandler so Application.listen() can delegate WebSocket upgrades.
+     */
+    getWebSocketConfig(): Bun.WebSocketHandler<WsData> & {
+        __upgradeHandler: (req: Request, srv: Bun.Server) => Response | undefined;
+    };
+    /**
+     * Middleware-like upgrade handler.
+     * Call this from the app's fetch function for WebSocket upgrade requests.
+     * Returns a Response if not a GraphQL WS path, undefined if upgraded.
+     */
+    handleUpgrade(req: Request, server: Bun.Server): Response | undefined;
+    private handleMessage;
+    private handleSubscribe;
+    private send;
+}
+export {};
+//# sourceMappingURL=subscription-handler.d.ts.map

package/dist/graphql/subscription-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-handler.d.ts","sourceRoot":"","sources":["../../src/graphql/subscription-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAkC,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAoD/D,UAAU,MAAM;IACf,YAAY,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,mBAAmB;IAI9B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,kBAAkB;IAR3B,OAAO,CAAC,WAAW,CAAsC;gBAGhD,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,KAAK,EAAE,EACrB,kBAAkB,EAAE,WAAW,EAAE;IAG1C;;;OAGG;IACH,kBAAkB,IAAI,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG;QAAE,gBAAgB,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAA;KAAE;IA2ClI;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,QAAQ,GAAG,SAAS;YAwBvD,aAAa;YA0Cb,eAAe;IAuE7B,OAAO,CAAC,IAAI;CAOZ"}

package/dist/graphql/types.d.ts

@@ -0,0 +1,252 @@
+/**
+ * GraphQL Module Types
+ *
+ * Core type definitions for the Bueno GraphQL integration layer.
+ */
+export type Constructor<T = unknown> = new (...args: unknown[]) => T;
+/**
+ * Represents a GraphQL scalar type via its JS constructor.
+ * Usage: () => String, () => Number, () => Boolean, () => GraphQLID
+ */
+export type GraphQLScalar = StringConstructor | NumberConstructor | BooleanConstructor | typeof GraphQLID | typeof GraphQLInt | typeof GraphQLFloat;
+/**
+ * A thunk that returns a type constructor or array of constructors.
+ * Used to avoid circular reference issues in type definitions.
+ *
+ * @example
+ * () => String        // GraphQL String scalar
+ * () => Number        // GraphQL Float scalar
+ * () => [User]        // [User!]! list
+ * () => User          // User object type
+ */
+export type TypeFn = () => Constructor | Constructor[] | GraphQLScalar;
+/**
+ * Sentinel class representing GraphQL ID scalar.
+ * Usage: @Field(() => GraphQLID)
+ */
+export declare class GraphQLID {
+    static readonly __type = "ID";
+}
+/**
+ * Sentinel class representing GraphQL Int scalar.
+ * Usage: @Field(() => GraphQLInt)
+ */
+export declare class GraphQLInt {
+    static readonly __type = "Int";
+}
+/**
+ * Sentinel class representing GraphQL Float scalar.
+ * Usage: @Field(() => GraphQLFloat)
+ */
+export declare class GraphQLFloat {
+    static readonly __type = "Float";
+}
+/** Options for @Field decorator */
+export interface FieldDecoratorOptions {
+    /** Whether the field can be null (default: false → non-null) */
+    nullable?: boolean;
+    /** Human-readable description */
+    description?: string;
+    /** Deprecation reason */
+    deprecationReason?: string;
+    /** Default value for input types */
+    defaultValue?: unknown;
+}
+/** Options for @Query/@Mutation/@Subscription decorators */
+export interface FieldOptions extends FieldDecoratorOptions {
+    /** GraphQL field name override (default: method name) */
+    name?: string;
+}
+/** Metadata stored per @Field-decorated property */
+export interface FieldMetadata {
+    propertyKey: string;
+    typeFn: TypeFn;
+    nullable: boolean;
+    description?: string;
+    deprecationReason?: string;
+    defaultValue?: unknown;
+}
+/** Metadata for a single resolver method parameter */
+export interface ParamMetadata {
+    index: number;
+    kind: "args" | "argsObject" | "context";
+    /** For @Args('name') — the specific argument name */
+    argName?: string;
+    /** For @Args('name', InputType) — the input object type */
+    inputTypeFn?: TypeFn;
+}
+/** Metadata stored per @Query/@Mutation/@Subscription method */
+export interface ResolverFieldMetadata {
+    /** Actual method name on the class */
+    methodName: string;
+    /** GraphQL field name (defaults to methodName) */
+    fieldName: string;
+    typeFn: TypeFn;
+    kind: "query" | "mutation" | "subscription";
+    nullable: boolean;
+    description?: string;
+    deprecationReason?: string;
+    paramMetadata: ParamMetadata[];
+}
+/** Metadata stored per @Resolver-decorated class */
+export interface ResolverClassMetadata {
+    /** GraphQL type name (default: class name) */
+    name: string;
+}
+/** Metadata stored per @ObjectType / @InputType class */
+export interface TypeClassMetadata {
+    name: string;
+    kind: "object" | "input";
+    description?: string;
+}
+/** A single resolvable field in the built schema */
+export interface ResolvedField {
+    resolverInstance: unknown;
+    methodName: string;
+    paramMetadata: ParamMetadata[];
+    typeFn: TypeFn;
+    nullable: boolean;
+}
+/** Internal schema representation consumed by the built-in engine */
+export interface ResolvedSchema {
+    queryFields: Map<string, ResolvedField>;
+    mutationFields: Map<string, ResolvedField>;
+    subscriptionFields: Map<string, ResolvedField>;
+}
+/** Context available inside resolver methods */
+export interface GraphQLContext {
+    /** The original HTTP Request */
+    request: Request;
+    /** Authenticated user (set by auth guards via context.set('user', ...)) */
+    user?: unknown;
+    /** Reference to the HTTP Context for advanced use */
+    httpContext: unknown;
+    /** Allow arbitrary values */
+    [key: string]: unknown;
+}
+/** A GraphQL error entry in the response */
+export interface GraphQLError {
+    message: string;
+    locations?: Array<{
+        line: number;
+        column: number;
+    }>;
+    path?: Array<string | number>;
+    extensions?: Record<string, unknown>;
+}
+/** The GraphQL response envelope */
+export interface GraphQLResult {
+    data?: Record<string, unknown> | null;
+    errors?: GraphQLError[];
+}
+/**
+ * Pluggable GraphQL execution engine.
+ * Implement this interface to use graphql-js, GraphQL Yoga, Mercurius, etc.
+ *
+ * @example
+ * ```typescript
+ * import * as graphqlJs from 'graphql';
+ * import { GraphQLJsAdapter } from '@buenojs/bueno/graphql';
+ *
+ * GraphQLModule.setup(app, {
+ *   engine: new GraphQLJsAdapter(graphqlJs),
+ *   resolvers: [UserResolver],
+ * });
+ * ```
+ */
+export interface GraphQLEngine {
+    /**
+     * Build the internal schema representation from resolver and type metadata.
+     * Returns an opaque schema object that is passed back to execute().
+     */
+    buildSchema(resolvers: ResolverFieldsByType, types: Map<string, FieldMetadata[]>, sdl: string): unknown;
+    /**
+     * Execute a GraphQL query or mutation.
+     */
+    execute(schema: unknown, query: string, variables: Record<string, unknown>, context: GraphQLContext, operationName?: string): Promise<GraphQLResult>;
+    /**
+     * Execute a GraphQL subscription (optional).
+     * Returns an async generator that yields results.
+     */
+    subscribe?(schema: unknown, query: string, variables: Record<string, unknown>, context: GraphQLContext, operationName?: string): Promise<AsyncGenerator<GraphQLResult>>;
+    /**
+     * Whether this engine supports introspection queries.
+     * Used to determine if the GraphQL Playground should be enabled.
+     */
+    readonly supportsIntrospection: boolean;
+    /**
+     * Whether this engine supports subscriptions.
+     */
+    readonly supportsSubscriptions: boolean;
+}
+/** Resolver fields organized by root type */
+export interface ResolverFieldsByType {
+    queries: Map<string, ResolvedField>;
+    mutations: Map<string, ResolvedField>;
+    subscriptions: Map<string, ResolvedField>;
+}
+/**
+ * Options passed to GraphQLModule.setup()
+ */
+export interface GraphQLModuleOptions {
+    /**
+     * Resolver classes to register.
+     * Dependencies are resolved from the DI container.
+     */
+    resolvers: Constructor[];
+    /**
+     * GraphQL engine adapter (default: built-in lightweight engine).
+     * Use GraphQLJsAdapter for full spec compliance.
+     */
+    engine?: GraphQLEngine;
+    /**
+     * HTTP path for the GraphQL endpoint (default: '/graphql').
+     */
+    path?: string;
+    /**
+     * Enable GraphiQL playground UI at GET <path>.
+     * Default: true when using an engine with supportsIntrospection,
+     *          false when using the built-in engine.
+     * Set to true to force-enable even with the built-in engine (with warning).
+     */
+    playground?: boolean;
+    /**
+     * Serve the SDL at GET <path>/schema (default: true).
+     */
+    introspection?: boolean;
+    /**
+     * Enable WebSocket subscriptions (default: false).
+     * Requires an engine with supportsSubscriptions.
+     */
+    subscriptions?: boolean;
+    /**
+     * Sync @Field metadata to the OpenAPI property store (default: false).
+     * Enables unified types: one class works for both GraphQL and REST/OpenAPI.
+     * Requires @buenojs/bueno/openapi to be in scope.
+     */
+    syncOpenAPI?: boolean;
+    /** Maximum query complexity score (default: 1000) */
+    complexityLimit?: number;
+    /** Maximum query depth (default: 10) */
+    maxDepth?: number;
+}
+/**
+ * GraphQL configuration added to BuenoConfig.
+ */
+export interface GraphQLConfig {
+    /** Enable GraphQL support (default: false) */
+    enabled?: boolean;
+    /** HTTP path (default: '/graphql') */
+    path?: string;
+    /** Enable playground (default: auto) */
+    playground?: boolean;
+    /** Enable introspection SDL endpoint (default: true) */
+    introspection?: boolean;
+    /** Maximum query complexity (default: 1000) */
+    complexityLimit?: number;
+    /** Maximum query depth (default: 10) */
+    maxDepth?: number;
+    /** Enable subscriptions (default: false) */
+    subscriptions?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/graphql/types.d.ts.map

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

package/dist/health/index.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Health Check System
+ *
+ * Provides health check endpoints for production monitoring:
+ * - /health (liveness probe) - Returns 200 if server is running
+ * - /ready (readiness probe) - Returns 200 only if all checks pass
+ */
+import type { Middleware } from "../middleware";
+/**
+ * Health check status
+ */
+export type HealthStatus = "healthy" | "unhealthy" | "degraded";
+/**
+ * Individual check result
+ */
+export interface CheckResult {
+    status: HealthStatus;
+    latency?: number;
+    message?: string;
+}
+/**
+ * Overall health check result
+ */
+export interface HealthCheckResult {
+    status: HealthStatus;
+    timestamp: string;
+    version?: string;
+    uptime?: number;
+    checks?: Record<string, CheckResult>;
+}
+/**
+ * Health check function type
+ */
+export type HealthCheckFn = () => Promise<CheckResult> | CheckResult;
+/**
+ * Options for individual health checks
+ */
+export interface CheckOptions {
+    /** Whether this check is critical for readiness (default: true) */
+    critical?: boolean;
+    /** Timeout in milliseconds (default: 5000) */
+    timeout?: number;
+    /** Description of the check */
+    description?: string;
+}
+/**
+ * Options for health middleware
+ */
+export interface HealthMiddlewareOptions {
+    /** Path for liveness probe (default: /health) */
+    healthPath?: string;
+    /** Path for readiness probe (default: /ready) */
+    readyPath?: string;
+    /** Whether to expose metrics in response (default: true) */
+    exposeMetrics?: boolean;
+    /** Initial health checks to register */
+    checks?: Record<string, HealthCheckFn | {
+        fn: HealthCheckFn;
+        options?: CheckOptions;
+    }>;
+    /** Custom version string (default: from package.json) */
+    version?: string;
+}
+/**
+ * Database interface for built-in checker
+ */
+export interface DatabaseLike {
+    query?(sql: string): Promise<unknown>;
+    execute?(sql: string): Promise<unknown>;
+    healthCheck?(): Promise<boolean>;
+}
+/**
+ * Cache interface for built-in checker
+ */
+export interface CacheLike {
+    get?(key: string): Promise<unknown>;
+    set?(key: string, value: unknown): Promise<unknown>;
+    ping?(): Promise<unknown>;
+    healthCheck?(): Promise<boolean>;
+}
+/**
+ * Manages health checks for the application
+ */
+export declare class HealthCheckManager {
+    private checks;
+    private startTime;
+    private version;
+    constructor(version?: string);
+    /**
+     * Register a health check
+     */
+    registerCheck(name: string, checkFn: HealthCheckFn, options?: CheckOptions): this;
+    /**
+     * Remove a health check
+     */
+    removeCheck(name: string): boolean;
+    /**
+     * Get all registered check names
+     */
+    getCheckNames(): string[];
+    /**
+     * Check if a check is registered
+     */
+    hasCheck(name: string): boolean;
+    /**
+     * Run a single check with timeout
+     */
+    private runSingleCheck;
+    /**
+     * Execute all registered checks
+     */
+    runChecks(): Promise<Record<string, CheckResult>>;
+    /**
+     * Get liveness status (lightweight - no dependency checks)
+     */
+    getHealth(): HealthCheckResult;
+    /**
+     * Get readiness status (runs all checks)
+     */
+    getReadiness(): Promise<HealthCheckResult>;
+    /**
+     * Get uptime in seconds
+     */
+    getUptime(): number;
+    /**
+     * Reset start time (useful for testing)
+     */
+    resetStartTime(): void;
+}
+/**
+ * Create health check middleware
+ */
+export declare function createHealthMiddleware(options?: HealthMiddlewareOptions): {
+    middleware: Middleware;
+    manager: HealthCheckManager;
+};
+/**
+ * Create a database connectivity check
+ */
+export declare function createDatabaseCheck(db: DatabaseLike, options?: {
+    query?: string;
+    timeout?: number;
+}): HealthCheckFn;
+/**
+ * Create a cache connectivity check
+ */
+export declare function createCacheCheck(cache: CacheLike, options?: {
+    testKey?: string;
+    timeout?: number;
+}): HealthCheckFn;
+/**
+ * Create a custom health check with timeout
+ */
+export declare function createCustomCheck(checkFn: () => Promise<boolean> | boolean, options?: {
+    message?: string;
+    timeout?: number;
+}): HealthCheckFn;
+/**
+ * Create a TCP port check
+ */
+export declare function createTCPCheck(host: string, port: number, options?: {
+    timeout?: number;
+}): HealthCheckFn;
+/**
+ * Create an HTTP endpoint check
+ */
+export declare function createHTTPCheck(url: string, options?: {
+    expectedStatus?: number;
+    timeout?: number;
+    headers?: Record<string, string>;
+}): HealthCheckFn;
+/**
+ * Create a new health check manager
+ */
+export declare function createHealthManager(version?: string): HealthCheckManager;
+//# sourceMappingURL=index.d.ts.map

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

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