@plyaz/types 1.5.5 → 1.7.0

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

@@ -48,8 +48,10 @@
  * @since 1.0.0
  */
 import type * as React from 'react';
+import type { UnknownRecord } from 'type-fest';
 import type { RenderOptions, RenderHookOptions, MockNextRouter } from '..';
 import type * as TestingLibraryReact from '@testing-library/react';
+import type { Named, Resettable, WithTimestamp } from '../../../common/types';
 /**
  * React wrapper component interface for test utilities
  *
@@ -122,7 +124,7 @@ export interface WrapperOptions {
         children: React.ReactNode;
     }>>;
     /** Props to pass to the providers */
-    providerProps?: Record<string, unknown>;
+    providerProps?: UnknownRecord;
 }
 /**
  * Extended render options combining RTL options with wrapper configuration.
@@ -233,10 +235,9 @@ export interface ErrorBoundaryProps {
  * };
  * ```
  */
-export interface MockProviderContextValue<T> {
+export interface MockProviderContextValue<T> extends Resettable {
     value: T;
     setValue: (value: T) => void;
-    reset: () => void;
 }
 /**
  * Props for mock provider components.
@@ -328,15 +329,13 @@ export interface TrackedProviderProps<T> {
  * expect(history[0].value).toEqual(initialState);
  * ```
  */
-export interface TrackedProviderReturn<T> {
+export interface TrackedProviderReturn<T> extends Resettable {
     /** Tracked provider component */
     Provider: React.FC<TrackedProviderProps<T>>;
     /** Get total render count */
     getRenderCount: () => number;
     /** Get history of value updates */
     getUpdateHistory: () => Array<UpdateHistoryEntry<T>>;
-    /** Reset tracking data */
-    reset: () => void;
 }
 /**
  * Context value for async data providers.
@@ -508,13 +507,11 @@ export interface ContextProvider<T = unknown> {
  * };
  * ```
  */
-export interface ProviderConfigOptions<T = unknown> {
+export interface ProviderConfigOptions<T = unknown> extends Partial<Named> {
     /** The context provider to configure */
     provider: ContextProvider<T>;
     /** Value to provide through the context */
     value: T;
-    /** Optional name for identification */
-    name?: string;
     /** Names of providers this depends on */
     dependencies?: string[];
 }
@@ -607,9 +604,7 @@ export interface MockProviderOptions<T> {
  * };
  * ```
  */
-export interface TrackedProviderOptions {
-    /** Name for identification in logs */
-    name: string;
+export interface TrackedProviderOptions extends Named {
     /** Whether to log renders to console */
     logRenders?: boolean;
 }
@@ -650,11 +645,9 @@ export interface AsyncProviderOptions<T> {
  * };
  * ```
  */
-export interface SubscribableProviderOptions<T> {
+export interface SubscribableProviderOptions<T> extends Named {
     /** Initial value for subscribers */
     initialValue: T;
-    /** Provider name for debugging */
-    name: string;
 }
 /**
  * Options for time-travel providers.
@@ -671,13 +664,11 @@ export interface SubscribableProviderOptions<T> {
  * };
  * ```
  */
-export interface TimeTravelProviderOptions<T> {
+export interface TimeTravelProviderOptions<T> extends Named {
     /** Initial state value */
     initialState: T;
     /** Maximum history entries to keep */
     maxHistory?: number;
-    /** Provider name for debugging */
-    name: string;
 }
 /**
  * Options for mock API providers.
@@ -697,13 +688,11 @@ export interface TimeTravelProviderOptions<T> {
  * };
  * ```
  */
-export interface MockApiProviderOptions {
+export interface MockApiProviderOptions extends Named {
     /** Mock endpoint implementations */
     endpoints: Record<string, () => Promise<unknown> | unknown>;
     /** Artificial delay in ms */
     delay?: number;
-    /** Provider name for debugging */
-    name: string;
 }
 /**
  * Entry in the update history for tracked providers.
@@ -719,9 +708,7 @@ export interface MockApiProviderOptions {
  * };
  * ```
  */
-export interface UpdateHistoryEntry<T> {
-    /** When the update occurred */
-    timestamp: number;
+export interface UpdateHistoryEntry<T> extends WithTimestamp<number> {
     /** Partial state updates applied */
     updates: Partial<T>;
 }
@@ -743,7 +730,7 @@ export interface ProviderChainItem {
         children: React.ReactNode;
     }>;
     /** Props to pass to provider */
-    props?: Record<string, unknown>;
+    props?: UnknownRecord;
 }
 /**
  * Context value for subscribable providers.
@@ -857,7 +844,7 @@ export type Subscriber<T> = (value: T) => void;
  * };
  * ```
  */
-export interface TimeTravelContextValue<T> {
+export interface TimeTravelContextValue<T> extends Resettable {
     /** Current state value */
     state: T;
     /** Whether undo operation is available */
@@ -870,8 +857,6 @@ export interface TimeTravelContextValue<T> {
     redo: () => void;
     /** Update state and add to history */
     update: (newState: T) => void;
-    /** Clear all history and reset to initial state */
-    reset: () => void;
     /** Get the complete state history */
     getHistory: () => T[];
 }
@@ -952,7 +937,7 @@ export interface TimeTravelProviderReturn<T> {
  * });
  * ```
  */
-export interface MockApiProviderReturn<T extends Record<string, unknown>> {
+export interface MockApiProviderReturn<T extends UnknownRecord> {
     /** Mock API provider component */
     Provider: React.FC<{
         children: React.ReactNode;

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

@@ -1,4 +1,5 @@
 import type { CacheEntry, CacheStats, CacheStrategy } from '../../../features';
+import type { KeyValueStore, Named } from '../../../common';
 /**
  * Configuration for cache strategy test suite
  *
@@ -34,8 +35,7 @@ import type { CacheEntry, CacheStats, CacheStrategy } from '../../../features';
  *
  * @public
  */
-export interface CacheStrategyTestConfig {
-    name: string;
+export interface CacheStrategyTestConfig extends Named {
     createStrategy: () => CacheStrategy | Promise<CacheStrategy>;
     supportsExpiration?: boolean;
     supportsStats?: boolean;
@@ -62,12 +62,8 @@ export interface CacheStrategyTestConfig {
  * };
  * ```
  */
-export interface Cache<T = unknown> {
-    get(key: string): Promise<T | null>;
+export interface Cache<T = unknown> extends Omit<KeyValueStore<T>, 'set'> {
     set(key: string, value: T, ttl?: number): Promise<void>;
-    delete(key: string): Promise<boolean>;
-    clear(): Promise<void>;
-    size(): Promise<number>;
     getStats?(): CacheStats;
     getRaw?(key: string): Promise<CacheEntry<T> | null>;
     onEviction?(callback: (key: string, value: T) => void): void;

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

@@ -45,8 +45,11 @@
  */
 import type * as Vitest from 'vitest';
 import type * as React from 'react';
+import type { UnknownRecord, UnknownArray, Arrayable, SetOptional } from 'type-fest';
 import type { FeatureFlag, FeatureFlagCondition, FeatureFlagConfig, FeatureFlagContext, FeatureFlagEvaluation, FeatureFlagRule, FeatureFlagValue, FeatureFlagProvider as IFeatureFlagProvider, FeatureFlagContextValue } from '../../../features';
 import type { MockLogger, RenderFunction, RenderHookFunction } from '../../common';
+import type { Promisable } from 'type-fest';
+import type { Describable, KeyValuePair, Resettable, WithMetadata, WithTimestamp } from '../../../common';
 /**
  * Builder interface for creating feature flag test objects with fluent API
  *
@@ -132,7 +135,7 @@ export interface FeatureFlagContextBuilder {
     /** Set the application version */
     withVersion: (version: string) => FeatureFlagContextBuilder;
     /** Set custom context properties */
-    withCustom: (custom: Record<string, unknown>) => FeatureFlagContextBuilder;
+    withCustom: (custom: UnknownRecord) => FeatureFlagContextBuilder;
     /** Build the final context object */
     build: () => FeatureFlagContext;
 }
@@ -154,7 +157,7 @@ export interface FeatureFlagConditionBuilder {
     /** Set the comparison operator */
     withOperator: (operator: FeatureFlagCondition['operator']) => FeatureFlagConditionBuilder;
     /** Set the comparison value(s) */
-    withValue: (value: string | number | string[] | number[]) => FeatureFlagConditionBuilder;
+    withValue: (value: Arrayable<string | number>) => FeatureFlagConditionBuilder;
     /** Build the final condition object */
     build: () => FeatureFlagCondition;
 }
@@ -196,7 +199,7 @@ export interface FeatureFlagFactory<FeatureFlagKey extends string> {
     /** Create a number feature flag */
     createNumber: (key: string, value: number, overrides?: Partial<FeatureFlag<FeatureFlagKey>>) => FeatureFlag<FeatureFlagKey>;
     /** Create an object feature flag */
-    createObject: (key: string, value: Record<string, unknown>, overrides?: Partial<FeatureFlag<FeatureFlagKey>>) => FeatureFlag<FeatureFlagKey>;
+    createObject: (key: string, value: UnknownRecord, overrides?: Partial<FeatureFlag<FeatureFlagKey>>) => FeatureFlag<FeatureFlagKey>;
 }
 /**
  * Pre-defined feature flag scenario generators for common testing patterns
@@ -489,11 +492,7 @@ export interface FeatureFlagTestOptions<FeatureFlagKey extends string> {
  * };
  * ```
  */
-export interface FeatureFlagScenario<FeatureFlagKey extends string> {
-    /** Scenario name */
-    name: string;
-    /** Optional scenario description */
-    description?: string;
+export interface FeatureFlagScenario<FeatureFlagKey extends string> extends SetOptional<Describable, 'description'> {
     /** Feature flags for this scenario */
     flags: FeatureFlag<FeatureFlagKey>[];
     /** Evaluation context */
@@ -501,9 +500,9 @@ export interface FeatureFlagScenario<FeatureFlagKey extends string> {
     /** Expected flag evaluation results */
     expectedResults: Record<string, FeatureFlagValue>;
     /** Setup function run before scenario */
-    setup?: () => void | Promise<void>;
+    setup?: () => Promisable<void>;
     /** Teardown function run after scenario */
-    teardown?: () => void | Promise<void>;
+    teardown?: () => Promisable<void>;
 }
 /**
  * Test suite for managing and running multiple feature flag scenarios
@@ -685,7 +684,7 @@ export interface FeatureFlagTestConfig {
  * eventEmitter.emit(event);
  * ```
  */
-export interface FeatureFlagEvent {
+export interface FeatureFlagEvent extends WithTimestamp<Date>, SetOptional<WithMetadata, 'metadata'> {
     /** Type of flag operation */
     type: 'evaluation' | 'update' | 'create' | 'delete' | 'refresh';
     /** Flag identifier */
@@ -694,10 +693,6 @@ export interface FeatureFlagEvent {
     context?: FeatureFlagContext;
     /** Flag value (for evaluations/updates) */
     value?: FeatureFlagValue;
-    /** Event timestamp */
-    timestamp: Date;
-    /** Additional event metadata */
-    metadata?: Record<string, unknown>;
 }
 /**
  * Handler function for feature flag events
@@ -716,7 +711,7 @@ export interface FeatureFlagEvent {
  * ```
  */
 export interface FeatureFlagEventHandler {
-    (event: FeatureFlagEvent): void | Promise<void>;
+    (event: FeatureFlagEvent): Promisable<void>;
 }
 /**
  * Event emitter for feature flag events with subscription management
@@ -918,11 +913,7 @@ export interface FeatureFlagStubManager {
  * await scheduleFeatureFlagUpdate(update);
  * ```
  */
-export interface FeatureFlagUpdate<FeatureFlagKey extends string> {
-    /** Flag key to update */
-    key: FeatureFlagKey;
-    /** New flag value */
-    value: FeatureFlagValue;
+export interface FeatureFlagUpdate<FeatureFlagKey extends string> extends KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
     /** Delay before applying update (ms) */
     delay: number;
 }
@@ -1072,7 +1063,7 @@ export interface ControllableProvider<FeatureFlagKey extends string> {
  *
  * @template FeatureFlagKey - Type of feature flag keys
  */
-export interface SubscriptionFeatureFlagTracker<FeatureFlagKey extends string> {
+export interface SubscriptionFeatureFlagTracker<FeatureFlagKey extends string> extends Resettable {
     /** Track a new subscription */
     track: (provider: IFeatureFlagProvider<FeatureFlagKey>, id?: string) => {
         id: string;
@@ -1087,8 +1078,6 @@ export interface SubscriptionFeatureFlagTracker<FeatureFlagKey extends string> {
     getCallCount: (id: string) => number;
     /** Get last call arguments for subscription */
     getLastCall: (id: string) => unknown;
-    /** Reset all tracking data */
-    reset: () => void;
 }
 /**
  * Assertions for feature flag evaluation results.
@@ -1415,8 +1404,8 @@ export interface FeatureFlagService {
     deleteFlag(key: string): Promise<void>;
     setOverride(key: string, value: unknown): Promise<void>;
     removeOverride(key: string): Promise<void>;
-    getAllFeatureFlags(environment?: string): Promise<unknown[]>;
-    getFlagRules(key: string): Promise<unknown[]>;
+    getAllFeatureFlags(environment?: string): Promise<UnknownArray>;
+    getFlagRules(key: string): Promise<UnknownArray>;
     refreshCache(): Promise<void>;
     getHealthStatus(): Promise<unknown>;
     initializeProvider(): Promise<void>;
@@ -1458,16 +1447,16 @@ export interface FeatureFlagRepository<FeatureFlagKey extends string> {
     createFlag(createData: unknown): Promise<unknown>;
     updateFlag(key: FeatureFlagKey, updateData: unknown): Promise<unknown>;
     deleteFlag(key: FeatureFlagKey): Promise<void>;
-    getAllFlags(environment?: string): Promise<unknown[]>;
-    getFlagRules(key: FeatureFlagKey): Promise<unknown[]>;
+    getAllFlags(environment?: string): Promise<UnknownArray>;
+    getFlagRules(key: FeatureFlagKey): Promise<UnknownArray>;
     getFlag(key: FeatureFlagKey): Promise<unknown>;
     createRule(rule: unknown): Promise<unknown>;
     updateRule(ruleId: string, updateData: unknown): Promise<unknown>;
     deleteRule(ruleId: string): Promise<void>;
     getFlagByKey(key: FeatureFlagKey): Promise<unknown>;
-    getAllRules(): Promise<unknown[]>;
+    getAllRules(): Promise<UnknownArray>;
     createSampleFlags(): Promise<void>;
-    filterFlagsByEnvironment(flags: unknown[], environment: string): unknown[];
+    filterFlagsByEnvironment(flags: UnknownArray, environment: string): UnknownArray;
     inferFlagType(value: unknown): string;
 }
 /**
@@ -1613,7 +1602,7 @@ export interface CreateABTestScenario<T extends string> {
     /** A/B test configuration */
     config: ABTestConfig<T>;
     /** Get variant for user */
-    getVariantForUser: (userId: string, attributes?: Record<string, unknown>) => FeatureFlagValue;
+    getVariantForUser: (userId: string, attributes?: UnknownRecord) => FeatureFlagValue;
     getTrafficDistribution: () => {
         control: number;
         treatment: number;

package/dist/web3/types.d.ts

@@ -1,20 +1,16 @@
 import type { CHAIN_ID } from './enums';
+import type { Named } from '../common/types';
 /**
  * Defines the configuration structure for an EVM-compatible blockchain network.
  * @description This is commonly used for wallet integration, chain switching, and displaying metadata such as currency and explorer links.
  */
-export interface NetworkConfig {
+export interface NetworkConfig extends Named {
     /**
      * Numeric chain ID of the blockchain network.
      * @description Should match the value from {@link typeof CHAIN_ID}.
      * @example 137 // Polygon Mainnet
      */
     readonly chainId: typeof CHAIN_ID;
-    /**
-     * @description Full name of the network.
-     * @example "Polygon"
-     */
-    readonly name: string;
     /**
      * @description Short, user-friendly name for display purposes.
      * @example "MATIC"
@@ -24,11 +20,6 @@ export interface NetworkConfig {
      * Native currency used on the network for fees and balances.
      */
     readonly nativeCurrency: {
-        /**
-         * @description Full name of the native currency.
-         * @example "Matic"
-         */
-        readonly name: string;
         /**
          * @description Symbol of the currency used in wallet UIs.
          * @example "MATIC"
@@ -39,7 +30,7 @@ export interface NetworkConfig {
          * @example 18
          */
         readonly decimals: number;
-    };
+    } & Named;
     /**
      * @description List of public RPC endpoints used to communicate with the blockchain.
      * @example ["https://polygon-rpc.com"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.5.5",
+  "version": "1.7.0",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",
@@ -31,6 +31,7 @@
     "pnpm": ">=8.0.0"
   },
   "keywords": [],
+  "packageManager": "pnpm@10.11.0",
   "dependencies": {
     "type-fest": "^4.41.0"
   },