@lssm/lib.jobs 0.0.0-canary-20251217062943 → 0.0.0-canary-20251217072406

package/dist/events.js

@@ -1 +1,303 @@
-import{l as e}from"./schema/dist/ScalarTypeEnum.js";import{n as t}from"./schema/dist/SchemaModel.js";import"./schema/dist/index.js";import{e as n}from"./contracts/dist/events.js";import"./contracts/dist/index.js";const r=t({name:`JobEnqueuedEventPayload`,description:`Payload when a job is added to the queue`,fields:{jobId:{type:e.String_unsecure(),isOptional:!1},type:{type:e.String_unsecure(),isOptional:!1},priority:{type:e.Int_unsecure(),isOptional:!1},scheduledAt:{type:e.DateTime(),isOptional:!0},tenantId:{type:e.String_unsecure(),isOptional:!0},enqueuedAt:{type:e.DateTime(),isOptional:!1}}}),i=t({name:`JobStartedEventPayload`,description:`Payload when a job starts processing`,fields:{jobId:{type:e.String_unsecure(),isOptional:!1},type:{type:e.String_unsecure(),isOptional:!1},attempt:{type:e.Int_unsecure(),isOptional:!1},startedAt:{type:e.DateTime(),isOptional:!1}}}),a=t({name:`JobCompletedEventPayload`,description:`Payload when a job completes successfully`,fields:{jobId:{type:e.String_unsecure(),isOptional:!1},type:{type:e.String_unsecure(),isOptional:!1},attempt:{type:e.Int_unsecure(),isOptional:!1},durationMs:{type:e.Int_unsecure(),isOptional:!1},completedAt:{type:e.DateTime(),isOptional:!1}}}),o=t({name:`JobFailedEventPayload`,description:`Payload when a job attempt fails`,fields:{jobId:{type:e.String_unsecure(),isOptional:!1},type:{type:e.String_unsecure(),isOptional:!1},attempt:{type:e.Int_unsecure(),isOptional:!1},error:{type:e.String_unsecure(),isOptional:!1},willRetry:{type:e.Boolean(),isOptional:!1},failedAt:{type:e.DateTime(),isOptional:!1}}}),s=t({name:`JobRetryingEventPayload`,description:`Payload when a job is scheduled for retry`,fields:{jobId:{type:e.String_unsecure(),isOptional:!1},type:{type:e.String_unsecure(),isOptional:!1},attempt:{type:e.Int_unsecure(),isOptional:!1},nextAttemptAt:{type:e.DateTime(),isOptional:!1},backoffMs:{type:e.Int_unsecure(),isOptional:!1}}}),c=t({name:`JobDeadLetteredEventPayload`,description:`Payload when a job is moved to dead letter queue`,fields:{jobId:{type:e.String_unsecure(),isOptional:!1},type:{type:e.String_unsecure(),isOptional:!1},attempts:{type:e.Int_unsecure(),isOptional:!1},lastError:{type:e.String_unsecure(),isOptional:!1},deadLetteredAt:{type:e.DateTime(),isOptional:!1}}}),l=t({name:`JobCancelledEventPayload`,description:`Payload when a job is cancelled`,fields:{jobId:{type:e.String_unsecure(),isOptional:!1},type:{type:e.String_unsecure(),isOptional:!1},cancelledBy:{type:e.String_unsecure(),isOptional:!0},cancelledAt:{type:e.DateTime(),isOptional:!1}}}),u=t({name:`ScheduledJobTriggeredEventPayload`,description:`Payload when a scheduled job is triggered`,fields:{scheduleName:{type:e.String_unsecure(),isOptional:!1},jobId:{type:e.String_unsecure(),isOptional:!1},jobType:{type:e.String_unsecure(),isOptional:!1},triggeredAt:{type:e.DateTime(),isOptional:!1},nextRunAt:{type:e.DateTime(),isOptional:!0}}}),d=n({name:`job.enqueued`,version:1,description:`A job has been added to the queue.`,payload:r}),f=n({name:`job.started`,version:1,description:`A job has started processing.`,payload:i}),p=n({name:`job.completed`,version:1,description:`A job has completed successfully.`,payload:a}),m=n({name:`job.failed`,version:1,description:`A job attempt has failed.`,payload:o}),h=n({name:`job.retrying`,version:1,description:`A job is being scheduled for retry.`,payload:s}),g=n({name:`job.dead_lettered`,version:1,description:`A job has exhausted all retries and moved to dead letter queue.`,payload:c}),_=n({name:`job.cancelled`,version:1,description:`A job has been cancelled.`,payload:l}),v=n({name:`scheduler.job_triggered`,version:1,description:`A scheduled job has been triggered.`,payload:u}),y={JobEnqueuedEvent:d,JobStartedEvent:f,JobCompletedEvent:p,JobFailedEvent:m,JobRetryingEvent:h,JobDeadLetteredEvent:g,JobCancelledEvent:_,ScheduledJobTriggeredEvent:v};export{_ as JobCancelledEvent,p as JobCompletedEvent,g as JobDeadLetteredEvent,d as JobEnqueuedEvent,y as JobEvents,m as JobFailedEvent,h as JobRetryingEvent,f as JobStartedEvent,v as ScheduledJobTriggeredEvent};
+import { ScalarTypeEnum } from "./schema/dist/ScalarTypeEnum.js";
+import { defineSchemaModel } from "./schema/dist/SchemaModel.js";
+import "./schema/dist/index.js";
+import { defineEvent } from "./contracts/dist/events.js";
+import "./contracts/dist/index.js";
+
+//#region src/events.ts
+const JobEnqueuedPayload = defineSchemaModel({
+	name: "JobEnqueuedEventPayload",
+	description: "Payload when a job is added to the queue",
+	fields: {
+		jobId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		type: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		priority: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		scheduledAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		tenantId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		enqueuedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const JobStartedPayload = defineSchemaModel({
+	name: "JobStartedEventPayload",
+	description: "Payload when a job starts processing",
+	fields: {
+		jobId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		type: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		attempt: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		startedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const JobCompletedPayload = defineSchemaModel({
+	name: "JobCompletedEventPayload",
+	description: "Payload when a job completes successfully",
+	fields: {
+		jobId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		type: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		attempt: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		durationMs: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		completedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const JobFailedPayload = defineSchemaModel({
+	name: "JobFailedEventPayload",
+	description: "Payload when a job attempt fails",
+	fields: {
+		jobId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		type: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		attempt: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		error: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		willRetry: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		failedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const JobRetryingPayload = defineSchemaModel({
+	name: "JobRetryingEventPayload",
+	description: "Payload when a job is scheduled for retry",
+	fields: {
+		jobId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		type: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		attempt: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		nextAttemptAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		backoffMs: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const JobDeadLetteredPayload = defineSchemaModel({
+	name: "JobDeadLetteredEventPayload",
+	description: "Payload when a job is moved to dead letter queue",
+	fields: {
+		jobId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		type: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		attempts: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		lastError: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		deadLetteredAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const JobCancelledPayload = defineSchemaModel({
+	name: "JobCancelledEventPayload",
+	description: "Payload when a job is cancelled",
+	fields: {
+		jobId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		type: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		cancelledBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		cancelledAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const ScheduledJobTriggeredPayload = defineSchemaModel({
+	name: "ScheduledJobTriggeredEventPayload",
+	description: "Payload when a scheduled job is triggered",
+	fields: {
+		scheduleName: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		jobId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		jobType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		triggeredAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		nextRunAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+/**
+* Emitted when a job is enqueued.
+*/
+const JobEnqueuedEvent = defineEvent({
+	name: "job.enqueued",
+	version: 1,
+	description: "A job has been added to the queue.",
+	payload: JobEnqueuedPayload
+});
+/**
+* Emitted when a job starts processing.
+*/
+const JobStartedEvent = defineEvent({
+	name: "job.started",
+	version: 1,
+	description: "A job has started processing.",
+	payload: JobStartedPayload
+});
+/**
+* Emitted when a job completes successfully.
+*/
+const JobCompletedEvent = defineEvent({
+	name: "job.completed",
+	version: 1,
+	description: "A job has completed successfully.",
+	payload: JobCompletedPayload
+});
+/**
+* Emitted when a job fails (single attempt).
+*/
+const JobFailedEvent = defineEvent({
+	name: "job.failed",
+	version: 1,
+	description: "A job attempt has failed.",
+	payload: JobFailedPayload
+});
+/**
+* Emitted when a job is being retried.
+*/
+const JobRetryingEvent = defineEvent({
+	name: "job.retrying",
+	version: 1,
+	description: "A job is being scheduled for retry.",
+	payload: JobRetryingPayload
+});
+/**
+* Emitted when a job is moved to dead letter queue.
+*/
+const JobDeadLetteredEvent = defineEvent({
+	name: "job.dead_lettered",
+	version: 1,
+	description: "A job has exhausted all retries and moved to dead letter queue.",
+	payload: JobDeadLetteredPayload
+});
+/**
+* Emitted when a job is cancelled.
+*/
+const JobCancelledEvent = defineEvent({
+	name: "job.cancelled",
+	version: 1,
+	description: "A job has been cancelled.",
+	payload: JobCancelledPayload
+});
+/**
+* Emitted when a scheduled job is triggered.
+*/
+const ScheduledJobTriggeredEvent = defineEvent({
+	name: "scheduler.job_triggered",
+	version: 1,
+	description: "A scheduled job has been triggered.",
+	payload: ScheduledJobTriggeredPayload
+});
+/**
+* All job events.
+*/
+const JobEvents = {
+	JobEnqueuedEvent,
+	JobStartedEvent,
+	JobCompletedEvent,
+	JobFailedEvent,
+	JobRetryingEvent,
+	JobDeadLetteredEvent,
+	JobCancelledEvent,
+	ScheduledJobTriggeredEvent
+};
+
+//#endregion
+export { JobCancelledEvent, JobCompletedEvent, JobDeadLetteredEvent, JobEnqueuedEvent, JobEvents, JobFailedEvent, JobRetryingEvent, JobStartedEvent, ScheduledJobTriggeredEvent };

package/dist/handlers/gmail-sync-handler.js

@@ -1 +1,9 @@
-function e(e){return async t=>{await e.syncThreads(t.payload)}}export{e as createGmailSyncHandler};
+//#region src/handlers/gmail-sync-handler.ts
+function createGmailSyncHandler(adapter) {
+	return async (job) => {
+		await adapter.syncThreads(job.payload);
+	};
+}
+
+//#endregion
+export { createGmailSyncHandler };

package/dist/handlers/index.js

@@ -1 +1,12 @@
-import{registerDefinedJob as e}from"../queue/register-defined-job.js";import{PING_JOB_TYPE as t,PingPayloadSchema as n,pingJob as r}from"./ping-job.js";import{createGmailSyncHandler as i}from"./gmail-sync-handler.js";import{createStorageDocumentHandler as a}from"./storage-document-handler.js";function o(t){e(t,r)}export{t as PING_JOB_TYPE,n as PingPayloadSchema,i as createGmailSyncHandler,a as createStorageDocumentHandler,r as pingJob,o as registerAllJobs};
+import { registerDefinedJob } from "../queue/register-defined-job.js";
+import { PING_JOB_TYPE, PingPayloadSchema, pingJob } from "./ping-job.js";
+import { createGmailSyncHandler } from "./gmail-sync-handler.js";
+import { createStorageDocumentHandler } from "./storage-document-handler.js";
+
+//#region src/handlers/index.ts
+function registerAllJobs(queue) {
+	registerDefinedJob(queue, pingJob);
+}
+
+//#endregion
+export { PING_JOB_TYPE, PingPayloadSchema, createGmailSyncHandler, createStorageDocumentHandler, pingJob, registerAllJobs };

package/dist/handlers/ping-job.d.ts

@@ -1,10 +1,10 @@
-import * as z from "zod";
+import * as z$1 from "zod";
 import { DefinedJob } from "@lssm/lib.contracts/jobs/define-job";
 
 //#region src/handlers/ping-job.d.ts
 declare const PING_JOB_TYPE: "core.ping";
-declare const PingPayloadSchema: z.ZodObject<{}, z.core.$strip>;
-type PingPayload = z.infer<typeof PingPayloadSchema>;
+declare const PingPayloadSchema: z$1.ZodObject<{}, z$1.core.$strip>;
+type PingPayload = z$1.infer<typeof PingPayloadSchema>;
 declare const pingJob: DefinedJob<PingPayload>;
 //#endregion
 export { PING_JOB_TYPE, PingPayload, PingPayloadSchema, pingJob };

package/dist/handlers/ping-job.js

@@ -1 +1,13 @@
-import*as e from"zod";const t=`core.ping`,n=e.object({}),r={type:t,schema:n,handler:async(e,t)=>{}};export{t as PING_JOB_TYPE,n as PingPayloadSchema,r as pingJob};
+import * as z$1 from "zod";
+
+//#region src/handlers/ping-job.ts
+const PING_JOB_TYPE = "core.ping";
+const PingPayloadSchema = z$1.object({});
+const pingJob = {
+	type: PING_JOB_TYPE,
+	schema: PingPayloadSchema,
+	handler: async (_payload, _job) => {}
+};
+
+//#endregion
+export { PING_JOB_TYPE, PingPayloadSchema, pingJob };

package/dist/handlers/storage-document-handler.js

@@ -1 +1,14 @@
-function e(e,t){return async n=>{let r=await e.getObject({bucket:n.payload.bucket,key:n.payload.key});if(!r)throw Error(`Object ${n.payload.bucket}/${n.payload.key} not found`);await t.ingestObject(r)}}export{e as createStorageDocumentHandler};
+//#region src/handlers/storage-document-handler.ts
+function createStorageDocumentHandler(storage, adapter) {
+	return async (job) => {
+		const object = await storage.getObject({
+			bucket: job.payload.bucket,
+			key: job.payload.key
+		});
+		if (!object) throw new Error(`Object ${job.payload.bucket}/${job.payload.key} not found`);
+		await adapter.ingestObject(object);
+	};
+}
+
+//#endregion
+export { createStorageDocumentHandler };

package/dist/index.js

@@ -1 +1,18 @@
-import{JobCancelledEvent as e,JobCompletedEvent as t,JobDeadLetteredEvent as n,JobEnqueuedEvent as r,JobEvents as i,JobFailedEvent as a,JobRetryingEvent as o,JobStartedEvent as s,ScheduledJobTriggeredEvent as c}from"./events.js";import{JobEntity as l,JobExecutionEntity as u,JobStatusEnum as d,ScheduledJobEntity as f,jobEntities as p,jobsSchemaContribution as m}from"./entities/index.js";import{e as h,n as g,t as _}from"./contracts/dist/jobs/queue.js";import{MemoryJobQueue as v}from"./queue/memory-queue.js";import{ScalewaySqsJobQueue as y}from"./queue/scaleway-sqs-queue.js";import{GcpCloudTasksQueue as b}from"./queue/gcp-cloud-tasks.js";import{GcpPubSubQueue as x}from"./queue/gcp-pubsub.js";import{registerDefinedJob as S}from"./queue/register-defined-job.js";import"./queue/index.js";import{PING_JOB_TYPE as C,PingPayloadSchema as w,pingJob as T}from"./handlers/ping-job.js";import{createGmailSyncHandler as E}from"./handlers/gmail-sync-handler.js";import{createStorageDocumentHandler as D}from"./handlers/storage-document-handler.js";import{registerAllJobs as O}from"./handlers/index.js";import{JobScheduler as k,createScheduler as A,defineSchedule as j}from"./scheduler/index.js";import{CancelJobContract as M,CreateScheduledJobContract as N,EnqueueJobContract as P,GetJobContract as F,GetQueueStatsContract as I,JobModel as L,ListScheduledJobsContract as R,QueueStatsModel as z,ScheduledJobModel as B,ToggleScheduledJobContract as V}from"./contracts/index.js";import{JobsFeature as H}from"./jobs.feature.js";export{M as CancelJobContract,N as CreateScheduledJobContract,h as DEFAULT_RETRY_POLICY,P as EnqueueJobContract,b as GcpCloudTasksQueue,x as GcpPubSubQueue,F as GetJobContract,I as GetQueueStatsContract,e as JobCancelledEvent,t as JobCompletedEvent,n as JobDeadLetteredEvent,r as JobEnqueuedEvent,l as JobEntity,i as JobEvents,u as JobExecutionEntity,a as JobFailedEvent,L as JobModel,o as JobRetryingEvent,k as JobScheduler,s as JobStartedEvent,d as JobStatusEnum,H as JobsFeature,R as ListScheduledJobsContract,v as MemoryJobQueue,C as PING_JOB_TYPE,w as PingPayloadSchema,z as QueueStatsModel,y as ScalewaySqsJobQueue,f as ScheduledJobEntity,B as ScheduledJobModel,c as ScheduledJobTriggeredEvent,V as ToggleScheduledJobContract,_ as calculateBackoff,E as createGmailSyncHandler,A as createScheduler,D as createStorageDocumentHandler,g as defineJobType,j as defineSchedule,p as jobEntities,m as jobsSchemaContribution,T as pingJob,O as registerAllJobs,S as registerDefinedJob};
+import { JobCancelledEvent, JobCompletedEvent, JobDeadLetteredEvent, JobEnqueuedEvent, JobEvents, JobFailedEvent, JobRetryingEvent, JobStartedEvent, ScheduledJobTriggeredEvent } from "./events.js";
+import { JobEntity, JobExecutionEntity, JobStatusEnum, ScheduledJobEntity, jobEntities, jobsSchemaContribution } from "./entities/index.js";
+import { DEFAULT_RETRY_POLICY, calculateBackoff, defineJobType } from "./contracts/dist/jobs/queue.js";
+import { MemoryJobQueue } from "./queue/memory-queue.js";
+import { ScalewaySqsJobQueue } from "./queue/scaleway-sqs-queue.js";
+import { GcpCloudTasksQueue } from "./queue/gcp-cloud-tasks.js";
+import { GcpPubSubQueue } from "./queue/gcp-pubsub.js";
+import { registerDefinedJob } from "./queue/register-defined-job.js";
+import "./queue/index.js";
+import { PING_JOB_TYPE, PingPayloadSchema, pingJob } from "./handlers/ping-job.js";
+import { createGmailSyncHandler } from "./handlers/gmail-sync-handler.js";
+import { createStorageDocumentHandler } from "./handlers/storage-document-handler.js";
+import { registerAllJobs } from "./handlers/index.js";
+import { JobScheduler, createScheduler, defineSchedule } from "./scheduler/index.js";
+import { CancelJobContract, CreateScheduledJobContract, EnqueueJobContract, GetJobContract, GetQueueStatsContract, JobModel, ListScheduledJobsContract, QueueStatsModel, ScheduledJobModel, ToggleScheduledJobContract } from "./contracts/index.js";
+import { JobsFeature } from "./jobs.feature.js";
+
+export { CancelJobContract, CreateScheduledJobContract, DEFAULT_RETRY_POLICY, EnqueueJobContract, GcpCloudTasksQueue, GcpPubSubQueue, GetJobContract, GetQueueStatsContract, JobCancelledEvent, JobCompletedEvent, JobDeadLetteredEvent, JobEnqueuedEvent, JobEntity, JobEvents, JobExecutionEntity, JobFailedEvent, JobModel, JobRetryingEvent, JobScheduler, JobStartedEvent, JobStatusEnum, JobsFeature, ListScheduledJobsContract, MemoryJobQueue, PING_JOB_TYPE, PingPayloadSchema, QueueStatsModel, ScalewaySqsJobQueue, ScheduledJobEntity, ScheduledJobModel, ScheduledJobTriggeredEvent, ToggleScheduledJobContract, calculateBackoff, createGmailSyncHandler, createScheduler, createStorageDocumentHandler, defineJobType, defineSchedule, jobEntities, jobsSchemaContribution, pingJob, registerAllJobs, registerDefinedJob };

package/dist/jobs.feature.js

@@ -1 +1,101 @@
-const e={meta:{key:`jobs`,title:`Background Jobs`,description:`Background job processing, scheduling, and queue management`,domain:`platform`,owners:[`@platform.jobs`],tags:[`jobs`,`queue`,`background`,`scheduler`],stability:`stable`},operations:[{name:`jobs.enqueue`,version:1},{name:`jobs.cancel`,version:1},{name:`jobs.get`,version:1},{name:`jobs.stats`,version:1},{name:`jobs.schedule.create`,version:1},{name:`jobs.schedule.toggle`,version:1},{name:`jobs.schedule.list`,version:1}],events:[{name:`job.enqueued`,version:1},{name:`job.started`,version:1},{name:`job.completed`,version:1},{name:`job.failed`,version:1},{name:`job.retrying`,version:1},{name:`job.dead_lettered`,version:1},{name:`job.cancelled`,version:1},{name:`scheduler.job_triggered`,version:1}],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{provides:[{key:`jobs`,version:1},{key:`scheduler`,version:1}],requires:[]}};export{e as JobsFeature};
+//#region src/jobs.feature.ts
+/**
+* Jobs feature module that bundles job queue management,
+* background processing, and scheduled task capabilities.
+*/
+const JobsFeature = {
+	meta: {
+		key: "jobs",
+		title: "Background Jobs",
+		description: "Background job processing, scheduling, and queue management",
+		domain: "platform",
+		owners: ["@platform.jobs"],
+		tags: [
+			"jobs",
+			"queue",
+			"background",
+			"scheduler"
+		],
+		stability: "stable"
+	},
+	operations: [
+		{
+			name: "jobs.enqueue",
+			version: 1
+		},
+		{
+			name: "jobs.cancel",
+			version: 1
+		},
+		{
+			name: "jobs.get",
+			version: 1
+		},
+		{
+			name: "jobs.stats",
+			version: 1
+		},
+		{
+			name: "jobs.schedule.create",
+			version: 1
+		},
+		{
+			name: "jobs.schedule.toggle",
+			version: 1
+		},
+		{
+			name: "jobs.schedule.list",
+			version: 1
+		}
+	],
+	events: [
+		{
+			name: "job.enqueued",
+			version: 1
+		},
+		{
+			name: "job.started",
+			version: 1
+		},
+		{
+			name: "job.completed",
+			version: 1
+		},
+		{
+			name: "job.failed",
+			version: 1
+		},
+		{
+			name: "job.retrying",
+			version: 1
+		},
+		{
+			name: "job.dead_lettered",
+			version: 1
+		},
+		{
+			name: "job.cancelled",
+			version: 1
+		},
+		{
+			name: "scheduler.job_triggered",
+			version: 1
+		}
+	],
+	presentations: [],
+	opToPresentation: [],
+	presentationsTargets: [],
+	capabilities: {
+		provides: [{
+			key: "jobs",
+			version: 1
+		}, {
+			key: "scheduler",
+			version: 1
+		}],
+		requires: []
+	}
+};
+
+//#endregion
+export { JobsFeature };

package/dist/queue/gcp-cloud-tasks.js

@@ -1 +1,61 @@
-import{e}from"../contracts/dist/jobs/queue.js";import"./types.js";import{randomUUID as t}from"node:crypto";var n=class{handlers=new Map;constructor(e){this.options=e}async enqueue(n,r,i={}){let a=new Date,o=i.delaySeconds==null?void 0:{seconds:Math.floor(Date.now()/1e3)+i.delaySeconds},s=Buffer.from(JSON.stringify({id:t(),type:n,payload:r}),`utf-8`);return await this.options.client.createTask({parent:`projects/${this.options.projectId}/locations/${this.options.location}/queues/${this.options.queue}`,task:{httpRequest:{httpMethod:`POST`,url:this.options.resolveUrl(n),body:s,headers:{"Content-Type":`application/json`},oidcToken:this.options.serviceAccountEmail?{serviceAccountEmail:this.options.serviceAccountEmail}:void 0},scheduleTime:o}}),{id:t(),type:n,version:1,payload:r,status:`pending`,priority:i.priority??0,attempts:0,maxRetries:i.maxRetries??e.maxRetries,createdAt:a,updatedAt:a,scheduledAt:i.delaySeconds?new Date(a.getTime()+i.delaySeconds*1e3):a,dedupeKey:i.dedupeKey,tenantId:i.tenantId,userId:i.userId,traceId:i.traceId,metadata:i.metadata}}register(e,t){this.handlers.set(e,t)}start(){}async stop(){this.handlers.clear()}};export{n as GcpCloudTasksQueue};
+import { DEFAULT_RETRY_POLICY } from "../contracts/dist/jobs/queue.js";
+import "./types.js";
+import { randomUUID } from "node:crypto";
+
+//#region src/queue/gcp-cloud-tasks.ts
+var GcpCloudTasksQueue = class {
+	handlers = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this.options = options;
+	}
+	async enqueue(jobType, payload, options = {}) {
+		const now = /* @__PURE__ */ new Date();
+		const enqueueTime = options.delaySeconds != null ? { seconds: Math.floor(Date.now() / 1e3) + options.delaySeconds } : void 0;
+		const body = Buffer.from(JSON.stringify({
+			id: randomUUID(),
+			type: jobType,
+			payload
+		}), "utf-8");
+		await this.options.client.createTask({
+			parent: `projects/${this.options.projectId}/locations/${this.options.location}/queues/${this.options.queue}`,
+			task: {
+				httpRequest: {
+					httpMethod: "POST",
+					url: this.options.resolveUrl(jobType),
+					body,
+					headers: { "Content-Type": "application/json" },
+					oidcToken: this.options.serviceAccountEmail ? { serviceAccountEmail: this.options.serviceAccountEmail } : void 0
+				},
+				scheduleTime: enqueueTime
+			}
+		});
+		return {
+			id: randomUUID(),
+			type: jobType,
+			version: 1,
+			payload,
+			status: "pending",
+			priority: options.priority ?? 0,
+			attempts: 0,
+			maxRetries: options.maxRetries ?? DEFAULT_RETRY_POLICY.maxRetries,
+			createdAt: now,
+			updatedAt: now,
+			scheduledAt: options.delaySeconds ? new Date(now.getTime() + options.delaySeconds * 1e3) : now,
+			dedupeKey: options.dedupeKey,
+			tenantId: options.tenantId,
+			userId: options.userId,
+			traceId: options.traceId,
+			metadata: options.metadata
+		};
+	}
+	register(jobType, handler) {
+		this.handlers.set(jobType, handler);
+	}
+	start() {}
+	async stop() {
+		this.handlers.clear();
+	}
+};
+
+//#endregion
+export { GcpCloudTasksQueue };

package/dist/queue/gcp-pubsub.js

@@ -1 +1,47 @@
-import{e}from"../contracts/dist/jobs/queue.js";import"./types.js";import{randomUUID as t}from"node:crypto";var n=class{handlers=new Map;constructor(e){this.options=e}async enqueue(n,r,i={}){let a=new Date;return await this.options.client.topic(this.options.topicName).publishMessage({data:Buffer.from(JSON.stringify({id:t(),type:n,payload:r}),`utf-8`)}),{id:t(),type:n,version:1,payload:r,status:`pending`,priority:i.priority??0,attempts:0,maxRetries:i.maxRetries??e.maxRetries,createdAt:a,updatedAt:a,scheduledAt:i.delaySeconds?new Date(a.getTime()+i.delaySeconds*1e3):a,dedupeKey:i.dedupeKey,tenantId:i.tenantId,userId:i.userId,traceId:i.traceId,metadata:i.metadata}}register(e,t){this.handlers.set(e,t)}start(){}async stop(){this.handlers.clear()}};export{n as GcpPubSubQueue};
+import { DEFAULT_RETRY_POLICY } from "../contracts/dist/jobs/queue.js";
+import "./types.js";
+import { randomUUID } from "node:crypto";
+
+//#region src/queue/gcp-pubsub.ts
+var GcpPubSubQueue = class {
+	handlers = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this.options = options;
+	}
+	async enqueue(jobType, payload, options = {}) {
+		const now = /* @__PURE__ */ new Date();
+		await this.options.client.topic(this.options.topicName).publishMessage({ data: Buffer.from(JSON.stringify({
+			id: randomUUID(),
+			type: jobType,
+			payload
+		}), "utf-8") });
+		return {
+			id: randomUUID(),
+			type: jobType,
+			version: 1,
+			payload,
+			status: "pending",
+			priority: options.priority ?? 0,
+			attempts: 0,
+			maxRetries: options.maxRetries ?? DEFAULT_RETRY_POLICY.maxRetries,
+			createdAt: now,
+			updatedAt: now,
+			scheduledAt: options.delaySeconds ? new Date(now.getTime() + options.delaySeconds * 1e3) : now,
+			dedupeKey: options.dedupeKey,
+			tenantId: options.tenantId,
+			userId: options.userId,
+			traceId: options.traceId,
+			metadata: options.metadata
+		};
+	}
+	register(jobType, handler) {
+		this.handlers.set(jobType, handler);
+	}
+	start() {}
+	async stop() {
+		this.handlers.clear();
+	}
+};
+
+//#endregion
+export { GcpPubSubQueue };

package/dist/queue/index.js

@@ -1 +1,9 @@
-import{e,n as t,t as n}from"../contracts/dist/jobs/queue.js";import"./types.js";import{MemoryJobQueue as r}from"./memory-queue.js";import{ScalewaySqsJobQueue as i}from"./scaleway-sqs-queue.js";import{GcpCloudTasksQueue as a}from"./gcp-cloud-tasks.js";import{GcpPubSubQueue as o}from"./gcp-pubsub.js";import{registerDefinedJob as s}from"./register-defined-job.js";export{e as DEFAULT_RETRY_POLICY,a as GcpCloudTasksQueue,o as GcpPubSubQueue,r as MemoryJobQueue,i as ScalewaySqsJobQueue,n as calculateBackoff,t as defineJobType,s as registerDefinedJob};
+import { DEFAULT_RETRY_POLICY, calculateBackoff, defineJobType } from "../contracts/dist/jobs/queue.js";
+import "./types.js";
+import { MemoryJobQueue } from "./memory-queue.js";
+import { ScalewaySqsJobQueue } from "./scaleway-sqs-queue.js";
+import { GcpCloudTasksQueue } from "./gcp-cloud-tasks.js";
+import { GcpPubSubQueue } from "./gcp-pubsub.js";
+import { registerDefinedJob } from "./register-defined-job.js";
+
+export { DEFAULT_RETRY_POLICY, GcpCloudTasksQueue, GcpPubSubQueue, MemoryJobQueue, ScalewaySqsJobQueue, calculateBackoff, defineJobType, registerDefinedJob };