import { defineProperty, Dict, isNullable } from 'cosmokit' import { Context } from './context.ts' import { getTraceable, symbols, withProps } from './utils.ts' import { Fiber, FiberState } from './fiber.ts' declare module './context.ts' { interface Context { get(name: K, strict?: boolean): undefined | this[K] get(name: string, strict?: boolean): any set(name: K, value: undefined | this[K]): void set(name: string, value: any): void provide(name: K, value: undefined | this[K]): () => void provide(name: string, value?: any): () => void accessor(name: string, options: Omit): void mixin(name: K, mixins: (keyof this & keyof this[K])[] | Dict): void mixin(source: T, mixins: (keyof this & keyof T)[] | Dict): void } } function enhanceError(error: Error) { const lines = error.stack!.split('\n') lines.splice(0, 2, `Error: ${error.message}`) error.stack = lines.join('\n') return error } const RESERVED_WORDS = ['prototype', 'then'] // - is a symbol // - is a reserved word (prototype, then) // - is a number string (0, 1, 2, ...) // - starts with `_` function isSpecialProperty(prop: string | symbol): prop is symbol { return typeof prop === 'symbol' || RESERVED_WORDS.includes(prop) || parseInt(prop).toString() === prop || prop.startsWith('_') } /** Context property definition known by the reflection service. */ export type Property = Property.Service | Property.Accessor /** Property definition variants understood by `ReflectService`. */ export namespace Property { /** Service property backed by a provided implementation. */ export interface Service { type: 'service' } /** Computed context property backed by custom get/set hooks. */ export interface Accessor { type: 'accessor' get: (this: Context, receiver: any, error: Error) => any set?: (this: Context, value: any, receiver: any, error: Error) => boolean } } /** Concrete service implementation record stored in the root reflect service. */ export interface Impl { name: string fiber: Fiber value?: any check?: () => boolean } /** * Reflection and service-resolution layer installed as `ctx.reflect`. * * This service powers the context proxy, service registration, accessors, and * the mixins that expose core service methods directly on `ctx`. */ export class ReflectService { static handler: ProxyHandler = { get: (target, prop, ctx: Context) => { if (isSpecialProperty(prop)) { return Reflect.get(target, prop, ctx) } if (Reflect.has(target, prop)) { return getTraceable(ctx, Reflect.get(target, prop, ctx)) } const error = new Error(`cannot get property "${prop}" without inject`) try { const def = target.reflect.props[prop] if (def?.type === 'accessor') { return def.get.call(ctx, ctx[symbols.receiver], error) } if (!ctx.fiber.runtime) return ctx.reflect.get(prop, false) return ctx.events.waterfall('internal/get', ctx, prop, error, () => { const key = target[symbols.isolate][prop] let fiber = (ctx[symbols.shadow] as Context ?? ctx).fiber while (true) { const impl = fiber.store?.[prop] if (impl) return getTraceable(ctx, impl.value) if (prop in fiber.inject) { error.message = `cannot get required service "${prop}" in inactive context` throw error } if (!fiber.runtime) throw error if (fiber.parent[symbols.isolate][prop] !== key) throw error fiber = fiber.parent.fiber } }) } catch (e: any) { throw e === error ? enhanceError(e) : e } }, set: (target, prop, value, ctx: Context) => { if (isSpecialProperty(prop)) { return Reflect.set(target, prop, value, ctx) } const error = new Error(`cannot set property "${prop}" without provide`) const def = target.reflect.props[prop] if (!def) { if (!ctx.fiber.runtime) return Reflect.set(target, prop, value, ctx) throw enhanceError(error) } try { if (def.type === 'accessor') { if (!def.set) return false return def.set.call(ctx, value, ctx[symbols.receiver], error) } return ctx.events.waterfall('internal/set', ctx, prop, value, error, () => { return ctx.reflect.set(prop, value, error) }) } catch (e: any) { throw e === error ? enhanceError(e) : e } }, has: (target, prop) => { if (isSpecialProperty(prop)) { return Reflect.has(target, prop) } if (Reflect.has(target, prop)) return true return !!target.reflect.props[prop] }, } public store: Dict = Object.create(null) public props: Dict = Object.create(null) constructor(public ctx: Context) { defineProperty(this, symbols.tracker, { property: 'ctx', noShadow: true, }) this.mixin('reflect', ['get', 'set', 'provide', 'accessor', 'mixin']) this.mixin('fiber', ['runtime', 'effect']) this.mixin('registry', ['inject', 'plugin']) this.mixin('events', ['on', 'once', 'parallel', 'emit', 'serial', 'bail', 'waterfall']) } get(name: string, strict = true) { return getTraceable(this.ctx, this._getImpl(name, strict)?.value) } _getImpl(name: string, strict = true) { const key = this.ctx[symbols.isolate][name] const impl = key && this.store[key] if (!impl) return if (strict && impl.fiber.state !== FiberState.ACTIVE) return return impl } set(name: string, value: any, error?: Error) { const key = this.ctx[symbols.isolate][name] const impl = this.store[key] if (!impl) { throw new Error(`cannot set property "${name}" without provide`) } if (impl.fiber !== this.ctx.fiber) { throw new Error(`cannot set property "${name}" in multiple fibers`) } impl.value = value return true } provide(name: string, value?: any, check?: () => boolean) { return this.ctx.fiber.effect(() => { if (!this.props[name]) { this.props[name] ??= { type: 'service' } } else if (this.props[name].type !== 'service') { throw new Error(`property "${name}" is already declared as ${this.props[name].type}`) } this.props[name] = { type: 'service' } this.ctx.root[symbols.isolate][name] ??= Symbol(name) const key = this.ctx[symbols.isolate][name] const impl: Impl = { name, value, fiber: this.ctx.fiber, check } if (this.store[key]) { throw new Error(`service "${name}" has been registered at <${this.store[key].fiber.name}>`) } this.store[key] = impl this.ctx.fiber.store![name] = impl if (this.ctx.fiber.state === FiberState.ACTIVE) { this.notify([name]) } return async () => { delete this.store[key] const fibers = this.notify([name]) await Promise.allSettled(fibers.map(fiber => fiber.await())) // ensure self access before dependencies cleanup delete this.ctx.fiber.store![name] } }, `ctx.provide(${JSON.stringify(name)})`) } notify(names: string[], filter = (ctx: Context, name: string) => ctx[symbols.isolate][name] === this.ctx[symbols.isolate][name]) { const fibers: Fiber[] = [] for (const runtime of this.ctx.registry.values()) { for (const fiber of runtime.fibers) { let hasUpdate = false for (const name of names) { if (!(name in fiber.inject)) continue if (!filter(fiber.ctx, name)) continue hasUpdate = true fiber._checkImpl(name) } if (!hasUpdate) continue fiber._refresh() fibers.push(fiber) } } return fibers } accessor(name: string, options: Omit) { return this.ctx.fiber.effect(() => { if (name in this.props) { throw new Error(`property "${name}" is already declared as ${this.props[name].type}`) } this.props[name] = { type: 'accessor', ...options } return () => delete this.props[name] }, `ctx.accessor(${JSON.stringify(name)})`) } mixin(source: any, mixins: string[] | Dict) { const self = this return this.ctx.fiber.effect(function* () { const entries = Array.isArray(mixins) ? mixins.map(key => [key, key]) : Object.entries(mixins) const getTarget = (ctx: Context, error: Error) => { // TODO enhance error message return ctx[source] } for (const [key, value] of entries) { yield self.accessor(value, { get(receiver, error) { const service = getTarget(this, error) if (isNullable(service)) return service const mixin = receiver ? withProps(receiver, service) : service const value = Reflect.get(service, key, mixin) if (typeof value !== 'function') return value return value.bind(mixin ?? service) }, set(value, receiver, error) { const service = getTarget(this, error) const mixin = receiver ? withProps(receiver, service) : service return Reflect.set(service, key, value, mixin) }, }) } }, `ctx.mixin(${JSON.stringify(source)})`) } trace(value: T) { return getTraceable(this.ctx, value) } bind(callback: T) { return new Proxy(callback, { apply: (target, thisArg, args) => { return Reflect.apply(target, this.trace(thisArg), args.map(arg => this.trace(arg))) }, construct: (target, args, newTarget) => { return Reflect.construct(target, args.map(arg => this.trace(arg)), newTarget) }, }) } }