@moldea.ai/core 8.0.0 → 9.0.1

package/dist/chunks/{errors-CvWn6gr2.js → errors-Uvb-9X1u.js}

@@ -1,4 +1,5 @@
-import { a as isCoreOperationErrorCode, i as isCoreOperation, n as CoreOperationException, r as isCoreConfigurationErrorCode, t as CoreConfigurationException } from "./exceptions-CYf1pCKf.js";
+import { a as isCoreOperationErrorCode, i as isCoreOperation, n as CoreOperationException, r as isCoreConfigurationErrorCode, t as CoreConfigurationException } from "./exceptions-AT654xUL.js";
+import { isObjectValid, measureJsonBytes } from "jg-utilities";
 import { RepositoryPathException, RepositorySourceException, isRepositoryPath } from "@moldea.ai/repository";
 import { Buffer } from "node:buffer";
 //#region src/node-inspection/constants.ts
@@ -27,25 +28,17 @@ var createInspectionProcessFailure = (cause) => new CoreOperationException({
 	operation: "create-project-inspection",
 	...cause === void 0 ? {} : { cause }
 });
-var isRecord = (input) => input !== null && typeof input === "object" && !Array.isArray(input);
-var JSON_SHORT_ESCAPES = /* @__PURE__ */ new Set([
-	8,
-	9,
-	10,
-	12,
-	13
-]);
 var isInteger = (input) => typeof input === "number" && Number.isSafeInteger(input) && input >= 0;
 var hasKeys = (input, required, optional = []) => required.every((key) => Object.hasOwn(input, key)) && Object.keys(input).every((key) => required.includes(key) || optional.includes(key));
-var isSnapshot = (input) => isRecord(input) && hasKeys(input, ["id", "sourceKind"]) && typeof input["id"] === "string" && input["id"].length > 0 && typeof input["sourceKind"] === "string" && input["sourceKind"].length > 0;
+var isSnapshot = (input) => isObjectValid(input, true) && hasKeys(input, ["id", "sourceKind"]) && typeof input["id"] === "string" && input["id"].length > 0 && typeof input["sourceKind"] === "string" && input["sourceKind"].length > 0;
 var isOptionalString = (input, key) => !Object.hasOwn(input, key) || typeof input[key] === "string";
-var isPageInput = (input) => isRecord(input) && hasKeys(input, ["maxItems", "view"], ["cursor"]) && isInteger(input["maxItems"]) && input["maxItems"] > 0 && [
+var isPageInput = (input) => isObjectValid(input, true) && hasKeys(input, ["maxItems", "view"], ["cursor"]) && isInteger(input["maxItems"]) && input["maxItems"] > 0 && [
 	"all",
 	"diagnostics",
 	"coverage",
 	"metadata"
 ].includes(String(input["view"])) && isOptionalString(input, "cursor");
-var isLimits = (input) => isRecord(input) && hasKeys(input, [
+var isLimits = (input) => isObjectValid(input, true) && hasKeys(input, [
 	"maxEntries",
 	"maxTotalBytesRead",
 	"maxFileBytes",
@@ -55,7 +48,7 @@ var isLimits = (input) => isRecord(input) && hasKeys(input, [
 	"maxCoverage",
 	"maxAcceptedWarnings"
 ]) && Object.values(input).every((limit) => isInteger(limit) && limit > 0);
-var isCounts = (input) => isRecord(input) && hasKeys(input, [
+var isCounts = (input) => isObjectValid(input, true) && hasKeys(input, [
 	"agents",
 	"context",
 	"decisions",
@@ -69,13 +62,13 @@ var isCounts = (input) => isRecord(input) && hasKeys(input, [
 	"coverage",
 	"metadata"
 ]) && Object.values(input).every(isInteger);
-var isSummary = (input) => input === null || isRecord(input) && hasKeys(input, [
+var isSummary = (input) => input === null || isObjectValid(input, true) && hasKeys(input, [
 	"counts",
 	"manifestDigest",
 	"manifestPath",
 	"projectDigest",
 	"projectPath"
-]) && isRecord(input["counts"]) && hasKeys(input["counts"], [
+]) && isObjectValid(input["counts"], true) && hasKeys(input["counts"], [
 	"agents",
 	"context",
 	"decisions",
@@ -83,7 +76,7 @@ var isSummary = (input) => input === null || isRecord(input) && hasKeys(input, [
 	"runtimes",
 	"unresolved"
 ]) && Object.values(input["counts"]).every(isInteger) && typeof input["manifestDigest"] === "string" && typeof input["projectDigest"] === "string" && isRepositoryPath(input["manifestPath"]) && isRepositoryPath(input["projectPath"]);
-var isInspectionBase = (input) => isCounts(input["counts"]) && isRecord(input["coverageCounts"]) && hasKeys(input["coverageCounts"], [
+var isInspectionBase = (input) => isCounts(input["counts"]) && isObjectValid(input["coverageCounts"], true) && hasKeys(input["coverageCounts"], [
 	"bindings",
 	"exportsPassed",
 	"exportsFailed",
@@ -98,18 +91,18 @@ var INSPECTION_KEYS = [
 	"source",
 	"summary"
 ];
-var isMetadata = (input) => isRecord(input) && hasKeys(input, [
+var isMetadata = (input) => isObjectValid(input, true) && hasKeys(input, [
 	...INSPECTION_KEYS,
 	"resourceUsage",
 	"maxAnalysisHeapBytes"
-]) && isInspectionBase(input) && isInteger(input["maxAnalysisHeapBytes"]) && input["maxAnalysisHeapBytes"] > 0 && isRecord(input["resourceUsage"]) && hasKeys(input["resourceUsage"], [
+]) && isInspectionBase(input) && isInteger(input["maxAnalysisHeapBytes"]) && input["maxAnalysisHeapBytes"] > 0 && isObjectValid(input["resourceUsage"], true) && hasKeys(input["resourceUsage"], [
 	"canonicalBytes",
 	"peakRetainedBytes",
 	"preparedBytes",
 	"retainedBytes",
 	"totalBytesRead"
 ]) && Object.values(input["resourceUsage"]).every(isInteger);
-var isPage = (input) => isRecord(input) && hasKeys(input, [
+var isPage = (input) => isObjectValid(input, true) && hasKeys(input, [
 	...INSPECTION_KEYS,
 	"page",
 	"view"
@@ -118,22 +111,22 @@ var isPage = (input) => isRecord(input) && hasKeys(input, [
 	"diagnostics",
 	"coverage",
 	"metadata"
-].includes(String(input["view"])) && isRecord(input["page"]) && hasKeys(input["page"], [
+].includes(String(input["view"])) && isObjectValid(input["page"], true) && hasKeys(input["page"], [
 	"isComplete",
 	"records",
 	"nextCursor",
 	"totalItems"
-]) && typeof input["page"]["isComplete"] === "boolean" && isInteger(input["page"]["totalItems"]) && (input["page"]["nextCursor"] === null || typeof input["page"]["nextCursor"] === "string") && Array.isArray(input["page"]["records"]) && input["page"]["records"].every((record) => isRecord(record) && hasKeys(record, ["item", "nextCursor"]) && (record["nextCursor"] === null || typeof record["nextCursor"] === "string") && isRecord(record["item"]) && typeof record["item"]["kind"] === "string" && [
+]) && typeof input["page"]["isComplete"] === "boolean" && isInteger(input["page"]["totalItems"]) && (input["page"]["nextCursor"] === null || typeof input["page"]["nextCursor"] === "string") && Array.isArray(input["page"]["records"]) && input["page"]["records"].every((record) => isObjectValid(record, true) && hasKeys(record, ["item", "nextCursor"]) && (record["nextCursor"] === null || typeof record["nextCursor"] === "string") && isObjectValid(record["item"], true) && typeof record["item"]["kind"] === "string" && [
 	"agent",
 	"diagnostic",
 	"coverage",
 	"metadata"
-].includes(record["item"]["kind"]) && hasKeys(record["item"], ["kind", record["item"]["kind"]]) && isRecord(record["item"][record["item"]["kind"]]));
+].includes(record["item"]["kind"]) && hasKeys(record["item"], ["kind", record["item"]["kind"]]) && isObjectValid(record["item"][record["item"]["kind"]], true));
 var isSource = (input) => input === "instructions" || input === "repository";
 var isFilePageRequest = (input) => isRepositoryPath(input["path"]) && isInteger(input["offset"]) && isInteger(input["maxBytes"]) && input["maxBytes"] > 0 && input["maxBytes"] <= 65536;
-var isInstructionSource = (input) => input === null || isRecord(input) && hasKeys(input, ["snapshot"]) && isSnapshot(input["snapshot"]);
+var isInstructionSource = (input) => input === null || isObjectValid(input, true) && hasKeys(input, ["snapshot"]) && isSnapshot(input["snapshot"]);
 var isRequest = (input) => {
-	if (!isRecord(input)) return false;
+	if (!isObjectValid(input, true)) return false;
 	switch (input["method"]) {
 		case "getEntry":
 		case "readLinkText": return hasKeys(input, [
@@ -154,7 +147,7 @@ var isRequest = (input) => {
 };
 /** Validates closed control envelopes and their typed operation payloads on both bridges. */
 var isMessage = (input) => {
-	if (!isRecord(input) || typeof input["attemptId"] !== "string" || !/^[a-f0-9]{32}$/.test(input["attemptId"])) return false;
+	if (!isObjectValid(input, true) || typeof input["attemptId"] !== "string" || !/^[a-f0-9]{32}$/.test(input["attemptId"])) return false;
 	const keys = ["attemptId", "kind"];
 	switch (input["kind"]) {
 		case "start": return hasKeys(input, [
@@ -193,53 +186,15 @@ var isMessage = (input) => {
 			...keys,
 			"failure",
 			...input["kind"] === "reader-failure" ? ["requestId"] : []
-		]) && (input["kind"] !== "reader-failure" || isInteger(input["requestId"])) && isRecord(input["failure"]) && hasKeys(input["failure"], ["family", "options"]) && [
+		]) && (input["kind"] !== "reader-failure" || isInteger(input["requestId"])) && isObjectValid(input["failure"], true) && hasKeys(input["failure"], ["family", "options"]) && [
 			"configuration",
 			"operation",
 			"repository",
 			"path"
-		].includes(String(input["failure"]["family"])) && isRecord(input["failure"]["options"]);
+		].includes(String(input["failure"]["family"])) && isObjectValid(input["failure"]["options"], true);
 		default: return false;
 	}
 };
-/** Counts escaped JSON bytes without first allocating a serialized oversized message. */
-var countJsonBytes = (input, ancestors, depth) => {
-	if (depth > 64) throw createInspectionProcessFailure();
-	if (input === null) return 4;
-	if (typeof input === "boolean") return input ? 4 : 5;
-	if (typeof input === "number" && Number.isFinite(input)) return String(input).length;
-	if (typeof input === "string") {
-		let bytes = 2;
-		for (let index = 0; index < input.length; index++) {
-			const code = input.charCodeAt(index);
-			if (code === 34 || code === 92 || JSON_SHORT_ESCAPES.has(code)) bytes += 2;
-			else if (code < 32) bytes += 6;
-			else if (code < 128) bytes++;
-			else if (code < 2048) bytes += 2;
-			else if (code >= 55296 && code <= 56319 && index + 1 < input.length && input.charCodeAt(index + 1) >= 56320 && input.charCodeAt(index + 1) <= 57343) {
-				bytes += 4;
-				index++;
-			} else bytes += code >= 55296 && code <= 57343 ? 6 : 3;
-			if (bytes > 1048576) return bytes;
-		}
-		return bytes;
-	}
-	if (typeof input !== "object" || ancestors.has(input)) throw createInspectionProcessFailure();
-	ancestors.add(input);
-	let bytes = 2;
-	let count = 0;
-	if (Array.isArray(input)) for (const element of input) {
-		bytes += (count++ === 0 ? 0 : 1) + countJsonBytes(element, ancestors, depth + 1);
-		if (bytes > 1048576) break;
-	}
-	else for (const key in input) {
-		if (!Object.hasOwn(input, key)) continue;
-		bytes += (count++ === 0 ? 0 : 1) + countJsonBytes(key, ancestors, depth + 1) + 1 + countJsonBytes(input[key], ancestors, depth + 1);
-		if (bytes > 1048576) break;
-	}
-	ancestors.delete(input);
-	return bytes;
-};
 /**
 * Admits a complete bounded record before serialization; no record is truncated.
 * @returns One private JSON frame.
@@ -248,7 +203,12 @@ var countJsonBytes = (input, ancestors, depth) => {
 * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.
 */
 var encodeInspectionMessage = (message) => {
-	const bytes = countJsonBytes(message, /* @__PURE__ */ new WeakSet(), 0);
+	let bytes;
+	try {
+		bytes = measureJsonBytes(message, NODE_INSPECTION_MESSAGE_BYTES);
+	} catch (error) {
+		throw createInspectionProcessFailure(error);
+	}
 	if (bytes > 1048576) throw new CoreOperationException({
 		code: "RESOURCE_LIMIT_EXCEEDED",
 		limit: "maxInspectionMessageBytes",
@@ -437,4 +397,4 @@ var deserializeInspectionFailure = (failure) => {
 //#endregion
 export { encodeInspectionMessage as a, NODE_INSPECTION_PROFILE as c, NODE_INSPECTION_TRANSPORT_BYTES as d, decodeInspectionMessage as i, NODE_INSPECTION_STDIO_BYTES as l, serializeInspectionFailure as n, NODE_INSPECTION_FILE_PAGE_BYTES as o, createInspectionProcessFailure as r, NODE_INSPECTION_LIFETIME_MS as s, deserializeInspectionFailure as t, NODE_INSPECTION_TERMINATION_GRACE_MS as u };
 
-//# sourceMappingURL=errors-CvWn6gr2.js.map
+//# sourceMappingURL=errors-Uvb-9X1u.js.map

package/dist/chunks/errors-Uvb-9X1u.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-Uvb-9X1u.js","names":[],"sources":["../../src/node-inspection/constants.ts","../../src/node-inspection/protocol.ts","../../src/node-inspection/errors.ts"],"sourcesContent":["// whole-attempt lifetime and bounded bridge ownership, independent of source file size\nexport const NODE_INSPECTION_LIFETIME_MS = 120_000;\nexport const NODE_INSPECTION_TERMINATION_GRACE_MS = 1_000;\nexport const NODE_INSPECTION_MAX_REQUESTS = 4;\nexport const NODE_INSPECTION_FILE_PAGE_BYTES = 65_536;\nexport const NODE_INSPECTION_MESSAGE_BYTES = 1_048_576;\nexport const NODE_INSPECTION_STDIO_BYTES = 32_768;\n\n// two UTF-16 bytes per serialized byte, two copies at each owner, for every RPC credit\nexport const NODE_INSPECTION_TRANSPORT_BYTES =\n  NODE_INSPECTION_MAX_REQUESTS * NODE_INSPECTION_MESSAGE_BYTES * 2 * 2 * 3;\n\n// fixed profile qualified in the constrained CLI and actual-worker lanes\nexport const NODE_INSPECTION_OLD_GENERATION_MIB = 512;\nexport const NODE_INSPECTION_YOUNG_GENERATION_MIB = 24;\n\n// immutable execution identity for consumers that authenticate prepared inspection state\nexport const NODE_INSPECTION_PROFILE = Object.freeze({\n  lifetimeMs: NODE_INSPECTION_LIFETIME_MS,\n  terminationGraceMs: NODE_INSPECTION_TERMINATION_GRACE_MS,\n  maxReaderRequests: NODE_INSPECTION_MAX_REQUESTS,\n  maxFilePageBytes: NODE_INSPECTION_FILE_PAGE_BYTES,\n  maxMessageBytes: NODE_INSPECTION_MESSAGE_BYTES,\n  maxStdioBytes: NODE_INSPECTION_STDIO_BYTES,\n  transportBytes: NODE_INSPECTION_TRANSPORT_BYTES,\n  oldGenerationMiB: NODE_INSPECTION_OLD_GENERATION_MIB,\n  youngGenerationMiB: NODE_INSPECTION_YOUNG_GENERATION_MIB,\n});\n","import { Buffer } from 'node:buffer';\nimport { isObjectValid, measureJsonBytes } from 'jg-utilities';\n\nimport { isRepositoryPath } from '@moldea.ai/repository';\n\nimport type { ICoreResourceLimits } from '../contracts/index.js';\nimport { CoreOperationException } from '../exceptions/index.js';\n\nimport { NODE_INSPECTION_FILE_PAGE_BYTES, NODE_INSPECTION_MESSAGE_BYTES } from './constants.js';\nimport type { INodeInspectionMessage } from './types.js';\n\n/** Creates the safe failure for an untrusted or inconsistent private protocol record. */\nexport const createInspectionProcessFailure = (cause?: unknown): CoreOperationException =>\n  new CoreOperationException({\n    code: 'INSPECTION_PROCESS_FAILED',\n    operation: 'create-project-inspection',\n    ...(cause === undefined ? {} : { cause }),\n  });\n\nconst isInteger = (input: unknown): input is number =>\n  typeof input === 'number' && Number.isSafeInteger(input) && input >= 0;\nconst hasKeys = (\n  input: Record<string, unknown>,\n  required: string[],\n  optional: string[] = [],\n): boolean =>\n  required.every((key) => Object.hasOwn(input, key)) &&\n  Object.keys(input).every((key) => required.includes(key) || optional.includes(key));\nconst isSnapshot = (input: unknown): boolean =>\n  isObjectValid(input, true) &&\n  hasKeys(input, ['id', 'sourceKind']) &&\n  typeof input['id'] === 'string' &&\n  input['id'].length > 0 &&\n  typeof input['sourceKind'] === 'string' &&\n  input['sourceKind'].length > 0;\nconst isOptionalString = (input: Record<string, unknown>, key: string): boolean =>\n  !Object.hasOwn(input, key) || typeof input[key] === 'string';\nconst isPageInput = (input: unknown): boolean =>\n  isObjectValid(input, true) &&\n  hasKeys(input, ['maxItems', 'view'], ['cursor']) &&\n  isInteger(input['maxItems']) &&\n  input['maxItems'] > 0 &&\n  ['all', 'diagnostics', 'coverage', 'metadata'].includes(String(input['view'])) &&\n  isOptionalString(input, 'cursor');\nconst isLimits = (input: unknown): input is ICoreResourceLimits =>\n  isObjectValid(input, true) &&\n  hasKeys(input, [\n    'maxEntries',\n    'maxTotalBytesRead',\n    'maxFileBytes',\n    'maxManifestBytes',\n    'maxRetainedBytes',\n    'maxDiagnostics',\n    'maxCoverage',\n    'maxAcceptedWarnings',\n  ]) &&\n  Object.values(input).every((limit) => isInteger(limit) && limit > 0);\nconst isCounts = (input: unknown): boolean =>\n  isObjectValid(input, true) &&\n  hasKeys(input, [\n    'agents',\n    'context',\n    'decisions',\n    'mirrors',\n    'runtimes',\n    'unresolved',\n    'diagnostics',\n    'errors',\n    'warnings',\n    'acceptedWarnings',\n    'coverage',\n    'metadata',\n  ]) &&\n  Object.values(input).every(isInteger);\nconst isSummary = (input: unknown): boolean =>\n  input === null ||\n  (isObjectValid(input, true) &&\n    hasKeys(input, ['counts', 'manifestDigest', 'manifestPath', 'projectDigest', 'projectPath']) &&\n    isObjectValid(input['counts'], true) &&\n    hasKeys(input['counts'], [\n      'agents',\n      'context',\n      'decisions',\n      'mirrors',\n      'runtimes',\n      'unresolved',\n    ]) &&\n    Object.values(input['counts']).every(isInteger) &&\n    typeof input['manifestDigest'] === 'string' &&\n    typeof input['projectDigest'] === 'string' &&\n    isRepositoryPath(input['manifestPath']) &&\n    isRepositoryPath(input['projectPath']));\nconst isInspectionBase = (input: Record<string, unknown>): boolean =>\n  isCounts(input['counts']) &&\n  isObjectValid(input['coverageCounts'], true) &&\n  hasKeys(input['coverageCounts'], [\n    'bindings',\n    'exportsPassed',\n    'exportsFailed',\n    'exportsNotChecked',\n  ]) &&\n  Object.values(input['coverageCounts']).every(isInteger) &&\n  typeof input['valid'] === 'boolean' &&\n  (input['formatVersion'] === null || input['formatVersion'] === 1) &&\n  typeof input['inspectionDigest'] === 'string' &&\n  isSnapshot(input['source']) &&\n  isSummary(input['summary']);\nconst INSPECTION_KEYS = [\n  'counts',\n  'coverageCounts',\n  'valid',\n  'formatVersion',\n  'inspectionDigest',\n  'source',\n  'summary',\n];\nconst isMetadata = (input: unknown): boolean =>\n  isObjectValid(input, true) &&\n  hasKeys(input, [...INSPECTION_KEYS, 'resourceUsage', 'maxAnalysisHeapBytes']) &&\n  isInspectionBase(input) &&\n  isInteger(input['maxAnalysisHeapBytes']) &&\n  input['maxAnalysisHeapBytes'] > 0 &&\n  isObjectValid(input['resourceUsage'], true) &&\n  hasKeys(input['resourceUsage'], [\n    'canonicalBytes',\n    'peakRetainedBytes',\n    'preparedBytes',\n    'retainedBytes',\n    'totalBytesRead',\n  ]) &&\n  Object.values(input['resourceUsage']).every(isInteger);\nconst isPage = (input: unknown): boolean =>\n  isObjectValid(input, true) &&\n  hasKeys(input, [...INSPECTION_KEYS, 'page', 'view']) &&\n  isInspectionBase(input) &&\n  ['all', 'diagnostics', 'coverage', 'metadata'].includes(String(input['view'])) &&\n  isObjectValid(input['page'], true) &&\n  hasKeys(input['page'], ['isComplete', 'records', 'nextCursor', 'totalItems']) &&\n  typeof input['page']['isComplete'] === 'boolean' &&\n  isInteger(input['page']['totalItems']) &&\n  (input['page']['nextCursor'] === null || typeof input['page']['nextCursor'] === 'string') &&\n  Array.isArray(input['page']['records']) &&\n  input['page']['records'].every(\n    (record: unknown) =>\n      isObjectValid(record, true) &&\n      hasKeys(record, ['item', 'nextCursor']) &&\n      (record['nextCursor'] === null || typeof record['nextCursor'] === 'string') &&\n      isObjectValid(record['item'], true) &&\n      typeof record['item']['kind'] === 'string' &&\n      ['agent', 'diagnostic', 'coverage', 'metadata'].includes(record['item']['kind']) &&\n      hasKeys(record['item'], ['kind', record['item']['kind']]) &&\n      isObjectValid(record['item'][record['item']['kind']], true),\n  );\nconst isSource = (input: unknown): boolean => input === 'instructions' || input === 'repository';\nconst isFilePageRequest = (input: Record<string, unknown>): boolean =>\n  isRepositoryPath(input['path']) &&\n  isInteger(input['offset']) &&\n  isInteger(input['maxBytes']) &&\n  input['maxBytes'] > 0 &&\n  input['maxBytes'] <= NODE_INSPECTION_FILE_PAGE_BYTES;\nconst isInstructionSource = (input: unknown): boolean =>\n  input === null ||\n  (isObjectValid(input, true) && hasKeys(input, ['snapshot']) && isSnapshot(input['snapshot']));\nconst isRequest = (input: unknown): boolean => {\n  if (!isObjectValid(input, true)) return false;\n  switch (input['method']) {\n    case 'getEntry':\n    case 'readLinkText':\n      return (\n        hasKeys(input, ['method', 'path', 'source']) &&\n        isRepositoryPath(input['path']) &&\n        isSource(input['source'])\n      );\n    case 'listEntriesPage':\n      return (\n        hasKeys(input, ['method', 'maxEntries'], ['cursor', 'prefix']) &&\n        isInteger(input['maxEntries']) &&\n        input['maxEntries'] > 0 &&\n        input['maxEntries'] <= 128 &&\n        isOptionalString(input, 'cursor') &&\n        (!Object.hasOwn(input, 'prefix') || isRepositoryPath(input['prefix']))\n      );\n    case 'readFilePage':\n      return (\n        hasKeys(input, ['method', 'path', 'maxBytes', 'offset', 'source']) &&\n        isSource(input['source']) &&\n        isFilePageRequest(input)\n      );\n    default:\n      return false;\n  }\n};\n\n/** Validates closed control envelopes and their typed operation payloads on both bridges. */\nconst isMessage = (input: unknown): input is INodeInspectionMessage => {\n  if (\n    !isObjectValid(input, true) ||\n    typeof input['attemptId'] !== 'string' ||\n    !/^[a-f0-9]{32}$/.test(input['attemptId'])\n  )\n    return false;\n  const keys = ['attemptId', 'kind'];\n  switch (input['kind']) {\n    case 'start':\n      return (\n        hasKeys(input, [...keys, 'snapshot', 'instructions', 'limits', 'deadline']) &&\n        isSnapshot(input['snapshot']) &&\n        isInstructionSource(input['instructions']) &&\n        isLimits(input['limits']) &&\n        isInteger(input['deadline'])\n      );\n    case 'ready':\n      return (\n        hasKeys(input, [...keys, 'maxAnalysisHeapBytes']) &&\n        isInteger(input['maxAnalysisHeapBytes']) &&\n        input['maxAnalysisHeapBytes'] > 0\n      );\n    case 'run':\n    case 'dispose':\n      return hasKeys(input, keys);\n    case 'prepared':\n      return hasKeys(input, [...keys, 'inspection']) && isMetadata(input['inspection']);\n    case 'read-page':\n      return (\n        hasKeys(input, [...keys, 'requestId', 'input']) &&\n        isInteger(input['requestId']) &&\n        isPageInput(input['input'])\n      );\n    case 'page':\n      return (\n        hasKeys(input, [...keys, 'requestId', 'result']) &&\n        isInteger(input['requestId']) &&\n        isPage(input['result'])\n      );\n    case 'reader-request':\n      return (\n        hasKeys(input, [...keys, 'requestId', 'request']) &&\n        isInteger(input['requestId']) &&\n        isRequest(input['request'])\n      );\n    case 'reader-response':\n      return hasKeys(input, [...keys, 'requestId', 'result']) && isInteger(input['requestId']);\n    case 'reader-failure':\n    case 'failure':\n      return (\n        hasKeys(input, [\n          ...keys,\n          'failure',\n          ...(input['kind'] === 'reader-failure' ? ['requestId'] : []),\n        ]) &&\n        (input['kind'] !== 'reader-failure' || isInteger(input['requestId'])) &&\n        isObjectValid(input['failure'], true) &&\n        hasKeys(input['failure'], ['family', 'options']) &&\n        ['configuration', 'operation', 'repository', 'path'].includes(\n          String(input['failure']['family']),\n        ) &&\n        isObjectValid(input['failure']['options'], true)\n      );\n    default:\n      return false;\n  }\n};\n\n/**\n * Admits a complete bounded record before serialization; no record is truncated.\n * @returns One private JSON frame.\n * @throws\n * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.\n * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.\n */\nexport const encodeInspectionMessage = (message: INodeInspectionMessage): string => {\n  let bytes: number;\n  try {\n    bytes = measureJsonBytes(message, NODE_INSPECTION_MESSAGE_BYTES);\n  } catch (error) {\n    throw createInspectionProcessFailure(error);\n  }\n  if (bytes > NODE_INSPECTION_MESSAGE_BYTES)\n    throw new CoreOperationException({\n      code: 'RESOURCE_LIMIT_EXCEEDED',\n      limit: 'maxInspectionMessageBytes',\n      limitMaximum: NODE_INSPECTION_MESSAGE_BYTES,\n      observedUsage: bytes,\n      nextAction: null,\n      operation: 'create-project-inspection',\n    });\n  if (!isMessage(message)) throw createInspectionProcessFailure();\n  return JSON.stringify(message);\n};\n\n/**\n * Checks frame size before parsing and validates the closed message contract.\n * @returns A validated private message.\n * @throws\n * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.\n */\nexport const decodeInspectionMessage = (frame: unknown): INodeInspectionMessage => {\n  if (typeof frame !== 'string' || Buffer.byteLength(frame) > NODE_INSPECTION_MESSAGE_BYTES)\n    throw createInspectionProcessFailure();\n  let message: unknown;\n  try {\n    message = JSON.parse(frame);\n  } catch (cause) {\n    throw createInspectionProcessFailure(cause);\n  }\n  if (!isMessage(message)) throw createInspectionProcessFailure();\n  return message;\n};\n","import {\n  RepositoryPathException,\n  RepositorySourceException,\n  isRepositoryPath,\n  type IRepositoryOperation,\n  type IRepositorySourceErrorCode,\n} from '@moldea.ai/repository';\n\nimport {\n  CoreConfigurationException,\n  CoreOperationException,\n  isCoreConfigurationErrorCode,\n  isCoreOperation,\n  isCoreOperationErrorCode,\n} from '../exceptions/index.js';\n\nimport { createInspectionProcessFailure } from './protocol.js';\nimport type { INodeInspectionFailure } from './types.js';\n\n/** Serializes only documented exception fields, excluding native messages, causes and stacks. */\nexport const serializeInspectionFailure = (error: unknown): INodeInspectionFailure => {\n  if (error instanceof CoreConfigurationException)\n    return {\n      family: 'configuration',\n      options: {\n        code: error.code,\n        operation: error.operation,\n      },\n    };\n  if (error instanceof CoreOperationException)\n    return {\n      family: 'operation',\n      options: {\n        code: error.code,\n        operation: error.operation,\n        ...(error.code !== 'RESOURCE_LIMIT_EXCEEDED'\n          ? {}\n          : {\n              limit: error.limit,\n              limitMaximum: error.limitMaximum,\n              nextAction: error.nextAction,\n              observedUsage: error.observedUsage,\n            }),\n      },\n    };\n  if (error instanceof RepositoryPathException) return { family: 'path', options: {} };\n  if (error instanceof RepositorySourceException)\n    return {\n      family: 'repository',\n      options: {\n        code: error.code,\n        operation: error.operation,\n        path: error.path,\n        retryable: error.retryable,\n        ...(error.resource === null ? {} : { resource: error.resource }),\n      },\n    };\n  return {\n    family: 'operation',\n    options: {\n      code: 'INSPECTION_PROCESS_FAILED',\n      operation: 'create-project-inspection',\n    },\n  };\n};\nconst REPOSITORY_CODES: IRepositorySourceErrorCode[] = [\n  'ENTRY_NOT_FOUND',\n  'ENTRY_NOT_FILE',\n  'ENTRY_NOT_DIRECTORY',\n  'INVALID_PAGE_REQUEST',\n  'ACCESS_DENIED',\n  'SOURCE_UNAVAILABLE',\n  'SNAPSHOT_CHANGED',\n  'PROVIDER_INCOMPLETE',\n  'INVALID_SOURCE_DATA',\n  'RESOURCE_LIMIT_EXCEEDED',\n  'ABORTED',\n];\nconst REPOSITORY_OPERATIONS: IRepositoryOperation[] = [\n  'create-reader',\n  'create-comparison',\n  'get-entry',\n  'read-file-page',\n  'list-entries-page',\n  'list-changes-page',\n];\nconst isNumber = (input: unknown): input is number =>\n  typeof input === 'number' && Number.isSafeInteger(input) && input >= 0;\n\n/**\n * Reconstructs a documented typed failure after checking its safe transport fields.\n * @returns A package exception without a remote native cause or stack.\n * @throws\n * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.\n */\nexport const deserializeInspectionFailure = (failure: INodeInspectionFailure): Error => {\n  const options = failure.options;\n  const allowed =\n    failure.family === 'configuration'\n      ? ['code', 'operation']\n      : failure.family === 'operation'\n        ? ['code', 'operation', 'limit', 'limitMaximum', 'nextAction', 'observedUsage']\n        : failure.family === 'repository'\n          ? ['code', 'operation', 'path', 'retryable', 'resource']\n          : [];\n  if (Object.keys(options).some((key) => !allowed.includes(key)))\n    throw createInspectionProcessFailure();\n  if (\n    (failure.family === 'operation' || failure.family === 'configuration') &&\n    !isCoreOperation(options['operation'])\n  )\n    throw createInspectionProcessFailure();\n  const scope = {\n    operation: isCoreOperation(options['operation'])\n      ? options['operation']\n      : ('create-project-inspection' as const),\n  };\n  if (failure.family === 'path' && Object.keys(options).length === 0)\n    return new RepositoryPathException();\n  if (failure.family === 'configuration') {\n    const code = options['code'];\n    if (isCoreConfigurationErrorCode(code))\n      return new CoreConfigurationException({ ...scope, code });\n  }\n  if (failure.family === 'operation') {\n    const code = options['code'];\n    if (\n      isCoreOperationErrorCode(code) &&\n      code !== 'RESOURCE_LIMIT_EXCEEDED' &&\n      !['limit', 'limitMaximum', 'nextAction', 'observedUsage'].some((key) =>\n        Object.hasOwn(options, key),\n      )\n    )\n      return new CoreOperationException({ ...scope, code });\n    if (\n      options['code'] === 'RESOURCE_LIMIT_EXCEEDED' &&\n      isNumber(options['limitMaximum']) &&\n      options['limitMaximum'] > 0\n    ) {\n      if (\n        options['limit'] === 'maxAnalysisHeapBytes' &&\n        options['nextAction'] === 'review-inspection-capacity' &&\n        options['observedUsage'] === null\n      )\n        return new CoreOperationException({\n          ...scope,\n          code: 'RESOURCE_LIMIT_EXCEEDED',\n          limit: 'maxAnalysisHeapBytes',\n          limitMaximum: options['limitMaximum'],\n          observedUsage: null,\n          nextAction: 'review-inspection-capacity',\n        });\n      if (\n        (options['limit'] === 'maxInspectionMessageBytes' ||\n          options['limit'] === 'maxReaderRequests') &&\n        options['nextAction'] === null &&\n        isNumber(options['observedUsage'])\n      )\n        return new CoreOperationException({\n          ...scope,\n          code: 'RESOURCE_LIMIT_EXCEEDED',\n          limit: options['limit'],\n          limitMaximum: options['limitMaximum'],\n          nextAction: null,\n          observedUsage: options['observedUsage'],\n        });\n      if (\n        typeof options['limit'] === 'string' &&\n        !['maxAnalysisHeapBytes', 'maxInspectionMessageBytes', 'maxReaderRequests'].includes(\n          options['limit'],\n        ) &&\n        options['nextAction'] === 'reduce-input-or-increase-limit' &&\n        isNumber(options['observedUsage'])\n      )\n        return new CoreOperationException({\n          ...scope,\n          code: 'RESOURCE_LIMIT_EXCEEDED',\n          limit: options['limit'],\n          limitMaximum: options['limitMaximum'],\n          nextAction: 'reduce-input-or-increase-limit',\n          observedUsage: options['observedUsage'],\n        });\n    }\n  }\n  if (failure.family === 'repository') {\n    const code = REPOSITORY_CODES.find((candidate) => candidate === options['code']);\n    const operation = REPOSITORY_OPERATIONS.find((candidate) => candidate === options['operation']);\n    const resource = options['resource'];\n    if (\n      code !== undefined &&\n      operation !== undefined &&\n      typeof options['retryable'] === 'boolean' &&\n      (options['path'] === null || isRepositoryPath(options['path'])) &&\n      (resource === undefined ||\n        (resource !== null &&\n          typeof resource === 'object' &&\n          Object.keys(resource).length === 3 &&\n          'dimension' in resource &&\n          typeof resource.dimension === 'string' &&\n          'limit' in resource &&\n          isNumber(resource.limit) &&\n          'observed' in resource &&\n          isNumber(resource.observed)))\n    ) {\n      return new RepositorySourceException({\n        code,\n        operation,\n        path: options['path'],\n        retryable: options['retryable'],\n        ...(resource === undefined\n          ? {}\n          : {\n              resource: resource as {\n                dimension: string;\n                limit: number;\n                observed: number;\n              },\n            }),\n      });\n    }\n  }\n  throw createInspectionProcessFailure();\n};\n"],"mappings":"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"}

package/dist/chunks/{exceptions-CYf1pCKf.js → exceptions-AT654xUL.js}

@@ -1,4 +1,4 @@
-import { Exception } from "error-message-utils";
+import { Exception } from "jg-exception";
 //#region src/exceptions/index.ts
 var CORE_OPERATIONS = [
 	"create-core",
@@ -36,26 +36,19 @@ var isCoreOperation = (input) => CORE_OPERATIONS.some((operation) => operation =
 var isCoreConfigurationErrorCode = (input) => typeof input === "string" && Object.hasOwn(CONFIGURATION_ERROR_MESSAGES, input);
 /** Checks a transported operation code against the authoritative message registry. */
 var isCoreOperationErrorCode = (input) => typeof input === "string" && Object.hasOwn(OPERATION_ERROR_MESSAGES, input);
-var attachCause = (exception, cause) => {
-	if (cause === void 0) return;
-	Object.defineProperty(exception, "cause", {
-		configurable: true,
-		enumerable: false,
-		value: cause,
-		writable: false
-	});
-};
 /** Represents invalid immutable Core configuration. */
 var CoreConfigurationException = class extends Exception {
 	code;
 	operation;
 	/** Creates a configuration exception with safe operation metadata. */
 	constructor(options) {
-		super(CONFIGURATION_ERROR_MESSAGES[options.code], options.code);
+		super(CONFIGURATION_ERROR_MESSAGES[options.code], {
+			code: options.code,
+			cause: options.cause
+		});
 		this.code = options.code;
 		this.name = "CoreConfigurationException";
 		this.operation = options.operation;
-		attachCause(this, options.cause);
 	}
 };
 /** Represents an operational failure that prevented Core from completing. */
@@ -69,7 +62,10 @@ var CoreOperationException = class extends Exception {
 	observedUsage;
 	/** Creates an operation exception with derived retry and safe scope metadata. */
 	constructor(options) {
-		super(OPERATION_ERROR_MESSAGES[options.code], options.code);
+		super(OPERATION_ERROR_MESSAGES[options.code], {
+			code: options.code,
+			cause: options.cause
+		});
 		this.code = options.code;
 		this.name = "CoreOperationException";
 		this.operation = options.operation;
@@ -78,10 +74,9 @@ var CoreOperationException = class extends Exception {
 		this.limitMaximum = options.limitMaximum ?? null;
 		this.nextAction = options.nextAction ?? null;
 		this.observedUsage = options.observedUsage ?? null;
-		attachCause(this, options.cause);
 	}
 };
 //#endregion
 export { isCoreOperationErrorCode as a, isCoreOperation as i, CoreOperationException as n, isCoreConfigurationErrorCode as r, CoreConfigurationException as t };
 
-//# sourceMappingURL=exceptions-CYf1pCKf.js.map
+//# sourceMappingURL=exceptions-AT654xUL.js.map

package/dist/chunks/exceptions-AT654xUL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions-AT654xUL.js","names":[],"sources":["../../src/exceptions/index.ts"],"sourcesContent":["import { Exception } from 'jg-exception';\n\n// stable configuration and operation failure codes\nexport type ICoreConfigurationErrorCode = 'INVALID_RESOURCE_LIMIT';\n\nexport type ICoreOperationErrorCode =\n  | 'INVALID_ARGUMENT'\n  | 'ABORTED'\n  | 'RESOURCE_LIMIT_EXCEEDED'\n  | 'INSPECTION_BUSY'\n  | 'INSPECTION_TIMEOUT'\n  | 'INSPECTION_PROCESS_FAILED'\n  | 'CONTENT_INVALID';\n\nconst CORE_OPERATIONS = [\n  'create-core',\n  'normalize-text',\n  'calculate-content-digest',\n  'parse-manifest',\n  'match-manifest-scope',\n  'parse-decision',\n  'create-project-inspection',\n  'read-canonical-content-page',\n  'validate-project',\n] as const;\n\nexport type ICoreOperation = (typeof CORE_OPERATIONS)[number];\n\n// safe construction options for exported Core exceptions\nexport interface ICoreConfigurationExceptionOptions {\n  readonly code: ICoreConfigurationErrorCode;\n  readonly operation: ICoreOperation;\n  readonly cause?: unknown;\n}\n\ninterface ICoreOperationExceptionOptionsBase {\n  readonly operation: ICoreOperation;\n  readonly cause?: unknown;\n}\n\n// logical budget refusals and verified isolated-worker heap exhaustion\nexport type ICoreResourceLimitNextAction =\n  'reduce-input-or-increase-limit' | 'review-inspection-capacity';\n\nexport type ICoreOperationExceptionOptions = ICoreOperationExceptionOptionsBase &\n  (\n    | {\n        readonly code: 'RESOURCE_LIMIT_EXCEEDED';\n        readonly limit: string;\n        readonly limitMaximum: number;\n        readonly nextAction: 'reduce-input-or-increase-limit';\n        readonly observedUsage: number;\n      }\n    | {\n        readonly code: 'RESOURCE_LIMIT_EXCEEDED';\n        readonly limit: 'maxAnalysisHeapBytes';\n        readonly limitMaximum: number;\n        readonly nextAction: 'review-inspection-capacity';\n        readonly observedUsage: null;\n      }\n    | {\n        readonly code: 'RESOURCE_LIMIT_EXCEEDED';\n        readonly limit: 'maxInspectionMessageBytes' | 'maxReaderRequests';\n        readonly limitMaximum: number;\n        readonly nextAction: null;\n        readonly observedUsage: number;\n      }\n    | {\n        readonly code: Exclude<ICoreOperationErrorCode, 'RESOURCE_LIMIT_EXCEEDED'>;\n        readonly limit?: never;\n        readonly limitMaximum?: never;\n        readonly nextAction?: never;\n        readonly observedUsage?: never;\n      }\n  );\n\nconst CONFIGURATION_ERROR_MESSAGES = {\n  INVALID_RESOURCE_LIMIT: 'A Core resource limit is invalid.',\n} as const satisfies Readonly<Record<ICoreConfigurationErrorCode, string>>;\n\nconst OPERATION_ERROR_MESSAGES = {\n  ABORTED: 'The Core operation was aborted.',\n  CONTENT_INVALID: 'The canonical content is not valid UTF-8 text.',\n  INVALID_ARGUMENT: 'The Core operation received an invalid argument.',\n  INSPECTION_BUSY: 'Project inspection capacity is busy. Try again shortly.',\n  INSPECTION_TIMEOUT: 'The isolated project inspection timed out.',\n  INSPECTION_PROCESS_FAILED: 'The isolated project inspection failed.',\n  RESOURCE_LIMIT_EXCEEDED: 'A Core resource limit was exceeded.',\n} as const satisfies Readonly<Record<ICoreOperationErrorCode, string>>;\n\nconst OPERATION_ERROR_RETRYABILITY = {\n  ABORTED: true,\n  CONTENT_INVALID: false,\n  INVALID_ARGUMENT: false,\n  INSPECTION_BUSY: true,\n  INSPECTION_TIMEOUT: true,\n  INSPECTION_PROCESS_FAILED: false,\n  RESOURCE_LIMIT_EXCEEDED: false,\n} as const satisfies Readonly<Record<ICoreOperationErrorCode, boolean>>;\n\n/** Checks a transported operation against the authoritative Core operation set. */\nexport const isCoreOperation = (input: unknown): input is ICoreOperation =>\n  CORE_OPERATIONS.some((operation) => operation === input);\n\n/** Checks a transported configuration code against the authoritative message registry. */\nexport const isCoreConfigurationErrorCode = (\n  input: unknown,\n): input is ICoreConfigurationErrorCode =>\n  typeof input === 'string' && Object.hasOwn(CONFIGURATION_ERROR_MESSAGES, input);\n\n/** Checks a transported operation code against the authoritative message registry. */\nexport const isCoreOperationErrorCode = (input: unknown): input is ICoreOperationErrorCode =>\n  typeof input === 'string' && Object.hasOwn(OPERATION_ERROR_MESSAGES, input);\n\n/** Represents invalid immutable Core configuration. */\nexport class CoreConfigurationException extends Exception {\n  public override readonly code: ICoreConfigurationErrorCode;\n\n  public readonly operation: ICoreOperation;\n\n  /** Creates a configuration exception with safe operation metadata. */\n  public constructor(options: ICoreConfigurationExceptionOptions) {\n    super(CONFIGURATION_ERROR_MESSAGES[options.code], {\n      code: options.code,\n      cause: options.cause,\n    });\n    this.code = options.code;\n    this.name = 'CoreConfigurationException';\n    this.operation = options.operation;\n  }\n}\n\n/** Represents an operational failure that prevented Core from completing. */\nexport class CoreOperationException extends Exception {\n  public override readonly code: ICoreOperationErrorCode;\n\n  public readonly operation: ICoreOperation;\n\n  public readonly retryable: boolean;\n\n  public readonly limit: string | null;\n\n  public readonly limitMaximum: number | null;\n\n  public readonly nextAction: ICoreResourceLimitNextAction | null;\n\n  public readonly observedUsage: number | null;\n\n  /** Creates an operation exception with derived retry and safe scope metadata. */\n  public constructor(options: ICoreOperationExceptionOptions) {\n    super(OPERATION_ERROR_MESSAGES[options.code], {\n      code: options.code,\n      cause: options.cause,\n    });\n    this.code = options.code;\n    this.name = 'CoreOperationException';\n    this.operation = options.operation;\n    this.retryable = OPERATION_ERROR_RETRYABILITY[options.code];\n    this.limit = options.limit ?? null;\n    this.limitMaximum = options.limitMaximum ?? null;\n    this.nextAction = options.nextAction ?? null;\n    this.observedUsage = options.observedUsage ?? null;\n  }\n}\n"],"mappings":";;AAcA,IAAM,kBAAkB;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAoDA,IAAM,+BAA+B,EACnC,wBAAwB,oCAC1B;AAEA,IAAM,2BAA2B;CAC/B,SAAS;CACT,iBAAiB;CACjB,kBAAkB;CAClB,iBAAiB;CACjB,oBAAoB;CACpB,2BAA2B;CAC3B,yBAAyB;AAC3B;AAEA,IAAM,+BAA+B;CACnC,SAAS;CACT,iBAAiB;CACjB,kBAAkB;CAClB,iBAAiB;CACjB,oBAAoB;CACpB,2BAA2B;CAC3B,yBAAyB;AAC3B;;AAGA,IAAa,mBAAmB,UAC9B,gBAAgB,MAAM,cAAc,cAAc,KAAK;;AAGzD,IAAa,gCACX,UAEA,OAAO,UAAU,YAAY,OAAO,OAAO,8BAA8B,KAAK;;AAGhF,IAAa,4BAA4B,UACvC,OAAO,UAAU,YAAY,OAAO,OAAO,0BAA0B,KAAK;;AAG5E,IAAa,6BAAb,cAAgD,UAAU;CACxD;CAEA;;CAGA,YAAmB,SAA6C;EAC9D,MAAM,6BAA6B,QAAQ,OAAO;GAChD,MAAM,QAAQ;GACd,OAAO,QAAQ;EACjB,CAAC;EACD,KAAK,OAAO,QAAQ;EACpB,KAAK,OAAO;EACZ,KAAK,YAAY,QAAQ;CAC3B;AACF;;AAGA,IAAa,yBAAb,cAA4C,UAAU;CACpD;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;;CAGA,YAAmB,SAAyC;EAC1D,MAAM,yBAAyB,QAAQ,OAAO;GAC5C,MAAM,QAAQ;GACd,OAAO,QAAQ;EACjB,CAAC;EACD,KAAK,OAAO,QAAQ;EACpB,KAAK,OAAO;EACZ,KAAK,YAAY,QAAQ;EACzB,KAAK,YAAY,6BAA6B,QAAQ;EACtD,KAAK,QAAQ,QAAQ,SAAS;EAC9B,KAAK,eAAe,QAAQ,gBAAgB;EAC5C,KAAK,aAAa,QAAQ,cAAc;EACxC,KAAK,gBAAgB,QAAQ,iBAAiB;CAChD;AACF"}

package/dist/chunks/{lifecycle-DwuevNoO.js → lifecycle-DuAHgnYH.js}

@@ -1,4 +1,4 @@
-import { a as encodeInspectionMessage, r as createInspectionProcessFailure, u as NODE_INSPECTION_TERMINATION_GRACE_MS } from "./errors-CvWn6gr2.js";
+import { a as encodeInspectionMessage, r as createInspectionProcessFailure, u as NODE_INSPECTION_TERMINATION_GRACE_MS } from "./errors-Uvb-9X1u.js";
 import process from "node:process";
 //#region src/node-inspection/lifecycle.ts
 /** Serializes bounded IPC sends and waits for Node's send callback before admitting the next. */
@@ -64,4 +64,4 @@ var superviseInspectionChild = (child, requestStop) => {
 //#endregion
 export { createInspectionSender as n, superviseInspectionChild as r, createInspectionEnvironment as t };
 
-//# sourceMappingURL=lifecycle-DwuevNoO.js.map
+//# sourceMappingURL=lifecycle-DuAHgnYH.js.map

package/dist/chunks/{lifecycle-DwuevNoO.js.map → lifecycle-DuAHgnYH.js.map}

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-DwuevNoO.js","names":[],"sources":["../../src/node-inspection/lifecycle.ts"],"sourcesContent":["import type { ChildProcess } from 'node:child_process';\nimport process from 'node:process';\n\nimport { NODE_INSPECTION_TERMINATION_GRACE_MS } from './constants.js';\nimport { NODE_INSPECTION_MAX_REQUESTS } from './constants.js';\nimport { createInspectionProcessFailure, encodeInspectionMessage } from './protocol.js';\nimport type { INodeInspectionMessage } from './types.js';\n\n/** Serializes bounded IPC sends and waits for Node's send callback before admitting the next. */\nexport const createInspectionSender = (\n  send: (frame: string, callback: (error: Error | null) => void) => void,\n): ((message: INodeInspectionMessage) => Promise<void>) => {\n  let queued = 0;\n  let tail = Promise.resolve();\n  return async (message) => {\n    if (queued >= NODE_INSPECTION_MAX_REQUESTS) throw createInspectionProcessFailure();\n    queued++;\n    const operation = tail.then(\n      () =>\n        new Promise<void>((resolve, reject) => {\n          try {\n            send(encodeInspectionMessage(message), (error) => {\n              if (error !== null) reject(createInspectionProcessFailure(error));\n              else resolve();\n            });\n          } catch (cause) {\n            reject(cause instanceof Error ? cause : createInspectionProcessFailure(cause));\n          }\n        }),\n    );\n    tail = operation.catch(() => {});\n    try {\n      await operation;\n    } finally {\n      queued--;\n    }\n  };\n};\n\n/** Keeps only operating-system bootstrap variables; no credentials or Node overrides cross. */\nexport const createInspectionEnvironment = (): NodeJS.ProcessEnv => {\n  const names = new Set(['systemroot', 'windir', 'temp', 'tmp', 'tmpdir']);\n  return Object.fromEntries(\n    Object.entries(process.env).filter(([name]) => names.has(name.toLowerCase())),\n  );\n};\n\n/**\n * Supervises one owned child without PID polling, shell commands, or process-group killing.\n * @returns Idempotent termination and actual close notification.\n */\nexport const superviseInspectionChild = (\n  child: ChildProcess,\n  requestStop: () => void,\n): {\n  closed: Promise<void>;\n  terminate: () => void;\n} => {\n  let hasClosed = false;\n  let forceTimer: NodeJS.Timeout | undefined;\n  const closed = new Promise<void>((resolve) => {\n    child.once('close', () => {\n      hasClosed = true;\n      clearTimeout(forceTimer);\n      resolve();\n    });\n  });\n  return {\n    closed,\n    terminate: (): void => {\n      if (hasClosed || forceTimer !== undefined) return;\n      // Let the child close IPC. Local disconnect can suppress ChildProcess's close event.\n      forceTimer = setTimeout(() => {\n        if (!hasClosed) child.kill('SIGKILL');\n      }, NODE_INSPECTION_TERMINATION_GRACE_MS);\n      requestStop();\n    },\n  };\n};\n"],"mappings":";;;;AASA,IAAa,0BACX,SACyD;CACzD,IAAI,SAAS;CACb,IAAI,OAAO,QAAQ,QAAQ;CAC3B,OAAO,OAAO,YAAY;EACxB,IAAI,UAAA,GAAwC,MAAM,+BAA+B;EACjF;EACA,MAAM,YAAY,KAAK,WAEnB,IAAI,SAAe,SAAS,WAAW;GACrC,IAAI;IACF,KAAK,wBAAwB,OAAO,IAAI,UAAU;KAChD,IAAI,UAAU,MAAM,OAAO,+BAA+B,KAAK,CAAC;UAC3D,QAAQ;IACf,CAAC;GACH,SAAS,OAAO;IACd,OAAO,iBAAiB,QAAQ,QAAQ,+BAA+B,KAAK,CAAC;GAC/E;EACF,CAAC,CACL;EACA,OAAO,UAAU,YAAY,CAAC,CAAC;EAC/B,IAAI;GACF,MAAM;EACR,UAAU;GACR;EACF;CACF;AACF;;AAGA,IAAa,oCAAuD;CAClE,MAAM,wBAAQ,IAAI,IAAI;EAAC;EAAc;EAAU;EAAQ;EAAO;CAAQ,CAAC;CACvE,OAAO,OAAO,YACZ,OAAO,QAAQ,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU,MAAM,IAAI,KAAK,YAAY,CAAC,CAAC,CAC9E;AACF;;;;;AAMA,IAAa,4BACX,OACA,gBAIG;CACH,IAAI,YAAY;CAChB,IAAI;CAQJ,OAAO;EACL,QAAA,IARiB,SAAe,YAAY;GAC5C,MAAM,KAAK,eAAe;IACxB,YAAY;IACZ,aAAa,UAAU;IACvB,QAAQ;GACV,CAAC;EACH,CAEE;EACA,iBAAuB;GACrB,IAAI,aAAa,eAAe,KAAA,GAAW;GAE3C,aAAa,iBAAiB;IAC5B,IAAI,CAAC,WAAW,MAAM,KAAK,SAAS;GACtC,GAAG,oCAAoC;GACvC,YAAY;EACd;CACF;AACF"}
+{"version":3,"file":"lifecycle-DuAHgnYH.js","names":[],"sources":["../../src/node-inspection/lifecycle.ts"],"sourcesContent":["import type { ChildProcess } from 'node:child_process';\nimport process from 'node:process';\n\nimport { NODE_INSPECTION_TERMINATION_GRACE_MS } from './constants.js';\nimport { NODE_INSPECTION_MAX_REQUESTS } from './constants.js';\nimport { createInspectionProcessFailure, encodeInspectionMessage } from './protocol.js';\nimport type { INodeInspectionMessage } from './types.js';\n\n/** Serializes bounded IPC sends and waits for Node's send callback before admitting the next. */\nexport const createInspectionSender = (\n  send: (frame: string, callback: (error: Error | null) => void) => void,\n): ((message: INodeInspectionMessage) => Promise<void>) => {\n  let queued = 0;\n  let tail = Promise.resolve();\n  return async (message) => {\n    if (queued >= NODE_INSPECTION_MAX_REQUESTS) throw createInspectionProcessFailure();\n    queued++;\n    const operation = tail.then(\n      () =>\n        new Promise<void>((resolve, reject) => {\n          try {\n            send(encodeInspectionMessage(message), (error) => {\n              if (error !== null) reject(createInspectionProcessFailure(error));\n              else resolve();\n            });\n          } catch (cause) {\n            reject(cause instanceof Error ? cause : createInspectionProcessFailure(cause));\n          }\n        }),\n    );\n    tail = operation.catch(() => {});\n    try {\n      await operation;\n    } finally {\n      queued--;\n    }\n  };\n};\n\n/** Keeps only operating-system bootstrap variables; no credentials or Node overrides cross. */\nexport const createInspectionEnvironment = (): NodeJS.ProcessEnv => {\n  const names = new Set(['systemroot', 'windir', 'temp', 'tmp', 'tmpdir']);\n  return Object.fromEntries(\n    Object.entries(process.env).filter(([name]) => names.has(name.toLowerCase())),\n  );\n};\n\n/**\n * Supervises one owned child without PID polling, shell commands, or process-group killing.\n * @returns Idempotent termination and actual close notification.\n */\nexport const superviseInspectionChild = (\n  child: ChildProcess,\n  requestStop: () => void,\n): {\n  closed: Promise<void>;\n  terminate: () => void;\n} => {\n  let hasClosed = false;\n  let forceTimer: NodeJS.Timeout | undefined;\n  const closed = new Promise<void>((resolve) => {\n    child.once('close', () => {\n      hasClosed = true;\n      clearTimeout(forceTimer);\n      resolve();\n    });\n  });\n  return {\n    closed,\n    terminate: (): void => {\n      if (hasClosed || forceTimer !== undefined) return;\n      // Let the child close IPC. Local disconnect can suppress ChildProcess's close event.\n      forceTimer = setTimeout(() => {\n        if (!hasClosed) child.kill('SIGKILL');\n      }, NODE_INSPECTION_TERMINATION_GRACE_MS);\n      requestStop();\n    },\n  };\n};\n"],"mappings":";;;;AASA,IAAa,0BACX,SACyD;CACzD,IAAI,SAAS;CACb,IAAI,OAAO,QAAQ,QAAQ;CAC3B,OAAO,OAAO,YAAY;EACxB,IAAI,UAAA,GAAwC,MAAM,+BAA+B;EACjF;EACA,MAAM,YAAY,KAAK,WAEnB,IAAI,SAAe,SAAS,WAAW;GACrC,IAAI;IACF,KAAK,wBAAwB,OAAO,IAAI,UAAU;KAChD,IAAI,UAAU,MAAM,OAAO,+BAA+B,KAAK,CAAC;UAC3D,QAAQ;IACf,CAAC;GACH,SAAS,OAAO;IACd,OAAO,iBAAiB,QAAQ,QAAQ,+BAA+B,KAAK,CAAC;GAC/E;EACF,CAAC,CACL;EACA,OAAO,UAAU,YAAY,CAAC,CAAC;EAC/B,IAAI;GACF,MAAM;EACR,UAAU;GACR;EACF;CACF;AACF;;AAGA,IAAa,oCAAuD;CAClE,MAAM,wBAAQ,IAAI,IAAI;EAAC;EAAc;EAAU;EAAQ;EAAO;CAAQ,CAAC;CACvE,OAAO,OAAO,YACZ,OAAO,QAAQ,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU,MAAM,IAAI,KAAK,YAAY,CAAC,CAAC,CAC9E;AACF;;;;;AAMA,IAAa,4BACX,OACA,gBAIG;CACH,IAAI,YAAY;CAChB,IAAI;CAQJ,OAAO;EACL,QAAA,IARiB,SAAe,YAAY;GAC5C,MAAM,KAAK,eAAe;IACxB,YAAY;IACZ,aAAa,UAAU;IACvB,QAAQ;GACV,CAAC;EACH,CAEE;EACA,iBAAuB;GACrB,IAAI,aAAa,eAAe,KAAA,GAAW;GAE3C,aAAa,iBAAiB;IAC5B,IAAI,CAAC,WAAW,MAAM,KAAK,SAAS;GACtC,GAAG,oCAAoC;GACvC,YAAY;EACd;CACF;AACF"}