@kensio/yulin 0.2.0 → 0.4.0

package/dist/service/s3/storage/s3-bucket-storage.js

@@ -1,64 +1,2 @@
-/**
- * Default in-memory simulated S3 Bucket storage.
- */
-export class MemoryS3BucketStorage {
-    objects = new Map();
-    /**
-     * Get a simulated Object from in-memory storage.
-     */
-    getObject(key) {
-        return Promise.resolve(this.objects.get(key));
-    }
-    /**
-     * List simulated Objects in in-memory storage.
-     */
-    listObjects(prefix) {
-        const objects = [...this.objects.entries()]
-            .filter(([key]) => prefix === undefined || key.startsWith(prefix))
-            .map(([, object]) => object);
-        return Promise.resolve(objects);
-    }
-    /**
-     * Put a simulated Object into in-memory storage.
-     */
-    putObject(object) {
-        this.objects.set(object.key, object);
-        return Promise.resolve();
-    }
-}
-// /**
-//  * Maps simulated S3 Objects to files under a directory.
-//  */
-// export class FilesystemS3BucketStorage implements SimS3BucketStorage {
-//   /**
-//    * Get a simulated Object from a file in the directory.
-//    */
-//   getObject(key: string): Promise<SimS3Object | undefined> {
-//     return Promise.resolve();
-//   }
-//
-//   /**
-//    * List simulated Objects based on files in the directory.
-//    */
-//   listObjects(prefix?: string): Promise<SimS3Object[]> {
-//     return Promise.resolve([]);
-//   }
-//
-//   /**
-//    * Store a simulated Object as a file in the directory.
-//    * TODO: Keep some kind of manifest for object metadata.
-//    */
-//   putObject(object: SimS3Object): Promise<void> {
-//     return Promise.resolve();
-//   }
-//
-//   /**
-//    * Is it OK to change to a different storage implementation?
-//    * For now, we're assuming that a user should not need to change from a
-//    * filesystem storage at runtime, so this is always false.
-//    */
-//   allowChangeStorage(): boolean {
-//     return false;
-//   }
-// }
+export {};
 //# sourceMappingURL=s3-bucket-storage.js.map

package/dist/service/s3/storage/s3-bucket-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"s3-bucket-storage.js","sourceRoot":"","sources":["../../../../src/service/s3/storage/s3-bucket-storage.ts"],"names":[],"mappings":"AAwBA;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACf,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE1D;;OAEG;IACH,SAAS,CAAC,GAAW;QACnB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAe;QACzB,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;aACxC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;aACjE,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QAE/B,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAmB;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CAUF;AAED,MAAM;AACN,2DAA2D;AAC3D,MAAM;AACN,yEAAyE;AACzE,QAAQ;AACR,4DAA4D;AAC5D,QAAQ;AACR,+DAA+D;AAC/D,gCAAgC;AAChC,MAAM;AACN,EAAE;AACF,QAAQ;AACR,+DAA+D;AAC/D,QAAQ;AACR,2DAA2D;AAC3D,kCAAkC;AAClC,MAAM;AACN,EAAE;AACF,QAAQ;AACR,4DAA4D;AAC5D,6DAA6D;AAC7D,QAAQ;AACR,oDAAoD;AACpD,gCAAgC;AAChC,MAAM;AACN,EAAE;AACF,QAAQ;AACR,iEAAiE;AACjE,4EAA4E;AAC5E,+DAA+D;AAC/D,QAAQ;AACR,oCAAoC;AACpC,oBAAoB;AACpB,MAAM;AACN,IAAI"}
+{"version":3,"file":"s3-bucket-storage.js","sourceRoot":"","sources":["../../../../src/service/s3/storage/s3-bucket-storage.ts"],"names":[],"mappings":""}

package/dist/service/s3/storage/s3-filesystem-storage.d.ts

@@ -0,0 +1,59 @@
+import type { SimS3BucketStorage } from "./s3-bucket-storage.js";
+import { SimS3Object } from "../object/s3-object.js";
+/**
+ * Maps simulated S3 Objects to files under a directory.
+ * This is useful for local development, such as serving a static website
+ * locally out of simulated S3.
+ * This class has some simple checks to reduce the risk of reading or writing
+ * files that might be unsafe, but it cannot completely protect against all
+ * potential safety issues.
+ */
+export declare class FilesystemS3BucketStorage implements SimS3BucketStorage {
+    private readonly directoryPath;
+    private readonly allowedDirectoryNames;
+    constructor(directoryPath: string, options?: FilesystemS3BucketStorageOptions);
+    /**
+     * Get a simulated Object from a file in the directory.
+     */
+    getObject(key: string): Promise<SimS3Object | undefined>;
+    /**
+     * List simulated Objects based on files in the directory.
+     */
+    listObjects(prefix?: string): Promise<SimS3Object[]>;
+    /**
+     * Store a simulated Object as a file in the directory.
+     */
+    putObject(object: SimS3Object): Promise<void>;
+    /**
+     * Is it OK to change to a different storage implementation?
+     * For now, we're assuming that a user should not need to change from a
+     * filesystem storage at runtime, so this is always false.
+     */
+    allowChangeStorage(): boolean;
+    private filePathForObjectKey;
+    private listObjectKeys;
+    private listObjectKeysInDirectory;
+    /**
+     * Make up reasonable metadata for an Object based on the file on disk.
+     */
+    private metadataForObjectKey;
+    /**
+     * Guess a reasonable content type for an Object key based on its file
+     * extension on disk.
+     */
+    private contentTypeForObjectKey;
+    private assertSafeDirectoryPath;
+    private assertSafeObjectKey;
+    private pathContainsParentDirectorySegment;
+    private isAllowedObjectKeyExtension;
+}
+/**
+ * Options for filesystem-based simulated S3 Bucket storage.
+ */
+export interface FilesystemS3BucketStorageOptions {
+    /**
+     * Directory names that are safe to use as filesystem storage roots.
+     */
+    readonly allowedDirectoryNames?: readonly string[];
+}
+//# sourceMappingURL=s3-filesystem-storage.d.ts.map

package/dist/service/s3/storage/s3-filesystem-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-filesystem-storage.d.ts","sourceRoot":"","sources":["../../../../src/service/s3/storage/s3-filesystem-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAuB,MAAM,wBAAwB,CAAC;AAK1E;;;;;;;GAOG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAoB;gBAGxD,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,gCAAqC;IAQhD;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAqB9D;;OAEG;IACG,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAmB1D;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASnD;;;;OAIG;IACH,kBAAkB,IAAI,OAAO;IAI7B,OAAO,CAAC,oBAAoB;YAkBd,cAAc;YAoBd,yBAAyB;IAiCvC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAqD/B,OAAO,CAAC,uBAAuB;IAuC/B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,kCAAkC;IAI1C,OAAO,CAAC,2BAA2B;CAGpC;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpD"}

package/dist/service/s3/storage/s3-filesystem-storage.js

@@ -0,0 +1,266 @@
+import { SimS3Object, SimS3ObjectMetadata } from "../object/s3-object.js";
+import path from "node:path";
+import { homedir } from "node:os";
+import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+/**
+ * Maps simulated S3 Objects to files under a directory.
+ * This is useful for local development, such as serving a static website
+ * locally out of simulated S3.
+ * This class has some simple checks to reduce the risk of reading or writing
+ * files that might be unsafe, but it cannot completely protect against all
+ * potential safety issues.
+ */
+export class FilesystemS3BucketStorage {
+    directoryPath;
+    allowedDirectoryNames;
+    constructor(directoryPath, options = {}) {
+        this.allowedDirectoryNames =
+            options.allowedDirectoryNames ?? defaultAllowedDirectoryNames;
+        this.assertSafeDirectoryPath(directoryPath);
+        this.directoryPath = path.resolve(directoryPath);
+    }
+    /**
+     * Get a simulated Object from a file in the directory.
+     */
+    async getObject(key) {
+        const filePath = this.filePathForObjectKey(key);
+        try {
+            // eslint-disable-next-line security/detect-non-literal-fs-filename
+            const body = await readFile(filePath);
+            return new SimS3Object(key, body, this.metadataForObjectKey(key));
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                "code" in error &&
+                error.code === "ENOENT") {
+                return undefined;
+            }
+            /* v8 ignore next */
+            throw error;
+        }
+    }
+    /**
+     * List simulated Objects based on files in the directory.
+     */
+    async listObjects(prefix) {
+        const objectKeys = await this.listObjectKeys();
+        return await Promise.all(objectKeys
+            .filter((key) => prefix === undefined || key.startsWith(prefix))
+            .map(async (key) => {
+            const object = await this.getObject(key);
+            /* v8 ignore next -- defensive guard for filesystem race */
+            if (object === undefined) {
+                throw new Error(`Object listed but not found: ${key}`);
+            }
+            return object;
+        }));
+    }
+    /**
+     * Store a simulated Object as a file in the directory.
+     */
+    async putObject(object) {
+        const filePath = this.filePathForObjectKey(object.key);
+        // eslint-disable-next-line security/detect-non-literal-fs-filename
+        await mkdir(path.dirname(filePath), { recursive: true });
+        // eslint-disable-next-line security/detect-non-literal-fs-filename
+        await writeFile(filePath, object.body);
+    }
+    /**
+     * Is it OK to change to a different storage implementation?
+     * For now, we're assuming that a user should not need to change from a
+     * filesystem storage at runtime, so this is always false.
+     */
+    allowChangeStorage() {
+        return false;
+    }
+    filePathForObjectKey(key) {
+        this.assertSafeObjectKey(key);
+        const filePath = path.resolve(this.directoryPath, key);
+        /* v8 ignore if -- defensive guard after object key validation */
+        if (filePath !== this.directoryPath &&
+            !filePath.startsWith(`${this.directoryPath}${path.sep}`)) {
+            throw new Error(`Invalid S3 Object key outside storage directory: ${key}`);
+        }
+        return filePath;
+    }
+    async listObjectKeys() {
+        try {
+            // eslint-disable-next-line security/detect-non-literal-fs-filename
+            await stat(this.directoryPath);
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                "code" in error &&
+                error.code === "ENOENT") {
+                return [];
+            }
+            /* v8 ignore next */
+            throw error;
+        }
+        return await this.listObjectKeysInDirectory(this.directoryPath);
+    }
+    async listObjectKeysInDirectory(directoryPath) {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename
+        const entries = await readdir(directoryPath, { withFileTypes: true });
+        const keys = [];
+        const nestedKeyPromises = [];
+        for (const entry of entries) {
+            const entryPath = path.join(directoryPath, entry.name);
+            if (entry.isDirectory()) {
+                nestedKeyPromises.push(this.listObjectKeysInDirectory(entryPath));
+                continue;
+            }
+            if (entry.isFile()) {
+                const key = path
+                    .relative(this.directoryPath, entryPath)
+                    .split(path.sep)
+                    .join("/");
+                if (this.isAllowedObjectKeyExtension(key)) {
+                    keys.push(key);
+                }
+            }
+        }
+        const nestedKeys = await Promise.all(nestedKeyPromises);
+        return [...keys, ...nestedKeys.flat()];
+    }
+    /**
+     * Make up reasonable metadata for an Object based on the file on disk.
+     */
+    metadataForObjectKey(key) {
+        const contentType = this.contentTypeForObjectKey(key);
+        /* v8 ignore if -- defensive fallback */
+        if (contentType === undefined) {
+            return new SimS3ObjectMetadata();
+        }
+        return new SimS3ObjectMetadata({
+            "content-type": contentType,
+        });
+    }
+    /**
+     * Guess a reasonable content type for an Object key based on its file
+     * extension on disk.
+     */
+    contentTypeForObjectKey(key) {
+        const extension = path.extname(key).toLowerCase();
+        switch (extension) {
+            case ".css": {
+                return "text/css";
+            }
+            case ".gif": {
+                return "image/gif";
+            }
+            case ".html":
+            case ".htm": {
+                return "text/html";
+            }
+            case ".ico": {
+                return "image/x-icon";
+            }
+            case ".jpeg":
+            case ".jpg": {
+                return "image/jpeg";
+            }
+            case ".js":
+            case ".mjs": {
+                return "text/javascript";
+            }
+            case ".json": {
+                return "application/json";
+            }
+            case ".map": {
+                return "application/json";
+            }
+            case ".png": {
+                return "image/png";
+            }
+            case ".svg": {
+                return "image/svg+xml";
+            }
+            case ".txt": {
+                return "text/plain";
+            }
+            case ".webp": {
+                return "image/webp";
+            }
+            case ".xml": {
+                return "application/xml";
+            }
+            default: {
+                /* v8 ignore next */
+                return undefined;
+            }
+        }
+    }
+    assertSafeDirectoryPath(directoryPath) {
+        if (!path.isAbsolute(directoryPath)) {
+            throw new Error(`Filesystem S3 storage directory path must be absolute: ${directoryPath}`);
+        }
+        if (this.pathContainsParentDirectorySegment(directoryPath)) {
+            throw new Error(`Filesystem S3 storage directory path must not contain '..': ${directoryPath}`);
+        }
+        const resolvedDirectoryPath = path.resolve(directoryPath);
+        const parsedDirectoryPath = path.parse(resolvedDirectoryPath);
+        if (resolvedDirectoryPath === parsedDirectoryPath.root) {
+            throw new Error(`Filesystem S3 storage directory path must not be a filesystem root: ${directoryPath}`);
+        }
+        if (resolvedDirectoryPath === path.resolve(homedir())) {
+            throw new Error(`Filesystem S3 storage directory path must not be the user home directory: ${directoryPath}`);
+        }
+        const directoryName = path.basename(resolvedDirectoryPath);
+        if (!this.allowedDirectoryNames.includes(directoryName)) {
+            throw new Error(`Filesystem S3 storage directory name must be one of: ${this.allowedDirectoryNames.join(", ")}. Got: ${directoryName}`);
+        }
+    }
+    assertSafeObjectKey(key) {
+        if (path.isAbsolute(key)) {
+            throw new Error(`S3 Object key must not be an absolute path: ${key}`);
+        }
+        if (this.pathContainsParentDirectorySegment(key)) {
+            throw new Error(`S3 Object key must not contain '..': ${key}`);
+        }
+        if (!this.isAllowedObjectKeyExtension(key)) {
+            throw new Error(`S3 Object key has unsupported file extension: ${key}`);
+        }
+    }
+    pathContainsParentDirectorySegment(value) {
+        return value.split(/[\\/]/u).includes("..");
+    }
+    isAllowedObjectKeyExtension(key) {
+        return allowedObjectFileExtensions.has(path.extname(key).toLowerCase());
+    }
+}
+/**
+ * Default directory names that are safe to use as filesystem storage roots.
+ */
+const defaultAllowedDirectoryNames = [
+    "assets",
+    "build",
+    "dist",
+    "out",
+    "public",
+    "static",
+    "www",
+];
+/**
+ * Cautious list of allowed file extensions for simulated S3 objects. This is to
+ * try and avoid reading or writing other files that might be unsafe.
+ */
+const allowedObjectFileExtensions = new Set([
+    ".css",
+    ".gif",
+    ".htm",
+    ".html",
+    ".ico",
+    ".jpeg",
+    ".jpg",
+    ".js",
+    ".json",
+    ".map",
+    ".mjs",
+    ".png",
+    ".svg",
+    ".txt",
+    ".webp",
+    ".xml",
+]);
+//# sourceMappingURL=s3-filesystem-storage.js.map

package/dist/service/s3/storage/s3-filesystem-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-filesystem-storage.js","sourceRoot":"","sources":["../../../../src/service/s3/storage/s3-filesystem-storage.ts"],"names":[],"mappings":"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"}

package/dist/service/s3/storage/s3-memory-storage.d.ts

@@ -0,0 +1,27 @@
+import type { SimS3Object } from "../object/s3-object.js";
+import type { SimS3BucketStorage } from "./s3-bucket-storage.js";
+/**
+ * Default in-memory simulated S3 Bucket storage.
+ */
+export declare class MemoryS3BucketStorage implements SimS3BucketStorage {
+    private readonly objects;
+    /**
+     * Get a simulated Object from in-memory storage.
+     */
+    getObject(key: string): Promise<SimS3Object | undefined>;
+    /**
+     * List simulated Objects in in-memory storage.
+     */
+    listObjects(prefix?: string): Promise<SimS3Object[]>;
+    /**
+     * Put a simulated Object into in-memory storage.
+     */
+    putObject(object: SimS3Object): Promise<void>;
+    /**
+     * Is it OK to change to a different storage implementation?
+     * To reduce unexpected behaviours, we disallow changing from in-memory
+     * storage if it currently contains any objects.
+     */
+    allowChangeStorage(): boolean;
+}
+//# sourceMappingURL=s3-memory-storage.d.ts.map

package/dist/service/s3/storage/s3-memory-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-memory-storage.d.ts","sourceRoot":"","sources":["../../../../src/service/s3/storage/s3-memory-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,qBAAa,qBAAsB,YAAW,kBAAkB;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAIxD;;OAEG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQpD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C;;;;OAIG;IACH,kBAAkB,IAAI,OAAO;CAG9B"}

package/dist/service/s3/storage/s3-memory-storage.js

@@ -0,0 +1,37 @@
+/**
+ * Default in-memory simulated S3 Bucket storage.
+ */
+export class MemoryS3BucketStorage {
+    objects = new Map();
+    /**
+     * Get a simulated Object from in-memory storage.
+     */
+    getObject(key) {
+        return Promise.resolve(this.objects.get(key));
+    }
+    /**
+     * List simulated Objects in in-memory storage.
+     */
+    listObjects(prefix) {
+        const objects = [...this.objects.entries()]
+            .filter(([key]) => prefix === undefined || key.startsWith(prefix))
+            .map(([, object]) => object);
+        return Promise.resolve(objects);
+    }
+    /**
+     * Put a simulated Object into in-memory storage.
+     */
+    putObject(object) {
+        this.objects.set(object.key, object);
+        return Promise.resolve();
+    }
+    /**
+     * Is it OK to change to a different storage implementation?
+     * To reduce unexpected behaviours, we disallow changing from in-memory
+     * storage if it currently contains any objects.
+     */
+    allowChangeStorage() {
+        return this.objects.size === 0;
+    }
+}
+//# sourceMappingURL=s3-memory-storage.js.map

package/dist/service/s3/storage/s3-memory-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-memory-storage.js","sourceRoot":"","sources":["../../../../src/service/s3/storage/s3-memory-storage.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACf,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE1D;;OAEG;IACH,SAAS,CAAC,GAAW;QACnB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAe;QACzB,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;aACxC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;aACjE,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QAE/B,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAmB;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/util/filesystem/temp-dir.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Create a temporary directory and return its path.
+ */
+export declare function makeTempDir(): Promise<string>;
+//# sourceMappingURL=temp-dir.d.ts.map

package/dist/util/filesystem/temp-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temp-dir.d.ts","sourceRoot":"","sources":["../../../src/util/filesystem/temp-dir.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAQnD"}

package/dist/util/filesystem/temp-dir.js

@@ -0,0 +1,14 @@
+import { mkdir, mkdtemp } from "node:fs/promises";
+import path from "node:path";
+import { tmpdir } from "node:os";
+/**
+ * Create a temporary directory and return its path.
+ */
+export async function makeTempDir() {
+    const tempRootPath = await mkdtemp(path.join(tmpdir(), "yulin-test-"));
+    const directoryPath = path.join(tempRootPath, "public");
+    // eslint-disable-next-line security/detect-non-literal-fs-filename
+    await mkdir(directoryPath);
+    return directoryPath;
+}
+//# sourceMappingURL=temp-dir.js.map

package/dist/util/filesystem/temp-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temp-dir.js","sourceRoot":"","sources":["../../../src/util/filesystem/temp-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IACvE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAExD,mEAAmE;IACnE,MAAM,KAAK,CAAC,aAAa,CAAC,CAAC;IAE3B,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kensio/yulin",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "AWS system behaviour simulation for isolated unit testing",
   "repository": "https://github.com/KensioSoftware/yulin",
   "type": "module",
@@ -15,19 +15,31 @@
     "isolated"
   ],
   "exports": {
+    "./package.json": "./package.json",
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     },
     "./cloudfront": {
-      "types": "./dist/service/cloudfront/index.d.ts",
-      "import": "./dist/service/cloudfront/index.js"
+      "import": "./dist/service/cloudfront/index.js",
+      "types": "./dist/service/cloudfront/index.d.ts"
     },
     "./cloudfront/globals": {
-      "types": "./dist/service/cloudfront/globals.d.ts",
-      "import": "./dist/service/cloudfront/globals.js"
+      "import": "./dist/service/cloudfront/globals.js",
+      "types": "./dist/service/cloudfront/globals.d.ts"
     },
-    "./package.json": "./package.json"
+    "./dynamodb": {
+      "import": "./dist/service/dynamodb/index.js",
+      "types": "./dist/service/dynamodb/index.d.ts"
+    },
+    "./s3": {
+      "import": "./dist/service/s3/index.js",
+      "types": "./dist/service/s3/index.d.ts"
+    },
+    "./serve": {
+      "import": "./dist/serve/index.js",
+      "types": "./dist/serve/index.d.ts"
+    }
   },
   "files": [
     "dist",
@@ -41,7 +53,7 @@
     "@aws-sdk/client-s3": "^3.1057.0",
     "@eslint/js": "^10.0.1",
     "@faker-js/faker": "^10.4.0",
-    "@kensio/smartass": "^1.0.2",
+    "@kensio/smartass": "^1.1.0",
     "@smithy/smithy-client": "^4.13.5",
     "@smithy/types": "^4.14.2",
     "@types/eslint-plugin-security": "^3.0.1",