@contractspec/lib.jobs 1.57.0 → 1.59.0

package/dist/jobs.capability.d.ts

@@ -1,8 +1,3 @@
-import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
-
-//#region src/jobs.capability.d.ts
-declare const JobsCapability: _contractspec_lib_contracts0.CapabilitySpec;
-declare const SchedulerCapability: _contractspec_lib_contracts0.CapabilitySpec;
-//#endregion
-export { JobsCapability, SchedulerCapability };
+export declare const JobsCapability: import("@contractspec/lib.contracts").CapabilitySpec;
+export declare const SchedulerCapability: import("@contractspec/lib.contracts").CapabilitySpec;
 //# sourceMappingURL=jobs.capability.d.ts.map

package/dist/jobs.capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.capability.d.ts","names":[],"sources":["../src/jobs.capability.ts"],"mappings":";;;cAEa,cAAA,EAUX,4BAAA,CAVyB,cAAA;AAAA,cAYd,mBAAA,EAUX,4BAAA,CAV8B,cAAA"}
+{"version":3,"file":"jobs.capability.d.ts","sourceRoot":"","sources":["../src/jobs.capability.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,sDAUzB,CAAC;AAEH,eAAO,MAAM,mBAAmB,sDAU9B,CAAC"}

package/dist/jobs.capability.js

@@ -1,33 +1,29 @@
-import { StabilityEnum, defineCapability } from "@contractspec/lib.contracts";
-
-//#region src/jobs.capability.ts
-const JobsCapability = defineCapability({ meta: {
-	key: "jobs",
-	version: "1.0.0",
-	kind: "api",
-	stability: StabilityEnum.Experimental,
-	description: "Background job processing",
-	owners: ["@platform.core"],
-	tags: [
-		"jobs",
-		"background",
-		"async"
-	]
-} });
-const SchedulerCapability = defineCapability({ meta: {
-	key: "scheduler",
-	version: "1.0.0",
-	kind: "api",
-	stability: StabilityEnum.Experimental,
-	description: "Scheduled job execution",
-	owners: ["@platform.core"],
-	tags: [
-		"scheduler",
-		"cron",
-		"jobs"
-	]
-} });
-
-//#endregion
-export { JobsCapability, SchedulerCapability };
-//# sourceMappingURL=jobs.capability.js.map
+// @bun
+// src/jobs.capability.ts
+import { defineCapability, StabilityEnum } from "@contractspec/lib.contracts";
+var JobsCapability = defineCapability({
+  meta: {
+    key: "jobs",
+    version: "1.0.0",
+    kind: "api",
+    stability: StabilityEnum.Experimental,
+    description: "Background job processing",
+    owners: ["@platform.core"],
+    tags: ["jobs", "background", "async"]
+  }
+});
+var SchedulerCapability = defineCapability({
+  meta: {
+    key: "scheduler",
+    version: "1.0.0",
+    kind: "api",
+    stability: StabilityEnum.Experimental,
+    description: "Scheduled job execution",
+    owners: ["@platform.core"],
+    tags: ["scheduler", "cron", "jobs"]
+  }
+});
+export {
+  SchedulerCapability,
+  JobsCapability
+};

package/dist/jobs.feature.d.ts

@@ -1,11 +1,6 @@
-import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
-
-//#region src/jobs.feature.d.ts
 /**
  * Jobs feature module that bundles background job processing,
  * queues, and scheduling capabilities.
  */
-declare const JobsFeature: _contractspec_lib_contracts0.FeatureModuleSpec;
-//#endregion
-export { JobsFeature };
+export declare const JobsFeature: import("@contractspec/lib.contracts").FeatureModuleSpec;
 //# sourceMappingURL=jobs.feature.d.ts.map

package/dist/jobs.feature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.feature.d.ts","names":[],"sources":["../src/jobs.feature.ts"],"mappings":";;;;;;AAWA;cAAa,WAAA,EAsDX,4BAAA,CAtDsB,iBAAA"}
+{"version":3,"file":"jobs.feature.d.ts","sourceRoot":"","sources":["../src/jobs.feature.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,eAAO,MAAM,WAAW,yDAsDtB,CAAC"}

package/dist/jobs.feature.js

@@ -1,110 +1,47 @@
+// @bun
+// src/jobs.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts";
-
-//#region src/jobs.feature.ts
-/**
-* Jobs Feature Module Specification
-*
-* Defines the feature module for background job processing and scheduling.
-*/
-/**
-* Jobs feature module that bundles background job processing,
-* queues, and scheduling capabilities.
-*/
-const JobsFeature = defineFeature({
-	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",
-		version: "1.0.0"
-	},
-	operations: [
-		{
-			key: "jobs.enqueue",
-			version: "1.0.0"
-		},
-		{
-			key: "jobs.cancel",
-			version: "1.0.0"
-		},
-		{
-			key: "jobs.get",
-			version: "1.0.0"
-		},
-		{
-			key: "jobs.stats",
-			version: "1.0.0"
-		},
-		{
-			key: "jobs.schedule.create",
-			version: "1.0.0"
-		},
-		{
-			key: "jobs.schedule.toggle",
-			version: "1.0.0"
-		},
-		{
-			key: "jobs.schedule.list",
-			version: "1.0.0"
-		}
-	],
-	events: [
-		{
-			key: "job.enqueued",
-			version: "1.0.0"
-		},
-		{
-			key: "job.started",
-			version: "1.0.0"
-		},
-		{
-			key: "job.completed",
-			version: "1.0.0"
-		},
-		{
-			key: "job.failed",
-			version: "1.0.0"
-		},
-		{
-			key: "job.retrying",
-			version: "1.0.0"
-		},
-		{
-			key: "job.dead_lettered",
-			version: "1.0.0"
-		},
-		{
-			key: "job.cancelled",
-			version: "1.0.0"
-		},
-		{
-			key: "scheduler.job_triggered",
-			version: "1.0.0"
-		}
-	],
-	presentations: [],
-	opToPresentation: [],
-	presentationsTargets: [],
-	capabilities: {
-		provides: [{
-			key: "jobs",
-			version: "1.0.0"
-		}, {
-			key: "scheduler",
-			version: "1.0.0"
-		}],
-		requires: []
-	}
+var JobsFeature = defineFeature({
+  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",
+    version: "1.0.0"
+  },
+  operations: [
+    { key: "jobs.enqueue", version: "1.0.0" },
+    { key: "jobs.cancel", version: "1.0.0" },
+    { key: "jobs.get", version: "1.0.0" },
+    { key: "jobs.stats", version: "1.0.0" },
+    { key: "jobs.schedule.create", version: "1.0.0" },
+    { key: "jobs.schedule.toggle", version: "1.0.0" },
+    { key: "jobs.schedule.list", version: "1.0.0" }
+  ],
+  events: [
+    { key: "job.enqueued", version: "1.0.0" },
+    { key: "job.started", version: "1.0.0" },
+    { key: "job.completed", version: "1.0.0" },
+    { key: "job.failed", version: "1.0.0" },
+    { key: "job.retrying", version: "1.0.0" },
+    { key: "job.dead_lettered", version: "1.0.0" },
+    { key: "job.cancelled", version: "1.0.0" },
+    { key: "scheduler.job_triggered", version: "1.0.0" }
+  ],
+  presentations: [],
+  opToPresentation: [],
+  presentationsTargets: [],
+  capabilities: {
+    provides: [
+      { key: "jobs", version: "1.0.0" },
+      { key: "scheduler", version: "1.0.0" }
+    ],
+    requires: []
+  }
 });
-
-//#endregion
-export { JobsFeature };
-//# sourceMappingURL=jobs.feature.js.map
+export {
+  JobsFeature
+};

package/dist/node/contracts/index.js

@@ -0,0 +1,318 @@
+// src/contracts/index.ts
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts";
+var OWNERS = ["platform.jobs"];
+var JobModel = defineSchemaModel({
+  name: "Job",
+  description: "Represents a background job",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    type: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    version: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    payload: { type: ScalarTypeEnum.JSON(), isOptional: false },
+    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    priority: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    attempts: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    maxRetries: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    scheduledAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    lastError: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+var ScheduledJobModel = defineSchemaModel({
+  name: "ScheduledJob",
+  description: "Represents a scheduled/recurring job",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    cronExpression: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    timezone: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jobType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    enabled: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+    lastRunAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    nextRunAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var QueueStatsModel = defineSchemaModel({
+  name: "QueueStats",
+  description: "Job queue statistics",
+  fields: {
+    pending: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    running: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    completed: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    failed: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    deadLetter: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false }
+  }
+});
+var EnqueueJobInput = defineSchemaModel({
+  name: "EnqueueJobInput",
+  description: "Input for enqueuing a new job",
+  fields: {
+    type: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    payload: { type: ScalarTypeEnum.JSON(), isOptional: false },
+    delaySeconds: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    dedupeKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    maxRetries: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    priority: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    timeoutMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true }
+  }
+});
+var GetJobInput = defineSchemaModel({
+  name: "GetJobInput",
+  description: "Input for getting a job by ID",
+  fields: {
+    jobId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var CancelJobInput = defineSchemaModel({
+  name: "CancelJobInput",
+  description: "Input for cancelling a job",
+  fields: {
+    jobId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var CancelJobOutput = defineSchemaModel({
+  name: "CancelJobOutput",
+  description: "Output for cancel job operation",
+  fields: {
+    success: { type: ScalarTypeEnum.Boolean(), isOptional: false }
+  }
+});
+var CreateScheduledJobInput = defineSchemaModel({
+  name: "CreateScheduledJobInput",
+  description: "Input for creating a scheduled job",
+  fields: {
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    cronExpression: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    timezone: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    jobType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    payload: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    maxRetries: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    enabled: { type: ScalarTypeEnum.Boolean(), isOptional: true }
+  }
+});
+var ListScheduledJobsOutput = defineSchemaModel({
+  name: "ListScheduledJobsOutput",
+  description: "Output for listing scheduled jobs",
+  fields: {
+    schedules: { type: ScheduledJobModel, isArray: true, isOptional: false }
+  }
+});
+var ToggleScheduledJobInput = defineSchemaModel({
+  name: "ToggleScheduledJobInput",
+  description: "Input for toggling a scheduled job",
+  fields: {
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    enabled: { type: ScalarTypeEnum.Boolean(), isOptional: false }
+  }
+});
+var JobEnqueuedPayload = defineSchemaModel({
+  name: "JobEnqueuedPayload",
+  description: "Payload for job.enqueued event",
+  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 }
+  }
+});
+var JobCancelledPayload = defineSchemaModel({
+  name: "JobCancelledPayload",
+  description: "Payload for job.cancelled event",
+  fields: {
+    jobId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var EnqueueJobContract = defineCommand({
+  meta: {
+    key: "jobs.enqueue",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["jobs", "enqueue"],
+    description: "Enqueue a background job for async processing.",
+    goal: "Allow services to offload work to background processing.",
+    context: "Called by any service that needs async processing."
+  },
+  io: {
+    input: EnqueueJobInput,
+    output: JobModel
+  },
+  policy: {
+    auth: "user"
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: "job.enqueued",
+        version: "1.0.0",
+        when: "Job is enqueued",
+        payload: JobEnqueuedPayload
+      }
+    ]
+  }
+});
+var GetJobContract = defineQuery({
+  meta: {
+    key: "jobs.get",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["jobs", "get"],
+    description: "Get a job by ID.",
+    goal: "Check job status and result.",
+    context: "Called to poll job status or retrieve results."
+  },
+  io: {
+    input: GetJobInput,
+    output: JobModel
+  },
+  policy: {
+    auth: "user"
+  }
+});
+var CancelJobContract = defineCommand({
+  meta: {
+    key: "jobs.cancel",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["jobs", "cancel"],
+    description: "Cancel a pending job.",
+    goal: "Allow cancellation of jobs that are no longer needed.",
+    context: "Only pending jobs can be cancelled."
+  },
+  io: {
+    input: CancelJobInput,
+    output: CancelJobOutput,
+    errors: {
+      JOB_NOT_FOUND: {
+        description: "Job does not exist",
+        http: 404,
+        gqlCode: "JOB_NOT_FOUND",
+        when: "Job ID is invalid"
+      },
+      JOB_NOT_PENDING: {
+        description: "Job is not in pending state",
+        http: 409,
+        gqlCode: "JOB_NOT_PENDING",
+        when: "Job has already started or completed"
+      }
+    }
+  },
+  policy: {
+    auth: "user"
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: "job.cancelled",
+        version: "1.0.0",
+        when: "Job is cancelled",
+        payload: JobCancelledPayload
+      }
+    ]
+  }
+});
+var GetQueueStatsContract = defineQuery({
+  meta: {
+    key: "jobs.stats",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["jobs", "stats", "admin"],
+    description: "Get job queue statistics.",
+    goal: "Monitor queue health and backlog.",
+    context: "Admin dashboard monitoring."
+  },
+  io: {
+    input: null,
+    output: QueueStatsModel
+  },
+  policy: {
+    auth: "admin"
+  }
+});
+var CreateScheduledJobContract = defineCommand({
+  meta: {
+    key: "jobs.schedule.create",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["jobs", "schedule", "create"],
+    description: "Create a scheduled/recurring job.",
+    goal: "Set up recurring background tasks.",
+    context: "Admin configuration for periodic tasks."
+  },
+  io: {
+    input: CreateScheduledJobInput,
+    output: ScheduledJobModel
+  },
+  policy: {
+    auth: "admin"
+  }
+});
+var ListScheduledJobsContract = defineQuery({
+  meta: {
+    key: "jobs.schedule.list",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["jobs", "schedule", "list"],
+    description: "List all scheduled jobs.",
+    goal: "View configured recurring tasks.",
+    context: "Admin dashboard."
+  },
+  io: {
+    input: null,
+    output: ListScheduledJobsOutput
+  },
+  policy: {
+    auth: "admin"
+  }
+});
+var ToggleScheduledJobContract = defineCommand({
+  meta: {
+    key: "jobs.schedule.toggle",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["jobs", "schedule", "toggle"],
+    description: "Enable or disable a scheduled job.",
+    goal: "Control when recurring tasks run.",
+    context: "Admin control over scheduled tasks."
+  },
+  io: {
+    input: ToggleScheduledJobInput,
+    output: ScheduledJobModel
+  },
+  policy: {
+    auth: "admin"
+  }
+});
+export {
+  ToggleScheduledJobContract,
+  ScheduledJobModel,
+  QueueStatsModel,
+  ListScheduledJobsContract,
+  JobModel,
+  GetQueueStatsContract,
+  GetJobContract,
+  EnqueueJobContract,
+  CreateScheduledJobContract,
+  CancelJobContract
+};