@openworkers/workers-types 0.1.4 → 0.1.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenWorkers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openworkers/workers-types",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "TypeScript types for the OpenWorkers runtime",
   "license": "MIT",
   "repository": {

package/types/bindings.d.ts

@@ -119,33 +119,55 @@ declare global {
     limit?: number;
   }
 
+  /**
+   * JSON-serializable value type.
+   * Supports strings, numbers, booleans, null, arrays, and objects.
+   * Note: Binary data (Uint8Array, ArrayBuffer) is not supported.
+   */
+  type JsonValue =
+    | string
+    | number
+    | boolean
+    | null
+    | JsonValue[]
+    | { [key: string]: JsonValue };
+
   /**
    * Key-Value storage binding for fast, low-latency data access.
-   * Ideal for configuration, sessions, and small data.
+   * Stores values as JSON, supporting strings, numbers, booleans, objects, and arrays.
+   * Ideal for configuration, sessions, and structured data.
    *
    * @example
    * ```ts
-   * // Store with expiration
-   * await env.KV.put('session:abc', userData, { expiresIn: 3600 });
+   * // Store a string
+   * await env.KV.put('greeting', 'Hello, World!');
+   *
+   * // Store a number
+   * await env.KV.put('count', 42);
    *
-   * // Retrieve
-   * const session = await env.KV.get('session:abc');
+   * // Store an object with expiration
+   * await env.KV.put('session:abc', { userId: 123, role: 'admin' }, { expiresIn: 3600 });
+   *
+   * // Retrieve with type inference
+   * const session = await env.KV.get<{ userId: number; role: string }>('session:abc');
    * ```
    */
   interface BindingKV {
     /**
      * Retrieves a value by key.
-     * @returns The value as a string, or null if not found.
+     * @typeParam T The expected value type (defaults to unknown).
+     * @returns The value, or null if not found or expired.
      */
-    get(key: string): Promise<string | null>;
+    get<T = unknown>(key: string): Promise<T | null>;
 
     /**
-     * Stores a value with optional expiration.
+     * Stores a JSON-serializable value with optional expiration.
+     * Maximum value size: 100KB.
      * @param key The storage key.
-     * @param value The value to store.
+     * @param value The value to store (must be JSON-serializable).
      * @param options Optional settings like TTL.
      */
-    put(key: string, value: string, options?: KVPutOptions): Promise<void>;
+    put(key: string, value: JsonValue, options?: KVPutOptions): Promise<void>;
 
     /**
      * Deletes a key.

package/types/fetch.d.ts

@@ -136,7 +136,7 @@ declare global {
     formData(): Promise<FormData>;
 
     /** Reads the body as JSON. */
-    json(): Promise<unknown>;
+    json<T = unknown>(): Promise<T>;
 
     /** Reads the body as text. */
     text(): Promise<string>;
@@ -227,7 +227,7 @@ declare global {
     formData(): Promise<FormData>;
 
     /** Reads the body as JSON. */
-    json(): Promise<unknown>;
+    json<T = unknown>(): Promise<T>;
 
     /** Reads the body as text. */
     text(): Promise<string>;

package/types/streams.d.ts

@@ -73,6 +73,12 @@ declare global {
     /** The amount of data the consumer wants, or null if the stream is closed. */
     readonly desiredSize: number | null;
 
+    /**
+     * An AbortSignal that is aborted when the stream consumer cancels/disconnects.
+     * Use this to detect client disconnection and stop producing data.
+     */
+    readonly signal?: AbortSignal;
+
     /** Closes the stream. No more chunks can be enqueued after this. */
     close(): void;
 

package/types/workers.d.ts

@@ -42,6 +42,13 @@ declare global {
      * Must be called before any response is sent.
      */
     passThroughOnException(): void;
+
+    /**
+     * Properties passed to the worker.
+     * For Hono/Cloudflare Workers compatibility.
+     * @deprecated Not implemented in OpenWorkers
+     */
+    props: never;
   }
 
   /**