@plyaz/types 1.19.4 → 1.20.0

package/dist/store/index.cjs

@@ -1,4 +1,17 @@
 'use strict';
 
+// @plyaz package - Built with tsup
+
+// src/store/keys.ts
+var STORE_KEYS = {
+  /** Error store slice - tracks application errors */
+  ERROR: "error",
+  /** Feature flags store slice - manages feature flag state */
+  FEATURE_FLAGS: "featureFlags"
+};
+var ALL_STORE_KEYS = Object.values(STORE_KEYS);
+
+exports.ALL_STORE_KEYS = ALL_STORE_KEYS;
+exports.STORE_KEYS = STORE_KEYS;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/store/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../../src/store/keys.ts"],"names":[],"mappings":";;;;;AAUO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,KAAA,EAAO,OAAA;AAAA;AAAA,EAEP,aAAA,EAAe;AACjB;AAUO,IAAM,cAAA,GAAiB,MAAA,CAAO,MAAA,CAAO,UAAU","file":"index.cjs","sourcesContent":["/**\n * Store Keys Types\n *\n * Type definitions for store keys used across packages.\n * The actual runtime values are defined in @plyaz/store.\n */\n\n/**\n * Keys for all available store slices.\n */\nexport const STORE_KEYS = {\n  /** Error store slice - tracks application errors */\n  ERROR: 'error',\n  /** Feature flags store slice - manages feature flag state */\n  FEATURE_FLAGS: 'featureFlags',\n} as const;\n\n/**\n * Type for store keys.\n */\nexport type StoreKey = (typeof STORE_KEYS)[keyof typeof STORE_KEYS];\n\n/**\n * Array of all store keys for iteration.\n */\nexport const ALL_STORE_KEYS = Object.values(STORE_KEYS) as StoreKey[];\n"]}

package/dist/store/index.d.ts

@@ -1 +1,3 @@
 export type * from './types';
+export { STORE_KEYS, ALL_STORE_KEYS } from './keys';
+export type { StoreKey } from './keys';

package/dist/store/index.js

@@ -1,3 +1,14 @@
+// @plyaz package - Built with tsup
 
+// src/store/keys.ts
+var STORE_KEYS = {
+  /** Error store slice - tracks application errors */
+  ERROR: "error",
+  /** Feature flags store slice - manages feature flag state */
+  FEATURE_FLAGS: "featureFlags"
+};
+var ALL_STORE_KEYS = Object.values(STORE_KEYS);
+
+export { ALL_STORE_KEYS, STORE_KEYS };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../src/store/keys.ts"],"names":[],"mappings":";;;AAUO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,KAAA,EAAO,OAAA;AAAA;AAAA,EAEP,aAAA,EAAe;AACjB;AAUO,IAAM,cAAA,GAAiB,MAAA,CAAO,MAAA,CAAO,UAAU","file":"index.js","sourcesContent":["/**\n * Store Keys Types\n *\n * Type definitions for store keys used across packages.\n * The actual runtime values are defined in @plyaz/store.\n */\n\n/**\n * Keys for all available store slices.\n */\nexport const STORE_KEYS = {\n  /** Error store slice - tracks application errors */\n  ERROR: 'error',\n  /** Feature flags store slice - manages feature flag state */\n  FEATURE_FLAGS: 'featureFlags',\n} as const;\n\n/**\n * Type for store keys.\n */\nexport type StoreKey = (typeof STORE_KEYS)[keyof typeof STORE_KEYS];\n\n/**\n * Array of all store keys for iteration.\n */\nexport const ALL_STORE_KEYS = Object.values(STORE_KEYS) as StoreKey[];\n"]}

package/dist/store/keys.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Store Keys Types
+ *
+ * Type definitions for store keys used across packages.
+ * The actual runtime values are defined in @plyaz/store.
+ */
+/**
+ * Keys for all available store slices.
+ */
+export declare const STORE_KEYS: {
+    /** Error store slice - tracks application errors */
+    readonly ERROR: "error";
+    /** Feature flags store slice - manages feature flag state */
+    readonly FEATURE_FLAGS: "featureFlags";
+};
+/**
+ * Type for store keys.
+ */
+export type StoreKey = (typeof STORE_KEYS)[keyof typeof STORE_KEYS];
+/**
+ * Array of all store keys for iteration.
+ */
+export declare const ALL_STORE_KEYS: StoreKey[];

package/dist/store/types.d.ts

@@ -1,82 +1,73 @@
-import type { StateCreator } from 'zustand';
-import type { BaseErrorContext } from '../errors';
 /**
- * Represents the error state and actions available for managing global errors.
+ * Store Types
  *
- * @typedef {Object} ErrorSliceType
- * @property {ReturnResponseType | null} error - The current error state, or `null` if no error exists.
- * @property {(error: ReturnResponseType) => void} addError - Adds or updates the global error state.
- * @property {() => void} clearError - Clears the current error from the store.
+ * Type definitions for Zustand store configurations used by @plyaz/store.
+ *
+ * @fileoverview Store configuration and hook result types
+ * @version 2.0.0
  */
-type ErrorSeverity = 'critical' | 'error' | 'warning' | 'info';
-interface BaseError {
-    statusCode: number;
-    message: string;
-    timestamp: string;
-    type: string;
-    context?: BaseErrorContext;
-}
-export interface ErrorLogEntry {
-    id: string;
-    error: BaseError;
-    timestamp: string;
-    severity?: ErrorSeverity;
-    source?: string;
-    correlationId?: string;
-    dismissed?: boolean;
-    context?: Record<string, object>;
-}
-export interface ErrorOptions {
-    source?: string;
-    context?: Record<string, object>;
-    severity?: ErrorSeverity;
-    correlationId?: string;
+import type { SerializedError, ErrorStoreActions, ErrorStoreSlice } from '../errors/store';
+import type { FeatureFlagStoreState, FeatureFlagStoreSlice } from '../features/feature-flag/store.types';
+/**
+ * Configuration for creating an error store.
+ */
+export interface ErrorStoreConfig {
+    /** Maximum errors to keep (default: 100) */
+    maxErrors?: number;
 }
-export interface ErrorSliceType {
-    errors: ErrorLogEntry[];
-    maxErrors: number;
-    addError: (error: BaseError, options?: ErrorOptions) => void;
-    addErrors: (errors: BaseError[], options?: ErrorOptions) => void;
-    clearError: (errorId: string) => void;
-    clearErrors: (errorIds: string[]) => void;
-    clearErrorsByType: (type: string) => void;
-    clearErrorsBySeverity: (severity: ErrorSeverity) => void;
-    clearAll: () => void;
-    dismissError: (errorId: string) => void;
-    dismissErrors: (errorIds: string[]) => void;
-    dismissAll: () => void;
-    getLatestError: () => ErrorLogEntry | null;
-    getErrorsByType: (type: string) => ErrorLogEntry[];
-    getErrorsBySeverity: (severity: ErrorSeverity) => ErrorLogEntry[];
-    getErrorsBySource: (source: string) => ErrorLogEntry[];
-    getUndismissedErrors: () => ErrorLogEntry[];
-    getActiveErrors: () => ErrorLogEntry[];
-    hasActiveErrors: () => boolean;
-    getErrorCount: () => number;
-    getActiveErrorCount: () => number;
+/**
+ * Result type for useErrorState hook.
+ * Combines error state with actions.
+ */
+export interface UseErrorStateResult extends ErrorStoreActions {
+    /** All errors in the store */
+    errors: SerializedError[];
+    /** Active (undismissed) errors */
+    activeErrors: SerializedError[];
+    /** Most recent error */
+    lastError: SerializedError | null;
+    /** Total error count */
+    errorCount: number;
+    /** Active (undismissed) error count */
+    activeErrorCount: number;
+    /** Whether there are any errors */
+    hasErrors: boolean;
+    /** Whether there are any active errors */
+    hasActiveErrors: boolean;
+    /** Whether error middleware is connected */
+    isConnected: boolean;
 }
 /**
- * Base Zustand slice creator type.
- *
- * Used for slices **without** middleware such as `persist` or `immer`.
+ * Configuration for creating a Zustand feature flag store.
+ * Used by createFeatureFlagStore in @plyaz/store.
  */
-export type BaseSliceCreator<T> = StateCreator<T>;
-type MiddlewareMutators = [never, unknown][];
+export interface FeatureFlagStoreConfig {
+    /** Enable Redux DevTools integration */
+    devtools?: boolean;
+    /** DevTools store name */
+    devtoolsName?: string;
+    /** Enable persistence */
+    persist?: boolean;
+    /** Persistence storage name */
+    persistName?: string;
+    /** Keys to persist (defaults to ['flags', 'defaults']) */
+    persistPartialize?: (keyof FeatureFlagStoreState)[];
+}
 /**
- * Zustand slice creator type for slices that use middleware
- * like `persist` and `immer`.
- *
- * Note: You don't need to manually specify middleware type tuples
- * (like `["zustand/persist", T]`) since Zustand automatically infers them.
+ * Combined root store state and actions.
+ * Merges all slice types into a single store interface.
  */
-export type PersistentSliceCreator<T> = StateCreator<T, [], MiddlewareMutators, T>;
+export type RootStoreSlice = ErrorStoreSlice & FeatureFlagStoreSlice;
 /**
- * Root store type that combines multiple Zustand slices.
- *
- * Currently includes only `ErrorSliceType`, but can later be extended
- * to include other slices such as `AuthSliceType`, `UserSliceType`, etc.
- *
- * @typedef {ErrorSliceType} RootStore
+ * Configuration for creating the root store.
  */
-export type RootStore = ErrorSliceType;
-export {};
+export interface RootStoreConfig {
+    /** Error store configuration */
+    errors?: ErrorStoreConfig;
+    /** Feature flag store configuration */
+    featureFlags?: FeatureFlagStoreConfig;
+    /** Enable Redux DevTools integration */
+    devtools?: boolean;
+    /** DevTools store name */
+    devtoolsName?: string;
+}

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

@@ -46,7 +46,7 @@
 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 { FeatureFlag, FeatureFlagCondition, FeatureFlagConfig, FeatureFlagContext, FeatureFlagEvaluation, FeatureFlagRule, FeatureFlagValue, FeatureFlagProvider as IFeatureFlagProvider, FeatureFlagContextValue, FeatureFlagProviderType } from '../../../features';
 import type { MockLogger, RenderFunction, RenderHookFunction } from '../../common';
 import type { Promisable } from 'type-fest';
 import type { Describable, KeyValuePair, Resettable, WithMetadata, WithTimestamp } from '../../../common';
@@ -461,7 +461,7 @@ export interface FeatureFlagTestOptions<FeatureFlagKey extends string> {
     /** Default evaluation context */
     context?: FeatureFlagContext;
     /** Provider type to use */
-    provider?: 'memory' | 'file' | 'database' | 'api' | 'redis';
+    provider?: FeatureFlagProviderType;
     /** Enable caching */
     cache?: boolean;
     /** Enable auto-refresh */
@@ -643,7 +643,7 @@ export interface FeatureFlagHelpersMock<FeatureFlagKey extends string> {
  */
 export interface FeatureFlagTestConfig {
     /** Default provider type */
-    defaultProvider: 'memory' | 'file' | 'database' | 'api' | 'redis';
+    defaultProvider: FeatureFlagProviderType;
     /** Default request timeout */
     defaultTimeout: number;
     /** Enable caching */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.19.4",
+  "version": "1.20.0",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",
@@ -210,6 +210,9 @@
       "import": "./dist/campaign/index.js",
       "require": "./dist/campaign/index.cjs"
     },
+    "./globals": {
+      "types": "./dist/globals.d.ts"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -300,9 +303,10 @@
     }
   },
   "scripts": {
-    "build": "pnpm clean && pnpm build:js && pnpm build:types",
+    "build": "pnpm clean && pnpm build:js && pnpm build:types && pnpm build:globals",
     "build:js": "tsup",
     "build:types": "tsc src/index.ts --emitDeclarationOnly --esModuleInterop --outDir dist --declaration --skipLibCheck",
+    "build:globals": "cp src/globals.d.ts dist/globals.d.ts",
     "build:watch": "tsup --watch",
     "dev": "tsup --watch",
     "lint": "eslint ./src",