@solumflow-app/crm-client 0.1.0 → 0.3.0

package/dist/react/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Placing an account's forms, booking pages, chat and tracking on a React
+ * site, without pasting HTML. React 19 or later: the scripts are rendered as
+ * `<script async>` elements, which React 19 loads once per page however many
+ * components ask for them.
+ *
+ * ```tsx
+ * <CrmEmbedProvider appOrigin="https://app.example.com">
+ *   <CrmForm formId="…" title="Contact" />
+ *   <CrmBooking url="https://app.example.com/book/acme" title="Book" />
+ *   <CrmChatWidget widgetId="…" />
+ *   <CrmSiteTracking publicKey="…" />
+ * </CrmEmbedProvider>
+ * ```
+ */
+export { CrmBooking } from './crm-booking';
+export { CrmChatWidget } from './crm-chat-widget';
+export { CrmForm } from './crm-form';
+export { CrmSiteTracking } from './crm-site-tracking';
+export { CrmEmbedProvider } from './embed-origin';

package/dist/react.cjs

@@ -0,0 +1,163 @@
+'use client';
+"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/react/index.ts
+var react_exports = {};
+__export(react_exports, {
+  CrmBooking: () => CrmBooking,
+  CrmChatWidget: () => CrmChatWidget,
+  CrmEmbedProvider: () => CrmEmbedProvider,
+  CrmForm: () => CrmForm,
+  CrmSiteTracking: () => CrmSiteTracking
+});
+module.exports = __toCommonJS(react_exports);
+
+// src/react/embed-origin.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var EmbedOriginContext = (0, import_react.createContext)(null);
+function CrmEmbedProvider(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(EmbedOriginContext.Provider, { value: normaliseOrigin(props.appOrigin), children: props.children });
+}
+function useEmbedOrigin(appOrigin) {
+  const fromProvider = (0, import_react.useContext)(EmbedOriginContext);
+  const origin = appOrigin ? normaliseOrigin(appOrigin) : fromProvider;
+  if (!origin) {
+    throw new Error(
+      'crm-client/react: no app origin. Pass `appOrigin` to the component or wrap the page in <CrmEmbedProvider appOrigin="https://app.example.com">. Never the page\u2019s own origin: that is your site, not the app.'
+    );
+  }
+  return origin;
+}
+function normaliseOrigin(value) {
+  return value.trim().replace(/\/+$/, "");
+}
+
+// src/react/crm-booking.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function CrmBooking(props) {
+  const origin = useEmbedOrigin(props.appOrigin);
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_jsx_runtime2.Fragment, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+      "iframe",
+      {
+        src: `${props.url}?embed=1`,
+        "data-service-booking-embed": "",
+        title: props.title,
+        className: props.className,
+        style: { width: "100%", border: 0 }
+      }
+    ),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("script", { async: true, src: `${origin}/booking-embed.js` })
+  ] });
+}
+
+// src/react/crm-chat-widget.tsx
+var import_jsx_runtime3 = require("react/jsx-runtime");
+function CrmChatWidget(props) {
+  const origin = useEmbedOrigin(props.appOrigin);
+  const hideOn = props.hideOnPaths ?? [];
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+    "script",
+    {
+      async: true,
+      src: `${origin}/embed/v1/chat.js`,
+      "data-chat-widget-id": props.widgetId,
+      ...hideOn.length > 0 ? { "data-chat-hide-on": hideOn.join(",") } : {},
+      ...props.loadOnInteraction ? { "data-chat-load-on-interaction": "true" } : {}
+    }
+  );
+}
+
+// src/react/crm-form.tsx
+var import_react2 = require("react");
+var import_jsx_runtime4 = require("react/jsx-runtime");
+function CrmForm(props) {
+  const origin = useEmbedOrigin(props.appOrigin);
+  const frame = (0, import_react2.useRef)(null);
+  (0, import_react2.useEffect)(() => {
+    function onMessage(event) {
+      const element = frame.current;
+      if (!element || event.origin !== origin || event.source !== element.contentWindow) {
+        return;
+      }
+      const data = event.data;
+      if (data?.type === "crm-form:resize" && typeof data.height === "number") {
+        element.style.height = `${Math.max(0, data.height)}px`;
+        return;
+      }
+      if (data?.type === "crm-form:submit") {
+        redirectTo(data.redirectUrl);
+      }
+    }
+    window.addEventListener("message", onMessage);
+    return () => window.removeEventListener("message", onMessage);
+  }, [origin]);
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+    "iframe",
+    {
+      ref: frame,
+      src: `${origin}/f/${encodeURIComponent(props.formId)}`,
+      title: props.title,
+      loading: "lazy",
+      className: props.className,
+      style: {
+        width: "100%",
+        border: 0,
+        display: "block",
+        minHeight: 200
+      }
+    }
+  );
+}
+function redirectTo(redirectUrl) {
+  if (typeof redirectUrl !== "string" || !redirectUrl) {
+    return;
+  }
+  try {
+    const url = new URL(redirectUrl);
+    if (url.protocol === "https:") {
+      window.top.location.href = url.href;
+    }
+  } catch {
+  }
+}
+
+// src/react/crm-site-tracking.tsx
+var import_jsx_runtime5 = require("react/jsx-runtime");
+function CrmSiteTracking(props) {
+  const origin = useEmbedOrigin(props.appOrigin);
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+    "script",
+    {
+      async: true,
+      src: `${origin}/api/site-tracking/script?k=${encodeURIComponent(props.publicKey)}`
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CrmBooking,
+  CrmChatWidget,
+  CrmEmbedProvider,
+  CrmForm,
+  CrmSiteTracking
+});
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/index.ts","../src/react/embed-origin.tsx","../src/react/crm-booking.tsx","../src/react/crm-chat-widget.tsx","../src/react/crm-form.tsx","../src/react/crm-site-tracking.tsx"],"sourcesContent":["/**\n * Placing an account's forms, booking pages, chat and tracking on a React\n * site, without pasting HTML. React 19 or later: the scripts are rendered as\n * `<script async>` elements, which React 19 loads once per page however many\n * components ask for them.\n *\n * ```tsx\n * <CrmEmbedProvider appOrigin=\"https://app.example.com\">\n *   <CrmForm formId=\"…\" title=\"Contact\" />\n *   <CrmBooking url=\"https://app.example.com/book/acme\" title=\"Book\" />\n *   <CrmChatWidget widgetId=\"…\" />\n *   <CrmSiteTracking publicKey=\"…\" />\n * </CrmEmbedProvider>\n * ```\n */\nexport { CrmBooking } from './crm-booking';\nexport { CrmChatWidget } from './crm-chat-widget';\nexport { CrmForm } from './crm-form';\nexport { CrmSiteTracking } from './crm-site-tracking';\nexport { CrmEmbedProvider } from './embed-origin';\n","'use client';\n\nimport { type ReactNode, createContext, useContext } from 'react';\n\nconst EmbedOriginContext = createContext<string | null>(null);\n\n/**\n * The app's address, once for every component below it, so a site does not\n * repeat it on each form, booking page and chat. The same origin as the\n * client's `baseUrl`: `https://app.example.com`, without a path.\n */\nexport function CrmEmbedProvider(props: {\n  appOrigin: string;\n  children: ReactNode;\n}) {\n  return (\n    <EmbedOriginContext.Provider value={normaliseOrigin(props.appOrigin)}>\n      {props.children}\n    </EmbedOriginContext.Provider>\n  );\n}\n\n/** The origin from the prop, else from the provider; refuses to guess one. */\nexport function useEmbedOrigin(appOrigin: string | undefined) {\n  const fromProvider = useContext(EmbedOriginContext);\n  const origin = appOrigin ? normaliseOrigin(appOrigin) : fromProvider;\n\n  if (!origin) {\n    throw new Error(\n      'crm-client/react: no app origin. Pass `appOrigin` to the component or ' +\n        'wrap the page in <CrmEmbedProvider appOrigin=\"https://app.example.com\">. ' +\n        'Never the page’s own origin: that is your site, not the app.',\n    );\n  }\n\n  return origin;\n}\n\nfunction normaliseOrigin(value: string) {\n  return value.trim().replace(/\\/+$/, '');\n}\n","import { useEmbedOrigin } from './embed-origin';\n\n/**\n * A booking page, embedded: the iframe the \"Share booking\" dialog hands out,\n * plus the script that makes it as tall as what is inside it.\n *\n * `url` is a booking page's address as the API lists it\n * (`getBookingPages()`), and it must be one of the app's own: the script only\n * listens to frames on that origin. React 19 loads the script once per page,\n * however many of these are on it.\n */\nexport function CrmBooking(props: {\n  url: string;\n  /** The frame's accessible name, such as the service's name. */\n  title: string;\n  appOrigin?: string;\n  className?: string;\n}) {\n  const origin = useEmbedOrigin(props.appOrigin);\n\n  return (\n    <>\n      <iframe\n        src={`${props.url}?embed=1`}\n        data-service-booking-embed=\"\"\n        title={props.title}\n        className={props.className}\n        style={{ width: '100%', border: 0 }}\n      />\n      <script async src={`${origin}/booking-embed.js`} />\n    </>\n  );\n}\n","import { useEmbedOrigin } from './embed-origin';\n\n/**\n * The chat widget of the account, in the corner of every page it is rendered\n * on. Put it in the layout, once: the chat script reads its settings off its\n * own tag and runs once per page.\n *\n * Only a published widget answers, and only on a site in its list of allowed\n * origins (an empty list allows any site). `hideOnPaths` and\n * `loadOnInteraction` are the two switches the Embed tab puts on the tag; pass\n * what `getChatWidgets()` shows in its snippet, or leave them out.\n */\nexport function CrmChatWidget(props: {\n  widgetId: string;\n  appOrigin?: string;\n  hideOnPaths?: readonly string[];\n  loadOnInteraction?: boolean;\n}) {\n  const origin = useEmbedOrigin(props.appOrigin);\n  const hideOn = props.hideOnPaths ?? [];\n\n  return (\n    <script\n      async\n      src={`${origin}/embed/v1/chat.js`}\n      data-chat-widget-id={props.widgetId}\n      {...(hideOn.length > 0 ? { 'data-chat-hide-on': hideOn.join(',') } : {})}\n      {...(props.loadOnInteraction\n        ? { 'data-chat-load-on-interaction': 'true' }\n        : {})}\n    />\n  );\n}\n","'use client';\n\nimport { useEffect, useRef } from 'react';\n\nimport { useEmbedOrigin } from './embed-origin';\n\n/**\n * A published form, drawn in place.\n *\n * The iframe is drawn here rather than left to `embed/v1/embed.js`, because\n * that loader looks for forms once, when it loads: a form that appears after a\n * client-side navigation would stay an empty box. What the loader does besides\n * drawing the frame is honoured here, on the same contract:\n *\n *  - `crm-form:resize` sets the frame's height, so it never scrolls inside;\n *  - `crm-form:submit` with an `https://` `redirectUrl` sends the whole page\n *    there, and nothing else ever navigates it.\n *\n * Both are trusted only from the app's own origin *and* from this frame's own\n * window: another frame on the page can send the same shape.\n */\nexport function CrmForm(props: {\n  formId: string;\n  appOrigin?: string;\n  /**\n   * The frame's accessible name, in your site's own language: what a screen\n   * reader announces before the form. Required, because this package has no\n   * language of its own to fall back on.\n   */\n  title: string;\n  className?: string;\n}) {\n  const origin = useEmbedOrigin(props.appOrigin);\n  const frame = useRef<HTMLIFrameElement>(null);\n\n  // An effect because the page's message channel is outside React: this\n  // subscribes to it for as long as the frame is on the page, and lets go.\n  useEffect(() => {\n    function onMessage(event: MessageEvent) {\n      const element = frame.current;\n\n      if (\n        !element ||\n        event.origin !== origin ||\n        event.source !== element.contentWindow\n      ) {\n        return;\n      }\n\n      const data = event.data as {\n        type?: unknown;\n        height?: unknown;\n        redirectUrl?: unknown;\n      } | null;\n\n      if (data?.type === 'crm-form:resize' && typeof data.height === 'number') {\n        element.style.height = `${Math.max(0, data.height)}px`;\n        return;\n      }\n\n      if (data?.type === 'crm-form:submit') {\n        redirectTo(data.redirectUrl);\n      }\n    }\n\n    window.addEventListener('message', onMessage);\n\n    return () => window.removeEventListener('message', onMessage);\n  }, [origin]);\n\n  return (\n    <iframe\n      ref={frame}\n      src={`${origin}/f/${encodeURIComponent(props.formId)}`}\n      title={props.title}\n      loading=\"lazy\"\n      className={props.className}\n      style={{\n        width: '100%',\n        border: 0,\n        display: 'block',\n        minHeight: 200,\n      }}\n    />\n  );\n}\n\nfunction redirectTo(redirectUrl: unknown) {\n  if (typeof redirectUrl !== 'string' || !redirectUrl) {\n    return;\n  }\n\n  try {\n    const url = new URL(redirectUrl);\n\n    if (url.protocol === 'https:') {\n      window.top!.location.href = url.href;\n    }\n  } catch {\n    // A malformed address is ignored; the page never navigates on one.\n  }\n}\n","import { useEmbedOrigin } from './embed-origin';\n\n/**\n * The website tracking script. Put it in the layout, once.\n *\n * It does nothing until the visitor has given the consent the account waits\n * for, and visits only count from hosts on the account's list -- an empty list\n * counts nothing. `publicKey` is public by design; it is in the page source of\n * every tracked site.\n */\nexport function CrmSiteTracking(props: {\n  publicKey: string;\n  appOrigin?: string;\n}) {\n  const origin = useEmbedOrigin(props.appOrigin);\n\n  return (\n    <script\n      async\n      src={`${origin}/api/site-tracking/script?k=${encodeURIComponent(props.publicKey)}`}\n    />\n  );\n}\n"],"mappings":"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","names":["import_jsx_runtime","import_jsx_runtime","import_react","import_jsx_runtime","import_jsx_runtime"]}

package/dist/react.js

@@ -0,0 +1,133 @@
+'use client';
+
+// src/react/embed-origin.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var EmbedOriginContext = createContext(null);
+function CrmEmbedProvider(props) {
+  return /* @__PURE__ */ jsx(EmbedOriginContext.Provider, { value: normaliseOrigin(props.appOrigin), children: props.children });
+}
+function useEmbedOrigin(appOrigin) {
+  const fromProvider = useContext(EmbedOriginContext);
+  const origin = appOrigin ? normaliseOrigin(appOrigin) : fromProvider;
+  if (!origin) {
+    throw new Error(
+      'crm-client/react: no app origin. Pass `appOrigin` to the component or wrap the page in <CrmEmbedProvider appOrigin="https://app.example.com">. Never the page\u2019s own origin: that is your site, not the app.'
+    );
+  }
+  return origin;
+}
+function normaliseOrigin(value) {
+  return value.trim().replace(/\/+$/, "");
+}
+
+// src/react/crm-booking.tsx
+import { Fragment, jsx as jsx2, jsxs } from "react/jsx-runtime";
+function CrmBooking(props) {
+  const origin = useEmbedOrigin(props.appOrigin);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx2(
+      "iframe",
+      {
+        src: `${props.url}?embed=1`,
+        "data-service-booking-embed": "",
+        title: props.title,
+        className: props.className,
+        style: { width: "100%", border: 0 }
+      }
+    ),
+    /* @__PURE__ */ jsx2("script", { async: true, src: `${origin}/booking-embed.js` })
+  ] });
+}
+
+// src/react/crm-chat-widget.tsx
+import { jsx as jsx3 } from "react/jsx-runtime";
+function CrmChatWidget(props) {
+  const origin = useEmbedOrigin(props.appOrigin);
+  const hideOn = props.hideOnPaths ?? [];
+  return /* @__PURE__ */ jsx3(
+    "script",
+    {
+      async: true,
+      src: `${origin}/embed/v1/chat.js`,
+      "data-chat-widget-id": props.widgetId,
+      ...hideOn.length > 0 ? { "data-chat-hide-on": hideOn.join(",") } : {},
+      ...props.loadOnInteraction ? { "data-chat-load-on-interaction": "true" } : {}
+    }
+  );
+}
+
+// src/react/crm-form.tsx
+import { useEffect, useRef } from "react";
+import { jsx as jsx4 } from "react/jsx-runtime";
+function CrmForm(props) {
+  const origin = useEmbedOrigin(props.appOrigin);
+  const frame = useRef(null);
+  useEffect(() => {
+    function onMessage(event) {
+      const element = frame.current;
+      if (!element || event.origin !== origin || event.source !== element.contentWindow) {
+        return;
+      }
+      const data = event.data;
+      if (data?.type === "crm-form:resize" && typeof data.height === "number") {
+        element.style.height = `${Math.max(0, data.height)}px`;
+        return;
+      }
+      if (data?.type === "crm-form:submit") {
+        redirectTo(data.redirectUrl);
+      }
+    }
+    window.addEventListener("message", onMessage);
+    return () => window.removeEventListener("message", onMessage);
+  }, [origin]);
+  return /* @__PURE__ */ jsx4(
+    "iframe",
+    {
+      ref: frame,
+      src: `${origin}/f/${encodeURIComponent(props.formId)}`,
+      title: props.title,
+      loading: "lazy",
+      className: props.className,
+      style: {
+        width: "100%",
+        border: 0,
+        display: "block",
+        minHeight: 200
+      }
+    }
+  );
+}
+function redirectTo(redirectUrl) {
+  if (typeof redirectUrl !== "string" || !redirectUrl) {
+    return;
+  }
+  try {
+    const url = new URL(redirectUrl);
+    if (url.protocol === "https:") {
+      window.top.location.href = url.href;
+    }
+  } catch {
+  }
+}
+
+// src/react/crm-site-tracking.tsx
+import { jsx as jsx5 } from "react/jsx-runtime";
+function CrmSiteTracking(props) {
+  const origin = useEmbedOrigin(props.appOrigin);
+  return /* @__PURE__ */ jsx5(
+    "script",
+    {
+      async: true,
+      src: `${origin}/api/site-tracking/script?k=${encodeURIComponent(props.publicKey)}`
+    }
+  );
+}
+export {
+  CrmBooking,
+  CrmChatWidget,
+  CrmEmbedProvider,
+  CrmForm,
+  CrmSiteTracking
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/embed-origin.tsx","../src/react/crm-booking.tsx","../src/react/crm-chat-widget.tsx","../src/react/crm-form.tsx","../src/react/crm-site-tracking.tsx"],"sourcesContent":["'use client';\n\nimport { type ReactNode, createContext, useContext } from 'react';\n\nconst EmbedOriginContext = createContext<string | null>(null);\n\n/**\n * The app's address, once for every component below it, so a site does not\n * repeat it on each form, booking page and chat. The same origin as the\n * client's `baseUrl`: `https://app.example.com`, without a path.\n */\nexport function CrmEmbedProvider(props: {\n  appOrigin: string;\n  children: ReactNode;\n}) {\n  return (\n    <EmbedOriginContext.Provider value={normaliseOrigin(props.appOrigin)}>\n      {props.children}\n    </EmbedOriginContext.Provider>\n  );\n}\n\n/** The origin from the prop, else from the provider; refuses to guess one. */\nexport function useEmbedOrigin(appOrigin: string | undefined) {\n  const fromProvider = useContext(EmbedOriginContext);\n  const origin = appOrigin ? normaliseOrigin(appOrigin) : fromProvider;\n\n  if (!origin) {\n    throw new Error(\n      'crm-client/react: no app origin. Pass `appOrigin` to the component or ' +\n        'wrap the page in <CrmEmbedProvider appOrigin=\"https://app.example.com\">. ' +\n        'Never the page’s own origin: that is your site, not the app.',\n    );\n  }\n\n  return origin;\n}\n\nfunction normaliseOrigin(value: string) {\n  return value.trim().replace(/\\/+$/, '');\n}\n","import { useEmbedOrigin } from './embed-origin';\n\n/**\n * A booking page, embedded: the iframe the \"Share booking\" dialog hands out,\n * plus the script that makes it as tall as what is inside it.\n *\n * `url` is a booking page's address as the API lists it\n * (`getBookingPages()`), and it must be one of the app's own: the script only\n * listens to frames on that origin. React 19 loads the script once per page,\n * however many of these are on it.\n */\nexport function CrmBooking(props: {\n  url: string;\n  /** The frame's accessible name, such as the service's name. */\n  title: string;\n  appOrigin?: string;\n  className?: string;\n}) {\n  const origin = useEmbedOrigin(props.appOrigin);\n\n  return (\n    <>\n      <iframe\n        src={`${props.url}?embed=1`}\n        data-service-booking-embed=\"\"\n        title={props.title}\n        className={props.className}\n        style={{ width: '100%', border: 0 }}\n      />\n      <script async src={`${origin}/booking-embed.js`} />\n    </>\n  );\n}\n","import { useEmbedOrigin } from './embed-origin';\n\n/**\n * The chat widget of the account, in the corner of every page it is rendered\n * on. Put it in the layout, once: the chat script reads its settings off its\n * own tag and runs once per page.\n *\n * Only a published widget answers, and only on a site in its list of allowed\n * origins (an empty list allows any site). `hideOnPaths` and\n * `loadOnInteraction` are the two switches the Embed tab puts on the tag; pass\n * what `getChatWidgets()` shows in its snippet, or leave them out.\n */\nexport function CrmChatWidget(props: {\n  widgetId: string;\n  appOrigin?: string;\n  hideOnPaths?: readonly string[];\n  loadOnInteraction?: boolean;\n}) {\n  const origin = useEmbedOrigin(props.appOrigin);\n  const hideOn = props.hideOnPaths ?? [];\n\n  return (\n    <script\n      async\n      src={`${origin}/embed/v1/chat.js`}\n      data-chat-widget-id={props.widgetId}\n      {...(hideOn.length > 0 ? { 'data-chat-hide-on': hideOn.join(',') } : {})}\n      {...(props.loadOnInteraction\n        ? { 'data-chat-load-on-interaction': 'true' }\n        : {})}\n    />\n  );\n}\n","'use client';\n\nimport { useEffect, useRef } from 'react';\n\nimport { useEmbedOrigin } from './embed-origin';\n\n/**\n * A published form, drawn in place.\n *\n * The iframe is drawn here rather than left to `embed/v1/embed.js`, because\n * that loader looks for forms once, when it loads: a form that appears after a\n * client-side navigation would stay an empty box. What the loader does besides\n * drawing the frame is honoured here, on the same contract:\n *\n *  - `crm-form:resize` sets the frame's height, so it never scrolls inside;\n *  - `crm-form:submit` with an `https://` `redirectUrl` sends the whole page\n *    there, and nothing else ever navigates it.\n *\n * Both are trusted only from the app's own origin *and* from this frame's own\n * window: another frame on the page can send the same shape.\n */\nexport function CrmForm(props: {\n  formId: string;\n  appOrigin?: string;\n  /**\n   * The frame's accessible name, in your site's own language: what a screen\n   * reader announces before the form. Required, because this package has no\n   * language of its own to fall back on.\n   */\n  title: string;\n  className?: string;\n}) {\n  const origin = useEmbedOrigin(props.appOrigin);\n  const frame = useRef<HTMLIFrameElement>(null);\n\n  // An effect because the page's message channel is outside React: this\n  // subscribes to it for as long as the frame is on the page, and lets go.\n  useEffect(() => {\n    function onMessage(event: MessageEvent) {\n      const element = frame.current;\n\n      if (\n        !element ||\n        event.origin !== origin ||\n        event.source !== element.contentWindow\n      ) {\n        return;\n      }\n\n      const data = event.data as {\n        type?: unknown;\n        height?: unknown;\n        redirectUrl?: unknown;\n      } | null;\n\n      if (data?.type === 'crm-form:resize' && typeof data.height === 'number') {\n        element.style.height = `${Math.max(0, data.height)}px`;\n        return;\n      }\n\n      if (data?.type === 'crm-form:submit') {\n        redirectTo(data.redirectUrl);\n      }\n    }\n\n    window.addEventListener('message', onMessage);\n\n    return () => window.removeEventListener('message', onMessage);\n  }, [origin]);\n\n  return (\n    <iframe\n      ref={frame}\n      src={`${origin}/f/${encodeURIComponent(props.formId)}`}\n      title={props.title}\n      loading=\"lazy\"\n      className={props.className}\n      style={{\n        width: '100%',\n        border: 0,\n        display: 'block',\n        minHeight: 200,\n      }}\n    />\n  );\n}\n\nfunction redirectTo(redirectUrl: unknown) {\n  if (typeof redirectUrl !== 'string' || !redirectUrl) {\n    return;\n  }\n\n  try {\n    const url = new URL(redirectUrl);\n\n    if (url.protocol === 'https:') {\n      window.top!.location.href = url.href;\n    }\n  } catch {\n    // A malformed address is ignored; the page never navigates on one.\n  }\n}\n","import { useEmbedOrigin } from './embed-origin';\n\n/**\n * The website tracking script. Put it in the layout, once.\n *\n * It does nothing until the visitor has given the consent the account waits\n * for, and visits only count from hosts on the account's list -- an empty list\n * counts nothing. `publicKey` is public by design; it is in the page source of\n * every tracked site.\n */\nexport function CrmSiteTracking(props: {\n  publicKey: string;\n  appOrigin?: string;\n}) {\n  const origin = useEmbedOrigin(props.appOrigin);\n\n  return (\n    <script\n      async\n      src={`${origin}/api/site-tracking/script?k=${encodeURIComponent(props.publicKey)}`}\n    />\n  );\n}\n"],"mappings":"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","names":["jsx","jsx","jsx","jsx"]}

package/dist/tags.d.ts

@@ -2,6 +2,17 @@
 export declare function productsTag(): string;
 /** One product, by whichever key it was fetched with. */
 export declare function productTag(slugOrId: string): string;
+/**
+ * Everything that lists categories, and every category page.
+ *
+ * A category delivery clears both this and the products collection, because a
+ * category page *is* a list of products: renaming a category, publishing one,
+ * or moving a product into one all change what a product listing filtered by
+ * that category answers.
+ */
+export declare function categoriesTag(): string;
+/** One category, by whichever key it was fetched with. */
+export declare function categoryTag(slugOrId: string): string;
 export declare function eventsTag(): string;
 export declare function eventTag(idOrSlug: string): string;
 /**

package/dist/types.d.ts

@@ -1,6 +1,7 @@
-import type { ApiErrorCode, PublicEventDetailItem, PublicEventListItem, PublicProductDetail, PublicProductImage, PublicProductListItem } from './generated/api-types';
-export type { ApiErrorCode, ApiScope, ApiWebhookEvent, ApiWebhookPayload, PublicProductCategory, PublicProductPrice, PublicProductSummary, } from './generated/api-types';
-export { ALL_API_ERROR_CODES, ALL_API_SCOPES, ALL_API_WEBHOOK_EVENTS, } from './generated/api-types';
+import type { ApiErrorCode, PublicCategoryDetail, PublicCategoryListItem, PublicContentText, PublicCta, PublicEventDetailItem, PublicEventListItem, PublicProductDetail, PublicProductField, PublicProductImage, PublicProductListItem, PublicProductVariant, PublicRepeater } from './generated/api-types';
+import type { PlacementChatWidget, PlacementForm, PlacementSiteTracking } from './generated/api-types';
+export type { ApiErrorCode, ApiScope, PublicContentFile, PublicContentIcon, PublicContentLink, PublicContentText, PublicCta, PublicRepeater, PublicRepeaterItem, PublicRepeaterItemField, ApiWebhookEvent, ApiWebhookPayload, ProductType, PublicCategoryStep, PublicProductCategory, PublicProductPrice, PublicProductSummary, PublicProductVariantAxis, PlacementBookingPage, PlacementChatWidget, PlacementForm, PlacementSiteTracking, } from './generated/api-types';
+export { ALL_API_ERROR_CODES, ALL_API_SCOPES, ALL_API_WEBHOOK_EVENTS, ALL_PRODUCT_TYPES, } from './generated/api-types';
 /**
  * The difference between what the projection holds and what goes over the wire.
  *
@@ -15,13 +16,36 @@ export interface ProductListItem extends Omit<PublicProductListItem, 'imagePath'
     /** Ready to put in an `<img>`; null when the seller uploaded no picture. */
     imageUrl: string | null;
 }
-export interface ProductDetail extends Omit<PublicProductDetail, 'imagePath' | 'images'> {
+export interface ProductDetail extends Omit<PublicProductDetail, 'imagePath' | 'images' | 'variants'> {
     imageUrl: string | null;
     images: ProductImage[];
+    variants: ProductVariant[];
+}
+export interface ProductVariant extends Omit<PublicProductVariant, 'images'> {
+    images: ProductImage[];
 }
 export interface ProductImage extends Omit<PublicProductImage, 'path'> {
     url: string;
 }
+export interface CategoryListItem extends Omit<PublicCategoryListItem, 'imagePath'> {
+    /** Ready to put in an `<img>`; null when the seller uploaded no picture. */
+    imageUrl: string | null;
+}
+/**
+ * One category page.
+ *
+ * `social` is subtracted and restated for the same reason the images are: the
+ * service holds a storage path and the route hands over a finished URL.
+ */
+export interface CategoryDetail extends Omit<PublicCategoryDetail, 'imagePath' | 'social' | 'products'> {
+    imageUrl: string | null;
+    social: {
+        title: string;
+        description: string | null;
+        imageUrl: string | null;
+    };
+    products: ProductListItem[];
+}
 export interface EventListItem extends Omit<PublicEventListItem, 'coverImagePath'> {
     coverImageUrl: string | null;
 }
@@ -36,6 +60,22 @@ export interface ProductList {
     /** Null on the last page. Pass it back as `cursor` for the one after this. */
     nextCursor: string | null;
 }
+export interface CategoryList {
+    data: CategoryListItem[];
+    /** Null on the last page. Pass it back as `cursor` for the one after this. */
+    nextCursor: string | null;
+}
+/**
+ * One category page and the first page of its products.
+ *
+ * The cursor is beside the category rather than inside it, because it pages the
+ * products and not the category: a shop asking for the next page sends it back
+ * on the same address and gets the same category with the next lot on it.
+ */
+export interface CategoryPage {
+    data: CategoryDetail;
+    nextCursor: string | null;
+}
 /**
  * The events listing, which does not have the shape of the others.
  *
@@ -132,6 +172,14 @@ export interface ContactInput {
     lastName?: string;
     phone?: string;
     company?: string;
+    /**
+     * The slug of the account's object for people a new contact is made in
+     * ("leden"). Somebody already known stays where they are. Left out, the
+     * account's own choice applies. A slug the account does not have, or one
+     * that is not an object for people, is refused with 422
+     * (`invalid_request`, `fields[0].path === 'object'`).
+     */
+    object?: string;
 }
 export interface ContactResult {
     id: string;
@@ -139,7 +187,8 @@ export interface ContactResult {
     created: boolean;
 }
 export interface RequestInput {
-    contact: ContactInput;
+    /** Where a request's contact lands is the account's choice alone. */
+    contact: Omit<ContactInput, 'object'>;
     message: string;
     productId?: string;
     source?: string;
@@ -170,3 +219,182 @@ export interface ApiErrorBody {
         }[];
     };
 }
+/**
+ * One price of a product written through the catalogue routes. `externalRef`
+ * keeps a renamed price itself; without one, a price is recognised by its
+ * label.
+ */
+export interface CatalogPriceInput {
+    externalRef?: string;
+    label: string;
+    amountCents: number;
+    compareAtCents?: number | null;
+    kind?: 'one_off' | 'recurring';
+    recurringInterval?: 'day' | 'week' | 'month' | 'year';
+    recurringIntervalCount?: number;
+    isDefault?: boolean;
+    active?: boolean;
+}
+export interface CatalogVariantInput {
+    externalRef: string;
+    /** The value per axis, keyed by the axis slug. */
+    options: Record<string, string>;
+    sku?: string | null;
+    gtin?: string | null;
+    prices?: CatalogPriceInput[];
+    position?: number;
+    active?: boolean;
+}
+/**
+ * A product as a catalogue sync sends it. Every field but `source` may be
+ * left out, and left out means "leave it as it is"; `null` empties a field.
+ */
+export interface CatalogProductInput {
+    /** Which system the references belong to, e.g. "coolflames-payload". */
+    source: string;
+    name?: string;
+    slug?: string | null;
+    description?: string | null;
+    longDescription?: string | null;
+    sku?: string | null;
+    gtin?: string | null;
+    productType?: 'digital' | 'physical';
+    /** A new product is a `draft` unless this says otherwise. */
+    availability?: 'draft' | 'internal' | 'scheduled' | 'public';
+    publishedAt?: string | null;
+    visibility?: 'public' | 'unlisted';
+    metaTitle?: string | null;
+    metaDescription?: string | null;
+    /** Category slugs; replaces the product's categories. */
+    categories?: string[];
+    createMissingCategories?: boolean;
+    /** Field values by field slug. */
+    fields?: Record<string, unknown>;
+    publicFields?: string[];
+    addMissingOptions?: boolean;
+    /** Replaces the product's prices as a whole. */
+    prices?: CatalogPriceInput[];
+    /** https only; fetched after the answer, in this order. */
+    images?: {
+        url: string;
+        alt?: string | null;
+    }[];
+    variantAxes?: {
+        slug: string;
+        label?: string;
+    }[];
+    /** Replaces the product's variants; one left out is archived. */
+    variants?: CatalogVariantInput[];
+    /** `false` brings back a product the API archived. */
+    archived?: false;
+}
+export interface CatalogProductResult {
+    id: string;
+    source: string;
+    externalRef: string;
+    /** False when the reference named a product that was already here. */
+    created: boolean;
+    name: string;
+    slug: string | null;
+    availability: 'draft' | 'internal' | 'scheduled' | 'public';
+    variants: {
+        externalRef: string;
+        id: string;
+        created: boolean;
+    }[];
+    /** `pending` while pictures are being fetched after the answer. */
+    images: 'pending' | 'unchanged';
+}
+export interface CatalogArchiveResult {
+    id: string;
+    archived: true;
+    alreadyArchived: boolean;
+}
+export interface CatalogCategoryInput {
+    name?: string;
+    description?: string | null;
+    /** `null` puts the category at the top of the tree. */
+    parentSlug?: string | null;
+    availability?: 'draft' | 'internal' | 'scheduled' | 'public';
+    publishedAt?: string | null;
+    metaTitle?: string | null;
+    metaDescription?: string | null;
+}
+export interface CatalogCategoryResult {
+    id: string;
+    slug: string;
+    name: string;
+    parentId: string | null;
+    created: boolean;
+}
+export interface CatalogFieldInput {
+    label?: string;
+    type?: 'text' | 'number' | 'select' | 'checkbox' | 'url' | 'date';
+    multiple?: boolean;
+    options?: {
+        value: string;
+        label?: string;
+    }[];
+    removeOptions?: string[];
+    public?: boolean;
+}
+/**
+ * A field of the catalogue, as `GET /attributes` lists the public ones. A
+ * `repeater` also says how it is drawn (`display`, `preset`) and what one
+ * entry holds (`itemFields`, `titleKey`).
+ */
+export type CatalogField = PublicProductField;
+/**
+ * What `fields[slug]` holds for a content field, by the `type` the field has in
+ * `GET /attributes`: `content_text`, `repeater` or `cta`. `null` when the block
+ * is published and empty. Narrow on the field's type, not on the value.
+ */
+export type ContentFieldValue = PublicContentText | PublicRepeater | PublicCta;
+export interface CatalogFieldResult extends CatalogField {
+    public: boolean;
+    created: boolean;
+}
+/** One page of published forms. Pass `nextCursor` back as `cursor` for the next. */
+export interface FormList {
+    data: PlacementForm[];
+    nextCursor: string | null;
+}
+/** One page of chat widgets. Archived ones are left out. */
+export interface ChatWidgetList {
+    data: PlacementChatWidget[];
+    nextCursor: string | null;
+}
+/**
+ * What may be said about a chat widget through the API. How it looks and what
+ * it says is done in the app's builder.
+ *
+ * Sites are added and removed, never replaced, so placing the chat on one more
+ * site cannot take it off the others. An empty list means any site; adding
+ * the first one narrows the widget to that site.
+ */
+export interface ChatWidgetInput {
+    /** Required when the widget does not exist yet. */
+    name?: string;
+    status?: 'draft' | 'published';
+    /** Origins: scheme, host, optional port. `https://www.example.com`. */
+    addAllowedOrigins?: string[];
+    removeAllowedOrigins?: string[];
+}
+export interface ChatWidgetResult extends PlacementChatWidget {
+    created: boolean;
+}
+/**
+ * The tracking script's hosts and consent signal. Hosts are added and removed,
+ * never replaced. An empty list counts nothing: only visits from a listed host
+ * are kept.
+ */
+export interface SiteTrackingInput {
+    /** Hosts, such as `www.example.com` or `*.example.com`. A full address is forgiven. */
+    addAllowedHosts?: string[];
+    removeAllowedHosts?: string[];
+    consentSignal?: PlacementSiteTracking['consentSignal'];
+}
+export interface SiteTrackingResult extends PlacementSiteTracking {
+    /** True when this call set tracking up for the account. */
+    created: boolean;
+}