@klappay/types 3.3.0 → 3.5.0

package/dist/index.d.ts

@@ -1564,11 +1564,11 @@ declare const METRICS_QUERY_DEFAULT_ROW_LIMIT = 100;
 declare const METRICS_QUERY_MAX_GROUP_BY = 3;
 declare const METRICS_QUERY_MAX_FILTERS = 20;
 declare const METRICS_QUERY_MAX_METRICS = 10;
-declare const ChargesQueryFieldSchema: z.ZodEnum<["status", "source", "apiKeyId", "currency", "isOverpaid", "externalRef"]>;
+declare const ChargesQueryFieldSchema: z.ZodEnum<["status", "source", "apiKeyId", "currency", "isOverpaid", "externalRef", "escrowReleaserAddress"]>;
 type ChargesQueryField = z.infer<typeof ChargesQueryFieldSchema>;
-declare const ChargesMetricFieldSchema: z.ZodEnum<["amount", "amountReceived", "feePercent"]>;
+declare const ChargesMetricFieldSchema: z.ZodEnum<["amount", "amountReceived", "feePercent", "escrowFeePercent"]>;
 type ChargesMetricField = z.infer<typeof ChargesMetricFieldSchema>;
-declare const ChargesDateFieldSchema: z.ZodEnum<["createdAt", "confirmedAt", "lastActivityAt", "expiresAt"]>;
+declare const ChargesDateFieldSchema: z.ZodEnum<["createdAt", "confirmedAt", "lastActivityAt", "expiresAt", "escrowReleasedAt"]>;
 type ChargesDateField = z.infer<typeof ChargesDateFieldSchema>;
 declare const TransactionsQueryFieldSchema: z.ZodEnum<["network", "token", "source", "causedTransition"]>;
 type TransactionsQueryField = z.infer<typeof TransactionsQueryFieldSchema>;
@@ -1586,64 +1586,64 @@ declare const MetricsQuerySchema: z.ZodEffects<z.ZodDiscriminatedUnion<"resource
     resource: z.ZodLiteral<"charges">;
     environment: z.ZodEnum<["live", "test"]>;
     dateRange: z.ZodObject<{
-        field: z.ZodEnum<["createdAt", "confirmedAt", "lastActivityAt", "expiresAt"]>;
+        field: z.ZodEnum<["createdAt", "confirmedAt", "lastActivityAt", "expiresAt", "escrowReleasedAt"]>;
         from: z.ZodString;
         to: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         from: string;
         to: string;
     }, {
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         from: string;
         to: string;
     }>;
     groupBy: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodObject<{
         type: z.ZodLiteral<"field">;
-        field: z.ZodEnum<["status", "source", "apiKeyId", "currency", "isOverpaid", "externalRef"]>;
+        field: z.ZodEnum<["status", "source", "apiKeyId", "currency", "isOverpaid", "externalRef", "escrowReleaserAddress"]>;
     }, "strip", z.ZodTypeAny, {
         type: "field";
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
     }, {
         type: "field";
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
     }>, z.ZodObject<{
         type: z.ZodLiteral<"date_bucket">;
-        field: z.ZodEnum<["createdAt", "confirmedAt", "lastActivityAt", "expiresAt"]>;
+        field: z.ZodEnum<["createdAt", "confirmedAt", "lastActivityAt", "expiresAt", "escrowReleasedAt"]>;
         granularity: z.ZodEnum<["day", "week", "month", "year"]>;
     }, "strip", z.ZodTypeAny, {
         type: "date_bucket";
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         granularity: "day" | "week" | "month" | "year";
     }, {
         type: "date_bucket";
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         granularity: "day" | "week" | "month" | "year";
     }>]>, "many">>;
     metrics: z.ZodArray<z.ZodObject<{
         aggregation: z.ZodEnum<["count", "sum", "avg", "min", "max"]>;
-        field: z.ZodOptional<z.ZodEnum<["amount", "amountReceived", "feePercent"]>>;
+        field: z.ZodOptional<z.ZodEnum<["amount", "amountReceived", "feePercent", "escrowFeePercent"]>>;
         alias: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         aggregation: "count" | "sum" | "avg" | "min" | "max";
-        field?: "amount" | "amountReceived" | "feePercent" | undefined;
+        field?: "amount" | "amountReceived" | "feePercent" | "escrowFeePercent" | undefined;
         alias?: string | undefined;
     }, {
         aggregation: "count" | "sum" | "avg" | "min" | "max";
-        field?: "amount" | "amountReceived" | "feePercent" | undefined;
+        field?: "amount" | "amountReceived" | "feePercent" | "escrowFeePercent" | undefined;
         alias?: string | undefined;
     }>, "many">;
     filters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        field: z.ZodEnum<["status", "source", "apiKeyId", "currency", "isOverpaid", "externalRef"]>;
+        field: z.ZodEnum<["status", "source", "apiKeyId", "currency", "isOverpaid", "externalRef", "escrowReleaserAddress"]>;
         operator: z.ZodEnum<["eq", "neq", "in", "gt", "gte", "lt", "lte"]>;
         value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">]>;
     }, "strip", z.ZodTypeAny, {
         value: string | number | boolean | (string | number)[];
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
         operator: "eq" | "neq" | "in" | "gt" | "gte" | "lt" | "lte";
     }, {
         value: string | number | boolean | (string | number)[];
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
         operator: "eq" | "neq" | "in" | "gt" | "gte" | "lt" | "lte";
     }>, "many">>;
     orderBy: z.ZodOptional<z.ZodObject<{
@@ -1662,26 +1662,26 @@ declare const MetricsQuerySchema: z.ZodEffects<z.ZodDiscriminatedUnion<"resource
     environment: "live" | "test";
     resource: "charges";
     dateRange: {
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         from: string;
         to: string;
     };
     groupBy: ({
         type: "field";
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
     } | {
         type: "date_bucket";
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         granularity: "day" | "week" | "month" | "year";
     })[];
     metrics: {
         aggregation: "count" | "sum" | "avg" | "min" | "max";
-        field?: "amount" | "amountReceived" | "feePercent" | undefined;
+        field?: "amount" | "amountReceived" | "feePercent" | "escrowFeePercent" | undefined;
         alias?: string | undefined;
     }[];
     filters: {
         value: string | number | boolean | (string | number)[];
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
         operator: "eq" | "neq" | "in" | "gt" | "gte" | "lt" | "lte";
     }[];
     orderBy?: {
@@ -1692,27 +1692,27 @@ declare const MetricsQuerySchema: z.ZodEffects<z.ZodDiscriminatedUnion<"resource
     environment: "live" | "test";
     resource: "charges";
     dateRange: {
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         from: string;
         to: string;
     };
     metrics: {
         aggregation: "count" | "sum" | "avg" | "min" | "max";
-        field?: "amount" | "amountReceived" | "feePercent" | undefined;
+        field?: "amount" | "amountReceived" | "feePercent" | "escrowFeePercent" | undefined;
         alias?: string | undefined;
     }[];
     limit?: number | undefined;
     groupBy?: ({
         type: "field";
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
     } | {
         type: "date_bucket";
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         granularity: "day" | "week" | "month" | "year";
     })[] | undefined;
     filters?: {
         value: string | number | boolean | (string | number)[];
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
         operator: "eq" | "neq" | "in" | "gt" | "gte" | "lt" | "lte";
     }[] | undefined;
     orderBy?: {
@@ -1998,26 +1998,26 @@ declare const MetricsQuerySchema: z.ZodEffects<z.ZodDiscriminatedUnion<"resource
     environment: "live" | "test";
     resource: "charges";
     dateRange: {
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         from: string;
         to: string;
     };
     groupBy: ({
         type: "field";
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
     } | {
         type: "date_bucket";
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         granularity: "day" | "week" | "month" | "year";
     })[];
     metrics: {
         aggregation: "count" | "sum" | "avg" | "min" | "max";
-        field?: "amount" | "amountReceived" | "feePercent" | undefined;
+        field?: "amount" | "amountReceived" | "feePercent" | "escrowFeePercent" | undefined;
         alias?: string | undefined;
     }[];
     filters: {
         value: string | number | boolean | (string | number)[];
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
         operator: "eq" | "neq" | "in" | "gt" | "gte" | "lt" | "lte";
     }[];
     orderBy?: {
@@ -2090,27 +2090,27 @@ declare const MetricsQuerySchema: z.ZodEffects<z.ZodDiscriminatedUnion<"resource
     environment: "live" | "test";
     resource: "charges";
     dateRange: {
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         from: string;
         to: string;
     };
     metrics: {
         aggregation: "count" | "sum" | "avg" | "min" | "max";
-        field?: "amount" | "amountReceived" | "feePercent" | undefined;
+        field?: "amount" | "amountReceived" | "feePercent" | "escrowFeePercent" | undefined;
         alias?: string | undefined;
     }[];
     limit?: number | undefined;
     groupBy?: ({
         type: "field";
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
     } | {
         type: "date_bucket";
-        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt";
+        field: "createdAt" | "expiresAt" | "confirmedAt" | "lastActivityAt" | "escrowReleasedAt";
         granularity: "day" | "week" | "month" | "year";
     })[] | undefined;
     filters?: {
         value: string | number | boolean | (string | number)[];
-        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId";
+        field: "status" | "currency" | "externalRef" | "source" | "isOverpaid" | "apiKeyId" | "escrowReleaserAddress";
         operator: "eq" | "neq" | "in" | "gt" | "gte" | "lt" | "lte";
     }[] | undefined;
     orderBy?: {
@@ -2221,15 +2221,15 @@ declare const MetricsQueryResultSchema: z.ZodObject<{
 }>;
 type MetricsQueryResult = z.infer<typeof MetricsQueryResultSchema>;
 
-declare const ChargeWebhookEventTypeSchema: z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>;
+declare const ChargeWebhookEventTypeSchema: z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>;
 declare const WebhookDeliveryEventTypeSchema: z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>;
-declare const WebhookEventTypeSchema: z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>;
+declare const WebhookEventTypeSchema: z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>;
 type WebhookEventType = z.infer<typeof WebhookEventTypeSchema>;
 declare const WebhookCategorySchema: z.ZodEnum<["payments", "webhooks"]>;
 type WebhookCategory = z.infer<typeof WebhookCategorySchema>;
-declare const EVENT_CATEGORY_MAP: Record<"charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy", "payments" | "webhooks">;
+declare const EVENT_CATEGORY_MAP: Record<"charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy", "payments" | "webhooks">;
 declare const WEBHOOK_EVENT_CATEGORIES: Record<WebhookCategory, readonly WebhookEventType[]>;
-declare const TriggerableChargeEventSchema: z.ZodEnum<["charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>;
+declare const TriggerableChargeEventSchema: z.ZodEnum<["charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>;
 type TriggerableChargeEvent = z.infer<typeof TriggerableChargeEventSchema>;
 
 type WebhookHealthEventData = {
@@ -2246,6 +2246,7 @@ type WebhookEventDataMap = {
     'charge.settled': Charge;
     'charge.settlement_failed': Charge;
     'charge.overpaid': Charge;
+    'charge.escrow_released': Charge;
     'webhook.delivery_failed': WebhookHealthEventData;
     'webhook.delivery_recovered': WebhookHealthEventData;
     'webhook.endpoint_unhealthy': WebhookHealthEventData;
@@ -2262,29 +2263,29 @@ type TypedWebhookPayload = {
 declare const WEBHOOK_EVENTS_WILDCARD = "*";
 declare const CreateWebhookSchema: z.ZodEffects<z.ZodObject<{
     url: z.ZodString;
-    events: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, z.ZodLiteral<"*">]>, "many">>;
+    events: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, z.ZodLiteral<"*">]>, "many">>;
     eventCategories: z.ZodDefault<z.ZodArray<z.ZodEnum<["payments", "webhooks"]>, "many">>;
-    excludeEvents: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, "many">>;
+    excludeEvents: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     url: string;
-    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | "*")[];
+    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | "*")[];
     eventCategories: ("payments" | "webhooks")[];
-    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
+    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
 }, {
     url: string;
-    events?: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | "*")[] | undefined;
+    events?: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | "*")[] | undefined;
     eventCategories?: ("payments" | "webhooks")[] | undefined;
-    excludeEvents?: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[] | undefined;
+    excludeEvents?: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[] | undefined;
 }>, {
     url: string;
-    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | "*")[];
+    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | "*")[];
     eventCategories: ("payments" | "webhooks")[];
-    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
+    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
 }, {
     url: string;
-    events?: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | "*")[] | undefined;
+    events?: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | "*")[] | undefined;
     eventCategories?: ("payments" | "webhooks")[] | undefined;
-    excludeEvents?: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[] | undefined;
+    excludeEvents?: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[] | undefined;
 }>;
 type CreateWebhookInput = z.infer<typeof CreateWebhookSchema>;
 type CreateWebhookRequest = z.input<typeof CreateWebhookSchema>;
@@ -2292,9 +2293,9 @@ declare const WebhookSchema: z.ZodObject<{
     id: z.ZodString;
     environment: z.ZodNullable<z.ZodEnum<["live", "test"]>>;
     url: z.ZodString;
-    events: z.ZodArray<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, "many">;
+    events: z.ZodArray<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, "many">;
     eventCategories: z.ZodArray<z.ZodEnum<["payments", "webhooks"]>, "many">;
-    excludeEvents: z.ZodArray<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, "many">;
+    excludeEvents: z.ZodArray<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, "many">;
     isWildcard: z.ZodBoolean;
     secret: z.ZodString;
     createdAt: z.ZodString;
@@ -2303,9 +2304,9 @@ declare const WebhookSchema: z.ZodObject<{
     environment: "live" | "test" | null;
     createdAt: string;
     url: string;
-    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
+    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
     eventCategories: ("payments" | "webhooks")[];
-    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
+    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
     isWildcard: boolean;
     secret: string;
 }, {
@@ -2313,9 +2314,9 @@ declare const WebhookSchema: z.ZodObject<{
     environment: "live" | "test" | null;
     createdAt: string;
     url: string;
-    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
+    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
     eventCategories: ("payments" | "webhooks")[];
-    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
+    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
     isWildcard: boolean;
     secret: string;
 }>;
@@ -2324,9 +2325,9 @@ declare const WebhookListItemSchema: z.ZodObject<Omit<{
     id: z.ZodString;
     environment: z.ZodNullable<z.ZodEnum<["live", "test"]>>;
     url: z.ZodString;
-    events: z.ZodArray<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, "many">;
+    events: z.ZodArray<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, "many">;
     eventCategories: z.ZodArray<z.ZodEnum<["payments", "webhooks"]>, "many">;
-    excludeEvents: z.ZodArray<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, "many">;
+    excludeEvents: z.ZodArray<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>, "many">;
     isWildcard: z.ZodBoolean;
     secret: z.ZodString;
     createdAt: z.ZodString;
@@ -2337,9 +2338,9 @@ declare const WebhookListItemSchema: z.ZodObject<Omit<{
     environment: "live" | "test" | null;
     createdAt: string;
     url: string;
-    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
+    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
     eventCategories: ("payments" | "webhooks")[];
-    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
+    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
     isWildcard: boolean;
     hint: string;
 }, {
@@ -2347,27 +2348,27 @@ declare const WebhookListItemSchema: z.ZodObject<Omit<{
     environment: "live" | "test" | null;
     createdAt: string;
     url: string;
-    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
+    events: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
     eventCategories: ("payments" | "webhooks")[];
-    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
+    excludeEvents: ("charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy")[];
     isWildcard: boolean;
     hint: string;
 }>;
 type WebhookListItem = z.infer<typeof WebhookListItemSchema>;
 declare const WebhookPayloadSchema: z.ZodObject<{
     id: z.ZodString;
-    event: z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>;
+    event: z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>;
     createdAt: z.ZodString;
     data: z.ZodUnknown;
 }, "strip", z.ZodTypeAny, {
     id: string;
     createdAt: string;
-    event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
+    event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
     data?: unknown;
 }, {
     id: string;
     createdAt: string;
-    event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
+    event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
     data?: unknown;
 }>;
 type WebhookPayload = z.infer<typeof WebhookPayloadSchema>;
@@ -2376,7 +2377,7 @@ type WebhookDeliveryStatus = z.infer<typeof WebhookDeliveryStatusSchema>;
 declare const WebhookDeliverySchema: z.ZodObject<{
     id: z.ZodString;
     webhookId: z.ZodString;
-    event: z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>;
+    event: z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>;
     status: z.ZodEnum<["pending", "delivered", "failed"]>;
     attempts: z.ZodNumber;
     responseCode: z.ZodNullable<z.ZodNumber>;
@@ -2388,7 +2389,7 @@ declare const WebhookDeliverySchema: z.ZodObject<{
     id: string;
     createdAt: string;
     attempts: number;
-    event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
+    event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
     webhookId: string;
     responseCode: number | null;
     nextRetryAt: string | null;
@@ -2398,7 +2399,7 @@ declare const WebhookDeliverySchema: z.ZodObject<{
     id: string;
     createdAt: string;
     attempts: number;
-    event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
+    event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
     webhookId: string;
     responseCode: number | null;
     nextRetryAt: string | null;
@@ -2421,7 +2422,7 @@ declare const PaginatedWebhookDeliveriesSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         webhookId: z.ZodString;
-        event: z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>;
+        event: z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>;
         status: z.ZodEnum<["pending", "delivered", "failed"]>;
         attempts: z.ZodNumber;
         responseCode: z.ZodNullable<z.ZodNumber>;
@@ -2433,7 +2434,7 @@ declare const PaginatedWebhookDeliveriesSchema: z.ZodObject<{
         id: string;
         createdAt: string;
         attempts: number;
-        event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
+        event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
         webhookId: string;
         responseCode: number | null;
         nextRetryAt: string | null;
@@ -2443,7 +2444,7 @@ declare const PaginatedWebhookDeliveriesSchema: z.ZodObject<{
         id: string;
         createdAt: string;
         attempts: number;
-        event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
+        event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
         webhookId: string;
         responseCode: number | null;
         nextRetryAt: string | null;
@@ -2457,7 +2458,7 @@ declare const PaginatedWebhookDeliveriesSchema: z.ZodObject<{
         id: string;
         createdAt: string;
         attempts: number;
-        event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
+        event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
         webhookId: string;
         responseCode: number | null;
         nextRetryAt: string | null;
@@ -2471,7 +2472,7 @@ declare const PaginatedWebhookDeliveriesSchema: z.ZodObject<{
         id: string;
         createdAt: string;
         attempts: number;
-        event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
+        event: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy";
         webhookId: string;
         responseCode: number | null;
         nextRetryAt: string | null;
@@ -2539,7 +2540,7 @@ declare const TimelineEventSchema: z.ZodObject<{
     token: z.ZodOptional<z.ZodEnum<["USDC", "USDT"]>>;
     network: z.ZodOptional<z.ZodEnum<["base", "optimism", "polygon", "ethereum", "arbitrum", "avalanche", "bnb"]>>;
     causedTransition: z.ZodOptional<z.ZodBoolean>;
-    event: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>>;
+    event: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["charge.created", "charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>, z.ZodEnum<["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]>]>>;
     responseCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     attempts: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
@@ -2552,7 +2553,7 @@ declare const TimelineEventSchema: z.ZodObject<{
     txHash?: string | undefined;
     causedTransition?: boolean | undefined;
     attempts?: number | undefined;
-    event?: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | undefined;
+    event?: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | undefined;
     responseCode?: number | null | undefined;
 }, {
     type: "charge.created" | "charge.expired" | "transaction.detected" | "split.distributed" | "webhook.dispatched" | "webhook.delivered" | "webhook.failed";
@@ -2564,7 +2565,7 @@ declare const TimelineEventSchema: z.ZodObject<{
     txHash?: string | undefined;
     causedTransition?: boolean | undefined;
     attempts?: number | undefined;
-    event?: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | undefined;
+    event?: "charge.created" | "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released" | "webhook.delivery_failed" | "webhook.delivery_recovered" | "webhook.endpoint_unhealthy" | undefined;
     responseCode?: number | null | undefined;
 }>;
 type TimelineEvent = z.infer<typeof TimelineEventSchema>;
@@ -2597,13 +2598,13 @@ declare const HealthSchema: z.ZodObject<{
 type Health = z.infer<typeof HealthSchema>;
 
 declare const SandboxTriggerSchema: z.ZodObject<{
-    event: z.ZodEnum<["charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid"]>;
+    event: z.ZodEnum<["charge.partially_paid", "charge.confirmed", "charge.expired", "charge.underpaid", "charge.settled", "charge.settlement_failed", "charge.overpaid", "charge.escrow_released"]>;
     amount: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    event: "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid";
+    event: "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released";
     amount?: number | undefined;
 }, {
-    event: "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid";
+    event: "charge.partially_paid" | "charge.confirmed" | "charge.expired" | "charge.underpaid" | "charge.settled" | "charge.settlement_failed" | "charge.overpaid" | "charge.escrow_released";
     amount?: number | undefined;
 }>;
 type SandboxTriggerInput = z.infer<typeof SandboxTriggerSchema>;

package/dist/index.js

@@ -366,7 +366,7 @@ var EscrowConfigSchema = import_zod9.z.object({
 });
 var ReleaseEscrowRequestSchema = import_zod9.z.object({
   signature: import_zod9.z.string().regex(/^0x[0-9a-fA-F]+$/, "must be hex-encoded signature bytes").describe(
-    "The Safe transaction signature authorizing this release, produced by signing the escrow's predetermined release transaction (destination and amount are fixed at escrow creation, never client-supplied here) with the private key behind this charge's `escrowReleaserAddress` \u2014 never anything Klappay can produce itself. Independently verified on-chain before anything moves; a mismatched, malformed, or missing signature is rejected, never trusted at face value."
+    "The Safe transaction signature authorizing this release, produced by signing a transfer of the escrow's entire current token balance to the charge's already-frozen split address (the same split that would have received the payment on a normal, non-escrow charge) with the private key behind this charge's `escrowReleaserAddress` \u2014 never anything Klappay can produce itself. The destination is fixed by the charge's `splitConfig` (frozen at creation); the amount is read live on-chain at release time, not fixed in advance, so it always matches whatever actually arrived \u2014 reconstruct the exact transaction server-side computes (ERC-20 `transfer(splitAddress, balance)` from the escrow Safe, nonce 0) before signing. Independently verified on-chain before anything moves \u2014 the Safe contract itself rejects a signature that isn't from `escrowReleaserAddress`, never trusted at face value by Klappay."
   )
 });
 
@@ -655,14 +655,22 @@ var orderBySchema = import_zod13.z.object({
 var limitSchema = import_zod13.z.number().int().min(1).max(METRICS_QUERY_MAX_ROW_LIMIT).default(METRICS_QUERY_DEFAULT_ROW_LIMIT).describe(
   `Max rows to return, ${1}\u2013${METRICS_QUERY_MAX_ROW_LIMIT}, default ${METRICS_QUERY_DEFAULT_ROW_LIMIT}. If more rows matched, \`meta.truncated\` is \`true\` on the response \u2014 narrow the query instead of just raising this.`
 );
-var ChargesQueryFieldSchema = import_zod13.z.enum(["status", "source", "apiKeyId", "currency", "isOverpaid", "externalRef"]).describe(
-  "A `Charge` field to filter or group by \u2014 see `ChargeStatusSchema` for `status`'s own possible values (charges.md). `source`/`externalRef` are free-form strings your own integration set at creation, not a fixed enum."
+var ChargesQueryFieldSchema = import_zod13.z.enum([
+  "status",
+  "source",
+  "apiKeyId",
+  "currency",
+  "isOverpaid",
+  "externalRef",
+  "escrowReleaserAddress"
+]).describe(
+  "A `Charge` field to filter or group by \u2014 see `ChargeStatusSchema` for `status`'s own possible values (charges.md). `source`/`externalRef` are free-form strings your own integration set at creation, not a fixed enum. `escrowReleaserAddress` is `null` for a normal charge \u2014 filter `escrowReleaserAddress` with operator `neq`/value `null` to isolate escrow-configured charges (see `escrow` in charges.md)."
 );
-var ChargesMetricFieldSchema = import_zod13.z.enum(["amount", "amountReceived", "feePercent"]).describe(
-  "A `Charge` numeric field to aggregate. `amount`/`amountReceived` are decimal currency amounts (requested vs. actually received \u2014 see `charges.md`). `feePercent` is the platform fee frozen on the charge at creation, e.g. `1.5` means 1.5%."
+var ChargesMetricFieldSchema = import_zod13.z.enum(["amount", "amountReceived", "feePercent", "escrowFeePercent"]).describe(
+  "A `Charge` numeric field to aggregate. `amount`/`amountReceived` are decimal currency amounts (requested vs. actually received \u2014 see `charges.md`). `feePercent` is the platform fee frozen on the charge at creation, e.g. `1.5` means 1.5%. `escrowFeePercent` is the additional escrow-specific fee component, only present on escrow-configured charges \u2014 see `docs/payments.md`."
 );
-var ChargesDateFieldSchema = import_zod13.z.enum(["createdAt", "confirmedAt", "lastActivityAt", "expiresAt"]).describe(
-  "A `Charge` timestamp to filter/bucket by. `confirmedAt` is `null` until the charge reaches `confirmed` \u2014 a `dateRange`/`date_bucket` on it implicitly excludes every charge that never confirmed. `expiresAt` is always present (set at creation), useful for e.g. finding charges expiring soon or measuring how close to expiry charges typically resolve."
+var ChargesDateFieldSchema = import_zod13.z.enum(["createdAt", "confirmedAt", "lastActivityAt", "expiresAt", "escrowReleasedAt"]).describe(
+  "A `Charge` timestamp to filter/bucket by. `confirmedAt` is `null` until the charge reaches `confirmed` \u2014 a `dateRange`/`date_bucket` on it implicitly excludes every charge that never confirmed. `expiresAt` is always present (set at creation), useful for e.g. finding charges expiring soon or measuring how close to expiry charges typically resolve. `escrowReleasedAt` is `null` until an escrow-configured charge is actually released \u2014 same implicit-exclusion behavior as `confirmedAt`, scoped to escrow charges only."
 );
 var ChargesFilterSchema = import_zod13.z.object({
   field: ChargesQueryFieldSchema,
@@ -859,9 +867,10 @@ var ChargeWebhookEventTypeSchema = import_zod14.z.enum([
   "charge.underpaid",
   "charge.settled",
   "charge.settlement_failed",
-  "charge.overpaid"
+  "charge.overpaid",
+  "charge.escrow_released"
 ]).describe(
-  'Note the distinction between `charge.confirmed` and `charge.settled`: `confirmed` means the payment was detected on-chain; `settled` means the merchant\'s wallet actually received the funds \u2014 a separate, later step. Subscribe to `confirmed` if you only need "will I get paid," or `settled` if you need "has the money actually arrived." `charge.overpaid` fires alongside `charge.confirmed`/`charge.partially_paid` whenever the cumulative amount received ends up above `amount` (see `Charge.isOverpaid`). Every event in this category carries the full `Charge` object as `data`.'
+  'Note the distinction between `charge.confirmed` and `charge.settled`: `confirmed` means the payment was detected on-chain; `settled` means the merchant\'s wallet actually received the funds \u2014 a separate, later step. Subscribe to `confirmed` if you only need "will I get paid," or `settled` if you need "has the money actually arrived." `charge.overpaid` fires alongside `charge.confirmed`/`charge.partially_paid` whenever the cumulative amount received ends up above `amount` (see `Charge.isOverpaid`). `charge.escrow_released` fires once an escrow-configured charge\'s funds have been moved out of its Safe to the split address by `POST /v1/charges/{id}/release` \u2014 a normal `charge.settled` still follows once the split itself finishes distributing. Every event in this category carries the full `Charge` object as `data`.'
 );
 var WebhookDeliveryEventTypeSchema = import_zod14.z.enum(["webhook.delivery_failed", "webhook.delivery_recovered", "webhook.endpoint_unhealthy"]).describe(
   "Meta-events about the health of your own webhook endpoints \u2014 useful for monitoring without polling `GET /v1/webhooks/{id}/deliveries`. `webhook.endpoint_unhealthy` fires once when a webhook's failure rate over the trailing 24h crosses 20%, and `webhook.delivery_recovered` fires once when a delivery to that webhook next succeeds. `data` for every event in this category: `{ webhookId, url, failureRatio? }` (`failureRatio` only present on `webhook.endpoint_unhealthy`)."