@bett3r-dev/pv3-types 1.0.0 → 1.11.0

package/CHANGELOG.md

@@ -0,0 +1,305 @@
+# @bett3r-dev/pv3-types
+
+<!-- MONOWEAVE:BELOW -->
+
+## [1.11.0](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.10.0...@bett3r-dev/pv3-types@1.11.0) "@bett3r-dev/pv3-types" (9/20/2026) <a name="1.11.0"></a>
+
+### Changes
+
+* feat(eventsourcing): add .stateStored as the named way to declare a state-stored aggregate ([87c7418c](git+https://github.com/bett3r-dev/pv3/commits/87c7418c))
+* Oracle: packages/pv3-library-tests/src/__tests__/eventsourcing/users.aggregate.test.ts ([87c7418c](git+https://github.com/bett3r-dev/pv3/commits/87c7418c))
+
+
+## [1.10.0](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.9.0...@bett3r-dev/pv3-types@1.10.0) "@bett3r-dev/pv3-types" (9/13/2026) <a name="1.10.0"></a>
+
+### Changes
+
+* feat(logger): per-module log levels via logger.moduleLevels ([201c6a68](git+https://github.com/bett3r-dev/pv3/commits/201c6a68))
+
+
+## [1.9.0](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.8.0...@bett3r-dev/pv3-types@1.9.0) "@bett3r-dev/pv3-types" (8/26/2026) <a name="1.9.0"></a>
+
+### Changes
+
+* fix(validation): update ReadmodelDefaultQuerySchema to accept string or number for the `after` cursor ([2767dc66](git+https://github.com/bett3r-dev/pv3/commits/2767dc66))
+* feat(eventsourcing): let a readmodel query declare its own HTTP visibility ([f95d49e1](git+https://github.com/bett3r-dev/pv3/commits/f95d49e1))
+
+
+## [1.8.0](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.7.0...@bett3r-dev/pv3-types@1.8.0) "@bett3r-dev/pv3-types" (8/25/2026) <a name="1.8.0"></a>
+
+### Changes
+
+* feat(database): add aggregate operation with GROUP BY to the collection contract ([96d540b4](git+https://github.com/bett3r-dev/pv3/commits/96d540b4))
+* Oracle: packages/pv3-adapter-database-postgres/__tests__/aggregate.deps.test.ts ([96d540b4](git+https://github.com/bett3r-dev/pv3/commits/96d540b4))
+* feat(database): support count, min, max and avg with multi-key grouping ([5e1e7740](git+https://github.com/bett3r-dev/pv3/commits/5e1e7740))
+* Oracle: packages/pv3-adapter-database-postgres/__tests__/aggregate.vocabulary.deps.test.ts ([5e1e7740](git+https://github.com/bett3r-dev/pv3/commits/5e1e7740))
+* feat(database): reject a malformed aggregate spec before deriving from it ([c959d4ec](git+https://github.com/bett3r-dev/pv3/commits/c959d4ec))
+* Oracle: packages/pv3-types/__tests__/aggregateSchema.validation.test.ts ([c959d4ec](git+https://github.com/bett3r-dev/pv3/commits/c959d4ec))
+* feat(types): export deriveAggregateSchema from the public surface ([5673495f](git+https://github.com/bett3r-dev/pv3/commits/5673495f))
+* Oracle: packages/pv3-types/__tests__/aggregateSchema.publicImport.test.ts ([5673495f](git+https://github.com/bett3r-dev/pv3/commits/5673495f))
+* it: jest's `moduleNameMapper` key `@bett3r-dev/pv3-types` is substring-matched, ([5673495f](git+https://github.com/bett3r-dev/pv3/commits/5673495f))
+* fix(types): a group key absent from a row is a nullable column ([0c588572](git+https://github.com/bett3r-dev/pv3/commits/0c588572))
+* Oracle: the flipped case (f) in aggregate.groupkey.deps.test.ts ([0c588572](git+https://github.com/bett3r-dev/pv3/commits/0c588572))
+* feat(database): filter, order and bound a grouped query ([c24d0855](git+https://github.com/bett3r-dev/pv3/commits/c24d0855))
+* Oracle: packages/pv3-adapter-database-postgres/__tests__/aggregate.filterbounds.deps.test.ts ([c24d0855](git+https://github.com/bett3r-dev/pv3/commits/c24d0855))
+* feat(eventsourcing): accept an aggregation spec over HTTP ([4fc44ff6](git+https://github.com/bett3r-dev/pv3/commits/4fc44ff6))
+* Oracle: packages/pv3-library-tests/src/__tests__/eventsourcing/eventhandlers.aggregate.test.ts ([4fc44ff6](git+https://github.com/bett3r-dev/pv3/commits/4fc44ff6))
+* fix(aggregate): close three findings from the whole-PR review ([4261a65a](git+https://github.com/bett3r-dev/pv3/commits/4261a65a))
+
+
+## [1.7.0](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.6.0...@bett3r-dev/pv3-types@1.7.0) "@bett3r-dev/pv3-types" (8/15/2026) <a name="1.7.0"></a>
+
+### Changes
+
+* feat(deployment-units): emit linkedTo endpoints as manifest artifacts (TV1-2257) ([7b4a8d55](git+https://github.com/bett3r-dev/pv3/commits/7b4a8d55))
+* Oracles: computeMDUs.test.ts (17/17), declarationSite.test.ts (6/6). ([7b4a8d55](git+https://github.com/bett3r-dev/pv3/commits/7b4a8d55))
+* feat(pv3-types): add 'array' CLI arg type ([fc1e9c3a](git+https://github.com/bett3r-dev/pv3/commits/fc1e9c3a))
+* feat(pv3-types): record a manual endpoint's route on its declaration site (TV1-2257) ([f59e5c47](git+https://github.com/bett3r-dev/pv3/commits/f59e5c47))
+* feat(eventsourcing): give a readmodel query's formatter the caller it serves ([6a822e2f](git+https://github.com/bett3r-dev/pv3/commits/6a822e2f))
+* Oracle: eventHandlers/__tests__/queryResponseFormatterCaller.test.ts (1 case, ([6a822e2f](git+https://github.com/bett3r-dev/pv3/commits/6a822e2f))
+* here: it passes under an implementation that ignores the caller entirely. ([6a822e2f](git+https://github.com/bett3r-dev/pv3/commits/6a822e2f))
+* feat(eventsourcing): shape realtime deltas per subscriber, not per change ([ba1a0868](git+https://github.com/bett3r-dev/pv3/commits/ba1a0868))
+* feat(pv3-types): make a response formatter a synchronous function of ( data, caller ) ([cd3b556e](git+https://github.com/bett3r-dev/pv3/commits/cd3b556e))
+* Oracle: `yarn build` (exit 0), not a test run — jest is transpile-only here, so ([cd3b556e](git+https://github.com/bett3r-dev/pv3/commits/cd3b556e))
+* fix(pv3-types): declare the infrastructure adapter selector in the config schema ([73eebef7](git+https://github.com/bett3r-dev/pv3/commits/73eebef7))
+* fix(eventsourcing): never let an absent caller skip per-subscriber shaping ([f8605f51](git+https://github.com/bett3r-dev/pv3/commits/f8605f51))
+* fix(pv3-types): clean up optional properties in InfrastructureConfigSchema ([cc5e319a](git+https://github.com/bett3r-dev/pv3/commits/cc5e319a))
+* feat(configuration): expose the last-applied arg snapshot synchronously ([2f567542](git+https://github.com/bett3r-dev/pv3/commits/2f567542))
+
+
+## [1.6.0](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.5.0...@bett3r-dev/pv3-types@1.6.0) "@bett3r-dev/pv3-types" (8/2/2026) <a name="1.6.0"></a>
+
+### Changes
+
+* feat(query-params): marker-sniff rison encoding for object/array query params ([74f85a27](git+https://github.com/bett3r-dev/pv3/commits/74f85a27))
+* Ticket: TV1-1466 ([74f85a27](git+https://github.com/bett3r-dev/pv3/commits/74f85a27))
+* fix(endpoint-validation): decode query before validation for all transports ([7b2210c1](git+https://github.com/bett3r-dev/pv3/commits/7b2210c1))
+* Ticket: TV1-1466 ([7b2210c1](git+https://github.com/bett3r-dev/pv3/commits/7b2210c1))
+* feat(eventstore): enhance reduceMultipleStream to support transactions ([1680d047](git+https://github.com/bett3r-dev/pv3/commits/1680d047))
+* fix(outbox): instrument event flow + restore self-healing OOS recovery ([3069caad](git+https://github.com/bett3r-dev/pv3/commits/3069caad))
+* feat(outbox-types): add notifyPullDebounceMs config field ([988f6901](git+https://github.com/bett3r-dev/pv3/commits/988f6901))
+* feat(outbox): wire scheduler + coordinators into EventDispatcher ([26ae44af](git+https://github.com/bett3r-dev/pv3/commits/26ae44af))
+* Tests: 61/61 pass across 4 eventDispatcher test files. ([26ae44af](git+https://github.com/bett3r-dev/pv3/commits/26ae44af))
+* feat(endpoints): rename defaultVisibility→visibility and add identity-forwarding to internal gateway ([4396abae](git+https://github.com/bett3r-dev/pv3/commits/4396abae))
+* BREAKING: consumers reading `x-default-visibility` from generated OpenAPI ([4396abae](git+https://github.com/bett3r-dev/pv3/commits/4396abae))
+* feat(command-templates): introduce CommandTemplate type and update related components ([dce852f7](git+https://github.com/bett3r-dev/pv3/commits/dce852f7))
+* feat(cache): add incrementByWithExpiry method for Memory and Redis caches ([cd93efc7](git+https://github.com/bett3r-dev/pv3/commits/cd93efc7))
+* feat(errors): enhance AppError with optional logLevel for flexible logging ([2e29c2db](git+https://github.com/bett3r-dev/pv3/commits/2e29c2db))
+* fix(command-handlers): add visibility property to command handlers and builder ([a6262ef4](git+https://github.com/bett3r-dev/pv3/commits/a6262ef4))
+* fix(database): extend watch functionality to include 'invalidate' change type ([901048e5](git+https://github.com/bett3r-dev/pv3/commits/901048e5))
+* fix(eventsourcing): improve event reducer handling by introducing ReducerNOOP and filtering non-noop events ([e11aa2f5](git+https://github.com/bett3r-dev/pv3/commits/e11aa2f5))
+* feat(pv3-adapter-database-postgres): refactor indexing to use generated columns + B-tree ([896376df](git+https://github.com/bett3r-dev/pv3/commits/896376df))
+* Ticket: TV1-1320 ([896376df](git+https://github.com/bett3r-dev/pv3/commits/896376df))
+* feat(pv3,observability): refactor ReadmodelChange to discriminated union, add undici instrumentation, and fix subscription wiring ([088c4cb9](git+https://github.com/bett3r-dev/pv3/commits/088c4cb9))
+* feat(tsgo): migrate build scripts from tsc to tsgo across multiple packages and update TypeScript configuration ([e0cf2b51](git+https://github.com/bett3r-dev/pv3/commits/e0cf2b51))
+* feat(outbox): implement Redis-backed L2 event cache shared across brokers ([a2a50547](git+https://github.com/bett3r-dev/pv3/commits/a2a50547))
+* feat(outbox): enhance outbox manager with Redis-backed L2 event cache and remove legacy channels ([36cf0558](git+https://github.com/bett3r-dev/pv3/commits/36cf0558))
+* fix(database): enhance array filter operations and add notEmpty support ([22c89c89](git+https://github.com/bett3r-dev/pv3/commits/22c89c89))
+* fix(outbox): atomic claimPosition closes bitmap dedup TOCTOU (TV1-1914) ([c32651df](git+https://github.com/bett3r-dev/pv3/commits/c32651df))
+* fix(outbox): claim lease + sweep to recover orphaned claims (TV1-1914 #3) ([8b995ab4](git+https://github.com/bett3r-dev/pv3/commits/8b995ab4))
+* fix(outbox-manager): prevent at-most-once drop on cross-split claim and in-flight bitmap collision (TV1-1914) ([3cf35e26](git+https://github.com/bett3r-dev/pv3/commits/3cf35e26))
+* Ticket: TV1-1506 ([3cf35e26](git+https://github.com/bett3r-dev/pv3/commits/3cf35e26))
+* feat(outbox): resurrect sub-watermark gap recovery; renumber ADR-012 → ADR-013 ([651a9777](git+https://github.com/bett3r-dev/pv3/commits/651a9777))
+* feat(outbox): stamp event.metadata.isRedelivery on definite redeliveries (TV1-1946) ([d039937f](git+https://github.com/bett3r-dev/pv3/commits/d039937f))
+* fix(outbox): stop phantom-gap recovery from re-dispatching handled events ([5f8f169d](git+https://github.com/bett3r-dev/pv3/commits/5f8f169d))
+* Verified: full outbox-manager suite green (113 tests, --runInBand) plus 3 ([5f8f169d](git+https://github.com/bett3r-dev/pv3/commits/5f8f169d))
+* feat(outbox): stream-fed dispatch deduped by shared per-(sub,stream) watermark ([752454ec](git+https://github.com/bett3r-dev/pv3/commits/752454ec))
+* Oracles: bitmapLeak.test.ts (Seam A, re-pointed onto subWm) — exactly-once ([752454ec](git+https://github.com/bett3r-dev/pv3/commits/752454ec))
+* feat(outbox): stamp isRedelivery from the per-(sub,stream) watermark ([4c095c1a](git+https://github.com/bett3r-dev/pv3/commits/4c095c1a))
+* Oracle: eventProcessing.test.ts Seam E (re-pointed onto subWm, 4 tests) — ([4c095c1a](git+https://github.com/bett3r-dev/pv3/commits/4c095c1a))
+* feat(outbox): admin scoped refill + recovery cursor + stream-path errored-stream quarantine ([3df2f99f](git+https://github.com/bett3r-dev/pv3/commits/3df2f99f))
+* feat(outbox): wire the commit-order stream as the production forward feed ([477f8dee](git+https://github.com/bett3r-dev/pv3/commits/477f8dee))
+* Oracle: redisCommitOrderStream.test.ts (real Redis, db:6) — events XADDed to the ([477f8dee](git+https://github.com/bett3r-dev/pv3/commits/477f8dee))
+* feat(outbox): bounded watermark GC keyed on the stream trim horizon ([72883f5b](git+https://github.com/bett3r-dev/pv3/commits/72883f5b))
+* Oracle: watermarkGc.test.ts (real Redis, db:5) — strictly-below dropped, ([72883f5b](git+https://github.com/bett3r-dev/pv3/commits/72883f5b))
+* feat(outbox): emit stream depth / consumer lag / refill / watermark metrics ([deeab3a7](git+https://github.com/bett3r-dev/pv3/commits/deeab3a7))
+* Oracles: instrumentEventProcessing.streamMetrics.test.ts (real MeterProvider + ([deeab3a7](git+https://github.com/bett3r-dev/pv3/commits/deeab3a7))
+* fix(outbox): stream-path retry/quarantine contract, refill trim-floor pin, recovery subWm advance ([9148fa45](git+https://github.com/bett3r-dev/pv3/commits/9148fa45))
+* Oracle: eventProcessing.test.ts. ([9148fa45](git+https://github.com/bett3r-dev/pv3/commits/9148fa45))
+* Doc: outbox-architecture.md "Retryable Error Handling" reconciled with the stream-path contract. ([9148fa45](git+https://github.com/bett3r-dev/pv3/commits/9148fa45))
+* feat(eventsourcing): enhance SSE subscription handling with authoritative readmodel name ([54a34d85](git+https://github.com/bett3r-dev/pv3/commits/54a34d85))
+* feat(docker-events): improve Docker event handling and error resilience ([e8d4c860](git+https://github.com/bett3r-dev/pv3/commits/e8d4c860))
+* fix(outbox): correct stale commitOrderStream fallback doc after D5a de-brand (TV1-1950) ([11fd7a57](git+https://github.com/bett3r-dev/pv3/commits/11fd7a57))
+* feat(outbox): hybrid dedup — null-version events dedup order-free on a position bitmap ([58ba223b](git+https://github.com/bett3r-dev/pv3/commits/58ba223b))
+* feat(outbox): prune null-class bitmap epochs to the trim floor (pruneBitmap) ([5ea6e4f0](git+https://github.com/bett3r-dev/pv3/commits/5ea6e4f0))
+* feat(outbox): dead-letter poison null-events so the stream keeps flowing ([dd54ba6d](git+https://github.com/bett3r-dev/pv3/commits/dd54ba6d))
+* feat(outbox): circuit breaker + half-open per (sub,host) for null events ([22a73639](git+https://github.com/bett3r-dev/pv3/commits/22a73639))
+* feat(outbox): operator drains the DLQ as first-delivery, not replay ([12a0495f](git+https://github.com/bett3r-dev/pv3/commits/12a0495f))
+* fix(outbox): harden null-class breaker — frontier-driven half-open probe + burst-safe trip (verify-build F1/F2/F4) ([e41930f5](git+https://github.com/bett3r-dev/pv3/commits/e41930f5))
+* Tests: rewrote the multi-split probe oracle to prove the frontier-driven probe ([e41930f5](git+https://github.com/bett3r-dev/pv3/commits/e41930f5))
+* feat(subscriptions): enhance live tracking of delivered events and events per second ([d869287b](git+https://github.com/bett3r-dev/pv3/commits/d869287b))
+* feat(subscriptions): implement consumer lag tracking and enhance metrics ([b327f235](git+https://github.com/bett3r-dev/pv3/commits/b327f235))
+* feat(admin): single-entry DLQ retry ([06619993](git+https://github.com/bett3r-dev/pv3/commits/06619993))
+* feat(outbox): DLQ-aware subscription status + fix stale split status after recovery ([54d0a228](git+https://github.com/bett3r-dev/pv3/commits/54d0a228))
+* feat(outbox): improve outbox admin ui ([b632b0b5](git+https://github.com/bett3r-dev/pv3/commits/b632b0b5))
+* feat(outbox): enrich DLQ errors with name/details and capture consumer response body ([675978bb](git+https://github.com/bett3r-dev/pv3/commits/675978bb))
+* Ticket: TV1-1954 ([675978bb](git+https://github.com/bett3r-dev/pv3/commits/675978bb))
+* feat(outbox): whole-split halt on retryable exhaustion + operator restart-datasplit (TV1-1954) ([174c111a](git+https://github.com/bett3r-dev/pv3/commits/174c111a))
+* Recovery: new restartDataSplit(subscriptionId, splitIndex) on the dispatcher + ([174c111a](git+https://github.com/bett3r-dev/pv3/commits/174c111a))
+* Tests: new splitHalt.test.ts (real Redis, db 12) covers halt-on-exhaustion ([174c111a](git+https://github.com/bett3r-dev/pv3/commits/174c111a))
+* feat(outbox): live retry progress on the datasplit view (TV1-1954) ([f02a3f13](git+https://github.com/bett3r-dev/pv3/commits/f02a3f13))
+* feat(outbox): honest backlog figures for halted and retrying datasplits (TV1-1954) ([46620ba3](git+https://github.com/bett3r-dev/pv3/commits/46620ba3))
+* Tests: splitHalt integration suite (real Redis, real pump/gate) extended — ([46620ba3](git+https://github.com/bett3r-dev/pv3/commits/46620ba3))
+* feat(outbox): whole-subscription bulk refill fans out across owning instances ([b4746619](git+https://github.com/bett3r-dev/pv3/commits/b4746619))
+* feat(outbox): multi-stream-list selector + as-new dispatch-time bypass ([f69314e8](git+https://github.com/bett3r-dev/pv3/commits/f69314e8))
+* asFirstDelivery: bypasses the redelivery skip and stamps ([f69314e8](git+https://github.com/bett3r-dev/pv3/commits/f69314e8))
+* fix(eventsourcing): enhance snapshot consistency and aggregate state management ([479b7ed3](git+https://github.com/bett3r-dev/pv3/commits/479b7ed3))
+* fix(command-handlers): type expectedVersion as number so OCC is reachable through executeCommand (TV1-1976 follow-up) ([90bf8d68](git+https://github.com/bett3r-dev/pv3/commits/90bf8d68))
+* feat(outbox-manager): cold-seed versioned dedup watermark to eventstore tip ([3d464ad2](git+https://github.com/bett3r-dev/pv3/commits/3d464ad2))
+* pump: one reduceStream(from:0) scan accumulates per-stream max version, flushes ([3d464ad2](git+https://github.com/bett3r-dev/pv3/commits/3d464ad2))
+* Oracle: seedColdStart.test.ts (boot-silent, force-replay, warm-restart ([3d464ad2](git+https://github.com/bett3r-dev/pv3/commits/3d464ad2))
+* Ref: TV1-1980 ([3d464ad2](git+https://github.com/bett3r-dev/pv3/commits/3d464ad2))
+* feat(outbox-manager): cold-seed null-version positions to the bitmap, batched ([749570fe](git+https://github.com/bett3r-dev/pv3/commits/749570fe))
+* Ref: TV1-1980 ([749570fe](git+https://github.com/bett3r-dev/pv3/commits/749570fe))
+* fix(outbox-manager): standardize spacing in type definitions and function signatures ([0755280e](git+https://github.com/bett3r-dev/pv3/commits/0755280e))
+* Ref: TV1-1980 ([0755280e](git+https://github.com/bett3r-dev/pv3/commits/0755280e))
+* fix(ports): await async onStarted boot callbacks in start(); fail loudly on rejection ([defc9282](git+https://github.com/bett3r-dev/pv3/commits/defc9282))
+* feat(outbox-manager): opt-in structure-ack readiness gate in coordination runtime (TV1-1973 S2) ([b742e898](git+https://github.com/bett3r-dev/pv3/commits/b742e898))
+* fix(eventstore-postgres): find the versioned head of a stream that also holds version-free rows ([9ce89463](git+https://github.com/bett3r-dev/pv3/commits/9ce89463))
+* read: `SELECT v FROM (VALUES (1),(2),(NULL::int)) t(v) ORDER BY v DESC LIMIT ([9ce89463](git+https://github.com/bett3r-dev/pv3/commits/9ce89463))
+* shapes: versioned-only (no NULLs to exclude), empty (no row either way), and ([9ce89463](git+https://github.com/bett3r-dev/pv3/commits/9ce89463))
+* Oracle: __tests__/mixedVersionStream.test.ts — against a real Postgres, since ([9ce89463](git+https://github.com/bett3r-dev/pv3/commits/9ce89463))
+* feat(database): add a bulk upsert primitive to the collection API ([e0c01c6e](git+https://github.com/bett3r-dev/pv3/commits/e0c01c6e))
+* feat(eventstore): ask the eventstore for a stream's head version ([3cfb7c41](git+https://github.com/bett3r-dev/pv3/commits/3cfb7c41))
+* feat(eventsourcing): assert the version the command actually read ([4725b1b5](git+https://github.com/bett3r-dev/pv3/commits/4725b1b5))
+* feat(eventsourcing): rewind a retried command inside a caller-owned transaction ([c5aa40b7](git+https://github.com/bett3r-dev/pv3/commits/c5aa40b7))
+* feat(eventsourcing): let a command declare its concurrency mode ([cc3585d9](git+https://github.com/bett3r-dev/pv3/commits/cc3585d9))
+
+
+## [1.5.0](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.4.0...@bett3r-dev/pv3-types@1.5.0) "@bett3r-dev/pv3-types" (4/11/2026) <a name="1.5.0"></a>
+
+### Changes
+
+* fix(build): update packages versions ([79f7da77](git+https://github.com/bett3r-dev/pv3/commits/79f7da77))
+* fix(cache): implement stop method in MemoryCache and enhance MemoryDb readById functionality ([c55afccb](git+https://github.com/bett3r-dev/pv3/commits/c55afccb))
+* fix(eventsourcing): enhance event handlers and readmodel configuration ([1789cd34](git+https://github.com/bett3r-dev/pv3/commits/1789cd34))
+* fix(dependencies): Update jsonschema-definer to 1.5.6 ([6c7e2e45](git+https://github.com/bett3r-dev/pv3/commits/6c7e2e45))
+* fix(pv3-types): rename validation.ts to errors.ts ([50bf4345](git+https://github.com/bett3r-dev/pv3/commits/50bf4345))
+* fix(eventsourcing): standardize custom schema keywords and enhance schema handling ([1c8cbf84](git+https://github.com/bett3r-dev/pv3/commits/1c8cbf84))
+* fix(dependencies): update jsonschema-definer to 1.5.7 and ramda to 0.32.0 ([e5af6e98](git+https://github.com/bett3r-dev/pv3/commits/e5af6e98))
+* fix(dependencies): upgrade jsonschema-definer to 1.5.8 across multiple packages ([3e704d18](git+https://github.com/bett3r-dev/pv3/commits/3e704d18))
+* fix(errors): standardize error handling by adding error codes ([0049c0a0](git+https://github.com/bett3r-dev/pv3/commits/0049c0a0))
+* fix(errors): add error code property to AppError class ([3e50805b](git+https://github.com/bett3r-dev/pv3/commits/3e50805b))
+* feat(command-handlers): add pre-processing functionality to command execution flow ([036eeaaa](git+https://github.com/bett3r-dev/pv3/commits/036eeaaa))
+* fix(authentication): implement Better Auth adapter and enhance authorization capabilities ([02ade1d9](git+https://github.com/bett3r-dev/pv3/commits/02ade1d9))
+* fix(TV1-716): implement account partitioning in readmodel subscriptions ([e79cdfb1](git+https://github.com/bett3r-dev/pv3/commits/e79cdfb1))
+* fix(TV1-862): implement outbox manager improvements for reliability and fault tolerance ([91801daf](git+https://github.com/bett3r-dev/pv3/commits/91801daf))
+* fix(commandHandlers): reorder parameters in executeCommand function for consistency ([bec05c54](git+https://github.com/bett3r-dev/pv3/commits/bec05c54))
+* fix(pv3-admin-server): update AdminServer and UI components to work with the new outbox manager ([c5669071](git+https://github.com/bett3r-dev/pv3/commits/c5669071))
+* feat(TV1-789): implement UserSession write API for enhanced session management ([80e5d86e](git+https://github.com/bett3r-dev/pv3/commits/80e5d86e))
+* fix(endpoints): implement asynchronous documentation generation for OpenAPI ([120e4819](git+https://github.com/bett3r-dev/pv3/commits/120e4819))
+* feat(TV1-933): introduce new admin plugins for authentication and outbox management ([71ee95f3](git+https://github.com/bett3r-dev/pv3/commits/71ee95f3))
+* fix(endpoints): remove artifact types from tags and fix schema registration ([93d3fea1](git+https://github.com/bett3r-dev/pv3/commits/93d3fea1))
+* Ticket: TV1-1060 ([93d3fea1](git+https://github.com/bett3r-dev/pv3/commits/93d3fea1))
+* feat(observability): add outbox channel instrumentation for tracing event dispatch ([01430e0b](git+https://github.com/bett3r-dev/pv3/commits/01430e0b))
+* Ticket: TV1-814 ([01430e0b](git+https://github.com/bett3r-dev/pv3/commits/01430e0b))
+* feat(observability): add command execution instrumentation ([7ae35b7f](git+https://github.com/bett3r-dev/pv3/commits/7ae35b7f))
+* Ticket: TV1-814 ([7ae35b7f](git+https://github.com/bett3r-dev/pv3/commits/7ae35b7f))
+* feat(cache): add list operations and fix hashIncrementBy in memory adapter ([2c3d011c](git+https://github.com/bett3r-dev/pv3/commits/2c3d011c))
+* fix(outbox-manager): increase default maxConsumerQueueSize to 1000 ([d7777d07](git+https://github.com/bett3r-dev/pv3/commits/d7777d07))
+* feat(admin-panel): improve auth, plugin loader, and outbox UI ([c0b96eb0](git+https://github.com/bett3r-dev/pv3/commits/c0b96eb0))
+* feat(cluster-structure): add configurable default automatic data splits ([3cb5a150](git+https://github.com/bett3r-dev/pv3/commits/3cb5a150))
+* Ticket: TV1-1147 ([3cb5a150](git+https://github.com/bett3r-dev/pv3/commits/3cb5a150))
+* fix(clusterAdministration): set default value for defaultAutomaticDataSplits to 5 ([b8ca46ce](git+https://github.com/bett3r-dev/pv3/commits/b8ca46ce))
+* feat(pv3): add deployment units system with MDU computation, manifest generation, and selective loading ([f9a1c35c](git+https://github.com/bett3r-dev/pv3/commits/f9a1c35c))
+* Ticket: TV1-1061 ([f9a1c35c](git+https://github.com/bett3r-dev/pv3/commits/f9a1c35c))
+* feat(eventsourcing): add snapshot subscription change type for initial load ([2ac3bcf3](git+https://github.com/bett3r-dev/pv3/commits/2ac3bcf3))
+* Ticket: TV1-1235 ([2ac3bcf3](git+https://github.com/bett3r-dev/pv3/commits/2ac3bcf3))
+* feat(command-handlers): add payload parameter to InstrumentCommandExecution type ([21cfd1c4](git+https://github.com/bett3r-dev/pv3/commits/21cfd1c4))
+* feat(eventsourcing): add snapshot and signal subscription modes with opt-in options ([9299316e](git+https://github.com/bett3r-dev/pv3/commits/9299316e))
+* Ticket: TV1-1235 ([9299316e](git+https://github.com/bett3r-dev/pv3/commits/9299316e))
+* fix(pv3): update clean script to exclude specific adapters and enhance query parameter validation ([f877c20f](git+https://github.com/bett3r-dev/pv3/commits/f877c20f))
+* feat(outbox): add OTel instrumentation for error pipeline ([4802a2b3](git+https://github.com/bett3r-dev/pv3/commits/4802a2b3))
+* Ticket: TV1-1256 ([4802a2b3](git+https://github.com/bett3r-dev/pv3/commits/4802a2b3))
+* fix(outbox-manager): cache from NOTIFY, debounce, serialized pulls, paginated reads ([02508c98](git+https://github.com/bett3r-dev/pv3/commits/02508c98))
+* Ticket: TV1-1415 ([02508c98](git+https://github.com/bett3r-dev/pv3/commits/02508c98))
+
+
+## [1.4.0](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.3.3...@bett3r-dev/pv3-types@1.4.0) "@bett3r-dev/pv3-types" (10/9/2025) <a name="1.4.0"></a>
+
+### Changes
+
+* feat(magiclink): add generateMagicLink function for improved magic link handling ([dde2460c](git+https://github.com/bett3r-dev/pv3/commits/dde2460c))
+
+
+## [1.3.3](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.3.2...@bett3r-dev/pv3-types@1.3.3) "@bett3r-dev/pv3-types" (10/3/2025) <a name="1.3.3"></a>
+
+### Changes
+
+* fix(eventsourcing): Refactor ReadModel => Readmodel across all repo ([094e5dd9](git+https://github.com/bett3r-dev/pv3/commits/094e5dd9))
+
+
+## [1.3.2](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.3.1...@bett3r-dev/pv3-types@1.3.2) "@bett3r-dev/pv3-types" (9/23/2025) <a name="1.3.2"></a>
+
+### Changes
+
+* fix(eventstore): enhance concurrency error handling and improve commit event logging ([3a9a7462](git+https://github.com/bett3r-dev/pv3/commits/3a9a7462))
+* fix(package): update build scripts and improve type usage in cluster structure ([f7e8d7ec](git+https://github.com/bett3r-dev/pv3/commits/f7e8d7ec))
+* fix(eventHandlers): enhance event schema handling with friendlyName support for Events ([84c6cb74](git+https://github.com/bett3r-dev/pv3/commits/84c6cb74))
+
+
+## [1.3.1](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.3.0...@bett3r-dev/pv3-types@1.3.1) "@bett3r-dev/pv3-types" (7/7/2025) <a name="1.3.1"></a>
+
+### Changes
+
+* fix(outbox-manager): added an event emitter to notify when error streams are created and fixed ([374c2c8e](git+https://github.com/bett3r-dev/pv3/commits/374c2c8e))
+
+
+## [1.3.0](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.2.0...@bett3r-dev/pv3-types@1.3.0) "@bett3r-dev/pv3-types" (7/4/2025) <a name="1.3.0"></a>
+
+### Changes
+
+* feat(cache): add hashLength, setBit, and getBit methods to Memory and Redis cache adapters ([abd06ddd](git+https://github.com/bett3r-dev/pv3/commits/abd06ddd))
+
+
+## [1.2.0](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.1.0...@bett3r-dev/pv3-types@1.2.0) "@bett3r-dev/pv3-types" (7/2/2025) <a name="1.2.0"></a>
+
+### Changes
+
+* feat(eventHandlers): add optional byDistinctField property to ReadmodelDefaultQuerySchema for enhanced query flexibility ([11ca6f3a](git+https://github.com/bett3r-dev/pv3/commits/11ca6f3a))
+* feat(outbox-manager): add optional subscriptionId parameter to getSubscriptionStatus route and implement getAllSubscriptionsStatus function for retrieving all subscriptions' statuses ([14a627af](git+https://github.com/bett3r-dev/pv3/commits/14a627af))
+
+
+## [1.1.0](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.0.6...@bett3r-dev/pv3-types@1.1.0) "@bett3r-dev/pv3-types" (6/26/2025) <a name="1.1.0"></a>
+
+### Changes
+
+* feat(database): enhance count and query functionality with distinct field support ([5a8c8d2a](git+https://github.com/bett3r-dev/pv3/commits/5a8c8d2a))
+
+
+## [1.0.6](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.0.5...@bett3r-dev/pv3-types@1.0.6) "@bett3r-dev/pv3-types" (6/24/2025) <a name="1.0.6"></a>
+
+### Changes
+
+* fix(eventsourcing): implement rison encoding for filters, sorts and selects ([138fa75d](git+https://github.com/bett3r-dev/pv3/commits/138fa75d))
+
+
+## [1.0.5](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.0.4...@bett3r-dev/pv3-types@1.0.5) "@bett3r-dev/pv3-types" (6/20/2025) <a name="1.0.5"></a>
+
+### Changes
+
+* fix: client library types improvement ([46190f29](git+https://github.com/bett3r-dev/pv3/commits/46190f29))
+* fix(outbox): standardize subscription state to be compatible with postgres ([06ccef68](git+https://github.com/bett3r-dev/pv3/commits/06ccef68))
+* fix(validation): correct error class name in UnauthorizedError constructor ([093e1e80](git+https://github.com/bett3r-dev/pv3/commits/093e1e80))
+* fix(database): enhance getCollection and translateSQL to support sequenceIdProperty ([fe35ba1f](git+https://github.com/bett3r-dev/pv3/commits/fe35ba1f))
+
+
+## [1.0.4](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.0.3...@bett3r-dev/pv3-types@1.0.4) "@bett3r-dev/pv3-types" (6/14/2025) <a name="1.0.4"></a>
+
+### Changes
+
+* fix: enhance QueryHandler and Query types to support RETURN_TYPE for improved type safety ([753dabd8](git+https://github.com/bett3r-dev/pv3/commits/753dabd8))
+
+
+## [1.0.3](git+https://github.com/bett3r-dev/pv3/compare/@bett3r-dev/pv3-types@1.0.2...@bett3r-dev/pv3-types@1.0.3) "@bett3r-dev/pv3-types" (6/14/2025) <a name="1.0.3"></a>
+
+### Changes
+
+* fix: update @bett3r-dev/jsonschema-definer dependency to version 1.5.0 across multiple packages ([a5f23884](git+https://github.com/bett3r-dev/pv3/commits/a5f23884))
+
+
+## 1.0.0
+
+### Major Changes
+
+- First Official Release of PV3

package/build/adminPlugin.d.ts

@@ -0,0 +1,24 @@
+export type AdminPluginTab = {
+    name: string;
+    route: string;
+};
+export type AdminPluginManifest = {
+    name: string;
+    route: string;
+    entry: string;
+    section?: string;
+    icon?: string;
+    tabs?: AdminPluginTab[];
+    permissions?: string[];
+};
+export type AdminUserContext = {
+    id: string;
+    displayName: string;
+};
+export type AdminPluginProps = {
+    backendUrl: string;
+    user?: AdminUserContext;
+    navigate: (path: string) => void;
+    basePath: string;
+};
+//# sourceMappingURL=adminPlugin.d.ts.map

package/build/adminPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adminPlugin.d.ts","sourceRoot":"","sources":["../src/adminPlugin.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,CAAE,IAAI,EAAE,MAAM,KAAM,IAAI,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/build/{eventsourcing/utils.js → adminPlugin.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=adminPlugin.js.map

package/build/adminPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adminPlugin.js","sourceRoot":"","sources":["../src/adminPlugin.ts"],"names":[],"mappings":""}

package/build/aggregateSchema.d.ts

@@ -0,0 +1,94 @@
+import { BaseSchema, ObjectSchema } from '@bett3r-dev/jsonschema-definer';
+import { AggregateSpec, Document } from './database';
+/**
+ * The filter schema embedded under `aggregate.filter`, carrying its OWN `$id` — see
+ * `collectionFilterSchemaWithId`. Identical rules to `CollectionFilterSchema`, different identity,
+ * because both are materialised in the SAME readmodel query document.
+ */
+export declare const AggregateFilterSchema: BaseSchema<Partial<import("./database").CollectionFilterOR<any> & import("./database").CollectionFilterAND<any> & import("./database").CollectionFilterInstance<any>>, true, Readonly<import("@bett3r-dev/jsonschema-definer/dist/base").BaseJsonSchema>>;
+/**
+ * Derives the RESPONSE SCHEMA of an aggregate row from the model's schema plus the spec.
+ *
+ * This is one of the three co-derivations of a single spec value (the other two being the
+ * `AggregateRow` TS type and the adapter's SQL). It is deliberately a PURE function of
+ * `(modelSchema, spec)` — no ports, no I/O, no dependency on endpoint registration — because
+ * the authoring-time consumer (teselly's rule validator) calls it on a spec pv3 never saw at
+ * build time. Building it as an internal of endpoint registration is the one decision here
+ * that would be expensive to undo.
+ *
+ * The rules:
+ *  - a `groupBy` key copies the model's property schema, facets (enum, format) included, made
+ *    NULLABLE: a row lacking the key groups under SQL NULL, and the adapter projects that group's
+ *    key as JS `null` (invariant I1 — the schema must accept what the SQL can legitimately hand
+ *    back);
+ *  - every OTHER `groupBy` facet survives onto the row rather than being flattened to a loose
+ *    primitive;
+ *  - a `count`/`sum` alias is always `number` — neither can be empty (a group exists because a
+ *    row exists, and the empty sum is COALESCEd to its identity element, 0);
+ *  - an `avg` alias is `number | null`, and a `min`/`max` alias copies the SOURCE field's
+ *    property schema verbatim — facets included (invariant I4) — made NULLABLE. This is the
+ *    half a TS type cannot carry: `AggregateTermType` can say `string`, only the schema can
+ *    say `format: 'date-time'`, and a consumer generating a client from it would otherwise be
+ *    handed a looser contract than the readmodel's own. The nullability mirrors
+ *    `AggregateTermType` exactly: these three functions have no identity element, so a group
+ *    whose every row lacks the field yields null rather than an invented value. `.nullable()`
+ *    is the library's own mechanism and preserves the other facets (it widens `type` and, for
+ *    an enum, appends null to the enum) instead of flattening the schema;
+ *  - every other model property DISAPPEARS — an aggregate row is a new type, not a partial
+ *    model.
+ */
+export declare const deriveAggregateSchema: <Model extends Document>(modelSchema: ObjectSchema<any, any>, spec: AggregateSpec<Model>) => ObjectSchema<any, any>;
+/**
+ * Charset-checks every value in the spec that reaches SQL by interpolation.
+ *
+ * Called from `validateSpec` (i.e. from INSIDE `deriveAggregateSchema`), so every caller that
+ * DERIVES — the endpoint, teselly's authoring-time validator — inherits it. It is deliberately
+ * NOT only there: `aggregate()` does NOT derive, so the Postgres adapter runs this check itself
+ * (`assertAggregateBoundsAreValid`, postgres.utils.ts) immediately before interpolating. The
+ * derivation is a chokepoint for the HTTP path, not for the port. Exported as well, so the
+ * boundary can run it FIRST and
+ * report "not a safe identifier" instead of the less useful "not a property of the model" that a
+ * membership check would report for the same hostile value.
+ */
+export declare const assertSafeAggregateIdentifiers: <Model extends Document>(spec: AggregateSpec<Model>) => void;
+/**
+ * INVARIANT I5 — the spec must be STATIC.
+ *
+ * This is the condition the whole design rests on, not a hygiene check. `AggregateRow`, the
+ * derived JSON Schema and the SQL are all computed FROM the spec; if a `groupBy` key or an
+ * aggregate `field` can arrive from a runtime value (an upstream edge in a rule graph, a
+ * template placeholder resolved later) then the row shape is not derivable at authoring time and
+ * the entire scheme degrades to `any` — silently, because a spec with a placeholder in it is a
+ * perfectly well-formed object.
+ *
+ * So the two runtime-reference shapes are refused explicitly:
+ *   - a NON-STRING where an identifier belongs (`{ from: 'input.field' }`, the shape a rules-engine
+ *     edge would produce);
+ *   - a string carrying template syntax (`{{...}}`, `${...}`), which would otherwise sail through
+ *     the charset guard's error path with a confusing message.
+ * Run BEFORE the charset guard so the failure names the right problem.
+ */
+export declare const assertStaticAggregateSpec: (spec: unknown) => void;
+/**
+ * The WIRE schema of an aggregate spec — what a caller may put in the query string.
+ *
+ * It validates the spec's SHAPE only (the function vocabulary, the bound types, the filter
+ * clauses). The SEMANTIC rules — field exists on the model, `sum` over a numeric field, alias
+ * collisions — deliberately stay in `deriveAggregateSchema`, which is the single place every
+ * caller passes through. Duplicating them here would create two rule sets that can drift.
+ *
+ * `filter` reuses the same filter DEFINITION (under its own `$id`) so a filter means exactly the same thing on
+ * `aggregate` as it does on `query`.
+ */
+export declare const AggregateSpecSchema: ObjectSchema<{
+    groupBy: string[];
+    aggregates: {
+        fn: "avg" | "count" | "max" | "min" | "sum";
+        field?: string | undefined;
+        as: string;
+    }[];
+    filter?: Partial<import("./database").CollectionFilterOR<any> & import("./database").CollectionFilterAND<any> & import("./database").CollectionFilterInstance<any>>[] | undefined;
+    maxGroups?: number | undefined;
+    maxGroupSize?: number | undefined;
+}, true>;
+//# sourceMappingURL=aggregateSchema.d.ts.map

package/build/aggregateSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregateSchema.d.ts","sourceRoot":"","sources":["../src/aggregateSchema.ts"],"names":[],"mappings":"AAAA,OAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAgC,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEnF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,2PAA8D,CAAC;AAkFjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,SAAS,QAAQ,eAC7C,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,QAC7B,aAAa,CAAC,KAAK,CAAC,KACzB,YAAY,CAAC,GAAG,EAAE,GAAG,CA2BvB,CAAC;AAmCF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,8BAA8B,GAAI,KAAK,SAAS,QAAQ,QAAS,aAAa,CAAC,KAAK,CAAC,SAMjG,CAAC;AAIF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB,SAAW,OAAO,KAAI,IA0B3D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;QAmB9B,CAAC"}