oc2token 0.1.0

package/dist/src/domain/windows.js

@@ -0,0 +1,272 @@
+import { DomainError } from "./errors.js";
+export const USAGE_WINDOW_KINDS = ["hour", "day", "week"];
+const HOUR_MS = 60 * 60 * 1000;
+const DAY_MS = 24 * HOUR_MS;
+const ISO_WEEK_DAYS = 7;
+function assertValidInstant(value, name) {
+    if (!(value instanceof Date) || Number.isNaN(value.getTime())) {
+        throw new DomainError("invalid-date", `${name} must be a valid Date`);
+    }
+}
+function assertTimeZone(timezone) {
+    if (typeof timezone !== "string" || timezone.trim().length === 0) {
+        throw new DomainError("invalid-timezone", "timezone must not be empty");
+    }
+    try {
+        // Constructing the formatter is the portable way to validate an IANA zone
+        // without depending on a third-party time-zone database.
+        new Intl.DateTimeFormat("en-US-u-ca-gregory", { timeZone: timezone }).format();
+    }
+    catch (error) {
+        throw new DomainError("invalid-timezone", `Invalid IANA timezone: ${timezone}`, {
+            cause: error,
+        });
+    }
+}
+function utcDateTime(value) {
+    const result = new Date(0);
+    result.setUTCFullYear(value.year, value.month - 1, value.day);
+    result.setUTCHours(value.hour, value.minute, value.second, 0);
+    return result;
+}
+function partsFor(instant, timezone) {
+    assertValidInstant(instant, "instant");
+    const formatter = new Intl.DateTimeFormat("en-US-u-ca-gregory-hc-h23", {
+        timeZone: timezone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hourCycle: "h23",
+    });
+    const parts = new Map(formatter
+        .formatToParts(instant)
+        .filter((part) => part.type !== "literal")
+        .map((part) => [part.type, part.value]));
+    const year = Number(parts.get("year"));
+    const month = Number(parts.get("month"));
+    const day = Number(parts.get("day"));
+    const hour = Number(parts.get("hour"));
+    const minute = Number(parts.get("minute"));
+    const second = Number(parts.get("second"));
+    if (![year, month, day, hour, minute, second].every(Number.isFinite)) {
+        throw new DomainError("invalid-timezone", "Timezone formatting did not return a complete date");
+    }
+    return { year, month, day, hour: hour === 24 ? 0 : hour, minute, second };
+}
+function localDateAt(instant, timezone) {
+    const { year, month, day } = partsFor(instant, timezone);
+    return { year, month, day };
+}
+function sameDateTime(left, right) {
+    return (left.year === right.year &&
+        left.month === right.month &&
+        left.day === right.day &&
+        left.hour === right.hour &&
+        left.minute === right.minute &&
+        left.second === right.second);
+}
+function offsetAt(instant, timezone) {
+    // Intl exposes local calendar parts rather than an offset. Formatting a
+    // whole-second instant as UTC and subtracting the instant recovers that
+    // offset, including changes caused by DST.
+    const instantMilliseconds = Math.floor(instant.getTime() / 1000) * 1000;
+    const local = partsFor(new Date(instantMilliseconds), timezone);
+    return utcDateTime(local).getTime() - instantMilliseconds;
+}
+/**
+ * Resolve a local civil time to an instant without assuming every day is 24h.
+ * Ambiguous local times use the earliest matching instant, which makes a
+ * repeated midnight the start of the first occurrence. Midnight normally
+ * exists even on DST transition days; the iterative fallback also gives a
+ * deterministic answer for historical zones that skip a civil time.
+ */
+function instantAtLocal(when, timezone) {
+    const targetMilliseconds = utcDateTime(when).getTime();
+    const possibleOffsets = new Set();
+    // Sampling around the naive UTC value finds both sides of a DST transition,
+    // including the two offsets that can map to an ambiguous local time.
+    for (let hour = -72; hour <= 72; hour += 6) {
+        possibleOffsets.add(offsetAt(new Date(targetMilliseconds + hour * HOUR_MS), timezone));
+    }
+    const matches = [...possibleOffsets]
+        .map((offset) => new Date(targetMilliseconds - offset))
+        .filter((candidate) => sameDateTime(partsFor(candidate, timezone), when));
+    if (matches.length > 0) {
+        return new Date(Math.min(...matches.map((candidate) => candidate.getTime())));
+    }
+    // A local time can be skipped by a timezone rule. Iterate the offset until
+    // stable instead of applying a fixed offset or assuming a 24-hour day.
+    let candidateMilliseconds = targetMilliseconds;
+    for (let attempt = 0; attempt < 8; attempt += 1) {
+        const nextMilliseconds = targetMilliseconds - offsetAt(new Date(candidateMilliseconds), timezone);
+        if (nextMilliseconds === candidateMilliseconds) {
+            break;
+        }
+        candidateMilliseconds = nextMilliseconds;
+    }
+    return new Date(candidateMilliseconds);
+}
+function civilDayNumber(date) {
+    return Math.floor(utcDateTime({ ...date, hour: 0, minute: 0, second: 0 }).getTime() / DAY_MS);
+}
+function civilDateFromDayNumber(dayNumber) {
+    const date = new Date(dayNumber * DAY_MS);
+    return {
+        year: date.getUTCFullYear(),
+        month: date.getUTCMonth() + 1,
+        day: date.getUTCDate(),
+    };
+}
+function addCivilDays(date, days) {
+    return civilDateFromDayNumber(civilDayNumber(date) + days);
+}
+function dateString(date) {
+    return `${String(date.year).padStart(4, "0")}-${String(date.month).padStart(2, "0")}-${String(date.day).padStart(2, "0")}`;
+}
+function isoDayOfWeek(date) {
+    const day = new Date(civilDayNumber(date) * DAY_MS).getUTCDay();
+    return day === 0 ? 7 : day;
+}
+function isoWeekInfo(date) {
+    const monday = addCivilDays(date, 1 - isoDayOfWeek(date));
+    const thursday = addCivilDays(monday, 3);
+    const isoYear = thursday.year;
+    // ISO week 1 is the week containing January 4, not necessarily the week
+    // containing January 1 (the latter can still belong to the prior ISO year).
+    const fourthJanuary = { year: isoYear, month: 1, day: 4 };
+    const firstMonday = addCivilDays(fourthJanuary, 1 - isoDayOfWeek(fourthJanuary));
+    const week = Math.floor((civilDayNumber(monday) - civilDayNumber(firstMonday)) / ISO_WEEK_DAYS) + 1;
+    return { year: isoYear, week, monday };
+}
+function assertWindowRange(from, to, kind) {
+    assertValidInstant(from, `${kind}.from`);
+    assertValidInstant(to, `${kind}.to`);
+    if (from.getTime() >= to.getTime()) {
+        throw new DomainError("invalid-window", `${kind} window must have from < to`);
+    }
+}
+export function createUsageWindow(kind, now, timezone) {
+    assertValidInstant(now, "now");
+    assertTimeZone(timezone);
+    if (!USAGE_WINDOW_KINDS.includes(kind)) {
+        throw new DomainError("invalid-window", `Unknown usage window kind: ${String(kind)}`);
+    }
+    if (kind === "hour") {
+        const from = new Date(now.getTime() - HOUR_MS);
+        const to = new Date(now.getTime());
+        assertWindowRange(from, to, kind);
+        return {
+            kind,
+            semantics: "rolling-hour",
+            timezone,
+            from,
+            to,
+            label: "last 60 minutes",
+        };
+    }
+    const currentDate = localDateAt(now, timezone);
+    const dayStart = instantAtLocal({ ...currentDate, hour: 0, minute: 0, second: 0 }, timezone);
+    if (kind === "day") {
+        const nextDate = addCivilDays(currentDate, 1);
+        const nextStart = instantAtLocal({ ...nextDate, hour: 0, minute: 0, second: 0 }, timezone);
+        assertWindowRange(dayStart, nextStart, kind);
+        const localDate = dateString(currentDate);
+        return {
+            kind,
+            semantics: "local-day",
+            timezone,
+            from: dayStart,
+            to: nextStart,
+            localDate,
+            label: localDate,
+        };
+    }
+    const week = isoWeekInfo(currentDate);
+    const nextMonday = addCivilDays(week.monday, ISO_WEEK_DAYS);
+    const weekStart = instantAtLocal({ ...week.monday, hour: 0, minute: 0, second: 0 }, timezone);
+    const weekEnd = instantAtLocal({ ...nextMonday, hour: 0, minute: 0, second: 0 }, timezone);
+    assertWindowRange(weekStart, weekEnd, kind);
+    const isoWeekLabel = `${String(week.year).padStart(4, "0")}-W${String(week.week).padStart(2, "0")}`;
+    return {
+        kind,
+        semantics: "iso-week",
+        timezone,
+        from: weekStart,
+        to: weekEnd,
+        isoWeekYear: week.year,
+        isoWeek: week.week,
+        isoWeekLabel,
+        label: isoWeekLabel,
+    };
+}
+/** Build all v1 windows from the same captured instant, avoiding boundary drift. */
+export function createUsageWindows(now, timezone) {
+    return {
+        hour: createUsageWindow("hour", now, timezone),
+        day: createUsageWindow("day", now, timezone),
+        week: createUsageWindow("week", now, timezone),
+    };
+}
+function trendBucketLabel(instant, timezone, kind) {
+    try {
+        return new Intl.DateTimeFormat("en-CA", kind === "week"
+            ? { timeZone: timezone, year: "numeric", month: "2-digit", day: "2-digit" }
+            : { timeZone: timezone, hour: "2-digit", minute: "2-digit", hourCycle: "h23" }).format(instant);
+    }
+    catch {
+        return instant.toISOString();
+    }
+}
+/**
+ * Build the stable trend intervals for a requested window. Calendar-day
+ * buckets advance in elapsed time from the local-day bounds, which preserves
+ * both missing and repeated hours on DST transition days. Week buckets use
+ * local midnights, so a DST day changes the bucket duration without changing
+ * the seven-day shape of the ISO week.
+ */
+export function createUsageTrendBuckets(window) {
+    assertTimeZone(window.timezone);
+    assertWindowRange(window.from, window.to, window.kind);
+    const buckets = [];
+    const append = (from, to) => {
+        const clippedFrom = Math.max(window.from.getTime(), from.getTime());
+        const clippedTo = Math.min(window.to.getTime(), to.getTime());
+        if (clippedFrom >= clippedTo)
+            return;
+        const bucketFrom = new Date(clippedFrom);
+        buckets.push({
+            label: trendBucketLabel(bucketFrom, window.timezone, window.kind),
+            from: bucketFrom,
+            to: new Date(clippedTo),
+        });
+    };
+    if (window.kind === "hour") {
+        const bucketDuration = 5 * 60 * 1_000;
+        for (let cursor = window.from.getTime(); cursor < window.to.getTime(); cursor += bucketDuration) {
+            append(new Date(cursor), new Date(Math.min(window.to.getTime(), cursor + bucketDuration)));
+        }
+        return buckets;
+    }
+    if (window.kind === "day") {
+        const bucketDuration = HOUR_MS;
+        for (let cursor = window.from.getTime(); cursor < window.to.getTime(); cursor += bucketDuration) {
+            append(new Date(cursor), new Date(Math.min(window.to.getTime(), cursor + bucketDuration)));
+        }
+        return buckets;
+    }
+    const localStart = localDateAt(window.from, window.timezone);
+    for (let day = 0; day < ISO_WEEK_DAYS; day += 1) {
+        const fromLocal = addCivilDays(localStart, day);
+        const toLocal = addCivilDays(localStart, day + 1);
+        append(instantAtLocal({ ...fromLocal, hour: 0, minute: 0, second: 0 }, window.timezone), instantAtLocal({ ...toLocal, hour: 0, minute: 0, second: 0 }, window.timezone));
+    }
+    return buckets;
+}
+export function containsInstant(window, instant) {
+    assertValidInstant(instant, "instant");
+    return instant.getTime() >= window.from.getTime() && instant.getTime() < window.to.getTime();
+}
+//# sourceMappingURL=windows.js.map

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

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

package/dist/src/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./application.js";
+export * from "./cache/index.js";
+export * from "./collector/collector.js";
+export { intervalUnion } from "./collector/types.js";
+export type { CollectorOptions } from "./collector/types.js";
+export * from "./dashboard/state/refresh-coordinator.js";
+export * from "./domain/index.js";
+export * from "./opencode/index.js";
+export * from "./output/index.js";

package/dist/src/index.js

@@ -0,0 +1,9 @@
+export * from "./application.js";
+export * from "./cache/index.js";
+export * from "./collector/collector.js";
+export { intervalUnion } from "./collector/types.js";
+export * from "./dashboard/state/refresh-coordinator.js";
+export * from "./domain/index.js";
+export * from "./opencode/index.js";
+export * from "./output/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,cAAc,0CAA0C,CAAC;AACzD,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/src/opencode/adapter.d.ts

@@ -0,0 +1,47 @@
+import { type CollectionRequest, type CollectionResult, type MessageListRequest, type MessagePage, type OpenCodeAssistantMessage, type OpenCodeSession, type OpenCodeSessionStats, type OpenCodeTransport, type SessionListRequest, type SessionPage, type UsageSource, type UsageStatsRange } from "../domain/index.js";
+import { type ConnectionOptions, type OpenCodeConnection as ClientConnection } from "./client.js";
+import type { Endpoint } from "@opencode-ai/client/service";
+import { type DoctorOptions, type DoctorReport } from "./doctor.js";
+import { type StatsRequestOptions } from "./transport.js";
+export interface OpenCodeAdapterOptions extends ConnectionOptions {
+    readonly transport?: OpenCodeTransport;
+    readonly pageSize?: number;
+    readonly maxAttempts?: number;
+    readonly baseDelayMs?: number;
+    readonly maxDelayMs?: number;
+    readonly jitter?: number;
+    readonly random?: () => number;
+    readonly sleep?: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
+    readonly requestTimeoutMs?: number;
+}
+/** Facade that keeps service lifecycle, transport, stats, and diagnostics together. */
+export declare class OpenCode2Adapter implements UsageSource {
+    readonly options: OpenCodeAdapterOptions;
+    private connection;
+    private readonly injectedClient;
+    private transportValue;
+    private statsSource;
+    constructor(options?: OpenCodeAdapterOptions);
+    get currentConnection(): ClientConnection | undefined;
+    get transport(): OpenCodeTransport | undefined;
+    connect(signal?: AbortSignal): Promise<ClientConnection>;
+    discover(): Promise<Endpoint | undefined>;
+    ensure(): Promise<Endpoint>;
+    private installClient;
+    private requireTransport;
+    getHealth(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<import("../domain/contracts.js").OpenCodeHealth>;
+    getSessionStats(window: UsageStatsRange, options?: StatsRequestOptions): Promise<OpenCodeSessionStats>;
+    listSessions(request?: SessionListRequest): Promise<SessionPage>;
+    listMessages(request: MessageListRequest): Promise<MessagePage>;
+    listAllSessions(options?: SessionListRequest & {
+        readonly maxPages?: number;
+    }): Promise<ReadonlyArray<OpenCodeSession>>;
+    listAllMessages(options: MessageListRequest & {
+        readonly maxPages?: number;
+    }): Promise<ReadonlyArray<OpenCodeAssistantMessage>>;
+    collect(request: CollectionRequest): Promise<CollectionResult>;
+    doctor(options?: Omit<DoctorOptions, "transport" | "connection">): Promise<DoctorReport>;
+}
+export declare function createOpenCodeAdapter(options?: OpenCodeAdapterOptions): OpenCode2Adapter;

package/dist/src/opencode/adapter.js

@@ -0,0 +1,118 @@
+import { connectOpenCode, defaultService, } from "./client.js";
+import { runOpenCodeDoctor } from "./doctor.js";
+import { OpenCodeStatsSource } from "./stats.js";
+import { OpenCode2Transport, } from "./transport.js";
+/** Facade that keeps service lifecycle, transport, stats, and diagnostics together. */
+export class OpenCode2Adapter {
+    options;
+    connection;
+    injectedClient;
+    transportValue;
+    statsSource;
+    constructor(options = {}) {
+        this.options = { ...options };
+        this.injectedClient = options.client;
+        this.transportValue = options.transport;
+        if (this.transportValue !== undefined)
+            this.statsSource = new OpenCodeStatsSource(this.transportValue);
+        else if (this.injectedClient !== undefined)
+            this.installClient(this.injectedClient);
+    }
+    get currentConnection() {
+        return this.connection;
+    }
+    get transport() {
+        return this.transportValue;
+    }
+    async connect(signal) {
+        this.connection = await connectOpenCode({
+            ...this.options,
+            ...(signal === undefined ? {} : { signal }),
+        });
+        this.installClient(this.connection.client);
+        return this.connection;
+    }
+    async discover() {
+        const service = this.options.service;
+        return (service ?? defaultService).discover({
+            ...this.options.discovery,
+            ...(this.options.version === undefined ? {} : { version: this.options.version }),
+        });
+    }
+    async ensure() {
+        const connection = await connectOpenCode({ ...this.options, ensure: true });
+        this.connection = connection;
+        this.installClient(connection.client);
+        return connection.endpoint;
+    }
+    installClient(client) {
+        const transportOptions = {
+            client,
+            pageSize: this.options.pageSize,
+            maxAttempts: this.options.maxAttempts,
+            baseDelayMs: this.options.baseDelayMs,
+            maxDelayMs: this.options.maxDelayMs,
+            jitter: this.options.jitter,
+            random: this.options.random,
+            sleep: this.options.sleep,
+            requestTimeoutMs: this.options.requestTimeoutMs,
+        };
+        this.transportValue = new OpenCode2Transport(transportOptions);
+        this.statsSource = new OpenCodeStatsSource(this.transportValue);
+    }
+    requireTransport() {
+        if (this.transportValue === undefined) {
+            throw new Error("OpenCode adapter is not connected");
+        }
+        return this.transportValue;
+    }
+    getHealth(options = {}) {
+        return this.requireTransport().getHealth(options);
+    }
+    getSessionStats(window, options = {}) {
+        const transport = this.requireTransport();
+        if (transport instanceof OpenCode2Transport)
+            return transport.getSessionStats(window, options);
+        return transport.getSessionStats(window, options);
+    }
+    listSessions(request = {}) {
+        return this.requireTransport().listSessions(request);
+    }
+    listMessages(request) {
+        return this.requireTransport().listMessages(request);
+    }
+    listAllSessions(options = {}) {
+        const transport = this.requireTransport();
+        if (!(transport instanceof OpenCode2Transport)) {
+            throw new Error("listAllSessions requires the OpenCode2Transport pagination implementation");
+        }
+        return transport.listAllSessions(options);
+    }
+    listAllMessages(options) {
+        const transport = this.requireTransport();
+        if (!(transport instanceof OpenCode2Transport)) {
+            throw new Error("listAllMessages requires the OpenCode2Transport pagination implementation");
+        }
+        return transport.listAllMessages(options);
+    }
+    collect(request) {
+        if (this.statsSource === undefined) {
+            if (this.injectedClient === undefined) {
+                return Promise.reject(new Error("OpenCode adapter is not connected"));
+            }
+            this.installClient(this.injectedClient);
+        }
+        return this.statsSource.collect(request);
+    }
+    doctor(options = {}) {
+        return runOpenCodeDoctor({
+            ...options,
+            connection: this.connection,
+            transport: this.transportValue,
+        });
+    }
+}
+export function createOpenCodeAdapter(options = {}) {
+    return new OpenCode2Adapter(options);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/src/opencode/adapter.js.map

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

package/dist/src/opencode/client.d.ts

@@ -0,0 +1,64 @@
+import { type DiscoverOptions, type Endpoint, type EnsureOptions } from "@opencode-ai/client/service";
+import type { OpenCodeHealth } from "../domain/index.js";
+/**
+ * The generated client has a very large surface and its beta types change
+ * independently of OC2Token.  Keeping this small structural seam makes the
+ * adapter easy to fake while the default factory still uses the generated
+ * client types at runtime.
+ */
+export interface OpenCodeClientLike {
+    readonly health: {
+        get(...args: any[]): Promise<unknown>;
+    };
+    readonly session: {
+        list(...args: any[]): Promise<unknown>;
+        stats(...args: any[]): Promise<unknown>;
+    };
+    readonly message: {
+        list(...args: any[]): Promise<unknown>;
+    };
+    readonly project?: {
+        list(...args: any[]): Promise<unknown>;
+    };
+}
+export interface ServiceLifecycle {
+    discover(options?: DiscoverOptions): Promise<Endpoint | undefined>;
+    ensure(options?: EnsureOptions): Promise<Endpoint>;
+    headers(endpoint: Endpoint): Record<string, string> | undefined;
+}
+export declare const defaultService: ServiceLifecycle;
+export interface OpenCodeClientFactoryOptions {
+    readonly fetch?: typeof globalThis.fetch;
+}
+export type OpenCodeClientFactory = (endpoint: Endpoint, options?: OpenCodeClientFactoryOptions) => OpenCodeClientLike;
+/** Create the official promise client with the service's auth headers. */
+export declare function createOpenCodeClient(endpoint: Endpoint, service?: Pick<ServiceLifecycle, "headers">, options?: OpenCodeClientFactoryOptions): OpenCodeClientLike;
+export declare const defaultClientFactory: OpenCodeClientFactory;
+export interface ConnectionOptions {
+    readonly service?: ServiceLifecycle;
+    readonly client?: OpenCodeClientLike;
+    readonly clientFactory?: OpenCodeClientFactory;
+    readonly fetch?: typeof globalThis.fetch;
+    /** Do not start a service when false. Defaults to true. */
+    readonly ensure?: boolean;
+    readonly discovery?: Omit<DiscoverOptions, "version">;
+    readonly ensureOptions?: Omit<EnsureOptions, "version">;
+    readonly version?: string | ((version: string) => boolean);
+    readonly signal?: AbortSignal;
+}
+export interface OpenCodeConnection {
+    readonly endpoint: Endpoint;
+    readonly client: OpenCodeClientLike;
+    readonly health: OpenCodeHealth;
+}
+export declare function parseOpenCodeHealth(value: unknown, endpoint: Endpoint): OpenCodeHealth;
+/** Discover a running service, optionally ensuring the V2 service exists. */
+export declare function connectOpenCode(options?: ConnectionOptions): Promise<OpenCodeConnection>;
+/** A class facade is convenient for callers that need to reconnect later. */
+export declare class OpenCodeConnectionManager {
+    readonly options: ConnectionOptions;
+    constructor(options?: ConnectionOptions);
+    discover(): Promise<Endpoint | undefined>;
+    ensure(): Promise<Endpoint>;
+    connect(): Promise<OpenCodeConnection>;
+}