@plyaz/types 1.7.2 → 1.7.4

package/dist/common/types.d.ts

@@ -253,7 +253,7 @@ export interface Describable extends Named {
  * }
  * ```
  */
-export interface WithMetadata<T = UnknownRecord | undefined> {
+export interface WithMetadata<T = UnknownRecord> {
     /** Metadata for additional information */
     metadata: T;
 }
@@ -868,7 +868,7 @@ export interface WithLogging {
  */
 export interface Refreshable {
     /** When the entity was last updated/refreshed */
-    lastUpdated: Date | string | null;
+    lastUpdated?: Date | string | null;
     /** Function to refresh the entity */
     refresh: () => void | Promise<void>;
 }
@@ -887,7 +887,7 @@ export interface Initializable {
     /** Whether the entity has been initialized */
     isInitialized: boolean;
     /** Callback when entity is ready */
-    onReady: () => void;
+    onReady?: () => void;
 }
 /**
  * Base interface for entities with a single timestamp.
@@ -922,7 +922,7 @@ export interface Tracked<T = null | undefined> extends WithTimestamp {
     /** Result of the operation */
     result: T;
     /** Error if the operation failed */
-    error: Error | null;
+    error: Error | null | undefined;
 }
 /**
  * Base interface for entities with duration tracking.
@@ -1119,9 +1119,9 @@ export interface WithSessionId {
  */
 export interface WithRetryTracking {
     /** Current retry attempt count */
-    retryCount: number;
+    retryCount?: number;
     /** Maximum allowed retries */
-    maxRetries: number;
+    maxRetries?: number;
     /** retry delay in milliseconds */
     retryDelay?: number;
 }
@@ -1445,7 +1445,7 @@ export interface WithBody<T = unknown> {
  * }
  * ```
  */
-export interface WithError extends WithMessage {
+export interface WithError extends Partial<WithMessage> {
     /** Error code for programmatic handling */
     code?: string;
 }

package/dist/events/types.d.ts

@@ -20,7 +20,7 @@ export interface Event<T> extends Identifiable, WithTimestamp, Partial<WithCorre
  * Additional contextual data for an event.
  * @description This is often populated with session/user data and retry tracking.
  */
-export type EventMetadata = SetOptional<WithUserId & WithSessionId & WithUserAgent & WithRetryTracking & WithIpAddress, 'userId' | 'sessionId' | 'userAgent' | 'retryCount' | 'maxRetries' | 'ip'> & {
+export type EventMetadata = SetOptional<WithUserId & WithSessionId & WithUserAgent & WithRetryTracking & WithIpAddress, 'userId' | 'sessionId' | 'userAgent' | 'ip'> & {
     /**
      * Additional metadata as key-value pairs.
      */

package/dist/features/cache/types.d.ts

@@ -94,9 +94,9 @@ export interface CacheStrategy {
      * Retrieves a cache entry.
      *
      * @param key - Cache key
-     * @returns Promise that resolves to cache entry or null if not found
+     * @returns Promise that resolves to cache entry or null/undefined if not found
      */
-    get<T>(key: string): Promise<CacheEntry<T> | null>;
+    get<T>(key: string): Promise<CacheEntry<T> | null | undefined>;
     /**
      * Removes a cache entry.
      *

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

@@ -6,7 +6,7 @@
  * @fileoverview Feature flags domain type definitions
  * @version 1.0.0
  */
-import type { UnknownRecord, UnknownArray, Arrayable, Promisable, SetOptional } from 'type-fest';
+import type { UnknownRecord, UnknownArray, Arrayable, SetOptional } from 'type-fest';
 import type * as React from 'react';
 import type { Describable, Timestamped, WithMetadata, Loadable, Authored, WithTags, WithEnvironment, Identifiable, Named, WithLogging, WithApiKey, Initializable, Refreshable, WithOperation, Enabled, WithError, KeyValuePair, WithUserId, WithCountry, Versioned, WithPlatform, WithPriority, ValidationResult } from '../../common/types';
 /**
@@ -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;
 }
@@ -254,7 +256,7 @@ export interface FeatureFlagHelpers<FeatureFlagKey extends string = string> {
     getMultipleFlags: (keys: FeatureFlagKey[], context?: FeatureFlagContext) => Promise<Record<FeatureFlagKey, FeatureFlagValue>>;
     isAnyEnabled: (keys: FeatureFlagKey[], context?: FeatureFlagContext) => Promise<boolean>;
     isAllEnabled: (keys: FeatureFlagKey[], context?: FeatureFlagContext) => Promise<boolean>;
-    whenEnabled: <T>(key: FeatureFlagKey, callback: () => Promisable<T>, fallback?: () => Promisable<T>, context?: FeatureFlagContext) => Promise<T | undefined>;
+    whenEnabled: <T>(key: FeatureFlagKey, callback: () => T | Promise<T>, fallback?: () => T | Promise<T>, context?: FeatureFlagContext) => Promise<T | undefined>;
 }
 /**
  * Response structure for fetching feature flag data.
@@ -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<string | number> {
+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<string | number
  * };
  * ```
  */
-export interface ValidationErrorPattern extends WithStatusCode, WithStatus<string | number> {
+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

@@ -2061,11 +2061,11 @@ export interface ConsoleMockParams {
     storage: string[];
     all: Array<{
         type: string;
-        args: UnknownArray;
+        args: unknown[];
     }>;
     originalFn: Function;
     suppressTypes: string[];
-    formatArguments: (args: readonly unknown[]) => string;
+    formatArguments: (args: unknown[]) => string;
     captureStackTrace?: boolean;
 }
 /**

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

@@ -540,7 +540,7 @@ export interface MockConsole {
  * };
  * ```
  */
-export interface MockEnv extends KeyValueStore<string, string> {
+export interface MockEnv extends Omit<KeyValueStore<string, string>, 'has'> {
     restore: () => void;
 }
 /**
@@ -2135,7 +2135,7 @@ export interface ModuleLifecycleTest extends Named {
  */
 export interface ApplicationLifecycleTest extends Named {
     app: UnknownRecord;
-    modules: UnknownArray;
+    modules: unknown[];
     expectedStartupSequence: string[];
     expectedShutdownSequence: string[];
 }
@@ -2611,7 +2611,8 @@ export interface MockNextRouterReturn {
  * };
  * ```
  */
-export interface MockNextRequest extends WithUrl, WithHttpMethod, WithHeaders, WithIpAddress, WithBody {
+export interface MockNextRequest extends WithUrl, WithHttpMethod, WithIpAddress, WithBody {
+    headers: Headers;
     searchParams?: Record<string, string>;
     nextUrl: {
         pathname: string;
@@ -2855,6 +2856,8 @@ export interface ApiRouteHandlerMethods {
     PUT?: Function;
     DELETE?: Function;
     PATCH?: Function;
+    HEAD?: Function;
+    OPTIONS?: Function;
 }
 /**
  * Test scenario for route handlers.
@@ -3653,7 +3656,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;
@@ -3725,7 +3728,7 @@ export interface ApiAuthScenario {
 export interface ApiRouteOptions extends Partial<WithUrl> {
     method?: HttpMethod;
     headers?: Record<string, Arrayable<string>>;
-    query?: Record<string, Arrayable<string>>;
+    query?: Record<string, Arrayable<string> | undefined>;
     body?: unknown;
     cookies?: Record<string, string>;
 }
@@ -4418,9 +4421,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 +4587,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/package.json

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