Migrate Node 2.0 to 2.1

This page documents @fireweaveai/sdk 2.0.0 → 2.1.0 only: the direct PostHog adapter came out. It is not the current surface.

After 2.1 you still need Migrate 2.1 to 2.3. That cut renames the package to @fireweaveai/server-sdk, removes the OpenFeature providers, removes the extension namespaces, and makes mode required. Do not stop here.

Every breakage below is quoted from the SDK CHANGELOG.md or the Node section of docs/migration.md as they described 2.1.

Version note (from CHANGELOG)

The 2.1.0 work was drafted as 3.0.0 and 3.1.0 and released as a single 2.1.0. Neither 3.x version reached a registry. Those changes shipped in a minor. A consumer pinned ^2.0.0 picked 2.1.0 up automatically and, if they imported @fireweaveai/sdk/posthog, failed to build.

Required — exactly three breakages

CHANGELOG: “Exactly three things break.”

1. `@fireweaveai/sdk/posthog` no longer resolves

Replace PostHogAdapter with FireweaveRemoteAdapter. Env vars POSTHOG_HOST / POSTHOG_API_KEY become FW_API_URL / FW_PROJECT_API_KEY.

// 2.0.0
import { PostHogAdapter } from '@fireweaveai/sdk/posthog';
const adapter = new PostHogAdapter({
  projectApiKey: process.env.POSTHOG_API_KEY,
  host: process.env.POSTHOG_HOST,
  featureFlagsRequestTimeoutMs: 3000,
});

// 2.1.0 — still the 2.1 package name
import { FireweaveRemoteAdapter } from '@fireweaveai/sdk';
const adapter = new FireweaveRemoteAdapter({
  apiUrl: process.env.FW_API_URL,
  apiKey: process.env.FW_PROJECT_API_KEY,
  requestTimeoutMs: 3000,
});

On 2.3 this adapter construction is usually replaced by initFireweave from @fireweaveai/server-sdk. See Migrate 2.1 to 2.3.

Before	After (2.1)
`POSTHOG_HOST`	`FW_API_URL` — fw-server base URL
`POSTHOG_API_KEY` (`phc_…`)	`FW_PROJECT_API_KEY` (`project-api-key_…`)
`featureFlagsRequestTimeoutMs`	`requestTimeoutMs`
`secretApiKey` / `onlyEvaluateLocally` / `featureFlagsPollingInterval`	no equivalent
`posthog-node` in your `package.json`	remove it, unless you use it for your own analytics

The new key is a Fireweave project key, not a re-labelled vendor key.

2. `posthog-node` is no longer a peer dependency

If you use it for analytics, depend on it directly.

3. Type-level: `'posthog'` removed from adapter unions

'posthog' is no longer a member of BackendAdapter['name'] or Capabilities['runtime']['backend']. Affects custom adapters declaring name: 'posthog' (use 'other') and exhaustive switches on backend. CHANGELOG also records features.posthogAdapter → features.remoteAdapter.

Removed capability — in-process local evaluation

CHANGELOG:

The vendor adapter’s secret-key mode (background definition polling, onlyEvaluateLocally, staleness detection, waitForLocalDefinitions) has no replacement; caching is fw-server’s concern and both shipped adapters report localEvaluation: false.

2.3 mode: 'local' is a seeded boolean map, not this vendor poller.

Not breaking in 2.1 — removed later

These were deliberately not breaking in 2.1. They are breaking in 2.3:

2.1 status	2.3
`client.flags` still exists and is `client.controlPoints`	Still an alias. Use `controlPoints` in new code
`capabilities.get().static.features.flags` still `true`	`capabilities` namespace removed
`FireweaveProvider` / OpenFeature peer	Removed
`releases` / `exposures` / `signals` / `guardrails`	Removed
SDK may read `FW_API_URL` / `FW_PROJECT_API_KEY`	SDK reads no environment
`FW_DEPRECATION_WARNINGS=1`	Does not exist

Decision.flagKey, InMemoryAdapterOptions.flags, and features.flags stay. See Migrate 2.1 to 2.3.

Changed — `DEFAULT_ALLOWED_HOSTS` contents

The export name stayed. Contents now list Fireweave hosts (app-server.fireweave.ai, staging-app-server.fireweave.ai, loopback), not vendor hosts. Code doing allowedHosts: [...DEFAULT_ALLOWED_HOSTS, 'mine.example'] keeps compiling and no longer permits the old endpoints. Intended; verify against your deployment.

What this page does not document

Migrating from direct PostHog SDK calls
Migrating from another OpenFeature provider (that provider is gone in 2.3)
Migrating from @fireweaveai/deploy-sdk
The 2.1 → 2.3 cut — that is Migrate 2.1 to 2.3

Migrate 2.1 to 2.3

Package rename, OpenFeature removal, required mode

Node SDK

Current server-sdk surface

Get Started

SDKs

Concepts

Production

CLI

Terraform

Testing

Troubleshooting

Migration

Reference

Migrate Node 2.0 to 2.1

Version note (from CHANGELOG)

Required — exactly three breakages

1. `@fireweaveai/sdk/posthog` no longer resolves

2. `posthog-node` is no longer a peer dependency

3. Type-level: `'posthog'` removed from adapter unions

Removed capability — in-process local evaluation

Not breaking in 2.1 — removed later

Changed — `DEFAULT_ALLOWED_HOSTS` contents

What this page does not document

Next

Migrate 2.1 to 2.3

Node SDK

​Version note (from CHANGELOG)

​Required — exactly three breakages

​1. @fireweaveai/sdk/posthog no longer resolves

​2. posthog-node is no longer a peer dependency

​3. Type-level: 'posthog' removed from adapter unions

​Removed capability — in-process local evaluation

​Not breaking in 2.1 — removed later

​Changed — DEFAULT_ALLOWED_HOSTS contents

​What this page does not document

​Next

Migrate 2.1 to 2.3

Node SDK

Version note (from CHANGELOG)

Required — exactly three breakages

1. `@fireweaveai/sdk/posthog` no longer resolves

2. `posthog-node` is no longer a peer dependency

3. Type-level: `'posthog'` removed from adapter unions

Removed capability — in-process local evaluation

Not breaking in 2.1 — removed later

Changed — `DEFAULT_ALLOWED_HOSTS` contents

What this page does not document

Next