@adobe/aio-commerce-sdk

[!WARNING] This package is a work in progress and is not yet ready for use yet. You may be able to install it, but if you do, expect breaking changes.

Meta-package that re-exports Adobe Commerce SDK libraries for Adobe App Builder applications.

This package serves as a convenient entry point for accessing commonly used Adobe Commerce libraries in App Builder projects, similar to how @adobe/aio-sdk works for general App Builder development.

Installation

pnpm install @adobe/aio-commerce-sdk

Overview

The @adobe/aio-commerce-sdk is a meta-package that consolidates and re-exports the most commonly used Adobe Commerce libraries for App Builder applications. Rather than installing and importing multiple individual packages, you can use this single package to access all the essential Commerce functionality.

Current Libraries

The SDK currently includes:

• @adobe/aio-commerce-lib-auth: Authentication utilities for Adobe Commerce apps, supporting both IMS and Commerce integrations authentication.

• @adobe/aio-commerce-lib-core: Core utilities for the Adobe Commerce SDK.

• @adobe/aio-commerce-lib-api: A set of utilities to build HTTP/API clients for I/O Events and Adobe Commerce.

• @adobe/aio-commerce-lib-events: Event management utilities to interact with the Adobe I/O and Commerce Eventing APIs.

Usage

Import directly from a specific library sub-path:

import {
  assertImsAuthParams,
  getImsAuthProvider,
  assertIntegrationAuthParams,
  getIntegrationAuthProvider,
} from "@adobe/aio-commerce-sdk/auth"; // <-- This is like @adobe/aio-commerce-lib-auth

import { AdobeCommerceHttpClient } from "@adobe/aio-commerce-sdk/api"; // <-- This is like @adobe/aio-commerce-lib-api
import {
  createCommerceEventsApiClient,
  updateEventingConfiguration,
} from "@adobe/aio-commerce-sdk/events/commerce"; // <-- This is like @adobe/aio-commerce-lib-events/commerce

// Validate and create IMS auth provider
assertImsAuthParams(params);
const imsAuth = getImsAuthProvider(params);

const commerceHttpClientConfig = {
  auth: imsAuth,
  config: {
    baseUrl: "https://na1-sandbox.api.commerce.adobe.com/{tenantId}/",
    flavor: "saas",
  },
};

const updateEventingConfigurationParams = {
  enabled: true,
  environmentId: "my-environment-id",
  instanceId: "my-instance-id",
  merchantId: "my-merchant-id",
  providerId: "my-provider-id",
  workspaceConfiguration: {
    // ...
  },
};

// Use the raw HTTP client
const commerceClient = new AdobeCommerceHttpClient(commerceHttpClientConfig);
await updateEventingConfiguration(
  commerceClient,
  updateEventingConfigurationParams,
);

// Or create an API client with a pre-bound HTTP client.
const commerceEventsClient = createCommerceEventsApiClient(
  commerceHttpClientConfig,
);

await commerceEventsClient.updateEventingConfiguration(
  updateEventingConfigurationParams,
);

Benefits

• Simplified dependency management: Install one package instead of multiple individual libraries
• Consistent versioning: All included libraries are tested together for compatibility
• Better developer experience: Single import source for common Commerce functionality
• Tree-shaking support: Both import patterns support dead code elimination
• Type safety: Full TypeScript support with type definitions included

Contributing

This package is part of the Adobe Commerce SDK monorepo. See the Contributing Guide and Development Guide for development setup and guidelines.

Refer to this section of the development guide if you want to add your library to the SDK: Add it to the SDK (optional)