@cmdoss/memwal-sdk 0.6.0

package/dist/embedding/types.d.ts

@@ -0,0 +1,302 @@
+/**
+ * Advanced Embedding Types for PDW SDK
+ *
+ * Comprehensive type definitions for vector embedding operations,
+ * HNSW indexing, and AI-powered similarity search.
+ */
+export interface VectorEmbedding {
+    vector: number[];
+    dimension: number;
+    model: string;
+    metadata?: {
+        contentType?: string;
+        category?: string;
+        timestamp?: number;
+        source?: string;
+    };
+}
+export interface EmbeddingConfig {
+    apiKey: string;
+    model?: string;
+    dimensions?: number;
+    requestsPerMinute?: number;
+}
+export interface EmbeddingOptions {
+    text: string;
+    type?: 'content' | 'metadata' | 'query';
+    taskType?: 'RETRIEVAL_QUERY' | 'RETRIEVAL_DOCUMENT' | 'SEMANTIC_SIMILARITY';
+}
+export interface EmbeddingResult {
+    vector: number[];
+    dimension: number;
+    model: string;
+    processingTime: number;
+    tokenCount?: number;
+}
+export interface BatchEmbeddingResult {
+    vectors: number[][];
+    dimension: number;
+    model: string;
+    totalProcessingTime: number;
+    averageProcessingTime: number;
+    successCount: number;
+    failedCount: number;
+}
+export interface HNSWIndexConfig {
+    dimension: number;
+    maxElements?: number;
+    efConstruction?: number;
+    m?: number;
+    randomSeed?: number;
+    spaceType?: 'cosine' | 'l2' | 'ip';
+}
+export interface HNSWIndexEntry {
+    id: number;
+    vector: number[];
+    metadata?: Record<string, any>;
+}
+export interface HNSWSearchResult {
+    ids: number[];
+    distances: number[];
+    similarities?: number[];
+}
+export interface HNSWSearchOptions {
+    k?: number;
+    efSearch?: number;
+    filter?: (metadata: any) => boolean;
+}
+export interface BatchConfig {
+    maxBatchSize?: number;
+    batchDelayMs?: number;
+    maxCacheSize?: number;
+    cacheTtlMs?: number;
+}
+export interface BatchJob {
+    userAddress: string;
+    vectors: Map<number, number[]>;
+    scheduledAt: Date;
+    metadata?: Map<number, any>;
+}
+export interface BatchStats {
+    totalUsers: number;
+    totalPendingVectors: number;
+    activeBatchJobs: number;
+    cacheHitRate: number;
+    averageBatchSize: number;
+    averageProcessingTime: number;
+}
+export interface Entity {
+    id: string;
+    label: string;
+    type: string;
+    confidence?: number;
+    properties?: Record<string, any>;
+}
+export interface Relationship {
+    id: string;
+    source: string;
+    target: string;
+    type: string;
+    label: string;
+    confidence?: number;
+    properties?: Record<string, any>;
+}
+export interface KnowledgeGraph {
+    entities: Entity[];
+    relationships: Relationship[];
+    metadata?: {
+        version: number;
+        lastUpdated: Date;
+        totalEntities: number;
+        totalRelationships: number;
+    };
+}
+export interface GraphExtractionResult {
+    entities: Entity[];
+    relationships: Relationship[];
+    processingTime: number;
+    confidence: number;
+}
+export interface Memory {
+    id: string;
+    content: string;
+    category?: string;
+    createdAt?: Date;
+    userId?: string;
+    metadata?: Record<string, any>;
+    tags?: string[];
+    embeddings?: number[];
+}
+export interface ProcessedMemory extends Memory {
+    embedding?: number[];
+    embeddingModel?: string;
+    processedAt?: Date;
+    vectorId?: number;
+    blobId?: string;
+    encryptionKeyId?: string;
+}
+export interface MemoryPipelineConfig {
+    enableClassification?: boolean;
+    enableEmbeddings?: boolean;
+    enableGraphExtraction?: boolean;
+    enableEncryption?: boolean;
+    batchConfig?: BatchConfig;
+    embeddingConfig?: EmbeddingConfig;
+}
+export interface MemoryPipelineResult {
+    success: boolean;
+    memoryId?: string;
+    vectorId?: number;
+    blobId?: string;
+    embeddingBlobId?: string;
+    graphBlobId?: string;
+    processingStats: {
+        totalTime: number;
+        classificationTime: number;
+        embeddingTime: number;
+        indexingTime: number;
+        graphTime: number;
+        encryptionTime: number;
+        storageTime: number;
+    };
+    errors?: string[];
+}
+export interface EnhancedStorageMetadata {
+    contentType: string;
+    contentSize: number;
+    contentHash: string;
+    category: string;
+    topic?: string;
+    importance?: number;
+    embeddingBlobId?: string;
+    embeddingDimension?: number;
+    hasKnowledgeGraph?: boolean;
+    graphBlobId?: string;
+    createdTimestamp: number;
+    updatedTimestamp?: number;
+    customMetadata?: Record<string, string>;
+}
+export interface MetadataSearchOptions {
+    query: string;
+    threshold?: number;
+    limit?: number;
+    category?: string;
+    minImportance?: number;
+    timeRange?: {
+        start?: Date;
+        end?: Date;
+    };
+}
+export interface MetadataSearchResult {
+    blobId: string;
+    content?: string;
+    metadata: EnhancedStorageMetadata;
+    similarity: number;
+    rank: number;
+}
+export interface VectorSearchOptions {
+    queryVector: number[];
+    userAddress: string;
+    k?: number;
+    efSearch?: number;
+    category?: string;
+    minSimilarity?: number;
+    includeMetadata?: boolean;
+    timeFilter?: {
+        start?: Date;
+        end?: Date;
+    };
+}
+export interface VectorSearchMatch {
+    memoryId: string;
+    vectorId: number;
+    similarity: number;
+    distance: number;
+    embedding?: VectorEmbedding;
+    metadata?: any;
+}
+export interface VectorSearchResult {
+    results: VectorSearchMatch[];
+    searchStats: {
+        searchTime: number;
+        nodesVisited: number;
+        exactMatches: number;
+        approximateMatches: number;
+        cacheHits: number;
+        indexSize: number;
+    };
+}
+export interface EmbeddingError extends Error {
+    code: 'API_ERROR' | 'RATE_LIMIT' | 'INVALID_INPUT' | 'DIMENSION_MISMATCH' | 'NETWORK_ERROR';
+    details?: any;
+}
+export interface VectorError extends Error {
+    code: 'INDEX_ERROR' | 'SEARCH_ERROR' | 'STORAGE_ERROR' | 'VALIDATION_ERROR';
+    details?: any;
+}
+export type VectorDistance = 'cosine' | 'euclidean' | 'manhattan' | 'dot_product';
+export type EmbeddingModel = 'text-embedding-004' | 'text-embedding-3-large' | 'text-embedding-3-small';
+export type ProcessingStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled';
+export interface ConfigValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface MemoryBatchResult {
+    success: boolean;
+    processedCount: number;
+    failedCount: number;
+    totalTime: number;
+    averageTime: number;
+    errors?: string[];
+    results: MemoryPipelineResult[];
+}
+export interface MemoryMetadata {
+    id: string;
+    category: string;
+    importance?: number;
+    tags?: string[];
+    topic?: string;
+    createdAt: Date;
+    updatedAt?: Date;
+    size: number;
+    embeddingModel?: string;
+    vectorId?: number;
+    customFields?: Record<string, any>;
+}
+export interface SimilarityResult {
+    id: string;
+    similarity: number;
+    distance: number;
+    metadata?: any;
+}
+export interface VectorOperationResult {
+    success: boolean;
+    vectorId?: number;
+    operation: 'add' | 'update' | 'delete' | 'search';
+    processingTime: number;
+    error?: string;
+}
+export interface VectorStats {
+    totalVectors: number;
+    dimension: number;
+    avgSimilarity: number;
+    indexSize: number;
+    lastUpdated: Date;
+}
+export interface IndexStats {
+    totalEntries: number;
+    dimension: number;
+    memoryUsage: number;
+    searchPerformance: {
+        avgSearchTime: number;
+        avgNodesVisited: number;
+    };
+}
+export interface VectorSearchStats {
+    searchTime: number;
+    nodesVisited: number;
+    cacheHits: number;
+    totalResults: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/embedding/types.d.ts.map

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

package/dist/embedding/types.js

@@ -0,0 +1,9 @@
+/**
+ * Advanced Embedding Types for PDW SDK
+ *
+ * Comprehensive type definitions for vector embedding operations,
+ * HNSW indexing, and AI-powered similarity search.
+ */
+export {};
+// Note: Using individual named exports instead of default export
+//# sourceMappingURL=types.js.map

package/dist/embedding/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/embedding/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;AAgWH,iEAAiE"}

package/dist/encryption/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Encryption Module - DEPRECATED
+ *
+ * ⚠️ DEPRECATION NOTICE:
+ * This directory is deprecated. Use services/EncryptionService instead.
+ *
+ * Migration Guide:
+ * - EncryptionService → services/EncryptionService
+ *
+ * This export is maintained for backward compatibility only.
+ */
+export { EncryptionService } from '../services/EncryptionService';
+export type { AccessGrantOptions, AccessRevokeOptions } from '../services/EncryptionService';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/encryption/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,+BAA+B,CAAC"}

package/dist/encryption/index.js

@@ -0,0 +1,14 @@
+/**
+ * Encryption Module - DEPRECATED
+ *
+ * ⚠️ DEPRECATION NOTICE:
+ * This directory is deprecated. Use services/EncryptionService instead.
+ *
+ * Migration Guide:
+ * - EncryptionService → services/EncryptionService
+ *
+ * This export is maintained for backward compatibility only.
+ */
+// Re-export from production location
+export { EncryptionService } from '../services/EncryptionService.js';
+//# sourceMappingURL=index.js.map

package/dist/encryption/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/encryption/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qCAAqC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Error Handling System for Personal Data Wallet SDK
+ *
+ * Provides structured error types, validation, and user-friendly messages
+ * for all SDK operations including blockchain, storage, and encryption errors.
+ */
+/**
+ * Base error class for all Personal Data Wallet SDK errors
+ */
+export declare abstract class PDWError extends Error {
+    readonly code: string;
+    readonly category: ErrorCategory;
+    readonly severity: ErrorSeverity;
+    readonly context?: Record<string, any>;
+    readonly timestamp: Date;
+    readonly originalError?: Error;
+    constructor(message: string, code: string, category: ErrorCategory, severity?: ErrorSeverity, context?: Record<string, any>, originalError?: Error);
+    /**
+     * Convert error to a structured object for logging/reporting
+     */
+    toObject(): ErrorObject;
+    /**
+     * Get user-friendly error message
+     */
+    getUserMessage(): string;
+    /**
+     * Check if error is retryable
+     */
+    isRetryable(): boolean;
+}
+export type ErrorCategory = 'validation' | 'blockchain' | 'storage' | 'encryption' | 'network' | 'configuration' | 'authentication' | 'permission';
+export type ErrorSeverity = 'info' | 'warning' | 'error' | 'critical';
+export interface ErrorObject {
+    name: string;
+    message: string;
+    code: string;
+    category: ErrorCategory;
+    severity: ErrorSeverity;
+    context?: Record<string, any>;
+    timestamp: string;
+    stack?: string;
+    originalError?: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+}
+export declare class ValidationError extends PDWError {
+    constructor(message: string, field?: string, value?: any, originalError?: Error);
+}
+export declare class ConfigurationError extends PDWError {
+    constructor(message: string, configKey?: string, originalError?: Error);
+}
+export declare class InvalidParameterError extends PDWError {
+    constructor(parameter: string, expected: string, received: any);
+}
+export declare class MissingParameterError extends PDWError {
+    constructor(parameter: string);
+}
+export declare class BlockchainError extends PDWError {
+    constructor(message: string, code: string, context?: Record<string, any>, originalError?: Error);
+}
+export declare class TransactionError extends BlockchainError {
+    constructor(message: string, transactionId?: string, originalError?: Error);
+}
+export declare class InsufficientGasError extends BlockchainError {
+    constructor(required: number, available: number);
+}
+export declare class ContractExecutionError extends BlockchainError {
+    constructor(contractFunction: string, reason: string, originalError?: Error);
+}
+export declare class ObjectNotFoundError extends BlockchainError {
+    constructor(objectId: string, objectType?: string);
+}
+export declare class StorageError extends PDWError {
+    constructor(message: string, code: string, context?: Record<string, any>, originalError?: Error);
+}
+export declare class WalrusError extends StorageError {
+    constructor(message: string, blobId?: string, originalError?: Error);
+}
+export declare class StorageUploadError extends StorageError {
+    constructor(reason: string, fileSize?: number, originalError?: Error);
+}
+export declare class StorageRetrievalError extends StorageError {
+    constructor(blobId: string, reason: string, originalError?: Error);
+}
+export declare class StorageQuotaExceededError extends StorageError {
+    constructor(currentUsage: number, limit: number);
+}
+export declare class EncryptionError extends PDWError {
+    constructor(message: string, code: string, context?: Record<string, any>, originalError?: Error);
+}
+export declare class SealInitializationError extends EncryptionError {
+    constructor(reason: string, originalError?: Error);
+}
+export declare class EncryptionFailedError extends EncryptionError {
+    constructor(userAddress: string, reason: string, originalError?: Error);
+}
+export declare class DecryptionFailedError extends EncryptionError {
+    constructor(reason: string, contentId?: string, originalError?: Error);
+}
+export declare class AccessDeniedError extends EncryptionError {
+    constructor(userAddress: string, contentId: string, reason?: string);
+}
+export declare class SessionKeyError extends EncryptionError {
+    constructor(operation: string, reason: string, originalError?: Error);
+}
+export declare class NetworkError extends PDWError {
+    constructor(message: string, code: string, context?: Record<string, any>, originalError?: Error);
+}
+export declare class ConnectionError extends NetworkError {
+    constructor(endpoint: string, originalError?: Error);
+}
+export declare class TimeoutError extends NetworkError {
+    constructor(operation: string, timeoutMs: number);
+}
+export declare class RateLimitError extends NetworkError {
+    constructor(service: string, retryAfter?: number);
+}
+export declare class AuthenticationError extends PDWError {
+    constructor(message: string, code: string, context?: Record<string, any>, originalError?: Error);
+}
+export declare class InvalidSignatureError extends AuthenticationError {
+    constructor(expectedAddress: string, actualAddress?: string);
+}
+export declare class WalletNotConnectedError extends AuthenticationError {
+    constructor();
+}
+export declare const ERROR_MESSAGES: Record<string, string>;
+export declare const RETRYABLE_ERROR_CODES: string[];
+/**
+ * Check if an error is a PDW SDK error
+ */
+export declare function isPDWError(error: any): error is PDWError;
+/**
+ * Wrap unknown errors in a PDWError
+ */
+export declare function wrapError(error: unknown, category?: ErrorCategory, context?: Record<string, any>): PDWError;
+/**
+ * Create error from Sui/blockchain errors
+ */
+export declare function createBlockchainError(error: any, context?: Record<string, any>): BlockchainError;
+/**
+ * Create error from network/HTTP errors
+ */
+export declare function createNetworkError(error: any, endpoint?: string): NetworkError;
+export * from './validation';
+export * from './recovery';
+//# sourceMappingURL=index.d.ts.map

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

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