@zuplo/runtime 7.11.4 → 7.11.6

package/out/esm/mocks/index.js

@@ -22,5 +22,5 @@
  *  DEALINGS IN THE SOFTWARE.
  *--------------------------------------------------------------------------------------------*/
     
-import{E as p,J as c,M as u}from"../chunk-3RVZUQKN.js";import"../chunk-NUVXDVLJ.js";import{a as d}from"../chunk-QGAJTUPE.js";import"../chunk-A3QGJZO7.js";import"../chunk-CDEAY3VY.js";import{aa as i}from"../chunk-LVSZ3WTO.js";import{a as o}from"../chunk-TYV53J3B.js";function w(l={request:new Request("https://api.example.com")}){let e=[];function t(s){e.push(Promise.resolve(s))}return o(t,"waitUntil"),{context:new a({event:{waitUntil:t},route:l.route,originalRequest:l.request}),invokeResponse:o(async()=>{await Promise.all(e)},"invokeResponse")}}o(w,"createMockContext");var g={path:"/",methods:["GET"],handler:{module:{},export:"default"},raw:o(()=>({}),"raw")},a=class extends EventTarget{static{o(this,"MockZuploContext")}#e;#t;contextId;requestId;log;route;custom;incomingRequestProperties;parentContext;analyticsContext;constructor({event:e,route:t=g,parentContext:n,originalRequest:r}){super(),this.requestId=crypto.randomUUID(),this.contextId=crypto.randomUUID(),this.log={info:i.console.info,log:i.console.log,debug:i.console.debug,warn:i.console.warn,error:i.console.error,setLogProperties:o(()=>{},"setLogProperties")},this.custom={},this.route=t,this.incomingRequestProperties={ip:"203.0.113.7",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,clientCert:void 0,clientMtlsVerificationStatus:void 0,clientMtlsVerificationReason:void 0,clientCertFingerprintSha256:void 0,clientCertNotBefore:void 0,clientCertNotAfter:void 0,clientCertIssuerDn:void 0,clientCertSubjectDn:void 0},this.parentContext=n,this.#e=e,this.#t=r,this.analyticsContext=new c(this.requestId)}waitUntil(e){this.#e.waitUntil(e)}invokeInboundPolicy(e,t){throw new Error("Not implemented")}invokeOutboundPolicy(e,t,n){throw new Error("Not implemented")}invokeRoute(e,t){throw new Error("Not implemented")}addResponseSendingHook(e){throw new Error("Not implemented")}addResponseSendingFinalHook(e){throw new Error("Not implemented")}addPreRequestHandler(e,t){let n;try{n=u.getContextExtensions(this)}catch{n=u.initialize(this,new d(this.#t??new Request("https://api.example.com")))}n.preRequestPhase??="active",p(this,n,e,t)}get preRequestHandlers(){let e;try{e=u.getContextExtensions(this)}catch{return[]}return(e.preRequestState?.entries??[]).map(t=>({policyName:t.policyName,name:t.name}))}addEventListener(e,t,n){let r=o(s=>{try{typeof t=="function"?t(s):t.handleEvent(s)}catch(m){throw this.log.error(`Error invoking event ${e}. See following logs for details.`),m}},"wrapped");super.addEventListener(e,r,n)}};export{a as MockZuploContext,w as createMockContext};
+import{E as p,J as c,M as u}from"../chunk-5SHD5VGF.js";import"../chunk-NUVXDVLJ.js";import{a as d}from"../chunk-QGAJTUPE.js";import"../chunk-A3QGJZO7.js";import"../chunk-CDEAY3VY.js";import{aa as i}from"../chunk-LVSZ3WTO.js";import{a as o}from"../chunk-TYV53J3B.js";function w(l={request:new Request("https://api.example.com")}){let e=[];function t(s){e.push(Promise.resolve(s))}return o(t,"waitUntil"),{context:new a({event:{waitUntil:t},route:l.route,originalRequest:l.request}),invokeResponse:o(async()=>{await Promise.all(e)},"invokeResponse")}}o(w,"createMockContext");var g={path:"/",methods:["GET"],handler:{module:{},export:"default"},raw:o(()=>({}),"raw")},a=class extends EventTarget{static{o(this,"MockZuploContext")}#e;#t;contextId;requestId;log;route;custom;incomingRequestProperties;parentContext;analyticsContext;constructor({event:e,route:t=g,parentContext:n,originalRequest:r}){super(),this.requestId=crypto.randomUUID(),this.contextId=crypto.randomUUID(),this.log={info:i.console.info,log:i.console.log,debug:i.console.debug,warn:i.console.warn,error:i.console.error,setLogProperties:o(()=>{},"setLogProperties"),setRequestProperties:o(()=>{},"setRequestProperties")},this.custom={},this.route=t,this.incomingRequestProperties={ip:"203.0.113.7",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,clientCert:void 0,clientMtlsVerificationStatus:void 0,clientMtlsVerificationReason:void 0,clientCertFingerprintSha256:void 0,clientCertNotBefore:void 0,clientCertNotAfter:void 0,clientCertIssuerDn:void 0,clientCertSubjectDn:void 0},this.parentContext=n,this.#e=e,this.#t=r,this.analyticsContext=new c(this.requestId)}waitUntil(e){this.#e.waitUntil(e)}invokeInboundPolicy(e,t){throw new Error("Not implemented")}invokeOutboundPolicy(e,t,n){throw new Error("Not implemented")}invokeRoute(e,t){throw new Error("Not implemented")}addResponseSendingHook(e){throw new Error("Not implemented")}addResponseSendingFinalHook(e){throw new Error("Not implemented")}addPreRequestHandler(e,t){let n;try{n=u.getContextExtensions(this)}catch{n=u.initialize(this,new d(this.#t??new Request("https://api.example.com")))}n.preRequestPhase??="active",p(this,n,e,t)}get preRequestHandlers(){let e;try{e=u.getContextExtensions(this)}catch{return[]}return(e.preRequestState?.entries??[]).map(t=>({policyName:t.policyName,name:t.name}))}addEventListener(e,t,n){let r=o(s=>{try{typeof t=="function"?t(s):t.handleEvent(s)}catch(m){throw this.log.error(`Error invoking event ${e}. See following logs for details.`),m}},"wrapped");super.addEventListener(e,r,n)}};export{a as MockZuploContext,w as createMockContext};
 //# sourceMappingURL=index.js.map

package/out/esm/mocks/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["@zuplo/runtime/mocks/context.ts"],"mappings":"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","names":["createMockContext","options","waitUntilPromises","waitUntil","promise","__name","MockZuploContext","DEFAULT_ROUTE_CONFIG","#event","#originalRequest","event","route","parentContext","originalRequest","internals_default","ZuploGatewayAnalyticsContext","policyName","request","response","input","init","hook","handler","ext","ZuploContextExtensions","ZuploRequest","registerPreRequestHandler","entry","type","wrapped","e","err"]}
+{"version":3,"sources":["@zuplo/runtime/mocks/context.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;0QAkCO,SAASA,EACdC,EAA6D,CAC3D,QAAS,IAAI,QAAQ,yBAAyB,CAChD,EACA,CACA,IAAMC,EAAwC,CAAC,EAG/C,SAASC,EAAUC,EAA6B,CAC9CF,EAAkB,KAAK,QAAQ,QAAQE,CAAO,CAAC,CACjD,CAFS,OAAAC,EAAAF,EAAA,aAcF,CAAE,QAVO,IAAIG,EAAiB,CACnC,MAAO,CAAE,UAAAH,CAAU,EACnB,MAAOF,EAAQ,MACf,gBAAiBA,EAAQ,OAC3B,CAAC,EAMiB,eAJKI,EAAA,SAAY,CACjC,MAAM,QAAQ,IAAIH,CAAiB,CACrC,EAFuB,iBAIU,CACnC,CAvBgBG,EAAAL,EAAA,qBAyBhB,IAAMO,EAA2C,CAC/C,KAAM,IACN,QAAS,CAAC,KAAK,EACf,QAAS,CACP,OAAQ,CAAC,EACT,OAAQ,SACV,EACA,IAAKF,EAAA,KAAU,CAAC,GAAX,MACP,EAMaC,EAAN,cAA+B,WAAoC,CAzE1E,MAyE0E,CAAAD,EAAA,yBAC/DG,GACAC,GACA,UACA,UACA,IACA,MAEA,OACA,0BACA,cACA,iBAET,YAAY,CACV,MAAAC,EACA,MAAAC,EAAQJ,EACR,cAAAK,EACA,gBAAAC,CACF,EAUG,CACD,MAAM,EACN,KAAK,UAAY,OAAO,WAAW,EACnC,KAAK,UAAY,OAAO,WAAW,EAEnC,KAAK,IAAM,CACT,KAAMC,EAAU,QAAQ,KACxB,IAAKA,EAAU,QAAQ,IACvB,MAAOA,EAAU,QAAQ,MACzB,KAAMA,EAAU,QAAQ,KACxB,MAAOA,EAAU,QAAQ,MACzB,iBAAkBT,EAAA,IAAM,CAAC,EAAP,oBAClB,qBAAsBA,EAAA,IAAM,CAAC,EAAP,uBACxB,EACA,KAAK,OAAS,CAAC,EACf,KAAK,MAAQM,EACb,KAAK,0BAA4B,CAC/B,GAAI,cACJ,IAAK,KACL,eAAgB,eAChB,KAAM,UACN,OAAQ,aACR,WAAY,KACZ,KAAM,MACN,UAAW,KACX,QAAS,KACT,WAAY,QACZ,UAAW,MACX,SAAU,OACV,UAAW,OACX,SAAU,OACV,aAAc,OACd,WAAY,OACZ,6BAA8B,OAC9B,6BAA8B,OAC9B,4BAA6B,OAC7B,oBAAqB,OACrB,mBAAoB,OACpB,mBAAoB,OACpB,oBAAqB,MACvB,EACA,KAAK,cAAgBC,EACrB,KAAKJ,GAASE,EACd,KAAKD,GAAmBI,EACxB,KAAK,iBAAmB,IAAIE,EAA6B,KAAK,SAAS,CACzE,CAGA,UAAUX,EAAuB,CAC/B,KAAKI,GAAO,UAAUJ,CAAO,CAC/B,CAEA,oBACEY,EACAC,EACkC,CAClC,MAAM,IAAI,MAAM,iBAAiB,CACnC,CAEA,qBACED,EACAE,EACAD,EACmB,CACnB,MAAM,IAAI,MAAM,iBAAiB,CACnC,CAEA,YACEE,EACAC,EACmB,CACnB,MAAM,IAAI,MAAM,iBAAiB,CACnC,CAKA,uBAAuBC,EAAmC,CACxD,MAAM,IAAI,MAAM,iBAAiB,CACnC,CAKA,4BAA4BA,EAAwC,CAClE,MAAM,IAAI,MAAM,iBAAiB,CACnC,CAQA,qBACEC,EACArB,EACM,CAIN,IAAIsB,EACJ,GAAI,CACFA,EAAMC,EAAuB,qBAAqB,IAAI,CACxD,MAAQ,CACND,EAAMC,EAAuB,WAC3B,KACA,IAAIC,EACF,KAAKhB,IAAoB,IAAI,QAAQ,yBAAyB,CAChE,CACF,CACF,CAKAc,EAAI,kBAAoB,SACxBG,EAA0B,KAAMH,EAAKD,EAASrB,CAAO,CACvD,CAgBA,IAAI,oBAAyE,CAC3E,IAAIsB,EACJ,GAAI,CACFA,EAAMC,EAAuB,qBAAqB,IAAI,CACxD,MAAQ,CACN,MAAO,CAAC,CACV,CACA,OAAQD,EAAI,iBAAiB,SAAW,CAAC,GAAG,IAAKI,IAAW,CAC1D,WAAYA,EAAM,WAClB,KAAMA,EAAM,IACd,EAAE,CACJ,CAES,iBACPC,EACAN,EACArB,EACM,CACN,IAAM4B,EAA8CxB,EAACyB,GAAM,CACzD,GAAI,CACF,OAAOR,GAAY,WAAaA,EAAQQ,CAAC,EAAIR,EAAQ,YAAYQ,CAAC,CACpE,OAASC,EAAK,CACZ,WAAK,IAAI,MACP,wBAAwBH,CAAI,mCAC9B,EACMG,CACR,CACF,EAToD,WAUpD,MAAM,iBAAiBH,EAAMC,EAAS5B,CAAO,CAC/C,CACF","names":["createMockContext","options","waitUntilPromises","waitUntil","promise","__name","MockZuploContext","DEFAULT_ROUTE_CONFIG","#event","#originalRequest","event","route","parentContext","originalRequest","internals_default","ZuploGatewayAnalyticsContext","policyName","request","response","input","init","hook","handler","ext","ZuploContextExtensions","ZuploRequest","registerPreRequestHandler","entry","type","wrapped","e","err"]}

package/out/types/index.d.ts

@@ -8658,6 +8658,44 @@ export declare interface Logger extends SystemLogger {
   setLogProperties?(
     properties: Record<string, string | number | boolean>
   ): void;
+  /**
+   * Attach properties to this request's row in Zuplo's request log, the one
+   * row per request that analytics and the request details view read.
+   *
+   * This differs from `setLogProperties`, which adds fields to every log
+   * entry (each `context.log.info(...)` line) that log plugins ship. Use
+   * `setRequestProperties` to label the request itself, for example with a
+   * tenant ID, a feature flag or an experiment variant.
+   *
+   * Each call merges into the properties already set for this request, and a
+   * later value for the same key overwrites an earlier one. Numbers and
+   * booleans are stored as strings, and `null` or `undefined` values are
+   * skipped. A request made with `context.invokeRoute` has a row of its own,
+   * so properties set while it runs land on that row, not on the caller's.
+   *
+   * To keep rows small, a request holds at most 64 properties, a key can be
+   * at most 128 characters, and a value at most 2048 characters. A longer
+   * value is truncated, and a property over the other limits is dropped. The
+   * method never throws.
+   *
+   * @param properties - Key-value pairs to attach to the request's log row.
+   *
+   * @example
+   * ```ts
+   * export default async function (request: ZuploRequest, context: ZuploContext) {
+   *   context.log.setRequestProperties({
+   *     tenantId: request.user?.data.tenantId,
+   *     pricingExperiment: "variant-b",
+   *     cached: false,
+   *   });
+   *
+   *   return new Response("ok");
+   * }
+   * ```
+   */
+  setRequestProperties(
+    properties: Record<string, string | number | boolean | undefined | null>
+  ): void;
 }
 
 /* Excluded from this release type: LoggingContext */
@@ -10745,6 +10783,18 @@ declare interface MetricsData {
   parentContextId?: string;
   requestId: string;
   parentRequestId?: string;
+  /**
+   * The full URL, query string included, of the request as the gateway
+   * received it for this route invocation. For a request made with
+   * `context.invokeRoute` this is the invoked URL, for example
+   * `http://localhost/some/path`.
+   */
+  url?: string;
+  /**
+   * Free-form properties attached with `context.log.setRequestProperties`.
+   * Omitted when none were set.
+   */
+  properties?: Record<string, string>;
   routePath: string;
   systemRouteName?: string;
   method: HttpMethod;

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

@@ -1058,6 +1058,44 @@ declare interface Logger extends BaseLogger {
   setLogProperties?(
     properties: Record<string, string | number | boolean>
   ): void;
+  /**
+   * Attach properties to this request's row in Zuplo's request log, the one
+   * row per request that analytics and the request details view read.
+   *
+   * This differs from `setLogProperties`, which adds fields to every log
+   * entry (each `context.log.info(...)` line) that log plugins ship. Use
+   * `setRequestProperties` to label the request itself, for example with a
+   * tenant ID, a feature flag or an experiment variant.
+   *
+   * Each call merges into the properties already set for this request, and a
+   * later value for the same key overwrites an earlier one. Numbers and
+   * booleans are stored as strings, and `null` or `undefined` values are
+   * skipped. A request made with `context.invokeRoute` has a row of its own,
+   * so properties set while it runs land on that row, not on the caller's.
+   *
+   * To keep rows small, a request holds at most 64 properties, a key can be
+   * at most 128 characters, and a value at most 2048 characters. A longer
+   * value is truncated, and a property over the other limits is dropped. The
+   * method never throws.
+   *
+   * @param properties - Key-value pairs to attach to the request's log row.
+   *
+   * @example
+   * ```ts
+   * export default async function (request: ZuploRequest, context: ZuploContext) {
+   *   context.log.setRequestProperties({
+   *     tenantId: request.user?.data.tenantId,
+   *     pricingExperiment: "variant-b",
+   *     cached: false,
+   *   });
+   *
+   *   return new Response("ok");
+   * }
+   * ```
+   */
+  setRequestProperties(
+    properties: Record<string, string | number | boolean | undefined | null>
+  ): void;
 }
 
 declare type Modify<T, R> = Omit<T, keyof R> & R;

package/out/types/mcp/messages/index.d.ts

@@ -986,6 +986,44 @@ declare interface Logger extends BaseLogger {
   setLogProperties?(
     properties: Record<string, string | number | boolean>
   ): void;
+  /**
+   * Attach properties to this request's row in Zuplo's request log, the one
+   * row per request that analytics and the request details view read.
+   *
+   * This differs from `setLogProperties`, which adds fields to every log
+   * entry (each `context.log.info(...)` line) that log plugins ship. Use
+   * `setRequestProperties` to label the request itself, for example with a
+   * tenant ID, a feature flag or an experiment variant.
+   *
+   * Each call merges into the properties already set for this request, and a
+   * later value for the same key overwrites an earlier one. Numbers and
+   * booleans are stored as strings, and `null` or `undefined` values are
+   * skipped. A request made with `context.invokeRoute` has a row of its own,
+   * so properties set while it runs land on that row, not on the caller's.
+   *
+   * To keep rows small, a request holds at most 64 properties, a key can be
+   * at most 128 characters, and a value at most 2048 characters. A longer
+   * value is truncated, and a property over the other limits is dropped. The
+   * method never throws.
+   *
+   * @param properties - Key-value pairs to attach to the request's log row.
+   *
+   * @example
+   * ```ts
+   * export default async function (request: ZuploRequest, context: ZuploContext) {
+   *   context.log.setRequestProperties({
+   *     tenantId: request.user?.data.tenantId,
+   *     pricingExperiment: "variant-b",
+   *     cached: false,
+   *   });
+   *
+   *   return new Response("ok");
+   * }
+   * ```
+   */
+  setRequestProperties(
+    properties: Record<string, string | number | boolean | undefined | null>
+  ): void;
 }
 
 /**

package/out/types/mcp-gateway/index.d.ts

@@ -1114,6 +1114,44 @@ declare interface Logger extends BaseLogger {
   setLogProperties?(
     properties: Record<string, string | number | boolean>
   ): void;
+  /**
+   * Attach properties to this request's row in Zuplo's request log, the one
+   * row per request that analytics and the request details view read.
+   *
+   * This differs from `setLogProperties`, which adds fields to every log
+   * entry (each `context.log.info(...)` line) that log plugins ship. Use
+   * `setRequestProperties` to label the request itself, for example with a
+   * tenant ID, a feature flag or an experiment variant.
+   *
+   * Each call merges into the properties already set for this request, and a
+   * later value for the same key overwrites an earlier one. Numbers and
+   * booleans are stored as strings, and `null` or `undefined` values are
+   * skipped. A request made with `context.invokeRoute` has a row of its own,
+   * so properties set while it runs land on that row, not on the caller's.
+   *
+   * To keep rows small, a request holds at most 64 properties, a key can be
+   * at most 128 characters, and a value at most 2048 characters. A longer
+   * value is truncated, and a property over the other limits is dropped. The
+   * method never throws.
+   *
+   * @param properties - Key-value pairs to attach to the request's log row.
+   *
+   * @example
+   * ```ts
+   * export default async function (request: ZuploRequest, context: ZuploContext) {
+   *   context.log.setRequestProperties({
+   *     tenantId: request.user?.data.tenantId,
+   *     pricingExperiment: "variant-b",
+   *     cached: false,
+   *   });
+   *
+   *   return new Response("ok");
+   * }
+   * ```
+   */
+  setRequestProperties(
+    properties: Record<string, string | number | boolean | undefined | null>
+  ): void;
 }
 
 /* Excluded from this release type: LookupResult */

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

@@ -893,6 +893,44 @@ declare interface Logger extends BaseLogger {
   setLogProperties?(
     properties: Record<string, string | number | boolean>
   ): void;
+  /**
+   * Attach properties to this request's row in Zuplo's request log, the one
+   * row per request that analytics and the request details view read.
+   *
+   * This differs from `setLogProperties`, which adds fields to every log
+   * entry (each `context.log.info(...)` line) that log plugins ship. Use
+   * `setRequestProperties` to label the request itself, for example with a
+   * tenant ID, a feature flag or an experiment variant.
+   *
+   * Each call merges into the properties already set for this request, and a
+   * later value for the same key overwrites an earlier one. Numbers and
+   * booleans are stored as strings, and `null` or `undefined` values are
+   * skipped. A request made with `context.invokeRoute` has a row of its own,
+   * so properties set while it runs land on that row, not on the caller's.
+   *
+   * To keep rows small, a request holds at most 64 properties, a key can be
+   * at most 128 characters, and a value at most 2048 characters. A longer
+   * value is truncated, and a property over the other limits is dropped. The
+   * method never throws.
+   *
+   * @param properties - Key-value pairs to attach to the request's log row.
+   *
+   * @example
+   * ```ts
+   * export default async function (request: ZuploRequest, context: ZuploContext) {
+   *   context.log.setRequestProperties({
+   *     tenantId: request.user?.data.tenantId,
+   *     pricingExperiment: "variant-b",
+   *     cached: false,
+   *   });
+   *
+   *   return new Response("ok");
+   * }
+   * ```
+   */
+  setRequestProperties(
+    properties: Record<string, string | number | boolean | undefined | null>
+  ): void;
 }
 
 /**

package/out/types/sdks/aws/index.d.ts

@@ -1270,6 +1270,44 @@ declare interface Logger extends BaseLogger {
   setLogProperties?(
     properties: Record<string, string | number | boolean>
   ): void;
+  /**
+   * Attach properties to this request's row in Zuplo's request log, the one
+   * row per request that analytics and the request details view read.
+   *
+   * This differs from `setLogProperties`, which adds fields to every log
+   * entry (each `context.log.info(...)` line) that log plugins ship. Use
+   * `setRequestProperties` to label the request itself, for example with a
+   * tenant ID, a feature flag or an experiment variant.
+   *
+   * Each call merges into the properties already set for this request, and a
+   * later value for the same key overwrites an earlier one. Numbers and
+   * booleans are stored as strings, and `null` or `undefined` values are
+   * skipped. A request made with `context.invokeRoute` has a row of its own,
+   * so properties set while it runs land on that row, not on the caller's.
+   *
+   * To keep rows small, a request holds at most 64 properties, a key can be
+   * at most 128 characters, and a value at most 2048 characters. A longer
+   * value is truncated, and a property over the other limits is dropped. The
+   * method never throws.
+   *
+   * @param properties - Key-value pairs to attach to the request's log row.
+   *
+   * @example
+   * ```ts
+   * export default async function (request: ZuploRequest, context: ZuploContext) {
+   *   context.log.setRequestProperties({
+   *     tenantId: request.user?.data.tenantId,
+   *     pricingExperiment: "variant-b",
+   *     cached: false,
+   *   });
+   *
+   *   return new Response("ok");
+   * }
+   * ```
+   */
+  setRequestProperties(
+    properties: Record<string, string | number | boolean | undefined | null>
+  ): void;
 }
 
 declare type Modify<T, R> = Omit<T, keyof R> & R;

package/package.json

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