@zenmanage/nextjs 0.0.0-stage → 1.0.0

package/dist/middleware.cjs

@@ -0,0 +1,199 @@
+"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/middleware.ts
+var middleware_exports = {};
+__export(middleware_exports, {
+  buildContextFromRequest: () => buildContextFromRequest,
+  evaluateMiddlewareFlag: () => evaluateMiddlewareFlag
+});
+module.exports = __toCommonJS(middleware_exports);
+var import_sdk2 = require("@zenmanage/sdk");
+
+// src/server.ts
+var import_sdk = require("@zenmanage/sdk");
+
+// src/types.ts
+var DEFAULT_SERVER_CACHE_TTL = 60;
+
+// package.json
+var version = "1.0.0";
+
+// src/identity.ts
+var CLIENT_AGENT = "zenmanage-nextjs";
+var PACKAGE_VERSION = version;
+
+// src/server.ts
+function buildClient(options) {
+  const builder = import_sdk.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 import_sdk.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 createServerRuntime(options) {
+  const client = createServerClient(options);
+  let manager = client.flags().withDefaults(options.defaults ?? new import_sdk.DefaultsCollection());
+  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);
+}
+
+// src/middleware.ts
+function getCookieValue(cookies, name) {
+  if (!cookies) {
+    return void 0;
+  }
+  const value = cookies.get(name);
+  if (typeof value === "string") {
+    return value;
+  }
+  return value?.value;
+}
+function getRequestPath(request) {
+  if (request.nextUrl?.pathname) {
+    return request.nextUrl.pathname;
+  }
+  if (request.url) {
+    return new URL(request.url).pathname;
+  }
+  return "/";
+}
+function decodeHeader(value) {
+  if (!value) {
+    return void 0;
+  }
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+function getIp(request) {
+  if (request.ip) {
+    return request.ip;
+  }
+  const forwarded = request.headers.get("x-forwarded-for")?.split(",")[0]?.trim();
+  return forwarded || request.headers.get("x-real-ip") || void 0;
+}
+function getGeo(request) {
+  const { headers, geo } = request;
+  return {
+    country: geo?.country || headers.get("x-vercel-ip-country") || headers.get("cf-ipcountry") || void 0,
+    region: geo?.region || headers.get("x-vercel-ip-country-region") || void 0,
+    city: geo?.city || decodeHeader(headers.get("x-vercel-ip-city"))
+  };
+}
+function buildContextFromRequest(request, options = {}) {
+  const identifierCookieName = options.identifierCookieName ?? "zenmanage_user_id";
+  const identifierHeaderName = options.identifierHeaderName ?? "x-zenmanage-user-id";
+  const includeGeo = options.includeGeo ?? true;
+  const includeIp = options.includeIp ?? false;
+  const identifier = getCookieValue(request.cookies, identifierCookieName) ?? request.headers.get(identifierHeaderName) ?? void 0;
+  const context = new import_sdk2.Context(options.contextType ?? "user", options.contextName, identifier);
+  const userAgent = request.headers.get("user-agent");
+  if (userAgent) {
+    context.addAttribute(new import_sdk2.Attribute("user-agent", [userAgent]));
+  }
+  context.addAttribute(new import_sdk2.Attribute("path", [getRequestPath(request)]));
+  const ip = includeIp ? getIp(request) : void 0;
+  if (ip) {
+    context.addAttribute(new import_sdk2.Attribute("ip", [ip]));
+  }
+  if (includeGeo) {
+    const geo = getGeo(request);
+    if (geo.country) {
+      context.addAttribute(new import_sdk2.Attribute("country", [geo.country]));
+    }
+    if (geo.region) {
+      context.addAttribute(new import_sdk2.Attribute("region", [geo.region]));
+    }
+    if (geo.city) {
+      context.addAttribute(new import_sdk2.Attribute("city", [geo.city]));
+    }
+  }
+  if (options.additionalAttributes) {
+    for (const [key, value] of Object.entries(options.additionalAttributes)) {
+      if (!value) {
+        continue;
+      }
+      const values = Array.isArray(value) ? value : [value];
+      context.addAttribute(new import_sdk2.Attribute(key, values));
+    }
+  }
+  return context;
+}
+async function evaluateMiddlewareFlag(input) {
+  const context = buildContextFromRequest(input.request, input.requestContext);
+  return getServerFlag({
+    environmentToken: input.environmentToken,
+    apiEndpoint: input.apiEndpoint,
+    cacheTtl: input.cacheTtl,
+    enableUsageReporting: input.enableUsageReporting,
+    logger: input.logger,
+    key: input.key,
+    defaultValue: input.defaultValue,
+    defaults: input.defaults,
+    context
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildContextFromRequest,
+  evaluateMiddlewareFlag
+});
+//# sourceMappingURL=middleware.cjs.map

package/dist/middleware.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/middleware.ts","../src/server.ts","../src/types.ts","../package.json","../src/identity.ts"],"sourcesContent":["import { Attribute, Context, type Flag } from '@zenmanage/sdk';\nimport { getServerFlag } from './server';\nimport type {\n  BuildRequestContextOptions,\n  MiddlewareFlagInput,\n  RequestCookiesLike,\n  RequestLike,\n} from './types';\n\nfunction getCookieValue(cookies: RequestCookiesLike | undefined, name: string): string | undefined {\n  if (!cookies) {\n    return undefined;\n  }\n\n  const value = cookies.get(name);\n  if (typeof value === 'string') {\n    return value;\n  }\n\n  return value?.value;\n}\n\nfunction getRequestPath(request: RequestLike): string {\n  if (request.nextUrl?.pathname) {\n    return request.nextUrl.pathname;\n  }\n\n  if (request.url) {\n    return new URL(request.url).pathname;\n  }\n\n  return '/';\n}\n\nfunction decodeHeader(value: string | null): string | undefined {\n  if (!value) {\n    return undefined;\n  }\n\n  try {\n    return decodeURIComponent(value);\n  } catch {\n    return value;\n  }\n}\n\n// Next.js 15 removed `request.ip` and `request.geo`, so read what the platform forwards.\nfunction getIp(request: RequestLike): string | undefined {\n  if (request.ip) {\n    return request.ip;\n  }\n\n  const forwarded = request.headers.get('x-forwarded-for')?.split(',')[0]?.trim();\n  return forwarded || request.headers.get('x-real-ip') || undefined;\n}\n\nfunction getGeo(request: RequestLike): { country?: string; region?: string; city?: string } {\n  const { headers, geo } = request;\n\n  // Next.js 14 and earlier set `request.geo` even when nothing fills it in (it is `{}` when\n  // self-hosted), so each field falls back to the headers on its own.\n  return {\n    country:\n      geo?.country ||\n      headers.get('x-vercel-ip-country') ||\n      headers.get('cf-ipcountry') ||\n      undefined,\n    region: geo?.region || headers.get('x-vercel-ip-country-region') || undefined,\n    city: geo?.city || decodeHeader(headers.get('x-vercel-ip-city')),\n  };\n}\n\n/**\n * Builds an evaluation context from a request: an identifier (cookie, then header), the path,\n * the user agent and, when the platform reports it, the visitor's location. Works with\n * `NextRequest` and with a plain `Request`.\n */\nexport function buildContextFromRequest(\n  request: RequestLike,\n  options: BuildRequestContextOptions = {}\n): Context {\n  const identifierCookieName = options.identifierCookieName ?? 'zenmanage_user_id';\n  const identifierHeaderName = options.identifierHeaderName ?? 'x-zenmanage-user-id';\n  const includeGeo = options.includeGeo ?? true;\n  const includeIp = options.includeIp ?? false;\n\n  const identifier =\n    getCookieValue(request.cookies, identifierCookieName) ??\n    request.headers.get(identifierHeaderName) ??\n    undefined;\n\n  const context = new Context(options.contextType ?? 'user', options.contextName, identifier);\n\n  const userAgent = request.headers.get('user-agent');\n  if (userAgent) {\n    context.addAttribute(new Attribute('user-agent', [userAgent]));\n  }\n\n  context.addAttribute(new Attribute('path', [getRequestPath(request)]));\n\n  const ip = includeIp ? getIp(request) : undefined;\n  if (ip) {\n    context.addAttribute(new Attribute('ip', [ip]));\n  }\n\n  if (includeGeo) {\n    const geo = getGeo(request);\n\n    if (geo.country) {\n      context.addAttribute(new Attribute('country', [geo.country]));\n    }\n\n    if (geo.region) {\n      context.addAttribute(new Attribute('region', [geo.region]));\n    }\n\n    if (geo.city) {\n      context.addAttribute(new Attribute('city', [geo.city]));\n    }\n  }\n\n  if (options.additionalAttributes) {\n    for (const [key, value] of Object.entries(options.additionalAttributes)) {\n      if (!value) {\n        continue;\n      }\n\n      const values = Array.isArray(value) ? value : [value];\n      context.addAttribute(new Attribute(key, values));\n    }\n  }\n\n  return context;\n}\n\n/**\n * Evaluates one flag for the request. Runs on the Edge runtime (`middleware.ts`) and on the\n * Node.js runtime (`proxy.ts` in Next.js 16), and needs a server key in both.\n */\nexport async function evaluateMiddlewareFlag(input: MiddlewareFlagInput): Promise<Flag> {\n  const context = buildContextFromRequest(input.request, input.requestContext);\n\n  return getServerFlag({\n    environmentToken: input.environmentToken,\n    apiEndpoint: input.apiEndpoint,\n    cacheTtl: input.cacheTtl,\n    enableUsageReporting: input.enableUsageReporting,\n    logger: input.logger,\n    key: input.key,\n    defaultValue: input.defaultValue,\n    defaults: input.defaults,\n    context,\n  });\n}\n","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 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"],"mappings":"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","names":["import_sdk"]}

package/dist/middleware.d.cts

@@ -0,0 +1,16 @@
+import { Context, Flag } from '@zenmanage/sdk';
+import { g as RequestLike, c as BuildRequestContextOptions, M as MiddlewareFlagInput } from './types-CFBzBNpk.cjs';
+
+/**
+ * Builds an evaluation context from a request: an identifier (cookie, then header), the path,
+ * the user agent and, when the platform reports it, the visitor's location. Works with
+ * `NextRequest` and with a plain `Request`.
+ */
+declare function buildContextFromRequest(request: RequestLike, options?: BuildRequestContextOptions): Context;
+/**
+ * Evaluates one flag for the request. Runs on the Edge runtime (`middleware.ts`) and on the
+ * Node.js runtime (`proxy.ts` in Next.js 16), and needs a server key in both.
+ */
+declare function evaluateMiddlewareFlag(input: MiddlewareFlagInput): Promise<Flag>;
+
+export { buildContextFromRequest, evaluateMiddlewareFlag };

package/dist/middleware.d.ts

@@ -0,0 +1,16 @@
+import { Context, Flag } from '@zenmanage/sdk';
+import { g as RequestLike, c as BuildRequestContextOptions, M as MiddlewareFlagInput } from './types-CFBzBNpk.js';
+
+/**
+ * Builds an evaluation context from a request: an identifier (cookie, then header), the path,
+ * the user agent and, when the platform reports it, the visitor's location. Works with
+ * `NextRequest` and with a plain `Request`.
+ */
+declare function buildContextFromRequest(request: RequestLike, options?: BuildRequestContextOptions): Context;
+/**
+ * Evaluates one flag for the request. Runs on the Edge runtime (`middleware.ts`) and on the
+ * Node.js runtime (`proxy.ts` in Next.js 16), and needs a server key in both.
+ */
+declare function evaluateMiddlewareFlag(input: MiddlewareFlagInput): Promise<Flag>;
+
+export { buildContextFromRequest, evaluateMiddlewareFlag };

package/dist/middleware.js

@@ -0,0 +1,10 @@
+import {
+  buildContextFromRequest,
+  evaluateMiddlewareFlag
+} from "./chunk-PMTVMVXJ.js";
+import "./chunk-ZUB4F2DA.js";
+export {
+  buildContextFromRequest,
+  evaluateMiddlewareFlag
+};
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server.cjs

@@ -0,0 +1,182 @@
+"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/server.ts
+var server_exports = {};
+__export(server_exports, {
+  clearServerClients: () => clearServerClients,
+  createServerClient: () => createServerClient,
+  createServerManager: () => createServerManager,
+  createServerRuntime: () => createServerRuntime,
+  getBootstrapPayload: () => getBootstrapPayload,
+  getFlagValue: () => getFlagValue,
+  getServerFlag: () => getServerFlag,
+  getServerFlags: () => getServerFlags,
+  mergeDefaults: () => mergeDefaults,
+  preloadServerFlags: () => preloadServerFlags
+});
+module.exports = __toCommonJS(server_exports);
+var import_sdk3 = require("@zenmanage/sdk");
+
+// src/bootstrap.ts
+var import_sdk = require("@zenmanage/sdk");
+
+// src/types.ts
+var DEFAULT_SERVER_CACHE_TTL = 60;
+
+// src/bootstrap.ts
+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() } : {}
+  };
+}
+
+// package.json
+var version = "1.0.0";
+
+// src/identity.ts
+var CLIENT_AGENT = "zenmanage-nextjs";
+var PACKAGE_VERSION = version;
+
+// 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/server.ts
+function buildClient(options) {
+  const builder = import_sdk3.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 import_sdk3.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 import_sdk3.DefaultsCollection());
+  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 }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearServerClients,
+  createServerClient,
+  createServerManager,
+  createServerRuntime,
+  getBootstrapPayload,
+  getFlagValue,
+  getServerFlag,
+  getServerFlags,
+  mergeDefaults,
+  preloadServerFlags
+});
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.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":["import_sdk","import_sdk"]}

package/dist/server.d.cts

@@ -0,0 +1,31 @@
+import { DefaultsCollection, Zenmanage, FlagManager, FlagValue, Flag } from '@zenmanage/sdk';
+import { e as NextZenmanageClientOptions, i as ServerFlagsInput, N as NextFlagsRuntime, S as ServerBootstrapInput, a as BootstrapPayload, h as ServerFlagInput, W as WidenFlagValue } from './types-CFBzBNpk.cjs';
+
+/** Combines two collections. `base` wins where both define a key. */
+declare function mergeDefaults(base?: DefaultsCollection, bootstrap?: DefaultsCollection): DefaultsCollection | undefined;
+
+/**
+ * Returns the client for this configuration, creating it on first use. Calls with the same
+ * token, endpoint, TTL, usage setting and logger share one client and so one rules cache.
+ */
+declare function createServerClient(options: NextZenmanageClientOptions): Zenmanage;
+/** Forgets every shared client, and with them their cached rules. Mostly useful in tests. */
+declare function clearServerClients(): void;
+declare function createServerRuntime(options: ServerFlagsInput): NextFlagsRuntime;
+declare function createServerManager(options: ServerFlagsInput): FlagManager;
+declare function getServerFlag(input: ServerFlagInput): Promise<Flag>;
+declare function getServerFlags(input: ServerFlagsInput): Promise<Flag[]>;
+declare function preloadServerFlags(input: ServerFlagsInput): Promise<FlagManager>;
+/**
+ * Evaluates a flag and returns its value as the type of `fallback`: a boolean, number or
+ * string, or a JSON object or array. A literal fallback (`'control'`, `false`) gives the
+ * widened type (`string`, `boolean`), so the result can be compared with other values.
+ */
+declare function getFlagValue<T extends FlagValue>(input: ServerFlagInput, fallback: T): Promise<WidenFlagValue<T>>;
+/**
+ * Evaluates flags on the server and packages them for `NextFlagsProvider`. Pass `keys` to
+ * send only the flags client components read.
+ */
+declare function getBootstrapPayload(input: ServerBootstrapInput): Promise<BootstrapPayload>;
+
+export { clearServerClients, createServerClient, createServerManager, createServerRuntime, getBootstrapPayload, getFlagValue, getServerFlag, getServerFlags, mergeDefaults, preloadServerFlags };

package/dist/server.d.ts

@@ -0,0 +1,31 @@
+import { DefaultsCollection, Zenmanage, FlagManager, FlagValue, Flag } from '@zenmanage/sdk';
+import { e as NextZenmanageClientOptions, i as ServerFlagsInput, N as NextFlagsRuntime, S as ServerBootstrapInput, a as BootstrapPayload, h as ServerFlagInput, W as WidenFlagValue } from './types-CFBzBNpk.js';
+
+/** Combines two collections. `base` wins where both define a key. */
+declare function mergeDefaults(base?: DefaultsCollection, bootstrap?: DefaultsCollection): DefaultsCollection | undefined;
+
+/**
+ * Returns the client for this configuration, creating it on first use. Calls with the same
+ * token, endpoint, TTL, usage setting and logger share one client and so one rules cache.
+ */
+declare function createServerClient(options: NextZenmanageClientOptions): Zenmanage;
+/** Forgets every shared client, and with them their cached rules. Mostly useful in tests. */
+declare function clearServerClients(): void;
+declare function createServerRuntime(options: ServerFlagsInput): NextFlagsRuntime;
+declare function createServerManager(options: ServerFlagsInput): FlagManager;
+declare function getServerFlag(input: ServerFlagInput): Promise<Flag>;
+declare function getServerFlags(input: ServerFlagsInput): Promise<Flag[]>;
+declare function preloadServerFlags(input: ServerFlagsInput): Promise<FlagManager>;
+/**
+ * Evaluates a flag and returns its value as the type of `fallback`: a boolean, number or
+ * string, or a JSON object or array. A literal fallback (`'control'`, `false`) gives the
+ * widened type (`string`, `boolean`), so the result can be compared with other values.
+ */
+declare function getFlagValue<T extends FlagValue>(input: ServerFlagInput, fallback: T): Promise<WidenFlagValue<T>>;
+/**
+ * Evaluates flags on the server and packages them for `NextFlagsProvider`. Pass `keys` to
+ * send only the flags client components read.
+ */
+declare function getBootstrapPayload(input: ServerBootstrapInput): Promise<BootstrapPayload>;
+
+export { clearServerClients, createServerClient, createServerManager, createServerRuntime, getBootstrapPayload, getFlagValue, getServerFlag, getServerFlags, mergeDefaults, preloadServerFlags };

package/dist/server.js

@@ -0,0 +1,25 @@
+import {
+  clearServerClients,
+  createServerClient,
+  createServerManager,
+  createServerRuntime,
+  getBootstrapPayload,
+  getFlagValue,
+  getServerFlag,
+  getServerFlags,
+  mergeDefaults,
+  preloadServerFlags
+} from "./chunk-ZUB4F2DA.js";
+export {
+  clearServerClients,
+  createServerClient,
+  createServerManager,
+  createServerRuntime,
+  getBootstrapPayload,
+  getFlagValue,
+  getServerFlag,
+  getServerFlags,
+  mergeDefaults,
+  preloadServerFlags
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}