@classytic/arc 2.3.0 → 2.4.2

package/dist/plugins/index.d.mts

@@ -1,92 +1,43 @@
-import "../elevation-DGo5shaX.mjs";
-import { K as HookSystem, w as ResourceRegistry } from "../interface-BtdYtQUA.mjs";
-import "../types-RLkFVgaw.mjs";
-import { AdditionalRoute, AnyRecord, MiddlewareConfig, PresetHook, RouteSchemaOptions } from "../types/index.mjs";
-import { t as ExternalOpenApiPaths } from "../externalPaths-SyPF2tgK.mjs";
-import { a as ssePlugin, c as _default$1, i as _default$5, l as cachingPlugin, n as errorHandlerPlugin, o as CachingOptions, r as SSEOptions, s as CachingRule, t as ErrorHandlerOptions } from "../errorHandler-CW3OOeYq.mjs";
-import { t as TracingOptions } from "../tracing-8CEbhF0w.mjs";
+import { B as MiddlewareConfig, It as ResourceRegistry, J as PresetHook, c as AdditionalRoute, in as HookSystem, l as AnyRecord, lt as RouteSchemaOptions } from "../interface-DGmPxakH.mjs";
+import { t as ExternalOpenApiPaths } from "../externalPaths-DpO-s7r8.mjs";
+import { _ as cachingPlugin, a as versioningPlugin, c as MetricsOptions, d as SSEOptions, f as _default$6, g as _default$1, h as CachingRule, i as _default$7, l as _default$4, m as CachingOptions, n as errorHandlerPlugin, o as MetricEntry, p as ssePlugin, r as VersioningOptions, s as MetricsCollector, t as ErrorHandlerOptions, u as metricsPlugin } from "../errorHandler-Do4vVQ1f.mjs";
+import { t as TracingOptions } from "../tracing-bz_U4EM1.mjs";
 import { FastifyInstance, FastifyPluginAsync } from "fastify";
 
-//#region src/plugins/requestId.d.ts
-interface RequestIdOptions {
-  /** Header name to read/write request ID (default: 'x-request-id') */
-  header?: string;
-  /** Custom ID generator (default: crypto.randomUUID) */
-  generator?: () => string;
-  /** Whether to set response header (default: true) */
-  setResponseHeader?: boolean;
-}
-declare module 'fastify' {
-  interface FastifyRequest {
-    /** Unique request identifier for tracing */
-    requestId: string;
-  }
-}
-declare const requestIdPlugin: FastifyPluginAsync<RequestIdOptions>;
-declare const _default$4: FastifyPluginAsync<RequestIdOptions>;
-//#endregion
-//#region src/plugins/health.d.ts
-declare module 'fastify' {
-  interface FastifyRequest {
-    _startTime?: number;
-  }
+//#region src/core/arcCorePlugin.d.ts
+interface ArcCorePluginOptions {
+  /** Enable event emission for CRUD operations (requires eventPlugin) */
+  emitEvents?: boolean;
+  /** Hook system instance (for testing/custom setup) */
+  hookSystem?: HookSystem;
+  /** Resource registry instance (for testing/custom setup) */
+  registry?: ResourceRegistry;
 }
-interface HealthCheck {
-  /** Name of the dependency */
+interface PluginMeta {
   name: string;
-  /** Function that returns true if healthy, false otherwise */
-  check: () => Promise<boolean> | boolean;
-  /** Optional timeout in ms (default: 5000) */
-  timeout?: number;
-  /** Whether this check is critical for readiness (default: true) */
-  critical?: boolean;
-}
-interface HealthOptions {
-  /** Route prefix (default: '/_health') */
-  prefix?: string;
-  /** Health check dependencies */
-  checks?: HealthCheck[];
-  /** Enable metrics endpoint (default: false) */
-  metrics?: boolean;
-  /** Custom metrics collector function */
-  metricsCollector?: () => Promise<string> | string;
-  /** Version info to include in responses */
   version?: string;
-  /** Collect HTTP request metrics (default: true if metrics enabled) */
-  collectHttpMetrics?: boolean;
+  options?: Record<string, unknown>;
+  registeredAt: string;
 }
-declare const healthPlugin: FastifyPluginAsync<HealthOptions>;
-declare const _default$3: FastifyPluginAsync<HealthOptions>;
-//#endregion
-//#region src/plugins/gracefulShutdown.d.ts
-interface GracefulShutdownOptions {
-  /** Maximum time to wait for graceful shutdown in ms (default: 30000) */
-  timeout?: number;
-  /** Custom cleanup function called before exit */
-  onShutdown?: () => Promise<void> | void;
-  /** Signals to handle (default: ['SIGTERM', 'SIGINT']) */
-  signals?: NodeJS.Signals[];
-  /** Whether to log shutdown events (default: true) */
-  logEvents?: boolean;
-  /**
-   * Called when shutdown times out or encounters an error.
-   * Defaults to `process.exit(1)` — appropriate for production but dangerous in:
-   * - **Tests**: kills the test runner. Pass `() => {}` or `() => { throw … }`.
-   * - **Shared runtimes** (e.g., serverless): may kill unrelated handlers.
-   *
-   * @param reason - `'timeout'` if shutdown exceeded `timeout` ms,
-   *                 `'error'` if `onShutdown` or `fastify.close()` threw.
-   */
-  onForceExit?: (reason: 'timeout' | 'error') => void;
+interface ArcCore {
+  /** Instance-scoped hook system */
+  hooks: HookSystem;
+  /** Instance-scoped resource registry */
+  registry: ResourceRegistry;
+  /** Whether event emission is enabled */
+  emitEvents: boolean;
+  /** External OpenAPI paths contributed by auth adapters or third-party integrations */
+  externalOpenApiPaths: ExternalOpenApiPaths[];
+  /** Registered plugins for introspection */
+  plugins: Map<string, PluginMeta>;
 }
-declare const gracefulShutdownPlugin: FastifyPluginAsync<GracefulShutdownOptions>;
-declare module 'fastify' {
+declare module "fastify" {
   interface FastifyInstance {
-    /** Trigger graceful shutdown manually */
-    shutdown: () => Promise<void>;
+    arc: ArcCore;
   }
 }
-declare const _default$2: FastifyPluginAsync<GracefulShutdownOptions>;
+declare const arcCorePlugin: FastifyPluginAsync<ArcCorePluginOptions>;
+declare const _default: FastifyPluginAsync<ArcCorePluginOptions>;
 //#endregion
 //#region src/plugins/createPlugin.d.ts
 interface PluginResourceResult {
@@ -134,39 +85,85 @@ interface ArcPlugin<TRootOpts extends AnyRecord = AnyRecord, TResourceOpts exten
  */
 declare function createPlugin<TRootOpts extends AnyRecord = AnyRecord, TResourceOpts extends AnyRecord = AnyRecord>(name: string, definition: CreatePluginDefinition<TRootOpts, TResourceOpts>): ArcPlugin<TRootOpts, TResourceOpts>;
 //#endregion
-//#region src/core/arcCorePlugin.d.ts
-interface ArcCorePluginOptions {
-  /** Enable event emission for CRUD operations (requires eventPlugin) */
-  emitEvents?: boolean;
-  /** Hook system instance (for testing/custom setup) */
-  hookSystem?: HookSystem;
-  /** Resource registry instance (for testing/custom setup) */
-  registry?: ResourceRegistry;
+//#region src/plugins/gracefulShutdown.d.ts
+interface GracefulShutdownOptions {
+  /** Maximum time to wait for graceful shutdown in ms (default: 30000) */
+  timeout?: number;
+  /** Custom cleanup function called before exit */
+  onShutdown?: () => Promise<void> | void;
+  /** Signals to handle (default: ['SIGTERM', 'SIGINT']) */
+  signals?: NodeJS.Signals[];
+  /** Whether to log shutdown events (default: true) */
+  logEvents?: boolean;
+  /**
+   * Called when shutdown times out or encounters an error.
+   * Defaults to `process.exit(1)` — appropriate for production but dangerous in:
+   * - **Tests**: kills the test runner. Pass `() => {}` or `() => { throw … }`.
+   * - **Shared runtimes** (e.g., serverless): may kill unrelated handlers.
+   *
+   * @param reason - `'timeout'` if shutdown exceeded `timeout` ms,
+   *                 `'error'` if `onShutdown` or `fastify.close()` threw.
+   */
+  onForceExit?: (reason: "timeout" | "error") => void;
 }
-interface PluginMeta {
+declare const gracefulShutdownPlugin: FastifyPluginAsync<GracefulShutdownOptions>;
+declare module "fastify" {
+  interface FastifyInstance {
+    /** Trigger graceful shutdown manually */
+    shutdown: () => Promise<void>;
+  }
+}
+declare const _default$2: FastifyPluginAsync<GracefulShutdownOptions>;
+//#endregion
+//#region src/plugins/health.d.ts
+declare module "fastify" {
+  interface FastifyRequest {
+    _startTime?: number;
+  }
+}
+interface HealthCheck {
+  /** Name of the dependency */
   name: string;
+  /** Function that returns true if healthy, false otherwise */
+  check: () => Promise<boolean> | boolean;
+  /** Optional timeout in ms (default: 5000) */
+  timeout?: number;
+  /** Whether this check is critical for readiness (default: true) */
+  critical?: boolean;
+}
+interface HealthOptions {
+  /** Route prefix (default: '/_health') */
+  prefix?: string;
+  /** Health check dependencies */
+  checks?: HealthCheck[];
+  /** Enable metrics endpoint (default: false) */
+  metrics?: boolean;
+  /** Custom metrics collector function */
+  metricsCollector?: () => Promise<string> | string;
+  /** Version info to include in responses */
   version?: string;
-  options?: Record<string, unknown>;
-  registeredAt: string;
+  /** Collect HTTP request metrics (default: true if metrics enabled) */
+  collectHttpMetrics?: boolean;
 }
-interface ArcCore {
-  /** Instance-scoped hook system */
-  hooks: HookSystem;
-  /** Instance-scoped resource registry */
-  registry: ResourceRegistry;
-  /** Whether event emission is enabled */
-  emitEvents: boolean;
-  /** External OpenAPI paths contributed by auth adapters or third-party integrations */
-  externalOpenApiPaths: ExternalOpenApiPaths[];
-  /** Registered plugins for introspection */
-  plugins: Map<string, PluginMeta>;
+declare const healthPlugin: FastifyPluginAsync<HealthOptions>;
+declare const _default$3: FastifyPluginAsync<HealthOptions>;
+//#endregion
+//#region src/plugins/requestId.d.ts
+interface RequestIdOptions {
+  /** Header name to read/write request ID (default: 'x-request-id') */
+  header?: string;
+  /** Custom ID generator (default: crypto.randomUUID) */
+  generator?: () => string;
+  /** Whether to set response header (default: true) */
+  setResponseHeader?: boolean;
 }
-declare module 'fastify' {
-  interface FastifyInstance {
-    arc: ArcCore;
+declare module "fastify" {
+  interface FastifyRequest {
+    /** Unique request identifier for tracing */
+    requestId: string;
   }
 }
-declare const arcCorePlugin: FastifyPluginAsync<ArcCorePluginOptions>;
-declare const _default: FastifyPluginAsync<ArcCorePluginOptions>;
+declare const requestIdPlugin: FastifyPluginAsync<RequestIdOptions>;
+declare const _default$5: FastifyPluginAsync<RequestIdOptions>;
 //#endregion
-export { type ArcCore, type ArcCorePluginOptions, type ArcPlugin, type CachingOptions, type CachingRule, type CreatePluginDefinition, type ErrorHandlerOptions, type GracefulShutdownOptions, type HealthCheck, type HealthOptions, type PluginMeta, type PluginResourceResult, type RequestIdOptions, type SSEOptions, type TracingOptions, _default as arcCorePlugin, arcCorePlugin as arcCorePluginFn, _default$1 as cachingPlugin, cachingPlugin as cachingPluginFn, createPlugin, errorHandlerPlugin, errorHandlerPlugin as errorHandlerPluginFn, _default$2 as gracefulShutdownPlugin, gracefulShutdownPlugin as gracefulShutdownPluginFn, _default$3 as healthPlugin, healthPlugin as healthPluginFn, _default$4 as requestIdPlugin, requestIdPlugin as requestIdPluginFn, _default$5 as ssePlugin, ssePlugin as ssePluginFn };
+export { type ArcCore, type ArcCorePluginOptions, type ArcPlugin, type CachingOptions, type CachingRule, type CreatePluginDefinition, type ErrorHandlerOptions, type GracefulShutdownOptions, type HealthCheck, type HealthOptions, type MetricEntry, type MetricsCollector, type MetricsOptions, type PluginMeta, type PluginResourceResult, type RequestIdOptions, type SSEOptions, type TracingOptions, type VersioningOptions, _default as arcCorePlugin, arcCorePlugin as arcCorePluginFn, _default$1 as cachingPlugin, cachingPlugin as cachingPluginFn, createPlugin, errorHandlerPlugin, errorHandlerPlugin as errorHandlerPluginFn, _default$2 as gracefulShutdownPlugin, gracefulShutdownPlugin as gracefulShutdownPluginFn, _default$3 as healthPlugin, healthPlugin as healthPluginFn, _default$4 as metricsPlugin, metricsPlugin as metricsPluginFn, _default$5 as requestIdPlugin, requestIdPlugin as requestIdPluginFn, _default$6 as ssePlugin, ssePlugin as ssePluginFn, _default$7 as versioningPlugin, versioningPlugin as versioningPluginFn };