@shivaedev/jobs 0.29.2 → 0.31.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +39 -0
- package/README.md +74 -22
- package/dist/display.d.ts +14 -0
- package/dist/display.d.ts.map +1 -0
- package/dist/display.js +2 -0
- package/dist/display.js.map +1 -0
- package/dist/server/ClientDatabase.d.ts +21 -0
- package/dist/server/ClientDatabase.d.ts.map +1 -0
- package/dist/server/ClientDatabase.js +2 -0
- package/dist/server/ClientDatabase.js.map +1 -0
- package/dist/server/PgBoss.d.ts +2 -2
- package/dist/server/PgBoss.d.ts.map +1 -1
- package/dist/server/adapters/batchClockOffset.d.ts +2 -2
- package/dist/server/adapters/batchClockOffset.d.ts.map +1 -1
- package/dist/server/adapters/batchClockOffset.js +5 -4
- package/dist/server/adapters/batchClockOffset.js.map +1 -1
- package/dist/server/adapters/batchHandler.d.ts +5 -0
- package/dist/server/adapters/batchHandler.d.ts.map +1 -0
- package/dist/server/{internal → adapters}/batchHandler.js +6 -6
- package/dist/server/adapters/batchHandler.js.map +1 -0
- package/dist/server/adapters/clientCache.d.ts +10 -0
- package/dist/server/adapters/clientCache.d.ts.map +1 -0
- package/dist/server/{internal → adapters}/clientCache.js +5 -19
- package/dist/server/adapters/clientCache.js.map +1 -0
- package/dist/server/adapters/clientErrorLogger.js +1 -1
- package/dist/server/adapters/clientErrorLogger.js.map +1 -1
- package/dist/server/adapters/defaultClientFactory.d.ts +4 -0
- package/dist/server/adapters/defaultClientFactory.d.ts.map +1 -0
- package/dist/server/adapters/defaultClientFactory.js.map +1 -0
- package/dist/server/adapters/deferralCount.d.ts +3 -3
- package/dist/server/adapters/deferralCount.d.ts.map +1 -1
- package/dist/server/adapters/deferralCount.js +2 -2
- package/dist/server/adapters/deferralCount.js.map +1 -1
- package/dist/server/adapters/expireAttempt.d.ts +4 -0
- package/dist/server/adapters/expireAttempt.d.ts.map +1 -0
- package/dist/server/{internal → adapters}/expireAttempt.js +1 -1
- package/dist/server/{internal → adapters}/expireAttempt.js.map +1 -1
- package/dist/server/adapters/installSchema.d.ts +1 -1
- package/dist/server/adapters/installSchema.d.ts.map +1 -1
- package/dist/server/adapters/installSchema.js +1 -1
- package/dist/server/adapters/installSchema.js.map +1 -1
- package/dist/server/adapters/jobEngine.d.ts +5 -0
- package/dist/server/adapters/jobEngine.d.ts.map +1 -0
- package/dist/server/adapters/jobEngine.js +50 -0
- package/dist/server/adapters/jobEngine.js.map +1 -0
- package/dist/server/adapters/lifecycle.d.ts +11 -0
- package/dist/server/adapters/lifecycle.d.ts.map +1 -0
- package/dist/server/adapters/lifecycle.js +48 -0
- package/dist/server/adapters/lifecycle.js.map +1 -0
- package/dist/server/adapters/listJobs.d.ts +5 -0
- package/dist/server/adapters/listJobs.d.ts.map +1 -0
- package/dist/server/adapters/listJobs.js +37 -0
- package/dist/server/adapters/listJobs.js.map +1 -0
- package/dist/server/adapters/observeTestingSettlements.d.ts +6 -0
- package/dist/server/adapters/observeTestingSettlements.d.ts.map +1 -0
- package/dist/server/adapters/observeTestingSettlements.js.map +1 -0
- package/dist/server/adapters/queueAdministration.d.ts +4 -0
- package/dist/server/adapters/queueAdministration.d.ts.map +1 -0
- package/dist/server/adapters/queueAdministration.js +42 -0
- package/dist/server/adapters/queueAdministration.js.map +1 -0
- package/dist/server/adapters/registerWorker.d.ts +5 -3
- package/dist/server/adapters/registerWorker.d.ts.map +1 -1
- package/dist/server/adapters/registerWorker.js +16 -7
- package/dist/server/adapters/registerWorker.js.map +1 -1
- package/dist/server/adapters/retireJobs.d.ts +3 -3
- package/dist/server/adapters/retireJobs.d.ts.map +1 -1
- package/dist/server/adapters/retireJobs.js +3 -3
- package/dist/server/adapters/retireJobs.js.map +1 -1
- package/dist/server/adapters/schemaIndexBuilds.d.ts +2 -2
- package/dist/server/adapters/schemaIndexBuilds.d.ts.map +1 -1
- package/dist/server/adapters/schemaIndexBuilds.js.map +1 -1
- package/dist/server/adapters/settleDeferral.d.ts +7 -0
- package/dist/server/adapters/settleDeferral.d.ts.map +1 -0
- package/dist/server/{internal → adapters}/settleDeferral.js +2 -2
- package/dist/server/adapters/settleDeferral.js.map +1 -0
- package/dist/server/adapters/testingClient.d.ts +14 -0
- package/dist/server/adapters/testingClient.d.ts.map +1 -0
- package/dist/server/{internal → adapters}/testingClient.js +15 -11
- package/dist/server/adapters/testingClient.js.map +1 -0
- package/dist/server/adapters/testingController.d.ts +34 -0
- package/dist/server/adapters/testingController.d.ts.map +1 -0
- package/dist/server/adapters/testingController.js +98 -0
- package/dist/server/adapters/testingController.js.map +1 -0
- package/dist/server/adapters/testingDueNow.d.ts +3 -3
- package/dist/server/adapters/testingDueNow.d.ts.map +1 -1
- package/dist/server/adapters/testingDueNow.js +2 -2
- package/dist/server/adapters/testingDueNow.js.map +1 -1
- package/dist/server/adapters/testingEngine.d.ts +5 -0
- package/dist/server/adapters/testingEngine.d.ts.map +1 -0
- package/dist/server/adapters/testingEngine.js +23 -0
- package/dist/server/adapters/testingEngine.js.map +1 -0
- package/dist/server/adapters/testingExpirations.d.ts +6 -4
- package/dist/server/adapters/testingExpirations.d.ts.map +1 -1
- package/dist/server/adapters/testingExpirations.js.map +1 -1
- package/dist/server/adapters/transactionDb.d.ts +2 -2
- package/dist/server/adapters/transactionDb.d.ts.map +1 -1
- package/dist/server/adapters/transactionDb.js.map +1 -1
- package/dist/server/client.d.ts +92 -18
- package/dist/server/client.d.ts.map +1 -1
- package/dist/server/clientOptions.d.ts +75 -0
- package/dist/server/clientOptions.d.ts.map +1 -0
- package/dist/server/clientOptions.js +2 -0
- package/dist/server/clientOptions.js.map +1 -0
- package/dist/server/defineSchedule.d.ts +1 -1
- package/dist/server/defineSchedule.d.ts.map +1 -1
- package/dist/server/defineSchedule.js +2 -1
- package/dist/server/defineSchedule.js.map +1 -1
- package/dist/server/definition.d.ts +20 -18
- package/dist/server/definition.d.ts.map +1 -1
- package/dist/server/definition.js +3 -1
- package/dist/server/definition.js.map +1 -1
- package/dist/server/engineClient.d.ts +26 -0
- package/dist/server/engineClient.d.ts.map +1 -0
- package/dist/server/engineClient.js +2 -0
- package/dist/server/engineClient.js.map +1 -0
- package/dist/server/enqueueOptions.d.ts +22 -0
- package/dist/server/enqueueOptions.d.ts.map +1 -0
- package/dist/server/enqueueOptions.js +2 -0
- package/dist/server/enqueueOptions.js.map +1 -0
- package/dist/server/error.d.ts +11 -1
- package/dist/server/error.d.ts.map +1 -1
- package/dist/server/error.js +8 -1
- package/dist/server/error.js.map +1 -1
- package/dist/server/health.d.ts +2 -2
- package/dist/server/health.d.ts.map +1 -1
- package/dist/server/internal/acquireClient.d.ts +11 -0
- package/dist/server/internal/acquireClient.d.ts.map +1 -0
- package/dist/server/internal/acquireClient.js +21 -0
- package/dist/server/internal/acquireClient.js.map +1 -0
- package/dist/server/internal/adapters/testingFetches.d.ts +2 -2
- package/dist/server/internal/adapters/testingFetches.d.ts.map +1 -1
- package/dist/server/internal/adapters/testingFetches.js.map +1 -1
- package/dist/server/internal/clientErrors.d.ts +1 -1
- package/dist/server/internal/clientErrors.d.ts.map +1 -1
- package/dist/server/internal/countsFor.d.ts +3 -3
- package/dist/server/internal/countsFor.d.ts.map +1 -1
- package/dist/server/internal/countsFor.js +2 -2
- package/dist/server/internal/countsFor.js.map +1 -1
- package/dist/server/internal/deadLetterResolutionPlan.js +1 -1
- package/dist/server/internal/deadLetterResolutionPlan.js.map +1 -1
- package/dist/server/internal/deadlineOf.d.ts +2 -2
- package/dist/server/internal/deadlineOf.d.ts.map +1 -1
- package/dist/server/internal/deadlineOf.js.map +1 -1
- package/dist/server/internal/deferrableAttempt.d.ts +4 -5
- package/dist/server/internal/deferrableAttempt.d.ts.map +1 -1
- package/dist/server/internal/deferrableAttempt.js +5 -14
- package/dist/server/internal/deferrableAttempt.js.map +1 -1
- package/dist/server/internal/deferral.d.ts +3 -3
- package/dist/server/internal/deferral.d.ts.map +1 -1
- package/dist/server/internal/deferral.js.map +1 -1
- package/dist/server/internal/deferralStorePlan.js +2 -2
- package/dist/server/internal/deferralStorePlan.js.map +1 -1
- package/dist/server/internal/definitionOptions.d.ts +7 -7
- package/dist/server/internal/definitionOptions.d.ts.map +1 -1
- package/dist/server/internal/engine.d.ts +30 -0
- package/dist/server/internal/engine.d.ts.map +1 -0
- package/dist/server/internal/engine.js +6 -0
- package/dist/server/internal/engine.js.map +1 -0
- package/dist/server/internal/enqueueFor.d.ts +2 -2
- package/dist/server/internal/enqueueFor.d.ts.map +1 -1
- package/dist/server/internal/enqueueFor.js +3 -3
- package/dist/server/internal/enqueueFor.js.map +1 -1
- package/dist/server/internal/ensureQueue.d.ts +2 -3
- package/dist/server/internal/ensureQueue.d.ts.map +1 -1
- package/dist/server/internal/ensureQueue.js +2 -2
- package/dist/server/internal/ensureQueue.js.map +1 -1
- package/dist/server/internal/healthFor.d.ts +3 -3
- package/dist/server/internal/healthFor.d.ts.map +1 -1
- package/dist/server/internal/healthFor.js +2 -2
- package/dist/server/internal/healthFor.js.map +1 -1
- package/dist/server/internal/jobControl.d.ts +9 -4
- package/dist/server/internal/jobControl.d.ts.map +1 -1
- package/dist/server/internal/jobControl.js +13 -40
- package/dist/server/internal/jobControl.js.map +1 -1
- package/dist/server/internal/jobListings.d.ts +16 -0
- package/dist/server/internal/jobListings.d.ts.map +1 -0
- package/dist/server/internal/jobListings.js +52 -0
- package/dist/server/internal/jobListings.js.map +1 -0
- package/dist/server/internal/jobStorePlans.js +2 -2
- package/dist/server/internal/jobStorePlans.js.map +1 -1
- package/dist/server/internal/lifecycle.d.ts +11 -7
- package/dist/server/internal/lifecycle.d.ts.map +1 -1
- package/dist/server/internal/lifecycle.js +2 -49
- package/dist/server/internal/lifecycle.js.map +1 -1
- package/dist/server/internal/makeService.d.ts +5 -3
- package/dist/server/internal/makeService.d.ts.map +1 -1
- package/dist/server/internal/makeService.js +15 -11
- package/dist/server/internal/makeService.js.map +1 -1
- package/dist/server/internal/register.d.ts +5 -5
- package/dist/server/internal/register.d.ts.map +1 -1
- package/dist/server/internal/register.js +17 -29
- package/dist/server/internal/register.js.map +1 -1
- package/dist/server/internal/registerReleasedJobs.d.ts +4 -4
- package/dist/server/internal/registerReleasedJobs.d.ts.map +1 -1
- package/dist/server/internal/registerReleasedJobs.js +2 -2
- package/dist/server/internal/registerReleasedJobs.js.map +1 -1
- package/dist/server/internal/retryWake.d.ts +1 -1
- package/dist/server/internal/retryWake.d.ts.map +1 -1
- package/dist/server/internal/retryWake.js +2 -2
- package/dist/server/internal/retryWake.js.map +1 -1
- package/dist/server/internal/runQueueWorker.d.ts +6 -4
- package/dist/server/internal/runQueueWorker.d.ts.map +1 -1
- package/dist/server/internal/runQueueWorker.js +5 -5
- package/dist/server/internal/runQueueWorker.js.map +1 -1
- package/dist/server/internal/storedRows.d.ts +2 -2
- package/dist/server/internal/storedRows.d.ts.map +1 -1
- package/dist/server/internal/storedRows.js +2 -2
- package/dist/server/internal/storedRows.js.map +1 -1
- package/dist/server/internal/testingDeferrals.d.ts +3 -3
- package/dist/server/internal/testingDeferrals.d.ts.map +1 -1
- package/dist/server/internal/testingDeferrals.js +2 -2
- package/dist/server/internal/testingDeferrals.js.map +1 -1
- package/dist/server/internal/testingIdle.d.ts +3 -3
- package/dist/server/internal/testingIdle.d.ts.map +1 -1
- package/dist/server/internal/testingIdle.js +11 -5
- package/dist/server/internal/testingIdle.js.map +1 -1
- package/dist/server/internal/testingReadout.d.ts +7 -41
- package/dist/server/internal/testingReadout.d.ts.map +1 -1
- package/dist/server/internal/testingReadout.js +2 -2
- package/dist/server/internal/testingReadout.js.map +1 -1
- package/dist/server/internal/testingRegistrations.d.ts +4 -0
- package/dist/server/internal/testingRegistrations.d.ts.map +1 -0
- package/dist/server/internal/testingRegistrations.js +8 -0
- package/dist/server/internal/testingRegistrations.js.map +1 -0
- package/dist/server/internal/testingSchedules.d.ts +3 -3
- package/dist/server/internal/testingSchedules.d.ts.map +1 -1
- package/dist/server/internal/testingSchedules.js +1 -1
- package/dist/server/internal/testingSchedules.js.map +1 -1
- package/dist/server/internal/testingSnapshot.d.ts +4 -4
- package/dist/server/internal/testingSnapshot.d.ts.map +1 -1
- package/dist/server/internal/testingSnapshot.js +7 -4
- package/dist/server/internal/testingSnapshot.js.map +1 -1
- package/dist/server/internal/testingWaits.d.ts +8 -7
- package/dist/server/internal/testingWaits.d.ts.map +1 -1
- package/dist/server/internal/testingWaits.js +3 -3
- package/dist/server/internal/testingWaits.js.map +1 -1
- package/dist/server/internal/tracing.d.ts +2 -2
- package/dist/server/internal/tracing.d.ts.map +1 -1
- package/dist/server/internal/tracing.js.map +1 -1
- package/dist/server/internal/validateQueueNames.d.ts +2 -2
- package/dist/server/internal/validateQueueNames.d.ts.map +1 -1
- package/dist/server/internal/validateQueueNames.js +1 -1
- package/dist/server/internal/validateQueueNames.js.map +1 -1
- package/dist/server/internal/waitForBatchExpiry.d.ts +4 -4
- package/dist/server/internal/waitForBatchExpiry.d.ts.map +1 -1
- package/dist/server/internal/waitForBatchExpiry.js +1 -1
- package/dist/server/internal/waitForBatchExpiry.js.map +1 -1
- package/dist/server/job.d.ts +42 -0
- package/dist/server/job.d.ts.map +1 -0
- package/dist/server/job.js +2 -0
- package/dist/server/job.js.map +1 -0
- package/dist/server/jobModule.d.ts +9 -0
- package/dist/server/jobModule.d.ts.map +1 -0
- package/dist/server/jobModule.js +15 -0
- package/dist/server/jobModule.js.map +1 -0
- package/dist/server/queueOptions.d.ts +19 -0
- package/dist/server/queueOptions.d.ts.map +1 -0
- package/dist/server/queueOptions.js +2 -0
- package/dist/server/queueOptions.js.map +1 -0
- package/dist/server/readJobFailure.d.ts +5 -0
- package/dist/server/readJobFailure.d.ts.map +1 -0
- package/dist/server/readJobFailure.js +8 -0
- package/dist/server/readJobFailure.js.map +1 -0
- package/dist/server/schema.d.ts +1 -1
- package/dist/server/schema.d.ts.map +1 -1
- package/dist/server/schema.js +18 -7
- package/dist/server/schema.js.map +1 -1
- package/dist/server/service.d.ts +15 -10
- package/dist/server/service.d.ts.map +1 -1
- package/dist/server/service.js +26 -33
- package/dist/server/service.js.map +1 -1
- package/dist/server/testing.d.ts +32 -70
- package/dist/server/testing.d.ts.map +1 -1
- package/dist/server/testing.js +9 -96
- package/dist/server/testing.js.map +1 -1
- package/dist/server/workerOptions.d.ts +25 -0
- package/dist/server/workerOptions.d.ts.map +1 -0
- package/dist/server/workerOptions.js +2 -0
- package/dist/server/workerOptions.js.map +1 -0
- package/package.json +11 -16
- package/src/display.ts +12 -0
- package/src/server/ClientDatabase.ts +7 -0
- package/src/server/PgBoss.ts +2 -2
- package/src/server/adapters/batchClockOffset.ts +8 -5
- package/src/server/{internal → adapters}/batchHandler.ts +13 -13
- package/src/server/{internal → adapters}/clientCache.ts +10 -22
- package/src/server/adapters/clientErrorLogger.ts +1 -1
- package/src/server/{defaultClientFactory.ts → adapters/defaultClientFactory.ts} +4 -2
- package/src/server/adapters/deferralCount.ts +5 -5
- package/src/server/{internal → adapters}/expireAttempt.ts +4 -3
- package/src/server/adapters/installSchema.ts +2 -2
- package/src/server/adapters/jobEngine.ts +59 -0
- package/src/server/adapters/lifecycle.ts +67 -0
- package/src/server/adapters/listJobs.ts +43 -0
- package/src/server/{internal → adapters}/observeTestingSettlements.ts +2 -2
- package/src/server/adapters/queueAdministration.ts +47 -0
- package/src/server/adapters/registerWorker.ts +24 -13
- package/src/server/adapters/retireJobs.ts +5 -5
- package/src/server/adapters/schemaIndexBuilds.ts +2 -2
- package/src/server/{internal → adapters}/settleDeferral.ts +5 -5
- package/src/server/{internal → adapters}/testingClient.ts +34 -26
- package/src/server/adapters/testingController.ts +109 -0
- package/src/server/adapters/testingDueNow.ts +5 -5
- package/src/server/adapters/testingEngine.ts +28 -0
- package/src/server/adapters/testingExpirations.ts +6 -4
- package/src/server/adapters/transactionDb.ts +2 -2
- package/src/server/client.ts +83 -30
- package/src/server/clientOptions.ts +81 -0
- package/src/server/defineSchedule.ts +3 -2
- package/src/server/definition.ts +24 -20
- package/src/server/engineClient.ts +24 -0
- package/src/server/enqueueOptions.ts +20 -0
- package/src/server/error.ts +17 -2
- package/src/server/health.ts +2 -2
- package/src/server/internal/acquireClient.ts +26 -0
- package/src/server/internal/adapters/testingFetches.ts +2 -2
- package/src/server/internal/clientErrors.ts +1 -1
- package/src/server/internal/countsFor.ts +5 -5
- package/src/server/internal/deadLetterResolutionPlan.ts +1 -1
- package/src/server/internal/deadlineOf.ts +2 -2
- package/src/server/internal/deferrableAttempt.ts +5 -22
- package/src/server/internal/deferral.ts +3 -3
- package/src/server/internal/deferralStorePlan.ts +2 -2
- package/src/server/internal/definitionOptions.ts +1 -1
- package/src/server/internal/engine.ts +41 -0
- package/src/server/internal/enqueueFor.ts +5 -5
- package/src/server/internal/ensureQueue.ts +5 -6
- package/src/server/internal/healthFor.ts +4 -4
- package/src/server/internal/jobControl.ts +15 -50
- package/src/server/internal/jobListings.ts +85 -0
- package/src/server/internal/jobStorePlans.ts +2 -2
- package/src/server/internal/lifecycle.ts +14 -55
- package/src/server/internal/makeService.ts +21 -13
- package/src/server/internal/register.ts +27 -45
- package/src/server/internal/registerReleasedJobs.ts +6 -6
- package/src/server/internal/retryWake.ts +3 -3
- package/src/server/internal/runQueueWorker.ts +14 -8
- package/src/server/internal/storedRows.ts +3 -3
- package/src/server/internal/testingDeferrals.ts +5 -5
- package/src/server/internal/testingIdle.ts +13 -8
- package/src/server/internal/testingReadout.ts +12 -6
- package/src/server/internal/testingRegistrations.ts +10 -0
- package/src/server/internal/testingSchedules.ts +4 -4
- package/src/server/internal/testingSnapshot.ts +11 -8
- package/src/server/internal/testingWaits.ts +11 -10
- package/src/server/internal/tracing.ts +2 -2
- package/src/server/internal/validateQueueNames.ts +2 -2
- package/src/server/internal/waitForBatchExpiry.ts +4 -4
- package/src/server/job.ts +42 -0
- package/src/server/jobModule.ts +30 -0
- package/src/server/queueOptions.ts +20 -0
- package/src/server/readJobFailure.ts +12 -0
- package/src/server/schema.ts +18 -7
- package/src/server/service.ts +63 -59
- package/src/server/testing.ts +17 -108
- package/src/server/workerOptions.ts +28 -0
- package/dist/server/defaultClientFactory.d.ts +0 -3
- package/dist/server/defaultClientFactory.d.ts.map +0 -1
- package/dist/server/defaultClientFactory.js.map +0 -1
- package/dist/server/internal/batchHandler.d.ts +0 -5
- package/dist/server/internal/batchHandler.d.ts.map +0 -1
- package/dist/server/internal/batchHandler.js.map +0 -1
- package/dist/server/internal/clientCache.d.ts +0 -8
- package/dist/server/internal/clientCache.d.ts.map +0 -1
- package/dist/server/internal/clientCache.js.map +0 -1
- package/dist/server/internal/expireAttempt.d.ts +0 -3
- package/dist/server/internal/expireAttempt.d.ts.map +0 -1
- package/dist/server/internal/listJobs.d.ts +0 -5
- package/dist/server/internal/listJobs.d.ts.map +0 -1
- package/dist/server/internal/listJobs.js +0 -75
- package/dist/server/internal/listJobs.js.map +0 -1
- package/dist/server/internal/observeTestingSettlements.d.ts +0 -6
- package/dist/server/internal/observeTestingSettlements.d.ts.map +0 -1
- package/dist/server/internal/observeTestingSettlements.js.map +0 -1
- package/dist/server/internal/settleDeferral.d.ts +0 -7
- package/dist/server/internal/settleDeferral.d.ts.map +0 -1
- package/dist/server/internal/settleDeferral.js.map +0 -1
- package/dist/server/internal/testingClient.d.ts +0 -13
- package/dist/server/internal/testingClient.d.ts.map +0 -1
- package/dist/server/internal/testingClient.js.map +0 -1
- package/src/server/internal/listJobs.ts +0 -116
- /package/dist/server/{defaultClientFactory.js → adapters/defaultClientFactory.js} +0 -0
- /package/dist/server/{internal → adapters}/observeTestingSettlements.js +0 -0
package/dist/server/testing.d.ts
CHANGED
|
@@ -1,14 +1,40 @@
|
|
|
1
|
-
import { type DateTime, Duration, Effect } from "effect";
|
|
2
|
-
import type {
|
|
3
|
-
|
|
4
|
-
|
|
1
|
+
import { type DateTime, type Duration, Effect, type Tracer } from "effect";
|
|
2
|
+
import type { JobPayloadSchema, QueueDefinition } from "#server/definition.ts";
|
|
3
|
+
export declare function makePgBossTesting(options?: PgBossTestingOptions): {
|
|
4
|
+
runDeferredNow: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<void, import("./error.ts").PgBossTestingError, never>;
|
|
5
|
+
runDueNow: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<void, import("./error.ts").PgBossTestingError, never>;
|
|
6
|
+
deferred: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<{
|
|
7
|
+
at: DateTime.Utc;
|
|
8
|
+
reason: string;
|
|
9
|
+
}[], import("./error.ts").PgBossTestingError, never>;
|
|
10
|
+
schedules: () => Effect.Effect<{
|
|
11
|
+
cron: string;
|
|
12
|
+
name: string;
|
|
13
|
+
timezone: string;
|
|
14
|
+
}[], import("./error.ts").PgBossTestingError, never>;
|
|
15
|
+
trigger: (schedule: Pick<import("#server/definition.ts").ScheduleDefinition, "name" | "scheduleOptions">) => Effect.Effect<void, import("./error.ts").PgBossTestingError, never>;
|
|
16
|
+
fetchesPass: (queue: Pick<QueueDefinition, "name">, count: number, options?: PgBossTestingWaitOptions) => Effect.Effect<unknown, import("./error.ts").PgBossTestingError | import("./error.ts").PgBossWaitError, never>;
|
|
17
|
+
untilJob: <TName extends string, TPayload extends JobPayloadSchema>(queue: Pick<QueueDefinition<TName, TPayload>, "name" | "schema">, id: string, state: import("./job.ts").JobState, options?: PgBossTestingWaitOptions) => Effect.Effect<import("./job.ts").Job<TPayload["Type"]>, import("./error.ts").PgBossPayloadError | import("./error.ts").PgBossTestingError | import("./error.ts").PgBossWaitError, Exclude<TPayload["DecodingServices"], never>>;
|
|
18
|
+
checkBatchWindow: (queue: Pick<QueueDefinition, "name" | "workerOptions">, millisecondsPerJob: number) => Effect.Effect<void, import("./error.ts").PgBossTestingError, never>;
|
|
19
|
+
checkSchemaVersion: (expected: number) => Effect.Effect<void, import("./error.ts").PgBossTestingError, never>;
|
|
20
|
+
clientFactory: import("./client.ts").PgBossClientFactory;
|
|
21
|
+
expireAfter: (queue: Pick<QueueDefinition, "name">, attempts: number) => Effect.Effect<void, import("./error.ts").PgBossTestingError, never>;
|
|
22
|
+
expireIn: (queue: Pick<QueueDefinition, "name">, duration: Duration.Input) => Effect.Effect<void, import("./error.ts").PgBossTestingError, never>;
|
|
23
|
+
failNextSend: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<void, never, never>;
|
|
24
|
+
jobs: <TName extends string, TPayload extends JobPayloadSchema>(queue: QueueDefinition<TName, TPayload>, options?: import("./client.ts").JobReadOptions) => Effect.Effect<import("./job.ts").Job<TPayload["Type"]>[], import("./error.ts").PgBossTestingError | import("./error.ts").PgBossPayloadError, TPayload["DecodingServices"]>;
|
|
25
|
+
revision: Effect.Effect<number, never, never>;
|
|
26
|
+
schemaVersion: Effect.Effect<number | null, import("./error.ts").PgBossTestingError, never>;
|
|
27
|
+
snapshot: <const TQueues extends readonly SnapshotQueue[]>(queues: TQueues) => Effect.Effect<readonly UnfinishedJob<TQueues[number]>[], import("./error.ts").PgBossPayloadError | import("./error.ts").PgBossTestingError, TQueues[number]["schema"]["DecodingServices"]>;
|
|
28
|
+
waitForChange: (after: number) => Effect.Effect<number>;
|
|
29
|
+
waitForIdle: Effect.Effect<void, import("./error.ts").PgBossTestingError, never>;
|
|
30
|
+
};
|
|
5
31
|
export type SnapshotQueue = Pick<QueueDefinition<string, JobPayloadSchema>, "name" | "schema">;
|
|
6
32
|
export interface UnfinishedJob<TQueue extends SnapshotQueue> {
|
|
7
33
|
readonly data: TQueue["schema"]["Type"];
|
|
8
34
|
readonly id: string;
|
|
9
35
|
readonly queue: TQueue["name"];
|
|
10
36
|
readonly startAfter: DateTime.Utc;
|
|
11
|
-
readonly state: "active" | "created" | "failed" | "retry";
|
|
37
|
+
readonly state: "active" | "created" | "deferred" | "failed" | "retry";
|
|
12
38
|
}
|
|
13
39
|
export interface PgBossTestingWaitOptions {
|
|
14
40
|
readonly within?: Duration.Input;
|
|
@@ -20,70 +46,6 @@ export declare const testRetryPolicy: Readonly<{
|
|
|
20
46
|
export interface PgBossTestingOptions {
|
|
21
47
|
readonly retryPolicy?: typeof testRetryPolicy;
|
|
22
48
|
}
|
|
23
|
-
export declare function
|
|
24
|
-
runDeferredNow: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<void, PgBossTestingError, never>;
|
|
25
|
-
runDueNow: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<void, PgBossTestingError, never>;
|
|
26
|
-
deferred: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<{
|
|
27
|
-
at: DateTime.Utc;
|
|
28
|
-
reason: string;
|
|
29
|
-
}[], PgBossTestingError, never>;
|
|
30
|
-
schedules: () => Effect.Effect<{
|
|
31
|
-
cron: string;
|
|
32
|
-
name: string;
|
|
33
|
-
timezone: string;
|
|
34
|
-
}[], PgBossTestingError, never>;
|
|
35
|
-
trigger: (schedule: Pick<import("#definition.ts").ScheduleDefinition, "name" | "scheduleOptions">) => Effect.Effect<void, PgBossTestingError, never>;
|
|
36
|
-
fetchesPass: (queue: Pick<QueueDefinition, "name">, count: number, options?: PgBossTestingWaitOptions) => Effect.Effect<unknown, PgBossTestingError | import("#error.ts").PgBossWaitError, never>;
|
|
37
|
-
untilJob: <TName extends string, TPayload extends JobPayloadSchema>(queue: Pick<QueueDefinition<TName, TPayload>, "name" | "schema">, id: string, state: import("pg-boss").JobWithMetadata["state"], options?: PgBossTestingWaitOptions) => Effect.Effect<import("pg-boss").JobWithMetadata<TPayload["Type"]>, import("#error.ts").PgBossPayloadError | PgBossTestingError | import("#error.ts").PgBossWaitError, Exclude<TPayload["DecodingServices"], never>>;
|
|
38
|
-
checkBatchWindow: (queue: Pick<QueueDefinition, "name" | "workerOptions">, millisecondsPerJob: number) => Effect.Effect<void, PgBossTestingError, never>;
|
|
39
|
-
checkSchemaVersion: (expected: number) => Effect.Effect<void, PgBossTestingError, never>;
|
|
40
|
-
clientFactory: PgBossClientFactory;
|
|
41
|
-
expireAfter: (queue: Pick<QueueDefinition, "name">, attempts: number) => Effect.Effect<void, PgBossTestingError, never>;
|
|
42
|
-
expireIn: (queue: Pick<QueueDefinition, "name">, duration: Duration.Input) => Effect.Effect<void, PgBossTestingError, never>;
|
|
43
|
-
failNextSend: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<void, never, never>;
|
|
44
|
-
jobs: <TName extends string, TPayload extends JobPayloadSchema>(queue: QueueDefinition<TName, TPayload>, options?: import("pg-boss").FindJobsOptions) => Effect.Effect<{
|
|
45
|
-
id: string;
|
|
46
|
-
name: string;
|
|
47
|
-
retryCount: number;
|
|
48
|
-
signal: AbortSignal;
|
|
49
|
-
groupId?: string | null;
|
|
50
|
-
groupTier?: string | null;
|
|
51
|
-
priority: number;
|
|
52
|
-
state: 'created' | 'retry' | 'active' | 'completed' | 'cancelled' | 'failed';
|
|
53
|
-
retryLimit: number;
|
|
54
|
-
retryDelay: number;
|
|
55
|
-
retryBackoff: boolean;
|
|
56
|
-
retryDelayMax?: number;
|
|
57
|
-
startAfter: Date;
|
|
58
|
-
startedOn: Date;
|
|
59
|
-
singletonKey: string | null;
|
|
60
|
-
singletonOn: Date | null;
|
|
61
|
-
expireInSeconds: number;
|
|
62
|
-
deleteAfterSeconds: number;
|
|
63
|
-
createdOn: Date;
|
|
64
|
-
completedOn: Date | null;
|
|
65
|
-
keepUntil: Date;
|
|
66
|
-
policy: import("pg-boss").QueuePolicy;
|
|
67
|
-
heartbeatOn: Date | null;
|
|
68
|
-
heartbeatSeconds: number | null;
|
|
69
|
-
blocked: boolean;
|
|
70
|
-
blocking: boolean;
|
|
71
|
-
pendingDependencies: number;
|
|
72
|
-
deadLetter: string;
|
|
73
|
-
output: object;
|
|
74
|
-
sourceName: string | null;
|
|
75
|
-
sourceId: string | null;
|
|
76
|
-
sourceCreatedOn: Date | null;
|
|
77
|
-
sourceRetryCount: number | null;
|
|
78
|
-
sourceOutput: object | null;
|
|
79
|
-
sourceRootId: string | null;
|
|
80
|
-
data: TPayload["Type"];
|
|
81
|
-
}[], import("#error.ts").PgBossPayloadError | PgBossTestingError, TPayload["DecodingServices"]>;
|
|
82
|
-
revision: Effect.Effect<number, never, never>;
|
|
83
|
-
schemaVersion: Effect.Effect<number | null, PgBossTestingError, never>;
|
|
84
|
-
snapshot: <const TQueues extends readonly SnapshotQueue[]>(queues: TQueues) => Effect.Effect<readonly UnfinishedJob<TQueues[number]>[], import("#error.ts").PgBossPayloadError | PgBossTestingError, TQueues[number]["schema"]["DecodingServices"]>;
|
|
85
|
-
waitForChange: (after: number) => Effect.Effect<number>;
|
|
86
|
-
waitForIdle: Effect.Effect<void, PgBossTestingError, never>;
|
|
87
|
-
};
|
|
49
|
+
export declare function linkedWorkerSpans(sender: Pick<Tracer.AnySpan, "spanId" | "traceId">, spans: readonly Tracer.Span[]): Effect.Effect<Tracer.Span[], never, never>;
|
|
88
50
|
export type PgBossTesting = ReturnType<typeof makePgBossTesting>;
|
|
89
51
|
//# sourceMappingURL=testing.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/server/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,QAAQ,EAAE,MAAM,
|
|
1
|
+
{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/server/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,oBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEnE;AAED,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;AAE/F,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,aAAa;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;CACvE;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;CACjC;AAED,eAAO,MAAM,eAAe;;;EAAwD,CAAC;AAErF,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,eAAe,CAAC;CAC9C;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,MAAM,CAAC,IAAI,EAAE,8CASlH;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
|
package/dist/server/testing.js
CHANGED
|
@@ -1,99 +1,12 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import { defaultClientFactory } from "#defaultClientFactory.ts";
|
|
4
|
-
import { PgBossTestingError } from "#error.ts";
|
|
5
|
-
import { testingFetches } from "#internal/adapters/testingFetches.ts";
|
|
6
|
-
import { testingClient } from "#internal/testingClient.ts";
|
|
7
|
-
import { testingDeferrals } from "#internal/testingDeferrals.ts";
|
|
8
|
-
import { testingIdle } from "#internal/testingIdle.ts";
|
|
9
|
-
import { testingOperation, testingReadout } from "#internal/testingReadout.ts";
|
|
10
|
-
import { testingSchedules } from "#internal/testingSchedules.ts";
|
|
11
|
-
import { testingSignal } from "#internal/testingSignal.ts";
|
|
12
|
-
import { testingSnapshot } from "#internal/testingSnapshot.ts";
|
|
13
|
-
import { testingWaits } from "#internal/testingWaits.ts";
|
|
14
|
-
export const testRetryPolicy = Object.freeze({ retryBackoff: false, retryDelay: 0 });
|
|
1
|
+
import { Effect } from "effect";
|
|
2
|
+
import { testingController } from "#server/adapters/testingController.ts";
|
|
15
3
|
export function makePgBossTesting(options = {}) {
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
expirations: new Map(),
|
|
24
|
-
expirySeconds: new Map(),
|
|
25
|
-
failures: new Set(),
|
|
26
|
-
retryPolicy: options.retryPolicy ?? {},
|
|
27
|
-
work,
|
|
28
|
-
};
|
|
29
|
-
function client() {
|
|
30
|
-
if (current === undefined) {
|
|
31
|
-
throw new Error("Provide the testing clientFactory to a jobs Layer first");
|
|
32
|
-
}
|
|
33
|
-
return current;
|
|
34
|
-
}
|
|
35
|
-
const clientFactory = (clientOptions) => {
|
|
36
|
-
if (current !== undefined) {
|
|
37
|
-
throw new Error("A testing controller owns one jobs client; create a controller per runtime");
|
|
38
|
-
}
|
|
39
|
-
schema = clientOptions.schema ?? "pgboss";
|
|
40
|
-
current = defaultClientFactory({ ...clientOptions, "__test__enableSpies": true });
|
|
41
|
-
fetches = testingFetches(current.getDb(), signal.changed);
|
|
42
|
-
return testingClient(current, clientOptions.schema ?? "pgboss", controls);
|
|
43
|
-
};
|
|
44
|
-
return {
|
|
45
|
-
...testingDeferrals(client),
|
|
46
|
-
...testingDueNow(client, () => schema, signal.changed),
|
|
47
|
-
...testingSchedules(client, signal.changed),
|
|
48
|
-
...testingWaits(client, () => fetches, signal),
|
|
49
|
-
checkBatchWindow: (queue, millisecondsPerJob) => testingOperation("checkBatchWindow", async () => {
|
|
50
|
-
const stored = await client().getQueue(queue.name);
|
|
51
|
-
if (stored === null) {
|
|
52
|
-
throw new Error("Queue is not registered");
|
|
53
|
-
}
|
|
54
|
-
if (stored.expireInSeconds === undefined) {
|
|
55
|
-
throw new Error("Queue has no expiry window");
|
|
56
|
-
}
|
|
57
|
-
if (!Number.isFinite(millisecondsPerJob) || millisecondsPerJob < 0) {
|
|
58
|
-
throw new RangeError("Job duration must be nonnegative and finite");
|
|
59
|
-
}
|
|
60
|
-
const required = (queue.workerOptions.batchSize ?? 10) * millisecondsPerJob;
|
|
61
|
-
if (required >= stored.expireInSeconds * 1000) {
|
|
62
|
-
throw new Error("Sequential batch work must fit within the queue expiry window");
|
|
63
|
-
}
|
|
64
|
-
}, queue.name),
|
|
65
|
-
checkSchemaVersion: (expected) => testingOperation("checkSchemaVersion", async () => {
|
|
66
|
-
if ((await client().schemaVersion()) !== expected) {
|
|
67
|
-
throw new Error(`Expected pg-boss schema version ${expected}`);
|
|
68
|
-
}
|
|
69
|
-
}),
|
|
70
|
-
clientFactory,
|
|
71
|
-
expireAfter: (queue, attempts) => Effect.try({
|
|
72
|
-
catch: (original) => new PgBossTestingError({ operation: "expireAfter", original: Redacted.make(original), queue: queue.name }),
|
|
73
|
-
try: () => {
|
|
74
|
-
if (!Number.isSafeInteger(attempts) || attempts < 1) {
|
|
75
|
-
throw new RangeError("Attempts must be a positive integer");
|
|
76
|
-
}
|
|
77
|
-
controls.expirations.set(queue.name, attempts);
|
|
78
|
-
},
|
|
79
|
-
}),
|
|
80
|
-
expireIn: (queue, duration) => Effect.try({
|
|
81
|
-
catch: (original) => new PgBossTestingError({ operation: "expireIn", original: Redacted.make(original), queue: queue.name }),
|
|
82
|
-
try: () => {
|
|
83
|
-
const milliseconds = Duration.toMillis(Duration.fromInputUnsafe(duration));
|
|
84
|
-
if (!Number.isFinite(milliseconds) || milliseconds < 1000) {
|
|
85
|
-
throw new RangeError("Expiry must be finite and at least one second");
|
|
86
|
-
}
|
|
87
|
-
controls.expirySeconds.set(queue.name, Math.ceil(milliseconds / 1000));
|
|
88
|
-
},
|
|
89
|
-
}),
|
|
90
|
-
failNextSend: (queue) => Effect.sync(() => controls.failures.add(queue.name)).pipe(Effect.asVoid),
|
|
91
|
-
jobs: testingReadout(client),
|
|
92
|
-
revision: signal.revision,
|
|
93
|
-
schemaVersion: testingOperation("schemaVersion", () => client().schemaVersion()),
|
|
94
|
-
snapshot: testingSnapshot(client, () => schema),
|
|
95
|
-
waitForChange: signal.waitForChange,
|
|
96
|
-
waitForIdle: testingIdle(client, () => schema, work, signal),
|
|
97
|
-
};
|
|
4
|
+
return testingController(options);
|
|
5
|
+
}
|
|
6
|
+
export const testRetryPolicy = Object.freeze({ retryBackoff: false, retryDelay: 0 });
|
|
7
|
+
export function linkedWorkerSpans(sender, spans) {
|
|
8
|
+
return Effect.sync(() => spans.filter((span) => span.kind === "consumer"
|
|
9
|
+
&& span.attributes.get("messaging.system") === "pg-boss"
|
|
10
|
+
&& span.links.some((link) => link.span.spanId === sender.spanId && link.span.traceId === sender.traceId)));
|
|
98
11
|
}
|
|
99
12
|
//# sourceMappingURL=testing.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/server/testing.ts"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/server/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,MAAM,EAAe,MAAM,QAAQ,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAG1E,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAyB,EAAE;IACnE,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAgBD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;AAMrF,MAAM,UAAU,iBAAiB,CAAC,MAAkD,EAAE,KAA6B;IAClH,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CACvB,KAAK,CAAC,MAAM,CACX,CAAC,IAAI,EAAE,EAAE,CACR,IAAI,CAAC,IAAI,KAAK,UAAU;WACrB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,SAAS;WACrD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CACzG,CACD,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
export interface GroupConcurrencyConfig {
|
|
2
|
+
default: number;
|
|
3
|
+
tiers?: Record<string, number>;
|
|
4
|
+
}
|
|
5
|
+
export interface WorkerOptions {
|
|
6
|
+
batchSize?: number;
|
|
7
|
+
burstWhenBatchFull?: boolean;
|
|
8
|
+
burstWhenReadyExceeds?: number;
|
|
9
|
+
groupConcurrency?: number | GroupConcurrencyConfig;
|
|
10
|
+
heartbeatRefreshSeconds?: number;
|
|
11
|
+
ignoreStartAfter?: boolean;
|
|
12
|
+
includeMetadata?: boolean;
|
|
13
|
+
localConcurrency?: number;
|
|
14
|
+
localGroupConcurrency?: number | GroupConcurrencyConfig;
|
|
15
|
+
maxPriority?: number;
|
|
16
|
+
minPriority?: number;
|
|
17
|
+
notifyPollingIntervalSeconds?: number;
|
|
18
|
+
orderByCreatedOn?: boolean;
|
|
19
|
+
perJobResults?: boolean;
|
|
20
|
+
pollingIntervalSeconds?: number;
|
|
21
|
+
priority?: boolean;
|
|
22
|
+
transactional?: boolean;
|
|
23
|
+
transactionTimeoutSeconds?: number;
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=workerOptions.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"workerOptions.d.ts","sourceRoot":"","sources":["../../src/server/workerOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;IAEnD,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACnC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"workerOptions.js","sourceRoot":"","sources":["../../src/server/workerOptions.ts"],"names":[],"mappings":""}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@shivaedev/jobs",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.31.0",
|
|
4
4
|
"description": "Effect-native jobs and lifecycle management for pg-boss",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"effect"
|
|
@@ -20,14 +20,9 @@
|
|
|
20
20
|
"imports": {
|
|
21
21
|
"#test/*": "./src/test-support/*",
|
|
22
22
|
"#*.ts": {
|
|
23
|
-
"source": "./src
|
|
24
|
-
"types": "./dist
|
|
25
|
-
"default": "./dist
|
|
26
|
-
},
|
|
27
|
-
"#JobFailure.ts": {
|
|
28
|
-
"source": "./src/JobFailure.ts",
|
|
29
|
-
"types": "./dist/JobFailure.d.ts",
|
|
30
|
-
"default": "./dist/JobFailure.js"
|
|
23
|
+
"source": "./src/*.ts",
|
|
24
|
+
"types": "./dist/*.d.ts",
|
|
25
|
+
"default": "./dist/*.js"
|
|
31
26
|
}
|
|
32
27
|
},
|
|
33
28
|
"exports": {
|
|
@@ -48,16 +43,16 @@
|
|
|
48
43
|
"README.md"
|
|
49
44
|
],
|
|
50
45
|
"dependencies": {
|
|
51
|
-
"@shivaedev/errors": "0.
|
|
46
|
+
"@shivaedev/errors": "0.6.0",
|
|
52
47
|
"@shivaedev/service": "0.6.1",
|
|
53
|
-
"@shivaedev/sql": "0.
|
|
48
|
+
"@shivaedev/sql": "0.34.0"
|
|
54
49
|
},
|
|
55
50
|
"devDependencies": {
|
|
56
|
-
"@shivaedev/http": "0.
|
|
57
|
-
"@shivaedev/quality": "0.
|
|
58
|
-
"@shivaedev/test": "0.
|
|
59
|
-
"@shivaedev/test-sql": "0.
|
|
60
|
-
"@shivaedev/test-story": "0.
|
|
51
|
+
"@shivaedev/http": "0.5.0",
|
|
52
|
+
"@shivaedev/quality": "0.57.0",
|
|
53
|
+
"@shivaedev/test": "0.14.0",
|
|
54
|
+
"@shivaedev/test-sql": "0.17.0",
|
|
55
|
+
"@shivaedev/test-story": "0.35.0",
|
|
61
56
|
"@types/node": "24.19.2",
|
|
62
57
|
"effect": "4.0.6",
|
|
63
58
|
"pg-boss": "12.38.0",
|
package/src/display.ts
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Schema } from "effect";
|
|
2
|
+
|
|
3
|
+
export interface SubjectColumn<TPayload extends Schema.Top> {
|
|
4
|
+
readonly field: Extract<keyof TPayload["Type"], string>;
|
|
5
|
+
readonly label: string;
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
export interface QueueDisplay {
|
|
9
|
+
readonly label?: string;
|
|
10
|
+
readonly name: string;
|
|
11
|
+
readonly subject?: readonly { readonly field: string; readonly label: string }[];
|
|
12
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export interface ClientDatabase {
|
|
2
|
+
beginTransaction?: () => Promise<{ db: ClientDatabase; commit: () => Promise<void>; rollback: () => Promise<void> }>;
|
|
3
|
+
executeSql: (text: string, values?: unknown[]) => Promise<{ rows: Record<string, unknown>[] }>;
|
|
4
|
+
listen?: (channel: string, onNotification: (payload: string) => void, onReconnect: () => void) => Promise<{ close: () => Promise<void> }>;
|
|
5
|
+
poolCounts?: () => { max: number; total: number; idle: number; waiting: number } | null;
|
|
6
|
+
setSessionStatements?: (statements: string[]) => Promise<void>;
|
|
7
|
+
}
|
package/src/server/PgBoss.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { Context } from "effect";
|
|
2
|
-
import type { StopOptions } from "
|
|
3
|
-
import type { AcquiredClient } from "#internal/lifecycle.ts";
|
|
2
|
+
import type { StopOptions } from "#server/clientOptions.ts";
|
|
3
|
+
import type { AcquiredClient } from "#server/internal/lifecycle.ts";
|
|
4
4
|
|
|
5
5
|
export class PgBoss extends Context.Service<
|
|
6
6
|
PgBoss,
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { Clock, Effect } from "effect";
|
|
2
|
-
import type { PgBossClient } from "#client.ts";
|
|
3
|
-
import { toPgBossError } from "#error.ts";
|
|
4
|
-
import { quotedSchema } from "#internal/storedRows.ts";
|
|
1
|
+
import { Clock, Effect, Schema } from "effect";
|
|
2
|
+
import type { PgBossClient } from "#server/client.ts";
|
|
3
|
+
import { toPgBossError } from "#server/error.ts";
|
|
4
|
+
import { quotedSchema } from "#server/internal/storedRows.ts";
|
|
5
5
|
|
|
6
6
|
export const batchClockOffset = Effect.fnUntraced(function* (client: PgBossClient, schema: string, name: string) {
|
|
7
7
|
const { rows } = yield* Effect.tryPromise({
|
|
@@ -13,5 +13,8 @@ export const batchClockOffset = Effect.fnUntraced(function* (client: PgBossClien
|
|
|
13
13
|
return client.getDb().executeSql(`SELECT EXTRACT(EPOCH FROM ${quotedSchema(schema)}.job_now()) * 1000 AS now`);
|
|
14
14
|
},
|
|
15
15
|
});
|
|
16
|
-
|
|
16
|
+
const row = yield* Schema.decodeUnknownEffect(Schema.Struct({ now: Schema.Union([Schema.String, Schema.Number]) }))(rows[0]).pipe(
|
|
17
|
+
Effect.mapError((error) => toPgBossError("settle", error, name)),
|
|
18
|
+
);
|
|
19
|
+
return (yield* Clock.currentTimeMillis) - Number(row.now);
|
|
17
20
|
});
|
|
@@ -1,18 +1,18 @@
|
|
|
1
1
|
import { Cause, Clock, Effect, Exit } from "effect";
|
|
2
|
-
import
|
|
3
|
-
import {
|
|
4
|
-
import
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
9
|
-
import {
|
|
2
|
+
import { batchClockOffset } from "#server/adapters/batchClockOffset.ts";
|
|
3
|
+
import type { PgBossClient } from "#server/client.ts";
|
|
4
|
+
import { toPgBossError } from "#server/error.ts";
|
|
5
|
+
import { deadlineOf } from "#server/internal/deadlineOf.ts";
|
|
6
|
+
import { deferredAttempt } from "#server/internal/deferral.ts";
|
|
7
|
+
import { failureOutput } from "#server/internal/failureOutput.ts";
|
|
8
|
+
import { waitForBatchExpiry } from "#server/internal/waitForBatchExpiry.ts";
|
|
9
|
+
import type { WorkerJob } from "#server/job.ts";
|
|
10
10
|
|
|
11
11
|
function settleAttempt(
|
|
12
12
|
complete: NonNullable<PgBossClient["complete"]>,
|
|
13
13
|
fail: NonNullable<PgBossClient["fail"]>,
|
|
14
14
|
name: string,
|
|
15
|
-
job:
|
|
15
|
+
job: WorkerJob<unknown>,
|
|
16
16
|
exit: Exit.Exit<unknown, unknown>,
|
|
17
17
|
) {
|
|
18
18
|
if (Exit.isSuccess(exit) && exit.value === deferredAttempt) {
|
|
@@ -51,15 +51,15 @@ export function batchHandler<R>(
|
|
|
51
51
|
client: PgBossClient,
|
|
52
52
|
name: string,
|
|
53
53
|
schema: string,
|
|
54
|
-
run: (job:
|
|
55
|
-
afterRetry: (job:
|
|
54
|
+
run: (job: WorkerJob<unknown>, deadline: number) => Effect.Effect<unknown, unknown, R>,
|
|
55
|
+
afterRetry: (job: WorkerJob<unknown>) => Effect.Effect<void, unknown> = () => Effect.void,
|
|
56
56
|
) {
|
|
57
57
|
const complete = client.complete?.bind(client);
|
|
58
58
|
const fail = client.fail?.bind(client);
|
|
59
59
|
if (complete === undefined || fail === undefined) {
|
|
60
60
|
throw new TypeError("This pg-boss client does not support complete and fail");
|
|
61
61
|
}
|
|
62
|
-
const handle = Effect.fnUntraced(function* (job:
|
|
62
|
+
const handle = Effect.fnUntraced(function* (job: WorkerJob<unknown>, offset: number) {
|
|
63
63
|
if (job.signal.aborted) {
|
|
64
64
|
return "interrupted";
|
|
65
65
|
}
|
|
@@ -78,7 +78,7 @@ export function batchHandler<R>(
|
|
|
78
78
|
}
|
|
79
79
|
return "settled";
|
|
80
80
|
});
|
|
81
|
-
return (jobs: readonly
|
|
81
|
+
return (jobs: readonly WorkerJob<unknown>[]) =>
|
|
82
82
|
Effect.gen(function* () {
|
|
83
83
|
const offset = yield* batchClockOffset(client, schema, name);
|
|
84
84
|
const deadline = Math.max(...jobs.map((job) => deadlineOf(job) + offset));
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import { isDeepStrictEqual } from "node:util";
|
|
2
|
-
import type {
|
|
3
|
-
import
|
|
4
|
-
import {
|
|
2
|
+
import type { ClientOptions } from "#server/clientOptions.ts";
|
|
3
|
+
import { PgBossClientOptionsError } from "#server/error.ts";
|
|
4
|
+
import type { StartingClient } from "./lifecycle.ts";
|
|
5
5
|
|
|
6
6
|
interface CachedClient {
|
|
7
|
-
readonly client:
|
|
8
|
-
readonly constructorOptions:
|
|
7
|
+
readonly client: StartingClient;
|
|
8
|
+
readonly constructorOptions: ClientOptions;
|
|
9
9
|
references: number;
|
|
10
10
|
}
|
|
11
11
|
|
|
@@ -23,13 +23,13 @@ function isCachedClient(value: unknown): value is CachedClient {
|
|
|
23
23
|
return (
|
|
24
24
|
typeof value === "object"
|
|
25
25
|
&& value !== null
|
|
26
|
-
&& Reflect.get(value, "client")
|
|
26
|
+
&& typeof Reflect.get(value, "client") === "object"
|
|
27
27
|
&& typeof Reflect.get(value, "constructorOptions") === "object"
|
|
28
28
|
&& typeof Reflect.get(value, "references") === "number"
|
|
29
29
|
);
|
|
30
30
|
}
|
|
31
31
|
|
|
32
|
-
export
|
|
32
|
+
export function acquireCachedClient(key: string | symbol, constructorOptions: ClientOptions, start: () => StartingClient) {
|
|
33
33
|
const existing = entryFor(key);
|
|
34
34
|
if (existing !== undefined) {
|
|
35
35
|
const options = [...new Set([...Object.keys(existing.constructorOptions), ...Object.keys(constructorOptions)])]
|
|
@@ -39,27 +39,15 @@ export async function acquireCachedClient(key: string | symbol, constructorOptio
|
|
|
39
39
|
throw new PgBossClientOptionsError({ key, options });
|
|
40
40
|
}
|
|
41
41
|
existing.references += 1;
|
|
42
|
-
|
|
43
|
-
return { client: await existing.client, reused: true };
|
|
44
|
-
} catch (error) {
|
|
45
|
-
existing.references -= 1;
|
|
46
|
-
throw error;
|
|
47
|
-
}
|
|
42
|
+
return { ...existing.client, reused: true };
|
|
48
43
|
}
|
|
49
44
|
const settings = { ...constructorOptions };
|
|
50
45
|
const entry: CachedClient = { client: start(), constructorOptions: settings, references: 1 };
|
|
51
46
|
clients.set(key, entry);
|
|
52
|
-
|
|
53
|
-
return { client: await entry.client, reused: false };
|
|
54
|
-
} catch (error) {
|
|
55
|
-
if (clients.get(key) === entry) {
|
|
56
|
-
clients.delete(key);
|
|
57
|
-
}
|
|
58
|
-
throw error;
|
|
59
|
-
}
|
|
47
|
+
return { ...entry.client, reused: false };
|
|
60
48
|
}
|
|
61
49
|
|
|
62
|
-
export function releaseCachedClient(key: string | symbol):
|
|
50
|
+
export function releaseCachedClient(key: string | symbol): StartingClient | undefined {
|
|
63
51
|
const entry = entryFor(key);
|
|
64
52
|
if (entry === undefined) {
|
|
65
53
|
return;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { Effect } from "effect";
|
|
2
|
-
import { logClientError } from "#internal/clientErrors.ts";
|
|
2
|
+
import { logClientError } from "#server/internal/clientErrors.ts";
|
|
3
3
|
|
|
4
4
|
export const clientErrorLogger = Effect.fnUntraced(function* () {
|
|
5
5
|
const run = Effect.runForkWith(yield* Effect.context<never>());
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import { Socket } from "node:net";
|
|
2
|
-
import {
|
|
2
|
+
import { PgBoss } from "pg-boss";
|
|
3
|
+
import type { ClientOptions } from "#server/clientOptions.ts";
|
|
4
|
+
import type { EngineClient } from "#server/engineClient.ts";
|
|
3
5
|
|
|
4
|
-
export function defaultClientFactory(options:
|
|
6
|
+
export function defaultClientFactory(options: ClientOptions): EngineClient {
|
|
5
7
|
const disconnected = new Set<Promise<void>>();
|
|
6
8
|
const config = {
|
|
7
9
|
...options,
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
import { Effect, Schema } from "effect";
|
|
2
|
-
import type {
|
|
3
|
-
import
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
2
|
+
import type { PgBossClient } from "#server/client.ts";
|
|
3
|
+
import { toPgBossError } from "#server/error.ts";
|
|
4
|
+
import { quotedSchema } from "#server/internal/storedRows.ts";
|
|
5
|
+
import type { WorkerJob } from "#server/job.ts";
|
|
6
6
|
|
|
7
7
|
const Count = Schema.Struct({ count: Schema.NumberFromString });
|
|
8
8
|
|
|
9
|
-
export const deferralCount = Effect.fnUntraced(function* (client: PgBossClient, schema: string, job:
|
|
9
|
+
export const deferralCount = Effect.fnUntraced(function* (client: PgBossClient, schema: string, job: WorkerJob<unknown>) {
|
|
10
10
|
const quoted = quotedSchema(schema);
|
|
11
11
|
return yield* Effect.tryPromise({
|
|
12
12
|
catch: (error) => toPgBossError("settle", error, job.name),
|
|
@@ -1,7 +1,8 @@
|
|
|
1
|
-
import type {
|
|
2
|
-
import {
|
|
1
|
+
import type { EngineClient } from "#server/engineClient.ts";
|
|
2
|
+
import type { JobAttempt } from "#server/internal/engine.ts";
|
|
3
|
+
import { quotedSchema } from "#server/internal/storedRows.ts";
|
|
3
4
|
|
|
4
|
-
export async function expireAttempt(client:
|
|
5
|
+
export async function expireAttempt(client: EngineClient, schema: string, job: JobAttempt, cause: "expiry" | "heartbeat" = "expiry"): Promise<void> {
|
|
5
6
|
if ((await client.schemaVersion()) !== 46) {
|
|
6
7
|
throw new Error("Testing expiry requires pg-boss schema version 46");
|
|
7
8
|
}
|
|
@@ -3,8 +3,8 @@ import { SqlClient } from "effect/sql";
|
|
|
3
3
|
import type { Connection } from "effect/sql/SqlConnection";
|
|
4
4
|
import { getConstructionPlans, getMigrationPlans, PgBoss } from "pg-boss";
|
|
5
5
|
import pgBossPackage from "pg-boss/package.json" with { type: "json" };
|
|
6
|
-
import { jobStorePlans } from "#internal/jobStorePlans.ts";
|
|
7
|
-
import type { PgBossSchemaOptions } from "#schema.ts";
|
|
6
|
+
import { jobStorePlans } from "#server/internal/jobStorePlans.ts";
|
|
7
|
+
import type { PgBossSchemaOptions } from "#server/schema.ts";
|
|
8
8
|
import { runSchemaPlan } from "./runSchemaPlan.ts";
|
|
9
9
|
import { resumeSchemaIndexes } from "./schemaIndexBuilds.ts";
|
|
10
10
|
|