@hoardodile/host 0.1.1 → 0.1.3

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';
 
@@ -684,6 +685,18 @@ type PluginHooks = {
      * shape-validated (hex values, per-resource cap).
      */
     readonly runImageHashes: (api: ResourceAPI, pluginId: PluginManifestId) => Promise<ImageHashesResult | undefined>;
+    /**
+     * Run the plugin's optional `onInstall` hook — best-effort, invoked
+     * by the host after a successful install/update commit (marketplace
+     * install/update or a zip upload; never seed/dev plugins). The hook
+     * receives an install-scoped {@link ResourceAPI}: no resource is
+     * attached (the file surface answers empty, `context.detect` is
+     * `undefined`), while the asset methods still work and stay gated by
+     * the shared consent dialog. A throwing (or consent-denied) hook is
+     * logged via `hookFailureText` and swallowed — the install itself is
+     * never failed; plugins must re-check at runtime.
+     */
+    readonly runInstallHook: (pluginId: PluginManifestId) => Promise<void>;
 };
 declare function createPluginHooks(deps: PluginHooksDeps): PluginHooks;
 

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);
     }
@@ -2270,6 +2298,59 @@ function parseManifest(dirPath, dirName) {
   }
   return result.data;
 }
+function createInstallScopeApi() {
+  const noResource = (method) => new Error(
+    `${method}() \u2014 no resource is attached to the onInstall hook; use the asset methods (download/statAsset/readAsset/deleteAsset) for install-time work`
+  );
+  return {
+    logInfo() {
+    },
+    logWarn() {
+    },
+    logError() {
+    },
+    context: { detect: void 0 },
+    listFileNames: async () => [],
+    readFile: async () => {
+      throw noResource("readFile");
+    },
+    statFile: async () => void 0,
+    statFiles: async (paths) => paths.map(() => void 0),
+    sniff: async () => void 0,
+    probe: async () => ({ kind: "unknown", reason: "unavailable" }),
+    hashBytes: async () => {
+      throw noResource("hashBytes");
+    },
+    computeImageHashes: async () => void 0,
+    listContainer: async () => {
+      throw noResource("listContainer");
+    },
+    extractArchive: async () => {
+      throw noResource("extractArchive");
+    },
+    download: async () => {
+      throw pluginAssetError(
+        "UNAVAILABLE",
+        "download() \u2014 this host has no plugin asset service; only the app server host can download into the plugin vault"
+      );
+    },
+    statAsset: async () => {
+      throw unavailableAsset2("statAsset");
+    },
+    readAsset: async () => {
+      throw unavailableAsset2("readAsset");
+    },
+    deleteAsset: async () => {
+      throw unavailableAsset2("deleteAsset");
+    }
+  };
+}
+function unavailableAsset2(method) {
+  return pluginAssetError(
+    "UNAVAILABLE",
+    `${method}() \u2014 this host has no plugin asset vault; only the app server host manages vault files`
+  );
+}
 
 // src/hooks.ts
 var MAX_IMAGE_HASHES_PER_RESOURCE = 2e3;
@@ -2444,6 +2525,17 @@ function createPluginHooks(deps) {
       pluginId
     );
   }
+  async function runInstallHook(pluginId) {
+    const entry = getRegistry().getById(pluginId);
+    if (entry === void 0) return;
+    await invokeHook(
+      entry,
+      entry.plugin.onInstall,
+      createInstallScopeApi(),
+      "onInstall",
+      "warn"
+    );
+  }
   return {
     defaultPluginId,
     getEffectiveEntry,
@@ -2455,7 +2547,8 @@ function createPluginHooks(deps) {
     resolveLocalCoverSource,
     runMetaHooks,
     supportsImageHashes,
-    runImageHashes
+    runImageHashes,
+    runInstallHook
   };
 }
 var HEX_VALUE = /^[0-9a-f]+$/;
@@ -2664,7 +2757,7 @@ function createPluginSandbox(config = DEFAULT_SANDBOX_CONFIG) {
       await teardownChild(previous);
     }
     if (!opts.eager) {
-      void teardownChild(state);
+      await teardownChild(state);
     }
     return createSandboxedPlugin(
       state.hooks ?? ["detect"],
@@ -2848,6 +2941,16 @@ function createPluginSandbox(config = DEFAULT_SANDBOX_CONFIG) {
     if (child === void 0) {
       throw new Error(`plugin ${state.id} sandbox unavailable`);
     }
+    try {
+      return await invokeOnChild(state, child, hook, api);
+    } finally {
+      if (hook === "onInstall") {
+        state.respawnTimes = [];
+        await teardownChild(state);
+      }
+    }
+  }
+  function invokeOnChild(state, child, hook, api) {
     const callId = nextCallId++;
     return new Promise((resolveCall, reject) => {
       const call = {
@@ -3305,6 +3408,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