@contractspec/lib.jobs 0.0.0-canary-20260113162409

package/dist/contracts/index.js

@@ -0,0 +1,482 @@
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts";
+
+//#region src/contracts/index.ts
+const OWNERS = ["platform.jobs"];
+const 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
+		}
+	}
+});
+const 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
+		}
+	}
+});
+const 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
+		}
+	}
+});
+const 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
+		}
+	}
+});
+const GetJobInput = defineSchemaModel({
+	name: "GetJobInput",
+	description: "Input for getting a job by ID",
+	fields: { jobId: {
+		type: ScalarTypeEnum.String_unsecure(),
+		isOptional: false
+	} }
+});
+const CancelJobInput = defineSchemaModel({
+	name: "CancelJobInput",
+	description: "Input for cancelling a job",
+	fields: { jobId: {
+		type: ScalarTypeEnum.String_unsecure(),
+		isOptional: false
+	} }
+});
+const CancelJobOutput = defineSchemaModel({
+	name: "CancelJobOutput",
+	description: "Output for cancel job operation",
+	fields: { success: {
+		type: ScalarTypeEnum.Boolean(),
+		isOptional: false
+	} }
+});
+const 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
+		}
+	}
+});
+const ListScheduledJobsOutput = defineSchemaModel({
+	name: "ListScheduledJobsOutput",
+	description: "Output for listing scheduled jobs",
+	fields: { schedules: {
+		type: ScheduledJobModel,
+		isArray: true,
+		isOptional: false
+	} }
+});
+const 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
+		}
+	}
+});
+const 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
+		}
+	}
+});
+const JobCancelledPayload = defineSchemaModel({
+	name: "JobCancelledPayload",
+	description: "Payload for job.cancelled event",
+	fields: { jobId: {
+		type: ScalarTypeEnum.String_unsecure(),
+		isOptional: false
+	} }
+});
+/**
+* Enqueue a job.
+*/
+const 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
+	}] }
+});
+/**
+* Get job by ID.
+*/
+const 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" }
+});
+/**
+* Cancel a job.
+*/
+const 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
+	}] }
+});
+/**
+* Get queue statistics.
+*/
+const 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" }
+});
+/**
+* Create a scheduled job.
+*/
+const 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" }
+});
+/**
+* List scheduled jobs.
+*/
+const 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" }
+});
+/**
+* Toggle scheduled job enabled state.
+*/
+const 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" }
+});
+
+//#endregion
+export { CancelJobContract, CreateScheduledJobContract, EnqueueJobContract, GetJobContract, GetQueueStatsContract, JobModel, ListScheduledJobsContract, QueueStatsModel, ScheduledJobModel, ToggleScheduledJobContract };
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

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

package/dist/entities/index.d.ts

@@ -0,0 +1,145 @@
+import * as _contractspec_lib_schema95 from "@contractspec/lib.schema";
+import { ModuleSchemaContribution } from "@contractspec/lib.schema";
+
+//#region src/entities/index.d.ts
+/**
+ * Job status enum.
+ */
+declare const JobStatusEnum: _contractspec_lib_schema95.EntityEnumDef;
+/**
+ * Job entity - represents a single job execution.
+ */
+declare const JobEntity: _contractspec_lib_schema95.EntitySpec<{
+  id: _contractspec_lib_schema95.EntityScalarField;
+  type: _contractspec_lib_schema95.EntityScalarField;
+  version: _contractspec_lib_schema95.EntityScalarField;
+  payload: _contractspec_lib_schema95.EntityScalarField;
+  status: _contractspec_lib_schema95.EntityEnumField;
+  priority: _contractspec_lib_schema95.EntityScalarField;
+  attempts: _contractspec_lib_schema95.EntityScalarField;
+  maxRetries: _contractspec_lib_schema95.EntityScalarField;
+  lastError: _contractspec_lib_schema95.EntityScalarField;
+  lastErrorStack: _contractspec_lib_schema95.EntityScalarField;
+  scheduledAt: _contractspec_lib_schema95.EntityScalarField;
+  startedAt: _contractspec_lib_schema95.EntityScalarField;
+  completedAt: _contractspec_lib_schema95.EntityScalarField;
+  timeoutAt: _contractspec_lib_schema95.EntityScalarField;
+  dedupeKey: _contractspec_lib_schema95.EntityScalarField;
+  tenantId: _contractspec_lib_schema95.EntityScalarField;
+  userId: _contractspec_lib_schema95.EntityScalarField;
+  traceId: _contractspec_lib_schema95.EntityScalarField;
+  metadata: _contractspec_lib_schema95.EntityScalarField;
+  result: _contractspec_lib_schema95.EntityScalarField;
+  createdAt: _contractspec_lib_schema95.EntityScalarField;
+  updatedAt: _contractspec_lib_schema95.EntityScalarField;
+  scheduledJob: _contractspec_lib_schema95.EntityRelationField;
+  scheduledJobId: _contractspec_lib_schema95.EntityScalarField;
+  executions: _contractspec_lib_schema95.EntityRelationField;
+}>;
+/**
+ * ScheduledJob entity - recurring job definitions.
+ */
+declare const ScheduledJobEntity: _contractspec_lib_schema95.EntitySpec<{
+  id: _contractspec_lib_schema95.EntityScalarField;
+  name: _contractspec_lib_schema95.EntityScalarField;
+  description: _contractspec_lib_schema95.EntityScalarField;
+  cronExpression: _contractspec_lib_schema95.EntityScalarField;
+  timezone: _contractspec_lib_schema95.EntityScalarField;
+  jobType: _contractspec_lib_schema95.EntityScalarField;
+  jobVersion: _contractspec_lib_schema95.EntityScalarField;
+  payload: _contractspec_lib_schema95.EntityScalarField;
+  maxRetries: _contractspec_lib_schema95.EntityScalarField;
+  timeoutMs: _contractspec_lib_schema95.EntityScalarField;
+  enabled: _contractspec_lib_schema95.EntityScalarField;
+  lastRunAt: _contractspec_lib_schema95.EntityScalarField;
+  nextRunAt: _contractspec_lib_schema95.EntityScalarField;
+  tenantId: _contractspec_lib_schema95.EntityScalarField;
+  createdAt: _contractspec_lib_schema95.EntityScalarField;
+  updatedAt: _contractspec_lib_schema95.EntityScalarField;
+  jobs: _contractspec_lib_schema95.EntityRelationField;
+}>;
+/**
+ * JobExecution entity - individual execution attempts.
+ */
+declare const JobExecutionEntity: _contractspec_lib_schema95.EntitySpec<{
+  id: _contractspec_lib_schema95.EntityScalarField;
+  jobId: _contractspec_lib_schema95.EntityScalarField;
+  attemptNumber: _contractspec_lib_schema95.EntityScalarField;
+  startedAt: _contractspec_lib_schema95.EntityScalarField;
+  completedAt: _contractspec_lib_schema95.EntityScalarField;
+  durationMs: _contractspec_lib_schema95.EntityScalarField;
+  success: _contractspec_lib_schema95.EntityScalarField;
+  error: _contractspec_lib_schema95.EntityScalarField;
+  errorStack: _contractspec_lib_schema95.EntityScalarField;
+  result: _contractspec_lib_schema95.EntityScalarField;
+  workerId: _contractspec_lib_schema95.EntityScalarField;
+  job: _contractspec_lib_schema95.EntityRelationField;
+}>;
+/**
+ * All job entities for schema composition.
+ */
+declare const jobEntities: (_contractspec_lib_schema95.EntitySpec<{
+  id: _contractspec_lib_schema95.EntityScalarField;
+  type: _contractspec_lib_schema95.EntityScalarField;
+  version: _contractspec_lib_schema95.EntityScalarField;
+  payload: _contractspec_lib_schema95.EntityScalarField;
+  status: _contractspec_lib_schema95.EntityEnumField;
+  priority: _contractspec_lib_schema95.EntityScalarField;
+  attempts: _contractspec_lib_schema95.EntityScalarField;
+  maxRetries: _contractspec_lib_schema95.EntityScalarField;
+  lastError: _contractspec_lib_schema95.EntityScalarField;
+  lastErrorStack: _contractspec_lib_schema95.EntityScalarField;
+  scheduledAt: _contractspec_lib_schema95.EntityScalarField;
+  startedAt: _contractspec_lib_schema95.EntityScalarField;
+  completedAt: _contractspec_lib_schema95.EntityScalarField;
+  timeoutAt: _contractspec_lib_schema95.EntityScalarField;
+  dedupeKey: _contractspec_lib_schema95.EntityScalarField;
+  tenantId: _contractspec_lib_schema95.EntityScalarField;
+  userId: _contractspec_lib_schema95.EntityScalarField;
+  traceId: _contractspec_lib_schema95.EntityScalarField;
+  metadata: _contractspec_lib_schema95.EntityScalarField;
+  result: _contractspec_lib_schema95.EntityScalarField;
+  createdAt: _contractspec_lib_schema95.EntityScalarField;
+  updatedAt: _contractspec_lib_schema95.EntityScalarField;
+  scheduledJob: _contractspec_lib_schema95.EntityRelationField;
+  scheduledJobId: _contractspec_lib_schema95.EntityScalarField;
+  executions: _contractspec_lib_schema95.EntityRelationField;
+}> | _contractspec_lib_schema95.EntitySpec<{
+  id: _contractspec_lib_schema95.EntityScalarField;
+  name: _contractspec_lib_schema95.EntityScalarField;
+  description: _contractspec_lib_schema95.EntityScalarField;
+  cronExpression: _contractspec_lib_schema95.EntityScalarField;
+  timezone: _contractspec_lib_schema95.EntityScalarField;
+  jobType: _contractspec_lib_schema95.EntityScalarField;
+  jobVersion: _contractspec_lib_schema95.EntityScalarField;
+  payload: _contractspec_lib_schema95.EntityScalarField;
+  maxRetries: _contractspec_lib_schema95.EntityScalarField;
+  timeoutMs: _contractspec_lib_schema95.EntityScalarField;
+  enabled: _contractspec_lib_schema95.EntityScalarField;
+  lastRunAt: _contractspec_lib_schema95.EntityScalarField;
+  nextRunAt: _contractspec_lib_schema95.EntityScalarField;
+  tenantId: _contractspec_lib_schema95.EntityScalarField;
+  createdAt: _contractspec_lib_schema95.EntityScalarField;
+  updatedAt: _contractspec_lib_schema95.EntityScalarField;
+  jobs: _contractspec_lib_schema95.EntityRelationField;
+}> | _contractspec_lib_schema95.EntitySpec<{
+  id: _contractspec_lib_schema95.EntityScalarField;
+  jobId: _contractspec_lib_schema95.EntityScalarField;
+  attemptNumber: _contractspec_lib_schema95.EntityScalarField;
+  startedAt: _contractspec_lib_schema95.EntityScalarField;
+  completedAt: _contractspec_lib_schema95.EntityScalarField;
+  durationMs: _contractspec_lib_schema95.EntityScalarField;
+  success: _contractspec_lib_schema95.EntityScalarField;
+  error: _contractspec_lib_schema95.EntityScalarField;
+  errorStack: _contractspec_lib_schema95.EntityScalarField;
+  result: _contractspec_lib_schema95.EntityScalarField;
+  workerId: _contractspec_lib_schema95.EntityScalarField;
+  job: _contractspec_lib_schema95.EntityRelationField;
+}>)[];
+/**
+ * Module schema contribution for jobs.
+ */
+declare const jobsSchemaContribution: ModuleSchemaContribution;
+//#endregion
+export { JobEntity, JobExecutionEntity, JobStatusEnum, ScheduledJobEntity, jobEntities, jobsSchemaContribution };
+//# sourceMappingURL=index.d.ts.map

package/dist/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/entities/index.ts"],"sourcesContent":[],"mappings":";;;;;;;AAWa,cAAA,aAYX,EAAA,0BAAA,CAZwB,aAYxB;AAKF;;;cAAa,sCAAS;MA4FpB,0BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;8DA5FoB;EAAA,cAAA,8CAAA;EAiGT,UAAA,gDAkDX;CAAA,CAAA;;;;cAlDW,+CAAkB;MAkD7B,0BAAA,CAAA;;;;;;;;;;;;yDAlD6B;EAAA,QAAA,8CAAA;EAuDlB,SAAA,8CA+BX;EAAA,SAAA,8CAAA;;;;;;cA/BW,+CAAkB;MA+B7B,0BAAA,CAAA;;;;;0DA/B6B;EAAA,OAAA,8CAAA;EAoClB,KAAA,8CAAiE;EAAA,UAAA,8CAAA;;;;;;;;cAAjE,yCAAW;MAAsD,0BAAA,CAAA;;;;;;;;;;;;;;;;sDAAtD;EAAA,OAAA,8CAAA;;;;;;;;;MAAA,0BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;EAKX,UAAA,8CAIZ;;;;;;;;;;;cAJY,wBAAwB"}