@mailoo/next-core 0.0.0-stage → 1.33.0

package/LICENSE

@@ -0,0 +1,16 @@
+Mailoo Integrator Use License
+
+Copyright (c) 2026 Mailoo
+
+Permission is granted to use, install, and distribute this software in
+unmodified form, including as a dependency of an application.
+
+Modification of this software is not permitted.
+
+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,23 @@
-# Temporary Holding Version
+# `@mailoo/next-core`
 
-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.
+Shared Next.js BFF helpers for Mailoo integration modules (`@mailoo/blog`,
+`@mailoo/forms`, `@mailoo/chat`, `@mailoo/images`, `@mailoo/market`).
+
+## Install
+
+```bash
+pnpm add @mailoo/next-core
+```
+
+Published on npm as `@mailoo/next-core`.
+
+## Exports
+
+- `readMailooIntegrationConfig` / `requireMailooIntegrationConfig` — env-based config
+- `proxyMailooWebhookJsonPost` / `proxyMailooApiGet` — server-side Mailoo API proxy;
+  network failure returns HTTP **502** JSON (never throws)
+- `@mailoo/next-core/request-origin` → `getRequestOriginBaseUrl` — absolute origin from request headers (RSC only; keep off the main barrel so client graphs never import `next/headers`)
+- `jsonError` — JSON error Response helper
+
+Hosts must treat Mailoo as a feature: check BFF status / Result objects so a
+down API does not 500 the whole site.

package/dist/index.cjs

@@ -0,0 +1,127 @@
+'use strict';
+
+// src/types.ts
+var defaultMailooLogger = {
+  error: (message, ...args) => {
+    console.error(message, ...args);
+  },
+  warn: (message, ...args) => {
+    console.warn(message, ...args);
+  },
+  logException: (error, message) => {
+    console.error(message, error);
+  }
+};
+
+// src/env.ts
+function trimEnv(value) {
+  const v = value?.trim();
+  return v || void 0;
+}
+function readMailooIntegrationConfig(options) {
+  const { prefix, allowApiBaseUrlFallback = false } = options;
+  const apiKey = trimEnv(process.env[`${prefix}_API_KEY`]);
+  const projectUid = trimEnv(process.env[`${prefix}_PROJECT_UID`]);
+  const integrationId = trimEnv(process.env[`${prefix}_ID`]) || trimEnv(process.env[`${prefix}_INTEGRATION_ID`]);
+  let apiBase = trimEnv(process.env[`${prefix}_API`]) || (allowApiBaseUrlFallback ? trimEnv(process.env.API_BASE_URL) : void 0);
+  if (!apiKey || !projectUid || !integrationId || !apiBase) {
+    return null;
+  }
+  apiBase = apiBase.replace(/\/$/, "");
+  return {
+    apiBaseUrl: apiBase,
+    apiKey,
+    projectUid,
+    integrationId
+  };
+}
+function requireMailooIntegrationConfig(options) {
+  const config = readMailooIntegrationConfig(options);
+  if (!config) {
+    throw new Error(
+      options.missingMessage ?? `${options.prefix}_API, ${options.prefix}_API_KEY, ${options.prefix}_PROJECT_UID and ${options.prefix}_ID (or _INTEGRATION_ID) must be set`
+    );
+  }
+  return config;
+}
+
+// src/upstream-origin.ts
+function mailooUpstreamOrigin(request) {
+  const raw = request.headers.get("origin")?.trim();
+  if (!raw) return void 0;
+  try {
+    const u = new URL(raw);
+    if (u.protocol !== "http:" && u.protocol !== "https:") return void 0;
+    return u.origin;
+  } catch {
+    return void 0;
+  }
+}
+
+// src/proxy-webhook.ts
+function jsonError(body, status) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+var UPSTREAM_FAILED = {
+  success: false,
+  error: "Upstream request failed",
+  message: "Upstream request failed"
+};
+async function proxyMailooWebhookJsonPost(options) {
+  const { request, url, apiKey, body } = options;
+  const headers = {
+    "Content-Type": "application/json",
+    "X-API-Key": apiKey
+  };
+  const origin = mailooUpstreamOrigin(request);
+  if (origin) headers.Origin = origin;
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body)
+    });
+    const data = await response.json().catch(() => ({}));
+    return new Response(JSON.stringify(data), {
+      status: response.status,
+      headers: { "Content-Type": "application/json" }
+    });
+  } catch {
+    return jsonError(UPSTREAM_FAILED, 502);
+  }
+}
+async function proxyMailooApiGet(options) {
+  const headers = {
+    "Content-Type": "application/json",
+    "X-API-Key": options.apiKey
+  };
+  if (options.origin) {
+    headers.Origin = options.origin;
+  }
+  try {
+    const response = await fetch(options.url, {
+      method: "GET",
+      headers
+    });
+    const data = await response.json().catch(() => ({}));
+    return new Response(JSON.stringify(data), {
+      status: response.status,
+      headers: { "Content-Type": "application/json" }
+    });
+  } catch {
+    return jsonError(UPSTREAM_FAILED, 502);
+  }
+}
+
+exports.defaultMailooLogger = defaultMailooLogger;
+exports.jsonError = jsonError;
+exports.mailooUpstreamOrigin = mailooUpstreamOrigin;
+exports.proxyMailooApiGet = proxyMailooApiGet;
+exports.proxyMailooWebhookJsonPost = proxyMailooWebhookJsonPost;
+exports.readMailooIntegrationConfig = readMailooIntegrationConfig;
+exports.requireMailooIntegrationConfig = requireMailooIntegrationConfig;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/env.ts","../src/upstream-origin.ts","../src/proxy-webhook.ts"],"names":[],"mappings":";;;AAcO,IAAM,mBAAA,GAAoC;AAAA,EAC/C,KAAA,EAAO,CAAC,OAAA,EAAA,GAAY,IAAA,KAAS;AAC3B,IAAA,OAAA,CAAQ,KAAA,CAAM,OAAA,EAAS,GAAG,IAAI,CAAA;AAAA,EAChC,CAAA;AAAA,EACA,IAAA,EAAM,CAAC,OAAA,EAAA,GAAY,IAAA,KAAS;AAC1B,IAAA,OAAA,CAAQ,IAAA,CAAK,OAAA,EAAS,GAAG,IAAI,CAAA;AAAA,EAC/B,CAAA;AAAA,EACA,YAAA,EAAc,CAAC,KAAA,EAAO,OAAA,KAAY;AAChC,IAAA,OAAA,CAAQ,KAAA,CAAM,SAAS,KAAK,CAAA;AAAA,EAC9B;AACF;;;ACtBA,SAAS,QAAQ,KAAA,EAA+C;AAC9D,EAAA,MAAM,CAAA,GAAI,OAAO,IAAA,EAAK;AACtB,EAAA,OAAO,CAAA,IAAK,MAAA;AACd;AAYO,SAAS,4BAA4B,OAAA,EAIT;AACjC,EAAA,MAAM,EAAE,MAAA,EAAQ,uBAAA,GAA0B,KAAA,EAAM,GAAI,OAAA;AACpD,EAAA,MAAM,SAAS,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA,EAAG,MAAM,UAAU,CAAC,CAAA;AACvD,EAAA,MAAM,aAAa,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA,EAAG,MAAM,cAAc,CAAC,CAAA;AAC/D,EAAA,MAAM,aAAA,GACJ,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,GAAG,MAAM,CAAA,GAAA,CAAK,CAAC,CAAA,IACnC,QAAQ,OAAA,CAAQ,GAAA,CAAI,CAAA,EAAG,MAAM,iBAAiB,CAAC,CAAA;AACjD,EAAA,IAAI,OAAA,GACF,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,GAAG,MAAM,CAAA,IAAA,CAAM,CAAC,CAAA,KACnC,uBAAA,GAA0B,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,YAAY,CAAA,GAAI,MAAA,CAAA;AAEjE,EAAA,IAAI,CAAC,MAAA,IAAU,CAAC,cAAc,CAAC,aAAA,IAAiB,CAAC,OAAA,EAAS;AACxD,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAA,GAAU,OAAA,CAAQ,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AACnC,EAAA,OAAO;AAAA,IACL,UAAA,EAAY,OAAA;AAAA,IACZ,MAAA;AAAA,IACA,UAAA;AAAA,IACA;AAAA,GACF;AACF;AAGO,SAAS,+BAA+B,OAAA,EAInB;AAC1B,EAAA,MAAM,MAAA,GAAS,4BAA4B,OAAO,CAAA;AAClD,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,OAAA,CAAQ,cAAA,IACN,CAAA,EAAG,OAAA,CAAQ,MAAM,CAAA,MAAA,EAAS,OAAA,CAAQ,MAAM,CAAA,UAAA,EAAa,OAAA,CAAQ,MAAM,CAAA,iBAAA,EAAoB,QAAQ,MAAM,CAAA,oCAAA;AAAA,KACzG;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;;;ACrDO,SAAS,qBACd,OAAA,EACoB;AACpB,EAAA,MAAM,MAAM,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,QAAQ,GAAG,IAAA,EAAK;AAChD,EAAA,IAAI,CAAC,KAAK,OAAO,MAAA;AACjB,EAAA,IAAI;AACF,IAAA,MAAM,CAAA,GAAI,IAAI,GAAA,CAAI,GAAG,CAAA;AACrB,IAAA,IAAI,EAAE,QAAA,KAAa,OAAA,IAAW,CAAA,CAAE,QAAA,KAAa,UAAU,OAAO,KAAA,CAAA;AAC9D,IAAA,OAAO,CAAA,CAAE,MAAA;AAAA,EACX,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,MAAA;AAAA,EACT;AACF;;;ACdO,SAAS,SAAA,CAAU,MAAe,MAAA,EAA0B;AACjE,EAAA,OAAO,IAAI,QAAA,CAAS,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,EAAG;AAAA,IACxC,MAAA;AAAA,IACA,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA;AAAmB,GAC/C,CAAA;AACH;AAEA,IAAM,eAAA,GAAkB;AAAA,EACtB,OAAA,EAAS,KAAA;AAAA,EACT,KAAA,EAAO,yBAAA;AAAA,EACP,OAAA,EAAS;AACX,CAAA;AAOA,eAAsB,2BAA2B,OAAA,EAK3B;AACpB,EAAA,MAAM,EAAE,OAAA,EAAS,GAAA,EAAK,MAAA,EAAQ,MAAK,GAAI,OAAA;AACvC,EAAA,MAAM,OAAA,GAAkC;AAAA,IACtC,cAAA,EAAgB,kBAAA;AAAA,IAChB,WAAA,EAAa;AAAA,GACf;AACA,EAAA,MAAM,MAAA,GAAS,qBAAqB,OAAO,CAAA;AAC3C,EAAA,IAAI,MAAA,UAAgB,MAAA,GAAS,MAAA;AAE7B,EAAA,IAAI;AACF,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,MAChC,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA;AAAA,MACA,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,KAC1B,CAAA;AACD,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,GAAO,KAAA,CAAM,OAAO,EAAC,CAAE,CAAA;AACnD,IAAA,OAAO,IAAI,QAAA,CAAS,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,EAAG;AAAA,MACxC,QAAQ,QAAA,CAAS,MAAA;AAAA,MACjB,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA;AAAmB,KAC/C,CAAA;AAAA,EACH,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,SAAA,CAAU,iBAAiB,GAAG,CAAA;AAAA,EACvC;AACF;AAMA,eAAsB,kBAAkB,OAAA,EAIlB;AACpB,EAAA,MAAM,OAAA,GAAkC;AAAA,IACtC,cAAA,EAAgB,kBAAA;AAAA,IAChB,aAAa,OAAA,CAAQ;AAAA,GACvB;AACA,EAAA,IAAI,QAAQ,MAAA,EAAQ;AAClB,IAAA,OAAA,CAAQ,SAAS,OAAA,CAAQ,MAAA;AAAA,EAC3B;AACA,EAAA,IAAI;AACF,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,OAAA,CAAQ,GAAA,EAAK;AAAA,MACxC,MAAA,EAAQ,KAAA;AAAA,MACR;AAAA,KACD,CAAA;AACD,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,GAAO,KAAA,CAAM,OAAO,EAAC,CAAE,CAAA;AACnD,IAAA,OAAO,IAAI,QAAA,CAAS,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,EAAG;AAAA,MACxC,QAAQ,QAAA,CAAS,MAAA;AAAA,MACjB,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA;AAAmB,KAC/C,CAAA;AAAA,EACH,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,SAAA,CAAU,iBAAiB,GAAG,CAAA;AAAA,EACvC;AACF","file":"index.cjs","sourcesContent":["/** Common Mailoo integration credentials (server-only). */\nexport type MailooIntegrationConfig = {\n  apiBaseUrl: string\n  apiKey: string\n  projectUid: string\n  integrationId: string\n}\n\nexport type MailooLogger = {\n  error: (message: string, ...args: unknown[]) => void\n  warn?: (message: string, ...args: unknown[]) => void\n  logException?: (error: unknown, message: string) => void\n}\n\nexport const defaultMailooLogger: MailooLogger = {\n  error: (message, ...args) => {\n    console.error(message, ...args)\n  },\n  warn: (message, ...args) => {\n    console.warn(message, ...args)\n  },\n  logException: (error, message) => {\n    console.error(message, error)\n  },\n}\n","import type { MailooIntegrationConfig } from './types.js'\n\nfunction trimEnv(value: string | undefined): string | undefined {\n  const v = value?.trim()\n  return v || undefined\n}\n\n/**\n * Read a Mailoo integration config from env var prefixes.\n * Example prefixes: `MAILOO_BLOG`, `MAILOO_CHAT_INTEGRATION`.\n *\n * Looks for:\n * - `{PREFIX}_API` or `{PREFIX}_API` + fallback `API_BASE_URL`\n * - `{PREFIX}_API_KEY`\n * - `{PREFIX}_PROJECT_UID`\n * - `{PREFIX}_ID` or `{PREFIX}_INTEGRATION_ID`\n */\nexport function readMailooIntegrationConfig(options: {\n  prefix: string\n  /** When API base is missing, fall back to API_BASE_URL */\n  allowApiBaseUrlFallback?: boolean\n}): MailooIntegrationConfig | null {\n  const { prefix, allowApiBaseUrlFallback = false } = options\n  const apiKey = trimEnv(process.env[`${prefix}_API_KEY`])\n  const projectUid = trimEnv(process.env[`${prefix}_PROJECT_UID`])\n  const integrationId =\n    trimEnv(process.env[`${prefix}_ID`]) ||\n    trimEnv(process.env[`${prefix}_INTEGRATION_ID`])\n  let apiBase =\n    trimEnv(process.env[`${prefix}_API`]) ||\n    (allowApiBaseUrlFallback ? trimEnv(process.env.API_BASE_URL) : undefined)\n\n  if (!apiKey || !projectUid || !integrationId || !apiBase) {\n    return null\n  }\n\n  apiBase = apiBase.replace(/\\/$/, '')\n  return {\n    apiBaseUrl: apiBase,\n    apiKey,\n    projectUid,\n    integrationId,\n  }\n}\n\n/** Require all four env vars; throw if any missing (fail-fast). */\nexport function requireMailooIntegrationConfig(options: {\n  prefix: string\n  allowApiBaseUrlFallback?: boolean\n  missingMessage?: string\n}): MailooIntegrationConfig {\n  const config = readMailooIntegrationConfig(options)\n  if (!config) {\n    throw new Error(\n      options.missingMessage ??\n        `${options.prefix}_API, ${options.prefix}_API_KEY, ${options.prefix}_PROJECT_UID and ${options.prefix}_ID (or _INTEGRATION_ID) must be set`\n    )\n  }\n  return config\n}\n","/**\n * Origin to forward from a Next BFF to Mailoo webhook APIs.\n * Never use Referer — path-bearing Referers fail exact allowedOrigins checks.\n * When the browser sends no Origin (typical same-origin GET), omit the header\n * so the API treats the call as server-to-server.\n */\nexport function mailooUpstreamOrigin(\n  request: { headers: { get(name: string): string | null } }\n): string | undefined {\n  const raw = request.headers.get('origin')?.trim()\n  if (!raw) return undefined\n  try {\n    const u = new URL(raw)\n    if (u.protocol !== 'http:' && u.protocol !== 'https:') return undefined\n    return u.origin\n  } catch {\n    return undefined\n  }\n}\n","import type { NextRequest } from 'next/server'\nimport { mailooUpstreamOrigin } from './upstream-origin.js'\n\n/** JSON error Response helper. */\nexport function jsonError(body: unknown, status: number): Response {\n  return new Response(JSON.stringify(body), {\n    status,\n    headers: { 'Content-Type': 'application/json' },\n  })\n}\n\nconst UPSTREAM_FAILED = {\n  success: false,\n  error: 'Upstream request failed',\n  message: 'Upstream request failed',\n} as const\n\n/**\n * Forward JSON to a Mailoo webhook URL with server-held API key.\n * Forwards a real browser Origin when present (never Referer).\n * Network / non-JSON upstream failures return HTTP 502 JSON (never throw).\n */\nexport async function proxyMailooWebhookJsonPost(options: {\n  request: NextRequest\n  url: string\n  apiKey: string\n  body: unknown\n}): Promise<Response> {\n  const { request, url, apiKey, body } = options\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'X-API-Key': apiKey,\n  }\n  const origin = mailooUpstreamOrigin(request)\n  if (origin) headers.Origin = origin\n\n  try {\n    const response = await fetch(url, {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(body),\n    })\n    const data = await response.json().catch(() => ({}))\n    return new Response(JSON.stringify(data), {\n      status: response.status,\n      headers: { 'Content-Type': 'application/json' },\n    })\n  } catch {\n    return jsonError(UPSTREAM_FAILED, 502)\n  }\n}\n\n/**\n * Proxy a GET to Mailoo API with X-API-Key.\n * Network / non-JSON upstream failures return HTTP 502 JSON (never throw).\n */\nexport async function proxyMailooApiGet(options: {\n  url: string\n  apiKey: string\n  origin?: string\n}): Promise<Response> {\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'X-API-Key': options.apiKey,\n  }\n  if (options.origin) {\n    headers.Origin = options.origin\n  }\n  try {\n    const response = await fetch(options.url, {\n      method: 'GET',\n      headers,\n    })\n    const data = await response.json().catch(() => ({}))\n    return new Response(JSON.stringify(data), {\n      status: response.status,\n      headers: { 'Content-Type': 'application/json' },\n    })\n  } catch {\n    return jsonError(UPSTREAM_FAILED, 502)\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,74 @@
+import { NextRequest } from 'next/server';
+
+/** Common Mailoo integration credentials (server-only). */
+type MailooIntegrationConfig = {
+    apiBaseUrl: string;
+    apiKey: string;
+    projectUid: string;
+    integrationId: string;
+};
+type MailooLogger = {
+    error: (message: string, ...args: unknown[]) => void;
+    warn?: (message: string, ...args: unknown[]) => void;
+    logException?: (error: unknown, message: string) => void;
+};
+declare const defaultMailooLogger: MailooLogger;
+
+/**
+ * Read a Mailoo integration config from env var prefixes.
+ * Example prefixes: `MAILOO_BLOG`, `MAILOO_CHAT_INTEGRATION`.
+ *
+ * Looks for:
+ * - `{PREFIX}_API` or `{PREFIX}_API` + fallback `API_BASE_URL`
+ * - `{PREFIX}_API_KEY`
+ * - `{PREFIX}_PROJECT_UID`
+ * - `{PREFIX}_ID` or `{PREFIX}_INTEGRATION_ID`
+ */
+declare function readMailooIntegrationConfig(options: {
+    prefix: string;
+    /** When API base is missing, fall back to API_BASE_URL */
+    allowApiBaseUrlFallback?: boolean;
+}): MailooIntegrationConfig | null;
+/** Require all four env vars; throw if any missing (fail-fast). */
+declare function requireMailooIntegrationConfig(options: {
+    prefix: string;
+    allowApiBaseUrlFallback?: boolean;
+    missingMessage?: string;
+}): MailooIntegrationConfig;
+
+/** JSON error Response helper. */
+declare function jsonError(body: unknown, status: number): Response;
+/**
+ * Forward JSON to a Mailoo webhook URL with server-held API key.
+ * Forwards a real browser Origin when present (never Referer).
+ * Network / non-JSON upstream failures return HTTP 502 JSON (never throw).
+ */
+declare function proxyMailooWebhookJsonPost(options: {
+    request: NextRequest;
+    url: string;
+    apiKey: string;
+    body: unknown;
+}): Promise<Response>;
+/**
+ * Proxy a GET to Mailoo API with X-API-Key.
+ * Network / non-JSON upstream failures return HTTP 502 JSON (never throw).
+ */
+declare function proxyMailooApiGet(options: {
+    url: string;
+    apiKey: string;
+    origin?: string;
+}): Promise<Response>;
+
+/**
+ * Origin to forward from a Next BFF to Mailoo webhook APIs.
+ * Never use Referer — path-bearing Referers fail exact allowedOrigins checks.
+ * When the browser sends no Origin (typical same-origin GET), omit the header
+ * so the API treats the call as server-to-server.
+ */
+declare function mailooUpstreamOrigin(request: {
+    headers: {
+        get(name: string): string | null;
+    };
+}): string | undefined;
+
+export { type MailooIntegrationConfig, type MailooLogger, defaultMailooLogger, jsonError, mailooUpstreamOrigin, proxyMailooApiGet, proxyMailooWebhookJsonPost, readMailooIntegrationConfig, requireMailooIntegrationConfig };

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+import { NextRequest } from 'next/server';
+
+/** Common Mailoo integration credentials (server-only). */
+type MailooIntegrationConfig = {
+    apiBaseUrl: string;
+    apiKey: string;
+    projectUid: string;
+    integrationId: string;
+};
+type MailooLogger = {
+    error: (message: string, ...args: unknown[]) => void;
+    warn?: (message: string, ...args: unknown[]) => void;
+    logException?: (error: unknown, message: string) => void;
+};
+declare const defaultMailooLogger: MailooLogger;
+
+/**
+ * Read a Mailoo integration config from env var prefixes.
+ * Example prefixes: `MAILOO_BLOG`, `MAILOO_CHAT_INTEGRATION`.
+ *
+ * Looks for:
+ * - `{PREFIX}_API` or `{PREFIX}_API` + fallback `API_BASE_URL`
+ * - `{PREFIX}_API_KEY`
+ * - `{PREFIX}_PROJECT_UID`
+ * - `{PREFIX}_ID` or `{PREFIX}_INTEGRATION_ID`
+ */
+declare function readMailooIntegrationConfig(options: {
+    prefix: string;
+    /** When API base is missing, fall back to API_BASE_URL */
+    allowApiBaseUrlFallback?: boolean;
+}): MailooIntegrationConfig | null;
+/** Require all four env vars; throw if any missing (fail-fast). */
+declare function requireMailooIntegrationConfig(options: {
+    prefix: string;
+    allowApiBaseUrlFallback?: boolean;
+    missingMessage?: string;
+}): MailooIntegrationConfig;
+
+/** JSON error Response helper. */
+declare function jsonError(body: unknown, status: number): Response;
+/**
+ * Forward JSON to a Mailoo webhook URL with server-held API key.
+ * Forwards a real browser Origin when present (never Referer).
+ * Network / non-JSON upstream failures return HTTP 502 JSON (never throw).
+ */
+declare function proxyMailooWebhookJsonPost(options: {
+    request: NextRequest;
+    url: string;
+    apiKey: string;
+    body: unknown;
+}): Promise<Response>;
+/**
+ * Proxy a GET to Mailoo API with X-API-Key.
+ * Network / non-JSON upstream failures return HTTP 502 JSON (never throw).
+ */
+declare function proxyMailooApiGet(options: {
+    url: string;
+    apiKey: string;
+    origin?: string;
+}): Promise<Response>;
+
+/**
+ * Origin to forward from a Next BFF to Mailoo webhook APIs.
+ * Never use Referer — path-bearing Referers fail exact allowedOrigins checks.
+ * When the browser sends no Origin (typical same-origin GET), omit the header
+ * so the API treats the call as server-to-server.
+ */
+declare function mailooUpstreamOrigin(request: {
+    headers: {
+        get(name: string): string | null;
+    };
+}): string | undefined;
+
+export { type MailooIntegrationConfig, type MailooLogger, defaultMailooLogger, jsonError, mailooUpstreamOrigin, proxyMailooApiGet, proxyMailooWebhookJsonPost, readMailooIntegrationConfig, requireMailooIntegrationConfig };

package/dist/index.js

@@ -0,0 +1,119 @@
+// src/types.ts
+var defaultMailooLogger = {
+  error: (message, ...args) => {
+    console.error(message, ...args);
+  },
+  warn: (message, ...args) => {
+    console.warn(message, ...args);
+  },
+  logException: (error, message) => {
+    console.error(message, error);
+  }
+};
+
+// src/env.ts
+function trimEnv(value) {
+  const v = value?.trim();
+  return v || void 0;
+}
+function readMailooIntegrationConfig(options) {
+  const { prefix, allowApiBaseUrlFallback = false } = options;
+  const apiKey = trimEnv(process.env[`${prefix}_API_KEY`]);
+  const projectUid = trimEnv(process.env[`${prefix}_PROJECT_UID`]);
+  const integrationId = trimEnv(process.env[`${prefix}_ID`]) || trimEnv(process.env[`${prefix}_INTEGRATION_ID`]);
+  let apiBase = trimEnv(process.env[`${prefix}_API`]) || (allowApiBaseUrlFallback ? trimEnv(process.env.API_BASE_URL) : void 0);
+  if (!apiKey || !projectUid || !integrationId || !apiBase) {
+    return null;
+  }
+  apiBase = apiBase.replace(/\/$/, "");
+  return {
+    apiBaseUrl: apiBase,
+    apiKey,
+    projectUid,
+    integrationId
+  };
+}
+function requireMailooIntegrationConfig(options) {
+  const config = readMailooIntegrationConfig(options);
+  if (!config) {
+    throw new Error(
+      options.missingMessage ?? `${options.prefix}_API, ${options.prefix}_API_KEY, ${options.prefix}_PROJECT_UID and ${options.prefix}_ID (or _INTEGRATION_ID) must be set`
+    );
+  }
+  return config;
+}
+
+// src/upstream-origin.ts
+function mailooUpstreamOrigin(request) {
+  const raw = request.headers.get("origin")?.trim();
+  if (!raw) return void 0;
+  try {
+    const u = new URL(raw);
+    if (u.protocol !== "http:" && u.protocol !== "https:") return void 0;
+    return u.origin;
+  } catch {
+    return void 0;
+  }
+}
+
+// src/proxy-webhook.ts
+function jsonError(body, status) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+var UPSTREAM_FAILED = {
+  success: false,
+  error: "Upstream request failed",
+  message: "Upstream request failed"
+};
+async function proxyMailooWebhookJsonPost(options) {
+  const { request, url, apiKey, body } = options;
+  const headers = {
+    "Content-Type": "application/json",
+    "X-API-Key": apiKey
+  };
+  const origin = mailooUpstreamOrigin(request);
+  if (origin) headers.Origin = origin;
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body)
+    });
+    const data = await response.json().catch(() => ({}));
+    return new Response(JSON.stringify(data), {
+      status: response.status,
+      headers: { "Content-Type": "application/json" }
+    });
+  } catch {
+    return jsonError(UPSTREAM_FAILED, 502);
+  }
+}
+async function proxyMailooApiGet(options) {
+  const headers = {
+    "Content-Type": "application/json",
+    "X-API-Key": options.apiKey
+  };
+  if (options.origin) {
+    headers.Origin = options.origin;
+  }
+  try {
+    const response = await fetch(options.url, {
+      method: "GET",
+      headers
+    });
+    const data = await response.json().catch(() => ({}));
+    return new Response(JSON.stringify(data), {
+      status: response.status,
+      headers: { "Content-Type": "application/json" }
+    });
+  } catch {
+    return jsonError(UPSTREAM_FAILED, 502);
+  }
+}
+
+export { defaultMailooLogger, jsonError, mailooUpstreamOrigin, proxyMailooApiGet, proxyMailooWebhookJsonPost, readMailooIntegrationConfig, requireMailooIntegrationConfig };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/env.ts","../src/upstream-origin.ts","../src/proxy-webhook.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/** Common Mailoo integration credentials (server-only). */\nexport type MailooIntegrationConfig = {\n  apiBaseUrl: string\n  apiKey: string\n  projectUid: string\n  integrationId: string\n}\n\nexport type MailooLogger = {\n  error: (message: string, ...args: unknown[]) => void\n  warn?: (message: string, ...args: unknown[]) => void\n  logException?: (error: unknown, message: string) => void\n}\n\nexport const defaultMailooLogger: MailooLogger = {\n  error: (message, ...args) => {\n    console.error(message, ...args)\n  },\n  warn: (message, ...args) => {\n    console.warn(message, ...args)\n  },\n  logException: (error, message) => {\n    console.error(message, error)\n  },\n}\n","import type { MailooIntegrationConfig } from './types.js'\n\nfunction trimEnv(value: string | undefined): string | undefined {\n  const v = value?.trim()\n  return v || undefined\n}\n\n/**\n * Read a Mailoo integration config from env var prefixes.\n * Example prefixes: `MAILOO_BLOG`, `MAILOO_CHAT_INTEGRATION`.\n *\n * Looks for:\n * - `{PREFIX}_API` or `{PREFIX}_API` + fallback `API_BASE_URL`\n * - `{PREFIX}_API_KEY`\n * - `{PREFIX}_PROJECT_UID`\n * - `{PREFIX}_ID` or `{PREFIX}_INTEGRATION_ID`\n */\nexport function readMailooIntegrationConfig(options: {\n  prefix: string\n  /** When API base is missing, fall back to API_BASE_URL */\n  allowApiBaseUrlFallback?: boolean\n}): MailooIntegrationConfig | null {\n  const { prefix, allowApiBaseUrlFallback = false } = options\n  const apiKey = trimEnv(process.env[`${prefix}_API_KEY`])\n  const projectUid = trimEnv(process.env[`${prefix}_PROJECT_UID`])\n  const integrationId =\n    trimEnv(process.env[`${prefix}_ID`]) ||\n    trimEnv(process.env[`${prefix}_INTEGRATION_ID`])\n  let apiBase =\n    trimEnv(process.env[`${prefix}_API`]) ||\n    (allowApiBaseUrlFallback ? trimEnv(process.env.API_BASE_URL) : undefined)\n\n  if (!apiKey || !projectUid || !integrationId || !apiBase) {\n    return null\n  }\n\n  apiBase = apiBase.replace(/\\/$/, '')\n  return {\n    apiBaseUrl: apiBase,\n    apiKey,\n    projectUid,\n    integrationId,\n  }\n}\n\n/** Require all four env vars; throw if any missing (fail-fast). */\nexport function requireMailooIntegrationConfig(options: {\n  prefix: string\n  allowApiBaseUrlFallback?: boolean\n  missingMessage?: string\n}): MailooIntegrationConfig {\n  const config = readMailooIntegrationConfig(options)\n  if (!config) {\n    throw new Error(\n      options.missingMessage ??\n        `${options.prefix}_API, ${options.prefix}_API_KEY, ${options.prefix}_PROJECT_UID and ${options.prefix}_ID (or _INTEGRATION_ID) must be set`\n    )\n  }\n  return config\n}\n","/**\n * Origin to forward from a Next BFF to Mailoo webhook APIs.\n * Never use Referer — path-bearing Referers fail exact allowedOrigins checks.\n * When the browser sends no Origin (typical same-origin GET), omit the header\n * so the API treats the call as server-to-server.\n */\nexport function mailooUpstreamOrigin(\n  request: { headers: { get(name: string): string | null } }\n): string | undefined {\n  const raw = request.headers.get('origin')?.trim()\n  if (!raw) return undefined\n  try {\n    const u = new URL(raw)\n    if (u.protocol !== 'http:' && u.protocol !== 'https:') return undefined\n    return u.origin\n  } catch {\n    return undefined\n  }\n}\n","import type { NextRequest } from 'next/server'\nimport { mailooUpstreamOrigin } from './upstream-origin.js'\n\n/** JSON error Response helper. */\nexport function jsonError(body: unknown, status: number): Response {\n  return new Response(JSON.stringify(body), {\n    status,\n    headers: { 'Content-Type': 'application/json' },\n  })\n}\n\nconst UPSTREAM_FAILED = {\n  success: false,\n  error: 'Upstream request failed',\n  message: 'Upstream request failed',\n} as const\n\n/**\n * Forward JSON to a Mailoo webhook URL with server-held API key.\n * Forwards a real browser Origin when present (never Referer).\n * Network / non-JSON upstream failures return HTTP 502 JSON (never throw).\n */\nexport async function proxyMailooWebhookJsonPost(options: {\n  request: NextRequest\n  url: string\n  apiKey: string\n  body: unknown\n}): Promise<Response> {\n  const { request, url, apiKey, body } = options\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'X-API-Key': apiKey,\n  }\n  const origin = mailooUpstreamOrigin(request)\n  if (origin) headers.Origin = origin\n\n  try {\n    const response = await fetch(url, {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(body),\n    })\n    const data = await response.json().catch(() => ({}))\n    return new Response(JSON.stringify(data), {\n      status: response.status,\n      headers: { 'Content-Type': 'application/json' },\n    })\n  } catch {\n    return jsonError(UPSTREAM_FAILED, 502)\n  }\n}\n\n/**\n * Proxy a GET to Mailoo API with X-API-Key.\n * Network / non-JSON upstream failures return HTTP 502 JSON (never throw).\n */\nexport async function proxyMailooApiGet(options: {\n  url: string\n  apiKey: string\n  origin?: string\n}): Promise<Response> {\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'X-API-Key': options.apiKey,\n  }\n  if (options.origin) {\n    headers.Origin = options.origin\n  }\n  try {\n    const response = await fetch(options.url, {\n      method: 'GET',\n      headers,\n    })\n    const data = await response.json().catch(() => ({}))\n    return new Response(JSON.stringify(data), {\n      status: response.status,\n      headers: { 'Content-Type': 'application/json' },\n    })\n  } catch {\n    return jsonError(UPSTREAM_FAILED, 502)\n  }\n}\n"]}

package/dist/request-origin.cjs

@@ -0,0 +1,18 @@
+'use strict';
+
+var headers = require('next/headers');
+
+// src/request-origin.ts
+async function getRequestOriginBaseUrl() {
+  const headersList = await headers.headers();
+  const host = headersList.get("host");
+  if (!host) {
+    throw new Error("Host header is required to resolve request origin");
+  }
+  const proto = headersList.get("x-forwarded-proto") || "http";
+  return `${proto}://${host}`;
+}
+
+exports.getRequestOriginBaseUrl = getRequestOriginBaseUrl;
+//# sourceMappingURL=request-origin.cjs.map
+//# sourceMappingURL=request-origin.cjs.map

package/dist/request-origin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/request-origin.ts"],"names":["headers"],"mappings":";;;;;AAMA,eAAsB,uBAAA,GAA2C;AAC/D,EAAA,MAAM,WAAA,GAAc,MAAMA,eAAA,EAAQ;AAClC,EAAA,MAAM,IAAA,GAAO,WAAA,CAAY,GAAA,CAAI,MAAM,CAAA;AACnC,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,MAAM,IAAI,MAAM,mDAAmD,CAAA;AAAA,EACrE;AACA,EAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,GAAA,CAAI,mBAAmB,CAAA,IAAK,MAAA;AACtD,EAAA,OAAO,CAAA,EAAG,KAAK,CAAA,GAAA,EAAM,IAAI,CAAA,CAAA;AAC3B","file":"request-origin.cjs","sourcesContent":["import { headers } from 'next/headers'\n\n/**\n * Build an absolute same-origin base URL from Next.js request headers.\n * Used by RSC/server helpers that fetch the app's own BFF routes.\n */\nexport async function getRequestOriginBaseUrl(): Promise<string> {\n  const headersList = await headers()\n  const host = headersList.get('host')\n  if (!host) {\n    throw new Error('Host header is required to resolve request origin')\n  }\n  const proto = headersList.get('x-forwarded-proto') || 'http'\n  return `${proto}://${host}`\n}\n"]}

package/dist/request-origin.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Build an absolute same-origin base URL from Next.js request headers.
+ * Used by RSC/server helpers that fetch the app's own BFF routes.
+ */
+declare function getRequestOriginBaseUrl(): Promise<string>;
+
+export { getRequestOriginBaseUrl };

package/dist/request-origin.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Build an absolute same-origin base URL from Next.js request headers.
+ * Used by RSC/server helpers that fetch the app's own BFF routes.
+ */
+declare function getRequestOriginBaseUrl(): Promise<string>;
+
+export { getRequestOriginBaseUrl };

package/dist/request-origin.js

@@ -0,0 +1,16 @@
+import { headers } from 'next/headers';
+
+// src/request-origin.ts
+async function getRequestOriginBaseUrl() {
+  const headersList = await headers();
+  const host = headersList.get("host");
+  if (!host) {
+    throw new Error("Host header is required to resolve request origin");
+  }
+  const proto = headersList.get("x-forwarded-proto") || "http";
+  return `${proto}://${host}`;
+}
+
+export { getRequestOriginBaseUrl };
+//# sourceMappingURL=request-origin.js.map
+//# sourceMappingURL=request-origin.js.map

package/dist/request-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/request-origin.ts"],"names":[],"mappings":";;;AAMA,eAAsB,uBAAA,GAA2C;AAC/D,EAAA,MAAM,WAAA,GAAc,MAAM,OAAA,EAAQ;AAClC,EAAA,MAAM,IAAA,GAAO,WAAA,CAAY,GAAA,CAAI,MAAM,CAAA;AACnC,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,MAAM,IAAI,MAAM,mDAAmD,CAAA;AAAA,EACrE;AACA,EAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,GAAA,CAAI,mBAAmB,CAAA,IAAK,MAAA;AACtD,EAAA,OAAO,CAAA,EAAG,KAAK,CAAA,GAAA,EAAM,IAAI,CAAA,CAAA;AAC3B","file":"request-origin.js","sourcesContent":["import { headers } from 'next/headers'\n\n/**\n * Build an absolute same-origin base URL from Next.js request headers.\n * Used by RSC/server helpers that fetch the app's own BFF routes.\n */\nexport async function getRequestOriginBaseUrl(): Promise<string> {\n  const headersList = await headers()\n  const host = headersList.get('host')\n  if (!host) {\n    throw new Error('Host header is required to resolve request origin')\n  }\n  const proto = headersList.get('x-forwarded-proto') || 'http'\n  return `${proto}://${host}`\n}\n"]}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@mailoo/next-core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.33.0",
+  "description": "Shared Next.js BFF helpers for Mailoo integration modules",
+  "license": "LicenseRef-Mailoo-NoModification",
+  "homepage": "https://mailoo.app/en/support/docs/integrations/nextjs-packages",
+  "keywords": [
+    "mailoo",
+    "nextjs",
+    "next-core"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "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"
+    },
+    "./request-origin": {
+      "types": "./dist/request-origin.d.ts",
+      "import": "./dist/request-origin.js",
+      "require": "./dist/request-origin.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "next": ">=16.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.5",
+    "next": "^16.3.4",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=20.20.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist .turbo",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit"
+  }
 }