@solidrt/flux-types 0.0.27 → 0.0.29

package/modules/fs.d.ts

@@ -16,6 +16,8 @@ declare module "flux:fs" {
     text(): Promise<string>
     /** Read the whole file as raw bytes. */
     bytes(): Promise<Uint8Array>
+    /** Read the whole file as an ArrayBuffer. */
+    arrayBuffer(): Promise<ArrayBuffer>
     /** Read and parse the file as JSON. */
     json(): Promise<any>
     /** Resolve to whether the file exists. */
@@ -40,6 +42,11 @@ declare module "flux:fs" {
     entries(): Promise<DirEntry[]>
     /** Resolve to whether the directory exists. */
     exists(): Promise<boolean>
+    /**
+     * Create the directory, including any missing parents. Succeeds if it
+     * already exists.
+     */
+    create(): Promise<void>
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidrt/flux-types",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "license": "MIT",
   "author": "Antoine van Wel",
   "types": "index.d.ts",

package/standards/console.d.ts

@@ -1,6 +1,8 @@
 // The web-standard `console` global. flux provides exactly these four methods
 // (no info/trace/table/group/...). A global script file: these declarations
 // stand in for the ones lib.dom would otherwise supply.
+// Formatting: arguments joined by spaces; strings as-is, Error objects as
+// `name: message` plus stack, other values JSON-stringified.
 
 declare let console: {
   debug(...args: any[]): void

package/standards/fetch.d.ts

@@ -1,6 +1,6 @@
 // The Fetch API cluster (Headers, Request, Response, fetch). A deliberate subset
 // of the WHATWG Fetch standard: flux provides exactly these members and no more
-// (no Blob, FormData, ReadableStream, arrayBuffer(), clone(), AbortSignal, ...).
+// (no Blob, FormData, ReadableStream, clone(), AbortSignal, ...).
 // Grouped in one file because the four share BodyInit/HeadersInit and reference
 // each other.
 
@@ -44,6 +44,28 @@ interface RequestInit {
   body?: BodyInit | null
   /** Request headers. */
   headers?: HeadersInit
+  /**
+   * Disk-cache policy, explicit and per call. flux never caches by default
+   * (like Node/Bun/Deno), and server cache headers (`cache-control`,
+   * `expires`, `etag`) are ignored entirely: the caller decides.
+   *
+   * - `"force-cache"`: serve from disk if stored, otherwise fetch and store.
+   *   No freshness, no TTL: the entry lives until evicted by the size cap or
+   *   overwritten by `"reload"`. Use for assets (images, audio, fonts);
+   *   versioned URLs are the normal way to handle updatable assets.
+   * - `"reload"`: fetch fresh and overwrite the stored entry.
+   * - `"default"`, `"no-store"`, `"no-cache"`: accepted, plain network
+   *   request (all equivalent to omitting the option here; there is no
+   *   freshness model to modulate).
+   *
+   * Only GET requests with 2xx responses are cached, keyed by URL; on other
+   * methods the option is ignored. Unknown values throw.
+   *
+   * Cached fetches queue on a small per-host concurrency limit so asset
+   * floods stay polite; disk hits and plain (uncached) fetches are never
+   * throttled.
+   */
+  cache?: "force-cache" | "reload" | "default" | "no-store" | "no-cache"
 }
 
 /**
@@ -62,6 +84,8 @@ interface Request {
   text(): Promise<string>
   /** Read the whole body as raw bytes. */
   bytes(): Promise<Uint8Array>
+  /** Read the whole body as an ArrayBuffer. */
+  arrayBuffer(): Promise<ArrayBuffer>
   /** Read and parse the whole body as JSON. */
   json(): Promise<any>
 }
@@ -93,6 +117,8 @@ interface Response {
   text(): Promise<string>
   /** Read the whole body as raw bytes. */
   bytes(): Promise<Uint8Array>
+  /** Read the whole body as an ArrayBuffer. */
+  arrayBuffer(): Promise<ArrayBuffer>
   /** Read and parse the whole body as JSON. */
   json(): Promise<any>
 }

package/standards/time.d.ts

@@ -7,15 +7,15 @@
  * {@link clearTimeout}.
  */
 declare function setTimeout(callback: () => void, ms: number): number
-/** Cancel a pending timeout. Throws on an unknown id. */
-declare function clearTimeout(id: number): void
+/** Cancel a pending timeout. Unknown or missing ids are ignored. */
+declare function clearTimeout(id?: number): void
 /**
  * Run `callback` every `ms` milliseconds. Returns a timer id for
  * {@link clearInterval}.
  */
 declare function setInterval(callback: () => void, ms: number): number
-/** Cancel a running interval. Throws on an unknown id. */
-declare function clearInterval(id: number): void
+/** Cancel a running interval. Unknown or missing ids are ignored. */
+declare function clearInterval(id?: number): void
 /**
  * Queue `callback` to run as a microtask: after the current job finishes, before
  * any timer fires.