@flagsync/nextjs-sdk 0.4.0 → 0.5.0

package/dist/index.cjs

@@ -21,26 +21,54 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   SyncType: () => import_node_sdk2.SyncType,
-  createFlagSyncAdapter: () => createFlagSyncAdapter,
-  createFlagSyncClient: () => createFlagSyncClient,
-  createIdentify: () => createIdentify
+  createAdapter: () => createAdapter,
+  createClient: () => createClient,
+  createIdentify: () => createIdentify,
+  createTypedFlag: () => createTypedFlag
 });
 module.exports = __toCommonJS(index_exports);
 var import_node_sdk2 = require("@flagsync/node-sdk");
 
 // src/adapter.ts
 var import_node_sdk = require("@flagsync/node-sdk");
-function createFlagSyncClient(config) {
+var import_next = require("flags/next");
+function createClient(config) {
   const instance = (0, import_node_sdk.FlagSyncFactory)({
     ...config,
     metadata: {
       sdkName: "@flagsync/nextjs-sdk",
-      sdkVersion: "0.4.0"
+      sdkVersion: "0.5.0"
     }
   });
   return instance.client();
 }
-function createFlagSyncAdapter(client) {
+function createAdapter(client) {
+  let isReady = false;
+  const ensureReady = async () => {
+    if (!isReady) {
+      await client.waitForReady();
+      isReady = true;
+    }
+  };
+  function adapter() {
+    return {
+      async decide({
+        key,
+        entities,
+        defaultValue
+      }) {
+        await ensureReady();
+        const userContext = {
+          key: "anonymous",
+          ...entities ?? {}
+        };
+        return client.flag(userContext, key, defaultValue);
+      }
+    };
+  }
+  return adapter;
+}
+function createTypedAdapter(client) {
   let isReady = false;
   const ensureReady = async () => {
     if (!isReady) {
@@ -66,14 +94,30 @@ function createFlagSyncAdapter(client) {
   }
   return flagSyncAdapter;
 }
+function createTypedFlag(client) {
+  const adapter = createTypedAdapter(client);
+  function typedFlag(options) {
+    const specificAdapter = adapter();
+    const fullFlagDeclaration = {
+      ...options,
+      key: options.key,
+      adapter: specificAdapter
+    };
+    return (0, import_next.flag)(fullFlagDeclaration);
+  }
+  return {
+    flag: typedFlag
+  };
+}
 
 // src/identify.ts
 var createIdentify = (callback) => (params) => callback(params);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SyncType,
-  createFlagSyncAdapter,
-  createFlagSyncClient,
-  createIdentify
+  createAdapter,
+  createClient,
+  createIdentify,
+  createTypedFlag
 });
 //# sourceMappingURL=index.cjs.map

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  FeatureFlags,\n} from '@flagsync/node-sdk';\n\nexport { SyncType } from '@flagsync/node-sdk';\n\nexport type { JsonObject } from './types';\n\nexport { createFlagSyncClient, createFlagSyncAdapter } from './adapter';\nexport { createIdentify } from './identify';\n","import {\n  FlagSyncFactory,\n  FsClient,\n  type FsConfig,\n  type FsUserContext,\n} from '@flagsync/node-sdk';\nimport { Adapter } from 'flags';\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.4.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 generic adapter instance that works with any flag.\n   * This adapter will handle type inference based on usage context.\n   */\n  function flagSyncAdapter<T = any>(): Adapter<T, FsUserContext> {\n    return {\n      async decide({\n        key,\n        entities,\n        defaultValue,\n      }: {\n        key: string;\n        entities?: FsUserContext;\n        defaultValue?: T;\n      }): Promise<T> {\n        await ensureReady();\n\n        const userContext: FsUserContext = {\n          key: 'anonymous',\n          ...(entities ?? {}),\n        };\n\n        return client.flag<T>(userContext, key, defaultValue);\n      },\n    };\n  }\n\n  return flagSyncAdapter;\n}\n","import { FsUserContext } from '@flagsync/node-sdk';\nimport { Identify } from '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;AAUA,IAAAA,mBAAyB;;;ACVzB,sBAKO;AAOA,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;AAMA,WAAS,kBAAsD;AAC7D,WAAO;AAAA,MACL,MAAM,OAAO;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,MACF,GAIe;AACb,cAAM,YAAY;AAElB,cAAM,cAA6B;AAAA,UACjC,KAAK;AAAA,UACL,GAAI,YAAY,CAAC;AAAA,QACnB;AAEA,eAAO,OAAO,KAAQ,aAAa,KAAK,YAAY;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;;;AChEO,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  FeatureFlags,\n} from '@flagsync/node-sdk';\n\nexport { SyncType } from '@flagsync/node-sdk';\n\nexport type { JsonObject } from './types';\n\nexport { createTypedFlag, createClient, createAdapter } from './adapter';\nexport { createIdentify } from './identify';\n","import {\n  FeatureFlags,\n  FlagReturnType,\n  FlagSyncFactory,\n  FsClient,\n  type FsConfig,\n  type FsUserContext,\n  NoExplicitReturnType,\n} from '@flagsync/node-sdk';\nimport { Adapter, FlagDeclaration } from 'flags';\nimport { flag } from 'flags/next';\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 createClient(config: FsConfig): FsClient {\n  const instance = FlagSyncFactory({\n    ...config,\n    metadata: {\n      sdkName: '@flagsync/nextjs-sdk',\n      sdkVersion: '0.5.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 createAdapter(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  function adapter<T = any>(): Adapter<\n    FlagReturnType<T, string, FeatureFlags>,\n    FsUserContext\n  > {\n    return {\n      async decide({\n        key,\n        entities,\n        defaultValue,\n      }: {\n        key: string;\n        entities?: FsUserContext;\n        defaultValue?: FlagReturnType<T, string, FeatureFlags>;\n      }): Promise<FlagReturnType<T, string, FeatureFlags>> {\n        await ensureReady();\n\n        const userContext: FsUserContext = {\n          key: 'anonymous',\n          ...(entities ?? {}),\n        };\n\n        return client.flag(userContext, key, defaultValue);\n      },\n    };\n  }\n\n  return adapter;\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 */\nfunction createTypedAdapter(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 generic adapter instance that works with any flag.\n   * This function is generic over the expected return type (R) and the key type (K)\n   * to correctly type the Adapter's `decide` method.\n   *\n   * @template R The explicit return type for the flag (e.g., `boolean`, `string`).\n   * Defaults to `NoExplicitReturnType` if not provided.\n   * @template K The literal string type of the flag key. Defaults to `string`.\n   * @returns An `Adapter` instance with its generic `T` correctly set to `FlagReturnType<R, K, FeatureFlags>`.\n   */\n  function flagSyncAdapter<\n    R = NoExplicitReturnType, // The explicit return type generic\n    K extends string = string, // The key type generic\n  >(): Adapter<FlagReturnType<R, K, FeatureFlags>, FsUserContext> {\n    return {\n      async decide({\n        key,\n        entities,\n        defaultValue,\n      }: {\n        key: string; // The Adapter interface mandates 'string' here.\n        entities?: FsUserContext;\n        defaultValue?: FlagReturnType<R, K, FeatureFlags>;\n      }): Promise<FlagReturnType<R, K, FeatureFlags>> {\n        await ensureReady();\n\n        const userContext: FsUserContext = {\n          key: 'anonymous',\n          ...(entities ?? {}),\n        };\n\n        // Call client.flag with the generics R and K.\n        // We must cast 'key as K' because the Adapter's 'key' is 'string',\n        // but client.flag's 'flagKey' parameter can be more restrictive (e.g., 'keyof FeatureFlags').\n        // This means strict key validation for the 'key' parameter is bypassed at this point,\n        // but the return type will still be correct.\n        return client.flag<R, K>(userContext, key as K, defaultValue);\n      },\n    };\n  }\n\n  return flagSyncAdapter;\n}\n\n/**\n * Initializes the FlagSync typed helpers.\n * @param client An FsClient instance from createFlagSyncClient.\n * @returns An object containing the typed `flag` function.\n */\nexport function createTypedFlag(client: FsClient) {\n  const adapter = createTypedAdapter(client);\n  /**\n   * A type-safe wrapper around Vercel's `flag` function that is\n   * aware of your FeatureFlags interface.\n   */\n  function typedFlag<TKey extends keyof FeatureFlags>(\n    options: Omit<\n      FlagDeclaration<FeatureFlags[TKey], FsUserContext>,\n      'key' | 'adapter' | 'decide'\n    > & {\n      key: TKey;\n    },\n  ) {\n    const specificAdapter = adapter<FeatureFlags[TKey], TKey>();\n\n    const fullFlagDeclaration: FlagDeclaration<\n      FeatureFlags[TKey],\n      FsUserContext\n    > = {\n      ...options,\n      key: options.key,\n      adapter: specificAdapter as unknown as Adapter<\n        FeatureFlags[TKey],\n        FsUserContext\n      >,\n    };\n\n    return flag(fullFlagDeclaration);\n  }\n\n  return {\n    flag: typedFlag,\n  };\n}\n","import { FsUserContext } from '@flagsync/node-sdk';\nimport { Identify } from '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;AAUA,IAAAA,mBAAyB;;;ACVzB,sBAQO;AAEP,kBAAqB;AAMd,SAAS,aAAa,QAA4B;AACvD,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,cAAc,QAAkB;AAC9C,MAAI,UAAU;AAMd,QAAM,cAAc,YAAY;AAC9B,QAAI,CAAC,SAAS;AACZ,YAAM,OAAO,aAAa;AAC1B,gBAAU;AAAA,IACZ;AAAA,EACF;AAEA,WAAS,UAGP;AACA,WAAO;AAAA,MACL,MAAM,OAAO;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,MACF,GAIqD;AACnD,cAAM,YAAY;AAElB,cAAM,cAA6B;AAAA,UACjC,KAAK;AAAA,UACL,GAAI,YAAY,CAAC;AAAA,QACnB;AAEA,eAAO,OAAO,KAAK,aAAa,KAAK,YAAY;AAAA,MACnD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAMA,SAAS,mBAAmB,QAAkB;AAC5C,MAAI,UAAU;AAMd,QAAM,cAAc,YAAY;AAC9B,QAAI,CAAC,SAAS;AACZ,YAAM,OAAO,aAAa;AAC1B,gBAAU;AAAA,IACZ;AAAA,EACF;AAYA,WAAS,kBAGuD;AAC9D,WAAO;AAAA,MACL,MAAM,OAAO;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,MACF,GAIgD;AAC9C,cAAM,YAAY;AAElB,cAAM,cAA6B;AAAA,UACjC,KAAK;AAAA,UACL,GAAI,YAAY,CAAC;AAAA,QACnB;AAOA,eAAO,OAAO,KAAW,aAAa,KAAU,YAAY;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAOO,SAAS,gBAAgB,QAAkB;AAChD,QAAM,UAAU,mBAAmB,MAAM;AAKzC,WAAS,UACP,SAMA;AACA,UAAM,kBAAkB,QAAkC;AAE1D,UAAM,sBAGF;AAAA,MACF,GAAG;AAAA,MACH,KAAK,QAAQ;AAAA,MACb,SAAS;AAAA,IAIX;AAEA,eAAO,kBAAK,mBAAmB;AAAA,EACjC;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,EACR;AACF;;;AC1KO,IAAM,iBACX,CACE,aAIF,CAAC,WACC,SAAS,MAAM;","names":["import_node_sdk"]}

package/dist/index.d.cts

@@ -1,6 +1,7 @@
-import { FsConfig, FsClient, FsUserContext } from '@flagsync/node-sdk';
+import { FsClient, FeatureFlags, FsUserContext, FsConfig, FlagReturnType } from '@flagsync/node-sdk';
 export { CustomAttributeValue, CustomAttributes, FeatureFlags, FsClient, FsConfig, FsUserContext, LogLevel, SyncType } from '@flagsync/node-sdk';
-import { Adapter, Identify } from 'flags';
+import * as flags_next from 'flags/next';
+import { FlagDeclaration, Adapter, Identify } from 'flags';
 
 type JsonPrimitive = string | number | boolean | null;
 type JsonValue = JsonPrimitive | JsonObject | JsonArray;
@@ -13,14 +14,24 @@ interface JsonObject {
  * Creates a FlagSync client instance that can be used across multiple feature flags.
  * This function should be called once to create a singleton client for your application.
  */
-declare function createFlagSyncClient(config: FsConfig): FsClient;
+declare function createClient(config: FsConfig): FsClient;
 /**
  * Creates an adapter factory that integrates FlagSync with Vercel's feature flag system.
  * This adapter handles the communication between your application and the FlagSync service.
  */
-declare function createFlagSyncAdapter(client: FsClient): <T = any>() => Adapter<T, FsUserContext>;
+declare function createAdapter(client: FsClient): <T = any>() => Adapter<FlagReturnType<T, string, FeatureFlags>, FsUserContext>;
+/**
+ * Initializes the FlagSync typed helpers.
+ * @param client An FsClient instance from createFlagSyncClient.
+ * @returns An object containing the typed `flag` function.
+ */
+declare function createTypedFlag(client: FsClient): {
+    flag: <TKey extends keyof FeatureFlags>(options: Omit<FlagDeclaration<FeatureFlags[TKey], FsUserContext>, "key" | "adapter" | "decide"> & {
+        key: TKey;
+    }) => flags_next.Flag<FeatureFlags[TKey], FsUserContext>;
+};
 
 type ExtractParams<T> = T extends (params: infer P) => any ? P : never;
 declare const createIdentify: (callback: (params: ExtractParams<Identify<FsUserContext>>) => Promise<FsUserContext> | FsUserContext) => Identify<FsUserContext>;
 
-export { type JsonObject, createFlagSyncAdapter, createFlagSyncClient, createIdentify };
+export { type JsonObject, createAdapter, createClient, createIdentify, createTypedFlag };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { FsConfig, FsClient, FsUserContext } from '@flagsync/node-sdk';
+import { FsClient, FeatureFlags, FsUserContext, FsConfig, FlagReturnType } from '@flagsync/node-sdk';
 export { CustomAttributeValue, CustomAttributes, FeatureFlags, FsClient, FsConfig, FsUserContext, LogLevel, SyncType } from '@flagsync/node-sdk';
-import { Adapter, Identify } from 'flags';
+import * as flags_next from 'flags/next';
+import { FlagDeclaration, Adapter, Identify } from 'flags';
 
 type JsonPrimitive = string | number | boolean | null;
 type JsonValue = JsonPrimitive | JsonObject | JsonArray;
@@ -13,14 +14,24 @@ interface JsonObject {
  * Creates a FlagSync client instance that can be used across multiple feature flags.
  * This function should be called once to create a singleton client for your application.
  */
-declare function createFlagSyncClient(config: FsConfig): FsClient;
+declare function createClient(config: FsConfig): FsClient;
 /**
  * Creates an adapter factory that integrates FlagSync with Vercel's feature flag system.
  * This adapter handles the communication between your application and the FlagSync service.
  */
-declare function createFlagSyncAdapter(client: FsClient): <T = any>() => Adapter<T, FsUserContext>;
+declare function createAdapter(client: FsClient): <T = any>() => Adapter<FlagReturnType<T, string, FeatureFlags>, FsUserContext>;
+/**
+ * Initializes the FlagSync typed helpers.
+ * @param client An FsClient instance from createFlagSyncClient.
+ * @returns An object containing the typed `flag` function.
+ */
+declare function createTypedFlag(client: FsClient): {
+    flag: <TKey extends keyof FeatureFlags>(options: Omit<FlagDeclaration<FeatureFlags[TKey], FsUserContext>, "key" | "adapter" | "decide"> & {
+        key: TKey;
+    }) => flags_next.Flag<FeatureFlags[TKey], FsUserContext>;
+};
 
 type ExtractParams<T> = T extends (params: infer P) => any ? P : never;
 declare const createIdentify: (callback: (params: ExtractParams<Identify<FsUserContext>>) => Promise<FsUserContext> | FsUserContext) => Identify<FsUserContext>;
 
-export { type JsonObject, createFlagSyncAdapter, createFlagSyncClient, createIdentify };
+export { type JsonObject, createAdapter, createClient, createIdentify, createTypedFlag };

package/dist/index.js

@@ -5,17 +5,44 @@ import { SyncType } from "@flagsync/node-sdk";
 import {
   FlagSyncFactory
 } from "@flagsync/node-sdk";
-function createFlagSyncClient(config) {
+import { flag } from "flags/next";
+function createClient(config) {
   const instance = FlagSyncFactory({
     ...config,
     metadata: {
       sdkName: "@flagsync/nextjs-sdk",
-      sdkVersion: "0.4.0"
+      sdkVersion: "0.5.0"
     }
   });
   return instance.client();
 }
-function createFlagSyncAdapter(client) {
+function createAdapter(client) {
+  let isReady = false;
+  const ensureReady = async () => {
+    if (!isReady) {
+      await client.waitForReady();
+      isReady = true;
+    }
+  };
+  function adapter() {
+    return {
+      async decide({
+        key,
+        entities,
+        defaultValue
+      }) {
+        await ensureReady();
+        const userContext = {
+          key: "anonymous",
+          ...entities ?? {}
+        };
+        return client.flag(userContext, key, defaultValue);
+      }
+    };
+  }
+  return adapter;
+}
+function createTypedAdapter(client) {
   let isReady = false;
   const ensureReady = async () => {
     if (!isReady) {
@@ -41,13 +68,29 @@ function createFlagSyncAdapter(client) {
   }
   return flagSyncAdapter;
 }
+function createTypedFlag(client) {
+  const adapter = createTypedAdapter(client);
+  function typedFlag(options) {
+    const specificAdapter = adapter();
+    const fullFlagDeclaration = {
+      ...options,
+      key: options.key,
+      adapter: specificAdapter
+    };
+    return flag(fullFlagDeclaration);
+  }
+  return {
+    flag: typedFlag
+  };
+}
 
 // src/identify.ts
 var createIdentify = (callback) => (params) => callback(params);
 export {
   SyncType,
-  createFlagSyncAdapter,
-  createFlagSyncClient,
-  createIdentify
+  createAdapter,
+  createClient,
+  createIdentify,
+  createTypedFlag
 };
 //# sourceMappingURL=index.js.map

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  FeatureFlags,\n} from '@flagsync/node-sdk';\n\nexport { SyncType } from '@flagsync/node-sdk';\n\nexport type { JsonObject } from './types';\n\nexport { createFlagSyncClient, createFlagSyncAdapter } from './adapter';\nexport { createIdentify } from './identify';\n","import {\n  FlagSyncFactory,\n  FsClient,\n  type FsConfig,\n  type FsUserContext,\n} from '@flagsync/node-sdk';\nimport { Adapter } from 'flags';\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.4.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 generic adapter instance that works with any flag.\n   * This adapter will handle type inference based on usage context.\n   */\n  function flagSyncAdapter<T = any>(): Adapter<T, FsUserContext> {\n    return {\n      async decide({\n        key,\n        entities,\n        defaultValue,\n      }: {\n        key: string;\n        entities?: FsUserContext;\n        defaultValue?: T;\n      }): Promise<T> {\n        await ensureReady();\n\n        const userContext: FsUserContext = {\n          key: 'anonymous',\n          ...(entities ?? {}),\n        };\n\n        return client.flag<T>(userContext, key, defaultValue);\n      },\n    };\n  }\n\n  return flagSyncAdapter;\n}\n","import { FsUserContext } from '@flagsync/node-sdk';\nimport { Identify } from '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":";AAUA,SAAS,gBAAgB;;;ACVzB;AAAA,EACE;AAAA,OAIK;AAOA,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;AAMA,WAAS,kBAAsD;AAC7D,WAAO;AAAA,MACL,MAAM,OAAO;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,MACF,GAIe;AACb,cAAM,YAAY;AAElB,cAAM,cAA6B;AAAA,UACjC,KAAK;AAAA,UACL,GAAI,YAAY,CAAC;AAAA,QACnB;AAEA,eAAO,OAAO,KAAQ,aAAa,KAAK,YAAY;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;;;AChEO,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  FeatureFlags,\n} from '@flagsync/node-sdk';\n\nexport { SyncType } from '@flagsync/node-sdk';\n\nexport type { JsonObject } from './types';\n\nexport { createTypedFlag, createClient, createAdapter } from './adapter';\nexport { createIdentify } from './identify';\n","import {\n  FeatureFlags,\n  FlagReturnType,\n  FlagSyncFactory,\n  FsClient,\n  type FsConfig,\n  type FsUserContext,\n  NoExplicitReturnType,\n} from '@flagsync/node-sdk';\nimport { Adapter, FlagDeclaration } from 'flags';\nimport { flag } from 'flags/next';\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 createClient(config: FsConfig): FsClient {\n  const instance = FlagSyncFactory({\n    ...config,\n    metadata: {\n      sdkName: '@flagsync/nextjs-sdk',\n      sdkVersion: '0.5.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 createAdapter(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  function adapter<T = any>(): Adapter<\n    FlagReturnType<T, string, FeatureFlags>,\n    FsUserContext\n  > {\n    return {\n      async decide({\n        key,\n        entities,\n        defaultValue,\n      }: {\n        key: string;\n        entities?: FsUserContext;\n        defaultValue?: FlagReturnType<T, string, FeatureFlags>;\n      }): Promise<FlagReturnType<T, string, FeatureFlags>> {\n        await ensureReady();\n\n        const userContext: FsUserContext = {\n          key: 'anonymous',\n          ...(entities ?? {}),\n        };\n\n        return client.flag(userContext, key, defaultValue);\n      },\n    };\n  }\n\n  return adapter;\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 */\nfunction createTypedAdapter(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 generic adapter instance that works with any flag.\n   * This function is generic over the expected return type (R) and the key type (K)\n   * to correctly type the Adapter's `decide` method.\n   *\n   * @template R The explicit return type for the flag (e.g., `boolean`, `string`).\n   * Defaults to `NoExplicitReturnType` if not provided.\n   * @template K The literal string type of the flag key. Defaults to `string`.\n   * @returns An `Adapter` instance with its generic `T` correctly set to `FlagReturnType<R, K, FeatureFlags>`.\n   */\n  function flagSyncAdapter<\n    R = NoExplicitReturnType, // The explicit return type generic\n    K extends string = string, // The key type generic\n  >(): Adapter<FlagReturnType<R, K, FeatureFlags>, FsUserContext> {\n    return {\n      async decide({\n        key,\n        entities,\n        defaultValue,\n      }: {\n        key: string; // The Adapter interface mandates 'string' here.\n        entities?: FsUserContext;\n        defaultValue?: FlagReturnType<R, K, FeatureFlags>;\n      }): Promise<FlagReturnType<R, K, FeatureFlags>> {\n        await ensureReady();\n\n        const userContext: FsUserContext = {\n          key: 'anonymous',\n          ...(entities ?? {}),\n        };\n\n        // Call client.flag with the generics R and K.\n        // We must cast 'key as K' because the Adapter's 'key' is 'string',\n        // but client.flag's 'flagKey' parameter can be more restrictive (e.g., 'keyof FeatureFlags').\n        // This means strict key validation for the 'key' parameter is bypassed at this point,\n        // but the return type will still be correct.\n        return client.flag<R, K>(userContext, key as K, defaultValue);\n      },\n    };\n  }\n\n  return flagSyncAdapter;\n}\n\n/**\n * Initializes the FlagSync typed helpers.\n * @param client An FsClient instance from createFlagSyncClient.\n * @returns An object containing the typed `flag` function.\n */\nexport function createTypedFlag(client: FsClient) {\n  const adapter = createTypedAdapter(client);\n  /**\n   * A type-safe wrapper around Vercel's `flag` function that is\n   * aware of your FeatureFlags interface.\n   */\n  function typedFlag<TKey extends keyof FeatureFlags>(\n    options: Omit<\n      FlagDeclaration<FeatureFlags[TKey], FsUserContext>,\n      'key' | 'adapter' | 'decide'\n    > & {\n      key: TKey;\n    },\n  ) {\n    const specificAdapter = adapter<FeatureFlags[TKey], TKey>();\n\n    const fullFlagDeclaration: FlagDeclaration<\n      FeatureFlags[TKey],\n      FsUserContext\n    > = {\n      ...options,\n      key: options.key,\n      adapter: specificAdapter as unknown as Adapter<\n        FeatureFlags[TKey],\n        FsUserContext\n      >,\n    };\n\n    return flag(fullFlagDeclaration);\n  }\n\n  return {\n    flag: typedFlag,\n  };\n}\n","import { FsUserContext } from '@flagsync/node-sdk';\nimport { Identify } from '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":";AAUA,SAAS,gBAAgB;;;ACVzB;AAAA,EAGE;AAAA,OAKK;AAEP,SAAS,YAAY;AAMd,SAAS,aAAa,QAA4B;AACvD,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,cAAc,QAAkB;AAC9C,MAAI,UAAU;AAMd,QAAM,cAAc,YAAY;AAC9B,QAAI,CAAC,SAAS;AACZ,YAAM,OAAO,aAAa;AAC1B,gBAAU;AAAA,IACZ;AAAA,EACF;AAEA,WAAS,UAGP;AACA,WAAO;AAAA,MACL,MAAM,OAAO;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,MACF,GAIqD;AACnD,cAAM,YAAY;AAElB,cAAM,cAA6B;AAAA,UACjC,KAAK;AAAA,UACL,GAAI,YAAY,CAAC;AAAA,QACnB;AAEA,eAAO,OAAO,KAAK,aAAa,KAAK,YAAY;AAAA,MACnD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAMA,SAAS,mBAAmB,QAAkB;AAC5C,MAAI,UAAU;AAMd,QAAM,cAAc,YAAY;AAC9B,QAAI,CAAC,SAAS;AACZ,YAAM,OAAO,aAAa;AAC1B,gBAAU;AAAA,IACZ;AAAA,EACF;AAYA,WAAS,kBAGuD;AAC9D,WAAO;AAAA,MACL,MAAM,OAAO;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,MACF,GAIgD;AAC9C,cAAM,YAAY;AAElB,cAAM,cAA6B;AAAA,UACjC,KAAK;AAAA,UACL,GAAI,YAAY,CAAC;AAAA,QACnB;AAOA,eAAO,OAAO,KAAW,aAAa,KAAU,YAAY;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAOO,SAAS,gBAAgB,QAAkB;AAChD,QAAM,UAAU,mBAAmB,MAAM;AAKzC,WAAS,UACP,SAMA;AACA,UAAM,kBAAkB,QAAkC;AAE1D,UAAM,sBAGF;AAAA,MACF,GAAG;AAAA,MACH,KAAK,QAAQ;AAAA,MACb,SAAS;AAAA,IAIX;AAEA,WAAO,KAAK,mBAAmB;AAAA,EACjC;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,EACR;AACF;;;AC1KO,IAAM,iBACX,CACE,aAIF,CAAC,WACC,SAAS,MAAM;","names":[]}

package/package.json

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