@furystack/inject/CHANGELOG.md

Dependency Injection framework for FuryStack

# Changelog

## [13.0.2] - 2026-06-05

### 👷 CI

- Raised the minimum supported Node.js to `>=24.0.0` (Node 24 LTS) in `engines`, dropping Node 22.

### ⬆️ Dependencies

- Bumped dev `vitest` to `^4.1.8`. No source changes — dev-tooling bump only.

## [13.0.1] - 2026-05-21

### 📚 Documentation

- Rewrote JSDoc on the public type surface (`Token`, `SyncToken`, `AsyncToken`, `AnyToken`, `ServiceContext`, `DefineServiceOptions`) and the `defineService` / `defineServiceAsync` / `Injector` exports to follow the new value-test guidance: dropped restate-the-type narration, kept intent / trade-offs / constraints (token identity, async resolution rules, factory caching, dispose callbacks), and cross-linked the sync/async variants instead of re-explaining lifetime semantics.

### ⬆️ Dependencies

- Bump dev `vitest` to `^4.1.5`.
- Bumped `vitest` to `^4.1.7`. No source changes — dev-tooling bump only.

## [13.0.0] - 2026-04-25

### 💥 Breaking Changes

Decorator-based DI is gone. Services are now declared with `defineService` / `defineServiceAsync`, which return opaque tokens; the `Injector` resolves tokens. See the [v7 migration guide](../../docs/migrations/v7-functional-di.md) for rationale, recipes, and pitfalls.

- Removed `@Injectable`, `@Injected`. Use `defineService({ name, lifetime, factory })` instead.
- Removed `injector.getInstance(Class)`. Use `injector.get(Token)`; async tokens must use `injector.getAsync(Token)`.
- Removed `injector.setExplicitInstance(instance, Class)`. Use `injector.bind(Token, () => instance)` — any cached instance is dropped.
- Renamed `injector.createChild(opts)` → `injector.createScope(opts)`.
- Removed `injector.cachedSingletons`. If you probed for opt-in registration, declare a nullable scoped token (`Token<T | null, 'scoped'>`, default `null`) and have the parent bind it.
- `Constructable` moved to `@furystack/core`. Packages that imported it from `@furystack/inject` must switch the import and add `@furystack/core` as a dependency.
- `hasInjectorReference` is gone — use an `instanceof Injector` check on the candidate prop instead.
- Added `createInjector()` as the preferred root-injector factory, `withScope(parent, fn)` for scope-create-and-dispose patterns, `isToken(value)` for runtime token detection, and `Injector.isResolved(token)` for bootstrap helpers that need to fail loudly when a service was already resolved before they ran.

### Quick reference

Before:

```ts
@Injectable({ lifetime: 'singleton' })
class Logger {
  @Injected(Config) private config!: Config
  log(msg: string) {
    console.log(`[${this.config.level}] ${msg}`)
  }
}
const logger = injector.getInstance(Logger)
```

After:

```ts
export const LoggerToken = defineService({
  name: 'app/Logger',
  lifetime: 'singleton',
  factory: ({ inject }) => {
    const config = inject(Config)
    return { log: (msg: string) => console.log(`[${config.level}] ${msg}`) }
  },
})
const logger = injector.get(LoggerToken)
```

## [12.0.36] - 2026-04-17

### ⬆️ Dependencies

- Raised `typescript` to ^6.0.3 and `vitest` to ^4.1.4 so package builds and tests track the workspace toolchain.

## [12.0.35] - 2026-03-27

### ⬆️ Dependencies

- Updated `vitest` to ^4.1.2

## [12.0.34] - 2026-03-25

### 📦 Build

- Removed deprecated `baseUrl` from tsconfig.json for TypeScript 6 compatibility

### ⬆️ Dependencies

- Upgraded `typescript` from ^5.9.3 to ^6.0.2
- Upgraded `vitest` from ^4.1.0 to ^4.1.1

## [12.0.33] - 2026-03-19

### ⬆️ Dependencies

- Upgraded `vite` from ^7.3.1 to ^8.0.0 for improved build performance and new features
- Upgraded `vitest` from ^4.0.18 to ^4.1.0
- Upgraded `@vitest/coverage-istanbul` from ^4.0.18 to ^4.1.0

## [12.0.32] - 2026-03-06

### ⬆️ Dependencies

- Updated internal FuryStack dependencies

## [12.0.31] - 2026-03-03

### ⬆️ Dependencies

- Updated `@furystack/utils` with EventHub listener error handling

## [12.0.30] - 2026-02-11

### ⬆️ Dependencies

- Bump `vitest` from `^4.0.17` to `^4.0.18`
- Updated internal dependencies

## [12.0.29] - 2026-02-09

### 🧪 Tests

- Refactored `Injected` and `Injector` tests to use `usingAsync` for proper `Injector` disposal

## [12.0.28] - 2026-01-26

### 🔧 Chores

- Standardized author format, improved keywords, removed obsolete `gitHead`, added `engines` (Node 22+) and `sideEffects: false`

## [12.0.27] - 2026-01-26

### 🐛 Bug Fixes

### Fixed singleton injector reference being overwritten by child injectors

The `getInstance()` method was unconditionally overwriting the injector reference on returned instances, even for singletons retrieved from a parent injector. This caused singletons to incorrectly reference the child injector that last retrieved them instead of the parent injector that created/owns them.

**Before:** When a child injector retrieved a singleton from a parent, the singleton's `injector` property was overwritten to point to the child.

**After:** The injector reference is now set at instance creation time and preserved when retrieved from parent injectors.

### 🧪 Tests

- Added regression tests to verify singleton injector references are preserved when retrieved from child injectors

## [12.0.26] - 2026-01-22

### ⬆️ Dependencies

- Dependency updates

### 📚 Documentation

- Improved README with clearer examples and better structure

### 🔧 Chores

- Migrated to centralized changelog management system