@openlimiter/connectors 0.2.0 → 0.4.0

package/dist/shared.js

@@ -20,6 +20,172 @@ export function futureInstant(value, now) {
         ? new Date(parsed).toISOString()
         : null;
 }
+/**
+ * Largest epoch value that is still read as seconds.
+ *
+ * A number this size in seconds is the year 33658, and the same number read as
+ * milliseconds is 2001. Anything at or above it is therefore a millisecond
+ * stamp handed to a seconds field, which is the single most likely way this
+ * conversion gets a reset instant wrong, so it is refused rather than turned
+ * into a date thirty thousand years away.
+ */
+export const MAX_EPOCH_SECONDS = 1e12;
+/**
+ * Slack allowed between a machine's clock and a provider's clock.
+ *
+ * An hour covers a wrong time zone offset applied to a timestamp, which is the
+ * realistic way two correct systems disagree, without widening the plausibility
+ * bound below into something that accepts nonsense.
+ */
+export const CLOCK_SKEW_SECONDS = 3_600;
+/**
+ * The furthest ahead a window of a given length may plausibly reset.
+ *
+ * A rolling window cannot reset more than one window from now, so twice the
+ * window is already generous, and the skew allowance sits on top of that. This
+ * is what stops a five hour meter from claiming it resets in 2038: such a value
+ * is not a reset, it is a corrupt field, a different unit, or a different
+ * meaning, and rendering a twelve year countdown beside a five hour window
+ * would be the product lying with a straight face.
+ */
+export function plausibleResetHorizon(windowSeconds) {
+    return windowSeconds * 2 + CLOCK_SKEW_SECONDS;
+}
+/**
+ * Read a reset instant stated as Unix epoch seconds.
+ *
+ * Claude Code states its reset times this way. The value must be a finite
+ * number, must be in seconds rather than milliseconds, must still be in the
+ * future against the supplied clock, because a window that has already reset
+ * says nothing about the window running now, and must be close enough to now to
+ * belong to the window it claims to describe. Nothing is repaired: a value that
+ * fails any of these is null and the caller drops that reading alone.
+ *
+ * `maxAheadSeconds` is the plausibility bound and is optional only so the
+ * helper stays usable for a source with no window length to reason from.
+ */
+export function futureInstantFromEpochSeconds(value, now, maxAheadSeconds) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return null;
+    if (value <= 0 || value >= MAX_EPOCH_SECONDS)
+        return null;
+    const current = Date.parse(now);
+    if (!Number.isFinite(current))
+        return null;
+    const milliseconds = Math.round(value * 1_000);
+    if (milliseconds <= current)
+        return null;
+    if (typeof maxAheadSeconds === "number" &&
+        Number.isFinite(maxAheadSeconds) &&
+        maxAheadSeconds > 0 &&
+        milliseconds > current + maxAheadSeconds * 1_000)
+        return null;
+    const instant = new Date(milliseconds);
+    return Number.isFinite(instant.getTime()) ? instant.toISOString() : null;
+}
+/**
+ * A fraction of a whole, as Google's quota summary states remaining quota.
+ *
+ * Zero and one are both real answers, so the bound is inclusive. A boolean is
+ * refused explicitly: JavaScript will happily do arithmetic on `true`, and a
+ * `remainingFraction` of `true` would otherwise become a usage of zero percent,
+ * which is the most dangerous wrong answer this product can give.
+ */
+export function boundedFraction(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return null;
+    return value >= 0 && value <= 1 ? value : null;
+}
+/**
+ * A whole positive count of seconds, when a provider states a window length.
+ *
+ * Bounded above by a year, because a rolling window longer than that is not a
+ * subscription window, it is a misread field or a different unit.
+ */
+export const MAX_WINDOW_SECONDS = 31_536_000;
+export function windowSeconds(value) {
+    if (typeof value !== "number" || !Number.isInteger(value))
+        return null;
+    return value > 0 && value <= MAX_WINDOW_SECONDS ? value : null;
+}
+/**
+ * Read a reset instant stated as an RFC3339 timestamp.
+ *
+ * Google's quota summary states reset times this way, and the Antigravity
+ * client writes them with SEVEN fractional digits, which `Date.parse` on some
+ * runtimes reads and others do not. The fraction is normalised to three digits
+ * before parsing, which is the one repair made anywhere in this file, and it is
+ * a repair of ENCODING rather than of value: the instant it names is unchanged.
+ * Recorded 2026-08-07 against a real credential and a real response.
+ *
+ * An offsetless stamp is read as UTC explicitly. Both observed sources carry an
+ * offset today, so this is a guard rather than a fix, and it exists because the
+ * alternative is silent: a naive stamp read as local time moves a reset by the
+ * machine's offset instead of failing.
+ */
+export function futureInstantFromRfc3339(value, now, maxAheadSeconds) {
+    if (typeof value !== "string" || value.length > 64)
+        return null;
+    const trimmed = value.trim();
+    /* Three digits is what every runtime agrees on; the rest are dropped, not
+       rounded, because sub millisecond precision on a quota reset is noise. */
+    const normalized = trimmed.replace(/\.(\d{1,9})/u, (_match, digits) => "." + (digits + "000").slice(0, 3));
+    const withZone = /(?:Z|[+-]\d{2}:?\d{2})$/u.test(normalized)
+        ? normalized
+        : normalized + "Z";
+    const parsed = Date.parse(withZone);
+    const current = Date.parse(now);
+    if (!Number.isFinite(parsed) || !Number.isFinite(current))
+        return null;
+    if (parsed <= current)
+        return null;
+    if (typeof maxAheadSeconds === "number" &&
+        Number.isFinite(maxAheadSeconds) &&
+        maxAheadSeconds > 0 &&
+        parsed > current + maxAheadSeconds * 1_000)
+        return null;
+    return new Date(parsed).toISOString();
+}
+/** How many seconds each unit a provider spells out is worth. */
+const DURATION_UNITS = {
+    day: 86_400,
+    hour: 3_600,
+    minute: 60,
+    second: 1
+};
+/**
+ * Seconds from a duration a page spelled out in words, or null.
+ *
+ * OpenCode's workspace page prints "Resets in 5 days 20 hours" rather than a
+ * timestamp, so the only reset available is a countdown rendered for a human.
+ * Only consecutive number and unit pairs are read, and an empty or zero total
+ * is null rather than now: a reset of zero seconds would render as a countdown
+ * that has already finished.
+ */
+export function durationSecondsFromWords(text) {
+    let total = 0;
+    let seen = false;
+    const pattern = /(\d{1,6})\s*(day|hour|minute|second)s?/giu;
+    for (const match of text.matchAll(pattern)) {
+        const count = Number.parseInt(match[1] ?? "", 10);
+        const unit = DURATION_UNITS[(match[2] ?? "").toLowerCase()];
+        if (!Number.isFinite(count) || unit === undefined)
+            return null;
+        total += count * unit;
+        seen = true;
+    }
+    if (!seen || total <= 0 || total > MAX_WINDOW_SECONDS)
+        return null;
+    return total;
+}
+/** An instant this many seconds after the supplied clock, or null. */
+export function instantAfter(now, seconds) {
+    const current = Date.parse(now);
+    if (!Number.isFinite(current))
+        return null;
+    const instant = new Date(current + seconds * 1_000);
+    return Number.isFinite(instant.getTime()) ? instant.toISOString() : null;
+}
 export function shortExpiry(now) {
     const parsed = Date.parse(now);
     return Number.isFinite(parsed) ? new Date(parsed + 60_000).toISOString() : null;

package/dist/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,OAAO,GAAG,GAAG;IACzD,OAAO,OAAO,KAAK,KAAK,QAAQ;QAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACtB,KAAK,IAAI,CAAC;QACV,KAAK,IAAI,OAAO;QAChB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,GAAW;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,GAAG,OAAO;QAC5E,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE;QAChC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAmBxB;IACC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACnC,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;AACjF,CAAC"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlimiter/connectors",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Provider connectors that collect quota and usage data for OpenLimiter.",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,7 +19,7 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@openlimiter/core": "0.2.0"
+    "@openlimiter/core": "0.4.0"
   },
   "repository": {
     "type": "git",