@pylonsync/functions 0.22.2 → 0.22.4

package/dist/types.d.ts

@@ -1380,6 +1380,15 @@ export interface RequestInfo {
     url: string;
     headers: Record<string, string>;
     rawBody: string;
+    /**
+     * The client IP Pylon uses for rate limits and the audit log. It comes
+     * from `PYLON_CLIENT_IP_HEADER` (`CF-Connecting-IP` counts only when the
+     * connecting address is a Cloudflare edge), then `X-Forwarded-For` with
+     * `PYLON_TRUST_PROXY_HOPS` trusted proxies, then the socket address. A
+     * caller cannot set it with a header. `null` when the platform exposes no
+     * client address.
+     */
+    clientIp: string | null;
 }
 export type FnType = "query" | "mutation" | "action";
 export interface FnDefinition<TArgs = unknown, TReturn = unknown> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pylonsync/functions",
-  "version": "0.22.2",
+  "version": "0.22.4",
   "description": "TypeScript function runtime for pylon — defines server-side queries, mutations, and actions.",
   "type": "module",
   "main": "src/index.ts",

package/src/runtime.ts

@@ -1269,6 +1269,10 @@ function buildActionCtx(
       url: String(r.url ?? ""),
       headers: (r.headers as Record<string, string>) ?? {},
       rawBody: String(r.raw_body ?? r.rawBody ?? ""),
+      clientIp:
+        typeof (r.client_ip ?? r.clientIp) === "string"
+          ? String(r.client_ip ?? r.clientIp)
+          : null,
     };
   }
   return {

package/src/types.ts

@@ -1511,6 +1511,15 @@ export interface RequestInfo {
   url: string;
   headers: Record<string, string>;
   rawBody: string;
+  /**
+   * The client IP Pylon uses for rate limits and the audit log. It comes
+   * from `PYLON_CLIENT_IP_HEADER` (`CF-Connecting-IP` counts only when the
+   * connecting address is a Cloudflare edge), then `X-Forwarded-For` with
+   * `PYLON_TRUST_PROXY_HOPS` trusted proxies, then the socket address. A
+   * caller cannot set it with a header. `null` when the platform exposes no
+   * client address.
+   */
+  clientIp: string | null;
 }
 
 // ---------------------------------------------------------------------------