@junobuild/functions 0.7.2-next-2026-03-22 → 0.7.2-next-2026-03-29

package/README.md

@@ -76,6 +76,7 @@ JavaScript and TypeScript utilities for [Juno] Serverless Functions.
 - [call](#gear-call)
 - [msgCaller](#gear-msgcaller)
 - [caller](#gear-caller)
+- [httpRequest](#gear-httprequest)
 - [canisterSelf](#gear-canisterself)
 - [id](#gear-id)
 - [satelliteSelf](#gear-satelliteself)
@@ -900,6 +901,24 @@ The Principal ID of the caller.
 
 [:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/caller.ic-cdk.ts#L21)
 
+#### :gear: httpRequest
+
+Performs an HTTP request from a Juno serverless function.
+
+| Function      | Type                                                    |
+| ------------- | ------------------------------------------------------- |
+| `httpRequest` | `(args: HttpRequestArgs) => Promise<HttpRequestResult>` |
+
+Parameters:
+
+- `args`: - The HTTP request parameters
+
+Returns:
+
+A promise resolving to the HTTP response.
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/http-request.ic-cdk.ts#L16)
+
 #### :gear: canisterSelf
 
 Retrieves the Satellite's Principal ID.
@@ -1066,6 +1085,10 @@ The current timestamp.
 - [CallArgsSchema](#gear-callargsschema)
 - [CallResultSchema](#gear-callresultschema)
 - [CallParamsSchema](#gear-callparamsschema)
+- [HttpHeaderSchema](#gear-httpheaderschema)
+- [HttpMethodSchema](#gear-httpmethodschema)
+- [HttpRequestArgsSchema](#gear-httprequestargsschema)
+- [HttpRequestResultSchema](#gear-httprequestresultschema)
 
 #### :gear: SatelliteEnvSchema
 
@@ -2336,6 +2359,54 @@ References:
 
 [:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L60)
 
+#### :gear: HttpHeaderSchema
+
+| Constant           | Type                                                        |
+| ------------------ | ----------------------------------------------------------- |
+| `HttpHeaderSchema` | `ZodObject<{ name: ZodString; value: ZodString; }, $strip>` |
+
+References:
+
+- HttpHeader
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/http-request.ts#L6)
+
+#### :gear: HttpMethodSchema
+
+| Constant           | Type                                                   |
+| ------------------ | ------------------------------------------------------ |
+| `HttpMethodSchema` | `ZodEnum<{ GET: "GET"; POST: "POST"; HEAD: "HEAD"; }>` |
+
+References:
+
+- HttpMethod
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/http-request.ts#L14)
+
+#### :gear: HttpRequestArgsSchema
+
+| Constant                | Type                                                                                                                                                                                                                                                                                                       |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `HttpRequestArgsSchema` | `ZodObject<{ url: ZodURL; method: ZodEnum<{ GET: "GET"; POST: "POST"; HEAD: "HEAD"; }>; headers: ZodArray<ZodObject<{ name: ZodString; value: ZodString; }, $strip>>; body: ZodOptional<...>; maxResponseBytes: ZodOptional<...>; transform: ZodOptional<...>; isReplicated: ZodOptional<...>; }, $strip>` |
+
+References:
+
+- HttpRequestArgs
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/http-request.ts#L19)
+
+#### :gear: HttpRequestResultSchema
+
+| Constant                  | Type                                                                                                                                                                                 |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `HttpRequestResultSchema` | `ZodObject<{ status: ZodBigInt; headers: ZodArray<ZodObject<{ name: ZodString; value: ZodString; }, $strip>>; body: ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<...>>; }, $strip>` |
+
+References:
+
+- HttpRequestResult
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/http-request.ts#L32)
+
 ### :factory: CallResponseLengthError
 
 [:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/types/errors.ts#L1)
@@ -2372,6 +2443,12 @@ References:
 - [SetAssetHandlerParams](#gear-setassethandlerparams)
 - [GetContentChunksStoreParams](#gear-getcontentchunksstoreparams)
 - [CallParams](#gear-callparams)
+- [HttpHeader](#gear-httpheader)
+- [HttpRequestArgs](#gear-httprequestargs)
+- [HttpRequestResult](#gear-httprequestresult)
+- [HttpHeader](#gear-httpheader)
+- [HttpRequestArgs](#gear-httprequestargs)
+- [HttpRequestResult](#gear-httprequestresult)
 
 #### :gear: CustomFunctionWithArgsAndResult
 
@@ -2745,6 +2822,84 @@ Type representing the parameters required to make a canister call.
 
 [:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L70)
 
+#### :gear: HttpHeader
+
+An HTTP header consisting of a name and value.
+
+| Property | Type     | Description       |
+| -------- | -------- | ----------------- |
+| `name`   | `string` | The header name.  |
+| `value`  | `string` | The header value. |
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/http-request.ts#L41)
+
+#### :gear: HttpRequestArgs
+
+The arguments for an HTTP request.
+
+| Property           | Type                                       | Description                                                                                                                                                                                                                                                                           |
+| ------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `url`              | `string`                                   | The requested URL.                                                                                                                                                                                                                                                                    |
+| `method`           | `HttpMethod`                               | The HTTP method.                                                                                                                                                                                                                                                                      |
+| `headers`          | `HttpHeader[]`                             | List of HTTP request headers and their corresponding values.                                                                                                                                                                                                                          |
+| `body`             | `Uint8Array<ArrayBufferLike> or undefined` | Optionally provide request body.                                                                                                                                                                                                                                                      |
+| `maxResponseBytes` | `bigint or undefined`                      | The maximal size of the response in bytes.                                                                                                                                                                                                                                            |
+| `transform`        | `string or undefined`                      | The name of a query function used to transform the response before consensus - for example, to trim headers. If provided, a corresponding query must be declared using {@link defineQuery }.                                                                                          |
+| `isReplicated`     | `boolean or undefined`                     | Whether all nodes should perform the request and agree on the response, or just one node. Using a single node is cheaper but the response is not verified by others - suitable when you trust the data source or consistency is not critical. Defaults to all nodes if not specified. |
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/http-request.ts#L54)
+
+#### :gear: HttpRequestResult
+
+The result of an HTTP request.
+
+| Property  | Type                          | Description                                                   |
+| --------- | ----------------------------- | ------------------------------------------------------------- |
+| `status`  | `bigint`                      | The response status (e.g. 200, 404).                          |
+| `headers` | `HttpHeader[]`                | List of HTTP response headers and their corresponding values. |
+| `body`    | `Uint8Array<ArrayBufferLike>` | The response's body.                                          |
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/http-request.ts#L67)
+
+#### :gear: HttpHeader
+
+An HTTP header consisting of a name and value.
+
+| Property | Type     | Description       |
+| -------- | -------- | ----------------- |
+| `name`   | `string` | The header name.  |
+| `value`  | `string` | The header value. |
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/http-request.ts#L76)
+
+#### :gear: HttpRequestArgs
+
+The arguments for an HTTP request.
+
+| Property           | Type                                       | Description                                                                                                                                                                                                                                                                           |
+| ------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `url`              | `string`                                   | The requested URL.                                                                                                                                                                                                                                                                    |
+| `method`           | `HttpMethod`                               | The HTTP method.                                                                                                                                                                                                                                                                      |
+| `headers`          | `HttpHeader[]`                             | List of HTTP request headers and their corresponding values.                                                                                                                                                                                                                          |
+| `body`             | `Uint8Array<ArrayBufferLike> or undefined` | Optionally provide request body.                                                                                                                                                                                                                                                      |
+| `maxResponseBytes` | `bigint or undefined`                      | The maximal size of the response in bytes.                                                                                                                                                                                                                                            |
+| `transform`        | `string or undefined`                      | The name of a query function used to transform the response before consensus - for example, to trim headers. If provided, a corresponding query must be declared using {@link defineQuery }.                                                                                          |
+| `isReplicated`     | `boolean or undefined`                     | Whether all nodes should perform the request and agree on the response, or just one node. Using a single node is cheaper but the response is not verified by others - suitable when you trust the data source or consistency is not critical. Defaults to all nodes if not specified. |
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/http-request.ts#L91)
+
+#### :gear: HttpRequestResult
+
+The result of an HTTP request.
+
+| Property  | Type                          | Description                                                   |
+| --------- | ----------------------------- | ------------------------------------------------------------- |
+| `status`  | `bigint`                      | The response status (e.g. 200, 404).                          |
+| `headers` | `HttpHeader[]`                | List of HTTP response headers and their corresponding values. |
+| `body`    | `Uint8Array<ArrayBufferLike>` | The response's body.                                          |
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/http-request.ts#L134)
+
 ### :cocktail: Types
 
 - [SatelliteEnv](#gear-satelliteenv)
@@ -2847,6 +3002,7 @@ Type representing the parameters required to make a canister call.
 - [CallArg](#gear-callarg)
 - [CallArgs](#gear-callargs)
 - [CallResult](#gear-callresult)
+- [HttpMethod](#gear-httpmethod)
 
 #### :gear: SatelliteEnv
 
@@ -3919,6 +4075,16 @@ Defines the type used to decode the result of a canister call.
 
 [:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L55)
 
+#### :gear: HttpMethod
+
+The HTTP method for the request.
+
+| Type         | Type                        |
+| ------------ | --------------------------- |
+| `HttpMethod` | `'GET' or 'POST' or 'HEAD'` |
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/http-request.ts#L49)
+
 <!-- TSDOC_END -->
 
 ## License

package/global.d.ts

@@ -126,4 +126,5 @@ declare global {
     method: string,
     args: Uint8Array<ArrayBuffer>
   ): Promise<Uint8Array<ArrayBuffer>>;
+  function __ic_cdk_http_request(args: HttpRequestArgs): Promise<HttpRequestResult>;
 }

package/ic-cdk/http-request.ic-cdk.d.ts

@@ -0,0 +1,10 @@
+import { type HttpRequestArgs, type HttpRequestResult } from './schemas/http-request';
+/**
+ * Performs an HTTP request from a Juno serverless function.
+ *
+ * @param {HttpRequestArgs} args - The HTTP request parameters
+ * @returns {Promise<HttpRequestResult>} A promise resolving to the HTTP response.
+ * @throws {ZodError} If the provided arguments do not match the expected schema.
+ * @throws {Error} If the HTTP request fails.
+ */
+export declare const httpRequest: (args: HttpRequestArgs) => Promise<HttpRequestResult>;

package/ic-cdk/schemas/http-request.d.ts

@@ -0,0 +1,142 @@
+/**
+ * @see HttpHeader
+ */
+export declare const HttpHeaderSchema: import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    value: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
+/**
+ * @see HttpMethod
+ */
+export declare const HttpMethodSchema: import("zod").ZodEnum<{
+    GET: "GET";
+    POST: "POST";
+    HEAD: "HEAD";
+}>;
+/**
+ * @see HttpRequestArgs
+ */
+export declare const HttpRequestArgsSchema: import("zod").ZodObject<{
+    url: import("zod").ZodURL;
+    method: import("zod").ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        HEAD: "HEAD";
+    }>;
+    headers: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        value: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    body: import("zod").ZodOptional<import("zod").ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>>;
+    maxResponseBytes: import("zod").ZodOptional<import("zod").ZodBigInt>;
+    transform: import("zod").ZodOptional<import("zod").ZodString>;
+    isReplicated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @see HttpRequestResult
+ */
+export declare const HttpRequestResultSchema: import("zod").ZodObject<{
+    status: import("zod").ZodBigInt;
+    headers: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        value: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    body: import("zod").ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+}, import("zod/v4/core").$strip>;
+/**
+ * An HTTP header consisting of a name and value.
+ */
+export interface HttpHeader {
+    name: string;
+    value: string;
+}
+/**
+ * The HTTP method for the request.
+ */
+export type HttpMethod = 'GET' | 'POST' | 'HEAD';
+/**
+ * The arguments for an HTTP request.
+ */
+export interface HttpRequestArgs {
+    url: string;
+    method: HttpMethod;
+    headers: HttpHeader[];
+    body?: Uint8Array;
+    maxResponseBytes?: bigint;
+    transform?: string;
+    isReplicated?: boolean;
+}
+/**
+ * The result of an HTTP request.
+ */
+export interface HttpRequestResult {
+    status: bigint;
+    headers: HttpHeader[];
+    body: Uint8Array;
+}
+/**
+ * An HTTP header consisting of a name and value.
+ */
+export interface HttpHeader {
+    /**
+     * The header name.
+     */
+    name: string;
+    /**
+     * The header value.
+     */
+    value: string;
+}
+/**
+ * The arguments for an HTTP request.
+ */
+export interface HttpRequestArgs {
+    /**
+     * The requested URL.
+     */
+    url: string;
+    /**
+     * The HTTP method.
+     */
+    method: HttpMethod;
+    /**
+     * List of HTTP request headers and their corresponding values.
+     */
+    headers: HttpHeader[];
+    /**
+     * Optionally provide request body.
+     */
+    body?: Uint8Array;
+    /**
+     * The maximal size of the response in bytes.
+     */
+    maxResponseBytes?: bigint;
+    /**
+     * The name of a query function used to transform the response before consensus - for example, to trim headers.
+     * If provided, a corresponding query must be declared using {@link defineQuery}.
+     */
+    transform?: string;
+    /**
+     * Whether all nodes should perform the request and agree on the response, or just one node.
+     * Using a single node is cheaper but the response is not verified by others - suitable when you trust the data source or consistency is not critical.
+     * Defaults to all nodes if not specified.
+     */
+    isReplicated?: boolean;
+}
+/**
+ * The result of an HTTP request.
+ */
+export interface HttpRequestResult {
+    /**
+     * The response status (e.g. 200, 404).
+     */
+    status: bigint;
+    /**
+     * List of HTTP response headers and their corresponding values.
+     */
+    headers: HttpHeader[];
+    /**
+     * The response's body.
+     */
+    body: Uint8Array;
+}

package/ic-cdk.d.ts

@@ -1,6 +1,8 @@
 export * from './ic-cdk/call.ic-cdk';
 export * from './ic-cdk/caller.ic-cdk';
+export * from './ic-cdk/http-request.ic-cdk';
 export * from './ic-cdk/id.ic-cdk';
 export * from './ic-cdk/schemas/call';
+export * from './ic-cdk/schemas/http-request';
 export * from './ic-cdk/time.ic-cdk';
 export * from './ic-cdk/types/errors';

package/ic-cdk.js

@@ -1,2 +1,2 @@
-import{a as c,b as n,c as e,d as l,e as a,f as m,g as f}from"./chunk-PEKVE4RM.js";import"./chunk-JU5CZHLY.js";import"./chunk-4C666HHU.js";import{Principal as o}from"@icp-sdk/core/principal";var t=()=>o.fromUint8Array(__ic_cdk_caller()),_=()=>t();import{Principal as p}from"@icp-sdk/core/principal";var r=()=>p.fromUint8Array(__ic_cdk_id()),d=()=>r(),k=()=>r();var u=()=>__ic_cdk_time();export{n as CallArgSchema,e as CallArgsSchema,a as CallParamsSchema,m as CallResponseLengthError,l as CallResultSchema,c as IDLTypeSchema,f as call,_ as caller,r as canisterSelf,d as id,t as msgCaller,k as satelliteSelf,u as time};
+import{a as m,b as u,c as d,d as H,e as x,f,g as R}from"./chunk-PEKVE4RM.js";import"./chunk-JU5CZHLY.js";import"./chunk-4C666HHU.js";import{Principal as a}from"@icp-sdk/core/principal";var n=()=>a.fromUint8Array(__ic_cdk_caller()),y=()=>n();import{j as t}from"@junobuild/schema";var r=t.object({name:t.string(),value:t.string()}),c=t.enum(["GET","POST","HEAD"]),o=t.object({url:t.url(),method:c,headers:t.array(r),body:t.uint8Array().optional(),maxResponseBytes:t.bigint().optional(),transform:t.string().optional(),isReplicated:t.boolean().optional()}),i=t.object({status:t.bigint(),headers:t.array(r),body:t.uint8Array()});var q=async e=>{o.parse(e);let s=await __ic_cdk_http_request(e);return i.parse(s)};import{Principal as l}from"@icp-sdk/core/principal";var p=()=>l.fromUint8Array(__ic_cdk_id()),U=()=>p(),j=()=>p();var E=()=>__ic_cdk_time();export{u as CallArgSchema,d as CallArgsSchema,x as CallParamsSchema,f as CallResponseLengthError,H as CallResultSchema,r as HttpHeaderSchema,c as HttpMethodSchema,o as HttpRequestArgsSchema,i as HttpRequestResultSchema,m as IDLTypeSchema,R as call,y as caller,p as canisterSelf,q as httpRequest,U as id,n as msgCaller,j as satelliteSelf,E as time};
 //# sourceMappingURL=ic-cdk.js.map

package/ic-cdk.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["src/ic-cdk/caller.ic-cdk.ts", "src/ic-cdk/id.ic-cdk.ts", "src/ic-cdk/time.ic-cdk.ts"],
-  "sourcesContent": ["import {Principal} from '@icp-sdk/core/principal';\n\n/**\n * Retrieves the caller's Principal ID.\n *\n * This function is a JavaScript binding for the Rust function\n * [`ic_cdk::api::msg_caller()`](https://docs.rs/ic-cdk/latest/ic_cdk/api/fn.msg_caller.html), which returns\n * the Principal of the caller of the current call.\n *\n * @returns {Principal} The Principal ID of the caller.\n */\nexport const msgCaller = (): Principal => {\n  const principal = Principal.fromUint8Array(__ic_cdk_caller());\n\n  return principal;\n};\n\n/**\n * @deprecated Use {@link msgCaller} instead.\n */\nexport const caller = (): Principal => msgCaller();\n", "import {Principal} from '@icp-sdk/core/principal';\n\n/**\n * Retrieves the Satellite's Principal ID.\n *\n * This function is a JavaScript binding for the Rust function\n * [`ic_cdk::api::canister_self()`](https://docs.rs/ic-cdk/latest/ic_cdk/api/fn.canister_self.html), which returns\n * the Principal of the executing canister.\n *\n * @returns {Principal} The Principal ID of the Satellite.\n */\nexport const canisterSelf = (): Principal => {\n  const principal = Principal.fromUint8Array(__ic_cdk_id());\n\n  // We assume the Principal is always built using the global function and is therefore always valid.\n  // In other words, we do not validate it to conserve resources and optimize performance.\n\n  return principal;\n};\n\n/**\n * @deprecated Use {@link canisterSelf} instead.\n */\nexport const id = (): Principal => canisterSelf();\n\n/**\n * Retrieves the Satellite's Principal ID.\n *\n * @returns {Principal} The Principal ID of the Satellite.\n */\nexport const satelliteSelf = (): Principal => canisterSelf();\n", "/**\n * Gets current timestamp, in nanoseconds since the epoch (1970-01-01)\n *\n * This function is a JavaScript binding for the Rust function\n * [`ic_cdk::time()`](https://docs.rs/ic-cdk/latest/ic_cdk/api/fn.time.html), which returns\n * the system time publicly exposed and verified part of the IC state tree\n *\n * @returns {bigint} The current timestamp.\n */\nexport const time = (): bigint => __ic_cdk_time();\n"],
-  "mappings": "0IAAA,OAAQ,aAAAA,MAAgB,0BAWjB,IAAMC,EAAY,IACLD,EAAU,eAAe,gBAAgB,CAAC,EAQjDE,EAAS,IAAiBD,EAAU,ECpBjD,OAAQ,aAAAE,MAAgB,0BAWjB,IAAMC,EAAe,IACRD,EAAU,eAAe,YAAY,CAAC,EAW7CE,EAAK,IAAiBD,EAAa,EAOnCE,EAAgB,IAAiBF,EAAa,ECrBpD,IAAMG,EAAO,IAAc,cAAc",
-  "names": ["Principal", "msgCaller", "caller", "Principal", "canisterSelf", "id", "satelliteSelf", "time"]
+  "sources": ["src/ic-cdk/caller.ic-cdk.ts", "src/ic-cdk/schemas/http-request.ts", "src/ic-cdk/http-request.ic-cdk.ts", "src/ic-cdk/id.ic-cdk.ts", "src/ic-cdk/time.ic-cdk.ts"],
+  "sourcesContent": ["import {Principal} from '@icp-sdk/core/principal';\n\n/**\n * Retrieves the caller's Principal ID.\n *\n * This function is a JavaScript binding for the Rust function\n * [`ic_cdk::api::msg_caller()`](https://docs.rs/ic-cdk/latest/ic_cdk/api/fn.msg_caller.html), which returns\n * the Principal of the caller of the current call.\n *\n * @returns {Principal} The Principal ID of the caller.\n */\nexport const msgCaller = (): Principal => {\n  const principal = Principal.fromUint8Array(__ic_cdk_caller());\n\n  return principal;\n};\n\n/**\n * @deprecated Use {@link msgCaller} instead.\n */\nexport const caller = (): Principal => msgCaller();\n", "import {j} from '@junobuild/schema';\n\n/**\n * @see HttpHeader\n */\nexport const HttpHeaderSchema = j.object({\n  name: j.string(),\n  value: j.string()\n});\n\n/**\n * @see HttpMethod\n */\nexport const HttpMethodSchema = j.enum(['GET', 'POST', 'HEAD']);\n\n/**\n * @see HttpRequestArgs\n */\nexport const HttpRequestArgsSchema = j.object({\n  url: j.url(),\n  method: HttpMethodSchema,\n  headers: j.array(HttpHeaderSchema),\n  body: j.uint8Array().optional(),\n  maxResponseBytes: j.bigint().optional(),\n  transform: j.string().optional(),\n  isReplicated: j.boolean().optional()\n});\n\n/**\n * @see HttpRequestResult\n */\nexport const HttpRequestResultSchema = j.object({\n  status: j.bigint(),\n  headers: j.array(HttpHeaderSchema),\n  body: j.uint8Array()\n});\n\n/**\n * An HTTP header consisting of a name and value.\n */\nexport interface HttpHeader {\n  name: string;\n  value: string;\n}\n\n/**\n * The HTTP method for the request.\n */\nexport type HttpMethod = 'GET' | 'POST' | 'HEAD';\n\n/**\n * The arguments for an HTTP request.\n */\nexport interface HttpRequestArgs {\n  url: string;\n  method: HttpMethod;\n  headers: HttpHeader[];\n  body?: Uint8Array;\n  maxResponseBytes?: bigint;\n  transform?: string;\n  isReplicated?: boolean;\n}\n\n/**\n * The result of an HTTP request.\n */\nexport interface HttpRequestResult {\n  status: bigint;\n  headers: HttpHeader[];\n  body: Uint8Array;\n}\n\n/**\n * An HTTP header consisting of a name and value.\n */\nexport interface HttpHeader {\n  /**\n   * The header name.\n   */\n  name: string;\n\n  /**\n   * The header value.\n   */\n  value: string;\n}\n\n/**\n * The arguments for an HTTP request.\n */\nexport interface HttpRequestArgs {\n  /**\n   * The requested URL.\n   */\n  url: string;\n\n  /**\n   * The HTTP method.\n   */\n  method: HttpMethod;\n\n  /**\n   * List of HTTP request headers and their corresponding values.\n   */\n  headers: HttpHeader[];\n\n  /**\n   * Optionally provide request body.\n   */\n  body?: Uint8Array;\n\n  /**\n   * The maximal size of the response in bytes.\n   */\n  maxResponseBytes?: bigint;\n\n  /**\n   * The name of a query function used to transform the response before consensus - for example, to trim headers.\n   * If provided, a corresponding query must be declared using {@link defineQuery}.\n   */\n  transform?: string;\n\n  /**\n   * Whether all nodes should perform the request and agree on the response, or just one node.\n   * Using a single node is cheaper but the response is not verified by others - suitable when you trust the data source or consistency is not critical.\n   * Defaults to all nodes if not specified.\n   */\n  isReplicated?: boolean;\n}\n\n/**\n * The result of an HTTP request.\n */\nexport interface HttpRequestResult {\n  /**\n   * The response status (e.g. 200, 404).\n   */\n  status: bigint;\n\n  /**\n   * List of HTTP response headers and their corresponding values.\n   */\n  headers: HttpHeader[];\n\n  /**\n   * The response's body.\n   */\n  body: Uint8Array;\n}\n", "import {\n  type HttpRequestArgs,\n  type HttpRequestResult,\n  HttpRequestArgsSchema,\n  HttpRequestResultSchema\n} from './schemas/http-request';\n\n/**\n * Performs an HTTP request from a Juno serverless function.\n *\n * @param {HttpRequestArgs} args - The HTTP request parameters\n * @returns {Promise<HttpRequestResult>} A promise resolving to the HTTP response.\n * @throws {ZodError} If the provided arguments do not match the expected schema.\n * @throws {Error} If the HTTP request fails.\n */\nexport const httpRequest = async (args: HttpRequestArgs): Promise<HttpRequestResult> => {\n  HttpRequestArgsSchema.parse(args);\n\n  const result = await __ic_cdk_http_request(args);\n\n  return HttpRequestResultSchema.parse(result);\n};\n", "import {Principal} from '@icp-sdk/core/principal';\n\n/**\n * Retrieves the Satellite's Principal ID.\n *\n * This function is a JavaScript binding for the Rust function\n * [`ic_cdk::api::canister_self()`](https://docs.rs/ic-cdk/latest/ic_cdk/api/fn.canister_self.html), which returns\n * the Principal of the executing canister.\n *\n * @returns {Principal} The Principal ID of the Satellite.\n */\nexport const canisterSelf = (): Principal => {\n  const principal = Principal.fromUint8Array(__ic_cdk_id());\n\n  // We assume the Principal is always built using the global function and is therefore always valid.\n  // In other words, we do not validate it to conserve resources and optimize performance.\n\n  return principal;\n};\n\n/**\n * @deprecated Use {@link canisterSelf} instead.\n */\nexport const id = (): Principal => canisterSelf();\n\n/**\n * Retrieves the Satellite's Principal ID.\n *\n * @returns {Principal} The Principal ID of the Satellite.\n */\nexport const satelliteSelf = (): Principal => canisterSelf();\n", "/**\n * Gets current timestamp, in nanoseconds since the epoch (1970-01-01)\n *\n * This function is a JavaScript binding for the Rust function\n * [`ic_cdk::time()`](https://docs.rs/ic-cdk/latest/ic_cdk/api/fn.time.html), which returns\n * the system time publicly exposed and verified part of the IC state tree\n *\n * @returns {bigint} The current timestamp.\n */\nexport const time = (): bigint => __ic_cdk_time();\n"],
+  "mappings": "qIAAA,OAAQ,aAAAA,MAAgB,0BAWjB,IAAMC,EAAY,IACLD,EAAU,eAAe,gBAAgB,CAAC,EAQjDE,EAAS,IAAiBD,EAAU,ECpBjD,OAAQ,KAAAE,MAAQ,oBAKT,IAAMC,EAAmBD,EAAE,OAAO,CACvC,KAAMA,EAAE,OAAO,EACf,MAAOA,EAAE,OAAO,CAClB,CAAC,EAKYE,EAAmBF,EAAE,KAAK,CAAC,MAAO,OAAQ,MAAM,CAAC,EAKjDG,EAAwBH,EAAE,OAAO,CAC5C,IAAKA,EAAE,IAAI,EACX,OAAQE,EACR,QAASF,EAAE,MAAMC,CAAgB,EACjC,KAAMD,EAAE,WAAW,EAAE,SAAS,EAC9B,iBAAkBA,EAAE,OAAO,EAAE,SAAS,EACtC,UAAWA,EAAE,OAAO,EAAE,SAAS,EAC/B,aAAcA,EAAE,QAAQ,EAAE,SAAS,CACrC,CAAC,EAKYI,EAA0BJ,EAAE,OAAO,CAC9C,OAAQA,EAAE,OAAO,EACjB,QAASA,EAAE,MAAMC,CAAgB,EACjC,KAAMD,EAAE,WAAW,CACrB,CAAC,ECpBM,IAAMK,EAAc,MAAOC,GAAsD,CACtFC,EAAsB,MAAMD,CAAI,EAEhC,IAAME,EAAS,MAAM,sBAAsBF,CAAI,EAE/C,OAAOG,EAAwB,MAAMD,CAAM,CAC7C,ECrBA,OAAQ,aAAAE,MAAgB,0BAWjB,IAAMC,EAAe,IACRD,EAAU,eAAe,YAAY,CAAC,EAW7CE,EAAK,IAAiBD,EAAa,EAOnCE,EAAgB,IAAiBF,EAAa,ECrBpD,IAAMG,EAAO,IAAc,cAAc",
+  "names": ["Principal", "msgCaller", "caller", "j", "HttpHeaderSchema", "HttpMethodSchema", "HttpRequestArgsSchema", "HttpRequestResultSchema", "httpRequest", "args", "HttpRequestArgsSchema", "result", "HttpRequestResultSchema", "Principal", "canisterSelf", "id", "satelliteSelf", "time"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junobuild/functions",
-  "version": "0.7.2-next-2026-03-22",
+  "version": "0.7.2-next-2026-03-29",
   "description": "JavaScript and TypeScript utilities for Juno Serverless Functions",
   "author": "David Dal Busco (https://daviddalbusco.com)",
   "license": "MIT",

package/src/global.d.ts

@@ -126,4 +126,5 @@ declare global {
     method: string,
     args: Uint8Array<ArrayBuffer>
   ): Promise<Uint8Array<ArrayBuffer>>;
+  function __ic_cdk_http_request(args: HttpRequestArgs): Promise<HttpRequestResult>;
 }