@hoardodile/host 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { I as ImageMetadataInput, b as ImageSourceProbe, A as AvProbeOptions, E
 import { R as ResourceContainer } from './container-fKxefO7p.js';
 import { P as PluginProbeCache } from './probe-cache-BkRI7HEK.js';
 export { a as PLUGIN_PROBE_CACHE_MAX_ENTRIES, c as createProbeCache } from './probe-cache-BkRI7HEK.js';
+export { p as packZipDirectory } from './pack-6IscrwYN.js';
 import { PluginCapabilityKey } from '@hoardodile/sdk-types/plugin-capabilities';
 import 'sharp';
 
@@ -143,7 +144,12 @@ type PluginRegistry = {
  * workbench) omit it and the methods answer `UNAVAILABLE`.
  */
 type PluginAssetHandler = {
-    readonly download: (pluginId: string, request: PluginDownloadRequest) => Promise<PluginDownloadResult>;
+    /**
+     * Download one request or a batch of requests. Answers with the
+     * result array (batch shape) — this adapter unwraps the single
+     * result for a single request (see {@link dispatchApi}).
+     */
+    readonly download: (pluginId: string, request: PluginDownloadRequest | readonly PluginDownloadRequest[]) => Promise<readonly PluginDownloadResult[]>;
     readonly statAsset: (pluginId: string, path: string) => Promise<{
         readonly sizeBytes: number;
     } | undefined>;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createWriteStream, createReadStream, existsSync, readFileSync, renameSync, rmSync, mkdirSync, readdirSync, cpSync, statSync, realpathSync } from 'fs';
-import { dirname, isAbsolute, normalize, resolve, sep, join } from 'path';
+import { dirname, resolve, sep, isAbsolute, normalize, join } from 'path';
 import { pluginAssetError, fileTypeFromName, createFailingPlugin, definePlugin } from '@hoardodile/sdk-types';
 export { HOOK_NAMES, assertPluginShape, createFailingPlugin, createResourceAPIFixture, definePlugin, isDetected, isMissed, stubLogger } from '@hoardodile/sdk-types';
 import { mimeToKind, MIME_FFMPEG_INPUT_FORMAT } from '@hoardodile/sdk-types/media-exts';
@@ -14,6 +14,7 @@ import { fork, spawn } from 'child_process';
 import { createRequire } from 'module';
 import { buffer } from 'stream/consumers';
 import { createInflateRaw } from 'zlib';
+import yazl from 'yazl';
 import { CAPABILITY_BY_METHOD } from '@hoardodile/sdk-types/plugin-capabilities';
 import { pathToFileURL, fileURLToPath } from 'url';
 import { pluginManifest } from '@hoardodile/sdk-types/schema';
@@ -661,16 +662,16 @@ function parseSltListing(stdout, legacyNames) {
       }
       continue;
     }
-    const sep4 = line.indexOf(" = ");
-    if (sep4 < 0) continue;
-    const key = line.slice(0, sep4);
+    const sep5 = line.indexOf(" = ");
+    if (sep5 < 0) continue;
+    const key = line.slice(0, sep5);
     if (key === "Path") {
-      const raw = Buffer.from(line.slice(sep4 + 3), "latin1");
+      const raw = Buffer.from(line.slice(sep5 + 3), "latin1");
       const decoded = legacyNames ? decodeLegacyZipName(raw) : raw.toString("utf8");
       name = decoded.replace(/\\/g, "/");
       continue;
     }
-    const value = line.slice(sep4 + 3);
+    const value = line.slice(sep5 + 3);
     switch (key) {
       case "Size":
         sizeBytes = Number.parseInt(value, 10) || 0;
@@ -916,11 +917,11 @@ var globalMaterializeInflight = /* @__PURE__ */ new Map();
 // src/archive/nested-entry.ts
 var VIRTUAL_PATH_SEPARATOR = "!";
 function splitVirtualPath(path) {
-  const sep4 = path.indexOf(VIRTUAL_PATH_SEPARATOR);
-  if (sep4 <= 0) return void 0;
-  const inner = path.slice(sep4 + 1);
+  const sep5 = path.indexOf(VIRTUAL_PATH_SEPARATOR);
+  if (sep5 <= 0) return void 0;
+  const inner = path.slice(sep5 + 1);
   if (inner.length === 0) return void 0;
-  return { outer: path.slice(0, sep4), inner };
+  return { outer: path.slice(0, sep5), inner };
 }
 function createOuterArchiveSource(outer, outerName, size) {
   return {
@@ -972,7 +973,7 @@ function createNestedResolver(outer, opts = {}) {
       zip: r
     }));
   }
-  async function resolve5(path) {
+  async function resolve6(path) {
     const parts = splitVirtualPath(path);
     if (parts === void 0) return { kind: "literal" };
     const { outer: outerName, inner } = parts;
@@ -999,7 +1000,7 @@ function createNestedResolver(outer, opts = {}) {
     );
     return work;
   }
-  return { resolve: resolve5, list };
+  return { resolve: resolve6, list };
 }
 function listedWithStream(outer, outerName, entry) {
   return {
@@ -1321,13 +1322,40 @@ function createNestedCdCache(opts) {
   }
   return { get, set, clear };
 }
+async function packZipDirectory(srcDir, zipPath) {
+  const root = resolve(srcDir);
+  const files = listFilesSorted(root);
+  const zip = new yazl.ZipFile();
+  for (const abs of files) {
+    const rel = abs.slice(root.length + 1).split(sep).join("/");
+    zip.addFile(abs, rel, { compress: true });
+  }
+  zip.end();
+  await pipeline(zip.outputStream, createWriteStream(resolve(zipPath)));
+}
+function listFilesSorted(root) {
+  const out = [];
+  const walk = (dir) => {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      const abs = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(abs);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      out.push(abs);
+    }
+  };
+  walk(root);
+  return out.sort();
+}
 var PHASH_GRID = 32;
 var MIN_PERCEPTUAL_STDDEV = 8;
 function hashStream(stream, algo) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const hash = createHash(algo);
     stream.on("data", (chunk) => hash.update(chunk));
-    stream.on("end", () => resolve5(hash.digest("hex")));
+    stream.on("end", () => resolve6(hash.digest("hex")));
     stream.on("error", reject);
   });
 }
@@ -1456,14 +1484,14 @@ function createNestedAwareContainer(base, nestedCdCache, scope, extractCacheDir)
       sizeBytes: entry.sizeBytes
     };
   }
-  async function resolve5(rel) {
+  async function resolve6(rel) {
     const nested = await resolver.resolve(rel);
     if (nested.kind === "container") return nested;
     const materialized = await resolveMaterialized(rel);
     return materialized ?? nested;
   }
   async function readEntrySlice(rel, start, end) {
-    const resolved = await resolve5(rel);
+    const resolved = await resolve6(rel);
     if (resolved.kind === "literal") {
       return base.readEntrySlice(rel, start, end);
     }
@@ -1473,7 +1501,7 @@ function createNestedAwareContainer(base, nestedCdCache, scope, extractCacheDir)
     return readVirtualSlice(() => resolved.openStream(), start, end);
   }
   async function openEntryStream(rel) {
-    const resolved = await resolve5(rel);
+    const resolved = await resolve6(rel);
     if (resolved.kind === "literal") {
       return base.openEntryStream(rel);
     }
@@ -1487,7 +1515,7 @@ function createNestedAwareContainer(base, nestedCdCache, scope, extractCacheDir)
     return { stream: resolved.openStream(), size: resolved.entry.sizeBytes };
   }
   async function readEntry(rel) {
-    const resolved = await resolve5(rel);
+    const resolved = await resolve6(rel);
     if (resolved.kind === "literal") {
       return base.readEntry(rel);
     }
@@ -1497,7 +1525,7 @@ function createNestedAwareContainer(base, nestedCdCache, scope, extractCacheDir)
     return buffer(resolved.openStream());
   }
   async function resolveByteRange(rel) {
-    const resolved = await resolve5(rel);
+    const resolved = await resolve6(rel);
     if (resolved.kind === "literal") {
       return base.resolveByteRange(rel);
     }
@@ -1507,7 +1535,7 @@ function createNestedAwareContainer(base, nestedCdCache, scope, extractCacheDir)
     return { size: resolved.entry.sizeBytes };
   }
   async function resolveSeekablePath(rel) {
-    const resolved = await resolve5(rel);
+    const resolved = await resolve6(rel);
     if (resolved.kind === "literal") {
       return base.resolveSeekablePath?.(rel);
     }
@@ -3004,10 +3032,9 @@ function createPluginSandbox(config = DEFAULT_SANDBOX_CONFIG) {
           return;
         }
         if (method === "download") {
-          respond(
-            true,
-            await handler.download(state.id, args[0])
-          );
+          const request = args[0];
+          const results = await handler.download(state.id, request);
+          respond(true, Array.isArray(request) ? results : results[0]);
         } else if (method === "statAsset") {
           respond(true, await handler.statAsset(state.id, args[0]));
         } else if (method === "readAsset") {
@@ -3306,6 +3333,6 @@ function createProbeCache(maxEntries = PLUGIN_PROBE_CACHE_MAX_ENTRIES) {
   };
 }
 
-export { DEFAULT_PLUGIN_EXTRACT_MAX_BYTES, DEFAULT_PLUGIN_EXTRACT_MAX_ENTRIES, DEFAULT_SANDBOX_CONFIG, DomainError, MIN_PERCEPTUAL_STDDEV, PERCEPTUAL_HASH_KINDS, PHASH_GRID, PLUGIN_HOOK_HARD_TIMEOUT_MS, PLUGIN_MAX_API_CALLS_PER_HOOK, PLUGIN_MAX_LOGS_PER_HOOK, PLUGIN_MAX_RESULT_BYTES, PLUGIN_PROBE_CACHE_MAX_ENTRIES, PLUGIN_WATCHDOG_TIMEOUT_MS, PLUGIN_WORKER_MAX_OLD_SPACE_MB, PLUGIN_WORKER_MAX_RESPAWNS, PLUGIN_WORKER_RESPAWN_WINDOW_MS, buildRegistry, computeDHash, computePHash, conflict, createCapabilityGuard, createDirectoryContainer, createDirectoryResourceAPI, createDirectoryResourceAPI as createImportResourceAPI, createNestedAwareContainer, createNestedCdCache, createPluginActivation, createPluginDiscovery, createPluginHooks, createPluginLoader, createPluginResourceAPI, createPluginSandbox, createProbeCache, grayStddev, invalid, listZipEntries, materializeFile, notFound, parseManifest, resolveSafeImportPath, runPluginHook, seedPlugins };
+export { DEFAULT_PLUGIN_EXTRACT_MAX_BYTES, DEFAULT_PLUGIN_EXTRACT_MAX_ENTRIES, DEFAULT_SANDBOX_CONFIG, DomainError, MIN_PERCEPTUAL_STDDEV, PERCEPTUAL_HASH_KINDS, PHASH_GRID, PLUGIN_HOOK_HARD_TIMEOUT_MS, PLUGIN_MAX_API_CALLS_PER_HOOK, PLUGIN_MAX_LOGS_PER_HOOK, PLUGIN_MAX_RESULT_BYTES, PLUGIN_PROBE_CACHE_MAX_ENTRIES, PLUGIN_WATCHDOG_TIMEOUT_MS, PLUGIN_WORKER_MAX_OLD_SPACE_MB, PLUGIN_WORKER_MAX_RESPAWNS, PLUGIN_WORKER_RESPAWN_WINDOW_MS, buildRegistry, computeDHash, computePHash, conflict, createCapabilityGuard, createDirectoryContainer, createDirectoryResourceAPI, createDirectoryResourceAPI as createImportResourceAPI, createNestedAwareContainer, createNestedCdCache, createPluginActivation, createPluginDiscovery, createPluginHooks, createPluginLoader, createPluginResourceAPI, createPluginSandbox, createProbeCache, grayStddev, invalid, listZipEntries, materializeFile, notFound, packZipDirectory, parseManifest, resolveSafeImportPath, runPluginHook, seedPlugins };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map