@qlever-llc/trellis 0.10.22 → 0.11.0-rc.1

package/esm/generated-sdk/jobs/schemas.js

@@ -11,6 +11,17 @@ export const JobsCancelResponseSchema = {
         "job": {
             "properties": {
                 "completedAt": { "format": "date-time", "type": "string" },
+                "concurrency": {
+                    "properties": {
+                        "heartbeatAt": { "format": "date-time", "type": "string" },
+                        "key": { "minLength": 1, "type": "string" },
+                        "keyHash": { "minLength": 1, "type": "string" },
+                        "leaseExpiresAt": { "format": "date-time", "type": "string" },
+                        "staleTakeoverCount": { "minimum": 0, "type": "integer" },
+                    },
+                    "required": ["key", "keyHash"],
+                    "type": "object",
+                },
                 "context": {
                     "properties": {
                         "requestId": { "minLength": 1, "type": "string" },
@@ -56,6 +67,16 @@ export const JobsCancelResponseSchema = {
                     },
                     "type": "object",
                 },
+                "queuePolicy": {
+                    "properties": {
+                        "existingJobId": { "minLength": 1, "type": "string" },
+                        "outcome": { "minLength": 1, "type": "string" },
+                        "reason": { "minLength": 1, "type": "string" },
+                        "replacedJobId": { "minLength": 1, "type": "string" },
+                    },
+                    "required": ["outcome"],
+                    "type": "object",
+                },
                 "result": {},
                 "service": { "minLength": 1, "type": "string" },
                 "startedAt": { "format": "date-time", "type": "string" },
@@ -105,6 +126,17 @@ export const JobsDismissDLQResponseSchema = {
         "job": {
             "properties": {
                 "completedAt": { "format": "date-time", "type": "string" },
+                "concurrency": {
+                    "properties": {
+                        "heartbeatAt": { "format": "date-time", "type": "string" },
+                        "key": { "minLength": 1, "type": "string" },
+                        "keyHash": { "minLength": 1, "type": "string" },
+                        "leaseExpiresAt": { "format": "date-time", "type": "string" },
+                        "staleTakeoverCount": { "minimum": 0, "type": "integer" },
+                    },
+                    "required": ["key", "keyHash"],
+                    "type": "object",
+                },
                 "context": {
                     "properties": {
                         "requestId": { "minLength": 1, "type": "string" },
@@ -150,6 +182,16 @@ export const JobsDismissDLQResponseSchema = {
                     },
                     "type": "object",
                 },
+                "queuePolicy": {
+                    "properties": {
+                        "existingJobId": { "minLength": 1, "type": "string" },
+                        "outcome": { "minLength": 1, "type": "string" },
+                        "reason": { "minLength": 1, "type": "string" },
+                        "replacedJobId": { "minLength": 1, "type": "string" },
+                    },
+                    "required": ["outcome"],
+                    "type": "object",
+                },
                 "result": {},
                 "service": { "minLength": 1, "type": "string" },
                 "startedAt": { "format": "date-time", "type": "string" },
@@ -188,6 +230,70 @@ export const JobsDismissDLQResponseSchema = {
     "required": ["job"],
     "type": "object",
 };
+export const JobsGetKeyRequestSchema = {
+    "properties": {
+        "key": { "minLength": 1, "type": "string" },
+        "service": { "minLength": 1, "type": "string" },
+        "type": { "minLength": 1, "type": "string" },
+    },
+    "required": ["service", "type", "key"],
+    "type": "object",
+};
+export const JobsGetKeyResponseSchema = {
+    "properties": {
+        "active": {
+            "items": {
+                "properties": {
+                    "heartbeatAgeMs": { "minimum": 0, "type": "integer" },
+                    "heartbeatAt": { "format": "date-time", "type": "string" },
+                    "instanceId": { "type": "string" },
+                    "jobId": { "minLength": 1, "type": "string" },
+                    "leaseExpiresAt": { "format": "date-time", "type": "string" },
+                    "startedAt": { "format": "date-time", "type": "string" },
+                },
+                "required": [
+                    "jobId",
+                    "instanceId",
+                    "startedAt",
+                    "heartbeatAt",
+                    "heartbeatAgeMs",
+                    "leaseExpiresAt",
+                ],
+                "type": "object",
+            },
+            "type": "array",
+        },
+        "key": { "minLength": 1, "type": "string" },
+        "keyHash": { "minLength": 1, "type": "string" },
+        "latestPolicyReason": { "minLength": 1, "type": "string" },
+        "queued": {
+            "items": {
+                "properties": {
+                    "createdAt": { "format": "date-time", "type": "string" },
+                    "jobId": { "minLength": 1, "type": "string" },
+                },
+                "required": ["jobId", "createdAt"],
+                "type": "object",
+            },
+            "type": "array",
+        },
+        "queuedDepth": { "minimum": 0, "type": "integer" },
+        "service": { "minLength": 1, "type": "string" },
+        "staleTakeoverCount": { "minimum": 0, "type": "integer" },
+        "type": { "minLength": 1, "type": "string" },
+    },
+    "required": [
+        "service",
+        "type",
+        "key",
+        "keyHash",
+        "active",
+        "queued",
+        "queuedDepth",
+        "staleTakeoverCount",
+    ],
+    "type": "object",
+};
 export const JobsGetRequestSchema = {
     "description": "Jobs admin ids are globally addressable; callers identify jobs by id only.",
     "properties": { "id": { "minLength": 1, "type": "string" } },
@@ -199,6 +305,17 @@ export const JobsGetResponseSchema = {
         "job": {
             "properties": {
                 "completedAt": { "format": "date-time", "type": "string" },
+                "concurrency": {
+                    "properties": {
+                        "heartbeatAt": { "format": "date-time", "type": "string" },
+                        "key": { "minLength": 1, "type": "string" },
+                        "keyHash": { "minLength": 1, "type": "string" },
+                        "leaseExpiresAt": { "format": "date-time", "type": "string" },
+                        "staleTakeoverCount": { "minimum": 0, "type": "integer" },
+                    },
+                    "required": ["key", "keyHash"],
+                    "type": "object",
+                },
                 "context": {
                     "properties": {
                         "requestId": { "minLength": 1, "type": "string" },
@@ -244,6 +361,16 @@ export const JobsGetResponseSchema = {
                     },
                     "type": "object",
                 },
+                "queuePolicy": {
+                    "properties": {
+                        "existingJobId": { "minLength": 1, "type": "string" },
+                        "outcome": { "minLength": 1, "type": "string" },
+                        "reason": { "minLength": 1, "type": "string" },
+                        "replacedJobId": { "minLength": 1, "type": "string" },
+                    },
+                    "required": ["outcome"],
+                    "type": "object",
+                },
                 "result": {},
                 "service": { "minLength": 1, "type": "string" },
                 "startedAt": { "format": "date-time", "type": "string" },
@@ -313,6 +440,17 @@ export const JobsListDLQResponseSchema = {
             "items": {
                 "properties": {
                     "completedAt": { "format": "date-time", "type": "string" },
+                    "concurrency": {
+                        "properties": {
+                            "heartbeatAt": { "format": "date-time", "type": "string" },
+                            "key": { "minLength": 1, "type": "string" },
+                            "keyHash": { "minLength": 1, "type": "string" },
+                            "leaseExpiresAt": { "format": "date-time", "type": "string" },
+                            "staleTakeoverCount": { "minimum": 0, "type": "integer" },
+                        },
+                        "required": ["key", "keyHash"],
+                        "type": "object",
+                    },
                     "context": {
                         "properties": {
                             "requestId": { "minLength": 1, "type": "string" },
@@ -358,6 +496,16 @@ export const JobsListDLQResponseSchema = {
                         },
                         "type": "object",
                     },
+                    "queuePolicy": {
+                        "properties": {
+                            "existingJobId": { "minLength": 1, "type": "string" },
+                            "outcome": { "minLength": 1, "type": "string" },
+                            "reason": { "minLength": 1, "type": "string" },
+                            "replacedJobId": { "minLength": 1, "type": "string" },
+                        },
+                        "required": ["outcome"],
+                        "type": "object",
+                    },
                     "result": {},
                     "service": { "minLength": 1, "type": "string" },
                     "startedAt": { "format": "date-time", "type": "string" },
@@ -435,6 +583,17 @@ export const JobsListResponseSchema = {
             "items": {
                 "properties": {
                     "completedAt": { "format": "date-time", "type": "string" },
+                    "concurrency": {
+                        "properties": {
+                            "heartbeatAt": { "format": "date-time", "type": "string" },
+                            "key": { "minLength": 1, "type": "string" },
+                            "keyHash": { "minLength": 1, "type": "string" },
+                            "leaseExpiresAt": { "format": "date-time", "type": "string" },
+                            "staleTakeoverCount": { "minimum": 0, "type": "integer" },
+                        },
+                        "required": ["key", "keyHash"],
+                        "type": "object",
+                    },
                     "context": {
                         "properties": {
                             "requestId": { "minLength": 1, "type": "string" },
@@ -480,6 +639,16 @@ export const JobsListResponseSchema = {
                         },
                         "type": "object",
                     },
+                    "queuePolicy": {
+                        "properties": {
+                            "existingJobId": { "minLength": 1, "type": "string" },
+                            "outcome": { "minLength": 1, "type": "string" },
+                            "reason": { "minLength": 1, "type": "string" },
+                            "replacedJobId": { "minLength": 1, "type": "string" },
+                        },
+                        "required": ["outcome"],
+                        "type": "object",
+                    },
                     "result": {},
                     "service": { "minLength": 1, "type": "string" },
                     "startedAt": { "format": "date-time", "type": "string" },
@@ -578,6 +747,17 @@ export const JobsReplayDLQResponseSchema = {
         "job": {
             "properties": {
                 "completedAt": { "format": "date-time", "type": "string" },
+                "concurrency": {
+                    "properties": {
+                        "heartbeatAt": { "format": "date-time", "type": "string" },
+                        "key": { "minLength": 1, "type": "string" },
+                        "keyHash": { "minLength": 1, "type": "string" },
+                        "leaseExpiresAt": { "format": "date-time", "type": "string" },
+                        "staleTakeoverCount": { "minimum": 0, "type": "integer" },
+                    },
+                    "required": ["key", "keyHash"],
+                    "type": "object",
+                },
                 "context": {
                     "properties": {
                         "requestId": { "minLength": 1, "type": "string" },
@@ -623,6 +803,16 @@ export const JobsReplayDLQResponseSchema = {
                     },
                     "type": "object",
                 },
+                "queuePolicy": {
+                    "properties": {
+                        "existingJobId": { "minLength": 1, "type": "string" },
+                        "outcome": { "minLength": 1, "type": "string" },
+                        "reason": { "minLength": 1, "type": "string" },
+                        "replacedJobId": { "minLength": 1, "type": "string" },
+                    },
+                    "required": ["outcome"],
+                    "type": "object",
+                },
                 "result": {},
                 "service": { "minLength": 1, "type": "string" },
                 "startedAt": { "format": "date-time", "type": "string" },
@@ -672,6 +862,17 @@ export const JobsRetryResponseSchema = {
         "job": {
             "properties": {
                 "completedAt": { "format": "date-time", "type": "string" },
+                "concurrency": {
+                    "properties": {
+                        "heartbeatAt": { "format": "date-time", "type": "string" },
+                        "key": { "minLength": 1, "type": "string" },
+                        "keyHash": { "minLength": 1, "type": "string" },
+                        "leaseExpiresAt": { "format": "date-time", "type": "string" },
+                        "staleTakeoverCount": { "minimum": 0, "type": "integer" },
+                    },
+                    "required": ["key", "keyHash"],
+                    "type": "object",
+                },
                 "context": {
                     "properties": {
                         "requestId": { "minLength": 1, "type": "string" },
@@ -717,6 +918,16 @@ export const JobsRetryResponseSchema = {
                     },
                     "type": "object",
                 },
+                "queuePolicy": {
+                    "properties": {
+                        "existingJobId": { "minLength": 1, "type": "string" },
+                        "outcome": { "minLength": 1, "type": "string" },
+                        "reason": { "minLength": 1, "type": "string" },
+                        "replacedJobId": { "minLength": 1, "type": "string" },
+                    },
+                    "required": ["outcome"],
+                    "type": "object",
+                },
                 "result": {},
                 "service": { "minLength": 1, "type": "string" },
                 "startedAt": { "format": "date-time", "type": "string" },

package/esm/generated-sdk/jobs/types.d.ts

@@ -1,14 +1,22 @@
-import type { RpcHandlerFn } from "@qlever-llc/trellis";
-import type { API } from "./api.js";
+import type { BaseError, HandlerTrellis, Result, RpcHandlerContext, TrellisErrorInstance } from "@qlever-llc/trellis";
+import type { Api } from "./api.js";
 import { TrellisError } from "@qlever-llc/trellis";
+export type HandlerClient = HandlerTrellis<Api>;
 export declare const CONTRACT_ID: "trellis.jobs@v1";
-export declare const CONTRACT_DIGEST: "jSB8nKGOQqIxdFDdUqO-gOTt3Dijg--SOXJtJ1ChpoY";
+export declare const CONTRACT_DIGEST: "xDigtrlrF3n3ZNgHVdwDJFcwi0PEJBiDyBG6FnzFzM8";
 export type JobsCancelInput = {
     id: string;
 };
 export type JobsCancelOutput = {
     job: {
         completedAt?: string;
+        concurrency?: {
+            heartbeatAt?: string;
+            key: string;
+            keyHash: string;
+            leaseExpiresAt?: string;
+            staleTakeoverCount?: number;
+        };
         context: {
             requestId: string;
             traceId: string;
@@ -32,6 +40,12 @@ export type JobsCancelOutput = {
             step?: string;
             total?: number;
         };
+        queuePolicy?: {
+            existingJobId?: string;
+            outcome: string;
+            reason?: string;
+            replacedJobId?: string;
+        };
         result?: unknown;
         service: string;
         startedAt?: string;
@@ -47,6 +61,13 @@ export type JobsDismissDLQInput = {
 export type JobsDismissDLQOutput = {
     job: {
         completedAt?: string;
+        concurrency?: {
+            heartbeatAt?: string;
+            key: string;
+            keyHash: string;
+            leaseExpiresAt?: string;
+            staleTakeoverCount?: number;
+        };
         context: {
             requestId: string;
             traceId: string;
@@ -70,6 +91,12 @@ export type JobsDismissDLQOutput = {
             step?: string;
             total?: number;
         };
+        queuePolicy?: {
+            existingJobId?: string;
+            outcome: string;
+            reason?: string;
+            replacedJobId?: string;
+        };
         result?: unknown;
         service: string;
         startedAt?: string;
@@ -85,6 +112,13 @@ export type JobsGetInput = {
 export type JobsGetOutput = {
     job: {
         completedAt?: string;
+        concurrency?: {
+            heartbeatAt?: string;
+            key: string;
+            keyHash: string;
+            leaseExpiresAt?: string;
+            staleTakeoverCount?: number;
+        };
         context: {
             requestId: string;
             traceId: string;
@@ -108,6 +142,12 @@ export type JobsGetOutput = {
             step?: string;
             total?: number;
         };
+        queuePolicy?: {
+            existingJobId?: string;
+            outcome: string;
+            reason?: string;
+            replacedJobId?: string;
+        };
         result?: unknown;
         service: string;
         startedAt?: string;
@@ -117,6 +157,32 @@ export type JobsGetOutput = {
         updatedAt: string;
     };
 };
+export type JobsGetKeyInput = {
+    key: string;
+    service: string;
+    type: string;
+};
+export type JobsGetKeyOutput = {
+    active: Array<{
+        heartbeatAgeMs: number;
+        heartbeatAt: string;
+        instanceId: string;
+        jobId: string;
+        leaseExpiresAt: string;
+        startedAt: string;
+    }>;
+    key: string;
+    keyHash: string;
+    latestPolicyReason?: string;
+    queued: Array<{
+        createdAt: string;
+        jobId: string;
+    }>;
+    queuedDepth: number;
+    service: string;
+    staleTakeoverCount: number;
+    type: string;
+};
 export type JobsHealthInput = {};
 export type JobsHealthOutput = {
     checks: Array<{
@@ -138,6 +204,13 @@ export type JobsListOutput = {
     count: number;
     entries: Array<{
         completedAt?: string;
+        concurrency?: {
+            heartbeatAt?: string;
+            key: string;
+            keyHash: string;
+            leaseExpiresAt?: string;
+            staleTakeoverCount?: number;
+        };
         context: {
             requestId: string;
             traceId: string;
@@ -161,6 +234,12 @@ export type JobsListOutput = {
             step?: string;
             total?: number;
         };
+        queuePolicy?: {
+            existingJobId?: string;
+            outcome: string;
+            reason?: string;
+            replacedJobId?: string;
+        };
         result?: unknown;
         service: string;
         startedAt?: string;
@@ -184,6 +263,13 @@ export type JobsListDLQOutput = {
     count: number;
     entries: Array<{
         completedAt?: string;
+        concurrency?: {
+            heartbeatAt?: string;
+            key: string;
+            keyHash: string;
+            leaseExpiresAt?: string;
+            staleTakeoverCount?: number;
+        };
         context: {
             requestId: string;
             traceId: string;
@@ -207,6 +293,12 @@ export type JobsListDLQOutput = {
             step?: string;
             total?: number;
         };
+        queuePolicy?: {
+            existingJobId?: string;
+            outcome: string;
+            reason?: string;
+            replacedJobId?: string;
+        };
         result?: unknown;
         service: string;
         startedAt?: string;
@@ -247,6 +339,13 @@ export type JobsReplayDLQInput = {
 export type JobsReplayDLQOutput = {
     job: {
         completedAt?: string;
+        concurrency?: {
+            heartbeatAt?: string;
+            key: string;
+            keyHash: string;
+            leaseExpiresAt?: string;
+            staleTakeoverCount?: number;
+        };
         context: {
             requestId: string;
             traceId: string;
@@ -270,6 +369,12 @@ export type JobsReplayDLQOutput = {
             step?: string;
             total?: number;
         };
+        queuePolicy?: {
+            existingJobId?: string;
+            outcome: string;
+            reason?: string;
+            replacedJobId?: string;
+        };
         result?: unknown;
         service: string;
         startedAt?: string;
@@ -285,6 +390,13 @@ export type JobsRetryInput = {
 export type JobsRetryOutput = {
     job: {
         completedAt?: string;
+        concurrency?: {
+            heartbeatAt?: string;
+            key: string;
+            keyHash: string;
+            leaseExpiresAt?: string;
+            staleTakeoverCount?: number;
+        };
         context: {
             requestId: string;
             traceId: string;
@@ -308,6 +420,12 @@ export type JobsRetryOutput = {
             step?: string;
             total?: number;
         };
+        queuePolicy?: {
+            existingJobId?: string;
+            outcome: string;
+            reason?: string;
+            replacedJobId?: string;
+        };
         result?: unknown;
         service: string;
         startedAt?: string;
@@ -382,6 +500,10 @@ export interface RpcMap {
         input: JobsGetInput;
         output: JobsGetOutput;
     };
+    "Jobs.GetKey": {
+        input: JobsGetKeyInput;
+        output: JobsGetKeyOutput;
+    };
     "Jobs.Health": {
         input: JobsHealthInput;
         output: JobsHealthOutput;
@@ -407,15 +529,76 @@ export interface RpcMap {
         output: JobsRetryOutput;
     };
 }
-export type JobsCancelHandler = RpcHandlerFn<typeof API.owned, "Jobs.Cancel">;
-export type JobsDismissDLQHandler = RpcHandlerFn<typeof API.owned, "Jobs.DismissDLQ">;
-export type JobsGetHandler = RpcHandlerFn<typeof API.owned, "Jobs.Get">;
-export type JobsHealthHandler = RpcHandlerFn<typeof API.owned, "Jobs.Health">;
-export type JobsListHandler = RpcHandlerFn<typeof API.owned, "Jobs.List">;
-export type JobsListDLQHandler = RpcHandlerFn<typeof API.owned, "Jobs.ListDLQ">;
-export type JobsListServicesHandler = RpcHandlerFn<typeof API.owned, "Jobs.ListServices">;
-export type JobsReplayDLQHandler = RpcHandlerFn<typeof API.owned, "Jobs.ReplayDLQ">;
-export type JobsRetryHandler = RpcHandlerFn<typeof API.owned, "Jobs.Retry">;
+export type JobsCancelHandlerError = TrellisErrorInstance | BaseError<NotFoundErrorData>;
+export type JobsCancelHandlerResult = Result<JobsCancelOutput, JobsCancelHandlerError>;
+export type JobsCancelHandler = (args: {
+    input: JobsCancelInput;
+    context: RpcHandlerContext;
+    client: HandlerClient;
+}) => JobsCancelHandlerResult | Promise<JobsCancelHandlerResult>;
+export type JobsDismissDLQHandlerError = TrellisErrorInstance | BaseError<NotFoundErrorData>;
+export type JobsDismissDLQHandlerResult = Result<JobsDismissDLQOutput, JobsDismissDLQHandlerError>;
+export type JobsDismissDLQHandler = (args: {
+    input: JobsDismissDLQInput;
+    context: RpcHandlerContext;
+    client: HandlerClient;
+}) => JobsDismissDLQHandlerResult | Promise<JobsDismissDLQHandlerResult>;
+export type JobsGetHandlerError = TrellisErrorInstance | BaseError<NotFoundErrorData>;
+export type JobsGetHandlerResult = Result<JobsGetOutput, JobsGetHandlerError>;
+export type JobsGetHandler = (args: {
+    input: JobsGetInput;
+    context: RpcHandlerContext;
+    client: HandlerClient;
+}) => JobsGetHandlerResult | Promise<JobsGetHandlerResult>;
+export type JobsGetKeyHandlerError = TrellisErrorInstance | BaseError<NotFoundErrorData>;
+export type JobsGetKeyHandlerResult = Result<JobsGetKeyOutput, JobsGetKeyHandlerError>;
+export type JobsGetKeyHandler = (args: {
+    input: JobsGetKeyInput;
+    context: RpcHandlerContext;
+    client: HandlerClient;
+}) => JobsGetKeyHandlerResult | Promise<JobsGetKeyHandlerResult>;
+export type JobsHealthHandlerError = TrellisErrorInstance;
+export type JobsHealthHandlerResult = Result<JobsHealthOutput, JobsHealthHandlerError>;
+export type JobsHealthHandler = (args: {
+    input: JobsHealthInput;
+    context: RpcHandlerContext;
+    client: HandlerClient;
+}) => JobsHealthHandlerResult | Promise<JobsHealthHandlerResult>;
+export type JobsListHandlerError = TrellisErrorInstance;
+export type JobsListHandlerResult = Result<JobsListOutput, JobsListHandlerError>;
+export type JobsListHandler = (args: {
+    input: JobsListInput;
+    context: RpcHandlerContext;
+    client: HandlerClient;
+}) => JobsListHandlerResult | Promise<JobsListHandlerResult>;
+export type JobsListDLQHandlerError = TrellisErrorInstance;
+export type JobsListDLQHandlerResult = Result<JobsListDLQOutput, JobsListDLQHandlerError>;
+export type JobsListDLQHandler = (args: {
+    input: JobsListDLQInput;
+    context: RpcHandlerContext;
+    client: HandlerClient;
+}) => JobsListDLQHandlerResult | Promise<JobsListDLQHandlerResult>;
+export type JobsListServicesHandlerError = TrellisErrorInstance;
+export type JobsListServicesHandlerResult = Result<JobsListServicesOutput, JobsListServicesHandlerError>;
+export type JobsListServicesHandler = (args: {
+    input: JobsListServicesInput;
+    context: RpcHandlerContext;
+    client: HandlerClient;
+}) => JobsListServicesHandlerResult | Promise<JobsListServicesHandlerResult>;
+export type JobsReplayDLQHandlerError = TrellisErrorInstance | BaseError<NotFoundErrorData>;
+export type JobsReplayDLQHandlerResult = Result<JobsReplayDLQOutput, JobsReplayDLQHandlerError>;
+export type JobsReplayDLQHandler = (args: {
+    input: JobsReplayDLQInput;
+    context: RpcHandlerContext;
+    client: HandlerClient;
+}) => JobsReplayDLQHandlerResult | Promise<JobsReplayDLQHandlerResult>;
+export type JobsRetryHandlerError = TrellisErrorInstance | BaseError<NotFoundErrorData>;
+export type JobsRetryHandlerResult = Result<JobsRetryOutput, JobsRetryHandlerError>;
+export type JobsRetryHandler = (args: {
+    input: JobsRetryInput;
+    context: RpcHandlerContext;
+    client: HandlerClient;
+}) => JobsRetryHandlerResult | Promise<JobsRetryHandlerResult>;
 export interface EventMap {
 }
 export interface FeedMap {