@fewchurs/next 0.0.0-stage → 1.0.1

package/dist/handler.d.ts

@@ -0,0 +1,28 @@
+import { DeviceIdResolver } from './identity.js';
+import '@fewchurs/react/core';
+
+interface HandlerOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    /** Where the handler is mounted, when it is not `/api/fewchurs`. */
+    apiPath?: string;
+    /** Return a stable, hashed id for the signed-in visitor so votes follow the account. */
+    deviceId?: DeviceIdResolver;
+}
+type RouteParams = {
+    route?: string[];
+};
+type RouteContext = {
+    params: Promise<RouteParams>;
+};
+type RouteHandler = (request: Request, context: RouteContext) => Promise<Response>;
+declare function createHandler(options?: HandlerOptions): {
+    GET: RouteHandler;
+    POST: RouteHandler;
+    DELETE: RouteHandler;
+};
+declare const GET: RouteHandler;
+declare const POST: RouteHandler;
+declare const DELETE: RouteHandler;
+
+export { DELETE, GET, type HandlerOptions, POST, type RouteHandler, createHandler };

package/dist/handler.js

@@ -0,0 +1,157 @@
+"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/handler.ts
+var handler_exports = {};
+__export(handler_exports, {
+  DELETE: () => DELETE,
+  GET: () => GET,
+  POST: () => POST,
+  createHandler: () => createHandler
+});
+module.exports = __toCommonJS(handler_exports);
+var import_server_only2 = require("server-only");
+var import_core2 = require("@fewchurs/react/core");
+
+// src/config.ts
+var import_server_only = require("server-only");
+var import_core = require("@fewchurs/react/core");
+var DEFAULT_API_PATH = "/api/fewchurs";
+function resolveApiKey(apiKey) {
+  return apiKey ?? process.env.FEWCHURS_API_KEY;
+}
+function resolveBaseUrl(baseUrl) {
+  return baseUrl ?? process.env.FEWCHURS_BASE_URL ?? import_core.DEFAULT_BASE_URL;
+}
+function resolveApiPath(apiPath) {
+  return (apiPath ?? process.env.FEWCHURS_API_PATH ?? DEFAULT_API_PATH).replace(/\/$/, "");
+}
+
+// src/version.ts
+var SDK_VERSION = "1.0.1";
+
+// src/constants.ts
+var DEVICE_ID_COOKIE = "fewchurs_did";
+var DEVICE_ID_MAX_AGE = 60 * 60 * 24 * 365;
+var SDK_HEADER = `next/${SDK_VERSION}`;
+
+// src/handler.ts
+var ALLOWED = [
+  { method: "GET", pattern: /^config$/ },
+  { method: "GET", pattern: /^features$/ },
+  { method: "POST", pattern: /^features$/ },
+  { method: "GET", pattern: /^features\/[^/]+$/ },
+  { method: "POST", pattern: /^features\/[^/]+\/vote$/ },
+  { method: "DELETE", pattern: /^features\/[^/]+\/vote$/ },
+  { method: "POST", pattern: /^features\/[^/]+\/follow$/ },
+  { method: "DELETE", pattern: /^features\/[^/]+\/follow$/ },
+  { method: "GET", pattern: /^features\/[^/]+\/comments$/ },
+  { method: "POST", pattern: /^comments$/ }
+];
+var DEVICE_ID_PATTERN = /^[A-Za-z0-9_-]{8,128}$/;
+function createHandler(options = {}) {
+  async function handle(request, context) {
+    const path = await routePath(request, context, resolveApiPath(options.apiPath));
+    if (!ALLOWED.some((route) => route.method === request.method && route.pattern.test(path))) {
+      return json({ error: { code: "not_found", message: "Unknown Fewchurs route." } }, 404);
+    }
+    const apiKey = resolveApiKey(options.apiKey);
+    if (!apiKey) {
+      console.error(
+        "[fewchurs] No API key. Set FEWCHURS_API_KEY, or pass apiKey to createHandler()."
+      );
+      return json({ error: { code: "internal", message: "Fewchurs is not configured." } }, 500);
+    }
+    const cookieValue = readCookie(request, DEVICE_ID_COOKIE);
+    const custom = options.deviceId ? await options.deviceId() : null;
+    const deviceId = custom ?? cookieValue ?? claimedDeviceId(request) ?? (0, import_core2.createDeviceId)();
+    const target = `${resolveBaseUrl(options.baseUrl)}/${path}${new URL(request.url).search}`;
+    const headers = {
+      Authorization: `Bearer ${apiKey}`,
+      "X-Device-Id": deviceId,
+      "X-Fewchurs-Sdk": request.headers.get("x-fewchurs-sdk") ?? SDK_HEADER,
+      Accept: "application/json"
+    };
+    const language = request.headers.get("accept-language");
+    if (language) headers["Accept-Language"] = language;
+    const body = request.method === "GET" ? void 0 : await request.text();
+    if (body) headers["Content-Type"] = "application/json";
+    let upstream;
+    try {
+      upstream = await fetch(target, { method: request.method, headers, body, cache: "no-store" });
+    } catch {
+      return json({ error: { code: "internal", message: "Could not reach Fewchurs." } }, 502);
+    }
+    const response = new Response(await upstream.text(), {
+      status: upstream.status,
+      headers: { "Content-Type": "application/json", "Cache-Control": "no-store" }
+    });
+    if (!custom && deviceId !== cookieValue) {
+      response.headers.append("Set-Cookie", serializeCookie(deviceId));
+    }
+    return response;
+  }
+  return { GET: handle, POST: handle, DELETE: handle };
+}
+var defaultHandler = createHandler();
+var GET = defaultHandler.GET;
+var POST = defaultHandler.POST;
+var DELETE = defaultHandler.DELETE;
+async function routePath(request, context, apiPath) {
+  const params = await context?.params;
+  if (params?.route?.length) return params.route.map(encodeURIComponent).join("/");
+  const { pathname } = new URL(request.url);
+  const index = pathname.indexOf(apiPath);
+  return index === -1 ? "" : pathname.slice(index + apiPath.length).replace(/^\//, "");
+}
+function claimedDeviceId(request) {
+  const claimed = request.headers.get("x-device-id");
+  return claimed && DEVICE_ID_PATTERN.test(claimed) ? claimed : null;
+}
+function readCookie(request, name) {
+  const header = request.headers.get("cookie");
+  if (!header) return null;
+  const match = header.match(new RegExp(`(?:^|;\\s*)${name}=([^;]*)`));
+  return match?.[1] ? decodeURIComponent(match[1]) : null;
+}
+function serializeCookie(deviceId) {
+  const parts = [
+    `${DEVICE_ID_COOKIE}=${encodeURIComponent(deviceId)}`,
+    "Path=/",
+    `Max-Age=${DEVICE_ID_MAX_AGE}`,
+    "HttpOnly",
+    "SameSite=Lax"
+  ];
+  if (process.env.NODE_ENV === "production") parts.push("Secure");
+  return parts.join("; ");
+}
+function json(body, status) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { "Content-Type": "application/json", "Cache-Control": "no-store" }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DELETE,
+  GET,
+  POST,
+  createHandler
+});
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/handler.ts","../src/config.ts","../src/version.ts","../src/constants.ts"],"sourcesContent":["import \"server-only\";\nimport { createDeviceId } from \"@fewchurs/react/core\";\nimport { resolveApiKey, resolveApiPath, resolveBaseUrl } from \"./config\";\nimport { DEVICE_ID_COOKIE, DEVICE_ID_MAX_AGE, SDK_HEADER } from \"./constants\";\nimport type { DeviceIdResolver } from \"./identity\";\n\nexport interface HandlerOptions {\n  apiKey?: string;\n  baseUrl?: string;\n  /** Where the handler is mounted, when it is not `/api/fewchurs`. */\n  apiPath?: string;\n  /** Return a stable, hashed id for the signed-in visitor so votes follow the account. */\n  deviceId?: DeviceIdResolver;\n}\n\ntype RouteParams = { route?: string[] };\n\n/** What Next passes: a Promise in 15, a plain object in 14. Both are awaited the same way. */\ntype IncomingContext = { params?: RouteParams | Promise<RouteParams> };\n\n// Next 15's route check wants a required second argument whose `params` is a Promise. The\n// handler itself takes `IncomingContext`, so Next 14's plain object still works at runtime.\ntype RouteContext = { params: Promise<RouteParams> };\n\nexport type RouteHandler = (request: Request, context: RouteContext) => Promise<Response>;\n\n/** Only the endpoints the board needs: everything else is a 404, not a proxy to the API. */\nconst ALLOWED: Array<{ method: string; pattern: RegExp }> = [\n  { method: \"GET\", pattern: /^config$/ },\n  { method: \"GET\", pattern: /^features$/ },\n  { method: \"POST\", pattern: /^features$/ },\n  { method: \"GET\", pattern: /^features\\/[^/]+$/ },\n  { method: \"POST\", pattern: /^features\\/[^/]+\\/vote$/ },\n  { method: \"DELETE\", pattern: /^features\\/[^/]+\\/vote$/ },\n  { method: \"POST\", pattern: /^features\\/[^/]+\\/follow$/ },\n  { method: \"DELETE\", pattern: /^features\\/[^/]+\\/follow$/ },\n  { method: \"GET\", pattern: /^features\\/[^/]+\\/comments$/ },\n  { method: \"POST\", pattern: /^comments$/ },\n];\n\nconst DEVICE_ID_PATTERN = /^[A-Za-z0-9_-]{8,128}$/;\n\nexport function createHandler(options: HandlerOptions = {}): {\n  GET: RouteHandler;\n  POST: RouteHandler;\n  DELETE: RouteHandler;\n} {\n  async function handle(request: Request, context?: IncomingContext): Promise<Response> {\n    const path = await routePath(request, context, resolveApiPath(options.apiPath));\n\n    if (!ALLOWED.some((route) => route.method === request.method && route.pattern.test(path))) {\n      return json({ error: { code: \"not_found\", message: \"Unknown Fewchurs route.\" } }, 404);\n    }\n\n    const apiKey = resolveApiKey(options.apiKey);\n    if (!apiKey) {\n      console.error(\n        \"[fewchurs] No API key. Set FEWCHURS_API_KEY, or pass apiKey to createHandler().\",\n      );\n      return json({ error: { code: \"internal\", message: \"Fewchurs is not configured.\" } }, 500);\n    }\n\n    const cookieValue = readCookie(request, DEVICE_ID_COOKIE);\n    const custom = options.deviceId ? await options.deviceId() : null;\n    const deviceId = custom ?? cookieValue ?? claimedDeviceId(request) ?? createDeviceId();\n\n    const target = `${resolveBaseUrl(options.baseUrl)}/${path}${new URL(request.url).search}`;\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${apiKey}`,\n      \"X-Device-Id\": deviceId,\n      \"X-Fewchurs-Sdk\": request.headers.get(\"x-fewchurs-sdk\") ?? SDK_HEADER,\n      Accept: \"application/json\",\n    };\n    const language = request.headers.get(\"accept-language\");\n    if (language) headers[\"Accept-Language\"] = language;\n\n    const body = request.method === \"GET\" ? undefined : await request.text();\n    if (body) headers[\"Content-Type\"] = \"application/json\";\n\n    let upstream: Response;\n    try {\n      upstream = await fetch(target, { method: request.method, headers, body, cache: \"no-store\" });\n    } catch {\n      return json({ error: { code: \"internal\", message: \"Could not reach Fewchurs.\" } }, 502);\n    }\n\n    const response = new Response(await upstream.text(), {\n      status: upstream.status,\n      headers: { \"Content-Type\": \"application/json\", \"Cache-Control\": \"no-store\" },\n    });\n\n    // A visitor keeps the same id across requests without the browser ever seeing the key,\n    // and an httpOnly cookie means page scripts cannot read or change it either.\n    if (!custom && deviceId !== cookieValue) {\n      response.headers.append(\"Set-Cookie\", serializeCookie(deviceId));\n    }\n\n    return response;\n  }\n\n  return { GET: handle, POST: handle, DELETE: handle };\n}\n\nconst defaultHandler = createHandler();\n\nexport const GET = defaultHandler.GET;\nexport const POST = defaultHandler.POST;\nexport const DELETE = defaultHandler.DELETE;\n\nasync function routePath(\n  request: Request,\n  context: IncomingContext | undefined,\n  apiPath: string,\n): Promise<string> {\n  const params = await context?.params;\n  if (params?.route?.length) return params.route.map(encodeURIComponent).join(\"/\");\n\n  const { pathname } = new URL(request.url);\n  const index = pathname.indexOf(apiPath);\n  return index === -1 ? \"\" : pathname.slice(index + apiPath.length).replace(/^\\//, \"\");\n}\n\n/**\n * The first request from a server-rendered board carries the id the page was rendered with,\n * so adopting it keeps the server's `hasVoted` answers and the browser's in agreement.\n */\nfunction claimedDeviceId(request: Request): string | null {\n  const claimed = request.headers.get(\"x-device-id\");\n  return claimed && DEVICE_ID_PATTERN.test(claimed) ? claimed : null;\n}\n\nfunction readCookie(request: Request, name: string): string | null {\n  const header = request.headers.get(\"cookie\");\n  if (!header) return null;\n  const match = header.match(new RegExp(`(?:^|;\\\\s*)${name}=([^;]*)`));\n  return match?.[1] ? decodeURIComponent(match[1]) : null;\n}\n\nfunction serializeCookie(deviceId: string): string {\n  const parts = [\n    `${DEVICE_ID_COOKIE}=${encodeURIComponent(deviceId)}`,\n    \"Path=/\",\n    `Max-Age=${DEVICE_ID_MAX_AGE}`,\n    \"HttpOnly\",\n    \"SameSite=Lax\",\n  ];\n  if (process.env.NODE_ENV === \"production\") parts.push(\"Secure\");\n  return parts.join(\"; \");\n}\n\nfunction json(body: unknown, status: number): Response {\n  return new Response(JSON.stringify(body), {\n    status,\n    headers: { \"Content-Type\": \"application/json\", \"Cache-Control\": \"no-store\" },\n  });\n}\n","import \"server-only\";\nimport { createFewchursClient, DEFAULT_BASE_URL, type FewchursClient } from \"@fewchurs/react/core\";\n\nexport const DEFAULT_API_PATH = \"/api/fewchurs\";\n\nexport interface ServerConfig {\n  apiKey?: string;\n  baseUrl?: string;\n  language?: string;\n}\n\nexport function resolveApiKey(apiKey?: string): string | undefined {\n  return apiKey ?? process.env.FEWCHURS_API_KEY;\n}\n\nexport function resolveBaseUrl(baseUrl?: string): string {\n  return baseUrl ?? process.env.FEWCHURS_BASE_URL ?? DEFAULT_BASE_URL;\n}\n\nexport function resolveApiPath(apiPath?: string): string {\n  return (apiPath ?? process.env.FEWCHURS_API_PATH ?? DEFAULT_API_PATH).replace(/\\/$/, \"\");\n}\n\nexport function serverClient(deviceId: string | null, config: ServerConfig = {}): FewchursClient {\n  const apiKey = resolveApiKey(config.apiKey);\n  if (!apiKey) {\n    throw new Error(\n      \"[fewchurs] No API key. Set FEWCHURS_API_KEY in your environment, or pass apiKey to the server component or createHandler().\",\n    );\n  }\n\n  return createFewchursClient({\n    apiKey,\n    baseUrl: resolveBaseUrl(config.baseUrl),\n    deviceId,\n    language: config.language,\n  });\n}\n","// Generated by tools/stamp-version.mjs from @fewchurs/next's package.json. Do not edit by hand.\nexport const SDK_VERSION = \"1.0.1\";\n","import { SDK_VERSION } from \"./version\";\n\nexport const DEVICE_ID_COOKIE = \"fewchurs_did\";\nexport const DEVICE_ID_MAX_AGE = 60 * 60 * 24 * 365;\nexport { SDK_VERSION };\nexport const SDK_HEADER = `next/${SDK_VERSION}`;\n"],"mappings":"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","names":["import_server_only","import_core"]}

package/dist/handler.mjs

@@ -0,0 +1,14 @@
+import {
+  DELETE,
+  GET,
+  POST,
+  createHandler
+} from "./chunk-KPJHLDQU.mjs";
+import "./chunk-W6QR6DEB.mjs";
+export {
+  DELETE,
+  GET,
+  POST,
+  createHandler
+};
+//# sourceMappingURL=handler.mjs.map

package/dist/handler.mjs.map

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

package/dist/identity.d.mts

@@ -0,0 +1,26 @@
+export { createDeviceId } from '@fewchurs/react/core';
+
+declare const DEVICE_ID_COOKIE = "fewchurs_did";
+declare const DEVICE_ID_MAX_AGE: number;
+
+type DeviceIdResolver = () => string | Promise<string>;
+/** The visitor's id, or null when nothing has been stored for them yet. */
+declare function readDeviceId(): Promise<string | null>;
+/**
+ * Reads the cookie, falling back to a fresh id. The value is not persisted here: a server
+ * component cannot set cookies, so the route handler stores it on the first request instead.
+ */
+declare function resolveDeviceId(custom?: DeviceIdResolver): Promise<string>;
+declare function deviceIdCookie(deviceId: string): {
+    name: string;
+    value: string;
+    options: {
+        httpOnly: true;
+        sameSite: "lax";
+        path: string;
+        maxAge: number;
+        secure: boolean;
+    };
+};
+
+export { DEVICE_ID_COOKIE, DEVICE_ID_MAX_AGE, type DeviceIdResolver, deviceIdCookie, readDeviceId, resolveDeviceId };

package/dist/identity.d.ts

@@ -0,0 +1,26 @@
+export { createDeviceId } from '@fewchurs/react/core';
+
+declare const DEVICE_ID_COOKIE = "fewchurs_did";
+declare const DEVICE_ID_MAX_AGE: number;
+
+type DeviceIdResolver = () => string | Promise<string>;
+/** The visitor's id, or null when nothing has been stored for them yet. */
+declare function readDeviceId(): Promise<string | null>;
+/**
+ * Reads the cookie, falling back to a fresh id. The value is not persisted here: a server
+ * component cannot set cookies, so the route handler stores it on the first request instead.
+ */
+declare function resolveDeviceId(custom?: DeviceIdResolver): Promise<string>;
+declare function deviceIdCookie(deviceId: string): {
+    name: string;
+    value: string;
+    options: {
+        httpOnly: true;
+        sameSite: "lax";
+        path: string;
+        maxAge: number;
+        secure: boolean;
+    };
+};
+
+export { DEVICE_ID_COOKIE, DEVICE_ID_MAX_AGE, type DeviceIdResolver, deviceIdCookie, readDeviceId, resolveDeviceId };

package/dist/identity.js

@@ -0,0 +1,74 @@
+"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/identity.ts
+var identity_exports = {};
+__export(identity_exports, {
+  DEVICE_ID_COOKIE: () => DEVICE_ID_COOKIE,
+  DEVICE_ID_MAX_AGE: () => DEVICE_ID_MAX_AGE,
+  createDeviceId: () => import_core.createDeviceId,
+  deviceIdCookie: () => deviceIdCookie,
+  readDeviceId: () => readDeviceId,
+  resolveDeviceId: () => resolveDeviceId
+});
+module.exports = __toCommonJS(identity_exports);
+var import_server_only = require("server-only");
+var import_headers = require("next/headers");
+var import_core = require("@fewchurs/react/core");
+
+// src/version.ts
+var SDK_VERSION = "1.0.1";
+
+// src/constants.ts
+var DEVICE_ID_COOKIE = "fewchurs_did";
+var DEVICE_ID_MAX_AGE = 60 * 60 * 24 * 365;
+var SDK_HEADER = `next/${SDK_VERSION}`;
+
+// src/identity.ts
+async function readDeviceId() {
+  const store = await (0, import_headers.cookies)();
+  return store.get(DEVICE_ID_COOKIE)?.value ?? null;
+}
+async function resolveDeviceId(custom) {
+  if (custom) return custom();
+  return await readDeviceId() ?? (0, import_core.createDeviceId)();
+}
+function deviceIdCookie(deviceId) {
+  return {
+    name: DEVICE_ID_COOKIE,
+    value: deviceId,
+    options: {
+      httpOnly: true,
+      sameSite: "lax",
+      path: "/",
+      maxAge: DEVICE_ID_MAX_AGE,
+      secure: process.env.NODE_ENV === "production"
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEVICE_ID_COOKIE,
+  DEVICE_ID_MAX_AGE,
+  createDeviceId,
+  deviceIdCookie,
+  readDeviceId,
+  resolveDeviceId
+});
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/identity.ts","../src/version.ts","../src/constants.ts"],"sourcesContent":["import \"server-only\";\nimport { cookies } from \"next/headers\";\nimport { createDeviceId } from \"@fewchurs/react/core\";\nimport { DEVICE_ID_COOKIE, DEVICE_ID_MAX_AGE } from \"./constants\";\n\nexport { DEVICE_ID_COOKIE, DEVICE_ID_MAX_AGE };\n\nexport type DeviceIdResolver = () => string | Promise<string>;\n\n/** The visitor's id, or null when nothing has been stored for them yet. */\nexport async function readDeviceId(): Promise<string | null> {\n  const store = await cookies();\n  return store.get(DEVICE_ID_COOKIE)?.value ?? null;\n}\n\n/**\n * Reads the cookie, falling back to a fresh id. The value is not persisted here: a server\n * component cannot set cookies, so the route handler stores it on the first request instead.\n */\nexport async function resolveDeviceId(custom?: DeviceIdResolver): Promise<string> {\n  if (custom) return custom();\n  return (await readDeviceId()) ?? createDeviceId();\n}\n\nexport function deviceIdCookie(deviceId: string): {\n  name: string;\n  value: string;\n  options: {\n    httpOnly: true;\n    sameSite: \"lax\";\n    path: string;\n    maxAge: number;\n    secure: boolean;\n  };\n} {\n  return {\n    name: DEVICE_ID_COOKIE,\n    value: deviceId,\n    options: {\n      httpOnly: true,\n      sameSite: \"lax\",\n      path: \"/\",\n      maxAge: DEVICE_ID_MAX_AGE,\n      secure: process.env.NODE_ENV === \"production\",\n    },\n  };\n}\n\nexport { createDeviceId };\n","// Generated by tools/stamp-version.mjs from @fewchurs/next's package.json. Do not edit by hand.\nexport const SDK_VERSION = \"1.0.1\";\n","import { SDK_VERSION } from \"./version\";\n\nexport const DEVICE_ID_COOKIE = \"fewchurs_did\";\nexport const DEVICE_ID_MAX_AGE = 60 * 60 * 24 * 365;\nexport { SDK_VERSION };\nexport const SDK_HEADER = `next/${SDK_VERSION}`;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAO;AACP,qBAAwB;AACxB,kBAA+B;;;ACDxB,IAAM,cAAc;;;ACCpB,IAAM,mBAAmB;AACzB,IAAM,oBAAoB,KAAK,KAAK,KAAK;AAEzC,IAAM,aAAa,QAAQ,WAAW;;;AFK7C,eAAsB,eAAuC;AAC3D,QAAM,QAAQ,UAAM,wBAAQ;AAC5B,SAAO,MAAM,IAAI,gBAAgB,GAAG,SAAS;AAC/C;AAMA,eAAsB,gBAAgB,QAA4C;AAChF,MAAI,OAAQ,QAAO,OAAO;AAC1B,SAAQ,MAAM,aAAa,SAAM,4BAAe;AAClD;AAEO,SAAS,eAAe,UAU7B;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SAAS;AAAA,MACP,UAAU;AAAA,MACV,UAAU;AAAA,MACV,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,QAAQ,QAAQ,IAAI,aAAa;AAAA,IACnC;AAAA,EACF;AACF;","names":[]}

package/dist/identity.mjs

@@ -0,0 +1,19 @@
+import {
+  createDeviceId,
+  deviceIdCookie,
+  readDeviceId,
+  resolveDeviceId
+} from "./chunk-QULKPZB4.mjs";
+import {
+  DEVICE_ID_COOKIE,
+  DEVICE_ID_MAX_AGE
+} from "./chunk-W6QR6DEB.mjs";
+export {
+  DEVICE_ID_COOKIE,
+  DEVICE_ID_MAX_AGE,
+  createDeviceId,
+  deviceIdCookie,
+  readDeviceId,
+  resolveDeviceId
+};
+//# sourceMappingURL=identity.mjs.map

package/dist/identity.mjs.map

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

package/dist/index.d.mts

@@ -0,0 +1,27 @@
+import { FewchursBoardProps as FewchursBoardProps$1 } from '@fewchurs/react';
+import { DeviceIdResolver } from './identity.mjs';
+export { DEVICE_ID_COOKIE, readDeviceId, resolveDeviceId } from './identity.mjs';
+export { HandlerOptions, RouteHandler, createHandler } from './handler.mjs';
+export { Comment, CommentPage, Feature, FeaturePage, FeatureSort, FeatureStatus, FewchursConfig, FewchursError } from '@fewchurs/react/core';
+
+/** Function props cannot cross the server/client boundary — compose in your own client file. */
+type SerializableBoardProps = Omit<FewchursBoardProps$1, "renderHeader" | "renderEmpty" | "renderFeature" | "children">;
+interface FewchursBoardProps extends SerializableBoardProps {
+    /** Defaults to `process.env.FEWCHURS_API_KEY`. Never reaches the browser. */
+    apiKey?: string;
+    baseUrl?: string;
+    /** Where your route handler is mounted. Defaults to `/api/fewchurs`. */
+    apiPath?: string;
+    language?: string;
+    deviceId?: DeviceIdResolver;
+}
+declare function FewchursBoard({ apiKey, baseUrl, apiPath, language, deviceId: deviceIdOption, ...board }: FewchursBoardProps): Promise<React.JSX.Element>;
+
+declare const DEFAULT_API_PATH = "/api/fewchurs";
+interface ServerConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    language?: string;
+}
+
+export { DEFAULT_API_PATH, DeviceIdResolver, FewchursBoard, type FewchursBoardProps, type ServerConfig };

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { FewchursBoardProps as FewchursBoardProps$1 } from '@fewchurs/react';
+import { DeviceIdResolver } from './identity.js';
+export { DEVICE_ID_COOKIE, readDeviceId, resolveDeviceId } from './identity.js';
+export { HandlerOptions, RouteHandler, createHandler } from './handler.js';
+export { Comment, CommentPage, Feature, FeaturePage, FeatureSort, FeatureStatus, FewchursConfig, FewchursError } from '@fewchurs/react/core';
+
+/** Function props cannot cross the server/client boundary — compose in your own client file. */
+type SerializableBoardProps = Omit<FewchursBoardProps$1, "renderHeader" | "renderEmpty" | "renderFeature" | "children">;
+interface FewchursBoardProps extends SerializableBoardProps {
+    /** Defaults to `process.env.FEWCHURS_API_KEY`. Never reaches the browser. */
+    apiKey?: string;
+    baseUrl?: string;
+    /** Where your route handler is mounted. Defaults to `/api/fewchurs`. */
+    apiPath?: string;
+    language?: string;
+    deviceId?: DeviceIdResolver;
+}
+declare function FewchursBoard({ apiKey, baseUrl, apiPath, language, deviceId: deviceIdOption, ...board }: FewchursBoardProps): Promise<React.JSX.Element>;
+
+declare const DEFAULT_API_PATH = "/api/fewchurs";
+interface ServerConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    language?: string;
+}
+
+export { DEFAULT_API_PATH, DeviceIdResolver, FewchursBoard, type FewchursBoardProps, type ServerConfig };