platform-types 1.10.740 → 1.10.742

package/dist/auth.d.ts

@@ -112,7 +112,8 @@ declare global {
          * First-touch acquisition captured by the registration client; the api
          * server-stamps `capturedAt`.
          *
-         * ⚠️ A STRICT allow-list, not a tracking bag. An unknown key (`gclid`,
+         * ⚠️ A STRICT allow-list, not a tracking bag. `fbclid` (Meta's ad click
+         * id) is the ONE click id accepted; any other unknown key (`gclid`,
          * `utm_term`, a raw referrer, a client-sent `capturedAt`) refuses the WHOLE
          * registration. Send all three required keys or omit the object entirely.
          */

package/dist/store.d.ts

@@ -340,21 +340,31 @@ declare global {
          */
         tolerancePercent?: number;
     }
-    /** First-touch acquisition metadata captured when this tenant self-registers. */
-    interface StoreAcquisition {
+    /**
+     * The REQUEST leaf: everything a registration client may send. The api
+     * refuses a body carrying `capturedAt`, and refuses any key this type does
+     * not name.
+     */
+    interface StoreAcquisitionInput {
         source: string;
         medium: string;
         campaign: string;
         content?: string;
+        /**
+         * Meta's ad click id (the `fbclid` URL parameter), present only when the
+         * sign-up arrived from a Meta ad. Case-sensitive: forwarded to Meta
+         * byte-for-byte. Trimmed, then 1–500 characters of `[A-Za-z0-9_-]`; only
+         * ever present together with the required UTM keys. REQUEST-only: the api
+         * never writes it to the STORE row, which is why `StoreAcquisition` (the
+         * stored shape) does not declare it.
+         */
+        fbclid?: string;
+    }
+    /** First-touch acquisition metadata captured when this tenant self-registers. */
+    interface StoreAcquisition extends Omit<StoreAcquisitionInput, 'fbclid'> {
         /** Unix ms, stamped by the api from the registration timestamp. */
         capturedAt: number;
     }
-    /**
-     * The REQUEST leaf: everything a registration client may send, i.e.
-     * `StoreAcquisition` minus the server-owned stamp. The api refuses a body
-     * carrying `capturedAt`, and refuses any key this type does not name.
-     */
-    type StoreAcquisitionInput = Omit<StoreAcquisition, 'capturedAt'>;
     /**
      * The terms-of-service acceptance recorded when this tenant self-registers.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.740",
+	"version": "1.10.742",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",