Contentful Personalization & Analytics

Node SSR Only Reference Implementation

This is a reference implementation for the Optimization Node SDK and is part of the Contentful Optimization SDK Suite.

The server creates one stateless Node SDK instance at module load and passes request-specific options directly to stateless event methods inside each incoming request handler.

Setup

All steps should be run from the monorepo root.

1. Install pnpm packages:

   pnpm install
   Copy

2. Build the local package tarballs consumed by implementations:

   pnpm build:pkgs
   Copy

3. Install this implementation so its local @contentful/* dependencies resolve from pkgs/:

   pnpm implementation:run -- node-sdk implementation:install
   Copy

4. Configure the environment in a .env file in implementations/node-sdk based on the .env.example included file. The file is pre-populated with values that are valid only against the mock server implementation. To test the implementation against a live server environment, see the mocks package for information on how to set up Contentful space with test data.

5. Start the mock API and application servers:

   pnpm --dir implementations/node-sdk --ignore-workspace serve
   Copy

6. The application can be accessed via Web browser at http://localhost:3000

7. Stop the mock API and application servers:

   pnpm --dir implementations/node-sdk --ignore-workspace serve:stop
   Copy

See implementations/node-sdk/package.json for more commands.

Running From Root Scripts

You can run this implementation from the monorepo root via the root package.json implementation scripts.

1. Start servers:

   pnpm run implementation:node-sdk -- serve
   Copy

2. Stop servers:

   pnpm run implementation:node-sdk -- serve:stop
   Copy

3. Run E2E:

   pnpm run implementation:node-sdk -- test:e2e
   Copy

Running E2E Tests

E2E tests are run using Playwright.

1. Install Playwright dependencies:

   pnpm --dir implementations/node-sdk --ignore-workspace exec playwright install --with-deps
   Copy

2. Run the E2E test suite:

   pnpm --dir implementations/node-sdk --ignore-workspace test:e2e
   Copy

   The tests can alternatively be run using Playwright's GUI:

   pnpm --dir implementations/node-sdk --ignore-workspace test:e2e:ui
   Copy