@plyaz/core 1.22.9 → 1.23.0

package/dist/backend/campaign/campaign.controller.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Campaign Controller
+ *
+ * NestJS controller demonstrating Core + BackendCampaignDomainService integration.
+ *
+ * @fileoverview Campaign REST API controller providing CRUD operations for campaigns
+ * @module CampaignController
+ */
+import { BackendCampaignDomainService } from '../../domain/campaign';
+import type { CampaignEntity, CreateCampaignDTO, PatchCampaignDTO } from '@plyaz/types/campaign';
+import type { ReturnResponseType } from '@plyaz/types/errors';
+/**
+ * Injection token for BackendCampaignDomainService
+ * @constant {string}
+ */
+export declare const BACKEND_CAMPAIGN_DOMAIN_SERVICE = "BACKEND_CAMPAIGN_DOMAIN_SERVICE";
+/**
+ * Campaign Controller
+ *
+ * Provides REST API endpoints for campaign management operations.
+ * All endpoints return standardized response format using SuccessResponseStandard.
+ *
+ * @class CampaignController
+ * @decorator @Controller('campaign')
+ *
+ * @example
+ * ```typescript
+ * // Usage in app.module.ts
+ * import { CampaignModule } from '@plyaz/core';
+ *
+ * @Module({
+ *   imports: [CampaignModule],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * Routes:
+ * - GET  /campaign/health                  - Health check
+ * - GET  /campaign/entities/:id            - Get campaign by ID
+ * - POST /campaign/entities                - Create campaign
+ * - PATCH /campaign/entities/:id           - Update campaign
+ * - DELETE /campaign/entities/:id          - Delete campaign
+ */
+export declare class CampaignController {
+    private readonly campaignService;
+    /**
+     * Creates an instance of CampaignController
+     *
+     * @param {BackendCampaignDomainService} campaignService - Injected campaign domain service
+     */
+    constructor(campaignService: BackendCampaignDomainService);
+    /**
+     * Health check endpoint
+     *
+     * @method GET
+     * @route /campaign/health
+     * @returns {ReturnResponseType<{service: boolean, timestamp: string}>} Service health status
+     *
+     * @example
+     * ```http
+     * GET /campaign/health
+     * ```
+     *
+     * @example Response
+     * ```json
+     * {
+     *   "success": true,
+     *   "message": "Service is healthy",
+     *   "data": {
+     *     "service": true,
+     *     "timestamp": "2024-01-01T00:00:00.000Z"
+     *   }
+     * }
+     * ```
+     */
+    health(): ReturnResponseType<{
+        service: boolean;
+        timestamp: string;
+    }>;
+    /**
+     * Get campaign by ID
+     *
+     * @method GET
+     * @route /campaign/entities/:id
+     * @param {string} id - Campaign ID
+     * @returns {Promise<ReturnResponseType<CampaignEntity | null>>} Campaign entity or null if not found
+     * @throws {ValidationError} When ID format is invalid
+     * @throws {NotFoundError} When campaign doesn't exist
+     *
+     * @example
+     * ```http
+     * GET /campaign/entities/campaign-123
+     * ```
+     *
+     * @example Response
+     * ```json
+     * {
+     *   "success": true,
+     *   "message": "Campaign retrieved successfully",
+     *   "data": {
+     *     "id": "campaign-123",
+     *     "name": "Summer Sale",
+     *     "description": "Summer promotional campaign",
+     *     "amount": 50000,
+     *     "status": "active"
+     *   }
+     * }
+     * ```
+     */
+    getCampaignById(id: string): Promise<ReturnResponseType<CampaignEntity | null>>;
+    /**
+     * Create a new campaign
+     *
+     * @method POST
+     * @route /campaign/entities
+     * @param {CreateCampaignDTO} dto - Campaign creation data
+     * @returns {Promise<ReturnResponseType<CampaignEntity>>} Created campaign entity
+     * @throws {ValidationError[]} When validation fails
+     * @throws {ConflictError} When campaign with same name exists
+     *
+     * @example
+     * ```http
+     * POST /campaign/entities
+     * Content-Type: application/json
+     *
+     * {
+     *   "name": "Winter Sale",
+     *   "description": "Winter promotional campaign",
+     *   "amount": 75000,
+     *   "is_visible": true
+     * }
+     * ```
+     *
+     * @example Response
+     * ```json
+     * {
+     *   "success": true,
+     *   "message": "Campaign created successfully",
+     *   "data": {
+     *     "id": "campaign-456",
+     *     "name": "Winter Sale",
+     *     "description": "Winter promotional campaign",
+     *     "amount": 75000,
+     *     "status": "draft",
+     *     "createdAt": "2024-01-01T00:00:00.000Z"
+     *   },
+     *   "codeStatus": 201
+     * }
+     * ```
+     */
+    createCampaign(dto: CreateCampaignDTO): Promise<ReturnResponseType<CampaignEntity>>;
+    /**
+     * Update a campaign (partial update)
+     *
+     * @method PATCH
+     * @route /campaign/entities/:id
+     * @param {string} id - Campaign ID to update
+     * @param {PatchCampaignDTO} dto - Partial campaign update data
+     * @returns {Promise<ReturnResponseType<CampaignEntity>>} Updated campaign entity
+     * @throws {ValidationError[]} When validation fails
+     * @throws {NotFoundError} When campaign doesn't exist
+     *
+     * @example
+     * ```http
+     * PATCH /campaign/entities/campaign-123
+     * Content-Type: application/json
+     *
+     * {
+     *   "amount": 60000,
+     *   "status": "active"
+     * }
+     * ```
+     *
+     * @example Response
+     * ```json
+     * {
+     *   "success": true,
+     *   "message": "Campaign updated successfully",
+     *   "data": {
+     *     "id": "campaign-123",
+     *     "name": "Summer Sale",
+     *     "amount": 60000,
+     *     "status": "active",
+     *     "updatedAt": "2024-01-01T00:00:00.000Z"
+     *   }
+     * }
+     * ```
+     */
+    updateCampaign(id: string, dto: PatchCampaignDTO): Promise<ReturnResponseType<CampaignEntity>>;
+    /**
+     * Delete a campaign
+     *
+     * @method DELETE
+     * @route /campaign/entities/:id
+     * @param {string} id - Campaign ID to delete
+     * @returns {Promise<ReturnResponseType<null>>} Null on successful deletion
+     * @throws {NotFoundError} When campaign doesn't exist
+     * @throws {ConflictError} When campaign cannot be deleted (e.g., has dependencies)
+     *
+     * @example
+     * ```http
+     * DELETE /campaign/entities/campaign-123
+     * ```
+     *
+     * @example Response
+     * ```json
+     * {
+     *   "success": true,
+     *   "message": "Campaign deleted successfully",
+     *   "data": null
+     * }
+     * ```
+     */
+    deleteCampaign(id: string): Promise<ReturnResponseType<null>>;
+}
+//# sourceMappingURL=campaign.controller.d.ts.map

package/dist/backend/campaign/campaign.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.controller.d.ts","sourceRoot":"","sources":["../../../src/backend/campaign/campaign.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D;;;GAGG;AACH,eAAO,MAAM,+BAA+B,oCAAoC,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,kBAAkB;IAQ3B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAPlC;;;;OAIG;gBAGgB,eAAe,EAAE,4BAA4B;IAGhE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IAEH,MAAM,IAAI,kBAAkB,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAOrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IAEG,eAAe,CACN,EAAE,EAAE,MAAM,GACtB,OAAO,CAAC,kBAAkB,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAKrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IAGG,cAAc,CACV,GAAG,EAAE,iBAAiB,GAC7B,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAK9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IAEG,cAAc,CACL,EAAE,EAAE,MAAM,EACf,GAAG,EAAE,gBAAgB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAK9C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IAGG,cAAc,CAAc,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;CAIjF"}

package/dist/backend/campaign/campaign.module.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Campaign Module
+ *
+ * NestJS module demonstrating the proper pattern using domain service directly:
+ * Module → Controller → BackendCampaignService
+ *
+ * @fileoverview Campaign NestJS module configuration
+ * @module CampaignModule
+ */
+import { BACKEND_CAMPAIGN_DOMAIN_SERVICE } from './campaign.controller';
+import { BackendCampaignDomainService } from '../../domain/campaign';
+/**
+ * Campaign Module
+ *
+ * Configures the campaign feature module with controller and domain service.
+ * Uses factory pattern to provide singleton instance of BackendCampaignDomainService.
+ *
+ * @class CampaignModule
+ * @decorator @Module
+ *
+ * @example
+ * ```typescript
+ * // Usage in app.module.ts
+ * import { CoreModule } from '@plyaz/core/nestjs';
+ * import { CampaignModule } from '@plyaz/core';
+ *
+ * @Module({
+ *   imports: [
+ *     CoreModule.forRoot({ envPath: '.env' }),
+ *     CampaignModule,
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Direct service injection in other modules
+ * import { BACKEND_CAMPAIGN_DOMAIN_SERVICE } from '@plyaz/core';
+ *
+ * @Injectable()
+ * export class SomeService {
+ *   constructor(
+ *     @Inject(BACKEND_CAMPAIGN_DOMAIN_SERVICE)
+ *     private campaignService: BackendCampaignDomainService
+ *   ) {}
+ * }
+ * ```
+ */
+export declare class CampaignModule {
+}
+/**
+ * Re-exported for convenience
+ * @see {BackendCampaignDomainService}
+ * @see {BACKEND_CAMPAIGN_DOMAIN_SERVICE}
+ */
+export { BackendCampaignDomainService, BACKEND_CAMPAIGN_DOMAIN_SERVICE };
+//# sourceMappingURL=campaign.module.d.ts.map

package/dist/backend/campaign/campaign.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.module.d.ts","sourceRoot":"","sources":["../../../src/backend/campaign/campaign.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAsB,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAgC,MAAM,uBAAuB,CAAC;AAEnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAiBa,cAAc;CAAG;AAE9B;;;;GAIG;AACH,OAAO,EAAE,4BAA4B,EAAE,+BAA+B,EAAE,CAAC"}

package/dist/backend/campaign/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Campaign Module Exports
+ *
+ * Pattern: Module → Controller → BackendCampaignDomainService (from domain)
+ *
+ * @fileoverview Campaign backend module entry point
+ * @module CampaignBackend
+ *
+ * @example
+ * ```typescript
+ * import { CampaignModule, CampaignController } from '@plyaz/core/backend/campaign';
+ * ```
+ */
+export { CampaignModule, BACKEND_CAMPAIGN_DOMAIN_SERVICE, BackendCampaignDomainService, } from './campaign.module';
+export { CampaignController } from './campaign.controller';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/campaign/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/campaign/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,cAAc,EACd,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/domain/campaign/BackendCampaignDomainService.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Backend Campaign 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
+ *
+ * @fileoverview Campaign domain service for backend operations
+ * @module BackendCampaignDomainService
+ */
+import { BaseBackendDomainService } from '../base';
+import type { CampaignEntity, CampaignResponseDTO, CreateCampaignDTO, PatchCampaignDTO, QueryCampaignDTO, DeleteCampaignDTO, CampaignStoreItem, CampaignDomainServiceConfig as _CampaignDomainServiceConfig } from '@plyaz/types/campaign';
+import type { CoreServiceCreateOptions, CoreInjectedServices } from '@plyaz/types/core';
+import { CampaignRepository, type CampaignDatabaseRow } from '../../models/campaign';
+import { CampaignMapperClass } from './mappers/CampaignMapper';
+import { CampaignValidatorClass } from './validators/CampaignValidator';
+/**
+ * Mapper type for this service
+ * @typedef {InstanceType<typeof CampaignMapperClass>} CampaignMapper
+ */
+type CampaignMapper = InstanceType<typeof CampaignMapperClass>;
+/**
+ * Validator type for this service
+ * @typedef {InstanceType<typeof CampaignValidatorClass>} CampaignValidator
+ */
+type CampaignValidator = InstanceType<typeof CampaignValidatorClass>;
+/**
+ * Campaign event types for subscription
+ * @typedef {string} CampaignEventType
+ */
+export type CampaignEventType = 'campaign:creating' | 'campaign:created' | 'campaign:updating' | 'campaign:updated' | 'campaign:deleting' | 'campaign:deleted';
+/**
+ * Backend Campaign Domain Service
+ *
+ * Extends BaseBackendDomainService with campaign-specific functionality.
+ * Provides CRUD operations, validation, mapping, and event emission.
+ *
+ * @class BackendCampaignDomainService
+ * @extends {BaseBackendDomainService}
+ *
+ * @example
+ * ```typescript
+ * // Create service instance
+ * const service = await BackendCampaignDomainService.create({
+ *   throwOnValidationError: true,
+ *   throwOnRepositoryError: true,
+ * });
+ *
+ * // Use inherited CRUD methods
+ * const campaign = await service.create({ name: 'Test Campaign', amount: 100 });
+ * const updated = await service.patch(campaign.id, { amount: 200 });
+ * await service.delete(campaign.id, { soft: true });
+ * ```
+ */
+export declare class BackendCampaignDomainService extends BaseBackendDomainService<_CampaignDomainServiceConfig, CampaignEntity, CampaignResponseDTO, CreateCampaignDTO, CreateCampaignDTO, PatchCampaignDTO, QueryCampaignDTO, DeleteCampaignDTO, CampaignDatabaseRow, CampaignRepository, CampaignStoreItem, CampaignMapper, CampaignValidator> {
+    /**
+     * Repository instance for data access
+     * @protected
+     * @type {CampaignRepository}
+     */
+    protected repository: CampaignRepository;
+    /**
+     * Event prefix for all events emitted by this service
+     * @protected
+     * @type {string}
+     */
+    protected eventPrefix: string;
+    /**
+     * Cache prefix for namespacing cache keys
+     * @protected
+     * @type {string}
+     */
+    protected cachePrefix: string;
+    /**
+     * Unique key for this service (used by ServiceRegistry)
+     * @static
+     * @readonly
+     * @type {string}
+     */
+    static readonly serviceKey: "campaign";
+    /**
+     * Factory method for ServiceRegistry auto-initialization.
+     * Creates and initializes the service instance.
+     *
+     * @static
+     * @param {_CampaignDomainServiceConfig} config - Service configuration
+     * @param {CoreServiceCreateOptions} [options] - Global options from the registry
+     * @returns {Promise<BackendCampaignDomainService>} Promise resolving to initialized service instance
+     *
+     * @example
+     * ```typescript
+     * const service = await BackendCampaignDomainService.create({
+     *   enabled: true,
+     *   throwOnValidationError: true,
+     *   cache: { enabled: true, defaultTtl: 300 }
+     * });
+     * ```
+     */
+    static create(config: _CampaignDomainServiceConfig, options?: CoreServiceCreateOptions): Promise<BackendCampaignDomainService>;
+    /**
+     * Creates an instance of BackendCampaignDomainService
+     *
+     * @param {_CampaignDomainServiceConfig} [config={}] - Service configuration
+     * @param {CoreInjectedServices} [injected] - Injected core services
+     */
+    constructor(config?: _CampaignDomainServiceConfig, injected?: CoreInjectedServices);
+    /**
+     * Check if service is available
+     *
+     * @returns {boolean} True if service is enabled and available
+     */
+    isAvailable(): boolean;
+    /**
+     * Dispose/cleanup the service
+     * Called when service is being destroyed
+     */
+    dispose(): void;
+    /**
+     * Get all campaigns with optional filters
+     * Demonstrates the getAll() method with typed query parameters
+     *
+     * @param {QueryCampaignDTO} [filters] - Optional query filters (status, pagination, sorting)
+     * @returns {Promise<CampaignEntity[]>} Promise resolving to array of CampaignEntity
+     *
+     * @example
+     * ```typescript
+     * // Get all active campaigns
+     * const activeCampaigns = await service.getCampaigns({ status: 'active' });
+     *
+     * // Get campaigns with pagination
+     * const campaigns = await service.getCampaigns({
+     *   page: 2,
+     *   limit: 10,
+     *   sort_by: 'name',
+     *   sort_order: 'asc'
+     * });
+     * ```
+     */
+    getCampaigns(filters?: QueryCampaignDTO): Promise<CampaignEntity[]>;
+}
+/**
+ * Default singleton instance of BackendCampaignDomainService
+ * Use this for singleton pattern usage
+ *
+ * @constant {BackendCampaignDomainService}
+ *
+ * @example
+ * ```typescript
+ * import { backendCampaignDomainService } from '@plyaz/core';
+ *
+ * const campaign = await backendCampaignDomainService.create({
+ *   name: 'Test Campaign',
+ *   amount: 100
+ * });
+ * ```
+ */
+export declare const backendCampaignDomainService: BackendCampaignDomainService;
+export {};
+//# sourceMappingURL=BackendCampaignDomainService.d.ts.map

package/dist/domain/campaign/BackendCampaignDomainService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackendCampaignDomainService.d.ts","sourceRoot":"","sources":["../../../src/domain/campaign/BackendCampaignDomainService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,IAAI,4BAA4B,EAC5D,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;;GAGG;AACH,KAAK,cAAc,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE/D;;;GAGG;AACH,KAAK,iBAAiB,GAAG,YAAY,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,kBAAkB,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,4BAA6B,SAAQ,wBAAwB,CACxE,4BAA4B,EAC5B,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,CAClB;IACC;;;;OAIG;IACH,SAAS,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAEzC;;;;OAIG;IACH,SAAS,CAAC,WAAW,SAAc;IAEnC;;;;OAIG;IACH,SAAS,CAAC,WAAW,SAAc;IAEnC;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,aAAyB;IAEnD;;;;;;;;;;;;;;;;;OAiBG;WAEU,MAAM,CACjB,MAAM,EAAE,4BAA4B,EACpC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,4BAA4B,CAAC;IAYxC;;;;;OAKG;gBACS,MAAM,GAAE,4BAAiC,EAAE,QAAQ,CAAC,EAAE,oBAAoB;IAyBtF;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,OAAO,IAAI,IAAI;IAIf;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAG1E;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,4BAA4B,8BAAqC,CAAC"}

package/dist/domain/campaign/FrontendCampaignDomainService.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Campaign 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<FrontendCampaignDomainService>('campaign');
+ *
+ * // Or create directly (stores injected if configured)
+ * const service = new FrontendCampaignDomainService({
+ *   enabled: true,
+ *   apiBasePath: '/api/campaigns',
+ * });
+ *
+ * // Use inherited CRUD methods
+ * const items = await service.fetchAll();
+ * const activeItems = await service.fetchAll({ status: 'ACTIVE' });
+ * const item = await service.create({ title: 'Test', funding_target: 100 });
+ * const updated = await service.update(item.id, { funding_target: 200 });
+ * await service.delete(item.id);
+ * ```
+ */
+import { type CampaignEntity, type CampaignResponseDTO, type CreateCampaignDTO, type PatchCampaignDTO, type QueryCampaignDTO, type CampaignStoreItem } from '@plyaz/types/campaign';
+import { BaseFrontendDomainService } from '../base/BaseFrontendDomainService';
+import { CampaignMapperClass } from './mappers/CampaignMapper';
+export type { CampaignFrontendStoreData, CampaignFrontendStoreSlice, CampaignFrontendServiceConfig, CampaignFrontendEventType, } from '@plyaz/types/campaign';
+import type { CampaignFrontendStoreData, CampaignFrontendStoreSlice, CampaignFrontendServiceConfig as _CampaignFrontendServiceConfig, CampaignFrontendEventType } from '@plyaz/types/campaign';
+import type { CoreServiceCreateOptions } from '@plyaz/types/core';
+import type { CoreBaseValidatorInstance } from '@plyaz/types/core';
+/**
+ * Campaign Frontend Service
+ *
+ * Extends BaseFrontendDomainService with all generic types:
+ * - TConfig: CampaignFrontendServiceConfig
+ * - TStore: CampaignFrontendStoreSlice
+ * - TData: CampaignFrontendStoreData
+ * - TEntity: CampaignEntity
+ * - TResponseDTO: CampaignResponseDTO
+ * - TCreateDTO: CreateCampaignDTO
+ * - TPatchDTO: PatchCampaignDTO
+ * - TQueryDTO: QueryCampaignDTO
+ * - TStoreState: CampaignStoreItem
+ * - TMapper: CampaignMapper
+ *
+ * All CRUD methods are inherited from base class - no need to implement!
+ */
+export declare class FrontendCampaignDomainService extends BaseFrontendDomainService<_CampaignFrontendServiceConfig, CampaignFrontendStoreSlice, CampaignFrontendStoreData, CampaignEntity, CampaignResponseDTO, CreateCampaignDTO, PatchCampaignDTO, QueryCampaignDTO, CampaignStoreItem, InstanceType<typeof CampaignMapperClass>, CoreBaseValidatorInstance, void> {
+    /**
+     * Event prefix for all events emitted by this service
+     * Required by BaseFrontendDomainService
+     */
+    protected eventPrefix: string;
+    /**
+     * Read-only store keys - inherits error and featureFlags from base
+     * No need to redeclare them - they're always included by default
+     */
+    static readonly serviceKey: "campaign-frontend";
+    /**
+     * Primary store key for this service.
+     * Used by ServiceRegistry to auto-inject the store if not specified in config.
+     * Also used by base class constructor to set instance primaryStoreKey.
+     */
+    static readonly primaryStoreKey: "campaign";
+    /**
+     * Factory method for ServiceRegistry auto-initialization.
+     * Creates and initializes the service instance.
+     */
+    static create(config: _CampaignFrontendServiceConfig, options?: CoreServiceCreateOptions): Promise<FrontendCampaignDomainService>;
+    constructor(config?: _CampaignFrontendServiceConfig, options?: CoreServiceCreateOptions);
+    /**
+     * After fetchAll - emit event (store sync handled automatically)
+     * Note: Base class automatically calls syncToStores() which uses storeHandlers
+     */
+    protected afterFetchAll(entities: CampaignEntity[]): Promise<void>;
+    /**
+     * Subscribe to service events
+     *
+     * @example
+     * ```tsx
+     * const unsubscribe = service.on('campaign:created', (data) => {
+     *   console.log('Campaign created:', data.entity);
+     * });
+     *
+     * // Later: cleanup
+     * unsubscribe();
+     * ```
+     */
+    on(event: CampaignFrontendEventType, handler: (data: unknown) => void): () => void;
+    /**
+     * Demo: Fetch all campaigns 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 CampaignEntity
+     *
+     * @example
+     * ```typescript
+     * // Fetch all active campaigns
+     * const activeCampaigns = await service.getCampaigns({ status: 'ACTIVE' });
+     *
+     * // Fetch campaigns with pagination
+     * const pagedCampaigns = await service.getCampaigns({
+     *   page: 2,
+     *   limit: 10
+     * });
+     *
+     * // Fetch campaigns sorted by funding target
+     * const sortedCampaigns = await service.getCampaigns({
+     *   sort_by: 'funding_target',
+     *   sort_order: 'desc'
+     * });
+     * ```
+     */
+    getCampaigns(filters?: QueryCampaignDTO): Promise<CampaignEntity[]>;
+    /**
+     * Demo: Fetch active campaigns only
+     * Convenience method demonstrating filtering
+     */
+    getActiveCampaigns(): Promise<CampaignEntity[]>;
+    /**
+     * Demo: Fetch draft campaigns only
+     * Convenience method demonstrating filtering
+     */
+    getDraftCampaigns(): Promise<CampaignEntity[]>;
+    /**
+     * Demo: Fetch completed campaigns only
+     * Convenience method demonstrating filtering
+     */
+    getCompletedCampaigns(): Promise<CampaignEntity[]>;
+}
+/**
+ * Default instance of FrontendCampaignDomainService
+ * Use this for singleton pattern usage
+ *
+ * @example
+ * ```tsx
+ * import { frontendCampaignDomainService } from '@plyaz/core';
+ *
+ * const campaigns = await frontendCampaignDomainService.fetchAll();
+ * ```
+ */
+export declare const frontendCampaignDomainService: FrontendCampaignDomainService;
+//# sourceMappingURL=FrontendCampaignDomainService.d.ts.map

package/dist/domain/campaign/FrontendCampaignDomainService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrontendCampaignDomainService.d.ts","sourceRoot":"","sources":["../../../src/domain/campaign/FrontendCampaignDomainService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAS/D,YAAY,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,6BAA6B,IAAI,8BAA8B,EAC/D,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAOnE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,6BAA8B,SAAQ,yBAAyB,CAC1E,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,CAAC,OAAO,mBAAmB,CAAC,EACxC,yBAAyB,EACzB,IAAI,CACL;IAKC;;;OAGG;IACH,SAAS,CAAC,WAAW,SAAc;IAEnC;;;OAGG;IAOH,MAAM,CAAC,QAAQ,CAAC,UAAU,sBAAkC;IAE5D;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,eAAe,aAAuB;IAEtD;;;OAGG;WACU,MAAM,CACjB,MAAM,EAAE,8BAA8B,EACtC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,6BAA6B,CAAC;gBAuB7B,MAAM,GAAE,8BAAmC,EAAE,OAAO,CAAC,EAAE,wBAAwB;IAmG3F;;;OAGG;cACsB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjF;;;;;;;;;;;;OAYG;IACH,EAAE,CAAC,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IASlF;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAIzE;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIrD;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIpD;;;OAGG;IACG,qBAAqB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAGzD;AAiBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6BAA6B,+BAAsC,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Campaign Domain Exports
+ *
+ * Types and schemas should be imported from @plyaz/types/campaign
+ *
+ * @fileoverview Campaign domain service exports
+ * @module CampaignDomain
+ */
+export { BackendCampaignDomainService, backendCampaignDomainService, type CampaignEventType, } from './BackendCampaignDomainService';
+export { FrontendCampaignDomainService, frontendCampaignDomainService, type CampaignFrontendStoreSlice, type CampaignFrontendStoreData, type CampaignFrontendServiceConfig, type CampaignFrontendEventType, } from './FrontendCampaignDomainService';
+export { CampaignMapper } from './mappers/CampaignMapper';
+export { CampaignValidator } from './validators/CampaignValidator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/campaign/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,KAAK,iBAAiB,GACvB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,GAC/B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC"}