@trigora/sdk 0.8.0 → 0.9.0

package/README.md

@@ -123,23 +123,28 @@ export default defineFlow({
 
 Use queue triggers to consume workspace-scoped queue messages. Deploy auto-provisions and binds the named queue to the flow.
 
+Optional `retry` configures how many times a failed message may be redelivered. Omitted `retry` means a single attempt. `attempts > 1` is supported for queue flows only.
+
 ```ts
 import { defineFlow } from '@trigora/sdk';
 
 export default defineFlow({
   id: 'process-image',
   trigger: { type: 'queue', queue: 'image-processing' },
+  retry: { attempts: 5, backoff: 'exponential' },
   async run(event, ctx) {
     await ctx.log.info('Processing message', {
       queue: event.queue,
       messageId: event.messageId,
+      attempt: event.attempt,
+      maxAttempts: event.maxAttempts,
       payload: event.payload,
     });
   },
 });
 ```
 
-Locally, `trigora trigger` and `trigora dev` invoke queue flows with a synthetic `QueueFlowEvent` (`messageId` starts with `local_`). Hosted runs use the real message id.
+Locally, `trigora trigger` and `trigora dev` invoke queue flows with a synthetic `QueueFlowEvent` (`messageId` starts with `local_`, `attempt` is `1`, and `maxAttempts` comes from `retry.attempts` or `1`). Local runs do not actually retry. Hosted runs use the real message id and attempt count.
 
 ## Return Types
 
@@ -204,6 +209,15 @@ type FlowEvent<TPayload = JsonValue> = {
 };
 ```
 
+Queue events also include:
+
+```ts
+queue: string;
+messageId: string;
+attempt: number;      // 1-based delivery count
+maxAttempts: number;  // from retry.attempts, or 1 when omitted
+```
+
 In local manual runs, the payload comes from your JSON payload file when one is provided. In local webhook dev and deployed webhook flows, the payload is the parsed JSON request body.
 
 If you do not provide your own payload type, `event.payload` defaults to `JsonValue`.
@@ -283,6 +297,7 @@ The exact exported type is `FlowContext<TEnv>`.
 - `FlowEvent`
 - `FlowRunFn`
 - `JsonValue`
+- `RetryPolicy`
 - `Trigger`
 - `WebhookFlowResult`
 

package/dist/defineFlow.d.ts

@@ -1,7 +1,12 @@
-import type { CronEventPayload, CronFlowDefinition, FlowDefinition, FlowRunFn, JsonValue, ManualFlowDefinition, ManualTrigger, QueueFlowDefinition, QueueTrigger, Trigger, WebhookTrigger, WebhookFlowDefinition, CronTrigger } from '@trigora/contracts';
+import type { CronEventPayload, CronFlowDefinition, FlowDefinition, FlowRunFn, JsonValue, ManualFlowDefinition, ManualTrigger, QueueFlowDefinition, QueueTrigger, RetryPolicy, Trigger, WebhookTrigger, WebhookFlowDefinition, CronTrigger } from '@trigora/contracts';
 type DefineFlowInput<TPayload, TEnv extends Record<string, string>, TTrigger extends Trigger> = {
     id: string;
     trigger: TTrigger;
+    /**
+     * Optional retry policy. Omitted means a single attempt.
+     * `attempts > 1` is supported for queue flows only (enforced at deploy time).
+     */
+    retry?: RetryPolicy;
     run: TTrigger extends ManualTrigger ? FlowRunFn<TPayload, TEnv, ManualTrigger> : TTrigger extends WebhookTrigger ? FlowRunFn<TPayload, TEnv, WebhookTrigger> : TTrigger extends CronTrigger ? FlowRunFn<CronEventPayload, TEnv, CronTrigger> : TTrigger extends QueueTrigger ? FlowRunFn<TPayload, TEnv, QueueTrigger> : never;
 };
 type DefineFlowOutput<TPayload, TEnv extends Record<string, string>, TTrigger extends Trigger> = TTrigger extends ManualTrigger ? ManualFlowDefinition<TPayload, TEnv> : TTrigger extends WebhookTrigger ? WebhookFlowDefinition<TPayload, TEnv> : TTrigger extends CronTrigger ? CronFlowDefinition<TEnv> : TTrigger extends QueueTrigger ? QueueFlowDefinition<TPayload, TEnv> : FlowDefinition<TPayload, TEnv, TTrigger>;
@@ -12,6 +17,7 @@ type DefineFlowOutput<TPayload, TEnv extends Record<string, string>, TTrigger ex
  * - `id`: the internal identifier for the flow in your project
  * - `trigger`: how the flow is invoked
  * - `run`: the function that executes when the flow is triggered
+ * - `retry`: optional retry policy (queue flows may use `attempts > 1`)
  *
  * `run` receives the incoming `event` and a `ctx` object with logging and environment access.
  *

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 export { defineFlow } from './defineFlow';
-export type { CronEventPayload, CronFlowEvent, FlowContext, FlowDefinition, FlowEvent, FlowRunFn, JsonValue, ManualFlowEvent, QueueFlowEvent, Trigger, WebhookFlowEvent, WebhookFlowResult, } from '@trigora/contracts';
+export type { CronEventPayload, CronFlowEvent, FlowContext, FlowDefinition, FlowEvent, FlowRunFn, JsonValue, ManualFlowEvent, QueueFlowEvent, RetryBackoff, RetryPolicy, Trigger, WebhookFlowEvent, WebhookFlowResult, } from '@trigora/contracts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trigora/sdk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/trigora-dev/trigora"
@@ -46,7 +46,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@trigora/contracts": "0.8.1"
+    "@trigora/contracts": "^0.9.0"
   },
   "devDependencies": {
     "tsup": "^8.5.1"