@botlr/next 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @botlr/next
+
+## 0.1.0
+
+- First release. `getBotlrForRoute` moves here from the publisher's
+  `lib/botlr-sdk/server.ts`, typed against `@botlr/sdk`, plus
+  `getCachedBotlr`, `createBotlrFromEnv`, `configFromEnv` and
+  `localeFromAcceptLanguage`.
+- Re-exports `@botlr/react` and the `@botlr/sdk` types.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Botlr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,32 @@
-# Temporary Holding Version
+# @botlr/next
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Thin Next.js helpers on top of `@botlr/sdk` and `@botlr/react`. Everything
+from both packages is re-exported, so a Next.js app can import from
+`@botlr/next` alone.
+
+```ts
+// app/[[...slug]]/page.tsx
+import { getBotlrForRoute, SectionRenderer } from "@botlr/next";
+
+export default async function Page({ params, searchParams }) {
+  const botlr = await getBotlrForRoute({
+    appId: process.env.BOTLR_APP_ID!,
+    preview: (await searchParams).preview === "true",
+  });
+  const resolved = await botlr.resolveUrl((await params).slug?.join("/") ?? "");
+  // ...render resolved.data.layout with SectionRenderer
+}
+```
+
+- `getBotlrForRoute(params)` builds a client for the current request. The
+  locale comes from `Accept-Language` unless given; `baseUrl`, `apiKey` and
+  `appId` fall back to `BOTLR_API_URL`, `BOTLR_API_KEY` and `BOTLR_APP_ID`.
+  All of them are server-side variables: the API URL is never exposed to the
+  browser through a `NEXT_PUBLIC_` name.
+- `getCachedBotlr` is the same, memoised per request with React `cache`.
+- `createBotlrFromEnv(overrides)` needs no request context (scripts,
+  `generateStaticParams`).
+- `localeFromAcceptLanguage(header, fallback)` and `configFromEnv(overrides)`
+  are the building blocks.
+
+`next` and `react` are peer dependencies.

package/dist/index.cjs

@@ -0,0 +1,113 @@
+"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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BOTLR_ENV: () => BOTLR_ENV,
+  BotlrConflictError: () => import_sdk2.BotlrConflictError,
+  BotlrError: () => import_sdk2.BotlrError,
+  DEFAULT_API_URL: () => DEFAULT_API_URL,
+  configFromEnv: () => configFromEnv,
+  createBotlrClient: () => import_sdk2.createBotlrClient,
+  createBotlrFromEnv: () => createBotlrFromEnv,
+  getBotlrForRoute: () => getBotlrForRoute,
+  getCachedBotlr: () => getCachedBotlr,
+  localeFromAcceptLanguage: () => localeFromAcceptLanguage
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/server.ts
+var import_headers = require("next/headers");
+var import_react = require("react");
+var import_sdk = require("@botlr/sdk");
+
+// src/env.ts
+var BOTLR_ENV = {
+  apiUrl: "BOTLR_API_URL",
+  apiKey: "BOTLR_API_KEY",
+  appId: "BOTLR_APP_ID",
+  pat: "BOTLR_PAT"
+};
+var DEFAULT_API_URL = "http://localhost:8888";
+function env(name) {
+  const value = typeof process !== "undefined" ? process.env?.[name] : void 0;
+  return value === "" ? void 0 : value;
+}
+function configFromEnv(overrides = {}) {
+  const appId = overrides.appId ?? env(BOTLR_ENV.appId);
+  if (!appId) {
+    throw new Error(`@botlr/next: pass appId or set ${BOTLR_ENV.appId}`);
+  }
+  return {
+    ...overrides,
+    baseUrl: overrides.baseUrl ?? env(BOTLR_ENV.apiUrl) ?? DEFAULT_API_URL,
+    appId,
+    apiKey: overrides.apiKey ?? env(BOTLR_ENV.apiKey),
+    personalToken: overrides.personalToken ?? env(BOTLR_ENV.pat)
+  };
+}
+
+// src/locale.ts
+function localeFromAcceptLanguage(header, fallback = "en") {
+  if (!header) return fallback;
+  const first = header.split(",")[0]?.split(";")[0]?.trim();
+  return first || fallback;
+}
+
+// src/server.ts
+async function getBotlrForRoute(params = {}) {
+  const h = await (0, import_headers.headers)();
+  const locale = params.locale || localeFromAcceptLanguage(h.get("accept-language"));
+  return (0, import_sdk.createBotlrClient)(
+    configFromEnv({
+      appId: params.appId,
+      apiKey: params.apiKey,
+      baseUrl: params.baseUrl,
+      previewToken: params.previewToken,
+      locale,
+      preview: params.preview,
+      fetch: params.fetch
+    })
+  );
+}
+var getCachedBotlr = (0, import_react.cache)(getBotlrForRoute);
+function createBotlrFromEnv(overrides = {}) {
+  return (0, import_sdk.createBotlrClient)(configFromEnv(overrides));
+}
+
+// src/index.ts
+__reExport(index_exports, require("@botlr/react"), module.exports);
+var import_sdk2 = require("@botlr/sdk");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BOTLR_ENV,
+  BotlrConflictError,
+  BotlrError,
+  DEFAULT_API_URL,
+  configFromEnv,
+  createBotlrClient,
+  createBotlrFromEnv,
+  getBotlrForRoute,
+  getCachedBotlr,
+  localeFromAcceptLanguage,
+  ...require("@botlr/react")
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/server.ts","../src/env.ts","../src/locale.ts"],"sourcesContent":["export { getBotlrForRoute, getCachedBotlr, createBotlrFromEnv, type GetBotlrParams } from \"./server\";\nexport { configFromEnv, BOTLR_ENV, DEFAULT_API_URL } from \"./env\";\nexport { localeFromAcceptLanguage } from \"./locale\";\n\nexport * from \"@botlr/react\";\nexport type * from \"@botlr/sdk\";\nexport { BotlrError, BotlrConflictError, createBotlrClient } from \"@botlr/sdk\";\n","import { headers } from \"next/headers\";\nimport { cache } from \"react\";\nimport { createBotlrClient, type BotlrClient } from \"@botlr/sdk\";\nimport { configFromEnv } from \"./env\";\nimport { localeFromAcceptLanguage } from \"./locale\";\n\nexport type GetBotlrParams = {\n  /** The app instance ID. Falls back to `BOTLR_APP_ID`. */\n  appId?: string;\n  /** Locale override; defaults to the request's `Accept-Language`, then `en`. */\n  locale?: string;\n  preview?: boolean;\n  /** Site token; falls back to `BOTLR_API_KEY`. Omit in dev mode. */\n  apiKey?: string;\n  /** Preview JWT, forwarded to `/api/resolve` in preview mode. */\n  previewToken?: string;\n  /** API origin; falls back to `BOTLR_API_URL`. */\n  baseUrl?: string;\n  fetch?: typeof fetch;\n};\n\n/**\n * A Botlr client for the current request, for Server Components, route\n * handlers and server actions. Reads the locale from `Accept-Language`\n * unless given.\n *\n * ```ts\n * const botlr = await getBotlrForRoute({ appId: scope.appInstanceId, locale: scope.locale, preview });\n * const pages = await botlr.getPageList({ tags: [\"news\"] });\n * ```\n */\nexport async function getBotlrForRoute(params: GetBotlrParams = {}): Promise<BotlrClient> {\n  const h = await headers();\n  const locale = params.locale || localeFromAcceptLanguage(h.get(\"accept-language\"));\n  return createBotlrClient(\n    configFromEnv({\n      appId: params.appId,\n      apiKey: params.apiKey,\n      baseUrl: params.baseUrl,\n      previewToken: params.previewToken,\n      locale,\n      preview: params.preview,\n      fetch: params.fetch,\n    }),\n  );\n}\n\n/**\n * `getBotlrForRoute` memoised per request with React `cache`, so several\n * components in one render share a client.\n */\nexport const getCachedBotlr: (params?: GetBotlrParams) => Promise<BotlrClient> = cache(getBotlrForRoute);\n\n/**\n * A client from the environment alone, with no request context. For scripts,\n * `generateStaticParams`, instrumentation and anywhere `headers()` is not\n * available.\n */\nexport function createBotlrFromEnv(overrides: Partial<GetBotlrParams> = {}): BotlrClient {\n  return createBotlrClient(configFromEnv(overrides));\n}\n","import type { BotlrClientConfig } from \"@botlr/sdk\";\n\n/** Environment variables the helpers read. All server-side: the API URL is never exposed to the browser. */\nexport const BOTLR_ENV = {\n  apiUrl: \"BOTLR_API_URL\",\n  apiKey: \"BOTLR_API_KEY\",\n  appId: \"BOTLR_APP_ID\",\n  pat: \"BOTLR_PAT\",\n} as const;\n\nexport const DEFAULT_API_URL = \"http://localhost:8888\";\n\nfunction env(name: string): string | undefined {\n  const value = typeof process !== \"undefined\" ? process.env?.[name] : undefined;\n  return value === \"\" ? undefined : value;\n}\n\n/**\n * Client config from the environment, with `overrides` winning. Throws when\n * no app id is known, since every Botlr request needs one.\n */\nexport function configFromEnv(overrides: Partial<BotlrClientConfig> = {}): BotlrClientConfig {\n  const appId = overrides.appId ?? env(BOTLR_ENV.appId);\n  if (!appId) {\n    throw new Error(`@botlr/next: pass appId or set ${BOTLR_ENV.appId}`);\n  }\n  return {\n    ...overrides,\n    baseUrl: overrides.baseUrl ?? env(BOTLR_ENV.apiUrl) ?? DEFAULT_API_URL,\n    appId,\n    apiKey: overrides.apiKey ?? env(BOTLR_ENV.apiKey),\n    personalToken: overrides.personalToken ?? env(BOTLR_ENV.pat),\n  };\n}\n","/** The first language of an `Accept-Language` value, or `fallback`. */\nexport function localeFromAcceptLanguage(header: string | null | undefined, fallback = \"en\"): string {\n  if (!header) return fallback;\n  const first = header.split(\",\")[0]?.split(\";\")[0]?.trim();\n  return first || fallback;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,qBAAwB;AACxB,mBAAsB;AACtB,iBAAoD;;;ACC7C,IAAM,YAAY;AAAA,EACvB,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,KAAK;AACP;AAEO,IAAM,kBAAkB;AAE/B,SAAS,IAAI,MAAkC;AAC7C,QAAM,QAAQ,OAAO,YAAY,cAAc,QAAQ,MAAM,IAAI,IAAI;AACrE,SAAO,UAAU,KAAK,SAAY;AACpC;AAMO,SAAS,cAAc,YAAwC,CAAC,GAAsB;AAC3F,QAAM,QAAQ,UAAU,SAAS,IAAI,UAAU,KAAK;AACpD,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,kCAAkC,UAAU,KAAK,EAAE;AAAA,EACrE;AACA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,UAAU,WAAW,IAAI,UAAU,MAAM,KAAK;AAAA,IACvD;AAAA,IACA,QAAQ,UAAU,UAAU,IAAI,UAAU,MAAM;AAAA,IAChD,eAAe,UAAU,iBAAiB,IAAI,UAAU,GAAG;AAAA,EAC7D;AACF;;;AChCO,SAAS,yBAAyB,QAAmC,WAAW,MAAc;AACnG,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,QAAQ,OAAO,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,GAAG,EAAE,CAAC,GAAG,KAAK;AACxD,SAAO,SAAS;AAClB;;;AF0BA,eAAsB,iBAAiB,SAAyB,CAAC,GAAyB;AACxF,QAAM,IAAI,UAAM,wBAAQ;AACxB,QAAM,SAAS,OAAO,UAAU,yBAAyB,EAAE,IAAI,iBAAiB,CAAC;AACjF,aAAO;AAAA,IACL,cAAc;AAAA,MACZ,OAAO,OAAO;AAAA,MACd,QAAQ,OAAO;AAAA,MACf,SAAS,OAAO;AAAA,MAChB,cAAc,OAAO;AAAA,MACrB;AAAA,MACA,SAAS,OAAO;AAAA,MAChB,OAAO,OAAO;AAAA,IAChB,CAAC;AAAA,EACH;AACF;AAMO,IAAM,qBAAoE,oBAAM,gBAAgB;AAOhG,SAAS,mBAAmB,YAAqC,CAAC,GAAgB;AACvF,aAAO,8BAAkB,cAAc,SAAS,CAAC;AACnD;;;ADxDA,0BAAc,yBAJd;AAMA,IAAAA,cAAkE;","names":["import_sdk"]}

package/dist/index.d.cts

@@ -0,0 +1,60 @@
+import { BotlrClient, BotlrClientConfig } from '@botlr/sdk';
+export * from '@botlr/sdk';
+export { BotlrConflictError, BotlrError, createBotlrClient } from '@botlr/sdk';
+export * from '@botlr/react';
+
+type GetBotlrParams = {
+    /** The app instance ID. Falls back to `BOTLR_APP_ID`. */
+    appId?: string;
+    /** Locale override; defaults to the request's `Accept-Language`, then `en`. */
+    locale?: string;
+    preview?: boolean;
+    /** Site token; falls back to `BOTLR_API_KEY`. Omit in dev mode. */
+    apiKey?: string;
+    /** Preview JWT, forwarded to `/api/resolve` in preview mode. */
+    previewToken?: string;
+    /** API origin; falls back to `BOTLR_API_URL`. */
+    baseUrl?: string;
+    fetch?: typeof fetch;
+};
+/**
+ * A Botlr client for the current request, for Server Components, route
+ * handlers and server actions. Reads the locale from `Accept-Language`
+ * unless given.
+ *
+ * ```ts
+ * const botlr = await getBotlrForRoute({ appId: scope.appInstanceId, locale: scope.locale, preview });
+ * const pages = await botlr.getPageList({ tags: ["news"] });
+ * ```
+ */
+declare function getBotlrForRoute(params?: GetBotlrParams): Promise<BotlrClient>;
+/**
+ * `getBotlrForRoute` memoised per request with React `cache`, so several
+ * components in one render share a client.
+ */
+declare const getCachedBotlr: (params?: GetBotlrParams) => Promise<BotlrClient>;
+/**
+ * A client from the environment alone, with no request context. For scripts,
+ * `generateStaticParams`, instrumentation and anywhere `headers()` is not
+ * available.
+ */
+declare function createBotlrFromEnv(overrides?: Partial<GetBotlrParams>): BotlrClient;
+
+/** Environment variables the helpers read. All server-side: the API URL is never exposed to the browser. */
+declare const BOTLR_ENV: {
+    readonly apiUrl: "BOTLR_API_URL";
+    readonly apiKey: "BOTLR_API_KEY";
+    readonly appId: "BOTLR_APP_ID";
+    readonly pat: "BOTLR_PAT";
+};
+declare const DEFAULT_API_URL = "http://localhost:8888";
+/**
+ * Client config from the environment, with `overrides` winning. Throws when
+ * no app id is known, since every Botlr request needs one.
+ */
+declare function configFromEnv(overrides?: Partial<BotlrClientConfig>): BotlrClientConfig;
+
+/** The first language of an `Accept-Language` value, or `fallback`. */
+declare function localeFromAcceptLanguage(header: string | null | undefined, fallback?: string): string;
+
+export { BOTLR_ENV, DEFAULT_API_URL, type GetBotlrParams, configFromEnv, createBotlrFromEnv, getBotlrForRoute, getCachedBotlr, localeFromAcceptLanguage };

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+import { BotlrClient, BotlrClientConfig } from '@botlr/sdk';
+export * from '@botlr/sdk';
+export { BotlrConflictError, BotlrError, createBotlrClient } from '@botlr/sdk';
+export * from '@botlr/react';
+
+type GetBotlrParams = {
+    /** The app instance ID. Falls back to `BOTLR_APP_ID`. */
+    appId?: string;
+    /** Locale override; defaults to the request's `Accept-Language`, then `en`. */
+    locale?: string;
+    preview?: boolean;
+    /** Site token; falls back to `BOTLR_API_KEY`. Omit in dev mode. */
+    apiKey?: string;
+    /** Preview JWT, forwarded to `/api/resolve` in preview mode. */
+    previewToken?: string;
+    /** API origin; falls back to `BOTLR_API_URL`. */
+    baseUrl?: string;
+    fetch?: typeof fetch;
+};
+/**
+ * A Botlr client for the current request, for Server Components, route
+ * handlers and server actions. Reads the locale from `Accept-Language`
+ * unless given.
+ *
+ * ```ts
+ * const botlr = await getBotlrForRoute({ appId: scope.appInstanceId, locale: scope.locale, preview });
+ * const pages = await botlr.getPageList({ tags: ["news"] });
+ * ```
+ */
+declare function getBotlrForRoute(params?: GetBotlrParams): Promise<BotlrClient>;
+/**
+ * `getBotlrForRoute` memoised per request with React `cache`, so several
+ * components in one render share a client.
+ */
+declare const getCachedBotlr: (params?: GetBotlrParams) => Promise<BotlrClient>;
+/**
+ * A client from the environment alone, with no request context. For scripts,
+ * `generateStaticParams`, instrumentation and anywhere `headers()` is not
+ * available.
+ */
+declare function createBotlrFromEnv(overrides?: Partial<GetBotlrParams>): BotlrClient;
+
+/** Environment variables the helpers read. All server-side: the API URL is never exposed to the browser. */
+declare const BOTLR_ENV: {
+    readonly apiUrl: "BOTLR_API_URL";
+    readonly apiKey: "BOTLR_API_KEY";
+    readonly appId: "BOTLR_APP_ID";
+    readonly pat: "BOTLR_PAT";
+};
+declare const DEFAULT_API_URL = "http://localhost:8888";
+/**
+ * Client config from the environment, with `overrides` winning. Throws when
+ * no app id is known, since every Botlr request needs one.
+ */
+declare function configFromEnv(overrides?: Partial<BotlrClientConfig>): BotlrClientConfig;
+
+/** The first language of an `Accept-Language` value, or `fallback`. */
+declare function localeFromAcceptLanguage(header: string | null | undefined, fallback?: string): string;
+
+export { BOTLR_ENV, DEFAULT_API_URL, type GetBotlrParams, configFromEnv, createBotlrFromEnv, getBotlrForRoute, getCachedBotlr, localeFromAcceptLanguage };

package/dist/index.js

@@ -0,0 +1,75 @@
+// src/server.ts
+import { headers } from "next/headers";
+import { cache } from "react";
+import { createBotlrClient } from "@botlr/sdk";
+
+// src/env.ts
+var BOTLR_ENV = {
+  apiUrl: "BOTLR_API_URL",
+  apiKey: "BOTLR_API_KEY",
+  appId: "BOTLR_APP_ID",
+  pat: "BOTLR_PAT"
+};
+var DEFAULT_API_URL = "http://localhost:8888";
+function env(name) {
+  const value = typeof process !== "undefined" ? process.env?.[name] : void 0;
+  return value === "" ? void 0 : value;
+}
+function configFromEnv(overrides = {}) {
+  const appId = overrides.appId ?? env(BOTLR_ENV.appId);
+  if (!appId) {
+    throw new Error(`@botlr/next: pass appId or set ${BOTLR_ENV.appId}`);
+  }
+  return {
+    ...overrides,
+    baseUrl: overrides.baseUrl ?? env(BOTLR_ENV.apiUrl) ?? DEFAULT_API_URL,
+    appId,
+    apiKey: overrides.apiKey ?? env(BOTLR_ENV.apiKey),
+    personalToken: overrides.personalToken ?? env(BOTLR_ENV.pat)
+  };
+}
+
+// src/locale.ts
+function localeFromAcceptLanguage(header, fallback = "en") {
+  if (!header) return fallback;
+  const first = header.split(",")[0]?.split(";")[0]?.trim();
+  return first || fallback;
+}
+
+// src/server.ts
+async function getBotlrForRoute(params = {}) {
+  const h = await headers();
+  const locale = params.locale || localeFromAcceptLanguage(h.get("accept-language"));
+  return createBotlrClient(
+    configFromEnv({
+      appId: params.appId,
+      apiKey: params.apiKey,
+      baseUrl: params.baseUrl,
+      previewToken: params.previewToken,
+      locale,
+      preview: params.preview,
+      fetch: params.fetch
+    })
+  );
+}
+var getCachedBotlr = cache(getBotlrForRoute);
+function createBotlrFromEnv(overrides = {}) {
+  return createBotlrClient(configFromEnv(overrides));
+}
+
+// src/index.ts
+export * from "@botlr/react";
+import { BotlrError, BotlrConflictError, createBotlrClient as createBotlrClient2 } from "@botlr/sdk";
+export {
+  BOTLR_ENV,
+  BotlrConflictError,
+  BotlrError,
+  DEFAULT_API_URL,
+  configFromEnv,
+  createBotlrClient2 as createBotlrClient,
+  createBotlrFromEnv,
+  getBotlrForRoute,
+  getCachedBotlr,
+  localeFromAcceptLanguage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/env.ts","../src/locale.ts","../src/index.ts"],"sourcesContent":["import { headers } from \"next/headers\";\nimport { cache } from \"react\";\nimport { createBotlrClient, type BotlrClient } from \"@botlr/sdk\";\nimport { configFromEnv } from \"./env\";\nimport { localeFromAcceptLanguage } from \"./locale\";\n\nexport type GetBotlrParams = {\n  /** The app instance ID. Falls back to `BOTLR_APP_ID`. */\n  appId?: string;\n  /** Locale override; defaults to the request's `Accept-Language`, then `en`. */\n  locale?: string;\n  preview?: boolean;\n  /** Site token; falls back to `BOTLR_API_KEY`. Omit in dev mode. */\n  apiKey?: string;\n  /** Preview JWT, forwarded to `/api/resolve` in preview mode. */\n  previewToken?: string;\n  /** API origin; falls back to `BOTLR_API_URL`. */\n  baseUrl?: string;\n  fetch?: typeof fetch;\n};\n\n/**\n * A Botlr client for the current request, for Server Components, route\n * handlers and server actions. Reads the locale from `Accept-Language`\n * unless given.\n *\n * ```ts\n * const botlr = await getBotlrForRoute({ appId: scope.appInstanceId, locale: scope.locale, preview });\n * const pages = await botlr.getPageList({ tags: [\"news\"] });\n * ```\n */\nexport async function getBotlrForRoute(params: GetBotlrParams = {}): Promise<BotlrClient> {\n  const h = await headers();\n  const locale = params.locale || localeFromAcceptLanguage(h.get(\"accept-language\"));\n  return createBotlrClient(\n    configFromEnv({\n      appId: params.appId,\n      apiKey: params.apiKey,\n      baseUrl: params.baseUrl,\n      previewToken: params.previewToken,\n      locale,\n      preview: params.preview,\n      fetch: params.fetch,\n    }),\n  );\n}\n\n/**\n * `getBotlrForRoute` memoised per request with React `cache`, so several\n * components in one render share a client.\n */\nexport const getCachedBotlr: (params?: GetBotlrParams) => Promise<BotlrClient> = cache(getBotlrForRoute);\n\n/**\n * A client from the environment alone, with no request context. For scripts,\n * `generateStaticParams`, instrumentation and anywhere `headers()` is not\n * available.\n */\nexport function createBotlrFromEnv(overrides: Partial<GetBotlrParams> = {}): BotlrClient {\n  return createBotlrClient(configFromEnv(overrides));\n}\n","import type { BotlrClientConfig } from \"@botlr/sdk\";\n\n/** Environment variables the helpers read. All server-side: the API URL is never exposed to the browser. */\nexport const BOTLR_ENV = {\n  apiUrl: \"BOTLR_API_URL\",\n  apiKey: \"BOTLR_API_KEY\",\n  appId: \"BOTLR_APP_ID\",\n  pat: \"BOTLR_PAT\",\n} as const;\n\nexport const DEFAULT_API_URL = \"http://localhost:8888\";\n\nfunction env(name: string): string | undefined {\n  const value = typeof process !== \"undefined\" ? process.env?.[name] : undefined;\n  return value === \"\" ? undefined : value;\n}\n\n/**\n * Client config from the environment, with `overrides` winning. Throws when\n * no app id is known, since every Botlr request needs one.\n */\nexport function configFromEnv(overrides: Partial<BotlrClientConfig> = {}): BotlrClientConfig {\n  const appId = overrides.appId ?? env(BOTLR_ENV.appId);\n  if (!appId) {\n    throw new Error(`@botlr/next: pass appId or set ${BOTLR_ENV.appId}`);\n  }\n  return {\n    ...overrides,\n    baseUrl: overrides.baseUrl ?? env(BOTLR_ENV.apiUrl) ?? DEFAULT_API_URL,\n    appId,\n    apiKey: overrides.apiKey ?? env(BOTLR_ENV.apiKey),\n    personalToken: overrides.personalToken ?? env(BOTLR_ENV.pat),\n  };\n}\n","/** The first language of an `Accept-Language` value, or `fallback`. */\nexport function localeFromAcceptLanguage(header: string | null | undefined, fallback = \"en\"): string {\n  if (!header) return fallback;\n  const first = header.split(\",\")[0]?.split(\";\")[0]?.trim();\n  return first || fallback;\n}\n","export { getBotlrForRoute, getCachedBotlr, createBotlrFromEnv, type GetBotlrParams } from \"./server\";\nexport { configFromEnv, BOTLR_ENV, DEFAULT_API_URL } from \"./env\";\nexport { localeFromAcceptLanguage } from \"./locale\";\n\nexport * from \"@botlr/react\";\nexport type * from \"@botlr/sdk\";\nexport { BotlrError, BotlrConflictError, createBotlrClient } from \"@botlr/sdk\";\n"],"mappings":";AAAA,SAAS,eAAe;AACxB,SAAS,aAAa;AACtB,SAAS,yBAA2C;;;ACC7C,IAAM,YAAY;AAAA,EACvB,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,KAAK;AACP;AAEO,IAAM,kBAAkB;AAE/B,SAAS,IAAI,MAAkC;AAC7C,QAAM,QAAQ,OAAO,YAAY,cAAc,QAAQ,MAAM,IAAI,IAAI;AACrE,SAAO,UAAU,KAAK,SAAY;AACpC;AAMO,SAAS,cAAc,YAAwC,CAAC,GAAsB;AAC3F,QAAM,QAAQ,UAAU,SAAS,IAAI,UAAU,KAAK;AACpD,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,kCAAkC,UAAU,KAAK,EAAE;AAAA,EACrE;AACA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,UAAU,WAAW,IAAI,UAAU,MAAM,KAAK;AAAA,IACvD;AAAA,IACA,QAAQ,UAAU,UAAU,IAAI,UAAU,MAAM;AAAA,IAChD,eAAe,UAAU,iBAAiB,IAAI,UAAU,GAAG;AAAA,EAC7D;AACF;;;AChCO,SAAS,yBAAyB,QAAmC,WAAW,MAAc;AACnG,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,QAAQ,OAAO,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,GAAG,EAAE,CAAC,GAAG,KAAK;AACxD,SAAO,SAAS;AAClB;;;AF0BA,eAAsB,iBAAiB,SAAyB,CAAC,GAAyB;AACxF,QAAM,IAAI,MAAM,QAAQ;AACxB,QAAM,SAAS,OAAO,UAAU,yBAAyB,EAAE,IAAI,iBAAiB,CAAC;AACjF,SAAO;AAAA,IACL,cAAc;AAAA,MACZ,OAAO,OAAO;AAAA,MACd,QAAQ,OAAO;AAAA,MACf,SAAS,OAAO;AAAA,MAChB,cAAc,OAAO;AAAA,MACrB;AAAA,MACA,SAAS,OAAO;AAAA,MAChB,OAAO,OAAO;AAAA,IAChB,CAAC;AAAA,EACH;AACF;AAMO,IAAM,iBAAoE,MAAM,gBAAgB;AAOhG,SAAS,mBAAmB,YAAqC,CAAC,GAAgB;AACvF,SAAO,kBAAkB,cAAc,SAAS,CAAC;AACnD;;;AGxDA,cAAc;AAEd,SAAS,YAAY,oBAAoB,qBAAAA,0BAAyB;","names":["createBotlrClient"]}

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "@botlr/next",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Next.js helpers for Botlr: per-request clients from headers and env, on top of @botlr/sdk and @botlr/react.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/botlr-io/botlr.git",
+    "directory": "packages/next"
+  },
+  "homepage": "https://github.com/botlr-io/botlr/tree/main/packages/next#readme",
+  "keywords": [
+    "botlr",
+    "cms",
+    "nextjs",
+    "react"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@botlr/react": "^0.1.0",
+    "@botlr/sdk": "^0.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=14",
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.0",
+    "next": "16.2.9",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "tsup": "^8.5.0",
+    "typescript": "~5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
 }