@zuplo/runtime 6.59.7 → 6.59.9

package/out/esm/internal/index.js

@@ -22,4 +22,4 @@
  *  DEALINGS IN THE SOFTWARE.
  *--------------------------------------------------------------------------------------------*/
     
-import{b as e,c as t,e as a,f as o,g as r,h as i,i as n}from"../chunk-ABYPZMH4.js";import"../chunk-SSAQ7DDU.js";export{o as getIdForParameterSchema,i as getIdForRefSchema,r as getIdForRequestBodySchema,a as getRawOperationDataIdentifierName,e as isRestrictedEnvVariableName,t as isZuploReadableEnvVariableName,n as sanitizedIdentifierName};
+import{b as e,c as t,e as a,f as o,g as r,h as i,i as n}from"../chunk-V5YKH6RW.js";import"../chunk-B77APQ6Y.js";export{o as getIdForParameterSchema,i as getIdForRefSchema,r as getIdForRequestBodySchema,a as getRawOperationDataIdentifierName,e as isRestrictedEnvVariableName,t as isZuploReadableEnvVariableName,n as sanitizedIdentifierName};

package/out/esm/mocks/index.js

@@ -22,4 +22,4 @@
  *  DEALINGS IN THE SOFTWARE.
  *--------------------------------------------------------------------------------------------*/
     
-import{a as p}from"../chunk-7X7Y6YCS.js";import{Z as n,a as t}from"../chunk-SSAQ7DDU.js";function g(u={request:new Request("https://api.example.com")}){let e=[];function o(i){e.push(Promise.resolve(i))}return t(o,"waitUntil"),{context:new s({event:{waitUntil:o},route:u.route}),invokeResponse:t(async()=>{await Promise.all(e)},"invokeResponse")}}t(g,"createMockContext");var a={path:"/",methods:["GET"],handler:{module:{},export:"default"},raw:t(()=>({}),"raw")},s=class extends EventTarget{static{t(this,"MockZuploContext")}#e;contextId;requestId;log;route;custom;incomingRequestProperties;parentContext;analyticsContext;constructor({event:e,route:o=a,parentContext:r}){super(),this.requestId=crypto.randomUUID(),this.contextId=crypto.randomUUID(),this.log={info:n.console.info,log:n.console.log,debug:n.console.debug,warn:n.console.warn,error:n.console.error},this.custom={},this.route=o,this.incomingRequestProperties={asn:1234,asOrganization:"ORGANIZATION",city:"Seattle",region:"Washington",regionCode:"WA",colo:"SEA",continent:"NA",country:"US",postalCode:"98004",metroCode:"SEA",latitude:void 0,longitude:void 0,timezone:void 0,httpProtocol:void 0},this.parentContext=r,this.#e=e,this.analyticsContext=new p(this.requestId)}waitUntil(e){this.#e.waitUntil(e)}invokeInboundPolicy(e,o){throw new Error("Not implemented")}invokeOutboundPolicy(e,o,r){throw new Error("Not implemented")}invokeRoute(e,o){throw new Error("Not implemented")}addResponseSendingHook(e){throw new Error("Not implemented")}addResponseSendingFinalHook(e){throw new Error("Not implemented")}addEventListener(e,o,r){let l=t(i=>{try{typeof o=="function"?o(i):o.handleEvent(i)}catch(d){throw this.log.error(`Error invoking event ${e}. See following logs for details.`),d}},"wrapped");super.addEventListener(e,l,r)}};export{s as MockZuploContext,g as createMockContext};
+import{a as p}from"../chunk-QROYR45R.js";import{Z as n,a as t}from"../chunk-B77APQ6Y.js";function g(u={request:new Request("https://api.example.com")}){let e=[];function o(i){e.push(Promise.resolve(i))}return t(o,"waitUntil"),{context:new s({event:{waitUntil:o},route:u.route}),invokeResponse:t(async()=>{await Promise.all(e)},"invokeResponse")}}t(g,"createMockContext");var a={path:"/",methods:["GET"],handler:{module:{},export:"default"},raw:t(()=>({}),"raw")},s=class extends EventTarget{static{t(this,"MockZuploContext")}#e;contextId;requestId;log;route;custom;incomingRequestProperties;parentContext;analyticsContext;constructor({event:e,route:o=a,parentContext:r}){super(),this.requestId=crypto.randomUUID(),this.contextId=crypto.randomUUID(),this.log={info:n.console.info,log:n.console.log,debug:n.console.debug,warn:n.console.warn,error:n.console.error},this.custom={},this.route=o,this.incomingRequestProperties={asn:1234,asOrganization:"ORGANIZATION",city:"Seattle",region:"Washington",regionCode:"WA",colo:"SEA",continent:"NA",country:"US",postalCode:"98004",metroCode:"SEA",latitude:void 0,longitude:void 0,timezone:void 0,httpProtocol:void 0},this.parentContext=r,this.#e=e,this.analyticsContext=new p(this.requestId)}waitUntil(e){this.#e.waitUntil(e)}invokeInboundPolicy(e,o){throw new Error("Not implemented")}invokeOutboundPolicy(e,o,r){throw new Error("Not implemented")}invokeRoute(e,o){throw new Error("Not implemented")}addResponseSendingHook(e){throw new Error("Not implemented")}addResponseSendingFinalHook(e){throw new Error("Not implemented")}addEventListener(e,o,r){let l=t(i=>{try{typeof o=="function"?o(i):o.handleEvent(i)}catch(d){throw this.log.error(`Error invoking event ${e}. See following logs for details.`),d}},"wrapped");super.addEventListener(e,l,r)}};export{s as MockZuploContext,g as createMockContext};

package/out/types/index.d.ts

@@ -4,6 +4,100 @@ import { RequestGeneric as RequestGeneric_2 } from "../../request.js";
 import type { ValidateFunction } from "ajv";
 import { z } from "zod/v4";
 
+/**
+ * Authenticates an AI Gateway Application requests based on Application API Keys
+ * using Zuplo's Gateway service.
+ * This policy validates API keys against the Api keys bucket, fetches configuration data,
+ * caches results for performance, and automatically adds user information to
+ * authenticated requests.
+ * @hidden
+ * @title AI Gateway Authentication
+ * @public
+ *
+ * @param request - The incoming ZuploRequest
+ * @param context - The ZuploContext
+ * @param unparsedOptions - The policy configuration options
+ * @param policyName - The name of the policy instance
+ * @returns The authenticated request with user info, or a 401 response if unauthorized
+ *
+ * @example
+ * ```json
+ * // policies.json - Basic AI Gateway authentication
+ * {
+ *   "name": "ai-gateway-auth",
+ *   "policyType": "ai-gateway-auth-inbound",
+ *   "handler": {
+ *     "export": "AIGatewayAuthInboundPolicy",
+ *     "module": "$import(@zuplo/runtime)",
+ *     "options": {
+ *        "cacheTtlSeconds": 300
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```json
+ * // Custom header and auth scheme
+ * {
+ *   "handler": {
+ *     "export": "AIGatewayAuthInboundPolicy",
+ *     "module": "$import(@zuplo/runtime)",
+ *     "options": {
+ *       "authHeader": "x-api-key",
+ *       "authScheme": ""
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Access authenticated user data in handler
+ * export function myHandler(request: ZuploRequest, context: ZuploContext) {
+ *   // User is automatically added by AI Gateway policy
+ *   const user = request.user;
+ *   context.log.info(`Request from API key: ${user.sub}`);
+ *
+ *   // Access AI Gateway configuration and metadata
+ *   const userData = user.data as {
+ *     metadata: Record<string, unknown>;
+ *     configuration: Record<string, unknown>;
+ *   };
+ *
+ *   return Response.json({
+ *     message: `Hello ${user.sub}`,
+ *     config: userData.configuration
+ *   });
+ * }
+ * ```
+ */
+export declare function AIGatewayAuthInboundPolicy(
+  request: ZuploRequest,
+  context: ZuploContext,
+  unparsedOptions: AIGatewayAuthInboundPolicyOptions,
+  policyName: string
+): Promise<Response | ZuploRequest<RequestGeneric_2>>;
+
+/**
+ * The options for this policy.
+ * @public
+ */
+export declare interface AIGatewayAuthInboundPolicyOptions {
+  /**
+   * The name of the header with the key.
+   */
+  authHeader?: string;
+  /**
+   * The scheme used on the header.
+   */
+  authScheme?: string;
+  /**
+   * The time to cache authentication results for a particular key. Higher values will decrease latency. Cached results will be valid until the cache expires even in the event the key is deleted, etc.
+   */
+  cacheTtlSeconds?: number;
+}
+
 /**
  * Handler that routes AI/LLM requests through Zuplo's LLM Translation Layer.
  * This handler forwards requests to the translation layer that handles provider-specific
@@ -30,6 +124,57 @@ export declare function aiGatewayHandler(
   context: ZuploContext
 ): Promise<Response>;
 
+/* Excluded from this release type: AIGatewayMeterIncrements */
+
+/**
+ * AI Gateway Metering policy for quota enforcement
+ *
+ * @title AI Gateway Metering
+ * @hidden
+ * @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 Request or a Response
+ */
+export declare class AIGatewayMeteringInboundPolicy extends InboundPolicy<AIGatewayMeteringInboundPolicyOptions> {
+  /**
+   * Set the meter increments for the current request.
+   *
+   * @param context - The ZuploContext
+   * @param increments - The increments to set.
+   */
+  static setIncrements(
+    context: ZuploContext,
+    increments: AIGatewayMeterIncrements
+  ): void;
+  static getIncrements(context: ZuploContext): AIGatewayMeterIncrements;
+  constructor(
+    options: AIGatewayMeteringInboundPolicyOptions,
+    policyName: string
+  );
+  handler(
+    request: ZuploRequest,
+    context: ZuploContext
+  ): Promise<Response | ZuploRequest<RequestGeneric_2>>;
+  private fetchCurrentMeters;
+  private incrementMeters;
+  private checkQuotas;
+  private checkQuotaLimit;
+  private createQuotaExceededResponse;
+}
+
+/**
+ * The options for this policy.
+ * @public
+ */
+export declare interface AIGatewayMeteringInboundPolicyOptions {
+  /**
+   * If true, the policy will throw an error in the event there is a problem connecting to the metering service.
+   */
+  throwOnFailure?: boolean;
+}
+
 /**
  * Entry format for Akamai API Security logger
  * @public

package/package.json

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