alepha 0.22.0 → 0.24.0

package/dist/api/jobs/index.browser.js

@@ -1,4 +1,4 @@
-import { $atom, $module, t } from "alepha";
+import { $atom, $module, z } from "alepha";
 import { logEntrySchema } from "alepha/logger";
 import { $entity, db } from "alepha/orm";
 //#region ../../src/api/jobs/entities/jobExecutionEntity.ts
@@ -21,13 +21,22 @@ import { $entity, db } from "alepha/orm";
 */
 const jobExecutionEntity = $entity({
 	name: "job_executions",
-	schema: t.object({
-		id: db.primaryKey(t.uuid()),
+	schema: z.object({
+		id: db.primaryKey(z.uuid()),
 		createdAt: db.createdAt(),
 		updatedAt: db.updatedAt(),
-		jobName: t.text(),
-		key: t.optional(t.nullable(t.text())),
-		status: db.default(t.enum([
+		jobName: z.text(),
+		key: z.text().nullable().optional(),
+		/**
+		* Owning tenant for this execution, when it was pushed in (or for) a tenant
+		* context. Used to org-scope tenant-facing views — notably the notification
+		* admin list, which is backed by this outbox. Nullable: cron / global / non-
+		* tenant pushes carry none. Deliberately NOT `db.organization()`: the job
+		* worker + sweep must see every org's rows, so this stays a plain,
+		* non-auto-scoping column rather than an auto-filtered one.
+		*/
+		organizationId: z.uuid().nullable().optional(),
+		status: db.default(z.enum([
 			"pending",
 			"running",
 			"scheduled",
@@ -35,22 +44,19 @@ const jobExecutionEntity = $entity({
 			"error",
 			"cancelled"
 		]), "pending"),
-		priority: db.default(t.integer({
-			minimum: 0,
-			maximum: 3
-		}), 2),
-		attempt: db.default(t.integer(), 0),
-		maxAttempts: db.default(t.integer(), 1),
-		payload: t.optional(t.record(t.text(), t.any())),
-		scheduledAt: t.optional(t.datetime()),
-		startedAt: t.optional(t.datetime()),
-		completedAt: t.optional(t.datetime()),
-		error: t.optional(t.text()),
-		logs: t.optional(t.array(logEntrySchema)),
-		triggeredBy: t.optional(t.text()),
-		triggeredByName: t.optional(t.text()),
-		cancelledBy: t.optional(t.text()),
-		cancelledByName: t.optional(t.text())
+		priority: db.default(z.integer().min(0).max(3), 2),
+		attempt: db.default(z.integer(), 0),
+		maxAttempts: db.default(z.integer(), 1),
+		payload: z.record(z.text(), z.any()).optional(),
+		scheduledAt: z.datetime().optional(),
+		startedAt: z.datetime().optional(),
+		completedAt: z.datetime().optional(),
+		error: z.text().optional(),
+		logs: z.array(logEntrySchema).optional(),
+		triggeredBy: z.text().optional(),
+		triggeredByName: z.text().optional(),
+		cancelledBy: z.text().optional(),
+		cancelledByName: z.text().optional()
 	}),
 	indexes: [
 		{ columns: [
@@ -75,15 +81,15 @@ const jobExecutionEntity = $entity({
 const jobConfig = $atom({
 	name: "alepha.jobs",
 	description: "Configuration for the $job primitive.",
-	schema: t.object({
-		sweepCron: t.text({ description: "Cron expression for the sweep tick. Must be minute-granular at minimum (cron resolution). On Cloudflare Workers this expression is emitted into wrangler.jsonc by the build." }),
-		trimCron: t.text({ description: "Cron expression for the ring-buffer trim tick (per-job keepLastSuccess/keepLastError enforcement). Decoupled from `sweepCron` because trim is bounded by job execution rate, not retry latency — running it every sweep is wasted work for most apps." }),
-		staleThreshold: t.integer({ description: "Pending age (ms) before the sweep re-dispatches it." }),
-		runTimeout: t.integer({ description: "Running age (ms) before assumed crash (fallback when no per-job timeout)." }),
-		keepLastSuccess: t.integer({ description: "Max successful rows to keep per job. Set 0 to disable and delete on success." }),
-		keepLastError: t.integer({ description: "Max error rows to keep per job." }),
-		logMaxEntries: t.integer({ description: "Max log entries captured per execution." }),
-		drainTimeout: t.integer({ description: "Max time (ms) to wait for in-flight jobs during shutdown." })
+	schema: z.object({
+		sweepCron: z.text({ description: "Cron expression for the sweep tick. Must be minute-granular at minimum (cron resolution). On Cloudflare Workers this expression is emitted into wrangler.jsonc by the build." }),
+		trimCron: z.text({ description: "Cron expression for the ring-buffer trim tick (per-job keepLastSuccess/keepLastError enforcement). Decoupled from `sweepCron` because trim is bounded by job execution rate, not retry latency — running it every sweep is wasted work for most apps." }),
+		staleThreshold: z.integer().describe("Pending age (ms) before the sweep re-dispatches it."),
+		runTimeout: z.integer().describe("Running age (ms) before assumed crash (fallback when no per-job timeout)."),
+		keepLastSuccess: z.integer().describe("Max successful rows to keep per job. Set 0 to disable and delete on success."),
+		keepLastError: z.integer().describe("Max error rows to keep per job."),
+		logMaxEntries: z.integer().describe("Max log entries captured per execution."),
+		drainTimeout: z.integer().describe("Max time (ms) to wait for in-flight jobs during shutdown.")
 	}),
 	default: {
 		sweepCron: "*/15 * * * *",
@@ -98,20 +104,16 @@ const jobConfig = $atom({
 });
 //#endregion
 //#region ../../src/api/jobs/schemas/jobExecutionQuerySchema.ts
-const jobExecutionQuerySchema = t.object({
-	status: t.optional(t.enum([
+const jobExecutionQuerySchema = z.object({
+	status: z.enum([
 		"pending",
 		"running",
 		"scheduled",
 		"ok",
 		"error",
 		"cancelled"
-	])),
-	limit: t.optional(t.integer({
-		minimum: 1,
-		maximum: 200,
-		default: 20
-	}))
+	]).optional(),
+	limit: z.integer().min(1).max(200).default(20).optional()
 });
 //#endregion
 //#region ../../src/api/jobs/schemas/jobExecutionResourceSchema.ts
@@ -125,49 +127,49 @@ const jobExecutionQuerySchema = t.object({
 *   `JobService` is responsible for the int → string transform.
 * - `can` derives the available admin actions from the row's status.
 */
-const jobExecutionResourceSchema = t.extend(t.omit(jobExecutionEntity.schema, ["priority"]), {
-	priority: t.enum([
+const jobExecutionResourceSchema = jobExecutionEntity.schema.omit({ priority: true }).extend({
+	priority: z.enum([
 		"critical",
 		"high",
 		"normal",
 		"low"
 	]),
-	can: t.object({
-		retry: t.boolean(),
-		cancel: t.boolean()
+	can: z.object({
+		retry: z.boolean(),
+		cancel: z.boolean()
 	})
-}, {
+}).meta({
 	title: "JobExecutionResource",
 	description: "A job execution row with derived actions."
 });
 //#endregion
 //#region ../../src/api/jobs/schemas/jobRegistrationSchema.ts
-const jobRegistrationSchema = t.object({
-	name: t.text(),
-	description: t.optional(t.text()),
-	type: t.enum([
+const jobRegistrationSchema = z.object({
+	name: z.text(),
+	description: z.text().optional(),
+	type: z.enum([
 		"cron",
 		"queue",
 		"direct"
-	], { description: "Effective runtime mode. 'cron' = scheduled. 'queue' = push-driven, dispatched via AlephaApiJobsQueue. 'direct' = push-driven, processed in-process (no queue infrastructure loaded), with the sweep as the safety net." }),
-	priority: t.enum([
+	]).describe("Effective runtime mode. 'cron' = scheduled. 'queue' = push-driven, dispatched via AlephaApiJobsQueue. 'direct' = push-driven, processed in-process (no queue infrastructure loaded), with the sweep as the safety net."),
+	priority: z.enum([
 		"critical",
 		"high",
 		"normal",
 		"low"
 	]),
-	cron: t.optional(t.text()),
-	timeout: t.optional(t.text()),
-	retry: t.optional(t.object({ retries: t.integer() })),
-	recent: t.object({
-		ok: t.integer(),
-		error: t.integer(),
-		lastRun: t.optional(t.datetime())
+	cron: z.text().optional(),
+	timeout: z.text().optional(),
+	retry: z.object({ retries: z.integer() }).optional(),
+	recent: z.object({
+		ok: z.integer(),
+		error: z.integer(),
+		lastRun: z.datetime().optional()
 	})
 });
 //#endregion
 //#region ../../src/api/jobs/schemas/triggerJobSchema.ts
-const triggerJobSchema = t.object({ payload: t.optional(t.record(t.text(), t.any())) });
+const triggerJobSchema = z.object({ payload: z.record(z.text(), z.any()).optional() });
 //#endregion
 //#region ../../src/api/jobs/index.browser.ts
 const AlephaApiJobs = $module({

package/dist/api/jobs/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","names":[],"sources":["../../../src/api/jobs/entities/jobExecutionEntity.ts","../../../src/api/jobs/schemas/jobConfigAtom.ts","../../../src/api/jobs/schemas/jobExecutionQuerySchema.ts","../../../src/api/jobs/schemas/jobExecutionResourceSchema.ts","../../../src/api/jobs/schemas/jobRegistrationSchema.ts","../../../src/api/jobs/schemas/triggerJobSchema.ts","../../../src/api/jobs/index.browser.ts"],"sourcesContent":["import { type Static, t } from \"alepha\";\nimport { logEntrySchema } from \"alepha/logger\";\nimport { $entity, db } from \"alepha/orm\";\n\n/**\n * Job execution record.\n *\n * Stores durable state for queue-mode jobs (outbox pattern) and error records\n * for cron-mode jobs. Successful executions are trimmed by the sweep to keep\n * the last N rows per job (configurable via `jobConfig.keepLastSuccess`).\n *\n * Status transitions:\n * - queue push            → pending (or `scheduled` if `delay`/`scheduledAt` was given)\n * - worker claim          → running\n * - success               → ok (or row deleted, depending on `record` and `keepLastSuccess`)\n * - terminal failure      → error\n * - retryable failure     → scheduled (with scheduledAt = now; sweep picks it up)\n * - delay                 → scheduled (with scheduledAt = now + delay)\n * - sweep picks due ones  → pending\n * - cancel                → cancelled\n */\nexport const jobExecutionEntity = $entity({\n  name: \"job_executions\",\n  schema: t.object({\n    id: db.primaryKey(t.uuid()),\n    createdAt: db.createdAt(),\n    updatedAt: db.updatedAt(),\n\n    jobName: t.text(),\n    key: t.optional(t.nullable(t.text())),\n\n    status: db.default(\n      t.enum([\"pending\", \"running\", \"scheduled\", \"ok\", \"error\", \"cancelled\"]),\n      \"pending\",\n    ),\n    priority: db.default(t.integer({ minimum: 0, maximum: 3 }), 2),\n\n    attempt: db.default(t.integer(), 0),\n    maxAttempts: db.default(t.integer(), 1),\n\n    payload: t.optional(t.record(t.text(), t.any())),\n\n    scheduledAt: t.optional(t.datetime()),\n    startedAt: t.optional(t.datetime()),\n    completedAt: t.optional(t.datetime()),\n\n    error: t.optional(t.text()),\n    logs: t.optional(t.array(logEntrySchema)),\n\n    triggeredBy: t.optional(t.text()),\n    triggeredByName: t.optional(t.text()),\n    cancelledBy: t.optional(t.text()),\n    cancelledByName: t.optional(t.text()),\n  }),\n  indexes: [\n    { columns: [\"jobName\", \"status\", \"scheduledAt\"] },\n    { columns: [\"jobName\", \"status\", \"createdAt\"] },\n    { columns: [\"jobName\", \"startedAt\"] },\n    { columns: [\"jobName\", \"key\"], unique: true },\n  ],\n});\n\nexport type JobExecutionEntity = Static<typeof jobExecutionEntity.schema>;\n\nexport type JobStatus =\n  | \"pending\"\n  | \"running\"\n  | \"scheduled\"\n  | \"ok\"\n  | \"error\"\n  | \"cancelled\";\n","import { $atom, type Static, t } from \"alepha\";\n\nexport const jobConfig = $atom({\n  name: \"alepha.jobs\",\n  description: \"Configuration for the $job primitive.\",\n  schema: t.object({\n    sweepCron: t.text({\n      description:\n        \"Cron expression for the sweep tick. Must be minute-granular at minimum (cron resolution). On Cloudflare Workers this expression is emitted into wrangler.jsonc by the build.\",\n    }),\n    trimCron: t.text({\n      description:\n        \"Cron expression for the ring-buffer trim tick (per-job keepLastSuccess/keepLastError enforcement). Decoupled from `sweepCron` because trim is bounded by job execution rate, not retry latency — running it every sweep is wasted work for most apps.\",\n    }),\n    staleThreshold: t.integer({\n      description: \"Pending age (ms) before the sweep re-dispatches it.\",\n    }),\n    runTimeout: t.integer({\n      description:\n        \"Running age (ms) before assumed crash (fallback when no per-job timeout).\",\n    }),\n    keepLastSuccess: t.integer({\n      description:\n        \"Max successful rows to keep per job. Set 0 to disable and delete on success.\",\n    }),\n    keepLastError: t.integer({\n      description: \"Max error rows to keep per job.\",\n    }),\n    logMaxEntries: t.integer({\n      description: \"Max log entries captured per execution.\",\n    }),\n    drainTimeout: t.integer({\n      description: \"Max time (ms) to wait for in-flight jobs during shutdown.\",\n    }),\n  }),\n  default: {\n    sweepCron: \"*/15 * * * *\",\n    trimCron: \"0 * * * *\",\n    staleThreshold: 300_000,\n    runTimeout: 1_800_000,\n    keepLastSuccess: 10,\n    keepLastError: 10,\n    logMaxEntries: 100,\n    drainTimeout: 30_000,\n  },\n});\n\nexport type JobConfig = Static<typeof jobConfig.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [jobConfig.key]: JobConfig;\n  }\n}\n","import { type Static, t } from \"alepha\";\n\nexport const jobExecutionQuerySchema = t.object({\n  status: t.optional(\n    t.enum([\"pending\", \"running\", \"scheduled\", \"ok\", \"error\", \"cancelled\"]),\n  ),\n  limit: t.optional(t.integer({ minimum: 1, maximum: 200, default: 20 })),\n});\n\nexport type JobExecutionQuery = Static<typeof jobExecutionQuerySchema>;\n","import { type Static, t } from \"alepha\";\nimport { jobExecutionEntity } from \"../entities/jobExecutionEntity.ts\";\n\n/**\n * Public-facing schema for a job execution row.\n *\n * Diverges from the raw entity in two places, both for API ergonomics:\n *\n * - `priority` is exposed as the **string enum** (`critical`/`high`/...)\n *   instead of the numeric value used internally for SQL ordering. The\n *   `JobService` is responsible for the int → string transform.\n * - `can` derives the available admin actions from the row's status.\n */\nexport const jobExecutionResourceSchema = t.extend(\n  // `t.extend` composes (interface-extends), it does not override: the base\n  // `priority` (integer) would still be enforced alongside the enum below and\n  // reject the int→string transform. Drop it from the base first.\n  t.omit(jobExecutionEntity.schema, [\"priority\"]),\n  {\n    priority: t.enum([\"critical\", \"high\", \"normal\", \"low\"]),\n    can: t.object({\n      retry: t.boolean(),\n      cancel: t.boolean(),\n    }),\n  },\n  {\n    title: \"JobExecutionResource\",\n    description: \"A job execution row with derived actions.\",\n  },\n);\n\nexport type JobExecutionResource = Static<typeof jobExecutionResourceSchema>;\n","import { type Static, t } from \"alepha\";\n\nexport const jobRegistrationSchema = t.object({\n  name: t.text(),\n  description: t.optional(t.text()),\n  type: t.enum([\"cron\", \"queue\", \"direct\"], {\n    description:\n      \"Effective runtime mode. 'cron' = scheduled. 'queue' = push-driven, dispatched via AlephaApiJobsQueue. 'direct' = push-driven, processed in-process (no queue infrastructure loaded), with the sweep as the safety net.\",\n  }),\n  priority: t.enum([\"critical\", \"high\", \"normal\", \"low\"]),\n  cron: t.optional(t.text()),\n  timeout: t.optional(t.text()),\n  retry: t.optional(\n    t.object({\n      retries: t.integer(),\n    }),\n  ),\n  recent: t.object({\n    ok: t.integer(),\n    error: t.integer(),\n    lastRun: t.optional(t.datetime()),\n  }),\n});\n\nexport type JobRegistration = Static<typeof jobRegistrationSchema>;\n","import { type Static, t } from \"alepha\";\n\nexport const triggerJobSchema = t.object({\n  payload: t.optional(t.record(t.text(), t.any())),\n});\n\nexport type TriggerJob = Static<typeof triggerJobSchema>;\n","import { $module } from \"alepha\";\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport * from \"./entities/jobExecutionEntity.ts\";\nexport * from \"./schemas/jobConfigAtom.ts\";\nexport * from \"./schemas/jobExecutionQuerySchema.ts\";\nexport * from \"./schemas/jobExecutionResourceSchema.ts\";\nexport * from \"./schemas/jobRegistrationSchema.ts\";\nexport * from \"./schemas/triggerJobSchema.ts\";\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport const AlephaApiJobs = $module({\n  name: \"alepha.api.jobs\",\n  services: [],\n});\n\nexport const AlephaApiJobsQueue = $module({\n  name: \"alepha.api.jobs.queue\",\n  services: [],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.browser.js","names":[],"sources":["../../../src/api/jobs/entities/jobExecutionEntity.ts","../../../src/api/jobs/schemas/jobConfigAtom.ts","../../../src/api/jobs/schemas/jobExecutionQuerySchema.ts","../../../src/api/jobs/schemas/jobExecutionResourceSchema.ts","../../../src/api/jobs/schemas/jobRegistrationSchema.ts","../../../src/api/jobs/schemas/triggerJobSchema.ts","../../../src/api/jobs/index.browser.ts"],"sourcesContent":["import { type Static, z } from \"alepha\";\nimport { logEntrySchema } from \"alepha/logger\";\nimport { $entity, db } from \"alepha/orm\";\n\n/**\n * Job execution record.\n *\n * Stores durable state for queue-mode jobs (outbox pattern) and error records\n * for cron-mode jobs. Successful executions are trimmed by the sweep to keep\n * the last N rows per job (configurable via `jobConfig.keepLastSuccess`).\n *\n * Status transitions:\n * - queue push            → pending (or `scheduled` if `delay`/`scheduledAt` was given)\n * - worker claim          → running\n * - success               → ok (or row deleted, depending on `record` and `keepLastSuccess`)\n * - terminal failure      → error\n * - retryable failure     → scheduled (with scheduledAt = now; sweep picks it up)\n * - delay                 → scheduled (with scheduledAt = now + delay)\n * - sweep picks due ones  → pending\n * - cancel                → cancelled\n */\nexport const jobExecutionEntity = $entity({\n  name: \"job_executions\",\n  schema: z.object({\n    id: db.primaryKey(z.uuid()),\n    createdAt: db.createdAt(),\n    updatedAt: db.updatedAt(),\n\n    jobName: z.text(),\n    key: z.text().nullable().optional(),\n\n    /**\n     * Owning tenant for this execution, when it was pushed in (or for) a tenant\n     * context. Used to org-scope tenant-facing views — notably the notification\n     * admin list, which is backed by this outbox. Nullable: cron / global / non-\n     * tenant pushes carry none. Deliberately NOT `db.organization()`: the job\n     * worker + sweep must see every org's rows, so this stays a plain,\n     * non-auto-scoping column rather than an auto-filtered one.\n     */\n    organizationId: z.uuid().nullable().optional(),\n\n    status: db.default(\n      z.enum([\"pending\", \"running\", \"scheduled\", \"ok\", \"error\", \"cancelled\"]),\n      \"pending\",\n    ),\n    priority: db.default(z.integer().min(0).max(3), 2),\n\n    attempt: db.default(z.integer(), 0),\n    maxAttempts: db.default(z.integer(), 1),\n\n    payload: z.record(z.text(), z.any()).optional(),\n\n    scheduledAt: z.datetime().optional(),\n    startedAt: z.datetime().optional(),\n    completedAt: z.datetime().optional(),\n\n    error: z.text().optional(),\n    logs: z.array(logEntrySchema).optional(),\n\n    triggeredBy: z.text().optional(),\n    triggeredByName: z.text().optional(),\n    cancelledBy: z.text().optional(),\n    cancelledByName: z.text().optional(),\n  }),\n  indexes: [\n    { columns: [\"jobName\", \"status\", \"scheduledAt\"] },\n    { columns: [\"jobName\", \"status\", \"createdAt\"] },\n    { columns: [\"jobName\", \"startedAt\"] },\n    { columns: [\"jobName\", \"key\"], unique: true },\n  ],\n});\n\nexport type JobExecutionEntity = Static<typeof jobExecutionEntity.schema>;\n\nexport type JobStatus =\n  | \"pending\"\n  | \"running\"\n  | \"scheduled\"\n  | \"ok\"\n  | \"error\"\n  | \"cancelled\";\n","import { $atom, type Static, z } from \"alepha\";\n\nexport const jobConfig = $atom({\n  name: \"alepha.jobs\",\n  description: \"Configuration for the $job primitive.\",\n  schema: z.object({\n    sweepCron: z.text({\n      description:\n        \"Cron expression for the sweep tick. Must be minute-granular at minimum (cron resolution). On Cloudflare Workers this expression is emitted into wrangler.jsonc by the build.\",\n    }),\n    trimCron: z.text({\n      description:\n        \"Cron expression for the ring-buffer trim tick (per-job keepLastSuccess/keepLastError enforcement). Decoupled from `sweepCron` because trim is bounded by job execution rate, not retry latency — running it every sweep is wasted work for most apps.\",\n    }),\n    staleThreshold: z\n      .integer()\n      .describe(\"Pending age (ms) before the sweep re-dispatches it.\"),\n    runTimeout: z\n      .integer()\n      .describe(\n        \"Running age (ms) before assumed crash (fallback when no per-job timeout).\",\n      ),\n    keepLastSuccess: z\n      .integer()\n      .describe(\n        \"Max successful rows to keep per job. Set 0 to disable and delete on success.\",\n      ),\n    keepLastError: z.integer().describe(\"Max error rows to keep per job.\"),\n    logMaxEntries: z\n      .integer()\n      .describe(\"Max log entries captured per execution.\"),\n    drainTimeout: z\n      .integer()\n      .describe(\"Max time (ms) to wait for in-flight jobs during shutdown.\"),\n  }),\n  default: {\n    sweepCron: \"*/15 * * * *\",\n    trimCron: \"0 * * * *\",\n    staleThreshold: 300_000,\n    runTimeout: 1_800_000,\n    keepLastSuccess: 10,\n    keepLastError: 10,\n    logMaxEntries: 100,\n    drainTimeout: 30_000,\n  },\n});\n\nexport type JobConfig = Static<typeof jobConfig.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [jobConfig.key]: JobConfig;\n  }\n}\n","import { type Static, z } from \"alepha\";\n\nexport const jobExecutionQuerySchema = z.object({\n  status: z\n    .enum([\"pending\", \"running\", \"scheduled\", \"ok\", \"error\", \"cancelled\"])\n    .optional(),\n  limit: z.integer().min(1).max(200).default(20).optional(),\n});\n\nexport type JobExecutionQuery = Static<typeof jobExecutionQuerySchema>;\n","import { type Static, z } from \"alepha\";\nimport { jobExecutionEntity } from \"../entities/jobExecutionEntity.ts\";\n\n/**\n * Public-facing schema for a job execution row.\n *\n * Diverges from the raw entity in two places, both for API ergonomics:\n *\n * - `priority` is exposed as the **string enum** (`critical`/`high`/...)\n *   instead of the numeric value used internally for SQL ordering. The\n *   `JobService` is responsible for the int → string transform.\n * - `can` derives the available admin actions from the row's status.\n */\nexport const jobExecutionResourceSchema = jobExecutionEntity.schema\n  .omit({ priority: true })\n  .extend({\n    priority: z.enum([\"critical\", \"high\", \"normal\", \"low\"]),\n    can: z.object({\n      retry: z.boolean(),\n      cancel: z.boolean(),\n    }),\n  })\n  .meta({\n    title: \"JobExecutionResource\",\n    description: \"A job execution row with derived actions.\",\n  });\n\nexport type JobExecutionResource = Static<typeof jobExecutionResourceSchema>;\n","import { type Static, z } from \"alepha\";\n\nexport const jobRegistrationSchema = z.object({\n  name: z.text(),\n  description: z.text().optional(),\n  type: z\n    .enum([\"cron\", \"queue\", \"direct\"])\n    .describe(\n      \"Effective runtime mode. 'cron' = scheduled. 'queue' = push-driven, dispatched via AlephaApiJobsQueue. 'direct' = push-driven, processed in-process (no queue infrastructure loaded), with the sweep as the safety net.\",\n    ),\n  priority: z.enum([\"critical\", \"high\", \"normal\", \"low\"]),\n  cron: z.text().optional(),\n  timeout: z.text().optional(),\n  retry: z\n    .object({\n      retries: z.integer(),\n    })\n    .optional(),\n  recent: z.object({\n    ok: z.integer(),\n    error: z.integer(),\n    lastRun: z.datetime().optional(),\n  }),\n});\n\nexport type JobRegistration = Static<typeof jobRegistrationSchema>;\n","import { type Static, z } from \"alepha\";\n\nexport const triggerJobSchema = z.object({\n  payload: z.record(z.text(), z.any()).optional(),\n});\n\nexport type TriggerJob = Static<typeof triggerJobSchema>;\n","import { $module } from \"alepha\";\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport * from \"./entities/jobExecutionEntity.ts\";\nexport * from \"./schemas/jobConfigAtom.ts\";\nexport * from \"./schemas/jobExecutionQuerySchema.ts\";\nexport * from \"./schemas/jobExecutionResourceSchema.ts\";\nexport * from \"./schemas/jobRegistrationSchema.ts\";\nexport * from \"./schemas/triggerJobSchema.ts\";\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport const AlephaApiJobs = $module({\n  name: \"alepha.api.jobs\",\n  services: [],\n});\n\nexport const AlephaApiJobsQueue = $module({\n  name: \"alepha.api.jobs.queue\",\n  services: [],\n});\n"],"mappings":"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"}