@akashic/headless-driver 2.8.3 → 2.9.0

package/lib/runner/Platform.d.ts

@@ -1,5 +1,5 @@
 import type { AMFlow } from "@akashic/amflow";
-import type { RunnerRenderingMode } from "./types";
+import type { RunnerLoadFileHandler, RunnerRenderingMode } from "./types";
 export interface PlatformParameters {
     assetBaseUrl: string;
     configurationBaseUrl?: string;
@@ -8,7 +8,7 @@ export interface PlatformParameters {
     trusted?: boolean;
     renderingMode?: RunnerRenderingMode;
     errorHandler: (err: any) => void;
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
 }
 export declare abstract class Platform {
     amflow: AMFlow;
@@ -18,8 +18,8 @@ export declare abstract class Platform {
     renderingMode: RunnerRenderingMode;
     protected sendToExternalHandler: (data: any) => void;
     protected errorHandler: (err: any) => void;
-    protected loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    protected loadFileHandler: RunnerLoadFileHandler;
     constructor(param: PlatformParameters);
     sendToExternal(_playId: string, data: any): void;
-    loadGameConfiguration: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadGameConfiguration: (url: string, callback: (err: Error | null, data?: string | Uint8Array) => void) => void;
 }

package/lib/runner/Platform.js

@@ -6,7 +6,7 @@ class Platform {
         var _a;
         // eslint-disable-next-line @typescript-eslint/typedef
         this.loadGameConfiguration = (url, callback) => {
-            this.loadFileHandler(url, (err, str) => {
+            this.loadFileHandler(url, "utf-8", (err, str) => {
                 if (err) {
                     callback(err);
                 }
@@ -14,6 +14,7 @@ class Platform {
                     callback(new Error("Platform#loadGameConfiguration(): No data received"));
                 }
                 else {
+                    // FIXME: as の回避
                     callback(null, JSON.parse(str));
                 }
             });

package/lib/runner/Runner.d.ts

@@ -1,7 +1,7 @@
 import type { AMFlow } from "@akashic/amflow";
 import { Trigger } from "@akashic/trigger";
 import type { Platform } from "./Platform";
-import type { RunnerAdvanceConditionFunc, RunnerExecutionMode, RunnerPlayer, RunnerPointEvent, RunnerRenderingMode } from "./types";
+import type { RunnerAdvanceConditionFunc, RunnerExecutionMode, RunnerLoadFileHandler, RunnerPlayer, RunnerPointEvent, RunnerRenderingMode } from "./types";
 export interface RunnerParameters {
     contentUrl: string;
     assetBaseUrl: string;
@@ -14,7 +14,7 @@ export interface RunnerParameters {
     executionMode: RunnerExecutionMode;
     trusted?: boolean;
     renderingMode?: RunnerRenderingMode;
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
     external?: {
         [key: string]: string;
     };
@@ -52,7 +52,7 @@ export declare abstract class Runner {
     get executionMode(): RunnerExecutionMode;
     get trusted(): boolean;
     get renderingMode(): RunnerRenderingMode;
-    get loadFileHandler(): (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    get loadFileHandler(): RunnerLoadFileHandler;
     get gameArgs(): any;
     get player(): RunnerPlayer | undefined;
     get external(): {

package/lib/runner/RunnerManager.d.ts

@@ -1,6 +1,7 @@
 import { NodeVM } from "vm2";
 import type { AMFlowClient } from "../play/amflow/AMFlowClient";
 import type { PlayManager } from "../play/PlayManager";
+import type { EncodingType } from "../utils";
 import type { RunnerStartParameters } from "./Runner";
 import type { RunnerExecutionMode, RunnerPlayer, RunnerRenderingMode } from "./types";
 import type { RunnerV1, RunnerV1Game } from "./v1";
@@ -114,7 +115,7 @@ export declare class RunnerManager {
     protected resolveContent(contentUrl: string): Promise<EngineConfiguration>;
     protected resolveGameConfiguration(gameJsonUrl: string): Promise<GameConfiguration>;
     protected loadJSON<T>(contentUrl: string): Promise<T>;
-    protected createLoadFileHandler(allowedUrls: (string | RegExp)[] | null): (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    protected createLoadFileHandler(allowedUrls: (string | RegExp)[] | null): (url: string, encoding: EncodingType, callback: (err: Error | null, data?: string | Uint8Array) => void) => void;
     protected createVm(trusted?: boolean): NodeVM;
 }
 export {};

package/lib/runner/RunnerManager.js

@@ -14,9 +14,9 @@ const fs = require("fs");
 const path = require("path");
 const url = require("url");
 const vm2_1 = require("vm2");
-const ExecVmScriptV3 = require("..//ExecuteVmScriptV3");
 const ExecVmScriptV1 = require("../ExecuteVmScriptV1");
 const ExecVmScriptV2 = require("../ExecuteVmScriptV2");
+const ExecVmScriptV3 = require("../ExecuteVmScriptV3");
 const Logger_1 = require("../Logger");
 const utils_1 = require("../utils");
 const requireEngineFiles_1 = require("./v3/requireEngineFiles");
@@ -257,11 +257,11 @@ class RunnerManager {
     }
     loadJSON(contentUrl) {
         return __awaiter(this, void 0, void 0, function* () {
-            return (0, utils_1.loadFile)(contentUrl).then((text) => JSON.parse(text));
+            return (0, utils_1.loadFile)(contentUrl, "utf-8").then((text) => JSON.parse(text));
         });
     }
     createLoadFileHandler(allowedUrls) {
-        return (url, callback) => {
+        return (url, encoding, callback) => {
             if (allowedUrls != null) {
                 const isAllowedUrl = allowedUrls.some((u) => {
                     if (typeof u === "string") {
@@ -276,7 +276,7 @@ class RunnerManager {
                     return void callback(new Error(`Not allowed to read this URL. ${url}`));
                 }
             }
-            (0, utils_1.loadFile)(url)
+            (0, utils_1.loadFile)(url, encoding)
                 .then((text) => {
                 callback(null, text);
             })

package/lib/runner/types.d.ts

@@ -1,3 +1,4 @@
+import type { EncodingType } from "../utils";
 export type RunnerExecutionMode = "active" | "passive";
 export type RunnerRenderingMode = "none" | "canvas";
 export type RunnerAdvanceConditionFunc = () => boolean;
@@ -13,3 +14,4 @@ export interface RunnerPlayer {
     id: string;
     name: string;
 }
+export type RunnerLoadFileHandler = (url: string, encoding: EncodingType, callback: (err: Error | null, data?: string | Uint8Array) => void) => void;

package/lib/runner/v1/RunnerV1.js

@@ -175,7 +175,7 @@ class RunnerV1 extends Runner_1.Runner {
                 renderingMode: this.renderingMode,
                 sendToExternalHandler: (data) => this.onSendedToExternal(data),
                 errorHandler: (e) => this.onError(e),
-                loadFileHandler: (url, callback) => this.loadFileHandler(url, callback)
+                loadFileHandler: (url, encoding, callback) => this.loadFileHandler(url, encoding, callback)
             });
             this.pause();
             const driver = new engine_files_v1_1.gameDriver.GameDriver({

package/lib/runner/v1/platform/ResourceFactory.d.ts

@@ -1,6 +1,7 @@
 import { akashicEngine as g } from "engine-files-v1";
+import type { RunnerLoadFileHandler } from "../../types";
 export interface ResourceFactoryParameters {
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
     errorHandler: (err: any) => void;
 }
 export declare class ResourceFactory extends g.ResourceFactory {

package/lib/runner/v1/platform/assets/NodeScriptAsset.d.ts

@@ -1,9 +1,10 @@
 import { akashicEngine as g } from "engine-files-v1";
+import type { RunnerLoadFileHandler } from "../../../types";
 export interface NodeScriptAssetParameters {
     id: string;
     path: string;
     errorHandler: (err: any) => void;
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
 }
 export declare class NodeScriptAsset extends g.ScriptAsset {
     static PRE_SCRIPT: string;

package/lib/runner/v1/platform/assets/NodeScriptAsset.js

@@ -9,7 +9,7 @@ class NodeScriptAsset extends engine_files_v1_1.akashicEngine.ScriptAsset {
         this.loadFileHandler = param.loadFileHandler;
     }
     _load(loader) {
-        this.loadFileHandler(this.path, (err, text) => {
+        this.loadFileHandler(this.path, "utf-8", (err, text) => {
             // NOTE: 過去バージョンのため型については精査しない
             if (err) {
                 loader._onAssetError(this, err);

package/lib/runner/v1/platform/assets/NodeTextAsset.d.ts

@@ -1,8 +1,9 @@
 import { akashicEngine as g } from "engine-files-v1";
+import type { RunnerLoadFileHandler } from "../../../types";
 export interface NodeTextAssetParameters {
     id: string;
     path: string;
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
 }
 export declare class NodeTextAsset extends g.TextAsset {
     private loadFileHandler;

package/lib/runner/v1/platform/assets/NodeTextAsset.js

@@ -8,7 +8,7 @@ class NodeTextAsset extends engine_files_v1_1.akashicEngine.TextAsset {
         this.loadFileHandler = param.loadFileHandler;
     }
     _load(loader) {
-        this.loadFileHandler(this.path, (err, text) => {
+        this.loadFileHandler(this.path, "utf-8", (err, text) => {
             // NOTE: 過去バージョンのため型については精査しない
             if (err) {
                 loader._onAssetError(this, err);

package/lib/runner/v2/RunnerV2.js

@@ -175,7 +175,7 @@ class RunnerV2 extends Runner_1.Runner {
                 renderingMode: this.renderingMode,
                 sendToExternalHandler: (data) => this.onSendedToExternal(data),
                 errorHandler: (e) => this.onError(e),
-                loadFileHandler: (url, callback) => this.loadFileHandler(url, callback)
+                loadFileHandler: (url, encoding, callback) => this.loadFileHandler(url, encoding, callback)
             });
             this.pause();
             const driver = new engine_files_v2_1.gameDriver.GameDriver({

package/lib/runner/v2/platform/ResourceFactory.d.ts

@@ -1,6 +1,7 @@
 import { akashicEngine as g } from "engine-files-v2";
+import type { RunnerLoadFileHandler } from "../../types";
 export interface ResourceFactoryParameters {
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
     errorHandler: (err: any) => void;
 }
 export declare class ResourceFactory extends g.ResourceFactory {

package/lib/runner/v2/platform/assets/NodeScriptAsset.d.ts

@@ -1,9 +1,10 @@
 import { akashicEngine as g } from "engine-files-v2";
+import type { RunnerLoadFileHandler } from "../../../types";
 export interface NodeScriptAssetParameters {
     id: string;
     path: string;
     errorHandler: (err: any) => void;
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
 }
 export declare class NodeScriptAsset extends g.ScriptAsset {
     static PRE_SCRIPT: string;

package/lib/runner/v2/platform/assets/NodeScriptAsset.js

@@ -9,7 +9,7 @@ class NodeScriptAsset extends engine_files_v2_1.akashicEngine.ScriptAsset {
         this.loadFileHandler = param.loadFileHandler;
     }
     _load(loader) {
-        this.loadFileHandler(this.path, (err, text) => {
+        this.loadFileHandler(this.path, "utf-8", (err, text) => {
             // NOTE: 過去バージョンのため型については精査しない
             if (err) {
                 loader._onAssetError(this, err);

package/lib/runner/v2/platform/assets/NodeTextAsset.d.ts

@@ -1,8 +1,9 @@
 import { akashicEngine as g } from "engine-files-v2";
+import type { RunnerLoadFileHandler } from "../../../types";
 export interface NodeTextAssetParameters {
     id: string;
     path: string;
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
 }
 export declare class NodeTextAsset extends g.TextAsset {
     private loadFileHandler;

package/lib/runner/v2/platform/assets/NodeTextAsset.js

@@ -8,7 +8,7 @@ class NodeTextAsset extends engine_files_v2_1.akashicEngine.TextAsset {
         this.loadFileHandler = param.loadFileHandler;
     }
     _load(loader) {
-        this.loadFileHandler(this.path, (err, text) => {
+        this.loadFileHandler(this.path, "utf-8", (err, text) => {
             // NOTE: 過去バージョンのため型については精査しない
             if (err) {
                 loader._onAssetError(this, err);

package/lib/runner/v3/RunnerV3.js

@@ -191,7 +191,7 @@ class RunnerV3 extends Runner_1.Runner {
                 renderingMode: this.renderingMode,
                 sendToExternalHandler: (data) => this.onSendedToExternal(data),
                 errorHandler: (e) => this.onError(e),
-                loadFileHandler: (url, callback) => this.loadFileHandler(url, callback)
+                loadFileHandler: (url, encoding, callback) => this.loadFileHandler(url, encoding, callback)
             });
             this.pause();
             const driver = new engineFiles_1.gameDriver.GameDriver({

package/lib/runner/v3/platform/NodeCanvasResourceFactory.d.ts

@@ -1,6 +1,7 @@
+import type { RunnerLoadFileHandler } from "../../types";
 import type { akashicEngine as g } from "../engineFiles";
 export interface NodeCanvasResourceFactoryParameters {
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
     errorHandler: (err: Error) => void;
 }
 /**
@@ -17,6 +18,7 @@ export declare class NodeCanvasResourceFactory implements g.ResourceFactory {
     createAudioPlayer(system: g.AudioSystem): g.AudioPlayer;
     createTextAsset(id: string, assetPath: string): g.TextAsset;
     createScriptAsset(id: string, assetPath: string): g.ScriptAsset;
+    createBinaryAsset(id: string, assetPath: string): g.BinaryAsset;
     createSurface(width: number, height: number): g.Surface;
     createGlyphFactory(fontFamily: string | string[], fontSize: number, baselineHeight?: number, fontColor?: string, strokeWidth?: number, strokeColor?: string, strokeOnly?: boolean, fontWeight?: g.FontWeightString): g.GlyphFactory;
 }

package/lib/runner/v3/platform/NodeCanvasResourceFactory.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeCanvasResourceFactory = void 0;
 const canvas_1 = require("canvas");
+const NodeBinaryAsset_1 = require("./assets/NodeBinaryAsset");
 const NodeScriptAsset_1 = require("./assets/NodeScriptAsset");
 const NodeTextAsset_1 = require("./assets/NodeTextAsset");
 const NullAudioAsset_1 = require("./audios/NullAudioAsset");
@@ -46,6 +47,13 @@ class NodeCanvasResourceFactory {
             loadFileHandler: this.loadFileHandler
         });
     }
+    createBinaryAsset(id, assetPath) {
+        return new NodeBinaryAsset_1.NodeBinaryAsset({
+            id,
+            path: assetPath,
+            loadFileHandler: this.loadFileHandler
+        });
+    }
     createSurface(width, height) {
         const canvas = new canvas_1.Canvas(width, height);
         return new NodeCanvasSurface_1.NodeCanvasSurface(canvas);

package/lib/runner/v3/platform/NullResourceFactory.d.ts

@@ -1,6 +1,7 @@
+import type { RunnerLoadFileHandler } from "../../types";
 import type { akashicEngine as g } from "../engineFiles";
 export interface NullResourceFactoryParameters {
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
     errorHandler: (err: Error) => void;
 }
 /**
@@ -16,6 +17,7 @@ export declare class NullResourceFactory implements g.ResourceFactory {
     createAudioPlayer(system: g.AudioSystem): g.AudioPlayer;
     createTextAsset(id: string, assetPath: string): g.TextAsset;
     createScriptAsset(id: string, assetPath: string): g.ScriptAsset;
+    createBinaryAsset(id: string, assetPath: string): g.BinaryAsset;
     createSurface(width: number, height: number): g.Surface;
     createGlyphFactory(fontFamily: string | string[], fontSize: number, baselineHeight?: number, fontColor?: string, strokeWidth?: number, strokeColor?: string, strokeOnly?: boolean, fontWeight?: g.FontWeightString): g.GlyphFactory;
 }

package/lib/runner/v3/platform/NullResourceFactory.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NullResourceFactory = void 0;
+const NodeBinaryAsset_1 = require("./assets/NodeBinaryAsset");
 const NodeScriptAsset_1 = require("./assets/NodeScriptAsset");
 const NodeTextAsset_1 = require("./assets/NodeTextAsset");
 const NullAudioAsset_1 = require("./audios/NullAudioAsset");
@@ -44,6 +45,13 @@ class NullResourceFactory {
             loadFileHandler: this.loadFileHandler
         });
     }
+    createBinaryAsset(id, assetPath) {
+        return new NodeBinaryAsset_1.NodeBinaryAsset({
+            id,
+            path: assetPath,
+            loadFileHandler: this.loadFileHandler
+        });
+    }
     createSurface(width, height) {
         return new NullSurface_1.NullSurface(width, height);
     }

package/lib/runner/v3/platform/assets/NodeBinaryAsset.d.ts

@@ -0,0 +1,15 @@
+import type { RunnerLoadFileHandler } from "../../../types";
+import type { akashicEngine as g } from "../../engineFiles";
+import { Asset } from "./Asset";
+export interface NodeBinaryAssetParameters {
+    id: string;
+    path: string;
+    loadFileHandler: RunnerLoadFileHandler;
+}
+export declare class NodeBinaryAsset extends Asset implements g.BinaryAsset {
+    type: "binary";
+    data: ArrayBuffer;
+    private loadFileHandler;
+    constructor(param: NodeBinaryAssetParameters);
+    _load(loader: g.AssetLoadHandler): void;
+}

package/lib/runner/v3/platform/assets/NodeBinaryAsset.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeBinaryAsset = void 0;
+const Asset_1 = require("./Asset");
+class NodeBinaryAsset extends Asset_1.Asset {
+    constructor(param) {
+        super(param.id, param.path);
+        this.type = "binary";
+        this.loadFileHandler = param.loadFileHandler;
+    }
+    _load(loader) {
+        this.loadFileHandler(this.path, "uint8array", (err, data) => {
+            if (err) {
+                loader._onAssetError(this, {
+                    name: "AssetLoadError",
+                    message: err.message,
+                    retriable: false
+                });
+            }
+            else if (data == null) {
+                loader._onAssetError(this, {
+                    name: "AssetLoadError",
+                    message: "NodeBinaryAsset#_load(): No data received",
+                    retriable: false
+                });
+            }
+            else {
+                // FIXME: as の回避
+                const arrayBuffer = toArrayBuffer(data);
+                this.data = arrayBuffer;
+                loader._onAssetLoad(this);
+            }
+        });
+    }
+}
+exports.NodeBinaryAsset = NodeBinaryAsset;
+function toArrayBuffer(typedArray) {
+    // sandbox の外側で初期化された TypedArray の .buffer を参照しても内容が正常に取得できないため、新たに TypedArray を生成し直す
+    const arrayBuffer = new ArrayBuffer(typedArray.length);
+    const view = new Uint8Array(arrayBuffer);
+    for (let i = 0; i < typedArray.length; ++i) {
+        view[i] = typedArray[i];
+    }
+    return arrayBuffer;
+}

package/lib/runner/v3/platform/assets/NodeScriptAsset.d.ts

@@ -1,16 +1,17 @@
+import type { RunnerLoadFileHandler } from "../../../types";
 import type { akashicEngine as g } from "../../engineFiles";
 import { Asset } from "./Asset";
 export interface NodeScriptAssetParameters {
     id: string;
     path: string;
+    exports?: string[];
     errorHandler: (err: any) => void;
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
 }
 export declare class NodeScriptAsset extends Asset implements g.ScriptAsset {
-    static PRE_SCRIPT: string;
-    static POST_SCRIPT: string;
     type: "script";
     script: string;
+    exports: string[];
     private errorHandler;
     private loadFileHandler;
     constructor(param: NodeScriptAssetParameters);

package/lib/runner/v3/platform/assets/NodeScriptAsset.js

@@ -4,14 +4,16 @@ exports.NodeScriptAsset = void 0;
 const Asset_1 = require("./Asset");
 class NodeScriptAsset extends Asset_1.Asset {
     constructor(param) {
+        var _a;
         super(param.id, param.path);
         this.type = "script";
         this.script = "";
+        this.exports = (_a = param.exports) !== null && _a !== void 0 ? _a : [];
         this.errorHandler = param.errorHandler;
         this.loadFileHandler = param.loadFileHandler;
     }
     _load(loader) {
-        this.loadFileHandler(this.path, (err, text) => {
+        this.loadFileHandler(this.path, "utf-8", (err, text) => {
             if (err) {
                 loader._onAssetError(this, {
                     name: "AssetLoadError",
@@ -27,13 +29,23 @@ class NodeScriptAsset extends Asset_1.Asset {
                 });
             }
             else {
+                // FIXME: as の回避
                 this.script = text;
                 loader._onAssetLoad(this);
             }
         });
     }
     execute(execEnv) {
-        const func = new Function("g", NodeScriptAsset.PRE_SCRIPT + this.script + NodeScriptAsset.POST_SCRIPT);
+        let postScript = "";
+        for (const key of this.exports) {
+            postScript += `exports["${key}"] = typeof ${key} !== "undefined" ? ${key} : undefined;\n`;
+        }
+        const func = new Function("g", "(function(exports, require, module, __filename, __dirname) {\n" +
+            this.script +
+            "\n" +
+            postScript +
+            "\n" +
+            "})(g.module.exports, g.module.require, g.module, g.filename, g.dirname);");
         try {
             func(execEnv);
         }
@@ -43,6 +55,4 @@ class NodeScriptAsset extends Asset_1.Asset {
         return execEnv.module.exports;
     }
 }
-NodeScriptAsset.PRE_SCRIPT = "(function(exports, require, module, __filename, __dirname) {\n";
-NodeScriptAsset.POST_SCRIPT = "\n})(g.module.exports, g.module.require, g.module, g.filename, g.dirname);";
 exports.NodeScriptAsset = NodeScriptAsset;

package/lib/runner/v3/platform/assets/NodeTextAsset.d.ts

@@ -1,9 +1,10 @@
+import type { RunnerLoadFileHandler } from "../../../types";
 import type { akashicEngine as g } from "../../engineFiles";
 import { Asset } from "./Asset";
 export interface NodeTextAssetParameters {
     id: string;
     path: string;
-    loadFileHandler: (url: string, callback: (err: Error | null, data?: string) => void) => void;
+    loadFileHandler: RunnerLoadFileHandler;
 }
 export declare class NodeTextAsset extends Asset implements g.TextAsset {
     type: "text";

package/lib/runner/v3/platform/assets/NodeTextAsset.js

@@ -10,7 +10,7 @@ class NodeTextAsset extends Asset_1.Asset {
         this.loadFileHandler = param.loadFileHandler;
     }
     _load(loader) {
-        this.loadFileHandler(this.path, (err, text) => {
+        this.loadFileHandler(this.path, "utf-8", (err, text) => {
             if (err) {
                 loader._onAssetError(this, {
                     name: "AssetLoadError",
@@ -26,6 +26,7 @@ class NodeTextAsset extends Asset_1.Asset {
                 });
             }
             else {
+                // FIXME: as の回避
                 this.data = text;
                 loader._onAssetLoad(this);
             }

package/lib/utils.d.ts

@@ -1,9 +1,12 @@
+export type EncodingType = "utf-8" | "uint8array";
 /**
  * ファイルを読み込む。
  *
  * @param url url または path
  */
-export declare function loadFile(url: string): Promise<string>;
+export declare function loadFile(url: string, encoding: EncodingType): Promise<string | Uint8Array>;
+export declare function loadFile(url: string, encoding: "utf-8"): Promise<string>;
+export declare function loadFile(url: string, encoding: "uint8array"): Promise<Uint8Array>;
 /**
  * loadFile() の内部実装のうち、特にテストのため外部から参照するものをまとめた namespace 。
  * 通常の利用では参照する必要はない。
@@ -15,6 +18,6 @@ export declare namespace LoadFileInternal {
      * 具体的な値は調整の余地がある。少なくとも Windows 環境で、128 以上で問題が起きることがわかっている。
      */
     const MAX_PARALLEL_LOAD = 32;
-    function loadImpl(url: string): Promise<string>;
+    function loadImpl(url: string, encoding?: EncodingType): Promise<string | Uint8Array>;
 }
 export declare function isHttpProtocol(url: string): boolean;

package/lib/utils.js

@@ -14,15 +14,10 @@ const fs = require("fs");
 const node_fetch_1 = require("node-fetch");
 const waitings = [];
 let loadingCount = 0;
-/**
- * ファイルを読み込む。
- *
- * @param url url または path
- */
-function loadFile(url) {
+function loadFile(url, encoding = "utf-8") {
     return __awaiter(this, void 0, void 0, function* () {
         const promise = new Promise((resolve, reject) => {
-            waitings.push({ url, resolve, reject });
+            waitings.push({ url, encoding, resolve, reject });
         });
         processWaitingLoad();
         return promise;
@@ -33,10 +28,10 @@ function processWaitingLoad() {
     return __awaiter(this, void 0, void 0, function* () {
         if (loadingCount >= LoadFileInternal.MAX_PARALLEL_LOAD || waitings.length === 0)
             return;
-        const { url, resolve, reject } = waitings.shift();
+        const { url, encoding, resolve, reject } = waitings.shift();
         try {
             ++loadingCount;
-            resolve(yield LoadFileInternal.loadImpl(url));
+            resolve(yield LoadFileInternal.loadImpl(url, encoding));
         }
         catch (e) {
             reject(e);
@@ -59,15 +54,30 @@ var LoadFileInternal;
      * 具体的な値は調整の余地がある。少なくとも Windows 環境で、128 以上で問題が起きることがわかっている。
      */
     LoadFileInternal.MAX_PARALLEL_LOAD = 32;
-    function loadImpl(url) {
+    function loadImpl(url, encoding = "utf-8") {
         return __awaiter(this, void 0, void 0, function* () {
             if (isHttpProtocol(url)) {
                 const res = yield (0, node_fetch_1.default)(url, { method: "GET" });
-                return res.text();
+                if (encoding === "utf-8") {
+                    return res.text();
+                }
+                else {
+                    // NOTE: vm2 の sandbox 環境外から sandbox 内へ ArrayBuffer を渡してもデータの中身を参照することができない。
+                    // おそらく Proxy の挙動によるものだと推測されるが原因については精査できていない。
+                    // 暫定対応として ArrayBuffer の代わりに Uint8Array を渡し、 sandbox 内で ArrayBuffer のインスタンスを生成するようにする。
+                    const arrayBuffer = yield res.arrayBuffer();
+                    return new Uint8Array(arrayBuffer);
+                }
             }
             else {
-                const str = fs.readFileSync(url, { encoding: "utf8" });
-                return str;
+                if (encoding === "utf-8") {
+                    return fs.readFileSync(url, { encoding: "utf-8" });
+                }
+                else {
+                    // 上記 NOTE と同様の理由により Uint8Array を返す。
+                    const buffer = fs.readFileSync(url, { encoding: null });
+                    return Uint8Array.from(buffer);
+                }
             }
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akashic/headless-driver",
-  "version": "2.8.3",
+  "version": "2.9.0",
   "description": "A library to execute contents using Akashic Engine headlessly",
   "main": "lib/index.js",
   "author": "DWANGO Co., Ltd.",
@@ -24,12 +24,12 @@
     "lib"
   ],
   "dependencies": {
-    "@akashic/amflow": "^3.1.0",
-    "@akashic/playlog": "^3.1.0",
+    "@akashic/amflow": "^3.2.0",
+    "@akashic/playlog": "^3.2.0",
     "@akashic/trigger": "^2.0.0",
-    "engine-files-v1": "npm:@akashic/engine-files@1.2.1",
-    "engine-files-v2": "npm:@akashic/engine-files@2.2.2",
-    "engine-files-v3": "npm:@akashic/engine-files@3.7.1",
+    "engine-files-v1": "npm:@akashic/engine-files@1.2.2",
+    "engine-files-v2": "npm:@akashic/engine-files@2.2.3",
+    "engine-files-v3": "npm:@akashic/engine-files@3.7.3",
     "js-sha256": "^0.9.0",
     "lodash.clonedeep": "^4.5.0",
     "node-fetch": "^2.6.7",