@distinctagency/cms-client 1.25.0 → 1.27.0

package/dist/index.d.mts

@@ -7,10 +7,10 @@ import { SupabaseClient } from '@supabase/supabase-js';
  * report installed-version telemetry and to send `x-cms-client-version` on
  * outgoing requests.
  */
-declare const CMS_CLIENT_VERSION = "1.25.0";
+declare const CMS_CLIENT_VERSION = "1.27.0";
 
 /** Field types supported by the CMS schema */
-type FieldType = "text" | "textarea" | "richtext" | "date" | "datetime" | "select" | "number" | "boolean" | "image" | "gallery" | "url" | "file" | "reference" | "multi-reference" | "computed" | "color" | "tags" | "json" | "embed" | "flipbook";
+type FieldType = "text" | "textarea" | "richtext" | "date" | "datetime" | "select" | "number" | "boolean" | "image" | "gallery" | "url" | "file" | "reference" | "multi-reference" | "computed" | "color" | "tags" | "json" | "embed" | "flipbook" | "group";
 /**
  * Date field precision. Controls which parts of a date the admin editor collects
  * and the partial-ISO shape the value is stored in:
@@ -62,6 +62,10 @@ interface FieldDefinition {
     max_length?: number;
     /** For text/textarea/richtext fields: soft target character count. Exceeding it shows a warning but does not block saving. */
     recommended_length?: number;
+    /** For group (repeater) fields: the item sub-schema (scalar fields only — no nested group/reference). */
+    fields?: FieldDefinition[];
+    /** For group fields: singular noun for the add button (e.g. "card"). Defaults to "item". */
+    item_label?: string;
 }
 interface Tenant {
     id: string;
@@ -962,11 +966,19 @@ interface EditMessage {
     name: string;
     value: string;
     length: number;
+    /** When the field is inside a repeating group item, the group field name. */
+    list?: string;
+    /** Item index within the group (document order). */
+    index?: number;
 }
 interface PickImageMessage {
     source: typeof CMS_VISUAL_SOURCE;
     type: "pick-image";
     name: string;
+    /** When the field is inside a repeating group item, the group field name. */
+    list?: string;
+    /** Item index within the group (document order). */
+    index?: number;
 }
 interface InitMessage {
     source: typeof CMS_VISUAL_SOURCE;
@@ -979,6 +991,10 @@ interface SetMessage {
     type: "set";
     name: string;
     value: string;
+    /** When the field is inside a repeating group item, the group field name. */
+    list?: string;
+    /** Item index within the group (document order). */
+    index?: number;
 }
 type BridgeOutbound = ReadyMessage | EditMessage | PickImageMessage;
 type BridgeInbound = InitMessage | SetMessage;
@@ -988,4 +1004,81 @@ declare function isTrustedOrigin(origin: string, allowlist: readonly string[]):
 /** Narrow an unknown postMessage payload to a visual message, or null. */
 declare function parseVisualMessage(data: unknown): VisualMessage | null;
 
-export { type BookingStatus, type BridgeInbound, type BridgeOutbound, CMS_CLIENT_VERSION, CMS_VISUAL_SOURCE, type CmsClientOptions, type CmsEvent, type CmsTicketTier, type ContentItem, type ContentQueryOptions, type ContentType, type ContentTypeSeoConfig, type CreateBookingParams, type CreateBookingResult, type CreateOrderParams, type CreateOrderResult, DEFAULT_TRUSTED_ORIGINS, type DateGranularity, type DiscountType, type EditMessage, type EmbedValue, type EventQueryOptions, type EventStatus, type EventWithTiers, type FieldDefinition, type FieldType, type FlipbookPagePublic, type FlipbookPublic, type FlipbookTocEntryPublic, type FormatPartialDateOptions, type GeocodeOptions, type GeocodeResult, type GoogleReview, IMAGE_PRESETS, type ImageConfig, type ImageTransformOptions, type InitMessage, MAPBOX_CONFIG_TAG, type MapboxConfig, type MapboxConfigOptions, type MapsClientOptions, type MediaFolder, type MediaItem, type Member, type MembershipTier, type OrderAddress, type OrderLineItem, type OrderStatus, type ParsedPartialDate, type PaymentStatus, type PickImageMessage, type Product, type ProductCategory, type ProductOption, type ProductQueryOptions, type ProductStatus, type ProductVariant, type Profile, type ReadyMessage, type ReviewQueryOptions, type SetMessage, TRACKING_CONFIG_TAG, type Tenant, type TenantMembership, type TrackingConfig, type TrackingConfigOptions, type VisualFieldMeta, type VisualFieldSchema, type VisualFieldType, type VisualMessage, WEBHOOK_EVENTS, type WebhookEvent, type WebhookEventPayload, createCmsClient, createEventsClient, createMapsClient, createShopClient, formatPartialDate, getEmbedHtml, getSrcSet, getTransformUrl, isTrustedOrigin, parsePartialDate, parseVisualMessage, revalidateAllTags, singletonTag, verifyWebhookSignature };
+declare const CMS_MARKUP_SOURCE: "cms-markup";
+interface MarkupReady {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-ready";
+    docW: number;
+    docH: number;
+}
+interface MarkupPin {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-pin";
+    xPct: number;
+    yPct: number;
+    relX: number;
+    relY: number;
+    selector: string | null;
+    viewportW: number;
+    docW: number;
+    docH: number;
+}
+interface MarkupViewport {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-viewport";
+    scrollX: number;
+    scrollY: number;
+    docW: number;
+    docH: number;
+    viewportW: number;
+}
+interface MarkupLocated {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-located";
+    id: string;
+    rect: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | null;
+}
+interface MarkupInit {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-init";
+}
+interface MarkupLocate {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-locate";
+    id: string;
+    selector: string;
+}
+type MarkupOutbound = MarkupReady | MarkupPin | MarkupViewport | MarkupLocated;
+type MarkupInbound = MarkupInit | MarkupLocate;
+type MarkupMessage = MarkupOutbound | MarkupInbound;
+declare function parseMarkupMessage(data: unknown): MarkupMessage | null;
+
+interface PinAnchor {
+    xPct: number;
+    yPct: number;
+    relX: number;
+    relY: number;
+}
+interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Turn a click into a hybrid anchor. clickX/clickY are VIEWPORT coords. */
+declare function computeAnchor(clickX: number, clickY: number, el: Element, scrollX: number, scrollY: number, docW: number, docH: number): PinAnchor;
+/** Resolve a pin to absolute {left, top} in document coords. */
+declare function positionPin(pin: PinAnchor, located: Rect | null, layout: {
+    docW: number;
+    docH: number;
+}): {
+    left: number;
+    top: number;
+};
+
+export { type BookingStatus, type BridgeInbound, type BridgeOutbound, CMS_CLIENT_VERSION, CMS_MARKUP_SOURCE, CMS_VISUAL_SOURCE, type CmsClientOptions, type CmsEvent, type CmsTicketTier, type ContentItem, type ContentQueryOptions, type ContentType, type ContentTypeSeoConfig, type CreateBookingParams, type CreateBookingResult, type CreateOrderParams, type CreateOrderResult, DEFAULT_TRUSTED_ORIGINS, type DateGranularity, type DiscountType, type EditMessage, type EmbedValue, type EventQueryOptions, type EventStatus, type EventWithTiers, type FieldDefinition, type FieldType, type FlipbookPagePublic, type FlipbookPublic, type FlipbookTocEntryPublic, type FormatPartialDateOptions, type GeocodeOptions, type GeocodeResult, type GoogleReview, IMAGE_PRESETS, type ImageConfig, type ImageTransformOptions, type InitMessage, MAPBOX_CONFIG_TAG, type MapboxConfig, type MapboxConfigOptions, type MapsClientOptions, type MarkupInbound, type MarkupInit, type MarkupLocate, type MarkupLocated, type MarkupMessage, type MarkupOutbound, type MarkupPin, type MarkupReady, type MarkupViewport, type MediaFolder, type MediaItem, type Member, type MembershipTier, type OrderAddress, type OrderLineItem, type OrderStatus, type ParsedPartialDate, type PaymentStatus, type PickImageMessage, type PinAnchor, type Product, type ProductCategory, type ProductOption, type ProductQueryOptions, type ProductStatus, type ProductVariant, type Profile, type ReadyMessage, type Rect, type ReviewQueryOptions, type SetMessage, TRACKING_CONFIG_TAG, type Tenant, type TenantMembership, type TrackingConfig, type TrackingConfigOptions, type VisualFieldMeta, type VisualFieldSchema, type VisualFieldType, type VisualMessage, WEBHOOK_EVENTS, type WebhookEvent, type WebhookEventPayload, computeAnchor, createCmsClient, createEventsClient, createMapsClient, createShopClient, formatPartialDate, getEmbedHtml, getSrcSet, getTransformUrl, isTrustedOrigin, parseMarkupMessage, parsePartialDate, parseVisualMessage, positionPin, revalidateAllTags, singletonTag, verifyWebhookSignature };

package/dist/index.d.ts

@@ -7,10 +7,10 @@ import { SupabaseClient } from '@supabase/supabase-js';
  * report installed-version telemetry and to send `x-cms-client-version` on
  * outgoing requests.
  */
-declare const CMS_CLIENT_VERSION = "1.25.0";
+declare const CMS_CLIENT_VERSION = "1.27.0";
 
 /** Field types supported by the CMS schema */
-type FieldType = "text" | "textarea" | "richtext" | "date" | "datetime" | "select" | "number" | "boolean" | "image" | "gallery" | "url" | "file" | "reference" | "multi-reference" | "computed" | "color" | "tags" | "json" | "embed" | "flipbook";
+type FieldType = "text" | "textarea" | "richtext" | "date" | "datetime" | "select" | "number" | "boolean" | "image" | "gallery" | "url" | "file" | "reference" | "multi-reference" | "computed" | "color" | "tags" | "json" | "embed" | "flipbook" | "group";
 /**
  * Date field precision. Controls which parts of a date the admin editor collects
  * and the partial-ISO shape the value is stored in:
@@ -62,6 +62,10 @@ interface FieldDefinition {
     max_length?: number;
     /** For text/textarea/richtext fields: soft target character count. Exceeding it shows a warning but does not block saving. */
     recommended_length?: number;
+    /** For group (repeater) fields: the item sub-schema (scalar fields only — no nested group/reference). */
+    fields?: FieldDefinition[];
+    /** For group fields: singular noun for the add button (e.g. "card"). Defaults to "item". */
+    item_label?: string;
 }
 interface Tenant {
     id: string;
@@ -962,11 +966,19 @@ interface EditMessage {
     name: string;
     value: string;
     length: number;
+    /** When the field is inside a repeating group item, the group field name. */
+    list?: string;
+    /** Item index within the group (document order). */
+    index?: number;
 }
 interface PickImageMessage {
     source: typeof CMS_VISUAL_SOURCE;
     type: "pick-image";
     name: string;
+    /** When the field is inside a repeating group item, the group field name. */
+    list?: string;
+    /** Item index within the group (document order). */
+    index?: number;
 }
 interface InitMessage {
     source: typeof CMS_VISUAL_SOURCE;
@@ -979,6 +991,10 @@ interface SetMessage {
     type: "set";
     name: string;
     value: string;
+    /** When the field is inside a repeating group item, the group field name. */
+    list?: string;
+    /** Item index within the group (document order). */
+    index?: number;
 }
 type BridgeOutbound = ReadyMessage | EditMessage | PickImageMessage;
 type BridgeInbound = InitMessage | SetMessage;
@@ -988,4 +1004,81 @@ declare function isTrustedOrigin(origin: string, allowlist: readonly string[]):
 /** Narrow an unknown postMessage payload to a visual message, or null. */
 declare function parseVisualMessage(data: unknown): VisualMessage | null;
 
-export { type BookingStatus, type BridgeInbound, type BridgeOutbound, CMS_CLIENT_VERSION, CMS_VISUAL_SOURCE, type CmsClientOptions, type CmsEvent, type CmsTicketTier, type ContentItem, type ContentQueryOptions, type ContentType, type ContentTypeSeoConfig, type CreateBookingParams, type CreateBookingResult, type CreateOrderParams, type CreateOrderResult, DEFAULT_TRUSTED_ORIGINS, type DateGranularity, type DiscountType, type EditMessage, type EmbedValue, type EventQueryOptions, type EventStatus, type EventWithTiers, type FieldDefinition, type FieldType, type FlipbookPagePublic, type FlipbookPublic, type FlipbookTocEntryPublic, type FormatPartialDateOptions, type GeocodeOptions, type GeocodeResult, type GoogleReview, IMAGE_PRESETS, type ImageConfig, type ImageTransformOptions, type InitMessage, MAPBOX_CONFIG_TAG, type MapboxConfig, type MapboxConfigOptions, type MapsClientOptions, type MediaFolder, type MediaItem, type Member, type MembershipTier, type OrderAddress, type OrderLineItem, type OrderStatus, type ParsedPartialDate, type PaymentStatus, type PickImageMessage, type Product, type ProductCategory, type ProductOption, type ProductQueryOptions, type ProductStatus, type ProductVariant, type Profile, type ReadyMessage, type ReviewQueryOptions, type SetMessage, TRACKING_CONFIG_TAG, type Tenant, type TenantMembership, type TrackingConfig, type TrackingConfigOptions, type VisualFieldMeta, type VisualFieldSchema, type VisualFieldType, type VisualMessage, WEBHOOK_EVENTS, type WebhookEvent, type WebhookEventPayload, createCmsClient, createEventsClient, createMapsClient, createShopClient, formatPartialDate, getEmbedHtml, getSrcSet, getTransformUrl, isTrustedOrigin, parsePartialDate, parseVisualMessage, revalidateAllTags, singletonTag, verifyWebhookSignature };
+declare const CMS_MARKUP_SOURCE: "cms-markup";
+interface MarkupReady {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-ready";
+    docW: number;
+    docH: number;
+}
+interface MarkupPin {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-pin";
+    xPct: number;
+    yPct: number;
+    relX: number;
+    relY: number;
+    selector: string | null;
+    viewportW: number;
+    docW: number;
+    docH: number;
+}
+interface MarkupViewport {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-viewport";
+    scrollX: number;
+    scrollY: number;
+    docW: number;
+    docH: number;
+    viewportW: number;
+}
+interface MarkupLocated {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-located";
+    id: string;
+    rect: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | null;
+}
+interface MarkupInit {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-init";
+}
+interface MarkupLocate {
+    source: typeof CMS_MARKUP_SOURCE;
+    type: "markup-locate";
+    id: string;
+    selector: string;
+}
+type MarkupOutbound = MarkupReady | MarkupPin | MarkupViewport | MarkupLocated;
+type MarkupInbound = MarkupInit | MarkupLocate;
+type MarkupMessage = MarkupOutbound | MarkupInbound;
+declare function parseMarkupMessage(data: unknown): MarkupMessage | null;
+
+interface PinAnchor {
+    xPct: number;
+    yPct: number;
+    relX: number;
+    relY: number;
+}
+interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Turn a click into a hybrid anchor. clickX/clickY are VIEWPORT coords. */
+declare function computeAnchor(clickX: number, clickY: number, el: Element, scrollX: number, scrollY: number, docW: number, docH: number): PinAnchor;
+/** Resolve a pin to absolute {left, top} in document coords. */
+declare function positionPin(pin: PinAnchor, located: Rect | null, layout: {
+    docW: number;
+    docH: number;
+}): {
+    left: number;
+    top: number;
+};
+
+export { type BookingStatus, type BridgeInbound, type BridgeOutbound, CMS_CLIENT_VERSION, CMS_MARKUP_SOURCE, CMS_VISUAL_SOURCE, type CmsClientOptions, type CmsEvent, type CmsTicketTier, type ContentItem, type ContentQueryOptions, type ContentType, type ContentTypeSeoConfig, type CreateBookingParams, type CreateBookingResult, type CreateOrderParams, type CreateOrderResult, DEFAULT_TRUSTED_ORIGINS, type DateGranularity, type DiscountType, type EditMessage, type EmbedValue, type EventQueryOptions, type EventStatus, type EventWithTiers, type FieldDefinition, type FieldType, type FlipbookPagePublic, type FlipbookPublic, type FlipbookTocEntryPublic, type FormatPartialDateOptions, type GeocodeOptions, type GeocodeResult, type GoogleReview, IMAGE_PRESETS, type ImageConfig, type ImageTransformOptions, type InitMessage, MAPBOX_CONFIG_TAG, type MapboxConfig, type MapboxConfigOptions, type MapsClientOptions, type MarkupInbound, type MarkupInit, type MarkupLocate, type MarkupLocated, type MarkupMessage, type MarkupOutbound, type MarkupPin, type MarkupReady, type MarkupViewport, type MediaFolder, type MediaItem, type Member, type MembershipTier, type OrderAddress, type OrderLineItem, type OrderStatus, type ParsedPartialDate, type PaymentStatus, type PickImageMessage, type PinAnchor, type Product, type ProductCategory, type ProductOption, type ProductQueryOptions, type ProductStatus, type ProductVariant, type Profile, type ReadyMessage, type Rect, type ReviewQueryOptions, type SetMessage, TRACKING_CONFIG_TAG, type Tenant, type TenantMembership, type TrackingConfig, type TrackingConfigOptions, type VisualFieldMeta, type VisualFieldSchema, type VisualFieldType, type VisualMessage, WEBHOOK_EVENTS, type WebhookEvent, type WebhookEventPayload, computeAnchor, createCmsClient, createEventsClient, createMapsClient, createShopClient, formatPartialDate, getEmbedHtml, getSrcSet, getTransformUrl, isTrustedOrigin, parseMarkupMessage, parsePartialDate, parseVisualMessage, positionPin, revalidateAllTags, singletonTag, verifyWebhookSignature };

package/dist/index.js

@@ -21,12 +21,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   CMS_CLIENT_VERSION: () => CMS_CLIENT_VERSION,
+  CMS_MARKUP_SOURCE: () => CMS_MARKUP_SOURCE,
   CMS_VISUAL_SOURCE: () => CMS_VISUAL_SOURCE,
   DEFAULT_TRUSTED_ORIGINS: () => DEFAULT_TRUSTED_ORIGINS,
   IMAGE_PRESETS: () => IMAGE_PRESETS,
   MAPBOX_CONFIG_TAG: () => MAPBOX_CONFIG_TAG,
   TRACKING_CONFIG_TAG: () => TRACKING_CONFIG_TAG,
   WEBHOOK_EVENTS: () => WEBHOOK_EVENTS,
+  computeAnchor: () => computeAnchor,
   createCmsClient: () => createCmsClient,
   createEventsClient: () => createEventsClient,
   createMapsClient: () => createMapsClient,
@@ -36,8 +38,10 @@ __export(src_exports, {
   getSrcSet: () => getSrcSet,
   getTransformUrl: () => getTransformUrl,
   isTrustedOrigin: () => isTrustedOrigin,
+  parseMarkupMessage: () => parseMarkupMessage,
   parsePartialDate: () => parsePartialDate,
   parseVisualMessage: () => parseVisualMessage,
+  positionPin: () => positionPin,
   revalidateAllTags: () => revalidateAllTags,
   singletonTag: () => singletonTag,
   verifyWebhookSignature: () => verifyWebhookSignature
@@ -45,7 +49,7 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // src/version.ts
-var CMS_CLIENT_VERSION = "1.25.0";
+var CMS_CLIENT_VERSION = "1.27.0";
 
 // src/queries.ts
 var import_supabase_js = require("@supabase/supabase-js");
@@ -819,15 +823,59 @@ function parseVisualMessage(data) {
   }
   return null;
 }
+
+// src/markup/protocol.ts
+var CMS_MARKUP_SOURCE = "cms-markup";
+var VALID = /* @__PURE__ */ new Set([
+  "markup-ready",
+  "markup-pin",
+  "markup-viewport",
+  "markup-located",
+  "markup-init",
+  "markup-locate"
+]);
+function parseMarkupMessage(data) {
+  if (typeof data === "object" && data !== null && data.source === CMS_MARKUP_SOURCE && typeof data.type === "string" && VALID.has(data.type)) {
+    return data;
+  }
+  return null;
+}
+
+// src/markup/anchor.ts
+function docRect(el, scrollX, scrollY) {
+  const r = el.getBoundingClientRect();
+  return { x: r.left + scrollX, y: r.top + scrollY, w: r.width, h: r.height };
+}
+function computeAnchor(clickX, clickY, el, scrollX, scrollY, docW, docH) {
+  const docX = clickX + scrollX;
+  const docY = clickY + scrollY;
+  const rect = docRect(el, scrollX, scrollY);
+  const relX = rect.w > 0 ? (docX - rect.x) / rect.w : 0;
+  const relY = rect.h > 0 ? (docY - rect.y) / rect.h : 0;
+  return {
+    xPct: docW > 0 ? docX / docW : 0,
+    yPct: docH > 0 ? docY / docH : 0,
+    relX: Math.min(1, Math.max(0, relX)),
+    relY: Math.min(1, Math.max(0, relY))
+  };
+}
+function positionPin(pin, located, layout) {
+  if (located) {
+    return { left: located.x + pin.relX * located.w, top: located.y + pin.relY * located.h };
+  }
+  return { left: pin.xPct * layout.docW, top: pin.yPct * layout.docH };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CMS_CLIENT_VERSION,
+  CMS_MARKUP_SOURCE,
   CMS_VISUAL_SOURCE,
   DEFAULT_TRUSTED_ORIGINS,
   IMAGE_PRESETS,
   MAPBOX_CONFIG_TAG,
   TRACKING_CONFIG_TAG,
   WEBHOOK_EVENTS,
+  computeAnchor,
   createCmsClient,
   createEventsClient,
   createMapsClient,
@@ -837,8 +885,10 @@ function parseVisualMessage(data) {
   getSrcSet,
   getTransformUrl,
   isTrustedOrigin,
+  parseMarkupMessage,
   parsePartialDate,
   parseVisualMessage,
+  positionPin,
   revalidateAllTags,
   singletonTag,
   verifyWebhookSignature