@asenajs/ergenecore 4.0.0 → 5.0.1

package/dist/lib/utils/staticFileReader.d.ts

@@ -0,0 +1,27 @@
+import { type Stats } from 'fs';
+export declare function staticFileHeaders(type: string, etag: string, lastModified: string): Headers;
+export interface StaticFileRead {
+    readonly bytes: Uint8Array<ArrayBuffer> | undefined;
+    readonly type: string;
+    readonly etag: string;
+    readonly lastModified: string;
+}
+export declare function regularFileStats(filePath: string): Stats | undefined;
+/**
+ * Reads small regular files from disk on every call through a bounded set of open descriptors.
+ * Nothing but the descriptor and derived metadata outlives a call; the bytes are always fresh.
+ */
+export declare class StaticFileReader {
+    private readonly maxFileBytes;
+    private readonly maxOpen;
+    private readonly files;
+    constructor(maxFileBytes?: number, maxOpen?: number);
+    read(filePath: string, stats: Stats, withBody: boolean): StaticFileRead;
+    respond(filePath: string, stats: Stats, withBody: boolean): Response;
+    private refresh;
+    release(filePath: string): void;
+    close(): void;
+    private readBytes;
+    private entry;
+    private forget;
+}

package/dist/lib/utils/staticFileReader.js

@@ -0,0 +1,172 @@
+import { closeSync, fstatSync, openSync, readSync, statSync } from 'fs';
+const IS_WINDOWS = process.platform === 'win32';
+export function staticFileHeaders(type, etag, lastModified) {
+    const headers = new Headers();
+    headers.set('Content-Type', type);
+    headers.set('ETag', etag);
+    headers.set('Last-Modified', lastModified);
+    return headers;
+}
+function defaultStaticHeaders(type, etag, lastModified) {
+    const headers = new Headers();
+    headers.set('Content-Type', type);
+    headers.set('ETag', etag);
+    headers.set('Last-Modified', lastModified);
+    headers.set('Cache-Control', 'public, max-age=0');
+    return headers;
+}
+export function regularFileStats(filePath) {
+    try {
+        const stats = statSync(filePath);
+        return stats.isFile() ? stats : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function closeQuietly(fd) {
+    try {
+        closeSync(fd);
+    }
+    catch {
+        return;
+    }
+}
+/**
+ * Reads small regular files from disk on every call through a bounded set of open descriptors.
+ * Nothing but the descriptor and derived metadata outlives a call; the bytes are always fresh.
+ */
+export class StaticFileReader {
+    maxFileBytes;
+    maxOpen;
+    files = new Map();
+    constructor(maxFileBytes = 64 * 1024, maxOpen = 64) {
+        this.maxFileBytes = maxFileBytes;
+        this.maxOpen = maxOpen;
+    }
+    read(filePath, stats, withBody) {
+        const entry = IS_WINDOWS ? undefined : this.entry(filePath, stats);
+        if (entry === undefined) {
+            const lastModifiedMs = Math.trunc(stats.mtimeMs);
+            return {
+                bytes: undefined,
+                type: Bun.file(filePath).type,
+                etag: `W/"${stats.size}-${lastModifiedMs}"`,
+                lastModified: new Date(lastModifiedMs).toUTCString(),
+            };
+        }
+        this.refresh(entry, stats);
+        return {
+            bytes: withBody ? this.readBytes(filePath, entry, stats.size) : undefined,
+            type: entry.type,
+            etag: entry.etag,
+            lastModified: entry.lastModified,
+        };
+    }
+    respond(filePath, stats, withBody) {
+        const entry = IS_WINDOWS ? undefined : this.entry(filePath, stats);
+        if (entry === undefined) {
+            const lastModifiedMs = Math.trunc(stats.mtimeMs);
+            const file = Bun.file(filePath);
+            return new Response(file, {
+                status: 200,
+                headers: defaultStaticHeaders(file.type, `W/"${stats.size}-${lastModifiedMs}"`, new Date(lastModifiedMs).toUTCString()),
+            });
+        }
+        this.refresh(entry, stats);
+        const headers = (entry.headers ??= defaultStaticHeaders(entry.type, entry.etag, entry.lastModified));
+        const bytes = withBody ? this.readBytes(filePath, entry, stats.size) : undefined;
+        return new Response(bytes ?? Bun.file(filePath), { status: 200, headers });
+    }
+    refresh(entry, stats) {
+        const lastModifiedMs = Math.trunc(stats.mtimeMs);
+        if (entry.mtimeMs === lastModifiedMs && entry.size === stats.size) {
+            return;
+        }
+        if (entry.mtimeMs !== lastModifiedMs) {
+            entry.mtimeMs = lastModifiedMs;
+            entry.lastModified = new Date(lastModifiedMs).toUTCString();
+        }
+        entry.size = stats.size;
+        entry.etag = `W/"${stats.size}-${lastModifiedMs}"`;
+        entry.headers = undefined;
+    }
+    release(filePath) {
+        const entry = this.files.get(filePath);
+        if (entry !== undefined) {
+            this.forget(filePath, entry);
+        }
+    }
+    close() {
+        for (const entry of this.files.values()) {
+            closeQuietly(entry.fd);
+        }
+        this.files.clear();
+    }
+    readBytes(filePath, entry, size) {
+        if (size > this.maxFileBytes) {
+            return undefined;
+        }
+        const bytes = Buffer.allocUnsafeSlow(size);
+        try {
+            return readSync(entry.fd, bytes, 0, size, 0) === size ? bytes : undefined;
+        }
+        catch {
+            this.forget(filePath, entry);
+            return undefined;
+        }
+    }
+    entry(filePath, stats) {
+        const existing = this.files.get(filePath);
+        if (existing !== undefined) {
+            if (existing.ino === stats.ino && existing.dev === stats.dev) {
+                return existing;
+            }
+            this.forget(filePath, existing);
+        }
+        if (stats.size > this.maxFileBytes) {
+            return undefined;
+        }
+        let fd;
+        try {
+            fd = openSync(filePath, 'r');
+        }
+        catch {
+            return undefined;
+        }
+        let opened;
+        try {
+            opened = fstatSync(fd);
+        }
+        catch {
+            closeQuietly(fd);
+            return undefined;
+        }
+        if (opened.ino !== stats.ino || opened.dev !== stats.dev || !opened.isFile()) {
+            closeQuietly(fd);
+            return undefined;
+        }
+        while (this.files.size >= this.maxOpen) {
+            const [oldestPath, oldest] = this.files.entries().next().value;
+            this.forget(oldestPath, oldest);
+        }
+        const entry = {
+            fd,
+            ino: stats.ino,
+            dev: stats.dev,
+            type: Bun.file(filePath).type,
+            mtimeMs: -1,
+            size: -1,
+            etag: '',
+            lastModified: '',
+            headers: undefined,
+        };
+        this.files.set(filePath, entry);
+        return entry;
+    }
+    forget(filePath, entry) {
+        this.files.delete(filePath);
+        closeQuietly(entry.fd);
+    }
+}
+//# sourceMappingURL=staticFileReader.js.map

package/dist/lib/utils/staticFileReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticFileReader.js","sourceRoot":"","sources":["../../../lib/utils/staticFileReader.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -9,9 +9,13 @@
     "README.md",
     "LICENSE"
   ],
-  "version": "4.0.0",
+  "version": "5.0.1",
   "author": "LibirSoft",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AsenaJs/ergenecore.git"
+  },
   "engines": {
     "bun": ">=1.4.0"
   },
@@ -37,7 +41,7 @@
     "release": "bun run build && changeset publish"
   },
   "devDependencies": {
-    "@asenajs/asena": "^0.11.0",
+    "@asenajs/asena": "^0.12.0",
     "@changesets/cli": "^2.31.1",
     "@types/bun": "latest",
     "@typescript-eslint/eslint-plugin": "^8.68.0",
@@ -56,7 +60,7 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@asenajs/asena": "^0.11.0",
+    "@asenajs/asena": "^0.12.0",
     "typescript": "^5.9.3",
     "zod": "^4.3.6"
   }