@plyaz/core 1.2.0 → 1.3.0

package/dist/services/NotificationService.d.ts

@@ -0,0 +1,153 @@
+/**
+ * NotificationService - Singleton Notification Manager
+ *
+ * @description Manages notification delivery for the entire application using a singleton pattern.
+ * This service wraps @plyaz/notifications and provides a centralized way to initialize and access
+ * notification capabilities across all domains (transactional, marketing, system alerts, etc.).
+ *
+ * **Architecture:**
+ * - Uses `NotificationService` from @plyaz/notifications which supports multi-provider setup
+ * - Supports email (Infobip primary, SendGrid fallback), SMS, and push notifications
+ * - Automatic failover between providers based on health status
+ * - Event-driven architecture for tracking delivery, opens, clicks
+ * - **Proxy-based method forwarding**: All methods from the underlying service are
+ *   automatically available with error handling - no manual wrapping needed
+ *
+ * **Provider Configuration:**
+ * - **Infobip**: Primary email provider (unified omnichannel platform)
+ * - **SendGrid**: Fallback email provider for transactional emails
+ *
+ * **Required Environment Variables (Infobip):**
+ * - INFOBIP_API_KEY: Your Infobip API key
+ * - INFOBIP_BASE_URL: Infobip API base URL
+ * - FROM_EMAIL: Default sender email address
+ *
+ * **Required Environment Variables (SendGrid):**
+ * - SENDGRID_API_KEY: Your SendGrid API key
+ * - FROM_EMAIL: Default sender email address
+ *
+ * @example Using with Core.initialize() (Recommended)
+ * ```typescript
+ * import { Core } from '@plyaz/core';
+ *
+ * await Core.initialize({
+ *   notifications: {
+ *     providers: {
+ *       email: [infobipAdapter, sendGridAdapter],
+ *       sms: [],
+ *       push: [],
+ *     },
+ *     events: {
+ *       onSent: (event) => console.log('Notification sent:', event),
+ *       onFailed: (event) => console.error('Notification failed:', event),
+ *     },
+ *   },
+ * });
+ *
+ * // Access via Core.notifications - all methods automatically available
+ * await Core.notifications.sendEmail({
+ *   recipientId: 'user-123',
+ *   to: 'user@example.com',
+ *   templateId: 'welcome',
+ *   templateData: { userName: 'John' },
+ * });
+ * ```
+ *
+ * @module services
+ */
+import { NotificationService as NotificationServiceImpl } from '@plyaz/notifications';
+import type { CoreNotificationConfig } from '@plyaz/types/core';
+export type { CoreNotificationConfig } from '@plyaz/types/core';
+/**
+ * NotificationService - Singleton Notification Manager with Proxy-based method forwarding
+ *
+ * Provides centralized notification management for all domains.
+ * Uses @plyaz/notifications under the hood with configurable providers and templates.
+ *
+ * All methods from the underlying NotificationServiceImpl are automatically available
+ * via Proxy - when new methods are added to @plyaz/notifications, they're instantly
+ * accessible here with automatic error handling.
+ */
+export declare class NotificationService {
+    private static instance;
+    private notificationService;
+    private config;
+    private initialized;
+    private constructor();
+    /**
+     * Emits a notification error event via CoreEventManager.
+     * Called when notification operations fail to integrate with global error handling.
+     */
+    private emitNotificationError;
+    /**
+     * Gets the singleton instance of NotificationService
+     */
+    static getInstance(): NotificationService;
+    /**
+     * Checks if the notification service has been initialized
+     */
+    static isInitialized(): boolean;
+    /**
+     * Resets the notification service by clearing the singleton instance
+     */
+    static reset(): Promise<void>;
+    /**
+     * Initializes the notification service
+     *
+     * @param config - Notification service configuration
+     * @returns The initialized NotificationService instance
+     */
+    static initialize(config: CoreNotificationConfig): Promise<NotificationService>;
+    /**
+     * Gets the raw underlying notification service instance without error handling wrapper.
+     * Use this only if you need direct access to the underlying service.
+     *
+     * @returns The raw NotificationService instance from @plyaz/notifications
+     * @throws {NotificationsPackageError} When notifications is not initialized
+     */
+    private getRawNotifications;
+    /**
+     * Gets the notification service with automatic error handling.
+     * All method calls are wrapped with try/catch and emit error events on failure.
+     * Any method added to @plyaz/notifications will be automatically available.
+     *
+     * @example
+     * ```typescript
+     * const notifications = NotificationService.getInstance().getNotifications();
+     * await notifications.sendEmail({ to: 'user@example.com', templateId: 'welcome' });
+     * await notifications.sendSMS({ to: '+1234567890', message: 'Hello!' });
+     * ```
+     *
+     * @returns NotificationServiceImpl with automatic error handling
+     */
+    getNotifications(): NotificationServiceImpl;
+    /**
+     * Performs a health check on the notification service.
+     * This method has special handling to transform the response format.
+     */
+    healthCheck(): Promise<{
+        isHealthy: boolean;
+        providers?: unknown[];
+        error?: string;
+    }>;
+    /**
+     * Gets the current configuration
+     */
+    getConfig(): CoreNotificationConfig | null;
+    /**
+     * Closes the notification service and cleans up resources
+     */
+    close(): Promise<void>;
+    /**
+     * Creates a dedicated notification service instance (NOT the singleton)
+     *
+     * Use this when you need an isolated notification service with its own configuration.
+     *
+     * @param config - Notification service configuration
+     * @returns Promise that resolves to a new dedicated NotificationService instance
+     */
+    static createInstance(config: CoreNotificationConfig): Promise<NotificationService>;
+}
+/** Type alias for NotificationService instance (use for type-only imports to avoid bundling) */
+export type NotificationServiceInstance = NotificationService;
+//# sourceMappingURL=NotificationService.d.ts.map

package/dist/services/NotificationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationService.d.ts","sourceRoot":"","sources":["../../src/services/NotificationService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH,OAAO,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAMhE,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAShE;;;;;;;;;GASG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoC;IAC3D,OAAO,CAAC,mBAAmB,CAAwC;IACnE,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;IAMP;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAKzC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,OAAO;IAI/B;;OAEG;WACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC;;;;;OAKG;WACU,UAAU,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAcrF;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;;;;;;;;;;;;OAaG;IACH,gBAAgB,IAAI,uBAAuB;IA6C3C;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAyB3F;;OAEG;IACH,SAAS,IAAI,sBAAsB,GAAG,IAAI;IAI1C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;;;;;OAOG;WACU,cAAc,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAO1F;AAED,gGAAgG;AAChG,MAAM,MAAM,2BAA2B,GAAG,mBAAmB,CAAC"}

package/dist/services/StorageService.d.ts

@@ -0,0 +1,146 @@
+/**
+ * StorageService - Singleton File Storage Manager
+ *
+ * @description Manages file storage operations for the entire application using a singleton pattern.
+ * This service wraps @plyaz/storage and provides a centralized way to initialize and access
+ * file storage across all domains (media uploads, compliance documents, user avatars, etc.).
+ *
+ * **Architecture:**
+ * - Uses `StorageService` from @plyaz/storage which supports multi-provider setup
+ * - Supports Cloudflare R2 (compliance documents) and Supabase Storage (assets/media)
+ * - Automatic failover between providers based on health status
+ * - Event-driven architecture with 40+ event types
+ * - **Proxy-based method forwarding**: All methods from the underlying service are
+ *   automatically available with error handling - no manual wrapping needed
+ *
+ * **Provider Configuration:**
+ * - **Cloudflare R2**: For compliance documents (tax, invoices, KYC) with zero egress fees
+ * - **Supabase Storage**: For assets like images, user avatars, media files
+ *
+ * **Required Environment Variables (Cloudflare R2):**
+ * - CLOUDFLARE_ACCOUNT_ID: Your Cloudflare account ID
+ * - R2_ACCESS_KEY_ID: R2 access key
+ * - R2_SECRET_ACCESS_KEY: R2 secret key
+ * - R2_BUCKET_NAME: Default bucket name
+ *
+ * **Required Environment Variables (Supabase Storage):**
+ * - SUPABASE_URL: Your Supabase project URL
+ * - SUPABASE_SERVICE_ROLE_KEY: Service role key for storage operations
+ *
+ * @example Using with Core.initialize() (Recommended)
+ * ```typescript
+ * import { Core } from '@plyaz/core';
+ *
+ * await Core.initialize({
+ *   storage: {
+ *     adapters: [r2Adapter, supabaseAdapter],
+ *     plugins: [virusScanPlugin, sharpImagePlugin],
+ *   },
+ * });
+ *
+ * // Access via Core.storage - all methods automatically available
+ * const result = await Core.storage.uploadFile({
+ *   file: buffer,
+ *   filename: 'document.pdf',
+ *   category: FILE_CATEGORY.COMPLIANCE_DOCUMENT,
+ * });
+ * ```
+ *
+ * @module services
+ */
+import { StorageService as StorageServiceImpl } from '@plyaz/storage';
+import type { CoreStorageConfig } from '@plyaz/types/core';
+export type { CoreStorageConfig } from '@plyaz/types/core';
+/**
+ * StorageService - Singleton File Storage Manager with Proxy-based method forwarding
+ *
+ * Provides centralized file storage management for all domains.
+ * Uses @plyaz/storage under the hood with configurable providers and plugins.
+ *
+ * All methods from the underlying StorageServiceImpl are automatically available
+ * via Proxy - when new methods are added to @plyaz/storage, they're instantly
+ * accessible here with automatic error handling.
+ */
+export declare class StorageService {
+    private static instance;
+    private storageService;
+    private config;
+    private initialized;
+    private constructor();
+    /**
+     * Emits a storage error event via CoreEventManager.
+     * Called when storage operations fail to integrate with global error handling.
+     */
+    private emitStorageError;
+    /**
+     * Gets the singleton instance of StorageService
+     */
+    static getInstance(): StorageService;
+    /**
+     * Checks if the storage service has been initialized
+     */
+    static isInitialized(): boolean;
+    /**
+     * Resets the storage service by clearing the singleton instance
+     */
+    static reset(): Promise<void>;
+    /**
+     * Initializes the storage service
+     *
+     * @param config - Storage service configuration
+     * @returns The initialized StorageService instance
+     */
+    static initialize(config: CoreStorageConfig): Promise<StorageService>;
+    /**
+     * Gets the raw underlying storage service instance without error handling wrapper.
+     * Use this only if you need direct access to the underlying service.
+     *
+     * @returns The raw StorageService instance from @plyaz/storage
+     * @throws {StoragePackageError} When storage is not initialized
+     */
+    private getRawStorage;
+    /**
+     * Gets the storage service with automatic error handling.
+     * All method calls are wrapped with try/catch and emit error events on failure.
+     * Any method added to @plyaz/storage will be automatically available.
+     *
+     * @example
+     * ```typescript
+     * const storage = StorageService.getInstance().getStorage();
+     * await storage.uploadFile({ file, filename: 'doc.pdf' });
+     * await storage.deleteFile({ fileId: '123' });
+     * ```
+     *
+     * @returns StorageServiceImpl with automatic error handling
+     */
+    getStorage(): StorageServiceImpl;
+    /**
+     * Performs a health check on the storage service by checking all adapter health.
+     * This method has special handling to transform the response format.
+     */
+    healthCheck(): Promise<{
+        isHealthy: boolean;
+        responseTime?: number;
+        error?: string;
+    }>;
+    /**
+     * Gets the current configuration
+     */
+    getConfig(): CoreStorageConfig | null;
+    /**
+     * Closes the storage service and cleans up resources
+     */
+    close(): Promise<void>;
+    /**
+     * Creates a dedicated storage service instance (NOT the singleton)
+     *
+     * Use this when you need an isolated storage connection with its own configuration.
+     *
+     * @param config - Storage service configuration
+     * @returns Promise that resolves to a new dedicated StorageService instance
+     */
+    static createInstance(config: CoreStorageConfig): Promise<StorageService>;
+}
+/** Type alias for StorageService instance (use for type-only imports to avoid bundling) */
+export type StorageServiceInstance = StorageService;
+//# sourceMappingURL=StorageService.d.ts.map

package/dist/services/StorageService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageService.d.ts","sourceRoot":"","sources":["../../src/services/StorageService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAGH,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAO3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAY3D;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA+B;IACtD,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;IAMP;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,cAAc;IAKpC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,OAAO;IAI/B;;OAEG;WACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC;;;;;OAKG;WACU,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgB3E;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAcrB;;;;;;;;;;;;;OAaG;IACH,UAAU,IAAI,kBAAkB;IA6ChC;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAkC3F;;OAEG;IACH,SAAS,IAAI,iBAAiB,GAAG,IAAI;IAIrC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;;;;;OAOG;WACU,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;CAShF;AAED,2FAA2F;AAC3F,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC"}

package/dist/services/index.d.ts

@@ -5,4 +5,8 @@
  * @module services
  */
 export * from './ApiClientService';
+export * from './CacheService';
+export * from './DbService';
+export * from './StorageService';
+export * from './NotificationService';
 //# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}

package/dist/utils/common/id.d.ts

@@ -0,0 +1,83 @@
+/**
+ * ID Generation Utilities
+ *
+ * Provides consistent ID generation across the application.
+ * Uses globalThis.crypto when available, with a fallback for environments without it.
+ *
+ * @fileoverview ID generation utility functions
+ */
+/**
+ * Generate a UUID v4 string.
+ * Uses crypto.randomUUID when available, otherwise falls back to a timestamp-based ID.
+ *
+ * @returns A UUID v4 string or fallback ID
+ *
+ * @example
+ * ```typescript
+ * const id = generateId();
+ * // => 'a1b2c3d4-e5f6-7890-abcd-ef1234567890' (crypto available)
+ * // => '1701475200000-x7k9m2' (fallback)
+ * ```
+ */
+export declare function generateId(): string;
+/**
+ * Generate a short random ID (8 characters).
+ * Useful for correlation IDs, short references, etc.
+ *
+ * @returns A short random string
+ *
+ * @example
+ * ```typescript
+ * const shortId = generateShortId();
+ * // => 'x7k9m2ab'
+ * ```
+ */
+export declare function generateShortId(): string;
+/**
+ * Generate a correlation ID for tracing.
+ * Format: timestamp-randomString
+ *
+ * @returns A correlation ID string
+ *
+ * @example
+ * ```typescript
+ * const correlationId = generateCorrelationId();
+ * // => '1701475200000-x7k9m2'
+ * ```
+ */
+export declare function generateCorrelationId(): string;
+/**
+ * Generate a trace ID for distributed tracing (32 hex characters / 128 bits).
+ *
+ * @returns A 32-character hex string
+ *
+ * @example
+ * ```typescript
+ * const traceId = generateTraceId();
+ * // => 'a1b2c3d4e5f67890abcdef1234567890'
+ * ```
+ */
+export declare function generateTraceId(): string;
+/**
+ * Generate a span ID for distributed tracing (16 hex characters / 64 bits).
+ *
+ * @returns A 16-character hex string
+ *
+ * @example
+ * ```typescript
+ * const spanId = generateSpanId();
+ * // => 'a1b2c3d4e5f67890'
+ * ```
+ */
+export declare function generateSpanId(): string;
+/**
+ * ID generation utilities object for convenient access.
+ */
+export declare const IdUtils: {
+    readonly generate: typeof generateId;
+    readonly generateShort: typeof generateShortId;
+    readonly generateCorrelation: typeof generateCorrelationId;
+    readonly generateTraceId: typeof generateTraceId;
+    readonly generateSpanId: typeof generateSpanId;
+};
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/common/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../src/utils/common/id.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAMnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAQxC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAWxC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAQvC;AAED;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;CAMV,CAAC"}

package/dist/utils/common/index.d.ts

@@ -6,6 +6,8 @@
  * @fileoverview Common utilities export
  */
 export { hashString, isInRollout, createRolloutIdentifier, HashUtils } from './hash';
+export { generateId, generateShortId, generateCorrelationId, generateTraceId, generateSpanId, IdUtils, } from './id';
 export { isTruthy, toBoolean, ValueUtils } from './values';
+export { setNestedProperty, getNestedProperty, hasNestedProperty, ObjectUtils } from './object';
 export * from './validation';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGrF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3D,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGrF,OAAO,EACL,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,OAAO,GACR,MAAM,MAAM,CAAC;AAGd,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEhG,cAAc,cAAc,CAAC"}

package/dist/utils/common/object.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Object Utilities
+ *
+ * Provides utilities for working with nested object paths and property access.
+ *
+ * @fileoverview Object manipulation utilities
+ */
+/**
+ * Sets a value at a nested path in an object, creating intermediate objects as needed.
+ *
+ * @param obj - The target object to modify
+ * @param path - Dot-separated path to the property (e.g., 'user.profile.name')
+ * @param value - The value to set at the path
+ *
+ * @example
+ * ```typescript
+ * const obj = { user: { id: 1 } };
+ * setNestedProperty(obj, 'user.profile.name', 'John');
+ * // Result: { user: { id: 1, profile: { name: 'John' } } }
+ * ```
+ */
+export declare function setNestedProperty(obj: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Gets a value at a nested path in an object.
+ *
+ * @param obj - The source object to read from
+ * @param path - Dot-separated path to the property (e.g., 'user.profile.name')
+ * @param defaultValue - Optional default value if the path doesn't exist
+ * @returns The value at the path, or defaultValue if not found
+ *
+ * @example
+ * ```typescript
+ * const obj = { user: { profile: { name: 'John' } } };
+ * getNestedProperty(obj, 'user.profile.name'); // 'John'
+ * getNestedProperty(obj, 'user.settings.theme', 'dark'); // 'dark' (default)
+ * ```
+ */
+export declare function getNestedProperty<T = unknown>(obj: Record<string, unknown>, path: string, defaultValue?: T): T | undefined;
+/**
+ * Checks if a nested path exists in an object.
+ *
+ * @param obj - The object to check
+ * @param path - Dot-separated path to check (e.g., 'user.profile.name')
+ * @returns True if the path exists and is not undefined
+ *
+ * @example
+ * ```typescript
+ * const obj = { user: { profile: { name: 'John' } } };
+ * hasNestedProperty(obj, 'user.profile.name'); // true
+ * hasNestedProperty(obj, 'user.settings.theme'); // false
+ * ```
+ */
+export declare function hasNestedProperty(obj: Record<string, unknown>, path: string): boolean;
+/**
+ * Object utilities namespace for convenient grouped access.
+ *
+ * @example
+ * ```typescript
+ * import { ObjectUtils } from '@plyaz/core/utils';
+ *
+ * ObjectUtils.setNestedProperty(obj, 'user.name', 'John');
+ * const name = ObjectUtils.getNestedProperty(obj, 'user.name');
+ * ```
+ */
+export declare const ObjectUtils: {
+    readonly setNestedProperty: typeof setNestedProperty;
+    readonly getNestedProperty: typeof getNestedProperty;
+    readonly hasNestedProperty: typeof hasNestedProperty;
+};
+//# sourceMappingURL=object.d.ts.map

package/dist/utils/common/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../src/utils/common/object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,IAAI,CAgBN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,CAAC,GACf,CAAC,GAAG,SAAS,CAaf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAerF;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC"}

package/dist/utils/featureFlags/conditions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../../src/utils/featureFlags/conditions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,oBAAoB,EAC/B,YAAY,EAAE,OAAO,GACpB,OAAO,CAoBT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAGT;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAeT;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,OAAO,EACvB,YAAY,EAAE,OAAO,GACpB,OAAO,CAQT;AAqBD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAeT;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;;;;;OAMG;iDAEW,oBAAoB,EAAE,gBACpB,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,KACvC,OAAO;IAUV;;;;;;OAMG;gDAEW,oBAAoB,EAAE,gBACpB,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,KACvC,OAAO;IAUV;;;;;OAKG;4CAEU,OAAO,CAAC,oBAAoB,CAAC,KACvC;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;IAmCD;;;;;;;OAOG;sCAEM,MAAM,YACH,oBAAoB,CAAC,UAAU,CAAC,SACnC,oBAAoB,CAAC,OAAO,CAAC,KACnC,oBAAoB;CAUf,CAAC"}
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../../src/utils/featureFlags/conditions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIzD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,oBAAoB,EAC/B,YAAY,EAAE,OAAO,GACpB,OAAO,CAoBT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAGT;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAeT;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,OAAO,EACvB,YAAY,EAAE,OAAO,GACpB,OAAO,CAQT;AAqBD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAeT;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;;;;;OAMG;iDAEW,oBAAoB,EAAE,gBACpB,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,KACvC,OAAO;IAUV;;;;;;OAMG;gDAEW,oBAAoB,EAAE,gBACpB,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,KACvC,OAAO;IAUV;;;;;OAKG;4CAEU,OAAO,CAAC,oBAAoB,CAAC,KACvC;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;IAmCD;;;;;;;OAOG;sCAEM,MAAM,YACH,oBAAoB,CAAC,UAAU,CAAC,SACnC,oBAAoB,CAAC,OAAO,CAAC,KACnC,oBAAoB;CAaf,CAAC"}

package/dist/utils/featureFlags/context.d.ts

@@ -2,7 +2,6 @@
  * Feature Flag Context Utilities
  *
  * Utilities for building, validating, and manipulating feature flag contexts.
- * Re-exports the context builder and utilities from domain layer for convenience.
  *
  * @fileoverview Feature flag context utilities
  * @version 1.0.0

package/dist/utils/featureFlags/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/utils/featureFlags/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/utils/featureFlags/context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,OAAO,CAAmC;IAElD;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKrC;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKjC;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI;IAKzD;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKjC;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI;IAK3E;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKhD;;;;;;OAMG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAMpD;;;;;;OAMG;IACH,KAAK,IAAI,kBAAkB;IAa3B;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,KAAK,IAAI,yBAAyB;CAQnC;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;;;;;OAMG;mDAEY,aAAa,GAAG,SAAS,GAAG,YAAY,aAC3C,KAAK,GAAG,QAAQ,GAAG,SAAS,KACrC,kBAAkB;IAOrB;;;;;OAKG;yCACuB;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;QACtD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;QACxC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,KAAG,kBAAkB;IAetB;;;;;OAKG;gDAC6B,OAAO,CAAC,kBAAkB,CAAC,KAAQ,kBAAkB;IAQrF;;;;;OAKG;wCACsB,OAAO,CAAC,kBAAkB,CAAC,KAAG;QACrD,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;IAuBD;;;;;OAKG;0CACwB,OAAO,CAAC,kBAAkB,CAAC,EAAE,KAAG,kBAAkB;IAuB7E;;;;;;OAMG;sCACoB,MAAM,WAAW,kBAAkB,KAAG,OAAO;IAmBpE;;;;;OAKG;0CACwB,kBAAkB,KAAG,MAAM;IAoBtD;;;;;;OAMG;wCAEQ,kBAAkB,oBACV,MAAM,EAAE,KACxB,kBAAkB;CAmBb,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG;IACF,WAAW,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAWA;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG;IACF,WAAW,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAWA"}

package/dist/utils/index.d.ts

@@ -3,4 +3,5 @@
  */
 export * from './common';
 export * from './featureFlags';
+export * from './runtime';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,WAAW,CAAC"}

package/dist/utils/mapperUtils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Mapper Utility Functions
+ *
+ * Common utilities for data transformation in mappers.
+ */
+/**
+ * Convert snake_case to camelCase
+ */
+export declare function snakeToCamel(str: string): string;
+/**
+ * Convert camelCase to snake_case
+ */
+export declare function camelToSnake(str: string): string;
+/**
+ * Parse ISO date string to Date object
+ */
+export declare function parseDate(dateString: string | null | undefined): Date | null;
+/**
+ * Format Date to ISO string for API
+ */
+export declare function formatDate(date: Date | null | undefined): string | null;
+/**
+ * Trim string if defined
+ */
+export declare function trimString(str: string | undefined): string | undefined;
+/**
+ * Pick only defined values from object (for PATCH requests)
+ */
+export declare function pickDefined<T extends Record<string, unknown>>(obj: T): Partial<T>;
+/**
+ * Convert object keys from snake_case to camelCase
+ */
+export declare function keysToCamel<T extends Record<string, unknown>>(obj: T): Record<string, unknown>;
+/**
+ * Convert object keys from camelCase to snake_case
+ */
+export declare function keysToSnake<T extends Record<string, unknown>>(obj: T): Record<string, unknown>;
+//# sourceMappingURL=mapperUtils.d.ts.map

package/dist/utils/mapperUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapperUtils.d.ts","sourceRoot":"","sources":["../../src/utils/mapperUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAI5E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEtE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQjF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM9F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM9F"}

package/dist/utils/runtime.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Runtime Detection Utilities
+ *
+ * Utilities for detecting the current JavaScript runtime environment.
+ */
+import type { CoreRuntimeEnvironment } from '@plyaz/types/core';
+/**
+ * Detect the current runtime environment
+ */
+export declare function detectRuntime(): CoreRuntimeEnvironment;
+/**
+ * Load environment variables from a .env file
+ */
+export declare function loadEnvFile(envPath: string, verbose?: boolean): Promise<void>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/utils/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/utils/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AA6DhE;;GAEG;AACH,wBAAgB,aAAa,IAAI,sBAAsB,CAmBtD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAanF"}

package/dist/version.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Package version - single source of truth
+ *
+ * Reads version from package.json to ensure consistency across:
+ * - Health check endpoints
+ * - API headers (X-Version)
+ * - Observability tags
+ * - Logging metadata
+ */
+/**
+ * Get the package version from package.json
+ * Caches the result for subsequent calls
+ */
+export declare function getPackageVersion(): string;
+/**
+ * Package version constant
+ * Use this for static contexts where async/dynamic loading isn't needed
+ */
+export declare const VERSION: string;
+/**
+ * Package name
+ */
+export declare const PACKAGE_NAME = "@plyaz/core";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAuB1C;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAsB,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,YAAY,gBAAgB,CAAC"}

package/dist/web_app/auth/add_user.d.ts

@@ -1,3 +1,3 @@
-import { type DBUser } from '@plyaz/types';
-export declare const userData: DBUser;
+import type { CoreDBUser } from '@plyaz/types/core';
+export declare const userData: CoreDBUser;
 //# sourceMappingURL=add_user.d.ts.map

package/dist/web_app/auth/add_user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add_user.d.ts","sourceRoot":"","sources":["../../../src/web_app/auth/add_user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,eAAO,MAAM,QAAQ,EAAE,MAiBtB,CAAC"}
+{"version":3,"file":"add_user.d.ts","sourceRoot":"","sources":["../../../src/web_app/auth/add_user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,QAAQ,EAAE,UAiBtB,CAAC"}

package/dist/web_app/auth/update_user.d.ts

@@ -1,2 +1,2 @@
-export declare const UpdateUser: <T extends Object>(table: string, id: string, input: T) => Promise<unknown>;
+export declare const UpdateUser: <T extends Record<string, unknown>>(table: string, id: string, input: T) => Promise<unknown>;
 //# sourceMappingURL=update_user.d.ts.map