@pack/hydrogen

Hydrogen runtime integration for Pack content, preview, A/B testing, and server-side error tracking.

Install

npm install @pack/hydrogen

Main exports

• createPackClient
• handleRequest
• PackSession, PackTestSession
• previewModeAction, previewModeLoader
• A/B test helpers (PackTestProvider, useAbTest, etc.)

Minimal setup

import {
  createPackClient,
  handleRequest,
} from '@pack/hydrogen';
import { createServerErrorHandler } from '@pack/errors';

// Optional if you want route-level error capture in addition to handleRequest wrapping.
// Duplicate reports for the same Error instance are deduplicated automatically.
export const handleError = createServerErrorHandler();

export default async function fetch(request: Request, env: Env, ctx: ExecutionContext) {
  const pack = createPackClient({
    cache: caches.default,
    waitUntil: ctx.waitUntil.bind(ctx),
    storeId: env.PACK_STORE_ID,
    token: env.PACK_API_TOKEN,
    errorTracking: {
      dsn: env.PUBLIC_PACK_ERROR_TRACKING_DSN,
    },
    session,
    testSession,
  });

  return handleRequest(pack, request, (req) => storefrontHandler(req));
}

Development

yarn
yarn build