@plyaz/types 1.31.1 → 1.33.0

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

@@ -3,4 +3,4 @@
  *
  * Core domain types for files/media service.
  */
-export { FileTypeSchema, type FileType, type FilesEntity, type FilesFrontendServiceConfig, type FilesDomainServiceConfig, type FilesDatabaseRow, type FilesCreateInput, type MediaVariantsDatabaseRow, type MediaVariantsCreateInput, type SingleUploadEventPayload, type BulkUploadEventPayload, } from './types';
+export { FileTypeSchema, type FileType, type FilesEntity, type FilesFrontendServiceConfig, type FilesDomainServiceConfig, type FilesDatabaseRow, type FilesCreateInput, type MediaVariantsDatabaseRow, type MediaVariantsCreateInput, type SingleUploadEventPayload, type BulkUploadEventPayload, type FileUploadedEventPayload, type FileBulkUploadedEventPayload, type FilesUploadEventPayload, type FileDocumentGeneratedEventPayload, } from './types';

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

@@ -5,7 +5,7 @@
  * Store types are in @plyaz/types/store/files.
  * API types are in @plyaz/types/api/endpoints/files.
  */
-import type { FileVariant } from '../../../api/endpoints/files/schemas';
+import type { FileVariant, UploadFileResponse, UploadFilesResponse, GenerateDocumentRequest, GenerateDocumentResponse } from '../../../api/endpoints/files';
 import type { CoreServiceInitConfig } from '../../init';
 import type { CoreInjectedServices } from '../types';
 import type { CoreBaseFrontendServiceConfig } from '../../frontend';
@@ -165,3 +165,31 @@ export interface BulkUploadEventPayload {
         results?: SingleUploadEventPayload['result'][];
     };
 }
+/**
+ * Frontend event payload for single file upload
+ * Used by files:upload:uploaded event (when bulk=false)
+ */
+export interface FileUploadedEventPayload {
+    result: UploadFileResponse;
+    bulk?: false;
+}
+/**
+ * Frontend event payload for bulk file upload
+ * Used by files:upload:uploaded event (when bulk=true)
+ */
+export interface FileBulkUploadedEventPayload {
+    result: UploadFilesResponse;
+    bulk: true;
+}
+/**
+ * Union type for files:upload:uploaded event payload
+ */
+export type FilesUploadEventPayload = FileUploadedEventPayload | FileBulkUploadedEventPayload;
+/**
+ * Frontend event payload for document generation
+ * Used by files:document:generated event
+ */
+export interface FileDocumentGeneratedEventPayload {
+    result: GenerateDocumentResponse;
+    request: GenerateDocumentRequest;
+}

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

@@ -19,4 +19,4 @@
  */
 export { CoreEventScope, SystemEventAction, EntityEventAction, ValidationEventAction, SanitizationEventAction, ApiEventAction, CacheEventAction, AuthEventAction, DatabaseEventAction, FeatureFlagEventAction, StoreEventAction, StorageEventAction, NotificationEventAction, CORE_EVENTS, } from './enums';
 export type { CoreEventScopeType, SystemEventType, EntityEventType, ValidationEventType, SanitizationEventType, ApiEventType, CacheEventType, AuthEventType, DatabaseEventType, FeatureFlagEventType, StoreEventType, CoreEventType, } from './enums';
-export type { CoreEvent, CoreCrudOperation, CoreValidationStartedPayload, CoreValidationSuccessPayload, CoreValidationFailedPayload, CoreSanitizationStartedPayload, CoreSanitizationSuccessPayload, CoreSanitizationFailedPayload, CoreEntityCreatedPayload, CoreEntityUpdatedPayload, CoreEntityPatchedPayload, CoreEntityDeletedPayload, CoreEntityCreatingPayload, CoreEntityUpdatingPayload, CoreEntityPatchingPayload, CoreEntityDeletingPayload, CoreEntityErrorPayload, CoreEntityCompletePayload, CoreBulkCreatedPayload, CoreBulkDeletedPayload, CoreSystemInitializedPayload, CoreSystemReadyPayload, CoreSystemShutdownPayload, CoreSystemErrorPayload, CoreSystemWarningPayload, CoreApiRequestStartPayload, CoreApiRequestSuccessPayload, CoreApiRequestErrorPayload, CoreApiRetryPayload, CoreApiTimeoutPayload, CoreCacheHitPayload, CoreCacheMissPayload, CoreCacheSetPayload, CoreCacheDeletePayload, CoreCacheClearPayload, CoreCacheExpiredPayload, CoreCacheErrorPayload, CoreDatabaseConnectedPayload, CoreDatabaseDisconnectedPayload, CoreDatabaseQueryPayload, CoreDatabaseErrorPayload, CoreDatabaseTransactionStartPayload, CoreDatabaseTransactionCommitPayload, CoreDatabaseTransactionRollbackPayload, CoreAuthLoginPayload, CoreAuthLogoutPayload, CoreAuthTokenRefreshPayload, CoreAuthSessionExpiredPayload, CoreAuthUnauthorizedPayload, CoreFeatureFlagChangedPayload, CoreFeatureFlagEvaluatedPayload, CoreFeatureFlagRefreshedPayload, CoreStoreUpdatedPayload, CoreStoreResetPayload, CoreStoreHydratedPayload, CoreOperationRequestPayload, CoreOperationResultPayload, CoreOperationErrorPayload, CoreStorageUploadedPayload, CoreStorageDownloadedPayload, CoreStorageDeletedPayload, CoreStorageErrorPayload, CoreStorageHealthCheckPayload, CoreNotificationSentPayload, CoreNotificationFailedPayload, CoreNotificationDeliveredPayload, CoreNotificationOpenedPayload, CoreNotificationClickedPayload, CoreNotificationErrorPayload, CoreNotificationHealthCheckPayload, CoreEventPayloadMap, EventPersistenceConfig, DomainPersistenceConfig, } from './payloads';
+export type { CoreEvent, CoreCrudOperation, CoreValidationStartedPayload, CoreValidationSuccessPayload, CoreValidationFailedPayload, CoreSanitizationStartedPayload, CoreSanitizationSuccessPayload, CoreSanitizationFailedPayload, CoreEntityCreatedPayload, CoreEntityUpdatedPayload, CoreEntityPatchedPayload, CoreEntityDeletedPayload, CoreEntityCreatingPayload, CoreEntityUpdatingPayload, CoreEntityPatchingPayload, CoreEntityDeletingPayload, CoreEntityErrorPayload, CoreEntityCompletePayload, CoreBulkCreatedPayload, CoreBulkDeletedPayload, CoreSystemInitializedPayload, CoreSystemReadyPayload, CoreSystemShutdownPayload, CoreSystemErrorPayload, CoreSystemWarningPayload, CoreApiRequestStartPayload, CoreApiRequestSuccessPayload, CoreApiRequestErrorPayload, CoreApiRetryPayload, CoreApiTimeoutPayload, CoreCacheHitPayload, CoreCacheMissPayload, CoreCacheSetPayload, CoreCacheDeletePayload, CoreCacheClearPayload, CoreCacheExpiredPayload, CoreCacheErrorPayload, CoreDatabaseConnectedPayload, CoreDatabaseDisconnectedPayload, CoreDatabaseQueryPayload, CoreDatabaseErrorPayload, CoreDatabaseTransactionStartPayload, CoreDatabaseTransactionCommitPayload, CoreDatabaseTransactionRollbackPayload, CoreAuthLoginPayload, CoreAuthLogoutPayload, CoreAuthTokenRefreshPayload, CoreAuthSessionExpiredPayload, CoreAuthUnauthorizedPayload, CoreFeatureFlagChangedPayload, CoreFeatureFlagEvaluatedPayload, CoreFeatureFlagRefreshedPayload, CoreStoreUpdatedPayload, CoreStoreResetPayload, CoreStoreHydratedPayload, CoreOperationRequestPayload, CoreOperationResultPayload, CoreOperationErrorPayload, CoreStorageUploadedPayload, CoreStorageDownloadedPayload, CoreStorageDeletedPayload, CoreStorageErrorPayload, CoreStorageHealthCheckPayload, CoreNotificationSentPayload, CoreNotificationFailedPayload, CoreNotificationDeliveredPayload, CoreNotificationOpenedPayload, CoreNotificationClickedPayload, CoreNotificationErrorPayload, CoreNotificationHealthCheckPayload, CoreEventPayloadMap, EventPersistenceConfig, DomainPersistenceConfig, PersistOperationConfig, FrontendEventHandlerConfig, DomainFrontendEventConfig, } from './payloads';

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

@@ -694,6 +694,25 @@ export interface EventPersistenceConfig<TPayload = unknown, TItem = unknown> {
     /** Optional: validate item before persisting */
     validate?: (item: TItem) => boolean;
 }
+/**
+ * Configuration for persist operations (internal to BackendEventPersistenceHandler)
+ * Reduces parameter count by grouping related options
+ *
+ * @typeParam TRepository - Repository type for database operations
+ * @typeParam TMapper - Mapper type for transforming items to DB rows
+ * @typeParam TItem - Item type extracted from event payload
+ * @typeParam TDbRow - Database row type
+ */
+export interface PersistOperationConfig<TRepository, TMapper, TItem, TDbRow> {
+    repository: TRepository;
+    mapper: TMapper;
+    mapToDbRow: (mapper: TMapper, item: TItem) => TDbRow;
+    createRecord: (repository: TRepository, dbRow: TDbRow) => Promise<unknown>;
+    validate?: (item: TItem) => boolean;
+    getUniqueKey?: (item: TItem) => string;
+    eventName: string;
+    verbose?: boolean;
+}
 /**
  * Domain persistence handler configuration
  * Used by BackendEventPersistenceHandler to register event-to-DB persistence
@@ -738,3 +757,74 @@ export interface DomainPersistenceConfig<TRepository = unknown, TMapper = unknow
     /** Enable verbose logging */
     verbose?: boolean;
 }
+/**
+ * Frontend event handler configuration
+ * Defines how to extract payload and update store for a specific event
+ *
+ * @typeParam TStore - Store slice type
+ * @typeParam TItem - Item type extracted from payload
+ *
+ * @example
+ * ```typescript
+ * const uploadedHandler: FrontendEventHandlerConfig<FilesStoreSlice, FilesEntity> = {
+ *   extractPayload: (payload) => payload.result,
+ *   updateStore: async (store, item) => {
+ *     if (Array.isArray(item)) {
+ *       store.addUploads(item);
+ *     } else {
+ *       store.addUpload(item);
+ *     }
+ *   },
+ *   isBulk: false,
+ * };
+ * ```
+ */
+/**
+ * Frontend event handler configuration
+ *
+ * Simple: just a callback that receives store and payload.
+ * Do whatever you need - set loading state, add data, etc.
+ *
+ * @typeParam TStore - Store slice type
+ * @typeParam TPayload - Event payload type
+ */
+export interface FrontendEventHandlerConfig<TStore = unknown, TPayload = unknown> {
+    /** Handle the event - receives store and typed payload */
+    handler: (store: TStore, payload: TPayload) => void | Promise<void>;
+}
+/**
+ * Domain frontend event handler configuration
+ * Used by FrontendEventPersistenceHandler to register event handlers
+ *
+ * @typeParam TStore - Store slice type (e.g., FilesFrontendStoreSlice)
+ * @typeParam TPayload - Event payload type
+ *
+ * @example
+ * ```typescript
+ * FrontendEventPersistenceHandler.register<FilesFrontendStoreSlice, FilesUploadEventPayload>({
+ *   domain: 'files',
+ *   events: {
+ *     'files:upload:uploading': {
+ *       handler: (store) => store.setUploading(true),
+ *     },
+ *     'files:upload:uploaded': {
+ *       handler: (store, payload) => {
+ *         store.setUploading(false);
+ *         store.addUpload(FilesMapper.toDomain(payload.result));
+ *       },
+ *     },
+ *   },
+ *   getStore: () => Core._rootStore?.getState().files,
+ * });
+ * ```
+ */
+export interface DomainFrontendEventConfig<TStore = unknown, TPayload = unknown> {
+    /** Domain name (e.g., 'files', 'notifications') */
+    domain: string;
+    /** Event configurations keyed by event name */
+    events: Record<string, FrontendEventHandlerConfig<TStore, TPayload>>;
+    /** Get store slice from root store (called per event, safe for SSR) */
+    getStore: () => TStore | undefined;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}

package/dist/store/files/types.d.ts

@@ -73,13 +73,13 @@ export interface FilesFrontendStoreData {
  * Files are immutable once uploaded - only metadata changes via storage service.
  */
 export interface FilesFrontendStoreActions extends CoreBaseFrontendStore<FilesFrontendStoreData> {
-    addFile: (file: FilesEntity) => void;
+    addFile: (file: FilesEntity | FilesEntity[]) => void;
     removeFile: (id: string) => void;
     clearFiles: () => void;
-    addUpload: (upload: FilesEntity) => void;
+    addUpload: (upload: FilesEntity | FilesEntity[]) => void;
     removeUpload: (id: string) => void;
     clearUploads: () => void;
-    addGenerated: (file: GeneratedFileItem) => void;
+    addGenerated: (file: GeneratedFileItem | GeneratedFileItem[]) => void;
     removeGenerated: (id: string) => void;
     clearGenerated: () => void;
     setLoading: (isLoading: boolean) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.31.1",
+  "version": "1.33.0",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",