@poweredbysous/storefront-sdk

Type-safe TypeScript SDK for storefront-facing Storefront Backend endpoints (/api/v1) generated from OpenAPI.

Install

npm install @poweredbysous/storefront-sdk

pnpm add @poweredbysous/storefront-sdk

yarn add @poweredbysous/storefront-sdk

Usage

import { createStorefrontClient } from "@poweredbysous/storefront-sdk";

const client = createStorefrontClient({
  baseUrl: "https://api.example.com",
  vendorId: "BRASSERIE_VD_01",
  language: "nl",
});

const response = await client.GET("/api/v1/products/");

language sets the Accept-Language request header and, by default, appends ?lang=<language> to GET/HEAD/OPTIONS requests when lang is missing. Disable query injection with appendLanguageQuery: false.

Error Handling

sdkErrorFromResponse(response) returns SDKError with:

• status HTTP status code
• code machine-readable API error code (when present)
• retryable retry hint based on status/code
• requestId correlation ID from request_id (when present)

Development

npm ci
npm run generate
npm run test
npm run build

Generated types live in src/generated/schema.ts.