@plyaz/core 1.1.0 → 1.2.0

package/dist/services/ApiClientService.d.ts

@@ -0,0 +1,90 @@
+/**
+ * API Client Singleton Service (@plyaz/core)
+ * Manages the API client with environment-specific configurations and intelligent defaults
+ *
+ * The app reads process.env and constructs ApiClientOptions, then passes to this service.
+ * Service never touches process.env directly - all env reading happens in the app layer.
+ *
+ * @module services/ApiClientService
+ */
+import type { ApiClientWithEvents, ApiClientOptions } from '@plyaz/types/api';
+import { type ClientEventManager, type EndpointsList } from '@plyaz/api';
+import type { ApiEnvironmentConfig } from '@plyaz/types/core';
+/**
+ * API Client Singleton Service
+ * Manages API client instance lifecycle with environment-specific configurations
+ *
+ * @example
+ * ```typescript
+ * // In your app initialization (Next.js, React, etc.)
+ * import { ApiClientService } from '@plyaz/core';
+ *
+ * // Environment metadata
+ * const envConfig = {
+ *   env: process.env.NODE_ENV as 'production',
+ *   apiKey: process.env.API_KEY,
+ * };
+ *
+ * // API configuration with event handlers
+ * await ApiClientService.init(envConfig, {
+ *   baseURL: process.env.API_URL!,
+ *   encryption: {
+ *     key: {
+ *       id: 'prod-key-v1',
+ *       key: process.env.ENCRYPTION_KEY!,
+ *       algorithm: 'AES-GCM'
+ *     }
+ *   },
+ *   clientEvents: {
+ *     onRequestStart: (event) => apiStore.trackRequest(event),
+ *   },
+ * });
+ *
+ * // Later, anywhere in your app
+ * const client = ApiClientService.getClient();
+ * ```
+ */
+export declare class ApiClientService {
+    private static instance;
+    private static isInitializing;
+    private static initPromise;
+    /**
+     * Initialize the API client with environment config and API options
+     *
+     * @param envConfig - Environment metadata (env, apiKey)
+     * @param apiConfig - API configuration (baseURL, encryption, timeout, event handlers, etc.)
+     * @returns Promise that resolves to the initialized client
+     */
+    static init(envConfig: ApiEnvironmentConfig, apiConfig?: Partial<ApiClientOptions>): Promise<ApiClientWithEvents<ClientEventManager, EndpointsList>>;
+    /**
+     * Internal initialization logic
+     * Merges environment-specific defaults with API configuration
+     *
+     * Merge Priority (lowest to highest):
+     * 1. Environment defaults (PRODUCTION_CONFIG / STAGING_CONFIG / DEVELOPMENT_CONFIG)
+     * 2. Environment metadata (envConfig - apiKey)
+     * 3. API configuration (apiConfig - baseURL, encryption, timeout, etc.)
+     */
+    private static createClient;
+    /**
+     * Get the initialized client instance
+     *
+     * @throws {ApiPackageError} If client not initialized
+     */
+    static getClient(): ApiClientWithEvents<ClientEventManager, EndpointsList>;
+    /**
+     * Check if client is initialized
+     */
+    static isInitialized(): boolean;
+    /**
+     * Reinitialize with new config and options
+     */
+    static reinitialize(envConfig: ApiEnvironmentConfig, apiConfig?: Partial<ApiClientOptions>): Promise<ApiClientWithEvents<ClientEventManager, EndpointsList>>;
+    /**
+     * Dispose of the client instance
+     */
+    static dispose(): void;
+}
+export declare const getApiClient: () => ApiClientWithEvents<ClientEventManager, EndpointsList>;
+export declare const initApiClient: (envConfig: ApiEnvironmentConfig, apiConfig?: Partial<ApiClientOptions>) => Promise<ApiClientWithEvents<ClientEventManager, EndpointsList>>;
+//# sourceMappingURL=ApiClientService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApiClientService.d.ts","sourceRoot":"","sources":["../../src/services/ApiClientService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAa,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAmB,MAAM,YAAY,CAAC;AAG1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AA2c9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuE;IAC9F,OAAO,CAAC,MAAM,CAAC,cAAc,CAAS;IACtC,OAAO,CAAC,MAAM,CAAC,WAAW,CAA8B;IAExD;;;;;;OAMG;WACU,IAAI,CACf,SAAS,EAAE,oBAAoB,EAC/B,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IA4BlE;;;;;;;;OAQG;mBACkB,YAAY;IA6CjC;;;;OAIG;IACH,MAAM,CAAC,SAAS,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC;IAmB1E;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,OAAO;IAI/B;;OAEG;WACU,YAAY,CACvB,SAAS,EAAE,oBAAoB,EAC/B,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAKlE;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,IAAI;CAQvB;AAGD,eAAO,MAAM,YAAY,QAAO,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CACvD,CAAC;AAE/B,eAAO,MAAM,aAAa,GACxB,WAAW,oBAAoB,EAC/B,YAAY,OAAO,CAAC,gBAAgB,CAAC,KACpC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CACpB,CAAC"}

package/dist/services/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Services Layer
+ * Domain services for @plyaz/core package
+ *
+ * @module services
+ */
+export * from './ApiClientService';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC"}

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

@@ -4,8 +4,8 @@
  * Exports all common utility functions that can be reused across the application.
  *
  * @fileoverview Common utilities export
- * @version 1.0.0
  */
 export { hashString, isInRollout, createRolloutIdentifier, HashUtils } from './hash';
 export { isTruthy, toBoolean, ValueUtils } from './values';
+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;;;;;;;GAOG;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"}
+{"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"}

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

@@ -0,0 +1,20 @@
+/**
+ * Validation Utility Functions
+ */
+/**
+ * Type guard to check if value is string
+ */
+export declare const isString: (value: unknown) => value is string;
+/**
+ * Type guard to check if value is defined (not undefined)
+ */
+export declare const isDefined: <T>(value: T | undefined) => value is T;
+/**
+ * Type guard to check if value is number
+ */
+export declare const isNumber: (value: unknown) => value is number;
+/**
+ * Helper function to get all valid provider types as array
+ */
+export declare const getValidProviders: () => string[];
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/common/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAmC,CAAC;AAEvF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,KAAG,KAAK,IAAI,CAAwB,CAAC;AAEtF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAmC,CAAC;AAEvF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAAM,EAA2C,CAAC"}

package/dist/utils/db/databaseService.d.ts

@@ -0,0 +1,6 @@
+import 'dotenv/config';
+import { createDatabaseService } from '@plyaz/db';
+declare let db: Awaited<ReturnType<typeof createDatabaseService>>;
+export declare function getDb(): Promise<unknown>;
+export { db };
+//# sourceMappingURL=databaseService.d.ts.map

package/dist/utils/db/databaseService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseService.d.ts","sourceRoot":"","sources":["../../../src/utils/db/databaseService.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAwBlD,QAAA,IAAI,EAAE,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC;AAE1D,wBAAsB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAS9C;AAED,OAAO,EAAE,EAAE,EAAE,CAAC"}

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

@@ -0,0 +1,2 @@
+export { db } from './databaseService';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC"}

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

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

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"update_user.d.ts","sourceRoot":"","sources":["../../../src/web_app/auth/update_user.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,GAAU,CAAC,SAAS,MAAM,EAC/C,OAAO,MAAM,EACb,IAAI,MAAM,EACV,OAAO,CAAC,KACP,OAAO,CAAC,OAAO,CAIjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/core",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Shared core logic and utilities for Plyaz apps, services, and future SDKs – centralized, reusable, and scalable.",
   "type": "module",
   "keywords": [],
@@ -28,12 +28,23 @@
   ],
   "dependencies": {
     "@nestjs/common": "^11.1.3",
-    "@plyaz/config": "1.3.3",
-    "@plyaz/translations": "^1.0.2",
+    "@nestjs/core": "^11.1.6",
+    "@plyaz/api": "^1.2.2",
+    "@plyaz/config": "^1.7.18",
+    "@plyaz/db": "^0.1.0",
+    "@plyaz/errors": "^1.3.7",
+    "@plyaz/logger": "^1.3.2",
+    "@plyaz/translations": "^1.4.5",
+    "@plyaz/types": "^1.15.19",
+    "@supabase/supabase-js": "^2.79.0",
+    "dotenv": "^17.2.3",
+    "drizzle-orm": "^0.36.4",
     "ioredis": "^5.6.1",
     "next": "15.4.7",
+    "postgres": "^3.4.7",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "rxjs": "^7.8.2",
     "viem": "^2.31.7",
     "yaml": "^2.8.0"
   },
@@ -44,12 +55,12 @@
     "@eslint/js": "^9.15.0",
     "@eslint/markdown": "^6.5.0",
     "@next/eslint-plugin-next": "^15.0.3",
-    "@plyaz/devtools": "^1.8.0",
-    "@plyaz/testing": "^1.4.2",
-    "@plyaz/types": "^1.7.7",
+    "@plyaz/devtools": "^1.9.4",
+    "@plyaz/testing": "^1.5.1",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.1",
+    "@types/express": "^5.0.5",
     "@types/node": "^22.14.0",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
@@ -86,6 +97,7 @@
     "eslint-plugin-testing-library": "^6.5.0",
     "eslint-plugin-unicorn": "^56.0.1",
     "eslint-plugin-unused-imports": "^4.1.4",
+    "express": "^5.1.0",
     "glob": "11.0.3",
     "jiti": "^2.4.2",
     "jsdom": "^26.1.0",
@@ -140,6 +152,7 @@
     "remove:unused": "pnpm remove:unused:fnc && pnpm remove:unused:interfaces",
     "remove:unused:interfaces": "npx tsx check_types.ts --remove --report=./internal-reports/unused-types-report.md",
     "remove:unused:fnc": "npx tsx check_fnc.ts --report=./internal-reports/unused-declarations.md",
-    "check:dependencies": "npx tsx check_dependencies_versions.ts --report=./internal-reports/dependency-report.md"
+    "check:dependencies": "npx tsx check_dependencies_versions.ts --report=./internal-reports/dependency-report.md",
+    "pre:deploy": "pnpm run build && pnpm run lint && pnpm run format && pnpm run type:check && pnpm run test"
   }
 }