@pikku/queue-pg-boss 0.12.8 → 0.12.9

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 0.12.9
+
+### Patch Changes
+
+- 6794681: Publish the ecosystem surface as per-area sub-barrels under `@pikku/core/ecosystem/*`, and point generated code, the CLI, the inspector and the runtime adapters at them.
+
+  348 names that only generated code, the toolchain or a runtime adapter ever imports now have a second home on `@pikku/core/ecosystem/<area>` — one sub-barrel per area, matching how core already publishes its entrypoints, so no single barrel grows without bound and a consumer only pulls in the area it uses.
+
+  This step is additive: every name is still exported from the entrypoint it was published from before, so nothing downstream breaks. Removing them from the app-facing barrels is a later change, and needs a release carrying `./ecosystem/*` first.
+
+- Updated dependencies [7406bfe]
+- Updated dependencies [6794681]
+  - @pikku/core@0.12.84
+
 ## 0.12.8
 
 ### Patch Changes

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 - present Yasser Fadl and Pikku contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @pikku/queue-pg-boss
+
+pg-boss queue, worker and scheduler services for Pikku. Backed by Postgres, so
+it needs no extra infrastructure if you already run one.
+
+## Install
+
+```bash
+npm install @pikku/queue-pg-boss
+```
+
+## Usage
+
+```typescript
+import PgBoss from 'pg-boss'
+import { PgBossQueueService } from '@pikku/queue-pg-boss'
+
+const pgBoss = new PgBoss(connectionString)
+await pgBoss.start()
+
+const queue = new PgBossQueueService(pgBoss)
+```
+
+Use `PgBossQueueWorkers` to process jobs and `PgBossSchedulerService` for cron
+wirings. For a Redis-backed alternative see `@pikku/queue-bullmq`.
+
+## Docs
+
+https://pikku.dev/docs

package/dist/index.d.ts

@@ -8,4 +8,5 @@ export { PgBossServiceFactory } from './pg-boss-service-factory.js';
 export { PgBossQueueService } from './pg-boss-queue-service.js';
 export { PgBossQueueWorkers } from './pg-boss-queue-worker.js';
 export { PgBossSchedulerService } from './pg-boss-scheduler-service.js';
-export type { QueueService, PikkuWorkerConfig, PikkuJobConfig, QueueJob, JobOptions, } from '@pikku/core/queue';
+export type { QueueService, QueueJob } from '@pikku/core/queue';
+export type { PikkuWorkerConfig, PikkuJobConfig, JobOptions, } from '@pikku/core/ecosystem/queue';

package/dist/pg-boss-queue-service.d.ts

@@ -1,5 +1,6 @@
 import type { PgBoss, Request as PgBossRequest } from 'pg-boss';
-import type { QueueService, QueueJob, JobOptions } from '@pikku/core/queue';
+import type { QueueService, QueueJob } from '@pikku/core/queue';
+import type { JobOptions } from '@pikku/core/ecosystem/queue';
 export declare const mapPikkuJobToPgBoss: (options?: JobOptions) => PgBossRequest["options"];
 /**
  * pg-boss/PostgreSQL queue service implementation

package/dist/pg-boss-queue-service.js

@@ -21,7 +21,9 @@ export const mapPikkuJobToPgBoss = (options) => {
         pgBossOptions.retryLimit = options.attempts - 1;
     }
     if (options?.backoff !== undefined) {
-        const type = typeof options.backoff === 'string' ? options.backoff : options.backoff.type;
+        const type = typeof options.backoff === 'string'
+            ? options.backoff
+            : options.backoff.type;
         const delay = typeof options.backoff === 'object' ? options.backoff.delay : undefined;
         pgBossOptions.retryBackoff = type === 'exponential';
         if (delay !== undefined) {

package/dist/pg-boss-queue-worker.d.ts

@@ -1,5 +1,5 @@
 import type { PgBoss, WorkOptions } from 'pg-boss';
-import type { QueueWorkers, PikkuWorkerConfig, QueueConfigMapping, ConfigValidationResult } from '@pikku/core/queue';
+import type { QueueWorkers, PikkuWorkerConfig, QueueConfigMapping, ConfigValidationResult } from '@pikku/core/ecosystem/queue';
 import type { Logger } from '@pikku/core/services';
 export declare const mapPikkuWorkerToPgBoss: (workerConfig?: PikkuWorkerConfig) => WorkOptions;
 /**

package/dist/pg-boss-queue-worker.js

@@ -1,5 +1,6 @@
-import { registerQueueWorkers, runQueueJob, QueueJobFailedError, QueueJobDiscardedError, } from '@pikku/core/queue';
-import { pikkuState } from '@pikku/core/internal';
+import { runQueueJob } from '@pikku/core/queue';
+import { registerQueueWorkers, QueueJobFailedError, QueueJobDiscardedError, } from '@pikku/core/ecosystem/queue';
+import { pikkuState } from '@pikku/core/ecosystem';
 import { mapPgBossJobToQueueJob } from './utils.js';
 export const mapPikkuWorkerToPgBoss = (workerConfig) => {
     // Map the requested parallelism to pg-boss `localConcurrency` (independent

package/dist/pg-boss-scheduler-service.d.ts

@@ -1,5 +1,6 @@
 import type { PgBoss } from 'pg-boss';
-import type { ScheduledTaskInfo, ScheduledTaskSummary, CoreUserSession } from '@pikku/core';
+import type { CoreUserSession } from '@pikku/core';
+import type { ScheduledTaskInfo, ScheduledTaskSummary } from '@pikku/core/ecosystem/services';
 import { SchedulerService } from '@pikku/core';
 /**
  * pg-boss scheduler service implementation

package/dist/pg-boss-scheduler-service.js

@@ -1,6 +1,8 @@
-import { SchedulerService, parseDurationString } from '@pikku/core';
-import { pikkuState } from '@pikku/core/internal';
-import { runScheduledTask, getScheduledTasks } from '@pikku/core/scheduler';
+import { SchedulerService } from '@pikku/core';
+import { parseDurationString } from '@pikku/core/ecosystem/types';
+import { pikkuState } from '@pikku/core/ecosystem';
+import { runScheduledTask } from '@pikku/core/scheduler';
+import { getScheduledTasks } from '@pikku/core/ecosystem/scheduler';
 /** Prefix for pg-boss queues/schedules backing recurring scheduled tasks. */
 const RECURRING_TASK_PREFIX = 'pikku-recurring-scheduled-task_';
 /**

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@pikku/queue-pg-boss",
-  "version": "0.12.8",
+  "version": "0.12.9",
+  "description": "pg-boss queue, worker and scheduler services for Pikku, backed by Postgres",
   "author": "yasser.fadl@gmail.com",
   "license": "MIT",
   "module": "dist/index.js",
@@ -15,7 +16,7 @@
     "prepublishOnly": "yarn build"
   },
   "peerDependencies": {
-    "@pikku/core": "^0.12.69"
+    "@pikku/core": "^0.12.84"
   },
   "dependencies": {
     "pg-boss": "^12.14.0"

package/src/index.ts

@@ -11,10 +11,9 @@ export { PgBossQueueWorkers } from './pg-boss-queue-worker.js'
 export { PgBossSchedulerService } from './pg-boss-scheduler-service.js'
 
 // Re-export core queue types for convenience
+export type { QueueService, QueueJob } from '@pikku/core/queue'
 export type {
-  QueueService,
   PikkuWorkerConfig,
   PikkuJobConfig,
-  QueueJob,
   JobOptions,
-} from '@pikku/core/queue'
+} from '@pikku/core/ecosystem/queue'

package/src/pg-boss-queue-service.ts

@@ -1,5 +1,6 @@
 import type { PgBoss, Request as PgBossRequest } from 'pg-boss'
-import type { QueueService, QueueJob, JobOptions } from '@pikku/core/queue'
+import type { QueueService, QueueJob } from '@pikku/core/queue'
+import type { JobOptions } from '@pikku/core/ecosystem/queue'
 import { mapPgBossJobToQueueJob } from './utils.js'
 
 export const mapPikkuJobToPgBoss = (
@@ -33,7 +34,9 @@ export const mapPikkuJobToPgBoss = (
 
   if (options?.backoff !== undefined) {
     const type =
-      typeof options.backoff === 'string' ? options.backoff : options.backoff.type
+      typeof options.backoff === 'string'
+        ? options.backoff
+        : options.backoff.type
     const delay =
       typeof options.backoff === 'object' ? options.backoff.delay : undefined
     pgBossOptions.retryBackoff = type === 'exponential'

package/src/pg-boss-queue-worker.ts

@@ -4,14 +4,14 @@ import type {
   PikkuWorkerConfig,
   QueueConfigMapping,
   ConfigValidationResult,
-} from '@pikku/core/queue'
+} from '@pikku/core/ecosystem/queue'
+import { runQueueJob } from '@pikku/core/queue'
 import {
   registerQueueWorkers,
-  runQueueJob,
   QueueJobFailedError,
   QueueJobDiscardedError,
-} from '@pikku/core/queue'
-import { pikkuState } from '@pikku/core/internal'
+} from '@pikku/core/ecosystem/queue'
+import { pikkuState } from '@pikku/core/ecosystem'
 import type { Logger } from '@pikku/core/services'
 import { mapPgBossJobToQueueJob } from './utils.js'
 

package/src/pg-boss-scheduler-service.ts

@@ -1,12 +1,14 @@
 import type { PgBoss } from 'pg-boss'
+import type { CoreUserSession } from '@pikku/core'
 import type {
   ScheduledTaskInfo,
   ScheduledTaskSummary,
-  CoreUserSession,
-} from '@pikku/core'
-import { SchedulerService, parseDurationString } from '@pikku/core'
-import { pikkuState } from '@pikku/core/internal'
-import { runScheduledTask, getScheduledTasks } from '@pikku/core/scheduler'
+} from '@pikku/core/ecosystem/services'
+import { SchedulerService } from '@pikku/core'
+import { parseDurationString } from '@pikku/core/ecosystem/types'
+import { pikkuState } from '@pikku/core/ecosystem'
+import { runScheduledTask } from '@pikku/core/scheduler'
+import { getScheduledTasks } from '@pikku/core/ecosystem/scheduler'
 
 /**
  * Data stored in scheduled job