@glandjs/core@2.0.0 · @glandjs/common@2.0.0
Changelog — @glandjs/core & common
Release history for @glandjs/core & common, mirrored from the repository.
Release notes for the Gland packages in this repository. Each package also has
its own CHANGELOG.md:
| Package | Version | Changelog |
|---|---|---|
@glandjs/core |
2.0.0 |
core |
@glandjs/common |
2.0.0 |
common |
The two packages are versioned in lockstep. Every metadata key the core reads is
written by a decorator in common, so a version skew between them is not a
supported configuration — and @glandjs/core declares
@glandjs/common as a peerDependency rather than a dependency, so nothing
enforces the pairing at install time.
Version history at a glance
Section titled “Version history at a glance”| Version | @glandjs/core |
@glandjs/common |
Published |
|---|---|---|---|
2.0.0 |
✅ 2.0.0 |
✅ 2.0.0 |
2026-10-03 |
1.0.3-beta |
✅ 1.0.3-beta |
✅ 1.0.3-beta |
2025-05-17 |
1.0.2-beta |
✅ 1.0.2-beta |
✅ 1.0.2-beta |
2025-05-17 |
1.0.1-beta |
✅ 1.0.1-beta |
✅ 1.0.1-beta |
2025-05-16 |
1.0.0-beta |
✅ 1.0.0-beta |
✅ 1.0.0-beta |
2025-05-16 |
1.0.1-alpha |
✅ 1.0.1-alpha |
✅ 1.0.1-alpha |
2025-04-11 |
1.0.0-alpha |
✅ 1.0.0-alpha |
✅ 1.0.0-alpha |
2025-04-10 |
1.0.0-alpha.1 |
✅ | ✅ | 2025-03-27 |
1.0.0-alpha.0 |
✅ | ✅ | 2025-03-27 |
2.0.0 is the first stable release of either package. Everything before it
carried a pre-release identifier.
2.0.0 — @glandjs/core and @glandjs/common
Section titled “2.0.0 — @glandjs/core and @glandjs/common”The beta hardened the core. The headline change is that emitDecoratorMetadata
is now a stated requirement rather than an accident, because without it the
container could not know what to inject.
Both packages take a major bump, not a minor one. @glandjs/core because
Module was renamed and create() changed its return type.
@glandjs/common because CryptoUUID and the UUID type were removed from its
public API and GlandRoute — the payload every adapter consumes — changed
shape.
Migration
-
Add
@Injectable()to any class the container constructs that has constructor parameters and no other Gland decorator. TypeScript only emitsdesign:paramtypesfor decorated classes.// before — received undefined for every dependencyexport class UserService {constructor(private users: UserRepository) {}}// after@Injectable()export class UserService {constructor(private users: UserRepository) {}}If a parameter’s type is an interface, a primitive, a string or a symbol, it erases to
Objectat runtime and@Injectable()is not enough — annotate the parameter with@Inject(token). -
GlandFactory.create()now returns{ app, shutdown }:// beforeconst app = await GlandFactory.create(AppModule);// afterconst { app, shutdown } = await GlandFactory.create(AppModule);create()also now awaits initialization, soappis fully wired by the time the promise resolves. -
Modulethe injector class is nowModuleRef, imported from@glandjs/core. The name@Module()stays with the decorator in@glandjs/common. -
An unknown channel event now throws
UnknownEventError, listing the events that exist. If you relied onctx.call()returningundefinedfor a misspelled name, catch it or check the name. -
Adapters must be updated for the new
GlandRoutepayload.metais gone; register routes frommethodandfullPath:// beforethis.broker.on('gland:define:route', ({ meta, action }) => this.app[meta.method.toLowerCase()](meta.path, action));// afterthis.broker.on('gland:define:route', ({ method, fullPath, action }) => this.app[method.toLowerCase()](fullPath, action));meta.methodheld the handler name, not the HTTP verb — so this fixes adapters that were registering routes under a function name. -
CryptoUUIDis gone. UserandomUUID()fromnode:crypto. -
loadPackage()throwsMissingDependencyErrorinstead of callingprocess.exit(1). Wrap the call if the dependency is optional. -
engines.nodeis now>=22in both packages, matching the repository root,.nvmrcand CI. The beta claimed>=20, which no test run ever exercised.
See the package changelogs for the full list, and dependency injection for the reasoning behind each change.
1.0.3-beta
Section titled “1.0.3-beta”reflect-metadatapeer dependency narrowed to^0.2.2in both packages.
1.0.2-beta
Section titled “1.0.2-beta”- Build script fix:
cleanno longer left nested build output behind, andpackages/core/tsconfig.jsondropped an emptyfiles: []that suppressed itsincludeglob.
1.0.1-beta
Section titled “1.0.1-beta”- Version bump only — no source changes.
1.0.0-beta
Section titled “1.0.0-beta”- Initial public beta of the two-package core.