toilscript 0.1.52 → 0.1.54

package/dist/web.js

@@ -1,8 +1,8 @@
-var ASSEMBLYSCRIPT_VERSION = "0.1.52";
+var ASSEMBLYSCRIPT_VERSION = "0.1.54";
   var ASSEMBLYSCRIPT_IMPORTMAP = {
   "imports": {
-    "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",
+    "toilscript": "https://cdn.jsdelivr.net/npm/toilscript@0.1.54/dist/toilscript.js",
+    "toilscript/cli": "https://cdn.jsdelivr.net/npm/toilscript@0.1.54/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.52",
+  "version": "0.1.54",
   "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

@@ -451,53 +451,53 @@ 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,
-  CacheHits = 41,
-  CacheMisses = 42,
-  ConnectedStreamsAvg = 43,
-  ConnectedStreamsPeak = 44,
-  CommittedMemoryAvg = 45,
-  CommittedMemoryPeak = 46,
+  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..=42`) = 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 = 43;
+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).
+/// A dashboard time range for `Analytics.series`. Short ranges (1h/6h) read the per-MINUTE ring; the long
+/// ranges (60d/90d) read the per-DAY ring (90-day retention); the rest read the per-HOUR ring (30-day).
+/// Append-only: never renumber (D60/D90 were added after D30, keeping the wire ids stable).
 export enum AnalyticsRange {
   H1 = 0,
   H6 = 1,
@@ -507,6 +507,8 @@ export enum AnalyticsRange {
   D7 = 5,
   D14 = 6,
   D30 = 7,
+  D60 = 8,
+  D90 = 9,
 }
 
 /// One tenant's analytics snapshot: the lifetime totals (indexed by `MetricId`, NO string keys), the two
@@ -523,6 +525,16 @@ export class TenantStats {
   reqMinuteCap: u64 = 0;
   reqDayUsed: u64 = 0;
   reqDayCap: u64 = 0;
+  /// LIVE per-second gauges (rates), computed edge-side from the last completed minute bucket so the
+  /// guest is STATELESS (no client diffing of two snapshots). Idle -> 0.0. `f64` (a rate is fractional
+  /// and bounded; f64 cannot overflow for any real value).
+  rps: f64 = 0;
+  bytesInPerSec: f64 = 0;
+  bytesOutPerSec: f64 = 0;
+  streamBytesInPerSec: f64 = 0;
+  streamBytesOutPerSec: f64 = 0;
+  dbOpsPerSec: f64 = 0;
+  gasPerSec: f64 = 0;
   /// Edge wall-clock (ms) when the snapshot was read.
   nowMs: u64 = 0;
 
@@ -540,7 +552,6 @@ export class TenantStats {
   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]; }
@@ -591,19 +602,28 @@ export class TenantStats {
   }
 }
 
-/// One metric's time series for a range: `points` oldest→newest, `bucketSecs` the per-bucket width, and
-/// `headMs` the newest bucket's end. Rates are derived, never stored.
+/// One metric's time series for a range: `points` oldest→newest (per-bucket totals, `u64` — non-negative),
+/// `bucketSecs` the per-bucket width, and `headMs` the newest bucket's end. Rates are derived, never stored.
 export class Series {
   metric: MetricId = MetricId.Requests;
   bucketSecs: u32 = 0;
   headMs: u64 = 0;
-  points: i64[] = [];
+  points: u64[] = [];
 
   /// Per-second rate of bucket `i` (its total divided by the bucket width). 0 for an out-of-range index.
   ratePerSec(i: i32): f64 {
     if (i < 0 || i >= this.points.length || this.bucketSecs == 0) return 0;
     return <f64>this.points[i] / <f64>this.bucketSecs;
   }
+
+  /// The CUMULATIVE total over the whole window (e.g. total bytes across a 30d/90d range). Folded into an
+  /// `f64` accumulator — NEVER a `u64`/`i64` sum, which could overflow a long byte-count window (AS has no
+  /// u128; `f64` max is 1.8e308, so it cannot overflow for any real value).
+  sum(): f64 {
+    let acc: f64 = 0;
+    for (let i = 0; i < this.points.length; i++) acc += <f64>this.points[i];
+    return acc;
+  }
 }
 
 /// A page of site names from `Analytics.listSites` (dacely.com only). When `hasMore` is
@@ -636,6 +656,16 @@ export class Analytics {
     stats.reqMinuteCap = r.readU64();
     stats.reqDayUsed = r.readU64();
     stats.reqDayCap = r.readU64();
+    // LIVE per-second rates (f64), appended after the windows. VERSION-GATE by LENGTH: a pre-rates
+    // (shorter) frame from an older edge exhausts the buffer here, so `readF64` returns 0.0 for each
+    // missing rate (DataReader is bounds-checked). No frame-version bump needed.
+    stats.rps = r.readF64();
+    stats.bytesInPerSec = r.readF64();
+    stats.bytesOutPerSec = r.readF64();
+    stats.streamBytesInPerSec = r.readF64();
+    stats.streamBytesOutPerSec = r.readF64();
+    stats.dbOpsPerSec = r.readF64();
+    stats.gasPerSec = r.readF64();
     return stats;
   }
 
@@ -648,8 +678,9 @@ export class Analytics {
     out.bucketSecs = r.readU32();
     out.headMs = r.readU64();
     const count = <i32>r.readU32();
-    const pts = new Array<i64>(count);
-    for (let i: i32 = 0; i < count && r.ok; i++) pts[i] = r.readI64();
+    // Points are non-negative per-bucket totals: read as u64 (matches the edge `u64 LE` series frame).
+    const pts = new Array<u64>(count);
+    for (let i: i32 = 0; i < count && r.ok; i++) pts[i] = r.readU64();
     out.points = pts;
     return out;
   }
@@ -735,6 +766,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,29 +280,31 @@ 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..=42` are cumulative
- *  COUNTERS (rate = value/seconds); `43..=46` are the avg/peak series of the two GAUGES. */
+ *  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,
-  CacheHits = 41, CacheMisses = 42,
-  ConnectedStreamsAvg = 43, ConnectedStreamsPeak = 44, CommittedMemoryAvg = 45, CommittedMemoryPeak = 46,
+  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). */
+/** A dashboard time range for `Analytics.series`. 1h/6h are per-minute; 60d/90d are per-day (90-day
+ *  retention); the rest are per-hour (30-day). Append-only ids. */
 declare const enum AnalyticsRange {
-  H1 = 0, H6 = 1, H12 = 2, H24 = 3, D3 = 4, D7 = 5, D14 = 6, D30 = 7,
+  H1 = 0, H6 = 1, H12 = 2, H24 = 3, D3 = 4, D7 = 5, D14 = 6, D30 = 7, D60 = 8, D90 = 9,
 }
 
 /** One tenant's analytics snapshot: lifetime totals (indexed by `MetricId`, no string keys), the two
@@ -318,7 +320,6 @@ declare class TenantStats {
   readonly status4xx: u64;
   readonly status5xx: u64;
   readonly staticHits: u64;
-  readonly wasmDispatches: u64;
   readonly executorFullRejects: u64;
   readonly unknownHostRejects: u64;
   readonly rateLimitedRejects: u64;
@@ -362,17 +363,28 @@ declare class TenantStats {
   reqMinuteCap: u64;
   reqDayUsed: u64;
   reqDayCap: u64;
+  /** LIVE per-second gauges (rates), computed edge-side from the last completed minute bucket (idle 0.0),
+   *  so no client diffing is needed. `f64` cannot overflow for any real value. */
+  readonly rps: f64;
+  readonly bytesInPerSec: f64;
+  readonly bytesOutPerSec: f64;
+  readonly streamBytesInPerSec: f64;
+  readonly streamBytesOutPerSec: f64;
+  readonly dbOpsPerSec: f64;
+  readonly gasPerSec: f64;
   nowMs: u64;
 }
 
-/** One metric's time series for a range: `points` oldest→newest, `bucketSecs` bucket width,
- *  `headMs` newest bucket end. `ratePerSec(i)` derives the per-second rate of point `i`. */
+/** One metric's time series for a range: `points` oldest→newest (per-bucket totals, `u64`), `bucketSecs`
+ *  bucket width, `headMs` newest bucket end. `ratePerSec(i)` derives the per-second rate of point `i`;
+ *  `sum()` folds the window into an `f64` cumulative (never a `u64` sum -> overflow-safe). */
 declare class Series {
   metric: MetricId;
   bucketSecs: u32;
   headMs: u64;
-  points: i64[];
+  points: u64[];
   ratePerSec(i: i32): f64;
+  sum(): f64;
 }
 
 /** A page of site names from `Analytics.listSites` (dacely.com only). When `hasMore` is