@klappay/types 3.4.0 → 3.5.0

package/dist/index.d.ts

@@ -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."
   )
 });
 
@@ -867,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`)."