oc2token 0.1.0

package/dist/src/dashboard/state/refresh-coordinator.js

@@ -0,0 +1,346 @@
+import { createUsageWindows } from "../../domain/windows.js";
+import { RefreshScheduler, } from "../scheduler/refresh-scheduler.js";
+const REASON_PRIORITY = {
+    timer: 1,
+    wake: 2,
+    manual: 3,
+};
+function copyDate(date) {
+    return new Date(date.getTime());
+}
+function cancelledOutcome(generation, reason) {
+    return { kind: "cancelled", generation, reason };
+}
+/**
+ * Owns every visible refresh transition. Sources do not mutate dashboard
+ * state; they return one result which is committed only by its current
+ * generation.
+ */
+export class RefreshCoordinator {
+    source;
+    clock;
+    timezone;
+    project;
+    listeners = new Set();
+    scheduler;
+    cleanupTimeoutMilliseconds;
+    state;
+    active;
+    pendingReason;
+    pendingWaiters = [];
+    nextGeneration = 0;
+    started = false;
+    quitting = false;
+    startPromise;
+    configuredOnStateChange;
+    constructor(options) {
+        this.source = options.source;
+        this.clock = options.clock;
+        this.timezone = options.timezone;
+        this.project = options.project;
+        this.cleanupTimeoutMilliseconds = options.cleanupTimeoutMilliseconds ?? 250;
+        if (!Number.isFinite(this.cleanupTimeoutMilliseconds) || this.cleanupTimeoutMilliseconds < 0) {
+            throw new RangeError("cleanupTimeoutMilliseconds must be non-negative");
+        }
+        this.configuredOnStateChange = options.onStateChange;
+        this.state = {
+            status: "idle",
+            generation: 0,
+            stale: false,
+            period: options.initialPeriod ?? "day",
+            navigation: options.initialNavigation ?? {},
+            ...(options.initialSnapshot === undefined
+                ? {}
+                : {
+                    snapshot: options.initialSnapshot,
+                    lastGoodSnapshot: options.initialSnapshot,
+                    lastUpdated: new Date(options.initialSnapshot.capturedAt.getTime()),
+                    stale: true,
+                }),
+        };
+        this.scheduler = options.scheduler ?? new RefreshScheduler({
+            clock: options.clock,
+            refreshIntervalSeconds: options.refreshIntervalSeconds,
+            timers: options.timers,
+            onRequest: (reason) => this.handleScheduledRequest(reason),
+        });
+    }
+    get refreshScheduler() {
+        return this.scheduler;
+    }
+    get isRefreshing() {
+        return this.active !== undefined;
+    }
+    get isStopped() {
+        return this.quitting;
+    }
+    getState() {
+        // Dates are copied so a renderer cannot mutate coordinator state between
+        // event-loop turns. Result/navigation are owned by their immutable seams.
+        return {
+            ...this.state,
+            ...(this.state.lastUpdated === undefined
+                ? {}
+                : { lastUpdated: copyDate(this.state.lastUpdated) }),
+            ...(this.state.nextRefreshAt === undefined
+                ? {}
+                : { nextRefreshAt: this.state.nextRefreshAt }),
+            ...(this.active === undefined ? {} : { activeGeneration: this.active.generation }),
+            ...(this.scheduler.nextRefreshAt() === undefined
+                ? { nextRefreshAt: undefined, countdownSeconds: undefined }
+                : {
+                    nextRefreshAt: this.scheduler.nextRefreshAt(),
+                    countdownSeconds: this.scheduler.countdownSeconds(),
+                }),
+        };
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    setPeriod(period) {
+        this.state = { ...this.state, period };
+        this.emit();
+    }
+    setNavigation(navigation) {
+        this.state = { ...this.state, navigation };
+        this.emit();
+    }
+    get refreshIntervalSeconds() {
+        return this.scheduler.refreshIntervalSeconds
+            ?? this.scheduler.refreshIntervalSeconds
+            ?? 0;
+    }
+    setRefreshIntervalSeconds(seconds) {
+        if (this.scheduler.setRefreshIntervalSeconds === undefined) {
+            throw new Error("Scheduler does not support dynamic interval updates");
+        }
+        this.scheduler.setRefreshIntervalSeconds(seconds);
+        this.emit();
+    }
+    /** Start the scheduler and immediately issue exactly one initial refresh. */
+    start() {
+        if (this.started) {
+            return this.startPromise ?? Promise.resolve(cancelledOutcome(this.nextGeneration, "initial"));
+        }
+        this.started = true;
+        this.scheduler.start();
+        this.startPromise = this.begin("initial");
+        return this.startPromise;
+    }
+    /** Request a refresh; concurrent requests are reduced to one pending reason. */
+    request(reason = "manual") {
+        if (!this.started || this.quitting) {
+            return Promise.resolve(cancelledOutcome(this.nextGeneration, reason));
+        }
+        if (reason === "manual" || reason === "wake") {
+            this.scheduler.reset();
+        }
+        if (this.active !== undefined) {
+            if (reason === "initial") {
+                return this.active.promise;
+            }
+            this.pendingReason = this.mergePendingReason(this.pendingReason, reason);
+            this.state = { ...this.state, pendingReason: this.pendingReason };
+            this.emit();
+            return new Promise((resolve) => {
+                this.pendingWaiters.push({ resolve });
+            });
+        }
+        return this.begin(reason);
+    }
+    refresh() {
+        return this.request("manual");
+    }
+    manualRefresh() {
+        return this.request("manual");
+    }
+    wake() {
+        return this.request("wake");
+    }
+    /**
+     * Stop scheduling, invalidate the current generation, abort network work,
+     * and wait only briefly for sources which honor cancellation.
+     */
+    async quit() {
+        if (this.quitting) {
+            return;
+        }
+        this.quitting = true;
+        this.scheduler.stop();
+        this.nextGeneration += 1;
+        const active = this.active;
+        if (active !== undefined) {
+            active.controller.abort();
+        }
+        const cancelled = cancelledOutcome(this.nextGeneration, "manual");
+        for (const waiter of this.pendingWaiters) {
+            waiter.resolve(cancelled);
+        }
+        this.pendingWaiters = [];
+        this.pendingReason = undefined;
+        this.state = {
+            ...this.state,
+            status: "stopped",
+            generation: this.nextGeneration,
+            activeGeneration: undefined,
+            pendingReason: undefined,
+        };
+        this.emit();
+        if (active !== undefined) {
+            await this.waitForCleanup(active.promise);
+        }
+    }
+    begin(reason) {
+        if (this.quitting) {
+            return Promise.resolve(cancelledOutcome(this.nextGeneration, reason));
+        }
+        const generation = ++this.nextGeneration;
+        const controller = new AbortController();
+        const wallNow = copyDate(this.clock.wallNow());
+        const monotonicStartedAt = this.clock.monotonicNow();
+        const active = {
+            generation,
+            reason,
+            controller,
+            promise: Promise.resolve(cancelledOutcome(generation, reason)),
+        };
+        this.active = active;
+        this.state = {
+            ...this.state,
+            status: "refreshing",
+            generation,
+            activeGeneration: generation,
+            pendingReason: undefined,
+            // A previous result remains visible while the next one is loading.
+            stale: this.state.lastGoodSnapshot !== undefined,
+        };
+        this.emit();
+        active.promise = Promise.resolve()
+            .then(() => {
+            const request = {
+                generation,
+                reason,
+                wallNow,
+                monotonicStartedAt,
+                capturedAt: wallNow,
+                windows: Object.values(createUsageWindows(wallNow, this.timezone)),
+                ...(this.project === undefined ? {} : { project: this.project }),
+                includeSubagents: true,
+                includeProvisional: false,
+                signal: controller.signal,
+            };
+            return this.source.collect(request);
+        })
+            .then((result) => {
+            if (this.quitting ||
+                controller.signal.aborted ||
+                this.active !== active ||
+                this.nextGeneration !== generation) {
+                return { kind: "discarded", generation, reason };
+            }
+            const lastUpdated = copyDate(this.clock.wallNow());
+            this.state = {
+                ...this.state,
+                status: "ready",
+                generation,
+                activeGeneration: undefined,
+                snapshot: result,
+                lastGoodSnapshot: result,
+                lastUpdated,
+                lastError: undefined,
+                stale: false,
+            };
+            this.emit();
+            return { kind: "committed", generation, reason, result };
+        }, (error) => {
+            if (this.quitting ||
+                controller.signal.aborted ||
+                this.active !== active ||
+                this.nextGeneration !== generation) {
+                return { kind: "cancelled", generation, reason, error };
+            }
+            this.state = {
+                ...this.state,
+                status: "error",
+                generation,
+                activeGeneration: undefined,
+                // Keep the last good snapshot in both fields. A renderer can show
+                // the error without losing the most recent trustworthy totals.
+                snapshot: this.state.lastGoodSnapshot,
+                lastError: error,
+                stale: this.state.lastGoodSnapshot !== undefined,
+            };
+            this.emit();
+            return { kind: "failed", generation, reason, error };
+        })
+            .finally(() => {
+            if (this.active !== active) {
+                return;
+            }
+            this.active = undefined;
+            this.state = {
+                ...this.state,
+                activeGeneration: undefined,
+            };
+            this.emit();
+            if (!this.quitting && this.pendingReason !== undefined) {
+                const pendingReason = this.pendingReason;
+                const waiters = this.pendingWaiters;
+                this.pendingReason = undefined;
+                this.pendingWaiters = [];
+                this.state = { ...this.state, pendingReason: undefined };
+                this.emit();
+                void this.begin(pendingReason).then((outcome) => {
+                    for (const waiter of waiters) {
+                        waiter.resolve(outcome);
+                    }
+                });
+            }
+        });
+        return active.promise;
+    }
+    mergePendingReason(current, requested) {
+        if (current === undefined || REASON_PRIORITY[requested] > REASON_PRIORITY[current]) {
+            return requested;
+        }
+        return current;
+    }
+    handleScheduledRequest(reason) {
+        if (!this.started || this.quitting) {
+            return;
+        }
+        // Timer callbacks have no caller waiting for a Promise. Update the one
+        // pending reason in place so delayed wake/sleep periods cannot accumulate
+        // an unbounded waiter queue.
+        if (this.active !== undefined) {
+            this.pendingReason = this.mergePendingReason(this.pendingReason, reason);
+            this.state = { ...this.state, pendingReason: this.pendingReason };
+            this.emit();
+            return;
+        }
+        void this.request(reason);
+    }
+    async waitForCleanup(activePromise) {
+        let timeoutHandle;
+        const timeout = new Promise((resolve) => {
+            timeoutHandle = setTimeout(resolve, this.cleanupTimeoutMilliseconds);
+            if (timeoutHandle !== undefined && typeof timeoutHandle === "object" && "unref" in timeoutHandle) {
+                timeoutHandle.unref();
+            }
+        });
+        await Promise.race([activePromise.then(() => undefined), timeout]);
+        if (timeoutHandle !== undefined) {
+            clearTimeout(timeoutHandle);
+        }
+    }
+    emit() {
+        const next = this.getState();
+        this.configuredOnStateChange?.(next);
+        for (const listener of this.listeners) {
+            listener(next);
+        }
+    }
+}
+export { RefreshScheduler };
+//# sourceMappingURL=refresh-coordinator.js.map

package/dist/src/dashboard/state/refresh-coordinator.js.map

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

package/dist/src/dashboard/state/types.d.ts

@@ -0,0 +1,68 @@
+import type { Clock as DomainClock, CollectionRequest, CollectionResult, UsageSource as DomainUsageSource, UsageWindow, UsageWindowKind } from "../../domain/index.js";
+/** Reasons which can enter the refresh lifecycle. */
+export type RefreshReason = "initial" | "timer" | "manual" | "wake";
+/**
+ * The clock used by the dashboard. `wallNow` is for report windows and
+ * timestamps; `monotonicNow` is for scheduling and countdowns.
+ */
+export type Clock = DomainClock;
+/** The request handed to the usage source for one immutable generation. */
+export interface RefreshRequest extends CollectionRequest {
+    readonly generation: number;
+    readonly reason: RefreshReason;
+    readonly wallNow: Date;
+    readonly monotonicStartedAt: number;
+    readonly capturedAt: Date;
+    readonly windows: ReadonlyArray<UsageWindow>;
+    readonly signal: AbortSignal;
+}
+/**
+ * This is deliberately structural. The collector/domain seam can return its
+ * immutable CollectionResult directly, so the dashboard never knows how the
+ * result is assembled or persisted.
+ */
+export type UsageSource = DomainUsageSource;
+export type DashboardStatus = "idle" | "refreshing" | "ready" | "error" | "stopped";
+export interface DashboardNavigation {
+    readonly panel?: string;
+    readonly index?: number;
+    readonly scrollOffset?: number;
+    readonly [key: string]: unknown;
+}
+export interface RefreshState<Navigation = DashboardNavigation> {
+    readonly status: DashboardStatus;
+    readonly generation: number;
+    readonly activeGeneration?: number;
+    /** The latest successful result, retained while a refresh is in flight/fails. */
+    readonly snapshot?: CollectionResult;
+    readonly lastGoodSnapshot?: CollectionResult;
+    readonly lastUpdated?: Date;
+    readonly lastError?: unknown;
+    readonly stale: boolean;
+    readonly pendingReason?: Exclude<RefreshReason, "initial">;
+    readonly period: UsageWindowKind;
+    readonly navigation: Navigation;
+    /** Monotonic deadline; absent in manual-only mode. */
+    readonly nextRefreshAt?: number;
+    /** Whole seconds remaining, derived from monotonic time. */
+    readonly countdownSeconds?: number;
+}
+export type RefreshOutcomeKind = "committed" | "failed" | "discarded" | "cancelled";
+export interface RefreshOutcome {
+    readonly kind: RefreshOutcomeKind;
+    readonly generation: number;
+    readonly reason: RefreshReason;
+    readonly result?: CollectionResult;
+    readonly error?: unknown;
+}
+export interface RefreshSchedulerLike {
+    start(): void;
+    stop(): void;
+    reset(): void;
+    manual(): void;
+    wake(): void;
+    countdownSeconds(): number | undefined;
+    nextRefreshAt(): number | undefined;
+    readonly refreshIntervalSeconds?: number;
+    setRefreshIntervalSeconds?(seconds: number): void;
+}

package/dist/src/dashboard/state/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/dashboard/state/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/dashboard/state/types.ts"],"names":[],"mappings":""}

package/dist/src/domain/contracts.d.ts

@@ -0,0 +1,219 @@
+import type { CollectionError } from "./errors.js";
+import type { TokenComponentsInput, UsageTotals } from "./tokens.js";
+import type { UsageRecord, UsageRecordCompleteness } from "./records.js";
+import type { UsageBucket, UsageWindow, UsageWindowKind } from "./windows.js";
+export type CollectionSource = "stats" | "message-scan" | "codex" | "antigravity" | "unified";
+export type ProviderKind = "opencode" | "codex" | "antigravity";
+/**
+ * Coverage describes what a collection actually observed. `complete` means
+ * traversal finished without a known gap; it does not turn provisional usage
+ * into final usage and it must never be inferred from non-zero totals.
+ */
+export interface Coverage {
+    readonly complete: boolean;
+    readonly sessionsDiscovered: number;
+    readonly sessionsScanned: number;
+    readonly sessionsSkipped: number;
+    readonly pagesRead: number;
+    readonly jobsRetried: number;
+    readonly provisionalMessages: number;
+    readonly errors: ReadonlyArray<CollectionError>;
+}
+export type UsageTotalsByWindow = Readonly<Partial<Record<UsageWindowKind, UsageTotals>>>;
+/** Aggregate model/provider data returned by the stats endpoint. */
+export interface UsageBreakdown {
+    readonly name: string;
+    readonly provider?: string;
+    readonly totals: UsageTotals;
+}
+export type UsageBreakdownsByWindow = Readonly<Partial<Record<UsageWindowKind, ReadonlyArray<UsageBreakdown>>>>;
+/** Range accepted by the OpenCode stats endpoint. */
+export interface UsageStatsRange {
+    readonly from: Date;
+    readonly to: Date;
+    readonly timezone: string;
+}
+export interface UsageTrendBucket extends UsageBucket {
+    readonly totals: UsageTotals;
+}
+export type UsageTrendsByWindow = Readonly<Partial<Record<UsageWindowKind, ReadonlyArray<UsageTrendBucket>>>>;
+/**
+ * One immutable collection intent. `capturedAt` and `windows` are created
+ * together so hour/day/week workers cannot each choose a different `now`.
+ *
+ * Recoverable item failures should be represented in a resolved partial result
+ * with `coverage.complete === false`. Cancellation is control flow instead:
+ * implementations must reject with a `DomainError` whose code is `cancelled`
+ * after observing `signal`; callers may retain a prior snapshot but may not
+ * publish the cancelled result as current.
+ */
+export interface CollectionRequest {
+    readonly capturedAt: Date;
+    readonly windows: ReadonlyArray<UsageWindow>;
+    readonly project?: string;
+    /** Defaults to true in the collector; child sessions are model work. */
+    readonly includeSubagents?: boolean;
+    /** Defaults to false so provisional usage is not silently presented as final. */
+    readonly includeProvisional?: boolean;
+    /** Refresh generation used to discard late results. */
+    readonly generation?: number;
+    readonly signal?: AbortSignal;
+}
+/**
+ * A collection may be partial while still carrying useful records. Consumers
+ * must inspect Coverage and source together with totals. No implementation may
+ * combine stats totals and message-scan totals for the same requested window.
+ */
+export interface CollectionResult {
+    readonly capturedAt: Date;
+    readonly windows: ReadonlyArray<UsageWindow>;
+    readonly source: CollectionSource;
+    readonly records: ReadonlyArray<UsageRecord>;
+    readonly totalsByWindow: UsageTotalsByWindow;
+    readonly models?: ReadonlyArray<UsageBreakdown>;
+    readonly providers?: ReadonlyArray<UsageBreakdown>;
+    readonly projects?: ReadonlyArray<UsageBreakdown>;
+    readonly modelsByWindow?: UsageBreakdownsByWindow;
+    readonly providersByWindow?: UsageBreakdownsByWindow;
+    readonly projectsByWindow?: UsageBreakdownsByWindow;
+    readonly trendsByWindow?: UsageTrendsByWindow;
+    readonly coverage: Coverage;
+    readonly serverFingerprint?: string;
+    readonly serverVersion?: string;
+}
+export declare const SNAPSHOT_SCHEMA_VERSION: 1;
+/**
+ * Persistable read model. A store commit must publish this as one immutable
+ * snapshot (normally via temp-file flush and same-directory rename). A failed
+ * commit leaves the previous snapshot readable. Store cancellation before the
+ * atomic publish must reject and must not report a successful commit.
+ */
+export interface StoredSnapshot {
+    readonly schemaVersion: typeof SNAPSHOT_SCHEMA_VERSION;
+    readonly generation: number;
+    readonly capturedAt: Date;
+    readonly requestedWindows: ReadonlyArray<UsageWindow>;
+    readonly source: CollectionSource;
+    readonly records: ReadonlyArray<UsageRecord>;
+    readonly totalsByWindow: UsageTotalsByWindow;
+    readonly models?: ReadonlyArray<UsageBreakdown>;
+    readonly providers?: ReadonlyArray<UsageBreakdown>;
+    readonly projects?: ReadonlyArray<UsageBreakdown>;
+    readonly modelsByWindow?: UsageBreakdownsByWindow;
+    readonly providersByWindow?: UsageBreakdownsByWindow;
+    readonly projectsByWindow?: UsageBreakdownsByWindow;
+    readonly trendsByWindow?: UsageTrendsByWindow;
+    readonly coverage: Coverage;
+    readonly serverFingerprint?: string;
+    readonly serverVersion?: string;
+}
+export interface TransportRequestOptions {
+    /** A transport must stop issuing work and reject with cancellation promptly. */
+    readonly signal?: AbortSignal;
+}
+export interface SessionListRequest extends TransportRequestOptions {
+    readonly cursor?: string;
+    readonly limit?: number;
+}
+export interface MessageListRequest extends TransportRequestOptions {
+    readonly sessionID: string;
+    readonly cursor?: string;
+    readonly limit?: number;
+}
+export interface OpenCodeSession {
+    readonly sessionID: string;
+    readonly parentSessionID?: string;
+    readonly projectID?: string;
+    readonly directory?: string;
+    readonly workspaceID?: string;
+}
+export interface OpenCodeAssistantMessage {
+    readonly sessionID: string;
+    readonly messageID: string;
+    readonly createdAt: Date;
+    readonly model: string;
+    /** Undefined means the API omitted the token object, not zero usage. */
+    readonly tokens?: TokenComponentsInput;
+    readonly completeness: UsageRecordCompleteness;
+}
+export interface SessionPage {
+    readonly sessions: ReadonlyArray<OpenCodeSession>;
+    /** `null` means exhausted; a repeated cursor is a protocol error. */
+    readonly nextCursor: string | null;
+}
+export interface MessagePage {
+    readonly messages: ReadonlyArray<OpenCodeAssistantMessage>;
+    /** `null` means exhausted; a repeated cursor is a protocol error. */
+    readonly nextCursor: string | null;
+}
+export interface OpenCodeHealth {
+    readonly version: string;
+    readonly fingerprint: string;
+}
+export interface OpenCodeRange {
+    readonly from: Date;
+    readonly to: Date;
+    readonly timezone: string;
+}
+export interface OpenCodeProject {
+    readonly id: string;
+    readonly canonical: string;
+    readonly name?: string;
+}
+export interface OpenCodeSessionStats {
+    readonly requestedWindow: UsageStatsRange;
+    /** The server-reported range must be compared with requestedWindow by the collector. */
+    readonly reportedRange: OpenCodeRange;
+    readonly totals: UsageTotals;
+    readonly models?: ReadonlyArray<UsageBreakdown>;
+    readonly providers?: ReadonlyArray<UsageBreakdown>;
+}
+/**
+ * Adapter seam for the read-only OpenCode 2 V2 server API.
+ *
+ * Every operation is an idempotent read. Implementations may retry reads but
+ * must not duplicate accounting as a retry side effect. They must honor an
+ * AbortSignal promptly, reject with cancellation rather than return a falsely
+ * complete page, and avoid exposing prompts/tool content in these DTOs.
+ * `getSessionStats` is usable only after its reported range is validated;
+ * callers must fall back to paginated messages when the server ignores bounds.
+ */
+export interface OpenCodeTransport {
+    getHealth(options?: TransportRequestOptions): Promise<OpenCodeHealth>;
+    getSessionStats(window: UsageStatsRange, options?: TransportRequestOptions & {
+        readonly project?: string;
+    }): Promise<OpenCodeSessionStats>;
+    listSessions(request?: SessionListRequest): Promise<SessionPage>;
+    listMessages(request: MessageListRequest): Promise<MessagePage>;
+    listProjects?(options?: TransportRequestOptions): Promise<ReadonlyArray<OpenCodeProject>>;
+}
+/** A source such as stats or a paginated message collector. */
+export interface UsageSource {
+    /**
+     * Resolve with a partial result for bounded, recoverable scan gaps. Reject
+     * cancellation so the refresh coordinator can discard this generation;
+     * never label a partial or cancelled result as complete.
+     */
+    collect(request: CollectionRequest): Promise<CollectionResult>;
+}
+export interface SnapshotStoreReadOptions extends TransportRequestOptions {
+}
+export interface SnapshotStoreCommitOptions extends TransportRequestOptions {
+}
+/**
+ * Process-safe snapshot persistence seam. Implementations serialize commits;
+ * a cache-busy condition should be reported rather than waiting forever, so a
+ * caller can continue with in-memory data and visible stale/partial status.
+ */
+export interface SnapshotStore {
+    read(options?: SnapshotStoreReadOptions): Promise<StoredSnapshot | null>;
+    commit(snapshot: StoredSnapshot, options?: SnapshotStoreCommitOptions): Promise<void>;
+}
+/**
+ * Wall time drives calendar windows; monotonic milliseconds drive scheduling
+ * and elapsed-time budgets. Tests provide a fake implementation for both.
+ */
+export interface Clock {
+    wallNow(): Date;
+    monotonicNow(): number;
+}

package/dist/src/domain/contracts.js

@@ -0,0 +1,2 @@
+export const SNAPSHOT_SCHEMA_VERSION = 1;
+//# sourceMappingURL=contracts.js.map

package/dist/src/domain/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/domain/contracts.ts"],"names":[],"mappings":"AAqGA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAU,CAAC"}