@plyaz/types 1.7.0 → 1.7.1

package/dist/common/types.d.ts

@@ -201,9 +201,9 @@ export interface NavigablePaginatedCollection<T> extends PaginatedCollection<T>,
  * }
  * ```
  */
-export interface SoftDeletable {
+export interface SoftDeletable<T = Date | null> {
     /** When the entity was soft deleted */
-    deletedAt: Date | null;
+    deletedAt: T;
 }
 /**
  * Base interface for named entities.
@@ -918,9 +918,9 @@ export interface WithTimestamp<T = Date | string> {
  * }
  * ```
  */
-export interface Tracked<T = unknown> extends WithTimestamp {
+export interface Tracked<T = null | undefined> extends WithTimestamp {
     /** Result of the operation */
-    result: T | null;
+    result: T;
     /** Error if the operation failed */
     error: Error | null;
 }
@@ -950,9 +950,9 @@ export interface WithDuration {
  * }
  * ```
  */
-export interface WithLastAccessed {
+export interface WithLastAccessed<T = Date | string | null> {
     /** When the entity was last accessed */
-    lastAccessedAt: Date | string | null;
+    lastAccessedAt: T;
 }
 /**
  * Base interface for versioned entities.
@@ -1122,6 +1122,8 @@ export interface WithRetryTracking {
     retryCount: number;
     /** Maximum allowed retries */
     maxRetries: number;
+    /** retry delay in milliseconds */
+    retryDelay?: number;
 }
 /**
  * Base interface for entities with roles.

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

@@ -4,7 +4,7 @@
  * Type definitions for assertion utilities.
  */
 import type { UnknownRecord, UnknownArray, Promisable } from 'type-fest';
-import type { WithStatusCode, WithMessage, WithTimestamp, WithError, WithCorrelationId, WithMetadata, Named, WithRequestId } from '../../../common/types';
+import type { WithStatusCode, WithMessage, WithTimestamp, WithCorrelationId, WithMetadata, Named, WithRequestId, WithStatus } from '../../../common/types';
 /**
  * Pattern for matching HTTP errors with status code and message.
  * Used in testing to assert specific error responses.
@@ -17,7 +17,7 @@ import type { WithStatusCode, WithMessage, WithTimestamp, WithError, WithCorrela
  * };
  * ```
  */
-export interface ErrorPattern extends WithStatusCode {
+export interface ErrorPattern extends WithStatusCode, WithStatus {
     /** Regular expression to match against error message */
     message: RegExp;
 }
@@ -61,7 +61,9 @@ export interface ErrorStats {
  * Entry in an error timeline tracking when errors occurred.
  * Used for debugging error patterns over time.
  */
-export interface ErrorTimelineEntry extends WithTimestamp<number>, WithError {
+export interface ErrorTimelineEntry extends WithTimestamp<number> {
+    /** The error that occurred */
+    error: Error;
     /** Additional context data at the time of error */
     context?: UnknownRecord;
 }
@@ -137,7 +139,9 @@ export interface ErrorRecoveryResult {
  * Entry for correlating errors with additional context.
  * Used in error tracking and debugging systems.
  */
-export interface ErrorCorrelationEntry extends WithError, Partial<WithMetadata<UnknownRecord>> {
+export interface ErrorCorrelationEntry extends Partial<WithMetadata<UnknownRecord>> {
+    /** The original error that triggered recovery */
+    error: Error;
 }
 /**
  * Definition of an error test scenario.
@@ -199,7 +203,7 @@ export interface ErrorPropagationTestResult<T> {
  */
 export interface ErrorCircuitBreaker<T> {
     /** Execute function with circuit breaker protection */
-    execute: (fn: () => Promisable<T>) => Promise<T>;
+    execute: (fn: () => Promisable<T>) => Promisable<T>;
     /** Get current circuit state */
     getState: () => 'closed' | 'open' | 'half-open';
     /** Get error statistics */
@@ -285,7 +289,7 @@ export interface ValidationMessage {
  * Expected HTTP exception pattern for testing.
  * Used to assert specific HTTP error responses.
  */
-export interface ExpectedHttpException extends Partial<WithStatusCode> {
+export interface ExpectedHttpException extends Partial<WithStatusCode>, WithStatus {
     /** Expected error message or pattern */
     message?: string | RegExp;
     /** Expected response body */

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

@@ -137,8 +137,7 @@ export type TestMetadata = Versioned & WithSource & Authored & WithTags & WithLa
  * };
  * ```
  */
-export interface TestTimestamps extends Timestamped<Date, Date>, SoftDeletable, WithExpiration, WithLastAccessed {
-}
+export type TestTimestamps = Timestamped<Date, Date> & SoftDeletable & WithExpiration<Date | null> & WithLastAccessed<Date | null>;
 /**
  * Test scenario interface for scenario-driven testing
  *
@@ -624,7 +623,7 @@ export interface ScenarioResult<T> {
  * };
  * ```
  */
-export interface TrackedCallRecord<TArgs extends unknown[], TReturn> extends Tracked<TReturn>, WithDuration {
+export interface TrackedCallRecord<TArgs extends unknown[], TReturn, TTimestamp = Date> extends Omit<Tracked<TReturn>, 'timestamp'>, WithDuration, WithTimestamp<TTimestamp> {
     /** Function arguments */
     args: TArgs;
 }
@@ -658,16 +657,16 @@ export interface TrackedCallRecord<TArgs extends unknown[], TReturn> extends Tra
  * trackedFn.resetCalls();
  * ```
  */
-export interface TrackedMockFunction<TArgs extends unknown[], TReturn> extends Vitest.Mock<(...args: TArgs) => TReturn> {
+export interface TrackedMockFunction<TArgs extends unknown[], TReturn, TTimestamp = Date> extends Vitest.Mock<(...args: TArgs) => TReturn> {
     /** Array of all call records with metadata */
-    calls: Array<TrackedCallRecord<TArgs, TReturn>>;
+    calls: Array<TrackedCallRecord<TArgs, TReturn, TTimestamp>>;
     /** Get a specific call by index */
-    getCall: (index: number) => TrackedCallRecord<TArgs, TReturn> | undefined;
+    getCall: (index: number) => TrackedCallRecord<TArgs, TReturn, TTimestamp> | undefined;
     /** Find calls matching a predicate */
     findCalls: (predicate: (call: {
         args: TArgs;
-        timestamp: Date;
-    }) => boolean) => Array<TrackedCallRecord<TArgs, TReturn>>;
+        timestamp: TTimestamp;
+    }) => boolean) => Array<TrackedCallRecord<TArgs, TReturn, TTimestamp>>;
     /** Reset all tracked calls */
     resetCalls: () => void;
 }

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

@@ -444,7 +444,7 @@ export interface MockTestingModule {
  * };
  * ```
  */
-export type HttpExceptionError = Error & WithStatus & {
+export type HttpExceptionError = Error & WithStatus<number> & {
     /** Error response data */
     response: string | object;
     /** Get HTTP status code */
@@ -2065,7 +2065,7 @@ export interface ConsoleMockParams {
     }>;
     originalFn: Function;
     suppressTypes: string[];
-    formatArguments: (args: UnknownArray) => string;
+    formatArguments: (args: readonly unknown[]) => string;
     captureStackTrace?: boolean;
 }
 /**

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

@@ -586,7 +586,7 @@ export interface StressTestConfig {
  * };
  * ```
  */
-export interface ProcessWithRetryParams<T> extends WithRetryTracking {
+export interface ProcessWithRetryParams<T = unknown> extends WithRetryTracking {
     /** Operation to process */
     operation: Operation<T>;
     /** Function to process the operation */

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

@@ -52,8 +52,8 @@ import type { Provider, Type } from '@nestjs/common';
 import type { RenderOptions as RTLRenderOptions, RenderHookOptions as RTLRenderHookOptions } from '@testing-library/react';
 import type { UserEvent as UserEventLib } from '@testing-library/user-event';
 import type { MockEventEmitter, MockNextRouter, MockGetServerSidePropsContext, MockGetStaticPropsContext, MockNextApiResponse, MockNextApiRequest, TestScenario, CreateMockUseRouterReturn, CreateMockWebSocketReturn, CreateMockNextRequestFunction } from '..';
-import type { UnknownRecord, UnknownArray, Promisable, Arrayable } from 'type-fest';
-import type { KeyValueStore, Identifiable, WithUrl, WithHttpMethod, WithHeaders, WithIpAddress, WithQueryParams, WithBody, Named, Clearable, Resettable, Describable, WithImpact, WithElement, WithDuration, IntervalControl, WithTimestamp, WithParams, WithKeyValues, WithTimeout, WithStatus, WithLocale, WithUserId, WithMessage } from '../../../common';
+import type { UnknownRecord, UnknownArray, Promisable, Arrayable, SetOptional } from 'type-fest';
+import type { KeyValueStore, Identifiable, WithUrl, WithHttpMethod, HttpMethod, WithHeaders, WithIpAddress, WithQueryParams, WithBody, Named, Clearable, Resettable, Describable, WithImpact, WithElement, WithDuration, IntervalControl, WithTimestamp, WithParams, WithTimeout, WithStatus, WithLocale, WithUserId, WithMessage } from '../../../common';
 /**
  * Subscription information for tracking subscriptions in tests
  *
@@ -494,7 +494,7 @@ export interface PollingTestOptions {
  * ```
  */
 export interface TestCleanup {
-    add: (cleanup: () => Promisable<void>) => void;
+    add: (cleanup: () => void | Promise<void>) => void;
     runAll: () => Promise<void>;
     clear: () => void;
 }
@@ -2907,7 +2907,7 @@ export interface ImageLoaderTestScenario {
  * ```
  */
 export interface ParameterizedTest<T> {
-    test: (name: string, fn: (input: T, expected: unknown) => Promisable<void>) => void;
+    test: (name: string, fn: (input: T, expected: unknown) => void | Promise<void>) => void;
 }
 /**
  * Test suite for service testing.
@@ -2940,7 +2940,7 @@ export interface ServiceTestSuite<T> {
  * ```
  */
 export interface NestJSTestSuiteReturn {
-    testProviderRegistration: (providerTokens: UnknownArray) => void;
+    testProviderRegistration: (providerTokens: unknown[]) => void;
     testProviderInjection: (injectionTests: Array<ProviderInjectionTest>) => void;
 }
 /**
@@ -3653,7 +3653,7 @@ export interface SecretsManagementTest extends Named {
 }
 export interface SecretsManager extends KeyValueStore<string, string> {
 }
-export interface MockEnvironment extends KeyValueStore<string, string> {
+export interface MockEnvironment extends Exclude<KeyValueStore<string, string>, 'delete' | 'has'> {
     update: (updates: EnvironmentConfig) => void;
     unset: (key: string) => void;
     restore: () => void;
@@ -3723,7 +3723,7 @@ export interface ApiAuthScenario {
     expectedMessage?: string;
 }
 export interface ApiRouteOptions extends Partial<WithUrl> {
-    method?: string;
+    method?: HttpMethod;
     headers?: Record<string, Arrayable<string>>;
     query?: Record<string, Arrayable<string>>;
     body?: unknown;
@@ -4176,7 +4176,7 @@ export type ModuleMockFactories = Record<string, () => UnknownRecord>;
  * ```
  */
 export interface TestCaseWithSetup<T> extends Named {
-    args: UnknownArray;
+    args: unknown[];
     expected: unknown;
     setup?: (instance: T) => void;
 }
@@ -4219,7 +4219,7 @@ export interface LifecycleHookTestConfig<T> extends Named {
  */
 export interface ErrorHandlingScenario<T> {
     method: keyof T;
-    args: UnknownArray;
+    args: unknown[];
     expectedError: string | RegExp | typeof Error;
     setup?: (instance: T) => void;
 }
@@ -4652,10 +4652,10 @@ export interface CreateMockRedisClientMock {
  * ```
  */
 export interface CallTracker {
-    trackCall: (name: string, args: UnknownArray) => void;
+    trackCall: (name: string, args: unknown[]) => void;
     getCalls: (name?: string) => Array<{
         name: string;
-        args: UnknownArray;
+        args: unknown[];
         timestamp: number;
     }>;
     reset: () => void;
@@ -5179,7 +5179,7 @@ export interface A11yOptions {
  * Accessibility violation
  * @interface A11yViolation
  */
-export interface A11yViolation extends Identifiable, Describable, Partial<WithImpact> {
+export interface A11yViolation extends Identifiable, SetOptional<Describable, 'name'>, Partial<WithImpact> {
     help: string;
     helpUrl: string;
     nodes: Array<{
@@ -5684,7 +5684,7 @@ export interface EnvMock {
  * Environment snapshot
  * @interface EnvSnapshot
  */
-export interface EnvSnapshot extends WithKeyValues<string | undefined>, WithTimestamp<number> {
+export interface EnvSnapshot extends WithTimestamp<number> {
     variables: Record<string, string | undefined>;
 }
 /**

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

@@ -62,8 +62,12 @@ export interface CacheStrategyTestConfig extends Named {
  * };
  * ```
  */
-export interface Cache<T = unknown> extends Omit<KeyValueStore<T>, 'set'> {
+export interface Cache<T = unknown> extends Omit<KeyValueStore<string, T>, 'set'> {
     set(key: string, value: T, ttl?: number): Promise<void>;
+    size(): Promise<number>;
+    keys(): Promise<string[]>;
+    values(): Promise<T[]>;
+    entries(): Promise<Array<[string, T]>>;
     getStats?(): CacheStats;
     getRaw?(key: string): Promise<CacheEntry<T> | null>;
     onEviction?(callback: (key: string, value: T) => void): void;

package/package.json

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