@ddd-ts-kit/aspects 0.0.0-stage → 0.1.0

package/dist/timeout/timeout.js

@@ -0,0 +1,42 @@
+import { defineAspect } from '../aspect/define-aspect.js';
+import { TimeoutError } from '../errors/timeout-error.js';
+import { schedulerOr } from '../runtime/scheduler-or.js';
+/**
+ * Rejects with a `TimeoutError` when the call has not answered in time. Without `signal` the
+ * underlying call keeps running and its late outcome is dropped.
+ */
+export function timeout(timeoutMs, options = {}) {
+    return defineAspect(timeoutAdvice(timeoutMs, options));
+}
+export function timeoutAdvice(timeoutMs, options = {}) {
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new RangeError('timeout: the duration is a positive number of milliseconds');
+    }
+    return (joinPoint) => (invocation) => new Promise((resolve, reject) => {
+        const controller = new AbortController();
+        const cancel = schedulerOr(options.scheduler).schedule(() => {
+            const error = new TimeoutError(`${joinPoint.className}.${joinPoint.method}`, timeoutMs);
+            controller.abort(error);
+            reject(error);
+        }, timeoutMs);
+        const args = options.signal === true ? withSignal(invocation, joinPoint, controller.signal) : invocation.args;
+        invocation.proceed(args).then(resolve, reject).finally(cancel).catch(ignored);
+    });
+}
+function withSignal(invocation, joinPoint, signal) {
+    const position = joinPoint.arity - 1;
+    const given = invocation.args[position];
+    if (position < 0 || !(given === undefined || given instanceof AbortSignal)) {
+        return invocation.args;
+    }
+    const args = [...invocation.args];
+    while (args.length < position) {
+        args.push(undefined);
+    }
+    args[position] = given === undefined ? signal : AbortSignal.any([given, signal]);
+    return args;
+}
+function ignored() {
+    return undefined;
+}
+//# sourceMappingURL=timeout.js.map

package/dist/timeout/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/timeout/timeout.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAezD;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,SAAiB,EAAE,OAAO,GAAmB,EAAE;IACrE,OAAO,YAAY,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,OAAO,GAAmB,EAAE;IAC3E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,UAAU,CAAC,4DAA4D,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,EAAE,CACnC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QAEzC,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE;YAC1D,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,GAAG,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC;YAExF,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAE9G,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,UAAU,CAAC,UAAsB,EAAE,SAAoB,EAAE,MAAmB;IACnF,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAExC,IAAI,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,YAAY,WAAW,CAAC,EAAE,CAAC;QAC3E,OAAO,UAAU,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAElC,OAAO,IAAI,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAEjF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,OAAO;IACd,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/weaving/advise-method.d.ts

@@ -0,0 +1,7 @@
+import type { AdviceFactory } from '../aspect/advice-factory.js';
+/**
+ * Puts the advice around one method that is known to answer a promise, from its first call:
+ * what a method decorator asks for.
+ */
+export declare function adviseMethod(instance: object, name: string, advise: AdviceFactory): void;
+//# sourceMappingURL=advise-method.d.ts.map

package/dist/weaving/advise-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advise-method.d.ts","sourceRoot":"","sources":["../../src/weaving/advise-method.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAMjE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAYxF"}

package/dist/weaving/advise-method.js

@@ -0,0 +1,19 @@
+import { advised } from './advised.js';
+import { isWrappable } from './is-wrappable.js';
+import { shadowed } from './shadowed.js';
+import { siteOf } from './site-of.js';
+/**
+ * Puts the advice around one method that is known to answer a promise, from its first call:
+ * what a method decorator asks for.
+ */
+export function adviseMethod(instance, name, advise) {
+    const method = Reflect.get(instance, name);
+    if (!isWrappable(method)) {
+        return;
+    }
+    const wrapper = advised(method, { ...siteOf(instance, {}), method: name, arity: method.length }, advise);
+    if (wrapper !== undefined) {
+        shadowed(instance, new Map([[name, wrapper]]));
+    }
+}
+//# sourceMappingURL=advise-method.js.map

package/dist/weaving/advise-method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advise-method.js","sourceRoot":"","sources":["../../src/weaving/advise-method.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,IAAY,EAAE,MAAqB;IAChF,MAAM,MAAM,GAAY,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAEpD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IAEzG,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/weaving/advise-methods.d.ts

@@ -0,0 +1,13 @@
+import type { AdviceFactory } from '../aspect/advice-factory.js';
+import type { AspectInfo } from '../aspect/aspect-info.js';
+/**
+ * Puts the advice around the calls that reach the instance from outside, on every asynchronous
+ * method. Public cannot be told from `private` once compiled, so every method is wrapped; what
+ * tells the calls apart is where they come from: a call the instance makes on itself while one
+ * of its advised calls is running is not advised again. A method declared `async` is advised
+ * from its first call; a method that merely returns a promise is advised from its second call
+ * (the first one teaches that it is asynchronous). Synchronous methods, getters, symbols,
+ * generators and lifecycle hooks are left alone.
+ */
+export declare function adviseMethods<T extends object>(instance: T, info: AspectInfo, advise: AdviceFactory): T;
+//# sourceMappingURL=advise-methods.d.ts.map

package/dist/weaving/advise-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advise-methods.d.ts","sourceRoot":"","sources":["../../src/weaving/advise-methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAc3D;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,GAAG,CAAC,CAkBvG"}

package/dist/weaving/advise-methods.js

@@ -0,0 +1,119 @@
+import { advised } from './advised.js';
+import { fromOutside } from './from-outside.js';
+import { isWrappable } from './is-wrappable.js';
+import { knownAsync } from './known-async.js';
+import { LIFECYCLE_HOOKS } from './lifecycle-hooks.js';
+import { named } from './named.js';
+import { shadowed } from './shadowed.js';
+import { siteOf } from './site-of.js';
+// A function standing in for another is asynchronous when the other is.
+const standsFor = new WeakMap();
+/**
+ * Puts the advice around the calls that reach the instance from outside, on every asynchronous
+ * method. Public cannot be told from `private` once compiled, so every method is wrapped; what
+ * tells the calls apart is where they come from: a call the instance makes on itself while one
+ * of its advised calls is running is not advised again. A method declared `async` is advised
+ * from its first call; a method that merely returns a promise is advised from its second call
+ * (the first one teaches that it is asynchronous). Synchronous methods, getters, symbols,
+ * generators and lifecycle hooks are left alone.
+ */
+export function adviseMethods(instance, info, advise) {
+    const wrappers = new Map();
+    const site = siteOf(instance, info);
+    const application = {};
+    for (const [name, method] of wrappableMethods(instance)) {
+        const wrapper = advised(method, { ...site, method: name, arity: method.length }, advise);
+        if (wrapper !== undefined) {
+            wrappers.set(name, learning(method, fromOutside(method, wrapper, application)));
+        }
+    }
+    if (wrappers.size === 0) {
+        return instance;
+    }
+    return Object.isExtensible(instance) ? shadowed(instance, wrappers) : proxied(instance, wrappers);
+}
+/** Own and inherited methods as they are reached now, without invoking any getter. */
+function wrappableMethods(instance) {
+    const methods = new Map();
+    const seen = new Set(['constructor', ...LIFECYCLE_HOOKS]);
+    for (const owner of prototypeChain(instance)) {
+        for (const name of Object.getOwnPropertyNames(owner)) {
+            if (seen.has(name)) {
+                continue;
+            }
+            seen.add(name);
+            if (!holdsShadowableMethod(owner, name, instance)) {
+                continue;
+            }
+            // Read through the instance: a proxy put by another aspect answers its own wrapper.
+            const current = Reflect.get(instance, name);
+            if (isWrappable(current)) {
+                methods.set(name, current);
+            }
+        }
+    }
+    return methods;
+}
+function prototypeChain(instance) {
+    const chain = [];
+    for (let owner = instance; owner !== null && owner !== Object.prototype && owner !== Function.prototype; owner = Reflect.getPrototypeOf(owner)) {
+        chain.push(owner);
+    }
+    return chain;
+}
+/** A read-only own property cannot be shadowed, neither in place nor through a proxy. */
+function holdsShadowableMethod(owner, name, instance) {
+    const descriptor = Object.getOwnPropertyDescriptor(owner, name);
+    if (descriptor === undefined || (owner === instance && isReadOnly(descriptor))) {
+        return false;
+    }
+    return typeof descriptor.value === 'function';
+}
+function isReadOnly(descriptor) {
+    return !descriptor.writable && !descriptor.configurable;
+}
+function learning(original, wrapper) {
+    if (isAsync(original)) {
+        return wrapper;
+    }
+    const learner = function (...args) {
+        if (isAsync(original)) {
+            return wrapper.apply(this, args);
+        }
+        const result = original.apply(this, args);
+        if (isThenable(result)) {
+            knownAsync.add(original);
+        }
+        return result;
+    };
+    standsFor.set(learner, original);
+    return named(learner, original);
+}
+function isAsync(method) {
+    if (method.constructor.name === 'AsyncFunction' || knownAsync.has(method)) {
+        return true;
+    }
+    const other = standsFor.get(method);
+    return other !== undefined && isAsync(other);
+}
+function isThenable(value) {
+    return ((typeof value === 'object' || typeof value === 'function') &&
+        value !== null &&
+        'then' in value &&
+        typeof value.then === 'function');
+}
+/**
+ * A sealed or frozen instance cannot receive own methods, so it is fronted by a proxy that
+ * answers the wrappers. A method runs with the proxy as `this`, as it would with the instance
+ * itself: a method it calls through `this` meets the same wrappers, and its fields are read
+ * through.
+ */
+function proxied(instance, wrappers) {
+    return new Proxy(instance, {
+        get(target, property, receiver) {
+            const wrapper = typeof property === 'string' ? wrappers.get(property) : undefined;
+            return wrapper ?? Reflect.get(target, property, receiver);
+        },
+    });
+}
+//# sourceMappingURL=advise-methods.js.map

package/dist/weaving/advise-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advise-methods.js","sourceRoot":"","sources":["../../src/weaving/advise-methods.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,wEAAwE;AACxE,MAAM,SAAS,GAAG,IAAI,OAAO,EAAkB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAmB,QAAW,EAAE,IAAgB,EAAE,MAAqB;IAClG,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,EAAE,CAAC;IAEvB,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;QAEzF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACpG,CAAC;AAED,sFAAsF;AACtF,SAAS,gBAAgB,CAAC,QAAgB;IACxC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,aAAa,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC;IAElE,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnB,SAAS;YACX,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEf,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAClD,SAAS;YACX,CAAC;YAED,oFAAoF;YACpF,MAAM,OAAO,GAAY,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAErD,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KACE,IAAI,KAAK,GAAkB,QAAQ,EACnC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,QAAQ,CAAC,SAAS,EAC5E,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,EACrC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yFAAyF;AACzF,SAAS,qBAAqB,CAAC,KAAa,EAAE,IAAY,EAAE,QAAgB;IAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAEhE,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAC/E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,CAAC;AAChD,CAAC;AAED,SAAS,UAAU,CAAC,UAA8B;IAChD,OAAO,CAAC,UAAU,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;AAC1D,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB,EAAE,OAAe;IACjD,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAW,UAAyB,GAAG,IAAe;QACjE,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtB,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE1C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEjC,OAAO,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,OAAO,CAAC,MAAc;IAC7B,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEpC,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;QAC1D,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CACjC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,OAAO,CAAmB,QAAW,EAAE,QAAqC;IACnF,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE;QACzB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAiB;YACrC,MAAM,OAAO,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAElF,OAAO,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/weaving/advise-prototype-method.d.ts

@@ -0,0 +1,8 @@
+import type { AdviceFactory } from '../aspect/advice-factory.js';
+/**
+ * The same advice for a method decorated in the legacy mode, which has no initializer to run
+ * at construction: the answer replaces the method on the prototype, and builds the advice of
+ * each instance at its first call. State is kept per instance and per method, as above.
+ */
+export declare function advisePrototypeMethod(name: string, original: unknown, advise: AdviceFactory): unknown;
+//# sourceMappingURL=advise-prototype-method.d.ts.map

package/dist/weaving/advise-prototype-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advise-prototype-method.d.ts","sourceRoot":"","sources":["../../src/weaving/advise-prototype-method.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAQjE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAsBrG"}

package/dist/weaving/advise-prototype-method.js

@@ -0,0 +1,30 @@
+import { advised } from './advised.js';
+import { isWrappable } from './is-wrappable.js';
+import { knownAsync } from './known-async.js';
+import { named } from './named.js';
+import { siteOf } from './site-of.js';
+/**
+ * The same advice for a method decorated in the legacy mode, which has no initializer to run
+ * at construction: the answer replaces the method on the prototype, and builds the advice of
+ * each instance at its first call. State is kept per instance and per method, as above.
+ */
+export function advisePrototypeMethod(name, original, advise) {
+    if (!isWrappable(original)) {
+        return original;
+    }
+    const wrappers = new WeakMap();
+    const dispatcher = function (...args) {
+        if (typeof this !== 'object' || this === null) {
+            return original.apply(this, args);
+        }
+        const wrapper = wrappers.get(this) ?? adviceOf(this, original, { name, advise });
+        wrappers.set(this, wrapper);
+        return wrapper.apply(this, args);
+    };
+    knownAsync.add(dispatcher);
+    return named(dispatcher, original);
+}
+function adviceOf(instance, original, { name, advise }) {
+    return advised(original, { ...siteOf(instance, {}), method: name, arity: original.length }, advise) ?? original;
+}
+//# sourceMappingURL=advise-prototype-method.js.map

package/dist/weaving/advise-prototype-method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advise-prototype-method.js","sourceRoot":"","sources":["../../src/weaving/advise-prototype-method.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,QAAiB,EAAE,MAAqB;IAC1F,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAkB,CAAC;IAE/C,MAAM,UAAU,GAAW,UAAyB,GAAG,IAAe;QACpE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAEjF,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE5B,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;IAEF,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE3B,OAAO,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC;AAOD,SAAS,QAAQ,CAAC,QAAgB,EAAE,QAAgB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAY;IAC9E,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC;AAClH,CAAC"}

package/dist/weaving/advised.d.ts

@@ -0,0 +1,6 @@
+import type { AdviceFactory } from '../aspect/advice-factory.js';
+import type { JoinPoint } from '../aspect/join-point.js';
+import type { Method } from './method.js';
+/** The method inside the advice built for its join point, `undefined` when the factory leaves it alone. */
+export declare function advised(original: Method, joinPoint: JoinPoint, advise: AdviceFactory): Method | undefined;
+//# sourceMappingURL=advised.d.ts.map

package/dist/weaving/advised.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advised.d.ts","sourceRoot":"","sources":["../../src/weaving/advised.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,2GAA2G;AAC3G,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAkBzG"}

package/dist/weaving/advised.js

@@ -0,0 +1,19 @@
+import { knownAsync } from './known-async.js';
+import { named } from './named.js';
+/** The method inside the advice built for its join point, `undefined` when the factory leaves it alone. */
+export function advised(original, joinPoint, advise) {
+    const advice = advise(joinPoint);
+    if (advice === undefined) {
+        return undefined;
+    }
+    // Async so that an advice failing before its first await rejects the call instead of throwing.
+    const wrapper = async function (...args) {
+        return advice({
+            args,
+            proceed: async (next = args) => original.apply(this, [...next]),
+        });
+    };
+    knownAsync.add(wrapper);
+    return named(wrapper, original);
+}
+//# sourceMappingURL=advised.js.map

package/dist/weaving/advised.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advised.js","sourceRoot":"","sources":["../../src/weaving/advised.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,2GAA2G;AAC3G,MAAM,UAAU,OAAO,CAAC,QAAgB,EAAE,SAAoB,EAAE,MAAqB;IACnF,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAEjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,+FAA+F;IAC/F,MAAM,OAAO,GAAW,KAAK,WAA0B,GAAG,IAAe;QACvE,OAAO,MAAM,CAAC;YACZ,IAAI;YACJ,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;SAChE,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAExB,OAAO,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/weaving/from-outside.d.ts

@@ -0,0 +1,10 @@
+import type { Method } from './method.js';
+/**
+ * The advice for a call that reaches the instance from outside, the method itself for a call
+ * made while an advised call of the same application (one aspect on one instance) is running
+ * in the same asynchronous flow: what the instance calls on itself, through a public or a
+ * `private` method, is the inside of the call being advised, not another call to advise.
+ * Concurrent calls from outside are separate flows: each is advised.
+ */
+export declare function fromOutside(original: Method, wrapper: Method, application: object): Method;
+//# sourceMappingURL=from-outside.d.ts.map

package/dist/weaving/from-outside.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-outside.d.ts","sourceRoot":"","sources":["../../src/weaving/from-outside.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAW1C;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAmB1F"}

package/dist/weaving/from-outside.js

@@ -0,0 +1,29 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { named } from './named.js';
+// The advised calls the current asynchronous flow is inside of, outermost first.
+const callsInProgress = new AsyncLocalStorage();
+/**
+ * The advice for a call that reaches the instance from outside, the method itself for a call
+ * made while an advised call of the same application (one aspect on one instance) is running
+ * in the same asynchronous flow: what the instance calls on itself, through a public or a
+ * `private` method, is the inside of the call being advised, not another call to advise.
+ * Concurrent calls from outside are separate flows: each is advised.
+ */
+export function fromOutside(original, wrapper, application) {
+    const entry = async function (...args) {
+        const outer = callsInProgress.getStore() ?? [];
+        if (outer.some((call) => call.running && call.application === application)) {
+            return original.apply(this, args);
+        }
+        const call = { application, running: true };
+        try {
+            return await callsInProgress.run([...outer, call], () => wrapper.apply(this, args));
+        }
+        finally {
+            // What the call left behind (a timer, a listener) is a caller from outside once it is over.
+            call.running = false;
+        }
+    };
+    return named(entry, original);
+}
+//# sourceMappingURL=from-outside.js.map

package/dist/weaving/from-outside.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-outside.js","sourceRoot":"","sources":["../../src/weaving/from-outside.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAOnC,iFAAiF;AACjF,MAAM,eAAe,GAAG,IAAI,iBAAiB,EAA0B,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAe,EAAE,WAAmB;IAChF,MAAM,KAAK,GAAW,KAAK,WAA0B,GAAG,IAAe;QACrE,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QAE/C,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,KAAK,WAAW,CAAC,EAAE,CAAC;YAC3E,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,IAAI,GAAgB,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAEzD,IAAI,CAAC;YACH,OAAO,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACtF,CAAC;gBAAS,CAAC;YACT,4FAA4F;YAC5F,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/dist/weaving/is-wrappable.d.ts

@@ -0,0 +1,3 @@
+import type { Method } from './method.js';
+export declare function isWrappable(value: unknown): value is Method;
+//# sourceMappingURL=is-wrappable.d.ts.map

package/dist/weaving/is-wrappable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-wrappable.d.ts","sourceRoot":"","sources":["../../src/weaving/is-wrappable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAM3D"}

package/dist/weaving/is-wrappable.js

@@ -0,0 +1,7 @@
+const UNWRAPPABLE_CONSTRUCTORS = new Set(['GeneratorFunction', 'AsyncGeneratorFunction']);
+export function isWrappable(value) {
+    return (typeof value === 'function' &&
+        !UNWRAPPABLE_CONSTRUCTORS.has(value.constructor.name) &&
+        !Function.prototype.toString.call(value).startsWith('class'));
+}
+//# sourceMappingURL=is-wrappable.js.map

package/dist/weaving/is-wrappable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-wrappable.js","sourceRoot":"","sources":["../../src/weaving/is-wrappable.ts"],"names":[],"mappings":"AAEA,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,mBAAmB,EAAE,wBAAwB,CAAC,CAAC,CAAC;AAE1F,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,UAAU;QAC3B,CAAC,wBAAwB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;QACrD,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAC7D,CAAC;AACJ,CAAC"}

package/dist/weaving/known-async.d.ts

@@ -0,0 +1,4 @@
+import type { Method } from './method.js';
+/** Shared by every instance of a class: one call returning a thenable teaches them all. */
+export declare const knownAsync: WeakSet<Method>;
+//# sourceMappingURL=known-async.d.ts.map

package/dist/weaving/known-async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-async.d.ts","sourceRoot":"","sources":["../../src/weaving/known-async.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,2FAA2F;AAC3F,eAAO,MAAM,UAAU,iBAAwB,CAAC"}

package/dist/weaving/known-async.js

@@ -0,0 +1,3 @@
+/** Shared by every instance of a class: one call returning a thenable teaches them all. */
+export const knownAsync = new WeakSet();
+//# sourceMappingURL=known-async.js.map

package/dist/weaving/known-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-async.js","sourceRoot":"","sources":["../../src/weaving/known-async.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,EAAU,CAAC"}

package/dist/weaving/lifecycle-hooks.d.ts

@@ -0,0 +1,3 @@
+/** Method names never wrapped: frameworks call them outside of any unit of work. */
+export declare const LIFECYCLE_HOOKS: readonly string[];
+//# sourceMappingURL=lifecycle-hooks.d.ts.map

package/dist/weaving/lifecycle-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-hooks.d.ts","sourceRoot":"","sources":["../../src/weaving/lifecycle-hooks.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAM5C,CAAC"}

package/dist/weaving/lifecycle-hooks.js

@@ -0,0 +1,9 @@
+/** Method names never wrapped: frameworks call them outside of any unit of work. */
+export const LIFECYCLE_HOOKS = [
+    'onModuleInit',
+    'onModuleDestroy',
+    'onApplicationBootstrap',
+    'onApplicationShutdown',
+    'dispose',
+];
+//# sourceMappingURL=lifecycle-hooks.js.map

package/dist/weaving/lifecycle-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-hooks.js","sourceRoot":"","sources":["../../src/weaving/lifecycle-hooks.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,cAAc;IACd,iBAAiB;IACjB,wBAAwB;IACxB,uBAAuB;IACvB,SAAS;CACV,CAAC"}

package/dist/weaving/method.d.ts

@@ -0,0 +1,2 @@
+export type Method = (this: unknown, ...args: unknown[]) => unknown;
+//# sourceMappingURL=method.d.ts.map

package/dist/weaving/method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method.d.ts","sourceRoot":"","sources":["../../src/weaving/method.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC"}

package/dist/weaving/method.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=method.js.map

package/dist/weaving/method.js.map

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

package/dist/weaving/named.d.ts

@@ -0,0 +1,4 @@
+import type { Method } from './method.js';
+/** The wrapper under the name and the declared parameters of what it wraps. */
+export declare function named(wrapper: Method, original: Method): Method;
+//# sourceMappingURL=named.d.ts.map

package/dist/weaving/named.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named.d.ts","sourceRoot":"","sources":["../../src/weaving/named.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,+EAA+E;AAC/E,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK/D"}

package/dist/weaving/named.js

@@ -0,0 +1,7 @@
+/** The wrapper under the name and the declared parameters of what it wraps. */
+export function named(wrapper, original) {
+    Object.defineProperty(wrapper, 'name', { value: original.name, configurable: true });
+    Object.defineProperty(wrapper, 'length', { value: original.length, configurable: true });
+    return wrapper;
+}
+//# sourceMappingURL=named.js.map

package/dist/weaving/named.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named.js","sourceRoot":"","sources":["../../src/weaving/named.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,QAAgB;IACrD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/weaving/shadowed.d.ts

@@ -0,0 +1,4 @@
+import type { Method } from './method.js';
+/** The instance with the wrappers as own methods, in front of the ones of its class. */
+export declare function shadowed<T extends object>(instance: T, wrappers: ReadonlyMap<string, Method>): T;
+//# sourceMappingURL=shadowed.d.ts.map

package/dist/weaving/shadowed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadowed.d.ts","sourceRoot":"","sources":["../../src/weaving/shadowed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,wFAAwF;AACxF,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAahG"}

package/dist/weaving/shadowed.js

@@ -0,0 +1,14 @@
+/** The instance with the wrappers as own methods, in front of the ones of its class. */
+export function shadowed(instance, wrappers) {
+    for (const [name, wrapper] of wrappers) {
+        const own = Object.getOwnPropertyDescriptor(instance, name);
+        Object.defineProperty(instance, name, {
+            value: wrapper,
+            writable: true,
+            configurable: true,
+            enumerable: own?.enumerable ?? false,
+        });
+    }
+    return instance;
+}
+//# sourceMappingURL=shadowed.js.map

package/dist/weaving/shadowed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadowed.js","sourceRoot":"","sources":["../../src/weaving/shadowed.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,MAAM,UAAU,QAAQ,CAAmB,QAAW,EAAE,QAAqC;IAC3F,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,CAAC,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAE5D,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE;YACpC,KAAK,EAAE,OAAO;YACd,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,GAAG,EAAE,UAAU,IAAI,KAAK;SACrC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/weaving/site-of.d.ts

@@ -0,0 +1,5 @@
+import type { AspectInfo } from '../aspect/aspect-info.js';
+import type { JoinPoint } from '../aspect/join-point.js';
+/** What every join point of an instance says of it. */
+export declare function siteOf(instance: object, info: AspectInfo): Omit<JoinPoint, 'method' | 'arity'>;
+//# sourceMappingURL=site-of.d.ts.map

package/dist/weaving/site-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-of.d.ts","sourceRoot":"","sources":["../../src/weaving/site-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,uDAAuD;AACvD,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,CAQ9F"}

package/dist/weaving/site-of.js

@@ -0,0 +1,15 @@
+/** What every join point of an instance says of it. */
+export function siteOf(instance, info) {
+    return {
+        instance,
+        className: info.className ?? constructorNameOf(instance),
+        ...(info.kind === undefined ? {} : { kind: info.kind }),
+        ...(info.context === undefined ? {} : { context: info.context }),
+        ...(info.token === undefined ? {} : { token: info.token }),
+    };
+}
+function constructorNameOf(instance) {
+    const constructor = Reflect.get(instance, 'constructor');
+    return typeof constructor === 'function' && constructor.name !== '' ? constructor.name : 'Object';
+}
+//# sourceMappingURL=site-of.js.map

package/dist/weaving/site-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-of.js","sourceRoot":"","sources":["../../src/weaving/site-of.ts"],"names":[],"mappings":"AAGA,uDAAuD;AACvD,MAAM,UAAU,MAAM,CAAC,QAAgB,EAAE,IAAgB;IACvD,OAAO;QACL,QAAQ;QACR,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,iBAAiB,CAAC,QAAQ,CAAC;QACxD,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;KAC3D,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,WAAW,GAAY,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAElE,OAAO,OAAO,WAAW,KAAK,UAAU,IAAI,WAAW,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AACpG,CAAC"}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@ddd-ts-kit/aspects",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Cross-cutting behaviour applied from outside: logging, metrics, retry, timeout, circuit breaker and caching as composable wrappers at the composition root, as bus middlewares, or as standard decorators on adapters. The domain stays clean.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gbourgeat/ddd-ts-kit.git",
+    "directory": "packages/aspects"
+  },
+  "homepage": "https://github.com/gbourgeat/ddd-ts-kit/tree/main/packages/aspects#readme",
+  "bugs": "https://github.com/gbourgeat/ddd-ts-kit/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./decorators": {
+      "types": "./dist/decorators.d.ts",
+      "default": "./dist/decorators.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@ddd-ts-kit/kernel": "0.1.0"
+  },
+  "devDependencies": {
+    "@ddd-ts-kit/di": "0.1.0"
+  }
+}