toilscript 0.1.51 → 0.1.52

package/dist/importmap.json

@@ -1,7 +1,7 @@
 {
   "imports": {
-    "toilscript": "https://cdn.jsdelivr.net/npm/toilscript@0.1.51/dist/toilscript.js",
-    "toilscript/cli": "https://cdn.jsdelivr.net/npm/toilscript@0.1.51/dist/cli.js",
+    "toilscript": "https://cdn.jsdelivr.net/npm/toilscript@0.1.52/dist/toilscript.js",
+    "toilscript/cli": "https://cdn.jsdelivr.net/npm/toilscript@0.1.52/dist/cli.js",
     "binaryen": "https://cdn.jsdelivr.net/npm/binaryen@130.0.0-nightly.20260609/index.js",
     "long": "https://cdn.jsdelivr.net/npm/long@5.3.2/index.js"
   }

package/dist/web.js

@@ -1,8 +1,8 @@
-var ASSEMBLYSCRIPT_VERSION = "0.1.51";
+var ASSEMBLYSCRIPT_VERSION = "0.1.52";
   var ASSEMBLYSCRIPT_IMPORTMAP = {
   "imports": {
-    "toilscript": "https://cdn.jsdelivr.net/npm/toilscript@0.1.51/dist/toilscript.js",
-    "toilscript/cli": "https://cdn.jsdelivr.net/npm/toilscript@0.1.51/dist/cli.js",
+    "toilscript": "https://cdn.jsdelivr.net/npm/toilscript@0.1.52/dist/toilscript.js",
+    "toilscript/cli": "https://cdn.jsdelivr.net/npm/toilscript@0.1.52/dist/cli.js",
     "binaryen": "https://cdn.jsdelivr.net/npm/binaryen@130.0.0-nightly.20260609/index.js",
     "long": "https://cdn.jsdelivr.net/npm/long@5.3.2/index.js"
   }

package/package.json

@@ -8,7 +8,7 @@
     "toilscript",
     "wasm"
   ],
-  "version": "0.1.51",
+  "version": "0.1.52",
   "author": "Daniel Wirtz <dcode+assemblyscript@dcode.io>",
   "license": "Apache-2.0",
   "homepage": "https://github.com/dacely-cloud/toilscript",

package/std/assembly/toildb.ts

@@ -440,7 +440,7 @@ export class Counter<K> {
 
 /// Every per-domain metric, by stable numeric id. This is the WIRE CONTRACT shared with the edge
 /// (`src/analytics/metric_id.rs`) and the dev server; it orders the snapshot frame and addresses a
-/// time-series. Ids `0..=40` are cumulative COUNTERS (a rate is `value / seconds`); `41..=44` are the
+/// time-series. Ids `0..=42` are cumulative COUNTERS (a rate is `value / seconds`); `43..=46` are the
 /// avg/peak series of the two GAUGES. Append-only: never renumber.
 export enum MetricId {
   Requests = 0,
@@ -484,15 +484,17 @@ export enum MetricId {
   DaemonHttpCallFailures = 38,
   MemGrownBytes = 39,
   Emails = 40,
-  ConnectedStreamsAvg = 41,
-  ConnectedStreamsPeak = 42,
-  CommittedMemoryAvg = 43,
-  CommittedMemoryPeak = 44,
+  CacheHits = 41,
+  CacheMisses = 42,
+  ConnectedStreamsAvg = 43,
+  ConnectedStreamsPeak = 44,
+  CommittedMemoryAvg = 45,
+  CommittedMemoryPeak = 46,
 }
 
-/// The number of cumulative counter metrics (`MetricId 0..=40`) = the length of the snapshot's lifetime
+/// The number of cumulative counter metrics (`MetricId 0..=42`) = the length of the snapshot's lifetime
 /// section.
-export const METRIC_COUNTERS: i32 = 41;
+export const METRIC_COUNTERS: i32 = 43;
 
 /// A dashboard time range for `Analytics.series`. Short ranges (1h/6h) read the per-MINUTE ring; the rest
 /// read the per-HOUR ring (30-day retention).
@@ -512,56 +514,81 @@ export enum AnalyticsRange {
 /// value either by the typed getter (`stats.requests`) or by id (`stats.metric(MetricId.Requests)`).
 export class TenantStats {
   /// Lifetime totals indexed by `MetricId` (length `METRIC_COUNTERS`). Prefer the named getters below.
-  life: StaticArray<i64> = new StaticArray<i64>(METRIC_COUNTERS);
+  life: StaticArray<u64> = new StaticArray<u64>(METRIC_COUNTERS);
   /// Live gauges (current level, not a total).
-  connectedStreams: i64 = 0;
-  committedMemory: i64 = 0;
+  connectedStreams: u64 = 0;
+  committedMemory: u64 = 0;
   /// Request windows: current bucket usage + plan cap (0 = unlimited).
-  reqMinuteUsed: i64 = 0;
+  reqMinuteUsed: u64 = 0;
   reqMinuteCap: u64 = 0;
-  reqDayUsed: i64 = 0;
+  reqDayUsed: u64 = 0;
   reqDayCap: u64 = 0;
   /// Edge wall-clock (ms) when the snapshot was read.
   nowMs: u64 = 0;
 
   /// Any counter metric by id (0 for an out-of-range id).
-  metric(id: MetricId): i64 {
+  metric(id: MetricId): u64 {
     return <i32>id < METRIC_COUNTERS ? this.life[<i32>id] : 0;
   }
 
   // Typed getters for every counter (the catalog: no magic strings, self-documenting).
-  get requests(): i64 { return this.life[MetricId.Requests]; }
-  get bytesOutL1(): i64 { return this.life[MetricId.BytesOutL1]; }
-  get bytesInL1(): i64 { return this.life[MetricId.BytesInL1]; }
-  get status2xx(): i64 { return this.life[MetricId.Status2xx]; }
-  get status3xx(): i64 { return this.life[MetricId.Status3xx]; }
-  get status4xx(): i64 { return this.life[MetricId.Status4xx]; }
-  get status5xx(): i64 { return this.life[MetricId.Status5xx]; }
-  get staticHits(): i64 { return this.life[MetricId.StaticHits]; }
-  get wasmDispatches(): i64 { return this.life[MetricId.WasmDispatches]; }
-  get executorFullRejects(): i64 { return this.life[MetricId.ExecutorFullRejects]; }
-  get unknownHostRejects(): i64 { return this.life[MetricId.UnknownHostRejects]; }
-  get rateLimitedRejects(): i64 { return this.life[MetricId.RateLimitedRejects]; }
-  get gasUsed(): i64 { return this.life[MetricId.GasUsed]; }
-  get dbOps(): i64 { return this.life[MetricId.DbOps]; }
-  get dbReads(): i64 { return this.life[MetricId.DbReads]; }
-  get dbWrites(): i64 { return this.life[MetricId.DbWrites]; }
-  get dbErrors(): i64 { return this.life[MetricId.DbErrors]; }
-  get dbLatencyNsSum(): i64 { return this.life[MetricId.DbLatencyNsSum]; }
-  get streamAccepts(): i64 { return this.life[MetricId.StreamAccepts]; }
-  get streamBytesIn(): i64 { return this.life[MetricId.StreamBytesIn]; }
-  get streamBytesOut(): i64 { return this.life[MetricId.StreamBytesOut]; }
-  get streamCloses(): i64 { return this.life[MetricId.StreamCloses]; }
-  get streamDisconnects(): i64 { return this.life[MetricId.StreamDisconnects]; }
-  get daemonTicks(): i64 { return this.life[MetricId.DaemonTicksFired]; }
-  get memGrownBytes(): i64 { return this.life[MetricId.MemGrownBytes]; }
-  get emails(): i64 { return this.life[MetricId.Emails]; }
+  get requests(): u64 { return this.life[MetricId.Requests]; }
+  get bytesOutL1(): u64 { return this.life[MetricId.BytesOutL1]; }
+  get bytesInL1(): u64 { return this.life[MetricId.BytesInL1]; }
+  get status2xx(): u64 { return this.life[MetricId.Status2xx]; }
+  get status3xx(): u64 { return this.life[MetricId.Status3xx]; }
+  get status4xx(): u64 { return this.life[MetricId.Status4xx]; }
+  get status5xx(): u64 { return this.life[MetricId.Status5xx]; }
+  get staticHits(): u64 { return this.life[MetricId.StaticHits]; }
+  get wasmDispatches(): u64 { return this.life[MetricId.WasmDispatches]; }
+  get executorFullRejects(): u64 { return this.life[MetricId.ExecutorFullRejects]; }
+  get unknownHostRejects(): u64 { return this.life[MetricId.UnknownHostRejects]; }
+  get rateLimitedRejects(): u64 { return this.life[MetricId.RateLimitedRejects]; }
+  get gasUsed(): u64 { return this.life[MetricId.GasUsed]; }
+  get dbOps(): u64 { return this.life[MetricId.DbOps]; }
+  get dbReads(): u64 { return this.life[MetricId.DbReads]; }
+  get dbWrites(): u64 { return this.life[MetricId.DbWrites]; }
+  get dbErrors(): u64 { return this.life[MetricId.DbErrors]; }
+  get dbLatencyNsSum(): u64 { return this.life[MetricId.DbLatencyNsSum]; }
+  get streamAccepts(): u64 { return this.life[MetricId.StreamAccepts]; }
+  get streamRejectWrongNode(): u64 { return this.life[MetricId.StreamRejectWrongNode]; }
+  get streamRejectCapacity(): u64 { return this.life[MetricId.StreamRejectCapacity]; }
+  get streamRejectArtifact(): u64 { return this.life[MetricId.StreamRejectArtifact]; }
+  get streamRejectGuest(): u64 { return this.life[MetricId.StreamRejectGuest]; }
+  get streamTraps(): u64 { return this.life[MetricId.StreamTraps]; }
+  get streamIdleTimeouts(): u64 { return this.life[MetricId.StreamIdleTimeouts]; }
+  get streamBytesIn(): u64 { return this.life[MetricId.StreamBytesIn]; }
+  get streamBytesOut(): u64 { return this.life[MetricId.StreamBytesOut]; }
+  get streamBackpressureEvents(): u64 { return this.life[MetricId.StreamBackpressureEvents]; }
+  get streamCloses(): u64 { return this.life[MetricId.StreamCloses]; }
+  get streamDisconnects(): u64 { return this.life[MetricId.StreamDisconnects]; }
+  get daemonStarts(): u64 { return this.life[MetricId.DaemonStarts]; }
+  get daemonStartFailures(): u64 { return this.life[MetricId.DaemonStartFailures]; }
+  get daemonTicksFired(): u64 { return this.life[MetricId.DaemonTicksFired]; }
+  get daemonTicksSkippedNotLeader(): u64 { return this.life[MetricId.DaemonTicksSkippedNotLeader]; }
+  get daemonTicksFailed(): u64 { return this.life[MetricId.DaemonTicksFailed]; }
+  get daemonLeaderAcquires(): u64 { return this.life[MetricId.DaemonLeaderAcquires]; }
+  get daemonLeaderFenced(): u64 { return this.life[MetricId.DaemonLeaderFenced]; }
+  get daemonHttpCallAttempts(): u64 { return this.life[MetricId.DaemonHttpCallAttempts]; }
+  get daemonHttpCallFailures(): u64 { return this.life[MetricId.DaemonHttpCallFailures]; }
+  get memGrownBytes(): u64 { return this.life[MetricId.MemGrownBytes]; }
+  get emails(): u64 { return this.life[MetricId.Emails]; }
+  get cacheHits(): u64 { return this.life[MetricId.CacheHits]; }
+  get cacheMisses(): u64 { return this.life[MetricId.CacheMisses]; }
 
   /// Mean host-observed DB op latency (ns), or 0 with no ops.
-  get meanDbLatencyNs(): i64 {
+  get meanDbLatencyNs(): u64 {
     const ops = this.dbOps;
     return ops > 0 ? this.dbLatencyNsSum / ops : 0;
   }
+
+  /// Fraction of cacheable responses served from cache (`hits / (hits + misses)`),
+  /// 0.0 when there were no cacheable responses.
+  get cacheRatio(): f64 {
+    const hits = this.cacheHits;
+    const total = hits + this.cacheMisses;
+    return total > 0 ? <f64>hits / <f64>total : 0.0;
+  }
 }
 
 /// One metric's time series for a range: `points` oldest→newest, `bucketSecs` the per-bucket width, and
@@ -599,14 +626,15 @@ export class Analytics {
     stats.nowMs = r.readU64();
     const count = <i32>r.readU32();
     for (let i: i32 = 0; i < count && r.ok; i++) {
-      const v = r.readI64();
+      // Wire fields are non-negative i64; read the same bytes as u64.
+      const v = r.readU64();
       if (i < METRIC_COUNTERS) stats.life[i] = v; // ignore any extra (forward-compat)
     }
-    stats.connectedStreams = r.readI64();
-    stats.committedMemory = r.readI64();
-    stats.reqMinuteUsed = r.readI64();
+    stats.connectedStreams = r.readU64();
+    stats.committedMemory = r.readU64();
+    stats.reqMinuteUsed = r.readU64();
     stats.reqMinuteCap = r.readU64();
-    stats.reqDayUsed = r.readI64();
+    stats.reqDayUsed = r.readU64();
     stats.reqDayCap = r.readU64();
     return stats;
   }

package/std/assembly/toilscript.d.ts

@@ -282,8 +282,8 @@ declare class Events<K, V> {
   latest(key: K, limit: i32): V[];
 }
 
-/** Every per-domain metric, by stable numeric id (the wire contract). `0..=40` are cumulative
- *  COUNTERS (rate = value/seconds); `41..=44` are the avg/peak series of the two GAUGES. */
+/** Every per-domain metric, by stable numeric id (the wire contract). `0..=42` are cumulative
+ *  COUNTERS (rate = value/seconds); `43..=46` are the avg/peak series of the two GAUGES. */
 declare const enum MetricId {
   Requests = 0, BytesOutL1 = 1, BytesInL1 = 2,
   Status2xx = 3, Status3xx = 4, Status4xx = 5, Status5xx = 6,
@@ -296,7 +296,8 @@ declare const enum MetricId {
   DaemonStarts = 30, DaemonStartFailures = 31, DaemonTicksFired = 32, DaemonTicksSkippedNotLeader = 33,
   DaemonTicksFailed = 34, DaemonLeaderAcquires = 35, DaemonLeaderFenced = 36,
   DaemonHttpCallAttempts = 37, DaemonHttpCallFailures = 38, MemGrownBytes = 39, Emails = 40,
-  ConnectedStreamsAvg = 41, ConnectedStreamsPeak = 42, CommittedMemoryAvg = 43, CommittedMemoryPeak = 44,
+  CacheHits = 41, CacheMisses = 42,
+  ConnectedStreamsAvg = 43, ConnectedStreamsPeak = 44, CommittedMemoryAvg = 45, CommittedMemoryPeak = 46,
 }
 
 /** A dashboard time range for `Analytics.series`. 1h/6h are per-minute; the rest per-hour (30-day). */
@@ -308,39 +309,58 @@ declare const enum AnalyticsRange {
  *  live gauge levels, and the request windows (current usage + plan cap; cap 0 = unlimited). Read a
  *  value by typed getter (`stats.requests`) or by id (`stats.metric(MetricId.Requests)`). */
 declare class TenantStats {
-  metric(id: MetricId): i64;
-  readonly requests: i64;
-  readonly bytesOutL1: i64;
-  readonly bytesInL1: i64;
-  readonly status2xx: i64;
-  readonly status3xx: i64;
-  readonly status4xx: i64;
-  readonly status5xx: i64;
-  readonly staticHits: i64;
-  readonly wasmDispatches: i64;
-  readonly executorFullRejects: i64;
-  readonly unknownHostRejects: i64;
-  readonly rateLimitedRejects: i64;
-  readonly gasUsed: i64;
-  readonly dbOps: i64;
-  readonly dbReads: i64;
-  readonly dbWrites: i64;
-  readonly dbErrors: i64;
-  readonly dbLatencyNsSum: i64;
-  readonly meanDbLatencyNs: i64;
-  readonly streamAccepts: i64;
-  readonly streamBytesIn: i64;
-  readonly streamBytesOut: i64;
-  readonly streamCloses: i64;
-  readonly streamDisconnects: i64;
-  readonly daemonTicks: i64;
-  readonly memGrownBytes: i64;
-  readonly emails: i64;
-  connectedStreams: i64;
-  committedMemory: i64;
-  reqMinuteUsed: i64;
+  metric(id: MetricId): u64;
+  readonly requests: u64;
+  readonly bytesOutL1: u64;
+  readonly bytesInL1: u64;
+  readonly status2xx: u64;
+  readonly status3xx: u64;
+  readonly status4xx: u64;
+  readonly status5xx: u64;
+  readonly staticHits: u64;
+  readonly wasmDispatches: u64;
+  readonly executorFullRejects: u64;
+  readonly unknownHostRejects: u64;
+  readonly rateLimitedRejects: u64;
+  readonly gasUsed: u64;
+  readonly dbOps: u64;
+  readonly dbReads: u64;
+  readonly dbWrites: u64;
+  readonly dbErrors: u64;
+  readonly dbLatencyNsSum: u64;
+  readonly meanDbLatencyNs: u64;
+  readonly streamAccepts: u64;
+  readonly streamRejectWrongNode: u64;
+  readonly streamRejectCapacity: u64;
+  readonly streamRejectArtifact: u64;
+  readonly streamRejectGuest: u64;
+  readonly streamTraps: u64;
+  readonly streamIdleTimeouts: u64;
+  readonly streamBytesIn: u64;
+  readonly streamBytesOut: u64;
+  readonly streamBackpressureEvents: u64;
+  readonly streamCloses: u64;
+  readonly streamDisconnects: u64;
+  readonly daemonStarts: u64;
+  readonly daemonStartFailures: u64;
+  readonly daemonTicksFired: u64;
+  readonly daemonTicksSkippedNotLeader: u64;
+  readonly daemonTicksFailed: u64;
+  readonly daemonLeaderAcquires: u64;
+  readonly daemonLeaderFenced: u64;
+  readonly daemonHttpCallAttempts: u64;
+  readonly daemonHttpCallFailures: u64;
+  readonly memGrownBytes: u64;
+  readonly emails: u64;
+  readonly cacheHits: u64;
+  readonly cacheMisses: u64;
+  /** Fraction of cacheable responses served from cache (`hits / (hits + misses)`), 0.0 when none. */
+  readonly cacheRatio: f64;
+  connectedStreams: u64;
+  committedMemory: u64;
+  reqMinuteUsed: u64;
   reqMinuteCap: u64;
-  reqDayUsed: i64;
+  reqDayUsed: u64;
   reqDayCap: u64;
   nowMs: u64;
 }