@shotkit/shotium 0.1.0 → 0.2.0

package/dist/native.d.ts

@@ -1,66 +0,0 @@
-import { i as NativeStartOptions, o as PurgeOptions, s as ScreenshotOptions } from "./types-x9HtkzeE.js";
-//#region src/native.d.ts
-/**
- * The engine, in this process, and the queue in front of it.
- *
- * Same options and same output as `runtime`, and a different set of trades.
- * There is no worker process, so there is nothing to start, nothing to find on
- * disk and no pipe: a screenshot costs about a third less than through the
- * pool, and the whole thing is one process instead of five.
- *
- * What it gives up is what a separate process was providing for free. One
- * renderer, because blink is a process-wide singleton and `worker_threads`
- * share the process, so requests are serialised however many callers there
- * are. And no crash isolation: a renderer that dies takes the host program
- * with it, where the pool would have retried.
- *
- * The queue is not about fairness. Each capture occupies a libuv thread pool
- * thread for as long as the render takes, and there are four of those by
- * default, shared with fs and dns -- so letting four screenshots go at once
- * would stall the host's file reads for a fifth of a second at a time while
- * gaining nothing, since the engine serialises them anyway.
- */
-declare class NativeRuntime {
-  private engine;
-  private tail;
-  get running(): boolean;
-  /**
-   * Starts the engine. Safe to call twice; the second call is a no-op.
-   *
-   * `cacheDir` is the HTTP disk cache and `null` disables it, which is the
-   * default here. `resourceDir` is where `shotium_data.pak` and
-   * `shotium_strings.pak` are, and defaults to the directory the addon was
-   * loaded from, which is where they ship.
-   */
-  start(options?: NativeStartOptions): this;
-  /** Stops the engine, after whatever is queued. */
-  stop(): Promise<void>;
-  /**
-   * Hands back what the engine is holding but can rebuild.
-   * `releaseWorkingSet` additionally asks the OS for the pages, which the next
-   * screenshot pays back in soft faults -- worth it when there may not be a
-   * next one soon.
-   *
-   * The resident worker does this for itself on a timer because it can watch
-   * its own request stream go quiet. Here the queue belongs to the caller, so
-   * the caller is the one who knows a batch has ended.
-   */
-  purge({ releaseWorkingSet }?: PurgeOptions): void;
-  /**
-   * Renders one screenshot. Resolves to the encoded image, or to `null` when
-   * `path` was given and the engine wrote the file itself.
-   */
-  screenshot(options: ScreenshotOptions): Promise<Buffer | null>;
-}
-/** The shared in-process engine, started on first use. */
-declare const native: NativeRuntime;
-/** One screenshot through the shared in-process engine. */
-declare const screenshot: (options: ScreenshotOptions) => Promise<Buffer | null>;
-declare const _default: {
-  NativeRuntime: typeof NativeRuntime;
-  native: NativeRuntime;
-  screenshot: (options: ScreenshotOptions) => Promise<Buffer | null>;
-};
-//#endregion
-export { NativeRuntime, type NativeStartOptions, type PurgeOptions, type ScreenshotOptions, _default as default, native, screenshot };
-//# sourceMappingURL=native.d.ts.map

package/dist/native.js

@@ -1,127 +0,0 @@
-import { n as packageDir, r as packageName } from "./platform-DU8DYqmA.js";
-import { r as toRequest } from "./request-qZXS3N9f.js";
-import { createRequire } from "node:module";
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-//#region src/native.ts
-const require = createRequire(import.meta.url);
-const HERE = path.dirname(fileURLToPath(import.meta.url));
-function candidates() {
-	const found = [];
-	const dir = packageDir();
-	if (dir) found.push(path.join(dir, "shotium.node"));
-	found.push(path.join(HERE, "..", "native", "build", "Release", "shotium.node"));
-	return found;
-}
-let binding = null;
-let bindingDir = null;
-function load() {
-	if (binding) return binding;
-	const tried = candidates();
-	for (const candidate of tried) {
-		if (!fs.existsSync(candidate)) continue;
-		binding = require(candidate);
-		bindingDir = path.dirname(candidate);
-		return binding;
-	}
-	const expected = packageName();
-	throw new Error(`shotium: no native engine for this platform.
-  looked in:\n    ${tried.join("\n    ")}\n` + (expected ? `  It ships in ${expected}, which npm installs as an optional dependency of this package.
-` : `  There is no build for ${process.platform}-${process.arch}.\n`) + "  import(\"@shotkit/shotium\") uses worker processes instead and needs no addon.");
-}
-/**
-* The engine, in this process, and the queue in front of it.
-*
-* Same options and same output as `runtime`, and a different set of trades.
-* There is no worker process, so there is nothing to start, nothing to find on
-* disk and no pipe: a screenshot costs about a third less than through the
-* pool, and the whole thing is one process instead of five.
-*
-* What it gives up is what a separate process was providing for free. One
-* renderer, because blink is a process-wide singleton and `worker_threads`
-* share the process, so requests are serialised however many callers there
-* are. And no crash isolation: a renderer that dies takes the host program
-* with it, where the pool would have retried.
-*
-* The queue is not about fairness. Each capture occupies a libuv thread pool
-* thread for as long as the render takes, and there are four of those by
-* default, shared with fs and dns -- so letting four screenshots go at once
-* would stall the host's file reads for a fifth of a second at a time while
-* gaining nothing, since the engine serialises them anyway.
-*/
-var NativeRuntime = class {
-	engine = null;
-	tail = Promise.resolve();
-	get running() {
-		return this.engine !== null;
-	}
-	/**
-	* Starts the engine. Safe to call twice; the second call is a no-op.
-	*
-	* `cacheDir` is the HTTP disk cache and `null` disables it, which is the
-	* default here. `resourceDir` is where `shotium_data.pak` and
-	* `shotium_strings.pak` are, and defaults to the directory the addon was
-	* loaded from, which is where they ship.
-	*/
-	start(options = {}) {
-		if (this.engine) return this;
-		const native = load();
-		const engineOptions = {};
-		if (options.cacheDir !== null && options.cacheDir !== void 0) engineOptions.cacheDir = options.cacheDir;
-		if (options.userAgent !== void 0) engineOptions.userAgent = options.userAgent;
-		engineOptions.resourceDir = options.resourceDir || bindingDir;
-		this.engine = native.create(JSON.stringify(engineOptions));
-		return this;
-	}
-	/** Stops the engine, after whatever is queued. */
-	async stop() {
-		if (!this.engine) return;
-		const engine = this.engine;
-		this.engine = null;
-		await this.tail.catch(() => {});
-		load().destroy(engine);
-	}
-	/**
-	* Hands back what the engine is holding but can rebuild.
-	* `releaseWorkingSet` additionally asks the OS for the pages, which the next
-	* screenshot pays back in soft faults -- worth it when there may not be a
-	* next one soon.
-	*
-	* The resident worker does this for itself on a timer because it can watch
-	* its own request stream go quiet. Here the queue belongs to the caller, so
-	* the caller is the one who knows a batch has ended.
-	*/
-	purge({ releaseWorkingSet = false } = {}) {
-		if (!this.engine) return;
-		load().purge(this.engine, releaseWorkingSet);
-	}
-	/**
-	* Renders one screenshot. Resolves to the encoded image, or to `null` when
-	* `path` was given and the engine wrote the file itself.
-	*/
-	async screenshot(options) {
-		const request = toRequest(options);
-		if (!this.engine) this.start();
-		const engine = this.engine;
-		const native = load();
-		const result = this.tail.catch(() => {}).then(() => native.capture(engine, JSON.stringify(request)));
-		this.tail = result.catch(() => {});
-		const image = await result;
-		return request.path ? null : image;
-	}
-};
-/** The shared in-process engine, started on first use. */
-const native = new NativeRuntime();
-/** One screenshot through the shared in-process engine. */
-const screenshot = (options) => native.screenshot(options);
-var native_default = {
-	NativeRuntime,
-	native,
-	screenshot
-};
-
-//#endregion
-export { NativeRuntime, native_default as default, native, screenshot };
-//# sourceMappingURL=native.js.map

package/dist/native.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"native.js","names":["platformPackage.packageDir","platformPackage.packageName"],"sources":["../src/native.ts"],"sourcesContent":["import fs from 'node:fs';\nimport {createRequire} from 'node:module';\nimport path from 'node:path';\nimport {fileURLToPath} from 'node:url';\n\nimport * as platformPackage from './lib/platform.js';\nimport {toRequest} from './lib/request.js';\nimport type {\n  NativeStartOptions,\n  PurgeOptions,\n  ScreenshotOptions,\n} from './types.js';\n\nexport type {\n  NativeStartOptions,\n  PurgeOptions,\n  ScreenshotOptions,\n} from './types.js';\n\n// A .node addon is a CommonJS artefact: there is no ESM loader for one.\nconst require = createRequire(import.meta.url);\n\n// ESM has no __dirname. This is the same thing, from the module's own URL.\nconst HERE = path.dirname(fileURLToPath(import.meta.url));\n\n// The engine handle the addon hands back. It is opaque on purpose: everything\n// that can be done with it is a call on the binding below.\ntype Engine = unknown;\n\n// What native/binding.cc exports. See shot/shot_api.h for the C ABI under it.\ninterface NativeBinding {\n  create(optionsJson: string): Engine;\n  destroy(engine: Engine): void;\n  purge(engine: Engine, releaseWorkingSet: boolean): void;\n  capture(engine: Engine, requestJson: string): Promise<Buffer>;\n}\n\n// shot in this process, instead of in workers beside it.\n//\n// The difference from `runtime` is not the API, which is the same\n// screenshot(options), and not the request format, which is byte for byte the\n// same JSON. It is where blink is:\n//\n//   runtime   N worker processes, one screenshot each at a time, a crash is a\n//             retry, memory is N copies of an engine\n//   native    one engine in this process, one screenshot at a time ever, a\n//             crash takes the program with it, memory is one copy\n//\n// One at a time is not a limitation of this file. Blink is a process-wide\n// singleton -- it is initialised once and there is no path to a second one --\n// so an in-process engine is one renderer no matter how it is driven, and\n// worker_threads do not change that because they share the process. A caller\n// who wants four screenshots at once wants four processes, which is what the\n// pool is for.\n//\n// What it buys is that there is no process to start, nothing to find on disk,\n// no pipe, and no supervisor: a program that takes a handful of screenshots\n// and exits pays for one engine and talks to it directly.\n\n// Where the addon and the library beside it live.\n//\n// The platform package is what ships -- the .node sits next to the shared\n// library it is linked against, which is the whole reason the two travel in\n// one package rather than two. native/build/Release is where node-gyp puts a\n// local build; it exists in a checkout and not in an install, so the two never\n// compete in practice. Both paths are relative to this file's build output,\n// which is one directory below the package root.\nfunction candidates(): string[] {\n  const found: string[] = [];\n  const dir = platformPackage.packageDir();\n  if (dir) {\n    found.push(path.join(dir, 'shotium.node'));\n  }\n  found.push(\n      path.join(HERE, '..', 'native', 'build', 'Release', 'shotium.node'));\n  return found;\n}\n\nlet binding: NativeBinding|null = null;\nlet bindingDir: string|null = null;\n\nfunction load(): NativeBinding {\n  if (binding) {\n    return binding;\n  }\n  const tried = candidates();\n  for (const candidate of tried) {\n    if (!fs.existsSync(candidate)) {\n      continue;\n    }\n    // Not wrapped in a try: a .node that is there and will not load is a\n    // broken installation, and the loader's own message -- a missing\n    // dependency, an architecture mismatch -- says more than anything that\n    // could be substituted for it.\n    binding = require(candidate) as NativeBinding;\n    bindingDir = path.dirname(candidate);\n    return binding;\n  }\n  const expected = platformPackage.packageName();\n  throw new Error(\n      'shotium: no native engine for this platform.\\n' +\n      `  looked in:\\n    ${tried.join('\\n    ')}\\n` +\n      (expected ?\n           `  It ships in ${expected}, which npm installs as an optional ` +\n               'dependency of this package.\\n' :\n           `  There is no build for ${process.platform}-${process.arch}.\\n`) +\n      '  import(\"@shotkit/shotium\") uses worker processes instead and needs ' +\n      'no addon.');\n}\n\n/**\n * The engine, in this process, and the queue in front of it.\n *\n * Same options and same output as `runtime`, and a different set of trades.\n * There is no worker process, so there is nothing to start, nothing to find on\n * disk and no pipe: a screenshot costs about a third less than through the\n * pool, and the whole thing is one process instead of five.\n *\n * What it gives up is what a separate process was providing for free. One\n * renderer, because blink is a process-wide singleton and `worker_threads`\n * share the process, so requests are serialised however many callers there\n * are. And no crash isolation: a renderer that dies takes the host program\n * with it, where the pool would have retried.\n *\n * The queue is not about fairness. Each capture occupies a libuv thread pool\n * thread for as long as the render takes, and there are four of those by\n * default, shared with fs and dns -- so letting four screenshots go at once\n * would stall the host's file reads for a fifth of a second at a time while\n * gaining nothing, since the engine serialises them anyway.\n */\nexport class NativeRuntime {\n  private engine: Engine|null = null;\n  private tail: Promise<unknown> = Promise.resolve();\n\n  get running(): boolean {\n    return this.engine !== null;\n  }\n\n  /**\n   * Starts the engine. Safe to call twice; the second call is a no-op.\n   *\n   * `cacheDir` is the HTTP disk cache and `null` disables it, which is the\n   * default here. `resourceDir` is where `shotium_data.pak` and\n   * `shotium_strings.pak` are, and defaults to the directory the addon was\n   * loaded from, which is where they ship.\n   */\n  start(options: NativeStartOptions = {}): this {\n    if (this.engine) {\n      return this;\n    }\n    const native = load();\n\n    const engineOptions: Record<string, unknown> = {};\n    if (options.cacheDir !== null && options.cacheDir !== undefined) {\n      engineOptions.cacheDir = options.cacheDir;\n    }\n    if (options.userAgent !== undefined) {\n      engineOptions.userAgent = options.userAgent;\n    }\n    // The packs sit beside the library, and the library cannot find itself on\n    // Linux -- the path the engine resolves for \"this module\" goes through\n    // /proc/self/exe, which names node. Saying it here is cheaper than\n    // teaching the engine a second way to look. See shot_api.h.\n    engineOptions.resourceDir = options.resourceDir || bindingDir;\n\n    this.engine = native.create(JSON.stringify(engineOptions));\n    return this;\n  }\n\n  /** Stops the engine, after whatever is queued. */\n  async stop(): Promise<void> {\n    if (!this.engine) {\n      return;\n    }\n    // After the queue, not before: destroy() waits for a capture in flight\n    // anyway, and doing it in order means a caller's last screenshot resolves\n    // rather than racing the shutdown.\n    const engine = this.engine;\n    this.engine = null;\n    await this.tail.catch(() => {});\n    load().destroy(engine);\n  }\n\n  /**\n   * Hands back what the engine is holding but can rebuild.\n   * `releaseWorkingSet` additionally asks the OS for the pages, which the next\n   * screenshot pays back in soft faults -- worth it when there may not be a\n   * next one soon.\n   *\n   * The resident worker does this for itself on a timer because it can watch\n   * its own request stream go quiet. Here the queue belongs to the caller, so\n   * the caller is the one who knows a batch has ended.\n   */\n  purge({releaseWorkingSet = false}: PurgeOptions = {}): void {\n    if (!this.engine) {\n      return;\n    }\n    load().purge(this.engine, releaseWorkingSet);\n  }\n\n  /**\n   * Renders one screenshot. Resolves to the encoded image, or to `null` when\n   * `path` was given and the engine wrote the file itself.\n   */\n  async screenshot(options: ScreenshotOptions): Promise<Buffer|null> {\n    // Before anything else, and before the queue: a malformed request should\n    // be a rejection now rather than one that waits its turn.\n    const request = toRequest(options);\n    if (!this.engine) {\n      this.start();\n    }\n    const engine = this.engine;\n    const native = load();\n\n    // Chain onto the tail so that captures run one at a time. The catch keeps\n    // one failure from poisoning everything queued behind it.\n    const result = this.tail.catch(() => {}).then(\n        () => native.capture(engine, JSON.stringify(request)));\n    this.tail = result.catch(() => {});\n    const image = await result;\n    return request.path ? null : image;\n  }\n}\n\n/** The shared in-process engine, started on first use. */\nconst native = new NativeRuntime();\n\n/** One screenshot through the shared in-process engine. */\nconst screenshot = (options: ScreenshotOptions): Promise<Buffer|null> =>\n    native.screenshot(options);\n\nexport {native, screenshot};\n\nexport default {NativeRuntime, native, screenshot};\n"],"mappings":";;;;;;;;AAoBA,MAAM,UAAU,cAAc,YAAY,GAAG;AAG7C,MAAM,OAAO,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AA4CxD,SAAS,aAAuB;CAC9B,MAAM,QAAkB,CAAC;CACzB,MAAM,MAAMA,WAA2B;CACvC,IAAI,KACF,MAAM,KAAK,KAAK,KAAK,KAAK,cAAc,CAAC;CAE3C,MAAM,KACF,KAAK,KAAK,MAAM,MAAM,UAAU,SAAS,WAAW,cAAc,CAAC;CACvE,OAAO;AACT;AAEA,IAAI,UAA8B;AAClC,IAAI,aAA0B;AAE9B,SAAS,OAAsB;CAC7B,IAAI,SACF,OAAO;CAET,MAAM,QAAQ,WAAW;CACzB,KAAK,MAAM,aAAa,OAAO;EAC7B,IAAI,CAAC,GAAG,WAAW,SAAS,GAC1B;EAMF,UAAU,QAAQ,SAAS;EAC3B,aAAa,KAAK,QAAQ,SAAS;EACnC,OAAO;CACT;CACA,MAAM,WAAWC,YAA4B;CAC7C,MAAM,IAAI,MACN;oBACqB,MAAM,KAAK,QAAQ,EAAE,OACzC,WACI,iBAAiB,SAAS;IAE1B,2BAA2B,QAAQ,SAAS,GAAG,QAAQ,KAAK,QACjE,kFACW;AACjB;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAa,gBAAb,MAA2B;CACzB,AAAQ,SAAsB;CAC9B,AAAQ,OAAyB,QAAQ,QAAQ;CAEjD,IAAI,UAAmB;EACrB,OAAO,KAAK,WAAW;CACzB;;;;;;;;;CAUA,MAAM,UAA8B,CAAC,GAAS;EAC5C,IAAI,KAAK,QACP,OAAO;EAET,MAAM,SAAS,KAAK;EAEpB,MAAM,gBAAyC,CAAC;EAChD,IAAI,QAAQ,aAAa,QAAQ,QAAQ,aAAa,QACpD,cAAc,WAAW,QAAQ;EAEnC,IAAI,QAAQ,cAAc,QACxB,cAAc,YAAY,QAAQ;EAMpC,cAAc,cAAc,QAAQ,eAAe;EAEnD,KAAK,SAAS,OAAO,OAAO,KAAK,UAAU,aAAa,CAAC;EACzD,OAAO;CACT;;CAGA,MAAM,OAAsB;EAC1B,IAAI,CAAC,KAAK,QACR;EAKF,MAAM,SAAS,KAAK;EACpB,KAAK,SAAS;EACd,MAAM,KAAK,KAAK,YAAY,CAAC,CAAC;EAC9B,KAAK,CAAC,CAAC,QAAQ,MAAM;CACvB;;;;;;;;;;;CAYA,MAAM,EAAC,oBAAoB,UAAuB,CAAC,GAAS;EAC1D,IAAI,CAAC,KAAK,QACR;EAEF,KAAK,CAAC,CAAC,MAAM,KAAK,QAAQ,iBAAiB;CAC7C;;;;;CAMA,MAAM,WAAW,SAAkD;EAGjE,MAAM,UAAU,UAAU,OAAO;EACjC,IAAI,CAAC,KAAK,QACR,KAAK,MAAM;EAEb,MAAM,SAAS,KAAK;EACpB,MAAM,SAAS,KAAK;EAIpB,MAAM,SAAS,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,WAC/B,OAAO,QAAQ,QAAQ,KAAK,UAAU,OAAO,CAAC,CAAC;EACzD,KAAK,OAAO,OAAO,YAAY,CAAC,CAAC;EACjC,MAAM,QAAQ,MAAM;EACpB,OAAO,QAAQ,OAAO,OAAO;CAC/B;AACF;;AAGA,MAAM,SAAS,IAAI,cAAc;;AAGjC,MAAM,cAAc,YAChB,OAAO,WAAW,OAAO;AAI7B,qBAAe;CAAC;CAAe;CAAQ;AAAU"}

package/dist/platform-DU8DYqmA.js

@@ -1,32 +0,0 @@
-import { createRequire } from "node:module";
-import path from "node:path";
-
-//#region src/lib/platform.ts
-const require = createRequire(import.meta.url);
-const PACKAGES = {
-	"win32-x64": "@shotkit/shotium-win32-x64",
-	"win32-arm64": "@shotkit/shotium-win32-arm64",
-	"darwin-x64": "@shotkit/shotium-darwin-x64",
-	"darwin-arm64": "@shotkit/shotium-darwin-arm64",
-	"linux-x64": "@shotkit/shotium-linux-x64",
-	"linux-arm64": "@shotkit/shotium-linux-arm64"
-};
-function packageName(platform = process.platform, arch = process.arch) {
-	return PACKAGES[`${platform}-${arch}`] ?? null;
-}
-function packageDir() {
-	const name = packageName();
-	if (!name) return null;
-	try {
-		return path.dirname(require.resolve(`${name}/package.json`));
-	} catch {
-		return null;
-	}
-}
-function binaryName() {
-	return process.platform === "win32" ? "shotium.exe" : "shotium";
-}
-
-//#endregion
-export { packageDir as n, packageName as r, binaryName as t };
-//# sourceMappingURL=platform-DU8DYqmA.js.map

package/dist/platform-DU8DYqmA.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"platform-DU8DYqmA.js","names":[],"sources":["../src/lib/platform.ts"],"sourcesContent":["import {createRequire} from 'node:module';\nimport path from 'node:path';\n\n// require.resolve is the resolver, and ESM has no synchronous equivalent\n// that answers for a package that may not be installed at all.\nconst require = createRequire(import.meta.url);\n\n// Which package carries the engine for this machine.\n//\n// The engine is not in this package and cannot be: it is a Chromium build,\n// 41 MB per platform and architecture, six of them, and `npm install` is never\n// going to produce one. So the bytes live in six packages of their own and\n// this one depends on all six as optionalDependencies with `os` and `cpu` set,\n// which is npm's way of saying \"install the one that matches this machine and\n// skip the other five\". A machine nobody builds for installs none of them and\n// still gets a working package -- it just has to be pointed at an engine.\n//\n// The alternative, a postinstall script that downloads a tarball, was not\n// chosen. It defeats a lockfile, which is supposed to pin what you get; it\n// fails behind a registry mirror, which is the one place a large dependency\n// most needs to work; and it runs code at install time in exchange for saving\n// nothing that npm was not already doing.\n//\n// Key and name are both `${process.platform}-${process.arch}`, so the table is\n// the identity map with a prefix on it. That is deliberate: the value npm\n// matches `os` and `cpu` against is process.platform, and a package named for\n// anything else makes the reader hold two spellings of one machine in their\n// head. It is also what every other package of this shape does -- esbuild,\n// swc, lightningcss all publish darwin-arm64 and win32-x64.\n//\n// The release archives spell it win/mac instead -- shotium-mac-arm64.7z --\n// and that is not going to change either. They are downloaded by people, and\n// `mac` is what people call it. So the two spellings do differ, in the one\n// place where each is right: the registry gets node's, the download page gets\n// the reader's.\nconst PACKAGES: Readonly<Record<string, string>> = {\n  'win32-x64': '@shotkit/shotium-win32-x64',\n  'win32-arm64': '@shotkit/shotium-win32-arm64',\n  'darwin-x64': '@shotkit/shotium-darwin-x64',\n  'darwin-arm64': '@shotkit/shotium-darwin-arm64',\n  'linux-x64': '@shotkit/shotium-linux-x64',\n  'linux-arm64': '@shotkit/shotium-linux-arm64',\n};\n\nfunction packageName(\n    platform: string = process.platform,\n    arch: string = process.arch): string|null {\n  return PACKAGES[`${platform}-${arch}`] ?? null;\n}\n\n// Where the matching platform package unpacked, or null if it is not installed.\n//\n// require.resolve rather than a path built from the module's own location: the\n// package can be hoisted to a workspace root, nested under this one, or left\n// in a pnpm store with a symlink pointing at it, and the resolver is the only\n// thing that knows which of those happened.\nfunction packageDir(): string|null {\n  const name = packageName();\n  if (!name) {\n    return null;\n  }\n  try {\n    return path.dirname(require.resolve(`${name}/package.json`));\n  } catch {\n    return null;\n  }\n}\n\n// What the engine executable is called, which is not what the platform calls\n// it: Windows wants the extension and nothing else does.\nfunction binaryName(): string {\n  return process.platform === 'win32' ? 'shotium.exe' : 'shotium';\n}\n\nexport {PACKAGES, binaryName, packageDir, packageName};\n"],"mappings":";;;;AAKA,MAAM,UAAU,cAAc,YAAY,GAAG;AA8B7C,MAAM,WAA6C;CACjD,aAAa;CACb,eAAe;CACf,cAAc;CACd,gBAAgB;CAChB,aAAa;CACb,eAAe;AACjB;AAEA,SAAS,YACL,WAAmB,QAAQ,UAC3B,OAAe,QAAQ,MAAmB;CAC5C,OAAO,SAAS,GAAG,SAAS,GAAG,WAAW;AAC5C;AAQA,SAAS,aAA0B;CACjC,MAAM,OAAO,YAAY;CACzB,IAAI,CAAC,MACH,OAAO;CAET,IAAI;EACF,OAAO,KAAK,QAAQ,QAAQ,QAAQ,GAAG,KAAK,cAAc,CAAC;CAC7D,QAAQ;EACN,OAAO;CACT;AACF;AAIA,SAAS,aAAqB;CAC5B,OAAO,QAAQ,aAAa,UAAU,gBAAgB;AACxD"}

package/dist/pool-BSgS6vkr.js

@@ -1,356 +0,0 @@
-import { n as packageDir, t as binaryName } from "./platform-DU8DYqmA.js";
-import { EventEmitter } from "node:events";
-import { spawn } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import os from "node:os";
-import crypto from "node:crypto";
-
-//#region src/lib/config.ts
-const HERE = path.dirname(fileURLToPath(import.meta.url));
-function defaultBinary() {
-	if (process.env.SHOTIUM_BINARY) return process.env.SHOTIUM_BINARY;
-	const dir = packageDir();
-	if (dir) return path.join(dir, binaryName());
-	return path.join(HERE, "..", "bin", binaryName());
-}
-const MAXIMUM_DEFAULT_WORKERS = 4;
-function defaultWorkers() {
-	const half = Math.floor((os.cpus().length || 2) / 2);
-	return Math.max(1, Math.min(MAXIMUM_DEFAULT_WORKERS, half));
-}
-function defaultCacheDir() {
-	return path.join(os.tmpdir(), "shotium-cache");
-}
-function resolveStartOptions(options = {}) {
-	return {
-		binary: options.binary || defaultBinary(),
-		workers: options.workers || defaultWorkers(),
-		cacheDir: options.cacheDir === null ? null : options.cacheDir || defaultCacheDir(),
-		args: options.args || []
-	};
-}
-
-//#endregion
-//#region src/lib/endpoint.ts
-function endpointKey(options) {
-	if (options.name) return String(options.name);
-	const identity = JSON.stringify([
-		path.resolve(options.binary || ""),
-		options.workers,
-		options.cacheDir === null ? null : path.resolve(options.cacheDir || ""),
-		options.args || []
-	]);
-	return crypto.createHash("sha256").update(identity).digest("hex").slice(0, 16);
-}
-function endpointFor(options = {}) {
-	if (options.endpoint) return options.endpoint;
-	if (process.env.SHOTIUM_ENDPOINT) return process.env.SHOTIUM_ENDPOINT;
-	const key = endpointKey(options);
-	if (process.platform === "win32") return `\\\\.\\pipe\\shotium-${key}`;
-	const uid = typeof process.getuid === "function" ? process.getuid() : 0;
-	return path.join(os.tmpdir(), `shotium-${uid}-${key}.sock`);
-}
-
-//#endregion
-//#region src/lib/protocol.ts
-const HEADER_BYTES = 4;
-function encodeFrame(payload) {
-	const header = Buffer.allocUnsafe(4);
-	header.writeUInt32LE(payload.length, 0);
-	return Buffer.concat([header, payload]);
-}
-function encodeRequest(request) {
-	return encodeFrame(Buffer.from(JSON.stringify(request), "utf8"));
-}
-var FrameReader = class {
-	buffer = Buffer.alloc(0);
-	push(chunk) {
-		this.buffer = this.buffer.length === 0 ? chunk : Buffer.concat([this.buffer, chunk]);
-	}
-	next() {
-		if (this.buffer.length < 4) return null;
-		const length = this.buffer.readUInt32LE(0);
-		if (this.buffer.length < 4 + length) return null;
-		const frame = this.buffer.subarray(4, 4 + length);
-		this.buffer = this.buffer.subarray(4 + length);
-		return frame;
-	}
-};
-
-//#endregion
-//#region src/lib/worker.ts
-var Worker = class extends EventEmitter {
-	id;
-	served = 0;
-	binary;
-	args;
-	process = null;
-	pending = null;
-	stopping = false;
-	reader = new FrameReader();
-	header = null;
-	stderr = "";
-	constructor(options) {
-		super();
-		this.id = options.id;
-		this.binary = options.binary;
-		this.args = options.args || [];
-		this.start();
-	}
-	get busy() {
-		return this.pending !== null;
-	}
-	get alive() {
-		return this.process !== null && this.process.exitCode === null && !this.stopping;
-	}
-	start() {
-		const stdio = [
-			"pipe",
-			"pipe",
-			"pipe"
-		];
-		const child = spawn(this.binary, ["--serve", ...this.args], {
-			stdio,
-			windowsHide: true,
-			detached: true
-		});
-		this.process = child;
-		child.stdout?.on("data", (chunk) => this.onStdout(chunk));
-		child.stderr?.on("data", (chunk) => this.onStderr(chunk));
-		child.on("error", (error) => this.onGone(null, null, error));
-		child.on("exit", (code, signal) => this.onGone(code, signal, null));
-		this.emit("ready");
-	}
-	onStdout(chunk) {
-		this.reader.push(chunk);
-		for (;;) {
-			const frame = this.reader.next();
-			if (frame === null) return;
-			if (this.header === null) {
-				try {
-					this.header = JSON.parse(frame.toString("utf8"));
-				} catch {
-					this.fail(/* @__PURE__ */ new Error(`shotium: worker ${this.id} sent a header that is not JSON`));
-					return;
-				}
-				continue;
-			}
-			const header = this.header;
-			this.header = null;
-			this.settle(header, frame);
-		}
-	}
-	onStderr(chunk) {
-		this.stderr += chunk.toString("utf8");
-		const lines = this.stderr.split(/\r?\n/);
-		this.stderr = lines.pop() ?? "";
-		for (const line of lines) if (line.length > 0) this.emit("stderr", {
-			worker: this.id,
-			line
-		});
-	}
-	onGone(code, signal, error) {
-		const wasOwed = this.pending !== null;
-		this.process = null;
-		if (wasOwed) {
-			this.fail(error || /* @__PURE__ */ new Error(`shotium: worker ${this.id} exited (code ${code}, signal ${signal}) with a request in flight`));
-			this.emit("crash", {
-				worker: this.id,
-				code,
-				signal
-			});
-		} else if (error) this.emit("error", error);
-		this.emit("exit", {
-			worker: this.id,
-			code,
-			signal
-		});
-	}
-	settle(header, payload) {
-		const pending = this.pending;
-		if (!pending) return;
-		this.pending = null;
-		this.served += 1;
-		if (header.ok) pending.resolve({
-			header,
-			image: header.path ? null : payload
-		});
-		else pending.reject(new Error(header.error || "shotium: request failed"));
-	}
-	fail(error) {
-		const pending = this.pending;
-		if (!pending) return;
-		this.pending = null;
-		pending.reject(error);
-	}
-	send(request) {
-		if (this.pending) return Promise.reject(/* @__PURE__ */ new Error(`shotium: worker ${this.id} is already busy`));
-		if (!this.alive) return Promise.reject(/* @__PURE__ */ new Error(`shotium: worker ${this.id} is not up`));
-		return new Promise((resolve, reject) => {
-			this.pending = {
-				resolve,
-				reject
-			};
-			this.process?.stdin?.write(encodeRequest(request), (error) => {
-				if (error) this.fail(error);
-			});
-		});
-	}
-	stop() {
-		this.stopping = true;
-		this.process?.stdin?.end();
-	}
-	kill() {
-		this.stopping = true;
-		this.process?.kill();
-	}
-};
-
-//#endregion
-//#region src/lib/pool.ts
-const FAST_FAILURE_MS = 1e3;
-const RESPAWN_DELAY_MS = 100;
-const MAX_RESPAWN_DELAY_MS = 5e3;
-var Pool = class extends EventEmitter {
-	binary;
-	size;
-	args;
-	cacheDir;
-	slots = [];
-	failures = [];
-	queue = [];
-	stopping = false;
-	nextId = 0;
-	constructor(options) {
-		super();
-		this.binary = options.binary;
-		this.size = options.workers;
-		this.args = options.args || [];
-		this.cacheDir = options.cacheDir || null;
-	}
-	start() {
-		if (this.slots.length > 0) return;
-		for (let slot = 0; slot < this.size; ++slot) this.slots[slot] = this.spawn(slot);
-		this.emit("ready", { workers: this.size });
-	}
-	spawn(slot) {
-		const id = this.nextId++;
-		const args = [...this.args];
-		if (this.cacheDir) {
-			const dir = path.join(this.cacheDir, `worker-${slot}`);
-			fs.mkdirSync(dir, { recursive: true });
-			args.push(`--cache-dir=${dir}`);
-		}
-		const startedAt = Date.now();
-		const worker = new Worker({
-			id,
-			binary: this.binary,
-			args
-		});
-		worker.on("stderr", (event) => this.emit("stderr", event));
-		worker.on("crash", (event) => this.emit("crash", event));
-		worker.on("error", (error) => this.emit("worker-error", {
-			worker: id,
-			error
-		}));
-		worker.on("exit", (event) => {
-			this.emit("exit", event);
-			if (this.stopping || this.slots[slot] !== worker) return;
-			const started = worker.served > 0 || Date.now() - startedAt >= FAST_FAILURE_MS;
-			if (started) this.failures[slot] = 0;
-			const failures = this.failures[slot] || 0;
-			const delay = started ? 0 : Math.min(MAX_RESPAWN_DELAY_MS, RESPAWN_DELAY_MS * 2 ** failures);
-			this.failures[slot] = failures + 1;
-			const refill = () => {
-				if (this.stopping || this.slots[slot] !== worker) return;
-				const replacement = this.spawn(slot);
-				this.slots[slot] = replacement;
-				this.emit("worker-restart", {
-					worker: replacement.id,
-					reason: "exit",
-					delay
-				});
-				this.pump();
-			};
-			if (delay === 0) {
-				refill();
-				return;
-			}
-			setTimeout(refill, delay).unref();
-		});
-		return worker;
-	}
-	submit(request, { timeout, retry }) {
-		return new Promise((resolve, reject) => {
-			this.queue.push({
-				request,
-				timeout,
-				attemptsLeft: Math.max(0, retry) + 1,
-				resolve,
-				reject
-			});
-			this.pump();
-		});
-	}
-	pump() {
-		while (this.queue.length > 0) {
-			const slot = this.slots.findIndex((w) => w && w.alive && !w.busy);
-			if (slot < 0) return;
-			this.dispatch(this.slots[slot], this.queue.shift());
-		}
-	}
-	dispatch(worker, job) {
-		job.attemptsLeft -= 1;
-		let settled = false;
-		const timer = setTimeout(() => {
-			if (settled) return;
-			settled = true;
-			this.emit("timeout", {
-				worker: worker.id,
-				timeout: job.timeout
-			});
-			worker.kill();
-			this.retryOrFail(job, /* @__PURE__ */ new Error(`shotium: no answer within ${job.timeout}ms`));
-		}, job.timeout);
-		worker.send(job.request).then((result) => {
-			if (settled) return;
-			settled = true;
-			clearTimeout(timer);
-			job.resolve(result);
-			this.pump();
-		}).catch((error) => {
-			if (settled) return;
-			settled = true;
-			clearTimeout(timer);
-			this.retryOrFail(job, error);
-		});
-	}
-	retryOrFail(job, error) {
-		if (job.attemptsLeft > 0 && !this.stopping) {
-			this.queue.unshift(job);
-			this.pump();
-			return;
-		}
-		job.reject(error);
-		this.pump();
-	}
-	async stop() {
-		this.stopping = true;
-		for (const job of this.queue.splice(0)) job.reject(/* @__PURE__ */ new Error("shotium: the runtime was stopped"));
-		await Promise.all(this.slots.map((worker) => new Promise((resolve) => {
-			if (!worker || !worker.alive) {
-				resolve();
-				return;
-			}
-			worker.once("exit", () => resolve());
-			worker.stop();
-		})));
-		this.slots = [];
-	}
-};
-
-//#endregion
-export { resolveStartOptions as a, endpointFor as i, FrameReader as n, encodeFrame as r, Pool as t };
-//# sourceMappingURL=pool-BSgS6vkr.js.map