@zuplo/runtime 6.59.6 → 6.59.7

package/out/esm/mocks/index.js

@@ -22,4 +22,4 @@
  *  DEALINGS IN THE SOFTWARE.
  *--------------------------------------------------------------------------------------------*/
     
-import{Z as n,a as t}from"../chunk-SSAQ7DDU.js";function m(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(m,"createMockContext");var l={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;constructor({event:e,route:o=l,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}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 d=t(i=>{try{typeof o=="function"?o(i):o.handleEvent(i)}catch(p){throw this.log.error(`Error invoking event ${e}. See following logs for details.`),p}},"wrapped");super.addEventListener(e,d,r)}};export{s as MockZuploContext,m as createMockContext};
+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};

package/out/types/index.d.ts

@@ -4,6 +4,32 @@ import { RequestGeneric as RequestGeneric_2 } from "../../request.js";
 import type { ValidateFunction } from "ajv";
 import { z } from "zod/v4";
 
+/**
+ * Handler that routes AI/LLM requests through Zuplo's LLM Translation Layer.
+ * This handler forwards requests to the translation layer that handles provider-specific
+ * API transformations, parameter validation, and response normalization to provide
+ * a unified OpenAI-compatible interface across multiple LLM providers.
+ *
+ * @param request - The incoming ZuploRequest containing AI/LLM API call
+ * @param context - The ZuploContext containing route configuration
+ * @returns A Response from the AI provider via the translation layer
+ *
+ * @public
+ * @example
+ * ```json
+ * {
+ *   "handler": {
+ *     "export": "aiGatewayHandler",
+ *     "module": "$import(@zuplo/runtime)"
+ *   }
+ * }
+ * ```
+ */
+export declare function aiGatewayHandler(
+  request: ZuploRequest,
+  context: ZuploContext
+): Promise<Response>;
+
 /**
  * Entry format for Akamai API Security logger
  * @public
@@ -2191,6 +2217,12 @@ export declare interface ErrorHandler {
   ): Response | Promise<Response>;
 }
 
+declare const EventType: {
+  readonly MCP_TOOL_USAGE: "mcp_tool_usage";
+};
+
+declare type EventType = (typeof EventType)[keyof typeof EventType];
+
 declare interface FetchOptions<T> {
   method?: HttpMethod_2;
   data?: T;
@@ -4415,6 +4447,26 @@ declare type Iso3166Alpha2Code =
   | "ZM"
   | "ZW";
 
+declare type JsonArray = JsonValue[] | readonly JsonValue[];
+
+/**
+ Matches a JSON object.
+ This type can be useful to enforce some input to be JSON-compatible or as a super-type to be extended from. Don't use this as a direct return type as the user would have to double-cast it: `jsonObject as unknown as CustomResponse`. Instead, you could extend your CustomResponse type from it to ensure your type only uses JSON-compatible types: `interface CustomResponse extends JsonObject { … }`.
+ */
+declare type JsonObject = {
+  [Key in string]: JsonValue;
+} & {
+  [Key in string]?: JsonValue | undefined;
+};
+
+declare type JsonPrimitive = string | number | boolean | null;
+
+/**
+ Matches any valid JSON value.
+ @see `Jsonify` if you need to transform a type to one that is assignable to `JsonValue`.
+ */
+declare type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+
 /**
  * Validates that the JWT token includes specific scopes
  *
@@ -9086,6 +9138,29 @@ export declare class ZoneCache<T = any> {
   logDebug(...messages: unknown[]): void;
 }
 
+declare interface ZuploAnalyticsContext {
+  addAnalyticsEvent(
+    value: number,
+    eventType: EventType,
+    metadata: JsonObject,
+    unit?: string
+  ): void;
+  getAnalyticsEvents(): ZuploAnalyticsEvent[];
+}
+
+declare interface ZuploAnalyticsEvent<T extends JsonObject = JsonObject> {
+  eventId: string;
+  requestId: string;
+  timestamp: Date;
+  accountName: string;
+  projectName: string;
+  deploymentName: string;
+  eventType: EventType;
+  metadata: T;
+  unit?: string;
+  value: number;
+}
+
 /**
  * The ZuploContext provides information about the current request and helper methods.
  * @public
@@ -9117,6 +9192,7 @@ export declare interface ZuploContext extends EventTarget {
    * @beta
    */
   readonly parentContext: ZuploContext | undefined;
+  /* Excluded from this release type: analyticsContext */
   readonly invokeInboundPolicy: (
     policyName: string,
     request: ZuploRequest

package/out/types/mocks/index.d.ts

@@ -65,6 +65,12 @@ export declare function createMockContext(options?: {
   invokeResponse: () => Promise<void>;
 };
 
+declare const EventType: {
+  readonly MCP_TOOL_USAGE: "mcp_tool_usage";
+};
+
+declare type EventType = (typeof EventType)[keyof typeof EventType];
+
 /**
  * @public
  */
@@ -754,6 +760,26 @@ declare type Iso3166Alpha2Code =
   | "ZM"
   | "ZW";
 
+declare type JsonArray = JsonValue[] | readonly JsonValue[];
+
+/**
+ Matches a JSON object.
+ This type can be useful to enforce some input to be JSON-compatible or as a super-type to be extended from. Don't use this as a direct return type as the user would have to double-cast it: `jsonObject as unknown as CustomResponse`. Instead, you could extend your CustomResponse type from it to ensure your type only uses JSON-compatible types: `interface CustomResponse extends JsonObject { … }`.
+ */
+declare type JsonObject = {
+  [Key in string]: JsonValue;
+} & {
+  [Key in string]?: JsonValue | undefined;
+};
+
+declare type JsonPrimitive = string | number | boolean | null;
+
+/**
+ Matches any valid JSON value.
+ @see `Jsonify` if you need to transform a type to one that is assignable to `JsonValue`.
+ */
+declare type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+
 /**
  * @beta
  */
@@ -781,6 +807,7 @@ export declare class MockZuploContext
   readonly custom: Record<string, any>;
   readonly incomingRequestProperties: IncomingRequestProperties;
   readonly parentContext: ZuploContext | undefined;
+  readonly analyticsContext: ZuploAnalyticsContext;
   constructor({
     event,
     route,
@@ -1517,6 +1544,29 @@ declare interface WaitUntilFunc {
   (promise: Promise<any>): void;
 }
 
+declare interface ZuploAnalyticsContext {
+  addAnalyticsEvent(
+    value: number,
+    eventType: EventType,
+    metadata: JsonObject,
+    unit?: string
+  ): void;
+  getAnalyticsEvents(): ZuploAnalyticsEvent[];
+}
+
+declare interface ZuploAnalyticsEvent<T extends JsonObject = JsonObject> {
+  eventId: string;
+  requestId: string;
+  timestamp: Date;
+  accountName: string;
+  projectName: string;
+  deploymentName: string;
+  eventType: EventType;
+  metadata: T;
+  unit?: string;
+  value: number;
+}
+
 /**
  * The ZuploContext provides information about the current request and helper methods.
  * @public
@@ -1548,6 +1598,7 @@ declare interface ZuploContext extends EventTarget {
    * @beta
    */
   readonly parentContext: ZuploContext | undefined;
+  /* Excluded from this release type: analyticsContext */
   readonly invokeInboundPolicy: (
     policyName: string,
     request: ZuploRequest

package/package.json

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