@functionland/fula-client 0.2.23 → 0.2.24

package/fula_js.d.ts

@@ -47,12 +47,21 @@ export function deleteBucket(client: EncryptedClient, name: string): Promise<voi
 export function deleteEncrypted(client: EncryptedClient, bucket: string, key: string): Promise<void>;
 
 /**
- * Derive a 32-byte key from context and input
+ * Derive a 32-byte key from context and input using Argon2id (memory-hard KDF)
  *
- * Use this to derive encryption keys from Google credentials:
+ * Use this to derive encryption keys from Google credentials with brute-force resistance:
  * ```javascript
- * const key = deriveKey('my-app-v1', new TextEncoder().encode(userId + email));
+ * const key = deriveKey('fula-files-v1', new TextEncoder().encode(`google:${userId}:${email}`));
  * ```
+ *
+ * Parameters:
+ * - Memory: 64 MiB
+ * - Iterations: 3
+ * - Parallelism: 1 (for cross-platform consistency)
+ *
+ * @param context - Context string used as salt (e.g., "fula-files-v1")
+ * @param input - Input bytes (e.g., UTF-8 encoded credentials)
+ * @returns 32-byte derived key
  */
 export function deriveKey(context: string, input: Uint8Array): Uint8Array;
 

package/fula_js.js

@@ -380,12 +380,21 @@ export function deleteEncrypted(client, bucket, key) {
 }
 
 /**
- * Derive a 32-byte key from context and input
+ * Derive a 32-byte key from context and input using Argon2id (memory-hard KDF)
  *
- * Use this to derive encryption keys from Google credentials:
+ * Use this to derive encryption keys from Google credentials with brute-force resistance:
  * ```javascript
- * const key = deriveKey('my-app-v1', new TextEncoder().encode(userId + email));
+ * const key = deriveKey('fula-files-v1', new TextEncoder().encode(`google:${userId}:${email}`));
  * ```
+ *
+ * Parameters:
+ * - Memory: 64 MiB
+ * - Iterations: 3
+ * - Parallelism: 1 (for cross-platform consistency)
+ *
+ * @param context - Context string used as salt (e.g., "fula-files-v1")
+ * @param input - Input bytes (e.g., UTF-8 encoded credentials)
+ * @returns 32-byte derived key
  * @param {string} context
  * @param {Uint8Array} input
  * @returns {Uint8Array}
@@ -1169,19 +1178,14 @@ function __wbg_get_imports() {
         const ret = getStringFromWasm0(arg0, arg1);
         return ret;
     };
-    imports.wbg.__wbindgen_cast_293162629359ccc7 = function(arg0, arg1) {
-        // Cast intrinsic for `Closure(Closure { dtor_idx: 284, function: Function { arguments: [], shim_idx: 285, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-        const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h175e7795724731f3, wasm_bindgen__convert__closures_____invoke__h137a7db9bfc1a698);
-        return ret;
-    };
     imports.wbg.__wbindgen_cast_4625c577ab2ec9ee = function(arg0) {
         // Cast intrinsic for `U64 -> Externref`.
         const ret = BigInt.asUintN(64, arg0);
         return ret;
     };
-    imports.wbg.__wbindgen_cast_7418e77c9d43951b = function(arg0, arg1) {
-        // Cast intrinsic for `Closure(Closure { dtor_idx: 319, function: Function { arguments: [Externref], shim_idx: 320, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-        const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hf1f5673d74edd4c1, wasm_bindgen__convert__closures_____invoke__hfca1d4c99c3f4fb2);
+    imports.wbg.__wbindgen_cast_6b8383c0ec1ae211 = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 289, function: Function { arguments: [], shim_idx: 290, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+        const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h175e7795724731f3, wasm_bindgen__convert__closures_____invoke__h137a7db9bfc1a698);
         return ret;
     };
     imports.wbg.__wbindgen_cast_77bc3e92745e9a35 = function(arg0, arg1) {
@@ -1191,6 +1195,11 @@ function __wbg_get_imports() {
         const ret = v0;
         return ret;
     };
+    imports.wbg.__wbindgen_cast_7d99ab386ec3ade6 = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 324, function: Function { arguments: [Externref], shim_idx: 325, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+        const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hf1f5673d74edd4c1, wasm_bindgen__convert__closures_____invoke__hfca1d4c99c3f4fb2);
+        return ret;
+    };
     imports.wbg.__wbindgen_cast_9ae0607507abb057 = function(arg0) {
         // Cast intrinsic for `I64 -> Externref`.
         const ret = arg0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@functionland/fula-client",
-  "version": "0.2.23",
+  "version": "0.2.24",
   "type": "module",
   "description": "JavaScript/TypeScript SDK for Fula decentralized storage - client-side encryption with cross-platform key compatibility",
   "main": "fula_js.js",