@qlever-llc/trellis 0.10.17 → 0.19.0-rc.1

package/src/sdk/_generated/core/api.ts

@@ -1,12 +1,15 @@
 // Generated from ./generated/contracts/manifests/trellis.core@v1.json
 import { OWNED_API } from "./owned_api.js";
+import { OWNED_API as HealthApi } from "../health/mod.js";
 
 export { OWNED_API };
 
 export type UsedApi = {
   rpc: {};
   operations: {};
-  events: {};
+  events: {
+    readonly "Health.Heartbeat": typeof HealthApi.events["Health.Heartbeat"];
+  };
   feeds: {};
   subjects: {};
 };
@@ -14,7 +17,11 @@ export type UsedApi = {
 export const USED_API: UsedApi = {
   rpc: {},
   operations: {},
-  events: {},
+  events: {
+    get "Health.Heartbeat"() {
+      return HealthApi.events["Health.Heartbeat"];
+    },
+  },
   feeds: {},
   subjects: {},
 };

package/src/sdk/_generated/core/client.ts

@@ -33,6 +33,7 @@ import type {
 } from "../../../index.js";
 import type { API, Api } from "./api.js";
 import type * as Types from "./types.js";
+import type * as HealthSdk from "../health/mod.js";
 
 type WithDeps<TDeps> = [TDeps] extends [undefined] ? {} : { deps: TDeps };
 
@@ -110,7 +111,26 @@ export interface TrellisCoreClient {
       ): AsyncResult<Types.TrellisSurfaceStatusOutput, BaseError>;
     };
   };
-  readonly event: {};
+  readonly event: {
+    readonly health: {
+      heartbeat: {
+        publish(
+          event: HealthSdk.HealthHeartbeatEvent,
+        ): AsyncResult<void, ValidationError | UnexpectedError>;
+        prepare(
+          event: HealthSdk.HealthHeartbeatEvent,
+        ): Result<
+          PreparedTrellisEvent<HealthSdk.HealthHeartbeatEvent>,
+          ValidationError | UnexpectedError
+        >;
+        listen(
+          handler: EventCallback<HealthSdk.HealthHeartbeatEvent>,
+          subjectData?: Record<string, unknown>,
+          opts?: EventOpts,
+        ): AsyncResult<void, ValidationError | UnexpectedError>;
+      };
+    };
+  };
   readonly feed: {};
   readonly operation: {};
   wait(): AsyncResult<void, BaseError>;
@@ -127,7 +147,26 @@ export type ServiceWithDeps<TDeps> = Omit<TrellisCoreClient, "event"> & {
   with<TNextDeps>(deps: TNextDeps): ServiceWithDeps<TNextDeps>;
 };
 
-export type ServiceEventSurface<TDeps> = {};
+export interface ServiceEventSurface<TDeps> {
+  readonly health: {
+    heartbeat: {
+      publish(
+        event: HealthSdk.HealthHeartbeatEvent,
+      ): AsyncResult<void, ValidationError | UnexpectedError>;
+      prepare(
+        event: HealthSdk.HealthHeartbeatEvent,
+      ): Result<
+        PreparedTrellisEvent<HealthSdk.HealthHeartbeatEvent>,
+        ValidationError | UnexpectedError
+      >;
+      listen(
+        handler: ServiceEventHandler<HealthSdk.HealthHeartbeatEvent, TDeps>,
+        subjectData?: Record<string, unknown>,
+        opts?: EventOpts,
+      ): AsyncResult<void, ValidationError | UnexpectedError>;
+    };
+  };
+}
 
 export interface ServiceHandle<TDeps = undefined> {
   readonly rpc: {

package/src/sdk/_generated/core/contract.ts

@@ -13,7 +13,7 @@ const CONTRACT_MODULE_METADATA = Symbol.for(
 
 export const CONTRACT_ID = "trellis.core@v1" as const;
 export const CONTRACT_DIGEST =
-  "L4HW6uUIxDhK1Kpa_PUxpumoMberMgiCgJTNN5Qvje0" as const;
+  "1vbZgyhBkgKDSkzqvkwItxObBfaLNdysxFBeTT-Ng2c" as const;
 export const CONTRACT = {
   "capabilities": {
     "trellis.core::catalog.read": {
@@ -170,6 +170,41 @@ export const CONTRACT = {
                               "type": "integer",
                             },
                             "dlq": { "type": "boolean" },
+                            "keyConcurrency": {
+                              "properties": {
+                                "heartbeatIntervalMs": {
+                                  "minimum": 1,
+                                  "type": "integer",
+                                },
+                                "heartbeatTtlMs": {
+                                  "minimum": 1,
+                                  "type": "integer",
+                                },
+                                "key": {
+                                  "items": { "minLength": 1, "type": "string" },
+                                  "minItems": 1,
+                                  "type": "array",
+                                },
+                                "maxActive": {
+                                  "minimum": 1,
+                                  "type": "integer",
+                                },
+                                "stalePolicy": {
+                                  "anyOf": [{
+                                    "const": "fail-stale",
+                                    "type": "string",
+                                  }, { "const": "block", "type": "string" }],
+                                },
+                              },
+                              "required": [
+                                "key",
+                                "maxActive",
+                                "heartbeatIntervalMs",
+                                "heartbeatTtlMs",
+                                "stalePolicy",
+                              ],
+                              "type": "object",
+                            },
                             "logs": { "type": "boolean" },
                             "maxDeliver": { "minimum": 1, "type": "integer" },
                             "payload": {
@@ -184,6 +219,26 @@ export const CONTRACT = {
                               "minLength": 1,
                               "type": "string",
                             },
+                            "queue": {
+                              "properties": {
+                                "maxQueuedPerKey": {
+                                  "minimum": 0,
+                                  "type": "integer",
+                                },
+                                "whenFull": {
+                                  "anyOf": [
+                                    { "const": "reject", "type": "string" },
+                                    { "const": "coalesce", "type": "string" },
+                                    {
+                                      "const": "replace-oldest",
+                                      "type": "string",
+                                    },
+                                  ],
+                                },
+                              },
+                              "required": ["maxQueuedPerKey", "whenFull"],
+                              "type": "object",
+                            },
                             "queueType": { "minLength": 1, "type": "string" },
                             "result": {
                               "properties": {
@@ -478,6 +533,29 @@ export const CONTRACT = {
                       "required": ["markdown"],
                       "type": "object",
                     },
+                    "keyConcurrency": {
+                      "properties": {
+                        "heartbeatIntervalMs": {
+                          "minimum": 1,
+                          "type": "integer",
+                        },
+                        "heartbeatTtlMs": { "minimum": 1, "type": "integer" },
+                        "key": {
+                          "items": { "minLength": 1, "type": "string" },
+                          "minItems": 1,
+                          "type": "array",
+                        },
+                        "maxActive": { "minimum": 1, "type": "integer" },
+                        "stalePolicy": {
+                          "anyOf": [
+                            { "const": "fail-stale", "type": "string" },
+                            { "const": "block", "type": "string" },
+                          ],
+                        },
+                      },
+                      "required": ["key"],
+                      "type": "object",
+                    },
                     "logs": { "type": "boolean" },
                     "maxDeliver": { "minimum": 1, "type": "integer" },
                     "payload": {
@@ -488,6 +566,18 @@ export const CONTRACT = {
                       "type": "object",
                     },
                     "progress": { "type": "boolean" },
+                    "queue": {
+                      "properties": {
+                        "maxQueuedPerKey": { "minimum": 0, "type": "integer" },
+                        "whenFull": {
+                          "anyOf": [{ "const": "reject", "type": "string" }, {
+                            "const": "coalesce",
+                            "type": "string",
+                          }, { "const": "replace-oldest", "type": "string" }],
+                        },
+                      },
+                      "type": "object",
+                    },
                     "result": {
                       "properties": {
                         "schema": { "minLength": 1, "type": "string" },

package/src/sdk/_generated/core/schemas.ts

@@ -75,6 +75,38 @@ export const TrellisBindingsGetResponseSchema = {
                           "type": "integer",
                         },
                         "dlq": { "type": "boolean" },
+                        "keyConcurrency": {
+                          "properties": {
+                            "heartbeatIntervalMs": {
+                              "minimum": 1,
+                              "type": "integer",
+                            },
+                            "heartbeatTtlMs": {
+                              "minimum": 1,
+                              "type": "integer",
+                            },
+                            "key": {
+                              "items": { "minLength": 1, "type": "string" },
+                              "minItems": 1,
+                              "type": "array",
+                            },
+                            "maxActive": { "minimum": 1, "type": "integer" },
+                            "stalePolicy": {
+                              "anyOf": [{
+                                "const": "fail-stale",
+                                "type": "string",
+                              }, { "const": "block", "type": "string" }],
+                            },
+                          },
+                          "required": [
+                            "key",
+                            "maxActive",
+                            "heartbeatIntervalMs",
+                            "heartbeatTtlMs",
+                            "stalePolicy",
+                          ],
+                          "type": "object",
+                        },
                         "logs": { "type": "boolean" },
                         "maxDeliver": { "minimum": 1, "type": "integer" },
                         "payload": {
@@ -86,6 +118,23 @@ export const TrellisBindingsGetResponseSchema = {
                         },
                         "progress": { "type": "boolean" },
                         "publishPrefix": { "minLength": 1, "type": "string" },
+                        "queue": {
+                          "properties": {
+                            "maxQueuedPerKey": {
+                              "minimum": 0,
+                              "type": "integer",
+                            },
+                            "whenFull": {
+                              "anyOf": [
+                                { "const": "reject", "type": "string" },
+                                { "const": "coalesce", "type": "string" },
+                                { "const": "replace-oldest", "type": "string" },
+                              ],
+                            },
+                          },
+                          "required": ["maxQueuedPerKey", "whenFull"],
+                          "type": "object",
+                        },
                         "queueType": { "minLength": 1, "type": "string" },
                         "result": {
                           "properties": {
@@ -381,6 +430,26 @@ export const TrellisContractGetResponseSchema = {
                   "required": ["markdown"],
                   "type": "object",
                 },
+                "keyConcurrency": {
+                  "properties": {
+                    "heartbeatIntervalMs": { "minimum": 1, "type": "integer" },
+                    "heartbeatTtlMs": { "minimum": 1, "type": "integer" },
+                    "key": {
+                      "items": { "minLength": 1, "type": "string" },
+                      "minItems": 1,
+                      "type": "array",
+                    },
+                    "maxActive": { "minimum": 1, "type": "integer" },
+                    "stalePolicy": {
+                      "anyOf": [{ "const": "fail-stale", "type": "string" }, {
+                        "const": "block",
+                        "type": "string",
+                      }],
+                    },
+                  },
+                  "required": ["key"],
+                  "type": "object",
+                },
                 "logs": { "type": "boolean" },
                 "maxDeliver": { "minimum": 1, "type": "integer" },
                 "payload": {
@@ -391,6 +460,18 @@ export const TrellisContractGetResponseSchema = {
                   "type": "object",
                 },
                 "progress": { "type": "boolean" },
+                "queue": {
+                  "properties": {
+                    "maxQueuedPerKey": { "minimum": 0, "type": "integer" },
+                    "whenFull": {
+                      "anyOf": [{ "const": "reject", "type": "string" }, {
+                        "const": "coalesce",
+                        "type": "string",
+                      }, { "const": "replace-oldest", "type": "string" }],
+                    },
+                  },
+                  "type": "object",
+                },
                 "result": {
                   "properties": {
                     "schema": { "minLength": 1, "type": "string" },

package/src/sdk/_generated/core/types.ts

@@ -4,7 +4,7 @@ import type { API } from "./api.js";
 
 export const CONTRACT_ID = "trellis.core@v1" as const;
 export const CONTRACT_DIGEST =
-  "L4HW6uUIxDhK1Kpa_PUxpumoMberMgiCgJTNN5Qvje0" as const;
+  "1vbZgyhBkgKDSkzqvkwItxObBfaLNdysxFBeTT-Ng2c" as const;
 
 export type TrellisBindingsGetInput = { contractId?: string; digest?: string };
 export type TrellisBindingsGetOutput = {
@@ -35,11 +35,22 @@ export type TrellisBindingsGetOutput = {
             consumerName: string;
             defaultDeadlineMs?: number;
             dlq: boolean;
+            keyConcurrency?: {
+              heartbeatIntervalMs: number;
+              heartbeatTtlMs: number;
+              key: Array<string>;
+              maxActive: number;
+              stalePolicy: "fail-stale" | "block";
+            };
             logs: boolean;
             maxDeliver: number;
             payload: { schema: string };
             progress: boolean;
             publishPrefix: string;
+            queue?: {
+              maxQueuedPerKey: number;
+              whenFull: "reject" | "coalesce" | "replace-oldest";
+            };
             queueType: string;
             result?: { schema: string };
             workSubject: string;
@@ -138,10 +149,21 @@ export type TrellisContractGetOutput = {
         defaultDeadlineMs?: number;
         dlq?: boolean;
         docs?: { markdown: string; summary?: string };
+        keyConcurrency?: {
+          heartbeatIntervalMs?: number;
+          heartbeatTtlMs?: number;
+          key: Array<string>;
+          maxActive?: number;
+          stalePolicy?: "fail-stale" | "block";
+        };
         logs?: boolean;
         maxDeliver?: number;
         payload: { schema: string };
         progress?: boolean;
+        queue?: {
+          maxQueuedPerKey?: number;
+          whenFull?: "reject" | "coalesce" | "replace-oldest";
+        };
         result?: { schema: string };
       };
     };

package/src/sdk/_generated/health/client.ts

@@ -99,12 +99,12 @@ export interface TrellisHealthClient {
     readonly health: {
       heartbeat: {
         publish(
-          event: Omit<Types.HealthHeartbeatEvent, "header">,
+          event: Types.HealthHeartbeatEvent,
         ): AsyncResult<void, ValidationError | UnexpectedError>;
         prepare(
-          event: Omit<Types.HealthHeartbeatEvent, "header">,
+          event: Types.HealthHeartbeatEvent,
         ): Result<
-          PreparedTrellisEvent<Omit<Types.HealthHeartbeatEvent, "header">>,
+          PreparedTrellisEvent<Types.HealthHeartbeatEvent>,
           ValidationError | UnexpectedError
         >;
         listen(
@@ -135,12 +135,12 @@ export interface ServiceEventSurface<TDeps> {
   readonly health: {
     heartbeat: {
       publish(
-        event: Omit<Types.HealthHeartbeatEvent, "header">,
+        event: Types.HealthHeartbeatEvent,
       ): AsyncResult<void, ValidationError | UnexpectedError>;
       prepare(
-        event: Omit<Types.HealthHeartbeatEvent, "header">,
+        event: Types.HealthHeartbeatEvent,
       ): Result<
-        PreparedTrellisEvent<Omit<Types.HealthHeartbeatEvent, "header">>,
+        PreparedTrellisEvent<Types.HealthHeartbeatEvent>,
         ValidationError | UnexpectedError
       >;
       listen(

package/src/sdk/_generated/health/contract.ts

@@ -13,7 +13,7 @@ const CONTRACT_MODULE_METADATA = Symbol.for(
 
 export const CONTRACT_ID = "trellis.health@v1" as const;
 export const CONTRACT_DIGEST =
-  "RHDzeH2V6Nltzk6WklCLbTIK48hF0hNuO9Qk6-BosT4" as const;
+  "z9RdJVXAI4q-hSkpvUX_xMYEJaKslMsayevlW4UlSeQ" as const;
 export const CONTRACT = {
   "description":
     "Expose shared Trellis heartbeat events for service observability.",
@@ -61,14 +61,6 @@ export const CONTRACT = {
           },
           "type": "array",
         },
-        "header": {
-          "properties": {
-            "id": { "type": "string" },
-            "time": { "format": "date-time", "type": "string" },
-          },
-          "required": ["id", "time"],
-          "type": "object",
-        },
         "service": {
           "properties": {
             "contractDigest": { "type": "string" },
@@ -115,7 +107,7 @@ export const CONTRACT = {
         },
         "summary": { "type": "string" },
       },
-      "required": ["header", "service", "status", "checks"],
+      "required": ["service", "status", "checks"],
       "type": "object",
     },
   },

package/src/sdk/_generated/health/schemas.ts

@@ -21,14 +21,6 @@ export const HealthHeartbeatSchema = {
       },
       "type": "array",
     },
-    "header": {
-      "properties": {
-        "id": { "type": "string" },
-        "time": { "format": "date-time", "type": "string" },
-      },
-      "required": ["id", "time"],
-      "type": "object",
-    },
     "service": {
       "properties": {
         "contractDigest": { "type": "string" },
@@ -75,6 +67,6 @@ export const HealthHeartbeatSchema = {
     },
     "summary": { "type": "string" },
   },
-  "required": ["header", "service", "status", "checks"],
+  "required": ["service", "status", "checks"],
   "type": "object",
 } as const;

package/src/sdk/_generated/health/types.ts

@@ -1,7 +1,9 @@
 // Generated from ./generated/contracts/manifests/trellis.health@v1.json
+import type { TrellisEventMessage } from "../../../index.js";
+
 export const CONTRACT_ID = "trellis.health@v1" as const;
 export const CONTRACT_DIGEST =
-  "RHDzeH2V6Nltzk6WklCLbTIK48hF0hNuO9Qk6-BosT4" as const;
+  "z9RdJVXAI4q-hSkpvUX_xMYEJaKslMsayevlW4UlSeQ" as const;
 
 export type HealthHeartbeatEvent = {
   checks: Array<
@@ -14,7 +16,6 @@ export type HealthHeartbeatEvent = {
       summary?: string;
     }
   >;
-  header: { id: string; time: string };
   service: {
     contractDigest: string;
     contractId: string;
@@ -31,6 +32,9 @@ export type HealthHeartbeatEvent = {
   status: "healthy" | "unhealthy" | "degraded";
   summary?: string;
 };
+export type HealthHeartbeatEventMessage = TrellisEventMessage<
+  HealthHeartbeatEvent
+>;
 
 export interface RpcMap {
 }

package/src/sdk/_generated/jobs/client.ts

@@ -117,6 +117,10 @@ export interface TrellisJobsClient {
         input: Types.JobsGetInput,
         opts?: RequestOpts,
       ): AsyncResult<Types.JobsGetOutput, BaseError>;
+      getKey(
+        input: Types.JobsGetKeyInput,
+        opts?: RequestOpts,
+      ): AsyncResult<Types.JobsGetKeyOutput, BaseError>;
       health(
         input: Types.JobsHealthInput,
         opts?: RequestOpts,
@@ -153,12 +157,12 @@ export interface TrellisJobsClient {
     readonly health: {
       heartbeat: {
         publish(
-          event: Omit<HealthSdk.HealthHeartbeatEvent, "header">,
+          event: HealthSdk.HealthHeartbeatEvent,
         ): AsyncResult<void, ValidationError | UnexpectedError>;
         prepare(
-          event: Omit<HealthSdk.HealthHeartbeatEvent, "header">,
+          event: HealthSdk.HealthHeartbeatEvent,
         ): Result<
-          PreparedTrellisEvent<Omit<HealthSdk.HealthHeartbeatEvent, "header">>,
+          PreparedTrellisEvent<HealthSdk.HealthHeartbeatEvent>,
           ValidationError | UnexpectedError
         >;
         listen(
@@ -189,12 +193,12 @@ export interface ServiceEventSurface<TDeps> {
   readonly health: {
     heartbeat: {
       publish(
-        event: Omit<HealthSdk.HealthHeartbeatEvent, "header">,
+        event: HealthSdk.HealthHeartbeatEvent,
       ): AsyncResult<void, ValidationError | UnexpectedError>;
       prepare(
-        event: Omit<HealthSdk.HealthHeartbeatEvent, "header">,
+        event: HealthSdk.HealthHeartbeatEvent,
       ): Result<
-        PreparedTrellisEvent<Omit<HealthSdk.HealthHeartbeatEvent, "header">>,
+        PreparedTrellisEvent<HealthSdk.HealthHeartbeatEvent>,
         ValidationError | UnexpectedError
       >;
       listen(
@@ -226,6 +230,13 @@ export interface ServiceHandle<TDeps = undefined> {
       get(
         handler: RpcHandler<Types.JobsGetInput, Types.JobsGetOutput, TDeps>,
       ): Promise<void>;
+      getKey(
+        handler: RpcHandler<
+          Types.JobsGetKeyInput,
+          Types.JobsGetKeyOutput,
+          TDeps
+        >,
+      ): Promise<void>;
       health(
         handler: RpcHandler<
           Types.JobsHealthInput,