@tailor-platform/sdk 1.20.0 → 1.21.0

package/dist/utils/test/index.d.mts

@@ -1,7 +1,7 @@
 /// <reference path="./../../user-defined.d.ts" />
-import { Ot as TailorField, s as TailorDBType } from "../../types-CNw4p8V7.mjs";
-import "../../types-C14GuyPI.mjs";
-import { G as WORKFLOW_TEST_USER_KEY, W as WORKFLOW_TEST_ENV_KEY, n as output } from "../../index-DcY0e3S5.mjs";
+import { Ot as TailorField, s as TailorDBType } from "../../types-QKq1usl7.mjs";
+import "../../types-C0o90Cmb.mjs";
+import { G as WORKFLOW_TEST_USER_KEY, W as WORKFLOW_TEST_ENV_KEY, n as output } from "../../index-CnHd6BNg.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/utils/test/index.d.ts

package/docs/services/resolver.md

@@ -214,3 +214,64 @@ createResolver({
   // ...
 });
 ```
+
+## Event Publishing
+
+Enable event publishing for a resolver to trigger executors on resolver execution:
+
+```typescript
+createResolver({
+  name: "processOrder",
+  operation: "mutation",
+  publishEvents: true,
+  // ...
+});
+```
+
+**Behavior:**
+
+- When `publishEvents: true`, resolver execution events are published
+- When not specified, it is **automatically set to `true`** if an executor uses this resolver with `resolverExecutedTrigger`
+- When explicitly set to `false` while an executor uses this resolver, an error is thrown during `tailor apply`
+
+**Use cases:**
+
+1. **Auto-detection (recommended)**: Don't set `publishEvents` - the SDK automatically enables it when needed by executors
+
+   ```typescript
+   // publishEvents is automatically enabled because an executor uses this resolver
+   export default createResolver({
+     name: "processPayment",
+     operation: "mutation",
+     // publishEvents not set - auto-detected
+     // ...
+   });
+
+   // In executor file:
+   export default createExecutor({
+     trigger: resolverExecutedTrigger("processPayment"),
+     // ...
+   });
+   ```
+
+2. **Manual enable**: Enable event publishing for external consumers or debugging
+
+   ```typescript
+   createResolver({
+     name: "auditAction",
+     operation: "mutation",
+     publishEvents: true, // Enable even without executor triggers
+     // ...
+   });
+   ```
+
+3. **Explicit disable**: Disable event publishing for a resolver that doesn't need it (error if executor uses it)
+
+   ```typescript
+   createResolver({
+     name: "internalHelper",
+     operation: "query",
+     publishEvents: false, // Explicitly disable
+     // ...
+   });
+   ```

package/docs/services/tailordb.md

@@ -394,6 +394,61 @@ db.type("User", {
 });
 ```
 
+#### Event Publishing
+
+Enable event publishing for a type to trigger executors on record changes:
+
+```typescript
+db.type("User", {
+  name: db.string(),
+}).features({
+  publishEvents: true,
+});
+```
+
+**Behavior:**
+
+- When `publishEvents: true`, record creation/update/deletion events are published
+- When not specified, it is **automatically set to `true`** if an executor uses this type with `recordCreatedTrigger`, `recordUpdatedTrigger`, or `recordDeletedTrigger`
+- When explicitly set to `false` while an executor uses this type, an error is thrown during `tailor apply`
+
+**Use cases:**
+
+1. **Auto-detection (recommended)**: Don't set `publishEvents` - the SDK automatically enables it when needed by executors
+
+   ```typescript
+   // publishEvents is automatically enabled because an executor uses this type
+   export const order = db.type("Order", {
+     status: db.string(),
+   });
+
+   // In executor file:
+   export default createExecutor({
+     trigger: recordCreatedTrigger(order),
+     // ...
+   });
+   ```
+
+2. **Manual enable**: Enable event publishing for external consumers or debugging
+
+   ```typescript
+   db.type("AuditLog", {
+     action: db.string(),
+   }).features({
+     publishEvents: true, // Enable even without executor triggers
+   });
+   ```
+
+3. **Explicit disable**: Disable event publishing for a type that doesn't need it (error if executor uses it)
+
+   ```typescript
+   db.type("TempData", {
+     data: db.string(),
+   }).features({
+     publishEvents: false, // Explicitly disable
+   });
+   ```
+
 ### Permissions
 
 Configure Permission and GQLPermission. For details, see the [TailorDB Permission documentation](https://docs.tailor.tech/guides/tailordb/permission).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/sdk",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "Tailor Platform SDK - The SDK to work with Tailor Platform",
   "license": "MIT",
   "repository": {