@cmdoss/memwal-sdk 0.9.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (174) hide show
  1. package/README.md +157 -52
  2. package/dist/client/ClientMemoryManager.d.ts.map +1 -1
  3. package/dist/client/ClientMemoryManager.js +25 -8
  4. package/dist/client/ClientMemoryManager.js.map +1 -1
  5. package/dist/client/PersonalDataWallet.d.ts.map +1 -1
  6. package/dist/client/SimplePDWClient.d.ts +2 -1
  7. package/dist/client/SimplePDWClient.d.ts.map +1 -1
  8. package/dist/client/SimplePDWClient.js +23 -6
  9. package/dist/client/SimplePDWClient.js.map +1 -1
  10. package/dist/client/namespaces/MemoryNamespace.d.ts +6 -0
  11. package/dist/client/namespaces/MemoryNamespace.d.ts.map +1 -1
  12. package/dist/client/namespaces/MemoryNamespace.js +131 -18
  13. package/dist/client/namespaces/MemoryNamespace.js.map +1 -1
  14. package/dist/client/namespaces/consolidated/StorageNamespace.d.ts +3 -1
  15. package/dist/client/namespaces/consolidated/StorageNamespace.d.ts.map +1 -1
  16. package/dist/client/namespaces/consolidated/StorageNamespace.js.map +1 -1
  17. package/dist/config/ConfigurationHelper.js +61 -61
  18. package/dist/config/index.d.ts +1 -0
  19. package/dist/config/index.d.ts.map +1 -1
  20. package/dist/config/index.js +2 -0
  21. package/dist/config/index.js.map +1 -1
  22. package/dist/config/modelDefaults.d.ts +67 -0
  23. package/dist/config/modelDefaults.d.ts.map +1 -0
  24. package/dist/config/modelDefaults.js +91 -0
  25. package/dist/config/modelDefaults.js.map +1 -0
  26. package/dist/graph/GraphService.d.ts.map +1 -1
  27. package/dist/graph/GraphService.js +22 -21
  28. package/dist/graph/GraphService.js.map +1 -1
  29. package/dist/index.d.ts +1 -1
  30. package/dist/index.d.ts.map +1 -1
  31. package/dist/index.js +1 -1
  32. package/dist/index.js.map +1 -1
  33. package/dist/langchain/createPDWRAG.js +30 -30
  34. package/dist/pipeline/MemoryPipeline.d.ts.map +1 -1
  35. package/dist/pipeline/MemoryPipeline.js +2 -1
  36. package/dist/pipeline/MemoryPipeline.js.map +1 -1
  37. package/dist/services/GeminiAIService.d.ts.map +1 -1
  38. package/dist/services/GeminiAIService.js +311 -310
  39. package/dist/services/GeminiAIService.js.map +1 -1
  40. package/dist/services/StorageService.d.ts +4 -1
  41. package/dist/services/StorageService.d.ts.map +1 -1
  42. package/dist/services/StorageService.js.map +1 -1
  43. package/dist/services/storage/QuiltBatchManager.d.ts +7 -0
  44. package/dist/services/storage/QuiltBatchManager.d.ts.map +1 -1
  45. package/dist/services/storage/QuiltBatchManager.js +24 -5
  46. package/dist/services/storage/QuiltBatchManager.js.map +1 -1
  47. package/dist/services/storage/WalrusStorageManager.d.ts +10 -1
  48. package/dist/services/storage/WalrusStorageManager.d.ts.map +1 -1
  49. package/dist/services/storage/WalrusStorageManager.js +53 -12
  50. package/dist/services/storage/WalrusStorageManager.js.map +1 -1
  51. package/dist/vector/BrowserHnswIndexService.js +2 -2
  52. package/dist/vector/BrowserHnswIndexService.js.map +1 -1
  53. package/dist/vector/NodeHnswService.js +4 -4
  54. package/dist/vector/NodeHnswService.js.map +1 -1
  55. package/dist/vector/createHnswService.d.ts +4 -0
  56. package/dist/vector/createHnswService.d.ts.map +1 -1
  57. package/dist/vector/createHnswService.js +15 -3
  58. package/dist/vector/createHnswService.js.map +1 -1
  59. package/package.json +1 -1
  60. package/src/access/PermissionService.ts +635 -635
  61. package/src/aggregation/AggregationService.ts +389 -389
  62. package/src/ai-sdk/PDWVectorStore.ts +715 -715
  63. package/src/ai-sdk/index.ts +65 -65
  64. package/src/ai-sdk/tools.ts +460 -460
  65. package/src/ai-sdk/types.ts +404 -404
  66. package/src/batch/BatchManager.ts +597 -597
  67. package/src/batch/BatchingService.ts +429 -429
  68. package/src/batch/MemoryProcessingCache.ts +492 -492
  69. package/src/batch/index.ts +30 -30
  70. package/src/browser.ts +200 -200
  71. package/src/client/ClientMemoryManager.ts +1004 -987
  72. package/src/client/PersonalDataWallet.ts +345 -345
  73. package/src/client/SimplePDWClient.ts +1387 -1369
  74. package/src/client/factory.ts +154 -154
  75. package/src/client/namespaces/AnalyticsNamespace.ts +377 -377
  76. package/src/client/namespaces/BatchNamespace.ts +356 -356
  77. package/src/client/namespaces/CacheNamespace.ts +123 -123
  78. package/src/client/namespaces/CapabilityNamespace.ts +217 -217
  79. package/src/client/namespaces/ClassifyNamespace.ts +169 -169
  80. package/src/client/namespaces/ContextNamespace.ts +297 -297
  81. package/src/client/namespaces/EncryptionNamespace.ts +221 -221
  82. package/src/client/namespaces/GraphNamespace.ts +468 -468
  83. package/src/client/namespaces/IndexNamespace.ts +364 -364
  84. package/src/client/namespaces/MemoryNamespace.ts +1704 -1569
  85. package/src/client/namespaces/PermissionsNamespace.ts +254 -254
  86. package/src/client/namespaces/PipelineNamespace.ts +220 -220
  87. package/src/client/namespaces/StorageNamespace.ts +458 -458
  88. package/src/client/namespaces/TxNamespace.ts +260 -260
  89. package/src/client/namespaces/WalletNamespace.ts +243 -243
  90. package/src/client/namespaces/consolidated/BlockchainNamespace.ts +607 -607
  91. package/src/client/namespaces/consolidated/SecurityNamespace.ts +648 -648
  92. package/src/client/namespaces/consolidated/StorageNamespace.ts +1143 -1141
  93. package/src/client/namespaces/consolidated/index.ts +41 -41
  94. package/src/client/signers/KeypairSigner.ts +108 -108
  95. package/src/client/signers/UnifiedSigner.ts +110 -110
  96. package/src/client/signers/WalletAdapterSigner.ts +159 -159
  97. package/src/client/signers/index.ts +26 -26
  98. package/src/config/ConfigurationHelper.ts +412 -412
  99. package/src/config/defaults.ts +56 -56
  100. package/src/config/index.ts +16 -9
  101. package/src/config/modelDefaults.ts +103 -0
  102. package/src/config/validation.ts +70 -70
  103. package/src/core/index.ts +14 -14
  104. package/src/core/interfaces/IService.ts +307 -307
  105. package/src/core/interfaces/index.ts +8 -8
  106. package/src/core/types/capability.ts +297 -297
  107. package/src/core/types/index.ts +874 -874
  108. package/src/core/types/wallet.ts +270 -270
  109. package/src/core/types.ts +9 -9
  110. package/src/core/wallet.ts +222 -222
  111. package/src/embedding/index.ts +19 -19
  112. package/src/embedding/types.ts +357 -357
  113. package/src/errors/index.ts +602 -602
  114. package/src/errors/recovery.ts +461 -461
  115. package/src/errors/validation.ts +567 -567
  116. package/src/generated/pdw/capability.ts +319 -319
  117. package/src/graph/GraphService.ts +888 -887
  118. package/src/graph/KnowledgeGraphManager.ts +728 -728
  119. package/src/graph/index.ts +25 -25
  120. package/src/index.ts +498 -498
  121. package/src/infrastructure/index.ts +22 -22
  122. package/src/infrastructure/seal/EncryptionService.ts +628 -628
  123. package/src/infrastructure/seal/SealService.ts +613 -613
  124. package/src/infrastructure/seal/index.ts +9 -9
  125. package/src/infrastructure/sui/BlockchainManager.ts +627 -627
  126. package/src/infrastructure/sui/SuiService.ts +888 -888
  127. package/src/infrastructure/sui/index.ts +9 -9
  128. package/src/infrastructure/walrus/StorageManager.ts +604 -604
  129. package/src/infrastructure/walrus/WalrusStorageService.ts +637 -637
  130. package/src/infrastructure/walrus/index.ts +9 -9
  131. package/src/langchain/createPDWRAG.ts +303 -303
  132. package/src/langchain/index.ts +47 -47
  133. package/src/permissions/ConsentRepository.browser.ts +249 -249
  134. package/src/permissions/ConsentRepository.ts +364 -364
  135. package/src/pipeline/MemoryPipeline.ts +863 -862
  136. package/src/pipeline/PipelineManager.ts +683 -683
  137. package/src/pipeline/index.ts +26 -26
  138. package/src/retrieval/AdvancedSearchService.ts +629 -629
  139. package/src/retrieval/MemoryAnalyticsService.ts +711 -711
  140. package/src/retrieval/MemoryDecryptionPipeline.ts +825 -825
  141. package/src/retrieval/index.ts +42 -42
  142. package/src/services/BatchService.ts +352 -352
  143. package/src/services/CapabilityService.ts +464 -464
  144. package/src/services/ClassifierService.ts +465 -465
  145. package/src/services/CrossContextPermissionService.ts +486 -486
  146. package/src/services/EmbeddingService.ts +796 -796
  147. package/src/services/EncryptionService.ts +712 -712
  148. package/src/services/GeminiAIService.ts +754 -753
  149. package/src/services/MemoryIndexService.ts +1009 -1009
  150. package/src/services/MemoryService.ts +369 -369
  151. package/src/services/QueryService.ts +890 -890
  152. package/src/services/StorageService.ts +1185 -1182
  153. package/src/services/TransactionService.ts +838 -838
  154. package/src/services/VectorService.ts +462 -462
  155. package/src/services/ViewService.ts +484 -484
  156. package/src/services/index.ts +25 -25
  157. package/src/services/storage/BlobAttributesManager.ts +333 -333
  158. package/src/services/storage/KnowledgeGraphManager.ts +425 -425
  159. package/src/services/storage/MemorySearchManager.ts +387 -387
  160. package/src/services/storage/QuiltBatchManager.ts +1157 -1130
  161. package/src/services/storage/WalrusMetadataManager.ts +268 -268
  162. package/src/services/storage/WalrusStorageManager.ts +333 -287
  163. package/src/services/storage/index.ts +57 -57
  164. package/src/types/index.ts +13 -13
  165. package/src/utils/index.ts +76 -76
  166. package/src/utils/memoryIndexOnChain.ts +507 -507
  167. package/src/vector/BrowserHnswIndexService.ts +758 -758
  168. package/src/vector/HnswWasmService.ts +731 -731
  169. package/src/vector/IHnswService.ts +233 -233
  170. package/src/vector/NodeHnswService.ts +833 -833
  171. package/src/vector/createHnswService.ts +147 -135
  172. package/src/vector/index.ts +56 -56
  173. package/src/wallet/ContextWalletService.ts +656 -656
  174. package/src/wallet/MainWalletService.ts +317 -317
@@ -1,159 +1,159 @@
1
- /**
2
- * Wallet Adapter Signer Implementation
3
- *
4
- * Wraps browser wallet adapters (Sui Wallet, Ethos, Suiet, etc.)
5
- * for use with SimplePDWClient in React dApps.
6
- *
7
- * @example
8
- * ```typescript
9
- * import { WalletAdapterSigner } from 'personal-data-wallet-sdk/client';
10
- *
11
- * // With @mysten/dapp-kit
12
- * const { currentWallet } = useCurrentWallet();
13
- * const signer = new WalletAdapterSigner(currentWallet);
14
- *
15
- * const pdw = await createPDWClient({
16
- * signer,
17
- * network: 'testnet'
18
- * });
19
- * ```
20
- *
21
- * @module client/signers
22
- */
23
-
24
- import type { Transaction } from '@mysten/sui/transactions';
25
- import type { Signer } from '@mysten/sui/cryptography';
26
- import type {
27
- UnifiedSigner,
28
- SignAndExecuteResult,
29
- SignPersonalMessageResult
30
- } from './UnifiedSigner';
31
-
32
- /**
33
- * Minimal wallet adapter interface
34
- * Compatible with @mysten/dapp-kit and other wallet adapters
35
- */
36
- export interface WalletAdapter {
37
- /**
38
- * Sign and execute transaction
39
- */
40
- signAndExecuteTransaction(options: {
41
- transaction: Transaction;
42
- options?: {
43
- showEffects?: boolean;
44
- showEvents?: boolean;
45
- showObjectChanges?: boolean;
46
- };
47
- }): Promise<{
48
- digest: string;
49
- effects?: any;
50
- events?: any[];
51
- objectChanges?: any[];
52
- }>;
53
-
54
- /**
55
- * Sign personal message
56
- */
57
- signPersonalMessage(options: {
58
- message: Uint8Array;
59
- }): Promise<{
60
- signature: string;
61
- bytes?: Uint8Array;
62
- }>;
63
-
64
- /**
65
- * Get account info
66
- */
67
- account: {
68
- address: string;
69
- publicKey?: Uint8Array;
70
- };
71
- }
72
-
73
- /**
74
- * Wallet adapter-based signer for browser environments
75
- */
76
- export class WalletAdapterSigner implements UnifiedSigner {
77
- constructor(private walletAdapter: WalletAdapter) {
78
- if (!walletAdapter) {
79
- throw new Error('WalletAdapter is required');
80
- }
81
-
82
- if (!walletAdapter.account || !walletAdapter.account.address) {
83
- throw new Error('Wallet not connected. Please connect wallet first.');
84
- }
85
- }
86
-
87
- /**
88
- * Sign and execute transaction using wallet adapter
89
- */
90
- async signAndExecuteTransaction(transaction: Transaction): Promise<SignAndExecuteResult> {
91
- const result = await this.walletAdapter.signAndExecuteTransaction({
92
- transaction,
93
- options: {
94
- showEffects: true,
95
- showEvents: true,
96
- showObjectChanges: true
97
- }
98
- });
99
-
100
- return {
101
- digest: result.digest,
102
- effects: result.effects,
103
- events: result.events,
104
- objectChanges: result.objectChanges
105
- };
106
- }
107
-
108
- /**
109
- * Sign personal message using wallet adapter
110
- */
111
- async signPersonalMessage(message: Uint8Array): Promise<SignPersonalMessageResult> {
112
- const result = await this.walletAdapter.signPersonalMessage({
113
- message
114
- });
115
-
116
- return {
117
- signature: result.signature,
118
- bytes: result.bytes || message // Fallback to original message if bytes not provided
119
- };
120
- }
121
-
122
- /**
123
- * Get Sui address from wallet
124
- */
125
- getAddress(): string {
126
- return this.walletAdapter.account.address;
127
- }
128
-
129
- /**
130
- * Get public key from wallet
131
- */
132
- getPublicKey(): Uint8Array | null {
133
- return this.walletAdapter.account.publicKey || null;
134
- }
135
-
136
- /**
137
- * Get underlying Signer
138
- *
139
- * Note: Wallet adapters don't expose full Signer interface,
140
- * so this throws an error. Use KeypairSigner for services requiring Signer.
141
- */
142
- getSigner(): Signer {
143
- throw new Error(
144
- 'WalletAdapterSigner does not expose underlying Signer. ' +
145
- 'Some PDW operations require direct Keypair access. ' +
146
- 'Use KeypairSigner for backend/Node.js environments.'
147
- );
148
- }
149
-
150
- /**
151
- * Get SuiClient instance
152
- *
153
- * Note: WalletAdapter doesn't provide SuiClient.
154
- * Use DappKitSigner if you need client access.
155
- */
156
- getClient(): null {
157
- return null;
158
- }
159
- }
1
+ /**
2
+ * Wallet Adapter Signer Implementation
3
+ *
4
+ * Wraps browser wallet adapters (Sui Wallet, Ethos, Suiet, etc.)
5
+ * for use with SimplePDWClient in React dApps.
6
+ *
7
+ * @example
8
+ * ```typescript
9
+ * import { WalletAdapterSigner } from 'personal-data-wallet-sdk/client';
10
+ *
11
+ * // With @mysten/dapp-kit
12
+ * const { currentWallet } = useCurrentWallet();
13
+ * const signer = new WalletAdapterSigner(currentWallet);
14
+ *
15
+ * const pdw = await createPDWClient({
16
+ * signer,
17
+ * network: 'testnet'
18
+ * });
19
+ * ```
20
+ *
21
+ * @module client/signers
22
+ */
23
+
24
+ import type { Transaction } from '@mysten/sui/transactions';
25
+ import type { Signer } from '@mysten/sui/cryptography';
26
+ import type {
27
+ UnifiedSigner,
28
+ SignAndExecuteResult,
29
+ SignPersonalMessageResult
30
+ } from './UnifiedSigner';
31
+
32
+ /**
33
+ * Minimal wallet adapter interface
34
+ * Compatible with @mysten/dapp-kit and other wallet adapters
35
+ */
36
+ export interface WalletAdapter {
37
+ /**
38
+ * Sign and execute transaction
39
+ */
40
+ signAndExecuteTransaction(options: {
41
+ transaction: Transaction;
42
+ options?: {
43
+ showEffects?: boolean;
44
+ showEvents?: boolean;
45
+ showObjectChanges?: boolean;
46
+ };
47
+ }): Promise<{
48
+ digest: string;
49
+ effects?: any;
50
+ events?: any[];
51
+ objectChanges?: any[];
52
+ }>;
53
+
54
+ /**
55
+ * Sign personal message
56
+ */
57
+ signPersonalMessage(options: {
58
+ message: Uint8Array;
59
+ }): Promise<{
60
+ signature: string;
61
+ bytes?: Uint8Array;
62
+ }>;
63
+
64
+ /**
65
+ * Get account info
66
+ */
67
+ account: {
68
+ address: string;
69
+ publicKey?: Uint8Array;
70
+ };
71
+ }
72
+
73
+ /**
74
+ * Wallet adapter-based signer for browser environments
75
+ */
76
+ export class WalletAdapterSigner implements UnifiedSigner {
77
+ constructor(private walletAdapter: WalletAdapter) {
78
+ if (!walletAdapter) {
79
+ throw new Error('WalletAdapter is required');
80
+ }
81
+
82
+ if (!walletAdapter.account || !walletAdapter.account.address) {
83
+ throw new Error('Wallet not connected. Please connect wallet first.');
84
+ }
85
+ }
86
+
87
+ /**
88
+ * Sign and execute transaction using wallet adapter
89
+ */
90
+ async signAndExecuteTransaction(transaction: Transaction): Promise<SignAndExecuteResult> {
91
+ const result = await this.walletAdapter.signAndExecuteTransaction({
92
+ transaction,
93
+ options: {
94
+ showEffects: true,
95
+ showEvents: true,
96
+ showObjectChanges: true
97
+ }
98
+ });
99
+
100
+ return {
101
+ digest: result.digest,
102
+ effects: result.effects,
103
+ events: result.events,
104
+ objectChanges: result.objectChanges
105
+ };
106
+ }
107
+
108
+ /**
109
+ * Sign personal message using wallet adapter
110
+ */
111
+ async signPersonalMessage(message: Uint8Array): Promise<SignPersonalMessageResult> {
112
+ const result = await this.walletAdapter.signPersonalMessage({
113
+ message
114
+ });
115
+
116
+ return {
117
+ signature: result.signature,
118
+ bytes: result.bytes || message // Fallback to original message if bytes not provided
119
+ };
120
+ }
121
+
122
+ /**
123
+ * Get Sui address from wallet
124
+ */
125
+ getAddress(): string {
126
+ return this.walletAdapter.account.address;
127
+ }
128
+
129
+ /**
130
+ * Get public key from wallet
131
+ */
132
+ getPublicKey(): Uint8Array | null {
133
+ return this.walletAdapter.account.publicKey || null;
134
+ }
135
+
136
+ /**
137
+ * Get underlying Signer
138
+ *
139
+ * Note: Wallet adapters don't expose full Signer interface,
140
+ * so this throws an error. Use KeypairSigner for services requiring Signer.
141
+ */
142
+ getSigner(): Signer {
143
+ throw new Error(
144
+ 'WalletAdapterSigner does not expose underlying Signer. ' +
145
+ 'Some PDW operations require direct Keypair access. ' +
146
+ 'Use KeypairSigner for backend/Node.js environments.'
147
+ );
148
+ }
149
+
150
+ /**
151
+ * Get SuiClient instance
152
+ *
153
+ * Note: WalletAdapter doesn't provide SuiClient.
154
+ * Use DappKitSigner if you need client access.
155
+ */
156
+ getClient(): null {
157
+ return null;
158
+ }
159
+ }
@@ -1,26 +1,26 @@
1
- /**
2
- * Signer Abstractions for SimplePDWClient
3
- *
4
- * Unified signer interface supporting multiple signing methods:
5
- * - Keypair (Node.js, backend, CLI)
6
- * - WalletAdapter (Browser, React dApps)
7
- * - DappKit (Browser, @mysten/dapp-kit hooks)
8
- *
9
- * @module client/signers
10
- */
11
-
12
- export type {
13
- UnifiedSigner,
14
- SignAndExecuteResult,
15
- SignPersonalMessageResult
16
- } from './UnifiedSigner';
17
-
18
- export { KeypairSigner } from './KeypairSigner';
19
- export { WalletAdapterSigner } from './WalletAdapterSigner';
20
- export type { WalletAdapter } from './WalletAdapterSigner';
21
- export { DappKitSigner } from './DappKitSigner';
22
- export type {
23
- DappKitSignerConfig,
24
- DappKitSignAndExecuteFn,
25
- DappKitSignPersonalMessageFn
26
- } from './DappKitSigner';
1
+ /**
2
+ * Signer Abstractions for SimplePDWClient
3
+ *
4
+ * Unified signer interface supporting multiple signing methods:
5
+ * - Keypair (Node.js, backend, CLI)
6
+ * - WalletAdapter (Browser, React dApps)
7
+ * - DappKit (Browser, @mysten/dapp-kit hooks)
8
+ *
9
+ * @module client/signers
10
+ */
11
+
12
+ export type {
13
+ UnifiedSigner,
14
+ SignAndExecuteResult,
15
+ SignPersonalMessageResult
16
+ } from './UnifiedSigner';
17
+
18
+ export { KeypairSigner } from './KeypairSigner';
19
+ export { WalletAdapterSigner } from './WalletAdapterSigner';
20
+ export type { WalletAdapter } from './WalletAdapterSigner';
21
+ export { DappKitSigner } from './DappKitSigner';
22
+ export type {
23
+ DappKitSignerConfig,
24
+ DappKitSignAndExecuteFn,
25
+ DappKitSignPersonalMessageFn
26
+ } from './DappKitSigner';