@janssenproject/cedarling_wasm 0.0.415-nodejs → 0.0.416-nodejs

package/cedarling_wasm.d.ts

@@ -63,6 +63,67 @@ export class Cedarling {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Collect every value of the annotation `key` across the given policies,
+     * preserving duplicates. Unknown policy IDs are silently skipped.
+     *
+     * # Arguments
+     *
+     * * `policy_ids` - List of policy IDs to search. Typically
+     *   `result.response.diagnostics.reason` from an authorization result.
+     * * `key` - The annotation key to collect values for (e.g. `"redirect"`).
+     *
+     * # Example
+     *
+     * ```javascript
+     * const redirects = cedarling.annotation_values(result.response.diagnostics.reason, "redirect");
+     * // ["/upgrade"]
+     * ```
+     */
+    annotation_values(policy_ids: string[], key: string): string[];
+    /**
+     * Return the annotations of each given policy, grouped by policy ID
+     * the loss-free companion to `annotations_map`. Unknown policy IDs are
+     * silently skipped.
+     *
+     * # Arguments
+     *
+     * * `policy_ids` - List of policy IDs whose annotations should be returned
+     *   grouped by policy ID. Typically `result.response.diagnostics.reason` from
+     *   an authorization result.
+     *
+     * # Example
+     *
+     * ```javascript
+     * const byPolicy = cedarling.annotations_by_policy(result.response.diagnostics.reason);
+     * // { "5": { redirect: "/upgrade", tier: "premium" } }
+     * ```
+     */
+    annotations_by_policy(policy_ids: string[]): any;
+    /**
+     * Merge the annotations (`@key("value")`) of the given policies into a single object.
+     *
+     * Intended for resolving the determining policies of an authorization decision:
+     * pass `result.response.diagnostics.reason`.
+     *
+     * Lossy: if the same annotation key appears on several policies, one value wins
+     * arbitrarily. Use `annotation_values` / `annotations_by_policy` when duplicates
+     * matter. Unknown policy IDs are silently skipped.
+     *
+     * # Arguments
+     *
+     * * `policy_ids` - List of policy IDs whose annotations should be merged into
+     *   a single object. Typically `result.response.diagnostics.reason` from an
+     *   authorization result.
+     *
+     * # Example
+     *
+     * ```javascript
+     * const annotations = cedarling.annotations_map(result.response.diagnostics.reason);
+     * // { redirect: "/upgrade", tier: "premium" }
+     * ```
+     */
+    annotations_map(policy_ids: string[]): any;
     /**
      * Authorize multi-issuer request.
      * Makes authorization decision based on multiple JWT tokens from different issuers.

package/cedarling_wasm.js

@@ -175,6 +175,122 @@ class Cedarling {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_cedarling_free(ptr, 0);
     }
+    /**
+     * Collect every value of the annotation `key` across the given policies,
+     * preserving duplicates. Unknown policy IDs are silently skipped.
+     *
+     * # Arguments
+     *
+     * * `policy_ids` - List of policy IDs to search. Typically
+     *   `result.response.diagnostics.reason` from an authorization result.
+     * * `key` - The annotation key to collect values for (e.g. `"redirect"`).
+     *
+     * # Example
+     *
+     * ```javascript
+     * const redirects = cedarling.annotation_values(result.response.diagnostics.reason, "redirect");
+     * // ["/upgrade"]
+     * ```
+     * @param {string[]} policy_ids
+     * @param {string} key
+     * @returns {string[]}
+     */
+    annotation_values(policy_ids, key) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArrayJsValueToWasm0(policy_ids, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(key, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.cedarling_annotation_values(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var v3 = getArrayJsValueFromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export5(r0, r1 * 4, 4);
+            return v3;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Return the annotations of each given policy, grouped by policy ID
+     * the loss-free companion to `annotations_map`. Unknown policy IDs are
+     * silently skipped.
+     *
+     * # Arguments
+     *
+     * * `policy_ids` - List of policy IDs whose annotations should be returned
+     *   grouped by policy ID. Typically `result.response.diagnostics.reason` from
+     *   an authorization result.
+     *
+     * # Example
+     *
+     * ```javascript
+     * const byPolicy = cedarling.annotations_by_policy(result.response.diagnostics.reason);
+     * // { "5": { redirect: "/upgrade", tier: "premium" } }
+     * ```
+     * @param {string[]} policy_ids
+     * @returns {any}
+     */
+    annotations_by_policy(policy_ids) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArrayJsValueToWasm0(policy_ids, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.cedarling_annotations_by_policy(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Merge the annotations (`@key("value")`) of the given policies into a single object.
+     *
+     * Intended for resolving the determining policies of an authorization decision:
+     * pass `result.response.diagnostics.reason`.
+     *
+     * Lossy: if the same annotation key appears on several policies, one value wins
+     * arbitrarily. Use `annotation_values` / `annotations_by_policy` when duplicates
+     * matter. Unknown policy IDs are silently skipped.
+     *
+     * # Arguments
+     *
+     * * `policy_ids` - List of policy IDs whose annotations should be merged into
+     *   a single object. Typically `result.response.diagnostics.reason` from an
+     *   authorization result.
+     *
+     * # Example
+     *
+     * ```javascript
+     * const annotations = cedarling.annotations_map(result.response.diagnostics.reason);
+     * // { redirect: "/upgrade", tier: "premium" }
+     * ```
+     * @param {string[]} policy_ids
+     * @returns {any}
+     */
+    annotations_map(policy_ids) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArrayJsValueToWasm0(policy_ids, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.cedarling_annotations_map(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Authorize multi-issuer request.
      * Makes authorization decision based on multiple JWT tokens from different issuers.
@@ -1883,7 +1999,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_8722(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_8746(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -2093,17 +2209,17 @@ function __wbg_get_imports() {
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
             // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 1196, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_12144);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_12170);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
             // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 995, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_8668);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_8691);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
             // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 883, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_8503);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_8526);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000004: function(arg0) {
@@ -2145,18 +2261,18 @@ function __wbg_get_imports() {
     };
 }
 
-function __wasm_bindgen_func_elem_8503(arg0, arg1) {
-    wasm.__wasm_bindgen_func_elem_8503(arg0, arg1);
+function __wasm_bindgen_func_elem_8526(arg0, arg1) {
+    wasm.__wasm_bindgen_func_elem_8526(arg0, arg1);
 }
 
-function __wasm_bindgen_func_elem_12144(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_12144(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_12170(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_12170(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_8668(arg0, arg1, arg2) {
+function __wasm_bindgen_func_elem_8691(arg0, arg1, arg2) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.__wasm_bindgen_func_elem_8668(retptr, arg0, arg1, addHeapObject(arg2));
+        wasm.__wasm_bindgen_func_elem_8691(retptr, arg0, arg1, addHeapObject(arg2));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         if (r1) {
@@ -2167,8 +2283,8 @@ function __wasm_bindgen_func_elem_8668(arg0, arg1, arg2) {
     }
 }
 
-function __wasm_bindgen_func_elem_8722(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_8722(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_8746(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_8746(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 
 
@@ -2394,6 +2510,16 @@ function makeMutClosure(arg0, arg1, f) {
     return real;
 }
 
+function passArrayJsValueToWasm0(array, malloc) {
+    const ptr = malloc(array.length * 4, 4) >>> 0;
+    const mem = getDataViewMemory0();
+    for (let i = 0; i < array.length; i++) {
+        mem.setUint32(ptr + 4 * i, addHeapObject(array[i]), true);
+    }
+    WASM_VECTOR_LEN = array.length;
+    return ptr;
+}
+
 function passStringToWasm0(arg, malloc, realloc) {
     if (realloc === undefined) {
         const buf = cachedTextEncoder.encode(arg);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@janssenproject/cedarling_wasm",
   "description": "The Cedarling is a performant local authorization service that runs the Rust Cedar Engine",
-  "version": "0.0.415-nodejs",
+  "version": "0.0.416-nodejs",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",