@plyaz/core 1.2.0 → 1.3.0

package/dist/backend/featureFlags/feature-flag.module.d.ts

@@ -1,54 +1,62 @@
 /**
- * Feature Flag Module
+ * Feature Flag NestJS Module
  *
- * NestJS module for feature flag functionality.
- * Configures providers, controllers, and dependencies.
+ * NestJS wrapper around the unified FeatureFlagModule.
+ * Adds the controller for REST API endpoints.
  *
- * @fileoverview NestJS module for feature flags
+ * @example
+ * ```typescript
+ * import { FeatureFlagModule } from '@plyaz/core/backend/featureFlags';
+ *
+ * @Module({
+ *   imports: [FeatureFlagModule.forRoot({ provider: 'database' })],
+ * })
+ * export class AppModule {}
+ * ```
  */
+import { type DynamicModule, type OnModuleDestroy, type Type, type ForwardReference, type InjectionToken } from '@nestjs/common';
+import { CoreFeatureFlagModuleConfig } from '@plyaz/types/core';
 /**
  * Feature Flag Module
  *
  * Provides feature flag functionality as a NestJS module.
- * Can be imported by other modules to access feature flag services.
+ * Uses the domain FeatureFlagService directly - no NestJS wrapper needed.
  *
  * @example
  * ```typescript
  * // In your app.module.ts
- * import { FeatureFlagModule } from '@plyaz/config/backend/featureFlags';
- *
  * @Module({
- *   imports: [FeatureFlagModule],
- *   // ... other module configuration
+ *   imports: [
+ *     FeatureFlagModule.forRoot({ provider: 'database' })
+ *   ],
  * })
  * export class AppModule {}
  * ```
  *
  * @example
  * ```typescript
- * // In your service
- * import { FeatureFlagService } from '@plyaz/config/backend/featureFlags';
- *
+ * // In your service - inject the domain service
  * @Injectable()
  * export class MyService {
- *   constructor(private readonly featureFlagService: FeatureFlagService) {}
+ *   constructor(
+ *     @Inject(FEATURE_FLAG_SERVICE)
+ *     private readonly featureFlagService: FeatureFlagService<FeatureFlagKey>
+ *   ) {}
  *
  *   async doSomething() {
  *     const isEnabled = await this.featureFlagService.isEnabled('MY_FEATURE');
- *     if (isEnabled) {
- *       // Execute new feature logic
- *     }
  *   }
  * }
  * ```
  */
-export declare class FeatureFlagModule {
+export declare class FeatureFlagModule implements OnModuleDestroy {
+    private static serviceInstance;
+    onModuleDestroy(): void;
     /**
-     * Static method for importing the module with configuration.
-     * This allows customization of the feature flag system.
+     * Creates the module with configuration.
      *
      * @param options - Module configuration options
-     * @returns Configured module
+     * @returns Configured dynamic module
      *
      * @example
      * ```typescript
@@ -56,7 +64,7 @@ export declare class FeatureFlagModule {
      *   imports: [
      *     FeatureFlagModule.forRoot({
      *       provider: 'database',
-     *       isCacheEnabled: true,
+     *       cacheEnabled: true,
      *       cacheTtl: 600,
      *     })
      *   ],
@@ -64,23 +72,13 @@ export declare class FeatureFlagModule {
      * export class AppModule {}
      * ```
      */
-    static forRoot(options?: {
-        provider?: 'memory' | 'database' | 'redis' | 'api' | 'file';
-        isCacheEnabled?: boolean;
-        cacheTtl?: number;
-        refreshInterval?: number;
-        isLoggingEnabled?: boolean;
-    }): {
-        module: typeof FeatureFlagModule;
-        providers: unknown[];
-        exports: unknown[];
-    };
+    static forRoot(options?: CoreFeatureFlagModuleConfig): DynamicModule;
     /**
-     * Static method for importing the module asynchronously.
+     * Creates the module with async configuration.
      * Useful when configuration depends on other services.
      *
      * @param options - Async module configuration options
-     * @returns Configured async module
+     * @returns Configured async dynamic module
      *
      * @example
      * ```typescript
@@ -100,14 +98,9 @@ export declare class FeatureFlagModule {
      * ```
      */
     static forRootAsync(options: {
-        imports?: unknown[];
-        inject?: unknown[];
-        useFactory?: (...args: unknown[]) => unknown;
-    }): {
-        module: typeof FeatureFlagModule;
-        imports: unknown[];
-        providers: unknown[];
-        exports: unknown[];
-    };
+        imports?: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
+        inject?: InjectionToken[];
+        useFactory: (...args: unknown[]) => CoreFeatureFlagModuleConfig | Promise<CoreFeatureFlagModuleConfig>;
+    }): DynamicModule;
 }
 //# sourceMappingURL=feature-flag.module.d.ts.map

package/dist/backend/featureFlags/feature-flag.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flag.module.d.ts","sourceRoot":"","sources":["../../../src/backend/featureFlags/feature-flag.module.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAMa,iBAAiB;IAC5B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACvB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;QAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,GAAG;QACF,MAAM,EAAE,OAAO,iBAAiB,CAAC;QACjC,SAAS,EAAE,OAAO,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,CAAC;KACpB;IAkBD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;KAC9C,GAAG;QACF,MAAM,EAAE,OAAO,iBAAiB,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,CAAC;QACnB,SAAS,EAAE,OAAO,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,CAAC;KACpB;CAgBF"}
+{"version":3,"file":"feature-flag.module.d.ts","sourceRoot":"","sources":["../../../src/backend/featureFlags/feature-flag.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAIa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,MAAM,CAAC,eAAe,CAAmD;IAEjF,eAAe,IAAI,IAAI;IAOvB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,2BAAgC,GAAG,aAAa;IAgBxE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,OAAO,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,gBAAgB,CAAC,CAAC;QAC3F,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;QAC1B,UAAU,EAAE,CACV,GAAG,IAAI,EAAE,OAAO,EAAE,KACf,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;KACzE,GAAG,aAAa;CAkBlB"}

package/dist/backend/featureFlags/guards/feature-flag.guard.d.ts

@@ -1,15 +1,29 @@
 import { CanActivate, ExecutionContext } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
-import { FeatureFlagService } from '../feature-flag.service';
+import type { FeatureFlagKey } from '@domain/types';
+import { FeatureFlagService } from '@domain/featureFlags';
 /**
  * Guard that ensures a feature flag is in the expected state
  * before allowing access to a route handler.
+ *
+ * @example
+ * ```typescript
+ * @Controller('premium')
+ * @UseGuards(FeatureFlagGuard)
+ * export class PremiumController {
+ *   @Get()
+ *   @FeatureEnabled('PREMIUM_FEATURE')
+ *   getPremiumData() {
+ *     // Only accessible if PREMIUM_FEATURE is enabled
+ *   }
+ * }
+ * ```
  */
 export declare class FeatureFlagGuard implements CanActivate {
     private readonly reflector;
     private readonly featureFlagService;
     private readonly logger;
-    constructor(reflector: Reflector, featureFlagService: FeatureFlagService);
+    constructor(reflector: Reflector, featureFlagService: FeatureFlagService<FeatureFlagKey>);
     canActivate(context: ExecutionContext): Promise<boolean>;
     /**
      * Compare expected vs actual values.

package/dist/backend/featureFlags/guards/feature-flag.guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flag.guard.d.ts","sourceRoot":"","sources":["../../../../src/backend/featureFlags/guards/feature-flag.guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,WAAW,EAAE,gBAAgB,EAAU,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAI7D;;;GAGG;AACH,qBACa,gBAAiB,YAAW,WAAW;IAIhD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAJrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAGzC,SAAS,EAAE,SAAS,EACpB,kBAAkB,EAAE,kBAAkB;IAGnD,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IA+B9D;;OAEG;IACH,OAAO,CAAC,OAAO;CAUhB"}
+{"version":3,"file":"feature-flag.guard.d.ts","sourceRoot":"","sources":["../../../../src/backend/featureFlags/guards/feature-flag.guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,WAAW,EAAE,gBAAgB,EAAU,MAAM,gBAAgB,CAAC;AAEnF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAwB,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGhF;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,gBAAiB,YAAW,WAAW;IAOhD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IARrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGpB;gBAGgB,SAAS,EAAE,SAAS,EAEpB,kBAAkB,EAAE,kBAAkB,CAAC,cAAc,CAAC;IAGnE,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IA+B9D;;OAEG;IACH,OAAO,CAAC,OAAO;CAUhB"}

package/dist/backend/featureFlags/index.d.ts

@@ -1,15 +1,15 @@
 /**
- * Feature Flag Backend - Main Exports
+ * Feature Flag Backend - NestJS Exports
  *
- * NestJS backend exports for feature flag functionality.
- * Provides controllers, services, repositories, and module for easy integration.
+ * NestJS module with controller, guards, decorators, and interceptors.
+ * Uses shared service factory from domain.
  *
  * @fileoverview Backend feature flags exports
  */
+export { FeatureFlagDomainService } from './FeatureFlagDomainService';
 export { FeatureFlagModule } from './feature-flag.module';
-export { FeatureFlagService } from './feature-flag.service';
-export { FeatureFlagRepository } from './feature-flag.repository';
 export { FeatureFlagController } from './feature-flag.controller';
+export { FeatureFlagService, FeatureFlagServiceFactory } from '@domain/featureFlags';
 export { FeatureDisabled } from './decorators/feature-disabled.decorator';
 export { FeatureEnabled } from './decorators/feature-enabled.decorator';
 export { FeatureFlagGuard } from './guards/feature-flag.guard';
@@ -18,6 +18,5 @@ export { FeatureFlagLoggingInterceptor } from './interceptors/feature-flag-loggi
 export { ErrorHandlingInterceptor } from './interceptors/error-handling-interceptor';
 export { FeatureFlagConfigFactory } from './config/feature-flag.config';
 export { FeatureFlagConfigValidator } from './config/validation';
-export { DatabaseConnectionManager } from './database/connection';
-export { FeatureFlagDatabaseRepository } from './database/repository';
+export { FeatureFlagDatabaseRepository } from '@models/featureFlags';
 //# sourceMappingURL=index.d.ts.map

package/dist/backend/featureFlags/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/featureFlags/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAGxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,iDAAiD,CAAC;AAChG,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAGrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAExE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAIjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/featureFlags/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGrF,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAGxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,iDAAiD,CAAC;AAChG,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAGrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAGjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/backend/featureFlags/interceptors/error-handling-interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handling-interceptor.d.ts","sourceRoot":"","sources":["../../../../src/backend/featureFlags/interceptors/error-handling-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAU,MAAM,gBAAgB,CAAC;AAIpG,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAGlC;;;;;;;;GAQG;AACH,qBACa,wBAAyB,YAAW,eAAe;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IAEpE,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;CAwB7E"}
+{"version":3,"file":"error-handling-interceptor.d.ts","sourceRoot":"","sources":["../../../../src/backend/featureFlags/interceptors/error-handling-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAK5F,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAGlC;;;;;;;;GAQG;AACH,qBACa,wBAAyB,YAAW,eAAe;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGpB;IAEH,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;CAwB7E"}

package/dist/backend/featureFlags/interceptors/feature-flag-logging-interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flag-logging-interceptor.d.ts","sourceRoot":"","sources":["../../../../src/backend/featureFlags/interceptors/feature-flag-logging-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAU,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,UAAU,EAAO,MAAM,MAAM,CAAC;AAEvC;;;;;;;;;GASG;AAEH,qBACa,6BAA8B,YAAW,eAAe;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;IAEzE,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;IA0B5E,OAAO,CAAC,iBAAiB;CAI1B"}
+{"version":3,"file":"feature-flag-logging-interceptor.d.ts","sourceRoot":"","sources":["../../../../src/backend/featureFlags/interceptors/feature-flag-logging-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE5F,OAAO,EAAE,UAAU,EAAO,MAAM,MAAM,CAAC;AAEvC;;;;;;;;;GASG;AAEH,qBACa,6BAA8B,YAAW,eAAe;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGpB;IAEH,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;IA0B5E,OAAO,CAAC,iBAAiB;CAI1B"}

package/dist/backend/featureFlags/middleware/feature-flag-middleware.d.ts

@@ -1,11 +1,7 @@
 import { NestMiddleware } from '@nestjs/common';
-import { FeatureFlagService } from '../feature-flag.service';
-type FeatureFlagRequest = {
-    featureFlags?: Record<string, boolean>;
-    query?: Record<string, unknown> | URLSearchParams;
-    headers?: Record<string, string | string[] | undefined>;
-    url?: string;
-};
+import { FeatureFlagService } from '@domain/featureFlags';
+import type { FeatureFlagKey } from '@domain/types';
+import type { CoreFeatureFlagRequest } from '@plyaz/types/core';
 /**
  * FeatureFlagMiddleware - Evaluates and attaches feature flags to every request
  *
@@ -128,14 +124,14 @@ type FeatureFlagRequest = {
 export declare class FeatureFlagMiddleware implements NestMiddleware {
     private readonly featureFlagService;
     private readonly logger;
-    constructor(featureFlagService: FeatureFlagService);
+    constructor(featureFlagService: FeatureFlagService<FeatureFlagKey>);
     /**
      * Main middleware execution method
      *
      * @description Processes incoming requests to evaluate and attach feature flags.
      * Handles flag key extraction from multiple sources and graceful error handling.
      *
-     * @param {FeatureFlagRequest} req - Express request object with feature flag extensions
+     * @param {CoreFeatureFlagRequest} req - Express request object with feature flag extensions
      * @param {unknown} res - Express response object (not used in this middleware)
      * @param {Function} next - Next middleware function in the chain
      *
@@ -161,7 +157,6 @@ export declare class FeatureFlagMiddleware implements NestMiddleware {
      * next();
      * ```
      */
-    use(req: FeatureFlagRequest, res: unknown, next: (...args: unknown[]) => void): Promise<void>;
+    use(req: CoreFeatureFlagRequest, res: unknown, next: (...args: unknown[]) => void): Promise<void>;
 }
-export {};
 //# sourceMappingURL=feature-flag-middleware.d.ts.map

package/dist/backend/featureFlags/middleware/feature-flag-middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flag-middleware.d.ts","sourceRoot":"","sources":["../../../../src/backend/featureFlags/middleware/feature-flag-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,cAAc,EAAU,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAK7D,KAAK,kBAAkB,GAAG;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAOF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsHG;AACH,qBACa,qBAAsB,YAAW,cAAc;IAG9C,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAF/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;gBAEpC,kBAAkB,EAAE,kBAAkB;IAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IAEG,GAAG,CACP,GAAG,EAAE,kBAAkB,EACvB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACjC,OAAO,CAAC,IAAI,CAAC;CAoCjB"}
+{"version":3,"file":"feature-flag-middleware.d.ts","sourceRoot":"","sources":["../../../../src/backend/featureFlags/middleware/feature-flag-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,cAAc,EAAU,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EAAwB,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAShE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsHG;AACH,qBACa,qBAAsB,YAAW,cAAc;IAQxD,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAPrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGpB;gBAIgB,kBAAkB,EAAE,kBAAkB,CAAC,cAAc,CAAC;IAGzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IAEG,GAAG,CACP,GAAG,EAAE,sBAAsB,EAC3B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACjC,OAAO,CAAC,IAAI,CAAC;CAoCjB"}

package/dist/backend/index.d.ts

@@ -1,5 +1,10 @@
 /**
  * Backend Layer Exports
+ *
+ * NestJS-specific implementations.
+ * For framework-agnostic modules, use domain exports:
+ * - import { FeatureFlagModule } from '@plyaz/core/domain/featureFlags';
  */
+export * from './example';
 export * from './featureFlags';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,gBAAgB,CAAC"}

package/dist/base/cache/CacheKeyBuilder.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Cache Key Builder Utility
+ *
+ * Provides standardized methods for building cache keys with consistent patterns.
+ * All keys are designed to be prefixed by the service (handled by service layer).
+ *
+ * Key pattern: {prefix}:{type}:{identifier}:{params}
+ * Example: "example:entity:123" or "user:list:page:1"
+ *
+ * @fileoverview Cache key building utilities
+ */
+/**
+ * Cache key builder for standardized cache key generation.
+ *
+ * All methods return un-prefixed keys that should be prefixed by the service layer.
+ * This allows each service to namespace their cache keys.
+ *
+ * @example
+ * ```typescript
+ * // In a service with cachePrefix = 'user'
+ * const key = CacheKeyBuilder.entity('123');
+ * // Returns: "entity:123"
+ * // After service prefixing: "user:entity:123"
+ * ```
+ */
+export declare class CacheKeyBuilder {
+    /**
+     * Build cache key for a single entity by ID
+     *
+     * @param id - Entity ID
+     * @returns Cache key (unprefixed)
+     *
+     * @example
+     * ```typescript
+     * CacheKeyBuilder.entity('123')
+     * // Returns: "entity:123"
+     * // With prefix "user": "user:entity:123"
+     * ```
+     */
+    static entity(id: string): string;
+    /**
+     * Build cache key for a list/collection query
+     *
+     * @param params - Query parameters (page, limit, filters, etc.)
+     * @returns Cache key (unprefixed)
+     *
+     * @example
+     * ```typescript
+     * CacheKeyBuilder.list({ page: 1, limit: 10 })
+     * // Returns: "list:limit:10:page:1"
+     * // With prefix: "user:list:limit:10:page:1"
+     *
+     * CacheKeyBuilder.list() // No params
+     * // Returns: "list:all"
+     * ```
+     */
+    static list(params?: Record<string, unknown>): string;
+    /**
+     * Build cache key for a named query/filter
+     *
+     * @param queryName - Name of the query (e.g., 'active', 'byStatus', 'search')
+     * @param params - Query parameters
+     * @returns Cache key (unprefixed)
+     *
+     * @example
+     * ```typescript
+     * CacheKeyBuilder.query('active', { status: 'published' })
+     * // Returns: "query:active:status:\"published\""
+     *
+     * CacheKeyBuilder.query('search', { q: 'hello', limit: 10 })
+     * // Returns: "query:search:limit:10:q:\"hello\""
+     * ```
+     */
+    static query(queryName: string, params?: Record<string, unknown>): string;
+    /**
+     * Build cache key for aggregate/count operations
+     *
+     * @param operation - Operation name (e.g., 'count', 'sum', 'avg')
+     * @param field - Field name (optional)
+     * @param params - Additional parameters (optional)
+     * @returns Cache key (unprefixed)
+     *
+     * @example
+     * ```typescript
+     * CacheKeyBuilder.aggregate('count')
+     * // Returns: "aggregate:count"
+     *
+     * CacheKeyBuilder.aggregate('sum', 'amount')
+     * // Returns: "aggregate:sum:amount"
+     *
+     * CacheKeyBuilder.aggregate('count', 'users', { status: 'active' })
+     * // Returns: "aggregate:count:users:status:\"active\""
+     * ```
+     */
+    static aggregate(operation: string, field?: string, params?: Record<string, unknown>): string;
+    /**
+     * Build a custom cache key with type and identifier
+     *
+     * @param type - Cache key type
+     * @param identifier - Unique identifier for this cache entry
+     * @param params - Additional parameters (optional)
+     * @returns Cache key (unprefixed)
+     *
+     * @example
+     * ```typescript
+     * CacheKeyBuilder.custom('session', 'abc123')
+     * // Returns: "session:abc123"
+     *
+     * CacheKeyBuilder.custom('report', 'monthly', { year: 2025, month: 1 })
+     * // Returns: "report:monthly:month:1:year:2025"
+     * ```
+     */
+    static custom(type: string, identifier: string, params?: Record<string, unknown>): string;
+}
+//# sourceMappingURL=CacheKeyBuilder.d.ts.map

package/dist/base/cache/CacheKeyBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheKeyBuilder.d.ts","sourceRoot":"","sources":["../../../src/base/cache/CacheKeyBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;IAC1B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAIjC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAWrD;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAUzE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAY7F;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAS1F"}

package/dist/base/cache/index.d.ts

@@ -96,4 +96,5 @@ export declare class CacheManager {
     dispose(): Promise<void>;
 }
 export * from './feature/caching';
+export { CacheKeyBuilder } from './CacheKeyBuilder';
 //# sourceMappingURL=index.d.ts.map

package/dist/base/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAiB,WAAW,EAAc,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE9F;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAY;IAQX,OAAO,CAAC,MAAM;IAP1B,OAAO,CAAC,QAAQ,CAAgB;IAEhC;;;;OAIG;gBACiB,MAAM,EAAE,WAAW;IAIvC;;;;;;;;OAQG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAe5C;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAexC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAI5C;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IActB;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAED,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAiB,WAAW,EAAc,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE9F;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAY;IAQX,OAAO,CAAC,MAAM;IAP1B,OAAO,CAAC,QAAQ,CAAgB;IAEhC;;;;OAIG;gBACiB,MAAM,EAAE,WAAW;IAIvC;;;;;;;;OAQG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAe5C;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAexC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAI5C;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAiBtB;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAED,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/base/cache/strategies/redis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../../src/base/cache/strategies/redis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG5F;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IAgB1C,OAAO,CAAC,MAAM;IAf1B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;;OAIG;gBACiB,MAAM,EAAE,gBAAgB;IAO5C;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAuBxD;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAqBrC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;;;;OAKG;YACW,eAAe;IAc7B;;;;;OAKG;YACW,mBAAmB;IA4BjC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAGtB"}
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../../src/base/cache/strategies/redis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAK5F;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IAgB1C,OAAO,CAAC,MAAM;IAf1B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;;OAIG;gBACiB,MAAM,EAAE,gBAAgB;IAO5C;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAuBxD;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAqBrC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;;;;OAKG;YACW,eAAe;IAc7B;;;;;OAKG;YACW,mBAAmB;IA4BjC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAGtB"}

package/dist/base/observability/BaseAdapter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Base Observability Adapter
+ *
+ * Abstract base class for all observability adapters.
+ * Provides common functionality and enforces the adapter interface.
+ *
+ * @module base/observability
+ */
+import { PackageLogger } from '@plyaz/logger';
+import type { ObservabilityAdapter, ObservabilityAdapterConfig, ObservabilityProvider, Metric, SpanOptions, Span, LogEntry, ObservabilityEvent } from '@plyaz/types/observability';
+/**
+ * Abstract base class for observability adapters.
+ *
+ * Provides common functionality:
+ * - Initialization lifecycle
+ * - Default tag management
+ * - Error handling
+ * - Logging
+ *
+ * Subclasses must implement provider-specific methods.
+ */
+export declare abstract class BaseAdapter implements ObservabilityAdapter {
+    abstract readonly provider: ObservabilityProvider;
+    abstract readonly name: string;
+    protected _isInitialized: boolean;
+    protected _config: ObservabilityAdapterConfig | null;
+    protected readonly logger: PackageLogger;
+    constructor();
+    get isInitialized(): boolean;
+    get config(): ObservabilityAdapterConfig | null;
+    initialize(config: ObservabilityAdapterConfig): Promise<void>;
+    shutdown(): Promise<void>;
+    isHealthy(): Promise<boolean>;
+    protected abstract doInitialize(config: ObservabilityAdapterConfig): Promise<void>;
+    protected abstract doShutdown(): Promise<void>;
+    protected abstract doHealthCheck(): Promise<boolean>;
+    recordMetric(metric: Metric): Promise<void>;
+    incrementCounter(name: string, value?: number, tags?: Record<string, string>): Promise<void>;
+    setGauge(name: string, value: number, tags?: Record<string, string>): Promise<void>;
+    recordHistogram(name: string, value: number, tags?: Record<string, string>): Promise<void>;
+    protected abstract doRecordMetric(metric: Metric): Promise<void>;
+    startSpan(options: SpanOptions): Span;
+    getActiveSpan(): Span | null;
+    withSpan<T>(options: SpanOptions, fn: (span: Span) => Promise<T>): Promise<T>;
+    protected abstract doStartSpan(options: SpanOptions): Span;
+    protected abstract doGetActiveSpan(): Span | null;
+    log(entry: LogEntry): Promise<void>;
+    protected abstract doLog(entry: LogEntry): Promise<void>;
+    sendEvent(event: ObservabilityEvent): Promise<void>;
+    protected abstract doSendEvent(event: ObservabilityEvent): Promise<void>;
+    flush(): Promise<void>;
+    protected abstract doFlush(): Promise<void>;
+    /**
+     * Apply default tags to a metric
+     */
+    protected applyDefaultTags(metric: Metric): Metric;
+    /**
+     * Create a no-op span (for disabled/sampled-out traces)
+     */
+    protected createNoopSpan(_options: SpanOptions): Span;
+}
+/**
+ * No-op adapter that does nothing.
+ * Use when observability is disabled.
+ */
+export declare class NoopAdapter extends BaseAdapter {
+    readonly provider: "noop";
+    readonly name = "NoopAdapter";
+    protected doInitialize(): Promise<void>;
+    protected doShutdown(): Promise<void>;
+    protected doHealthCheck(): Promise<boolean>;
+    protected doRecordMetric(): Promise<void>;
+    protected doStartSpan(options: SpanOptions): Span;
+    protected doGetActiveSpan(): Span | null;
+    protected doLog(): Promise<void>;
+    protected doSendEvent(): Promise<void>;
+    protected doFlush(): Promise<void>;
+}
+//# sourceMappingURL=BaseAdapter.d.ts.map

package/dist/base/observability/BaseAdapter.d.ts.map

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

package/dist/base/observability/CompositeAdapter.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Composite Adapter
+ *
+ * Supports multiple observability providers running in parallel or priority (fallback) modes.
+ *
+ * - **Parallel mode**: Sends data to all adapters simultaneously
+ * - **Priority mode**: Tries first adapter, falls back to next on failure
+ *
+ * @module base/observability
+ */
+import type { ObservabilityAdapter, ObservabilityAdapterConfig, Metric, SpanOptions, Span, LogEntry, ObservabilityEvent } from '@plyaz/types/observability';
+/**
+ * Composite adapter that delegates to multiple child adapters.
+ *
+ * @example Parallel mode (send to all - e.g., Datadog + Console)
+ * ```typescript
+ * const composite = new CompositeAdapter();
+ * await composite.initialize({
+ *   mode: 'parallel',
+ *   adapters: [datadogAdapter, loggerAdapter],
+ *   failOnAnyError: false,
+ * });
+ * ```
+ *
+ * @example Priority mode (fallback chain)
+ * ```typescript
+ * const composite = new CompositeAdapter();
+ * await composite.initialize({
+ *   mode: 'priority',
+ *   adapters: [datadogAdapter, grafanaAdapter, loggerAdapter],
+ *   adapterTimeout: 5000,
+ * });
+ * ```
+ */
+export declare class CompositeAdapter implements ObservabilityAdapter {
+    readonly provider: "custom";
+    readonly name = "CompositeAdapter";
+    private _isInitialized;
+    private _config;
+    private adapters;
+    private mode;
+    private adapterTimeout;
+    private failOnAnyError;
+    private fallbackOnErrors;
+    private readonly logger;
+    constructor();
+    get isInitialized(): boolean;
+    initialize(config: ObservabilityAdapterConfig): Promise<void>;
+    shutdown(): Promise<void>;
+    isHealthy(): Promise<boolean>;
+    recordMetric(metric: Metric): Promise<void>;
+    incrementCounter(name: string, value?: number, tags?: Record<string, string>): Promise<void>;
+    setGauge(name: string, value: number, tags?: Record<string, string>): Promise<void>;
+    recordHistogram(name: string, value: number, tags?: Record<string, string>): Promise<void>;
+    startSpan(options: SpanOptions): Span;
+    getActiveSpan(): Span | null;
+    withSpan<T>(options: SpanOptions, fn: (span: Span) => Promise<T>): Promise<T>;
+    log(entry: LogEntry): Promise<void>;
+    sendEvent(event: ObservabilityEvent): Promise<void>;
+    flush(): Promise<void>;
+    private executeOnAdapters;
+    private executeParallel;
+    private executePriority;
+    private withTimeout;
+    /**
+     * Check if we should fallback on this error type
+     */
+    private shouldFallbackOnError;
+    private createCompositeSpan;
+    private createNoopSpan;
+}
+//# sourceMappingURL=CompositeAdapter.d.ts.map

package/dist/base/observability/CompositeAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeAdapter.d.ts","sourceRoot":"","sources":["../../../src/base/observability/CompositeAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,MAAM,EACN,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,kBAAkB,EAInB,MAAM,4BAA4B,CAAC;AAUpC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,gBAAiB,YAAW,oBAAoB;IAC3D,QAAQ,CAAC,QAAQ,EAAG,QAAQ,CAAU;IACtC,QAAQ,CAAC,IAAI,sBAAsB;IAEnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAgB;IAExC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;;IASvC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAIK,UAAU,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C7D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAazB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAkB7B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAU,EACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC;IAMV,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAInF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhG,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IA2BrC,aAAa,IAAI,IAAI,GAAG,IAAI;IAUtB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmB7E,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnC,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAMd,iBAAiB;YAoBjB,eAAe;YAyBf,eAAe;YAgCf,WAAW;IAgBzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,cAAc;CAiBvB"}