@telorun/cache-memory 0.2.0 → 0.3.0

package/README.md

@@ -23,7 +23,7 @@ Built to be language-agnostic and infinitely extensible.
 
 ```bash
 # Reconcile your manifest into a running backend
-$ telo ./examples/hello-api.yaml
+$ telo ./examples/hello-api
 
 {"level":30,"time":1771610393008,"pid":1310178,"hostname":"dev","msg":"Server listening at http://127.0.0.1:8844"}
 ```
@@ -44,146 +44,7 @@ $ telo ./examples/hello-api.yaml
 
 ## Example manifest
 
-Here is an example Telo application that defines a simple HTTP API:
-
-```yaml
-kind: Telo.Application
-metadata:
-  name: feedback
-  version: 1.0.0
-  description: |
-    A complete feedback collection REST API — no code, pure YAML.
-    Persists entries to SQLite and serves them over HTTP.
-imports:
-  Http: std/http-server@0.12.0
-  Sql: std/sql@0.9.2
-targets:
-  - !ref Migrations
-  - !ref Server
----
-# SQLite database — swap driver/host/database for PostgreSQL with zero YAML changes
-kind: Sql.Connection
-metadata:
-  name: Db
-driver: sqlite
-file: ./tmp/feedback.db
----
-# Migrations: applied automatically before the server starts
-kind: Sql.Migrations
-metadata:
-  name: Migrations
-connection: !ref Db
----
-kind: Sql.Migration
-metadata:
-  name: Migration_20260413_182154_CreateFeedback
-version: 20260413_182154_CreateFeedback
-sql: |
-  CREATE TABLE IF NOT EXISTS feedback (
-    id        INTEGER PRIMARY KEY AUTOINCREMENT,
-    text      TEXT    NOT NULL,
-    source    TEXT,
-    score     INTEGER NOT NULL DEFAULT 0,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-  )
----
-kind: Http.Server
-metadata:
-  name: Server
-baseUrl: http://localhost:8844
-port: 8844
-logger: true
-openapi:
-  info:
-    title: Feedback API
-    version: 1.0.0
-mounts:
-  - path: /v1
-    mount: !ref FeedbackRoutes
----
-kind: Http.Api
-metadata:
-  name: FeedbackRoutes
-routes:
-  # POST /v1/feedback — insert a new entry, score derived from body length heuristic
-  - request:
-      path: /feedback
-      method: POST
-      schema:
-        body:
-          type: object
-          properties:
-            text:
-              type: string
-              minLength: 1
-            source:
-              type: string
-          required: [ text ]
-    handler:
-      kind: Sql.Exec
-      connection: !ref Db
-    inputs:
-      sql: "INSERT INTO feedback (text, source, score) VALUES (?, ?, ?)"
-      bindings:
-        - "${{ request.body.text }}"
-        - "${{ request.body.source }}"
-        - "${{ size(request.body.text) }}"
-    response:
-      - status: 201
-        headers:
-          Content-Type: application/json
-        body:
-          ok: true
-          message: Feedback received
-
-  # GET /v1/feedback — list all entries, newest first
-  - request:
-      path: /feedback
-      method: GET
-    handler:
-      kind: Sql.Select
-      connection: !ref Db
-      from: feedback
-      columns: [ id, text, source, score, created_at ]
-      orderBy:
-        - { column: created_at, direction: desc }
-    response:
-      - status: 200
-        headers:
-          Content-Type: application/json
-        body: "${{ result.rows }}"
-
-  # GET /v1/feedback/{id} — fetch a single entry
-  - request:
-      path: /feedback/{id}
-      method: GET
-      schema:
-        params:
-          type: object
-          properties:
-            id:
-              type: integer
-          required: [ id ]
-    handler:
-      kind: Sql.Select
-      connection: !ref Db
-      from: feedback
-      columns: [ id, text, source, score, created_at ]
-      where:
-        - { column: id, op: "=", value: "${{ request.params.id }}" }
-    response:
-      - status: 200
-        when: "size(result.rows) > 0"
-        headers:
-          Content-Type: application/json
-        body: "${{ result.rows[0] }}"
-      - status: 404
-        headers:
-          Content-Type: application/json
-        body:
-          ok: false
-          message: Not found
-```
+See [examples/](./examples/) for a list of working applications.
 
 ## Status
 

package/dist/store-controller.d.ts

@@ -19,6 +19,7 @@ declare class MemoryStore implements ResourceInstance, CacheStore {
     get(key: string): Promise<CacheLookupResult>;
     set(key: string, value: unknown, ttlMs: number, staleTtlMs: number): Promise<void>;
     delete(key: string): Promise<void>;
+    increment(key: string, delta: number, ttlMs: number): Promise<number>;
     provide(): Promise<MemoryStore>;
     teardown(): Promise<void>;
     snapshot(): Record<string, unknown>;

package/dist/store-controller.js

@@ -40,6 +40,27 @@ class MemoryStore {
     async delete(key) {
         this.entries.delete(key);
     }
+    // Atomic within the single-threaded event loop: no `await` between the read
+    // and the write, so concurrent increments can't interleave. The expiry is set
+    // only when the counter is first created this window (fixed window).
+    async increment(key, delta, ttlMs) {
+        const now = Date.now();
+        const entry = this.entries.get(key);
+        if (!entry || now >= entry.expireAt) {
+            this.entries.delete(key);
+            this.entries.set(key, { value: delta, storedAt: now, freshUntil: now + ttlMs, expireAt: now + ttlMs });
+            while (this.entries.size > this.maxEntries) {
+                const oldest = this.entries.keys().next().value;
+                if (oldest === undefined)
+                    break;
+                this.entries.delete(oldest);
+            }
+            return delta;
+        }
+        const next = (typeof entry.value === "number" ? entry.value : 0) + delta;
+        entry.value = next;
+        return next;
+    }
     async provide() {
         return this;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/cache-memory",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Telo cache-memory module — in-process, freshness-aware CacheMemory.Store.",
   "keywords": [
     "telo",
@@ -40,12 +40,12 @@
     "src/**"
   ],
   "dependencies": {
-    "@telorun/cache": "0.2.0"
+    "@telorun/cache": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0",
-    "@telorun/sdk": "0.33.0"
+    "@telorun/sdk": "0.38.0"
   },
   "peerDependencies": {
     "@telorun/sdk": "*"

package/src/store-controller.ts

@@ -58,6 +58,27 @@ class MemoryStore implements ResourceInstance, CacheStore {
     this.entries.delete(key);
   }
 
+  // Atomic within the single-threaded event loop: no `await` between the read
+  // and the write, so concurrent increments can't interleave. The expiry is set
+  // only when the counter is first created this window (fixed window).
+  async increment(key: string, delta: number, ttlMs: number): Promise<number> {
+    const now = Date.now();
+    const entry = this.entries.get(key);
+    if (!entry || now >= entry.expireAt) {
+      this.entries.delete(key);
+      this.entries.set(key, { value: delta, storedAt: now, freshUntil: now + ttlMs, expireAt: now + ttlMs });
+      while (this.entries.size > this.maxEntries) {
+        const oldest = this.entries.keys().next().value;
+        if (oldest === undefined) break;
+        this.entries.delete(oldest);
+      }
+      return delta;
+    }
+    const next = (typeof entry.value === "number" ? entry.value : 0) + delta;
+    entry.value = next;
+    return next;
+  }
+
   async provide(): Promise<MemoryStore> {
     return this;
   }