@cmdoss/memwal-sdk 0.6.0

package/dist/client/namespaces/IndexNamespace.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Index Namespace - Vector Indexing Operations
+ *
+ * Delegates to MemoryIndexService for HNSW-based vector indexing with
+ * full Walrus persistence support via HnswWasmService.
+ *
+ * Features:
+ * - O(log N) vector similarity search via HNSW
+ * - Walrus storage persistence for durability
+ * - IndexedDB caching for offline support
+ * - Automatic batching for optimal performance
+ *
+ * @module client/namespaces
+ */
+import type { ServiceContainer } from '../SimplePDWClient';
+/**
+ * Index statistics
+ */
+export interface IndexStats {
+    totalVectors: number;
+    dimension: number;
+    spaceType: string;
+    maxElements: number;
+    currentCount: number;
+}
+/**
+ * Index configuration
+ */
+export interface IndexConfig {
+    dimension?: number;
+    maxElements?: number;
+    efConstruction?: number;
+    m?: number;
+}
+/**
+ * Index Namespace
+ *
+ * Handles HNSW vector indexing and fast similarity search with Walrus persistence
+ */
+export declare class IndexNamespace {
+    private services;
+    constructor(services: ServiceContainer);
+    /**
+     * Get the underlying service (prefer MemoryIndexService over VectorService)
+     */
+    private getService;
+    /**
+     * Create a new vector index
+     *
+     * Note: MemoryIndexService auto-initializes indices on first use.
+     * This method is provided for explicit initialization or VectorService compatibility.
+     *
+     * @param spaceId - Index space identifier (e.g., userAddress)
+     * @param dimension - Vector dimension (default: 3072)
+     * @param config - Optional HNSW config (used by VectorService)
+     */
+    create(spaceId: string, dimension?: number, config?: IndexConfig): Promise<void>;
+    /**
+     * Add vector to index
+     *
+     * Delegates to: MemoryIndexService or VectorService
+     *
+     * @param spaceId - Index space identifier
+     * @param vectorId - Vector ID (unique number)
+     * @param vector - Vector array
+     * @param metadata - Optional metadata
+     */
+    add(spaceId: string, vectorId: number, vector: number[], metadata?: any): Promise<void>;
+    /**
+     * Search vectors in index
+     *
+     * Delegates to: MemoryIndexService or VectorService
+     *
+     * @param spaceId - Index space identifier
+     * @param queryVector - Query vector
+     * @param options - Search options (k, threshold, etc.)
+     * @returns Search results with IDs and similarities
+     */
+    search(spaceId: string, queryVector: number[], options?: {
+        k?: number;
+        threshold?: number;
+        efSearch?: number;
+    }): Promise<Array<{
+        vectorId: number;
+        memoryId: string;
+        similarity: number;
+        distance: number;
+    }>>;
+    /**
+     * Get index statistics
+     *
+     * Returns stats about the index size and configuration
+     *
+     * @param spaceId - Index space identifier
+     * @returns Index statistics
+     */
+    getStats(spaceId: string): IndexStats;
+    /**
+     * Save index to Walrus storage
+     *
+     * Persists the HNSW index binary to Walrus for durability.
+     * Uses HnswWasmService.saveIndex() which properly serializes the index.
+     *
+     * @param spaceId - Index space identifier (userAddress)
+     * @returns Blob ID of saved index on Walrus, or null if no index exists
+     */
+    save(spaceId: string): Promise<void>;
+    /**
+     * Load index from Walrus storage
+     *
+     * Loads a previously saved HNSW index from Walrus.
+     * Uses HnswWasmService.loadIndex() which properly deserializes the binary.
+     *
+     * @param spaceId - Index space identifier (userAddress)
+     * @param blobId - Blob ID of the saved index on Walrus
+     */
+    load(spaceId: string, blobId: string): Promise<void>;
+    /**
+     * Clear index and remove all vectors
+     *
+     * @param spaceId - Index space identifier
+     */
+    clear(spaceId: string): void;
+    /**
+     * Force flush pending vectors
+     *
+     * Immediately processes all batched vectors for the given space.
+     *
+     * @param spaceId - Index space identifier
+     */
+    flush(spaceId: string): Promise<void>;
+    /**
+     * Optimize index for better search performance
+     *
+     * For MemoryIndexService, this triggers a flush and potential rebuild.
+     *
+     * @param spaceId - Index space identifier
+     */
+    optimize(spaceId: string): Promise<void>;
+}
+//# sourceMappingURL=IndexNamespace.d.ts.map

package/dist/client/namespaces/IndexNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexNamespace.d.ts","sourceRoot":"","sources":["../../../src/client/namespaces/IndexNamespace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAE9C;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;;;;;;;;OASG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5F;;;;;;;;;OASG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB7F;;;;;;;;;OASG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9D,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA4B/F;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IA6BrC;;;;;;;;OAQG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1C;;;;;;;;OAQG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1D;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAU5B;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3C;;;;;;OAMG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAW/C"}

package/dist/client/namespaces/IndexNamespace.js

@@ -0,0 +1,238 @@
+/**
+ * Index Namespace - Vector Indexing Operations
+ *
+ * Delegates to MemoryIndexService for HNSW-based vector indexing with
+ * full Walrus persistence support via HnswWasmService.
+ *
+ * Features:
+ * - O(log N) vector similarity search via HNSW
+ * - Walrus storage persistence for durability
+ * - IndexedDB caching for offline support
+ * - Automatic batching for optimal performance
+ *
+ * @module client/namespaces
+ */
+/**
+ * Index Namespace
+ *
+ * Handles HNSW vector indexing and fast similarity search with Walrus persistence
+ */
+export class IndexNamespace {
+    constructor(services) {
+        this.services = services;
+    }
+    /**
+     * Get the underlying service (prefer MemoryIndexService over VectorService)
+     */
+    getService() {
+        if (this.services.memoryIndex) {
+            return { type: 'memoryIndex', service: this.services.memoryIndex };
+        }
+        if (this.services.vector) {
+            return { type: 'vector', service: this.services.vector };
+        }
+        throw new Error('No indexing service configured. Enable local indexing in config.');
+    }
+    /**
+     * Create a new vector index
+     *
+     * Note: MemoryIndexService auto-initializes indices on first use.
+     * This method is provided for explicit initialization or VectorService compatibility.
+     *
+     * @param spaceId - Index space identifier (e.g., userAddress)
+     * @param dimension - Vector dimension (default: 3072)
+     * @param config - Optional HNSW config (used by VectorService)
+     */
+    async create(spaceId, dimension = 3072, config) {
+        const { type, service } = this.getService();
+        if (type === 'memoryIndex') {
+            // MemoryIndexService auto-creates indices on first indexMemory() call
+            // The HNSW config is set at service construction time
+            console.log(`Index ${spaceId} will be created on first vector add (dimension: ${dimension})`);
+        }
+        else {
+            await service.createIndex(spaceId, dimension, config);
+        }
+    }
+    /**
+     * Add vector to index
+     *
+     * Delegates to: MemoryIndexService or VectorService
+     *
+     * @param spaceId - Index space identifier
+     * @param vectorId - Vector ID (unique number)
+     * @param vector - Vector array
+     * @param metadata - Optional metadata
+     */
+    async add(spaceId, vectorId, vector, metadata) {
+        const { type, service } = this.getService();
+        if (type === 'memoryIndex') {
+            // MemoryIndexService uses batched add internally via HnswWasmService
+            // Option A+: Pass isEncrypted to control content storage
+            await service.indexMemory(spaceId, vectorId.toString(), metadata?.blobId || '', metadata?.content || '', metadata || {}, vector, { isEncrypted: metadata?.isEncrypted ?? false });
+        }
+        else {
+            await service.addVector(spaceId, vectorId, vector, metadata);
+        }
+    }
+    /**
+     * Search vectors in index
+     *
+     * Delegates to: MemoryIndexService or VectorService
+     *
+     * @param spaceId - Index space identifier
+     * @param queryVector - Query vector
+     * @param options - Search options (k, threshold, etc.)
+     * @returns Search results with IDs and similarities
+     */
+    async search(spaceId, queryVector, options) {
+        const { type, service } = this.getService();
+        if (type === 'memoryIndex') {
+            const results = await service.searchMemories({
+                vector: queryVector,
+                userAddress: spaceId,
+                k: options?.k || 10,
+                threshold: options?.threshold
+            });
+            return results.map((r) => ({
+                vectorId: parseInt(r.memoryId) || 0,
+                memoryId: r.memoryId,
+                similarity: r.similarity || r.relevanceScore || 0,
+                distance: 1 - (r.similarity || r.relevanceScore || 0)
+            }));
+        }
+        else {
+            const result = await service.searchVectors(spaceId, queryVector, options);
+            return result.results.map((r) => ({
+                vectorId: r.vectorId,
+                memoryId: r.memoryId,
+                similarity: r.similarity,
+                distance: r.distance
+            }));
+        }
+    }
+    /**
+     * Get index statistics
+     *
+     * Returns stats about the index size and configuration
+     *
+     * @param spaceId - Index space identifier
+     * @returns Index statistics
+     */
+    getStats(spaceId) {
+        const { type, service } = this.getService();
+        if (type === 'memoryIndex') {
+            const stats = service.getIndexStats(spaceId);
+            // MemoryIndexService.getIndexStats returns: { totalMemories, categoryCounts, indexSize, ... }
+            return {
+                totalVectors: stats.totalMemories || 0,
+                dimension: 3072, // Default dimension (set at service construction)
+                spaceType: 'cosine',
+                maxElements: 10000, // Default max (set at service construction)
+                currentCount: stats.indexSize || stats.totalMemories || 0
+            };
+        }
+        else {
+            const entry = service.indexCache?.get(spaceId);
+            if (!entry) {
+                throw new Error(`Index ${spaceId} not found`);
+            }
+            const currentCount = entry.index.getCurrentCount?.() || 0;
+            return {
+                totalVectors: currentCount,
+                dimension: 3072,
+                spaceType: 'cosine',
+                maxElements: 10000,
+                currentCount
+            };
+        }
+    }
+    /**
+     * Save index to Walrus storage
+     *
+     * Persists the HNSW index binary to Walrus for durability.
+     * Uses HnswWasmService.saveIndex() which properly serializes the index.
+     *
+     * @param spaceId - Index space identifier (userAddress)
+     * @returns Blob ID of saved index on Walrus, or null if no index exists
+     */
+    async save(spaceId) {
+        const { type, service } = this.getService();
+        if (type === 'memoryIndex') {
+            // MemoryIndexService.saveIndex() saves to persistent storage
+            await service.saveIndex(spaceId);
+            console.log(`Index saved for space: ${spaceId}`);
+        }
+        else {
+            // VectorService has limited persistence support
+            await service.saveIndex(spaceId);
+        }
+    }
+    /**
+     * Load index from Walrus storage
+     *
+     * Loads a previously saved HNSW index from Walrus.
+     * Uses HnswWasmService.loadIndex() which properly deserializes the binary.
+     *
+     * @param spaceId - Index space identifier (userAddress)
+     * @param blobId - Blob ID of the saved index on Walrus
+     */
+    async load(spaceId, blobId) {
+        const { type, service } = this.getService();
+        if (type === 'memoryIndex') {
+            // MemoryIndexService.loadIndex(userAddress, indexBlobId?)
+            await service.loadIndex(spaceId, blobId);
+            console.log(`Index loaded from Walrus: ${blobId}`);
+        }
+        else {
+            await service.loadIndex(spaceId, blobId);
+        }
+    }
+    /**
+     * Clear index and remove all vectors
+     *
+     * @param spaceId - Index space identifier
+     */
+    clear(spaceId) {
+        const { type, service } = this.getService();
+        if (type === 'memoryIndex') {
+            service.clearUserIndex(spaceId);
+        }
+        else {
+            service.indexCache?.delete(spaceId);
+        }
+    }
+    /**
+     * Force flush pending vectors
+     *
+     * Immediately processes all batched vectors for the given space.
+     *
+     * @param spaceId - Index space identifier
+     */
+    async flush(spaceId) {
+        const { type, service } = this.getService();
+        if (type === 'memoryIndex') {
+            await service.flush(spaceId);
+        }
+        // VectorService handles flushing automatically
+    }
+    /**
+     * Optimize index for better search performance
+     *
+     * For MemoryIndexService, this triggers a flush and potential rebuild.
+     *
+     * @param spaceId - Index space identifier
+     */
+    async optimize(spaceId) {
+        const { type, service } = this.getService();
+        if (type === 'memoryIndex') {
+            // Flush pending vectors first
+            await service.flush(spaceId);
+            console.log(`Index ${spaceId} optimized (flushed pending vectors)`);
+        }
+        else {
+            console.log(`Index ${spaceId} uses automatic optimization via batching`);
+        }
+    }
+}
+//# sourceMappingURL=IndexNamespace.js.map

package/dist/client/namespaces/IndexNamespace.js.map

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

package/dist/client/namespaces/MemoryNamespace.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Memory Namespace - Complete Memory CRUD Operations
+ *
+ * Provides simple API for creating, reading, updating, and deleting memories
+ * without React hooks or UI dependencies.
+ *
+ * @module client/namespaces
+ */
+import type { ServiceContainer } from '../SimplePDWClient';
+/**
+ * Memory object returned by operations
+ */
+export interface Memory {
+    id: string;
+    content: string;
+    category?: string;
+    importance?: number;
+    topic?: string;
+    blobId: string;
+    vectorId?: number;
+    embedding?: number[];
+    metadata?: Record<string, any>;
+    encrypted?: boolean;
+    createdAt: number;
+    updatedAt?: number;
+}
+/**
+ * Options for creating a memory
+ */
+export interface CreateMemoryOptions {
+    category?: 'fact' | 'preference' | 'todo' | 'note' | 'general';
+    importance?: number;
+    topic?: string;
+    metadata?: Record<string, any>;
+    onProgress?: (stage: string, percent: number) => void;
+}
+/**
+ * Options for updating a memory
+ */
+export interface UpdateMemoryOptions {
+    /** New content (will upload new blob to Walrus) */
+    content?: string;
+    /** New category */
+    category?: string;
+    /** New importance (1-10) */
+    importance?: number;
+    /** New topic */
+    topic?: string;
+    /** New embedding blob ID */
+    embeddingBlobId?: string;
+    /** New content hash */
+    contentHash?: string;
+    /** New content size */
+    contentSize?: number;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Options for listing memories
+ */
+export interface ListMemoryOptions {
+    category?: string;
+    limit?: number;
+    offset?: number;
+    sortBy?: 'date' | 'importance' | 'relevance';
+    order?: 'asc' | 'desc';
+}
+/**
+ * Memory context with related memories
+ */
+export interface MemoryContext {
+    memory: Memory;
+    related: Memory[];
+    entities?: Array<{
+        id: string;
+        name: string;
+        type: string;
+    }>;
+    relationships?: Array<{
+        source: string;
+        target: string;
+        type: string;
+    }>;
+}
+/**
+ * Memory Namespace
+ *
+ * Handles all memory CRUD operations
+ */
+export declare class MemoryNamespace {
+    private services;
+    constructor(services: ServiceContainer);
+    /**
+     * Create a new memory with automatic processing
+     *
+     * Pipeline:
+     * 1. Auto-classify content (if classifier enabled and category not provided)
+     * 2. Generate embedding (if AI enabled)
+     * 3. Encrypt content (if encryption enabled)
+     * 4. Upload to Walrus
+     * 5. Register on Sui blockchain
+     * 6. Index locally (if enabled)
+     * 7. Extract knowledge graph (if enabled)
+     *
+     * @param content - Text content to save
+     * @param options - Optional metadata and callbacks
+     * @returns Created memory with ID and blob ID
+     *
+     * @example
+     * ```typescript
+     * // Auto-classify and extract knowledge graph automatically
+     * const memory = await pdw.memory.create('I love TypeScript', {
+     *   importance: 8,
+     *   onProgress: (stage, percent) => console.log(stage, percent)
+     * });
+     *
+     * // Provide category to skip auto-classify
+     * const memory = await pdw.memory.create('Meeting at 3pm', {
+     *   category: 'todo'
+     * });
+     * ```
+     */
+    create(content: string, options?: CreateMemoryOptions): Promise<Memory>;
+    /**
+     * Get a memory by ID
+     *
+     * @param memoryId - Memory ID (blob ID)
+     * @returns Memory with full metadata
+     */
+    get(memoryId: string): Promise<Memory>;
+    /**
+     * Update memory record on-chain
+     *
+     * Updates memory object fields via Sui transaction. Only non-empty/non-zero
+     * values will be updated.
+     *
+     * If content is provided, a new blob will be uploaded to Walrus and
+     * the blob_id will be updated on-chain.
+     *
+     * @param memoryId - Memory object ID on Sui
+     * @param updates - Fields to update
+     * @returns Updated memory object
+     *
+     * @example
+     * ```typescript
+     * // Update importance and topic
+     * const updated = await pdw.memory.update(memoryId, {
+     *   importance: 9,
+     *   topic: 'programming'
+     * });
+     *
+     * // Update content (creates new Walrus blob)
+     * const updated = await pdw.memory.update(memoryId, {
+     *   content: 'Updated content here'
+     * });
+     * ```
+     */
+    update(memoryId: string, updates: UpdateMemoryOptions): Promise<Memory>;
+    /**
+     * Delete a memory
+     *
+     * Removes from:
+     * - Local vector index
+     * - Blockchain records (marks as deleted)
+     * Note: Walrus blobs are immutable, can only be marked as deleted
+     *
+     * @param memoryId - Memory ID to delete
+     */
+    delete(memoryId: string): Promise<void>;
+    /**
+     * List user memories with pagination
+     *
+     * @param options - Filter and pagination options
+     * @returns Array of memories
+     */
+    list(options?: ListMemoryOptions): Promise<Memory[]>;
+    /**
+     * Create multiple memories in batch using Walrus Quilt
+     *
+     * Uses Walrus SDK's writeFiles() which automatically batches small blobs
+     * into a single Quilt transaction, providing ~90% gas savings.
+     *
+     * Pipeline (batched):
+     * 1. Auto-classify all contents (if classifier enabled)
+     * 2. Generate embeddings for all contents (parallel)
+     * 3. Encrypt all contents (if encryption enabled)
+     * 4. Batch upload to Walrus as Quilt (single transaction!)
+     * 5. Register on Sui blockchain (batched PTB)
+     * 6. Index locally (batch add to vector index)
+     *
+     * @param contents - Array of content strings
+     * @param options - Shared options for all memories
+     * @returns Array of created memories
+     *
+     * @example
+     * ```typescript
+     * // Create multiple memories efficiently with Quilt
+     * const memories = await pdw.memory.createBatch([
+     *   'I love TypeScript',
+     *   'Meeting at 3pm tomorrow',
+     *   'Remember to buy milk'
+     * ], {
+     *   category: 'note',
+     *   importance: 5
+     * });
+     * // All 3 memories uploaded in 1 transaction!
+     * ```
+     */
+    createBatch(contents: string[], options?: CreateMemoryOptions): Promise<Memory[]>;
+    /**
+     * Delete multiple memories
+     *
+     * @param memoryIds - Array of memory IDs to delete
+     */
+    deleteBatch(memoryIds: string[]): Promise<void>;
+    /**
+     * Update multiple memories in batch
+     *
+     * Updates memories in parallel batches:
+     * 1. For updates with new content: uploads new blobs to Walrus
+     * 2. Executes on-chain update transactions
+     * 3. Updates local vector index if enabled
+     *
+     * @param updates - Array of {id, content?, category?, importance?, topic?}
+     * @returns Array of successfully updated memory IDs
+     *
+     * @example
+     * ```typescript
+     * const updatedIds = await pdw.memory.updateBatch([
+     *   { id: 'mem1', importance: 9 },
+     *   { id: 'mem2', content: 'Updated content' }
+     * ]);
+     * ```
+     */
+    updateBatch(updates: Array<{
+        id: string;
+        content?: string;
+        category?: string;
+        importance?: number;
+        topic?: string;
+    }>): Promise<string[]>;
+    /**
+     * Get memory with related context (related memories, knowledge graph)
+     *
+     * @param memoryId - Memory ID
+     * @param options - Context options
+     * @returns Memory with context
+     */
+    getContext(memoryId: string, options?: {
+        includeRelated?: boolean;
+        includeGraph?: boolean;
+    }): Promise<MemoryContext>;
+    /**
+     * Get memories related to a specific memory
+     *
+     * @param memoryId - Memory ID
+     * @param k - Number of related memories to return
+     * @returns Array of related memories
+     */
+    getRelated(memoryId: string, k?: number): Promise<Memory[]>;
+    /**
+     * Export memories to file format
+     *
+     * Exports memories to JSON or CSV format for backup/portability
+     *
+     * @param options - Export options
+     * @returns Exported data as string
+     */
+    export(options?: {
+        format?: 'json' | 'csv';
+        includeContent?: boolean;
+        includeEmbeddings?: boolean;
+        category?: string;
+        limit?: number;
+    }): Promise<string>;
+}
+//# sourceMappingURL=MemoryNamespace.d.ts.map

package/dist/client/namespaces/MemoryNamespace.d.ts.map

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