@cotal-ai/core 0.115.0 → 0.115.2

package/dist/endpoint.js

@@ -2159,7 +2159,7 @@ export class CotalEndpoint extends EventEmitter {
      *  other requests. */
     serveControl(service, handler, opts = {}) {
         if (!this.nc)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         const sub = this.nc.subscribe(controlServiceSubject(this.space, service, "*", "*"), {
             queue: service,
         });
@@ -3001,7 +3001,7 @@ export class CotalEndpoint extends EventEmitter {
      *  two names look alike, so this one is explicitly "feed". Read-only here; agents hold no grant. */
     async membershipFeedRegistry() {
         if (!this.nc)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         this.membershipFeedKv ??= await new Kvm(this.nc).open(membershipBucket(this.space));
         return this.membershipFeedKv;
     }
@@ -3277,7 +3277,7 @@ export class CotalEndpoint extends EventEmitter {
         if (!Number.isSafeInteger(limit) || limit < 1 || limit > 1000)
             throw new Error("channelHistoryPage limit must be a whole number from 1 to 1000");
         if (!this.nc || !this.js)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         const jsm = this.jsm ??= await jetstreamManager(this.nc);
         const signal = AbortSignal.any([AbortSignal.timeout(10_000), ...(opts?.signal ? [opts.signal] : [])]);
         signal.throwIfAborted();
@@ -3518,7 +3518,7 @@ export class CotalEndpoint extends EventEmitter {
      */
     async streamHistory(stream, subjects, limit, before, signal) {
         if (!this.nc)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         signal?.throwIfAborted();
         // A LIMIT THAT IS NOT A FINITE NUMBER HAS NO ANSWER, AND THE SEARCH BELOW CANNOT REFUSE IT.
         // Every comparison against NaN is false, so `limit <= 0` does not fire for one, and neither of
@@ -4060,7 +4060,7 @@ export class CotalEndpoint extends EventEmitter {
      *  the same definitions are used by `cotal up` at privileged setup. */
     async ensureStreams() {
         if (!this.jsm)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         await createSpaceStreams(this.jsm, this.space);
     }
     // (v3) The old `provisionMembership` — manager/provisioner-written boot membership at spawn — is GONE.
@@ -4159,7 +4159,7 @@ export class CotalEndpoint extends EventEmitter {
     /** Lazily open the privileged members registry KV (delivery daemon / open-mode self). */
     async membersRegistry() {
         if (!this.nc)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         this.membersKv ??= await openMembersRegistry(this.nc, this.space);
         return this.membersKv;
     }
@@ -4167,7 +4167,7 @@ export class CotalEndpoint extends EventEmitter {
      *  ACL at mint); the delivery daemon reads it fresh per durable entry to re-authorize. */
     async aclRegistry() {
         if (!this.nc)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         this.aclKv ??= await openAclRegistry(this.nc, this.space);
         return this.aclKv;
     }
@@ -4211,7 +4211,7 @@ export class CotalEndpoint extends EventEmitter {
     /** Lazily open the delivery lease/readiness KV (pre-created at `cotal up`; bind, never create). */
     async deliveryRegistry() {
         if (!this.nc)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         this.deliveryKv ??= await openDeliveryRegistry(this.nc, this.space);
         return this.deliveryKv;
     }
@@ -4456,7 +4456,7 @@ export class CotalEndpoint extends EventEmitter {
      *  as "lease held". */
     async managerLeaseRegistry() {
         if (!this.nc)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         if (this.managerLeaseKv)
             return this.managerLeaseKv;
         // A JetStream client of its own, so every operation on this bucket carries the lease budget's
@@ -4741,7 +4741,7 @@ export class CotalEndpoint extends EventEmitter {
      */
     async durableJoinFor(owner, channel, lifecycleUid, opts = {}) {
         if (!this.js)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         await this.manager(); // ensure jsm — a non-consuming provisioner inits it lazily; catch-up + fence need it
         const kv = await this.membersRegistry();
         const existing = await readMember(kv, channel, owner, lifecycleUid);
@@ -4915,7 +4915,7 @@ export class CotalEndpoint extends EventEmitter {
      *  is required, not optional (the responder would otherwise be lost on a broker blip). */
     async startPlane3(aclFor, opts = {}) {
         if (!this.js)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         this.plane3 = { aclFor, reloadMembershipCreds: opts.reloadMembershipCreds, evictPrincipal: opts.evictPrincipal, evictPrincipals: opts.evictPrincipals, planeConnLiveness: opts.planeConnLiveness, principalLiveness: opts.principalLiveness, reloadStoreIdentity: opts.reloadStoreIdentity, onDeliveryCredsAdopted: opts.onDeliveryCredsAdopted, startupComplete: opts.startupComplete };
         await this.armPlane3();
     }
@@ -5350,7 +5350,7 @@ export class CotalEndpoint extends EventEmitter {
      *  call for the same plane replaces the first. */
     serveLiveness(plane, readState) {
         if (!this.nc)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         const held = this.livenessResponders.get(plane);
         if (held)
             held.readState = readState;
@@ -6216,14 +6216,14 @@ export class CotalEndpoint extends EventEmitter {
      *  consume:false) can still pre-create others' durables. */
     async manager() {
         if (!this.nc)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         this.jsm ??= await jetstreamManager(this.nc);
         return this.jsm;
     }
     /** Bind this endpoint's durable consumers: DM inbox, chat, and (if a role) the task queue. */
     async startConsumers() {
         if (!this.jsm)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         // Unicast: this instance's private DM inbox, keyed on this endpoint's owner+actor principal. Open
         // mode self-creates; auth mode BINDS a durable the provisioner pre-created (agents are denied
         // CONSUMER.CREATE on DM_<space>, since the create-time filter_subject is the attack surface).
@@ -6283,7 +6283,7 @@ export class CotalEndpoint extends EventEmitter {
      *  and acking one unseen on the work queue would delete the only copy of the request. */
     async pump(stream, durable, opts = {}) {
         if (!this.js)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         const consumer = await this.js.consumers.get(stream, durable);
         const ackWaitMs = await ackWaitOf(consumer);
         const msgs = await consumer.consume();
@@ -6393,7 +6393,7 @@ export class CotalEndpoint extends EventEmitter {
      *  of one, and the next copy reaches the handler only after the previous handler settles. */
     async bindDmOnly(mode) {
         if (!this.js)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         const stream = dmStream(this.space);
         const durable = dmDurable(this.owner, this.actor, this.requireLifecycleUid("consuming the DM inbox"));
         let consumer;
@@ -6560,7 +6560,7 @@ export class CotalEndpoint extends EventEmitter {
      *  and exposes the current `filter_subjects` for restart reconciliation. */
     async consumerInfo(stream, durable) {
         if (!this.jsm)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         try {
             return await this.jsm.consumers.info(stream, durable);
         }
@@ -6573,7 +6573,7 @@ export class CotalEndpoint extends EventEmitter {
     /** Delete one named consumer, swallowing ONLY structured consumer/stream absence. */
     async deleteConsumerIfPresent(stream, durable) {
         if (!this.jsm)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         try {
             await this.jsm.consumers.delete(stream, durable);
         }
@@ -6662,7 +6662,7 @@ export class CotalEndpoint extends EventEmitter {
     }
     async collectHistoryInner(subject, start, opts = {}) {
         if (!this.jsm || !this.js)
-            throw new Error("endpoint not started");
+            throw new Error(this.notLiveMsg());
         const stream = chatStream(this.space);
         const name = chatHistDurable(this.owner, this.actor, this.requireLifecycleUid("chat history reads"));
         const out = [];