@open-mercato/core 0.4.5-develop-995ce486fa → 0.4.5-develop-8a56591995

package/dist/modules/progress/lib/progressServiceImpl.js

@@ -0,0 +1,215 @@
+import { ProgressJob } from "../data/entities.js";
+import { calculateEta, calculateProgressPercent, STALE_JOB_TIMEOUT_SECONDS } from "./progressService.js";
+import { PROGRESS_EVENTS } from "./events.js";
+function createProgressService(em, eventBus) {
+  return {
+    async createJob(input, ctx) {
+      const job = em.create(ProgressJob, {
+        jobType: input.jobType,
+        name: input.name,
+        description: input.description,
+        totalCount: input.totalCount,
+        cancellable: input.cancellable ?? false,
+        meta: input.meta,
+        parentJobId: input.parentJobId,
+        partitionIndex: input.partitionIndex,
+        partitionCount: input.partitionCount,
+        startedByUserId: ctx.userId,
+        tenantId: ctx.tenantId,
+        organizationId: ctx.organizationId,
+        status: "pending"
+      });
+      await em.persistAndFlush(job);
+      await eventBus.emit(PROGRESS_EVENTS.JOB_CREATED, {
+        jobId: job.id,
+        jobType: job.jobType,
+        name: job.name,
+        tenantId: ctx.tenantId,
+        organizationId: ctx.organizationId
+      });
+      return job;
+    },
+    async startJob(jobId, ctx) {
+      const job = await em.findOneOrFail(ProgressJob, { id: jobId, tenantId: ctx.tenantId });
+      job.status = "running";
+      job.startedAt = /* @__PURE__ */ new Date();
+      job.heartbeatAt = /* @__PURE__ */ new Date();
+      await em.flush();
+      await eventBus.emit(PROGRESS_EVENTS.JOB_STARTED, {
+        jobId: job.id,
+        jobType: job.jobType,
+        tenantId: ctx.tenantId
+      });
+      return job;
+    },
+    async updateProgress(jobId, input, ctx) {
+      const job = await em.findOneOrFail(ProgressJob, { id: jobId, tenantId: ctx.tenantId });
+      if (input.processedCount !== void 0) {
+        job.processedCount = input.processedCount;
+      }
+      if (input.totalCount !== void 0) {
+        job.totalCount = input.totalCount;
+      }
+      if (input.meta !== void 0) {
+        job.meta = { ...job.meta, ...input.meta };
+      }
+      if (input.progressPercent !== void 0) {
+        job.progressPercent = input.progressPercent;
+      } else if (job.totalCount) {
+        job.progressPercent = calculateProgressPercent(job.processedCount, job.totalCount);
+      }
+      if (input.etaSeconds !== void 0) {
+        job.etaSeconds = input.etaSeconds;
+      } else if (job.startedAt && job.totalCount) {
+        job.etaSeconds = calculateEta(job.processedCount, job.totalCount, job.startedAt);
+      }
+      job.heartbeatAt = /* @__PURE__ */ new Date();
+      await em.flush();
+      await eventBus.emit(PROGRESS_EVENTS.JOB_UPDATED, {
+        jobId: job.id,
+        jobType: job.jobType,
+        progressPercent: job.progressPercent,
+        processedCount: job.processedCount,
+        totalCount: job.totalCount,
+        etaSeconds: job.etaSeconds,
+        tenantId: ctx.tenantId
+      });
+      return job;
+    },
+    async incrementProgress(jobId, delta, ctx) {
+      const job = await em.findOneOrFail(ProgressJob, { id: jobId, tenantId: ctx.tenantId });
+      job.processedCount += delta;
+      job.heartbeatAt = /* @__PURE__ */ new Date();
+      if (job.totalCount) {
+        job.progressPercent = calculateProgressPercent(job.processedCount, job.totalCount);
+        if (job.startedAt) {
+          job.etaSeconds = calculateEta(job.processedCount, job.totalCount, job.startedAt);
+        }
+      }
+      await em.flush();
+      await eventBus.emit(PROGRESS_EVENTS.JOB_UPDATED, {
+        jobId: job.id,
+        progressPercent: job.progressPercent,
+        processedCount: job.processedCount,
+        tenantId: ctx.tenantId
+      });
+      return job;
+    },
+    async completeJob(jobId, input, ctx) {
+      const job = await em.findOne(ProgressJob, { id: jobId, tenantId: ctx.tenantId });
+      if (!job) throw new Error(`Job ${jobId} not found`);
+      job.status = "completed";
+      job.finishedAt = /* @__PURE__ */ new Date();
+      job.progressPercent = 100;
+      job.etaSeconds = 0;
+      if (input?.resultSummary) {
+        job.resultSummary = input.resultSummary;
+      }
+      await em.flush();
+      await eventBus.emit(PROGRESS_EVENTS.JOB_COMPLETED, {
+        jobId: job.id,
+        jobType: job.jobType,
+        resultSummary: job.resultSummary,
+        tenantId: ctx.tenantId
+      });
+      return job;
+    },
+    async failJob(jobId, input, ctx) {
+      const job = await em.findOne(ProgressJob, { id: jobId, tenantId: ctx.tenantId });
+      if (!job) throw new Error(`Job ${jobId} not found`);
+      job.status = "failed";
+      job.finishedAt = /* @__PURE__ */ new Date();
+      job.errorMessage = input.errorMessage;
+      job.errorStack = input.errorStack;
+      await em.flush();
+      await eventBus.emit(PROGRESS_EVENTS.JOB_FAILED, {
+        jobId: job.id,
+        jobType: job.jobType,
+        errorMessage: job.errorMessage,
+        tenantId: ctx.tenantId
+      });
+      return job;
+    },
+    async cancelJob(jobId, ctx) {
+      const job = await em.findOneOrFail(ProgressJob, {
+        id: jobId,
+        tenantId: ctx.tenantId,
+        cancellable: true,
+        status: { $in: ["pending", "running"] }
+      });
+      job.cancelRequestedAt = /* @__PURE__ */ new Date();
+      job.cancelledByUserId = ctx.userId;
+      if (job.status === "pending") {
+        job.status = "cancelled";
+        job.finishedAt = /* @__PURE__ */ new Date();
+      }
+      await em.flush();
+      await eventBus.emit(PROGRESS_EVENTS.JOB_CANCELLED, {
+        jobId: job.id,
+        jobType: job.jobType,
+        tenantId: ctx.tenantId
+      });
+      return job;
+    },
+    async isCancellationRequested(jobId) {
+      const job = await em.findOne(ProgressJob, { id: jobId });
+      return job?.cancelRequestedAt != null;
+    },
+    async getActiveJobs(ctx) {
+      return em.find(ProgressJob, {
+        tenantId: ctx.tenantId,
+        ...ctx.organizationId ? { organizationId: ctx.organizationId } : {},
+        status: { $in: ["pending", "running"] },
+        parentJobId: null
+      }, {
+        orderBy: { createdAt: "DESC" },
+        limit: 50
+      });
+    },
+    async getRecentlyCompletedJobs(ctx, sinceSeconds = 30) {
+      const cutoff = new Date(Date.now() - sinceSeconds * 1e3);
+      return em.find(ProgressJob, {
+        tenantId: ctx.tenantId,
+        ...ctx.organizationId ? { organizationId: ctx.organizationId } : {},
+        status: { $in: ["completed", "failed"] },
+        finishedAt: { $gte: cutoff },
+        parentJobId: null
+      }, {
+        orderBy: { finishedAt: "DESC" },
+        limit: 10
+      });
+    },
+    async getJob(jobId, ctx) {
+      return em.findOne(ProgressJob, {
+        id: jobId,
+        tenantId: ctx.tenantId
+      });
+    },
+    async markStaleJobsFailed(tenantId, timeoutSeconds = STALE_JOB_TIMEOUT_SECONDS) {
+      const cutoff = new Date(Date.now() - timeoutSeconds * 1e3);
+      const staleJobs = await em.find(ProgressJob, {
+        tenantId,
+        status: "running",
+        heartbeatAt: { $lt: cutoff }
+      });
+      for (const job of staleJobs) {
+        job.status = "failed";
+        job.finishedAt = /* @__PURE__ */ new Date();
+        job.errorMessage = `Job stale: no heartbeat for ${timeoutSeconds} seconds`;
+        await eventBus.emit(PROGRESS_EVENTS.JOB_FAILED, {
+          jobId: job.id,
+          jobType: job.jobType,
+          errorMessage: job.errorMessage,
+          tenantId: job.tenantId,
+          stale: true
+        });
+      }
+      await em.flush();
+      return staleJobs.length;
+    }
+  };
+}
+export {
+  createProgressService
+};
+//# sourceMappingURL=progressServiceImpl.js.map

package/dist/modules/progress/lib/progressServiceImpl.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/progress/lib/progressServiceImpl.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/core'\nimport { ProgressJob } from '../data/entities'\nimport type { ProgressService } from './progressService'\nimport { calculateEta, calculateProgressPercent, STALE_JOB_TIMEOUT_SECONDS } from './progressService'\nimport { PROGRESS_EVENTS } from './events'\n\nexport function createProgressService(em: EntityManager, eventBus: { emit: (event: string, payload: Record<string, unknown>) => Promise<void> }): ProgressService {\n  return {\n    async createJob(input, ctx) {\n      const job = em.create(ProgressJob, {\n        jobType: input.jobType,\n        name: input.name,\n        description: input.description,\n        totalCount: input.totalCount,\n        cancellable: input.cancellable ?? false,\n        meta: input.meta,\n        parentJobId: input.parentJobId,\n        partitionIndex: input.partitionIndex,\n        partitionCount: input.partitionCount,\n        startedByUserId: ctx.userId,\n        tenantId: ctx.tenantId,\n        organizationId: ctx.organizationId,\n        status: 'pending',\n      })\n\n      await em.persistAndFlush(job)\n\n      await eventBus.emit(PROGRESS_EVENTS.JOB_CREATED, {\n        jobId: job.id,\n        jobType: job.jobType,\n        name: job.name,\n        tenantId: ctx.tenantId,\n        organizationId: ctx.organizationId,\n      })\n\n      return job\n    },\n\n    async startJob(jobId, ctx) {\n      const job = await em.findOneOrFail(ProgressJob, { id: jobId, tenantId: ctx.tenantId })\n\n      job.status = 'running'\n      job.startedAt = new Date()\n      job.heartbeatAt = new Date()\n\n      await em.flush()\n\n      await eventBus.emit(PROGRESS_EVENTS.JOB_STARTED, {\n        jobId: job.id,\n        jobType: job.jobType,\n        tenantId: ctx.tenantId,\n      })\n\n      return job\n    },\n\n    async updateProgress(jobId, input, ctx) {\n      const job = await em.findOneOrFail(ProgressJob, { id: jobId, tenantId: ctx.tenantId })\n\n      if (input.processedCount !== undefined) {\n        job.processedCount = input.processedCount\n      }\n      if (input.totalCount !== undefined) {\n        job.totalCount = input.totalCount\n      }\n      if (input.meta !== undefined) {\n        job.meta = { ...job.meta, ...input.meta }\n      }\n\n      if (input.progressPercent !== undefined) {\n        job.progressPercent = input.progressPercent\n      } else if (job.totalCount) {\n        job.progressPercent = calculateProgressPercent(job.processedCount, job.totalCount)\n      }\n\n      if (input.etaSeconds !== undefined) {\n        job.etaSeconds = input.etaSeconds\n      } else if (job.startedAt && job.totalCount) {\n        job.etaSeconds = calculateEta(job.processedCount, job.totalCount, job.startedAt)\n      }\n\n      job.heartbeatAt = new Date()\n\n      await em.flush()\n\n      await eventBus.emit(PROGRESS_EVENTS.JOB_UPDATED, {\n        jobId: job.id,\n        jobType: job.jobType,\n        progressPercent: job.progressPercent,\n        processedCount: job.processedCount,\n        totalCount: job.totalCount,\n        etaSeconds: job.etaSeconds,\n        tenantId: ctx.tenantId,\n      })\n\n      return job\n    },\n\n    async incrementProgress(jobId, delta, ctx) {\n      const job = await em.findOneOrFail(ProgressJob, { id: jobId, tenantId: ctx.tenantId })\n\n      job.processedCount += delta\n      job.heartbeatAt = new Date()\n\n      if (job.totalCount) {\n        job.progressPercent = calculateProgressPercent(job.processedCount, job.totalCount)\n        if (job.startedAt) {\n          job.etaSeconds = calculateEta(job.processedCount, job.totalCount, job.startedAt)\n        }\n      }\n\n      await em.flush()\n\n      await eventBus.emit(PROGRESS_EVENTS.JOB_UPDATED, {\n        jobId: job.id,\n        progressPercent: job.progressPercent,\n        processedCount: job.processedCount,\n        tenantId: ctx.tenantId,\n      })\n\n      return job\n    },\n\n    async completeJob(jobId, input, ctx) {\n      const job = await em.findOne(ProgressJob, { id: jobId, tenantId: ctx.tenantId })\n      if (!job) throw new Error(`Job ${jobId} not found`)\n\n      job.status = 'completed'\n      job.finishedAt = new Date()\n      job.progressPercent = 100\n      job.etaSeconds = 0\n      if (input?.resultSummary) {\n        job.resultSummary = input.resultSummary\n      }\n\n      await em.flush()\n\n      await eventBus.emit(PROGRESS_EVENTS.JOB_COMPLETED, {\n        jobId: job.id,\n        jobType: job.jobType,\n        resultSummary: job.resultSummary,\n        tenantId: ctx.tenantId,\n      })\n\n      return job\n    },\n\n    async failJob(jobId, input, ctx) {\n      const job = await em.findOne(ProgressJob, { id: jobId, tenantId: ctx.tenantId })\n      if (!job) throw new Error(`Job ${jobId} not found`)\n\n      job.status = 'failed'\n      job.finishedAt = new Date()\n      job.errorMessage = input.errorMessage\n      job.errorStack = input.errorStack\n\n      await em.flush()\n\n      await eventBus.emit(PROGRESS_EVENTS.JOB_FAILED, {\n        jobId: job.id,\n        jobType: job.jobType,\n        errorMessage: job.errorMessage,\n        tenantId: ctx.tenantId,\n      })\n\n      return job\n    },\n\n    async cancelJob(jobId, ctx) {\n      const job = await em.findOneOrFail(ProgressJob, {\n        id: jobId,\n        tenantId: ctx.tenantId,\n        cancellable: true,\n        status: { $in: ['pending', 'running'] },\n      })\n\n      job.cancelRequestedAt = new Date()\n      job.cancelledByUserId = ctx.userId\n\n      if (job.status === 'pending') {\n        job.status = 'cancelled'\n        job.finishedAt = new Date()\n      }\n\n      await em.flush()\n\n      await eventBus.emit(PROGRESS_EVENTS.JOB_CANCELLED, {\n        jobId: job.id,\n        jobType: job.jobType,\n        tenantId: ctx.tenantId,\n      })\n\n      return job\n    },\n\n    async isCancellationRequested(jobId) {\n      const job = await em.findOne(ProgressJob, { id: jobId })\n      return job?.cancelRequestedAt != null\n    },\n\n    async getActiveJobs(ctx) {\n      return em.find(ProgressJob, {\n        tenantId: ctx.tenantId,\n        ...(ctx.organizationId ? { organizationId: ctx.organizationId } : {}),\n        status: { $in: ['pending', 'running'] },\n        parentJobId: null,\n      }, {\n        orderBy: { createdAt: 'DESC' },\n        limit: 50,\n      })\n    },\n\n    async getRecentlyCompletedJobs(ctx, sinceSeconds = 30) {\n      const cutoff = new Date(Date.now() - sinceSeconds * 1000)\n      return em.find(ProgressJob, {\n        tenantId: ctx.tenantId,\n        ...(ctx.organizationId ? { organizationId: ctx.organizationId } : {}),\n        status: { $in: ['completed', 'failed'] },\n        finishedAt: { $gte: cutoff },\n        parentJobId: null,\n      }, {\n        orderBy: { finishedAt: 'DESC' },\n        limit: 10,\n      })\n    },\n\n    async getJob(jobId, ctx) {\n      return em.findOne(ProgressJob, {\n        id: jobId,\n        tenantId: ctx.tenantId,\n      })\n    },\n\n    async markStaleJobsFailed(tenantId: string, timeoutSeconds = STALE_JOB_TIMEOUT_SECONDS) {\n      const cutoff = new Date(Date.now() - timeoutSeconds * 1000)\n\n      const staleJobs = await em.find(ProgressJob, {\n        tenantId,\n        status: 'running',\n        heartbeatAt: { $lt: cutoff },\n      })\n\n      for (const job of staleJobs) {\n        job.status = 'failed'\n        job.finishedAt = new Date()\n        job.errorMessage = `Job stale: no heartbeat for ${timeoutSeconds} seconds`\n\n        await eventBus.emit(PROGRESS_EVENTS.JOB_FAILED, {\n          jobId: job.id,\n          jobType: job.jobType,\n          errorMessage: job.errorMessage,\n          tenantId: job.tenantId,\n          stale: true,\n        })\n      }\n\n      await em.flush()\n      return staleJobs.length\n    },\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/progress/migrations/Migration20260220214819.js

@@ -0,0 +1,16 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260220214819 extends Migration {
+  async up() {
+    this.addSql(`create table "progress_jobs" ("id" uuid not null default gen_random_uuid(), "job_type" text not null, "name" text not null, "description" text null, "status" text not null default 'pending', "progress_percent" smallint not null default 0, "processed_count" int not null default 0, "total_count" int null, "eta_seconds" int null, "started_by_user_id" uuid null, "started_at" timestamptz null, "heartbeat_at" timestamptz null, "finished_at" timestamptz null, "result_summary" jsonb null, "error_message" text null, "error_stack" text null, "meta" jsonb null, "cancellable" boolean not null default false, "cancelled_by_user_id" uuid null, "cancel_requested_at" timestamptz null, "parent_job_id" uuid null, "partition_index" int null, "partition_count" int null, "tenant_id" uuid not null, "organization_id" uuid null, "created_at" timestamptz not null, "updated_at" timestamptz not null, constraint "progress_jobs_pkey" primary key ("id"));`);
+    this.addSql(`create index "progress_jobs_parent_idx" on "progress_jobs" ("parent_job_id");`);
+    this.addSql(`create index "progress_jobs_type_tenant_idx" on "progress_jobs" ("job_type", "tenant_id");`);
+    this.addSql(`create index "progress_jobs_status_tenant_idx" on "progress_jobs" ("status", "tenant_id");`);
+  }
+  async down() {
+    this.addSql(`drop table if exists "progress_jobs";`);
+  }
+}
+export {
+  Migration20260220214819
+};
+//# sourceMappingURL=Migration20260220214819.js.map

package/dist/modules/progress/migrations/Migration20260220214819.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/progress/migrations/Migration20260220214819.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\nexport class Migration20260220214819 extends Migration {\n\n  override async up(): Promise<void> {\n    this.addSql(`create table \"progress_jobs\" (\"id\" uuid not null default gen_random_uuid(), \"job_type\" text not null, \"name\" text not null, \"description\" text null, \"status\" text not null default 'pending', \"progress_percent\" smallint not null default 0, \"processed_count\" int not null default 0, \"total_count\" int null, \"eta_seconds\" int null, \"started_by_user_id\" uuid null, \"started_at\" timestamptz null, \"heartbeat_at\" timestamptz null, \"finished_at\" timestamptz null, \"result_summary\" jsonb null, \"error_message\" text null, \"error_stack\" text null, \"meta\" jsonb null, \"cancellable\" boolean not null default false, \"cancelled_by_user_id\" uuid null, \"cancel_requested_at\" timestamptz null, \"parent_job_id\" uuid null, \"partition_index\" int null, \"partition_count\" int null, \"tenant_id\" uuid not null, \"organization_id\" uuid null, \"created_at\" timestamptz not null, \"updated_at\" timestamptz not null, constraint \"progress_jobs_pkey\" primary key (\"id\"));`);\n    this.addSql(`create index \"progress_jobs_parent_idx\" on \"progress_jobs\" (\"parent_job_id\");`);\n    this.addSql(`create index \"progress_jobs_type_tenant_idx\" on \"progress_jobs\" (\"job_type\", \"tenant_id\");`);\n    this.addSql(`create index \"progress_jobs_status_tenant_idx\" on \"progress_jobs\" (\"status\", \"tenant_id\");`);\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`drop table if exists \"progress_jobs\";`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,gCAAgC,UAAU;AAAA,EAErD,MAAe,KAAoB;AACjC,SAAK,OAAO,46BAA46B;AACx7B,SAAK,OAAO,+EAA+E;AAC3F,SAAK,OAAO,4FAA4F;AACxG,SAAK,OAAO,4FAA4F;AAAA,EAC1G;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,uCAAuC;AAAA,EACrD;AACF;",
+  "names": []
+}

package/dist/modules/progress/setup.js

@@ -0,0 +1,12 @@
+const setup = {
+  defaultRoleFeatures: {
+    admin: ["progress.*"],
+    employee: ["progress.view"]
+  }
+};
+var setup_default = setup;
+export {
+  setup_default as default,
+  setup
+};
+//# sourceMappingURL=setup.js.map

package/dist/modules/progress/setup.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/progress/setup.ts"],
+  "sourcesContent": ["import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'\n\nexport const setup: ModuleSetupConfig = {\n  defaultRoleFeatures: {\n    admin: ['progress.*'],\n    employee: ['progress.view'],\n  },\n}\n\nexport default setup\n"],
+  "mappings": "AAEO,MAAM,QAA2B;AAAA,EACtC,qBAAqB;AAAA,IACnB,OAAO,CAAC,YAAY;AAAA,IACpB,UAAU,CAAC,eAAe;AAAA,EAC5B;AACF;AAEA,IAAO,gBAAQ;",
+  "names": []
+}

package/generated/entities/progress_job/index.ts

@@ -0,0 +1,27 @@
+export const id = 'id'
+export const job_type = 'job_type'
+export const name = 'name'
+export const description = 'description'
+export const status = 'status'
+export const progress_percent = 'progress_percent'
+export const processed_count = 'processed_count'
+export const total_count = 'total_count'
+export const eta_seconds = 'eta_seconds'
+export const started_by_user_id = 'started_by_user_id'
+export const started_at = 'started_at'
+export const heartbeat_at = 'heartbeat_at'
+export const finished_at = 'finished_at'
+export const result_summary = 'result_summary'
+export const error_message = 'error_message'
+export const error_stack = 'error_stack'
+export const meta = 'meta'
+export const cancellable = 'cancellable'
+export const cancelled_by_user_id = 'cancelled_by_user_id'
+export const cancel_requested_at = 'cancel_requested_at'
+export const parent_job_id = 'parent_job_id'
+export const partition_index = 'partition_index'
+export const partition_count = 'partition_count'
+export const tenant_id = 'tenant_id'
+export const organization_id = 'organization_id'
+export const created_at = 'created_at'
+export const updated_at = 'updated_at'

package/generated/entities.ids.generated.ts

@@ -23,6 +23,7 @@ export const M = {
   "resources": "resources",
   "staff": "staff",
   "notifications": "notifications",
+  "progress": "progress",
   "translations": "translations",
   "inbox_ops": "inbox_ops"
 } as const
@@ -190,6 +191,9 @@ export const E = {
   "notifications": {
     "notification": "notifications:notification"
   },
+  "progress": {
+    "progress_job": "progress:progress_job"
+  },
   "translations": {
     "entity_translation": "translations:entity_translation"
   },

package/generated/entity-fields-registry.ts

@@ -65,6 +65,7 @@ import * as password_reset from './entities/password_reset/index'
 import * as perspective from './entities/perspective/index'
 import * as planner_availability_rule from './entities/planner_availability_rule/index'
 import * as planner_availability_rule_set from './entities/planner_availability_rule_set/index'
+import * as progress_job from './entities/progress_job/index'
 import * as resources_resource from './entities/resources_resource/index'
 import * as resources_resource_activity from './entities/resources_resource_activity/index'
 import * as resources_resource_comment from './entities/resources_resource_comment/index'
@@ -192,6 +193,7 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
   perspective,
   planner_availability_rule,
   planner_availability_rule_set,
+  progress_job,
   resources_resource,
   resources_resource_activity,
   resources_resource_comment,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.4.5-develop-995ce486fa",
+  "version": "0.4.5-develop-8a56591995",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
@@ -207,7 +207,7 @@
     }
   },
   "dependencies": {
-    "@open-mercato/shared": "0.4.5-develop-995ce486fa",
+    "@open-mercato/shared": "0.4.5-develop-8a56591995",
     "@types/semver": "^7.5.8",
     "@xyflow/react": "^12.6.0",
     "ai": "^6.0.0",

package/src/modules/progress/__integration__/TC-PROG-001.spec.ts

@@ -0,0 +1,67 @@
+import { test, expect } from '@playwright/test';
+import { getAuthToken, apiRequest } from '@open-mercato/core/modules/core/__integration__/helpers/api';
+
+/**
+ * TC-PROG-001: Progress Job Lifecycle
+ * Covers: create, list active, update progress, cancel
+ */
+test.describe('TC-PROG-001: Progress Job Lifecycle', () => {
+  test('should create, list, update, and cancel a progress job', async ({ request }) => {
+    let token: string | null = null;
+    let jobId: string | null = null;
+
+    try {
+      token = await getAuthToken(request);
+
+      // 1. Create a job via POST /api/progress/jobs
+      const createRes = await apiRequest(request, 'POST', '/api/progress/jobs', {
+        token,
+        data: {
+          jobType: 'integration-test',
+          name: `QA TC-PROG-001 ${Date.now()}`,
+          totalCount: 200,
+          cancellable: true,
+        },
+      });
+      expect(createRes.status()).toBe(201);
+      const createBody = await createRes.json();
+      expect(createBody.id).toBeTruthy();
+      jobId = createBody.id;
+
+      // 2. Verify it appears in GET /api/progress/active
+      const activeRes = await apiRequest(request, 'GET', '/api/progress/active', { token });
+      expect(activeRes.ok()).toBeTruthy();
+      const activeBody = await activeRes.json();
+      const activeIds = activeBody.active.map((j: { id: string }) => j.id);
+      expect(activeIds).toContain(jobId);
+
+      // 3. Update progress via PUT /api/progress/jobs/:id
+      const updateRes = await apiRequest(request, 'PUT', `/api/progress/jobs/${jobId}`, {
+        token,
+        data: { processedCount: 80, totalCount: 200 },
+      });
+      expect(updateRes.ok()).toBeTruthy();
+      const updateBody = await updateRes.json();
+      expect(updateBody.ok).toBe(true);
+      expect(updateBody.progressPercent).toBe(40);
+
+      // 4. Cancel job via DELETE /api/progress/jobs/:id
+      const cancelRes = await apiRequest(request, 'DELETE', `/api/progress/jobs/${jobId}`, { token });
+      expect(cancelRes.ok()).toBeTruthy();
+      const cancelBody = await cancelRes.json();
+      expect(cancelBody.ok).toBe(true);
+
+      // 5. Verify the job is now cancelled (pending jobs cancel immediately)
+      const detailRes = await apiRequest(request, 'GET', `/api/progress/jobs/${jobId}`, { token });
+      expect(detailRes.ok()).toBeTruthy();
+      const detailBody = await detailRes.json();
+      expect(detailBody.status).toBe('cancelled');
+    } finally {
+      // Jobs are soft state — no explicit cleanup needed.
+      // If the test created a job that wasn't cancelled, cancel it to keep state clean.
+      if (token && jobId) {
+        await apiRequest(request, 'DELETE', `/api/progress/jobs/${jobId}`, { token }).catch(() => {});
+      }
+    }
+  });
+});