order3000 1.5.0 → 1.6.0

package/dist/schemas.mjs

@@ -11,9 +11,9 @@ const abandonBasketResponseSchema = z.object({
 
 const actorTypeSchema = z.enum(["human", "robot"]);
 
-const adChannelSchema = z.enum(["google"]);
+const adChannelSchema = z.enum(["google", "facebook", "instagram"]);
 
-const adOwnerTypeSchema = z.enum(["event"]);
+const adOwnerTypeSchema = z.enum(["event", "ritual"]);
 
 const adStatusSchema = z.enum(["draft", "ready", "archived"]);
 
@@ -578,6 +578,27 @@ const createAdResponseSchema = z.object({
     z.array(z.any()),
     z.object({}).catchall(z.any())
   ]),
+  metaContent: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  metaRefs: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  targetingOverride: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
   keywords: z.union([
     z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
     z.array(z.any()),
@@ -818,6 +839,27 @@ const deleteAdResponseSchema = z.object({
     z.array(z.any()),
     z.object({}).catchall(z.any())
   ]),
+  metaContent: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  metaRefs: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  targetingOverride: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
   keywords: z.union([
     z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
     z.array(z.any()),
@@ -946,6 +988,27 @@ const editAdResponseSchema = z.object({
     z.array(z.any()),
     z.object({}).catchall(z.any())
   ]),
+  metaContent: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  metaRefs: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  targetingOverride: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
   keywords: z.union([
     z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
     z.array(z.any()),
@@ -1186,6 +1249,103 @@ const editEventResponseSchema = z.object({
   )
 }).describe("Successfully updated event with schedule");
 
+const editMetaAdRequestSchema = z.object({
+  venueAccessor: z.string().min(1),
+  id: z.string().min(1),
+  metaContent: z.optional(
+    z.object({
+      primaryText: z.object({}).catchall(z.string().max(125)),
+      headline: z.object({}).catchall(z.string().max(40)),
+      description: z.object({}).catchall(z.string().max(30)),
+      finalUrl: z.url(),
+      callToAction: z.string(),
+      creatives: z.object({}).catchall(
+        z.object({
+          assetId: z.string()
+        })
+      )
+    })
+  ),
+  get status() {
+    return adStatusSchema.optional();
+  }
+}).describe("Partial-update body for an existing Meta ad");
+
+const editMetaAdResponseSchema = z.object({
+  id: z.string(),
+  venueId: z.string(),
+  get ownerEntityType() {
+    return adOwnerTypeSchema;
+  },
+  ownerEntityId: z.string(),
+  get channel() {
+    return adChannelSchema;
+  },
+  get status() {
+    return adStatusSchema;
+  },
+  campaignId: z.nullable(z.string()),
+  content: z.union([
+    z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+    z.array(z.any()),
+    z.object({}).catchall(z.any())
+  ]),
+  metaContent: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  metaRefs: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  targetingOverride: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  keywords: z.union([
+    z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+    z.array(z.any()),
+    z.object({}).catchall(z.any())
+  ]),
+  negativeKeywords: z.union([
+    z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+    z.array(z.any()),
+    z.object({}).catchall(z.any())
+  ]),
+  disabledVenueKeywords: z.union([
+    z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+    z.array(z.any()),
+    z.object({}).catchall(z.any())
+  ]),
+  dismissedKeywords: z.union([
+    z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+    z.array(z.any()),
+    z.object({}).catchall(z.any())
+  ]),
+  publishedContentHash: z.nullable(z.string()),
+  publishedAt: z.nullable(z.any()),
+  pushedKeywords: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  createdBy: z.nullable(z.string()),
+  updatedBy: z.nullable(z.string()),
+  createdAt: z.nullable(z.any()),
+  updatedAt: z.nullable(z.any())
+}).describe("Successfully updated Meta ad");
+
 const entityOwnerTypeSchema = z.enum([
   "event",
   "dish",
@@ -1258,6 +1418,27 @@ const fetchAdResponseSchema = z.object({
     z.array(z.any()),
     z.object({}).catchall(z.any())
   ]),
+  metaContent: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  metaRefs: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  targetingOverride: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
   keywords: z.union([
     z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
     z.array(z.any()),
@@ -1313,6 +1494,27 @@ const fetchAdsResponseSchema = z.array(
       z.array(z.any()),
       z.object({}).catchall(z.any())
     ]),
+    metaContent: z.nullable(
+      z.union([
+        z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+        z.array(z.any()),
+        z.object({}).catchall(z.any())
+      ])
+    ),
+    metaRefs: z.nullable(
+      z.union([
+        z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+        z.array(z.any()),
+        z.object({}).catchall(z.any())
+      ])
+    ),
+    targetingOverride: z.nullable(
+      z.union([
+        z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+        z.array(z.any()),
+        z.object({}).catchall(z.any())
+      ])
+    ),
     keywords: z.union([
       z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
       z.array(z.any()),
@@ -1679,7 +1881,7 @@ const fetchEventResponseSchema = z.object({
     )
   )
 }).describe(
-  "Event details. Nested objects (schedule, timeSlots, menus, posters, nextOccurrence) pass through; their shape follows the SDK Event interface."
+  "Event details. Nested objects (schedule, timeSlots, menus, assets, nextOccurrence) pass through; their shape follows the SDK Event interface."
 );
 
 const promotionBenefitTypeSchema = z.enum([
@@ -2250,6 +2452,233 @@ const fetchMenuSubscriptionsResponseSchema = z.array(
   })
 );
 
+const fetchRitualResponseSchema = z.object({
+  id: z.string(),
+  venueId: z.string(),
+  accessor: z.string(),
+  get ritualType() {
+    return ritualTypeSchema;
+  },
+  scheduleId: z.nullable(z.string()),
+  name: z.union([
+    z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+    z.array(z.any()),
+    z.object({}).catchall(z.any())
+  ]),
+  description: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  playbook: z.nullable(
+    z.union([
+      z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+      z.array(z.any()),
+      z.object({}).catchall(z.any())
+    ])
+  ),
+  maxBookings: z.nullable(z.int().min(-2147483648).max(2147483647)),
+  maxGuests: z.nullable(z.int().min(-2147483648).max(2147483647)),
+  minPartySize: z.nullable(z.int().min(-2147483648).max(2147483647)),
+  maxPartySize: z.nullable(z.int().min(-2147483648).max(2147483647)),
+  isPublic: z.boolean(),
+  reservationsEnabled: z.boolean(),
+  bookingOpensAtDays: z.nullable(z.int().min(-2147483648).max(2147483647)),
+  bookingClosesAtOffset: z.nullable(z.int().min(-2147483648).max(2147483647)),
+  isActive: z.boolean(),
+  isFeatured: z.boolean(),
+  priority: z.int().min(-2147483648).max(2147483647),
+  createdBy: z.nullable(z.string()),
+  updatedBy: z.nullable(z.string()),
+  createdAt: z.nullable(z.any()),
+  updatedAt: z.nullable(z.any()),
+  assets: z.array(
+    z.object({
+      id: z.string(),
+      get type() {
+        return assetTypeSchema;
+      },
+      tags: z.nullable(z.array(z.string())),
+      bucket: z.string(),
+      storagePath: z.string(),
+      filename: z.string(),
+      contentType: z.string(),
+      sizeBytes: z.int().min(-2147483648).max(2147483647),
+      caption: z.union([
+        z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+        z.array(z.any()),
+        z.object({}).catchall(z.any())
+      ]),
+      alt: z.union([
+        z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+        z.array(z.any()),
+        z.object({}).catchall(z.any())
+      ]),
+      metadata: z.nullable(
+        z.union([
+          z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+          z.array(z.any()),
+          z.object({}).catchall(z.any())
+        ])
+      ),
+      cropArea: z.nullable(
+        z.union([
+          z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+          z.array(z.any()),
+          z.object({}).catchall(z.any())
+        ])
+      ),
+      isActive: z.boolean(),
+      sortIndex: z.nullable(z.string().max(255)),
+      createdAt: z.nullable(z.any()),
+      updatedAt: z.nullable(z.any()),
+      createdBy: z.nullable(z.string()),
+      updatedBy: z.nullable(z.string()),
+      venueId: z.nullable(z.string()),
+      publicUrl: z.string()
+    })
+  ),
+  events: z.array(
+    z.object({
+      id: z.string(),
+      venueId: z.string(),
+      accessor: z.nullable(z.string()),
+      name: z.union([
+        z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+        z.array(z.any()),
+        z.object({}).catchall(z.any())
+      ]),
+      description: z.nullable(
+        z.union([
+          z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+          z.array(z.any()),
+          z.object({}).catchall(z.any())
+        ])
+      ),
+      scheduleId: z.nullable(z.string()),
+      ritualId: z.nullable(z.string()),
+      occurrenceDate: z.nullable(z.string()),
+      maxBookings: z.nullable(z.int().min(-2147483648).max(2147483647)),
+      maxGuests: z.nullable(z.int().min(-2147483648).max(2147483647)),
+      minPartySize: z.nullable(z.int().min(-2147483648).max(2147483647)),
+      maxPartySize: z.nullable(z.int().min(-2147483648).max(2147483647)),
+      isPublic: z.boolean(),
+      reservationsEnabled: z.boolean(),
+      bookingOpensAtDays: z.nullable(z.int().min(-2147483648).max(2147483647)),
+      bookingClosesAtOffset: z.nullable(
+        z.int().min(-2147483648).max(2147483647)
+      ),
+      isActive: z.boolean(),
+      isFeatured: z.boolean(),
+      priority: z.int().min(-2147483648).max(2147483647),
+      createdBy: z.nullable(z.string()),
+      updatedBy: z.nullable(z.string()),
+      createdAt: z.nullable(z.any()),
+      updatedAt: z.nullable(z.any()),
+      covers: z.number()
+    })
+  ),
+  schedule: z.nullable(
+    z.object({
+      id: z.string(),
+      name: z.union([
+        z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+        z.array(z.any()),
+        z.object({}).catchall(z.any())
+      ]),
+      description: z.nullable(
+        z.union([
+          z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+          z.array(z.any()),
+          z.object({}).catchall(z.any())
+        ])
+      ),
+      timezone: z.string(),
+      rrule: z.nullable(z.string()),
+      exdates: z.nullable(z.array(z.string())),
+      validFrom: z.nullable(z.string()),
+      validTo: z.nullable(z.string()),
+      priority: z.nullable(z.int().min(-2147483648).max(2147483647)),
+      get slotMode() {
+        return slotModeSchema;
+      },
+      intervalDuration: z.nullable(z.int().min(-2147483648).max(2147483647)),
+      duration: z.nullable(z.int().min(-2147483648).max(2147483647)),
+      isActive: z.boolean(),
+      sortIndex: z.nullable(z.string().max(255)),
+      updatedAt: z.nullable(z.any()),
+      updatedBy: z.nullable(z.string()),
+      createdAt: z.nullable(z.any()),
+      createdBy: z.nullable(z.string()),
+      scheduleTimeSlots: z.array(
+        z.object({
+          scheduleId: z.nullable(z.string()),
+          timeSlotId: z.nullable(z.string()),
+          get dayOfWeek() {
+            return dayOfWeekSchema;
+          },
+          sortIndex: z.nullable(z.string().max(255)),
+          timeSlot: z.nullable(
+            z.object({
+              id: z.string(),
+              startTime: z.string(),
+              endTime: z.nullable(z.string()),
+              isActive: z.nullable(z.boolean()),
+              isSchedulable: z.nullable(z.boolean()),
+              sortIndex: z.nullable(z.string().max(255)),
+              updatedAt: z.nullable(z.any()),
+              updatedBy: z.nullable(z.string()),
+              createdAt: z.nullable(z.any()),
+              createdBy: z.nullable(z.string())
+            })
+          )
+        })
+      ),
+      scheduleOverrides: z.array(
+        z.object({
+          id: z.string(),
+          scheduleId: z.string(),
+          date: z.string(),
+          reason: z.nullable(
+            z.union([
+              z.union([z.boolean(), z.string(), z.number(), z.enum([])]),
+              z.array(z.any()),
+              z.object({}).catchall(z.any())
+            ])
+          ),
+          isActive: z.boolean(),
+          priority: z.nullable(z.int().min(-2147483648).max(2147483647)),
+          updatedAt: z.nullable(z.any()),
+          updatedBy: z.nullable(z.string()),
+          createdAt: z.nullable(z.any()),
+          createdBy: z.nullable(z.string()),
+          scheduleOverrideTimeSlots: z.array(
+            z.object({
+              overrideId: z.string(),
+              timeSlotId: z.string(),
+              sortIndex: z.nullable(z.string().max(255)),
+              timeSlot: z.object({
+                id: z.string(),
+                startTime: z.string(),
+                endTime: z.nullable(z.string()),
+                isActive: z.nullable(z.boolean()),
+                isSchedulable: z.nullable(z.boolean()),
+                sortIndex: z.nullable(z.string().max(255)),
+                updatedAt: z.nullable(z.any()),
+                updatedBy: z.nullable(z.string()),
+                createdAt: z.nullable(z.any()),
+                createdBy: z.nullable(z.string())
+              })
+            })
+          )
+        })
+      )
+    })
+  )
+});
+
 const fetchTeamOrderResponseSchema = z.object({
   teamOrder: z.object({
     id: z.string(),
@@ -2369,6 +2798,21 @@ const fetchTeamOrderResponseSchema = z.object({
   isLead: z.boolean()
 });
 
+const gbpMediaCategorySchema = z.enum([
+  "cover",
+  "logo",
+  "gallery",
+  "video"
+]);
+
+const gbpSyncStatusSchema = z.enum([
+  "processing",
+  "live",
+  "rejected",
+  "failed",
+  "removed"
+]);
+
 const getAreaAvailabilityResponseSchema = z.object({
   from: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
   to: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
@@ -2503,7 +2947,12 @@ const integrationNotificationTypeSchema = z.enum([
   "reservation_cancelled"
 ]);
 
-const integrationTypeSchema = z.enum(["telegram", "google_ads"]);
+const integrationTypeSchema = z.enum([
+  "telegram",
+  "google_ads",
+  "google_business_profile",
+  "meta_ads"
+]);
 
 const inventoryAssetStatusSchema = z.enum([
   "available",
@@ -2769,6 +3218,9 @@ const makeReservationRequestSchema = z.object({
   ).nullish(),
   wbraid: z.string().describe(
     "Google Ads click identifier for web-to-app (iOS) where `gclid` is unavailable."
+  ).nullish(),
+  fbclid: z.string().describe(
+    "Meta (Facebook/Instagram) click identifier from the landing URL. Stored for server-side Conversions API reporting."
   ).nullish()
 }).describe("Request payload for making a new reservation");
 
@@ -2830,6 +3282,7 @@ const makeReservationResponseSchema = z.object({
   gclid: z.nullable(z.string()),
   gbraid: z.nullable(z.string()),
   wbraid: z.nullable(z.string()),
+  fbclid: z.nullable(z.string()),
   specialRequests: z.nullable(
     z.string().describe("Any special requirements or notes")
   ),
@@ -3308,6 +3761,8 @@ const schemas = {
   EditArticleResponse: editArticleResponseSchema,
   EditEventRequest: editEventRequestSchema,
   EditEventResponse: editEventResponseSchema,
+  EditMetaAdRequest: editMetaAdRequestSchema,
+  EditMetaAdResponse: editMetaAdResponseSchema,
   EntityOwnerType: entityOwnerTypeSchema,
   EnumFalse: enumFalseSchema,
   EnumTrue: enumTrueSchema,
@@ -3332,8 +3787,11 @@ const schemas = {
   FetchMenuBundlesResponse: fetchMenuBundlesResponseSchema,
   FetchMenuResponse: fetchMenuResponseSchema,
   FetchMenuSubscriptionsResponse: fetchMenuSubscriptionsResponseSchema,
+  FetchRitualResponse: fetchRitualResponseSchema,
   FetchTeamOrderResponse: fetchTeamOrderResponseSchema,
   FulfillmentType: fulfillmentTypeSchema,
+  GbpMediaCategory: gbpMediaCategorySchema,
+  GbpSyncStatus: gbpSyncStatusSchema,
   GetAreaAvailabilityResponse: getAreaAvailabilityResponseSchema,
   GetBasketTotalsRequest: getBasketTotalsRequestSchema,
   GetBasketTotalsResponse: getBasketTotalsResponseSchema,

package/dist/tracking.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+const AD_CLICK_ID_KEYS = [
+  "gclid",
+  "gbraid",
+  "wbraid",
+  "fbclid"
+];
+const AD_CLICK_COOKIE_MAX_AGE = 90 * 24 * 60 * 60;
+function writeCookie(name, value) {
+  document.cookie = `${name}=${encodeURIComponent(value)}; path=/; max-age=${AD_CLICK_COOKIE_MAX_AGE}; SameSite=Lax`;
+}
+function readCookie(name) {
+  const match = document.cookie.split("; ").find((row) => row.startsWith(`${name}=`));
+  return match ? decodeURIComponent(match.slice(name.length + 1)) : void 0;
+}
+function persistAdClickIdsFromUrl() {
+  if (typeof window === "undefined") return;
+  const params = new URLSearchParams(window.location.search);
+  for (const key of AD_CLICK_ID_KEYS) {
+    const value = params.get(key);
+    if (value) writeCookie(key, value);
+  }
+}
+function getAdClickIds() {
+  if (typeof window === "undefined") return {};
+  const ids = {};
+  for (const key of AD_CLICK_ID_KEYS) {
+    const value = readCookie(key);
+    if (value) ids[key] = value;
+  }
+  return ids;
+}
+
+exports.AD_CLICK_ID_KEYS = AD_CLICK_ID_KEYS;
+exports.getAdClickIds = getAdClickIds;
+exports.persistAdClickIdsFromUrl = persistAdClickIdsFromUrl;

package/dist/tracking.d.cts

@@ -0,0 +1,34 @@
+/**
+ * order3000 ad-click attribution — first-party capture of the click identifiers
+ * that appear on an ad's landing URL (Google Ads auto-tagging `gclid`/`gbraid`/
+ * `wbraid`; Meta `fbclid`). A reservation made later in the session is then
+ * attributed to the originating ad click and reported to the ad platform
+ * server-side — Google Ads offline conversions and the Meta Conversions API.
+ *
+ * **Provided by order3000 so every consumer captures attribution identically,
+ * without re-implementing this logic.** Wire it in two lines on the restaurant
+ * frontend:
+ *
+ *   - call `persistAdClickIdsFromUrl()` once on landing (every page), and
+ *   - spread `getAdClickIds()` into the `reservations.make(...)` payload on
+ *     submit.
+ *
+ * No Google/Meta script is ever loaded — these are plain query params we read
+ * ourselves and store in first-party cookies (browser-only; every function is a
+ * no-op when `window` is undefined, so it is safe to import in SSR code).
+ */
+/** The ad-click identifiers order3000 captures from a landing URL. */
+declare const AD_CLICK_ID_KEYS: readonly ["gclid", "gbraid", "wbraid", "fbclid"];
+type AdClickIdKey = (typeof AD_CLICK_ID_KEYS)[number];
+type AdClickIds = Partial<Record<AdClickIdKey, string>>;
+/**
+ * Read any ad-click ids from the current URL and persist them to first-party
+ * cookies. Call once on landing (every page). Only a present id is written, so a
+ * later non-ad navigation never clears an earlier attribution.
+ */
+declare function persistAdClickIdsFromUrl(): void;
+/** The persisted ad-click ids, for attaching to a reservation on submit. */
+declare function getAdClickIds(): AdClickIds;
+
+export { AD_CLICK_ID_KEYS, getAdClickIds, persistAdClickIdsFromUrl };
+export type { AdClickIdKey, AdClickIds };

package/dist/tracking.d.mts

@@ -0,0 +1,34 @@
+/**
+ * order3000 ad-click attribution — first-party capture of the click identifiers
+ * that appear on an ad's landing URL (Google Ads auto-tagging `gclid`/`gbraid`/
+ * `wbraid`; Meta `fbclid`). A reservation made later in the session is then
+ * attributed to the originating ad click and reported to the ad platform
+ * server-side — Google Ads offline conversions and the Meta Conversions API.
+ *
+ * **Provided by order3000 so every consumer captures attribution identically,
+ * without re-implementing this logic.** Wire it in two lines on the restaurant
+ * frontend:
+ *
+ *   - call `persistAdClickIdsFromUrl()` once on landing (every page), and
+ *   - spread `getAdClickIds()` into the `reservations.make(...)` payload on
+ *     submit.
+ *
+ * No Google/Meta script is ever loaded — these are plain query params we read
+ * ourselves and store in first-party cookies (browser-only; every function is a
+ * no-op when `window` is undefined, so it is safe to import in SSR code).
+ */
+/** The ad-click identifiers order3000 captures from a landing URL. */
+declare const AD_CLICK_ID_KEYS: readonly ["gclid", "gbraid", "wbraid", "fbclid"];
+type AdClickIdKey = (typeof AD_CLICK_ID_KEYS)[number];
+type AdClickIds = Partial<Record<AdClickIdKey, string>>;
+/**
+ * Read any ad-click ids from the current URL and persist them to first-party
+ * cookies. Call once on landing (every page). Only a present id is written, so a
+ * later non-ad navigation never clears an earlier attribution.
+ */
+declare function persistAdClickIdsFromUrl(): void;
+/** The persisted ad-click ids, for attaching to a reservation on submit. */
+declare function getAdClickIds(): AdClickIds;
+
+export { AD_CLICK_ID_KEYS, getAdClickIds, persistAdClickIdsFromUrl };
+export type { AdClickIdKey, AdClickIds };

package/dist/tracking.mjs

@@ -0,0 +1,33 @@
+const AD_CLICK_ID_KEYS = [
+  "gclid",
+  "gbraid",
+  "wbraid",
+  "fbclid"
+];
+const AD_CLICK_COOKIE_MAX_AGE = 90 * 24 * 60 * 60;
+function writeCookie(name, value) {
+  document.cookie = `${name}=${encodeURIComponent(value)}; path=/; max-age=${AD_CLICK_COOKIE_MAX_AGE}; SameSite=Lax`;
+}
+function readCookie(name) {
+  const match = document.cookie.split("; ").find((row) => row.startsWith(`${name}=`));
+  return match ? decodeURIComponent(match.slice(name.length + 1)) : void 0;
+}
+function persistAdClickIdsFromUrl() {
+  if (typeof window === "undefined") return;
+  const params = new URLSearchParams(window.location.search);
+  for (const key of AD_CLICK_ID_KEYS) {
+    const value = params.get(key);
+    if (value) writeCookie(key, value);
+  }
+}
+function getAdClickIds() {
+  if (typeof window === "undefined") return {};
+  const ids = {};
+  for (const key of AD_CLICK_ID_KEYS) {
+    const value = readCookie(key);
+    if (value) ids[key] = value;
+  }
+  return ids;
+}
+
+export { AD_CLICK_ID_KEYS, getAdClickIds, persistAdClickIdsFromUrl };