@zuplo/runtime 6.40.20 → 6.40.22

package/out/types/index.d.ts

@@ -5076,6 +5076,60 @@ export declare interface SleepInboundPolicyOptions {
 
 /* Excluded from this release type: StandardEnv */
 
+/**
+ * The StreamingZoneCache is a wrapper around the zone cache that allows
+ * storing a ReadableStream by wrapping it in a Response. The key
+ * is stored as the request URL for retrieval later.
+ * @beta This is a beta feature and may change in the future.
+ */
+export declare class StreamingZoneCache {
+    #private;
+    /**
+     * Construct a new StreamingZoneCache with a ZuploContext.
+     * This will log debug messages using the provided context.
+     * @param name - The name of the cache
+     * @param context - The ZuploContext to use
+     */
+    constructor(name: string, context: ZuploContext);
+    /**
+     * Construct a new StreamingZoneCache with CacheOptions.
+     * Useful if the system is constructing this behind the scenes.
+     * @param name - The name of the cache
+     * @param context - The CacheOptions to use
+     */
+    constructor(name: string, options: CacheOptions);
+    /**
+     * Retrieve a stream from the cache. If not found or expired, returns undefined.
+     * Otherwise, returns the ReadableStream from the cached Response body.
+     * @param key - The key to retrieve from the cache
+     */
+    get(key: string): Promise<ReadableStream<Uint8Array> | undefined>;
+    /**
+     * Store a stream in the cache for a given TTL (in seconds). We wrap it in a Response
+     * with a custom expiry header so we can handle local expiry.
+     * @param key - The key to store in the cache
+     * @param stream - The stream to store
+     * @param ttlSeconds - The time-to-live in seconds
+     */
+    put(key: string, stream: ReadableStream<Uint8Array>, ttlSeconds: number): Promise<void>;
+    /**
+     * Remove an entry from the cache if it exists. If there's an error, we try a fallback
+     * approach that sets the local expiry to now.
+     * @param key - The key to delete from the cache
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * In case we can't properly delete from the cache,
+     * we overwrite it with an empty, immediately-expired Response.
+     * @param key - The key to delete from the cache
+     */
+    private deleteFallback;
+    /**
+     * Log internal debug messages to either the ZuploContext logger or the console.
+     */
+    private logDebug;
+}
+
 /**
  * Adds stripe monetization routes and configuration
  * @beta

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zuplo/runtime",
   "type": "module",
-  "version": "6.40.20",
+  "version": "6.40.22",
   "repository": "https://github.com/zuplo/zuplo",
   "author": "Zuplo, Inc.",
   "exports": {