@zenmanage/nextjs 0.0.0-stage → 1.0.0

package/dist/chunk-ZUB4F2DA.js

@@ -0,0 +1,237 @@
+// src/server.ts
+import {
+  ConfigBuilder,
+  DefaultsCollection as DefaultsCollection3,
+  Zenmanage
+} from "@zenmanage/sdk";
+
+// src/bootstrap.ts
+import {
+  Context,
+  DefaultsCollection
+} from "@zenmanage/sdk";
+
+// src/types.ts
+var DEFAULT_BOOTSTRAP_ELEMENT_ID = "__ZENMANAGE_BOOTSTRAP__";
+var DEFAULT_SERVER_CACHE_TTL = 60;
+
+// src/bootstrap.ts
+var ELEMENT_ID_PATTERN = /^[A-Za-z_][\w:.-]*$/;
+function escapeForScriptTag(value) {
+  return value.replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isFlagValue(value) {
+  return typeof value === "boolean" || typeof value === "string" || typeof value === "number" && Number.isFinite(value) || typeof value === "object" && value !== null;
+}
+function buildBootstrapPayload(flags, options = {}) {
+  const values = Array.isArray(flags) ? Object.fromEntries(flags.map((flag) => [flag.getKey(), flag.getValue()])) : flags;
+  return {
+    version: 1,
+    generatedAt: (options.generatedAt ?? /* @__PURE__ */ new Date()).toISOString(),
+    flags: values,
+    ...options.context ? { context: options.context.toJSON() } : {}
+  };
+}
+function serializeBootstrapPayload(payload) {
+  return escapeForScriptTag(JSON.stringify(payload));
+}
+function deserializeBootstrapPayload(serializedPayload) {
+  try {
+    const parsed = JSON.parse(serializedPayload);
+    if (!isPlainObject(parsed) || parsed.version !== 1 || !isPlainObject(parsed.flags) || typeof parsed.generatedAt !== "string") {
+      return null;
+    }
+    const flags = Object.fromEntries(
+      Object.entries(parsed.flags).filter(([, value]) => isFlagValue(value))
+    );
+    return {
+      version: 1,
+      generatedAt: parsed.generatedAt,
+      flags,
+      ...isPlainObject(parsed.context) ? { context: parsed.context } : {}
+    };
+  } catch {
+    return null;
+  }
+}
+function buildBootstrapScript(payload, options = {}) {
+  const elementId = options.elementId ?? DEFAULT_BOOTSTRAP_ELEMENT_ID;
+  if (!ELEMENT_ID_PATTERN.test(elementId)) {
+    throw new Error(`Invalid bootstrap element id "${elementId}".`);
+  }
+  const serialized = serializeBootstrapPayload(payload);
+  return `<script id="${elementId}" type="application/json">${serialized}</script>`;
+}
+function readBootstrapPayloadFromDocument(elementId = DEFAULT_BOOTSTRAP_ELEMENT_ID) {
+  if (typeof document === "undefined") {
+    return null;
+  }
+  const element = document.getElementById(elementId);
+  if (!element) {
+    return null;
+  }
+  const text = element.textContent ?? "";
+  return deserializeBootstrapPayload(text);
+}
+function defaultsFromBootstrapPayload(payload) {
+  if (!payload) {
+    return void 0;
+  }
+  return DefaultsCollection.fromObject(payload.flags);
+}
+function defaultsFromBootstrapDocument(elementId = DEFAULT_BOOTSTRAP_ELEMENT_ID) {
+  return defaultsFromBootstrapPayload(readBootstrapPayloadFromDocument(elementId));
+}
+function contextFromBootstrapPayload(payload) {
+  if (!payload?.context) {
+    return void 0;
+  }
+  try {
+    return Context.fromObject(payload.context);
+  } catch {
+    return void 0;
+  }
+}
+
+// package.json
+var version = "1.0.0";
+
+// src/identity.ts
+var CLIENT_AGENT = "zenmanage-nextjs";
+var PACKAGE_VERSION = version;
+
+// src/defaults.ts
+import { DefaultsCollection as DefaultsCollection2 } from "@zenmanage/sdk";
+function mergeDefaults(base, bootstrap) {
+  if (!base && !bootstrap) {
+    return void 0;
+  }
+  const merged = new DefaultsCollection2();
+  for (const source of [bootstrap, base]) {
+    if (!source) {
+      continue;
+    }
+    for (const key of source.keys()) {
+      const value = source.get(key);
+      if (value !== void 0) {
+        merged.set(key, value);
+      }
+    }
+  }
+  return merged;
+}
+
+// src/server.ts
+function buildClient(options) {
+  const builder = ConfigBuilder.create().withEnvironmentToken(options.environmentToken).withClientAgent(CLIENT_AGENT).withSdkVersion(PACKAGE_VERSION).withCacheTtl(options.cacheTtl ?? DEFAULT_SERVER_CACHE_TTL);
+  if (options.apiEndpoint) {
+    builder.withApiEndpoint(options.apiEndpoint);
+  }
+  if (typeof options.enableUsageReporting === "boolean") {
+    builder.withUsageReporting(options.enableUsageReporting);
+  }
+  if (options.logger) {
+    builder.withLogger(options.logger);
+  }
+  return new Zenmanage(builder.build());
+}
+var clientsWithoutLogger = /* @__PURE__ */ new Map();
+var clientsByLogger = /* @__PURE__ */ new WeakMap();
+function configurationKey(options) {
+  return JSON.stringify([
+    options.environmentToken,
+    options.apiEndpoint ?? null,
+    options.cacheTtl ?? null,
+    options.enableUsageReporting ?? null
+  ]);
+}
+function createServerClient(options) {
+  let clients = clientsWithoutLogger;
+  if (options.logger) {
+    clients = clientsByLogger.get(options.logger) ?? /* @__PURE__ */ new Map();
+    clientsByLogger.set(options.logger, clients);
+  }
+  const key = configurationKey(options);
+  let client = clients.get(key);
+  if (!client) {
+    client = buildClient(options);
+    clients.set(key, client);
+  }
+  return client;
+}
+function clearServerClients() {
+  clientsWithoutLogger.clear();
+  clientsByLogger = /* @__PURE__ */ new WeakMap();
+}
+function createServerRuntime(options) {
+  const client = createServerClient(options);
+  let manager = client.flags().withDefaults(options.defaults ?? new DefaultsCollection3());
+  if (options.context) {
+    manager = manager.withContext(options.context);
+  }
+  return { client, manager };
+}
+function createServerManager(options) {
+  return createServerRuntime(options).manager;
+}
+async function getServerFlag(input) {
+  const manager = createServerManager(input);
+  return manager.single(input.key, input.defaultValue);
+}
+async function getServerFlags(input) {
+  const manager = createServerManager(input);
+  return manager.all();
+}
+async function preloadServerFlags(input) {
+  const manager = createServerManager(input);
+  await manager.all();
+  return manager;
+}
+async function getFlagValue(input, fallback) {
+  const flag = await getServerFlag(input);
+  if (typeof fallback === "boolean") {
+    return flag.asBool();
+  }
+  if (typeof fallback === "number") {
+    return flag.asNumber();
+  }
+  if (typeof fallback === "string") {
+    return flag.asString();
+  }
+  return flag.asJson();
+}
+async function getBootstrapPayload(input) {
+  const flags = await getServerFlags(input);
+  const wanted = input.keys ? new Set(input.keys) : null;
+  return buildBootstrapPayload(
+    flags.filter((flag) => wanted === null || wanted.has(flag.getKey())),
+    { context: input.includeContext ? input.context : void 0 }
+  );
+}
+
+export {
+  DEFAULT_BOOTSTRAP_ELEMENT_ID,
+  DEFAULT_SERVER_CACHE_TTL,
+  buildBootstrapPayload,
+  serializeBootstrapPayload,
+  deserializeBootstrapPayload,
+  buildBootstrapScript,
+  readBootstrapPayloadFromDocument,
+  defaultsFromBootstrapPayload,
+  defaultsFromBootstrapDocument,
+  contextFromBootstrapPayload,
+  mergeDefaults,
+  createServerClient,
+  clearServerClients,
+  createServerRuntime,
+  createServerManager,
+  getServerFlag,
+  getServerFlags,
+  preloadServerFlags,
+  getFlagValue,
+  getBootstrapPayload
+};
+//# sourceMappingURL=chunk-ZUB4F2DA.js.map

package/dist/chunk-ZUB4F2DA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/bootstrap.ts","../src/types.ts","../package.json","../src/identity.ts","../src/defaults.ts"],"sourcesContent":["import {\n  ConfigBuilder,\n  DefaultsCollection,\n  Zenmanage,\n  type Flag,\n  type FlagManager,\n  type FlagValue,\n  type Logger,\n} from '@zenmanage/sdk';\nimport { buildBootstrapPayload } from './bootstrap';\nimport { CLIENT_AGENT, PACKAGE_VERSION } from './identity';\nimport {\n  DEFAULT_SERVER_CACHE_TTL,\n  type BootstrapPayload,\n  type NextFlagsRuntime,\n  type NextZenmanageClientOptions,\n  type ServerBootstrapInput,\n  type ServerFlagInput,\n  type ServerFlagsInput,\n  type WidenFlagValue,\n} from './types';\n\nexport { mergeDefaults } from './defaults';\n\nfunction buildClient(options: NextZenmanageClientOptions): Zenmanage {\n  const builder = ConfigBuilder.create()\n    .withEnvironmentToken(options.environmentToken)\n    .withClientAgent(CLIENT_AGENT)\n    .withSdkVersion(PACKAGE_VERSION)\n    .withCacheTtl(options.cacheTtl ?? DEFAULT_SERVER_CACHE_TTL);\n\n  if (options.apiEndpoint) {\n    builder.withApiEndpoint(options.apiEndpoint);\n  }\n\n  if (typeof options.enableUsageReporting === 'boolean') {\n    builder.withUsageReporting(options.enableUsageReporting);\n  }\n\n  if (options.logger) {\n    builder.withLogger(options.logger);\n  }\n\n  return new Zenmanage(builder.build());\n}\n\n// A client owns the rules cache, so building one per call would refetch the rules for every\n// flag on every request. Clients are shared per configuration instead, for the life of the\n// server process (or edge isolate). Loggers are compared by identity, hence the WeakMap.\nconst clientsWithoutLogger = new Map<string, Zenmanage>();\nlet clientsByLogger = new WeakMap<Logger, Map<string, Zenmanage>>();\n\nfunction configurationKey(options: NextZenmanageClientOptions): string {\n  return JSON.stringify([\n    options.environmentToken,\n    options.apiEndpoint ?? null,\n    options.cacheTtl ?? null,\n    options.enableUsageReporting ?? null,\n  ]);\n}\n\n/**\n * Returns the client for this configuration, creating it on first use. Calls with the same\n * token, endpoint, TTL, usage setting and logger share one client and so one rules cache.\n */\nexport function createServerClient(options: NextZenmanageClientOptions): Zenmanage {\n  let clients = clientsWithoutLogger;\n\n  if (options.logger) {\n    clients = clientsByLogger.get(options.logger) ?? new Map<string, Zenmanage>();\n    clientsByLogger.set(options.logger, clients);\n  }\n\n  const key = configurationKey(options);\n  let client = clients.get(key);\n\n  if (!client) {\n    client = buildClient(options);\n    clients.set(key, client);\n  }\n\n  return client;\n}\n\n/** Forgets every shared client, and with them their cached rules. Mostly useful in tests. */\nexport function clearServerClients(): void {\n  clientsWithoutLogger.clear();\n  clientsByLogger = new WeakMap();\n}\n\nexport function createServerRuntime(options: ServerFlagsInput): NextFlagsRuntime {\n  const client = createServerClient(options);\n\n  // A manager loads its rules once and keeps them, whatever the cache TTL. Handing out the\n  // client's own manager would pin the first rules it saw for the life of the process, so\n  // every call gets a copy that reads the shared cache (and so honors the TTL) instead.\n  let manager = client.flags().withDefaults(options.defaults ?? new DefaultsCollection());\n\n  if (options.context) {\n    manager = manager.withContext(options.context);\n  }\n\n  return { client, manager };\n}\n\nexport function createServerManager(options: ServerFlagsInput): FlagManager {\n  return createServerRuntime(options).manager;\n}\n\nexport async function getServerFlag(input: ServerFlagInput): Promise<Flag> {\n  const manager = createServerManager(input);\n  return manager.single(input.key, input.defaultValue);\n}\n\nexport async function getServerFlags(input: ServerFlagsInput): Promise<Flag[]> {\n  const manager = createServerManager(input);\n  return manager.all();\n}\n\nexport async function preloadServerFlags(input: ServerFlagsInput): Promise<FlagManager> {\n  const manager = createServerManager(input);\n  await manager.all();\n  return manager;\n}\n\n/**\n * Evaluates a flag and returns its value as the type of `fallback`: a boolean, number or\n * string, or a JSON object or array. A literal fallback (`'control'`, `false`) gives the\n * widened type (`string`, `boolean`), so the result can be compared with other values.\n */\nexport async function getFlagValue<T extends FlagValue>(\n  input: ServerFlagInput,\n  fallback: T\n): Promise<WidenFlagValue<T>> {\n  const flag = await getServerFlag(input);\n\n  if (typeof fallback === 'boolean') {\n    return flag.asBool() as WidenFlagValue<T>;\n  }\n\n  if (typeof fallback === 'number') {\n    return flag.asNumber() as WidenFlagValue<T>;\n  }\n\n  if (typeof fallback === 'string') {\n    return flag.asString() as WidenFlagValue<T>;\n  }\n\n  return flag.asJson() as WidenFlagValue<T>;\n}\n\n/**\n * Evaluates flags on the server and packages them for `NextFlagsProvider`. Pass `keys` to\n * send only the flags client components read.\n */\nexport async function getBootstrapPayload(input: ServerBootstrapInput): Promise<BootstrapPayload> {\n  const flags = await getServerFlags(input);\n  const wanted = input.keys ? new Set(input.keys) : null;\n\n  return buildBootstrapPayload(\n    flags.filter((flag) => wanted === null || wanted.has(flag.getKey())),\n    { context: input.includeContext ? input.context : undefined }\n  );\n}\n","import {\n  Context,\n  DefaultsCollection,\n  type ContextData,\n  type Flag,\n  type FlagValue,\n} from '@zenmanage/sdk';\nimport type {\n  BootstrapPayload,\n  BuildBootstrapPayloadOptions,\n  BuildBootstrapScriptOptions,\n} from './types';\nimport { DEFAULT_BOOTSTRAP_ELEMENT_ID } from './types';\n\nconst ELEMENT_ID_PATTERN = /^[A-Za-z_][\\w:.-]*$/;\n\nfunction escapeForScriptTag(value: string): string {\n  return value\n    .replace(/</g, '\\\\u003c')\n    .replace(/>/g, '\\\\u003e')\n    .replace(/&/g, '\\\\u0026')\n    .replace(/\\u2028/g, '\\\\u2028')\n    .replace(/\\u2029/g, '\\\\u2029');\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isFlagValue(value: unknown): value is FlagValue {\n  return (\n    typeof value === 'boolean' ||\n    typeof value === 'string' ||\n    (typeof value === 'number' && Number.isFinite(value)) ||\n    (typeof value === 'object' && value !== null)\n  );\n}\n\n/**\n * Builds the payload `NextFlagsProvider` reads. Accepts the flags straight from\n * `getServerFlags`, or a plain `{ key: value }` record.\n */\nexport function buildBootstrapPayload(\n  flags: Flag[] | Record<string, FlagValue>,\n  options: BuildBootstrapPayloadOptions = {}\n): BootstrapPayload {\n  const values = Array.isArray(flags)\n    ? Object.fromEntries(flags.map((flag) => [flag.getKey(), flag.getValue()]))\n    : flags;\n\n  // `context` is left out rather than set to undefined: Next.js refuses undefined in the props\n  // `getServerSideProps` returns, and this payload is meant to be passed there.\n  return {\n    version: 1,\n    generatedAt: (options.generatedAt ?? new Date()).toISOString(),\n    flags: values,\n    ...(options.context ? { context: options.context.toJSON() } : {}),\n  };\n}\n\nexport function serializeBootstrapPayload(payload: BootstrapPayload): string {\n  return escapeForScriptTag(JSON.stringify(payload));\n}\n\nexport function deserializeBootstrapPayload(serializedPayload: string): BootstrapPayload | null {\n  try {\n    const parsed: unknown = JSON.parse(serializedPayload);\n\n    if (\n      !isPlainObject(parsed) ||\n      parsed.version !== 1 ||\n      !isPlainObject(parsed.flags) ||\n      typeof parsed.generatedAt !== 'string'\n    ) {\n      return null;\n    }\n\n    const flags = Object.fromEntries(\n      Object.entries(parsed.flags).filter(([, value]) => isFlagValue(value))\n    ) as Record<string, FlagValue>;\n\n    return {\n      version: 1,\n      generatedAt: parsed.generatedAt,\n      flags,\n      ...(isPlainObject(parsed.context)\n        ? { context: parsed.context as unknown as ContextData }\n        : {}),\n    };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Renders the payload as a JSON `<script>` tag for pages that can't pass props to the provider.\n * Prefer the `bootstrapPayload` prop: only a prop is identical on the server and in the browser.\n */\nexport function buildBootstrapScript(\n  payload: BootstrapPayload,\n  options: BuildBootstrapScriptOptions = {}\n): string {\n  const elementId = options.elementId ?? DEFAULT_BOOTSTRAP_ELEMENT_ID;\n\n  if (!ELEMENT_ID_PATTERN.test(elementId)) {\n    throw new Error(`Invalid bootstrap element id \"${elementId}\".`);\n  }\n\n  const serialized = serializeBootstrapPayload(payload);\n  return `<script id=\"${elementId}\" type=\"application/json\">${serialized}</script>`;\n}\n\nexport function readBootstrapPayloadFromDocument(\n  elementId = DEFAULT_BOOTSTRAP_ELEMENT_ID\n): BootstrapPayload | null {\n  if (typeof document === 'undefined') {\n    return null;\n  }\n\n  const element = document.getElementById(elementId);\n  if (!element) {\n    return null;\n  }\n\n  const text = element.textContent ?? '';\n  return deserializeBootstrapPayload(text);\n}\n\nexport function defaultsFromBootstrapPayload(\n  payload: BootstrapPayload | null | undefined\n): DefaultsCollection | undefined {\n  if (!payload) {\n    return undefined;\n  }\n\n  return DefaultsCollection.fromObject(payload.flags);\n}\n\nexport function defaultsFromBootstrapDocument(\n  elementId = DEFAULT_BOOTSTRAP_ELEMENT_ID\n): DefaultsCollection | undefined {\n  return defaultsFromBootstrapPayload(readBootstrapPayloadFromDocument(elementId));\n}\n\nexport function contextFromBootstrapPayload(\n  payload: BootstrapPayload | null | undefined\n): Context | undefined {\n  if (!payload?.context) {\n    return undefined;\n  }\n\n  try {\n    return Context.fromObject(payload.context);\n  } catch {\n    return undefined;\n  }\n}\n","import type {\n  Context,\n  ContextData,\n  DefaultsCollection,\n  FlagManager,\n  FlagValue,\n  Logger,\n  Zenmanage,\n} from '@zenmanage/sdk';\nimport type { FlagsProviderProps } from '@zenmanage/react';\n\nexport const DEFAULT_BOOTSTRAP_ELEMENT_ID = '__ZENMANAGE_BOOTSTRAP__';\n\n/**\n * Rules are cached in memory for this many seconds. The SDK's own default is an hour, which\n * would leave a long-running `next start` server on stale rules; a minute keeps flag changes\n * visible quickly while still sharing one fetch across every request and component.\n */\nexport const DEFAULT_SERVER_CACHE_TTL = 60;\n\n/**\n * Widens a literal (`false`, `'control'`, `1500`) to its primitive type, so a value read with\n * a literal fallback is `boolean`, `string` or `number` rather than the literal. Object and\n * array values (JSON flags) pass through unchanged.\n */\nexport type WidenFlagValue<T extends FlagValue> = T extends boolean\n  ? boolean\n  : T extends number\n    ? number\n    : T extends string\n      ? string\n      : T;\n\nexport interface NextZenmanageClientOptions {\n  /** A server key (`srv_...`). Server and edge runtimes reject client keys. */\n  environmentToken: string;\n  apiEndpoint?: string;\n  /** Seconds to cache rules in memory. Defaults to {@link DEFAULT_SERVER_CACHE_TTL}. */\n  cacheTtl?: number;\n  enableUsageReporting?: boolean;\n  logger?: Logger;\n}\n\nexport interface ServerFlagInput extends NextZenmanageClientOptions {\n  key: string;\n  defaultValue?: FlagValue;\n  context?: Context;\n  defaults?: DefaultsCollection;\n}\n\nexport interface ServerFlagsInput extends NextZenmanageClientOptions {\n  context?: Context;\n  defaults?: DefaultsCollection;\n}\n\nexport interface ServerBootstrapInput extends ServerFlagsInput {\n  /**\n   * The flags to send to the browser. Bootstrapping every flag puts each flag's key and\n   * value in the page source, so list only what client components read.\n   */\n  keys?: string[];\n  /** Include the evaluation context in the payload so the browser evaluates for the same user. */\n  includeContext?: boolean;\n}\n\nexport interface BootstrapPayload {\n  version: 1;\n  generatedAt: string;\n  flags: Record<string, FlagValue>;\n  context?: ContextData;\n}\n\nexport interface BuildBootstrapPayloadOptions {\n  context?: Context;\n  generatedAt?: Date;\n}\n\nexport interface BuildBootstrapScriptOptions {\n  elementId?: string;\n}\n\nexport interface RequestCookieValue {\n  value: string;\n}\n\nexport interface RequestCookiesLike {\n  get(name: string): RequestCookieValue | string | undefined;\n}\n\nexport interface RequestGeoLike {\n  country?: string;\n  region?: string;\n  city?: string;\n}\n\nexport interface RequestLike {\n  headers: Headers;\n  cookies?: RequestCookiesLike;\n  nextUrl?: { pathname: string };\n  url?: string;\n  /** Removed from `NextRequest` in Next.js 15; the forwarding headers are used instead. */\n  ip?: string | null;\n  /** Removed from `NextRequest` in Next.js 15; the Vercel and Cloudflare headers are used instead. */\n  geo?: RequestGeoLike;\n}\n\nexport interface BuildRequestContextOptions {\n  contextType?: string;\n  contextName?: string;\n  identifierCookieName?: string;\n  identifierHeaderName?: string;\n  /** Add `country`, `region` and `city` attributes when the platform reports them. Default `true`. */\n  includeGeo?: boolean;\n  /** Add the visitor's IP address as an `ip` attribute. Default `false`: an IP is personal data. */\n  includeIp?: boolean;\n  additionalAttributes?: Record<string, string | string[] | undefined>;\n}\n\nexport interface MiddlewareFlagInput extends NextZenmanageClientOptions {\n  request: RequestLike;\n  key: string;\n  defaultValue?: FlagValue;\n  defaults?: DefaultsCollection;\n  requestContext?: BuildRequestContextOptions;\n}\n\nexport interface NextFlagsProviderProps extends Omit<FlagsProviderProps, 'defaults'> {\n  defaults?: DefaultsCollection;\n  /**\n   * Flags evaluated on the server. Pass it as a prop so the server render and the first\n   * client render see the same value, which is what keeps hydration clean.\n   */\n  bootstrapPayload?: BootstrapPayload | null;\n  /** Read the payload from a `<script>` tag with this id when `bootstrapPayload` isn't set. */\n  bootstrapElementId?: string;\n}\n\nexport interface NextFlagsRuntime {\n  client: Zenmanage;\n  manager: FlagManager;\n}\n","{\n  \"name\": \"@zenmanage/nextjs\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Next.js integration helpers for Zenmanage feature flags: server evaluation, middleware, and hydration-safe client bootstrap\",\n  \"keywords\": [\n    \"nextjs\",\n    \"next.js\",\n    \"react\",\n    \"ssr\",\n    \"app-router\",\n    \"pages-router\",\n    \"middleware\",\n    \"feature-flags\",\n    \"feature-toggles\",\n    \"feature-management\",\n    \"remote-config\",\n    \"ab-testing\",\n    \"experiments\",\n    \"zenmanage\"\n  ],\n  \"homepage\": \"https://github.com/zenmanage/zenmanage-nextjs#readme\",\n  \"bugs\": {\n    \"url\": \"https://github.com/zenmanage/zenmanage-nextjs/issues\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/zenmanage/zenmanage-nextjs.git\"\n  },\n  \"license\": \"MIT\",\n  \"author\": \"Zenmanage\",\n  \"type\": \"module\",\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"import\": {\n        \"types\": \"./dist/index.d.ts\",\n        \"default\": \"./dist/index.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/index.d.cts\",\n        \"default\": \"./dist/index.cjs\"\n      }\n    },\n    \"./server\": {\n      \"import\": {\n        \"types\": \"./dist/server.d.ts\",\n        \"default\": \"./dist/server.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/server.d.cts\",\n        \"default\": \"./dist/server.cjs\"\n      }\n    },\n    \"./middleware\": {\n      \"import\": {\n        \"types\": \"./dist/middleware.d.ts\",\n        \"default\": \"./dist/middleware.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/middleware.d.cts\",\n        \"default\": \"./dist/middleware.cjs\"\n      }\n    },\n    \"./client\": {\n      \"import\": {\n        \"types\": \"./dist/client.d.ts\",\n        \"default\": \"./dist/client.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/client.d.cts\",\n        \"default\": \"./dist/client.cjs\"\n      }\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"README.md\",\n    \"LICENSE\"\n  ],\n  \"sideEffects\": false,\n  \"scripts\": {\n    \"build\": \"rm -rf dist && tsup\",\n    \"clean\": \"rm -rf dist coverage\",\n    \"changeset\": \"changeset\",\n    \"version-packages\": \"changeset version\",\n    \"release\": \"changeset publish\",\n    \"lint\": \"eslint src tests --ext .ts,.tsx\",\n    \"lint:fix\": \"eslint src tests --ext .ts,.tsx --fix\",\n    \"format\": \"prettier --write \\\"src/**/*.{ts,tsx}\\\" \\\"tests/**/*.{ts,tsx}\\\" \\\"examples/**/*.{ts,tsx}\\\" \\\"examples/smoke-app/**/*.{js,jsx}\\\" \\\"scripts/**/*.mjs\\\" \\\"*.{md,json,yml,yaml,cjs}\\\"\",\n    \"format:check\": \"prettier --check \\\"src/**/*.{ts,tsx}\\\" \\\"tests/**/*.{ts,tsx}\\\" \\\"examples/**/*.{ts,tsx}\\\" \\\"examples/smoke-app/**/*.{js,jsx}\\\" \\\"scripts/**/*.mjs\\\" \\\"*.{md,json,yml,yaml,cjs}\\\"\",\n    \"type-check\": \"tsc --noEmit && tsc -p tsconfig.test.json --noEmit && tsc -p tsconfig.examples.json\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"test:coverage\": \"vitest run --coverage\",\n    \"test:smoke\": \"npm run build && node scripts/smoke.mjs\",\n    \"validate\": \"npm run format:check && npm run lint && npm run type-check && npm run test:coverage && npm run build && npm run test:smoke\",\n    \"prepublishOnly\": \"npm run validate\"\n  },\n  \"peerDependencies\": {\n    \"@zenmanage/react\": \"^1.0.0\",\n    \"@zenmanage/sdk\": \"^3.5.0\",\n    \"next\": \"^13.4.0 || ^14.0.0 || ^15.0.0 || ^16.0.0\",\n    \"react\": \"^18.2.0 || ^19.0.0\"\n  },\n  \"devDependencies\": {\n    \"@changesets/cli\": \"^2.28.1\",\n    \"@testing-library/react\": \"^16.0.1\",\n    \"@types/node\": \"^20.11.0\",\n    \"@types/react\": \"^19.2.0\",\n    \"@types/react-dom\": \"^19.2.0\",\n    \"@typescript-eslint/eslint-plugin\": \"^6.20.0\",\n    \"@typescript-eslint/parser\": \"^6.20.0\",\n    \"@vitest/coverage-v8\": \"^1.6.0\",\n    \"@zenmanage/react\": \"^1.0.0\",\n    \"@zenmanage/sdk\": \"^3.5.0\",\n    \"eslint\": \"^8.57.0\",\n    \"eslint-config-prettier\": \"^9.1.0\",\n    \"eslint-plugin-prettier\": \"^5.2.1\",\n    \"eslint-plugin-react-hooks\": \"^5.1.0\",\n    \"jsdom\": \"^24.1.1\",\n    \"next\": \"^15.5.0\",\n    \"prettier\": \"^3.3.3\",\n    \"react\": \"^19.2.0\",\n    \"react-dom\": \"^19.2.0\",\n    \"tsup\": \"^8.2.4\",\n    \"typescript\": \"^5.6.2\",\n    \"vitest\": \"^1.6.0\"\n  },\n  \"engines\": {\n    \"node\": \">=18.0.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  }\n}\n","import { version } from '../package.json';\n\n/** The client agent the API registers this package under (see the api's EnsureClientAgentIsValid). */\nexport const CLIENT_AGENT = 'zenmanage-nextjs';\n\nexport const PACKAGE_VERSION: string = version;\n","import { DefaultsCollection } from '@zenmanage/sdk';\n\n/** Combines two collections. `base` wins where both define a key. */\nexport function mergeDefaults(\n  base?: DefaultsCollection,\n  bootstrap?: DefaultsCollection\n): DefaultsCollection | undefined {\n  if (!base && !bootstrap) {\n    return undefined;\n  }\n\n  const merged = new DefaultsCollection();\n\n  for (const source of [bootstrap, base]) {\n    if (!source) {\n      continue;\n    }\n\n    for (const key of source.keys()) {\n      const value = source.get(key);\n      if (value !== undefined) {\n        merged.set(key, value);\n      }\n    }\n  }\n\n  return merged;\n}\n"],"mappings":"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","names":["DefaultsCollection","DefaultsCollection","DefaultsCollection"]}

package/dist/client.cjs

@@ -0,0 +1,287 @@
+'use client';
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  NextFlagsProvider: () => NextFlagsProvider,
+  useFlag: () => useFlag,
+  useFlagsContext: () => import_react8.useFlagsContext,
+  useVariant: () => useVariant
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/client/NextFlagsProvider.tsx
+var import_react4 = require("react");
+var import_react5 = require("@zenmanage/react");
+
+// src/bootstrap.ts
+var import_sdk = require("@zenmanage/sdk");
+
+// src/types.ts
+var DEFAULT_BOOTSTRAP_ELEMENT_ID = "__ZENMANAGE_BOOTSTRAP__";
+
+// src/bootstrap.ts
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isFlagValue(value) {
+  return typeof value === "boolean" || typeof value === "string" || typeof value === "number" && Number.isFinite(value) || typeof value === "object" && value !== null;
+}
+function deserializeBootstrapPayload(serializedPayload) {
+  try {
+    const parsed = JSON.parse(serializedPayload);
+    if (!isPlainObject(parsed) || parsed.version !== 1 || !isPlainObject(parsed.flags) || typeof parsed.generatedAt !== "string") {
+      return null;
+    }
+    const flags = Object.fromEntries(
+      Object.entries(parsed.flags).filter(([, value]) => isFlagValue(value))
+    );
+    return {
+      version: 1,
+      generatedAt: parsed.generatedAt,
+      flags,
+      ...isPlainObject(parsed.context) ? { context: parsed.context } : {}
+    };
+  } catch {
+    return null;
+  }
+}
+function defaultsFromBootstrapPayload(payload) {
+  if (!payload) {
+    return void 0;
+  }
+  return import_sdk.DefaultsCollection.fromObject(payload.flags);
+}
+function contextFromBootstrapPayload(payload) {
+  if (!payload?.context) {
+    return void 0;
+  }
+  try {
+    return import_sdk.Context.fromObject(payload.context);
+  } catch {
+    return void 0;
+  }
+}
+
+// src/defaults.ts
+var import_sdk2 = require("@zenmanage/sdk");
+function mergeDefaults(base, bootstrap) {
+  if (!base && !bootstrap) {
+    return void 0;
+  }
+  const merged = new import_sdk2.DefaultsCollection();
+  for (const source of [bootstrap, base]) {
+    if (!source) {
+      continue;
+    }
+    for (const key of source.keys()) {
+      const value = source.get(key);
+      if (value !== void 0) {
+        merged.set(key, value);
+      }
+    }
+  }
+  return merged;
+}
+
+// src/client/BootstrapProvider.tsx
+var import_react2 = require("react");
+var import_react3 = require("@zenmanage/react");
+
+// src/client/context.ts
+var import_react = require("react");
+var BootstrapContext = (0, import_react.createContext)(null);
+
+// src/client/BootstrapProvider.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function BootstrapProvider({ flags, children }) {
+  const { manager, isReady, revision } = (0, import_react3.useFlagsContext)();
+  const [live, setLive] = (0, import_react2.useState)(null);
+  (0, import_react2.useEffect)(() => {
+    if (!flags || !isReady) {
+      return void 0;
+    }
+    let isCurrent = true;
+    manager.all().then(
+      (loaded) => isCurrent && setLive(new Set(loaded.map((flag) => flag.getKey()))),
+      () => isCurrent && setLive(/* @__PURE__ */ new Set())
+    );
+    return () => {
+      isCurrent = false;
+    };
+  }, [flags, isReady, manager, revision]);
+  const value = (0, import_react2.useMemo)(() => flags ? { flags, live } : null, [flags, live]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(BootstrapContext.Provider, { value, children });
+}
+
+// src/client/createClient.ts
+var import_sdk3 = require("@zenmanage/sdk");
+
+// package.json
+var version = "1.0.0";
+
+// src/identity.ts
+var CLIENT_AGENT = "zenmanage-nextjs";
+var PACKAGE_VERSION = version;
+
+// src/client/createClient.ts
+function isServerRender() {
+  return typeof window === "undefined" && typeof document === "undefined";
+}
+function createProviderClient(options) {
+  const { environmentToken, apiEndpoint, cacheTtl, enableUsageReporting } = options;
+  if (!environmentToken) {
+    throw new Error("NextFlagsProvider requires either a client or an environmentToken.");
+  }
+  if (environmentToken.startsWith("srv_")) {
+    throw new Error(
+      "NextFlagsProvider received a server key (srv_...). Server keys must never reach the browser; use a client key (cli_...)."
+    );
+  }
+  if (isServerRender()) {
+    if (!environmentToken.startsWith("cli_")) {
+      throw new Error("NextFlagsProvider needs a client key (cli_...).");
+    }
+    return new import_sdk3.Zenmanage({
+      environmentToken,
+      apiEndpoint,
+      cacheTtl,
+      enableUsageReporting,
+      clientAgent: CLIENT_AGENT,
+      sdkVersion: PACKAGE_VERSION
+    });
+  }
+  const builder = import_sdk3.ConfigBuilder.create().withEnvironmentToken(environmentToken).withClientAgent(CLIENT_AGENT).withSdkVersion(PACKAGE_VERSION);
+  if (apiEndpoint) {
+    builder.withApiEndpoint(apiEndpoint);
+  }
+  if (typeof cacheTtl === "number") {
+    builder.withCacheTtl(cacheTtl);
+  }
+  if (typeof enableUsageReporting === "boolean") {
+    builder.withUsageReporting(enableUsageReporting);
+  }
+  return new import_sdk3.Zenmanage(builder.build());
+}
+
+// src/client/NextFlagsProvider.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var subscribeToNothing = () => () => void 0;
+function useDocumentPayload(elementId, enabled) {
+  const cache = (0, import_react4.useRef)({
+    text: null,
+    payload: null
+  });
+  const getSnapshot = (0, import_react4.useCallback)(() => {
+    if (!enabled || typeof document === "undefined") {
+      return null;
+    }
+    const text = document.getElementById(elementId)?.textContent ?? null;
+    if (text !== cache.current.text) {
+      cache.current = { text, payload: text === null ? null : deserializeBootstrapPayload(text) };
+    }
+    return cache.current.payload;
+  }, [elementId, enabled]);
+  return (0, import_react4.useSyncExternalStore)(subscribeToNothing, getSnapshot, () => null);
+}
+function NextFlagsProvider({
+  client,
+  environmentToken,
+  apiEndpoint,
+  cacheTtl,
+  enableUsageReporting,
+  context,
+  defaults,
+  bootstrapPayload,
+  bootstrapElementId = DEFAULT_BOOTSTRAP_ELEMENT_ID,
+  children,
+  ...providerProps
+}) {
+  const documentPayload = useDocumentPayload(bootstrapElementId, !bootstrapPayload);
+  const payload = bootstrapPayload ?? documentPayload;
+  const resolvedClient = (0, import_react4.useMemo)(
+    () => client ?? createProviderClient({ environmentToken, apiEndpoint, cacheTtl, enableUsageReporting }),
+    [client, environmentToken, apiEndpoint, cacheTtl, enableUsageReporting]
+  );
+  const mergedDefaults = (0, import_react4.useMemo)(
+    () => mergeDefaults(defaults, defaultsFromBootstrapPayload(payload)),
+    [defaults, payload]
+  );
+  const resolvedContext = (0, import_react4.useMemo)(
+    () => context ?? contextFromBootstrapPayload(payload),
+    [context, payload]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    import_react5.FlagsProvider,
+    {
+      ...providerProps,
+      client: resolvedClient,
+      context: resolvedContext,
+      defaults: mergedDefaults,
+      children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(BootstrapProvider, { flags: payload?.flags ?? null, children })
+    }
+  );
+}
+
+// src/client/hooks.ts
+var import_react6 = require("react");
+var import_react7 = require("@zenmanage/react");
+function sameKind(candidate, fallback) {
+  if (typeof fallback === "object") {
+    return typeof candidate === "object" && candidate !== null && Array.isArray(candidate) === Array.isArray(fallback);
+  }
+  return typeof candidate === typeof fallback;
+}
+function useFlag(key, defaultValue) {
+  const bootstrap = (0, import_react6.useContext)(BootstrapContext);
+  const result = (0, import_react7.useFlag)(key, defaultValue);
+  const seed = bootstrap?.flags[key];
+  if (seed === void 0 || !sameKind(seed, defaultValue)) {
+    return result;
+  }
+  const hasLiveValue = bootstrap?.live?.has(key) === true;
+  if (hasLiveValue && !result.isLoading) {
+    return result;
+  }
+  return { ...result, value: seed, isLoading: false };
+}
+function useVariant(key, defaultVariant = "control") {
+  const result = useFlag(key, defaultVariant);
+  return {
+    key,
+    variant: result.value,
+    flag: result.flag,
+    isLoading: result.isLoading,
+    error: result.error,
+    refresh: result.refresh
+  };
+}
+
+// src/client.ts
+var import_react8 = require("@zenmanage/react");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NextFlagsProvider,
+  useFlag,
+  useFlagsContext,
+  useVariant
+});
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/client/NextFlagsProvider.tsx","../src/bootstrap.ts","../src/types.ts","../src/defaults.ts","../src/client/BootstrapProvider.tsx","../src/client/context.ts","../src/client/createClient.ts","../package.json","../src/identity.ts","../src/client/hooks.ts"],"sourcesContent":["export { NextFlagsProvider } from './client/NextFlagsProvider';\nexport { useFlag, useVariant } from './client/hooks';\nexport { useFlagsContext } from '@zenmanage/react';\nexport type { NextFlagsProviderProps } from './types';\n","import { useCallback, useMemo, useRef, useSyncExternalStore, type ReactElement } from 'react';\nimport { FlagsProvider } from '@zenmanage/react';\nimport {\n  contextFromBootstrapPayload,\n  defaultsFromBootstrapPayload,\n  deserializeBootstrapPayload,\n} from '../bootstrap';\nimport { mergeDefaults } from '../defaults';\nimport {\n  DEFAULT_BOOTSTRAP_ELEMENT_ID,\n  type BootstrapPayload,\n  type NextFlagsProviderProps,\n} from '../types';\nimport { BootstrapProvider } from './BootstrapProvider';\nimport { createProviderClient } from './createClient';\n\nconst subscribeToNothing = (): (() => void) => () => undefined;\n\n/**\n * Reads the payload from a `<script>` tag. `useSyncExternalStore` serves `null` while\n * hydrating and the real payload right after, so the first client render matches the server\n * render instead of reading the DOM mid-render.\n */\nfunction useDocumentPayload(elementId: string, enabled: boolean): BootstrapPayload | null {\n  const cache = useRef<{ text: string | null; payload: BootstrapPayload | null }>({\n    text: null,\n    payload: null,\n  });\n\n  const getSnapshot = useCallback((): BootstrapPayload | null => {\n    if (!enabled || typeof document === 'undefined') {\n      return null;\n    }\n\n    const text = document.getElementById(elementId)?.textContent ?? null;\n    if (text !== cache.current.text) {\n      cache.current = { text, payload: text === null ? null : deserializeBootstrapPayload(text) };\n    }\n\n    return cache.current.payload;\n  }, [elementId, enabled]);\n\n  return useSyncExternalStore(subscribeToNothing, getSnapshot, () => null);\n}\n\nexport function NextFlagsProvider({\n  client,\n  environmentToken,\n  apiEndpoint,\n  cacheTtl,\n  enableUsageReporting,\n  context,\n  defaults,\n  bootstrapPayload,\n  bootstrapElementId = DEFAULT_BOOTSTRAP_ELEMENT_ID,\n  children,\n  ...providerProps\n}: NextFlagsProviderProps): ReactElement {\n  const documentPayload = useDocumentPayload(bootstrapElementId, !bootstrapPayload);\n  const payload = bootstrapPayload ?? documentPayload;\n\n  const resolvedClient = useMemo(\n    () =>\n      client ??\n      createProviderClient({ environmentToken, apiEndpoint, cacheTtl, enableUsageReporting }),\n    [client, environmentToken, apiEndpoint, cacheTtl, enableUsageReporting]\n  );\n\n  const mergedDefaults = useMemo(\n    () => mergeDefaults(defaults, defaultsFromBootstrapPayload(payload)),\n    [defaults, payload]\n  );\n\n  // Without an explicit context the browser evaluates for the user the server evaluated for.\n  const resolvedContext = useMemo(\n    () => context ?? contextFromBootstrapPayload(payload),\n    [context, payload]\n  );\n\n  return (\n    <FlagsProvider\n      {...providerProps}\n      client={resolvedClient}\n      context={resolvedContext}\n      defaults={mergedDefaults}\n    >\n      <BootstrapProvider flags={payload?.flags ?? null}>{children}</BootstrapProvider>\n    </FlagsProvider>\n  );\n}\n","import {\n  Context,\n  DefaultsCollection,\n  type ContextData,\n  type Flag,\n  type FlagValue,\n} from '@zenmanage/sdk';\nimport type {\n  BootstrapPayload,\n  BuildBootstrapPayloadOptions,\n  BuildBootstrapScriptOptions,\n} from './types';\nimport { DEFAULT_BOOTSTRAP_ELEMENT_ID } from './types';\n\nconst ELEMENT_ID_PATTERN = /^[A-Za-z_][\\w:.-]*$/;\n\nfunction escapeForScriptTag(value: string): string {\n  return value\n    .replace(/</g, '\\\\u003c')\n    .replace(/>/g, '\\\\u003e')\n    .replace(/&/g, '\\\\u0026')\n    .replace(/\\u2028/g, '\\\\u2028')\n    .replace(/\\u2029/g, '\\\\u2029');\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isFlagValue(value: unknown): value is FlagValue {\n  return (\n    typeof value === 'boolean' ||\n    typeof value === 'string' ||\n    (typeof value === 'number' && Number.isFinite(value)) ||\n    (typeof value === 'object' && value !== null)\n  );\n}\n\n/**\n * Builds the payload `NextFlagsProvider` reads. Accepts the flags straight from\n * `getServerFlags`, or a plain `{ key: value }` record.\n */\nexport function buildBootstrapPayload(\n  flags: Flag[] | Record<string, FlagValue>,\n  options: BuildBootstrapPayloadOptions = {}\n): BootstrapPayload {\n  const values = Array.isArray(flags)\n    ? Object.fromEntries(flags.map((flag) => [flag.getKey(), flag.getValue()]))\n    : flags;\n\n  // `context` is left out rather than set to undefined: Next.js refuses undefined in the props\n  // `getServerSideProps` returns, and this payload is meant to be passed there.\n  return {\n    version: 1,\n    generatedAt: (options.generatedAt ?? new Date()).toISOString(),\n    flags: values,\n    ...(options.context ? { context: options.context.toJSON() } : {}),\n  };\n}\n\nexport function serializeBootstrapPayload(payload: BootstrapPayload): string {\n  return escapeForScriptTag(JSON.stringify(payload));\n}\n\nexport function deserializeBootstrapPayload(serializedPayload: string): BootstrapPayload | null {\n  try {\n    const parsed: unknown = JSON.parse(serializedPayload);\n\n    if (\n      !isPlainObject(parsed) ||\n      parsed.version !== 1 ||\n      !isPlainObject(parsed.flags) ||\n      typeof parsed.generatedAt !== 'string'\n    ) {\n      return null;\n    }\n\n    const flags = Object.fromEntries(\n      Object.entries(parsed.flags).filter(([, value]) => isFlagValue(value))\n    ) as Record<string, FlagValue>;\n\n    return {\n      version: 1,\n      generatedAt: parsed.generatedAt,\n      flags,\n      ...(isPlainObject(parsed.context)\n        ? { context: parsed.context as unknown as ContextData }\n        : {}),\n    };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Renders the payload as a JSON `<script>` tag for pages that can't pass props to the provider.\n * Prefer the `bootstrapPayload` prop: only a prop is identical on the server and in the browser.\n */\nexport function buildBootstrapScript(\n  payload: BootstrapPayload,\n  options: BuildBootstrapScriptOptions = {}\n): string {\n  const elementId = options.elementId ?? DEFAULT_BOOTSTRAP_ELEMENT_ID;\n\n  if (!ELEMENT_ID_PATTERN.test(elementId)) {\n    throw new Error(`Invalid bootstrap element id \"${elementId}\".`);\n  }\n\n  const serialized = serializeBootstrapPayload(payload);\n  return `<script id=\"${elementId}\" type=\"application/json\">${serialized}</script>`;\n}\n\nexport function readBootstrapPayloadFromDocument(\n  elementId = DEFAULT_BOOTSTRAP_ELEMENT_ID\n): BootstrapPayload | null {\n  if (typeof document === 'undefined') {\n    return null;\n  }\n\n  const element = document.getElementById(elementId);\n  if (!element) {\n    return null;\n  }\n\n  const text = element.textContent ?? '';\n  return deserializeBootstrapPayload(text);\n}\n\nexport function defaultsFromBootstrapPayload(\n  payload: BootstrapPayload | null | undefined\n): DefaultsCollection | undefined {\n  if (!payload) {\n    return undefined;\n  }\n\n  return DefaultsCollection.fromObject(payload.flags);\n}\n\nexport function defaultsFromBootstrapDocument(\n  elementId = DEFAULT_BOOTSTRAP_ELEMENT_ID\n): DefaultsCollection | undefined {\n  return defaultsFromBootstrapPayload(readBootstrapPayloadFromDocument(elementId));\n}\n\nexport function contextFromBootstrapPayload(\n  payload: BootstrapPayload | null | undefined\n): Context | undefined {\n  if (!payload?.context) {\n    return undefined;\n  }\n\n  try {\n    return Context.fromObject(payload.context);\n  } catch {\n    return undefined;\n  }\n}\n","import type {\n  Context,\n  ContextData,\n  DefaultsCollection,\n  FlagManager,\n  FlagValue,\n  Logger,\n  Zenmanage,\n} from '@zenmanage/sdk';\nimport type { FlagsProviderProps } from '@zenmanage/react';\n\nexport const DEFAULT_BOOTSTRAP_ELEMENT_ID = '__ZENMANAGE_BOOTSTRAP__';\n\n/**\n * Rules are cached in memory for this many seconds. The SDK's own default is an hour, which\n * would leave a long-running `next start` server on stale rules; a minute keeps flag changes\n * visible quickly while still sharing one fetch across every request and component.\n */\nexport const DEFAULT_SERVER_CACHE_TTL = 60;\n\n/**\n * Widens a literal (`false`, `'control'`, `1500`) to its primitive type, so a value read with\n * a literal fallback is `boolean`, `string` or `number` rather than the literal. Object and\n * array values (JSON flags) pass through unchanged.\n */\nexport type WidenFlagValue<T extends FlagValue> = T extends boolean\n  ? boolean\n  : T extends number\n    ? number\n    : T extends string\n      ? string\n      : T;\n\nexport interface NextZenmanageClientOptions {\n  /** A server key (`srv_...`). Server and edge runtimes reject client keys. */\n  environmentToken: string;\n  apiEndpoint?: string;\n  /** Seconds to cache rules in memory. Defaults to {@link DEFAULT_SERVER_CACHE_TTL}. */\n  cacheTtl?: number;\n  enableUsageReporting?: boolean;\n  logger?: Logger;\n}\n\nexport interface ServerFlagInput extends NextZenmanageClientOptions {\n  key: string;\n  defaultValue?: FlagValue;\n  context?: Context;\n  defaults?: DefaultsCollection;\n}\n\nexport interface ServerFlagsInput extends NextZenmanageClientOptions {\n  context?: Context;\n  defaults?: DefaultsCollection;\n}\n\nexport interface ServerBootstrapInput extends ServerFlagsInput {\n  /**\n   * The flags to send to the browser. Bootstrapping every flag puts each flag's key and\n   * value in the page source, so list only what client components read.\n   */\n  keys?: string[];\n  /** Include the evaluation context in the payload so the browser evaluates for the same user. */\n  includeContext?: boolean;\n}\n\nexport interface BootstrapPayload {\n  version: 1;\n  generatedAt: string;\n  flags: Record<string, FlagValue>;\n  context?: ContextData;\n}\n\nexport interface BuildBootstrapPayloadOptions {\n  context?: Context;\n  generatedAt?: Date;\n}\n\nexport interface BuildBootstrapScriptOptions {\n  elementId?: string;\n}\n\nexport interface RequestCookieValue {\n  value: string;\n}\n\nexport interface RequestCookiesLike {\n  get(name: string): RequestCookieValue | string | undefined;\n}\n\nexport interface RequestGeoLike {\n  country?: string;\n  region?: string;\n  city?: string;\n}\n\nexport interface RequestLike {\n  headers: Headers;\n  cookies?: RequestCookiesLike;\n  nextUrl?: { pathname: string };\n  url?: string;\n  /** Removed from `NextRequest` in Next.js 15; the forwarding headers are used instead. */\n  ip?: string | null;\n  /** Removed from `NextRequest` in Next.js 15; the Vercel and Cloudflare headers are used instead. */\n  geo?: RequestGeoLike;\n}\n\nexport interface BuildRequestContextOptions {\n  contextType?: string;\n  contextName?: string;\n  identifierCookieName?: string;\n  identifierHeaderName?: string;\n  /** Add `country`, `region` and `city` attributes when the platform reports them. Default `true`. */\n  includeGeo?: boolean;\n  /** Add the visitor's IP address as an `ip` attribute. Default `false`: an IP is personal data. */\n  includeIp?: boolean;\n  additionalAttributes?: Record<string, string | string[] | undefined>;\n}\n\nexport interface MiddlewareFlagInput extends NextZenmanageClientOptions {\n  request: RequestLike;\n  key: string;\n  defaultValue?: FlagValue;\n  defaults?: DefaultsCollection;\n  requestContext?: BuildRequestContextOptions;\n}\n\nexport interface NextFlagsProviderProps extends Omit<FlagsProviderProps, 'defaults'> {\n  defaults?: DefaultsCollection;\n  /**\n   * Flags evaluated on the server. Pass it as a prop so the server render and the first\n   * client render see the same value, which is what keeps hydration clean.\n   */\n  bootstrapPayload?: BootstrapPayload | null;\n  /** Read the payload from a `<script>` tag with this id when `bootstrapPayload` isn't set. */\n  bootstrapElementId?: string;\n}\n\nexport interface NextFlagsRuntime {\n  client: Zenmanage;\n  manager: FlagManager;\n}\n","import { DefaultsCollection } from '@zenmanage/sdk';\n\n/** Combines two collections. `base` wins where both define a key. */\nexport function mergeDefaults(\n  base?: DefaultsCollection,\n  bootstrap?: DefaultsCollection\n): DefaultsCollection | undefined {\n  if (!base && !bootstrap) {\n    return undefined;\n  }\n\n  const merged = new DefaultsCollection();\n\n  for (const source of [bootstrap, base]) {\n    if (!source) {\n      continue;\n    }\n\n    for (const key of source.keys()) {\n      const value = source.get(key);\n      if (value !== undefined) {\n        merged.set(key, value);\n      }\n    }\n  }\n\n  return merged;\n}\n","import { useEffect, useMemo, useState, type ReactElement, type ReactNode } from 'react';\nimport type { FlagValue } from '@zenmanage/sdk';\nimport { useFlagsContext } from '@zenmanage/react';\nimport { BootstrapContext } from './context';\n\ninterface BootstrapProviderProps {\n  flags: Record<string, FlagValue> | null;\n  children: ReactNode;\n}\n\n/**\n * Sits inside `FlagsProvider`. Once the browser has tried to load the rules it records which\n * flags they contain, so `useFlag` can tell \"the live value\" from \"the SDK fell back to the\n * default because nothing loaded\".\n */\nexport function BootstrapProvider({ flags, children }: BootstrapProviderProps): ReactElement {\n  const { manager, isReady, revision } = useFlagsContext();\n  const [live, setLive] = useState<ReadonlySet<string> | null>(null);\n\n  useEffect(() => {\n    if (!flags || !isReady) {\n      return undefined;\n    }\n\n    let isCurrent = true;\n\n    // The SDK serves defaults instead of throwing when rules can't be loaded, so an empty list\n    // is what an unreachable API looks like.\n    manager.all().then(\n      (loaded) => isCurrent && setLive(new Set(loaded.map((flag) => flag.getKey()))),\n      () => isCurrent && setLive(new Set())\n    );\n\n    return () => {\n      isCurrent = false;\n    };\n  }, [flags, isReady, manager, revision]);\n\n  const value = useMemo(() => (flags ? { flags, live } : null), [flags, live]);\n\n  return <BootstrapContext.Provider value={value}>{children}</BootstrapContext.Provider>;\n}\n","import { createContext } from 'react';\nimport type { FlagValue } from '@zenmanage/sdk';\n\nexport interface BootstrapState {\n  /** The flag values the server evaluated. */\n  flags: Record<string, FlagValue>;\n  /**\n   * The keys the browser's own rules contain, or `null` until it has asked. A flag that is\n   * bootstrapped but absent here has no live evaluation behind it (the rules didn't load, or\n   * the flag doesn't exist), so the server's value is the best answer there is.\n   */\n  live: ReadonlySet<string> | null;\n}\n\n/** `null` when the provider wasn't given a bootstrap payload. */\nexport const BootstrapContext = createContext<BootstrapState | null>(null);\n","import { ConfigBuilder, Zenmanage } from '@zenmanage/sdk';\nimport { CLIENT_AGENT, PACKAGE_VERSION } from '../identity';\n\ninterface ClientOptions {\n  environmentToken?: string;\n  apiEndpoint?: string;\n  cacheTtl?: number;\n  enableUsageReporting?: boolean;\n}\n\n// Mirrors how @zenmanage/sdk tells the runtimes apart.\nfunction isServerRender(): boolean {\n  return typeof window === 'undefined' && typeof document === 'undefined';\n}\n\n/**\n * Builds the client a provider hands to its hooks.\n *\n * Next.js renders Client Components on the server as well as in the browser, and the SDK\n * refuses a client key in Node.js. Nothing is fetched while rendering (effects don't run), so\n * the server render gets a client assembled without that check, which is only ever asked for\n * its defaults. The browser gets a fully validated one.\n */\nexport function createProviderClient(options: ClientOptions): Zenmanage {\n  const { environmentToken, apiEndpoint, cacheTtl, enableUsageReporting } = options;\n\n  if (!environmentToken) {\n    throw new Error('NextFlagsProvider requires either a client or an environmentToken.');\n  }\n\n  // A prop on a Client Component is written into the page, so a server key here would leak.\n  if (environmentToken.startsWith('srv_')) {\n    throw new Error(\n      'NextFlagsProvider received a server key (srv_...). Server keys must never reach the browser; use a client key (cli_...).'\n    );\n  }\n\n  if (isServerRender()) {\n    if (!environmentToken.startsWith('cli_')) {\n      throw new Error('NextFlagsProvider needs a client key (cli_...).');\n    }\n\n    return new Zenmanage({\n      environmentToken,\n      apiEndpoint,\n      cacheTtl,\n      enableUsageReporting,\n      clientAgent: CLIENT_AGENT,\n      sdkVersion: PACKAGE_VERSION,\n    });\n  }\n\n  const builder = ConfigBuilder.create()\n    .withEnvironmentToken(environmentToken)\n    .withClientAgent(CLIENT_AGENT)\n    .withSdkVersion(PACKAGE_VERSION);\n\n  if (apiEndpoint) {\n    builder.withApiEndpoint(apiEndpoint);\n  }\n\n  if (typeof cacheTtl === 'number') {\n    builder.withCacheTtl(cacheTtl);\n  }\n\n  if (typeof enableUsageReporting === 'boolean') {\n    builder.withUsageReporting(enableUsageReporting);\n  }\n\n  return new Zenmanage(builder.build());\n}\n","{\n  \"name\": \"@zenmanage/nextjs\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Next.js integration helpers for Zenmanage feature flags: server evaluation, middleware, and hydration-safe client bootstrap\",\n  \"keywords\": [\n    \"nextjs\",\n    \"next.js\",\n    \"react\",\n    \"ssr\",\n    \"app-router\",\n    \"pages-router\",\n    \"middleware\",\n    \"feature-flags\",\n    \"feature-toggles\",\n    \"feature-management\",\n    \"remote-config\",\n    \"ab-testing\",\n    \"experiments\",\n    \"zenmanage\"\n  ],\n  \"homepage\": \"https://github.com/zenmanage/zenmanage-nextjs#readme\",\n  \"bugs\": {\n    \"url\": \"https://github.com/zenmanage/zenmanage-nextjs/issues\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/zenmanage/zenmanage-nextjs.git\"\n  },\n  \"license\": \"MIT\",\n  \"author\": \"Zenmanage\",\n  \"type\": \"module\",\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"import\": {\n        \"types\": \"./dist/index.d.ts\",\n        \"default\": \"./dist/index.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/index.d.cts\",\n        \"default\": \"./dist/index.cjs\"\n      }\n    },\n    \"./server\": {\n      \"import\": {\n        \"types\": \"./dist/server.d.ts\",\n        \"default\": \"./dist/server.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/server.d.cts\",\n        \"default\": \"./dist/server.cjs\"\n      }\n    },\n    \"./middleware\": {\n      \"import\": {\n        \"types\": \"./dist/middleware.d.ts\",\n        \"default\": \"./dist/middleware.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/middleware.d.cts\",\n        \"default\": \"./dist/middleware.cjs\"\n      }\n    },\n    \"./client\": {\n      \"import\": {\n        \"types\": \"./dist/client.d.ts\",\n        \"default\": \"./dist/client.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/client.d.cts\",\n        \"default\": \"./dist/client.cjs\"\n      }\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"README.md\",\n    \"LICENSE\"\n  ],\n  \"sideEffects\": false,\n  \"scripts\": {\n    \"build\": \"rm -rf dist && tsup\",\n    \"clean\": \"rm -rf dist coverage\",\n    \"changeset\": \"changeset\",\n    \"version-packages\": \"changeset version\",\n    \"release\": \"changeset publish\",\n    \"lint\": \"eslint src tests --ext .ts,.tsx\",\n    \"lint:fix\": \"eslint src tests --ext .ts,.tsx --fix\",\n    \"format\": \"prettier --write \\\"src/**/*.{ts,tsx}\\\" \\\"tests/**/*.{ts,tsx}\\\" \\\"examples/**/*.{ts,tsx}\\\" \\\"examples/smoke-app/**/*.{js,jsx}\\\" \\\"scripts/**/*.mjs\\\" \\\"*.{md,json,yml,yaml,cjs}\\\"\",\n    \"format:check\": \"prettier --check \\\"src/**/*.{ts,tsx}\\\" \\\"tests/**/*.{ts,tsx}\\\" \\\"examples/**/*.{ts,tsx}\\\" \\\"examples/smoke-app/**/*.{js,jsx}\\\" \\\"scripts/**/*.mjs\\\" \\\"*.{md,json,yml,yaml,cjs}\\\"\",\n    \"type-check\": \"tsc --noEmit && tsc -p tsconfig.test.json --noEmit && tsc -p tsconfig.examples.json\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"test:coverage\": \"vitest run --coverage\",\n    \"test:smoke\": \"npm run build && node scripts/smoke.mjs\",\n    \"validate\": \"npm run format:check && npm run lint && npm run type-check && npm run test:coverage && npm run build && npm run test:smoke\",\n    \"prepublishOnly\": \"npm run validate\"\n  },\n  \"peerDependencies\": {\n    \"@zenmanage/react\": \"^1.0.0\",\n    \"@zenmanage/sdk\": \"^3.5.0\",\n    \"next\": \"^13.4.0 || ^14.0.0 || ^15.0.0 || ^16.0.0\",\n    \"react\": \"^18.2.0 || ^19.0.0\"\n  },\n  \"devDependencies\": {\n    \"@changesets/cli\": \"^2.28.1\",\n    \"@testing-library/react\": \"^16.0.1\",\n    \"@types/node\": \"^20.11.0\",\n    \"@types/react\": \"^19.2.0\",\n    \"@types/react-dom\": \"^19.2.0\",\n    \"@typescript-eslint/eslint-plugin\": \"^6.20.0\",\n    \"@typescript-eslint/parser\": \"^6.20.0\",\n    \"@vitest/coverage-v8\": \"^1.6.0\",\n    \"@zenmanage/react\": \"^1.0.0\",\n    \"@zenmanage/sdk\": \"^3.5.0\",\n    \"eslint\": \"^8.57.0\",\n    \"eslint-config-prettier\": \"^9.1.0\",\n    \"eslint-plugin-prettier\": \"^5.2.1\",\n    \"eslint-plugin-react-hooks\": \"^5.1.0\",\n    \"jsdom\": \"^24.1.1\",\n    \"next\": \"^15.5.0\",\n    \"prettier\": \"^3.3.3\",\n    \"react\": \"^19.2.0\",\n    \"react-dom\": \"^19.2.0\",\n    \"tsup\": \"^8.2.4\",\n    \"typescript\": \"^5.6.2\",\n    \"vitest\": \"^1.6.0\"\n  },\n  \"engines\": {\n    \"node\": \">=18.0.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  }\n}\n","import { version } from '../package.json';\n\n/** The client agent the API registers this package under (see the api's EnsureClientAgentIsValid). */\nexport const CLIENT_AGENT = 'zenmanage-nextjs';\n\nexport const PACKAGE_VERSION: string = version;\n","import { useContext } from 'react';\nimport type { FlagValue } from '@zenmanage/sdk';\nimport {\n  useFlag as useReactFlag,\n  type UseFlagResult,\n  type UseVariantResult,\n  type WidenFlagValue,\n} from '@zenmanage/react';\nimport { BootstrapContext } from './context';\n\nfunction sameKind(candidate: FlagValue, fallback: FlagValue): boolean {\n  if (typeof fallback === 'object') {\n    return (\n      typeof candidate === 'object' &&\n      candidate !== null &&\n      Array.isArray(candidate) === Array.isArray(fallback)\n    );\n  }\n\n  return typeof candidate === typeof fallback;\n}\n\n/**\n * Like `useFlag` from `@zenmanage/react`, but it serves the value the server evaluated until\n * the browser has a live evaluation to replace it. Both the server render and the first client\n * render use that value, with `isLoading` false, so the page hydrates without a mismatch or a\n * flash of the default. Once the browser's rules load, the live value takes over. If they\n * never load (a blocked CDN, no network), the server's value stays rather than the page\n * switching to the code default.\n *\n * Without a bootstrap value for the key it behaves exactly like the React hook.\n */\nexport function useFlag<T extends FlagValue>(\n  key: string,\n  defaultValue: T\n): UseFlagResult<WidenFlagValue<T>> {\n  const bootstrap = useContext(BootstrapContext);\n  // The hook's own default stays the fallback for the live evaluation: reporting the server's\n  // value as the code default would corrupt the default-value usage the API records.\n  const result = useReactFlag(key, defaultValue);\n\n  const seed = bootstrap?.flags[key];\n  if (seed === undefined || !sameKind(seed, defaultValue)) {\n    return result;\n  }\n\n  const hasLiveValue = bootstrap?.live?.has(key) === true;\n  if (hasLiveValue && !result.isLoading) {\n    return result;\n  }\n\n  return { ...result, value: seed as WidenFlagValue<T>, isLoading: false };\n}\n\nexport function useVariant(key: string, defaultVariant = 'control'): UseVariantResult {\n  const result = useFlag<string>(key, defaultVariant);\n\n  return {\n    key,\n    variant: result.value,\n    flag: result.flag,\n    isLoading: result.isLoading,\n    error: result.error,\n    refresh: result.refresh,\n  };\n}\n"],"mappings":"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","names":["import_react","import_sdk","import_react","import_sdk","import_jsx_runtime","import_react","useReactFlag","import_react"]}