@codeqr/ts 0.19.3 → 0.24.0

package/src/resources/qrcodes/qrcodes.ts

@@ -23,6 +23,21 @@ export class Qrcodes extends APIResource {
     return this._client.post('/qrcodes', { body, ...options });
   }
 
+  /**
+   * Retrieve a paginated list of QR Codes for the authenticated workspace.
+   *
+   * @example
+   * ```ts
+   * const qrCodes = await client.qrcodes.list();
+   * ```
+   */
+  list(
+    query: QrcodeListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<QrcodeListResponse> {
+    return this._client.get('/qrcodes', { query, ...options });
+  }
+
   /**
    * Retrieve the info for a QR Code.
    *
@@ -56,21 +71,6 @@ export class Qrcodes extends APIResource {
     return this._client.put(path`/qrcodes/${qrcodeID}`, { body, ...options });
   }
 
-  /**
-   * Retrieve a paginated list of QR Codes for the authenticated workspace.
-   *
-   * @example
-   * ```ts
-   * const qrCodes = await client.qrcodes.list();
-   * ```
-   */
-  list(
-    query: QrcodeListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<QrcodeListResponse> {
-    return this._client.get('/qrcodes', { query, ...options });
-  }
-
   /**
    * Delete a QR Code for the authenticated workspace.
    *
@@ -291,6 +291,11 @@ export interface QrCode {
    */
   rewrite: boolean;
 
+  /**
+   * Smart rules for conditional destination routing by request attribute.
+   */
+  rules: Array<QrCode.Rule> | null;
+
   /**
    * The amount of the sale generated by the link.
    */
@@ -371,8 +376,10 @@ export interface QrCode {
     | 'crypto'
     | 'sms'
     | 'facetime'
+    | 'geo'
     | 'latlog'
-    | 'pix';
+    | 'pix'
+    | 'whatsapp';
 
   /**
    * The date and time the QR code was updated last.
@@ -426,6 +433,12 @@ export interface QrCode {
    */
   vcard: { [key: string]: string } | null;
 
+  /**
+   * The WhatsApp click-to-chat info: E.164 number (digits only) and optional
+   * prefilled message.
+   */
+  whatsapp: QrCode.Whatsapp | null;
+
   /**
    * The width of the QR code.
    */
@@ -436,6 +449,14 @@ export interface QrCode {
    */
   wifi: { [key: string]: string } | null;
 
+  /**
+   * Typographic styles applied to the frame label text. Object with optional keys:
+   * `weight` (`normal` | `bold`), `style` (`normal` | `italic`), `family` (`sans` |
+   * `sans-condensed` | `serif` | `serif-elegant` | `mono`), `size` (`s` | `m` | `l`
+   * | `xl`). Every field is enum-gated on write; omitted keys render with defaults.
+   */
+  frameTextStyles?: QrCode.FrameTextStyles | null;
+
   /**
    * The ID of the page to redirect to before the QR code destination.
    */
@@ -447,6 +468,44 @@ export interface QrCode {
   pageUrl?: string | null;
 }
 
+export namespace QrCode {
+  export interface Rule {
+    attribute: 'device' | 'country' | 'utm_source' | 'utm_medium' | 'utm_campaign' | 'referrer' | 'language';
+
+    operator: 'equals' | 'not_equals';
+
+    url: string;
+
+    value: string;
+  }
+
+  /**
+   * The WhatsApp click-to-chat info: E.164 number (digits only) and optional
+   * prefilled message.
+   */
+  export interface Whatsapp {
+    number: string;
+
+    message?: string;
+  }
+
+  /**
+   * Typographic styles applied to the frame label text. Object with optional keys:
+   * `weight` (`normal` | `bold`), `style` (`normal` | `italic`), `family` (`sans` |
+   * `sans-condensed` | `serif` | `serif-elegant` | `mono`), `size` (`s` | `m` | `l`
+   * | `xl`). Every field is enum-gated on write; omitted keys render with defaults.
+   */
+  export interface FrameTextStyles {
+    family?: 'sans' | 'sans-condensed' | 'serif' | 'serif-elegant' | 'mono';
+
+    size?: 's' | 'm' | 'l' | 'xl';
+
+    style?: 'normal' | 'italic';
+
+    weight?: 'normal' | 'bold';
+  }
+}
+
 export type QrcodeListResponse = Array<QrCode>;
 
 export interface QrcodeDeleteResponse {
@@ -460,7 +519,20 @@ export interface QrcodeCreateParams {
   /**
    * The type of content of the QR code.
    */
-  type: 'url' | 'text' | 'email' | 'wifi' | 'phone' | 'vcard' | 'crypto' | 'sms' | 'facetime' | 'latlog';
+  type:
+    | 'url'
+    | 'text'
+    | 'email'
+    | 'wifi'
+    | 'phone'
+    | 'vcard'
+    | 'crypto'
+    | 'sms'
+    | 'facetime'
+    | 'geo'
+    | 'latlog'
+    | 'pix'
+    | 'whatsapp';
 
   /**
    * The destination URL for Android for the QR code for device targeting Android.
@@ -473,7 +545,8 @@ export interface QrcodeCreateParams {
   archived?: boolean;
 
   /**
-   * The background color of the QR code.
+   * The background color of the QR code (hex or CSS keyword). Invalid values are
+   * coerced to default.
    */
   bgColor?: string;
 
@@ -544,7 +617,8 @@ export interface QrcodeCreateParams {
   facetime?: { [key: string]: string } | null;
 
   /**
-   * The foreground color of the QR code.
+   * The foreground color of the QR code (hex or CSS keyword). Invalid values are
+   * coerced to default.
    */
   fgColor?: string;
 
@@ -578,15 +652,26 @@ export interface QrcodeCreateParams {
   frameColor?: string;
 
   /**
-   * The text of the frame of the QR code.
+   * Label text rendered inside the frame (e.g. "SCAN ME", a product SKU). Maximum
+   * 200 characters. Word-wraps to multiple lines at larger sizes; the frame bar
+   * grows vertically to fit.
    */
   frameText?: string;
 
   /**
-   * The color of the text inside the frame (hex or CSS keyword). When not set, a
-   * contrasting color is derived from the frame color.
+   * Color of the frame label text (hex `#RRGGBB`, `#RGB`, `#RRGGBBAA`, or a CSS
+   * keyword from the allowlist). When omitted, a contrasting color is derived
+   * automatically from `frameColor`.
+   */
+  frameTextColor?: string | null;
+
+  /**
+   * Typographic styles applied to the frame label text. Every key is enum-gated —
+   * unknown keys or out-of-enum values are rejected to prevent SVG attribute
+   * injection. All fields are optional; omitted keys fall back to the default
+   * (normal weight, normal style, sans family, medium size).
    */
-  frameTextColor?: string;
+  frameTextStyles?: QrcodeCreateParams.FrameTextStyles | null;
 
   /**
    * Geographic segmentation information for the QR code in the JSON format
@@ -662,6 +747,12 @@ export interface QrcodeCreateParams {
    */
   phone?: string | null;
 
+  /**
+   * The prefix for the randomly generated key. If provided, the key will be prefixed
+   * with this value.
+   */
+  prefix?: string;
+
   /**
    * If the QR code has pre-redirection.
    */
@@ -682,6 +773,11 @@ export interface QrcodeCreateParams {
    */
   rewrite?: boolean;
 
+  /**
+   * Smart rules for conditional destination routing by request attribute.
+   */
+  rules?: Array<QrcodeCreateParams.Rule> | null;
+
   /**
    * The shape of the design around the QR code (none, square, circle).
    */
@@ -728,6 +824,13 @@ export interface QrcodeCreateParams {
    */
   tagNames?: string | Array<string>;
 
+  /**
+   * ID of a QR code (in the same project) marked as a template. Its customization
+   * fields (colors, logo, pattern, shape, frame) will be applied to the new QR code
+   * unless explicitly overridden.
+   */
+  templateId?: string | null;
+
   /**
    * The text of the QR code.
    */
@@ -772,6 +875,12 @@ export interface QrcodeCreateParams {
    */
   webhookIds?: Array<string> | null;
 
+  /**
+   * The WhatsApp click-to-chat info: E.164 number (digits only) and optional
+   * prefilled message.
+   */
+  whatsapp?: QrcodeCreateParams.Whatsapp | null;
+
   /**
    * Logo width in pixels. When omitted, a proportional size is used based on the QR
    * code size (about 10–20% depending on size).
@@ -785,6 +894,40 @@ export interface QrcodeCreateParams {
 }
 
 export namespace QrcodeCreateParams {
+  /**
+   * Typographic styles applied to the frame label text. Every key is enum-gated —
+   * unknown keys or out-of-enum values are rejected to prevent SVG attribute
+   * injection. All fields are optional; omitted keys fall back to the default
+   * (normal weight, normal style, sans family, medium size).
+   */
+  export interface FrameTextStyles {
+    /**
+     * Font family used for the frame label text. `sans` = Arial / Helvetica (default).
+     * `sans-condensed` = Arial Narrow. `serif` = Georgia / Times New Roman.
+     * `serif-elegant` = Palatino Linotype / Book Antiqua. `mono` = Courier New. Values
+     * resolve to safe system font stacks on the rendered SVG.
+     */
+    family?: 'sans' | 'sans-condensed' | 'serif' | 'serif-elegant' | 'mono';
+
+    /**
+     * Font size preset for the frame label. `s` = 60 viewBox units, `m` = 89.1
+     * (default), `l` = 120, `xl` = 150. Larger sizes grow the frame bar vertically to
+     * fit. Extremely long text auto-shrinks to keep within 4 lines (floor 48).
+     */
+    size?: 's' | 'm' | 'l' | 'xl';
+
+    /**
+     * Font style of the frame label text. `italic` applies `font-style="italic"`.
+     */
+    style?: 'normal' | 'italic';
+
+    /**
+     * Font weight of the frame label text. `bold` renders at SVG `font-weight="700"`,
+     * `normal` at `400`.
+     */
+    weight?: 'normal' | 'bold';
+  }
+
   /**
    * Geographic segmentation information for the QR code in the JSON format
    * `{[COUNTRY]: https://example.com }`.
@@ -1290,207 +1433,458 @@ export namespace QrcodeCreateParams {
 
     ZW?: string;
   }
-}
 
-export interface QrcodeRetrieveParams {
-  /**
-   * The domain of the QR code to be retrieved. For example, for
-   * `codeqr.link/github`, the domain is `codeqr.link`.
-   */
-  domain: string;
+  export interface Rule {
+    attribute: 'device' | 'country' | 'utm_source' | 'utm_medium' | 'utm_campaign' | 'referrer' | 'language';
 
-  /**
-   * The key of the QR code to be retrieved. For example, for `codeqr.link/github`,
-   * the key is `github`.
-   */
-  key: string;
+    operator: 'equals' | 'not_equals';
 
-  /**
-   * The slug of the project to which the QR code belongs. For example, for
-   * `app.codeqr.io/acme`, the projectSlug is `acme`.
-   */
-  projectSlug: string;
+    url: string;
 
-  /**
-   * This is the ID of the QR code in your database. It must be prefixed with `ext_`
-   * when passed as a query parameter.
-   */
-  externalId?: string;
+    value: string;
+  }
 
   /**
-   * The unique ID of the QR code.
+   * The WhatsApp click-to-chat info: E.164 number (digits only) and optional
+   * prefilled message.
    */
-  qrCodeId?: string;
+  export interface Whatsapp {
+    number: string;
+
+    message?: string;
+  }
 }
 
-export interface QrcodeUpdateParams {
+export interface QrcodeListParams {
   /**
-   * The destination URL for Android for the QR code for device targeting Android.
+   * The comments to filter by.
    */
-  android?: string | null;
+  comments?: string;
 
   /**
-   * If the QR code is archived.
+   * Filter QR codes created after this date
    */
-  archived?: boolean;
+  createdAfter?: string;
 
   /**
-   * The background color of the QR code.
+   * Filter QR codes created before this date
    */
-  bgColor?: string;
+  createdBefore?: string;
 
   /**
-   * The comments for the QR code.
+   * The domain to filter the QR codes. For example, `ac.me`. If not provided, all QR
+   * codes of the project will be returned.
    */
-  comments?: string | null;
+  domain?: string;
 
   /**
-   * The static content of the QR code.
+   * Filter QR codes expiring after this date
    */
-  contentStatic?: string | null;
+  expiresAfter?: string;
 
   /**
-   * The cryptocurrency information of the QR code.
+   * The date and time the QR code will expire in ISO-8601 format. Must be in the
+   * future.
    */
-  crypto?: { [key: string]: string } | null;
+  expiresAt?: string | null;
 
   /**
-   * The description of the QR code generated via `api.codeqr.io/metatags`. Will be
-   * used for custom link preview if `proxy` is true.
+   * Filter QR codes expiring before this date
    */
-  description?: string | null;
+  expiresBefore?: string;
 
   /**
-   * Allow search engines to index your QR code. The default is `false` if not
-   * provided. Learn more: https://codeqr.link/noindex
+   * The folder ID to filter the QR codes by.
    */
-  doIndex?: boolean;
+  folderId?: string;
 
   /**
-   * The domain of the QR code. If not provided, the main domain of the project will
-   * be used (or `codeqr.link` if the project does not have domains).
+   * Filter by QR code format - static or dynamic
    */
-  domain?: string;
+  format?: 'static' | 'dynamic';
 
   /**
-   * The email information of the QR code.
+   * Filter QR codes with/without comments
    */
-  email?: { [key: string]: string } | null;
+  hasComments?: boolean;
 
   /**
-   * If the QR code should have excavated areas.
+   * Filter QR codes with/without custom social media cards
    */
-  excavate?: boolean;
+  hasCustomSocial?: boolean;
 
   /**
-   * The URL to redirect when the QR code expires.
+   * Filter QR codes with/without device targeting
    */
-  expiredUrl?: string | null;
+  hasDevice?: boolean;
 
   /**
-   * The date and time the QR code will expire in ISO-8601 format. Must be in the
-   * future.
+   * Filter QR codes with/without expiration date
    */
-  expiresAt?: string | null;
+  hasExpiration?: boolean;
 
   /**
-   * This is the ID of the QR code in your database. If defined, it can be used to
-   * identify the QR code in the future. It must be prefixed with `ext_` when passed
-   * as a query parameter.
+   * Filter QR codes with/without geo-targeting
    */
-  externalId?: string | null;
+  hasGeo?: boolean;
 
   /**
-   * The FaceTime information of the QR code.
+   * Filter QR codes with/without password protection
    */
-  facetime?: { [key: string]: string } | null;
+  hasPassword?: boolean;
 
   /**
-   * The foreground color of the QR code.
+   * Filter QR codes with/without tags
    */
-  fgColor?: string;
+  hasTags?: boolean;
 
   /**
-   * If the QR code is filled.
+   * Filter QR codes with/without UTM parameters
    */
-  filled?: boolean;
+  hasUTM?: boolean;
 
   /**
-   * If the QR code is flexible.
+   * The page number for pagination.
    */
-  flexible?: boolean;
+  page?: number;
 
   /**
-   * The unique ID of the folder assigned to the QR code. Omit or set to null for no
-   * folder.
+   * The number of items per page.
    */
-  folderId?: string | null;
+  pageSize?: number;
 
   /**
-   * The type of frame of the QR code (e.g. none, frame-1, frame-2, frame-3, frame-5,
-   * frame-6). frame-5/6 are top-bar variants. Unknown ids fall back to no frame at
-   * render.
+   * The password to filter by.
    */
-  frame?: string;
+  password?: string;
 
   /**
-   * The color of the frame (hex or CSS keyword). Invalid values are coerced to
-   * default.
+   * The slug of the project to which the QR code belongs. For example, for
+   * `app.codeqr.io/acme`, the projectSlug is `acme`.
    */
-  frameColor?: string;
+  projectSlug?: string;
 
   /**
-   * The text of the frame of the QR code.
+   * Maximum number of scans
    */
-  frameText?: string;
+  scansMax?: number;
 
   /**
-   * The color of the text inside the frame (hex or CSS keyword). When not set, a
-   * contrasting color is derived from the frame color.
+   * Minimum number of scans
    */
-  frameTextColor?: string;
+  scansMin?: number;
 
   /**
-   * Geographic segmentation information for the QR code in the JSON format
-   * `{[COUNTRY]: https://example.com }`.
+   * The search term to filter the QR codes. The search term will be matched against
+   * the QR code slug, title, and the destination URL.
    */
-  geo?: QrcodeUpdateParams.Geo | null;
+  search?: string;
 
   /**
-   * Logo height in pixels. When omitted, a proportional size is used based on the QR
-   * code size (about 10–20% depending on size).
+   * If should include archived QR codes in the response. The default is `false` if
+   * not provided.
    */
-  height?: number;
+  showArchived?: boolean;
 
   /**
-   * The image of the QR code generated via `api.codeqr.io/metatags`. Will be used
-   * for custom link preview if `proxy` is true.
+   * The field to order the QR codes. The default is `createdAt`, and the order of
+   * sorting is always descending.
    */
-  image?: string | null;
+  sort?: 'createdAt' | 'scans' | 'lastClicked';
 
   /**
-   * The destination URL for iOS for the QR code for device targeting iOS.
+   * @deprecated [DEPRECATED (use tagIds instead)]: The unique ID of the tag assigned
+   * to the QR code.
    */
-  ios?: string | null;
+  tagId?: string;
 
   /**
-   * If the form is mandatory for the page.
+   * The IDs of the tags to filter the QR codes.
    */
-  isFormMandatory?: boolean;
+  tagIds?: string | Array<string>;
 
   /**
-   * The slug of the QR code. If not provided, a random slug of 7 characters will be
-   * generated.
+   * The unique name of the tags assigned to the QR code (case insensitive).
    */
-  key?: string;
+  tagNames?: string | Array<string>;
 
   /**
-   * The latitude and longitude information of the QR code.
+   * If should include QR codes with conversion tracking enabled. The default is
+   * `false` if not provided.
    */
-  latlog?: { [key: string]: string } | null;
+  trackConversion?: boolean;
 
   /**
-   * The level of error correction of the QR code.
+   * Filter by QR code type
+   */
+  type?:
+    | 'url'
+    | 'text'
+    | 'email'
+    | 'wifi'
+    | 'phone'
+    | 'vcard'
+    | 'crypto'
+    | 'sms'
+    | 'facetime'
+    | 'geo'
+    | 'latlog'
+    | 'pix'
+    | 'whatsapp';
+
+  /**
+   * Filter QR codes marked as templates.
+   */
+  useAsTemplate?: boolean;
+
+  /**
+   * The ID of the user to filter by.
+   */
+  userId?: string;
+
+  /**
+   * Filter by UTM campaign value
+   */
+  utm_campaign?: string;
+
+  /**
+   * Filter by UTM content value
+   */
+  utm_content?: string;
+
+  /**
+   * Filter by UTM medium value
+   */
+  utm_medium?: string;
+
+  /**
+   * Filter by UTM source value
+   */
+  utm_source?: string;
+
+  /**
+   * Filter by UTM term value
+   */
+  utm_term?: string;
+
+  /**
+   * If should include tags in the response. The default is `false` if not provided.
+   */
+  withTags?: boolean;
+}
+
+export interface QrcodeRetrieveParams {
+  /**
+   * The domain of the QR code to be retrieved. For example, for
+   * `codeqr.link/github`, the domain is `codeqr.link`.
+   */
+  domain: string;
+
+  /**
+   * The key of the QR code to be retrieved. For example, for `codeqr.link/github`,
+   * the key is `github`.
+   */
+  key: string;
+
+  /**
+   * The slug of the project to which the QR code belongs. For example, for
+   * `app.codeqr.io/acme`, the projectSlug is `acme`.
+   */
+  projectSlug: string;
+
+  /**
+   * This is the ID of the QR code in your database. It must be prefixed with `ext_`
+   * when passed as a query parameter.
+   */
+  externalId?: string;
+
+  /**
+   * The unique ID of the QR code.
+   */
+  qrCodeId?: string;
+}
+
+export interface QrcodeUpdateParams {
+  /**
+   * The destination URL for Android for the QR code for device targeting Android.
+   */
+  android?: string | null;
+
+  /**
+   * If the QR code is archived.
+   */
+  archived?: boolean;
+
+  /**
+   * The background color of the QR code (hex or CSS keyword). Invalid values are
+   * coerced to default.
+   */
+  bgColor?: string;
+
+  /**
+   * The comments for the QR code.
+   */
+  comments?: string | null;
+
+  /**
+   * The static content of the QR code.
+   */
+  contentStatic?: string | null;
+
+  /**
+   * The cryptocurrency information of the QR code.
+   */
+  crypto?: { [key: string]: string } | null;
+
+  /**
+   * The description of the QR code generated via `api.codeqr.io/metatags`. Will be
+   * used for custom link preview if `proxy` is true.
+   */
+  description?: string | null;
+
+  /**
+   * Allow search engines to index your QR code. The default is `false` if not
+   * provided. Learn more: https://codeqr.link/noindex
+   */
+  doIndex?: boolean;
+
+  /**
+   * The domain of the QR code. If not provided, the main domain of the project will
+   * be used (or `codeqr.link` if the project does not have domains).
+   */
+  domain?: string;
+
+  /**
+   * The email information of the QR code.
+   */
+  email?: { [key: string]: string } | null;
+
+  /**
+   * If the QR code should have excavated areas.
+   */
+  excavate?: boolean;
+
+  /**
+   * The URL to redirect when the QR code expires.
+   */
+  expiredUrl?: string | null;
+
+  /**
+   * The date and time the QR code will expire in ISO-8601 format. Must be in the
+   * future.
+   */
+  expiresAt?: string | null;
+
+  /**
+   * This is the ID of the QR code in your database. If defined, it can be used to
+   * identify the QR code in the future. It must be prefixed with `ext_` when passed
+   * as a query parameter.
+   */
+  externalId?: string | null;
+
+  /**
+   * The FaceTime information of the QR code.
+   */
+  facetime?: { [key: string]: string } | null;
+
+  /**
+   * The foreground color of the QR code (hex or CSS keyword). Invalid values are
+   * coerced to default.
+   */
+  fgColor?: string;
+
+  /**
+   * If the QR code is filled.
+   */
+  filled?: boolean;
+
+  /**
+   * If the QR code is flexible.
+   */
+  flexible?: boolean;
+
+  /**
+   * The unique ID of the folder assigned to the QR code. Omit or set to null for no
+   * folder.
+   */
+  folderId?: string | null;
+
+  /**
+   * The type of frame of the QR code (e.g. none, frame-1, frame-2, frame-3, frame-5,
+   * frame-6). frame-5/6 are top-bar variants. Unknown ids fall back to no frame at
+   * render.
+   */
+  frame?: string;
+
+  /**
+   * The color of the frame (hex or CSS keyword). Invalid values are coerced to
+   * default.
+   */
+  frameColor?: string;
+
+  /**
+   * Label text rendered inside the frame (e.g. "SCAN ME", a product SKU). Maximum
+   * 200 characters. Word-wraps to multiple lines at larger sizes; the frame bar
+   * grows vertically to fit.
+   */
+  frameText?: string;
+
+  /**
+   * Color of the frame label text (hex `#RRGGBB`, `#RGB`, `#RRGGBBAA`, or a CSS
+   * keyword from the allowlist). When omitted, a contrasting color is derived
+   * automatically from `frameColor`.
+   */
+  frameTextColor?: string | null;
+
+  /**
+   * Typographic styles applied to the frame label text. Every key is enum-gated —
+   * unknown keys or out-of-enum values are rejected to prevent SVG attribute
+   * injection. All fields are optional; omitted keys fall back to the default
+   * (normal weight, normal style, sans family, medium size).
+   */
+  frameTextStyles?: QrcodeUpdateParams.FrameTextStyles | null;
+
+  /**
+   * Geographic segmentation information for the QR code in the JSON format
+   * `{[COUNTRY]: https://example.com }`.
+   */
+  geo?: QrcodeUpdateParams.Geo | null;
+
+  /**
+   * Logo height in pixels. When omitted, a proportional size is used based on the QR
+   * code size (about 10–20% depending on size).
+   */
+  height?: number;
+
+  /**
+   * The image of the QR code generated via `api.codeqr.io/metatags`. Will be used
+   * for custom link preview if `proxy` is true.
+   */
+  image?: string | null;
+
+  /**
+   * The destination URL for iOS for the QR code for device targeting iOS.
+   */
+  ios?: string | null;
+
+  /**
+   * If the form is mandatory for the page.
+   */
+  isFormMandatory?: boolean;
+
+  /**
+   * The slug of the QR code. If not provided, a random slug of 7 characters will be
+   * generated.
+   */
+  key?: string;
+
+  /**
+   * The latitude and longitude information of the QR code.
+   */
+  latlog?: { [key: string]: string } | null;
+
+  /**
+   * The level of error correction of the QR code.
    */
   level?: string;
 
@@ -1524,6 +1918,12 @@ export interface QrcodeUpdateParams {
    */
   phone?: string | null;
 
+  /**
+   * The prefix for the randomly generated key. If provided, the key will be prefixed
+   * with this value.
+   */
+  prefix?: string;
+
   /**
    * If the QR code has pre-redirection.
    */
@@ -1544,6 +1944,11 @@ export interface QrcodeUpdateParams {
    */
   rewrite?: boolean;
 
+  /**
+   * Smart rules for conditional destination routing by request attribute.
+   */
+  rules?: Array<QrcodeUpdateParams.Rule> | null;
+
   /**
    * The shape of the design around the QR code (none, square, circle).
    */
@@ -1590,6 +1995,13 @@ export interface QrcodeUpdateParams {
    */
   tagNames?: string | Array<string>;
 
+  /**
+   * ID of a QR code (in the same project) marked as a template. Its customization
+   * fields (colors, logo, pattern, shape, frame) will be applied to the new QR code
+   * unless explicitly overridden.
+   */
+  templateId?: string | null;
+
   /**
    * The text of the QR code.
    */
@@ -1609,7 +2021,20 @@ export interface QrcodeUpdateParams {
   /**
    * The type of content of the QR code.
    */
-  type?: 'url' | 'text' | 'email' | 'wifi' | 'phone' | 'vcard' | 'crypto' | 'sms' | 'facetime' | 'latlog';
+  type?:
+    | 'url'
+    | 'text'
+    | 'email'
+    | 'wifi'
+    | 'phone'
+    | 'vcard'
+    | 'crypto'
+    | 'sms'
+    | 'facetime'
+    | 'geo'
+    | 'latlog'
+    | 'pix'
+    | 'whatsapp';
 
   /**
    * The destination URL of the QR code.
@@ -1639,6 +2064,12 @@ export interface QrcodeUpdateParams {
    */
   webhookIds?: Array<string> | null;
 
+  /**
+   * The WhatsApp click-to-chat info: E.164 number (digits only) and optional
+   * prefilled message.
+   */
+  whatsapp?: QrcodeUpdateParams.Whatsapp | null;
+
   /**
    * Logo width in pixels. When omitted, a proportional size is used based on the QR
    * code size (about 10–20% depending on size).
@@ -1652,6 +2083,40 @@ export interface QrcodeUpdateParams {
 }
 
 export namespace QrcodeUpdateParams {
+  /**
+   * Typographic styles applied to the frame label text. Every key is enum-gated —
+   * unknown keys or out-of-enum values are rejected to prevent SVG attribute
+   * injection. All fields are optional; omitted keys fall back to the default
+   * (normal weight, normal style, sans family, medium size).
+   */
+  export interface FrameTextStyles {
+    /**
+     * Font family used for the frame label text. `sans` = Arial / Helvetica (default).
+     * `sans-condensed` = Arial Narrow. `serif` = Georgia / Times New Roman.
+     * `serif-elegant` = Palatino Linotype / Book Antiqua. `mono` = Courier New. Values
+     * resolve to safe system font stacks on the rendered SVG.
+     */
+    family?: 'sans' | 'sans-condensed' | 'serif' | 'serif-elegant' | 'mono';
+
+    /**
+     * Font size preset for the frame label. `s` = 60 viewBox units, `m` = 89.1
+     * (default), `l` = 120, `xl` = 150. Larger sizes grow the frame bar vertically to
+     * fit. Extremely long text auto-shrinks to keep within 4 lines (floor 48).
+     */
+    size?: 's' | 'm' | 'l' | 'xl';
+
+    /**
+     * Font style of the frame label text. `italic` applies `font-style="italic"`.
+     */
+    style?: 'normal' | 'italic';
+
+    /**
+     * Font weight of the frame label text. `bold` renders at SVG `font-weight="700"`,
+     * `normal` at `400`.
+     */
+    weight?: 'normal' | 'bold';
+  }
+
   /**
    * Geographic segmentation information for the QR code in the JSON format
    * `{[COUNTRY]: https://example.com }`.
@@ -2157,197 +2622,26 @@ export namespace QrcodeUpdateParams {
 
     ZW?: string;
   }
-}
-
-export interface QrcodeListParams {
-  /**
-   * The comments to filter by.
-   */
-  comments?: string;
-
-  /**
-   * Filter QR codes created after this date
-   */
-  createdAfter?: string;
-
-  /**
-   * Filter QR codes created before this date
-   */
-  createdBefore?: string;
-
-  /**
-   * The domain to filter the QR codes. For example, `ac.me`. If not provided, all QR
-   * codes of the project will be returned.
-   */
-  domain?: string;
-
-  /**
-   * Filter QR codes expiring after this date
-   */
-  expiresAfter?: string;
-
-  /**
-   * The date and time the QR code will expire in ISO-8601 format. Must be in the
-   * future.
-   */
-  expiresAt?: string | null;
-
-  /**
-   * Filter QR codes expiring before this date
-   */
-  expiresBefore?: string;
-
-  /**
-   * The folder ID to filter the QR codes by.
-   */
-  folderId?: string;
-
-  /**
-   * Filter by QR code format - static or dynamic
-   */
-  format?: 'static' | 'dynamic';
-
-  /**
-   * Filter QR codes with/without comments
-   */
-  hasComments?: boolean;
-
-  /**
-   * Filter QR codes with/without custom social media cards
-   */
-  hasCustomSocial?: boolean;
-
-  /**
-   * Filter QR codes with/without device targeting
-   */
-  hasDevice?: boolean;
-
-  /**
-   * Filter QR codes with/without expiration date
-   */
-  hasExpiration?: boolean;
-
-  /**
-   * Filter QR codes with/without geo-targeting
-   */
-  hasGeo?: boolean;
 
-  /**
-   * Filter QR codes with/without password protection
-   */
-  hasPassword?: boolean;
+  export interface Rule {
+    attribute: 'device' | 'country' | 'utm_source' | 'utm_medium' | 'utm_campaign' | 'referrer' | 'language';
 
-  /**
-   * Filter QR codes with/without tags
-   */
-  hasTags?: boolean;
-
-  /**
-   * Filter QR codes with/without UTM parameters
-   */
-  hasUTM?: boolean;
+    operator: 'equals' | 'not_equals';
 
-  /**
-   * The page number for pagination.
-   */
-  page?: number;
-
-  /**
-   * The number of items per page.
-   */
-  pageSize?: number;
-
-  /**
-   * The password to filter by.
-   */
-  password?: string;
+    url: string;
 
-  /**
-   * The slug of the project to which the QR code belongs. For example, for
-   * `app.codeqr.io/acme`, the projectSlug is `acme`.
-   */
-  projectSlug?: string;
-
-  /**
-   * Maximum number of scans
-   */
-  scansMax?: number;
-
-  /**
-   * Minimum number of scans
-   */
-  scansMin?: number;
-
-  /**
-   * The search term to filter the QR codes. The search term will be matched against
-   * the QR code slug and the destination URL.
-   */
-  search?: string;
-
-  /**
-   * If should include archived QR codes in the response. The default is `false` if
-   * not provided.
-   */
-  showArchived?: boolean;
-
-  /**
-   * The field to order the QR codes. The default is `createdAt`, and the order of
-   * sorting is always descending.
-   */
-  sort?: 'createdAt' | 'scans' | 'lastClicked';
-
-  /**
-   * @deprecated [DEPRECATED (use tagIds instead)]: The unique ID of the tag assigned
-   * to the QR code.
-   */
-  tagId?: string;
-
-  /**
-   * The IDs of the tags to filter the QR codes.
-   */
-  tagIds?: string | Array<string>;
-
-  /**
-   * The unique name of the tags assigned to the QR code (case insensitive).
-   */
-  tagNames?: string | Array<string>;
-
-  /**
-   * If should include QR codes with conversion tracking enabled. The default is
-   * `false` if not provided.
-   */
-  trackConversion?: boolean;
-
-  /**
-   * Filter by QR code type
-   */
-  type?:
-    | 'url'
-    | 'text'
-    | 'email'
-    | 'wifi'
-    | 'phone'
-    | 'vcard'
-    | 'crypto'
-    | 'sms'
-    | 'facetime'
-    | 'latlog'
-    | 'pix';
-
-  /**
-   * Filter QR codes marked as templates.
-   */
-  useAsTemplate?: boolean;
+    value: string;
+  }
 
   /**
-   * The ID of the user to filter by.
+   * The WhatsApp click-to-chat info: E.164 number (digits only) and optional
+   * prefilled message.
    */
-  userId?: string;
+  export interface Whatsapp {
+    number: string;
 
-  /**
-   * If should include tags in the response. The default is `false` if not provided.
-   */
-  withTags?: boolean;
+    message?: string;
+  }
 }
 
 Qrcodes.Bulk = Bulk;
@@ -2358,9 +2652,9 @@ export declare namespace Qrcodes {
     type QrcodeListResponse as QrcodeListResponse,
     type QrcodeDeleteResponse as QrcodeDeleteResponse,
     type QrcodeCreateParams as QrcodeCreateParams,
+    type QrcodeListParams as QrcodeListParams,
     type QrcodeRetrieveParams as QrcodeRetrieveParams,
     type QrcodeUpdateParams as QrcodeUpdateParams,
-    type QrcodeListParams as QrcodeListParams,
   };
 
   export {