@sly-rentals/core 1.0.0 → 1.1.0

package/dist/cjs/audit/events-registry.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Typed namespace tree for the SRSLY event listener.
+ *
+ * Built once from a const manifest mapping each event's IDL name to a
+ * `{ group, verb }` pair. The TypeScript type derives the entire dotted
+ * namespace shape from that manifest, so consumers get autocomplete on
+ * every event without us hand-rolling an interface — and adding a new
+ * event in the future only requires:
+ *
+ *   1. Append a row to `EVENT_MANIFEST`.
+ *   2. Add a decoder in `events.ts`.
+ *   3. Extend the `AuditEvent` union in `types.ts`.
+ *
+ * The runtime tree is generated alongside the type so they can never drift.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.events = void 0;
+const listener_1 = require("./listener");
+// Single source of truth — tuple form keeps the type literal so we can
+// derive the namespace shape at the type level. Order: [IDL name, group,
+// verb]. New events extend by appending here.
+const EVENT_MANIFEST = [
+    ['RentalAccepted', 'rental', 'accepted'],
+    ['RentalSettled', 'rental', 'settled'],
+    ['RentalCancelled', 'rental', 'cancelled'],
+    ['RentalClosed', 'rental', 'closed'],
+    ['OwnerPaid', 'owner', 'paid'],
+    ['FeesPaid', 'fees', 'paid'],
+];
+function nameChannel(name) {
+    return {
+        on: handler => (0, listener_1.onSrslyEvent)(name, handler),
+    };
+}
+function allChannel() {
+    return {
+        on: handler => (0, listener_1.onSrslyEvent)('*', handler),
+    };
+}
+function groupChannel(group) {
+    // Group-level "all" filters the global stream by manifest membership so a
+    // handler registered on `events.rental.all` only sees rental events even
+    // if a new top-level event ships later.
+    const memberNames = new Set(EVENT_MANIFEST.filter(([, g]) => g === group).map(([n]) => n));
+    return {
+        on: handler => {
+            return (0, listener_1.onSrslyEvent)('*', evt => {
+                if (memberNames.has(evt.type))
+                    handler(evt);
+            });
+        },
+    };
+}
+function buildTree() {
+    // Object literal — typed loosely while building, asserted to the derived
+    // tree shape at the end. Shape is guaranteed by the manifest iteration.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const tree = { all: allChannel() };
+    for (const [name, group, verb] of EVENT_MANIFEST) {
+        if (!tree[group])
+            tree[group] = { all: groupChannel(group) };
+        tree[group][verb] = nameChannel(name);
+    }
+    return tree;
+}
+/**
+ * Typed event tree. Use the deepest path you need — the handler arg is
+ * narrowed accordingly:
+ *
+ * @example
+ * ```ts
+ * import { events } from '@sly-rentals/core';
+ *
+ * // Single event
+ * events.rental.accepted.on(evt => evt.escrow);
+ *
+ * // Group-scoped catch-all
+ * events.rental.all.on(evt => evt.type);   // 'RentalAccepted' | 'RentalSettled' | …
+ *
+ * // Global catch-all
+ * events.all.on(evt => evt.signature);
+ * ```
+ */
+exports.events = buildTree();
+//# sourceMappingURL=events-registry.js.map

package/dist/cjs/audit/events-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-registry.js","sourceRoot":"","sources":["../../../src/audit/events-registry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,yCAA0C;AAI1C,uEAAuE;AACvE,yEAAyE;AACzE,8CAA8C;AAC9C,MAAM,cAAc,GAAG;IACrB,CAAC,gBAAgB,EAAE,QAAQ,EAAE,UAAU,CAAC;IACxC,CAAC,eAAe,EAAE,QAAQ,EAAE,SAAS,CAAC;IACtC,CAAC,iBAAiB,EAAE,QAAQ,EAAE,WAAW,CAAC;IAC1C,CAAC,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACpC,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC;IAC9B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC;CACpB,CAAC;AAsCX,SAAS,WAAW,CAAC,IAAoB;IACvC,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,IAAA,uBAAY,EAAC,IAAa,EAAE,OAAgB,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,UAAU;IACjB,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,IAAA,uBAAY,EAAC,GAAG,EAAE,OAAO,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAiB;IACrC,0EAA0E;IAC1E,yEAAyE;IACzE,wCAAwC;IACxC,MAAM,WAAW,GAAgB,IAAI,GAAG,CACtC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAC9D,CAAC;IACF,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;YACZ,OAAO,IAAA,uBAAY,EAAC,GAAG,EAAE,GAAG,CAAC,EAAE;gBAC7B,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS;IAChB,yEAAyE;IACzE,wEAAwE;IACxE,8DAA8D;IAC9D,MAAM,IAAI,GAAwB,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,cAAc,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAsB,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAkB,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,MAAM,GAAe,SAAS,EAAE,CAAC"}

package/dist/cjs/audit/index.js

@@ -1,8 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseAnchorEvents = exports.fetchContractAudit = void 0;
+exports.events = exports.onSrslyEvent = exports.getEventsFromTx = exports.createSrslyEventListener = exports.closeSrslyEventListener = exports.parseAnchorEvents = exports.fetchContractAudit = void 0;
 var audit_1 = require("./audit");
 Object.defineProperty(exports, "fetchContractAudit", { enumerable: true, get: function () { return audit_1.fetchContractAudit; } });
 var events_1 = require("./events");
 Object.defineProperty(exports, "parseAnchorEvents", { enumerable: true, get: function () { return events_1.parseAnchorEvents; } });
+var listener_1 = require("./listener");
+Object.defineProperty(exports, "closeSrslyEventListener", { enumerable: true, get: function () { return listener_1.closeSrslyEventListener; } });
+Object.defineProperty(exports, "createSrslyEventListener", { enumerable: true, get: function () { return listener_1.createSrslyEventListener; } });
+Object.defineProperty(exports, "getEventsFromTx", { enumerable: true, get: function () { return listener_1.getEventsFromTx; } });
+Object.defineProperty(exports, "onSrslyEvent", { enumerable: true, get: function () { return listener_1.onSrslyEvent; } });
+var events_registry_1 = require("./events-registry");
+Object.defineProperty(exports, "events", { enumerable: true, get: function () { return events_registry_1.events; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/audit/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/audit/index.ts"],"names":[],"mappings":";;;AAAA,iCAA6C;AAApC,2GAAA,kBAAkB,OAAA;AAC3B,mCAA6C;AAApC,2GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/audit/index.ts"],"names":[],"mappings":";;;AAAA,iCAA6C;AAApC,2GAAA,kBAAkB,OAAA;AAC3B,mCAA6C;AAApC,2GAAA,iBAAiB,OAAA;AAC1B,uCAKoB;AAJlB,mHAAA,uBAAuB,OAAA;AACvB,oHAAA,wBAAwB,OAAA;AACxB,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA;AAEd,qDAA2C;AAAlC,yGAAA,MAAM,OAAA"}

package/dist/cjs/audit/listener.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * SRSLY event listener — plug-and-play wrapper over `parseAnchorEvents` that
+ * lets a developer subscribe to the program's emitted events without ever
+ * importing Anchor or the IDL.
+ *
+ * Two ingest paths share one dispatch table:
+ *
+ *   - Live stream: register a handler with `onSrslyEvent(name, cb)`. The SDK
+ *     opens (and lazily caches) a singleton `logsNotifications` subscription
+ *     using the `wsUrl` from `setSdkConfig`. No listener instance to manage —
+ *     drop your handlers and go.
+ *   - Per-signature: pass a tx signature to `getEventsFromTx(sig)` to fetch
+ *     the confirmed transaction, parse its logs, and get back the typed
+ *     event array. Same handlers fire as for the live stream.
+ *
+ * Kit-only by design: events are SRSLY's, so there's no value in shipping a
+ * web3.js variant. Consumers that already have `@solana/kit` (everyone using
+ * this package) get the listener for free.
+ *
+ * For advanced cases — multiple isolated listeners, custom program IDs,
+ * test fixtures — `createSrslyEventListener()` is exported as the
+ * underlying primitive.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSrslyEventListener = createSrslyEventListener;
+exports.onSrslyEvent = onSrslyEvent;
+exports.getEventsFromTx = getEventsFromTx;
+exports.closeSrslyEventListener = closeSrslyEventListener;
+const kit_1 = require("@solana/kit");
+const events_1 = require("./events");
+const srsly_1 = require("../generated/codama/programs/srsly");
+const config_1 = require("../utils/config");
+/**
+ * Underlying listener primitive. Most consumers should reach for
+ * `onSrslyEvent` / `getEventsFromTx` instead — those bind to `setSdkConfig`
+ * automatically. Use this when you need multiple isolated listeners, a
+ * non-default program ID, or test injection.
+ */
+function createSrslyEventListener(opts = {}) {
+    const programId = String(opts.programId ?? srsly_1.SRSLY_PROGRAM_ADDRESS);
+    const handlers = new Map();
+    let abort = null;
+    let drain = null;
+    function dispatch(events) {
+        for (const evt of events) {
+            handlers.get(evt.type)?.forEach(cb => {
+                try {
+                    cb(evt);
+                }
+                catch (err) {
+                    // eslint-disable-next-line no-console
+                    console.error('[srsly:listener] handler threw for', evt.type, err);
+                }
+            });
+            handlers.get('*')?.forEach(cb => {
+                try {
+                    cb(evt);
+                }
+                catch (err) {
+                    // eslint-disable-next-line no-console
+                    console.error('[srsly:listener] * handler threw', err);
+                }
+            });
+        }
+    }
+    function on(name, handler) {
+        let set = handlers.get(name);
+        if (!set) {
+            set = new Set();
+            handlers.set(name, set);
+        }
+        set.add(handler);
+        return () => set.delete(handler);
+    }
+    async function start(o) {
+        if (abort)
+            return;
+        abort = new AbortController();
+        const commitment = o.commitment ?? 'confirmed';
+        let stream;
+        try {
+            stream = (await o.rpcSubscriptions
+                .logsNotifications({ mentions: [programId] }, { commitment })
+                .subscribe({ abortSignal: abort.signal }));
+        }
+        catch (err) {
+            // WS connect failure (RPC doesn't support logsSubscribe, network down,
+            // CORS, etc.). Stay inert so HTTP-only callers of `getEventsFromTx`
+            // still work. Reset abort so a later `start` can retry.
+            abort = null;
+            // eslint-disable-next-line no-console
+            console.warn('[srsly] event listener disabled — WS connect failed:', err);
+            return;
+        }
+        drain = (async () => {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                for await (const msg of stream) {
+                    const value = msg?.value;
+                    const slot = msg?.context?.slot;
+                    if (!value || slot === undefined)
+                        continue;
+                    if (value.err)
+                        continue;
+                    const events = (0, events_1.parseAnchorEvents)(value.logs, programId, BigInt(slot), String(value.signature));
+                    dispatch(events);
+                }
+            }
+            catch {
+                // AbortError on close, or socket-level disconnects.
+            }
+        })();
+    }
+    async function process(signature, o) {
+        const tx = await o.rpc
+            .getTransaction(signature, {
+            encoding: 'json',
+            maxSupportedTransactionVersion: 0,
+            commitment: o.commitment ?? 'confirmed',
+        })
+            .send();
+        if (!tx?.meta?.logMessages)
+            return [];
+        const events = (0, events_1.parseAnchorEvents)(tx.meta.logMessages, programId, BigInt(tx.slot), signature);
+        dispatch(events);
+        return events;
+    }
+    async function close() {
+        abort?.abort();
+        abort = null;
+        if (drain)
+            await drain;
+        drain = null;
+        handlers.clear();
+    }
+    return { on: on, start, process, close };
+}
+// ─────────────────────────────────────────────────────────────────────────
+// Config-bound singleton — what most consumers should reach for
+// ─────────────────────────────────────────────────────────────────────────
+let singleton = null;
+let singletonStarted = null;
+function getSingleton() {
+    if (!singleton)
+        singleton = createSrslyEventListener();
+    return singleton;
+}
+/**
+ * Lazily open the live stream when `setSdkConfig({ eventsListener: true })`
+ * is set. Idempotent — the second call returns the same start promise.
+ * No-op when the listener is disabled, so on-demand `getEventsFromTx` calls
+ * still work against the HTTP RPC alone.
+ *
+ * Throws if `eventsListener` is on but no `wsUrl` is configured — the failure
+ * is louder this way than a silently-no-op listener.
+ */
+async function ensureLiveStream() {
+    if (!(0, config_1.isEventsListenerEnabled)())
+        return false;
+    const wsUrl = (0, config_1.getWsUrl)();
+    if (!wsUrl) {
+        throw new Error('setSdkConfig({ eventsListener: true }) requires a wsUrl. ' +
+            'Set both fields together, or leave eventsListener unset for HTTP-only mode.');
+    }
+    if (singletonStarted) {
+        await singletonStarted;
+        return true;
+    }
+    const listener = getSingleton();
+    singletonStarted = listener.start({
+        rpcSubscriptions: (0, kit_1.createSolanaRpcSubscriptions)(wsUrl),
+    });
+    await singletonStarted;
+    return true;
+}
+function onSrslyEvent(name, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+handler) {
+    const off = getSingleton().on(name, handler);
+    // Fire-and-forget: kick off the WS subscription if configured. We don't
+    // block the caller on the connect — events that arrive before the socket
+    // is ready are simply not seen, which matches existing kit semantics.
+    void ensureLiveStream();
+    return off;
+}
+/**
+ * Pull and parse SRSLY events from a single confirmed transaction signature.
+ * Uses the `rpcUrl` from `setSdkConfig` unless an override is passed.
+ *
+ * Dispatches into the same singleton handler registry that `onSrslyEvent`
+ * subscribes to — so a handler registered once will fire for both live
+ * events and per-signature lookups.
+ *
+ * @example Right after submitting an instruction
+ * ```ts
+ * const ixs = await acceptRental(params);
+ * const sig = await wallet.sendAndConfirm(ixs);
+ * const events = await getEventsFromTx(sig);
+ * const accepted = events.find(e => e.type === 'RentalAccepted');
+ * ```
+ */
+async function getEventsFromTx(signature, opts = {}) {
+    const rpc = (0, kit_1.createSolanaRpc)(opts.rpcUrl ?? (0, config_1.getRpcUrl)());
+    return getSingleton().process(signature, { rpc, commitment: opts.commitment });
+}
+/**
+ * Tear down the singleton listener, close the WS subscription if open, and
+ * clear all handlers. Call this in test teardown or app shutdown — most apps
+ * never need to.
+ */
+async function closeSrslyEventListener() {
+    if (!singleton)
+        return;
+    await singleton.close();
+    singleton = null;
+    singletonStarted = null;
+}
+//# sourceMappingURL=listener.js.map

package/dist/cjs/audit/listener.js.map

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

package/dist/cjs/kit/index.js

@@ -52,7 +52,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.audit = exports.codama = exports.claim = exports.VERSION = void 0;
+exports.onSrslyEvent = exports.getEventsFromTx = exports.events = exports.closeSrslyEventListener = exports.audit = exports.codama = exports.claim = exports.VERSION = void 0;
 var version_1 = require("../version");
 Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });
 __exportStar(require("../utils"), exports);
@@ -66,4 +66,13 @@ var vault_1 = require("@sly-rentals/vault");
 Object.defineProperty(exports, "claim", { enumerable: true, get: function () { return vault_1.claim; } });
 exports.codama = __importStar(require("../generated/codama"));
 exports.audit = __importStar(require("../audit"));
+// Event listener helpers — bubbled up from `audit` so consumers can write
+// `import { events, onSrslyEvent, getEventsFromTx } from '@sly-rentals/core'`
+// without the audit namespace prefix. The full audit module is still
+// accessible via `audit.*` for the parser primitives + report builder.
+var audit_1 = require("../audit");
+Object.defineProperty(exports, "closeSrslyEventListener", { enumerable: true, get: function () { return audit_1.closeSrslyEventListener; } });
+Object.defineProperty(exports, "events", { enumerable: true, get: function () { return audit_1.events; } });
+Object.defineProperty(exports, "getEventsFromTx", { enumerable: true, get: function () { return audit_1.getEventsFromTx; } });
+Object.defineProperty(exports, "onSrslyEvent", { enumerable: true, get: function () { return audit_1.onSrslyEvent; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/kit/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kit/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,sCAAqC;AAA5B,kGAAA,OAAO,OAAA;AAChB,2CAAyB;AACzB,kDAAgC;AAChC,8CAA4B;AAC5B,4CAA0B;AAC1B,yCAAuB;AACvB,0CAAwB;AAExB,sBAAsB;AACtB,4CAA6D;AAApD,8FAAA,KAAK,OAAA;AAEd,8DAA8C;AAC9C,kDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kit/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,sCAAqC;AAA5B,kGAAA,OAAO,OAAA;AAChB,2CAAyB;AACzB,kDAAgC;AAChC,8CAA4B;AAC5B,4CAA0B;AAC1B,yCAAuB;AACvB,0CAAwB;AAExB,sBAAsB;AACtB,4CAA6D;AAApD,8FAAA,KAAK,OAAA;AAEd,8DAA8C;AAC9C,kDAAkC;AAElC,0EAA0E;AAC1E,8EAA8E;AAC9E,qEAAqE;AACrE,uEAAuE;AACvE,kCAA0F;AAAjF,gHAAA,uBAAuB,OAAA;AAAE,+FAAA,MAAM,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,qGAAA,YAAY,OAAA"}

package/dist/cjs/legacy/index.js

@@ -59,7 +59,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.claim = exports.updateAffiliate = exports.removeAffiliate = exports.approveAffiliate = exports.createAffiliate = exports.deleteConfig = exports.updateConfig = exports.createConfig = exports.updateContractThread = exports.closeContractThread = exports.createContractThread = exports.claimContract = exports.deleteBorrower = exports.createBorrower = exports.closeBorrower = exports.claimBorrower = exports.deleteRental = exports.reserveRental = exports.invalidateRental = exports.releaseRental = exports.closeRental = exports.cancelRental = exports.acceptRental = exports.setDelegate = exports.deleteContract = exports.closeContract = exports.updateContract = exports.createContract = exports.codama = exports.VERSION = void 0;
+exports.claim = exports.updateAffiliate = exports.removeAffiliate = exports.approveAffiliate = exports.createAffiliate = exports.deleteConfig = exports.updateConfig = exports.createConfig = exports.updateContractThread = exports.closeContractThread = exports.createContractThread = exports.claimContract = exports.deleteBorrower = exports.createBorrower = exports.closeBorrower = exports.claimBorrower = exports.deleteRental = exports.reserveRental = exports.invalidateRental = exports.releaseRental = exports.closeRental = exports.cancelRental = exports.acceptRental = exports.setDelegate = exports.deleteContract = exports.closeContract = exports.updateContract = exports.createContract = exports.onSrslyEvent = exports.getEventsFromTx = exports.events = exports.closeSrslyEventListener = exports.audit = exports.codama = exports.VERSION = void 0;
 const utils_1 = require("../utils");
 const kit = __importStar(require("../instructions"));
 const vault_1 = require("@sly-rentals/vault");
@@ -71,6 +71,12 @@ __exportStar(require("../pda"), exports);
 var version_1 = require("../version");
 Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });
 exports.codama = __importStar(require("../generated/codama"));
+exports.audit = __importStar(require("../audit"));
+var audit_1 = require("../audit");
+Object.defineProperty(exports, "closeSrslyEventListener", { enumerable: true, get: function () { return audit_1.closeSrslyEventListener; } });
+Object.defineProperty(exports, "events", { enumerable: true, get: function () { return audit_1.events; } });
+Object.defineProperty(exports, "getEventsFromTx", { enumerable: true, get: function () { return audit_1.getEventsFromTx; } });
+Object.defineProperty(exports, "onSrslyEvent", { enumerable: true, get: function () { return audit_1.onSrslyEvent; } });
 /**
  * Wrapper that checks for PublicKey and provides helpful error
  */

package/dist/cjs/legacy/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/legacy/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,oCAAwF;AACxF,qDAAuC;AACvC,8CAA4D;AAE5D,oDAAoD;AACpD,2CAAyB;AACzB,8CAA4B;AAC5B,4CAA0B;AAC1B,yCAAuB;AACvB,sCAAqC;AAA5B,kGAAA,OAAO,OAAA;AAChB,8DAA8C;AAM9C;;GAEG;AACH,SAAS,UAAU,CACjB,EAAkD;IAElD,OAAO,KAAK,EAAE,GAAG,IAAW,EAAgC,EAAE;QAC5D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACjC,MAAM,EAAE,GAAG,IAAA,oBAAY,GAAE,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CACb,8DAA8D;gBAC5D,iCAAiC;gBACjC,kDAAkD;gBAClD,8DAA8D;gBAC9D,gCAAgC,CACnC,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,GAAG,UAAU,CAAC;AAErB,+DAA+D;AAClD,QAAA,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACvC,QAAA,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACvC,QAAA,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACrC,QAAA,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACvC,QAAA,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACjC,QAAA,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACnC,QAAA,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACnC,QAAA,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACjC,QAAA,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACrC,QAAA,gBAAgB,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC3C,QAAA,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACrC,QAAA,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACnC,QAAA,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACrC,QAAA,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACrC,QAAA,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACvC,QAAA,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACvC,QAAA,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACrC,QAAA,oBAAoB,GAAG,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACnD,QAAA,mBAAmB,GAAG,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACjD,QAAA,oBAAoB,GAAG,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACnD,QAAA,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACnC,QAAA,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACnC,QAAA,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACnC,QAAA,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AACzC,QAAA,gBAAgB,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC3C,QAAA,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AACzC,QAAA,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AACzC,QAAA,KAAK,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/legacy/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sly-rentals/core",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "TypeScript SDK for SRSLY",
   "sideEffects": false,
   "publishConfig": {

package/dist/cjs/utils/config.js

@@ -11,6 +11,8 @@ exports.getSdkConfig = getSdkConfig;
 exports.clearSdkConfig = clearSdkConfig;
 exports.mergeConfig = mergeConfig;
 exports.getRpcUrl = getRpcUrl;
+exports.getWsUrl = getWsUrl;
+exports.isEventsListenerEnabled = isEventsListenerEnabled;
 exports.getProgramId = getProgramId;
 exports.getCommitment = getCommitment;
 exports.getAffiliateConfig = getAffiliateConfig;
@@ -128,6 +130,20 @@ function getRpcUrl(config) {
         ALIAS_RPC_URLS[finalConfig.programs] ||
         DEFAULT_RPC_URLS[addresses_1.DEVNET_GENESIS]);
 }
+/**
+ * Get the effective WebSocket URL, if any. Returns `undefined` when neither
+ * the global config nor the override sets one.
+ */
+function getWsUrl(config) {
+    return mergeConfig(config).wsUrl;
+}
+/**
+ * Returns whether the singleton SRSLY event listener should auto-start.
+ * Defaults to `false` if unset.
+ */
+function isEventsListenerEnabled(config) {
+    return mergeConfig(config).eventsListener === true;
+}
 /**
  * Get the effective program ID for a configuration
  *

package/dist/cjs/utils/config.js.map

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

package/dist/cjs/version.js

@@ -3,5 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 // Auto-generated from package.json - DO NOT EDIT
 // Run "pnpm run generate:version" to update
-exports.VERSION = '1.0.0';
+exports.VERSION = '1.1.0';
 //# sourceMappingURL=version.js.map

package/dist/esm/audit/events-registry.js

@@ -0,0 +1,83 @@
+/**
+ * Typed namespace tree for the SRSLY event listener.
+ *
+ * Built once from a const manifest mapping each event's IDL name to a
+ * `{ group, verb }` pair. The TypeScript type derives the entire dotted
+ * namespace shape from that manifest, so consumers get autocomplete on
+ * every event without us hand-rolling an interface — and adding a new
+ * event in the future only requires:
+ *
+ *   1. Append a row to `EVENT_MANIFEST`.
+ *   2. Add a decoder in `events.ts`.
+ *   3. Extend the `AuditEvent` union in `types.ts`.
+ *
+ * The runtime tree is generated alongside the type so they can never drift.
+ */
+import { onSrslyEvent } from './listener';
+// Single source of truth — tuple form keeps the type literal so we can
+// derive the namespace shape at the type level. Order: [IDL name, group,
+// verb]. New events extend by appending here.
+const EVENT_MANIFEST = [
+    ['RentalAccepted', 'rental', 'accepted'],
+    ['RentalSettled', 'rental', 'settled'],
+    ['RentalCancelled', 'rental', 'cancelled'],
+    ['RentalClosed', 'rental', 'closed'],
+    ['OwnerPaid', 'owner', 'paid'],
+    ['FeesPaid', 'fees', 'paid'],
+];
+function nameChannel(name) {
+    return {
+        on: handler => onSrslyEvent(name, handler),
+    };
+}
+function allChannel() {
+    return {
+        on: handler => onSrslyEvent('*', handler),
+    };
+}
+function groupChannel(group) {
+    // Group-level "all" filters the global stream by manifest membership so a
+    // handler registered on `events.rental.all` only sees rental events even
+    // if a new top-level event ships later.
+    const memberNames = new Set(EVENT_MANIFEST.filter(([, g]) => g === group).map(([n]) => n));
+    return {
+        on: handler => {
+            return onSrslyEvent('*', evt => {
+                if (memberNames.has(evt.type))
+                    handler(evt);
+            });
+        },
+    };
+}
+function buildTree() {
+    // Object literal — typed loosely while building, asserted to the derived
+    // tree shape at the end. Shape is guaranteed by the manifest iteration.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const tree = { all: allChannel() };
+    for (const [name, group, verb] of EVENT_MANIFEST) {
+        if (!tree[group])
+            tree[group] = { all: groupChannel(group) };
+        tree[group][verb] = nameChannel(name);
+    }
+    return tree;
+}
+/**
+ * Typed event tree. Use the deepest path you need — the handler arg is
+ * narrowed accordingly:
+ *
+ * @example
+ * ```ts
+ * import { events } from '@sly-rentals/core';
+ *
+ * // Single event
+ * events.rental.accepted.on(evt => evt.escrow);
+ *
+ * // Group-scoped catch-all
+ * events.rental.all.on(evt => evt.type);   // 'RentalAccepted' | 'RentalSettled' | …
+ *
+ * // Global catch-all
+ * events.all.on(evt => evt.signature);
+ * ```
+ */
+export const events = buildTree();
+//# sourceMappingURL=events-registry.js.map

package/dist/esm/audit/events-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-registry.js","sourceRoot":"","sources":["../../../src/audit/events-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI1C,uEAAuE;AACvE,yEAAyE;AACzE,8CAA8C;AAC9C,MAAM,cAAc,GAAG;IACrB,CAAC,gBAAgB,EAAE,QAAQ,EAAE,UAAU,CAAC;IACxC,CAAC,eAAe,EAAE,QAAQ,EAAE,SAAS,CAAC;IACtC,CAAC,iBAAiB,EAAE,QAAQ,EAAE,WAAW,CAAC;IAC1C,CAAC,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACpC,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC;IAC9B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC;CACpB,CAAC;AAsCX,SAAS,WAAW,CAAC,IAAoB;IACvC,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,IAAa,EAAE,OAAgB,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,UAAU;IACjB,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAiB;IACrC,0EAA0E;IAC1E,yEAAyE;IACzE,wCAAwC;IACxC,MAAM,WAAW,GAAgB,IAAI,GAAG,CACtC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAC9D,CAAC;IACF,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;YACZ,OAAO,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE;gBAC7B,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS;IAChB,yEAAyE;IACzE,wEAAwE;IACxE,8DAA8D;IAC9D,MAAM,IAAI,GAAwB,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,cAAc,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAsB,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAkB,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAe,SAAS,EAAE,CAAC"}

package/dist/esm/audit/index.js

@@ -1,3 +1,5 @@
 export { fetchContractAudit } from './audit';
 export { parseAnchorEvents } from './events';
+export { closeSrslyEventListener, createSrslyEventListener, getEventsFromTx, onSrslyEvent, } from './listener';
+export { events } from './events-registry';
 //# sourceMappingURL=index.js.map

package/dist/esm/audit/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/audit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/audit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}