@cldmv/slothlet-types 3.17.0 → 3.18.1

package/lib/handlers/event-manager.d.mts

@@ -66,6 +66,32 @@ export class EventManager extends ComponentBase {
      * @public
      */
     public emit(event: string, payload?: any): Promise<void>;
+    /**
+     * Resolve the delivery level a given subscriber identity WOULD be granted for an event, WITHOUT
+     * subscribing. Host-only (gated like `rules.*` by the built-in `slothlet.event.**` deny), because
+     * it is answered for a caller-SUPPLIED identity — the inverse of {@link on}, which derives the
+     * subscriber from the live caller and never trusts a supplied one. Here the caller is the trusted
+     * host, resolving on behalf of someone else.
+     *
+     * The motivating consumer is a cross-boundary forwarding layer such as `@cldmv/slothlet-vine`:
+     * to carry an instance's events to a subscriber in another instance, the trusted (serving) side
+     * resolves that remote subscriber's level here and strips the payload BEFORE it crosses, so a
+     * `notify`-level far subscriber's domain payload never leaves this instance. Enforcement stays on
+     * the trusted side; the boundary layer never re-implements the policy.
+     *
+     * Pure and side-effect-free: it registers nothing and mutates no state. Conditional event rules
+     * resolve against the current runtime context, exactly as an emit-time resolution would.
+     *
+     * @param {string|null} subscriberPath - The subscriber's api path to resolve for. `null` denotes a
+     *   host subscription and always resolves `allow`.
+     * @param {string} event - Event name.
+     * @returns {"deny"|"notify"|"allow"} The level that identity would be granted for this event under
+     *   the current rule set and runtime context.
+     * @throws {SlothletError} INVALID_ARGUMENT for a non-string/empty event, or a `subscriberPath` that
+     *   is neither a string nor `null`.
+     * @public
+     */
+    public resolveLevel(subscriberPath: string | null, event: string): "deny" | "notify" | "allow";
     /**
      * Tear down all subscriptions. Called from `Slothlet.shutdown()`.
      * @returns {void}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cldmv/slothlet-types",
-	"version": "3.17.0",
+	"version": "3.18.1",
 	"description": "TypeScript declaration files (.d.mts) for @cldmv/slothlet. Install alongside @cldmv/slothlet for editor and type-checker support.",
 	"keywords": [
 		"slothlet",
@@ -79,7 +79,7 @@
 		"LICENSE"
 	],
 	"peerDependencies": {
-		"@cldmv/slothlet": "3.17.0"
+		"@cldmv/slothlet": "3.18.1"
 	},
 	"peerDependenciesMeta": {
 		"@cldmv/slothlet": {