stitchkit 0.115.0 → 0.117.0

package/llms.txt

@@ -9,7 +9,7 @@ Build with stitchkit: define a contract once, then `implement` it and serve it (
 Load the slice for each entrypoint your code imports — `import … from 'stitchkit/server'` → `llms/server.txt`; the root `stitchkit` import → `llms/stitchkit.txt`. A slice holds that entrypoint's API reference section and the guide pages whose home it is; every guide lives in exactly one slice, and a slice that needs another's guide names it under "Also read". Each file is at most 50.0 KB; a longer one continues in numbered parts, each naming the next at its top. Moving across versions: load `llms/upgrading.txt` and the range slices it lists between your version and the target. `llms-full.txt` inlines everything; it is far larger than a context window, so do not read it whole.
 
 ## Entrypoint slices
-- **stitchkit**: [llms/stitchkit.txt](llms/stitchkit.txt) 43.2 KB → [llms/stitchkit.2.txt](llms/stitchkit.2.txt) 43.1 KB
+- **stitchkit**: [llms/stitchkit.txt](llms/stitchkit.txt) 43.7 KB → [llms/stitchkit.2.txt](llms/stitchkit.2.txt) 43.1 KB
 - **stitchkit/live**: [llms/live.txt](llms/live.txt) 21.2 KB
 - **stitchkit/react**: [llms/react.txt](llms/react.txt) 8.7 KB
 - **stitchkit/react/keyboard**: [llms/react-keyboard.txt](llms/react-keyboard.txt) 22.7 KB
@@ -19,14 +19,14 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **stitchkit/tools/contract**: [llms/tools-contract.txt](llms/tools-contract.txt) 0.2 KB
 - **stitchkit/tools/invoker**: [llms/tools-invoker.txt](llms/tools-invoker.txt) 0.2 KB
 - **stitchkit/tools/connections**: [llms/tools-connections.txt](llms/tools-connections.txt) 3.9 KB
-- **stitchkit/cli**: [llms/cli.txt](llms/cli.txt) 36.3 KB → [llms/cli.2.txt](llms/cli.2.txt) 36.4 KB
+- **stitchkit/cli**: [llms/cli.txt](llms/cli.txt) 36.5 KB → [llms/cli.2.txt](llms/cli.2.txt) 36.4 KB
 - **stitchkit/cli/publish**: [llms/cli-publish.txt](llms/cli-publish.txt) 1.5 KB
 - **stitchkit/remote**: [llms/remote.txt](llms/remote.txt) 1.0 KB
 - **stitchkit/contract**: [llms/contract.txt](llms/contract.txt) 31.9 KB
-- **stitchkit/primitives**: [llms/primitives.txt](llms/primitives.txt) 11.7 KB
+- **stitchkit/primitives**: [llms/primitives.txt](llms/primitives.txt) 13.2 KB
 - **stitchkit/server**: [llms/server.txt](llms/server.txt) 44.2 KB → [llms/server.2.txt](llms/server.2.txt) 20.5 KB → [llms/server.3.txt](llms/server.3.txt) 47.0 KB → [llms/server.4.txt](llms/server.4.txt) 38.6 KB → [llms/server.5.txt](llms/server.5.txt) 22.9 KB
 - **stitchkit/observability**: [llms/observability.txt](llms/observability.txt) 46.9 KB
-- **stitchkit/agent-runtime**: [llms/agent-runtime.txt](llms/agent-runtime.txt) 44.1 KB → [llms/agent-runtime.2.txt](llms/agent-runtime.2.txt) 45.9 KB → [llms/agent-runtime.3.txt](llms/agent-runtime.3.txt) 42.2 KB
+- **stitchkit/agent-runtime**: [llms/agent-runtime.txt](llms/agent-runtime.txt) 44.3 KB → [llms/agent-runtime.2.txt](llms/agent-runtime.2.txt) 46.7 KB → [llms/agent-runtime.3.txt](llms/agent-runtime.3.txt) 43.4 KB
 - **stitchkit/agent-runtime/testing**: [llms/agent-runtime-testing.txt](llms/agent-runtime-testing.txt) 2.6 KB
 - **stitchkit/agent-runtime/harness**: [llms/agent-runtime-harness.txt](llms/agent-runtime-harness.txt) 11.0 KB
 - **stitchkit/agent-runtime/coding-tools**: [llms/agent-runtime-coding-tools.txt](llms/agent-runtime-coding-tools.txt) 5.0 KB
@@ -43,14 +43,17 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **stitchkit/testing**: [llms/testing.txt](llms/testing.txt) 33.6 KB
 - **stitchkit/agent-runtime/sandbox**: [llms/agent-runtime-sandbox.txt](llms/agent-runtime-sandbox.txt) 8.3 KB
 - **stitchkit/files**: [llms/files.txt](llms/files.txt) 5.7 KB
-- **stitchkit/telegram**: [llms/telegram.txt](llms/telegram.txt) 41.6 KB
+- **stitchkit/telegram**: [llms/telegram.txt](llms/telegram.txt) 43.9 KB
 - **stitchkit/telegram/grammy**: [llms/telegram-grammy.txt](llms/telegram-grammy.txt) 1.2 KB
 - **stitchkit/telegram/html**: [llms/telegram-html.txt](llms/telegram-html.txt) 2.7 KB
 - **stitchkit/telegram/screens**: [llms/telegram-screens.txt](llms/telegram-screens.txt) 21.2 KB
-- **stitchkit/tracking**: [llms/tracking.txt](llms/tracking.txt) 18.1 KB
+- **stitchkit/tracking**: [llms/tracking.txt](llms/tracking.txt) 20.5 KB
 - **stitchkit/release**: [llms/release.txt](llms/release.txt) 8.9 KB
-- **stitchkit/tracking/server**: [llms/tracking-server.txt](llms/tracking-server.txt) 2.5 KB
+- **stitchkit/tracking/contract**: [llms/tracking-contract.txt](llms/tracking-contract.txt) 2.8 KB
+- **stitchkit/tracking/performance**: [llms/tracking-performance.txt](llms/tracking-performance.txt) 1.1 KB
+- **stitchkit/tracking/server**: [llms/tracking-server.txt](llms/tracking-server.txt) 2.7 KB
 - **stitchkit/geo**: [llms/geo.txt](llms/geo.txt) 4.1 KB
+- **stitchkit/xlsx**: [llms/xlsx.txt](llms/xlsx.txt) 4.5 KB
 - **stitchkit/voice**: [llms/voice.txt](llms/voice.txt) 5.2 KB
 - **stitchkit/oauth**: [llms/oauth.txt](llms/oauth.txt) 6.7 KB
 - **stitchkit/google**: [llms/google.txt](llms/google.txt) 1.4 KB
@@ -66,10 +69,10 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 
 ## Upgrading slices
 - **Upgrading — how to move across versions**: [llms/upgrading.txt](llms/upgrading.txt) 12.7 KB
-- **Upgrading 0.104.0 → 0.115.0**: [llms/upgrading-0.104.0-0.115.0.txt](llms/upgrading-0.104.0-0.115.0.txt) 46.3 KB
-- **Upgrading 0.79.0 → 0.103.13**: [llms/upgrading-0.79.0-0.103.13.txt](llms/upgrading-0.79.0-0.103.13.txt) 46.3 KB
-- **Upgrading 0.62.0 → 0.78.0**: [llms/upgrading-0.62.0-0.78.0.txt](llms/upgrading-0.62.0-0.78.0.txt) 42.2 KB
-- **Upgrading 0.44.0 → 0.61.0**: [llms/upgrading-0.44.0-0.61.0.txt](llms/upgrading-0.44.0-0.61.0.txt) 41.4 KB
+- **Upgrading 0.105.0 → 0.117.0**: [llms/upgrading-0.105.0-0.117.0.txt](llms/upgrading-0.105.0-0.117.0.txt) 42.1 KB
+- **Upgrading 0.84.0 → 0.104.0**: [llms/upgrading-0.84.0-0.104.0.txt](llms/upgrading-0.84.0-0.104.0.txt) 46.1 KB
+- **Upgrading 0.63.0 → 0.83.0**: [llms/upgrading-0.63.0-0.83.0.txt](llms/upgrading-0.63.0-0.83.0.txt) 44.0 KB
+- **Upgrading 0.44.0 → 0.62.0**: [llms/upgrading-0.44.0-0.62.0.txt](llms/upgrading-0.44.0-0.62.0.txt) 46.5 KB
 - **Upgrading 0.37.0 → 0.44.0**: [llms/upgrading-0.37.0-0.44.0.txt](llms/upgrading-0.37.0-0.44.0.txt) 14.7 KB
 
 ## Guide (web)
@@ -102,6 +105,7 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - [Telegram bots](https://github.com/max-listov/stitchkit/blob/master/docs/guide/telegram.md): stitchkit/telegram — the journal, the operator channel, resumable broadcasts, local Bot API files, webhook ownership and durable update intake, message markup (stitchkit/telegram/html); the bot as application resources
 - [Telegram screens](https://github.com/max-listov/stitchkit/blob/master/docs/guide/telegram-screens.md): stitchkit/telegram/screens — a bot menu as declared screens: typed paths, actions and input, messages reconciled in place, state in a StorageAdapter, a test chat
 - [GeoIP](https://github.com/max-listov/stitchkit/blob/master/docs/guide/geo.md): stitchkit/geo — a server-only managed reader, three observable states and last-known-good generation reloads
+- [XLSX](https://github.com/max-listov/stitchkit/blob/master/docs/guide/xlsx.md): stitchkit/xlsx — a workbook from rows and typed columns, with no dependency and no formula in the file
 - [Upgrading](https://github.com/max-listov/stitchkit/blob/master/docs/guide/upgrading.md): moving a project across stitchkit versions; how breaking changes are marked
 - [Project declaration](https://github.com/max-listov/stitchkit/blob/master/docs/guide/declaration.md): the optional machine-readable statement a repository makes about itself — identity, roles, build, requirements, release steps and the names of the values a deployment supplies
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.115.0",
+  "version": "0.117.0",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",
@@ -217,6 +217,14 @@
       "types": "./dist/entrypoints/release.d.ts",
       "import": "./dist/entrypoints/release.js"
     },
+    "./tracking/contract": {
+      "types": "./dist/entrypoints/tracking/contract.d.ts",
+      "import": "./dist/entrypoints/tracking/contract.js"
+    },
+    "./tracking/performance": {
+      "types": "./dist/entrypoints/tracking/performance.d.ts",
+      "import": "./dist/entrypoints/tracking/performance.js"
+    },
     "./tracking/server": {
       "types": "./dist/entrypoints/tracking/server.d.ts",
       "import": "./dist/entrypoints/tracking/server.js"
@@ -225,6 +233,10 @@
       "types": "./dist/entrypoints/geo.d.ts",
       "import": "./dist/entrypoints/geo.js"
     },
+    "./xlsx": {
+      "types": "./dist/entrypoints/xlsx.d.ts",
+      "import": "./dist/entrypoints/xlsx.js"
+    },
     "./voice": {
       "types": "./dist/entrypoints/voice.d.ts",
       "import": "./dist/entrypoints/voice.js"
@@ -304,30 +316,28 @@
     "@tanstack/react-query": ">=5",
     "@types/bun": "^1.4.2",
     "ai": "^7.0.107",
-    "grammy": "^1.46.0",
     "google-auth-library": "^11.1.0",
+    "grammy": "^1.46.0",
     "maxmind": "^5.0.7",
     "react": ">=18",
     "react-query-kit": "^3.3.3",
     "socket.io": "^4.8.3",
     "socket.io-client": "^4.8.3",
     "srvx": "^0.12.5 || ^1.0.5",
+    "web-vitals": "^6.2.3",
     "zod": "^4.6.5"
   },
   "peerDependenciesMeta": {
     "@modelcontextprotocol/ext-apps": {
       "optional": true
     },
-    "@types/bun": {
-      "optional": true
-    },
     "@modelcontextprotocol/server": {
       "optional": true
     },
-    "@opentelemetry/api": {
+    "@openrouter/ai-sdk-provider": {
       "optional": true
     },
-    "@openrouter/ai-sdk-provider": {
+    "@opentelemetry/api": {
       "optional": true
     },
     "@socket.io/bun-engine": {
@@ -339,15 +349,18 @@
     "@tanstack/react-query": {
       "optional": true
     },
-    "ai": {
+    "@types/bun": {
       "optional": true
     },
-    "grammy": {
+    "ai": {
       "optional": true
     },
     "google-auth-library": {
       "optional": true
     },
+    "grammy": {
+      "optional": true
+    },
     "maxmind": {
       "optional": true
     },
@@ -365,6 +378,9 @@
     },
     "srvx": {
       "optional": true
+    },
+    "web-vitals": {
+      "optional": true
     }
   },
   "dependencies": {
@@ -387,6 +403,7 @@
     "@typescript/typescript6": "^6.0.2",
     "ai": "^7.0.111",
     "ajv": "^8.20.0",
+    "exceljs": "^4.4.0",
     "fake-indexeddb": "^6.2.5",
     "google-auth-library": "^11.1.0",
     "grammy": "^1.46.0",
@@ -397,6 +414,7 @@
     "socket.io-client": "^4.8.3",
     "srvx": "^1.0.5",
     "typescript": "^7.0.2",
+    "web-vitals": "^6.2.3",
     "zod": "^4.6.5"
   }
 }

package/dist/{index-z3d6smer.js → index-tdpmfks8.js}

@@ -246,13 +246,13 @@ async function createOwned(path, options, reclaimed) {
       throw error;
     }
   } catch (error) {
-    await handle.close().catch(() => {
-      return;
-    });
     if (published && ino !== undefined && dev !== undefined)
       await unlinkIfSame(path, ino, dev, 2).catch(() => {
         return;
       });
+    await handle.close().catch(() => {
+      return;
+    });
     await unlink(staged).catch(() => {
       return;
     });
@@ -279,9 +279,9 @@ async function createOwned(path, options, reclaimed) {
         return;
       released = true;
       try {
-        await handle.close();
-      } finally {
         await unlinkIfSame(path, ownedInode, ownedDevice);
+      } finally {
+        await handle.close();
       }
     }
   };