late-sdk 1.4.413__tar.gz → 1.4.415__tar.gz

{late_sdk-1.4.413 → late_sdk-1.4.415}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: late-sdk
-Version: 1.4.413
+Version: 1.4.415
 Summary: The official Python library for the Zernio API
 Project-URL: Homepage, https://zernio.com
 Project-URL: Documentation, https://docs.zernio.com

{late_sdk-1.4.413 → late_sdk-1.4.415}/openapi.yaml

@@ -1457,6 +1457,11 @@ components:
               type: array
               items: { type: string }
               description: Sample values for header text variables
+            header_text_named_params:
+              type: array
+              items:
+                $ref: '#/components/schemas/WhatsAppNamedParamExample'
+              description: 'Sample values for NAMED header variables (templates using {{customer_name}}-style tokens with parameter_format: NAMED).'
             header_handle:
               type: array
               minItems: 1
@@ -1487,6 +1492,22 @@ components:
                 type: array
                 items: { type: string }
               description: Sample values for body variables (array of arrays)
+            body_text_named_params:
+              type: array
+              items:
+                $ref: '#/components/schemas/WhatsAppNamedParamExample'
+              description: 'Sample values for NAMED body variables (templates using {{customer_name}}-style tokens with parameter_format: NAMED).'
+    WhatsAppNamedParamExample:
+      type: object
+      required: [param_name, example]
+      properties:
+        param_name:
+          type: string
+          pattern: '^[a-z0-9_]+$'
+          description: 'Variable name as it appears in the text, without braces (e.g. customer_name for {{customer_name}}).'
+        example:
+          type: string
+          description: Sample value for this variable.
     WhatsAppFooterComponent:
       type: object
       required: [type]
@@ -6995,7 +7016,7 @@ components:
           type: [object, "null"]
           description: Platform-specific creative data. Fields vary by platform.
           properties:
-            thumbnailUrl: { type: string, description: Primary thumbnail/image URL }
+            thumbnailUrl: { type: [string, "null"], description: Primary thumbnail/image URL }
             imageUrl: { type: string, description: Alternative image URL }
             videoId: { type: [string, "null"], description: "Meta video ID for VIDEO-type ads. Null for non-video ads. Callers that need an embeddable MP4 can call GET /{videoId}?fields=source with the page access token." }
             videoUrl: { type: [string, "null"], description: "Public Facebook watch URL for VIDEO-type ads (https://www.facebook.com/watch/?v={videoId}). Null for non-video ads." }
@@ -26161,6 +26182,10 @@ paths:
                 language:
                   type: string
                   description: Template language code (e.g., en_US)
+                parameter_format:
+                  type: string
+                  enum: [POSITIONAL, NAMED, positional, named]
+                  description: 'Variable style: POSITIONAL ({{1}}, the default) or NAMED ({{customer_name}}). Named templates provide examples via body_text_named_params / header_text_named_params. Inferred as NAMED when omitted but a named-params example is present.'
                 components:
                   type: array
                   description: "Template components (header, body, footer, buttons, carousel, limited_time_offer). Required for custom templates, omit when using library_template_name."

{late_sdk-1.4.413 → late_sdk-1.4.415}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "late-sdk"
-version = "1.4.413"
+version = "1.4.415"
 description = "The official Python library for the Zernio API"
 readme = "README.md"
 requires-python = ">=3.10"

{late_sdk-1.4.413 → late_sdk-1.4.415}/src/late/__init__.py

@@ -42,7 +42,7 @@ from .enums import (
     Visibility,
 )
 
-__version__ = "1.4.413"
+__version__ = "1.4.415"
 
 __all__ = [
     # Client

{late_sdk-1.4.413 → late_sdk-1.4.415}/src/late/mcp/generated_tools.py

@@ -14545,6 +14545,7 @@ def register_generated_tools(mcp, _get_client):
         name: str,
         category: str,
         language: str,
+        parameter_format: str | None = None,
         components: list[dict[str, Any]] | None = None,
         library_template_name: str | None = None,
         library_template_body_inputs: dict[str, Any] | None = None,
@@ -14557,6 +14558,7 @@ def register_generated_tools(mcp, _get_client):
                 name: Template name (lowercase, letters/numbers/underscores, must start with a letter) (required)
                 category: Template category (required)
                 language: Template language code (e.g., en_US) (required)
+                parameter_format: Variable style: POSITIONAL ({{1}}, the default) or NAMED ({{customer_name}}). Named templates provide examples via body_text_named_params / header_text_named_params. Inferred as NAMED when omitted but a named-params example is present.
                 components: Template components (header, body, footer, buttons, carousel, limited_time_offer). Required for custom templates, omit when using library_template_name.
                 library_template_name: Name of a pre-built template from Meta's template library (e.g., "appointment_reminder",
         "auto_pay_reminder_1", "address_update"). When provided, the template is pre-approved
@@ -14573,6 +14575,7 @@ def register_generated_tools(mcp, _get_client):
                 name=name,
                 category=category,
                 language=language,
+                parameter_format=parameter_format,
                 components=components,
                 library_template_name=library_template_name,
                 library_template_body_inputs=library_template_body_inputs,

{late_sdk-1.4.413 → late_sdk-1.4.415}/src/late/models/_generated/models.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  openapi.yaml
-#   timestamp: 2026-08-04T11:57:30+00:00
+#   timestamp: 2026-08-04T14:32:02+00:00
 
 from __future__ import annotations
 
@@ -1076,49 +1076,19 @@ class Format(str, Enum):
     LOCATION = "location"
 
 
-class Example(BaseModel):
-    header_text: List[str] | None = None
-    """
-    Sample values for header text variables
-    """
-    header_handle: List[AnyUrl] | None = None
-    """
-    When the header format is a media type (image, video, gif, document), provide a public URL here. Zernio will download and upload it to WhatsApp on your behalf, replacing it with the internal file handle before creating the template.
-    """
-
-
-class WhatsAppHeaderComponent(BaseModel):
-    type: Literal["header"]
-    format: Format
-    text: str | None = None
-    """
-    Header text (may include {{1}} variable). Used when format is TEXT.
-    """
-    example: Example | None = None
-
-
 class Type5(str, Enum):
     BODY = "body"
 
 
-class Example1(BaseModel):
-    body_text: List[List[str]] | None = None
+class WhatsAppNamedParamExample(BaseModel):
+    param_name: Annotated[str, Field(pattern="^[a-z0-9_]+$")]
     """
-    Sample values for body variables (array of arrays)
+    Variable name as it appears in the text, without braces (e.g. customer_name for {{customer_name}}).
     """
-
-
-class WhatsAppBodyComponent(BaseModel):
-    type: Literal["body"]
-    text: str
-    """
-    Body text with optional {{n}} variables
+    example: str
     """
-    add_security_recommendation: bool | None = None
-    """
-    Add security recommendation text (authentication templates only)
+    Sample value for this variable.
     """
-    example: Example1 | None = None
 
 
 class Type6(str, Enum):
@@ -9229,24 +9199,53 @@ class SharedAdAccount(BaseModel):
     """
 
 
-class Card(BaseModel):
-    components: Annotated[
-        List[
-            WhatsAppHeaderComponent | WhatsAppBodyComponent | WhatsAppButtonsComponent
-        ],
-        Field(min_length=1),
-    ]
+class Example(BaseModel):
+    header_text: List[str] | None = None
     """
-    Per-card components. Each card carries its own media header + optional body + up to 2 buttons. Footer and nested carousel are not allowed inside cards.
+    Sample values for header text variables
+    """
+    header_text_named_params: List[WhatsAppNamedParamExample] | None = None
+    """
+    Sample values for NAMED header variables (templates using {{customer_name}}-style tokens with parameter_format: NAMED).
+    """
+    header_handle: List[AnyUrl] | None = None
+    """
+    When the header format is a media type (image, video, gif, document), provide a public URL here. Zernio will download and upload it to WhatsApp on your behalf, replacing it with the internal file handle before creating the template.
     """
 
 
-class WhatsAppCarouselComponent(BaseModel):
-    type: Literal["carousel"]
-    cards: Annotated[List[Card], Field(max_length=10, min_length=2)]
+class WhatsAppHeaderComponent(BaseModel):
+    type: Literal["header"]
+    format: Format
+    text: str | None = None
     """
-    2-10 cards. Meta requires all cards to share the same component structure; a mismatch surfaces as a rejected_reason. MARKETING category only.
+    Header text (may include {{1}} variable). Used when format is TEXT.
+    """
+    example: Example | None = None
+
+
+class Example1(BaseModel):
+    body_text: List[List[str]] | None = None
+    """
+    Sample values for body variables (array of arrays)
+    """
+    body_text_named_params: List[WhatsAppNamedParamExample] | None = None
     """
+    Sample values for NAMED body variables (templates using {{customer_name}}-style tokens with parameter_format: NAMED).
+    """
+
+
+class WhatsAppBodyComponent(BaseModel):
+    type: Literal["body"]
+    text: str
+    """
+    Body text with optional {{n}} variables
+    """
+    add_security_recommendation: bool | None = None
+    """
+    Add security recommendation text (authentication templates only)
+    """
+    example: Example1 | None = None
 
 
 class ExternalPostWebhookPost(BaseModel):
@@ -9369,25 +9368,24 @@ class XApiPricing(BaseModel):
     """
 
 
-class WhatsAppTemplateComponent(
-    RootModel[
-        WhatsAppHeaderComponent
-        | WhatsAppBodyComponent
-        | WhatsAppFooterComponent
-        | WhatsAppButtonsComponent
-        | WhatsAppCarouselComponent
-        | WhatsAppLimitedTimeOfferComponent
-    ]
-):
-    root: Annotated[
-        WhatsAppHeaderComponent
-        | WhatsAppBodyComponent
-        | WhatsAppFooterComponent
-        | WhatsAppButtonsComponent
-        | WhatsAppCarouselComponent
-        | WhatsAppLimitedTimeOfferComponent,
-        Field(discriminator="type"),
+class Card(BaseModel):
+    components: Annotated[
+        List[
+            WhatsAppHeaderComponent | WhatsAppBodyComponent | WhatsAppButtonsComponent
+        ],
+        Field(min_length=1),
     ]
+    """
+    Per-card components. Each card carries its own media header + optional body + up to 2 buttons. Footer and nested carousel are not allowed inside cards.
+    """
+
+
+class WhatsAppCarouselComponent(BaseModel):
+    type: Literal["carousel"]
+    cards: Annotated[List[Card], Field(max_length=10, min_length=2)]
+    """
+    2-10 cards. Meta requires all cards to share the same component structure; a mismatch surfaces as a rejected_reason. MARKETING category only.
+    """
 
 
 class PlatformTarget(BaseModel):
@@ -9533,3 +9531,24 @@ class PostUpdateResponse(BaseModel):
 class PostRetryResponse(BaseModel):
     message: str | None = None
     post: Post3 | None = None
+
+
+class WhatsAppTemplateComponent(
+    RootModel[
+        WhatsAppHeaderComponent
+        | WhatsAppBodyComponent
+        | WhatsAppFooterComponent
+        | WhatsAppButtonsComponent
+        | WhatsAppCarouselComponent
+        | WhatsAppLimitedTimeOfferComponent
+    ]
+):
+    root: Annotated[
+        WhatsAppHeaderComponent
+        | WhatsAppBodyComponent
+        | WhatsAppFooterComponent
+        | WhatsAppButtonsComponent
+        | WhatsAppCarouselComponent
+        | WhatsAppLimitedTimeOfferComponent,
+        Field(discriminator="type"),
+    ]

{late_sdk-1.4.413 → late_sdk-1.4.415}/src/late/resources/_generated/whatsapp.py

@@ -105,6 +105,7 @@ class WhatsappResource:
         category: str,
         language: str,
         *,
+        parameter_format: str | None = None,
         components: list[Any] | None = None,
         library_template_name: str | None = None,
         library_template_body_inputs: dict[str, Any] | None = None,
@@ -116,6 +117,7 @@ class WhatsappResource:
             name=name,
             category=category,
             language=language,
+            parameter_format=parameter_format,
             components=components,
             library_template_name=library_template_name,
             library_template_body_inputs=library_template_body_inputs,
@@ -527,6 +529,7 @@ class WhatsappResource:
         category: str,
         language: str,
         *,
+        parameter_format: str | None = None,
         components: list[Any] | None = None,
         library_template_name: str | None = None,
         library_template_body_inputs: dict[str, Any] | None = None,
@@ -538,6 +541,7 @@ class WhatsappResource:
             name=name,
             category=category,
             language=language,
+            parameter_format=parameter_format,
             components=components,
             library_template_name=library_template_name,
             library_template_body_inputs=library_template_body_inputs,

{late_sdk-1.4.413 → late_sdk-1.4.415}/uv.lock

@@ -2389,7 +2389,7 @@ wheels = [
 
 [[package]]
 name = "zernio-sdk"
-version = "1.4.412"
+version = "1.4.414"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },