Version Packages (#48)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

.changeset/few-wombats-reply.md

@@ -1,5 +1,51 @@
 # @vercel/flags
 
+## 3.1.0
+
+### Minor Changes
+
+- 76feb16: Add `mergeProviderData` function to `@vercel/flags`.
+
+  This function allows merging ProviderData from multiple sources.
+
+  This is handy when you declare feature flags in code, and want to extend those definitions with data loaded from your feature flag provider.
+
+  ```ts
+  import { verifyAccess, mergeProviderData, type ApiData } from '@vercel/flags';
+  import { getProviderData } from '@vercel/flags/next';
+  import { NextResponse, type NextRequest } from 'next/server';
+  import { getProviderData as getStatsigProviderData } from '@flags-sdk/statsig';
+  import * as flagsA from '../../../../flags-a'; // your feature flags file(s)
+  import * as flagsB from '../../../../flags-b'; // your feature flags file(s)
+
+  export async function GET(request: NextRequest) {
+    const access = await verifyAccess(request.headers.get('Authorization'));
+    if (!access) return NextResponse.json(null, { status: 401 });
+
+    const providerData = await mergeProviderData([
+      // expose flags declared in code first
+      getProviderData({ ...flagsA, ...flagsB }),
+      // then enhance them with metadata from your flag provider
+      getStatsigProviderData({ consoleApiKey: '', projectId: '' }),
+    ]);
+
+    return NextResponse.json<ApiData>(providerData);
+  }
+  ```
+
+### Patch Changes
+
+- 2713ea7: Handle `undefined` values
+
+  - fix: Fall back to `defaultValue` when a feature flag returns `undefined`
+  - fix: Throw error when a flag resolves to `undefined` and no `defaultValue` is present
+
+  The value `undefined` can not be serialized so feature flags should never resolve to `undefined`. Use `null` instead.
+
+  Fix exports
+
+  - fix: Export `Identify` and `Decide` types
+
 ## 3.0.2
 
 ### Patch Changes

.changeset/light-shirts-fix.md

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/flags",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "description": "Flags SDK by Vercel - The feature flags toolkit for Next.js and SvelteKit",
   "keywords": [
     "feature flags",