toilscript 0.1.51 → 0.1.53

package/dist/web.js

@@ -1,8 +1,8 @@
-var ASSEMBLYSCRIPT_VERSION = "0.1.51";
+var ASSEMBLYSCRIPT_VERSION = "0.1.53";
   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.53/dist/toilscript.js",
+    "toilscript/cli": "https://cdn.jsdelivr.net/npm/toilscript@0.1.53/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.53",
   "author": "Daniel Wirtz <dcode+assemblyscript@dcode.io>",
   "license": "Apache-2.0",
   "homepage": "https://github.com/dacely-cloud/toilscript",

package/std/assembly/bindings/toildb.ts

@@ -223,6 +223,10 @@ export namespace toildbHost {
   @external("env", "data.latest")
   export declare function latest(handle: u32, keyPtr: usize, keyLen: i32, limit: i32): i32;
 
+  // @ts-ignore: decorator
+  @external("env", "data.events_since")
+  export declare function eventsSince(handle: u32, keyPtr: usize, keyLen: i32, limit: i32): i32;
+
   // events.append_once -> 1 appended | 0 duplicate (deduped on eventId) | <0 error.
   // Idempotent append: a retried call with the same eventId never doubles the event.
   // @ts-ignore: decorator

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,
@@ -451,48 +451,49 @@ export enum MetricId {
   Status4xx = 5,
   Status5xx = 6,
   StaticHits = 7,
-  WasmDispatches = 8,
-  ExecutorFullRejects = 9,
-  UnknownHostRejects = 10,
-  RateLimitedRejects = 11,
-  GasUsed = 12,
-  DbOps = 13,
-  DbReads = 14,
-  DbWrites = 15,
-  DbErrors = 16,
-  DbLatencyNsSum = 17,
-  StreamAccepts = 18,
-  StreamRejectWrongNode = 19,
-  StreamRejectCapacity = 20,
-  StreamRejectArtifact = 21,
-  StreamRejectGuest = 22,
-  StreamTraps = 23,
-  StreamIdleTimeouts = 24,
-  StreamBytesIn = 25,
-  StreamBytesOut = 26,
-  StreamBackpressureEvents = 27,
-  StreamCloses = 28,
-  StreamDisconnects = 29,
-  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,
+  ExecutorFullRejects = 8,
+  UnknownHostRejects = 9,
+  RateLimitedRejects = 10,
+  GasUsed = 11,
+  DbOps = 12,
+  DbReads = 13,
+  DbWrites = 14,
+  DbErrors = 15,
+  DbLatencyNsSum = 16,
+  StreamAccepts = 17,
+  StreamRejectWrongNode = 18,
+  StreamRejectCapacity = 19,
+  StreamRejectArtifact = 20,
+  StreamRejectGuest = 21,
+  StreamTraps = 22,
+  StreamIdleTimeouts = 23,
+  StreamBytesIn = 24,
+  StreamBytesOut = 25,
+  StreamBackpressureEvents = 26,
+  StreamCloses = 27,
+  StreamDisconnects = 28,
+  DaemonStarts = 29,
+  DaemonStartFailures = 30,
+  DaemonTicksFired = 31,
+  DaemonTicksSkippedNotLeader = 32,
+  DaemonTicksFailed = 33,
+  DaemonLeaderAcquires = 34,
+  DaemonLeaderFenced = 35,
+  DaemonHttpCallAttempts = 36,
+  DaemonHttpCallFailures = 37,
+  MemGrownBytes = 38,
+  Emails = 39,
+  CacheHits = 40,
+  CacheMisses = 41,
+  ConnectedStreamsAvg = 42,
+  ConnectedStreamsPeak = 43,
+  CommittedMemoryAvg = 44,
+  CommittedMemoryPeak = 45,
 }
 
-/// The number of cumulative counter metrics (`MetricId 0..=40`) = the length of the snapshot's lifetime
+/// The number of cumulative counter metrics (`MetricId 0..=41`) = the length of the snapshot's lifetime
 /// section.
-export const METRIC_COUNTERS: i32 = 41;
+export const METRIC_COUNTERS: i32 = 42;
 
 /// 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 +513,80 @@ 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 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 +624,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;
   }
@@ -707,6 +733,34 @@ export class Events<K, V> {
     return status == 1;
   }
 
+  /// The NEXT batch of events for `key` past this derive's checkpoint, OLDEST first, up to `limit`. The
+  /// host owns the resumable cursor (seeded from the durable checkpoint and advanced/committed around the
+  /// fold), so repeated calls drain an unbounded log in bounded batches and return an empty array once
+  /// caught up. Use it in a `@derive` (or `@job`) to fold a growing log incrementally instead of rescanning:
+  /// `for (const e of this.events.since(key, 500)) { ...update the view... }`, looping until it is empty.
+  /// The fold must be idempotent per event (a heal can trigger a full re-read). Same frame as `latest`.
+  since(key: K, limit: i32): V[] {
+    const kb = key.encode();
+    const status = toildbHost.eventsSince(this.__handle, kb.dataStart, kb.byteLength, limit);
+    if (status < 0) unreachable();
+    const blob = __toildbTake(status);
+    const out = new Array<V>();
+    let off: i32 = 0;
+    const count = load<u32>(blob.dataStart + off);
+    off += 4;
+    for (let i: u32 = 0; i < count; i++) {
+      const ver = <i64>load<u32>(blob.dataStart + off);
+      off += 4;
+      const len = <i32>load<u32>(blob.dataStart + off);
+      off += 4;
+      const ev = instantiate<V>();
+      ev.decodeIntoVersioned(blob.subarray(off, off + len), ver);
+      out.push(ev);
+      off += len;
+    }
+    return out;
+  }
+
   /// The newest `limit` events, newest first. Decodes each framed event into a
   /// `V`. The host frames them as `u32 count` then per event
   /// `u32 schema_version + u32 len + bytes`.

package/std/assembly/toilscript.d.ts

@@ -280,23 +280,25 @@ declare class Counter<K> {
 declare class Events<K, V> {
   append(key: K, event: V): void;
   latest(key: K, limit: i32): V[];
+  since(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); `42..=45` 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,
-  StaticHits = 7, WasmDispatches = 8,
-  ExecutorFullRejects = 9, UnknownHostRejects = 10, RateLimitedRejects = 11, GasUsed = 12,
-  DbOps = 13, DbReads = 14, DbWrites = 15, DbErrors = 16, DbLatencyNsSum = 17,
-  StreamAccepts = 18, StreamRejectWrongNode = 19, StreamRejectCapacity = 20, StreamRejectArtifact = 21,
-  StreamRejectGuest = 22, StreamTraps = 23, StreamIdleTimeouts = 24, StreamBytesIn = 25,
-  StreamBytesOut = 26, StreamBackpressureEvents = 27, StreamCloses = 28, StreamDisconnects = 29,
-  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,
+  StaticHits = 7,
+  ExecutorFullRejects = 8, UnknownHostRejects = 9, RateLimitedRejects = 10, GasUsed = 11,
+  DbOps = 12, DbReads = 13, DbWrites = 14, DbErrors = 15, DbLatencyNsSum = 16,
+  StreamAccepts = 17, StreamRejectWrongNode = 18, StreamRejectCapacity = 19, StreamRejectArtifact = 20,
+  StreamRejectGuest = 21, StreamTraps = 22, StreamIdleTimeouts = 23, StreamBytesIn = 24,
+  StreamBytesOut = 25, StreamBackpressureEvents = 26, StreamCloses = 27, StreamDisconnects = 28,
+  DaemonStarts = 29, DaemonStartFailures = 30, DaemonTicksFired = 31, DaemonTicksSkippedNotLeader = 32,
+  DaemonTicksFailed = 33, DaemonLeaderAcquires = 34, DaemonLeaderFenced = 35,
+  DaemonHttpCallAttempts = 36, DaemonHttpCallFailures = 37, MemGrownBytes = 38, Emails = 39,
+  CacheHits = 40, CacheMisses = 41,
+  ConnectedStreamsAvg = 42, ConnectedStreamsPeak = 43, CommittedMemoryAvg = 44, CommittedMemoryPeak = 45,
 }
 
 /** A dashboard time range for `Analytics.series`. 1h/6h are per-minute; the rest per-hour (30-day). */
@@ -308,39 +310,57 @@ 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 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;
 }