@plyaz/core 1.2.0 → 1.3.0

package/dist/domain/base/BaseValidator.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Base Validator
+ *
+ * Abstract base class for domain validators.
+ * Handles validation AND sanitization using Zod schemas from @plyaz/types.
+ *
+ * Supports all HTTP operations:
+ * - create (POST)
+ * - update (PUT - full replacement)
+ * - patch (PATCH - partial update)
+ * - delete (DELETE with options)
+ * - query (GET params)
+ *
+ * @example
+ * ```typescript
+ * import { CreateExampleSchema, PatchExampleSchema } from '@plyaz/types/examples';
+ *
+ * class ExampleValidator extends BaseValidator<
+ *   CreateExampleDTO,   // create
+ *   UpdateExampleDTO,   // update (full)
+ *   PatchExampleDTO,    // patch (partial)
+ *   DeleteExampleDTO,   // delete options
+ *   QueryExampleDTO     // query params
+ * > {
+ *   constructor() {
+ *     super({
+ *       createSchema: CreateExampleSchema,
+ *       patchSchema: PatchExampleSchema,
+ *       // ... other schemas
+ *     });
+ *   }
+ * }
+ * ```
+ */
+import { ValidationError } from '@plyaz/errors';
+import type { ValidationIssue, BaseErrorContext, InternalValidationSchema } from '@plyaz/types/errors';
+import type { CoreValidationResult, CoreValidatorConfig, CoreBaseValidatorInstance } from '@plyaz/types/core';
+/**
+ * Abstract base validator with default implementations
+ */
+export declare abstract class BaseValidator<TCreate = unknown, TUpdate = TCreate, TPatch = Partial<TCreate>, TDelete = unknown, TQuery = unknown> implements CoreBaseValidatorInstance<TCreate, TUpdate, TPatch, TDelete, TQuery> {
+    protected readonly config: CoreValidatorConfig<TCreate, TUpdate, TPatch, TDelete, TQuery>;
+    constructor(config?: CoreValidatorConfig<TCreate, TUpdate, TPatch, TDelete, TQuery>);
+    /**
+     * Validate data for create operation (POST)
+     */
+    validateCreate(data: unknown): CoreValidationResult<TCreate>;
+    /**
+     * Validate data for full update operation (PUT)
+     */
+    validateUpdate(data: unknown): CoreValidationResult<TUpdate>;
+    /**
+     * Validate data for partial update operation (PATCH)
+     */
+    validatePatch(data: unknown): CoreValidationResult<TPatch>;
+    /**
+     * Validate data for delete operation (DELETE with options)
+     */
+    validateDelete(data: unknown): CoreValidationResult<TDelete>;
+    /**
+     * Validate query parameters (GET list)
+     */
+    validateQuery(data: unknown): CoreValidationResult<TQuery>;
+    /**
+     * Validate and throw if invalid (for create)
+     * @throws ValidationError[] (array) if validation fails
+     */
+    validateCreateOrThrow(data: unknown): TCreate;
+    /**
+     * Validate and throw if invalid (for update)
+     * @throws ValidationError[] (array) if validation fails
+     */
+    validateUpdateOrThrow(data: unknown): TUpdate;
+    /**
+     * Validate and throw if invalid (for patch)
+     * @throws ValidationError[] (array) if validation fails
+     */
+    validatePatchOrThrow(data: unknown): TPatch;
+    /**
+     * Validate and throw if invalid (for delete)
+     * @throws ValidationError[] (array) if validation fails
+     */
+    validateDeleteOrThrow(data: unknown): TDelete;
+    /**
+     * Validate and throw if invalid (for query)
+     * @throws ValidationError[] (array) if validation fails
+     */
+    validateQueryOrThrow(data: unknown): TQuery;
+    /**
+     * Internal validation using ValidateAndFormatErrors from @plyaz/errors
+     * This handles both validation AND sanitization (via Zod transforms)
+     */
+    protected validate<T>(data: unknown, schema: InternalValidationSchema<T>): CoreValidationResult<T>;
+    /**
+     * Convert ValidationIssue[] to array of ValidationError objects
+     * Each validation issue becomes a separate ValidationError
+     */
+    protected toValidationErrorArray(issues?: ValidationIssue[]): ValidationError[];
+    /**
+     * Convert ValidationIssue[] to BaseErrorContext (legacy)
+     * @deprecated Use toValidationErrorArray instead
+     */
+    protected toErrorContext(issues?: ValidationIssue[]): BaseErrorContext;
+}
+//# sourceMappingURL=BaseValidator.d.ts.map

package/dist/domain/base/BaseValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseValidator.d.ts","sourceRoot":"","sources":["../../../src/domain/base/BaseValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAA2B,eAAe,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,8BAAsB,aAAa,CACjC,OAAO,GAAG,OAAO,EACjB,OAAO,GAAG,OAAO,EACjB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,EACzB,OAAO,GAAG,OAAO,EACjB,MAAM,GAAG,OAAO,CAChB,YAAW,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;IAE/E,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBAE9E,MAAM,GAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAM;IAQvF;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC;IAO5D;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC;IAO5D;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAO1D;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC;IAO5D;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAW1D;;;OAGG;IACH,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAW7C;;;OAGG;IACH,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAW7C;;;OAGG;IACH,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAW3C;;;OAGG;IACH,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAW7C;;;OAGG;IACH,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAe3C;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,CAAC,EAClB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAClC,oBAAoB,CAAC,CAAC,CAAC;IAgB1B;;;OAGG;IACH,SAAS,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE;IAoB/E;;;OAGG;IACH,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,GAAG,gBAAgB;CAevE"}

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

@@ -0,0 +1,10 @@
+/**
+ * Base Domain Exports
+ */
+export { BaseDomainService } from './BaseDomainService';
+export { BaseFrontendDomainService } from './BaseFrontendDomainService';
+export { BaseBackendDomainService } from './BaseBackendDomainService';
+export { BaseMapper } from './BaseMapper';
+export { BaseValidator } from './BaseValidator';
+export * from '../../utils/mapperUtils';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/base/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,cAAc,yBAAyB,CAAC"}

package/dist/domain/example/BackendExampleDomainService.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Backend Example Domain Service
+ *
+ * Demonstrates extending BaseBackendDomainService which provides:
+ * - Automatic validation → mapper → repository/API → mapper flow
+ * - Event emission throughout CRUD lifecycle
+ * - Dual mode: Repository (DbService/dummy) OR HTTP API
+ * - Configurable error throwing behavior
+ *
+ * This service only needs to:
+ * - Initialize repository in constructor
+ * - Set eventPrefix for event emission
+ * - Implement isAvailable() and dispose()
+ * - Add any custom domain methods
+ *
+ * All standard CRUD operations are inherited with cache support:
+ * - create(data, options?) - Create with optional caching
+ * - patch(id, data, options?) - Update with automatic cache invalidation
+ * - delete(id, deleteOptions?, crudOptions?) - Delete with automatic cache invalidation
+ * - getById(id, options?) - Read with cache-aside pattern
+ *
+ * Runtime: Backend (NestJS, Express, Node.js)
+ * - Uses repository (DbService or dummy data fallback)
+ * - Auto-initialized by Core.initialize() as part of DomainServices
+ * - For HTTP API calls, use fetchers from @plyaz/api directly
+ *
+ * @example
+ * ```tsx
+ * // Create service
+ * const service = await BackendExampleDomainService.create({
+ *   throwOnValidationError: true, // Throw on validation errors (default)
+ *   throwOnRepositoryError: true, // Throw on repository errors (default)
+ * });
+ *
+ * // Use inherited CRUD methods
+ * const entity = await service.create({ name: 'Test', amount: 100 });
+ * const updated = await service.patch(entity.id, { amount: 200 });
+ * await service.delete(entity.id, { soft: true });
+ * ```
+ */
+import { BaseBackendDomainService } from '../base';
+import type { ExampleEntity, ExampleResponseDTO, CreateExampleDTO, PatchExampleDTO, QueryExampleDTO, DeleteExampleDTO, ExampleStoreItem, ExampleDomainServiceConfig as _ExampleDomainServiceConfig } from '@plyaz/types/examples';
+import type { CoreServiceCreateOptions, CoreInjectedServices } from '@plyaz/types/core';
+import { ExampleRepository, type ExampleDatabaseRow } from '../../models/example';
+import { ExampleMapperClass } from './mappers/ExampleMapper';
+import { ExampleValidatorClass } from './validators/ExampleValidator';
+/**
+ * Mapper type for this service
+ */
+type ExampleMapper = InstanceType<typeof ExampleMapperClass>;
+/**
+ * Validator type for this service
+ */
+type ExampleValidator = InstanceType<typeof ExampleValidatorClass>;
+/**
+ * Example event types (for subscription)
+ */
+export type ExampleEventType = 'example:creating' | 'example:created' | 'example:updating' | 'example:updated' | 'example:deleting' | 'example:deleted' | 'example:complete' | 'example:error' | 'example:validation:started' | 'example:validation:success' | 'example:validation:failed' | 'example:sanitization:started' | 'example:sanitization:complete';
+/**
+ * Backend Example Domain Service
+ *
+ * Extends BaseBackendDomainService with all generic types:
+ * - TConfig: ExampleDomainServiceConfig
+ * - TEntity: ExampleEntity
+ * - TResponseDTO: ExampleResponseDTO
+ * - TCreateDTO: CreateExampleDTO
+ * - TUpdateDTO: CreateExampleDTO (same as create)
+ * - TPatchDTO: PatchExampleDTO
+ * - TQueryDTO: QueryExampleDTO
+ * - TDeleteOptions: DeleteExampleDTO
+ * - TRepository: ExampleRepository
+ * - TDatabaseRow: ExampleDatabaseRow
+ * - TStoreState: ExampleStoreItem
+ * - TMapper: ExampleMapper
+ * - TValidator: ExampleValidator
+ *
+ * All CRUD methods are inherited from base class - no need to implement!
+ */
+export declare class BackendExampleDomainService extends BaseBackendDomainService<_ExampleDomainServiceConfig, ExampleEntity, ExampleResponseDTO, CreateExampleDTO, CreateExampleDTO, // Update same as create
+PatchExampleDTO, QueryExampleDTO, // Query/filter type for getAll()
+DeleteExampleDTO, ExampleDatabaseRow, ExampleRepository, ExampleStoreItem, ExampleMapper, ExampleValidator> {
+    /**
+     * Repository instance for data access
+     * Required by BaseBackendDomainService
+     */
+    protected repository: ExampleRepository;
+    /**
+     * Event prefix for all events emitted by this service
+     * Required by BaseBackendDomainService
+     */
+    protected eventPrefix: string;
+    /**
+     * Cache prefix for namespacing cache keys
+     * Optional: defaults to serviceName.toLowerCase() if not set
+     */
+    protected cachePrefix: string;
+    /**
+     * Unique key for this service (used by ServiceRegistry)
+     */
+    static readonly serviceKey: "example";
+    /**
+     * Factory method for ServiceRegistry auto-initialization.
+     * Creates and initializes the service instance.
+     *
+     * @param config - Service configuration
+     * @param options - Global options from the registry (includes cache, db, api instances)
+     * @returns Promise resolving to the initialized service instance
+     */
+    static create(config: _ExampleDomainServiceConfig, options?: CoreServiceCreateOptions): Promise<BackendExampleDomainService>;
+    constructor(config?: _ExampleDomainServiceConfig, injected?: CoreInjectedServices);
+    /**
+     * Check if service is available
+     * Service is available if enabled (repository is always available)
+     */
+    isAvailable(): boolean;
+    /**
+     * Dispose/cleanup the service
+     */
+    dispose(): void;
+    /**
+     * Configure the service (mutates config)
+     * Use this to update configuration at runtime
+     */
+    configure(updates: Partial<_ExampleDomainServiceConfig>): void;
+    /**
+     * Subscribe to service events
+     * Uses CoreEventManager under the hood
+     *
+     * @param event - Event type to listen for
+     * @param handler - Event handler function
+     * @returns Unsubscribe function
+     */
+    on(event: ExampleEventType, handler: (data: unknown) => void): () => void;
+    /**
+     * Demo: Single validation error
+     * Validates data with ONE field invalid to trigger single validation error in array
+     *
+     * @throws ValidationError[] (array with 1 error)
+     */
+    demoSingleValidationError(): void;
+    /**
+     * Demo: Multiple validation errors
+     * Validates data with MULTIPLE fields invalid to trigger array of validation errors
+     *
+     * @throws ValidationError[] (array with multiple errors)
+     */
+    demoMultipleValidationErrors(): void;
+    /**
+     * Demo: Get all examples with optional filters
+     * Demonstrates the getAll() method with typed query parameters
+     *
+     * @param filters - Optional query filters (status, pagination, sorting)
+     * @returns Promise resolving to array of ExampleEntity
+     *
+     * @example
+     * ```typescript
+     * // Get all active examples
+     * const activeExamples = await service.getExamples({ status: 'active' });
+     *
+     * // Get archived examples with pagination
+     * const archivedExamples = await service.getExamples({
+     *   status: 'archived',
+     *   page: 2,
+     *   limit: 10
+     * });
+     *
+     * // Get all examples sorted by name
+     * const sortedExamples = await service.getExamples({
+     *   sort_by: 'name',
+     *   sort_order: 'asc'
+     * });
+     * ```
+     */
+    getExamples(filters?: QueryExampleDTO): Promise<ExampleEntity[]>;
+    /**
+     * Demo: Get active examples only
+     * Convenience method demonstrating filtering
+     */
+    getActiveExamples(): Promise<ExampleEntity[]>;
+    /**
+     * Demo: Get draft examples only
+     * Convenience method demonstrating filtering
+     */
+    getDraftExamples(): Promise<ExampleEntity[]>;
+    /**
+     * Demo: Get archived examples only
+     * Convenience method demonstrating filtering
+     */
+    getArchivedExamples(): Promise<ExampleEntity[]>;
+    /**
+     * Demo: Check if an example exists
+     * More efficient than fetching the full entity when you only need existence
+     *
+     * @param id - Example ID to check
+     * @returns Promise resolving to boolean
+     *
+     * @example
+     * ```typescript
+     * const exists = await service.checkExampleExists('123');
+     * if (exists) {
+     *   console.log('Example exists!');
+     * }
+     * ```
+     */
+    checkExampleExists(id: string): Promise<boolean>;
+    /**
+     * Demo: Create multiple examples at once
+     * More efficient than calling create() multiple times
+     *
+     * @param dataArray - Array of example data to create
+     * @returns Promise resolving to array of created entities
+     *
+     * @example
+     * ```typescript
+     * const examples = await service.createMultipleExamples([
+     *   { name: 'Example 1', amount: 100 },
+     *   { name: 'Example 2', amount: 200 },
+     *   { name: 'Example 3', amount: 300 },
+     * ]);
+     * console.log(`Created ${examples.length} examples`);
+     * ```
+     */
+    createMultipleExamples(dataArray: CreateExampleDTO[]): Promise<ExampleEntity[]>;
+    /**
+     * Demo: Delete multiple examples at once
+     * More efficient than calling delete() multiple times
+     *
+     * @param ids - Array of example IDs to delete
+     * @param soft - Whether to soft delete (default: true)
+     * @returns Promise resolving when all deletions complete
+     *
+     * @example
+     * ```typescript
+     * // Soft delete multiple examples
+     * await service.deleteMultipleExamples(['id1', 'id2', 'id3'], true);
+     *
+     * // Hard delete multiple examples
+     * await service.deleteMultipleExamples(['id1', 'id2', 'id3'], false);
+     * ```
+     */
+    deleteMultipleExamples(ids: string[], soft?: boolean): Promise<void>;
+}
+/**
+ * Default instance of BackendExampleDomainService
+ * Use this for singleton pattern usage
+ *
+ * @example
+ * ```tsx
+ * import { backendExampleDomainService } from '@plyaz/core';
+ *
+ * const entity = await backendExampleDomainService.create({ name: 'Test', amount: 100 });
+ * ```
+ */
+export declare const backendExampleDomainService: BackendExampleDomainService;
+export { backendExampleDomainService as backendExampleService };
+export { backendExampleDomainService as exampleService };
+//# sourceMappingURL=BackendExampleDomainService.d.ts.map

package/dist/domain/example/BackendExampleDomainService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackendExampleDomainService.d.ts","sourceRoot":"","sources":["../../../src/domain/example/BackendExampleDomainService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,IAAI,2BAA2B,EAC1D,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAMtE;;GAEG;AACH,KAAK,aAAa,GAAG,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE7D;;GAEG;AACH,KAAK,gBAAgB,GAAG,YAAY,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAExB,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,GAEf,4BAA4B,GAC5B,4BAA4B,GAC5B,2BAA2B,GAE3B,8BAA8B,GAC9B,+BAA+B,CAAC;AAMpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,2BAA4B,SAAQ,wBAAwB,CACvE,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAAE,wBAAwB;AAC1C,eAAe,EACf,eAAe,EAAE,iCAAiC;AAClD,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,CACjB;IAKC;;;OAGG;IACH,SAAS,CAAC,UAAU,EAAE,iBAAiB,CAAC;IAExC;;;OAGG;IACH,SAAS,CAAC,WAAW,SAAa;IAElC;;;OAGG;IACH,SAAS,CAAC,WAAW,SAAa;IAMlC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,YAAwB;IAElD;;;;;;;OAOG;WACU,MAAM,CACjB,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,2BAA2B,CAAC;gBAgB3B,MAAM,GAAE,2BAAgC,EAAE,QAAQ,CAAC,EAAE,oBAAoB;IA8BrF;;;OAGG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAAG,IAAI;IAK9D;;;;;;;OAOG;IAEH,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAUzE;;;;;OAKG;IACH,yBAAyB,IAAI,IAAI;IAUjC;;;;;OAKG;IACH,4BAA4B,IAAI,IAAI;IAcpC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAItE;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAInD;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAIlD;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAQrD;;;;;;;;;;;;;;OAcG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD;;;;;;;;;;;;;;;;OAgBG;IACG,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIrF;;;;;;;;;;;;;;;;OAgBG;IACG,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CA6BxE;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,6BAAoC,CAAC;AAG7E,OAAO,EAAE,2BAA2B,IAAI,qBAAqB,EAAE,CAAC;AAChE,OAAO,EAAE,2BAA2B,IAAI,cAAc,EAAE,CAAC"}

package/dist/domain/example/FrontendExampleDomainService.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Example Frontend Service
+ *
+ * Demonstrates extending BaseFrontendDomainService which provides:
+ * - Automatic CRUD operations (fetchAll, fetchById, create, update, delete)
+ * - Store integration (Zustand-compatible)
+ * - Error handling with @plyaz/errors
+ * - Event emission and subscription
+ * - Loading/error state management
+ * - Automatic DTO validation and mapping via validator and mapper
+ *
+ * This service only needs to:
+ * - Set eventPrefix for event emission
+ * - Add any custom domain methods (e.g., polling)
+ * - Override lifecycle hooks if needed
+ *
+ * All standard CRUD operations are inherited:
+ * - fetchAll(query?) - Inherited from BaseFrontendDomainService
+ * - fetchById(id) - Inherited from BaseFrontendDomainService
+ * - create(data) - Inherited from BaseFrontendDomainService
+ * - update(id, data) - Inherited from BaseFrontendDomainService
+ * - delete(id) - Inherited from BaseFrontendDomainService
+ *
+ * Runtime: Frontend only (Browser/React/Next.js)
+ *
+ * @example
+ * ```tsx
+ * // Service automatically gets stores via ServiceRegistry injection
+ * const service = await ServiceRegistry.getAsync<FrontendExampleDomainService>('example');
+ *
+ * // Or create directly (stores injected if configured)
+ * const service = new FrontendExampleDomainService({
+ *   enabled: true,
+ *   apiBasePath: '/api/examples',
+ * });
+ *
+ * // Use inherited CRUD methods
+ * const items = await service.fetchAll();
+ * const activeItems = await service.fetchAll({ status: 'active' });
+ * const item = await service.create({ name: 'Test', amount: 100 });
+ * const updated = await service.update(item.id, { amount: 200 });
+ * await service.delete(item.id);
+ * ```
+ */
+import type { ExampleEntity, ExampleResponseDTO, CreateExampleDTO, PatchExampleDTO, QueryExampleDTO, ExampleStoreItem } from '@plyaz/types/examples';
+import { BaseFrontendDomainService } from '../base';
+import { ExampleMapperClass } from './mappers/ExampleMapper';
+export type { ExampleFrontendStoreData, ExampleFrontendStoreSlice, ExampleFrontendServiceConfig, ExampleFrontendEventType, } from '@plyaz/types/examples';
+import type { ExampleFrontendStoreData, ExampleFrontendStoreSlice, ExampleFrontendServiceConfig as _ExampleFrontendServiceConfig, ExampleFrontendEventType } from '@plyaz/types/examples';
+import type { CoreServiceCreateOptions } from '@plyaz/types/core';
+import type { CoreBaseValidatorInstance } from '@plyaz/types/core';
+/**
+ * Example Frontend Service
+ *
+ * Extends BaseFrontendDomainService with all generic types:
+ * - TConfig: ExampleFrontendServiceConfig
+ * - TStore: ExampleFrontendStoreSlice
+ * - TData: ExampleFrontendStoreData
+ * - TEntity: ExampleEntity
+ * - TResponseDTO: ExampleResponseDTO
+ * - TCreateDTO: CreateExampleDTO
+ * - TPatchDTO: PatchExampleDTO
+ * - TQueryDTO: QueryExampleDTO
+ * - TStoreState: ExampleStoreItem
+ * - TMapper: ExampleMapper
+ *
+ * All CRUD methods are inherited from base class - no need to implement!
+ */
+export declare class FrontendExampleDomainService extends BaseFrontendDomainService<_ExampleFrontendServiceConfig, ExampleFrontendStoreSlice, ExampleFrontendStoreData, ExampleEntity, ExampleResponseDTO, CreateExampleDTO, PatchExampleDTO, QueryExampleDTO, ExampleStoreItem, InstanceType<typeof ExampleMapperClass>, CoreBaseValidatorInstance, void> {
+    /**
+     * Event prefix for all events emitted by this service
+     * Required by BaseFrontendDomainService
+     */
+    protected eventPrefix: string;
+    /**
+     * Primary store key - the store this service can mutate
+     */
+    protected primaryStoreKey: "example";
+    /**
+     * Read-only store keys - inherits error and featureFlags from base
+     * No need to redeclare them - they're always included by default
+     */
+    private pollingTimer;
+    static readonly serviceKey: "example-frontend";
+    /**
+     * Factory method for ServiceRegistry auto-initialization.
+     * Creates and initializes the service instance.
+     */
+    static create(config: _ExampleFrontendServiceConfig, options?: CoreServiceCreateOptions): Promise<FrontendExampleDomainService>;
+    constructor(config?: _ExampleFrontendServiceConfig, options?: CoreServiceCreateOptions);
+    isAvailable(): boolean;
+    dispose(): void;
+    /**
+     * After fetchAll - emit event (store sync handled automatically)
+     * Note: Base class automatically calls syncToStores() which uses storeHandlers
+     */
+    protected afterFetchAll(entities: ExampleEntity[]): Promise<void>;
+    /**
+     * Subscribe to service events
+     *
+     * @example
+     * ```tsx
+     * const unsubscribe = service.on('example:created', (data) => {
+     *   console.log('Item created:', data.entity);
+     * });
+     *
+     * // Later: cleanup
+     * unsubscribe();
+     * ```
+     */
+    on(event: ExampleFrontendEventType, handler: (data: unknown) => void): () => void;
+    /**
+     * Start polling for updates
+     * Domain-specific feature - not part of base class
+     */
+    startPolling(): void;
+    /**
+     * Stop polling
+     */
+    stopPolling(): void;
+    /**
+     * Demo: Fetch all examples with optional filters
+     * Demonstrates the fetchAll() method with typed query parameters
+     *
+     * @param filters - Optional query filters (status, pagination, sorting)
+     * @returns Promise resolving to array of ExampleEntity
+     *
+     * @example
+     * ```typescript
+     * // Fetch all active examples
+     * const activeExamples = await service.getExamples({ status: 'active' });
+     *
+     * // Fetch archived examples with pagination
+     * const archivedExamples = await service.getExamples({
+     *   status: 'archived',
+     *   page: 2,
+     *   limit: 10
+     * });
+     *
+     * // Fetch all examples sorted by name
+     * const sortedExamples = await service.getExamples({
+     *   sort_by: 'name',
+     *   sort_order: 'asc'
+     * });
+     * ```
+     */
+    getExamples(filters?: QueryExampleDTO): Promise<ExampleEntity[]>;
+    /**
+     * Demo: Fetch active examples only
+     * Convenience method demonstrating filtering
+     */
+    getActiveExamples(): Promise<ExampleEntity[]>;
+    /**
+     * Demo: Fetch draft examples only
+     * Convenience method demonstrating filtering
+     */
+    getDraftExamples(): Promise<ExampleEntity[]>;
+    /**
+     * Demo: Fetch archived examples only
+     * Convenience method demonstrating filtering
+     */
+    getArchivedExamples(): Promise<ExampleEntity[]>;
+}
+//# sourceMappingURL=FrontendExampleDomainService.d.ts.map

package/dist/domain/example/FrontendExampleDomainService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrontendExampleDomainService.d.ts","sourceRoot":"","sources":["../../../src/domain/example/FrontendExampleDomainService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAc7D,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,IAAI,6BAA6B,EAC7D,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAMnE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,4BAA6B,SAAQ,yBAAyB,CACzE,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,CAAC,OAAO,kBAAkB,CAAC,EACvC,yBAAyB,EACzB,IAAI,CACL;IAKC;;;OAGG;IACH,SAAS,CAAC,WAAW,SAAa;IAElC;;OAEG;IACH,SAAS,CAAC,eAAe,YAAsB;IAE/C;;;OAGG;IAOH,OAAO,CAAC,YAAY,CAA+C;IAMnE,MAAM,CAAC,QAAQ,CAAC,UAAU,qBAAiC;IAE3D;;;OAGG;WACU,MAAM,CACjB,MAAM,EAAE,6BAA6B,EACrC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,4BAA4B,CAAC;gBAmB5B,MAAM,GAAE,6BAAkC,EAAE,OAAO,CAAC,EAAE,wBAAwB;IA0E1F,WAAW,IAAI,OAAO;IAItB,OAAO,IAAI,IAAI;IASf;;;OAGG;cACsB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BhF;;;;;;;;;;;;OAYG;IACH,EAAE,CAAC,KAAK,EAAE,wBAAwB,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAQjF;;;OAGG;IACH,YAAY,IAAI,IAAI;IAapB;;OAEG;IACH,WAAW,IAAI,IAAI;IAYnB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAItE;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAInD;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAIlD;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;CAkBtD"}

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

@@ -0,0 +1,10 @@
+/**
+ * Example Domain Exports
+ *
+ * Types and schemas should be imported from @plyaz/types/examples
+ */
+export { BackendExampleDomainService, backendExampleDomainService, backendExampleService, exampleService, type ExampleEventType, } from './BackendExampleDomainService';
+export { FrontendExampleDomainService, type ExampleFrontendStoreSlice, type ExampleFrontendStoreData, type ExampleFrontendServiceConfig, type ExampleFrontendEventType, } from './FrontendExampleDomainService';
+export { ExampleMapper } from './mappers/ExampleMapper';
+export { ExampleValidator } from './validators/ExampleValidator';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/example/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/example/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,4BAA4B,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAC9B,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/domain/example/mappers/ExampleMapper.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Example Mapper
+ *
+ * Demonstrates extending BaseMapper for a domain entity.
+ * Uses types from @plyaz/types/examples.
+ *
+ * Note: Validation is handled by ExampleValidator, not here.
+ */
+import { BaseMapper } from '../../base';
+import type { ExampleEntity, ExampleResponseDTO, ExampleStoreItem, CreateExampleDTO, UpdateExampleDTO, PatchExampleDTO, QueryExampleDTO } from '@plyaz/types/examples';
+/**
+ * Example Mapper implementation
+ *
+ * Supports:
+ * - toDomain: API response → Domain
+ * - toCreateDTO: Domain → POST body
+ * - toPatchDTO: Domain → PATCH body
+ * - toStoreState: Domain → Zustand store
+ */
+declare class ExampleMapperClass extends BaseMapper<ExampleEntity, ExampleResponseDTO, CreateExampleDTO, UpdateExampleDTO, PatchExampleDTO, QueryExampleDTO, ExampleStoreItem> {
+    /**
+     * API DTO → Domain Model
+     */
+    toDomain(dto: ExampleResponseDTO): ExampleEntity;
+    /**
+     * Domain data → Create DTO (POST body)
+     */
+    toCreateDTO(data: Partial<ExampleEntity>): CreateExampleDTO;
+    /**
+     * Domain data → Update DTO (PUT body - full)
+     */
+    toUpdateDTO(data: Partial<ExampleEntity>): UpdateExampleDTO;
+    /**
+     * Domain data → Patch DTO (PATCH body - partial)
+     */
+    toPatchDTO(data: Partial<ExampleEntity>): PatchExampleDTO;
+    /**
+     * Filters → Query params DTO (GET)
+     */
+    toQueryDTO(filters: Partial<QueryExampleDTO>): QueryExampleDTO;
+    /**
+     * Domain → Store state (serializable)
+     */
+    toStoreState(domain: ExampleEntity): ExampleStoreItem;
+    /**
+     * Store state → Domain (restore computed props)
+     */
+    fromStoreState(state: ExampleStoreItem): ExampleEntity;
+    /**
+     * Database row → Response DTO
+     * Maps repository output to API response format
+     */
+    toResponseDTO(row: {
+        id: string;
+        name: string;
+        description: string | null;
+        amount: number;
+        owner_id: string;
+        status: string;
+        is_visible: boolean;
+        created_at: string;
+        updated_at: string;
+    }): ExampleResponseDTO;
+}
+export { ExampleMapperClass };
+export declare const ExampleMapper: ExampleMapperClass;
+//# sourceMappingURL=ExampleMapper.d.ts.map

package/dist/domain/example/mappers/ExampleMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExampleMapper.d.ts","sourceRoot":"","sources":["../../../../src/domain/example/mappers/ExampleMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAQ/B;;;;;;;;GAQG;AACH,cAAM,kBAAmB,SAAQ,UAAU,CACzC,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,CACjB;IACC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,kBAAkB,GAAG,aAAa;IAkBhD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,gBAAgB;IAS3D;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,gBAAgB;IAI3D;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,eAAe;IAmBzD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe;IAc9D;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB;IAgBrD;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa;IAgBtD;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,kBAAkB;CAavB;AAGD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAG9B,eAAO,MAAM,aAAa,oBAA2B,CAAC"}