@gcoredev/proxy-wasm-sdk-as 1.2.2 → 1.2.3

package/assembly/fastedge/dictionary.ts

@@ -3,11 +3,36 @@ import * as imports from "../imports";
 import { globalArrayBufferReference, WasmResultValues } from "../runtime";
 
 /**
- * Function to get the value for the provided environment variable name.
+ * Reads an environment variable by name using the WASI environment interface.
+ *
+ * Use this for normal-sized environment variables (under 64 KB). For values
+ * that may exceed the WASI 64 KB limit, use {@link getDictionary} instead.
+ *
  * @param {string} name - The name of the environment variable.
- * @returns {string} The value of the environment variable.
+ * @returns {string} The value, or an empty string if not found.
  */
 function getEnv(name: string): string {
+  const hasKey = process.env.has(name);
+  if (hasKey) {
+    return process.env.get(name);
+  }
+  return "";
+}
+
+/**
+ * Reads a dictionary value by name using the proxy-wasm dictionary API
+ * (`proxy_dictionary_get`).
+ *
+ * This bypasses the WASI 64 KB environment variable size limit and should
+ * be used when a value may be larger than 64 KB (e.g. large JSON configs,
+ * PEM certificates, policy documents).
+ *
+ * For normal-sized environment variables, prefer {@link getEnv}.
+ *
+ * @param {string} name - The dictionary key to look up.
+ * @returns {string} The value, or an empty string if not found.
+ */
+function getDictionary(name: string): string {
   const buffer = String.UTF8.encode(name);
   const status = imports.proxy_dictionary_get(
     changetype<usize>(buffer),
@@ -24,4 +49,4 @@ function getEnv(name: string): string {
   return "";
 }
 
-export { getEnv };
+export { getEnv, getDictionary };

package/assembly/fastedge/secrets.ts

@@ -27,7 +27,7 @@ function getSecret(name: string): string {
 /**
  * Function to get the value for the provided secret variable name from a specific slot.
  * @param {string} name - The name of the secret variable.
- * @param {u32} effectiveAt - The slot index of the secret. (effectiveAt >= secret_slots.slot)
+ * @param {u32} effectiveAt - The numeric slot index to retrieve. Slots are defined in the FastEdge UI and are always numeric (e.g. incremental integers, or Date.now()-style values to represent a point in time).
  * @returns {string} The value of the secret variable.
  */
 function getSecretEffectiveAt(name: string, effectiveAt: u32): string {
@@ -60,7 +60,7 @@ function getSecretVar(name: string): string {
 /**
  * @deprecated Use {@link getSecretEffectiveAt} instead. This function will be removed in a future version.
  * @param {string} name - The name of the secret variable.
- * @param {u32} effectiveAt - The slot index of the secret. (effectiveAt >= secret_slots.slot)
+ * @param {u32} effectiveAt - The numeric slot index to retrieve. Slots are defined in the FastEdge UI and are always numeric (e.g. incremental integers, or Date.now()-style values to represent a point in time).
  * @returns {string} The value of the secret variable.
  */
 function getSecretVarEffectiveAt(name: string, effectiveAt: u32): string {

package/assembly/runtime.ts

@@ -490,7 +490,7 @@ class HeaderStreamManipulator {
   }
 
   /**
-   * Replace a header.
+   * Replace a header value. No-op if the header is not present.
    * @param key the header name.
    * @param value the header value.
    */
@@ -1125,7 +1125,7 @@ export function deleteContext(context_id: u32): void {
 /**
  * Register a root context factory and make it available to the runtime.
  * @param root_context_factory A function that creates a new root context.
- * @param name Paremeter kept for backwards compatibility. It will be ignored.
+ * @param name Accepted for API compatibility with the proxy-wasm spec but ignored by the FastEdge runtime. The value does not need to match any configuration — pass any descriptive string.
  */
 export function registerRootContext(
   context_factory: (context_id: u32) => RootContext,

package/package.json

@@ -1,25 +1,18 @@
 {
   "name": "@gcoredev/proxy-wasm-sdk-as",
   "description": "Use this SDK to write extensions for the proxy WASM ABI",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "main": "assembly/index.ts",
   "scripts": {
     "asbuild:debug": "asc assembly/index.ts --target debug",
     "asbuild:release": "asc assembly/index.ts --target release",
     "asbuild": "npm run asbuild:debug && npm run asbuild:release",
-    "server": "ws --log.format dev",
-    "docs": "typedoc"
+    "generate:docs": "./fastedge-plugin-source/generate-docs.sh"
   },
   "devDependencies": {
     "@assemblyscript/wasi-shim": "^0.1.0",
     "@semantic-release/changelog": "^6.0.3",
-    "assemblyscript": "^0.28.9",
-    "http-server": "^14.1.1",
-    "local-web-server": "^5.4.0",
-    "typedoc": "^0.28.16"
-  },
-  "directories": {
-    "doc": "docs"
+    "assemblyscript": "^0.28.9"
   },
   "repository": {
     "type": "git",