@waffo/pancake-ts 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to `@waffo/pancake-ts` will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.0] - 2026-05-11
+
+### Changed
+
+- **`AddWebhookParams.events` / `UpdateWebhookParams.events` / `StoreWebhook.events`** typed as `` `${WebhookEventType}`[] `` instead of `string[]`. Editors now autocomplete the 10 enum values and flag typos at compile time. Runtime behavior unchanged — server still accepts string literals.
+- **README webhook examples** use `WebhookEventType.OrderCompleted` enum form instead of raw string literals.
+
+### Added
+
+- **`GraphQLResponse.warnings?[]`** — soft warning envelope emitted when query cost approaches the hard limit (graphql-service `v2026.5.11.3`). Each warning carries `message`, `layer`, and `aiHint` (e.g. `REDUCE_QUERY_SIZE`). Server still returns HTTP 200; the next slightly-larger query may be rejected with 400.
+- **`GraphQLResponse.errors[].aiHint?`** — actionable agent hint on error items (e.g. `REDUCE_QUERY_SIZE` when query cost exceeds the hard limit).
+
+### Migration
+
+- TypeScript compile errors in webhook event arrays — import `WebhookEventType` and use enum values (or string literals matching the enum) instead of arbitrary strings. Runtime payload unchanged.
+- Client logic reading webhook errors / warnings can now surface `aiHint` to operators or feed it back to LLM agents for self-correction.
+
 ## [0.6.0] - 2026-05-07
 
 ### BREAKING

package/README.md

@@ -341,12 +341,14 @@ const { store: deleted } = await client.stores.delete({ id: store.id });
 Manage webhook endpoints across HTTP, Feishu, Discord, Telegram, and Slack. Each store can have up to 20 webhooks across all channels.
 
 ```typescript
+import { WebhookEventType } from "@waffo/pancake-ts";
+
 // Add a standard HTTPS webhook (RSA-signed envelope)
 const { webhook } = await client.webhooks.add({
   storeId: store.id,
   channel: "http",
   url: "https://example.com/webhooks/pancake",
-  events: ["order.completed", "refund.succeeded"],
+  events: [WebhookEventType.OrderCompleted, WebhookEventType.RefundSucceeded],
   testMode: false,
 });
 
@@ -355,7 +357,7 @@ await client.webhooks.add({
   storeId: store.id,
   channel: "discord",
   url: "https://discord.com/api/webhooks/123/abc",
-  events: ["order.completed"],
+  events: [WebhookEventType.OrderCompleted],
   testMode: false,
 });
 
@@ -364,7 +366,7 @@ await client.webhooks.add({
   storeId: store.id,
   channel: "telegram",
   url: "https://api.telegram.org/bot123:ABC/sendMessage",
-  events: ["order.completed"],
+  events: [WebhookEventType.OrderCompleted],
   testMode: false,
   secret: "8737101383",
 });
@@ -372,7 +374,7 @@ await client.webhooks.add({
 // Update events
 await client.webhooks.update({
   id: webhook.id,
-  events: ["order.completed", "refund.succeeded", "subscription.canceled"],
+  events: [WebhookEventType.OrderCompleted, WebhookEventType.RefundSucceeded, WebhookEventType.SubscriptionCanceled],
 });
 
 // Hard-delete a webhook (delivery history retained for audit)