@ariestools/aries-dapp-core 0.1.14 → 0.1.16

package/dist/bin/dappServer.mjs

@@ -4,166 +4,10 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import path from "node:path";
 import { DAPP_BACKINGS, DAPP_BUCKETS, isDappBackingKind, resolveBacking, startDappServer } from "@ariestools/aries-dapp-serve";
-import { AbstractCreatable, ConsoleLogger, IdLogger, assertEx, creatable } from "@ariestools/sdk";
+import { ConsoleLogger, assertEx, creatable } from "@ariestools/sdk";
+import { PeriodicActor, bootActors } from "@ariestools/actor";
 import { DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
 import { pathToFileURL } from "node:url";
-//#region src/actor/AbstractActor.ts
-function createDeferred$1() {
-	let resolve;
-	let reject;
-	const promise = new Promise((res, rej) => {
-		resolve = res;
-		reject = rej;
-	});
-	promise.catch(() => {});
-	return {
-		promise,
-		reject,
-		resolve
-	};
-}
-/**
-* Lean, dapp-owned fork of the xl1 `ActorV3` pattern: the create/start/stop
-* lifecycle from `AbstractCreatable`, plus non-overlapping interval timers and
-* a readiness contract. It deliberately swaps the chain's
-* `ProviderFactoryLocator`/`LocatorConfig` machinery for the small
-* {@link DappProviderLocator} seam, so a dapp actor resolves providers by
-* moniker without dragging the chain protocol config model in.
-*
-* The locator is process-wide: the daemon builds it once and passes the same
-* instance to every actor via `params.locator` (see `bootDappActors`). When
-* this graduates into a shared cli/actor toolkit — and, later, xl1-protocol —
-* this base can re-adopt the real locator.
-*/
-var AbstractActor = class extends AbstractCreatable {
-	_intervals = /* @__PURE__ */ new Map();
-	_timeouts = /* @__PURE__ */ new Map();
-	_abortController = new AbortController();
-	_idLogger;
-	_inFlight = /* @__PURE__ */ new Map();
-	_readyDeferred = createDeferred$1();
-	_readyError;
-	_readyState = "pending";
-	get logger() {
-		this._idLogger ??= new IdLogger(assertEx(this.context.logger, () => `Logger is required in context for actor ${this.name}.`), () => this.name);
-		return this._idLogger;
-	}
-	get readyError() {
-		return this._readyError;
-	}
-	get readyState() {
-		return this._readyState;
-	}
-	get context() {
-		return this.locator.context;
-	}
-	get locator() {
-		return this.params.locator;
-	}
-	/** Abort signal cancelled when the actor stops (or is replaced on restart). */
-	get signal() {
-		return this._abortController.signal;
-	}
-	static async paramsHandler(params) {
-		const inParams = params ?? {};
-		const baseParams = await super.paramsHandler({
-			...inParams,
-			name: inParams.name ?? "UnknownActor"
-		});
-		const locator = assertEx(inParams.locator, () => `params.locator is required for actor ${String(baseParams.name)}.`);
-		return {
-			...baseParams,
-			locator
-		};
-	}
-	/** Override to prove the actor can do useful work. Default: no-op. */
-	async readyHandler() {}
-	/**
-	* Register a recurring task. The first invocation fires after `dueTimeMs`
-	* (the documented first-run delay); subsequent invocations fire every
-	* `periodMs` while the actor is `started`. A run is skipped if the previous
-	* one is still in flight, so a slow pass can never stack on top of itself.
-	* Must be called from `startHandler` (guards on `starting` status).
-	*/
-	registerTimer(timerName, callback, dueTimeMs, periodMs) {
-		if (this.status !== "starting") {
-			this.logger.warn(`Cannot register timer '${timerName}' because actor is not starting.`);
-			return;
-		}
-		const tick = () => {
-			if (this.status !== "started") return;
-			if (this._inFlight.has(timerName)) {
-				this.logger.warn(`Skipping timer '${this.name}:${timerName}' because the previous run is still in flight.`);
-				return;
-			}
-			const run = (async () => {
-				const startTime = Date.now();
-				try {
-					await callback();
-				} catch (error) {
-					const err = error instanceof Error ? error : new Error(String(error));
-					this.logger.error(`Error in timer '${this.name}:${timerName}': ${err.message}`);
-				} finally {
-					const duration = Date.now() - startTime;
-					if (duration > periodMs) this.logger.warn(`Timer '${this.name}:${timerName}' took ${duration}ms, longer than its ${periodMs}ms period.`);
-				}
-			})();
-			this._inFlight.set(timerName, run.finally(() => {
-				this._inFlight.delete(timerName);
-			}));
-		};
-		const timeoutId = setTimeout(() => {
-			if (this.status !== "started") return;
-			this._intervals.set(timerName, setInterval(tick, periodMs));
-			tick();
-		}, dueTimeMs);
-		this._timeouts.set(timerName, timeoutId);
-	}
-	/**
-	* Run the warm-pass once. The standard boot path invokes this after
-	* `start()` so readiness either resolves or rejects.
-	*/
-	async runReadyHandler() {
-		if (this._readyState !== "pending") return;
-		try {
-			await this.readyHandler();
-			this._readyState = "ready";
-			this._readyDeferred.resolve();
-		} catch (error) {
-			const err = error instanceof Error ? error : new Error(String(error));
-			this._readyState = "failed";
-			this._readyError = err;
-			this._readyDeferred.reject(err);
-			throw err;
-		}
-	}
-	async startHandler() {
-		if (this._abortController.signal.aborted) this._abortController = new AbortController();
-		await super.startHandler();
-	}
-	async stopHandler() {
-		await super.stopHandler();
-		this._abortController.abort();
-		for (const timeoutRef of this._timeouts.values()) clearTimeout(timeoutRef);
-		this._timeouts.clear();
-		for (const intervalRef of this._intervals.values()) clearInterval(intervalRef);
-		this._intervals.clear();
-		const inFlight = [...this._inFlight.values()];
-		this._inFlight.clear();
-		const timeoutMs = this.params.shutdownTimeoutMs;
-		if (timeoutMs === void 0) {
-			await Promise.allSettled(inFlight);
-			return;
-		}
-		await Promise.race([Promise.allSettled(inFlight), new Promise((resolve) => {
-			setTimeout(resolve, timeoutMs);
-		})]);
-	}
-	async whenReady() {
-		await this._readyDeferred.promise;
-	}
-};
-//#endregion
 //#region src/providers/capabilities.ts
 /** Thrown when a read-only capability wrapper receives a write. */
 var ReadOnlyStoreError = class extends Error {
@@ -323,7 +167,7 @@ function failureStatusFields(prior, consecutiveFailures, error, now) {
 	};
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.140.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -333,22 +177,6 @@ function __decorate(decorators, target, key, desc) {
 //#endregion
 //#region src/DappActor.ts
 const DEFAULT_REDUCE_INTERVAL_MS = 5e3;
-const DEFAULT_FIRST_RUN_DELAY_MS = 2e3;
-const REDUCE_TIMER = "DappReduce";
-function createDeferred() {
-	let resolve;
-	let reject;
-	const promise = new Promise((res, rej) => {
-		resolve = res;
-		reject = rej;
-	});
-	promise.catch(() => {});
-	return {
-		promise,
-		reject,
-		resolve
-	};
-}
 function withDefaultGenerationRoot(result) {
 	if (result === void 0) return;
 	if (result.generation === void 0 || result.generationRoot !== void 0) return result;
@@ -357,7 +185,7 @@ function withDefaultGenerationRoot(result) {
 		generationRoot: HEAD_KEY
 	};
 }
-let DappActor = class DappActor extends AbstractActor {
+let DappActor = class DappActor extends PeriodicActor {
 	static dependencies = [
 		DappDataStoreMoniker,
 		DappStateStoreMoniker,
@@ -366,12 +194,13 @@ let DappActor = class DappActor extends AbstractActor {
 	_data;
 	_index;
 	_state;
-	_consecutiveFailures = 0;
-	_firstPass = createDeferred();
-	_firstPassSettled = false;
-	/** Consecutive reduce failures since the last success. */
-	get consecutiveFailures() {
-		return this._consecutiveFailures;
+	/** Dapp actors require a logger in the locator context (see {@link DappContext}). */
+	get logger() {
+		return assertEx(super.logger, () => `Logger is required in context for actor ${this.name}.`);
+	}
+	/** Reduce cadence: `reduceIntervalMs` names the interval in dapp configs. */
+	get intervalMs() {
+		return this.params.reduceIntervalMs ?? DEFAULT_REDUCE_INTERVAL_MS;
 	}
 	async createHandler() {
 		await super.createHandler();
@@ -380,21 +209,25 @@ let DappActor = class DappActor extends AbstractActor {
 		this._state = await this.locator.getInstance(DappStateStoreMoniker);
 		this._index = await this.locator.getInstance(DappIndexStoreMoniker);
 	}
-	async readyHandler() {
-		await this._firstPass.promise;
-	}
 	async startHandler() {
 		await super.startHandler();
-		const interval = this.params.reduceIntervalMs ?? DEFAULT_REDUCE_INTERVAL_MS;
-		const firstRunDelay = this.params.firstRunDelayMs ?? DEFAULT_FIRST_RUN_DELAY_MS;
-		this.registerTimer(REDUCE_TIMER, async () => {
-			await this.runReducePass();
-		}, firstRunDelay, interval);
-		this.logger.info(`DappActor started: reducer '${this.params.reducer.name}' every ${interval}ms (first run in ${firstRunDelay}ms)`);
+		this.logger.info(`DappActor started: reducer '${this.params.reducer.name}' every ${this.intervalMs}ms (first run in ${this.firstRunDelayMs}ms)`);
 	}
-	async stopHandler() {
-		this.settleFirstPass(/* @__PURE__ */ new Error("Actor stopped before first reduce pass completed"));
-		await super.stopHandler();
+	/** Failure side-channel: publish durable failure status (count already incremented). */
+	async onPassError(error) {
+		await this.safePublishStatus(void 0, error);
+	}
+	async runPass({ signal }) {
+		const result = await this.params.reducer.reduce({
+			data: this._data,
+			index: this._index,
+			logger: this.logger,
+			signal,
+			state: this._state
+		});
+		if (signal.aborted) return;
+		const progress = withDefaultGenerationRoot(result === void 0 ? void 0 : result);
+		await this.safePublishStatus(progress);
 	}
 	async publishStatusFromProgress(progress, error) {
 		if (this.params.publishStatus === false) return;
@@ -405,40 +238,9 @@ let DappActor = class DappActor extends AbstractActor {
 			prior = void 0;
 		}
 		const now = (/* @__PURE__ */ new Date()).toISOString();
-		const fields = error === void 0 ? successStatusFields(progress, prior, now) : failureStatusFields(prior, this._consecutiveFailures, error, now);
+		const fields = error === void 0 ? successStatusFields(progress, prior, now) : failureStatusFields(prior, this.consecutiveFailures, error, now);
 		await writeIndexerStatus(this._state, fields);
 	}
-	async runReducePass() {
-		const signal = this.signal;
-		try {
-			const result = await this.params.reducer.reduce({
-				data: this._data,
-				index: this._index,
-				logger: this.logger,
-				signal,
-				state: this._state
-			});
-			if (signal.aborted) return;
-			const progress = withDefaultGenerationRoot(result === void 0 ? void 0 : result);
-			this._consecutiveFailures = 0;
-			await this.safePublishStatus(progress);
-			this.settleFirstPass();
-		} catch (error) {
-			if (signal.aborted) return;
-			const err = error instanceof Error ? error : new Error(String(error));
-			this._consecutiveFailures += 1;
-			await this.safePublishStatus(void 0, err);
-			this.settleFirstPass(err);
-			this.logger.error(`Error in reduce pass for '${this.params.reducer.name}': ${err.message}`);
-			const max = this.params.maxConsecutiveFailures;
-			if (max !== void 0 && this._consecutiveFailures >= max) {
-				this.logger.error(`Reducer '${this.params.reducer.name}' failed ${this._consecutiveFailures} consecutive times; stopping actor`);
-				setTimeout(() => {
-					this.stop();
-				}, 0);
-			}
-		}
-	}
 	async safePublishStatus(progress, error) {
 		try {
 			await this.publishStatusFromProgress(progress, error);
@@ -446,48 +248,34 @@ let DappActor = class DappActor extends AbstractActor {
 			this.logger.error(`Failed to publish indexer status: ${String(statusError)}`);
 		}
 	}
-	settleFirstPass(error) {
-		if (this._firstPassSettled) return;
-		this._firstPassSettled = true;
-		if (error === void 0) this._firstPass.resolve();
-		else this._firstPass.reject(error);
-	}
 };
 DappActor = __decorate([creatable()], DappActor);
 //#endregion
 //#region src/boot/bootDappActors.ts
 /**
 * Creates and starts one {@link DappActor} per spec, all sharing the single
-* process-wide locator. On partial failure, actors already started are stopped
-* before the error is rethrown. Returns them so the caller can stop them on
-* shutdown.
+* process-wide locator. A thin wrapper over actor-kit's `bootActors`: on
+* partial failure, actors already started are stopped (with shutdown
+* fallback) before the error is rethrown. Returns them so the caller can
+* stop them on shutdown.
 */
 async function bootDappActors(locator, specs) {
-	const actors = [];
-	try {
-		for (const spec of specs) {
-			const params = {
-				locator,
-				name: spec.name,
-				reducer: spec.reducer,
-				...spec.reduceIntervalMs !== void 0 && { reduceIntervalMs: spec.reduceIntervalMs },
-				...spec.firstRunDelayMs !== void 0 && { firstRunDelayMs: spec.firstRunDelayMs },
-				...spec.maxConsecutiveFailures !== void 0 && { maxConsecutiveFailures: spec.maxConsecutiveFailures },
-				...spec.publishStatus !== void 0 && { publishStatus: spec.publishStatus },
-				...spec.shutdownTimeoutMs !== void 0 && { shutdownTimeoutMs: spec.shutdownTimeoutMs }
-			};
-			const actor = await DappActor.create(params);
-			await actor.start();
-			actors.push(actor);
-			if (spec.runReady !== false) await actor.runReadyHandler();
-		}
-		return actors;
-	} catch (error) {
-		for (const actor of [...actors].reverse()) try {
-			await actor.stop();
-		} catch {}
-		throw error;
-	}
+	return await bootActors(specs.map((spec) => {
+		const params = {
+			locator,
+			name: spec.name,
+			reducer: spec.reducer,
+			...spec.reduceIntervalMs !== void 0 && { reduceIntervalMs: spec.reduceIntervalMs },
+			...spec.firstRunDelayMs !== void 0 && { firstRunDelayMs: spec.firstRunDelayMs },
+			...spec.maxConsecutiveFailures !== void 0 && { maxConsecutiveFailures: spec.maxConsecutiveFailures },
+			...spec.publishStatus !== void 0 && { publishStatus: spec.publishStatus },
+			...spec.shutdownTimeoutMs !== void 0 && { shutdownTimeoutMs: spec.shutdownTimeoutMs }
+		};
+		return {
+			create: () => DappActor.create(params),
+			...spec.runReady !== void 0 && { runReady: spec.runReady }
+		};
+	}));
 }
 //#endregion
 //#region src/providers/errors.ts

package/dist/node/DappActor.d.ts

@@ -1,47 +1,43 @@
-import { AbstractActor } from './actor/AbstractActor.ts';
-import type { ActorParams } from './actor/types.ts';
+import type { PeriodicActorParams, PeriodicPassContext } from '@ariestools/actor';
+import { PeriodicActor } from '@ariestools/actor';
+import type { Logger } from '@ariestools/sdk';
+import type { DappProviderLocator } from './actor/types.ts';
 import type { DappObjectReader, DappObjectWriter } from './providers/capabilities.ts';
 import type { DappReducer } from './reducer/DappReducer.ts';
-export interface DappActorParams extends ActorParams {
-    /** Delay before the first reduce pass. Defaults to 2000ms. */
-    firstRunDelayMs?: number;
-    /**
-     * When set, after this many consecutive reduce failures the actor stops so a
-     * supervisor can restart the process.
-     */
-    maxConsecutiveFailures?: number;
+export interface DappActorParams extends PeriodicActorParams<DappProviderLocator> {
     /**
      * When true (default), publish durable indexer status to the state store
      * after each reduce pass (success or failure).
      */
     publishStatus?: boolean;
+    /** Period between reduce passes. Defaults to 5000ms. */
     reduceIntervalMs?: number;
     reducer: DappReducer;
 }
 /**
  * The stock dapp actor: resolves the three bucket stores from the shared
  * locator, then drives its reducer on an interval to keep `state` and `index`
- * derived from authoritative input. Multiple actors (each with its own
- * reducer) can share one locator; this is the default single-reducer instance
- * the local daemon boots.
+ * derived from authoritative input. The loop policies (first-pass-gated
+ * readiness, non-overlap, consecutive-failure self-stop) come from
+ * `PeriodicActor`; this class contributes the reduce pass and durable status
+ * publication. Multiple actors (each with its own reducer) can share one
+ * locator; this is the default single-reducer instance the local daemon boots.
  */
-export declare class DappActor extends AbstractActor<DappActorParams> {
+export declare class DappActor extends PeriodicActor<DappActorParams> {
     static readonly dependencies: readonly ["DappDataStore", "DappStateStore", "DappIndexStore"];
     protected _data: DappObjectReader;
     protected _index: DappObjectWriter;
     protected _state: DappObjectWriter;
-    private _consecutiveFailures;
-    private readonly _firstPass;
-    private _firstPassSettled;
-    /** Consecutive reduce failures since the last success. */
-    get consecutiveFailures(): number;
+    /** Dapp actors require a logger in the locator context (see {@link DappContext}). */
+    get logger(): Logger;
+    /** Reduce cadence: `reduceIntervalMs` names the interval in dapp configs. */
+    protected get intervalMs(): number;
     createHandler(): Promise<void>;
-    readyHandler(): Promise<void>;
     startHandler(): Promise<void>;
-    stopHandler(): Promise<void>;
+    /** Failure side-channel: publish durable failure status (count already incremented). */
+    protected onPassError(error: Error): Promise<void>;
+    protected runPass({ signal }: PeriodicPassContext): Promise<void>;
     private publishStatusFromProgress;
-    private runReducePass;
     private safePublishStatus;
-    private settleFirstPass;
 }
 //# sourceMappingURL=DappActor.d.ts.map

package/dist/node/DappActor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DappActor.d.ts","sourceRoot":"","sources":["../../src/DappActor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AASrF,OAAO,KAAK,EAAsB,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE/E,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,EAAE,WAAW,CAAA;CACrB;AAmCD;;;;;;GAMG;AACH,qBACa,SAAU,SAAQ,aAAa,CAAC,eAAe,CAAC;IAC3D,MAAM,CAAC,QAAQ,CAAC,YAAY,iEAIlB;IAEV,SAAS,CAAC,KAAK,EAAG,gBAAgB,CAAA;IAClC,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAA;IACnC,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAA;IAEnC,OAAO,CAAC,oBAAoB,CAAI;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,iBAAiB,CAAQ;IAEjC,0DAA0D;IAC1D,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAEc,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAa7B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;YAK7B,yBAAyB;YAkBzB,aAAa;YA8Cb,iBAAiB;IAW/B,OAAO,CAAC,eAAe;CAMxB"}
+{"version":3,"file":"DappActor.d.ts","sourceRoot":"","sources":["../../src/DappActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAG7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AASrF,OAAO,KAAK,EAAsB,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE/E,MAAM,WAAW,eAAgB,SAAQ,mBAAmB,CAAC,mBAAmB,CAAC;IAC/E;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,EAAE,WAAW,CAAA;CACrB;AAYD;;;;;;;;GAQG;AACH,qBACa,SAAU,SAAQ,aAAa,CAAC,eAAe,CAAC;IAC3D,MAAM,CAAC,QAAQ,CAAC,YAAY,iEAIlB;IAEV,SAAS,CAAC,KAAK,EAAG,gBAAgB,CAAA;IAClC,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAA;IACnC,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAA;IAEnC,qFAAqF;IACrF,IAAa,MAAM,IAAI,MAAM,CAE5B;IAED,6EAA6E;IAC7E,cAAuB,UAAU,IAAI,MAAM,CAE1C;IAEc,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5C,wFAAwF;cAC/D,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;cAIxC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;YAclE,yBAAyB;YAkBzB,iBAAiB;CAUhC"}

package/dist/node/actor/types.d.ts

@@ -1,37 +1,21 @@
-import type { CreatableParams, Logger } from '@ariestools/sdk';
+import type { ActorContext, InstanceLocator, OwnedLocator, RegistrableLocator } from '@ariestools/actor-model';
+import type { Logger } from '@ariestools/sdk';
 /** Identifier a provider is registered and resolved under in the locator. */
 export type DappMoniker = string;
-export type ReadyState = 'pending' | 'ready' | 'failed';
 /**
- * The shared context carried by the process-wide locator. Kept intentionally
- * minimal — a `logger` is all an actor requires. Telemetry (meter/tracer) can
- * be added here when the base graduates into the shared cli/actor toolkit.
+ * The shared context carried by the process-wide locator. A `logger` is
+ * required for dapp actors; telemetry providers and a status reporter are
+ * available via the inherited {@link ActorContext} fields when wired.
  */
-export interface DappContext {
+export interface DappContext extends ActorContext {
     logger: Logger;
 }
 /**
- * Small service-locator seam an actor uses to resolve its providers by moniker.
- * A dapp-owned stand-in for the chain's `ProviderFactoryLocatorInstance` that
- * avoids the chain `LocatorConfig`/protocol coupling. The daemon builds one and
- * shares the same instance across every actor (see `bootDappActors`).
+ * The dapp locator contract: the actor-kit locator seam carrying the dapp
+ * context, with registration, ownership, and a `has` probe. The daemon builds
+ * one and shares the same instance across every actor (see `bootDappActors`).
  */
-export interface DappProviderLocator {
-    readonly context: DappContext;
-    /** Release owned resources (e.g. an S3 client constructed by the locator). */
-    destroy(): void;
-    getInstance<T>(moniker: DappMoniker): Promise<T>;
+export type DappProviderLocator = InstanceLocator<DappContext> & OwnedLocator & RegistrableLocator & {
     has(moniker: DappMoniker): boolean;
-    register(moniker: DappMoniker, instance: unknown): void;
-    tryGetInstance<T>(moniker: DappMoniker): Promise<T | undefined>;
-}
-/** Base params every dapp actor takes: the shared, process-wide locator. */
-export interface ActorParams extends CreatableParams {
-    locator: DappProviderLocator;
-    /**
-     * Max time to wait for in-flight timer work on stop after aborting the
-     * signal. When omitted, stop waits until in-flight work settles.
-     */
-    shutdownTimeoutMs?: number;
-}
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/node/actor/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/actor/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE9D,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,8EAA8E;IAC9E,OAAO,IAAI,IAAI,CAAA;IACf,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAChD,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;IACvD,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;CAChE;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,OAAO,EAAE,mBAAmB,CAAA;IAC5B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/actor/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,kBAAkB,EACnB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,WAAW,CAAC,GAAG,YAAY,GAAG,kBAAkB,GAAG;IACnG,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAA;CACnC,CAAA"}

package/dist/node/boot/bootDappActors.d.ts

@@ -17,9 +17,10 @@ export interface DappActorSpec {
 }
 /**
  * Creates and starts one {@link DappActor} per spec, all sharing the single
- * process-wide locator. On partial failure, actors already started are stopped
- * before the error is rethrown. Returns them so the caller can stop them on
- * shutdown.
+ * process-wide locator. A thin wrapper over actor-kit's `bootActors`: on
+ * partial failure, actors already started are stopped (with shutdown
+ * fallback) before the error is rethrown. Returns them so the caller can
+ * stop them on shutdown.
  */
 export declare function bootDappActors(locator: DappProviderLocator, specs: readonly DappActorSpec[]): Promise<DappActor[]>;
 //# sourceMappingURL=bootDappActors.d.ts.map

package/dist/node/boot/bootDappActors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootDappActors.d.ts","sourceRoot":"","sources":["../../../src/boot/bootDappActors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE5D,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,OAAO,CAAC,SAAS,EAAE,CAAC,CAiCtB"}
+{"version":3,"file":"bootDappActors.d.ts","sourceRoot":"","sources":["../../../src/boot/bootDappActors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE5D,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,OAAO,CAAC,SAAS,EAAE,CAAC,CAkBtB"}

package/dist/node/index.d.ts

@@ -1,5 +1,4 @@
-export { AbstractActor } from './actor/AbstractActor.ts';
-export type { ActorParams, DappContext, DappMoniker, DappProviderLocator, ReadyState, } from './actor/types.ts';
+export type { DappContext, DappMoniker, DappProviderLocator, } from './actor/types.ts';
 export type { DappActorSpec } from './boot/bootDappActors.ts';
 export { bootDappActors } from './boot/bootDappActors.ts';
 export type { DappActorParams } from './DappActor.ts';

package/dist/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}