Helpers Requests Req Pattern

Example (client component)

import { webBuckets } from '@boilerplate/helpers-requests';
import { getApiBaseUrl } from '../../../../../lib/api-client';

const baseUrl = getApiBaseUrl();
const res = await webBuckets.reqPostPublicBucketMessage(baseUrl, bucketId, {
  senderName,
  body,
  isPublic,
});
if (!res.ok) {
  setSubmitError(res.error.message ?? 'Failed to submit');
  return;
}
// res.data available when res.ok

Example (server component)

import { webBuckets } from '@boilerplate/helpers-requests';
import { getServerApiBaseUrl } from '../../../../../lib/server-request';

const baseUrl = getServerApiBaseUrl();
const res = await webBuckets.reqFetchPublicBucket(baseUrl, id);
if (!res.ok || res.data?.bucket === undefined) return null;
return res.data.bucket;

When to use this skill

• Adding or changing any HTTP request from apps/web or apps/management-web to the main API or management API.
• Reviewing or refactoring code that uses fetch(...) or direct HTTP calls to app backends.
• Adding a new API endpoint and wiring it in the frontend: add the req... helper first, then use it in the app.