@plyaz/types 1.22.0 → 1.22.2

package/dist/core/domain/crud.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CRUD Operation Types
+ * Type definitions for CRUD operations in @plyaz/core domain services
+ */
+/**
+ * Cache-specific options for CRUD operations
+ */
+export interface CrudCacheOptions {
+    /** Enable/disable caching for this operation (default: true if cache available) */
+    useCache?: boolean;
+    /** TTL override for this specific operation (in seconds) */
+    cacheTtl?: number;
+    /** Force cache invalidation after operation (useful for updates/deletes) */
+    invalidateCache?: boolean;
+    /** Custom cache key (will still be prefixed with cachePrefix) */
+    customKey?: string;
+}
+/**
+ * Options for CRUD operations (create, getById, patch, delete, getAll)
+ *
+ * Provides extensible configuration for CRUD operations with cache support
+ * and room for future additions like pagination, sorting, filtering, etc.
+ */
+export interface CrudOperationOptions {
+    /** Cache-related options */
+    cache?: CrudCacheOptions;
+}

package/dist/core/domain/index.d.ts

@@ -2,4 +2,5 @@
  * Core Domain Types
  * Type definitions for @plyaz/core domain services
  */
-export type { CoreBaseDomainServiceInterface, CoreEventSubscribable, CoreProviderSubscribable, CoreValidationResult, CoreValidatorConfig, CoreBaseValidatorInstance, CoreBaseMapperInstance, CoreBaseDomainServiceConfig, CoreMapperClass, CoreValidatorClass, CoreBaseServiceConfig, } from './types';
+export type { CoreBaseDomainServiceInterface, CoreEventSubscribable, CoreProviderSubscribable, CoreValidationResult, CoreValidatorConfig, CoreBaseValidatorInstance, CoreBaseMapperInstance, CoreBaseDomainServiceConfig, CoreBaseBackendServiceConfig, CoreMapperClass, CoreValidatorClass, CoreBaseServiceConfig, CoreInjectedServices, } from './types';
+export type { CrudCacheOptions, CrudOperationOptions, } from './crud';

package/dist/core/domain/types.d.ts

@@ -77,6 +77,7 @@ export interface CoreBaseValidatorInstance<TCreate = unknown, TUpdate = unknown,
 export interface CoreBaseMapperInstance<TDomain = unknown, TResponseDTO = unknown, TCreateDTO = unknown, TUpdateDTO = TCreateDTO, TPatchDTO = Partial<TCreateDTO>, TQueryDTO = unknown, TStoreState = TDomain> {
     toDomain(dto: TResponseDTO): TDomain;
     toDomainList(dtos: TResponseDTO[]): TDomain[];
+    toResponseDTO?(row: unknown): TResponseDTO;
     toCreateDTO?(data: Partial<TDomain>): TCreateDTO;
     toUpdateDTO?(data: Partial<TDomain>): TUpdateDTO;
     toPatchDTO?(data: Partial<TDomain>): TPatchDTO;
@@ -102,6 +103,18 @@ export type CoreMapperClass<T extends CoreBaseMapperInstance<unknown, unknown> =
  * Type for validator class constructor
  */
 export type CoreValidatorClass<T extends CoreBaseValidatorInstance = CoreBaseValidatorInstance> = new () => T;
+/**
+ * Injected services/dependencies for domain services.
+ * These are created/managed by ServiceRegistry and injected into services.
+ */
+export interface CoreInjectedServices {
+    /** Cache manager instance */
+    cache?: unknown;
+    /** Database service instance */
+    db?: unknown;
+    /** API client instance */
+    api?: unknown;
+}
 /**
  * Base service configuration passed to constructor
  */
@@ -120,4 +133,25 @@ export interface CoreBaseServiceConfig<TConfig extends CoreBaseDomainServiceConf
     mapperClass?: CoreMapperClass<TMapper>;
     /** Validator class for input validation */
     validatorClass?: CoreValidatorClass<TValidator>;
+    /** Injected services (cache, db, api) */
+    injected?: CoreInjectedServices;
+}
+/**
+ * Configuration for backend domain services
+ * Extends base config with backend-specific options
+ */
+export interface CoreBaseBackendServiceConfig extends CoreBaseDomainServiceConfig {
+    /** Throw on validation errors (default: true) */
+    throwOnValidationError?: boolean;
+    /** Throw on repository errors (default: true) */
+    throwOnRepositoryError?: boolean;
+    /** Emit lifecycle events (default: true) */
+    emitEvents?: boolean;
+    /** Cache configuration */
+    cache?: {
+        /** Enable/disable cache for this service (default: true) */
+        enabled?: boolean;
+        /** Default TTL in seconds for cache entries (default: 300 = 5 minutes) */
+        defaultTtl?: number;
+    };
 }

package/dist/core/events/payloads.d.ts

@@ -154,6 +154,7 @@ export interface CoreEntityDeletingPayload {
 export interface CoreEntityErrorPayload {
     error: unknown;
     entityId?: string;
+    data?: Record<string, unknown>;
 }
 /**
  * Payload for entity:*:complete events (regardless of success/failure)

package/dist/core/frontend/featureFlags.d.ts

@@ -88,11 +88,11 @@ export interface CoreFeatureFlagServiceInterface extends CoreBaseFrontendService
     /** Fetch all flags and sync to stores */
     fetchAndSyncAll(context?: FeatureFlagContext): Promise<Record<string, FeatureFlagValue>>;
     /** Create a new flag */
-    create<TKey extends string = string>(data: CreateFlagRequest<TKey>): Promise<FeatureFlag<TKey>>;
+    createFlag<TKey extends string = string>(data: CreateFlagRequest<TKey>): Promise<FeatureFlag<TKey>>;
     /** Update an existing flag */
-    update<TKey extends string = string>(key: TKey, data: Partial<CreateFlagRequest<TKey>>): Promise<FeatureFlag<TKey>>;
+    updateFlag<TKey extends string = string>(key: TKey, data: Partial<CreateFlagRequest<TKey>>): Promise<FeatureFlag<TKey>>;
     /** Delete a flag */
-    delete<TKey extends string = string>(key: TKey): Promise<void>;
+    deleteFlag<TKey extends string = string>(key: TKey): Promise<void>;
     /** Get rules for a flag */
     getRules<TKey extends string = string>(key: TKey): Promise<FeatureFlagRule<TKey>[]>;
     /** Get all rules */

package/dist/core/frontend/index.d.ts

@@ -2,5 +2,5 @@
  * Core Frontend Types
  * Type definitions for @plyaz/core frontend services
  */
-export type { CoreBaseFrontendStore, CoreBaseFrontendServiceConfig, CoreBaseFrontendServiceInterface, CorePlyazApiConfig, FrontendFeatureFlagProvider, CorePlyazFeatureFlagConfig, CorePlyazStoreConfig, CorePlyazConfig, CoreFeatureFlagServiceLike, CoreFeatureFlagFetcherOptions, CoreFeatureFlagStoreInitConfig, CoreBaseFrontendServiceConstructorConfig, CoreInitializationErrorProps, CoreInitializationLoadingProps, CorePlyazServices, CorePlyazContextValue, CorePlyazProviderProps, } from './types';
+export type { CoreBaseFrontendStore, CoreBaseFrontendServiceConfig, CoreBaseFrontendServiceInterface, CoreStoreHandlers, CoreFetcherFunction, CoreServiceFetchers, CorePlyazApiConfig, FrontendFeatureFlagProvider, CorePlyazFeatureFlagConfig, CorePlyazStoreConfig, CorePlyazConfig, CoreFeatureFlagServiceLike, CoreFeatureFlagFetcherOptions, CoreFeatureFlagStoreInitConfig, CoreBaseFrontendServiceConstructorConfig, CoreInitializationErrorProps, CoreInitializationLoadingProps, CorePlyazServices, CorePlyazContextValue, CorePlyazProviderProps, } from './types';
 export type { CoreFrontendFeatureFlagEventType, CoreFeatureFlagStore, CoreFeatureFlagServiceConfig, CoreFeatureFlagServiceInitConfig, CoreFeatureFlagServiceInterface, } from './featureFlags';