@zuplo/runtime 6.66.12 → 6.66.13

package/out/types/index.d.ts

@@ -2994,6 +2994,41 @@ declare interface HeaderCredentialsConfig {
   headerName: string;
 }
 
+/**
+ * Sets HTTP deprecation headers on the outgoing response following the IETF
+ * HTTP Deprecation Header standard. Supports the Deprecation, Sunset, and Link
+ * headers.
+ *
+ * @title HTTP Deprecation
+ * @public
+ * @param response - The Response
+ * @param request - The ZuploRequest
+ * @param context - The ZuploContext
+ * @param options - The policy options set in policies.json
+ * @param policyName - The name of the policy as set in policies.json
+ * @returns A Response with deprecation headers
+ */
+export declare const HttpDeprecationOutboundPolicy: OutboundPolicyHandler<HttpDeprecationOutboundPolicyOptions>;
+
+/**
+ * The options for the HTTP Deprecation outbound policy.
+ * @public
+ */
+export declare interface HttpDeprecationOutboundPolicyOptions {
+  /**
+   * The deprecation value. Use `true` for already deprecated, an ISO 8601 date string for a specific date, or a Unix timestamp number.
+   */
+  deprecation: true | string | number;
+  /**
+   * An ISO 8601 date string indicating when the endpoint will be removed. Sets the Sunset header.
+   */
+  sunset?: string;
+  /**
+   * A URL to documentation about the deprecation or migration guide. Sets the Link header.
+   */
+  link?: string;
+}
+
 /**
  * @public
  */
@@ -7377,7 +7412,9 @@ declare type RateLimitFunction<T extends CustomRateLimitDetailsBase> = (
   policyName: string
 ) =>
   | (Partial<T> & CustomRateLimitDetailsBase)
-  | Promise<Partial<T> & CustomRateLimitDetailsBase>;
+  | undefined
+  | null
+  | Promise<(Partial<T> & CustomRateLimitDetailsBase) | undefined | null>;
 
 /**
  * Adds the retry-after header.
@@ -7476,6 +7513,24 @@ declare type RateLimitHeaderMode_2 = "none" | "retry-after";
  *   }
  * };
  * ```
+ *
+ * @example
+ * ```typescript
+ * // Skip rate limiting for specific conditions (return undefined)
+ * import { CustomRateLimitFunction, CustomRateLimitDetails } from "@zuplo/runtime";
+ *
+ * export const customRateLimitWithSkip: CustomRateLimitFunction = async (
+ *   request,
+ *   context
+ * ): Promise<CustomRateLimitDetails | undefined> => {
+ *   // Skip rate limiting for whitelisted IPs or internal services
+ *   const clientIp = request.headers.get("cf-connecting-ip");
+ *   if (isWhitelisted(clientIp)) {
+ *     return undefined;  // Skip rate limiting entirely - no Redis call
+ *   }
+ *   return { key: `user-${request.user?.sub}` };
+ * };
+ * ```
  */
 declare const RateLimitInboundPolicy: InboundPolicyHandler<RateLimitInboundPolicyOptions>;
 export { RateLimitInboundPolicy as BasicRateLimitInboundPolicy };

package/package.json

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