@openrig/cli 0.6.11 → 0.6.13

package/daemon/dist/domain/provider/usage-windows.d.ts

@@ -0,0 +1,113 @@
+import type { ProviderKind, ProviderUsageAllowance, UsageRefreshOutcome, UsageWindowRow } from "./provider-types.js";
+/** A reading is too old to claim current capacity after this (Ops' openrig.subscription-usage.v1 rule). */
+export declare const USAGE_FRESH_FOR_MS: number;
+/** An observation up to this far in the future is clock skew within tolerance (same rule). */
+export declare const USAGE_CLOCK_TOLERANCE_MS = 60000;
+/** Whether two readings' reset times name the same window: equal, or within the clock tolerance. */
+export declare function sameReset(a: string | null, b: string | null): boolean;
+/** Unresolved observations can't be matched to earlier ones, so each read adds its own rows. Keep those
+ *  from the most recent few reads: enough to compare the latest with the two before it, and bounded
+ *  because nothing else ever removes them. */
+export declare const UNRESOLVED_READS_KEPT = 3;
+export interface UsageReadWindow {
+    /** The provider-native window name. */
+    window: string;
+    durationMins: number | null;
+    usedPercent: number | null;
+    resetsAt: string | null;
+}
+export interface UsageReading<I> {
+    identity: I;
+    windows: UsageReadWindow[];
+    limitEvidence: string | null;
+    observedAt: string;
+}
+/** A reader's outcome: the raw answers on success (normalizing is the provider spec's job), or a named failure. */
+export type UsageReadOutcome<R> = ({
+    ok: true;
+    observedAt: string;
+} & R) | {
+    ok: false;
+    at: string;
+    reason: string;
+    detail: string;
+};
+export interface UsageWindowsSpec<I extends {
+    source: string;
+}, R> {
+    provider: ProviderKind;
+    sourceKind: ProviderUsageAllowance["source"]["kind"];
+    read: () => Promise<UsageReadOutcome<R>>;
+    normalize: (answer: R & {
+        observedAt: string;
+    }) => {
+        ok: true;
+        readings: Array<UsageReading<I>>;
+    } | {
+        ok: false;
+        detail: string;
+    };
+    /** The replacement key of a resolved identity; null when unresolved (never matched or replaced). */
+    key: (identity: I) => string | null;
+    now?: () => string;
+    /** Durable readings, keyed by `key`. Absent: memory only (a restart starts empty). */
+    store?: UsageReadingStore<I>;
+}
+/** The durable half: what a restart reloads, and each allowance's last observed exhaustion. */
+export interface UsageReadingStore<I> {
+    record(key: string, reading: UsageReading<I>): void;
+    latestAll(): Array<{
+        key: string;
+        reading: UsageReading<I>;
+    }>;
+    lastExhaustion(key: string): {
+        at: string;
+        window: string | null;
+        evidence: string;
+    } | null;
+}
+/** The planning fact for a window whose reset has passed. */
+export declare const EXPECTED_FULL_NOTE = "planning, not a reading: expected to have been replenished at its reset; current remaining isn't observed, and use since the reset is unknown";
+export interface UsageRefreshResult {
+    refresh: UsageRefreshOutcome & {
+        coalesced: boolean;
+    };
+}
+/** Freshness is aged from the window's own observation, never from the time of the request. A row a later
+ *  read superseded is stale whatever its age. */
+export declare function usageFreshness(observedAt: string, now: string, failedAfter: {
+    at: string;
+} | null, superseded?: boolean): Pick<UsageWindowRow, "freshness" | "freshnessReason">;
+/** Level of one window as of its observation. Absent data is never nearing or exhausted. */
+export declare function usageLevel(window: UsageReadWindow, limitEvidence: string | null, now: string): Pick<UsageWindowRow, "level" | "levelReason">;
+export declare const UNRESOLVED_NOTE = "identity unresolved: not matched to, merged with or replacing any other row";
+export declare const UNRESOLVED_EARLIER_NOTE = "identity unresolved: from an earlier read, possibly this same login; not matched to, merged with or replacing any other row";
+export declare class UsageWindows<I extends {
+    source: string;
+}, R> {
+    private readonly spec;
+    private readonly now;
+    private readonly startedAt;
+    private readonly readings;
+    /** Each stored allowance's last observed exhaustion, set at load and on each record, so a projection reads no store. */
+    private readonly exhaustion;
+    /** Unresolved observations, grouped by read, newest last; at most UNRESOLVED_READS_KEPT reads. */
+    private unresolved;
+    private unresolvedDropped;
+    private lastRefresh;
+    private inflight;
+    constructor(spec: UsageWindowsSpec<I, R>);
+    /** One bounded read. A refresh asked for while one runs joins it; one asked for after it ends reads again. */
+    refresh(): Promise<UsageRefreshResult>;
+    private runRead;
+    /** The sign-in fact for a row, from the last refresh only (never from its windows). Only the latest read's row is the
+     *  login the refresh read. */
+    private signIn;
+    /** The daemon's current home when the last refresh found no signed-in account but earlier rows are kept: its own row,
+     *  in the shape the projection already serves with no reading, so the fact isn't pinned on an earlier account. */
+    private homeRow;
+    private recordFailure;
+    /** The served rows. Reads memory only: it never starts a native read. */
+    project(now: string): ProviderUsageAllowance[];
+}
+//# sourceMappingURL=usage-windows.d.ts.map

package/daemon/dist/domain/provider/usage-windows.d.ts.map

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

package/daemon/dist/domain/provider/usage-windows.js

@@ -0,0 +1,285 @@
+// Slice 01 (OPR.0.7.0.1) — usage windows for the provider view, shared by every provider's native
+// reader. Holds each provider's last reading in memory, refreshes it only on request (one bounded read;
+// matching overlapping requests share it), and projects rows keyed by allowance identity with freshness
+// kept separate from level. A failed refresh never replaces a reading: the reading stays, with its own
+// time, marked old beside the failure. A row a later read superseded ages to stale. With a store, each resolved
+// reading is kept on disk, so a daemon restart starts from the last readings, marked as from before the restart.
+import { NEARING_THRESHOLD_PERCENT } from "./host-usage-rollup.js";
+/** A reading is too old to claim current capacity after this (Ops' openrig.subscription-usage.v1 rule). */
+export const USAGE_FRESH_FOR_MS = 15 * 60_000;
+/** An observation up to this far in the future is clock skew within tolerance (same rule). */
+export const USAGE_CLOCK_TOLERANCE_MS = 60_000;
+/** Whether two readings' reset times name the same window: equal, or within the clock tolerance. */
+export function sameReset(a, b) {
+    if (a === null || b === null)
+        return a === b;
+    const am = Date.parse(a), bm = Date.parse(b);
+    return Number.isFinite(am) && Number.isFinite(bm) ? Math.abs(am - bm) <= USAGE_CLOCK_TOLERANCE_MS : a === b;
+}
+/** Unresolved observations can't be matched to earlier ones, so each read adds its own rows. Keep those
+ *  from the most recent few reads: enough to compare the latest with the two before it, and bounded
+ *  because nothing else ever removes them. */
+export const UNRESOLVED_READS_KEPT = 3;
+/** The planning fact for a window whose reset has passed. */
+export const EXPECTED_FULL_NOTE = "planning, not a reading: expected to have been replenished at its reset; current remaining isn't observed, and use since the reset is unknown";
+/** Freshness is aged from the window's own observation, never from the time of the request. A row a later
+ *  read superseded is stale whatever its age. */
+export function usageFreshness(observedAt, now, failedAfter, superseded = false) {
+    const observedMs = Date.parse(observedAt);
+    const nowMs = Date.parse(now);
+    if (!Number.isFinite(observedMs) || !Number.isFinite(nowMs)) {
+        return { freshness: "unavailable", freshnessReason: "observation time unreadable" };
+    }
+    if (observedMs - nowMs > USAGE_CLOCK_TOLERANCE_MS) {
+        return { freshness: "unavailable", freshnessReason: "observed in the future beyond the 60 s clock tolerance" };
+    }
+    if (superseded)
+        return { freshness: "stale", freshnessReason: "a later read exists" };
+    if (failedAfter)
+        return { freshness: "stale", freshnessReason: `refresh failed at ${failedAfter.at}; this reading is older` };
+    if (nowMs - observedMs > USAGE_FRESH_FOR_MS) {
+        return { freshness: "stale", freshnessReason: `observed ${Math.round((nowMs - observedMs) / 60_000)} min ago (fresh for 15 min)` };
+    }
+    return { freshness: "fresh" };
+}
+/** Level of one window as of its observation. Absent data is never nearing or exhausted. */
+export function usageLevel(window, limitEvidence, now) {
+    if (window.usedPercent === null)
+        return { level: "unknown", levelReason: "no usage reported for this window" };
+    const resetMs = window.resetsAt === null ? NaN : Date.parse(window.resetsAt);
+    const nowMs = Date.parse(now);
+    if (Number.isFinite(resetMs) && Number.isFinite(nowMs) && nowMs >= resetMs) {
+        return { level: "unknown", levelReason: `reset passed at ${window.resetsAt}; a new reading is needed` };
+    }
+    if (window.usedPercent >= 100)
+        return { level: "exhausted", levelReason: "at the limit" };
+    if (limitEvidence !== null)
+        return { level: "exhausted", levelReason: `provider limit evidence: ${limitEvidence}` };
+    if (window.usedPercent >= NEARING_THRESHOLD_PERCENT)
+        return { level: "nearing", levelReason: `${NEARING_THRESHOLD_PERCENT}% or more used` };
+    return { level: "ok" };
+}
+/** Whether a window's known reset has passed. No reset, no expectation: one is never invented. */
+function resetPassed(resetsAt, now) {
+    if (resetsAt === null)
+        return false;
+    const reset = Date.parse(resetsAt), at = Date.parse(now);
+    return Number.isFinite(reset) && Number.isFinite(at) && at >= reset;
+}
+function safeLastExhaustion(store, key) {
+    try {
+        return store.lastExhaustion(key);
+    }
+    catch {
+        return null;
+    }
+}
+export const UNRESOLVED_NOTE = "identity unresolved: not matched to, merged with or replacing any other row";
+export const UNRESOLVED_EARLIER_NOTE = "identity unresolved: from an earlier read, possibly this same login; not matched to, merged with or replacing any other row";
+export class UsageWindows {
+    spec;
+    now;
+    startedAt;
+    readings = new Map();
+    /** Each stored allowance's last observed exhaustion, set at load and on each record, so a projection reads no store. */
+    exhaustion = new Map();
+    /** Unresolved observations, grouped by read, newest last; at most UNRESOLVED_READS_KEPT reads. */
+    unresolved = [];
+    unresolvedDropped = 0;
+    lastRefresh = null;
+    inflight = null;
+    constructor(spec) {
+        this.spec = spec;
+        this.now = spec.now ?? (() => new Date().toISOString());
+        this.startedAt = this.now();
+        // The last stored reading of each allowance, as history: never current until a fresh read.
+        try {
+            for (const { key, reading } of spec.store?.latestAll() ?? []) {
+                this.readings.set(key, { ...reading, latest: false, retained: true });
+                this.exhaustion.set(key, safeLastExhaustion(spec.store, key));
+            }
+        }
+        catch { /* an unreadable store starts empty, as before */ }
+    }
+    /** One bounded read. A refresh asked for while one runs joins it; one asked for after it ends reads again. */
+    async refresh() {
+        if (this.inflight)
+            return { refresh: { ...(await this.inflight), coalesced: true } };
+        const run = this.runRead();
+        this.inflight = run;
+        try {
+            return { refresh: { ...(await run), coalesced: false } };
+        }
+        finally {
+            if (this.inflight === run)
+                this.inflight = null;
+        }
+    }
+    async runRead() {
+        let outcome;
+        try {
+            outcome = await this.spec.read();
+        }
+        catch (error) {
+            outcome = { ok: false, at: this.now(), reason: "spawn_failed", detail: `the reader failed: ${error instanceof Error ? error.message : String(error)}` };
+        }
+        if (!outcome.ok)
+            return this.recordFailure(outcome.at, outcome.reason, outcome.detail);
+        const normalized = this.spec.normalize(outcome);
+        if (!normalized.ok)
+            return this.recordFailure(outcome.observedAt, "unrecognized_shape", normalized.detail);
+        for (const reading of [...this.readings.values(), ...this.unresolved.flat()])
+            reading.latest = false;
+        const unresolvedNow = [];
+        for (const reading of normalized.readings) {
+            const key = this.spec.key(reading.identity);
+            if (key === null)
+                unresolvedNow.push({ ...reading, latest: true });
+            else {
+                this.readings.set(key, { ...reading, latest: true });
+                // A storage failure never fails the read: the reading is still served from memory.
+                if (this.spec.store) {
+                    try {
+                        this.spec.store.record(key, reading);
+                    }
+                    catch { /* kept in memory */ }
+                    this.exhaustion.set(key, safeLastExhaustion(this.spec.store, key));
+                }
+            }
+        }
+        if (unresolvedNow.length > 0) {
+            this.unresolved.push(unresolvedNow);
+            while (this.unresolved.length > UNRESOLVED_READS_KEPT) {
+                this.unresolved.shift();
+                this.unresolvedDropped += 1;
+            }
+        }
+        this.lastRefresh = { at: outcome.observedAt, outcome: "ok" };
+        return this.lastRefresh;
+    }
+    /** The sign-in fact for a row, from the last refresh only (never from its windows). Only the latest read's row is the
+     *  login the refresh read. */
+    signIn(latest, unresolved = false, observedAt = null, retained = false) {
+        const last = this.lastRefresh;
+        // A row kept from before the restart: there may have been no refresh since, so it was superseded by nothing.
+        if (retained) {
+            return { state: "unknown", at: null,
+                evidence: `kept from before the daemon restarted at ${this.startedAt}; this login's sign-in hasn't been read since` };
+        }
+        if (!latest) {
+            // An unresolved earlier read can't be matched, so it may be this same login: never call it another one.
+            return { state: "unknown", at: null, evidence: unresolved
+                    ? "an earlier read not matched to the latest one (possibly this same login)"
+                    : "not the latest read: a later refresh didn't report this row (another login, one it couldn't identify, or this bucket no longer reported)" };
+        }
+        if (!last)
+            return { state: "unknown", evidence: `no refresh since the daemon started at ${this.startedAt}`, at: null };
+        if (last.outcome === "ok") {
+            return { state: "usable", evidence: "the refresh's rate-limit read was answered for this login (the daemon's CODEX_HOME)", at: last.at };
+        }
+        // A failure after this row's reading identified no account, so it says nothing about this row's login. The
+        // home it did read is reported on its own row (homeRow).
+        if (observedAt !== null) {
+            return { state: "unknown", at: last.at,
+                evidence: `the last refresh at ${last.at} failed (${last.reason ?? "unknown reason"}) and didn't identify an account; this row's login was last read at ${observedAt}` };
+        }
+        if (last.reason === "not_signed_in") {
+            return { state: "needs_sign_in", evidence: "the refresh's account/read reported no signed-in account", at: last.at };
+        }
+        return { state: "unknown", evidence: `the last refresh failed (${last.reason ?? "unknown reason"})`, at: last.at };
+    }
+    /** The daemon's current home when the last refresh found no signed-in account but earlier rows are kept: its own row,
+     *  in the shape the projection already serves with no reading, so the fact isn't pinned on an earlier account. */
+    homeRow(provider, source) {
+        const last = this.lastRefresh;
+        if (last?.outcome !== "failed" || last.reason !== "not_signed_in")
+            return null;
+        return {
+            provider, identity: null, source, observedAt: null, seats: "unknown", windows: [], limitEvidence: null,
+            latestFromSource: true, lastRefresh: last, currentAvailability: "unknown",
+            signIn: this.signIn(true),
+            unavailableReason: `the refresh at ${last.at} found no signed-in account in the daemon's CODEX_HOME; the rows above keep their earlier reads`,
+        };
+    }
+    recordFailure(at, reason, detail) {
+        this.lastRefresh = { at, outcome: "failed", reason, detail };
+        return this.lastRefresh;
+    }
+    /** The served rows. Reads memory only: it never starts a native read. */
+    project(now) {
+        const provider = this.spec.provider;
+        const source = { kind: this.spec.sourceKind, host: "local" };
+        const failure = this.lastRefresh?.outcome === "failed" ? this.lastRefresh : null;
+        if (this.readings.size === 0 && this.unresolved.length === 0) {
+            return [{
+                    provider,
+                    identity: null,
+                    source,
+                    observedAt: null,
+                    seats: "unknown",
+                    windows: [],
+                    limitEvidence: null,
+                    latestFromSource: false,
+                    lastRefresh: this.lastRefresh,
+                    currentAvailability: "unknown",
+                    signIn: this.signIn(true),
+                    unavailableReason: failure
+                        ? `refresh failed at ${failure.at}: ${failure.reason}; no earlier reading since the daemon started at ${this.startedAt}`
+                        : `no reading since the daemon started at ${this.startedAt}; refresh with rig provider status --refresh`,
+                }];
+        }
+        const rows = [];
+        const resolved = [...this.readings.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([, reading]) => reading);
+        for (const reading of [...resolved, ...this.unresolved.flat()]) {
+            const failedAfter = failure && Date.parse(failure.at) >= Date.parse(reading.observedAt) ? failure : null;
+            const key = this.spec.key(reading.identity);
+            // Every keyed reading is its allowance's latest known one; an unresolved earlier read may be a duplicate.
+            const expects = key !== null || reading.latest;
+            const windows = reading.windows.map((w) => ({
+                window: w.window,
+                durationMins: w.durationMins,
+                usedPercent: w.usedPercent,
+                remainingPercent: w.usedPercent === null ? null : Math.max(0, 100 - w.usedPercent),
+                resetsAt: w.resetsAt,
+                observedAt: reading.observedAt,
+                ...usageLevel(w, reading.limitEvidence, now),
+                ...(reading.retained
+                    ? { freshness: "stale", freshnessReason: `read at ${reading.observedAt}, before the daemon restarted at ${this.startedAt}; refresh with rig provider status --refresh` }
+                    : usageFreshness(reading.observedAt, now, failedAfter, !reading.latest)),
+                ...(expects && resetPassed(w.resetsAt, now) ? { expectation: { expectedFullSince: w.resetsAt, note: EXPECTED_FULL_NOTE } } : {}),
+            }));
+            const known = reading.latest && failedAfter === null && windows.length > 0
+                && windows.every((w) => w.freshness === "fresh" && w.level !== "unknown");
+            rows.push({
+                provider,
+                identity: reading.identity,
+                source,
+                observedAt: reading.observedAt,
+                seats: "unknown",
+                windows,
+                limitEvidence: reading.limitEvidence,
+                latestFromSource: reading.latest,
+                lastRefresh: this.lastRefresh,
+                currentAvailability: known ? "known" : "unknown",
+                ...(reading.retained ? { retained: "before_restart" } : {}),
+                accountHistory: key !== null ? "linked" : "unknown",
+                ...(this.spec.store && key !== null ? { lastObservedExhausted: this.exhaustion.get(key) ?? null } : {}),
+                ...(!reading.latest && key !== null ? { savedProfile: "not linked" } : {}),
+                signIn: this.signIn(reading.latest, reading.identity.source === "unresolved", reading.observedAt, reading.retained === true),
+                ...(reading.identity.source === "unresolved" ? {
+                    unresolved: {
+                        note: reading.latest ? UNRESOLVED_NOTE : UNRESOLVED_EARLIER_NOTE,
+                        keptReads: UNRESOLVED_READS_KEPT,
+                        droppedReads: this.unresolvedDropped,
+                    },
+                } : {}),
+            });
+        }
+        // Last, so the existing rows keep their order.
+        const home = this.homeRow(provider, source);
+        if (home)
+            rows.push(home);
+        return rows;
+    }
+}
+//# sourceMappingURL=usage-windows.js.map

package/daemon/dist/domain/provider/usage-windows.js.map

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

package/daemon/dist/domain/queue-owner.d.ts

@@ -9,4 +9,10 @@ export declare function resolveSessionNodeId(db: Database.Database, session: str
  *  outside the recorded topology, or a parent with no session binding, resolves to null
  *  (there is no orchestrator session to wake — never synthesize one). */
 export declare function defaultResolveOrchestrator(db: Database.Database, session: string): string | null;
+/** A rig's representative, the seat a person's message to "the rig" reaches: the rig's one
+ *  delegation root, the node that delegates to others and that nothing delegates to, at its
+ *  CURRENT canonical session binding. Null when the rig name is ambiguous or absent, when the rig
+ *  has no such root or several, or when the root has no session; the caller falls back to its
+ *  configured destination rather than guessing. */
+export declare function resolveRigRepresentative(db: Database.Database, rigName: string): string | null;
 //# sourceMappingURL=queue-owner.d.ts.map

package/daemon/dist/domain/queue-owner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue-owner.d.ts","sourceRoot":"","sources":["../../src/domain/queue-owner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C;;;sFAGsF;AACtF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK1F;AAED;;;yEAGyE;AACzE,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAahG"}
+{"version":3,"file":"queue-owner.d.ts","sourceRoot":"","sources":["../../src/domain/queue-owner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C;;;sFAGsF;AACtF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK1F;AAED;;;yEAGyE;AACzE,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAahG;AAED;;;;mDAImD;AACnD,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB9F"}

package/daemon/dist/domain/queue-owner.js

@@ -25,4 +25,26 @@ export function defaultResolveOrchestrator(db, session) {
         .get(nodeId);
     return row?.parentSession ?? null;
 }
+/** A rig's representative, the seat a person's message to "the rig" reaches: the rig's one
+ *  delegation root, the node that delegates to others and that nothing delegates to, at its
+ *  CURRENT canonical session binding. Null when the rig name is ambiguous or absent, when the rig
+ *  has no such root or several, or when the root has no session; the caller falls back to its
+ *  configured destination rather than guessing. */
+export function resolveRigRepresentative(db, rigName) {
+    const rigs = db.prepare("SELECT id FROM rigs WHERE name = ?").all(rigName);
+    if (rigs.length !== 1)
+        return null;
+    const roots = db
+        .prepare(`SELECT n.id AS nodeId FROM nodes n
+        WHERE n.rig_id = ?
+          AND EXISTS (SELECT 1 FROM edges e WHERE e.source_id = n.id AND e.kind = 'delegates_to')
+          AND NOT EXISTS (SELECT 1 FROM edges e WHERE e.target_id = n.id AND e.kind = 'delegates_to')`)
+        .all(rigs[0].id);
+    if (roots.length !== 1)
+        return null;
+    const row = db
+        .prepare("SELECT session_name FROM sessions WHERE node_id = ? ORDER BY id DESC LIMIT 1")
+        .get(roots[0].nodeId);
+    return row?.session_name ?? null;
+}
 //# sourceMappingURL=queue-owner.js.map

package/daemon/dist/domain/queue-owner.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue-owner.js","sourceRoot":"","sources":["../../src/domain/queue-owner.ts"],"names":[],"mappings":"AAEA;;;sFAGsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,EAAqB,EAAE,OAAe;IACzE,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,8EAA8E,CAAC;SACvF,GAAG,CAAC,OAAO,CAAoC,CAAC;IACnD,OAAO,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC;AAC9B,CAAC;AAED;;;yEAGyE;AACzE,MAAM,UAAU,0BAA0B,CAAC,EAAqB,EAAE,OAAe;IAC/E,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CACN;;;;gBAIU,CACX;SACA,GAAG,CAAC,MAAM,CAA0C,CAAC;IACxD,OAAO,GAAG,EAAE,aAAa,IAAI,IAAI,CAAC;AACpC,CAAC"}
+{"version":3,"file":"queue-owner.js","sourceRoot":"","sources":["../../src/domain/queue-owner.ts"],"names":[],"mappings":"AAEA;;;sFAGsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,EAAqB,EAAE,OAAe;IACzE,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,8EAA8E,CAAC;SACvF,GAAG,CAAC,OAAO,CAAoC,CAAC;IACnD,OAAO,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC;AAC9B,CAAC;AAED;;;yEAGyE;AACzE,MAAM,UAAU,0BAA0B,CAAC,EAAqB,EAAE,OAAe;IAC/E,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CACN;;;;gBAIU,CACX;SACA,GAAG,CAAC,MAAM,CAA0C,CAAC;IACxD,OAAO,GAAG,EAAE,aAAa,IAAI,IAAI,CAAC;AACpC,CAAC;AAED;;;;mDAImD;AACnD,MAAM,UAAU,wBAAwB,CAAC,EAAqB,EAAE,OAAe;IAC7E,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,CAAC,OAAO,CAA0B,CAAC;IACpG,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,KAAK,GAAG,EAAE;SACb,OAAO,CACN;;;sGAGgG,CACjG;SACA,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE,CAA8B,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,8EAA8E,CAAC;SACvF,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,CAAyC,CAAC;IACjE,OAAO,GAAG,EAAE,YAAY,IAAI,IAAI,CAAC;AACnC,CAAC"}