@zavudev/sdk 0.56.0 → 0.58.0

package/resources/templates.d.ts

@@ -1,82 +1,69 @@
 import { APIResource } from "../core/resource.js";
 import { APIPromise } from "../core/api-promise.js";
-import { Cursor, type CursorParams, PagePromise } from "../core/pagination.js";
+import { Cursor, PagePromise } from "../core/pagination.js";
 import { RequestOptions } from "../internal/request-options.js";
+import type * as T from "../types.js";
 export declare class Templates extends APIResource {
     /**
+     * Create template
+     *
      * Create a WhatsApp message template. Note: Templates must be approved by Meta
      * before use.
      *
-     * @example
-     * ```ts
-     * const template = await client.templates.create({
-     *   body: 'Hi {{1}}, your order {{2}} has been confirmed and will ship within 24 hours.',
-     *   language: 'en',
-     *   name: 'order_confirmation',
-     *   variables: ['customer_name', 'order_id'],
-     *   whatsappCategory: 'UTILITY',
-     * });
-     * ```
+     * `POST /v1/templates`
      */
     create(body: TemplateCreateParams, options?: RequestOptions): APIPromise<Template>;
     /**
      * Get template
      *
-     * @example
-     * ```ts
-     * const template = await client.templates.retrieve(
-     *   'templateId',
-     * );
-     * ```
+     * `GET /v1/templates/{templateId}`
      */
     retrieve(templateID: string, options?: RequestOptions): APIPromise<Template>;
     /**
+     * List templates
+     *
      * List WhatsApp message templates for this project.
      *
-     * @example
-     * ```ts
-     * // Automatically fetches more pages as needed.
-     * for await (const template of client.templates.list()) {
-     *   // ...
-     * }
-     * ```
+     * `GET /v1/templates`
      */
     list(query?: TemplateListParams | null | undefined, options?: RequestOptions): PagePromise<TemplatesCursor, Template>;
     /**
      * Delete template
      *
-     * @example
-     * ```ts
-     * await client.templates.delete('templateId');
-     * ```
+     * `DELETE /v1/templates/{templateId}`
      */
     delete(templateID: string, options?: RequestOptions): APIPromise<void>;
     /**
+     * Submit template for approval
+     *
      * Submit a WhatsApp template to Meta for approval. The template must be in draft
      * status and associated with a sender that has a WhatsApp Business Account
      * configured.
      *
-     * @example
-     * ```ts
-     * const template = await client.templates.submit(
-     *   'templateId',
-     *   { senderId: 'sender_abc123', category: 'UTILITY' },
-     * );
-     * ```
+     * `POST /v1/templates/{templateId}/submit`
      */
     submit(templateID: string, body: TemplateSubmitParams, options?: RequestOptions): APIPromise<Template>;
     /**
-     * Reconcile this project's templates against WhatsApp. Two things happen per
+     * Sync templates from WhatsApp
+     *
+     * Reconcile this project's templates against WhatsApp. Three things happen per
      * connected WhatsApp Business Account: templates that exist on Meta but not in
-     * Zavu are imported (or linked to an existing template with the same name), and
-     * the approval status of the templates Zavu already knows about is refreshed from
-     * Meta.
+     * Zavu are imported (or linked to an existing template with the same name), the
+     * approval status of the templates Zavu already knows about is refreshed from
+     * Meta, and their **category** is refreshed from Meta.
+     *
+     * The category matters because it is what each message is billed under, and Meta
+     * reassigns it on its own — commonly `UTILITY` to `MARKETING`, on a template
+     * that is already approved and whose status therefore never moves. A template
+     * whose category changed but whose status did not is still counted in `updated`.
+     * This is the way to repair templates whose category drifted before you started
+     * listening for `template.status_changed`.
      *
-     * This is what to call when a template was created outside Zavu — in Meta Business
-     * Manager, or by another tool — or when a `template.status_changed` webhook was
-     * missed and a template is stuck in `pending`. Status changes normally arrive by
-     * webhook; this endpoint is the recovery path and the only path for a template
-     * Zavu never created.
+     * This is what to call when a template was created outside Zavu — in Meta
+     * Business Manager, or by another tool — or when a `template.status_changed`
+     * webhook was missed and a template is stuck in `pending`. Status changes normally
+     * arrive by webhook; this endpoint is the recovery path and the only path for a
+     * template Zavu never created.
      *
      * Templates that Meta reports as rejected or disabled are not imported; they are
      * counted in `skipped`. Existing local templates are matched first by Meta
@@ -84,272 +71,29 @@ export declare class Templates extends APIResource {
      *
      * By default every sender in the project with a WhatsApp Business Account is
      * synced. Pass `senderId` to sync only that sender's account. The call is
-     * synchronous — it waits for Meta and returns what changed — so it can take a few
-     * seconds per account. A failure on one account does not fail the request: it is
-     * reported in `errors` and the remaining accounts are still synced.
+     * synchronous — it waits for Meta and returns what changed — so it can take a
+     * few seconds per account. A failure on one account does not fail the request: it
+     * is reported in `errors` and the remaining accounts are still synced.
      *
-     * @example
-     * ```ts
-     * const response = await client.templates.sync();
-     * ```
+     * `POST /v1/templates/sync`
      */
     sync(body?: TemplateSyncParams | null | undefined, options?: RequestOptions): APIPromise<TemplateSyncResponse>;
 }
-export type TemplatesCursor = Cursor<Template>;
-export interface Template {
-    id: string;
-    /**
-     * Default template body with variables: positional ({{1}}, {{2}}) or named
-     * ({{customer_name}}, {{contact.first_name}}). Templates created in Zavu are
-     * submitted to Meta as positional; templates imported from a WhatsApp Business
-     * Account keep their original format (named or positional). Used when no
-     * channel-specific body is set.
-     */
-    body: string;
-    /**
-     * WhatsApp template category.
-     */
-    category: WhatsappCategory;
-    /**
-     * Language code.
-     */
-    language: string;
-    /**
-     * Template name. For WhatsApp, must match the approved template name in Meta.
-     */
-    name: string;
-    /**
-     * Add 'Do not share this code' disclaimer. Only for AUTHENTICATION templates.
-     */
-    addSecurityRecommendation?: boolean;
-    /**
-     * Template buttons.
-     */
-    buttons?: Array<Template.Button>;
-    /**
-     * Code expiration time in minutes. Only for AUTHENTICATION templates.
-     */
-    codeExpirationMinutes?: number;
-    createdAt?: string;
-    /**
-     * Footer text for the template.
-     */
-    footer?: string;
-    /**
-     * Header content (text or media URL).
-     */
-    headerContent?: string;
-    /**
-     * Type of header (text, image, video, document).
-     */
-    headerType?: string;
-    /**
-     * Channel-specific body for Instagram messages. Falls back to `body` if not set.
-     */
-    instagramBody?: string;
-    /**
-     * Channel-specific body for SMS messages. Falls back to `body` if not set.
-     */
-    smsBody?: string;
-    status?: 'draft' | 'pending' | 'approved' | 'rejected';
-    /**
-     * Channel-specific body for Telegram messages. Falls back to `body` if not set.
-     */
-    telegramBody?: string;
-    updatedAt?: string;
-    /**
-     * List of variable names for documentation.
-     */
-    variables?: Array<string>;
-    /**
-     * WhatsApp-specific template information.
-     */
-    whatsapp?: Template.Whatsapp;
-}
+export type TemplatesCursor = Cursor<T.Template>;
+export type Template = T.Template;
 export declare namespace Template {
-    interface Button {
-        /**
-         * Sample value used to substitute `{{1}}` in the URL when submitting the template
-         * to Meta for review. Only present for dynamic URL buttons.
-         */
-        example?: string;
-        /**
-         * OTP button type. Required when type is 'otp'.
-         */
-        otpType?: 'COPY_CODE' | 'ONE_TAP';
-        /**
-         * Android package name. Required for ONE_TAP buttons.
-         */
-        packageName?: string;
-        phoneNumber?: string;
-        /**
-         * Android app signature hash. Required for ONE_TAP buttons.
-         */
-        signatureHash?: string;
-        text?: string;
-        type?: 'quick_reply' | 'url' | 'phone' | 'otp' | 'request_contact_info';
-        url?: string;
-    }
-    /**
-     * WhatsApp-specific template information.
-     */
-    interface Whatsapp {
-        /**
-         * WhatsApp Business Account namespace.
-         */
-        namespace?: string;
-        /**
-         * WhatsApp approval status.
-         */
-        status?: string;
-        /**
-         * WhatsApp template name.
-         */
-        templateName?: string;
-    }
-}
-/**
- * WhatsApp template category.
- */
-export type WhatsappCategory = 'UTILITY' | 'MARKETING' | 'AUTHENTICATION';
-export interface TemplateSyncResponse {
-    /**
-     * WhatsApp Business Accounts reconciled in this call.
-     */
-    accountsSynced: number;
-    /**
-     * Problems hit while syncing. Non-empty with a 200 means part of the sync did not
-     * complete — the rest still did.
-     */
-    errors: Array<string>;
-    /**
-     * Templates that existed on Meta and were created in Zavu by this call.
-     */
-    imported: number;
-    /**
-     * Existing Zavu templates that were matched to a Meta template by name and bound
-     * to its Meta ID.
-     */
-    linked: number;
-    /**
-     * Meta templates left alone: already linked to a Zavu template, or
-     * rejected/disabled on Meta.
-     */
-    skipped: number;
-    /**
-     * Templates whose approval status changed to match Meta.
-     */
-    updated: number;
-}
-export interface TemplateCreateParams {
-    /**
-     * Default template body. Used when no channel-specific body is set.
-     */
-    body: string;
-    language: string;
-    name: string;
-    /**
-     * Add 'Do not share this code' disclaimer. Only for AUTHENTICATION templates.
-     */
-    addSecurityRecommendation?: boolean;
-    /**
-     * Template buttons (max 3).
-     */
-    buttons?: Array<TemplateCreateParams.Button>;
-    /**
-     * Code expiration time in minutes. Only for AUTHENTICATION templates.
-     */
-    codeExpirationMinutes?: number;
-    /**
-     * Footer text for the template.
-     */
-    footer?: string;
-    /**
-     * Header content (text string or media URL).
-     */
-    headerContent?: string;
-    /**
-     * Type of header for the template.
-     */
-    headerType?: 'text' | 'image' | 'video' | 'document';
-    /**
-     * Channel-specific body for Instagram. Falls back to `body` if not set.
-     */
-    instagramBody?: string;
-    /**
-     * Channel-specific body for SMS. Falls back to `body` if not set.
-     */
-    smsBody?: string;
-    /**
-     * Channel-specific body for Telegram. Falls back to `body` if not set.
-     */
-    telegramBody?: string;
-    variables?: Array<string>;
-    /**
-     * WhatsApp template category.
-     */
-    whatsappCategory?: WhatsappCategory;
+    type Button = T.TemplateButtonsItem;
+    type Whatsapp = T.TemplateWhatsapp;
 }
+export type WhatsappCategory = T.WhatsAppCategory;
+export type TemplateSyncResponse = T.SyncTemplatesResponse;
+export type TemplateCreateParams = T.TemplatesCreateParams;
 export declare namespace TemplateCreateParams {
-    interface Button {
-        /**
-         * `request_contact_info` renders a fixed **Share Contact Info** button that asks
-         * the recipient to share their phone number — useful when a contact adopted a
-         * WhatsApp username and you only know their BSUID. It takes no other fields.
-         */
-        type: 'quick_reply' | 'url' | 'phone' | 'otp' | 'request_contact_info';
-        /**
-         * Sample value Meta uses to review templates with a dynamic URL button.
-         * Substituted into `{{1}}` of the URL when the template is submitted to Meta. Only
-         * meaningful when `url` contains `{{1}}`; ignored for static URLs.
-         */
-        example?: string;
-        /**
-         * Required when type is 'otp'. COPY_CODE shows copy button, ONE_TAP enables
-         * Android autofill.
-         */
-        otpType?: 'COPY_CODE' | 'ONE_TAP';
-        /**
-         * Android package name. Required for ONE_TAP buttons.
-         */
-        packageName?: string;
-        phoneNumber?: string;
-        /**
-         * Android app signature hash. Required for ONE_TAP buttons.
-         */
-        signatureHash?: string;
-        /**
-         * Button label. Required for every type except `request_contact_info`, whose label
-         * is fixed by WhatsApp.
-         */
-        text?: string;
-        /**
-         * Button destination. Use `{{1}}` exactly once for a dynamic URL (e.g.
-         * `https://example.com/orders/{{1}}`); WhatsApp only accepts the strict `{{1}}`
-         * form. Static URLs must not contain any `{{...}}` placeholder.
-         */
-        url?: string;
-    }
-}
-export interface TemplateListParams extends CursorParams {
-}
-export interface TemplateSubmitParams {
-    /**
-     * The sender ID with the WhatsApp Business Account to submit the template to.
-     */
-    senderId: string;
-    /**
-     * Template category. If not provided, uses the category set on the template.
-     */
-    category?: WhatsappCategory;
-}
-export interface TemplateSyncParams {
-    /**
-     * Sync only the WhatsApp Business Account attached to this sender. If omitted,
-     * every WhatsApp sender in the project is synced.
-     */
-    senderId?: string;
+    type Button = T.TemplateCreateRequestButtonsItem;
 }
+export type TemplateListParams = T.TemplatesListParams;
+export type TemplateSubmitParams = T.TemplatesSubmitParams;
+export type TemplateSyncParams = T.TemplatesSyncParams;
 export declare namespace Templates {
     export { type Template as Template, type WhatsappCategory as WhatsappCategory, type TemplateSyncResponse as TemplateSyncResponse, type TemplatesCursor as TemplatesCursor, type TemplateCreateParams as TemplateCreateParams, type TemplateListParams as TemplateListParams, type TemplateSubmitParams as TemplateSubmitParams, type TemplateSyncParams as TemplateSyncParams, };
 }

package/resources/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/resources/templates.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/resources/templates.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,8BAA2B;AAEzD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAE7D,OAAO,KAAK,KAAK,CAAC,oBAAiB;AAEnC,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;IAIlF;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;IAI5E;;;;;;OAMG;IACH,IAAI,CACF,KAAK,GAAE,kBAAkB,GAAG,IAAI,GAAG,SAAc,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,eAAe,EAAE,QAAQ,CAAC;IAIzC;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOtE;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;IAItG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,IAAI,CACF,IAAI,GAAE,kBAAkB,GAAG,IAAI,GAAG,SAAc,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,oBAAoB,CAAC;CAGpC;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEjD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;AAClC,yBAAiB,QAAQ,CAAC;IACxB,KAAY,MAAM,GAAG,CAAC,CAAC,mBAAmB,CAAC;IAC3C,KAAY,QAAQ,GAAG,CAAC,CAAC,gBAAgB,CAAC;CAC3C;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,qBAAqB,CAAC;AAE3D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,qBAAqB,CAAC;AAC3D,yBAAiB,oBAAoB,CAAC;IACpC,KAAY,MAAM,GAAG,CAAC,CAAC,gCAAgC,CAAC;CACzD;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,mBAAmB,CAAC;AAEvD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,qBAAqB,CAAC;AAE3D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,mBAAmB,CAAC;AAEvD,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/templates.js

@@ -1,5 +1,5 @@
 "use strict";
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Templates = void 0;
 const resource_1 = require("../core/resource.js");
@@ -8,19 +8,12 @@ const headers_1 = require("../internal/headers.js");
 const path_1 = require("../internal/utils/path.js");
 class Templates extends resource_1.APIResource {
     /**
+     * Create template
+     *
      * Create a WhatsApp message template. Note: Templates must be approved by Meta
      * before use.
      *
-     * @example
-     * ```ts
-     * const template = await client.templates.create({
-     *   body: 'Hi {{1}}, your order {{2}} has been confirmed and will ship within 24 hours.',
-     *   language: 'en',
-     *   name: 'order_confirmation',
-     *   variables: ['customer_name', 'order_id'],
-     *   whatsappCategory: 'UTILITY',
-     * });
-     * ```
+     * `POST /v1/templates`
      */
     create(body, options) {
         return this._client.post('/v1/templates', { body, ...options });
@@ -28,26 +21,17 @@ class Templates extends resource_1.APIResource {
     /**
      * Get template
      *
-     * @example
-     * ```ts
-     * const template = await client.templates.retrieve(
-     *   'templateId',
-     * );
-     * ```
+     * `GET /v1/templates/{templateId}`
      */
     retrieve(templateID, options) {
         return this._client.get((0, path_1.path) `/v1/templates/${templateID}`, options);
     }
     /**
+     * List templates
+     *
      * List WhatsApp message templates for this project.
      *
-     * @example
-     * ```ts
-     * // Automatically fetches more pages as needed.
-     * for await (const template of client.templates.list()) {
-     *   // ...
-     * }
-     * ```
+     * `GET /v1/templates`
      */
     list(query = {}, options) {
         return this._client.getAPIList('/v1/templates', (pagination_1.Cursor), { query, ...options });
@@ -55,10 +39,7 @@ class Templates extends resource_1.APIResource {
     /**
      * Delete template
      *
-     * @example
-     * ```ts
-     * await client.templates.delete('templateId');
-     * ```
+     * `DELETE /v1/templates/{templateId}`
      */
     delete(templateID, options) {
         return this._client.delete((0, path_1.path) `/v1/templates/${templateID}`, {
@@ -67,33 +48,38 @@ class Templates extends resource_1.APIResource {
         });
     }
     /**
+     * Submit template for approval
+     *
      * Submit a WhatsApp template to Meta for approval. The template must be in draft
      * status and associated with a sender that has a WhatsApp Business Account
      * configured.
      *
-     * @example
-     * ```ts
-     * const template = await client.templates.submit(
-     *   'templateId',
-     *   { senderId: 'sender_abc123', category: 'UTILITY' },
-     * );
-     * ```
+     * `POST /v1/templates/{templateId}/submit`
      */
     submit(templateID, body, options) {
         return this._client.post((0, path_1.path) `/v1/templates/${templateID}/submit`, { body, ...options });
     }
     /**
-     * Reconcile this project's templates against WhatsApp. Two things happen per
+     * Sync templates from WhatsApp
+     *
+     * Reconcile this project's templates against WhatsApp. Three things happen per
      * connected WhatsApp Business Account: templates that exist on Meta but not in
-     * Zavu are imported (or linked to an existing template with the same name), and
-     * the approval status of the templates Zavu already knows about is refreshed from
-     * Meta.
+     * Zavu are imported (or linked to an existing template with the same name), the
+     * approval status of the templates Zavu already knows about is refreshed from
+     * Meta, and their **category** is refreshed from Meta.
+     *
+     * The category matters because it is what each message is billed under, and Meta
+     * reassigns it on its own — commonly `UTILITY` to `MARKETING`, on a template
+     * that is already approved and whose status therefore never moves. A template
+     * whose category changed but whose status did not is still counted in `updated`.
+     * This is the way to repair templates whose category drifted before you started
+     * listening for `template.status_changed`.
      *
-     * This is what to call when a template was created outside Zavu — in Meta Business
-     * Manager, or by another tool — or when a `template.status_changed` webhook was
-     * missed and a template is stuck in `pending`. Status changes normally arrive by
-     * webhook; this endpoint is the recovery path and the only path for a template
-     * Zavu never created.
+     * This is what to call when a template was created outside Zavu — in Meta
+     * Business Manager, or by another tool — or when a `template.status_changed`
+     * webhook was missed and a template is stuck in `pending`. Status changes normally
+     * arrive by webhook; this endpoint is the recovery path and the only path for a
+     * template Zavu never created.
      *
      * Templates that Meta reports as rejected or disabled are not imported; they are
      * counted in `skipped`. Existing local templates are matched first by Meta
@@ -101,14 +87,11 @@ class Templates extends resource_1.APIResource {
      *
      * By default every sender in the project with a WhatsApp Business Account is
      * synced. Pass `senderId` to sync only that sender's account. The call is
-     * synchronous — it waits for Meta and returns what changed — so it can take a few
-     * seconds per account. A failure on one account does not fail the request: it is
-     * reported in `errors` and the remaining accounts are still synced.
+     * synchronous — it waits for Meta and returns what changed — so it can take a
+     * few seconds per account. A failure on one account does not fail the request: it
+     * is reported in `errors` and the remaining accounts are still synced.
      *
-     * @example
-     * ```ts
-     * const response = await client.templates.sync();
-     * ```
+     * `POST /v1/templates/sync`
      */
     sync(body = {}, options) {
         return this._client.post('/v1/templates/sync', { body, ...options });

package/resources/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/resources/templates.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,sDAA4E;AAC5E,oDAAmD;AAEnD,oDAA8C;AAE9C,MAAa,SAAU,SAAQ,sBAAW;IACxC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAA0B,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,UAAkB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,iBAAiB,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAA,mBAAgB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,UAAkB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,iBAAiB,UAAU,EAAE,EAAE;YAC5D,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,UAAkB,EAAE,IAA0B,EAAE,OAAwB;QAC7E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,iBAAiB,UAAU,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,IAAI,CACF,OAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;CACF;AAtHD,8BAsHC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/resources/templates.ts"],"names":[],"mappings":";AAAA,6FAA6F;;;AAE7F,kDAA+C;AAE/C,sDAAyD;AACzD,oDAAmD;AAEnD,oDAA8C;AAG9C,MAAa,SAAU,SAAQ,sBAAW;IACxC;;;;;;;OAOG;IACH,MAAM,CAAC,IAA0B,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,UAAkB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,iBAAiB,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAA,mBAAgB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,UAAkB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,iBAAiB,UAAU,EAAE,EAAE;YAC5D,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAkB,EAAE,IAA0B,EAAE,OAAwB;QAC7E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,iBAAiB,UAAU,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,IAAI,CACF,OAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;CACF;AArGD,8BAqGC"}