@qwickapps/server 1.4.0 → 1.5.1

package/dist/plugins/devices/__tests__/token-utils.test.js

@@ -0,0 +1,197 @@
+/**
+ * Token Utilities Tests
+ *
+ * Unit tests for device token generation, hashing, and verification.
+ */
+import { describe, it, expect } from 'vitest';
+import { generateDeviceToken, generatePairingCode, hashToken, verifyToken, isValidTokenFormat, isTokenExpired, getTokenExpiration, } from '../token-utils.js';
+describe('Token Utilities', () => {
+    describe('generateDeviceToken', () => {
+        it('should generate a token with the correct prefix', async () => {
+            const result = await generateDeviceToken('mob');
+            expect(result.token).toMatch(/^mob_/);
+        });
+        it('should generate a 43-character secret after prefix', async () => {
+            const result = await generateDeviceToken('mob');
+            const secret = result.token.split('_')[1];
+            expect(secret.length).toBe(43);
+        });
+        it('should generate base64url-safe characters', async () => {
+            const result = await generateDeviceToken('test');
+            const secret = result.token.split('_')[1];
+            expect(secret).toMatch(/^[A-Za-z0-9_-]+$/);
+        });
+        it('should return a SHA-256 hash (64 hex characters)', async () => {
+            const result = await generateDeviceToken('mob');
+            expect(result.hash).toMatch(/^[a-f0-9]{64}$/);
+        });
+        it('should return an 8-character prefix for display', async () => {
+            const result = await generateDeviceToken('mob');
+            expect(result.prefix.length).toBe(8);
+            expect(result.token.startsWith(result.prefix)).toBe(true);
+        });
+        it('should generate unique tokens each time', async () => {
+            const result1 = await generateDeviceToken('mob');
+            const result2 = await generateDeviceToken('mob');
+            expect(result1.token).not.toBe(result2.token);
+            expect(result1.hash).not.toBe(result2.hash);
+        });
+    });
+    describe('generatePairingCode', () => {
+        it('should generate a 6-character code', () => {
+            const code = generatePairingCode();
+            expect(code.length).toBe(6);
+        });
+        it('should only contain uppercase alphanumeric characters', () => {
+            const code = generatePairingCode();
+            // Excludes confusing chars: 0, O, I, 1
+            expect(code).toMatch(/^[ABCDEFGHJKLMNPQRSTUVWXYZ23456789]+$/);
+        });
+        it('should generate unique codes', () => {
+            const codes = new Set();
+            for (let i = 0; i < 100; i++) {
+                codes.add(generatePairingCode());
+            }
+            // Should have mostly unique codes (allowing some collisions)
+            expect(codes.size).toBeGreaterThan(90);
+        });
+    });
+    describe('hashToken', () => {
+        it('should return a 64-character hex string', async () => {
+            const hash = await hashToken('test_token');
+            expect(hash.length).toBe(64);
+            expect(hash).toMatch(/^[a-f0-9]+$/);
+        });
+        it('should produce consistent hashes for same input', async () => {
+            const hash1 = await hashToken('same_token');
+            const hash2 = await hashToken('same_token');
+            expect(hash1).toBe(hash2);
+        });
+        it('should produce different hashes for different input', async () => {
+            const hash1 = await hashToken('token_one');
+            const hash2 = await hashToken('token_two');
+            expect(hash1).not.toBe(hash2);
+        });
+    });
+    describe('verifyToken', () => {
+        it('should return valid for matching token and hash', async () => {
+            const token = 'mob_ABC123testtoken';
+            const hash = await hashToken(token);
+            const result = await verifyToken(token, hash);
+            expect(result.valid).toBe(true);
+            expect(result.error).toBeUndefined();
+        });
+        it('should return invalid for non-matching token', async () => {
+            const originalHash = await hashToken('original_token');
+            const result = await verifyToken('different_token', originalHash);
+            expect(result.valid).toBe(false);
+            expect(result.error).toBe('Invalid token');
+        });
+        it('should handle malformed hash gracefully', async () => {
+            const result = await verifyToken('some_token', 'not-a-valid-hex-hash');
+            expect(result.valid).toBe(false);
+            expect(result.error).toBeDefined();
+        });
+        it('should use constant-time comparison (timing-safe)', async () => {
+            // This test ensures the comparison doesn't leak timing info
+            // We can't directly test timing, but we verify the function uses the correct approach
+            const token = 'mob_securetoken123';
+            const hash = await hashToken(token);
+            // Multiple verifications should all succeed
+            for (let i = 0; i < 10; i++) {
+                const result = await verifyToken(token, hash);
+                expect(result.valid).toBe(true);
+            }
+        });
+    });
+    describe('isValidTokenFormat', () => {
+        it('should return true for valid token format', () => {
+            // 43 base64url characters after prefix (32 bytes = 43 chars in base64url)
+            const validToken = 'mob_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijk123456';
+            expect(isValidTokenFormat(validToken, 'mob')).toBe(true);
+        });
+        it('should return false for wrong prefix', () => {
+            const token = 'mob_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijk123456';
+            expect(isValidTokenFormat(token, 'cpute')).toBe(false);
+        });
+        it('should return false for missing underscore', () => {
+            const token = 'mobABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijk123456';
+            expect(isValidTokenFormat(token, 'mob')).toBe(false);
+        });
+        it('should return false for too short secret', () => {
+            const token = 'mob_tooshort';
+            expect(isValidTokenFormat(token, 'mob')).toBe(false);
+        });
+        it('should return false for too long secret', () => {
+            const token = 'mob_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijk123456extra';
+            expect(isValidTokenFormat(token, 'mob')).toBe(false);
+        });
+        it('should return false for invalid characters', () => {
+            const token = 'mob_ABCDEFGHIJKLMNOPQRSTUVWXYZ!@#$%^&*()123456';
+            expect(isValidTokenFormat(token, 'mob')).toBe(false);
+        });
+        it('should accept base64url characters including - and _', () => {
+            const token = 'mob_ABCDEFGHIJKLMNOPQRSTUVWXYZ-_abcdefghij12345';
+            expect(isValidTokenFormat(token, 'mob')).toBe(true);
+        });
+    });
+    describe('isTokenExpired', () => {
+        it('should return false for future date', () => {
+            const futureDate = new Date();
+            futureDate.setDate(futureDate.getDate() + 30);
+            expect(isTokenExpired(futureDate)).toBe(false);
+        });
+        it('should return true for past date', () => {
+            const pastDate = new Date();
+            pastDate.setDate(pastDate.getDate() - 1);
+            expect(isTokenExpired(pastDate)).toBe(true);
+        });
+        it('should return true for date exactly now (edge case)', () => {
+            const now = new Date();
+            // Slightly in the past to ensure it's expired
+            now.setMilliseconds(now.getMilliseconds() - 1);
+            expect(isTokenExpired(now)).toBe(true);
+        });
+    });
+    describe('getTokenExpiration', () => {
+        it('should return a date 90 days in the future by default', () => {
+            const now = new Date();
+            const expiration = getTokenExpiration();
+            const daysDiff = Math.round((expiration.getTime() - now.getTime()) / (1000 * 60 * 60 * 24));
+            expect(daysDiff).toBe(90);
+        });
+        it('should accept custom validity days', () => {
+            const now = new Date();
+            const expiration = getTokenExpiration(30);
+            const daysDiff = Math.round((expiration.getTime() - now.getTime()) / (1000 * 60 * 60 * 24));
+            expect(daysDiff).toBe(30);
+        });
+        it('should handle 0 days (expires immediately)', () => {
+            const now = new Date();
+            const expiration = getTokenExpiration(0);
+            // Should be very close to now
+            const diffMs = Math.abs(expiration.getTime() - now.getTime());
+            expect(diffMs).toBeLessThan(1000); // Within 1 second
+        });
+        it('should handle large values', () => {
+            const now = new Date();
+            const expiration = getTokenExpiration(365);
+            const daysDiff = Math.round((expiration.getTime() - now.getTime()) / (1000 * 60 * 60 * 24));
+            expect(daysDiff).toBe(365);
+        });
+    });
+    describe('integration: generate and verify', () => {
+        it('should generate token that can be verified', async () => {
+            const { token, hash } = await generateDeviceToken('mob');
+            const verifyResult = await verifyToken(token, hash);
+            expect(verifyResult.valid).toBe(true);
+        });
+        it('should reject tampered token', async () => {
+            const { hash } = await generateDeviceToken('mob');
+            const tamperedToken = 'mob_tamperedtokenthatisdifferentfromoriginal';
+            const verifyResult = await verifyToken(tamperedToken, hash);
+            expect(verifyResult.valid).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=token-utils.test.js.map

package/dist/plugins/devices/__tests__/token-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-utils.test.js","sourceRoot":"","sources":["../../../../src/plugins/devices/__tests__/token-utils.test.ts"],"names":[],"mappings":"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"}

package/dist/plugins/devices/adapters/compute-adapter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Compute Device Adapter
+ *
+ * Adapter for computing devices (laptops, desktops, containers).
+ * Used by QwickForge for CLI device management.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { DeviceAdapter } from '../types.js';
+/**
+ * Compute adapter configuration
+ */
+export interface ComputeAdapterConfig {
+    /** Token prefix (default: 'qwf_dev') */
+    tokenPrefix?: string;
+    /** Require hostname in metadata */
+    requireHostname?: boolean;
+    /** Allowed OS types (optional, allows all if not specified) */
+    allowedOS?: string[];
+}
+/**
+ * Create a compute device adapter
+ *
+ * @param config - Adapter configuration
+ * @returns DeviceAdapter for compute devices
+ *
+ * @example
+ * ```ts
+ * const adapter = computeDeviceAdapter({
+ *   tokenPrefix: 'qwf_dev',
+ *   requireHostname: true,
+ * });
+ * ```
+ */
+export declare function computeDeviceAdapter(config?: ComputeAdapterConfig): DeviceAdapter;
+//# sourceMappingURL=compute-adapter.d.ts.map

package/dist/plugins/devices/adapters/compute-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-adapter.d.ts","sourceRoot":"","sources":["../../../../src/plugins/devices/adapters/compute-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EAKd,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,oBAAyB,GAAG,aAAa,CA+FrF"}

package/dist/plugins/devices/adapters/compute-adapter.js

@@ -0,0 +1,100 @@
+/**
+ * Compute Device Adapter
+ *
+ * Adapter for computing devices (laptops, desktops, containers).
+ * Used by QwickForge for CLI device management.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Create a compute device adapter
+ *
+ * @param config - Adapter configuration
+ * @returns DeviceAdapter for compute devices
+ *
+ * @example
+ * ```ts
+ * const adapter = computeDeviceAdapter({
+ *   tokenPrefix: 'qwf_dev',
+ *   requireHostname: true,
+ * });
+ * ```
+ */
+export function computeDeviceAdapter(config = {}) {
+    const { tokenPrefix = 'qwf_dev', requireHostname = false, allowedOS, } = config;
+    return {
+        name: 'compute',
+        tokenPrefix,
+        validateDeviceInput(input) {
+            const errors = [];
+            const metadata = input.metadata;
+            // Validate name
+            if (!input.name || input.name.trim().length === 0) {
+                errors.push('Device name is required');
+            }
+            if (input.name && input.name.length > 255) {
+                errors.push('Device name must be 255 characters or less');
+            }
+            // Validate hostname if required
+            if (requireHostname && (!metadata?.hostname || metadata.hostname.trim().length === 0)) {
+                errors.push('Hostname is required for compute devices');
+            }
+            // Validate OS if allowedOS is specified
+            if (allowedOS && metadata?.os) {
+                if (!allowedOS.includes(metadata.os)) {
+                    errors.push(`OS '${metadata.os}' is not allowed. Allowed: ${allowedOS.join(', ')}`);
+                }
+            }
+            // Validate architecture
+            if (metadata?.arch) {
+                const validArchs = ['x64', 'arm64', 'ia32', 'arm'];
+                if (!validArchs.includes(metadata.arch)) {
+                    errors.push(`Invalid architecture '${metadata.arch}'. Valid: ${validArchs.join(', ')}`);
+                }
+            }
+            return {
+                valid: errors.length === 0,
+                errors: errors.length > 0 ? errors : undefined,
+            };
+        },
+        transformForStorage(input) {
+            const metadata = (input.metadata || {});
+            // Ensure compute-specific defaults
+            return {
+                hostname: metadata.hostname || null,
+                os: metadata.os || null,
+                os_version: metadata.os_version || null,
+                arch: metadata.arch || null,
+                cli_capabilities: metadata.cli_capabilities || [],
+                container_id: metadata.container_id || null,
+                node_version: metadata.node_version || null,
+            };
+        },
+        transformFromStorage(row) {
+            const metadata = (row.metadata || {});
+            // Extract compute-specific fields from metadata
+            return {
+                hostname: metadata.hostname,
+                os: metadata.os,
+                os_version: metadata.os_version,
+                arch: metadata.arch,
+                cli_capabilities: metadata.cli_capabilities || [],
+                container_id: metadata.container_id,
+                node_version: metadata.node_version,
+            };
+        },
+        async onDeviceCreated(device) {
+            // Optional: Log device creation, send notifications, etc.
+            console.log(`[ComputeAdapter] Device created: ${device.name} (${device.id})`);
+        },
+        async onDeviceDeleted(device) {
+            // Optional: Cleanup, revoke certificates, etc.
+            console.log(`[ComputeAdapter] Device deleted: ${device.name} (${device.id})`);
+        },
+        async onDeviceVerified(device, ip) {
+            // Optional: Log device verification, track activity
+            console.log(`[ComputeAdapter] Device verified: ${device.name} from ${ip || 'unknown'}`);
+        },
+    };
+}
+//# sourceMappingURL=compute-adapter.js.map

package/dist/plugins/devices/adapters/compute-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-adapter.js","sourceRoot":"","sources":["../../../../src/plugins/devices/adapters/compute-adapter.ts"],"names":[],"mappings":"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"}

package/dist/plugins/devices/adapters/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Device Adapters
+ *
+ * Export all built-in device adapters.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export { computeDeviceAdapter } from './compute-adapter.js';
+export type { ComputeAdapterConfig } from './compute-adapter.js';
+export { mobileDeviceAdapter } from './mobile-adapter.js';
+export type { MobileAdapterConfig } from './mobile-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/devices/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/devices/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/plugins/devices/adapters/index.js

@@ -0,0 +1,10 @@
+/**
+ * Device Adapters
+ *
+ * Export all built-in device adapters.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export { computeDeviceAdapter } from './compute-adapter.js';
+export { mobileDeviceAdapter } from './mobile-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/plugins/devices/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/devices/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/plugins/devices/adapters/mobile-adapter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Mobile Device Adapter
+ *
+ * Adapter for mobile devices (phones, tablets).
+ * Used by QwickBot for mobile app device management.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { DeviceAdapter } from '../types.js';
+/**
+ * Mobile adapter configuration
+ */
+export interface MobileAdapterConfig {
+    /** Token prefix (default: 'qwb_mob') */
+    tokenPrefix?: string;
+    /** Require device model in metadata */
+    requireDeviceModel?: boolean;
+    /** Require app version in metadata */
+    requireAppVersion?: boolean;
+    /** Allowed OS names (optional, allows all if not specified) */
+    allowedOS?: string[];
+    /** Minimum app version (optional, uses semver) */
+    minAppVersion?: string;
+}
+/**
+ * Create a mobile device adapter
+ *
+ * @param config - Adapter configuration
+ * @returns DeviceAdapter for mobile devices
+ *
+ * @example
+ * ```ts
+ * const adapter = mobileDeviceAdapter({
+ *   tokenPrefix: 'qwb_mob',
+ *   requireDeviceModel: true,
+ *   allowedOS: ['iOS', 'Android'],
+ * });
+ * ```
+ */
+export declare function mobileDeviceAdapter(config?: MobileAdapterConfig): DeviceAdapter;
+//# sourceMappingURL=mobile-adapter.d.ts.map

package/dist/plugins/devices/adapters/mobile-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-adapter.d.ts","sourceRoot":"","sources":["../../../../src/plugins/devices/adapters/mobile-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EAKd,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAkBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,mBAAwB,GAAG,aAAa,CAkHnF"}

package/dist/plugins/devices/adapters/mobile-adapter.js

@@ -0,0 +1,131 @@
+/**
+ * Mobile Device Adapter
+ *
+ * Adapter for mobile devices (phones, tablets).
+ * Used by QwickBot for mobile app device management.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Compare semver versions (simplified)
+ */
+function compareSemver(v1, v2) {
+    const parts1 = v1.split('.').map(Number);
+    const parts2 = v2.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const p1 = parts1[i] || 0;
+        const p2 = parts2[i] || 0;
+        if (p1 > p2)
+            return 1;
+        if (p1 < p2)
+            return -1;
+    }
+    return 0;
+}
+/**
+ * Create a mobile device adapter
+ *
+ * @param config - Adapter configuration
+ * @returns DeviceAdapter for mobile devices
+ *
+ * @example
+ * ```ts
+ * const adapter = mobileDeviceAdapter({
+ *   tokenPrefix: 'qwb_mob',
+ *   requireDeviceModel: true,
+ *   allowedOS: ['iOS', 'Android'],
+ * });
+ * ```
+ */
+export function mobileDeviceAdapter(config = {}) {
+    const { tokenPrefix = 'qwb_mob', requireDeviceModel = false, requireAppVersion = false, allowedOS, minAppVersion, } = config;
+    return {
+        name: 'mobile',
+        tokenPrefix,
+        validateDeviceInput(input) {
+            const errors = [];
+            const metadata = input.metadata;
+            // Validate name
+            if (!input.name || input.name.trim().length === 0) {
+                errors.push('Device name is required');
+            }
+            if (input.name && input.name.length > 255) {
+                errors.push('Device name must be 255 characters or less');
+            }
+            // Validate device model if required
+            if (requireDeviceModel && (!metadata?.device_model || metadata.device_model.trim().length === 0)) {
+                errors.push('Device model is required for mobile devices');
+            }
+            // Validate app version if required
+            if (requireAppVersion && (!metadata?.app_version || metadata.app_version.trim().length === 0)) {
+                errors.push('App version is required for mobile devices');
+            }
+            // Validate OS if allowedOS is specified
+            if (allowedOS && metadata?.os_name) {
+                if (!allowedOS.includes(metadata.os_name)) {
+                    errors.push(`OS '${metadata.os_name}' is not supported. Supported: ${allowedOS.join(', ')}`);
+                }
+            }
+            // Validate minimum app version
+            if (minAppVersion && metadata?.app_version) {
+                if (compareSemver(metadata.app_version, minAppVersion) < 0) {
+                    errors.push(`App version ${metadata.app_version} is below minimum required version ${minAppVersion}`);
+                }
+            }
+            // Validate screen dimensions if provided
+            if (metadata?.screen_width !== undefined && metadata.screen_width <= 0) {
+                errors.push('Screen width must be a positive number');
+            }
+            if (metadata?.screen_height !== undefined && metadata.screen_height <= 0) {
+                errors.push('Screen height must be a positive number');
+            }
+            return {
+                valid: errors.length === 0,
+                errors: errors.length > 0 ? errors : undefined,
+            };
+        },
+        transformForStorage(input) {
+            const metadata = (input.metadata || {});
+            // Ensure mobile-specific defaults
+            return {
+                device_model: metadata.device_model || null,
+                os_name: metadata.os_name || null,
+                os_version: metadata.os_version || null,
+                app_version: metadata.app_version || null,
+                push_token: metadata.push_token || null,
+                screen_width: metadata.screen_width || null,
+                screen_height: metadata.screen_height || null,
+            };
+        },
+        transformFromStorage(row) {
+            const metadata = (row.metadata || {});
+            // Extract mobile-specific fields from metadata
+            return {
+                device_model: metadata.device_model,
+                os_name: metadata.os_name,
+                os_version: metadata.os_version,
+                app_version: metadata.app_version,
+                push_token: metadata.push_token,
+                screen_width: metadata.screen_width,
+                screen_height: metadata.screen_height,
+            };
+        },
+        async onDeviceCreated(device) {
+            // Optional: Log device creation, track in analytics, etc.
+            console.log(`[MobileAdapter] Device registered: ${device.name} (${device.id})`);
+        },
+        async onDeviceDeleted(device) {
+            // Optional: Unregister push token, cleanup, etc.
+            const metadata = device.metadata;
+            if (metadata?.push_token) {
+                console.log(`[MobileAdapter] Should unregister push token for device: ${device.id}`);
+            }
+            console.log(`[MobileAdapter] Device deleted: ${device.name} (${device.id})`);
+        },
+        async onDeviceVerified(device, ip) {
+            // Optional: Log device verification, track activity
+            console.log(`[MobileAdapter] Device verified: ${device.name} from ${ip || 'unknown'}`);
+        },
+    };
+}
+//# sourceMappingURL=mobile-adapter.js.map

package/dist/plugins/devices/adapters/mobile-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-adapter.js","sourceRoot":"","sources":["../../../../src/plugins/devices/adapters/mobile-adapter.ts"],"names":[],"mappings":"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"}

package/dist/plugins/devices/devices-plugin.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Devices Plugin
+ *
+ * Device management plugin for @qwickapps/server.
+ * Supports different device types through adapters (compute, mobile, IoT).
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { Plugin } from '../../core/plugin-registry.js';
+import type { DevicesPluginConfig, DeviceStore, DeviceAdapter, Device, DeviceWithToken, CreateDeviceInput, UpdateDeviceInput, TokenVerificationResult } from './types.js';
+/**
+ * Create the Devices plugin
+ */
+export declare function createDevicesPlugin(config: DevicesPluginConfig): Plugin;
+/**
+ * Get the current device store instance
+ */
+export declare function getDeviceStore(): DeviceStore | null;
+/**
+ * Get the current device adapter instance
+ */
+export declare function getDeviceAdapter(): DeviceAdapter | null;
+/**
+ * Register a new device
+ */
+export declare function registerDevice(input: CreateDeviceInput): Promise<DeviceWithToken>;
+/**
+ * Verify a device token
+ */
+export declare function verifyDeviceToken(token: string, clientIp?: string): Promise<TokenVerificationResult>;
+/**
+ * Get a device by ID
+ */
+export declare function getDeviceById(id: string): Promise<Device | null>;
+/**
+ * Update a device
+ */
+export declare function updateDevice(id: string, input: UpdateDeviceInput): Promise<Device | null>;
+/**
+ * Delete a device
+ */
+export declare function deleteDevice(id: string): Promise<boolean>;
+/**
+ * Regenerate token for a device
+ */
+export declare function regenerateToken(deviceId: string, validityDays?: number): Promise<{
+    token: string;
+    expiresAt: Date;
+} | null>;
+/**
+ * List devices for a user
+ */
+export declare function listUserDevices(userId: string): Promise<Device[]>;
+/**
+ * List devices for an organization
+ */
+export declare function listOrgDevices(orgId: string): Promise<Device[]>;
+/**
+ * Deactivate a device
+ */
+export declare function deactivateDevice(id: string): Promise<boolean>;
+/**
+ * Activate a device
+ */
+export declare function activateDevice(id: string): Promise<boolean>;
+/**
+ * Cleanup expired device tokens
+ */
+export declare function cleanupExpiredTokens(): Promise<number>;
+//# sourceMappingURL=devices-plugin.d.ts.map