@emitia/node 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3587 @@
+import { z } from 'zod';
+
+/** Resolved, validated SDK configuration. All fields are present. */
+interface EmitiaConfig {
+    apiKey: string;
+    baseURL: string;
+    timeout: number;
+    maxRetries: number;
+    /**
+     * Injectable fetch implementation (default: globalThis.fetch).
+     * Used in tests to inject a mock without patching globals.
+     * ADR-2: native fetch only — nothing is loaded at runtime. (The package's
+     * single dependency, zod, exists solely so the published .d.ts can derive
+     * types from its schemas; the compiled .js never imports it.)
+     */
+    fetch?: typeof globalThis.fetch;
+}
+
+/**
+ * AccountInfoSchema — Zod SSOT for GET /v1/account response.
+ *
+ * This schema is the SINGLE source of truth for the account response contract.
+ * The NestJS service imports `AccountInfo` (the inferred type) from here so
+ * the TS type and the OpenAPI schema can never drift from each other.
+ *
+ * Spec: openapi-spec / Response Contract Test (anti-drift).
+ * Design: ADR-1 registry pattern.
+ */
+declare const AccountInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    dian_environment: z.ZodString;
+    key_mode: z.ZodEnum<["test", "live"]>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    dian_environment: string;
+    key_mode: "test" | "live";
+}, {
+    id: string;
+    name: string;
+    dian_environment: string;
+    key_mode: "test" | "live";
+}>;
+
+/**
+ * TriggerEventBodySchema — request body for POST /v1/test/trigger-event.
+ *
+ * Registered as a component so it appears under components.schemas
+ * and the contract test can assert on its properties.
+ */
+declare const TriggerEventBodySchema: z.ZodObject<{
+    type: z.ZodEnum<["invoice.accepted_by_dian", "invoice.rejected_by_dian", "invoice.accepted_contingency", "invoice.failed", "invoice.email.delivered", "invoice.email.bounced", "invoice.email.complained", "credit_note.email.delivered", "credit_note.email.bounced", "credit_note.email.complained", "debit_note.email.delivered", "debit_note.email.bounced", "debit_note.email.complained"]>;
+    object_id: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "invoice.accepted_by_dian" | "invoice.rejected_by_dian" | "invoice.accepted_contingency" | "invoice.failed" | "invoice.email.delivered" | "invoice.email.bounced" | "invoice.email.complained" | "credit_note.email.delivered" | "credit_note.email.bounced" | "credit_note.email.complained" | "debit_note.email.delivered" | "debit_note.email.bounced" | "debit_note.email.complained";
+    object_id?: string | undefined;
+    data?: Record<string, unknown> | undefined;
+}, {
+    type: "invoice.accepted_by_dian" | "invoice.rejected_by_dian" | "invoice.accepted_contingency" | "invoice.failed" | "invoice.email.delivered" | "invoice.email.bounced" | "invoice.email.complained" | "credit_note.email.delivered" | "credit_note.email.bounced" | "credit_note.email.complained" | "debit_note.email.delivered" | "debit_note.email.bounced" | "debit_note.email.complained";
+    object_id?: string | undefined;
+    data?: Record<string, unknown> | undefined;
+}>;
+/**
+ * TriggerEventResponseSchema — 201 response for POST /v1/test/trigger-event.
+ *
+ * `livemode` is always `false` — this endpoint is only callable with sk_test_* keys.
+ */
+declare const TriggerEventResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    livemode: z.ZodLiteral<false>;
+    created: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    id: string;
+    livemode: false;
+    created: string;
+}, {
+    type: string;
+    id: string;
+    livemode: false;
+    created: string;
+}>;
+
+/**
+ * BalanceResponseSchema — SSOT for GET /v1/balance response shape.
+ *
+ * Explicitly EXCLUDES: plan_id, invoices_included, invoices_billable, estimated_cost.
+ * These are deferred to billing-pipeline SDD #9 (D1 gap).
+ */
+declare const BalanceResponseSchema: z.ZodObject<{
+    current_period: z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+        documents_used: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        start: string;
+        end: string;
+        documents_used: number;
+    }, {
+        start: string;
+        end: string;
+        documents_used: number;
+    }>;
+    all_time: z.ZodObject<{
+        documents_processed: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        documents_processed: number;
+    }, {
+        documents_processed: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    current_period: {
+        start: string;
+        end: string;
+        documents_used: number;
+    };
+    all_time: {
+        documents_processed: number;
+    };
+}, {
+    current_period: {
+        start: string;
+        end: string;
+        documents_used: number;
+    };
+    all_time: {
+        documents_processed: number;
+    };
+}>;
+
+declare const CustomerResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"customer">;
+    livemode: z.ZodBoolean;
+    identification: z.ZodObject<{
+        type: z.ZodString;
+        number: z.ZodString;
+        check_digit: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        number: string;
+        type: string;
+        check_digit?: string | undefined;
+    }, {
+        number: string;
+        type: string;
+        check_digit?: string | undefined;
+    }>;
+    legal_name: z.ZodString;
+    trade_name: z.ZodNullable<z.ZodString>;
+    email: z.ZodNullable<z.ZodString>;
+    phone: z.ZodNullable<z.ZodString>;
+    address: z.ZodNullable<z.ZodString>;
+    city_code: z.ZodNullable<z.ZodString>;
+    department_code: z.ZodNullable<z.ZodString>;
+    country_code: z.ZodString;
+    postal_code: z.ZodNullable<z.ZodString>;
+    fiscal_responsibility: z.ZodArray<z.ZodString, "many">;
+    organization_type: z.ZodNullable<z.ZodString>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    deleted: z.ZodBoolean;
+    deleted_at: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    object: "customer";
+    id: string;
+    livemode: boolean;
+    identification: {
+        number: string;
+        type: string;
+        check_digit?: string | undefined;
+    };
+    legal_name: string;
+    trade_name: string | null;
+    email: string | null;
+    phone: string | null;
+    address: string | null;
+    city_code: string | null;
+    department_code: string | null;
+    country_code: string;
+    postal_code: string | null;
+    fiscal_responsibility: string[];
+    organization_type: string | null;
+    metadata: Record<string, unknown>;
+    deleted: boolean;
+    deleted_at: string | null;
+    created_at: string;
+    updated_at: string;
+}, {
+    object: "customer";
+    id: string;
+    livemode: boolean;
+    identification: {
+        number: string;
+        type: string;
+        check_digit?: string | undefined;
+    };
+    legal_name: string;
+    trade_name: string | null;
+    email: string | null;
+    phone: string | null;
+    address: string | null;
+    city_code: string | null;
+    department_code: string | null;
+    country_code: string;
+    postal_code: string | null;
+    fiscal_responsibility: string[];
+    organization_type: string | null;
+    metadata: Record<string, unknown>;
+    deleted: boolean;
+    deleted_at: string | null;
+    created_at: string;
+    updated_at: string;
+}>;
+declare const CreateCustomerRequestSchema: z.ZodObject<{
+    identification: z.ZodObject<{
+        type: z.ZodString;
+        number: z.ZodString;
+        check_digit: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        number: string;
+        type: string;
+        check_digit?: string | undefined;
+    }, {
+        number: string;
+        type: string;
+        check_digit?: string | undefined;
+    }>;
+    legal_name: z.ZodString;
+    trade_name: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    city_code: z.ZodOptional<z.ZodString>;
+    department_code: z.ZodOptional<z.ZodString>;
+    country_code: z.ZodDefault<z.ZodString>;
+    postal_code: z.ZodOptional<z.ZodString>;
+    fiscal_responsibility: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    organization_type: z.ZodOptional<z.ZodEnum<["1", "2"]>>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    identification: {
+        number: string;
+        type: string;
+        check_digit?: string | undefined;
+    };
+    legal_name: string;
+    country_code: string;
+    fiscal_responsibility: string[];
+    metadata: Record<string, unknown>;
+    trade_name?: string | undefined;
+    email?: string | undefined;
+    phone?: string | undefined;
+    address?: string | undefined;
+    city_code?: string | undefined;
+    department_code?: string | undefined;
+    postal_code?: string | undefined;
+    organization_type?: "1" | "2" | undefined;
+}, {
+    identification: {
+        number: string;
+        type: string;
+        check_digit?: string | undefined;
+    };
+    legal_name: string;
+    trade_name?: string | undefined;
+    email?: string | undefined;
+    phone?: string | undefined;
+    address?: string | undefined;
+    city_code?: string | undefined;
+    department_code?: string | undefined;
+    country_code?: string | undefined;
+    postal_code?: string | undefined;
+    fiscal_responsibility?: string[] | undefined;
+    organization_type?: "1" | "2" | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+declare const CustomerListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        object: z.ZodLiteral<"customer">;
+        livemode: z.ZodBoolean;
+        identification: z.ZodObject<{
+            type: z.ZodString;
+            number: z.ZodString;
+            check_digit: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            number: string;
+            type: string;
+            check_digit?: string | undefined;
+        }, {
+            number: string;
+            type: string;
+            check_digit?: string | undefined;
+        }>;
+        legal_name: z.ZodString;
+        trade_name: z.ZodNullable<z.ZodString>;
+        email: z.ZodNullable<z.ZodString>;
+        phone: z.ZodNullable<z.ZodString>;
+        address: z.ZodNullable<z.ZodString>;
+        city_code: z.ZodNullable<z.ZodString>;
+        department_code: z.ZodNullable<z.ZodString>;
+        country_code: z.ZodString;
+        postal_code: z.ZodNullable<z.ZodString>;
+        fiscal_responsibility: z.ZodArray<z.ZodString, "many">;
+        organization_type: z.ZodNullable<z.ZodString>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        deleted: z.ZodBoolean;
+        deleted_at: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        object: "customer";
+        id: string;
+        livemode: boolean;
+        identification: {
+            number: string;
+            type: string;
+            check_digit?: string | undefined;
+        };
+        legal_name: string;
+        trade_name: string | null;
+        email: string | null;
+        phone: string | null;
+        address: string | null;
+        city_code: string | null;
+        department_code: string | null;
+        country_code: string;
+        postal_code: string | null;
+        fiscal_responsibility: string[];
+        organization_type: string | null;
+        metadata: Record<string, unknown>;
+        deleted: boolean;
+        deleted_at: string | null;
+        created_at: string;
+        updated_at: string;
+    }, {
+        object: "customer";
+        id: string;
+        livemode: boolean;
+        identification: {
+            number: string;
+            type: string;
+            check_digit?: string | undefined;
+        };
+        legal_name: string;
+        trade_name: string | null;
+        email: string | null;
+        phone: string | null;
+        address: string | null;
+        city_code: string | null;
+        department_code: string | null;
+        country_code: string;
+        postal_code: string | null;
+        fiscal_responsibility: string[];
+        organization_type: string | null;
+        metadata: Record<string, unknown>;
+        deleted: boolean;
+        deleted_at: string | null;
+        created_at: string;
+        updated_at: string;
+    }>, "many">;
+    has_more: z.ZodBoolean;
+    next_cursor: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        object: "customer";
+        id: string;
+        livemode: boolean;
+        identification: {
+            number: string;
+            type: string;
+            check_digit?: string | undefined;
+        };
+        legal_name: string;
+        trade_name: string | null;
+        email: string | null;
+        phone: string | null;
+        address: string | null;
+        city_code: string | null;
+        department_code: string | null;
+        country_code: string;
+        postal_code: string | null;
+        fiscal_responsibility: string[];
+        organization_type: string | null;
+        metadata: Record<string, unknown>;
+        deleted: boolean;
+        deleted_at: string | null;
+        created_at: string;
+        updated_at: string;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}, {
+    data: {
+        object: "customer";
+        id: string;
+        livemode: boolean;
+        identification: {
+            number: string;
+            type: string;
+            check_digit?: string | undefined;
+        };
+        legal_name: string;
+        trade_name: string | null;
+        email: string | null;
+        phone: string | null;
+        address: string | null;
+        city_code: string | null;
+        department_code: string | null;
+        country_code: string;
+        postal_code: string | null;
+        fiscal_responsibility: string[];
+        organization_type: string | null;
+        metadata: Record<string, unknown>;
+        deleted: boolean;
+        deleted_at: string | null;
+        created_at: string;
+        updated_at: string;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}>;
+
+/**
+ * catalogs.ts — OpenAPI path registrations for the catalogs resource.
+ *
+ * Spec: catalogs-resource/spec.md
+ * Design: STANDARDS §2 molde (read-only, unauthenticated @Public() endpoints).
+ *
+ * Side-effect: registers paths in the global registry when this module is imported.
+ */
+declare const CatalogItemSchema: z.ZodObject<{
+    code: z.ZodString;
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    name: string;
+}, {
+    code: string;
+    name: string;
+}>;
+declare const CatalogListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        name: string;
+    }, {
+        code: string;
+        name: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        code: string;
+        name: string;
+    }[];
+}, {
+    data: {
+        code: string;
+        name: string;
+    }[];
+}>;
+declare const MunicipioItemSchema: z.ZodObject<{
+    code: z.ZodString;
+    name: z.ZodString;
+    department_code: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    name: string;
+    department_code: string;
+}, {
+    code: string;
+    name: string;
+    department_code: string;
+}>;
+declare const MunicipioListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        name: z.ZodString;
+        department_code: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        name: string;
+        department_code: string;
+    }, {
+        code: string;
+        name: string;
+        department_code: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        code: string;
+        name: string;
+        department_code: string;
+    }[];
+}, {
+    data: {
+        code: string;
+        name: string;
+        department_code: string;
+    }[];
+}>;
+
+/**
+ * numbering-resolutions.ts — OpenAPI path registrations for the numbering-resolutions resource.
+ *
+ * Spec: numbering-resolutions-resource/spec.md
+ * Design: ADR-3 (ClTec write-only; never in response).
+ *
+ * Trust boundary:
+ *   - technical_key is present in POST request body (write-only).
+ *   - NumberingResolutionResponse DOES NOT include technical_key or technical_key_ciphertext.
+ *
+ * Side-effect: registers paths in the global registry when this module is imported.
+ */
+declare const NumberingResolutionResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"numbering_resolution">;
+    livemode: z.ZodBoolean;
+    resolution_number: z.ZodString;
+    prefix: z.ZodString;
+    document_type: z.ZodString;
+    range_from: z.ZodNumber;
+    range_to: z.ZodNumber;
+    valid_from: z.ZodString;
+    valid_to: z.ZodString;
+    environment: z.ZodString;
+    is_active: z.ZodBoolean;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    object: "numbering_resolution";
+    id: string;
+    livemode: boolean;
+    created_at: string;
+    updated_at: string;
+    resolution_number: string;
+    prefix: string;
+    document_type: string;
+    range_from: number;
+    range_to: number;
+    valid_from: string;
+    valid_to: string;
+    environment: string;
+    is_active: boolean;
+}, {
+    object: "numbering_resolution";
+    id: string;
+    livemode: boolean;
+    created_at: string;
+    updated_at: string;
+    resolution_number: string;
+    prefix: string;
+    document_type: string;
+    range_from: number;
+    range_to: number;
+    valid_from: string;
+    valid_to: string;
+    environment: string;
+    is_active: boolean;
+}>;
+declare const CreateNumberingResolutionRequestSchema: z.ZodObject<{
+    resolution_number: z.ZodString;
+    prefix: z.ZodDefault<z.ZodString>;
+    document_type: z.ZodEnum<["01", "91", "92"]>;
+    technical_key: z.ZodString;
+    range_from: z.ZodNumber;
+    range_to: z.ZodNumber;
+    valid_from: z.ZodString;
+    valid_to: z.ZodString;
+    environment: z.ZodEnum<["production", "habilitacion"]>;
+}, "strip", z.ZodTypeAny, {
+    resolution_number: string;
+    prefix: string;
+    document_type: "01" | "91" | "92";
+    range_from: number;
+    range_to: number;
+    valid_from: string;
+    valid_to: string;
+    environment: "habilitacion" | "production";
+    technical_key: string;
+}, {
+    resolution_number: string;
+    document_type: "01" | "91" | "92";
+    range_from: number;
+    range_to: number;
+    valid_from: string;
+    valid_to: string;
+    environment: "habilitacion" | "production";
+    technical_key: string;
+    prefix?: string | undefined;
+}>;
+declare const NumberingResolutionListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        object: z.ZodLiteral<"numbering_resolution">;
+        livemode: z.ZodBoolean;
+        resolution_number: z.ZodString;
+        prefix: z.ZodString;
+        document_type: z.ZodString;
+        range_from: z.ZodNumber;
+        range_to: z.ZodNumber;
+        valid_from: z.ZodString;
+        valid_to: z.ZodString;
+        environment: z.ZodString;
+        is_active: z.ZodBoolean;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        object: "numbering_resolution";
+        id: string;
+        livemode: boolean;
+        created_at: string;
+        updated_at: string;
+        resolution_number: string;
+        prefix: string;
+        document_type: string;
+        range_from: number;
+        range_to: number;
+        valid_from: string;
+        valid_to: string;
+        environment: string;
+        is_active: boolean;
+    }, {
+        object: "numbering_resolution";
+        id: string;
+        livemode: boolean;
+        created_at: string;
+        updated_at: string;
+        resolution_number: string;
+        prefix: string;
+        document_type: string;
+        range_from: number;
+        range_to: number;
+        valid_from: string;
+        valid_to: string;
+        environment: string;
+        is_active: boolean;
+    }>, "many">;
+    has_more: z.ZodBoolean;
+    next_cursor: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        object: "numbering_resolution";
+        id: string;
+        livemode: boolean;
+        created_at: string;
+        updated_at: string;
+        resolution_number: string;
+        prefix: string;
+        document_type: string;
+        range_from: number;
+        range_to: number;
+        valid_from: string;
+        valid_to: string;
+        environment: string;
+        is_active: boolean;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}, {
+    data: {
+        object: "numbering_resolution";
+        id: string;
+        livemode: boolean;
+        created_at: string;
+        updated_at: string;
+        resolution_number: string;
+        prefix: string;
+        document_type: string;
+        range_from: number;
+        range_to: number;
+        valid_from: string;
+        valid_to: string;
+        environment: string;
+        is_active: boolean;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}>;
+
+/**
+ * certificates.ts — OpenAPI path registrations for the certificates resource.
+ *
+ * Spec: certificates-resource/spec.md
+ * Design: ADR-4 (base64 JSON body; parse-before-encrypt; zeroize; redact).
+ *
+ * Trust boundary:
+ *   - content_base64 and password are WRITE-ONLY (present in POST request body).
+ *   - CertificateResponse does NOT include content_base64, password, r2_key,
+ *     vault_transit_key, p12_passphrase_ciphertext, or software_pin_ciphertext.
+ *
+ * Side-effect: registers paths in the global registry when this module is imported.
+ *
+ * Endpoints registered (PR3a + PR3b):
+ *   POST   /v1/certificates         — upload
+ *   GET    /v1/certificates         — list (paginated, excludes deleted)
+ *   GET    /v1/certificates/{id}    — get by id
+ *   POST   /v1/certificates/{id}/activate — activate (200, last-activation-wins)
+ *   DELETE /v1/certificates/{id}    — soft-delete (200, inactive only)
+ */
+declare const CertificateResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"certificate">;
+    livemode: z.ZodBoolean;
+    filename: z.ZodString;
+    subject_dn: z.ZodString;
+    issuer_dn: z.ZodString;
+    serial_number: z.ZodString;
+    fingerprint_sha256: z.ZodString;
+    valid_from: z.ZodString;
+    valid_until: z.ZodString;
+    is_active: z.ZodBoolean;
+    deleted: z.ZodBoolean;
+    deleted_at: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    object: "certificate";
+    id: string;
+    livemode: boolean;
+    deleted: boolean;
+    deleted_at: string | null;
+    created_at: string;
+    updated_at: string;
+    valid_from: string;
+    is_active: boolean;
+    filename: string;
+    subject_dn: string;
+    issuer_dn: string;
+    serial_number: string;
+    fingerprint_sha256: string;
+    valid_until: string;
+}, {
+    object: "certificate";
+    id: string;
+    livemode: boolean;
+    deleted: boolean;
+    deleted_at: string | null;
+    created_at: string;
+    updated_at: string;
+    valid_from: string;
+    is_active: boolean;
+    filename: string;
+    subject_dn: string;
+    issuer_dn: string;
+    serial_number: string;
+    fingerprint_sha256: string;
+    valid_until: string;
+}>;
+declare const CreateCertificateRequestSchema: z.ZodObject<{
+    filename: z.ZodString;
+    content_base64: z.ZodString;
+    password: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    password: string;
+    filename: string;
+    content_base64: string;
+}, {
+    password: string;
+    filename: string;
+    content_base64: string;
+}>;
+declare const CertificateListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        object: z.ZodLiteral<"certificate">;
+        livemode: z.ZodBoolean;
+        filename: z.ZodString;
+        subject_dn: z.ZodString;
+        issuer_dn: z.ZodString;
+        serial_number: z.ZodString;
+        fingerprint_sha256: z.ZodString;
+        valid_from: z.ZodString;
+        valid_until: z.ZodString;
+        is_active: z.ZodBoolean;
+        deleted: z.ZodBoolean;
+        deleted_at: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        object: "certificate";
+        id: string;
+        livemode: boolean;
+        deleted: boolean;
+        deleted_at: string | null;
+        created_at: string;
+        updated_at: string;
+        valid_from: string;
+        is_active: boolean;
+        filename: string;
+        subject_dn: string;
+        issuer_dn: string;
+        serial_number: string;
+        fingerprint_sha256: string;
+        valid_until: string;
+    }, {
+        object: "certificate";
+        id: string;
+        livemode: boolean;
+        deleted: boolean;
+        deleted_at: string | null;
+        created_at: string;
+        updated_at: string;
+        valid_from: string;
+        is_active: boolean;
+        filename: string;
+        subject_dn: string;
+        issuer_dn: string;
+        serial_number: string;
+        fingerprint_sha256: string;
+        valid_until: string;
+    }>, "many">;
+    has_more: z.ZodBoolean;
+    next_cursor: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        object: "certificate";
+        id: string;
+        livemode: boolean;
+        deleted: boolean;
+        deleted_at: string | null;
+        created_at: string;
+        updated_at: string;
+        valid_from: string;
+        is_active: boolean;
+        filename: string;
+        subject_dn: string;
+        issuer_dn: string;
+        serial_number: string;
+        fingerprint_sha256: string;
+        valid_until: string;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}, {
+    data: {
+        object: "certificate";
+        id: string;
+        livemode: boolean;
+        deleted: boolean;
+        deleted_at: string | null;
+        created_at: string;
+        updated_at: string;
+        valid_from: string;
+        is_active: boolean;
+        filename: string;
+        subject_dn: string;
+        issuer_dn: string;
+        serial_number: string;
+        fingerprint_sha256: string;
+        valid_until: string;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}>;
+
+declare const CreateCreditNoteRequestSchema: z.ZodObject<{
+    reference_invoice_id: z.ZodString;
+    customer_id: z.ZodString;
+    prefix: z.ZodDefault<z.ZodString>;
+    discrepancy_response_code: z.ZodEnum<["1", "2", "3", "4", "5"]>;
+    discrepancy_description: z.ZodOptional<z.ZodString>;
+    currency: z.ZodDefault<z.ZodEnum<["COP"]>>;
+    notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    lines: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        sku: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodString;
+        unit_code: z.ZodDefault<z.ZodString>;
+        unit_price: z.ZodString;
+        line_extension_amount: z.ZodString;
+        taxes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            rate: z.ZodString;
+            base: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }, {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        quantity: string;
+        unit_code: string;
+        unit_price: string;
+        line_extension_amount: string;
+        taxes: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[];
+        sku?: string | undefined;
+    }, {
+        description: string;
+        quantity: string;
+        unit_price: string;
+        line_extension_amount: string;
+        sku?: string | undefined;
+        unit_code?: string | undefined;
+        taxes?: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[] | undefined;
+    }>, "many">;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    prefix: string;
+    customer_id: string;
+    currency: "COP";
+    lines: {
+        description: string;
+        quantity: string;
+        unit_code: string;
+        unit_price: string;
+        line_extension_amount: string;
+        taxes: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[];
+        sku?: string | undefined;
+    }[];
+    reference_invoice_id: string;
+    discrepancy_response_code: "1" | "2" | "3" | "4" | "5";
+    metadata?: Record<string, unknown> | undefined;
+    notes?: string[] | undefined;
+    discrepancy_description?: string | undefined;
+}, {
+    customer_id: string;
+    lines: {
+        description: string;
+        quantity: string;
+        unit_price: string;
+        line_extension_amount: string;
+        sku?: string | undefined;
+        unit_code?: string | undefined;
+        taxes?: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[] | undefined;
+    }[];
+    reference_invoice_id: string;
+    discrepancy_response_code: "1" | "2" | "3" | "4" | "5";
+    metadata?: Record<string, unknown> | undefined;
+    prefix?: string | undefined;
+    currency?: "COP" | undefined;
+    notes?: string[] | undefined;
+    discrepancy_description?: string | undefined;
+}>;
+declare const CreditNoteResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"credit_note">;
+    livemode: z.ZodBoolean;
+    status: z.ZodEnum<["draft", "processing", "signed", "accepted_by_dian", "rejected_by_dian", "accepted_contingency", "failed"]>;
+    full_number: z.ZodString;
+    cude: z.ZodNullable<z.ZodString>;
+    reference_invoice_id: z.ZodString;
+    customer_id: z.ZodString;
+    prefix: z.ZodString;
+    numbering_resolution_id: z.ZodString;
+    discrepancy_response_code: z.ZodString;
+    discrepancy_description: z.ZodNullable<z.ZodString>;
+    issue_date: z.ZodString;
+    currency_code: z.ZodString;
+    environment: z.ZodString;
+    payable_amount: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    object: "credit_note";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+    reference_invoice_id: string;
+    discrepancy_response_code: string;
+    discrepancy_description: string | null;
+    cude: string | null;
+}, {
+    object: "credit_note";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+    reference_invoice_id: string;
+    discrepancy_response_code: string;
+    discrepancy_description: string | null;
+    cude: string | null;
+}>;
+declare const CreditNoteDetailResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"credit_note">;
+    livemode: z.ZodBoolean;
+    status: z.ZodEnum<["draft", "processing", "signed", "accepted_by_dian", "rejected_by_dian", "accepted_contingency", "failed"]>;
+    full_number: z.ZodString;
+    cude: z.ZodNullable<z.ZodString>;
+    reference_invoice_id: z.ZodString;
+    customer_id: z.ZodString;
+    prefix: z.ZodString;
+    numbering_resolution_id: z.ZodString;
+    discrepancy_response_code: z.ZodString;
+    discrepancy_description: z.ZodNullable<z.ZodString>;
+    issue_date: z.ZodString;
+    currency_code: z.ZodString;
+    environment: z.ZodString;
+    payable_amount: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+} & {
+    dian_response: z.ZodNullable<z.ZodObject<{
+        track_id: z.ZodNullable<z.ZodString>;
+        status_code: z.ZodNullable<z.ZodString>;
+        status_description: z.ZodNullable<z.ZodString>;
+        is_valid: z.ZodBoolean;
+        validated_at: z.ZodNullable<z.ZodString>;
+        errors: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            message: string;
+        }, {
+            code: string;
+            message: string;
+        }>, "many">;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            message: string;
+        }, {
+            code: string;
+            message: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    }, {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    }>>;
+    has_xml: z.ZodBoolean;
+    has_pdf: z.ZodBoolean;
+    qr_url: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    object: "credit_note";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+    dian_response: {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    } | null;
+    has_xml: boolean;
+    has_pdf: boolean;
+    qr_url: string | null;
+    reference_invoice_id: string;
+    discrepancy_response_code: string;
+    discrepancy_description: string | null;
+    cude: string | null;
+}, {
+    object: "credit_note";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+    dian_response: {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    } | null;
+    has_xml: boolean;
+    has_pdf: boolean;
+    qr_url: string | null;
+    reference_invoice_id: string;
+    discrepancy_response_code: string;
+    discrepancy_description: string | null;
+    cude: string | null;
+}>;
+declare const CreditNoteListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        object: z.ZodLiteral<"credit_note">;
+        livemode: z.ZodBoolean;
+        status: z.ZodEnum<["draft", "processing", "signed", "accepted_by_dian", "rejected_by_dian", "accepted_contingency", "failed"]>;
+        full_number: z.ZodString;
+        cude: z.ZodNullable<z.ZodString>;
+        reference_invoice_id: z.ZodString;
+        customer_id: z.ZodString;
+        prefix: z.ZodString;
+        numbering_resolution_id: z.ZodString;
+        discrepancy_response_code: z.ZodString;
+        discrepancy_description: z.ZodNullable<z.ZodString>;
+        issue_date: z.ZodString;
+        currency_code: z.ZodString;
+        environment: z.ZodString;
+        payable_amount: z.ZodString;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    } & {
+        dian_response: z.ZodNullable<z.ZodObject<{
+            track_id: z.ZodNullable<z.ZodString>;
+            status_code: z.ZodNullable<z.ZodString>;
+            status_description: z.ZodNullable<z.ZodString>;
+            is_valid: z.ZodBoolean;
+            validated_at: z.ZodNullable<z.ZodString>;
+            errors: z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                message: string;
+            }, {
+                code: string;
+                message: string;
+            }>, "many">;
+            warnings: z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                message: string;
+            }, {
+                code: string;
+                message: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        }, {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        }>>;
+        has_xml: z.ZodBoolean;
+        has_pdf: z.ZodBoolean;
+        qr_url: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        object: "credit_note";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+        reference_invoice_id: string;
+        discrepancy_response_code: string;
+        discrepancy_description: string | null;
+        cude: string | null;
+    }, {
+        object: "credit_note";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+        reference_invoice_id: string;
+        discrepancy_response_code: string;
+        discrepancy_description: string | null;
+        cude: string | null;
+    }>, "many">;
+    has_more: z.ZodBoolean;
+    next_cursor: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        object: "credit_note";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+        reference_invoice_id: string;
+        discrepancy_response_code: string;
+        discrepancy_description: string | null;
+        cude: string | null;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}, {
+    data: {
+        object: "credit_note";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+        reference_invoice_id: string;
+        discrepancy_response_code: string;
+        discrepancy_description: string | null;
+        cude: string | null;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}>;
+
+declare const CreateDebitNoteRequestSchema: z.ZodObject<{
+    reference_invoice_id: z.ZodString;
+    customer_id: z.ZodString;
+    prefix: z.ZodDefault<z.ZodString>;
+    discrepancy_response_code: z.ZodEnum<["1", "2", "3", "4"]>;
+    discrepancy_description: z.ZodOptional<z.ZodString>;
+    currency: z.ZodDefault<z.ZodEnum<["COP"]>>;
+    notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    lines: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        sku: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodString;
+        unit_code: z.ZodDefault<z.ZodString>;
+        unit_price: z.ZodString;
+        line_extension_amount: z.ZodString;
+        taxes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            rate: z.ZodString;
+            base: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }, {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        quantity: string;
+        unit_code: string;
+        unit_price: string;
+        line_extension_amount: string;
+        taxes: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[];
+        sku?: string | undefined;
+    }, {
+        description: string;
+        quantity: string;
+        unit_price: string;
+        line_extension_amount: string;
+        sku?: string | undefined;
+        unit_code?: string | undefined;
+        taxes?: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[] | undefined;
+    }>, "many">;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    prefix: string;
+    customer_id: string;
+    currency: "COP";
+    lines: {
+        description: string;
+        quantity: string;
+        unit_code: string;
+        unit_price: string;
+        line_extension_amount: string;
+        taxes: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[];
+        sku?: string | undefined;
+    }[];
+    reference_invoice_id: string;
+    discrepancy_response_code: "1" | "2" | "3" | "4";
+    metadata?: Record<string, unknown> | undefined;
+    notes?: string[] | undefined;
+    discrepancy_description?: string | undefined;
+}, {
+    customer_id: string;
+    lines: {
+        description: string;
+        quantity: string;
+        unit_price: string;
+        line_extension_amount: string;
+        sku?: string | undefined;
+        unit_code?: string | undefined;
+        taxes?: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[] | undefined;
+    }[];
+    reference_invoice_id: string;
+    discrepancy_response_code: "1" | "2" | "3" | "4";
+    metadata?: Record<string, unknown> | undefined;
+    prefix?: string | undefined;
+    currency?: "COP" | undefined;
+    notes?: string[] | undefined;
+    discrepancy_description?: string | undefined;
+}>;
+declare const DebitNoteResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"debit_note">;
+    livemode: z.ZodBoolean;
+    status: z.ZodEnum<["draft", "processing", "signed", "accepted_by_dian", "rejected_by_dian", "accepted_contingency", "failed"]>;
+    full_number: z.ZodString;
+    cude: z.ZodNullable<z.ZodString>;
+    reference_invoice_id: z.ZodString;
+    customer_id: z.ZodString;
+    prefix: z.ZodString;
+    numbering_resolution_id: z.ZodString;
+    discrepancy_response_code: z.ZodString;
+    discrepancy_description: z.ZodNullable<z.ZodString>;
+    issue_date: z.ZodString;
+    currency_code: z.ZodString;
+    environment: z.ZodString;
+    payable_amount: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    object: "debit_note";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+    reference_invoice_id: string;
+    discrepancy_response_code: string;
+    discrepancy_description: string | null;
+    cude: string | null;
+}, {
+    object: "debit_note";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+    reference_invoice_id: string;
+    discrepancy_response_code: string;
+    discrepancy_description: string | null;
+    cude: string | null;
+}>;
+declare const DebitNoteDetailResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"debit_note">;
+    livemode: z.ZodBoolean;
+    status: z.ZodEnum<["draft", "processing", "signed", "accepted_by_dian", "rejected_by_dian", "accepted_contingency", "failed"]>;
+    full_number: z.ZodString;
+    cude: z.ZodNullable<z.ZodString>;
+    reference_invoice_id: z.ZodString;
+    customer_id: z.ZodString;
+    prefix: z.ZodString;
+    numbering_resolution_id: z.ZodString;
+    discrepancy_response_code: z.ZodString;
+    discrepancy_description: z.ZodNullable<z.ZodString>;
+    issue_date: z.ZodString;
+    currency_code: z.ZodString;
+    environment: z.ZodString;
+    payable_amount: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+} & {
+    dian_response: z.ZodNullable<z.ZodObject<{
+        track_id: z.ZodNullable<z.ZodString>;
+        status_code: z.ZodNullable<z.ZodString>;
+        status_description: z.ZodNullable<z.ZodString>;
+        is_valid: z.ZodBoolean;
+        validated_at: z.ZodNullable<z.ZodString>;
+        errors: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            message: string;
+        }, {
+            code: string;
+            message: string;
+        }>, "many">;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            message: string;
+        }, {
+            code: string;
+            message: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    }, {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    }>>;
+    has_xml: z.ZodBoolean;
+    has_pdf: z.ZodBoolean;
+    qr_url: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    object: "debit_note";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+    dian_response: {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    } | null;
+    has_xml: boolean;
+    has_pdf: boolean;
+    qr_url: string | null;
+    reference_invoice_id: string;
+    discrepancy_response_code: string;
+    discrepancy_description: string | null;
+    cude: string | null;
+}, {
+    object: "debit_note";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+    dian_response: {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    } | null;
+    has_xml: boolean;
+    has_pdf: boolean;
+    qr_url: string | null;
+    reference_invoice_id: string;
+    discrepancy_response_code: string;
+    discrepancy_description: string | null;
+    cude: string | null;
+}>;
+declare const DebitNoteListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        object: z.ZodLiteral<"debit_note">;
+        livemode: z.ZodBoolean;
+        status: z.ZodEnum<["draft", "processing", "signed", "accepted_by_dian", "rejected_by_dian", "accepted_contingency", "failed"]>;
+        full_number: z.ZodString;
+        cude: z.ZodNullable<z.ZodString>;
+        reference_invoice_id: z.ZodString;
+        customer_id: z.ZodString;
+        prefix: z.ZodString;
+        numbering_resolution_id: z.ZodString;
+        discrepancy_response_code: z.ZodString;
+        discrepancy_description: z.ZodNullable<z.ZodString>;
+        issue_date: z.ZodString;
+        currency_code: z.ZodString;
+        environment: z.ZodString;
+        payable_amount: z.ZodString;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    } & {
+        dian_response: z.ZodNullable<z.ZodObject<{
+            track_id: z.ZodNullable<z.ZodString>;
+            status_code: z.ZodNullable<z.ZodString>;
+            status_description: z.ZodNullable<z.ZodString>;
+            is_valid: z.ZodBoolean;
+            validated_at: z.ZodNullable<z.ZodString>;
+            errors: z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                message: string;
+            }, {
+                code: string;
+                message: string;
+            }>, "many">;
+            warnings: z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                message: string;
+            }, {
+                code: string;
+                message: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        }, {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        }>>;
+        has_xml: z.ZodBoolean;
+        has_pdf: z.ZodBoolean;
+        qr_url: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        object: "debit_note";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+        reference_invoice_id: string;
+        discrepancy_response_code: string;
+        discrepancy_description: string | null;
+        cude: string | null;
+    }, {
+        object: "debit_note";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+        reference_invoice_id: string;
+        discrepancy_response_code: string;
+        discrepancy_description: string | null;
+        cude: string | null;
+    }>, "many">;
+    has_more: z.ZodBoolean;
+    next_cursor: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        object: "debit_note";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+        reference_invoice_id: string;
+        discrepancy_response_code: string;
+        discrepancy_description: string | null;
+        cude: string | null;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}, {
+    data: {
+        object: "debit_note";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+        reference_invoice_id: string;
+        discrepancy_response_code: string;
+        discrepancy_description: string | null;
+        cude: string | null;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}>;
+
+/**
+ * invoices.ts — OpenAPI path registrations for the invoices resource (PR4a + PR4b + PR4 emails).
+ *
+ * Spec: invoices-resource/spec.md, email-delivery PR4.
+ * Design: ADR-1 (create-draft-and-enqueue; API NEVER numbers), ADR-5 (paginate).
+ *
+ * CRITICAL response contract:
+ *   - POST /v1/invoices returns 202 (accepted for async processing).
+ *   - Response includes status:'draft', full_number:'', cufe:null.
+ *   - The API NEVER assigns consecutive or full_number — the worker does.
+ *   - docs/API.md §6.2 example is being corrected in T-24/PR6 (shows status:'draft').
+ *
+ * Endpoints registered:
+ *   POST /v1/invoices             — create draft + enqueue dian-submit (PR4a)
+ *   GET  /v1/invoices             — list (paginated, filterable) — items are SUMMARY (no lines) (PR4b)
+ *   GET  /v1/invoices/{id}        — get by id — DETAIL (includes all line items) (PR4b)
+ *   GET  /v1/invoices/{id}/emails — list email deliveries (PR4 trazabilidad)
+ */
+declare const InvoiceResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"invoice">;
+    livemode: z.ZodBoolean;
+    /**
+     * status: 'draft' on 202 response (the worker transitions to 'processing' after
+     * reserveNumber completes, and eventually to 'accepted_by_dian' or 'rejected_by_dian').
+     *
+     * Estados:
+     *   draft           — creado, encolado pendiente de procesamiento
+     *   processing      — worker asignó número, firmando
+     *   signed          — firmado, enviando a DIAN
+     *   accepted_by_dian — DIAN aceptó
+     *   rejected_by_dian — DIAN rechazó
+     *   accepted_contingency — Tipo 04 emitido
+     *   failed          — error interno
+     */
+    status: z.ZodEnum<["draft", "processing", "signed", "accepted_by_dian", "rejected_by_dian", "accepted_contingency", "failed"]>;
+    /**
+     * full_number: '' in the 202 draft response. Filled by worker after reserveNumber.
+     * Format: '{prefix}{consecutive}', e.g. 'FE0042'.
+     */
+    full_number: z.ZodString;
+    /**
+     * cufe: null in the 202 draft response. Filled by worker after signing.
+     */
+    cufe: z.ZodNullable<z.ZodString>;
+    customer_id: z.ZodString;
+    prefix: z.ZodString;
+    numbering_resolution_id: z.ZodString;
+    issue_date: z.ZodString;
+    currency_code: z.ZodString;
+    environment: z.ZodString;
+    payable_amount: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    object: "invoice";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    cufe: string | null;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+}, {
+    object: "invoice";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    cufe: string | null;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+}>;
+declare const CreateInvoiceRequestSchema: z.ZodObject<{
+    customer_id: z.ZodString;
+    prefix: z.ZodDefault<z.ZodString>;
+    issue_date: z.ZodOptional<z.ZodString>;
+    due_date: z.ZodOptional<z.ZodString>;
+    payment_means: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        type: z.ZodEnum<["1", "2"]>;
+        due_date: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "1" | "2";
+        code: string;
+        due_date?: string | undefined;
+    }, {
+        type: "1" | "2";
+        code: string;
+        due_date?: string | undefined;
+    }>>;
+    currency: z.ZodDefault<z.ZodEnum<["COP"]>>;
+    operation_type: z.ZodDefault<z.ZodString>;
+    lines: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        sku: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodString;
+        unit_code: z.ZodDefault<z.ZodString>;
+        unit_price: z.ZodString;
+        line_extension_amount: z.ZodString;
+        taxes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            rate: z.ZodString;
+            base: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }, {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        quantity: string;
+        unit_code: string;
+        unit_price: string;
+        line_extension_amount: string;
+        taxes: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[];
+        sku?: string | undefined;
+    }, {
+        description: string;
+        quantity: string;
+        unit_price: string;
+        line_extension_amount: string;
+        sku?: string | undefined;
+        unit_code?: string | undefined;
+        taxes?: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[] | undefined;
+    }>, "many">;
+    notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    prefix: string;
+    customer_id: string;
+    currency: "COP";
+    operation_type: string;
+    lines: {
+        description: string;
+        quantity: string;
+        unit_code: string;
+        unit_price: string;
+        line_extension_amount: string;
+        taxes: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[];
+        sku?: string | undefined;
+    }[];
+    metadata?: Record<string, unknown> | undefined;
+    issue_date?: string | undefined;
+    due_date?: string | undefined;
+    payment_means?: {
+        type: "1" | "2";
+        code: string;
+        due_date?: string | undefined;
+    } | undefined;
+    notes?: string[] | undefined;
+}, {
+    customer_id: string;
+    lines: {
+        description: string;
+        quantity: string;
+        unit_price: string;
+        line_extension_amount: string;
+        sku?: string | undefined;
+        unit_code?: string | undefined;
+        taxes?: {
+            code: string;
+            value: string;
+            rate: string;
+            base: string;
+        }[] | undefined;
+    }[];
+    metadata?: Record<string, unknown> | undefined;
+    prefix?: string | undefined;
+    issue_date?: string | undefined;
+    due_date?: string | undefined;
+    payment_means?: {
+        type: "1" | "2";
+        code: string;
+        due_date?: string | undefined;
+    } | undefined;
+    currency?: "COP" | undefined;
+    operation_type?: string | undefined;
+    notes?: string[] | undefined;
+}>;
+declare const InvoiceDetailResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"invoice">;
+    livemode: z.ZodBoolean;
+    /**
+     * status: 'draft' on 202 response (the worker transitions to 'processing' after
+     * reserveNumber completes, and eventually to 'accepted_by_dian' or 'rejected_by_dian').
+     *
+     * Estados:
+     *   draft           — creado, encolado pendiente de procesamiento
+     *   processing      — worker asignó número, firmando
+     *   signed          — firmado, enviando a DIAN
+     *   accepted_by_dian — DIAN aceptó
+     *   rejected_by_dian — DIAN rechazó
+     *   accepted_contingency — Tipo 04 emitido
+     *   failed          — error interno
+     */
+    status: z.ZodEnum<["draft", "processing", "signed", "accepted_by_dian", "rejected_by_dian", "accepted_contingency", "failed"]>;
+    /**
+     * full_number: '' in the 202 draft response. Filled by worker after reserveNumber.
+     * Format: '{prefix}{consecutive}', e.g. 'FE0042'.
+     */
+    full_number: z.ZodString;
+    /**
+     * cufe: null in the 202 draft response. Filled by worker after signing.
+     */
+    cufe: z.ZodNullable<z.ZodString>;
+    customer_id: z.ZodString;
+    prefix: z.ZodString;
+    numbering_resolution_id: z.ZodString;
+    issue_date: z.ZodString;
+    currency_code: z.ZodString;
+    environment: z.ZodString;
+    payable_amount: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+} & {
+    dian_response: z.ZodNullable<z.ZodObject<{
+        track_id: z.ZodNullable<z.ZodString>;
+        status_code: z.ZodNullable<z.ZodString>;
+        status_description: z.ZodNullable<z.ZodString>;
+        is_valid: z.ZodBoolean;
+        validated_at: z.ZodNullable<z.ZodString>;
+        errors: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            message: string;
+        }, {
+            code: string;
+            message: string;
+        }>, "many">;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            message: string;
+        }, {
+            code: string;
+            message: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    }, {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    }>>;
+    has_xml: z.ZodBoolean;
+    has_pdf: z.ZodBoolean;
+    qr_url: z.ZodNullable<z.ZodString>;
+} & {
+    lines: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        line_number: z.ZodNumber;
+        description: z.ZodString;
+        sku: z.ZodNullable<z.ZodString>;
+        standard_item_id: z.ZodNullable<z.ZodString>;
+        standard_item_schema: z.ZodNullable<z.ZodString>;
+        quantity: z.ZodString;
+        unit_code: z.ZodString;
+        unit_price: z.ZodString;
+        line_extension_amount: z.ZodString;
+        allowance_amount: z.ZodString;
+        charge_amount: z.ZodString;
+        iva_rate: z.ZodString;
+        iva_base: z.ZodString;
+        iva_amount: z.ZodString;
+        inc_rate: z.ZodString;
+        inc_amount: z.ZodString;
+        ica_rate: z.ZodString;
+        ica_amount: z.ZodString;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        id: string;
+        metadata: Record<string, unknown>;
+        sku: string | null;
+        quantity: string;
+        unit_code: string;
+        unit_price: string;
+        line_extension_amount: string;
+        line_number: number;
+        standard_item_id: string | null;
+        standard_item_schema: string | null;
+        allowance_amount: string;
+        charge_amount: string;
+        iva_rate: string;
+        iva_base: string;
+        iva_amount: string;
+        inc_rate: string;
+        inc_amount: string;
+        ica_rate: string;
+        ica_amount: string;
+    }, {
+        description: string;
+        id: string;
+        metadata: Record<string, unknown>;
+        sku: string | null;
+        quantity: string;
+        unit_code: string;
+        unit_price: string;
+        line_extension_amount: string;
+        line_number: number;
+        standard_item_id: string | null;
+        standard_item_schema: string | null;
+        allowance_amount: string;
+        charge_amount: string;
+        iva_rate: string;
+        iva_base: string;
+        iva_amount: string;
+        inc_rate: string;
+        inc_amount: string;
+        ica_rate: string;
+        ica_amount: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    object: "invoice";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    cufe: string | null;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+    lines: {
+        description: string;
+        id: string;
+        metadata: Record<string, unknown>;
+        sku: string | null;
+        quantity: string;
+        unit_code: string;
+        unit_price: string;
+        line_extension_amount: string;
+        line_number: number;
+        standard_item_id: string | null;
+        standard_item_schema: string | null;
+        allowance_amount: string;
+        charge_amount: string;
+        iva_rate: string;
+        iva_base: string;
+        iva_amount: string;
+        inc_rate: string;
+        inc_amount: string;
+        ica_rate: string;
+        ica_amount: string;
+    }[];
+    dian_response: {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    } | null;
+    has_xml: boolean;
+    has_pdf: boolean;
+    qr_url: string | null;
+}, {
+    object: "invoice";
+    id: string;
+    status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+    livemode: boolean;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+    environment: string;
+    full_number: string;
+    cufe: string | null;
+    customer_id: string;
+    numbering_resolution_id: string;
+    issue_date: string;
+    currency_code: string;
+    payable_amount: string;
+    lines: {
+        description: string;
+        id: string;
+        metadata: Record<string, unknown>;
+        sku: string | null;
+        quantity: string;
+        unit_code: string;
+        unit_price: string;
+        line_extension_amount: string;
+        line_number: number;
+        standard_item_id: string | null;
+        standard_item_schema: string | null;
+        allowance_amount: string;
+        charge_amount: string;
+        iva_rate: string;
+        iva_base: string;
+        iva_amount: string;
+        inc_rate: string;
+        inc_amount: string;
+        ica_rate: string;
+        ica_amount: string;
+    }[];
+    dian_response: {
+        errors: {
+            code: string;
+            message: string;
+        }[];
+        track_id: string | null;
+        status_code: string | null;
+        status_description: string | null;
+        is_valid: boolean;
+        validated_at: string | null;
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+    } | null;
+    has_xml: boolean;
+    has_pdf: boolean;
+    qr_url: string | null;
+}>;
+declare const InvoiceListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        object: z.ZodLiteral<"invoice">;
+        livemode: z.ZodBoolean;
+        /**
+         * status: 'draft' on 202 response (the worker transitions to 'processing' after
+         * reserveNumber completes, and eventually to 'accepted_by_dian' or 'rejected_by_dian').
+         *
+         * Estados:
+         *   draft           — creado, encolado pendiente de procesamiento
+         *   processing      — worker asignó número, firmando
+         *   signed          — firmado, enviando a DIAN
+         *   accepted_by_dian — DIAN aceptó
+         *   rejected_by_dian — DIAN rechazó
+         *   accepted_contingency — Tipo 04 emitido
+         *   failed          — error interno
+         */
+        status: z.ZodEnum<["draft", "processing", "signed", "accepted_by_dian", "rejected_by_dian", "accepted_contingency", "failed"]>;
+        /**
+         * full_number: '' in the 202 draft response. Filled by worker after reserveNumber.
+         * Format: '{prefix}{consecutive}', e.g. 'FE0042'.
+         */
+        full_number: z.ZodString;
+        /**
+         * cufe: null in the 202 draft response. Filled by worker after signing.
+         */
+        cufe: z.ZodNullable<z.ZodString>;
+        customer_id: z.ZodString;
+        prefix: z.ZodString;
+        numbering_resolution_id: z.ZodString;
+        issue_date: z.ZodString;
+        currency_code: z.ZodString;
+        environment: z.ZodString;
+        payable_amount: z.ZodString;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    } & {
+        dian_response: z.ZodNullable<z.ZodObject<{
+            track_id: z.ZodNullable<z.ZodString>;
+            status_code: z.ZodNullable<z.ZodString>;
+            status_description: z.ZodNullable<z.ZodString>;
+            is_valid: z.ZodBoolean;
+            validated_at: z.ZodNullable<z.ZodString>;
+            errors: z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                message: string;
+            }, {
+                code: string;
+                message: string;
+            }>, "many">;
+            warnings: z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                message: string;
+            }, {
+                code: string;
+                message: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        }, {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        }>>;
+        has_xml: z.ZodBoolean;
+        has_pdf: z.ZodBoolean;
+        qr_url: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        object: "invoice";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        cufe: string | null;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+    }, {
+        object: "invoice";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        cufe: string | null;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+    }>, "many">;
+    has_more: z.ZodBoolean;
+    next_cursor: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        object: "invoice";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        cufe: string | null;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}, {
+    data: {
+        object: "invoice";
+        id: string;
+        status: "draft" | "processing" | "signed" | "accepted_by_dian" | "rejected_by_dian" | "accepted_contingency" | "failed";
+        livemode: boolean;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        prefix: string;
+        environment: string;
+        full_number: string;
+        cufe: string | null;
+        customer_id: string;
+        numbering_resolution_id: string;
+        issue_date: string;
+        currency_code: string;
+        payable_amount: string;
+        dian_response: {
+            errors: {
+                code: string;
+                message: string;
+            }[];
+            track_id: string | null;
+            status_code: string | null;
+            status_description: string | null;
+            is_valid: boolean;
+            validated_at: string | null;
+            warnings: {
+                code: string;
+                message: string;
+            }[];
+        } | null;
+        has_xml: boolean;
+        has_pdf: boolean;
+        qr_url: string | null;
+    }[];
+    has_more: boolean;
+    next_cursor: string | null;
+}>;
+/**
+ * EmailDeliveryResponseSchema — shape of a single email delivery row (PR4 trazabilidad).
+ *
+ * Shared across all 3 document resources. Registered once here (openapi `'EmailDeliveryResponse'`
+ * name), referenced in credit-notes.ts and debit-notes.ts.
+ */
+declare const EmailDeliveryResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<["queued", "sent", "delivered", "bounced", "complained"]>;
+    mode: z.ZodEnum<["test", "live"]>;
+    recipient_email: z.ZodString;
+    provider_message_id: z.ZodNullable<z.ZodString>;
+    attempts: z.ZodNumber;
+    last_error: z.ZodNullable<z.ZodString>;
+    trigger_source: z.ZodEnum<["auto", "manual"]>;
+    sent_at: z.ZodNullable<z.ZodString>;
+    delivered_at: z.ZodNullable<z.ZodString>;
+    bounced_at: z.ZodNullable<z.ZodString>;
+    complained_at: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    status: "queued" | "sent" | "delivered" | "bounced" | "complained";
+    created_at: string;
+    mode: "test" | "live";
+    recipient_email: string;
+    provider_message_id: string | null;
+    attempts: number;
+    last_error: string | null;
+    trigger_source: "auto" | "manual";
+    sent_at: string | null;
+    delivered_at: string | null;
+    bounced_at: string | null;
+    complained_at: string | null;
+}, {
+    id: string;
+    status: "queued" | "sent" | "delivered" | "bounced" | "complained";
+    created_at: string;
+    mode: "test" | "live";
+    recipient_email: string;
+    provider_message_id: string | null;
+    attempts: number;
+    last_error: string | null;
+    trigger_source: "auto" | "manual";
+    sent_at: string | null;
+    delivered_at: string | null;
+    bounced_at: string | null;
+    complained_at: string | null;
+}>;
+declare const EmailDeliveryListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<["queued", "sent", "delivered", "bounced", "complained"]>;
+        mode: z.ZodEnum<["test", "live"]>;
+        recipient_email: z.ZodString;
+        provider_message_id: z.ZodNullable<z.ZodString>;
+        attempts: z.ZodNumber;
+        last_error: z.ZodNullable<z.ZodString>;
+        trigger_source: z.ZodEnum<["auto", "manual"]>;
+        sent_at: z.ZodNullable<z.ZodString>;
+        delivered_at: z.ZodNullable<z.ZodString>;
+        bounced_at: z.ZodNullable<z.ZodString>;
+        complained_at: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        status: "queued" | "sent" | "delivered" | "bounced" | "complained";
+        created_at: string;
+        mode: "test" | "live";
+        recipient_email: string;
+        provider_message_id: string | null;
+        attempts: number;
+        last_error: string | null;
+        trigger_source: "auto" | "manual";
+        sent_at: string | null;
+        delivered_at: string | null;
+        bounced_at: string | null;
+        complained_at: string | null;
+    }, {
+        id: string;
+        status: "queued" | "sent" | "delivered" | "bounced" | "complained";
+        created_at: string;
+        mode: "test" | "live";
+        recipient_email: string;
+        provider_message_id: string | null;
+        attempts: number;
+        last_error: string | null;
+        trigger_source: "auto" | "manual";
+        sent_at: string | null;
+        delivered_at: string | null;
+        bounced_at: string | null;
+        complained_at: string | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        id: string;
+        status: "queued" | "sent" | "delivered" | "bounced" | "complained";
+        created_at: string;
+        mode: "test" | "live";
+        recipient_email: string;
+        provider_message_id: string | null;
+        attempts: number;
+        last_error: string | null;
+        trigger_source: "auto" | "manual";
+        sent_at: string | null;
+        delivered_at: string | null;
+        bounced_at: string | null;
+        complained_at: string | null;
+    }[];
+}, {
+    data: {
+        id: string;
+        status: "queued" | "sent" | "delivered" | "bounced" | "complained";
+        created_at: string;
+        mode: "test" | "live";
+        recipient_email: string;
+        provider_message_id: string | null;
+        attempts: number;
+        last_error: string | null;
+        trigger_source: "auto" | "manual";
+        sent_at: string | null;
+        delivered_at: string | null;
+        bounced_at: string | null;
+        complained_at: string | null;
+    }[];
+}>;
+declare const SendEmailRequestSchema: z.ZodObject<{
+    to: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    to?: string | undefined;
+}, {
+    to?: string | undefined;
+}>;
+declare const EmailContentResponseSchema: z.ZodObject<{
+    recipient: z.ZodNullable<z.ZodString>;
+    subject: z.ZodString;
+    attached_document: z.ZodObject<{
+        available: z.ZodBoolean;
+        download_url: z.ZodNullable<z.ZodString>;
+        expires_in: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        available: boolean;
+        download_url: string | null;
+        expires_in: number | null;
+    }, {
+        available: boolean;
+        download_url: string | null;
+        expires_in: number | null;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    recipient: string | null;
+    subject: string;
+    attached_document: {
+        available: boolean;
+        download_url: string | null;
+        expires_in: number | null;
+    };
+}, {
+    recipient: string | null;
+    subject: string;
+    attached_document: {
+        available: boolean;
+        download_url: string | null;
+        expires_in: number | null;
+    };
+}>;
+
+/**
+ * Generated SDK types inferred from @emitia/openapi Zod schemas.
+ *
+ * ADR-1: z.infer types come from @emitia/openapi (devDependency, type-only).
+ * @emitia/openapi is NEVER bundled into dist — types are erased at runtime.
+ *
+ * This file is purely a type alias re-export. No runtime code.
+ */
+
+type AccountInfo = z.infer<typeof AccountInfoSchema>;
+type BalanceResponse = z.infer<typeof BalanceResponseSchema>;
+type CatalogItem = z.infer<typeof CatalogItemSchema>;
+type CatalogListResponse = z.infer<typeof CatalogListResponseSchema>;
+type MunicipioItem = z.infer<typeof MunicipioItemSchema>;
+type MunicipioListResponse = z.infer<typeof MunicipioListResponseSchema>;
+type CustomerResponse = z.infer<typeof CustomerResponseSchema>;
+type CreateCustomerRequest = z.infer<typeof CreateCustomerRequestSchema>;
+type CustomerListResponse = z.infer<typeof CustomerListResponseSchema>;
+type NumberingResolutionResponse = z.infer<typeof NumberingResolutionResponseSchema>;
+type CreateNumberingResolutionRequest = z.infer<typeof CreateNumberingResolutionRequestSchema>;
+type NumberingResolutionListResponse = z.infer<typeof NumberingResolutionListResponseSchema>;
+type InvoiceResponse = z.infer<typeof InvoiceResponseSchema>;
+type InvoiceDetailResponse = z.infer<typeof InvoiceDetailResponseSchema>;
+type InvoiceListResponse = z.infer<typeof InvoiceListResponseSchema>;
+type CreateInvoiceRequest = z.infer<typeof CreateInvoiceRequestSchema>;
+type EmailDeliveryResponse = z.infer<typeof EmailDeliveryResponseSchema>;
+type EmailDeliveryListResponse = z.infer<typeof EmailDeliveryListResponseSchema>;
+type SendEmailRequest = z.infer<typeof SendEmailRequestSchema>;
+type EmailContentResponse = z.infer<typeof EmailContentResponseSchema>;
+type CreditNoteResponse = z.infer<typeof CreditNoteResponseSchema>;
+type CreditNoteDetailResponse = z.infer<typeof CreditNoteDetailResponseSchema>;
+type CreditNoteListResponse = z.infer<typeof CreditNoteListResponseSchema>;
+type CreateCreditNoteRequest = z.infer<typeof CreateCreditNoteRequestSchema>;
+type DebitNoteResponse = z.infer<typeof DebitNoteResponseSchema>;
+type DebitNoteDetailResponse = z.infer<typeof DebitNoteDetailResponseSchema>;
+type DebitNoteListResponse = z.infer<typeof DebitNoteListResponseSchema>;
+type CreateDebitNoteRequest = z.infer<typeof CreateDebitNoteRequestSchema>;
+type CertificateResponse = z.infer<typeof CertificateResponseSchema>;
+type CreateCertificateRequest = z.infer<typeof CreateCertificateRequestSchema>;
+type CertificateListResponse = z.infer<typeof CertificateListResponseSchema>;
+type TriggerEventBody = z.infer<typeof TriggerEventBodySchema>;
+type TriggerEventResponse = z.infer<typeof TriggerEventResponseSchema>;
+
+/**
+ * HTTP transport for the @emitia/node SDK.
+ *
+ * R02: Authorization + User-Agent on every request.
+ * R03: Idempotency-key auto-generation (UUID v4 via crypto.randomUUID) for flagged POSTs.
+ * R04: Retry 429/5xx with exponential backoff + full jitter; Retry-After defensive.
+ *      AbortSignal respected. Same idempotency-key reused across retries.
+ *      No `!` non-null assertions in runtime code.
+ */
+
+interface RequestOptions {
+    method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    path: string;
+    query?: Record<string, string | number | boolean>;
+    body?: unknown;
+    idempotencyKey?: string;
+    /** When true, a UUID v4 idempotency-key is generated automatically. */
+    autoIdempotency?: boolean;
+    signal?: AbortSignal;
+}
+declare class HttpClient {
+    private readonly config;
+    constructor(config: EmitiaConfig);
+    request<T>(opts: RequestOptions): Promise<T>;
+    private buildUrl;
+}
+
+/**
+ * BaseResource — shared base class for all SDK resource namespaces.
+ *
+ * Holds a reference to the HttpClient so resource subclasses can call
+ * this._http.request<T>(...) without re-wiring the transport.
+ */
+
+declare abstract class BaseResource {
+    protected readonly _http: HttpClient;
+    constructor(http: HttpClient);
+}
+
+/**
+ * AccountResource — GET /v1/account
+ *
+ * R06: Read-only resource. Returns tenant info for the authenticated API key.
+ */
+
+declare class AccountResource extends BaseResource {
+    retrieve(): Promise<AccountInfo>;
+}
+
+/**
+ * BalanceResource — GET /v1/balance
+ *
+ * R06: Read-only resource. Returns document usage counts for the current period.
+ */
+
+declare class BalanceResource extends BaseResource {
+    retrieve(): Promise<BalanceResponse>;
+}
+
+/**
+ * CatalogsResource — GET /v1/catalogs/{slug} and GET /v1/catalogs/municipios
+ *
+ * R06: Read-only resource (public endpoints, no auth required by the API — but
+ *      the SDK sends Authorization anyway as it's always present).
+ *
+ * Response types are inferred via z.infer from the @emitia/openapi Zod SSOT
+ * (CatalogListResponseSchema / MunicipioListResponseSchema) — zero drift with
+ * the actual API contract.
+ */
+
+interface MunicipiosQuery {
+    /** 2-digit DANE department code (e.g. "11" for Bogotá D.C.). */
+    department?: string;
+}
+declare class CatalogsResource extends BaseResource {
+    /**
+     * GET /v1/catalogs/{slug}
+     * Returns all items in a named DIAN catalog.
+     */
+    retrieve(slug: string): Promise<CatalogListResponse>;
+    /**
+     * GET /v1/catalogs/municipios
+     * Returns Colombian municipalities. Optionally filtered by 2-digit department code.
+     */
+    municipios(query?: MunicipiosQuery): Promise<MunicipioListResponse>;
+}
+
+/**
+ * CertificatesResource — read + write methods for /v1/certificates
+ *
+ * R06: retrieve(id), list(params?), create(body, opts?), del(id), activate(id).
+ * R03: create() does NOT auto-generate idempotency-key (openapi.json: no Idempotency-Key header on POST /v1/certificates).
+ *      Override via opts.idempotencyKey is still accepted.
+ *      del() and activate() carry no idempotency-key.
+ */
+
+interface CertificateListParams {
+    /** Number of results per page (1–100, default 20). */
+    limit?: number;
+    /** Opaque cursor for pagination. */
+    starting_after?: string;
+}
+interface CertificateCreateOpts {
+    /** Optional explicit idempotency key (NOT auto-generated — openapi.json does not require it). */
+    idempotencyKey?: string;
+}
+declare class CertificatesResource extends BaseResource {
+    /**
+     * GET /v1/certificates/{id}
+     * Returns certificate metadata by ID. 404 if not found or cross-tenant.
+     */
+    retrieve(id: string): Promise<CertificateResponse>;
+    /**
+     * GET /v1/certificates
+     * Returns a cursor-paginated list of certificate metadata.
+     * Soft-deleted certificates are excluded.
+     */
+    list(params?: CertificateListParams): Promise<CertificateListResponse>;
+    /**
+     * POST /v1/certificates — Upload a new .p12 certificate.
+     * Returns 201. No auto-idempotency (openapi.json: no Idempotency-Key header required).
+     * Explicit override accepted via opts.idempotencyKey.
+     */
+    create(body: CreateCertificateRequest, opts?: CertificateCreateOpts): Promise<CertificateResponse>;
+    /**
+     * DELETE /v1/certificates/{id} — Soft-delete a certificate.
+     * Returns 200 with the deleted CertificateResponse (not 204). No idempotency-key.
+     */
+    del(id: string): Promise<CertificateResponse>;
+    /**
+     * POST /v1/certificates/{id}/activate — Set this certificate as the active signing cert.
+     * Returns 200 with updated CertificateResponse. No idempotency-key.
+     */
+    activate(id: string): Promise<CertificateResponse>;
+}
+
+/**
+ * CreditNotesResource — full CRUD + email methods for /v1/credit-notes
+ *
+ * R03: create() and sendEmail() are POST cobrables — auto-generate idempotency-key.
+ * R06: 6 methods: create, retrieve, list, sendEmail, emailContent, listEmails.
+ * R07: Money fields (payable_amount) remain strings — no coercion.
+ */
+
+type NoteStatus$1 = 'draft' | 'processing' | 'signed' | 'accepted_by_dian' | 'rejected_by_dian' | 'accepted_contingency' | 'failed';
+interface CreditNoteListParams {
+    /** Max items to return (1–100). */
+    limit?: number;
+    /** Cursor from previous page. */
+    starting_after?: string;
+    /** Filter by credit note status. */
+    status?: NoteStatus$1;
+    /** ISO-8601 date/datetime — include notes created at or after. */
+    'created[gte]'?: string;
+    /** ISO-8601 date/datetime — include notes created before. */
+    'created[lt]'?: string;
+}
+interface CreditNoteCreateOpts {
+    /** Explicit idempotency key. When omitted a UUID v4 is auto-generated. */
+    idempotencyKey?: string;
+}
+interface SendEmailOpts$2 {
+    /** Explicit idempotency key. When omitted a UUID v4 is auto-generated. */
+    idempotencyKey?: string;
+}
+declare class CreditNotesResource extends BaseResource {
+    /**
+     * POST /v1/credit-notes — Create a draft credit note.
+     * Returns 202. Auto-generates idempotency-key (R03).
+     */
+    create(body: CreateCreditNoteRequest, opts?: CreditNoteCreateOpts): Promise<CreditNoteResponse>;
+    /**
+     * GET /v1/credit-notes/{id} — Retrieve credit note by ID (detail including DIAN response).
+     * No idempotency-key.
+     */
+    retrieve(id: string): Promise<CreditNoteDetailResponse>;
+    /**
+     * GET /v1/credit-notes — List credit notes (cursor-paginated, filterable).
+     * No idempotency-key.
+     */
+    list(params?: CreditNoteListParams): Promise<CreditNoteListResponse>;
+    /**
+     * POST /v1/credit-notes/{id}/send-email — Manually resend the credit note email.
+     * Returns 202. Auto-generates idempotency-key (R03).
+     */
+    sendEmail(id: string, body?: SendEmailRequest, opts?: SendEmailOpts$2): Promise<EmailDeliveryResponse>;
+    /**
+     * GET /v1/credit-notes/{id}/email-content — Get email content.
+     * No idempotency-key.
+     */
+    emailContent(id: string): Promise<EmailContentResponse>;
+    /**
+     * GET /v1/credit-notes/{id}/emails — List email delivery attempts.
+     * No idempotency-key.
+     */
+    listEmails(id: string): Promise<EmailDeliveryListResponse>;
+}
+
+/**
+ * CustomersResource — read + write methods for /v1/customers
+ *
+ * R06: retrieve(id), list(params?), create(body, opts?), update(id, body), del(id).
+ * R03: create() is a billable POST — auto-generates idempotency-key (Idempotency-Key required per openapi.json).
+ *      PATCH and DELETE do NOT carry idempotency-key.
+ */
+
+interface CustomerListParams {
+    /** Number of results per page (1–100, default 20). */
+    limit?: number;
+    /** Opaque cursor for pagination (ID of the last item from the previous page). */
+    starting_after?: string;
+}
+interface CustomerCreateOpts {
+    /** Explicit idempotency key. When omitted a UUID v4 is auto-generated (R03). */
+    idempotencyKey?: string;
+}
+declare class CustomersResource extends BaseResource {
+    /**
+     * GET /v1/customers/{id}
+     * Returns a customer by public ID. 404 if not found or soft-deleted.
+     */
+    retrieve(id: string): Promise<CustomerResponse>;
+    /**
+     * GET /v1/customers
+     * Returns a cursor-paginated list of customers.
+     */
+    list(params?: CustomerListParams): Promise<CustomerListResponse>;
+    /**
+     * POST /v1/customers — Create a customer.
+     * Returns 201. Auto-generates idempotency-key (R03 — openapi.json marks Idempotency-Key required).
+     */
+    create(body: CreateCustomerRequest, opts?: CustomerCreateOpts): Promise<CustomerResponse>;
+    /**
+     * PATCH /v1/customers/{id} — Update a customer.
+     * Returns 200 with updated CustomerResponse. No idempotency-key.
+     */
+    update(id: string, body: Partial<CreateCustomerRequest>): Promise<CustomerResponse>;
+    /**
+     * DELETE /v1/customers/{id} — Soft-delete a customer.
+     * Returns 200 with the deleted CustomerResponse (not 204). No idempotency-key.
+     */
+    del(id: string): Promise<CustomerResponse>;
+}
+
+/**
+ * DebitNotesResource — full CRUD + email methods for /v1/debit-notes
+ *
+ * R03: create() and sendEmail() are POST cobrables — auto-generate idempotency-key.
+ * R06: 6 methods: create, retrieve, list, sendEmail, emailContent, listEmails.
+ * R07: Money fields (payable_amount) remain strings — no coercion.
+ */
+
+type NoteStatus = 'draft' | 'processing' | 'signed' | 'accepted_by_dian' | 'rejected_by_dian' | 'accepted_contingency' | 'failed';
+interface DebitNoteListParams {
+    /** Max items to return (1–100). */
+    limit?: number;
+    /** Cursor from previous page. */
+    starting_after?: string;
+    /** Filter by debit note status. */
+    status?: NoteStatus;
+    /** ISO-8601 date/datetime — include notes created at or after. */
+    'created[gte]'?: string;
+    /** ISO-8601 date/datetime — include notes created before. */
+    'created[lt]'?: string;
+}
+interface DebitNoteCreateOpts {
+    /** Explicit idempotency key. When omitted a UUID v4 is auto-generated. */
+    idempotencyKey?: string;
+}
+interface SendEmailOpts$1 {
+    /** Explicit idempotency key. When omitted a UUID v4 is auto-generated. */
+    idempotencyKey?: string;
+}
+declare class DebitNotesResource extends BaseResource {
+    /**
+     * POST /v1/debit-notes — Create a draft debit note.
+     * Returns 202. Auto-generates idempotency-key (R03).
+     */
+    create(body: CreateDebitNoteRequest, opts?: DebitNoteCreateOpts): Promise<DebitNoteResponse>;
+    /**
+     * GET /v1/debit-notes/{id} — Retrieve debit note by ID (detail including DIAN response).
+     * No idempotency-key.
+     */
+    retrieve(id: string): Promise<DebitNoteDetailResponse>;
+    /**
+     * GET /v1/debit-notes — List debit notes (cursor-paginated, filterable).
+     * No idempotency-key.
+     */
+    list(params?: DebitNoteListParams): Promise<DebitNoteListResponse>;
+    /**
+     * POST /v1/debit-notes/{id}/send-email — Manually resend the debit note email.
+     * Returns 202. Auto-generates idempotency-key (R03).
+     */
+    sendEmail(id: string, body?: SendEmailRequest, opts?: SendEmailOpts$1): Promise<EmailDeliveryResponse>;
+    /**
+     * GET /v1/debit-notes/{id}/email-content — Get email content.
+     * No idempotency-key.
+     */
+    emailContent(id: string): Promise<EmailContentResponse>;
+    /**
+     * GET /v1/debit-notes/{id}/emails — List email delivery attempts.
+     * No idempotency-key.
+     */
+    listEmails(id: string): Promise<EmailDeliveryListResponse>;
+}
+
+/**
+ * InvoicesResource — full CRUD + email methods for /v1/invoices
+ *
+ * R03: create() and sendEmail() are POST cobrables — auto-generate idempotency-key.
+ * R06: 6 methods: create, retrieve, list, sendEmail, emailContent, listEmails.
+ * R07: Money fields (payable_amount) remain strings — no coercion.
+ */
+
+/** Status values for the list filter. */
+type InvoiceStatus = 'draft' | 'processing' | 'signed' | 'accepted_by_dian' | 'rejected_by_dian' | 'accepted_contingency' | 'failed';
+interface InvoiceListParams {
+    /** Max items to return (1–100, default 20). */
+    limit?: number;
+    /** Cursor from previous page (next_cursor field). */
+    starting_after?: string;
+    /** Filter by invoice status. */
+    status?: InvoiceStatus;
+    /** Filter by customer_id. */
+    customer?: string;
+    /** ISO-8601 date/datetime — include invoices created at or after. */
+    'created[gte]'?: string;
+    /** ISO-8601 date/datetime — include invoices created before. */
+    'created[lt]'?: string;
+    /** Filter by numbering prefix (e.g. "FE"). */
+    number_prefix?: string;
+    /** Filter by exact CUFE value. */
+    cufe?: string;
+}
+interface InvoiceCreateOpts {
+    /** Explicit idempotency key. When omitted a UUID v4 is auto-generated. */
+    idempotencyKey?: string;
+}
+interface SendEmailOpts {
+    /** Explicit idempotency key. When omitted a UUID v4 is auto-generated. */
+    idempotencyKey?: string;
+}
+declare class InvoicesResource extends BaseResource {
+    /**
+     * POST /v1/invoices — Create a draft invoice.
+     * Returns 202. Auto-generates idempotency-key (R03).
+     */
+    create(body: CreateInvoiceRequest, opts?: InvoiceCreateOpts): Promise<InvoiceResponse>;
+    /**
+     * GET /v1/invoices/{id} — Retrieve invoice by ID (detail including lines).
+     * No idempotency-key.
+     */
+    retrieve(id: string): Promise<InvoiceDetailResponse>;
+    /**
+     * GET /v1/invoices — List invoices (cursor-paginated, filterable).
+     * No idempotency-key.
+     */
+    list(params?: InvoiceListParams): Promise<InvoiceListResponse>;
+    /**
+     * POST /v1/invoices/{id}/send-email — Manually resend the invoice email.
+     * Returns 202. Auto-generates idempotency-key (R03).
+     */
+    sendEmail(id: string, body?: SendEmailRequest, opts?: SendEmailOpts): Promise<EmailDeliveryResponse>;
+    /**
+     * GET /v1/invoices/{id}/email-content — Get email content (recipient, subject, AttachedDoc).
+     * No idempotency-key.
+     */
+    emailContent(id: string): Promise<EmailContentResponse>;
+    /**
+     * GET /v1/invoices/{id}/emails — List email delivery attempts.
+     * No idempotency-key.
+     */
+    listEmails(id: string): Promise<EmailDeliveryListResponse>;
+}
+
+/**
+ * NumberingResolutionsResource — read + write methods for /v1/numbering-resolutions
+ *
+ * R06: retrieve(id), list(params?), create(body, opts?), activate(id).
+ * R03: create() auto-generates idempotency-key (openapi.json: Idempotency-Key required on POST /v1/numbering-resolutions).
+ *      activate() carries no idempotency-key (openapi.json: no header on POST /{id}/activate).
+ */
+
+interface NumberingResolutionListParams {
+    /** Number of results per page (1–100, default 20). */
+    limit?: number;
+    /** Opaque cursor for pagination. */
+    starting_after?: string;
+}
+interface NumberingResolutionCreateOpts {
+    /** Explicit idempotency key. When omitted a UUID v4 is auto-generated (R03). */
+    idempotencyKey?: string;
+}
+declare class NumberingResolutionsResource extends BaseResource {
+    /**
+     * GET /v1/numbering-resolutions/{id}
+     * Returns a numbering resolution by ID. 404 if not found or cross-tenant.
+     */
+    retrieve(id: string): Promise<NumberingResolutionResponse>;
+    /**
+     * GET /v1/numbering-resolutions
+     * Returns a cursor-paginated list of numbering resolutions.
+     */
+    list(params?: NumberingResolutionListParams): Promise<NumberingResolutionListResponse>;
+    /**
+     * POST /v1/numbering-resolutions — Register a new DIAN resolution.
+     * Returns 201. Auto-generates idempotency-key (R03 — openapi.json marks Idempotency-Key required).
+     */
+    create(body: CreateNumberingResolutionRequest, opts?: NumberingResolutionCreateOpts): Promise<NumberingResolutionResponse>;
+    /**
+     * POST /v1/numbering-resolutions/{id}/activate — Mark this resolution as active.
+     * Returns 200 with updated NumberingResolutionResponse. No idempotency-key.
+     */
+    activate(id: string): Promise<NumberingResolutionResponse>;
+}
+
+/**
+ * TestResource — methods for /v1/test/* (test-mode only).
+ *
+ * R06: triggerEvent(body) → POST /v1/test/trigger-event.
+ * R03: No auto-idempotency (openapi.json: no Idempotency-Key header on this endpoint).
+ *
+ * 403 PermissionError is thrown automatically by the HTTP transport when the API
+ * key is a live key — no special handling needed here.
+ */
+
+declare class TestResource extends BaseResource {
+    /**
+     * POST /v1/test/trigger-event — Manually fire a webhook event in test mode.
+     * Returns 201 with TriggerEventResponse.
+     * Throws PermissionError (403) if called with a live API key.
+     * No idempotency-key.
+     */
+    triggerEvent(body: TriggerEventBody): Promise<TriggerEventResponse>;
+}
+
+/**
+ * Emitia SDK client.
+ *
+ * R01: Constructor validates apiKey and merges opts. Throws synchronously on invalid key.
+ * R02: HttpClient attaches Authorization + User-Agent to every request.
+ *
+ * Resource namespaces are readonly properties, instantiated in the constructor
+ * with the private #http field. No getter stubs, no _transport leakage.
+ *
+ * PR2 auditor fix: removed _transport getter. #http is passed directly to each
+ * resource in the constructor body — a class private field is accessible within
+ * the class scope, so no public exposure is needed.
+ *
+ * PR3a: invoices, creditNotes, debitNotes wired as real readonly properties.
+ * PR3b: customers write methods added; TestResource replaces test stub.
+ */
+
+/** Options accepted by the Emitia constructor (all optional). */
+type EmitiaOptions = Partial<Omit<EmitiaConfig, 'apiKey'>>;
+declare class Emitia {
+    #private;
+    readonly account: AccountResource;
+    readonly balance: BalanceResource;
+    readonly catalogs: CatalogsResource;
+    readonly certificates: CertificatesResource;
+    readonly numberingResolutions: NumberingResolutionsResource;
+    readonly customers: CustomersResource;
+    readonly invoices: InvoicesResource;
+    readonly creditNotes: CreditNotesResource;
+    readonly debitNotes: DebitNotesResource;
+    readonly test: TestResource;
+    constructor(apiKey: string, opts?: EmitiaOptions);
+}
+
+/**
+ * Typed error hierarchy for the @emitia/node SDK.
+ *
+ * R05: Every non-2xx response → typed subclass of EmitiaError.
+ *
+ * Design: SDK redeclares its own hierarchy. Does NOT import @emitia/shared
+ * at runtime — @emitia/shared is a backend-private package.
+ *
+ * Mapping:
+ *   401                           → AuthenticationError
+ *   403                           → PermissionError
+ *   404                           → NotFoundError
+ *   422                           → ValidationError
+ *   429                           → RateLimitError
+ *   409 + type=idempotency_error  → IdempotencyError
+ *   type=dian_rejected            → DianRejectedError  (any status)
+ *   all others                    → ApiError
+ */
+interface ErrorPayloadInner {
+    type: string;
+    code: string;
+    message: string;
+    doc_url?: string;
+    request_id?: string;
+    details?: unknown;
+}
+interface ErrorEnvelope {
+    error: ErrorPayloadInner;
+}
+/** Narrows an unknown value to an ErrorEnvelope. No `!` usage. */
+declare function isErrorEnvelope(value: unknown): value is ErrorEnvelope;
+declare class EmitiaError extends Error {
+    readonly type: string;
+    readonly code: string;
+    readonly requestId: string;
+    readonly statusCode: number;
+    readonly docUrl: string | undefined;
+    readonly details: unknown;
+    constructor(opts: {
+        type: string;
+        code: string;
+        message: string;
+        requestId: string;
+        statusCode: number;
+        docUrl?: string;
+        details?: unknown;
+    });
+}
+declare class AuthenticationError extends EmitiaError {
+}
+declare class PermissionError extends EmitiaError {
+}
+declare class NotFoundError extends EmitiaError {
+}
+declare class ValidationError extends EmitiaError {
+}
+declare class RateLimitError extends EmitiaError {
+}
+declare class IdempotencyError extends EmitiaError {
+}
+declare class DianRejectedError extends EmitiaError {
+}
+declare class DianUnavailableError extends EmitiaError {
+}
+declare class CertificateError extends EmitiaError {
+}
+declare class NumberingError extends EmitiaError {
+}
+/** Fallback for any type not explicitly mapped. */
+declare class ApiError extends EmitiaError {
+}
+/**
+ * Build a typed error from an API error envelope + HTTP metadata.
+ *
+ * Resolution order:
+ *   1. error.type in TYPE_TO_CLASS → use that class
+ *   2. httpStatus in HTTP_STATUS_TO_CLASS → use that class
+ *   3. fallback → ApiError
+ *
+ * requestId comes from the `X-Request-Id` response header (passed as parameter).
+ */
+declare function fromPayload(envelope: ErrorEnvelope, httpStatus: number, requestId: string): EmitiaError;
+
+/**
+ * Webhook signature verification for @emitia/node.
+ *
+ * R08: constructEvent() parses and validates the Emitia-Signature header,
+ * verifies the HMAC-SHA256 signature timing-safely, checks timestamp freshness,
+ * and returns the parsed event.
+ *
+ * Algorithm (source: apps/worker/src/processors/webhook-deliver.processor.ts L136–158):
+ *   t      = Math.floor(Date.now() / 1000)   — unix seconds
+ *   signed = `${t}.${rawBody}`               — concatenate timestamp + raw body
+ *   v1     = HMAC-SHA256(secret, signed).digest('hex')
+ *   header = `t=${t},v1=${v1}`               — Emitia-Signature header value
+ *
+ *   Additional headers sent by worker (informational, NOT part of signature):
+ *     Emitia-Event-Id, Emitia-Event-Type
+ *
+ * Security notes:
+ *   - timingSafeEqual is used for HMAC comparison to prevent timing attacks.
+ *   - Length pre-check before timingSafeEqual: if lengths differ we reject
+ *     immediately (before calling timingSafeEqual which would throw on unequal
+ *     lengths) to prevent RangeError from leaking information.
+ *   - JSON.parse is called ONLY after signature verification — never on
+ *     unverified input first.
+ */
+/**
+ * Emitia webhook event shape.
+ *
+ * Matches the canonical body built in webhook-deliver.processor.ts L137–143:
+ *   { id, type, api_version, created: tSeconds (number), data }
+ *
+ * NOTE: There is no shared schema in @emitia/openapi for the event envelope —
+ * it is built inline in the worker. This type mirrors that shape exactly.
+ */
+interface EmitiaEvent {
+    /** Event ID (e.g. "evt_01HX..."). */
+    id: string;
+    /** Event type (e.g. "invoice.accepted"). */
+    type: string;
+    /** API version that generated this event (e.g. "2024-01-01"). */
+    api_version: string;
+    /** Unix timestamp (seconds) when the event was created. */
+    created: number;
+    /** Event-specific payload. Shape depends on event.type. */
+    data: unknown;
+}
+/** Reason codes for SignatureVerificationError. */
+type SignatureVerificationReason = 'no_signature' /** Header missing, empty, or unparseable. */ | 'timestamp_out_of_tolerance' /** |now - t| > toleranceSec. */ | 'signature_mismatch' /** HMAC does not match any v1 value in header. */ | 'invalid_payload'; /** Signature verified, but the body is not valid JSON. */
+/**
+ * Thrown when constructEvent() cannot verify the webhook signature.
+ *
+ * Design: NOT a subclass of EmitiaError (which models HTTP API errors).
+ * This error models a local crypto verification failure — no HTTP involved.
+ */
+declare class SignatureVerificationError extends Error {
+    readonly reason: SignatureVerificationReason;
+    constructor(reason: SignatureVerificationReason, message: string);
+}
+/**
+ * Verify an Emitia webhook signature and return the parsed event.
+ *
+ * @param payload        Raw request body — string or Buffer. Do NOT parse JSON first.
+ * @param signatureHeader Value of the `Emitia-Signature` header (e.g. `t=...,v1=...`).
+ * @param secret         Webhook endpoint signing secret.
+ * @param toleranceSec   Maximum allowed age of the event in seconds (default: 300).
+ * @param nowSec         Injectable clock (returns current unix seconds). Defaults to
+ *                       Math.floor(Date.now() / 1000). Exposed for deterministic tests.
+ * @returns              Parsed and verified {@link EmitiaEvent}.
+ * @throws {SignatureVerificationError} When the header is invalid, the timestamp is
+ *         out of tolerance, or the signature does not match.
+ */
+declare function constructEvent(payload: string | Buffer, signatureHeader: string, secret: string, toleranceSec?: number, nowSec?: () => number): EmitiaEvent;
+
+/**
+ * SDK version constant.
+ *
+ * ADR-5: Declared as a plain string constant matching package.json#version.
+ * Not imported via import JSON (fragile ESM) — kept in sync by a test guard
+ * (src/__tests__/version.test.ts) that fails if they diverge.
+ */
+declare const SDK_VERSION = "0.1.0";
+
+export { type AccountInfo, ApiError, AuthenticationError, type BalanceResponse, type CatalogItem, type CatalogListResponse, CertificateError, type CertificateListResponse, type CertificateResponse, type CreateCertificateRequest, type CreateCreditNoteRequest, type CreateCustomerRequest, type CreateDebitNoteRequest, type CreateInvoiceRequest, type CreateNumberingResolutionRequest, type CreditNoteDetailResponse, type CreditNoteListResponse, type CreditNoteResponse, type CustomerListResponse, type CustomerResponse, type DebitNoteDetailResponse, type DebitNoteListResponse, type DebitNoteResponse, DianRejectedError, DianUnavailableError, type EmailContentResponse, type EmailDeliveryListResponse, type EmailDeliveryResponse, Emitia, EmitiaError, type EmitiaEvent, type EmitiaOptions, IdempotencyError, type InvoiceDetailResponse, type InvoiceListResponse, type InvoiceResponse, type MunicipioItem, type MunicipioListResponse, NotFoundError, NumberingError, type NumberingResolutionListResponse, type NumberingResolutionResponse, PermissionError, RateLimitError, SDK_VERSION, type SendEmailRequest, SignatureVerificationError, type SignatureVerificationReason, type TriggerEventBody, type TriggerEventResponse, ValidationError, constructEvent, fromPayload, isErrorEnvelope };