@ariestools/aries-dapp-core 0.1.15 → 0.1.17

package/dist/bin/dappServer.mjs

@@ -3,169 +3,17 @@ import { createRequire } from "node:module";
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import path from "node:path";
+import { runActorsService } from "@ariestools/actor-cli";
 import { DAPP_BACKINGS, DAPP_BUCKETS, isDappBackingKind, resolveBacking, startDappServer } from "@ariestools/aries-dapp-serve";
-import { AbstractCreatable, ConsoleLogger, IdLogger, assertEx, creatable } from "@ariestools/sdk";
+import { createNodeProcessHost } from "@ariestools/cli-kit-node";
+import { ConsoleLogger, assertEx, creatable } from "@ariestools/sdk";
+import { PeriodicActor } 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
-	};
-}
+//#region src/providers/capabilities.ts
 /**
-* 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.
+Thrown when a read-only capability wrapper receives a write.
 */
-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 {
 	name = "ReadOnlyStoreError";
 	constructor(role, operation = "put") {
@@ -222,10 +70,14 @@ const DappStateStoreMoniker = "DappStateStore";
 const DappIndexStoreMoniker = "DappIndexStore";
 //#endregion
 //#region src/publication/constants.ts
-/** Well-known relative keys published by the coherent generation protocol. */
+/**
+Well-known relative keys published by the coherent generation protocol.
+*/
 const HEAD_KEY = "head.json";
 const STATUS_KEY = "status.json";
-/** CDN caching: mutable head and status objects that must revalidate. */
+/**
+CDN caching: mutable head and status objects that must revalidate.
+*/
 const CACHE_CONTROL_REVALIDATE = "public, max-age=0, must-revalidate";
 const INDEXER_STATUS_SCHEMA = "network.aries.dapp.indexer.status";
 //#endregion
@@ -290,7 +142,9 @@ const PROGRESS_KEYS = [
 	"generation",
 	"generationRoot"
 ];
-/** Carry forward durable progress fields from a prior status object. */
+/**
+Carry forward durable progress fields from a prior status object.
+*/
 function priorProgressFields(prior) {
 	if (prior === void 0) return {};
 	return {
@@ -298,7 +152,9 @@ function priorProgressFields(prior) {
 		...prior.lastSuccessAt !== void 0 && { lastSuccessAt: prior.lastSuccessAt }
 	};
 }
-/** Build success status fields from reduce progress, falling back to prior. */
+/**
+Build success status fields from reduce progress, falling back to prior.
+*/
 function successStatusFields(progress, prior, now) {
 	const fromProgress = progress === void 0 ? {} : pickDefined(progress, PROGRESS_KEYS);
 	const generation = progress?.generation ?? prior?.generation;
@@ -313,7 +169,9 @@ function successStatusFields(progress, prior, now) {
 		...prior?.lastErrorAt !== void 0 && { lastErrorAt: prior.lastErrorAt }
 	};
 }
-/** Build failure status fields while preserving prior checkpoint progress. */
+/**
+Build failure status fields while preserving prior checkpoint progress.
+*/
 function failureStatusFields(prior, consecutiveFailures, error, now) {
 	return {
 		consecutiveFailures,
@@ -323,7 +181,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.143.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 +191,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 +199,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 +208,17 @@ 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 +227,27 @@ 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)`);
+	}
+	/**
+	Failure side-channel: publish durable failure status (count already incremented).
+	*/
+	async onPassError(error) {
+		await this.safePublishStatus(void 0, error);
 	}
-	async stopHandler() {
-		this.settleFirstPass(/* @__PURE__ */ new Error("Actor stopped before first reduce pass completed"));
-		await super.stopHandler();
+	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 +258,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,50 +268,9 @@ 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.
-*/
-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;
-	}
-}
-//#endregion
 //#region src/providers/errors.ts
 /**
 * Thrown when a conditional put fails (object already exists under
@@ -517,7 +298,9 @@ function joinKey(prefix, relativeKey) {
 	if (cleanKey.length === 0) return cleanPrefix;
 	return `${cleanPrefix}/${cleanKey}`;
 }
-/** Strip a role prefix from a physical key, returning the relative key. */
+/**
+Strip a role prefix from a physical key, returning the relative key.
+*/
 function stripPrefix(prefix, physicalKey) {
 	const cleanPrefix = prefix.replaceAll(/^\/+|\/+$/g, "");
 	if (cleanPrefix.length === 0) return physicalKey;
@@ -526,7 +309,9 @@ function stripPrefix(prefix, physicalKey) {
 	if (physicalKey.startsWith(withSlash)) return physicalKey.slice(withSlash.length);
 	return physicalKey;
 }
-/** Normalize an optional public base URL (no trailing slash). */
+/**
+Normalize an optional public base URL (no trailing slash).
+*/
 function normalizePublicBaseUrl(url) {
 	if (url === void 0 || url.length === 0) return void 0;
 	return url.replace(/\/+$/, "");
@@ -942,28 +727,30 @@ async function main() {
 	});
 	process.env.DAPP_PUBLICATION_SAFETY ??= "unfenced";
 	process.env.DAPP_ENDPOINT ??= server.baseUrl;
-	const actors = await bootDappActors(locator, [{
+	const actors = [await DappActor.create({
+		firstRunDelayMs: FIRST_RUN_DELAY_MS,
+		locator,
 		name: "DappActor",
-		reducer,
+		publishStatus: reducer.name !== "noop",
 		reduceIntervalMs: REDUCE_INTERVAL_MS,
-		firstRunDelayMs: FIRST_RUN_DELAY_MS,
-		publishStatus: reducer.name !== "noop"
-	}]);
+		reducer
+	})];
 	const versionSuffix = reducer.version === void 0 ? "" : `@${reducer.version}`;
 	const reducerLine = REDUCER_SPEC === void 0 ? "\nreducer: noop (pass DAPP_REDUCER / --reducer for real logic)" : `\nreducer: ${REDUCER_SPEC}`;
-	console.log(`[dev-only] dapp server listening at ${server.baseUrl}\n` + DAPP_BUCKETS.map((bucket) => `  /${bucket.padEnd(5)} ${server.baseUrl}/${bucket}`).join("\n") + `\nbacking: ${backing.description}\nactors: ${actors.length} (reducer '${reducer.name}'${versionSuffix}, every ${REDUCE_INTERVAL_MS}ms)` + reducerLine);
-	const shutdown = async () => {
-		for (const actor of actors) await actor.stop();
+	const banner = `[dev-only] dapp server listening at ${server.baseUrl}\n` + DAPP_BUCKETS.map((bucket) => `  /${bucket.padEnd(5)} ${server.baseUrl}/${bucket}`).join("\n") + `\nbacking: ${backing.description}\nactors: ${actors.length} (reducer '${reducer.name}'${versionSuffix}, every ${REDUCE_INTERVAL_MS}ms)` + reducerLine;
+	const processHost = createNodeProcessHost({ signals: ["SIGINT", "SIGTERM"] });
+	try {
+		await runActorsService(processHost, {
+			actors,
+			onReady: () => {
+				console.log(banner);
+			},
+			supervisor: "parallel"
+		});
+	} finally {
 		locator.destroy();
 		await server.close();
-		process.exit(0);
-	};
-	process.on("SIGINT", () => {
-		shutdown();
-	});
-	process.on("SIGTERM", () => {
-		shutdown();
-	});
+	}
 }
 main().catch((error) => {
 	console.error(error);

package/dist/node/DappActor.d.ts

@@ -1,47 +1,51 @@
-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;;MAEE;IACF,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;;MAEE;IACF,IAAa,MAAM,IAAI,MAAM,CAE5B;IAED;;MAEE;IACF,cAAuB,UAAU,IAAI,MAAM,CAE1C;IAEc,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5C;;MAEE;cACuB,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,23 @@
-import type { CreatableParams, Logger } from '@ariestools/sdk';
-/** Identifier a provider is registered and resolved under in the locator. */
+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;;EAEE;AACF,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/bin/loadReducer.d.ts

@@ -5,7 +5,9 @@ export interface LoadReducerOptions {
      * Defaults to trying `reducer`, then `default`.
      */
     exportName?: string;
-    /** Absolute or relative path to a `.mjs` file, or a resolvable package export. */
+    /**
+    Absolute or relative path to a `.mjs` file, or a resolvable package export.
+    */
     spec: string;
 }
 /**

package/dist/node/bin/loadReducer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadReducer.d.ts","sourceRoot":"","sources":["../../../src/bin/loadReducer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAI5D,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAA;CACb;AA6DD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAOnF"}
+{"version":3,"file":"loadReducer.d.ts","sourceRoot":"","sources":["../../../src/bin/loadReducer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAI5D,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;MAEE;IACF,IAAI,EAAE,MAAM,CAAA;CACb;AA6DD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAOnF"}

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