@flagsync/nextjs-sdk 0.2.7 → 0.3.0

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2005 Mike Chabot (FlagSync)
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -1,288 +1,14 @@
-# FlagSync Adapter for Vercel Flags
+# FlagSync SDK for Next.js
 
-[FlagSync](https://www.flagsync.com) brings affordable, user-friendly feature flags and A/B testing to indie hackers and growing businesses. This adapter integrates FlagSync with [Vercel Flags](https://vercel.com/docs/flags) in Next.js apps. [Get started](https://docs.flagsync.com/getting-started/set-up-flagsync) today!
+The `@flagsync/nextjs-sdk` integrates into Next.js applications with [Vercel Flags](https://flags-sdk.dev/) for feature management and event tracking—ideal for SSR and static site generation workflows.
 
 [![npm version](https://badge.fury.io/js/%40flagsync%2Fvercel-flags-sdk.svg)](https://badge.fury.io/js/%40flagsync%2Fvercel-flags-sdk)
-[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/flagsync.svg?style=social&label=Follow%20%40flagsync)](https://twitter.com/flagsync)
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
-
----
-
-## Getting Started
-
-Refer to the [SDK documentation](https://docs.flagsync.com/sdks/next.js) for more information on how to use this library.
-
-### Compatibility
+[![Twitter URL](https://img.shields.io/twitter/url/https/twitter.com/flagsync.svg?style=social&label=Follow%20%40flagsync)](https://twitter.com/flagsync)
 
+## Compatibility
 - Requires [Next.js](https://nextjs.org/) 14+
-- Compatible with Node.js 16+ and ES5.
-- TypeScript is fully supported.
-- **Note:** This SDK is optimized for Next.js App Router. For non-Next.js Node.js apps, use the [FlagSync Node SDK](https://github.com/flagsync/node-client) instead.
-
-### Prerequisites
-- Install the SDK: `npm install @flagsync/vercel-flags-sdk flags/next`
-- Set the `FLAGSYNC_SDK_KEY` environment variable in your `.env` file.
-
-## Basic Setup
-
-FlagSync lets you toggle features and personalize experiences in your Next.js App Router application. Follow these steps to set it up.
-
-### Step 1: Create the FlagSync client singleton
-
-Initialize the client with your server-side SDK key:
-
-```typescript
-// lib/flagsync.ts
-import { createFlagSyncClient } from '@flagsync/vercel-flags-sdk';
-
-export const client = createFlagSyncClient({
-  sdkKey: process.env.FLAGSYNC_SDK_KEY!,
-});
-```
-
-### Step 2: Set up user identification
-
-> [!NOTE]
-> Feature flags in FlagSync use user context (e.g. via `identify`) to enable personalized experiences.
-
-The `identify` function defines how users are identified (e.g., via cookies, headers, or session data). See [Identify](#identify) for more details.
-
-```typescript
-// lib/flagsync.ts
-import {
-  createIdentify,
-  createFlagSyncClient,
-} from '@flagsync/vercel-flags-sdk';
-
-export const identify = createIdentify(({ cookies }) => {
-  const userId = cookies.get('user-id')?.value;       // Authenticated user ID
-  const visitorId = cookies.get('visitor-id')?.value; // Unauthenticated visitor ID
-  return {
-    key: userId ?? visitorId ?? 'anonymous'           // Fallback to 'anonymous'
-  };
-});
-```
-> [!CAUTION]
-> While `anonymous` user contexts are supported, always provide a unique identifier (even for unauthenticated users) to ensure consistent flag evaluation.
-> 
-> See [Identify](#identify) for more details.
-
-### Step 3: Define a feature flag
-
-Create a flag definition using the shared `client` and `identify` function:
-
-```typescript
-// app/dashboard/flags.ts
-import { flag } from 'flags/next';
-import { client, identify } from '@/lib/flagsync';
-import { createStringFlagAdaptor } from '@flagsync/vercel-flags-sdk';
-
-export const dashboardFlag = flag<string>({
-  identify,                                 // Links flag to user context
-  key: 'dashboardFlag',                     // Unique flag key
-  adapter: createStringFlagAdaptor(client), // Retrieves the flag with type safety
-});
-```
-
-### Step 4: Use the flag in your app
-
-Now you can use `dashboardFlag` in your Server Components:
-
-```typescript jsx
-// app/dashboard/page.tsx
-
-import { dashboardFlag } from '@/app/dashboard/flags';
-
-export default async function DashboardPage() {
-  const dashboard = await dashboardFlag();
-
-  return (
-    <div>The value of {dashboardFlag.key} is {dashboard}</div>
-  );
-}
-```
-
-## Type-Safe Feature Flags
-
-FlagSync supports multiple flag types for different use cases. Use the type-specific adapter depending on your flag type: 
-
-- `createBoolFlagAdaptor`: For boolean flags
-- `createStringFlagAdaptor`: For string flags
-- `createNumberFlagAdaptor`: For numeric flags
-- `createJsonFlagAdaptor`: For JSON object flags
-
-```typescript
-// app/<route>/flags.ts
-import { client, identify } from '@/lib/flagsync';
-import {
-  createBoolFlagAdaptor,
-  createJsonFlagAdaptor,
-  createNumberFlagAdaptor,
-  createStringFlagAdaptor,
-} from '@flagsync/vercel-flags-sdk';
-import { flag } from '@vercel/flags';
-
-// Boolean flag for feature toggles
-export const betaFeatureFlag = flag<boolean>({
-  identify,
-  key: 'beta-feature-enabled',
-  adapter: createBoolFlagAdaptor(client),
-});
-
-// String flag for UI variants
-export const heroCtaFlag = flag<string>({
-  identify,
-  key: 'hero-cta',
-  adapter: createStringFlagAdaptor(client),
-});
-
-// Number flag for pricing tiers
-export const discountFlag = flag<number>({
-  identify,
-  key: 'price-discount',
-  adapter: createNumberFlagAdaptor(client),
-});
+- Compatible with Node.js 16+ and ES5
+- TypeScript is fully supported
 
-// JSON flag for complex configurations
-export const featureConfigFlag = flag<{
-  enabled: boolean;
-  limits: { requests: number; storage: number };
-}>({
-  identify,
-  key: 'feature-config',
-  adapter: createJsonFlagAdaptor(client),
-});
-```
-
-## Identify
-
-The `identify` function links feature flags to user contexts in FlagSync by returning an `FsUserContext` object.
-
-```typescript
-type FsUserContext = {
-  key: string;  // Unique identifier for the user
-  attributes?: Record<string, string | number | boolean>; // Optional custom data (used in individual targeting)
-};
-```
-* `key`: A unique ID for the user (required)
-* `attributes`: Optional metadata (e.g., user agent, region, role, department) to personalize flag evaluations.
-
-> [!IMPORTANT]
-> User contexts enable personalized flag evaluations via [Individual Targeting](https://docs.flagsync.com/sdks/sdk-concepts/flag-evaluation#does-the-flag-have-any-individual-targeting-rules), and consistent experiences during [Percentage Rollouts](https://docs.flagsync.com/sdks/sdk-concepts/flag-evaluation#does-the-flag-have-a-percentage-rollout).
-
-We recommend:
-1. Using a helper function (getFlagSyncUserContext) to build the full context.
-2. Setting cookies in middleware for the key.
-
-Here's how:
-
-### Step 1: Define a helper function
-
-Create a utility to build the user context:
-
-```typescript
-// lib/flagsync.user-context.ts
-import type { ReadonlyRequestCookies, ReadonlyHeaders } from 'flags';
-import { dedupe } from 'flags/next';
-import { nanoid } from 'nanoid';
-import type { NextRequest } from 'next/server';
-
-const generateId = dedupe(async () => nanoid());
-
-export const getFlagSyncUserContext = async (
-  cookies: ReadonlyRequestCookies | NextRequest['cookies'],
-  headers: ReadonlyHeaders | NextRequest['headers'],
-) => {
-  const userId = cookies.get('user-id')?.value; // Authenticated user
-  const visitorId = cookies.get('visitor-id')?.value; // Anonymous visitor
-
-  return {
-    key: userId ?? visitorId ?? (await generateId()), // Fallback to new ID
-    attributes: {
-      userAgent: headers.get('user-agent') || 'unknown', // Browser info
-      region: headers.get('x-region-code') || 'default', // Custom header
-    },
-  };
-};
-
-```
-### Step 2: Set up identification
-
-Use the helper in `identify`:
-
-```typescript
-// lib/flagsync.ts
-import { createIdentify, createFlagSyncClient } from '@flagsync/vercel-flags-sdk';
-import { getFlagSyncUserContext } from '@lib/flagsync.user-context';
-
-export const identify = createIdentify(({ cookies, headers }) => {
-  return getFlagSyncUserContext(cookies, headers);
-});
-
-export const client = createFlagSyncClient({
-  sdkKey: process.env.FLAGSYNC_SDK_KEY!,
-});
-```
-
-### Step 3: Handle cookies in middleware
-
-```typescript
-// middleware.ts
-import { NextRequest, NextResponse } from 'next/server';
-import { nanoid } from 'nanoid';
-
-export async function middleware(request: NextRequest) {
-  const response = NextResponse.next();
-
-  // Example: Get userId from a JWT or API call (replace with your logic)
-  const jwt = request.cookies.get('jwt')?.value;
-  let userId: string | undefined;
-  if (jwt) {
-    userId = 'user@example.com'; // Stub: e.g., await decodeJwt(jwt).email
-  }
-
-  if (userId) {
-    response.cookies.set('user-id', userId, { maxAge: 60 * 60 * 24 * 7 });
-  } else {
-    const visitorId = request.cookies.get('visitor-id')?.value ?? nanoid();
-    response.cookies.set('visitor-id', visitorId, { maxAge: 60 * 60 * 24 * 365 });
-  }
-
-  return response;
-}
-
-export const config = {
-  matcher: [
-    /*
-     * Match all request paths except for the ones starting with:
-     * - api (API routes)
-     * - _next/static (static files)
-     * - _next/image (image optimization files)
-     * - favicon.ico (favicon file)
-     */
-    {
-      source: '/((?!api|_next/static|_next/image|favicon.ico).*)',
-      missing: [
-        { type: 'header', key: 'next-router-prefetch' },
-        { type: 'header', key: 'purpose', value: 'prefetch' },
-      ],
-    },
-  ],
-};
-
-```
-
-## Next Steps
-
-- Configure flags in the [FlagSync dashboard](https://www.flagsync.com/dashboard).
-- Explore the [Docs](https://docs.flagsync.com/) for information on how to use FlagSync.
-
-## Environment Variables
-
-Required environment variables:
-
-- `FLAGSYNC_SDK_KEY`: Your server-side FlagSync SDK key (required)
-
-### License
-
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
+## Getting Started
+Refer to the [SDK documentation](https://docs.flagsync.com/sdks-server-side/nextjs) for setup instructions and usage details.

package/dist/index.cjs

@@ -39,7 +39,7 @@ function createFlagSyncClient(config) {
     ...config,
     metadata: {
       sdkName: "@flagsync/nextjs-sdk",
-      sdkVersion: "0.2.7"
+      sdkVersion: "0.3.0"
     }
   });
   return instance.client();

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/adapter.ts","../src/identify.ts"],"sourcesContent":["export type {\n  CustomAttributes,\n  CustomAttributeValue,\n  FsConfig,\n  FsClient,\n  LogLevel,\n  FsUserContext,\n} from '@flagsync/node-sdk';\n\nexport { SyncType } from '@flagsync/node-sdk';\n\nexport type { JsonObject } from './types';\n\nexport {\n  createFlagSyncClient,\n  createFlagSyncAdapter,\n  createBoolFlagAdaptor,\n  createStringFlagAdaptor,\n  createJsonFlagAdaptor,\n  createNumberFlagAdaptor,\n} from './adapter';\n\nexport { createIdentify } from './identify';\n","import {\n  FlagSyncFactory,\n  FsClient,\n  type FsConfig,\n  type FsUserContext,\n} from '@flagsync/node-sdk';\nimport type { Adapter } from '@vercel/flags';\n\nimport { JsonObject } from './types';\n\n/**\n * Creates a FlagSync client instance that can be used across multiple feature flags.\n * This function should be called once to create a singleton client for your application.\n */\nexport function createFlagSyncClient(config: FsConfig): FsClient {\n  const instance = FlagSyncFactory({\n    ...config,\n    metadata: {\n      sdkName: '@flagsync/nextjs-sdk',\n      sdkVersion: '0.2.7',\n    },\n  });\n  return instance.client();\n}\n\n/**\n * Creates an adapter factory that integrates FlagSync with Vercel's feature flag system.\n * This adapter handles the communication between your application and the FlagSync service.\n */\nexport function createFlagSyncAdapter(client: FsClient) {\n  let isReady = false;\n\n  /**\n   * Ensures the FlagSync client is ready before making any flag decisions.\n   * This is called internally before each flag evaluation.\n   */\n  const ensureReady = async () => {\n    if (!isReady) {\n      await client.waitForReady();\n      isReady = true;\n    }\n  };\n\n  /**\n   * Creates a typed adapter instance for a specific flag value type.\n   */\n  return function flagSyncAdapter<ValueType>(): Adapter<\n    ValueType,\n    FsUserContext\n  > {\n    return {\n      /**\n       * Evaluates a feature flag for a given context and returns its value.\n       */\n      async decide({ key, entities }) {\n        await ensureReady();\n\n        const userContext: FsUserContext = {\n          key: 'anonymous',\n          ...(entities ?? {}),\n        };\n\n        return client.flag<ValueType>(userContext, key);\n      },\n    };\n  };\n}\n\n/** Creates an adapter for string-typed flags */\nexport const createStringFlagAdaptor = (\n  client: FsClient,\n): Adapter<string, FsUserContext> => createFlagSyncAdapter(client)<string>();\n\n/** Creates an adapter for boolean-typed flags */\nexport const createBoolFlagAdaptor = (\n  client: FsClient,\n): Adapter<boolean, FsUserContext> => createFlagSyncAdapter(client)<boolean>();\n\n/** Creates an adapter for number-typed flags */\nexport const createNumberFlagAdaptor = (\n  client: FsClient,\n): Adapter<number, FsUserContext> => createFlagSyncAdapter(client)<number>();\n\n/** Creates an adapter for JSON object-typed flags */\nexport const createJsonFlagAdaptor = (\n  client: FsClient,\n): Adapter<JsonObject, FsUserContext> =>\n  createFlagSyncAdapter(client)<JsonObject>();\n","import { FsUserContext } from '@flagsync/node-sdk';\nimport { Identify } from '@vercel/flags';\n\ntype ExtractParams<T> = T extends (params: infer P) => any ? P : never;\n\nexport const createIdentify =\n  (\n    callback: (\n      params: ExtractParams<Identify<FsUserContext>>,\n    ) => Promise<FsUserContext> | FsUserContext,\n  ): Identify<FsUserContext> =>\n  (params) =>\n    callback(params);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,IAAAA,mBAAyB;;;ACTzB,sBAKO;AASA,SAAS,qBAAqB,QAA4B;AAC/D,QAAM,eAAW,iCAAgB;AAAA,IAC/B,GAAG;AAAA,IACH,UAAU;AAAA,MACR,SAAS;AAAA,MACT,YAAY;AAAA,IACd;AAAA,EACF,CAAC;AACD,SAAO,SAAS,OAAO;AACzB;AAMO,SAAS,sBAAsB,QAAkB;AACtD,MAAI,UAAU;AAMd,QAAM,cAAc,YAAY;AAC9B,QAAI,CAAC,SAAS;AACZ,YAAM,OAAO,aAAa;AAC1B,gBAAU;AAAA,IACZ;AAAA,EACF;AAKA,SAAO,SAAS,kBAGd;AACA,WAAO;AAAA;AAAA;AAAA;AAAA,MAIL,MAAM,OAAO,EAAE,KAAK,SAAS,GAAG;AAC9B,cAAM,YAAY;AAElB,cAAM,cAA6B;AAAA,UACjC,KAAK;AAAA,UACL,GAAI,YAAY,CAAC;AAAA,QACnB;AAEA,eAAO,OAAO,KAAgB,aAAa,GAAG;AAAA,MAChD;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,0BAA0B,CACrC,WACmC,sBAAsB,MAAM,EAAU;AAGpE,IAAM,wBAAwB,CACnC,WACoC,sBAAsB,MAAM,EAAW;AAGtE,IAAM,0BAA0B,CACrC,WACmC,sBAAsB,MAAM,EAAU;AAGpE,IAAM,wBAAwB,CACnC,WAEA,sBAAsB,MAAM,EAAc;;;AClFrC,IAAM,iBACX,CACE,aAIF,CAAC,WACC,SAAS,MAAM;","names":["import_node_sdk"]}
+{"version":3,"sources":["../src/index.ts","../src/adapter.ts","../src/identify.ts"],"sourcesContent":["export type {\n  CustomAttributes,\n  CustomAttributeValue,\n  FsConfig,\n  FsClient,\n  LogLevel,\n  FsUserContext,\n} from '@flagsync/node-sdk';\n\nexport { SyncType } from '@flagsync/node-sdk';\n\nexport type { JsonObject } from './types';\n\nexport {\n  createFlagSyncClient,\n  createFlagSyncAdapter,\n  createBoolFlagAdaptor,\n  createStringFlagAdaptor,\n  createJsonFlagAdaptor,\n  createNumberFlagAdaptor,\n} from './adapter';\n\nexport { createIdentify } from './identify';\n","import {\n  FlagSyncFactory,\n  FsClient,\n  type FsConfig,\n  type FsUserContext,\n} from '@flagsync/node-sdk';\nimport type { Adapter } from '@vercel/flags';\n\nimport { JsonObject } from './types';\n\n/**\n * Creates a FlagSync client instance that can be used across multiple feature flags.\n * This function should be called once to create a singleton client for your application.\n */\nexport function createFlagSyncClient(config: FsConfig): FsClient {\n  const instance = FlagSyncFactory({\n    ...config,\n    metadata: {\n      sdkName: '@flagsync/nextjs-sdk',\n      sdkVersion: '0.3.0',\n    },\n  });\n  return instance.client();\n}\n\n/**\n * Creates an adapter factory that integrates FlagSync with Vercel's feature flag system.\n * This adapter handles the communication between your application and the FlagSync service.\n */\nexport function createFlagSyncAdapter(client: FsClient) {\n  let isReady = false;\n\n  /**\n   * Ensures the FlagSync client is ready before making any flag decisions.\n   * This is called internally before each flag evaluation.\n   */\n  const ensureReady = async () => {\n    if (!isReady) {\n      await client.waitForReady();\n      isReady = true;\n    }\n  };\n\n  /**\n   * Creates a typed adapter instance for a specific flag value type.\n   */\n  return function flagSyncAdapter<ValueType>(): Adapter<\n    ValueType,\n    FsUserContext\n  > {\n    return {\n      /**\n       * Evaluates a feature flag for a given context and returns its value.\n       */\n      async decide({ key, entities }) {\n        await ensureReady();\n\n        const userContext: FsUserContext = {\n          key: 'anonymous',\n          ...(entities ?? {}),\n        };\n\n        return client.flag<ValueType>(userContext, key);\n      },\n    };\n  };\n}\n\n/** Creates an adapter for string-typed flags */\nexport const createStringFlagAdaptor = (\n  client: FsClient,\n): Adapter<string, FsUserContext> => createFlagSyncAdapter(client)<string>();\n\n/** Creates an adapter for boolean-typed flags */\nexport const createBoolFlagAdaptor = (\n  client: FsClient,\n): Adapter<boolean, FsUserContext> => createFlagSyncAdapter(client)<boolean>();\n\n/** Creates an adapter for number-typed flags */\nexport const createNumberFlagAdaptor = (\n  client: FsClient,\n): Adapter<number, FsUserContext> => createFlagSyncAdapter(client)<number>();\n\n/** Creates an adapter for JSON object-typed flags */\nexport const createJsonFlagAdaptor = (\n  client: FsClient,\n): Adapter<JsonObject, FsUserContext> =>\n  createFlagSyncAdapter(client)<JsonObject>();\n","import { FsUserContext } from '@flagsync/node-sdk';\nimport { Identify } from '@vercel/flags';\n\ntype ExtractParams<T> = T extends (params: infer P) => any ? P : never;\n\nexport const createIdentify =\n  (\n    callback: (\n      params: ExtractParams<Identify<FsUserContext>>,\n    ) => Promise<FsUserContext> | FsUserContext,\n  ): Identify<FsUserContext> =>\n  (params) =>\n    callback(params);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,IAAAA,mBAAyB;;;ACTzB,sBAKO;AASA,SAAS,qBAAqB,QAA4B;AAC/D,QAAM,eAAW,iCAAgB;AAAA,IAC/B,GAAG;AAAA,IACH,UAAU;AAAA,MACR,SAAS;AAAA,MACT,YAAY;AAAA,IACd;AAAA,EACF,CAAC;AACD,SAAO,SAAS,OAAO;AACzB;AAMO,SAAS,sBAAsB,QAAkB;AACtD,MAAI,UAAU;AAMd,QAAM,cAAc,YAAY;AAC9B,QAAI,CAAC,SAAS;AACZ,YAAM,OAAO,aAAa;AAC1B,gBAAU;AAAA,IACZ;AAAA,EACF;AAKA,SAAO,SAAS,kBAGd;AACA,WAAO;AAAA;AAAA;AAAA;AAAA,MAIL,MAAM,OAAO,EAAE,KAAK,SAAS,GAAG;AAC9B,cAAM,YAAY;AAElB,cAAM,cAA6B;AAAA,UACjC,KAAK;AAAA,UACL,GAAI,YAAY,CAAC;AAAA,QACnB;AAEA,eAAO,OAAO,KAAgB,aAAa,GAAG;AAAA,MAChD;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,0BAA0B,CACrC,WACmC,sBAAsB,MAAM,EAAU;AAGpE,IAAM,wBAAwB,CACnC,WACoC,sBAAsB,MAAM,EAAW;AAGtE,IAAM,0BAA0B,CACrC,WACmC,sBAAsB,MAAM,EAAU;AAGpE,IAAM,wBAAwB,CACnC,WAEA,sBAAsB,MAAM,EAAc;;;AClFrC,IAAM,iBACX,CACE,aAIF,CAAC,WACC,SAAS,MAAM;","names":["import_node_sdk"]}

package/dist/index.js

@@ -10,7 +10,7 @@ function createFlagSyncClient(config) {
     ...config,
     metadata: {
       sdkName: "@flagsync/nextjs-sdk",
-      sdkVersion: "0.2.7"
+      sdkVersion: "0.3.0"
     }
   });
   return instance.client();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/adapter.ts","../src/identify.ts"],"sourcesContent":["export type {\n  CustomAttributes,\n  CustomAttributeValue,\n  FsConfig,\n  FsClient,\n  LogLevel,\n  FsUserContext,\n} from '@flagsync/node-sdk';\n\nexport { SyncType } from '@flagsync/node-sdk';\n\nexport type { JsonObject } from './types';\n\nexport {\n  createFlagSyncClient,\n  createFlagSyncAdapter,\n  createBoolFlagAdaptor,\n  createStringFlagAdaptor,\n  createJsonFlagAdaptor,\n  createNumberFlagAdaptor,\n} from './adapter';\n\nexport { createIdentify } from './identify';\n","import {\n  FlagSyncFactory,\n  FsClient,\n  type FsConfig,\n  type FsUserContext,\n} from '@flagsync/node-sdk';\nimport type { Adapter } from '@vercel/flags';\n\nimport { JsonObject } from './types';\n\n/**\n * Creates a FlagSync client instance that can be used across multiple feature flags.\n * This function should be called once to create a singleton client for your application.\n */\nexport function createFlagSyncClient(config: FsConfig): FsClient {\n  const instance = FlagSyncFactory({\n    ...config,\n    metadata: {\n      sdkName: '@flagsync/nextjs-sdk',\n      sdkVersion: '0.2.7',\n    },\n  });\n  return instance.client();\n}\n\n/**\n * Creates an adapter factory that integrates FlagSync with Vercel's feature flag system.\n * This adapter handles the communication between your application and the FlagSync service.\n */\nexport function createFlagSyncAdapter(client: FsClient) {\n  let isReady = false;\n\n  /**\n   * Ensures the FlagSync client is ready before making any flag decisions.\n   * This is called internally before each flag evaluation.\n   */\n  const ensureReady = async () => {\n    if (!isReady) {\n      await client.waitForReady();\n      isReady = true;\n    }\n  };\n\n  /**\n   * Creates a typed adapter instance for a specific flag value type.\n   */\n  return function flagSyncAdapter<ValueType>(): Adapter<\n    ValueType,\n    FsUserContext\n  > {\n    return {\n      /**\n       * Evaluates a feature flag for a given context and returns its value.\n       */\n      async decide({ key, entities }) {\n        await ensureReady();\n\n        const userContext: FsUserContext = {\n          key: 'anonymous',\n          ...(entities ?? {}),\n        };\n\n        return client.flag<ValueType>(userContext, key);\n      },\n    };\n  };\n}\n\n/** Creates an adapter for string-typed flags */\nexport const createStringFlagAdaptor = (\n  client: FsClient,\n): Adapter<string, FsUserContext> => createFlagSyncAdapter(client)<string>();\n\n/** Creates an adapter for boolean-typed flags */\nexport const createBoolFlagAdaptor = (\n  client: FsClient,\n): Adapter<boolean, FsUserContext> => createFlagSyncAdapter(client)<boolean>();\n\n/** Creates an adapter for number-typed flags */\nexport const createNumberFlagAdaptor = (\n  client: FsClient,\n): Adapter<number, FsUserContext> => createFlagSyncAdapter(client)<number>();\n\n/** Creates an adapter for JSON object-typed flags */\nexport const createJsonFlagAdaptor = (\n  client: FsClient,\n): Adapter<JsonObject, FsUserContext> =>\n  createFlagSyncAdapter(client)<JsonObject>();\n","import { FsUserContext } from '@flagsync/node-sdk';\nimport { Identify } from '@vercel/flags';\n\ntype ExtractParams<T> = T extends (params: infer P) => any ? P : never;\n\nexport const createIdentify =\n  (\n    callback: (\n      params: ExtractParams<Identify<FsUserContext>>,\n    ) => Promise<FsUserContext> | FsUserContext,\n  ): Identify<FsUserContext> =>\n  (params) =>\n    callback(params);\n"],"mappings":";AASA,SAAS,gBAAgB;;;ACTzB;AAAA,EACE;AAAA,OAIK;AASA,SAAS,qBAAqB,QAA4B;AAC/D,QAAM,WAAW,gBAAgB;AAAA,IAC/B,GAAG;AAAA,IACH,UAAU;AAAA,MACR,SAAS;AAAA,MACT,YAAY;AAAA,IACd;AAAA,EACF,CAAC;AACD,SAAO,SAAS,OAAO;AACzB;AAMO,SAAS,sBAAsB,QAAkB;AACtD,MAAI,UAAU;AAMd,QAAM,cAAc,YAAY;AAC9B,QAAI,CAAC,SAAS;AACZ,YAAM,OAAO,aAAa;AAC1B,gBAAU;AAAA,IACZ;AAAA,EACF;AAKA,SAAO,SAAS,kBAGd;AACA,WAAO;AAAA;AAAA;AAAA;AAAA,MAIL,MAAM,OAAO,EAAE,KAAK,SAAS,GAAG;AAC9B,cAAM,YAAY;AAElB,cAAM,cAA6B;AAAA,UACjC,KAAK;AAAA,UACL,GAAI,YAAY,CAAC;AAAA,QACnB;AAEA,eAAO,OAAO,KAAgB,aAAa,GAAG;AAAA,MAChD;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,0BAA0B,CACrC,WACmC,sBAAsB,MAAM,EAAU;AAGpE,IAAM,wBAAwB,CACnC,WACoC,sBAAsB,MAAM,EAAW;AAGtE,IAAM,0BAA0B,CACrC,WACmC,sBAAsB,MAAM,EAAU;AAGpE,IAAM,wBAAwB,CACnC,WAEA,sBAAsB,MAAM,EAAc;;;AClFrC,IAAM,iBACX,CACE,aAIF,CAAC,WACC,SAAS,MAAM;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/adapter.ts","../src/identify.ts"],"sourcesContent":["export type {\n  CustomAttributes,\n  CustomAttributeValue,\n  FsConfig,\n  FsClient,\n  LogLevel,\n  FsUserContext,\n} from '@flagsync/node-sdk';\n\nexport { SyncType } from '@flagsync/node-sdk';\n\nexport type { JsonObject } from './types';\n\nexport {\n  createFlagSyncClient,\n  createFlagSyncAdapter,\n  createBoolFlagAdaptor,\n  createStringFlagAdaptor,\n  createJsonFlagAdaptor,\n  createNumberFlagAdaptor,\n} from './adapter';\n\nexport { createIdentify } from './identify';\n","import {\n  FlagSyncFactory,\n  FsClient,\n  type FsConfig,\n  type FsUserContext,\n} from '@flagsync/node-sdk';\nimport type { Adapter } from '@vercel/flags';\n\nimport { JsonObject } from './types';\n\n/**\n * Creates a FlagSync client instance that can be used across multiple feature flags.\n * This function should be called once to create a singleton client for your application.\n */\nexport function createFlagSyncClient(config: FsConfig): FsClient {\n  const instance = FlagSyncFactory({\n    ...config,\n    metadata: {\n      sdkName: '@flagsync/nextjs-sdk',\n      sdkVersion: '0.3.0',\n    },\n  });\n  return instance.client();\n}\n\n/**\n * Creates an adapter factory that integrates FlagSync with Vercel's feature flag system.\n * This adapter handles the communication between your application and the FlagSync service.\n */\nexport function createFlagSyncAdapter(client: FsClient) {\n  let isReady = false;\n\n  /**\n   * Ensures the FlagSync client is ready before making any flag decisions.\n   * This is called internally before each flag evaluation.\n   */\n  const ensureReady = async () => {\n    if (!isReady) {\n      await client.waitForReady();\n      isReady = true;\n    }\n  };\n\n  /**\n   * Creates a typed adapter instance for a specific flag value type.\n   */\n  return function flagSyncAdapter<ValueType>(): Adapter<\n    ValueType,\n    FsUserContext\n  > {\n    return {\n      /**\n       * Evaluates a feature flag for a given context and returns its value.\n       */\n      async decide({ key, entities }) {\n        await ensureReady();\n\n        const userContext: FsUserContext = {\n          key: 'anonymous',\n          ...(entities ?? {}),\n        };\n\n        return client.flag<ValueType>(userContext, key);\n      },\n    };\n  };\n}\n\n/** Creates an adapter for string-typed flags */\nexport const createStringFlagAdaptor = (\n  client: FsClient,\n): Adapter<string, FsUserContext> => createFlagSyncAdapter(client)<string>();\n\n/** Creates an adapter for boolean-typed flags */\nexport const createBoolFlagAdaptor = (\n  client: FsClient,\n): Adapter<boolean, FsUserContext> => createFlagSyncAdapter(client)<boolean>();\n\n/** Creates an adapter for number-typed flags */\nexport const createNumberFlagAdaptor = (\n  client: FsClient,\n): Adapter<number, FsUserContext> => createFlagSyncAdapter(client)<number>();\n\n/** Creates an adapter for JSON object-typed flags */\nexport const createJsonFlagAdaptor = (\n  client: FsClient,\n): Adapter<JsonObject, FsUserContext> =>\n  createFlagSyncAdapter(client)<JsonObject>();\n","import { FsUserContext } from '@flagsync/node-sdk';\nimport { Identify } from '@vercel/flags';\n\ntype ExtractParams<T> = T extends (params: infer P) => any ? P : never;\n\nexport const createIdentify =\n  (\n    callback: (\n      params: ExtractParams<Identify<FsUserContext>>,\n    ) => Promise<FsUserContext> | FsUserContext,\n  ): Identify<FsUserContext> =>\n  (params) =>\n    callback(params);\n"],"mappings":";AASA,SAAS,gBAAgB;;;ACTzB;AAAA,EACE;AAAA,OAIK;AASA,SAAS,qBAAqB,QAA4B;AAC/D,QAAM,WAAW,gBAAgB;AAAA,IAC/B,GAAG;AAAA,IACH,UAAU;AAAA,MACR,SAAS;AAAA,MACT,YAAY;AAAA,IACd;AAAA,EACF,CAAC;AACD,SAAO,SAAS,OAAO;AACzB;AAMO,SAAS,sBAAsB,QAAkB;AACtD,MAAI,UAAU;AAMd,QAAM,cAAc,YAAY;AAC9B,QAAI,CAAC,SAAS;AACZ,YAAM,OAAO,aAAa;AAC1B,gBAAU;AAAA,IACZ;AAAA,EACF;AAKA,SAAO,SAAS,kBAGd;AACA,WAAO;AAAA;AAAA;AAAA;AAAA,MAIL,MAAM,OAAO,EAAE,KAAK,SAAS,GAAG;AAC9B,cAAM,YAAY;AAElB,cAAM,cAA6B;AAAA,UACjC,KAAK;AAAA,UACL,GAAI,YAAY,CAAC;AAAA,QACnB;AAEA,eAAO,OAAO,KAAgB,aAAa,GAAG;AAAA,MAChD;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,0BAA0B,CACrC,WACmC,sBAAsB,MAAM,EAAU;AAGpE,IAAM,wBAAwB,CACnC,WACoC,sBAAsB,MAAM,EAAW;AAGtE,IAAM,0BAA0B,CACrC,WACmC,sBAAsB,MAAM,EAAU;AAGpE,IAAM,wBAAwB,CACnC,WAEA,sBAAsB,MAAM,EAAc;;;AClFrC,IAAM,iBACX,CACE,aAIF,CAAC,WACC,SAAS,MAAM;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flagsync/nextjs-sdk",
-  "version": "0.2.7",
+  "version": "0.3.0",
   "description": "FlagSync adapter for Vercel's Flags SDK",
   "author": "Mike Chabot",
   "license": "Apache-2.0",
@@ -39,7 +39,7 @@
     "@vercel/flags": "^3.1.1"
   },
   "dependencies": {
-    "@flagsync/node-sdk": "^0.2.2"
+    "@flagsync/node-sdk": "^0.3.0"
   },
   "devDependencies": {
     "@trivago/prettier-plugin-sort-imports": "^5.2.2",