@oxyhq/services 5.18.0 → 5.18.2

package/lib/typescript/module/core/OxyServices.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.base.d.ts","sourceRoot":"","sources":["../../../../src/core/OxyServices.base.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAkB,MAAM,sBAAsB,CAAC;AAEvF,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAGjE,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD;;GAEG;AACH,qBAAa,eAAe;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;gBAEb,GAAG,IAAI,EAAE,GAAG,EAAE;IAa1B,MAAM,CAAC,qBAAqB,IAAI,IAAI;IAIpC;;;OAGG;IACU,WAAW,CAAC,CAAC,EACxB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,EACnD,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;IAcb;;OAEG;IACI,UAAU,IAAI,MAAM;IAI3B;;;OAGG;IACI,SAAS,IAAI,WAAW;IAI/B;;OAEG;IACI,UAAU;;;;;;;;IAIjB;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACI,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACI,aAAa;;;;;;IAIpB;;OAEG;IACI,WAAW,IAAI,MAAM;IAI5B;;OAEG;IACI,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,SAAK,GAAG,IAAI;IAI9D;;OAEG;IACI,WAAW,IAAI,IAAI;IAI1B;;OAEG;IACI,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAcxC;;OAEG;IACI,aAAa,IAAI,OAAO;IAI/B;;OAEG;IACI,cAAc,IAAI,MAAM,GAAG,IAAI;IAItC;;;;;;;;;;;;;;;;;OAiBG;IACU,WAAW,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA6B5D;;;OAGG;IACU,aAAa,CAAC,CAAC,EAC1B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;KACnB,GACL,OAAO,CAAC,CAAC,CAAC;IAuDb;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBlC;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK;IAWzC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KACnB,CAAC;CAWH"}

package/lib/typescript/module/core/OxyServices.d.ts

@@ -0,0 +1,82 @@
+/**
+ * OxyServices - Unified client for Oxy API and Oxy Cloud
+ *
+ * # Usage Examples
+ *
+ * ## Browser (ESM/TypeScript)
+ *
+ * ```typescript
+ * import { OxyServices } from './core/OxyServices';
+ *
+ * const oxy = new OxyServices({
+ *   baseURL: 'https://api.oxy.so',
+ *   cloudURL: 'https://cloud.oxy.so',
+ * });
+ *
+ * // Authenticate and fetch user
+ * await oxy.setTokens('ACCESS_TOKEN');
+ * const user = await oxy.getCurrentUser();
+ *
+ * // Upload a file (browser File API)
+ * const fileInput = document.querySelector('input[type=file]');
+ * const file = fileInput.files[0];
+ * await oxy.uploadRawFile(file);
+ *
+ * // Get a file download URL for <img src>
+ * const url = oxy.getFileDownloadUrl('fileId', 'thumb');
+ * ```
+ *
+ * ## Node.js (CommonJS/TypeScript)
+ *
+ * ```typescript
+ * import { OxyServices } from './core/OxyServices';
+ * import fs from 'fs';
+ *
+ * const oxy = new OxyServices({
+ *   baseURL: 'https://api.oxy.so',
+ *   cloudURL: 'https://cloud.oxy.so',
+ * });
+ *
+ * // Authenticate and fetch user
+ * await oxy.setTokens('ACCESS_TOKEN');
+ * const user = await oxy.getCurrentUser();
+ *
+ * // Upload a file (Node.js Buffer)
+ * const buffer = fs.readFileSync('myfile.png');
+ * const blob = new Blob([buffer]);
+ * await oxy.uploadRawFile(blob, { filename: 'myfile.png' });
+ *
+ * // Get a file download URL
+ * const url = oxy.getFileDownloadUrl('fileId');
+ * ```
+ *
+ * ## Configuration
+ * - `baseURL`: Oxy API endpoint (e.g., https://api.oxy.so)
+ * - `cloudURL`: Oxy Cloud/CDN endpoint (e.g., https://cloud.oxy.so)
+ *
+ * See method JSDoc for more details and options.
+ */
+import { type OxyConfig } from './OxyServices.base';
+import { OxyAuthenticationError, OxyAuthenticationTimeoutError } from './OxyServices.errors';
+import { composeOxyServices } from './mixins';
+declare const OxyServices_base: any;
+export declare class OxyServices extends OxyServices_base {
+    constructor(config: OxyConfig);
+}
+export interface OxyServices extends InstanceType<ReturnType<typeof composeOxyServices>> {
+}
+export { OxyAuthenticationError, OxyAuthenticationTimeoutError };
+/**
+ * Export the default Oxy Cloud URL (for backward compatibility)
+ */
+export declare const OXY_CLOUD_URL = "https://cloud.oxy.so";
+/**
+ * Export the default Oxy API URL (for documentation)
+ */
+export declare const OXY_API_URL: any;
+/**
+ * Pre-configured client instance for easy import
+ * Uses OXY_API_URL as baseURL and OXY_CLOUD_URL as cloudURL
+ */
+export declare const oxyClient: OxyServices;
+//# sourceMappingURL=OxyServices.d.ts.map

package/lib/typescript/module/core/OxyServices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.d.ts","sourceRoot":"","sources":["../../../../src/core/OxyServices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAG7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;gCAuCW,GAAG;AAA5D,qBAAa,WAAY,SAAQ,gBAA4B;gBAC/C,MAAM,EAAE,SAAS;CAG9B;AAID,MAAM,WAAW,WAAY,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;CAAG;AAG3F,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,aAAa,yBAAyB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,WAAW,KAAqG,CAAC;AAE9H;;;GAGG;AACH,eAAO,MAAM,SAAS,aAAqE,CAAC"}

package/lib/typescript/module/core/OxyServices.errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Custom error types for better error handling
+ */
+export declare class OxyAuthenticationError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(message: string, code?: string, status?: number);
+}
+export declare class OxyAuthenticationTimeoutError extends OxyAuthenticationError {
+    constructor(operationName: string, timeoutMs: number);
+}
+//# sourceMappingURL=OxyServices.errors.d.ts.map

package/lib/typescript/module/core/OxyServices.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.errors.d.ts","sourceRoot":"","sources":["../../../../src/core/OxyServices.errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,IAAI,SAAe,EAAE,MAAM,SAAM;CAM/D;AAED,qBAAa,6BAA8B,SAAQ,sBAAsB;gBAC3D,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAQrD"}

package/lib/typescript/module/core/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * OxyServices Core Module - Unified Architecture
+ *
+ * This module exports the unified OxyServices class that provides all API functionality
+ * in one simple, easy-to-use interface.
+ */
+export { OxyServices, OxyAuthenticationError, OxyAuthenticationTimeoutError } from './OxyServices';
+export { OXY_CLOUD_URL, oxyClient } from './OxyServices';
+export { CrossDomainAuth, createCrossDomainAuth } from './CrossDomainAuth';
+export type { CrossDomainAuthOptions } from './CrossDomainAuth';
+export * from '../models/interfaces';
+export * from '../models/session';
+export { DeviceManager } from '../utils/deviceManager';
+export type { DeviceFingerprint, StoredDeviceInfo } from '../utils/deviceManager';
+export { SUPPORTED_LANGUAGES, getLanguageMetadata, getLanguageName, getNativeLanguageName, normalizeLanguageCode } from '../utils/languageUtils';
+export type { LanguageMetadata } from '../utils/languageUtils';
+import { OxyServices } from './OxyServices';
+export default OxyServices;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAGlF,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,eAAe,WAAW,CAAC"}

package/lib/typescript/module/core/mixins/OxyServices.analytics.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Analytics Methods Mixin
+ *
+ * Provides methods for analytics tracking and data retrieval
+ */
+import type { OxyServicesBase } from '../OxyServices.base';
+export declare function OxyServicesAnalyticsMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Track an analytics event
+         * @param eventName - Name of the event to track
+         * @param properties - Optional event properties
+         */
+        trackEvent(eventName: string, properties?: Record<string, any>): Promise<void>;
+        /**
+         * Get analytics data for a date range
+         * @param startDate - Optional start date (ISO string)
+         * @param endDate - Optional end date (ISO string)
+         * @returns Analytics data
+         */
+        getAnalytics(startDate?: string, endDate?: string): Promise<any>;
+        httpService: import("../HttpService").HttpService;
+        cloudURL: string;
+        config: import("../OxyServices.base").OxyConfig;
+        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
+        getBaseURL(): string;
+        getClient(): import("../HttpService").HttpService;
+        getMetrics(): {
+            totalRequests: number;
+            successfulRequests: number;
+            failedRequests: number;
+            cacheHits: number;
+            cacheMisses: number;
+            averageResponseTime: number;
+        };
+        clearCache(): void;
+        clearCacheEntry(key: string): void;
+        getCacheStats(): {
+            size: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        getCloudURL(): string;
+        setTokens(accessToken: string, refreshToken?: string): void;
+        clearTokens(): void;
+        getCurrentUserId(): string | null;
+        hasValidToken(): boolean;
+        getAccessToken(): string | null;
+        waitForAuth(timeoutMs?: number): Promise<boolean>;
+        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
+            maxRetries?: number;
+            retryDelay?: number;
+            authTimeoutMs?: number;
+        }): Promise<T_1>;
+        validate(): Promise<boolean>;
+        handleError(error: unknown): Error;
+        healthCheck(): Promise<{
+            status: string;
+            users?: number;
+            timestamp?: string;
+            [key: string]: any;
+        }>;
+    };
+    __resetTokensForTests(): void;
+} & T;
+//# sourceMappingURL=OxyServices.analytics.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.analytics.d.ts","sourceRoot":"","sources":["../../../../../src/core/mixins/OxyServices.analytics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,OAAO,eAAe,EAAE,IAAI,EAAE,CAAC;kBAE1D,GAAG,EAAE;QAI1B;;;;WAIG;8BACyB,MAAM,eAAe,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;QAWpF;;;;;WAKG;iCAC4B,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAiBgwI,CAAC;sBAA0B,CAAC;yBAA6B,CAAC;;;;;;iBAAuhG,CAAC;qBAAwB,CAAC;;;;;MAFp7O"}

package/lib/typescript/module/core/mixins/OxyServices.assets.d.ts

@@ -0,0 +1,136 @@
+import type { AccountStorageUsageResponse, AssetUrlResponse, AssetVariant } from '../../models/interfaces';
+import type { OxyServicesBase } from '../OxyServices.base';
+export declare function OxyServicesAssetsMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Delete file
+         */
+        deleteFile(fileId: string): Promise<any>;
+        /**
+         * Get file download URL (synchronous - uses stream endpoint for images to avoid ORB blocking)
+         */
+        getFileDownloadUrl(fileId: string, variant?: string, expiresIn?: number): string;
+        /**
+         * Get file download URL asynchronously (returns signed URL directly from CDN)
+         */
+        getFileDownloadUrlAsync(fileId: string, variant?: string, expiresIn?: number): Promise<string>;
+        /**
+         * List user files
+         */
+        listUserFiles(limit?: number, offset?: number): Promise<{
+            files: any[];
+            total: number;
+            hasMore: boolean;
+        }>;
+        /**
+         * Get account storage usage (server-side usage aggregated from assets)
+         */
+        getAccountStorageUsage(): Promise<AccountStorageUsageResponse>;
+        /**
+         * Get file content as text
+         */
+        getFileContentAsText(fileId: string, variant?: string): Promise<string>;
+        /**
+         * Get file content as blob
+         */
+        getFileContentAsBlob(fileId: string, variant?: string): Promise<Blob>;
+        /**
+         * Get batch access to multiple files
+         */
+        getBatchFileAccess(fileIds: string[], context?: string): Promise<Record<string, any>>;
+        /**
+         * Get download URLs for multiple files efficiently
+         */
+        getFileDownloadUrls(fileIds: string[], context?: string): Promise<Record<string, string>>;
+        /**
+         * Upload raw file data
+         */
+        uploadRawFile(file: File | Blob, visibility?: "private" | "public" | "unlisted", metadata?: Record<string, any>): Promise<any>;
+        /**
+         * Upload file using Central Asset Service
+         */
+        assetUpload(file: File, visibility?: "private" | "public" | "unlisted", metadata?: Record<string, any>, onProgress?: (progress: number) => void): Promise<any>;
+        /**
+         * Link asset to an entity
+         */
+        assetLink(fileId: string, app: string, entityType: string, entityId: string, visibility?: "private" | "public" | "unlisted", webhookUrl?: string): Promise<any>;
+        /**
+         * Unlink asset from an entity
+         */
+        assetUnlink(fileId: string, app: string, entityType: string, entityId: string): Promise<any>;
+        /**
+         * Get asset metadata
+         */
+        assetGet(fileId: string): Promise<any>;
+        /**
+         * Get asset URL (CDN or signed URL)
+         */
+        assetGetUrl(fileId: string, variant?: string, expiresIn?: number): Promise<AssetUrlResponse>;
+        /**
+         * Restore asset from trash
+         */
+        assetRestore(fileId: string): Promise<any>;
+        /**
+         * Delete asset with optional force
+         */
+        assetDelete(fileId: string, force?: boolean): Promise<any>;
+        /**
+         * Get list of available variants for an asset
+         */
+        assetGetVariants(fileId: string): Promise<AssetVariant[]>;
+        /**
+         * Update asset visibility
+         */
+        assetUpdateVisibility(fileId: string, visibility: "private" | "public" | "unlisted"): Promise<any>;
+        uploadAvatar(file: File, userId: string, app?: string): Promise<any>;
+        uploadProfileBanner(file: File, userId: string, app?: string): Promise<any>;
+        getAssetUrlCacheTTL(expiresIn?: number): number;
+        fetchAssetDownloadUrl(fileId: string, variant?: string, cacheTTL?: number, expiresIn?: number): Promise<string | null>;
+        fetchAssetContent(url: string, type: "text"): Promise<string>;
+        fetchAssetContent(url: string, type: "blob"): Promise<Blob>;
+        httpService: import("../HttpService").HttpService;
+        cloudURL: string;
+        config: import("../OxyServices.base").OxyConfig;
+        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
+        getBaseURL(): string;
+        getClient(): import("../HttpService").HttpService;
+        getMetrics(): {
+            totalRequests: number;
+            successfulRequests: number;
+            failedRequests: number;
+            cacheHits: number;
+            cacheMisses: number;
+            averageResponseTime: number;
+        };
+        clearCache(): void;
+        clearCacheEntry(key: string): void;
+        getCacheStats(): {
+            size: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        getCloudURL(): string;
+        setTokens(accessToken: string, refreshToken?: string): void;
+        clearTokens(): void;
+        getCurrentUserId(): string | null;
+        hasValidToken(): boolean;
+        getAccessToken(): string | null;
+        waitForAuth(timeoutMs?: number): Promise<boolean>;
+        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
+            maxRetries?: number;
+            retryDelay?: number;
+            authTimeoutMs?: number;
+        }): Promise<T_1>;
+        validate(): Promise<boolean>;
+        handleError(error: unknown): Error;
+        healthCheck(): Promise<{
+            status: string;
+            users?: number;
+            timestamp?: string;
+            [key: string]: any;
+        }>;
+    };
+    __resetTokensForTests(): void;
+} & T;
+//# sourceMappingURL=OxyServices.assets.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.assets.d.ts","sourceRoot":"","sources":["../../../../../src/core/mixins/OxyServices.assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,OAAO,eAAe,EAAE,IAAI,EAAE,CAAC;kBAEvD,GAAG,EAAE;QAI1B;;WAEG;2BACsB,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;QAQ9C;;WAEG;mCACwB,MAAM,YAAY,MAAM,cAAc,MAAM,GAAG,MAAM;QAahF;;WAEG;wCACmC,MAAM,YAAY,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAepG;;WAEG;8BACyB,MAAM,WAAW,MAAM,GAAG,OAAO,CAAC;YAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC;QAahH;;WAEG;kCAC6B,OAAO,CAAC,2BAA2B,CAAC;QAUpE;;WAEG;qCACgC,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAkB7E;;WAEG;qCACgC,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;QAkB3E;;WAEG;oCAC+B,MAAM,EAAE,YAAY,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAW3F;;WAEG;qCACgC,MAAM,EAAE,YAAY,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAY/F;;WAEG;4BACuB,IAAI,GAAG,IAAI,eAAe,SAAS,GAAG,QAAQ,GAAG,UAAU,aAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;QAIpI;;WAEG;0BACqB,IAAI,eAAe,SAAS,GAAG,QAAQ,GAAG,UAAU,aAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;QAgFpK;;WAEG;0BACqB,MAAM,OAAO,MAAM,cAAc,MAAM,YAAY,MAAM,eAAe,SAAS,GAAG,QAAQ,GAAG,UAAU,eAAe,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;QAWrK;;WAEG;4BACuB,MAAM,OAAO,MAAM,cAAc,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;QAYlG;;WAEG;yBACoB,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;QAW5C;;WAEG;4BACuB,MAAM,YAAY,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;QAelG;;WAEG;6BACwB,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;QAQhD;;WAEG;4BACuB,MAAM,UAAS,OAAO,GAAW,OAAO,CAAC,GAAG,CAAC;QASvE;;WAEG;iCAC4B,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;QAS/D;;WAEG;sCACiC,MAAM,cAAc,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;2BAU/E,IAAI,UAAU,MAAM,QAAO,MAAM,GAAgB,OAAO,CAAC,GAAG,CAAC;kCAUtD,IAAI,UAAU,MAAM,QAAO,MAAM,GAAgB,OAAO,CAAC,GAAG,CAAC;wCAUtD,MAAM;sCAMnC,MAAM,YACJ,MAAM,aACL,MAAM,cACL,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;+BAkBW,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;+BACtC,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA9N7B,CAAC;sBACtC,CAAR;yBAA6B,CAAC;;;;;;iBAwFxB,CAAP;qBAAwB,CAAC;;;;;MA8IzB"}

package/lib/typescript/module/core/mixins/OxyServices.auth.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Authentication Methods Mixin
+ *
+ * Supports password-based login (email/username) and public key challenge-response.
+ */
+import type { User } from '../../models/interfaces';
+import type { SessionLoginResponse } from '../../models/session';
+import type { OxyServicesBase } from '../OxyServices.base';
+export interface ChallengeResponse {
+    challenge: string;
+    expiresAt: string;
+}
+export interface RegistrationRequest {
+    publicKey: string;
+    username: string;
+    email?: string;
+    signature: string;
+    timestamp: number;
+}
+export interface ChallengeVerifyRequest {
+    publicKey: string;
+    challenge: string;
+    signature: string;
+    timestamp: number;
+    deviceName?: string;
+    deviceFingerprint?: string;
+}
+export interface PublicKeyCheckResponse {
+    registered: boolean;
+    message: string;
+}
+export declare function OxyServicesAuthMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Register a new identity with public key authentication
+         * Identity is purely cryptographic - username and profile data are optional
+         *
+         * @param publicKey - The user's ECDSA public key (hex)
+         * @param signature - Signature of the registration request
+         * @param timestamp - Timestamp when the signature was created
+         */
+        register(publicKey: string, signature: string, timestamp: number): Promise<{
+            message: string;
+            user: User;
+        }>;
+        /**
+         * Request an authentication challenge
+         * The client must sign this challenge with their private key
+         *
+         * @param publicKey - The user's public key
+         */
+        requestChallenge(publicKey: string): Promise<ChallengeResponse>;
+        /**
+         * Verify a signed challenge and create a session
+         *
+         * @param publicKey - The user's public key
+         * @param challenge - The challenge string from requestChallenge
+         * @param signature - Signature of the auth message
+         * @param timestamp - Timestamp when the signature was created
+         * @param deviceName - Optional device name
+         * @param deviceFingerprint - Optional device fingerprint
+         */
+        verifyChallenge(publicKey: string, challenge: string, signature: string, timestamp: number, deviceName?: string, deviceFingerprint?: string): Promise<SessionLoginResponse>;
+        /**
+         * Check if a public key is already registered
+         */
+        checkPublicKeyRegistered(publicKey: string): Promise<PublicKeyCheckResponse>;
+        /**
+         * Get user by public key
+         */
+        getUserByPublicKey(publicKey: string): Promise<User>;
+        /**
+         * Get user by session ID
+         */
+        getUserBySession(sessionId: string): Promise<User>;
+        /**
+         * Batch get multiple user profiles by session IDs
+         */
+        getUsersBySessions(sessionIds: string[]): Promise<Array<{
+            sessionId: string;
+            user: User | null;
+        }>>;
+        /**
+         * Get access token by session ID
+         */
+        getTokenBySession(sessionId: string): Promise<{
+            accessToken: string;
+            expiresAt: string;
+        }>;
+        /**
+         * Get sessions by session ID
+         */
+        getSessionsBySessionId(sessionId: string): Promise<any[]>;
+        /**
+         * Logout from a specific session
+         */
+        logoutSession(sessionId: string, targetSessionId?: string): Promise<void>;
+        /**
+         * Logout from all sessions
+         */
+        logoutAllSessions(sessionId: string): Promise<void>;
+        /**
+         * Validate session
+         */
+        validateSession(sessionId: string, options?: {
+            deviceFingerprint?: string;
+            useHeaderValidation?: boolean;
+        }): Promise<{
+            valid: boolean;
+            expiresAt: string;
+            lastActivity: string;
+            user: User;
+            sessionId?: string;
+            source?: string;
+        }>;
+        /**
+         * Check username availability
+         */
+        checkUsernameAvailability(username: string): Promise<{
+            available: boolean;
+            message: string;
+        }>;
+        /**
+         * Check email availability
+         */
+        checkEmailAvailability(email: string): Promise<{
+            available: boolean;
+            message: string;
+        }>;
+        /**
+         * Register a new user with email/username and password
+         */
+        signUp(username: string, email: string, password: string, deviceName?: string, deviceFingerprint?: any): Promise<SessionLoginResponse>;
+        /**
+         * Sign in with email or username and password
+         */
+        signIn(identifier: string, password: string, deviceName?: string, deviceFingerprint?: any): Promise<SessionLoginResponse>;
+        /**
+         * Convenience helper for email sign-in
+         */
+        signInWithEmail(email: string, password: string, deviceName?: string, deviceFingerprint?: any): Promise<SessionLoginResponse>;
+        httpService: import("../HttpService").HttpService;
+        cloudURL: string;
+        config: import("../OxyServices.base").OxyConfig;
+        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
+        getBaseURL(): string;
+        getClient(): import("../HttpService").HttpService;
+        getMetrics(): {
+            totalRequests: number;
+            successfulRequests: number;
+            failedRequests: number;
+            cacheHits: number;
+            cacheMisses: number;
+            averageResponseTime: number;
+        };
+        clearCache(): void;
+        clearCacheEntry(key: string): void;
+        getCacheStats(): {
+            size: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        getCloudURL(): string;
+        setTokens(accessToken: string, refreshToken?: string): void;
+        clearTokens(): void;
+        getCurrentUserId(): string | null;
+        hasValidToken(): boolean;
+        getAccessToken(): string | null;
+        waitForAuth(timeoutMs?: number): Promise<boolean>;
+        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
+            maxRetries?: number;
+            retryDelay?: number;
+            authTimeoutMs?: number;
+        }): Promise<T_1>;
+        validate(): Promise<boolean>;
+        handleError(error: unknown): Error;
+        healthCheck(): Promise<{
+            status: string;
+            users?: number;
+            timestamp?: string;
+            [key: string]: any;
+        }>;
+    };
+    __resetTokensForTests(): void;
+} & T;
+//# sourceMappingURL=OxyServices.auth.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.auth.d.ts","sourceRoot":"","sources":["../../../../../src/core/mixins/OxyServices.auth.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/core/mixins/OxyServices.developer.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Developer API Methods Mixin
+ *
+ * Provides methods for managing developer applications and API keys
+ */
+import type { OxyServicesBase } from '../OxyServices.base';
+export declare function OxyServicesDeveloperMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Get developer apps for the current user
+         * @returns Array of developer apps
+         */
+        getDeveloperApps(): Promise<any[]>;
+        /**
+         * Create a new developer app
+         * @param data - Developer app configuration
+         * @returns Created developer app
+         */
+        createDeveloperApp(data: {
+            name: string;
+            description?: string;
+            webhookUrl: string;
+            devWebhookUrl?: string;
+            scopes?: string[];
+        }): Promise<any>;
+        /**
+         * Get a specific developer app
+         */
+        getDeveloperApp(appId: string): Promise<any>;
+        /**
+         * Update a developer app
+         * @param appId - The developer app ID
+         * @param data - Updated app configuration
+         * @returns Updated developer app
+         */
+        updateDeveloperApp(appId: string, data: {
+            name?: string;
+            description?: string;
+            webhookUrl?: string;
+            devWebhookUrl?: string;
+            scopes?: string[];
+        }): Promise<any>;
+        /**
+         * Regenerate API secret for a developer app
+         * @param appId - The developer app ID
+         * @returns App with new secret
+         */
+        regenerateDeveloperAppSecret(appId: string): Promise<any>;
+        /**
+         * Delete a developer app
+         * @param appId - The developer app ID
+         * @returns Deletion result
+         */
+        deleteDeveloperApp(appId: string): Promise<any>;
+        httpService: import("../HttpService").HttpService;
+        cloudURL: string;
+        config: import("../OxyServices.base").OxyConfig;
+        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
+        getBaseURL(): string;
+        getClient(): import("../HttpService").HttpService;
+        getMetrics(): {
+            totalRequests: number;
+            successfulRequests: number;
+            failedRequests: number;
+            cacheHits: number;
+            cacheMisses: number;
+            averageResponseTime: number;
+        };
+        clearCache(): void;
+        clearCacheEntry(key: string): void;
+        getCacheStats(): {
+            size: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        getCloudURL(): string;
+        setTokens(accessToken: string, refreshToken?: string): void;
+        clearTokens(): void;
+        getCurrentUserId(): string | null;
+        hasValidToken(): boolean;
+        getAccessToken(): string | null;
+        waitForAuth(timeoutMs?: number): Promise<boolean>;
+        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
+            maxRetries?: number;
+            retryDelay?: number;
+            authTimeoutMs?: number;
+        }): Promise<T_1>;
+        validate(): Promise<boolean>;
+        handleError(error: unknown): Error;
+        healthCheck(): Promise<{
+            status: string;
+            users?: number;
+            timestamp?: string;
+            [key: string]: any;
+        }>;
+    };
+    __resetTokensForTests(): void;
+} & T;
+//# sourceMappingURL=OxyServices.developer.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.developer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.developer.d.ts","sourceRoot":"","sources":["../../../../../src/core/mixins/OxyServices.developer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,OAAO,eAAe,EAAE,IAAI,EAAE,CAAC;kBAE1D,GAAG,EAAE;QAI1B;;;WAGG;4BACuB,OAAO,CAAC,GAAG,EAAE,CAAC;QAYxC;;;;WAIG;iCAC4B;YAC7B,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,EAAE,MAAM,CAAC;YACnB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;SACnB,GAAG,OAAO,CAAC,GAAG,CAAC;QAShB;;WAEG;+BAC0B,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;QAYlD;;;;;WAKG;kCAC6B,MAAM,QAAQ;YAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;SACnB,GAAG,OAAO,CAAC,GAAG,CAAC;QAShB;;;;WAIG;4CACuC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;QAQ/D;;;;WAIG;kCAC6B,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAU0pF,CAAC;sBAA0B,CAAC;yBAA6B,CAAC;;;;;;iBAAuhG,CAAC;qBAAwB,CAAC;;;;;MAF7zL"}