@pikku/queue-pg-boss 0.12.9 → 0.12.10

package/CHANGELOG.md

@@ -1,3 +1,103 @@
+## 0.12.10
+
+### Patch Changes
+
+- 266e3bc: One door per name: `@pikku/core/ecosystem/*` and the package root are gone
+
+  `@pikku/core` published every module twice. `ecosystem/http` re-exported
+  `./http`, `ecosystem/services` re-exported `./services`, and a name was
+  reachable through either — so every addition had to be made in two places, and a
+  consumer's import said nothing about what it actually used. The package root was
+  the same problem at a larger scale: a single barrel of 206 names that no bundler
+  could take apart, and the one specifier that revealed nothing at all.
+
+  Both are deleted. Every name now lives on the subpath that owns it, and every
+  import carries that subpath — `@pikku/core/http`, `@pikku/core/services`,
+  `@pikku/core/errors`, `@pikku/core/types`.
+
+  Deleting the facades meant the raw subpaths had to become a superset of them,
+  which they were not: the facade tree had accumulated 25 names with no raw home
+  and about 26 more filed under a different area than the module they came from.
+  Those names moved to the area that owns them, and three areas were published as
+  new entry points rather than left on a root that is going away — `./types` (the
+  shared type surface, the largest single destination), `./state` and
+  `./classification`.
+
+  `./classification` is one door onto one subject: what a value is and how it must
+  be handled. Its three halves would each have been an entry point — the brands
+  and manifest types, the stored-form helpers (`hashToken`, `unsafeAsSealed` and
+  friends), and `SecretValue` — split by whether a name happens to be a type or a
+  value, which is the same defect as the facades. The duration and versioned-id
+  helpers went to `./utils`, which already published, and `PikkuRequest` went to
+  `./function`: it is the transport-agnostic request base, not an HTTP one — HTTP
+  has `PikkuHTTPAbstractRequest`, and the only thing outside core that extends
+  `PikkuRequest` is Azure's timer request.
+
+  `./types` inherited the root barrel's habit before it inherited its contents, so
+  the names with an owner elsewhere were moved off it. The middleware types and the
+  five middleware factories — `pikkuMiddleware`, `pikkuMiddlewareFactory`,
+  `pikkuChannelMiddleware`, `pikkuChannelMiddlewareFactory` and
+  `pikkuAgentMiddleware`, runtime values on a types entry point — are now
+  `@pikku/core/middleware`; the function meta types are `@pikku/core/function`;
+  `SerializedError` is `@pikku/core/errors`; and the generic TypeScript helpers
+  (`MakeRequired`, `PickRequired`, `PickOptional`, `RequireAtLeastOne`,
+  `JSONPrimitive`, `JSONValue`) are `@pikku/core/utils`. What is left on `./types`
+  is the vocabulary the wirings share, which no single module owns.
+
+  `pikku` was itself a root barrel — `export * from '@pikku/core'` — and
+  now exports only the services it bundles.
+
+  One module survives at the old specifier, and only for the bootstrap:
+  `packages/cli` is generated by the _published_ CLI pinned in its `build.sh`, and
+  that CLI still writes a bare `@pikku/core` into the files it generates for the
+  CLI itself. `bootstrap-compat/root.ts` carries the eight types it names, a test
+  in core fails if that list grows, and it goes when the pin moves to a CLI
+  released from this branch. The adapter names the pinned CLI reaches for —
+  `pikkuState` and `CreateWireServices` — are rewritten to `@pikku/core/state` and
+  `@pikku/core/types` by the same `build.sh` patch pass, so no second shim is
+  needed for them.
+
+  A guard test keeps the root shut: it parses imports and rejects a bare
+  `@pikku/core` rather than grepping for it, because several tests hold a user's
+  file as a template literal, where `import … from '@pikku/core'` is fixture text
+  rather than an import this repo makes.
+
+  An agent scaffold a project generated under an older CLI is refreshed rather
+  than left to fail: `pikku all` already deleted one importing an entry point
+  `@pikku/core` no longer publishes, and the `#pikku` hub joins that list.
+  Without it a project that scaffolds the agent endpoint but
+  declares no agents keeps the old file forever — the generator that would rewrite
+  it only runs when agents exist, and the file being present is what stops it
+  being regenerated as missing.
+
+  `pikku new addon` also wrote a tsconfig `paths` map naming only the deleted hub.
+  An addon's `imports` map points into `dist`, so `paths` is what resolves
+  `#pikku/<leaf>` for the addon's own source build — it now names the two leaf
+  patterns, in both the addon and its test harness.
+
+- 6eef0a0: Bump every dependency to its latest compatible minor/patch across the monorepo.
+- Updated dependencies [7722ceb]
+- Updated dependencies [375c1ff]
+- Updated dependencies [02a70cd]
+- Updated dependencies [aeef159]
+- Updated dependencies [a281de6]
+- Updated dependencies [266e3bc]
+- Updated dependencies [02a70cd]
+- Updated dependencies [786dae5]
+- Updated dependencies [6eef0a0]
+- Updated dependencies [3561d67]
+- Updated dependencies [a91c433]
+- Updated dependencies [02a70cd]
+- Updated dependencies [9537f74]
+- Updated dependencies [2b57ca8]
+- Updated dependencies [266e3bc]
+- Updated dependencies [9fce0f1]
+- Updated dependencies [83683a0]
+- Updated dependencies [456c88b]
+- Updated dependencies [456c88b]
+- Updated dependencies [c127273]
+  - @pikku/core@0.12.85
+
 ## 0.12.9
 
 ### Patch Changes

package/dist/index.d.ts

@@ -8,5 +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, QueueJob } from '@pikku/core/queue';
-export type { PikkuWorkerConfig, PikkuJobConfig, JobOptions, } from '@pikku/core/ecosystem/queue';
+export type { QueueJob, QueueService } from '@pikku/core/queue';
+export type { PikkuWorkerConfig, PikkuJobConfig, JobOptions, } from '@pikku/core/queue';

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

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

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/ecosystem/queue';
+import type { QueueWorkers, PikkuWorkerConfig, QueueConfigMapping, ConfigValidationResult } from '@pikku/core/queue';
 import type { Logger } from '@pikku/core/services';
 export declare const mapPikkuWorkerToPgBoss: (workerConfig?: PikkuWorkerConfig) => WorkOptions;
 /**

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

@@ -1,6 +1,6 @@
 import { runQueueJob } from '@pikku/core/queue';
-import { registerQueueWorkers, QueueJobFailedError, QueueJobDiscardedError, } from '@pikku/core/ecosystem/queue';
-import { pikkuState } from '@pikku/core/ecosystem';
+import { registerQueueWorkers, QueueJobFailedError, QueueJobDiscardedError, } from '@pikku/core/queue';
+import { pikkuState } from '@pikku/core/state';
 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,7 +1,7 @@
 import type { PgBoss } from 'pg-boss';
-import type { CoreUserSession } from '@pikku/core';
-import type { ScheduledTaskInfo, ScheduledTaskSummary } from '@pikku/core/ecosystem/services';
-import { SchedulerService } from '@pikku/core';
+import { SchedulerService } from '@pikku/core/services';
+import type { CoreUserSession } from '@pikku/core/types';
+import type { ScheduledTaskInfo, ScheduledTaskSummary } from '@pikku/core/services';
 /**
  * pg-boss scheduler service implementation
  * Uses pg-boss's schedule() API to store recurring jobs in PostgreSQL.

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

@@ -1,8 +1,8 @@
-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';
+import { SchedulerService } from '@pikku/core/services';
+import { parseDurationString } from '@pikku/core/utils';
+import { pikkuState } from '@pikku/core/state';
+import { getScheduledTasks } from '@pikku/core/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,6 @@
 {
   "name": "@pikku/queue-pg-boss",
-  "version": "0.12.9",
+  "version": "0.12.10",
   "description": "pg-boss queue, worker and scheduler services for Pikku, backed by Postgres",
   "author": "yasser.fadl@gmail.com",
   "license": "MIT",
@@ -16,10 +16,10 @@
     "prepublishOnly": "yarn build"
   },
   "peerDependencies": {
-    "@pikku/core": "^0.12.84"
+    "@pikku/core": "^0.12.85"
   },
   "dependencies": {
-    "pg-boss": "^12.14.0"
+    "pg-boss": "^12.27.0"
   },
   "devDependencies": {
     "typescript": "^6.0.3"
@@ -27,4 +27,4 @@
   "exports": {
     ".": "./dist/index.js"
   }
-}
+}

package/src/index.ts

@@ -11,9 +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 { QueueJob, QueueService } from '@pikku/core/queue'
 export type {
   PikkuWorkerConfig,
   PikkuJobConfig,
   JobOptions,
-} from '@pikku/core/ecosystem/queue'
+} from '@pikku/core/queue'

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

@@ -60,8 +60,10 @@ describe('mapPikkuJobToPgBoss — retry mapping', () => {
 
 describe('mapPikkuJobToPgBoss — group mapping', () => {
   test('group id is forwarded so the worker can enforce a per-group limit', () => {
-    assert.deepEqual(mapPikkuJobToPgBoss({ group: { id: 'deployWorkflow' } })
-      .group, { id: 'deployWorkflow' })
+    assert.deepEqual(
+      mapPikkuJobToPgBoss({ group: { id: 'deployWorkflow' } }).group,
+      { id: 'deployWorkflow' }
+    )
   })
 
   test('tier is only set when provided', () => {
@@ -69,7 +71,10 @@ describe('mapPikkuJobToPgBoss — group mapping', () => {
       group: { id: 'deployWorkflow', tier: 'slow' },
     })
     assert.deepEqual(opts.group, { id: 'deployWorkflow', tier: 'slow' })
-    assert.equal('tier' in mapPikkuJobToPgBoss({ group: { id: 'a' } }).group!, false)
+    assert.equal(
+      'tier' in mapPikkuJobToPgBoss({ group: { id: 'a' } }).group!,
+      false
+    )
   })
 
   test('no group → no group field', () => {

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

@@ -1,6 +1,6 @@
 import type { PgBoss, Request as PgBossRequest } from 'pg-boss'
-import type { QueueService, QueueJob } from '@pikku/core/queue'
-import type { JobOptions } from '@pikku/core/ecosystem/queue'
+import type { QueueJob, QueueService } from '@pikku/core/queue'
+import type { JobOptions } from '@pikku/core/queue'
 import { mapPgBossJobToQueueJob } from './utils.js'
 
 export const mapPikkuJobToPgBoss = (

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

@@ -4,15 +4,15 @@ import type {
   PikkuWorkerConfig,
   QueueConfigMapping,
   ConfigValidationResult,
-} from '@pikku/core/ecosystem/queue'
+} from '@pikku/core/queue'
 import { runQueueJob } from '@pikku/core/queue'
+import type { Logger } from '@pikku/core/services'
 import {
   registerQueueWorkers,
   QueueJobFailedError,
   QueueJobDiscardedError,
-} from '@pikku/core/ecosystem/queue'
-import { pikkuState } from '@pikku/core/ecosystem'
-import type { Logger } from '@pikku/core/services'
+} from '@pikku/core/queue'
+import { pikkuState } from '@pikku/core/state'
 import { mapPgBossJobToQueueJob } from './utils.js'
 
 export const mapPikkuWorkerToPgBoss = (
@@ -180,7 +180,7 @@ export class PgBossQueueWorkers implements QueueWorkers {
       logger,
       async (queueName, processor) => {
         await this.pgBoss.createQueue(queueName)
-        const workerId = await this.pgBoss.work<any>(
+        const workerId = await this.pgBoss.work(
           processor.name,
           {
             ...mapPikkuWorkerToPgBoss(processor.config),

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

@@ -1,14 +1,14 @@
 import type { PgBoss } from 'pg-boss'
-import type { CoreUserSession } from '@pikku/core'
+import { runScheduledTask } from '@pikku/core/scheduler'
+import { SchedulerService } from '@pikku/core/services'
+import type { CoreUserSession } from '@pikku/core/types'
 import type {
   ScheduledTaskInfo,
   ScheduledTaskSummary,
-} 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'
+} from '@pikku/core/services'
+import { parseDurationString } from '@pikku/core/utils'
+import { pikkuState } from '@pikku/core/state'
+import { getScheduledTasks } from '@pikku/core/scheduler'
 
 /**
  * Data stored in scheduled job