@cmdoss/memwal-sdk 0.6.0

package/dist/core/interfaces/IService.d.ts.map

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

package/dist/core/interfaces/IService.js

@@ -0,0 +1,159 @@
+/**
+ * Base Service Interface
+ *
+ * Defines the standard interface that all services in the PDW SDK should implement.
+ * Provides consistent lifecycle management, error handling, logging, and metrics.
+ */
+/**
+ * Service lifecycle states
+ */
+export var ServiceState;
+(function (ServiceState) {
+    ServiceState["UNINITIALIZED"] = "uninitialized";
+    ServiceState["INITIALIZING"] = "initializing";
+    ServiceState["READY"] = "ready";
+    ServiceState["ERROR"] = "error";
+    ServiceState["DESTROYED"] = "destroyed";
+})(ServiceState || (ServiceState = {}));
+/**
+ * Default console logger implementation
+ */
+export class ConsoleLogger {
+    constructor(serviceName, debugEnabled = false) {
+        this.serviceName = serviceName;
+        this.debugEnabled = debugEnabled;
+    }
+    debug(message, context) {
+        if (this.debugEnabled) {
+            console.debug(`[${this.serviceName}] ${message}`, context || '');
+        }
+    }
+    info(message, context) {
+        console.log(`[${this.serviceName}] ${message}`, context || '');
+    }
+    warn(message, context) {
+        console.warn(`[${this.serviceName}] ${message}`, context || '');
+    }
+    error(message, error, context) {
+        console.error(`[${this.serviceName}] ${message}`, error, context || '');
+    }
+}
+/**
+ * Abstract base service class with common functionality
+ */
+export class BaseService {
+    constructor(config) {
+        this.config = config;
+        this._state = ServiceState.UNINITIALIZED;
+        this._logger = config.logger || new ConsoleLogger(config.name || this.constructor.name, config.debug || false);
+        this._startTime = Date.now();
+        this._metrics = {
+            operationCount: 0,
+            errorCount: 0,
+            averageDuration: 0,
+            uptime: 0,
+            custom: {},
+        };
+    }
+    get name() {
+        return this.config.name || this.constructor.name;
+    }
+    get state() {
+        return this._state;
+    }
+    async initialize() {
+        if (this._state !== ServiceState.UNINITIALIZED) {
+            this._logger.warn('Service already initialized', { state: this._state });
+            return;
+        }
+        this._state = ServiceState.INITIALIZING;
+        this._logger.info('Initializing service...');
+        try {
+            await this.onInitialize();
+            this._state = ServiceState.READY;
+            this._logger.info('Service initialized successfully');
+        }
+        catch (error) {
+            this._state = ServiceState.ERROR;
+            this._logger.error('Service initialization failed', error);
+            throw error;
+        }
+    }
+    async destroy() {
+        this._logger.info('Destroying service...');
+        try {
+            await this.onDestroy();
+            this._state = ServiceState.DESTROYED;
+            this._logger.info('Service destroyed successfully');
+        }
+        catch (error) {
+            this._logger.error('Service destruction failed', error);
+            throw error;
+        }
+    }
+    async reset() {
+        this._logger.info('Resetting service...');
+        try {
+            await this.onReset();
+            this._metrics = {
+                operationCount: 0,
+                errorCount: 0,
+                averageDuration: 0,
+                uptime: 0,
+                custom: {},
+            };
+            this._logger.info('Service reset successfully');
+        }
+        catch (error) {
+            this._logger.error('Service reset failed', error);
+            throw error;
+        }
+    }
+    async getHealth() {
+        return {
+            healthy: this._state === ServiceState.READY,
+            state: this._state,
+            timestamp: Date.now(),
+            details: {
+                uptime: Date.now() - this._startTime,
+                operationCount: this._metrics.operationCount,
+                errorCount: this._metrics.errorCount,
+            },
+        };
+    }
+    getMetrics() {
+        return {
+            ...this._metrics,
+            uptime: Date.now() - this._startTime,
+        };
+    }
+    /**
+     * Track an operation for metrics
+     */
+    async trackOperation(operationName, operation) {
+        const startTime = performance.now();
+        try {
+            this._logger.debug(`Starting operation: ${operationName}`);
+            const result = await operation();
+            const duration = performance.now() - startTime;
+            this.updateMetrics(duration);
+            this._logger.debug(`Completed operation: ${operationName}`, { duration });
+            return result;
+        }
+        catch (error) {
+            this._metrics.errorCount++;
+            this._logger.error(`Operation failed: ${operationName}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Update metrics with operation duration
+     */
+    updateMetrics(duration) {
+        this._metrics.operationCount++;
+        // Calculate rolling average
+        const totalDuration = this._metrics.averageDuration * (this._metrics.operationCount - 1);
+        this._metrics.averageDuration = (totalDuration + duration) / this._metrics.operationCount;
+    }
+}
+//# sourceMappingURL=IService.js.map

package/dist/core/interfaces/IService.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Core Interfaces - Barrel Export
+ *
+ * Exports all core interfaces and base classes for the PDW SDK.
+ */
+export * from './IService';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/interfaces/index.d.ts.map

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

package/dist/core/interfaces/index.js

@@ -0,0 +1,7 @@
+/**
+ * Core Interfaces - Barrel Export
+ *
+ * Exports all core interfaces and base classes for the PDW SDK.
+ */
+export * from './IService.js';
+//# sourceMappingURL=index.js.map

package/dist/core/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC"}

package/dist/core/types/capability.d.ts

@@ -0,0 +1,268 @@
+/**
+ * Capability-Based Architecture Types for Personal Data Wallet SDK
+ *
+ * This module defines the TypeScript interfaces for the new capability-based
+ * access control system following SEAL PrivateData pattern.
+ *
+ * Key concepts:
+ * - MemoryCap: Capability object for app context access
+ * - Object ownership = access permission (SEAL idiomatic)
+ * - Transfer capability = share access
+ * - Burn capability = revoke access
+ *
+ * @see CAPABILITY-ARCHITECTURE-SUMMARY.md
+ */
+/**
+ * Memory capability object - core unit of access control
+ *
+ * Owns this object = can decrypt memories for this app context
+ * Can be transferred to share access with others
+ * Burn to permanently revoke access
+ */
+export interface MemoryCap {
+    /** Sui object ID of the capability */
+    id: string;
+    /** Random nonce for SEAL key derivation */
+    nonce: string;
+    /** Application context identifier (e.g., "MEMO", "HEALTH") */
+    appId: string;
+    /** Owner address (who can call seal_approve) */
+    owner: string;
+    /** Creation timestamp (epoch) */
+    createdAt?: number;
+}
+/**
+ * Options for creating a new MemoryCap
+ */
+export interface CreateMemoryCapOptions {
+    /** Application identifier (e.g., "MEMO", "HEALTH") */
+    appId: string;
+}
+/**
+ * Options for transferring a MemoryCap
+ */
+export interface TransferCapOptions {
+    /** Object ID of the capability to transfer */
+    capId: string;
+    /** Recipient address */
+    recipient: string;
+}
+/**
+ * Options for burning (revoking) a MemoryCap
+ */
+export interface BurnCapOptions {
+    /** Object ID of the capability to burn */
+    capId: string;
+}
+/**
+ * Options for SEAL approval
+ */
+export interface SealApproveOptions {
+    /** Reference to the MemoryCap object */
+    capId: string;
+    /** SEAL key ID to validate */
+    keyId: string;
+}
+/**
+ * Result of querying user's capabilities
+ */
+export interface MemoryCapList {
+    /** All capabilities owned by the user */
+    capabilities: MemoryCap[];
+    /** Total count */
+    count: number;
+}
+/**
+ * Options for filtering capabilities
+ */
+export interface ListCapsOptions {
+    /** Filter by specific app ID */
+    appId?: string;
+    /** User address (defaults to current signer) */
+    userAddress?: string;
+}
+/**
+ * Options for getting or creating a capability
+ */
+export interface GetOrCreateCapOptions {
+    /** Application identifier */
+    appId: string;
+    /** User address (defaults to current signer) */
+    userAddress?: string;
+}
+/**
+ * Event emitted when capability is created
+ */
+export interface MemoryCapCreatedEvent {
+    capId: string;
+    owner: string;
+    appId: string;
+    nonce: string;
+    createdAt: number;
+}
+/**
+ * Event emitted when capability is transferred
+ */
+export interface MemoryCapTransferredEvent {
+    capId: string;
+    from: string;
+    to: string;
+    appId: string;
+}
+/**
+ * Event emitted when capability is burned
+ */
+export interface MemoryCapBurnedEvent {
+    capId: string;
+    owner: string;
+    appId: string;
+}
+/**
+ * Options for computing SEAL key ID
+ */
+export interface ComputeKeyIdOptions {
+    /** Owner address */
+    owner: string;
+    /** Nonce from capability */
+    nonce: string;
+}
+/**
+ * Capability namespace for SimplePDWClient
+ * Provides methods for managing MemoryCap objects
+ */
+export interface CapabilityNamespace {
+    /**
+     * Create a new MemoryCap for an app context
+     * @param appId Application identifier
+     * @returns Created capability
+     */
+    create(appId: string): Promise<MemoryCap>;
+    /**
+     * Get an existing capability by app ID
+     * @param appId Application identifier
+     * @returns Capability or null if not found
+     */
+    get(appId: string): Promise<MemoryCap | null>;
+    /**
+     * Get or create a capability for an app context
+     * @param appId Application identifier
+     * @returns Existing or newly created capability
+     */
+    getOrCreate(appId: string): Promise<MemoryCap>;
+    /**
+     * List all capabilities owned by the user
+     * @param options Optional filter options
+     * @returns List of capabilities
+     */
+    list(options?: ListCapsOptions): Promise<MemoryCap[]>;
+    /**
+     * Transfer a capability to another address
+     * @param capId Capability object ID
+     * @param recipient Recipient address
+     */
+    transfer(capId: string, recipient: string): Promise<void>;
+    /**
+     * Burn (revoke) a capability
+     * @param capId Capability object ID
+     */
+    burn(capId: string): Promise<void>;
+    /**
+     * Compute SEAL key ID for a capability
+     * @param cap Capability object
+     * @returns Key ID bytes as hex string
+     */
+    computeKeyId(cap: MemoryCap): string;
+}
+/**
+ * Context namespace for SimplePDWClient
+ * Higher-level abstraction over capabilities
+ */
+export interface ContextNamespace {
+    /**
+     * Create a new context (creates MemoryCap)
+     * @param appId Application identifier
+     * @returns Created capability
+     */
+    create(appId: string): Promise<MemoryCap>;
+    /**
+     * Get context by app ID
+     * @param appId Application identifier
+     * @returns Capability or null
+     */
+    get(appId: string): Promise<MemoryCap | null>;
+    /**
+     * Get or create context
+     * @param appId Application identifier
+     * @returns Existing or new capability
+     */
+    getOrCreate(appId: string): Promise<MemoryCap>;
+    /**
+     * List all contexts for user
+     * @returns List of capabilities
+     */
+    list(): Promise<MemoryCap[]>;
+    /**
+     * Delete a context (burns capability)
+     * @param appId Application identifier
+     */
+    delete(appId: string): Promise<void>;
+    /**
+     * Transfer context to another user
+     * @param appId Application identifier
+     * @param recipient Recipient address
+     */
+    transfer(appId: string, recipient: string): Promise<void>;
+}
+/**
+ * Wallet namespace for SimplePDWClient
+ * Simplified wallet operations (no HD wallet complexity)
+ */
+export interface WalletNamespace {
+    /**
+     * Get current wallet address
+     * @returns Wallet address
+     */
+    getAddress(): Promise<string>;
+    /**
+     * Check if wallet is connected/ready
+     * @returns Connection status
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * Get all owned objects of a specific type
+     * @param structType Move struct type
+     * @returns List of objects
+     */
+    getOwnedObjects<T>(structType: string): Promise<T[]>;
+}
+/**
+ * Memory creation options with capability
+ */
+export interface CreateMemoryWithCapOptions {
+    /** Capability to use for access control */
+    cap: MemoryCap;
+    /** Memory content */
+    content: string;
+    /** Memory category */
+    category: string;
+    /** Optional topic */
+    topic?: string;
+    /** Importance level 1-10 */
+    importance?: number;
+    /** Custom metadata */
+    customMetadata?: Record<string, string>;
+}
+/**
+ * Memory query options with context filtering
+ */
+export interface QueryMemoriesOptions {
+    /** User address */
+    userAddress: string;
+    /** Filter by app context (app_id) */
+    appId?: string;
+    /** Filter by category */
+    category?: string;
+    /** Maximum results */
+    limit?: number;
+}
+//# sourceMappingURL=capability.d.ts.map

package/dist/core/types/capability.d.ts.map

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

package/dist/core/types/capability.js

@@ -0,0 +1,16 @@
+/**
+ * Capability-Based Architecture Types for Personal Data Wallet SDK
+ *
+ * This module defines the TypeScript interfaces for the new capability-based
+ * access control system following SEAL PrivateData pattern.
+ *
+ * Key concepts:
+ * - MemoryCap: Capability object for app context access
+ * - Object ownership = access permission (SEAL idiomatic)
+ * - Transfer capability = share access
+ * - Burn capability = revoke access
+ *
+ * @see CAPABILITY-ARCHITECTURE-SUMMARY.md
+ */
+export {};
+//# sourceMappingURL=capability.js.map

package/dist/core/types/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../../../src/core/types/capability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}