@plyaz/types 1.7.1 → 1.7.3

package/dist/features/feature-flag/types.d.ts

@@ -18,7 +18,7 @@ export type FeatureFlagValue = boolean | string | number | UnknownRecord;
  * Core feature flag definition interface.
  * Represents a complete feature flag with all its metadata and configuration.
  */
-export interface FeatureFlag<FeatureFlagKey extends string> extends Describable, Timestamped, WithMetadata, Authored, Named, WithTags, WithEnvironment, Enabled, KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
+export interface FeatureFlag<FeatureFlagKey extends string> extends Describable, Timestamped, SetOptional<WithMetadata, 'metadata'>, Authored, Named, SetOptional<WithTags, 'tags'>, WithEnvironment, Enabled, KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
     /** The data type of the flag value */
     type: FlagType;
     /** Percentage of users who should receive this flag (0-100) */
@@ -27,7 +27,7 @@ export interface FeatureFlag<FeatureFlagKey extends string> extends Describable,
 /**
  * Feature flag rule for advanced targeting and conditional logic.
  */
-export interface FeatureFlagRule<FeatureFlagKey extends string> extends Identifiable, Named, WithPriority<number>, WithMetadata, Enabled {
+export interface FeatureFlagRule<FeatureFlagKey extends string> extends Identifiable, Named, WithPriority<number>, SetOptional<WithMetadata, 'metadata'>, Enabled {
     /** The feature flag this rule applies to */
     flagKey: FeatureFlagKey;
     /** Array of conditions that must all be met for this rule to apply */
@@ -51,7 +51,7 @@ export interface FeatureFlagCondition {
 /**
  * Context information used for feature flag evaluation.
  */
-export interface FeatureFlagContext extends SetOptional<WithUserId, 'userId'>, WithCountry, Versioned, WithEnvironment, WithPlatform {
+export interface FeatureFlagContext extends SetOptional<WithUserId, 'userId'>, SetOptional<WithCountry, 'country'>, SetOptional<Versioned, 'version'>, WithEnvironment, SetOptional<WithPlatform, 'platform'> {
     /** User's email address */
     userEmail?: string;
     /** User's role or permission level */
@@ -79,7 +79,7 @@ export interface FeatureFlagEvaluation<FeatureFlagKey extends string> extends En
 /**
  * Configuration options for the feature flag system.
  */
-export interface FeatureFlagConfig<FeatureFlagKey extends string> extends SetOptional<WithLogging, 'isLoggingEnabled'>, WithApiKey {
+export interface FeatureFlagConfig<FeatureFlagKey extends string> extends SetOptional<WithLogging, 'isLoggingEnabled'>, SetOptional<WithApiKey, 'apiKey'> {
     /** The storage provider to use for flag data */
     provider: 'database' | 'redis' | 'memory' | 'api' | 'file';
     /** Whether to enable caching of flag evaluations */
@@ -172,7 +172,7 @@ export interface FeatureFlagProviderProps<FeatureFlagKey extends string, Feature
 /**
  * Backend Request DTO for flag creation.
  */
-export interface CreateFlagRequest<FeatureFlagKey extends string> extends WithEnvironment, SetOptional<Enabled, 'isEnabled'>, SetOptional<Describable, 'description'>, Named, KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
+export interface CreateFlagRequest<FeatureFlagKey extends string> extends Partial<WithEnvironment>, SetOptional<Enabled, 'isEnabled'>, SetOptional<Describable, 'description'>, Named, KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
     rolloutPercentage?: number;
 }
 /**
@@ -227,6 +227,8 @@ export interface ProviderStats {
     avgEvaluationTime: number;
     /** Last refresh timestamp */
     lastRefresh?: Date;
+    /** Last updated timestamp */
+    lastUpdated?: Date;
     /** Provider uptime in ms */
     uptime: number;
 }
@@ -303,7 +305,7 @@ export interface FlagEvaluationTestInput<FeatureFlagKey extends string> extends
 /**
  * Input for flag creation test cases
  */
-export interface FlagCreationTestInput<FeatureFlagKey extends string> extends WithEnvironment, Enabled, Describable, Named, KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
+export interface FlagCreationTestInput<FeatureFlagKey extends string> extends Partial<WithEnvironment>, Enabled, Describable, Named, KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
     /** Rollout percentage (0-100) */
     rolloutPercentage?: number;
 }

package/dist/testing/common/assertions/types.d.ts

@@ -3,7 +3,7 @@
  *
  * Type definitions for assertion utilities.
  */
-import type { UnknownRecord, UnknownArray, Promisable } from 'type-fest';
+import type { UnknownRecord, UnknownArray, SetOptional } from 'type-fest';
 import type { WithStatusCode, WithMessage, WithTimestamp, WithCorrelationId, WithMetadata, Named, WithRequestId, WithStatus } from '../../../common/types';
 /**
  * Pattern for matching HTTP errors with status code and message.
@@ -17,7 +17,7 @@ import type { WithStatusCode, WithMessage, WithTimestamp, WithCorrelationId, Wit
  * };
  * ```
  */
-export interface ErrorPattern extends WithStatusCode, WithStatus {
+export interface ErrorPattern extends SetOptional<WithStatusCode, 'statusCode'>, WithStatus<string | number> {
     /** Regular expression to match against error message */
     message: RegExp;
 }
@@ -33,7 +33,7 @@ export interface ErrorPattern extends WithStatusCode, WithStatus {
  * };
  * ```
  */
-export interface ValidationErrorPattern extends WithStatusCode {
+export interface ValidationErrorPattern extends SetOptional<WithStatusCode, 'statusCode'>, WithStatus<string | number> {
     /** Array of field names that failed validation */
     validation: string[];
 }
@@ -203,7 +203,7 @@ export interface ErrorPropagationTestResult<T> {
  */
 export interface ErrorCircuitBreaker<T> {
     /** Execute function with circuit breaker protection */
-    execute: (fn: () => Promisable<T>) => Promisable<T>;
+    execute: (fn: () => T | Promise<T>) => T | Promise<T>;
     /** Get current circuit state */
     getState: () => 'closed' | 'open' | 'half-open';
     /** Get error statistics */

package/dist/testing/common/factories/types.d.ts

@@ -623,7 +623,7 @@ export interface ScenarioResult<T> {
  * };
  * ```
  */
-export interface TrackedCallRecord<TArgs extends unknown[], TReturn, TTimestamp = Date> extends Omit<Tracked<TReturn>, 'timestamp'>, WithDuration, WithTimestamp<TTimestamp> {
+export interface TrackedCallRecord<TArgs extends unknown[], TReturn, TTimestamp = Date> extends Omit<Tracked<TReturn | undefined>, 'timestamp'>, WithDuration, WithTimestamp<TTimestamp> {
     /** Function arguments */
     args: TArgs;
 }

package/dist/testing/common/mocks/types.d.ts

@@ -465,7 +465,7 @@ export type HttpExceptionError = Error & WithStatus<number> & {
  * };
  * ```
  */
-export type SimpleExceptionError = Error & WithStatus & {
+export type SimpleExceptionError = Error & WithStatus<number> & {
     /** Error response data */
     response: unknown;
 };

package/dist/testing/common/patterns/types.d.ts

@@ -400,10 +400,10 @@ export interface CreateTableDrivenTestOptions<TInput, TExpected> extends Named {
     }>;
     test?: (testCase: TInput & {
         expected?: TExpected;
-    }) => Promisable<void>;
+    }) => void | Promise<void>;
     fn?: (testCase: TInput & {
         expected?: TExpected;
-    }) => Promisable<void>;
+    }) => void | Promise<void>;
 }
 /**
  * Statistics collected for operation performance tracking.

package/dist/testing/common/utils/types.d.ts

@@ -2135,7 +2135,7 @@ export interface ModuleLifecycleTest extends Named {
  */
 export interface ApplicationLifecycleTest extends Named {
     app: UnknownRecord;
-    modules: UnknownArray;
+    modules: unknown[];
     expectedStartupSequence: string[];
     expectedShutdownSequence: string[];
 }
@@ -2855,6 +2855,8 @@ export interface ApiRouteHandlerMethods {
     PUT?: Function;
     DELETE?: Function;
     PATCH?: Function;
+    HEAD?: Function;
+    OPTIONS?: Function;
 }
 /**
  * Test scenario for route handlers.
@@ -3653,7 +3655,7 @@ export interface SecretsManagementTest extends Named {
 }
 export interface SecretsManager extends KeyValueStore<string, string> {
 }
-export interface MockEnvironment extends Exclude<KeyValueStore<string, string>, 'delete' | 'has'> {
+export interface MockEnvironment extends Omit<KeyValueStore<string, string>, 'delete' | 'has'> {
     update: (updates: EnvironmentConfig) => void;
     unset: (key: string) => void;
     restore: () => void;
@@ -4418,9 +4420,9 @@ export interface DynamicModuleClass {
  * ```
  */
 export interface DynamicModuleExpectations {
-    providers?: UnknownArray;
-    imports?: UnknownArray;
-    exports?: UnknownArray;
+    providers?: unknown[];
+    imports?: unknown[];
+    exports?: unknown[];
 }
 /**
  * Return value from NestJS test suite setup.
@@ -4584,7 +4586,7 @@ export interface UserFlowStep extends Named {
 export interface MockNextRequestCreatorParams {
     url: string;
     options?: {
-        method?: string;
+        method?: HttpMethod;
         headers?: Record<string, string>;
         body?: unknown;
         searchParams?: Record<string, string>;

package/dist/testing/features/feature-flags/types.d.ts

@@ -1255,6 +1255,8 @@ export interface TestFeatureFlagContextValue<FeatureFlagKey extends string> {
     lastUpdated: Date;
     /** Force refresh flags */
     refresh: () => Promise<void>;
+    /** Callback when provider is ready */
+    onReady: () => void;
 }
 /**
  * Options for waiting for flag value changes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",