@smalk/nextjs-ads 0.1.0 → 1.2.0

package/dist/chunk-4QWOGJYF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/freshness/route.ts","../src/freshness/activeUrlsStore.ts","../src/freshness/activeUrlsCache.ts","../src/freshness/middleware.ts","../src/index.ts"],"sourcesContent":["export interface SmalkConfig {\n    /** Full API base including version path, e.g. https://api.smalk.ai/api/v1 */\n    apiBase: string;\n    apiKey: string;\n    projectKey: string;\n    cronSecret: string;\n    pluginVersion: string;\n    publicHost?: string;\n}\n\n/**\n * Backwards-compatible config shape for legacy callers (pre-P2). Adds an\n * `apiBaseUrl` alias for `apiBase`. New code should use `getSmalkConfig()`\n * and read `apiBase` directly.\n */\nexport interface LegacySmalkConfig extends SmalkConfig {\n    /**\n     * @deprecated Use `apiBase` instead.\n     *\n     * Pre-P2.5 shape: host-only (e.g. `https://api.smalk.ai`), and external\n     * publisher code appended `/api/v1/...`. To preserve that shape after the\n     * P2.5 Next config unify (which moved `/api/v1` into the canonical\n     * `apiBase`), this field strips a trailing `/api/vN` segment from\n     * `apiBase` before exposing it. New code should read `apiBase` directly.\n     */\n    apiBaseUrl: string;\n}\n\nconst DEFAULT_API_BASE = \"https://api.smalk.ai/api/v1\";\nconst PLUGIN_VERSION = \"1.1.0\";\n\nexport function getSmalkConfig(): SmalkConfig {\n    const apiBase = process.env.SMALK_API_BASE || process.env.SMALK_API_BASE_URL || DEFAULT_API_BASE;\n    const apiKey = process.env.SMALK_API_KEY ?? \"\";\n    const projectKey = process.env.SMALK_PROJECT_KEY ?? \"\";\n    const cronSecret = process.env.SMALK_CRON_SECRET ?? \"\";\n    const publicHost = process.env.SMALK_PUBLIC_HOST || undefined;\n\n    return {\n        apiBase,\n        apiKey,\n        projectKey,\n        cronSecret,\n        pluginVersion: PLUGIN_VERSION,\n        publicHost,\n    };\n}\n\n/**\n * Strip a trailing `/api/vN` (or `/api/vN/`) segment from an API base URL.\n * Preserves backward compatibility with publishers building URLs like\n * `${apiBaseUrl}/api/v1/...` — without stripping, those would double-prefix\n * to `/api/v1/api/v1/...` and 404.\n */\nfunction stripApiPathSuffix(apiBase: string): string {\n    return apiBase.replace(/\\/api\\/v\\d+\\/?$/, \"\");\n}\n\n/**\n * Legacy loader retained for external consumers (publisher apps) that import\n * `loadConfig` from `@smalk/nextjs-ads`. Returns the canonical `SmalkConfig`\n * plus an `apiBaseUrl` alias whose shape matches the pre-P2.5 contract\n * (host-only, no `/api/v1` suffix). New code should prefer `getSmalkConfig()`\n * and read `apiBase` directly.\n */\nexport function loadConfig(): LegacySmalkConfig {\n    const cfg = getSmalkConfig();\n    return { ...cfg, apiBaseUrl: stripApiPathSuffix(cfg.apiBase) };\n}\n","import { revalidatePath } from \"next/cache\";\nimport { NextRequest, NextResponse } from \"next/server\";\n\nimport { getSmalkConfig } from \"../config\";\nimport { cacheActiveUrls } from \"./activeUrlsCache\";\n\nexport async function smalkFreshnessRevalidateHandler(req: NextRequest) {\n    const cfg = getSmalkConfig();\n    const secret = req.headers.get(\"x-smalk-cron-secret\");\n    if (!secret || secret !== cfg.cronSecret) {\n        return NextResponse.json({ error: \"unauthorized\" }, { status: 401 });\n    }\n\n    const endpoint = `${cfg.apiBase}/projects/${cfg.projectKey}/ads/inventory/active-ad-urls/`;\n    const resp = await fetch(endpoint, {\n        headers: {\n            \"X-API-Key\": cfg.apiKey,\n            \"X-Smalk-CMS\": \"nextjs\",\n            \"X-Smalk-Plugin\": cfg.pluginVersion,\n        },\n        cache: \"no-store\",\n    });\n    if (!resp.ok) {\n        return NextResponse.json({ error: `api ${resp.status}` }, { status: 502 });\n    }\n    const payload = (await resp.json()) as { urls: { url: string }[] };\n    const paths = payload.urls\n        .map((u) => safePath(u.url, cfg.publicHost))\n        .filter((p): p is string => Boolean(p));\n\n    await cacheActiveUrls(paths);\n\n    let revalidated = 0;\n    for (const p of paths) {\n        try {\n            revalidatePath(p);\n            revalidated++;\n        } catch (e) {\n            console.warn(`[smalk] revalidatePath failed for ${p}`, e);\n        }\n    }\n\n    return NextResponse.json({\n        ok: true,\n        total: paths.length,\n        revalidated,\n        ran_at: new Date().toISOString(),\n    });\n}\n\nfunction safePath(url: string, publicHost?: string): string | null {\n    try {\n        const u = new URL(url);\n        if (publicHost && u.host !== publicHost) return null;\n        return u.pathname;\n    } catch {\n        return null;\n    }\n}\n","export interface ActiveUrlsCachedPayload {\n    paths: string[];\n    updated_at: number;\n}\n\nexport interface ActiveUrlsStore {\n    read(): Promise<ActiveUrlsCachedPayload | null>;\n    write(payload: ActiveUrlsCachedPayload): Promise<void>;\n}\n\n// In-memory store (per-process, fast, lost on restart — good for tests).\nexport class InMemoryActiveUrlsStore implements ActiveUrlsStore {\n    private value: ActiveUrlsCachedPayload | null = null;\n    async read() { return this.value; }\n    async write(payload: ActiveUrlsCachedPayload) { this.value = payload; }\n}\n\n// Filesystem fallback — uses os.tmpdir() (current behavior, kept for Node dev).\nexport class FilesystemActiveUrlsStore implements ActiveUrlsStore {\n    constructor(private filePath?: string) {}\n    async read(): Promise<ActiveUrlsCachedPayload | null> {\n        const fs = await import(\"node:fs/promises\");\n        const path = await import(\"node:path\");\n        const os = await import(\"node:os\");\n        const f = this.filePath || path.join(os.tmpdir(), \"smalk-active-ad-paths.json\");\n        try {\n            return JSON.parse(await fs.readFile(f, \"utf8\"));\n        } catch {\n            return null;\n        }\n    }\n    async write(payload: ActiveUrlsCachedPayload) {\n        const fs = await import(\"node:fs/promises\");\n        const path = await import(\"node:path\");\n        const os = await import(\"node:os\");\n        const f = this.filePath || path.join(os.tmpdir(), \"smalk-active-ad-paths.json\");\n        await fs.mkdir(path.dirname(f), { recursive: true });\n        await fs.writeFile(f, JSON.stringify(payload));\n    }\n}\n\n// Vercel KV adapter — requires @vercel/kv installed by the publisher.\n// We don't bundle the dep; lazy-import via a non-literal specifier so\n// bundlers (vite/vitest/tsup/webpack) don't try to resolve it at build time.\nconst VERCEL_KV_MODULE = \"@vercel/kv\";\nasync function loadVercelKv(): Promise<{ kv: { get(k: string): Promise<unknown>; set(k: string, v: string): Promise<unknown> } }> {\n    // Indirect specifier — opaque to bundler static analysis.\n    return (await import(/* @vite-ignore */ /* webpackIgnore: true */ VERCEL_KV_MODULE)) as {\n        kv: { get(k: string): Promise<unknown>; set(k: string, v: string): Promise<unknown> };\n    };\n}\n\nexport class VercelKVActiveUrlsStore implements ActiveUrlsStore {\n    private readonly key: string;\n    constructor(key = \"smalk:active-ad-paths\") { this.key = key; }\n    async read(): Promise<ActiveUrlsCachedPayload | null> {\n        const { kv } = await loadVercelKv();\n        const raw = await kv.get(this.key);\n        if (!raw) return null;\n        try { return typeof raw === \"string\" ? JSON.parse(raw) : (raw as ActiveUrlsCachedPayload); }\n        catch { return null; }\n    }\n    async write(payload: ActiveUrlsCachedPayload) {\n        const { kv } = await loadVercelKv();\n        await kv.set(this.key, JSON.stringify(payload));\n    }\n}\n\n// Cloudflare KV adapter — publisher passes the KVNamespace binding.\nexport class CloudflareKVActiveUrlsStore implements ActiveUrlsStore {\n    constructor(private namespace: { get(key: string): Promise<string | null>; put(key: string, value: string): Promise<void> }, private key = \"smalk:active-ad-paths\") {}\n    async read(): Promise<ActiveUrlsCachedPayload | null> {\n        const raw = await this.namespace.get(this.key);\n        return raw ? JSON.parse(raw) : null;\n    }\n    async write(payload: ActiveUrlsCachedPayload) {\n        await this.namespace.put(this.key, JSON.stringify(payload));\n    }\n}\n\n// Module-level default — process-wide singleton, swap with setActiveUrlsStore().\nlet currentStore: ActiveUrlsStore = new FilesystemActiveUrlsStore();\n\nexport function getActiveUrlsStore(): ActiveUrlsStore {\n    return currentStore;\n}\n\nexport function setActiveUrlsStore(store: ActiveUrlsStore): void {\n    currentStore = store;\n}\n","import { getActiveUrlsStore, type ActiveUrlsCachedPayload } from \"./activeUrlsStore\";\n\nexport async function cacheActiveUrls(paths: string[]) {\n    await getActiveUrlsStore().write({ paths, updated_at: Date.now() });\n}\n\nexport async function readActiveUrls(): Promise<ActiveUrlsCachedPayload | null> {\n    return getActiveUrlsStore().read();\n}\n\n// Re-export for publishers configuring their own store\nexport { getActiveUrlsStore, setActiveUrlsStore } from \"./activeUrlsStore\";\nexport type { ActiveUrlsStore, ActiveUrlsCachedPayload } from \"./activeUrlsStore\";\n","import { NextRequest, NextResponse } from \"next/server\";\n\nimport { readActiveUrls } from \"./activeUrlsCache\";\n\nlet pathsCache: Set<string> | null = null;\nlet pathsLoadedAt = 0;\nconst RELOAD_INTERVAL_MS = 60_000;\n\nasync function getPaths(): Promise<Set<string>> {\n    const now = Date.now();\n    if (!pathsCache || now - pathsLoadedAt > RELOAD_INTERVAL_MS) {\n        const data = await readActiveUrls();\n        pathsCache = new Set(data?.paths ?? []);\n        pathsLoadedAt = now;\n    }\n    return pathsCache;\n}\n\nexport async function smalkFreshnessMiddleware(req: NextRequest): Promise<NextResponse | undefined> {\n    const paths = await getPaths();\n    if (!paths.has(req.nextUrl.pathname)) return undefined;\n    const res = NextResponse.next();\n    // Day-bucket stable Last-Modified so real users with If-Modified-Since\n    // still get 304s within the day; AI crawlers (which hit infrequently)\n    // get a fresh signal on the next UTC day rollover.\n    const dayBucket = Math.floor(Date.now() / 86_400_000) * 86_400_000;\n    res.headers.set(\"Last-Modified\", new Date(dayBucket).toUTCString());\n    res.headers.set(\"X-Smalk-Freshness\", \"bumped\");\n    return res;\n}\n","export interface AdInput {\n  pageUrl: string;\n  userAgent: string;\n  referer: string;\n  clientIp: string;\n}\n\nexport interface AdResult {\n  html: string;\n  bookingId: string | null;\n}\n\nexport interface ApiResponse {\n  html?: string;\n  booking_id?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport const DEFAULT_TIMEOUT_MS = 100;\nexport const DEFAULT_REVALIDATE_S = 1200;\nexport const API_PATH = '/transform/ads/content/';\n\nexport { getSmalkConfig, loadConfig } from './config';\nexport type { SmalkConfig, LegacySmalkConfig } from './config';\n\n/** @deprecated Use `SmalkConfig` from `./config`. Kept as alias for legacy imports. */\nexport type { LegacySmalkConfig as SmalkAdsConfig } from './config';\n\nexport { smalkFreshnessRevalidateHandler } from \"./freshness/route\";\nexport { smalkFreshnessMiddleware } from \"./freshness/middleware\";\nexport { cacheActiveUrls, readActiveUrls } from \"./freshness/activeUrlsCache\";\nexport {\n    InMemoryActiveUrlsStore,\n    FilesystemActiveUrlsStore,\n    VercelKVActiveUrlsStore,\n    CloudflareKVActiveUrlsStore,\n    getActiveUrlsStore,\n    setActiveUrlsStore,\n} from \"./freshness/activeUrlsStore\";\nexport type { ActiveUrlsStore, ActiveUrlsCachedPayload } from \"./freshness/activeUrlsStore\";\n"],"mappings":"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","names":["NextResponse","NextResponse"]}

package/dist/{chunk-YA6M2IA4.js → chunk-INI3DN37.js}

@@ -2,13 +2,13 @@ import {
   API_PATH,
   DEFAULT_REVALIDATE_S,
   DEFAULT_TIMEOUT_MS,
-  loadConfig
-} from "./chunk-HX4ZGDYQ.js";
+  getSmalkConfig
+} from "./chunk-4QWOGJYF.js";
 
 // src/client.ts
 var lastHashByUrl = /* @__PURE__ */ new Map();
 async function fetchAd(input, opts = {}) {
-  const cfg = loadConfig();
+  const cfg = getSmalkConfig();
   if (!cfg.projectKey || !cfg.apiKey) return null;
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
@@ -23,7 +23,7 @@ async function fetchAd(input, opts = {}) {
     if (opts.preview !== void 0 && opts.preview !== false) {
       body.preview = opts.preview;
     }
-    const res = await fetch(`${cfg.apiBaseUrl}${API_PATH}`, {
+    const res = await fetch(`${cfg.apiBase}${API_PATH}`, {
       method: "POST",
       headers: {
         "Authorization": `Api-Key ${cfg.apiKey}`,
@@ -89,4 +89,4 @@ async function sha256Hex(input) {
 export {
   fetchAd
 };
-//# sourceMappingURL=chunk-YA6M2IA4.js.map
+//# sourceMappingURL=chunk-INI3DN37.js.map

package/dist/chunk-INI3DN37.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import { getSmalkConfig } from './config';\nimport { AdInput, AdResult, ApiResponse, API_PATH, DEFAULT_TIMEOUT_MS, DEFAULT_REVALIDATE_S } from './index';\n\nconst lastHashByUrl = new Map<string, string>();\n\nexport function _resetHashCacheForTests(): void {\n  lastHashByUrl.clear();\n}\n\nexport interface FetchAdOptions {\n  revalidate?: number;\n  /** Preview mode: `true` (PARAGRAPH placeholder) or a format string (e.g. `'FAQ'`). Bypasses booking lookup. */\n  preview?: boolean | string;\n}\n\nexport async function fetchAd(input: AdInput, opts: FetchAdOptions = {}): Promise<AdResult | null> {\n  const cfg = getSmalkConfig();\n  if (!cfg.projectKey || !cfg.apiKey) return null;\n\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);\n\n  try {\n    const body: Record<string, unknown> = {\n      project_key: cfg.projectKey,\n      page_url: input.pageUrl,\n      user_agent: input.userAgent,\n      referer: input.referer,\n      client_ip: input.clientIp,\n    };\n    if (opts.preview !== undefined && opts.preview !== false) {\n      body.preview = opts.preview;\n    }\n    const res = await fetch(`${cfg.apiBase}${API_PATH}`, {\n      method: 'POST',\n      headers: {\n        'Authorization': `Api-Key ${cfg.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(body),\n      signal: controller.signal,\n      // `next` is a Next.js fetch extension; type provided by next types when present.\n      next: {\n        revalidate: opts.revalidate ?? DEFAULT_REVALIDATE_S,\n        tags: ['smalk-ad', `smalk-ad:${input.pageUrl}`],\n      },\n    } as RequestInit);\n\n    if (!res.ok) {\n      logErrorOnce(`smalk-ads fetch failed: HTTP ${res.status}`);\n      return null;\n    }\n\n    const data = (await res.json()) as ApiResponse;\n    if (!data.html) return null;\n\n    const hash = await sha256Hex(data.html);\n    const prev = lastHashByUrl.get(input.pageUrl);\n    if (prev && prev !== hash) {\n      await maybeRevalidatePath(input.pageUrl);\n    }\n    lastHashByUrl.set(input.pageUrl, hash);\n\n    return { html: data.html, bookingId: data.booking_id ?? null };\n  } catch (err) {\n    if (err instanceof Error && err.name !== 'AbortError') {\n      logErrorOnce(`smalk-ads fetch error: ${err.message}`);\n    }\n    return null;\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\nasync function maybeRevalidatePath(pageUrl: string): Promise<void> {\n  try {\n    const mod = await import('next/cache');\n    if (typeof mod.revalidatePath === 'function') {\n      const pathname = new URL(pageUrl).pathname;\n      mod.revalidatePath(pathname);\n    }\n  } catch {\n    // next/cache not available (Pages Router runtime, edge, or test env without next).\n  }\n}\n\nconst seenErrors = new Set<string>();\nfunction logErrorOnce(msg: string): void {\n  if (seenErrors.has(msg)) return;\n  seenErrors.add(msg);\n  console.error(`[smalk-nextjs-ads] ${msg}`);\n}\n\nasync function sha256Hex(input: string): Promise<string> {\n  const data = new TextEncoder().encode(input);\n  const buf = await globalThis.crypto.subtle.digest('SHA-256', data);\n  const bytes = new Uint8Array(buf);\n  let hex = '';\n  for (let i = 0; i < bytes.length; i++) {\n    hex += bytes[i].toString(16).padStart(2, '0');\n  }\n  return hex;\n}\n"],"mappings":";;;;;;;;AAGA,IAAM,gBAAgB,oBAAI,IAAoB;AAY9C,eAAsB,QAAQ,OAAgB,OAAuB,CAAC,GAA6B;AACjG,QAAM,MAAM,eAAe;AAC3B,MAAI,CAAC,IAAI,cAAc,CAAC,IAAI,OAAQ,QAAO;AAE3C,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,QAAQ,WAAW,MAAM,WAAW,MAAM,GAAG,kBAAkB;AAErE,MAAI;AACF,UAAM,OAAgC;AAAA,MACpC,aAAa,IAAI;AAAA,MACjB,UAAU,MAAM;AAAA,MAChB,YAAY,MAAM;AAAA,MAClB,SAAS,MAAM;AAAA,MACf,WAAW,MAAM;AAAA,IACnB;AACA,QAAI,KAAK,YAAY,UAAa,KAAK,YAAY,OAAO;AACxD,WAAK,UAAU,KAAK;AAAA,IACtB;AACA,UAAM,MAAM,MAAM,MAAM,GAAG,IAAI,OAAO,GAAG,QAAQ,IAAI;AAAA,MACnD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,iBAAiB,WAAW,IAAI,MAAM;AAAA,QACtC,gBAAgB;AAAA,MAClB;AAAA,MACA,MAAM,KAAK,UAAU,IAAI;AAAA,MACzB,QAAQ,WAAW;AAAA;AAAA,MAEnB,MAAM;AAAA,QACJ,YAAY,KAAK,cAAc;AAAA,QAC/B,MAAM,CAAC,YAAY,YAAY,MAAM,OAAO,EAAE;AAAA,MAChD;AAAA,IACF,CAAgB;AAEhB,QAAI,CAAC,IAAI,IAAI;AACX,mBAAa,gCAAgC,IAAI,MAAM,EAAE;AACzD,aAAO;AAAA,IACT;AAEA,UAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,QAAI,CAAC,KAAK,KAAM,QAAO;AAEvB,UAAM,OAAO,MAAM,UAAU,KAAK,IAAI;AACtC,UAAM,OAAO,cAAc,IAAI,MAAM,OAAO;AAC5C,QAAI,QAAQ,SAAS,MAAM;AACzB,YAAM,oBAAoB,MAAM,OAAO;AAAA,IACzC;AACA,kBAAc,IAAI,MAAM,SAAS,IAAI;AAErC,WAAO,EAAE,MAAM,KAAK,MAAM,WAAW,KAAK,cAAc,KAAK;AAAA,EAC/D,SAAS,KAAK;AACZ,QAAI,eAAe,SAAS,IAAI,SAAS,cAAc;AACrD,mBAAa,0BAA0B,IAAI,OAAO,EAAE;AAAA,IACtD;AACA,WAAO;AAAA,EACT,UAAE;AACA,iBAAa,KAAK;AAAA,EACpB;AACF;AAEA,eAAe,oBAAoB,SAAgC;AACjE,MAAI;AACF,UAAM,MAAM,MAAM,OAAO,YAAY;AACrC,QAAI,OAAO,IAAI,mBAAmB,YAAY;AAC5C,YAAM,WAAW,IAAI,IAAI,OAAO,EAAE;AAClC,UAAI,eAAe,QAAQ;AAAA,IAC7B;AAAA,EACF,QAAQ;AAAA,EAER;AACF;AAEA,IAAM,aAAa,oBAAI,IAAY;AACnC,SAAS,aAAa,KAAmB;AACvC,MAAI,WAAW,IAAI,GAAG,EAAG;AACzB,aAAW,IAAI,GAAG;AAClB,UAAQ,MAAM,sBAAsB,GAAG,EAAE;AAC3C;AAEA,eAAe,UAAU,OAAgC;AACvD,QAAM,OAAO,IAAI,YAAY,EAAE,OAAO,KAAK;AAC3C,QAAM,MAAM,MAAM,WAAW,OAAO,OAAO,OAAO,WAAW,IAAI;AACjE,QAAM,QAAQ,IAAI,WAAW,GAAG;AAChC,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,WAAO,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAAA,EAC9C;AACA,SAAO;AACT;","names":[]}

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,44 +17,253 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
   API_PATH: () => API_PATH,
+  CloudflareKVActiveUrlsStore: () => CloudflareKVActiveUrlsStore,
   DEFAULT_REVALIDATE_S: () => DEFAULT_REVALIDATE_S,
   DEFAULT_TIMEOUT_MS: () => DEFAULT_TIMEOUT_MS,
-  loadConfig: () => loadConfig
+  FilesystemActiveUrlsStore: () => FilesystemActiveUrlsStore,
+  InMemoryActiveUrlsStore: () => InMemoryActiveUrlsStore,
+  VercelKVActiveUrlsStore: () => VercelKVActiveUrlsStore,
+  cacheActiveUrls: () => cacheActiveUrls,
+  getActiveUrlsStore: () => getActiveUrlsStore,
+  getSmalkConfig: () => getSmalkConfig,
+  loadConfig: () => loadConfig,
+  readActiveUrls: () => readActiveUrls,
+  setActiveUrlsStore: () => setActiveUrlsStore,
+  smalkFreshnessMiddleware: () => smalkFreshnessMiddleware,
+  smalkFreshnessRevalidateHandler: () => smalkFreshnessRevalidateHandler
 });
 module.exports = __toCommonJS(src_exports);
-var DEFAULT_TIMEOUT_MS = 100;
-var DEFAULT_REVALIDATE_S = 1200;
-var API_PATH = "/api/v1/transform/ads/content/";
-function loadConfig() {
-  const projectKey = process.env.SMALK_PROJECT_KEY;
-  const apiKey = process.env.SMALK_API_KEY;
-  const apiBaseUrl = process.env.SMALK_API_BASE_URL || "https://api.smalk.ai";
-  const isProd = process.env.NODE_ENV === "production";
-  if (!projectKey) {
-    if (isProd) throw new Error("@smalk/nextjs-ads: SMALK_PROJECT_KEY env var is required in production");
-    console.warn("[smalk] SMALK_PROJECT_KEY not set \u2014 ad fetch will be skipped");
-  }
-  if (!apiKey) {
-    if (isProd) throw new Error("@smalk/nextjs-ads: SMALK_API_KEY env var is required in production");
-    console.warn("[smalk] SMALK_API_KEY not set \u2014 ad fetch will be skipped");
-  }
+
+// src/config.ts
+var DEFAULT_API_BASE = "https://api.smalk.ai/api/v1";
+var PLUGIN_VERSION = "1.1.0";
+function getSmalkConfig() {
+  const apiBase = process.env.SMALK_API_BASE || process.env.SMALK_API_BASE_URL || DEFAULT_API_BASE;
+  const apiKey = process.env.SMALK_API_KEY ?? "";
+  const projectKey = process.env.SMALK_PROJECT_KEY ?? "";
+  const cronSecret = process.env.SMALK_CRON_SECRET ?? "";
+  const publicHost = process.env.SMALK_PUBLIC_HOST || void 0;
   return {
-    projectKey: projectKey ?? "",
-    apiKey: apiKey ?? "",
-    apiBaseUrl
+    apiBase,
+    apiKey,
+    projectKey,
+    cronSecret,
+    pluginVersion: PLUGIN_VERSION,
+    publicHost
   };
 }
+function stripApiPathSuffix(apiBase) {
+  return apiBase.replace(/\/api\/v\d+\/?$/, "");
+}
+function loadConfig() {
+  const cfg = getSmalkConfig();
+  return { ...cfg, apiBaseUrl: stripApiPathSuffix(cfg.apiBase) };
+}
+
+// src/freshness/route.ts
+var import_cache = require("next/cache");
+var import_server = require("next/server");
+
+// src/freshness/activeUrlsStore.ts
+var InMemoryActiveUrlsStore = class {
+  value = null;
+  async read() {
+    return this.value;
+  }
+  async write(payload) {
+    this.value = payload;
+  }
+};
+var FilesystemActiveUrlsStore = class {
+  constructor(filePath) {
+    this.filePath = filePath;
+  }
+  filePath;
+  async read() {
+    const fs = await import("fs/promises");
+    const path = await import("path");
+    const os = await import("os");
+    const f = this.filePath || path.join(os.tmpdir(), "smalk-active-ad-paths.json");
+    try {
+      return JSON.parse(await fs.readFile(f, "utf8"));
+    } catch {
+      return null;
+    }
+  }
+  async write(payload) {
+    const fs = await import("fs/promises");
+    const path = await import("path");
+    const os = await import("os");
+    const f = this.filePath || path.join(os.tmpdir(), "smalk-active-ad-paths.json");
+    await fs.mkdir(path.dirname(f), { recursive: true });
+    await fs.writeFile(f, JSON.stringify(payload));
+  }
+};
+var VERCEL_KV_MODULE = "@vercel/kv";
+async function loadVercelKv() {
+  return await import(
+    /* @vite-ignore */
+    /* webpackIgnore: true */
+    VERCEL_KV_MODULE
+  );
+}
+var VercelKVActiveUrlsStore = class {
+  key;
+  constructor(key = "smalk:active-ad-paths") {
+    this.key = key;
+  }
+  async read() {
+    const { kv } = await loadVercelKv();
+    const raw = await kv.get(this.key);
+    if (!raw) return null;
+    try {
+      return typeof raw === "string" ? JSON.parse(raw) : raw;
+    } catch {
+      return null;
+    }
+  }
+  async write(payload) {
+    const { kv } = await loadVercelKv();
+    await kv.set(this.key, JSON.stringify(payload));
+  }
+};
+var CloudflareKVActiveUrlsStore = class {
+  constructor(namespace, key = "smalk:active-ad-paths") {
+    this.namespace = namespace;
+    this.key = key;
+  }
+  namespace;
+  key;
+  async read() {
+    const raw = await this.namespace.get(this.key);
+    return raw ? JSON.parse(raw) : null;
+  }
+  async write(payload) {
+    await this.namespace.put(this.key, JSON.stringify(payload));
+  }
+};
+var currentStore = new FilesystemActiveUrlsStore();
+function getActiveUrlsStore() {
+  return currentStore;
+}
+function setActiveUrlsStore(store) {
+  currentStore = store;
+}
+
+// src/freshness/activeUrlsCache.ts
+async function cacheActiveUrls(paths) {
+  await getActiveUrlsStore().write({ paths, updated_at: Date.now() });
+}
+async function readActiveUrls() {
+  return getActiveUrlsStore().read();
+}
+
+// src/freshness/route.ts
+async function smalkFreshnessRevalidateHandler(req) {
+  const cfg = getSmalkConfig();
+  const secret = req.headers.get("x-smalk-cron-secret");
+  if (!secret || secret !== cfg.cronSecret) {
+    return import_server.NextResponse.json({ error: "unauthorized" }, { status: 401 });
+  }
+  const endpoint = `${cfg.apiBase}/projects/${cfg.projectKey}/ads/inventory/active-ad-urls/`;
+  const resp = await fetch(endpoint, {
+    headers: {
+      "X-API-Key": cfg.apiKey,
+      "X-Smalk-CMS": "nextjs",
+      "X-Smalk-Plugin": cfg.pluginVersion
+    },
+    cache: "no-store"
+  });
+  if (!resp.ok) {
+    return import_server.NextResponse.json({ error: `api ${resp.status}` }, { status: 502 });
+  }
+  const payload = await resp.json();
+  const paths = payload.urls.map((u) => safePath(u.url, cfg.publicHost)).filter((p) => Boolean(p));
+  await cacheActiveUrls(paths);
+  let revalidated = 0;
+  for (const p of paths) {
+    try {
+      (0, import_cache.revalidatePath)(p);
+      revalidated++;
+    } catch (e) {
+      console.warn(`[smalk] revalidatePath failed for ${p}`, e);
+    }
+  }
+  return import_server.NextResponse.json({
+    ok: true,
+    total: paths.length,
+    revalidated,
+    ran_at: (/* @__PURE__ */ new Date()).toISOString()
+  });
+}
+function safePath(url, publicHost) {
+  try {
+    const u = new URL(url);
+    if (publicHost && u.host !== publicHost) return null;
+    return u.pathname;
+  } catch {
+    return null;
+  }
+}
+
+// src/freshness/middleware.ts
+var import_server2 = require("next/server");
+var pathsCache = null;
+var pathsLoadedAt = 0;
+var RELOAD_INTERVAL_MS = 6e4;
+async function getPaths() {
+  const now = Date.now();
+  if (!pathsCache || now - pathsLoadedAt > RELOAD_INTERVAL_MS) {
+    const data = await readActiveUrls();
+    pathsCache = new Set(data?.paths ?? []);
+    pathsLoadedAt = now;
+  }
+  return pathsCache;
+}
+async function smalkFreshnessMiddleware(req) {
+  const paths = await getPaths();
+  if (!paths.has(req.nextUrl.pathname)) return void 0;
+  const res = import_server2.NextResponse.next();
+  const dayBucket = Math.floor(Date.now() / 864e5) * 864e5;
+  res.headers.set("Last-Modified", new Date(dayBucket).toUTCString());
+  res.headers.set("X-Smalk-Freshness", "bumped");
+  return res;
+}
+
+// src/index.ts
+var DEFAULT_TIMEOUT_MS = 100;
+var DEFAULT_REVALIDATE_S = 1200;
+var API_PATH = "/transform/ads/content/";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   API_PATH,
+  CloudflareKVActiveUrlsStore,
   DEFAULT_REVALIDATE_S,
   DEFAULT_TIMEOUT_MS,
-  loadConfig
+  FilesystemActiveUrlsStore,
+  InMemoryActiveUrlsStore,
+  VercelKVActiveUrlsStore,
+  cacheActiveUrls,
+  getActiveUrlsStore,
+  getSmalkConfig,
+  loadConfig,
+  readActiveUrls,
+  setActiveUrlsStore,
+  smalkFreshnessMiddleware,
+  smalkFreshnessRevalidateHandler
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface SmalkAdsConfig {\n  projectKey: string;\n  apiKey: string;\n  apiBaseUrl: string;\n}\n\nexport interface AdInput {\n  pageUrl: string;\n  userAgent: string;\n  referer: string;\n  clientIp: string;\n}\n\nexport interface AdResult {\n  html: string;\n  bookingId: string | null;\n}\n\nexport interface ApiResponse {\n  html?: string;\n  booking_id?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport const DEFAULT_TIMEOUT_MS = 100;\nexport const DEFAULT_REVALIDATE_S = 1200;\nexport const API_PATH = '/api/v1/transform/ads/content/';\n\nexport function loadConfig(): SmalkAdsConfig {\n  const projectKey = process.env.SMALK_PROJECT_KEY;\n  const apiKey = process.env.SMALK_API_KEY;\n  const apiBaseUrl = process.env.SMALK_API_BASE_URL || 'https://api.smalk.ai';\n  const isProd = process.env.NODE_ENV === 'production';\n\n  if (!projectKey) {\n    if (isProd) throw new Error('@smalk/nextjs-ads: SMALK_PROJECT_KEY env var is required in production');\n    console.warn('[smalk] SMALK_PROJECT_KEY not set — ad fetch will be skipped');\n  }\n  if (!apiKey) {\n    if (isProd) throw new Error('@smalk/nextjs-ads: SMALK_API_KEY env var is required in production');\n    console.warn('[smalk] SMALK_API_KEY not set — ad fetch will be skipped');\n  }\n\n  return {\n    projectKey: projectKey ?? '',\n    apiKey: apiKey ?? '',\n    apiBaseUrl,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwBO,IAAM,qBAAqB;AAC3B,IAAM,uBAAuB;AAC7B,IAAM,WAAW;AAEjB,SAAS,aAA6B;AAC3C,QAAM,aAAa,QAAQ,IAAI;AAC/B,QAAM,SAAS,QAAQ,IAAI;AAC3B,QAAM,aAAa,QAAQ,IAAI,sBAAsB;AACrD,QAAM,SAAS,QAAQ,IAAI,aAAa;AAExC,MAAI,CAAC,YAAY;AACf,QAAI,OAAQ,OAAM,IAAI,MAAM,wEAAwE;AACpG,YAAQ,KAAK,mEAA8D;AAAA,EAC7E;AACA,MAAI,CAAC,QAAQ;AACX,QAAI,OAAQ,OAAM,IAAI,MAAM,oEAAoE;AAChG,YAAQ,KAAK,+DAA0D;AAAA,EACzE;AAEA,SAAO;AAAA,IACL,YAAY,cAAc;AAAA,IAC1B,QAAQ,UAAU;AAAA,IAClB;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/freshness/route.ts","../src/freshness/activeUrlsStore.ts","../src/freshness/activeUrlsCache.ts","../src/freshness/middleware.ts"],"sourcesContent":["export interface AdInput {\n  pageUrl: string;\n  userAgent: string;\n  referer: string;\n  clientIp: string;\n}\n\nexport interface AdResult {\n  html: string;\n  bookingId: string | null;\n}\n\nexport interface ApiResponse {\n  html?: string;\n  booking_id?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport const DEFAULT_TIMEOUT_MS = 100;\nexport const DEFAULT_REVALIDATE_S = 1200;\nexport const API_PATH = '/transform/ads/content/';\n\nexport { getSmalkConfig, loadConfig } from './config';\nexport type { SmalkConfig, LegacySmalkConfig } from './config';\n\n/** @deprecated Use `SmalkConfig` from `./config`. Kept as alias for legacy imports. */\nexport type { LegacySmalkConfig as SmalkAdsConfig } from './config';\n\nexport { smalkFreshnessRevalidateHandler } from \"./freshness/route\";\nexport { smalkFreshnessMiddleware } from \"./freshness/middleware\";\nexport { cacheActiveUrls, readActiveUrls } from \"./freshness/activeUrlsCache\";\nexport {\n    InMemoryActiveUrlsStore,\n    FilesystemActiveUrlsStore,\n    VercelKVActiveUrlsStore,\n    CloudflareKVActiveUrlsStore,\n    getActiveUrlsStore,\n    setActiveUrlsStore,\n} from \"./freshness/activeUrlsStore\";\nexport type { ActiveUrlsStore, ActiveUrlsCachedPayload } from \"./freshness/activeUrlsStore\";\n","export interface SmalkConfig {\n    /** Full API base including version path, e.g. https://api.smalk.ai/api/v1 */\n    apiBase: string;\n    apiKey: string;\n    projectKey: string;\n    cronSecret: string;\n    pluginVersion: string;\n    publicHost?: string;\n}\n\n/**\n * Backwards-compatible config shape for legacy callers (pre-P2). Adds an\n * `apiBaseUrl` alias for `apiBase`. New code should use `getSmalkConfig()`\n * and read `apiBase` directly.\n */\nexport interface LegacySmalkConfig extends SmalkConfig {\n    /**\n     * @deprecated Use `apiBase` instead.\n     *\n     * Pre-P2.5 shape: host-only (e.g. `https://api.smalk.ai`), and external\n     * publisher code appended `/api/v1/...`. To preserve that shape after the\n     * P2.5 Next config unify (which moved `/api/v1` into the canonical\n     * `apiBase`), this field strips a trailing `/api/vN` segment from\n     * `apiBase` before exposing it. New code should read `apiBase` directly.\n     */\n    apiBaseUrl: string;\n}\n\nconst DEFAULT_API_BASE = \"https://api.smalk.ai/api/v1\";\nconst PLUGIN_VERSION = \"1.1.0\";\n\nexport function getSmalkConfig(): SmalkConfig {\n    const apiBase = process.env.SMALK_API_BASE || process.env.SMALK_API_BASE_URL || DEFAULT_API_BASE;\n    const apiKey = process.env.SMALK_API_KEY ?? \"\";\n    const projectKey = process.env.SMALK_PROJECT_KEY ?? \"\";\n    const cronSecret = process.env.SMALK_CRON_SECRET ?? \"\";\n    const publicHost = process.env.SMALK_PUBLIC_HOST || undefined;\n\n    return {\n        apiBase,\n        apiKey,\n        projectKey,\n        cronSecret,\n        pluginVersion: PLUGIN_VERSION,\n        publicHost,\n    };\n}\n\n/**\n * Strip a trailing `/api/vN` (or `/api/vN/`) segment from an API base URL.\n * Preserves backward compatibility with publishers building URLs like\n * `${apiBaseUrl}/api/v1/...` — without stripping, those would double-prefix\n * to `/api/v1/api/v1/...` and 404.\n */\nfunction stripApiPathSuffix(apiBase: string): string {\n    return apiBase.replace(/\\/api\\/v\\d+\\/?$/, \"\");\n}\n\n/**\n * Legacy loader retained for external consumers (publisher apps) that import\n * `loadConfig` from `@smalk/nextjs-ads`. Returns the canonical `SmalkConfig`\n * plus an `apiBaseUrl` alias whose shape matches the pre-P2.5 contract\n * (host-only, no `/api/v1` suffix). New code should prefer `getSmalkConfig()`\n * and read `apiBase` directly.\n */\nexport function loadConfig(): LegacySmalkConfig {\n    const cfg = getSmalkConfig();\n    return { ...cfg, apiBaseUrl: stripApiPathSuffix(cfg.apiBase) };\n}\n","import { revalidatePath } from \"next/cache\";\nimport { NextRequest, NextResponse } from \"next/server\";\n\nimport { getSmalkConfig } from \"../config\";\nimport { cacheActiveUrls } from \"./activeUrlsCache\";\n\nexport async function smalkFreshnessRevalidateHandler(req: NextRequest) {\n    const cfg = getSmalkConfig();\n    const secret = req.headers.get(\"x-smalk-cron-secret\");\n    if (!secret || secret !== cfg.cronSecret) {\n        return NextResponse.json({ error: \"unauthorized\" }, { status: 401 });\n    }\n\n    const endpoint = `${cfg.apiBase}/projects/${cfg.projectKey}/ads/inventory/active-ad-urls/`;\n    const resp = await fetch(endpoint, {\n        headers: {\n            \"X-API-Key\": cfg.apiKey,\n            \"X-Smalk-CMS\": \"nextjs\",\n            \"X-Smalk-Plugin\": cfg.pluginVersion,\n        },\n        cache: \"no-store\",\n    });\n    if (!resp.ok) {\n        return NextResponse.json({ error: `api ${resp.status}` }, { status: 502 });\n    }\n    const payload = (await resp.json()) as { urls: { url: string }[] };\n    const paths = payload.urls\n        .map((u) => safePath(u.url, cfg.publicHost))\n        .filter((p): p is string => Boolean(p));\n\n    await cacheActiveUrls(paths);\n\n    let revalidated = 0;\n    for (const p of paths) {\n        try {\n            revalidatePath(p);\n            revalidated++;\n        } catch (e) {\n            console.warn(`[smalk] revalidatePath failed for ${p}`, e);\n        }\n    }\n\n    return NextResponse.json({\n        ok: true,\n        total: paths.length,\n        revalidated,\n        ran_at: new Date().toISOString(),\n    });\n}\n\nfunction safePath(url: string, publicHost?: string): string | null {\n    try {\n        const u = new URL(url);\n        if (publicHost && u.host !== publicHost) return null;\n        return u.pathname;\n    } catch {\n        return null;\n    }\n}\n","export interface ActiveUrlsCachedPayload {\n    paths: string[];\n    updated_at: number;\n}\n\nexport interface ActiveUrlsStore {\n    read(): Promise<ActiveUrlsCachedPayload | null>;\n    write(payload: ActiveUrlsCachedPayload): Promise<void>;\n}\n\n// In-memory store (per-process, fast, lost on restart — good for tests).\nexport class InMemoryActiveUrlsStore implements ActiveUrlsStore {\n    private value: ActiveUrlsCachedPayload | null = null;\n    async read() { return this.value; }\n    async write(payload: ActiveUrlsCachedPayload) { this.value = payload; }\n}\n\n// Filesystem fallback — uses os.tmpdir() (current behavior, kept for Node dev).\nexport class FilesystemActiveUrlsStore implements ActiveUrlsStore {\n    constructor(private filePath?: string) {}\n    async read(): Promise<ActiveUrlsCachedPayload | null> {\n        const fs = await import(\"node:fs/promises\");\n        const path = await import(\"node:path\");\n        const os = await import(\"node:os\");\n        const f = this.filePath || path.join(os.tmpdir(), \"smalk-active-ad-paths.json\");\n        try {\n            return JSON.parse(await fs.readFile(f, \"utf8\"));\n        } catch {\n            return null;\n        }\n    }\n    async write(payload: ActiveUrlsCachedPayload) {\n        const fs = await import(\"node:fs/promises\");\n        const path = await import(\"node:path\");\n        const os = await import(\"node:os\");\n        const f = this.filePath || path.join(os.tmpdir(), \"smalk-active-ad-paths.json\");\n        await fs.mkdir(path.dirname(f), { recursive: true });\n        await fs.writeFile(f, JSON.stringify(payload));\n    }\n}\n\n// Vercel KV adapter — requires @vercel/kv installed by the publisher.\n// We don't bundle the dep; lazy-import via a non-literal specifier so\n// bundlers (vite/vitest/tsup/webpack) don't try to resolve it at build time.\nconst VERCEL_KV_MODULE = \"@vercel/kv\";\nasync function loadVercelKv(): Promise<{ kv: { get(k: string): Promise<unknown>; set(k: string, v: string): Promise<unknown> } }> {\n    // Indirect specifier — opaque to bundler static analysis.\n    return (await import(/* @vite-ignore */ /* webpackIgnore: true */ VERCEL_KV_MODULE)) as {\n        kv: { get(k: string): Promise<unknown>; set(k: string, v: string): Promise<unknown> };\n    };\n}\n\nexport class VercelKVActiveUrlsStore implements ActiveUrlsStore {\n    private readonly key: string;\n    constructor(key = \"smalk:active-ad-paths\") { this.key = key; }\n    async read(): Promise<ActiveUrlsCachedPayload | null> {\n        const { kv } = await loadVercelKv();\n        const raw = await kv.get(this.key);\n        if (!raw) return null;\n        try { return typeof raw === \"string\" ? JSON.parse(raw) : (raw as ActiveUrlsCachedPayload); }\n        catch { return null; }\n    }\n    async write(payload: ActiveUrlsCachedPayload) {\n        const { kv } = await loadVercelKv();\n        await kv.set(this.key, JSON.stringify(payload));\n    }\n}\n\n// Cloudflare KV adapter — publisher passes the KVNamespace binding.\nexport class CloudflareKVActiveUrlsStore implements ActiveUrlsStore {\n    constructor(private namespace: { get(key: string): Promise<string | null>; put(key: string, value: string): Promise<void> }, private key = \"smalk:active-ad-paths\") {}\n    async read(): Promise<ActiveUrlsCachedPayload | null> {\n        const raw = await this.namespace.get(this.key);\n        return raw ? JSON.parse(raw) : null;\n    }\n    async write(payload: ActiveUrlsCachedPayload) {\n        await this.namespace.put(this.key, JSON.stringify(payload));\n    }\n}\n\n// Module-level default — process-wide singleton, swap with setActiveUrlsStore().\nlet currentStore: ActiveUrlsStore = new FilesystemActiveUrlsStore();\n\nexport function getActiveUrlsStore(): ActiveUrlsStore {\n    return currentStore;\n}\n\nexport function setActiveUrlsStore(store: ActiveUrlsStore): void {\n    currentStore = store;\n}\n","import { getActiveUrlsStore, type ActiveUrlsCachedPayload } from \"./activeUrlsStore\";\n\nexport async function cacheActiveUrls(paths: string[]) {\n    await getActiveUrlsStore().write({ paths, updated_at: Date.now() });\n}\n\nexport async function readActiveUrls(): Promise<ActiveUrlsCachedPayload | null> {\n    return getActiveUrlsStore().read();\n}\n\n// Re-export for publishers configuring their own store\nexport { getActiveUrlsStore, setActiveUrlsStore } from \"./activeUrlsStore\";\nexport type { ActiveUrlsStore, ActiveUrlsCachedPayload } from \"./activeUrlsStore\";\n","import { NextRequest, NextResponse } from \"next/server\";\n\nimport { readActiveUrls } from \"./activeUrlsCache\";\n\nlet pathsCache: Set<string> | null = null;\nlet pathsLoadedAt = 0;\nconst RELOAD_INTERVAL_MS = 60_000;\n\nasync function getPaths(): Promise<Set<string>> {\n    const now = Date.now();\n    if (!pathsCache || now - pathsLoadedAt > RELOAD_INTERVAL_MS) {\n        const data = await readActiveUrls();\n        pathsCache = new Set(data?.paths ?? []);\n        pathsLoadedAt = now;\n    }\n    return pathsCache;\n}\n\nexport async function smalkFreshnessMiddleware(req: NextRequest): Promise<NextResponse | undefined> {\n    const paths = await getPaths();\n    if (!paths.has(req.nextUrl.pathname)) return undefined;\n    const res = NextResponse.next();\n    // Day-bucket stable Last-Modified so real users with If-Modified-Since\n    // still get 304s within the day; AI crawlers (which hit infrequently)\n    // get a fresh signal on the next UTC day rollover.\n    const dayBucket = Math.floor(Date.now() / 86_400_000) * 86_400_000;\n    res.headers.set(\"Last-Modified\", new Date(dayBucket).toUTCString());\n    res.headers.set(\"X-Smalk-Freshness\", \"bumped\");\n    return res;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC4BA,IAAM,mBAAmB;AACzB,IAAM,iBAAiB;AAEhB,SAAS,iBAA8B;AAC1C,QAAM,UAAU,QAAQ,IAAI,kBAAkB,QAAQ,IAAI,sBAAsB;AAChF,QAAM,SAAS,QAAQ,IAAI,iBAAiB;AAC5C,QAAM,aAAa,QAAQ,IAAI,qBAAqB;AACpD,QAAM,aAAa,QAAQ,IAAI,qBAAqB;AACpD,QAAM,aAAa,QAAQ,IAAI,qBAAqB;AAEpD,SAAO;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,eAAe;AAAA,IACf;AAAA,EACJ;AACJ;AAQA,SAAS,mBAAmB,SAAyB;AACjD,SAAO,QAAQ,QAAQ,mBAAmB,EAAE;AAChD;AASO,SAAS,aAAgC;AAC5C,QAAM,MAAM,eAAe;AAC3B,SAAO,EAAE,GAAG,KAAK,YAAY,mBAAmB,IAAI,OAAO,EAAE;AACjE;;;ACpEA,mBAA+B;AAC/B,oBAA0C;;;ACUnC,IAAM,0BAAN,MAAyD;AAAA,EACpD,QAAwC;AAAA,EAChD,MAAM,OAAO;AAAE,WAAO,KAAK;AAAA,EAAO;AAAA,EAClC,MAAM,MAAM,SAAkC;AAAE,SAAK,QAAQ;AAAA,EAAS;AAC1E;AAGO,IAAM,4BAAN,MAA2D;AAAA,EAC9D,YAAoB,UAAmB;AAAnB;AAAA,EAAoB;AAAA,EAApB;AAAA,EACpB,MAAM,OAAgD;AAClD,UAAM,KAAK,MAAM,OAAO,aAAkB;AAC1C,UAAM,OAAO,MAAM,OAAO,MAAW;AACrC,UAAM,KAAK,MAAM,OAAO,IAAS;AACjC,UAAM,IAAI,KAAK,YAAY,KAAK,KAAK,GAAG,OAAO,GAAG,4BAA4B;AAC9E,QAAI;AACA,aAAO,KAAK,MAAM,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAAA,IAClD,QAAQ;AACJ,aAAO;AAAA,IACX;AAAA,EACJ;AAAA,EACA,MAAM,MAAM,SAAkC;AAC1C,UAAM,KAAK,MAAM,OAAO,aAAkB;AAC1C,UAAM,OAAO,MAAM,OAAO,MAAW;AACrC,UAAM,KAAK,MAAM,OAAO,IAAS;AACjC,UAAM,IAAI,KAAK,YAAY,KAAK,KAAK,GAAG,OAAO,GAAG,4BAA4B;AAC9E,UAAM,GAAG,MAAM,KAAK,QAAQ,CAAC,GAAG,EAAE,WAAW,KAAK,CAAC;AACnD,UAAM,GAAG,UAAU,GAAG,KAAK,UAAU,OAAO,CAAC;AAAA,EACjD;AACJ;AAKA,IAAM,mBAAmB;AACzB,eAAe,eAAmH;AAE9H,SAAQ,MAAM;AAAA;AAAA;AAAA,IAAoD;AAAA;AAGtE;AAEO,IAAM,0BAAN,MAAyD;AAAA,EAC3C;AAAA,EACjB,YAAY,MAAM,yBAAyB;AAAE,SAAK,MAAM;AAAA,EAAK;AAAA,EAC7D,MAAM,OAAgD;AAClD,UAAM,EAAE,GAAG,IAAI,MAAM,aAAa;AAClC,UAAM,MAAM,MAAM,GAAG,IAAI,KAAK,GAAG;AACjC,QAAI,CAAC,IAAK,QAAO;AACjB,QAAI;AAAE,aAAO,OAAO,QAAQ,WAAW,KAAK,MAAM,GAAG,IAAK;AAAA,IAAiC,QACrF;AAAE,aAAO;AAAA,IAAM;AAAA,EACzB;AAAA,EACA,MAAM,MAAM,SAAkC;AAC1C,UAAM,EAAE,GAAG,IAAI,MAAM,aAAa;AAClC,UAAM,GAAG,IAAI,KAAK,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,EAClD;AACJ;AAGO,IAAM,8BAAN,MAA6D;AAAA,EAChE,YAAoB,WAAiH,MAAM,yBAAyB;AAAhJ;AAAiH;AAAA,EAAgC;AAAA,EAAjJ;AAAA,EAAiH;AAAA,EACrI,MAAM,OAAgD;AAClD,UAAM,MAAM,MAAM,KAAK,UAAU,IAAI,KAAK,GAAG;AAC7C,WAAO,MAAM,KAAK,MAAM,GAAG,IAAI;AAAA,EACnC;AAAA,EACA,MAAM,MAAM,SAAkC;AAC1C,UAAM,KAAK,UAAU,IAAI,KAAK,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,EAC9D;AACJ;AAGA,IAAI,eAAgC,IAAI,0BAA0B;AAE3D,SAAS,qBAAsC;AAClD,SAAO;AACX;AAEO,SAAS,mBAAmB,OAA8B;AAC7D,iBAAe;AACnB;;;ACvFA,eAAsB,gBAAgB,OAAiB;AACnD,QAAM,mBAAmB,EAAE,MAAM,EAAE,OAAO,YAAY,KAAK,IAAI,EAAE,CAAC;AACtE;AAEA,eAAsB,iBAA0D;AAC5E,SAAO,mBAAmB,EAAE,KAAK;AACrC;;;AFFA,eAAsB,gCAAgC,KAAkB;AACpE,QAAM,MAAM,eAAe;AAC3B,QAAM,SAAS,IAAI,QAAQ,IAAI,qBAAqB;AACpD,MAAI,CAAC,UAAU,WAAW,IAAI,YAAY;AACtC,WAAO,2BAAa,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EACvE;AAEA,QAAM,WAAW,GAAG,IAAI,OAAO,aAAa,IAAI,UAAU;AAC1D,QAAM,OAAO,MAAM,MAAM,UAAU;AAAA,IAC/B,SAAS;AAAA,MACL,aAAa,IAAI;AAAA,MACjB,eAAe;AAAA,MACf,kBAAkB,IAAI;AAAA,IAC1B;AAAA,IACA,OAAO;AAAA,EACX,CAAC;AACD,MAAI,CAAC,KAAK,IAAI;AACV,WAAO,2BAAa,KAAK,EAAE,OAAO,OAAO,KAAK,MAAM,GAAG,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC7E;AACA,QAAM,UAAW,MAAM,KAAK,KAAK;AACjC,QAAM,QAAQ,QAAQ,KACjB,IAAI,CAAC,MAAM,SAAS,EAAE,KAAK,IAAI,UAAU,CAAC,EAC1C,OAAO,CAAC,MAAmB,QAAQ,CAAC,CAAC;AAE1C,QAAM,gBAAgB,KAAK;AAE3B,MAAI,cAAc;AAClB,aAAW,KAAK,OAAO;AACnB,QAAI;AACA,uCAAe,CAAC;AAChB;AAAA,IACJ,SAAS,GAAG;AACR,cAAQ,KAAK,qCAAqC,CAAC,IAAI,CAAC;AAAA,IAC5D;AAAA,EACJ;AAEA,SAAO,2BAAa,KAAK;AAAA,IACrB,IAAI;AAAA,IACJ,OAAO,MAAM;AAAA,IACb;AAAA,IACA,SAAQ,oBAAI,KAAK,GAAE,YAAY;AAAA,EACnC,CAAC;AACL;AAEA,SAAS,SAAS,KAAa,YAAoC;AAC/D,MAAI;AACA,UAAM,IAAI,IAAI,IAAI,GAAG;AACrB,QAAI,cAAc,EAAE,SAAS,WAAY,QAAO;AAChD,WAAO,EAAE;AAAA,EACb,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;;;AG1DA,IAAAA,iBAA0C;AAI1C,IAAI,aAAiC;AACrC,IAAI,gBAAgB;AACpB,IAAM,qBAAqB;AAE3B,eAAe,WAAiC;AAC5C,QAAM,MAAM,KAAK,IAAI;AACrB,MAAI,CAAC,cAAc,MAAM,gBAAgB,oBAAoB;AACzD,UAAM,OAAO,MAAM,eAAe;AAClC,iBAAa,IAAI,IAAI,MAAM,SAAS,CAAC,CAAC;AACtC,oBAAgB;AAAA,EACpB;AACA,SAAO;AACX;AAEA,eAAsB,yBAAyB,KAAqD;AAChG,QAAM,QAAQ,MAAM,SAAS;AAC7B,MAAI,CAAC,MAAM,IAAI,IAAI,QAAQ,QAAQ,EAAG,QAAO;AAC7C,QAAM,MAAM,4BAAa,KAAK;AAI9B,QAAM,YAAY,KAAK,MAAM,KAAK,IAAI,IAAI,KAAU,IAAI;AACxD,MAAI,QAAQ,IAAI,iBAAiB,IAAI,KAAK,SAAS,EAAE,YAAY,CAAC;AAClE,MAAI,QAAQ,IAAI,qBAAqB,QAAQ;AAC7C,SAAO;AACX;;;ALXO,IAAM,qBAAqB;AAC3B,IAAM,uBAAuB;AAC7B,IAAM,WAAW;","names":["import_server"]}

package/dist/index.d.cts

@@ -1,8 +1,93 @@
-interface SmalkAdsConfig {
-    projectKey: string;
+import { NextRequest, NextResponse } from 'next/server';
+
+interface SmalkConfig {
+    /** Full API base including version path, e.g. https://api.smalk.ai/api/v1 */
+    apiBase: string;
     apiKey: string;
+    projectKey: string;
+    cronSecret: string;
+    pluginVersion: string;
+    publicHost?: string;
+}
+/**
+ * Backwards-compatible config shape for legacy callers (pre-P2). Adds an
+ * `apiBaseUrl` alias for `apiBase`. New code should use `getSmalkConfig()`
+ * and read `apiBase` directly.
+ */
+interface LegacySmalkConfig extends SmalkConfig {
+    /**
+     * @deprecated Use `apiBase` instead.
+     *
+     * Pre-P2.5 shape: host-only (e.g. `https://api.smalk.ai`), and external
+     * publisher code appended `/api/v1/...`. To preserve that shape after the
+     * P2.5 Next config unify (which moved `/api/v1` into the canonical
+     * `apiBase`), this field strips a trailing `/api/vN` segment from
+     * `apiBase` before exposing it. New code should read `apiBase` directly.
+     */
     apiBaseUrl: string;
 }
+declare function getSmalkConfig(): SmalkConfig;
+/**
+ * Legacy loader retained for external consumers (publisher apps) that import
+ * `loadConfig` from `@smalk/nextjs-ads`. Returns the canonical `SmalkConfig`
+ * plus an `apiBaseUrl` alias whose shape matches the pre-P2.5 contract
+ * (host-only, no `/api/v1` suffix). New code should prefer `getSmalkConfig()`
+ * and read `apiBase` directly.
+ */
+declare function loadConfig(): LegacySmalkConfig;
+
+declare function smalkFreshnessRevalidateHandler(req: NextRequest): Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    ok: boolean;
+    total: number;
+    revalidated: number;
+    ran_at: string;
+}>>;
+
+declare function smalkFreshnessMiddleware(req: NextRequest): Promise<NextResponse | undefined>;
+
+interface ActiveUrlsCachedPayload {
+    paths: string[];
+    updated_at: number;
+}
+interface ActiveUrlsStore {
+    read(): Promise<ActiveUrlsCachedPayload | null>;
+    write(payload: ActiveUrlsCachedPayload): Promise<void>;
+}
+declare class InMemoryActiveUrlsStore implements ActiveUrlsStore {
+    private value;
+    read(): Promise<ActiveUrlsCachedPayload | null>;
+    write(payload: ActiveUrlsCachedPayload): Promise<void>;
+}
+declare class FilesystemActiveUrlsStore implements ActiveUrlsStore {
+    private filePath?;
+    constructor(filePath?: string | undefined);
+    read(): Promise<ActiveUrlsCachedPayload | null>;
+    write(payload: ActiveUrlsCachedPayload): Promise<void>;
+}
+declare class VercelKVActiveUrlsStore implements ActiveUrlsStore {
+    private readonly key;
+    constructor(key?: string);
+    read(): Promise<ActiveUrlsCachedPayload | null>;
+    write(payload: ActiveUrlsCachedPayload): Promise<void>;
+}
+declare class CloudflareKVActiveUrlsStore implements ActiveUrlsStore {
+    private namespace;
+    private key;
+    constructor(namespace: {
+        get(key: string): Promise<string | null>;
+        put(key: string, value: string): Promise<void>;
+    }, key?: string);
+    read(): Promise<ActiveUrlsCachedPayload | null>;
+    write(payload: ActiveUrlsCachedPayload): Promise<void>;
+}
+declare function getActiveUrlsStore(): ActiveUrlsStore;
+declare function setActiveUrlsStore(store: ActiveUrlsStore): void;
+
+declare function cacheActiveUrls(paths: string[]): Promise<void>;
+declare function readActiveUrls(): Promise<ActiveUrlsCachedPayload | null>;
+
 interface AdInput {
     pageUrl: string;
     userAgent: string;
@@ -20,7 +105,6 @@ interface ApiResponse {
 }
 declare const DEFAULT_TIMEOUT_MS = 100;
 declare const DEFAULT_REVALIDATE_S = 1200;
-declare const API_PATH = "/api/v1/transform/ads/content/";
-declare function loadConfig(): SmalkAdsConfig;
+declare const API_PATH = "/transform/ads/content/";
 
-export { API_PATH, type AdInput, type AdResult, type ApiResponse, DEFAULT_REVALIDATE_S, DEFAULT_TIMEOUT_MS, type SmalkAdsConfig, loadConfig };
+export { API_PATH, type ActiveUrlsCachedPayload, type ActiveUrlsStore, type AdInput, type AdResult, type ApiResponse, CloudflareKVActiveUrlsStore, DEFAULT_REVALIDATE_S, DEFAULT_TIMEOUT_MS, FilesystemActiveUrlsStore, InMemoryActiveUrlsStore, type LegacySmalkConfig, type LegacySmalkConfig as SmalkAdsConfig, type SmalkConfig, VercelKVActiveUrlsStore, cacheActiveUrls, getActiveUrlsStore, getSmalkConfig, loadConfig, readActiveUrls, setActiveUrlsStore, smalkFreshnessMiddleware, smalkFreshnessRevalidateHandler };

package/dist/index.d.ts

@@ -1,8 +1,93 @@
-interface SmalkAdsConfig {
-    projectKey: string;
+import { NextRequest, NextResponse } from 'next/server';
+
+interface SmalkConfig {
+    /** Full API base including version path, e.g. https://api.smalk.ai/api/v1 */
+    apiBase: string;
     apiKey: string;
+    projectKey: string;
+    cronSecret: string;
+    pluginVersion: string;
+    publicHost?: string;
+}
+/**
+ * Backwards-compatible config shape for legacy callers (pre-P2). Adds an
+ * `apiBaseUrl` alias for `apiBase`. New code should use `getSmalkConfig()`
+ * and read `apiBase` directly.
+ */
+interface LegacySmalkConfig extends SmalkConfig {
+    /**
+     * @deprecated Use `apiBase` instead.
+     *
+     * Pre-P2.5 shape: host-only (e.g. `https://api.smalk.ai`), and external
+     * publisher code appended `/api/v1/...`. To preserve that shape after the
+     * P2.5 Next config unify (which moved `/api/v1` into the canonical
+     * `apiBase`), this field strips a trailing `/api/vN` segment from
+     * `apiBase` before exposing it. New code should read `apiBase` directly.
+     */
     apiBaseUrl: string;
 }
+declare function getSmalkConfig(): SmalkConfig;
+/**
+ * Legacy loader retained for external consumers (publisher apps) that import
+ * `loadConfig` from `@smalk/nextjs-ads`. Returns the canonical `SmalkConfig`
+ * plus an `apiBaseUrl` alias whose shape matches the pre-P2.5 contract
+ * (host-only, no `/api/v1` suffix). New code should prefer `getSmalkConfig()`
+ * and read `apiBase` directly.
+ */
+declare function loadConfig(): LegacySmalkConfig;
+
+declare function smalkFreshnessRevalidateHandler(req: NextRequest): Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    ok: boolean;
+    total: number;
+    revalidated: number;
+    ran_at: string;
+}>>;
+
+declare function smalkFreshnessMiddleware(req: NextRequest): Promise<NextResponse | undefined>;
+
+interface ActiveUrlsCachedPayload {
+    paths: string[];
+    updated_at: number;
+}
+interface ActiveUrlsStore {
+    read(): Promise<ActiveUrlsCachedPayload | null>;
+    write(payload: ActiveUrlsCachedPayload): Promise<void>;
+}
+declare class InMemoryActiveUrlsStore implements ActiveUrlsStore {
+    private value;
+    read(): Promise<ActiveUrlsCachedPayload | null>;
+    write(payload: ActiveUrlsCachedPayload): Promise<void>;
+}
+declare class FilesystemActiveUrlsStore implements ActiveUrlsStore {
+    private filePath?;
+    constructor(filePath?: string | undefined);
+    read(): Promise<ActiveUrlsCachedPayload | null>;
+    write(payload: ActiveUrlsCachedPayload): Promise<void>;
+}
+declare class VercelKVActiveUrlsStore implements ActiveUrlsStore {
+    private readonly key;
+    constructor(key?: string);
+    read(): Promise<ActiveUrlsCachedPayload | null>;
+    write(payload: ActiveUrlsCachedPayload): Promise<void>;
+}
+declare class CloudflareKVActiveUrlsStore implements ActiveUrlsStore {
+    private namespace;
+    private key;
+    constructor(namespace: {
+        get(key: string): Promise<string | null>;
+        put(key: string, value: string): Promise<void>;
+    }, key?: string);
+    read(): Promise<ActiveUrlsCachedPayload | null>;
+    write(payload: ActiveUrlsCachedPayload): Promise<void>;
+}
+declare function getActiveUrlsStore(): ActiveUrlsStore;
+declare function setActiveUrlsStore(store: ActiveUrlsStore): void;
+
+declare function cacheActiveUrls(paths: string[]): Promise<void>;
+declare function readActiveUrls(): Promise<ActiveUrlsCachedPayload | null>;
+
 interface AdInput {
     pageUrl: string;
     userAgent: string;
@@ -20,7 +105,6 @@ interface ApiResponse {
 }
 declare const DEFAULT_TIMEOUT_MS = 100;
 declare const DEFAULT_REVALIDATE_S = 1200;
-declare const API_PATH = "/api/v1/transform/ads/content/";
-declare function loadConfig(): SmalkAdsConfig;
+declare const API_PATH = "/transform/ads/content/";
 
-export { API_PATH, type AdInput, type AdResult, type ApiResponse, DEFAULT_REVALIDATE_S, DEFAULT_TIMEOUT_MS, type SmalkAdsConfig, loadConfig };
+export { API_PATH, type ActiveUrlsCachedPayload, type ActiveUrlsStore, type AdInput, type AdResult, type ApiResponse, CloudflareKVActiveUrlsStore, DEFAULT_REVALIDATE_S, DEFAULT_TIMEOUT_MS, FilesystemActiveUrlsStore, InMemoryActiveUrlsStore, type LegacySmalkConfig, type LegacySmalkConfig as SmalkAdsConfig, type SmalkConfig, VercelKVActiveUrlsStore, cacheActiveUrls, getActiveUrlsStore, getSmalkConfig, loadConfig, readActiveUrls, setActiveUrlsStore, smalkFreshnessMiddleware, smalkFreshnessRevalidateHandler };

package/dist/index.js

@@ -1,13 +1,35 @@
 import {
   API_PATH,
+  CloudflareKVActiveUrlsStore,
   DEFAULT_REVALIDATE_S,
   DEFAULT_TIMEOUT_MS,
-  loadConfig
-} from "./chunk-HX4ZGDYQ.js";
+  FilesystemActiveUrlsStore,
+  InMemoryActiveUrlsStore,
+  VercelKVActiveUrlsStore,
+  cacheActiveUrls,
+  getActiveUrlsStore,
+  getSmalkConfig,
+  loadConfig,
+  readActiveUrls,
+  setActiveUrlsStore,
+  smalkFreshnessMiddleware,
+  smalkFreshnessRevalidateHandler
+} from "./chunk-4QWOGJYF.js";
 export {
   API_PATH,
+  CloudflareKVActiveUrlsStore,
   DEFAULT_REVALIDATE_S,
   DEFAULT_TIMEOUT_MS,
-  loadConfig
+  FilesystemActiveUrlsStore,
+  InMemoryActiveUrlsStore,
+  VercelKVActiveUrlsStore,
+  cacheActiveUrls,
+  getActiveUrlsStore,
+  getSmalkConfig,
+  loadConfig,
+  readActiveUrls,
+  setActiveUrlsStore,
+  smalkFreshnessMiddleware,
+  smalkFreshnessRevalidateHandler
 };
 //# sourceMappingURL=index.js.map