@scayle/storefront-core 8.60.1 → 8.61.0

package/dist/rpc/methods/checkout/checkout.mjs

@@ -40,9 +40,9 @@ export const getCheckoutToken = defineRpcHandler(async (jwtPayload = {}, context
       ...customData,
       ...orderCustomData
     }
-  }).setIssuedAt(now).setNotBefore(now).setExpirationTime("1h").setIssuer(`${"@scayle/storefront-core"}@${"8.60.1"}`).setProtectedHeader({ alg: "HS256", typ: "JWT" }).sign(secret);
+  }).setIssuedAt(now).setNotBefore(now).setExpirationTime("1h").setIssuer(`${"@scayle/storefront-core"}@${"8.61.0"}`).setProtectedHeader({ alg: "HS256", typ: "JWT" }).sign(secret);
   return {
     accessToken: refreshedAccessToken,
     checkoutJwt
   };
-});
+}, { method: "POST" });

package/dist/rpc/methods/checkout/order.mjs

@@ -50,7 +50,7 @@ export const getOrderById = defineRpcHandler(async ({ orderId }, context) => {
       "Unknown error"
     );
   }
-});
+}, { method: "POST" });
 export const getOrderCustomData = defineRpcHandler(async () => {
   return {};
-});
+}, { method: "POST" });

package/dist/rpc/methods/checkout/shopUser.mjs

@@ -56,7 +56,7 @@ export const updateShopUser = defineRpcHandler(async (payload, context) => {
       "Error while updating user information"
     );
   }
-});
+}, { method: "PUT" });
 export const updatePassword = defineRpcHandler(async ({ oldPassword, newPassword }, context) => {
   const shopUser = context.user;
   const oauthEnabled = context.oauth?.apiHost && context.oauth?.clientId && context.oauth?.clientSecret;
@@ -121,4 +121,4 @@ export const updatePassword = defineRpcHandler(async ({ oldPassword, newPassword
     }
   }
   return { user: shopUser };
-});
+}, { method: "PUT" });

package/dist/rpc/methods/checkout/shopUserAddresses.mjs

@@ -5,6 +5,8 @@ const getShopUserAddresses = defineRpcHandler(
     const shopId = context.shopId;
     const client = new CustomerAPIClient(context);
     return (await client.getAddresses(shopId)).entities;
-  }
+  },
+  // We use POST here to prevent user data to be leaking into caches.
+  { method: "POST" }
 );
 export { getShopUserAddresses };

package/dist/rpc/methods/navigationTrees.mjs

@@ -6,13 +6,13 @@ export const fetchAllNavigationTrees = defineRpcHandler(async ({ params }, conte
   return await cached(navigation.getAll, {
     cacheKeyPrefix: "getAll-navigation-trees"
   })(params);
-});
+}, { method: "GET" });
 export const fetchNavigationTreeById = defineRpcHandler(async ({ treeId, params }, context) => {
   const { sapiClient: { navigation }, cached } = context;
   return await cached(navigation.getById, {
     cacheKeyPrefix: `getById-navigation-trees-${treeId}`
   })(treeId, params);
-});
+}, { method: "GET" });
 export const fetchNavigationTreeByName = defineRpcHandler(async ({ treeName, params }, context) => {
   const { sapiClient: { navigation }, cached } = context;
   return await cached(
@@ -34,4 +34,4 @@ export const fetchNavigationTreeByName = defineRpcHandler(async ({ treeName, par
       cacheKeyPrefix: `getByName-navigation-trees-${treeName}`
     }
   )(treeName, params);
-});
+}, { method: "GET" });

package/dist/rpc/methods/oauth/idp.mjs

@@ -46,7 +46,7 @@ export const getExternalIdpRedirect = defineRpcHandler(async ({ queryParams, aut
     })
   );
   return Object.fromEntries(results);
-});
+}, { method: "GET" });
 export const handleIDPLoginCallback = defineRpcHandler(async (payload, context) => {
   if (!hasSession(context)) {
     return new ErrorResponse(
@@ -61,4 +61,4 @@ export const handleIDPLoginCallback = defineRpcHandler(async (payload, context)
   return {
     message: "success"
   };
-});
+}, { method: "POST" });

package/dist/rpc/methods/products.mjs

@@ -4,6 +4,7 @@ import { MINUTE } from "../../cache/index.mjs";
 import { unwrap } from "../../utils/response.mjs";
 import { mapSAPIFetchErrorToResponse } from "../../utils/sapi.mjs";
 import { ErrorResponse } from "../../errors/index.mjs";
+import { defineRpcHandler } from "../../utils/index.mjs";
 const MAX_PER_PAGE = 100;
 const sanitizeAttributesForSAPI = ({
   attributes,
@@ -32,7 +33,7 @@ export async function resolveCategoryIdFromParams(context, params) {
   }
   return { category, categoryId };
 }
-export const getProductById = async function getProductById2(options, context) {
+export const getProductById = defineRpcHandler(async (options, context) => {
   const { sapiClient, cached, withParams } = context;
   const campaignKey = await context.callRpc?.("getCampaignKey");
   return await cached(
@@ -47,8 +48,8 @@ export const getProductById = async function getProductById2(options, context) {
     pricePromotionKey: options.pricePromotionKey,
     includeSellableForFree: options.includeSellableForFree
   });
-};
-export const getProductsByIds = async function getProductsByIds2(options, context) {
+}, { method: "GET" });
+export const getProductsByIds = defineRpcHandler(async (options, context) => {
   const { sapiClient, cached, withParams } = context;
   const campaignKey = await context.callRpc?.("getCampaignKey");
   return await cached(
@@ -62,8 +63,8 @@ export const getProductsByIds = async function getProductsByIds2(options, contex
     campaignKey,
     pricePromotionKey: options.pricePromotionKey
   });
-};
-export const getProductsByReferenceKeys = async function getProductsByReferenceKeys2(options, context) {
+}, { method: "GET" });
+export const getProductsByReferenceKeys = defineRpcHandler(async (options, context) => {
   const { sapiClient, cached, withParams } = context;
   const campaignKey = await context.callRpc?.("getCampaignKey");
   return await cached(
@@ -77,63 +78,66 @@ export const getProductsByReferenceKeys = async function getProductsByReferenceK
     campaignKey,
     pricePromotionKey: options.pricePromotionKey
   });
-};
-export const getProductsCount = async function getProductsCount2(params, context) {
-  const {
-    includedFilters,
-    where = void 0,
-    includeSoldOut = false,
-    includeSellableForFree = false,
-    orFiltersOperator = void 0
-  } = params;
-  const { cached, sapiClient } = context;
-  const campaignKey = await context.callRpc?.("getCampaignKey");
-  const { categoryId } = await resolveCategoryIdFromParams(context, params);
-  const { attributes, whitelistAttributes, ...filter } = where || {};
-  const response = await getSanitizedAttributes(
-    context,
-    categoryId,
-    attributes || [],
-    includedFilters,
-    includeSoldOut,
-    includeSellableForFree,
-    orFiltersOperator
-  );
-  if (response instanceof ErrorResponse) {
-    return response;
-  }
-  const sanitizedAttributes = response;
-  const productCount = await cached(sapiClient.products.query, {
-    ttl: 15 * MINUTE,
-    cacheKeyPrefix: "products-query"
-  })({
-    where: {
-      ...filter,
+}, { method: "GET" });
+export const getProductsCount = defineRpcHandler(
+  async (params, context) => {
+    const {
+      includedFilters,
+      where = void 0,
+      includeSoldOut = false,
+      includeSellableForFree = false,
+      orFiltersOperator = void 0
+    } = params;
+    const { cached, sapiClient } = context;
+    const campaignKey = await context.callRpc?.("getCampaignKey");
+    const { categoryId } = await resolveCategoryIdFromParams(context, params);
+    const { attributes, whitelistAttributes, ...filter } = where || {};
+    const response = await getSanitizedAttributes(
+      context,
       categoryId,
-      attributes: [
-        ...sanitizedAttributes,
-        ...whitelistAttributes || []
-      ]
-    },
-    pagination: {
-      perPage: 1
-    },
-    campaignKey,
-    includeSellableForFree,
-    includeSoldOut,
-    orFiltersOperator
-  });
-  return {
-    count: productCount?.pagination.total
-  };
-};
-export const fetchAllFiltersForCategory = async function fetchAllFiltersForCategory2({
+      attributes || [],
+      includedFilters,
+      includeSoldOut,
+      includeSellableForFree,
+      orFiltersOperator
+    );
+    if (response instanceof ErrorResponse) {
+      return response;
+    }
+    const sanitizedAttributes = response;
+    const productCount = await cached(sapiClient.products.query, {
+      ttl: 15 * MINUTE,
+      cacheKeyPrefix: "products-query"
+    })({
+      where: {
+        ...filter,
+        categoryId,
+        attributes: [
+          ...sanitizedAttributes,
+          ...whitelistAttributes || []
+        ]
+      },
+      pagination: {
+        perPage: 1
+      },
+      campaignKey,
+      includeSellableForFree,
+      includeSoldOut,
+      orFiltersOperator
+    });
+    return {
+      count: productCount?.pagination.total
+    };
+  },
+  { method: "GET" }
+);
+export const fetchAllFiltersForCategory = defineRpcHandler(async ({
   includedFilters = [],
   category,
   includeSoldOut,
   includeSellableForFree,
   orFiltersOperator
-}, context) {
+}, context) => {
   const { cached, sapiClient } = context;
   const campaignKey = await context.callRpc?.("getCampaignKey");
   const fetchAndMapFiltersToSlugs = async () => {
@@ -152,7 +156,7 @@ export const fetchAllFiltersForCategory = async function fetchAllFiltersForCateg
     // cached for 4 hours
     cacheKey: `filters-for-category-${category.id}`
   })();
-};
+}, { method: "GET" });
 async function getSanitizedAttributes(context, categoryId, attributes, includedFilters, includeSoldOut, includeSellableForFree, orFiltersOperator) {
   const response = await fetchAllFiltersForCategory(
     {
@@ -174,7 +178,7 @@ async function getSanitizedAttributes(context, categoryId, attributes, includedF
     includedFilters
   });
 }
-export const getFilters = async function getFilters2(params, context) {
+export const getFilters = defineRpcHandler(async (params, context) => {
   const {
     includedFilters,
     where = void 0,
@@ -245,8 +249,8 @@ export const getFilters = async function getFilters2(params, context) {
     filters,
     unfilteredCount: productCount?.pagination.total
   };
-};
-export const getProductsByCategory = async function getProductsByCategory2(params, context) {
+}, { method: "GET" });
+export const getProductsByCategory = defineRpcHandler(async (params, context) => {
   const {
     includedFilters,
     cache,
@@ -321,4 +325,4 @@ export const getProductsByCategory = async function getProductsByCategory2(param
       ...pagination
     }
   };
-};
+}, { method: "GET" });

package/dist/rpc/methods/promotion.mjs

@@ -18,7 +18,7 @@ export const getPromotions = defineRpcHandler(async (params = {}, context) => {
     ...params,
     pagination: setPaginationDefault(params.pagination)
   });
-});
+}, { method: "GET" });
 export const getCurrentPromotions = defineRpcHandler(async (params = {}, context) => {
   const { sapiClient, cached } = context;
   const now = /* @__PURE__ */ new Date();
@@ -31,7 +31,7 @@ export const getCurrentPromotions = defineRpcHandler(async (params = {}, context
     activeAt,
     pagination: setPaginationDefault(params.pagination)
   });
-});
+}, { method: "GET" });
 export const getPromotionsByIds = defineRpcHandler(async (ids, context) => {
   const { sapiClient, cached } = context;
   return await cached(
@@ -40,4 +40,4 @@ export const getPromotionsByIds = defineRpcHandler(async (ids, context) => {
       cacheKeyPrefix: "getByIds-promotions"
     }
   )(ids);
-});
+}, { method: "GET" });

package/dist/rpc/methods/search.mjs

@@ -9,7 +9,7 @@ export const getSearchSuggestions = defineRpcHandler(async ({ term, with: _with,
       with: _with ?? withParams?.searchV2
     }
   );
-});
+}, { method: "GET" });
 export const resolveSearch = defineRpcHandler(async ({ term, with: _with, categoryId }, context) => {
   const { cached, sapiClient, withParams } = context;
   const resolvedEntity = await cached(sapiClient.searchv2.resolve, {
@@ -22,4 +22,4 @@ export const resolveSearch = defineRpcHandler(async ({ term, with: _with, catego
     return null;
   }
   return resolvedEntity;
-});
+}, { method: "GET" });

package/dist/rpc/methods/session.mjs

@@ -99,7 +99,7 @@ export const oauthLogin = defineRpcHandler(async (login, context) => {
       "Login failed"
     );
   }
-});
+}, { method: "POST" });
 export const oauthRegister = defineRpcHandler(async (register, context) => {
   if (!hasSession(context)) {
     return new ErrorResponse(
@@ -132,7 +132,7 @@ export const oauthRegister = defineRpcHandler(async (register, context) => {
       "Register failed"
     );
   }
-});
+}, { method: "POST" });
 export const oauthGuestLogin = defineRpcHandler(async (guest, context) => {
   if (!hasSession(context)) {
     return new ErrorResponse(
@@ -164,7 +164,7 @@ export const oauthGuestLogin = defineRpcHandler(async (guest, context) => {
       "Guest login failed"
     );
   }
-});
+}, { method: "POST" });
 export const refreshAccessToken = defineRpcHandler(async (context) => {
   if (!hasSession(context)) {
     return new ErrorResponse(
@@ -212,7 +212,7 @@ export const refreshAccessToken = defineRpcHandler(async (context) => {
     }
     return { success: false };
   }
-});
+}, { method: "POST" });
 export const oauthRevokeToken = defineRpcHandler(async (context) => {
   if (!hasSession(context)) {
     return new ErrorResponse(
@@ -251,7 +251,7 @@ export const oauthRevokeToken = defineRpcHandler(async (context) => {
     }
     return { result: false };
   }
-});
+}, { method: "POST" });
 export const oauthForgetPassword = defineRpcHandler(async ({ email }, context) => {
   if (!hasSession(context)) {
     return new ErrorResponse(
@@ -294,7 +294,7 @@ export const oauthForgetPassword = defineRpcHandler(async ({ email }, context) =
     }
     return { success: false };
   }
-});
+}, { method: "POST" });
 export const updatePasswordByHash = defineRpcHandler(async (passwordHash, context) => {
   if (!hasSession(context)) {
     return new ErrorResponse(
@@ -331,4 +331,4 @@ export const updatePasswordByHash = defineRpcHandler(async (passwordHash, contex
     );
   }
   return new Response(null, { status: HttpStatusCode.NO_CONTENT });
-});
+}, { method: "POST" });

package/dist/rpc/methods/shopConfiguration.mjs

@@ -8,5 +8,5 @@ const getShopConfiguration = defineRpcHandler(async (context) => {
       cacheKeyPrefix: "get-shopConfigurations"
     }
   )();
-});
+}, { method: "GET" });
 export { getShopConfiguration };

package/dist/rpc/methods/user.mjs

@@ -17,7 +17,9 @@ const getUser = defineRpcHandler(
     return {
       user
     };
-  }
+  },
+  // We use POST here to prevent user data to be leaking into caches.
+  { method: "POST" }
 );
 const fetchUser = defineRpcHandler(async ({ accessToken }, context) => {
   const { shopId } = context;
@@ -35,7 +37,7 @@ const fetchUser = defineRpcHandler(async ({ accessToken }, context) => {
     ({ shopId: shopId2 }) => shopId2 === context.shopId
   );
   return user;
-});
+}, { method: "POST" });
 const refreshUser = defineRpcHandler(async (context) => {
   if (!hasSession(context)) {
     return new ErrorResponse(
@@ -59,7 +61,7 @@ const refreshUser = defineRpcHandler(async (context) => {
     await context.destroySession();
     return { user: void 0 };
   }
-});
+}, { method: "POST" });
 const getAccessToken = defineRpcHandler(async ({ forceTokenRefresh = false } = { forceTokenRefresh: false }, context) => {
   if (!hasSession(context)) {
     return new ErrorResponse(
@@ -107,5 +109,5 @@ const getAccessToken = defineRpcHandler(async ({ forceTokenRefresh = false } = {
     }
   }
   return context.accessToken;
-});
+}, { method: "POST" });
 export { getUser, fetchUser, refreshUser, getAccessToken };

package/dist/rpc/methods/variants.mjs

@@ -16,4 +16,4 @@ export const getVariantById = defineRpcHandler(async ({ ids, include = defaultWi
     ids,
     include ? { with: resolvedWith, campaignKey, pricePromotionKey } : void 0
   );
-});
+}, { method: "GET" });

package/dist/rpc/methods/wishlist.mjs

@@ -33,7 +33,8 @@ export const getWishlist = defineRpcHandler(
         pricePromotionKey: pricePromotionKey ?? ""
       }
     );
-  }
+  },
+  { method: "POST" }
 );
 export const addItemToWishlist = defineRpcHandler(async (options, context) => {
   if (!hasSession(context)) {
@@ -46,7 +47,10 @@ export const addItemToWishlist = defineRpcHandler(async (options, context) => {
   const { sapiClient, wishlistKey } = context;
   const campaignKey = await context.callRpc?.("getCampaignKey");
   const { productId, variantId } = options;
-  const { pricePromotionKey, ...resolvedWith } = getWithParams(options, context);
+  const { pricePromotionKey, ...resolvedWith } = getWithParams(
+    options,
+    context
+  );
   if (!productId && !variantId) {
     return new ErrorResponse(
       HttpStatusCode.BAD_REQUEST,
@@ -70,7 +74,7 @@ export const addItemToWishlist = defineRpcHandler(async (options, context) => {
     context.log.error("Adding to wishlist failed", result.wishlist);
     return new Response(JSON.stringify({ kind, type }), { status: code });
   }
-});
+}, { method: "PUT" });
 export const removeItemFromWishlist = defineRpcHandler(async (options, context) => {
   if (!hasSession(context)) {
     return new ErrorResponse(
@@ -81,7 +85,10 @@ export const removeItemFromWishlist = defineRpcHandler(async (options, context)
   }
   const { sapiClient, wishlistKey } = context;
   const campaignKey = await context.callRpc?.("getCampaignKey");
-  const { pricePromotionKey, ...resolvedWith } = getWithParams(options, context);
+  const { pricePromotionKey, ...resolvedWith } = getWithParams(
+    options,
+    context
+  );
   return await mapSAPIFetchErrorToResponse(sapiClient.wishlist.deleteItem)(
     wishlistKey,
     options.itemKey,
@@ -91,7 +98,7 @@ export const removeItemFromWishlist = defineRpcHandler(async (options, context)
       pricePromotionKey: pricePromotionKey ?? ""
     }
   );
-});
+}, { method: "DELETE" });
 export const clearWishlist = defineRpcHandler(
   async (context) => {
     const wishlistResponse = await getWishlist({}, context);
@@ -105,5 +112,6 @@ export const clearWishlist = defineRpcHandler(
       })
     );
     return await getWishlist({}, context);
-  }
+  },
+  { method: "DELETE" }
 );

package/dist/types/api/rpc.d.ts

@@ -1,24 +1,37 @@
 import type { RpcContext } from './context';
+/**
+ * Discriminator attached to RPC handlers indicating whether they accept a
+ * parameters argument or only the RPC context.
+ */
+export type RpcType = 'NoParam' | 'WithParam';
+/**
+ * HTTP method an RPC handler is exposed under.
+ * `GET` is reserved for safe, idempotent, read-only calls (enables CDN/browser caching).
+ * `POST` is the default for every other call and for legacy handlers.
+ */
+export type RpcHttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
 /**
  * Type for an RPC handler that accepts parameters.
  *
- * @note In the upcoming major release `rpcType` property will be mandatory.
+ * @note In the upcoming major release the `rpcType` and `httpMethod` properties will be mandatory.
  *
  * @template Params The type of the parameters object.
  * @template ResponseType The type of the response.
  */
 export type ParamRpcHandler<Params extends Record<string, any>, ResponseType> = ((params: Params, context: RpcContext) => Promise<(ResponseType extends undefined ? void : ResponseType) | Response> | ResponseType | Response) & {
     rpcType?: 'WithParam';
+    httpMethod?: RpcHttpMethod;
 };
 /**
  * Type for an RPC handler that does not accept parameters.
  *
- * @note In the upcoming major release `rpcType` property will be mandatory.
+ * @note In the upcoming major release the `rpcType` and `httpMethod` properties will be mandatory.
  *
  * @template ResponseType The type of the response.
  */
 export type NoParamRpcHandler<ResponseType> = ((context: RpcContext) => Promise<ResponseType | Response> | ResponseType | Response) & {
     rpcType?: 'NoParam';
+    httpMethod?: RpcHttpMethod;
 };
 /**
  * Generic RPC handler type. Handles both cases with and without parameters.

package/dist/utils/hash.mjs

@@ -35,10 +35,15 @@ export const hmac = async (value, secret, algorithm = "SHA-256") => {
 };
 function base64ToBytes(base64) {
   const binString = atob(base64);
-  return Uint8Array.from(binString, (m) => m.codePointAt(0));
+  return Uint8Array.from(
+    binString,
+    (m) => m.codePointAt(0)
+  );
 }
 function bytesToBase64(bytes) {
-  const binString = Array.from(bytes, (x) => String.fromCodePoint(x)).join("");
+  const binString = Array.from(bytes, (x) => String.fromCodePoint(x)).join(
+    ""
+  );
   return btoa(binString);
 }
 export const encodeBase64 = (string) => {

package/dist/utils/index.d.ts

@@ -5,5 +5,6 @@ export * from './basket';
 export * from './campaign';
 export { unwrap } from './response';
 export { generateBasketKey, generateWishlistKey } from './keys';
-export { defineRpcHandler } from './rpc';
+export { defineRpcHandler, DEFAULT_RPC_HTTP_METHOD } from './rpc';
+export type { DefineRpcHandlerOptions } from './rpc';
 export { sha256 } from './hash';

package/dist/utils/index.mjs

@@ -5,5 +5,5 @@ export * from "./basket.mjs";
 export * from "./campaign.mjs";
 export { unwrap } from "./response.mjs";
 export { generateBasketKey, generateWishlistKey } from "./keys.mjs";
-export { defineRpcHandler } from "./rpc.mjs";
+export { defineRpcHandler, DEFAULT_RPC_HTTP_METHOD } from "./rpc.mjs";
 export { sha256 } from "./hash.mjs";

package/dist/utils/rpc.d.ts

@@ -1,27 +1,44 @@
 import type { RpcMethods, RpcMethodName } from '..';
-import type { RpcContext, RpcHandler } from '../types';
-type RpcType = 'NoParam' | 'WithParam';
+import type { RpcContext, RpcHandler, RpcHttpMethod, RpcType } from '../types';
+/**
+ * Options accepted by {@link defineRpcHandler}.
+ */
+export interface DefineRpcHandlerOptions {
+    /**
+     * HTTP method the RPC endpoint will be exposed under.
+     * Defaults to `'POST'`. Use `'GET'` for read-only, cacheable endpoints;
+     * `'PUT'` / `'DELETE'` for RESTful update/delete semantics.
+     */
+    method?: RpcHttpMethod;
+}
+/**
+ * Default HTTP method for RPC handlers when not explicitly specified.
+ */
+export declare const DEFAULT_RPC_HTTP_METHOD: RpcHttpMethod;
 /**
  * Defines an RPC method handler.
  *
  * @param handler - The RPC handler function.
+ * @param options - Optional handler options (e.g. HTTP method).
  * @returns The handler itself, with correct types enforced and internal properties set.
  */
-export declare function defineRpcHandler<Params extends Record<string, any> | undefined, Result>(handler: (params: Params, context: RpcContext) => Result | Response | Promise<Result | Response>): RpcHandler<Params, Result>;
+export declare function defineRpcHandler<Params extends Record<string, any> | undefined, Result>(handler: (params: Params, context: RpcContext) => Result | Response | Promise<Result | Response>, options?: DefineRpcHandlerOptions): RpcHandler<Params, Result>;
 /**
  * Defines an RPC method handler.
  *
  * @param handler - The RPC handler function.
+ * @param options - Optional handler options (e.g. HTTP method).
  * @returns The handler itself, with correct types enforced and internal properties set.
  */
-export declare function defineRpcHandler<Result>(handler: (context: RpcContext) => Result | Response | Promise<Result | Response>): RpcHandler<Result>;
+export declare function defineRpcHandler<Result>(handler: (context: RpcContext) => Result | Response | Promise<Result | Response>, options?: DefineRpcHandlerOptions): RpcHandler<Result>;
 /**
  * Defines an RPC method handler.
  *
  * @param handler The RPC handler function.
+ * @param options Optional handler options (e.g. HTTP method).
  * @returns The handler itself, with correct types enforced and internal properties set.
  */
-export declare function defineRpcHandler<T extends RpcMethods[RpcMethodName]>(handler: T): T & {
+export declare function defineRpcHandler<T extends RpcMethods[RpcMethodName]>(handler: T, options?: DefineRpcHandlerOptions): T & {
     rpcType: RpcType;
+    httpMethod: RpcHttpMethod;
 };
-export {};

package/dist/utils/rpc.mjs

@@ -1,5 +1,6 @@
-export function defineRpcHandler(handler) {
+export const DEFAULT_RPC_HTTP_METHOD = "POST";
+export function defineRpcHandler(handler, options) {
   const rpcType = handler.length === 1 ? "NoParam" : "WithParam";
-  const handlerWithType = Object.assign(handler, { rpcType });
-  return handlerWithType;
+  const httpMethod = options?.method ?? DEFAULT_RPC_HTTP_METHOD;
+  return Object.assign(handler, { rpcType, httpMethod });
 }