@postrun/js 2.23.0 → 2.24.0

package/dist/query.d.cts

@@ -1525,13 +1525,13 @@ type GoogleAdsConversionUserIdentifier = {
      */
     phone_number?: string;
     /**
-     * A plaintext postal address. Name fields are hashed; region/postal code are sent in the clear.
+     * A plaintext postal address — all four parts are required. Name fields are hashed; region/postal code are sent in the clear.
      */
     address?: {
-        given_name?: string;
-        family_name?: string;
-        region_code?: string;
-        postal_code?: string;
+        given_name: string;
+        family_name: string;
+        region_code: string;
+        postal_code: string;
     };
 };
 /**
@@ -1539,9 +1539,13 @@ type GoogleAdsConversionUserIdentifier = {
  */
 type GoogleAdsConversionEvent = {
     /**
-     * When the conversion happened, as an RFC 3339 timestamp (required).
+     * When the conversion happened, as an RFC 3339 timestamp (required). A UTC `Z` or an explicit timezone offset (e.g. +05:30) is accepted.
      */
     event_timestamp: string;
+    /**
+     * Where the conversion happened (required by Google): WEB for a gclid web conversion, or APP / IN_STORE / PHONE / MESSAGE / OTHER.
+     */
+    event_source: 'WEB' | 'APP' | 'IN_STORE' | 'PHONE' | 'MESSAGE' | 'OTHER';
     /**
      * Your unique transaction id for this conversion (Google’s transaction_id). Used to de-duplicate.
      */
@@ -1627,7 +1631,7 @@ type GoogleAdsConversionStatus = {
      */
     request_id: string;
     /**
-     * One entry per destination, ordered to match the request’s destinations.
+     * One entry per destination, ordered to match the request’s destinations. EMPTY for the first ~minute after a send, while Google registers the request — poll again until it populates.
      */
     destinations: Array<{
         /**
@@ -34471,7 +34475,7 @@ declare const googleGetConversionStatusQueryKey: (options: Options<GoogleGetConv
  *
  * **Authentication.** Secret `pr_` API key, or a browser-safe frontend token granting `ads:read` scoped to the profile that owns the connection.
  *
- * Returns the per-destination, count-by-reason processing status for a prior conversion send (by its `request_id`) — the total events submitted, the error breakdown (with typed codes), and informational warnings.
+ * Returns the per-destination, count-by-reason processing status for a prior conversion send (by its `request_id`) — the total events submitted, the error breakdown (with typed codes), and informational warnings. `destinations` is EMPTY for the first ~minute after a send (Google registers the request asynchronously) — poll until it populates.
  */
 declare const googleGetConversionStatusOptions: (options: Options<GoogleGetConversionStatusData>) => _tanstack_react_query.OmitKeyof<_tanstack_react_query.UseQueryOptions<GoogleAdsConversionStatus, GoogleGetConversionStatusError, GoogleAdsConversionStatus, [Pick<Options<GoogleGetConversionStatusData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
     _id: string;

package/dist/query.d.ts

@@ -1525,13 +1525,13 @@ type GoogleAdsConversionUserIdentifier = {
      */
     phone_number?: string;
     /**
-     * A plaintext postal address. Name fields are hashed; region/postal code are sent in the clear.
+     * A plaintext postal address — all four parts are required. Name fields are hashed; region/postal code are sent in the clear.
      */
     address?: {
-        given_name?: string;
-        family_name?: string;
-        region_code?: string;
-        postal_code?: string;
+        given_name: string;
+        family_name: string;
+        region_code: string;
+        postal_code: string;
     };
 };
 /**
@@ -1539,9 +1539,13 @@ type GoogleAdsConversionUserIdentifier = {
  */
 type GoogleAdsConversionEvent = {
     /**
-     * When the conversion happened, as an RFC 3339 timestamp (required).
+     * When the conversion happened, as an RFC 3339 timestamp (required). A UTC `Z` or an explicit timezone offset (e.g. +05:30) is accepted.
      */
     event_timestamp: string;
+    /**
+     * Where the conversion happened (required by Google): WEB for a gclid web conversion, or APP / IN_STORE / PHONE / MESSAGE / OTHER.
+     */
+    event_source: 'WEB' | 'APP' | 'IN_STORE' | 'PHONE' | 'MESSAGE' | 'OTHER';
     /**
      * Your unique transaction id for this conversion (Google’s transaction_id). Used to de-duplicate.
      */
@@ -1627,7 +1631,7 @@ type GoogleAdsConversionStatus = {
      */
     request_id: string;
     /**
-     * One entry per destination, ordered to match the request’s destinations.
+     * One entry per destination, ordered to match the request’s destinations. EMPTY for the first ~minute after a send, while Google registers the request — poll again until it populates.
      */
     destinations: Array<{
         /**
@@ -34471,7 +34475,7 @@ declare const googleGetConversionStatusQueryKey: (options: Options<GoogleGetConv
  *
  * **Authentication.** Secret `pr_` API key, or a browser-safe frontend token granting `ads:read` scoped to the profile that owns the connection.
  *
- * Returns the per-destination, count-by-reason processing status for a prior conversion send (by its `request_id`) — the total events submitted, the error breakdown (with typed codes), and informational warnings.
+ * Returns the per-destination, count-by-reason processing status for a prior conversion send (by its `request_id`) — the total events submitted, the error breakdown (with typed codes), and informational warnings. `destinations` is EMPTY for the first ~minute after a send (Google registers the request asynchronously) — poll until it populates.
  */
 declare const googleGetConversionStatusOptions: (options: Options<GoogleGetConversionStatusData>) => _tanstack_react_query.OmitKeyof<_tanstack_react_query.UseQueryOptions<GoogleAdsConversionStatus, GoogleGetConversionStatusError, GoogleAdsConversionStatus, [Pick<Options<GoogleGetConversionStatusData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
     _id: string;