@endo/compartment-mapper 1.5.0 → 1.6.1

package/src/node-powers.d.ts

@@ -37,7 +37,7 @@ export function makeWritePowers({ fs, url }: {
 }): {
     write: (location: string, data: Uint8Array) => Promise<void>;
 };
-export function makeNodeReadPowers(fs: FsInterface, crypto?: CryptoInterface | undefined): ReadPowers;
+export function makeNodeReadPowers(fs: FsInterface, crypto?: CryptoInterface): ReadPowers;
 export function makeNodeWritePowers(fs: FsInterface): WritePowers;
 import type { FsInterface } from './types/node-powers.js';
 import type { UrlInterface } from './types/node-powers.js';

package/src/node-powers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-powers.d.ts","sourceRoot":"","sources":["node-powers.js"],"names":[],"mappings":"AA0LO,8DANJ;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;IACA,MAAM;IACR,IAAI;CACjC,GAAU,eAAe,GAAG,aAAa,CAoC3C;AAlKD;;;;;;;;;;;GAWG;AACH,2DANG;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;IACA,MAAM;IACR,IAAI;CACjC,GAAU,eAAe,CA0G3B;AAgDD;;;;;;;;GAQG;AACH,6CAHG;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;CAAC;sBAOtB,MAAM,QACN,UAAU;EAYtB;AA2BM,uCALI,WAAW,yCAET,UAAU,CAKtB;AAWM,wCAJI,WAAW,GACT,WAAW,CAKvB;iCApRS,wBAAwB;kCAAxB,wBAAwB;qCAAxB,wBAAwB;mCAAxB,wBAAwB;qCAexB,mBAAmB;mCAAnB,mBAAmB;gCAAnB,mBAAmB;iCAAnB,mBAAmB"}
+{"version":3,"file":"node-powers.d.ts","sourceRoot":"","sources":["node-powers.js"],"names":[],"mappings":"AA4LO,8DANJ;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;IACA,MAAM;IACR,IAAI;CACjC,GAAU,eAAe,GAAG,aAAa,CAoC3C;AAlKD;;;;;;;;;;;GAWG;AACH,2DANG;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;IACA,MAAM;IACR,IAAI;CACjC,GAAU,eAAe,CA0G3B;AAgDD;;;;;;;;GAQG;AACH,6CAHG;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;CAAC;sBAOtB,MAAM,QACN,UAAU;EAYtB;AA2BM,uCALI,WAAW,WACX,eAAe,GACb,UAAU,CAKtB;AAWM,wCAJI,WAAW,GACT,WAAW,CAKvB;iCApRS,wBAAwB;kCAAxB,wBAAwB;qCAAxB,wBAAwB;mCAAxB,wBAAwB;qCAexB,mBAAmB;mCAAnB,mBAAmB;gCAAnB,mBAAmB;iCAAnB,mBAAmB"}

package/src/node-powers.js

@@ -1,10 +1,12 @@
 /**
- * @module Provides adapters for Compartment Mapper I/O to the corresponding
+ * Provides adapters for Compartment Mapper I/O to the corresponding
  * Node.js implementations of those behaviors.
  *
  * The Compartment Mapper generalizes its I/O interface to allow for a wide
  * variety of I/O providers, but especially for reading and writing from
  * virtualized file systems like zip files.
+ *
+ * @module
  */
 
 /**

package/src/parse-archive-cjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseArchiveCjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: true;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-archive-cjs.d.ts.map

package/src/parse-archive-cjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-archive-cjs.d.ts","sourceRoot":"","sources":["parse-archive-cjs.js"],"names":[],"mappings":"AAkBA,sBAAsB;AACtB,8BADW,OAAO,CA6ChB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BA5DzB,YAAY"}
+{"version":3,"file":"parse-archive-cjs.d.ts","sourceRoot":"","sources":["parse-archive-cjs.js"],"names":[],"mappings":"AAoBA,sBAAsB;AACtB,8BADW,OAAO,CAkDhB;;;;;;;6BA/DyB,YAAY"}

package/src/parse-archive-cjs.js

@@ -1,6 +1,8 @@
 /**
- * @module Provides language behavior for analyzing, pre-compiling, and storing
+ * Provides language behavior for analyzing, pre-compiling, and storing
  * CommonJS modules for an archive.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */
@@ -22,9 +24,12 @@ export const parseArchiveCjs = (
   _specifier,
   location,
   _packageLocation,
+  options = {},
 ) => {
   const source = textDecoder.decode(bytes);
 
+  const { archiveOnly = false } = options;
+
   const {
     requires: imports,
     exports,
@@ -35,18 +40,20 @@ export const parseArchiveCjs = (
     exports.push('default');
   }
 
-  const cjsWrappedSource = `(function (require, exports, module, __filename, __dirname) { ${source} //*/\n})\n`;
+  let cjsFunctor = `(function (require, exports, module, __filename, __dirname) { 'use strict'; ${source} //*/\n})\n`;
 
   const pre = textEncoder.encode(
     JSON.stringify({
       imports,
       exports,
       reexports,
-      source: cjsWrappedSource,
+      source: cjsFunctor,
     }),
   );
 
-  const cjsFunctor = `${cjsWrappedSource}//# sourceURL=${location}\n`;
+  if (!archiveOnly) {
+    cjsFunctor = `${cjsFunctor}//# sourceURL=${location}\n`;
+  }
 
   return {
     parser: 'pre-cjs-json',

package/src/parse-archive-mjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseArchiveMjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-archive-mjs.d.ts.map

package/src/parse-archive-mjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-archive-mjs.d.ts","sourceRoot":"","sources":["parse-archive-mjs.js"],"names":[],"mappings":"AAYA,sBAAsB;AACtB,8BADW,OAAO,CAqBhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BA9BzB,YAAY"}
+{"version":3,"file":"parse-archive-mjs.d.ts","sourceRoot":"","sources":["parse-archive-mjs.js"],"names":[],"mappings":"AAcA,sBAAsB;AACtB,8BADW,OAAO,CAqBhB;;;;;;;6BA5ByB,YAAY"}

package/src/parse-archive-mjs.js

@@ -1,6 +1,8 @@
 /**
- * @module Provides language behavior for analyzing, pre-compiling, and storing ESM
+ * Provides language behavior for analyzing, pre-compiling, and storing ESM
  * modules for an archive.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */

package/src/parse-bytes.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseBytes: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-bytes.d.ts.map

package/src/parse-bytes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-bytes.d.ts","sourceRoot":"","sources":["parse-bytes.js"],"names":[],"mappings":"AAgBA,sBAAsB;AACtB,yBADW,OAAO,CA0BhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BAtCzB,YAAY"}
+{"version":3,"file":"parse-bytes.d.ts","sourceRoot":"","sources":["parse-bytes.js"],"names":[],"mappings":"AAkBA,sBAAsB;AACtB,yBADW,OAAO,CA0BhB;;;;;;;6BApCyB,YAAY"}

package/src/parse-bytes.js

@@ -1,6 +1,8 @@
 /**
- * @module Provides rudimentary support for treating an arbitrary file as a
+ * Provides rudimentary support for treating an arbitrary file as a
  * module that exports the bytes of that file.
+ *
+ * @module
  */
 
 /** @import {Harden} from 'ses' */

package/src/parse-cjs-shared-export-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-cjs-shared-export-wrapper.d.ts","sourceRoot":"","sources":["parse-cjs-shared-export-wrapper.js"],"names":[],"mappings":"AAwCO,2CAPI,UAAU,GAAG,MAAM,GAAG,SAAS,YAC/B,MAAM,GACJ;IACR,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAC,IAAI,CAAA;CACrB,CAgCH;AAmBM,uGAZJ;IAAmB,uBAAuB,EAAlC,MAAM;IACU,WAAW,EAA3B,WAAW;IACgB,eAAe,EAA1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACX,QAAQ,EAAnB,MAAM;IAC8B,UAAU,EAA9C,MAAM,GAAG,UAAU,GAAG,SAAS;CACvC,GAAU;IACR,MAAM,EAAE;QAAE,OAAO,EAAE,GAAG,CAAA;KAAE,CAAC;IACzB,aAAa,EAAE,GAAG,CAAC;IACnB,YAAY,WAAW;IACvB,OAAO,WAAW;CACnB,CAmIH;gCApNqC,YAAY;4BAAZ,YAAY"}
+{"version":3,"file":"parse-cjs-shared-export-wrapper.d.ts","sourceRoot":"","sources":["parse-cjs-shared-export-wrapper.js"],"names":[],"mappings":"AA0CO,2CAPI,UAAU,GAAG,MAAM,GAAG,SAAS,YAC/B,MAAM,GACJ;IACR,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAC,IAAI,CAAA;CACrB,CAgCH;AAmBM,uGAZJ;IAAmB,uBAAuB,EAAlC,MAAM;IACU,WAAW,EAA3B,WAAW;IACgB,eAAe,EAA1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACX,QAAQ,EAAnB,MAAM;IAC8B,UAAU,EAA9C,MAAM,GAAG,UAAU,GAAG,SAAS;CACvC,GAAU;IACR,MAAM,EAAE;QAAE,OAAO,EAAE,GAAG,CAAA;KAAE,CAAC;IACzB,aAAa,EAAE,GAAG,CAAC;IACnB,YAAY,WAAW;IACvB,OAAO,WAAW;CACnB,CA2HH;gCA5MqC,YAAY;4BAAZ,YAAY"}

package/src/parse-cjs-shared-export-wrapper.js

@@ -1,7 +1,9 @@
 /**
- * @module Provides shared functionality for {@link parse-cjs.js} and {@link
+ * Provides shared functionality for {@link parse-cjs.js} and {@link
  * parse-archive-cjs.js} toward importing or archiving CommonJS as a virtual
  * module source.
+ *
+ * @module
  */
 
 /** @import {ReadFn, ReadPowers} from './types.js' */
@@ -135,16 +137,7 @@ export const wrap = ({
     },
   });
 
-  let finalExports = originalExports;
-
-  const module = freeze({
-    get exports() {
-      return finalExports;
-    },
-    set exports(value) {
-      finalExports = value;
-    },
-  });
+  const module = { exports: originalExports };
 
   /** @param {string} importSpecifier */
   const require = importSpecifier => {
@@ -192,6 +185,7 @@ export const wrap = ({
   freeze(require);
 
   const afterExecute = () => {
+    const finalExports = module.exports; // in case it's a getter, only call it once
     const exportsHaveBeenOverwritten = finalExports !== originalExports;
     // Promotes keys from redefined module.export to top level namespace for import *
     // Note: We could do it less consistently but closer to how node does it if we iterated over exports detected by

package/src/parse-cjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseCjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: true;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-cjs.d.ts.map

package/src/parse-cjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-cjs.d.ts","sourceRoot":"","sources":["parse-cjs.js"],"names":[],"mappings":"AAcA,sBAAsB;AACtB,uBADW,OAAO,CA0DhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BArEzB,YAAY"}
+{"version":3,"file":"parse-cjs.d.ts","sourceRoot":"","sources":["parse-cjs.js"],"names":[],"mappings":"AAgBA,sBAAsB;AACtB,uBADW,OAAO,CA0DhB;;;;;;;6BAnEyB,YAAY"}

package/src/parse-cjs.js

@@ -1,6 +1,8 @@
 /**
- * @module Provides language behavior (parser) for importing CommonJS as a
+ * Provides language behavior (parser) for importing CommonJS as a
  * virtual module source.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */
@@ -41,7 +43,7 @@ export const parseCjs = (
    */
   const execute = (moduleEnvironmentRecord, compartment, resolvedImports) => {
     const functor = compartment.evaluate(
-      `(function (require, exports, module, __filename, __dirname) { ${source} //*/\n})\n//# sourceURL=${location}`,
+      `(function (require, exports, module, __filename, __dirname) { 'use strict'; ${source} })\n`,
     );
 
     const { require, moduleExports, module, afterExecute } = wrap({

package/src/parse-json.d.ts

@@ -1,7 +1,10 @@
 /** @type {ParseFn} */
 export const parseJson: ParseFn;
-declare const _default: ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
-import type { ParserImplementation } from './types.js';
 //# sourceMappingURL=parse-json.d.ts.map

package/src/parse-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-json.d.ts","sourceRoot":"","sources":["parse-json.js"],"names":[],"mappings":"AAmBA,sBAAsB;AACtB,wBADW,OAAO,CAqBhB;wBAES,oBAAoB;;6BAtCiB,YAAY;0CAAZ,YAAY"}
+{"version":3,"file":"parse-json.d.ts","sourceRoot":"","sources":["parse-json.js"],"names":[],"mappings":"AAmBA,sBAAsB;AACtB,wBADW,OAAO,CAqBhB;;;;;;;6BApC8C,YAAY"}

package/src/parse-mjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseMjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-mjs.d.ts.map

package/src/parse-mjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-mjs.d.ts","sourceRoot":"","sources":["parse-mjs.js"],"names":[],"mappings":"AAQA,sBAAsB;AACtB,uBADW,OAAO,CAqBhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BA7BzB,YAAY"}
+{"version":3,"file":"parse-mjs.d.ts","sourceRoot":"","sources":["parse-mjs.js"],"names":[],"mappings":"AAQA,sBAAsB;AACtB,uBADW,OAAO,CAqBhB;;;;;;;6BA3ByB,YAAY"}

package/src/parse-mjs.js

@@ -14,10 +14,10 @@ export const parseMjs = (
   _packageLocation,
   options = {},
 ) => {
-  const { sourceMap, sourceMapHook } = options;
+  const { sourceMap, sourceMapHook, archiveOnly = false } = options;
   const source = textDecoder.decode(bytes);
   const record = new ModuleSource(source, {
-    sourceUrl,
+    sourceUrl: archiveOnly ? undefined : sourceUrl,
     sourceMap,
     sourceMapUrl: sourceUrl,
     sourceMapHook,

package/src/parse-pre-cjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parsePreCjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: true;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-pre-cjs.d.ts.map

package/src/parse-pre-cjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-pre-cjs.d.ts","sourceRoot":"","sources":["parse-pre-cjs.js"],"names":[],"mappings":"AAeA,sBAAsB;AACtB,0BADW,OAAO,CAuDhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BAhEzB,YAAY"}
+{"version":3,"file":"parse-pre-cjs.d.ts","sourceRoot":"","sources":["parse-pre-cjs.js"],"names":[],"mappings":"AAiBA,sBAAsB;AACtB,0BADW,OAAO,CAuDhB;;;;;;;6BA9DyB,YAAY"}

package/src/parse-pre-cjs.js

@@ -1,9 +1,11 @@
 /**
- * @module Provides language-specific behavior for importing pre-compiled
+ * Provides language-specific behavior for importing pre-compiled
  * CommonJS.
  * Pre-compiled CommonJS is a module in JSON format that describes its imports,
  * exports, and source to execute in the presence of `require`, `module`, and
  * `exports`.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */

package/src/parse-pre-mjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parsePreMjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-pre-mjs.d.ts.map

package/src/parse-pre-mjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-pre-mjs.d.ts","sourceRoot":"","sources":["parse-pre-mjs.js"],"names":[],"mappings":"AAaA,sBAAsB;AACtB,0BADW,OAAO,CAsBhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BA9BzB,YAAY"}
+{"version":3,"file":"parse-pre-mjs.d.ts","sourceRoot":"","sources":["parse-pre-mjs.js"],"names":[],"mappings":"AAeA,sBAAsB;AACtB,0BADW,OAAO,CAsBhB;;;;;;;6BA5ByB,YAAY"}

package/src/parse-pre-mjs.js

@@ -1,8 +1,10 @@
 /**
- * @module Provides language-specific behaviors for importing pre-compiled ESM.
+ * Provides language-specific behaviors for importing pre-compiled ESM.
  * Pre-compiling or translating ESM from a module to a script with a
  * calling-convention is necessary to prepare an archive so that it can be
  * imported by the SES shim without entraining a dependency on Babel.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */

package/src/parse-text.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseText: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-text.d.ts.map

package/src/parse-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-text.d.ts","sourceRoot":"","sources":["parse-text.js"],"names":[],"mappings":"AAkBA,sBAAsB;AACtB,wBADW,OAAO,CAuBhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BArCzB,YAAY"}
+{"version":3,"file":"parse-text.d.ts","sourceRoot":"","sources":["parse-text.js"],"names":[],"mappings":"AAoBA,sBAAsB;AACtB,wBADW,OAAO,CAuBhB;;;;;;;6BAnCyB,YAAY"}

package/src/parse-text.js

@@ -1,7 +1,9 @@
 /**
- * @module Provides language-behaviors for importing a module as a document
+ * Provides language-behaviors for importing a module as a document
  * that exports itself as a string based on a UTF-8 interpretation of the
  * module's text.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */

package/src/policy-format.d.ts

@@ -1,8 +1,9 @@
+export const WILDCARD_POLICY_VALUE: "any";
 export function policyLookupHelper(packagePolicy: import("./types.js").PackagePolicy, field: "builtins" | "globals" | "packages", itemName: string): boolean | import("./types.js").AttenuationDefinition;
 export function isAllowingEverything(policyValue: unknown): policyValue is import("./types.js").WildcardPolicy;
 export function isAttenuationDefinition(allegedDefinition: unknown): allegedDefinition is import("./types.js").AttenuationDefinition;
 export function getAttenuatorFromDefinition(attenuationDefinition: import("./types.js").AttenuationDefinition): import("./types.js").UnifiedAttenuationDefinition;
-export function assertPackagePolicy(allegedPackagePolicy: unknown, path: string, url?: string | undefined): asserts allegedPackagePolicy is SomePackagePolicy | undefined;
+export function assertPackagePolicy(allegedPackagePolicy: unknown, path: string, url?: string): asserts allegedPackagePolicy is SomePackagePolicy | undefined;
 export function assertPolicy(allegedPolicy: unknown): asserts allegedPolicy is (SomePolicy | undefined);
 import type { SomePackagePolicy } from './types.js';
 import type { SomePolicy } from './types.js';

package/src/policy-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy-format.d.ts","sourceRoot":"","sources":["policy-format.js"],"names":[],"mappings":"AA2BO,kDALI,OAAO,YAAY,EAAE,aAAa,SAClC,UAAU,GAAC,SAAS,GAAC,UAAU,YAC/B,MAAM,GACJ,OAAO,GAAG,OAAO,YAAY,EAAE,qBAAqB,CAyBhE;AAQM,kDAHI,OAAO,GACL,WAAW,IAAI,OAAO,YAAY,EAAE,cAAc,CAGxB;AAOhC,2DAHI,OAAO,GACL,iBAAiB,IAAI,OAAO,YAAY,EAAE,qBAAqB,CAS3E;AAOM,mEAHI,OAAO,YAAY,EAAE,qBAAqB,GACxC,OAAO,YAAY,EAAE,4BAA4B,CAuB7D;AA0CM,0DALI,OAAO,QACP,MAAM,6BAEJ,QAAQ,oBAAoB,IAAI,iBAAiB,GAAC,SAAS,CA4DvE;AAUM,4CAHI,OAAO,GACL,QAAQ,aAAa,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,CAgC7D;uCA5OgD,YAAY;gCAAZ,YAAY"}
+{"version":3,"file":"policy-format.d.ts","sourceRoot":"","sources":["policy-format.js"],"names":[],"mappings":"AAeA,oCAAqC,KAAK,CAAC;AAepC,kDALI,OAAO,YAAY,EAAE,aAAa,SAClC,UAAU,GAAC,SAAS,GAAC,UAAU,YAC/B,MAAM,GACJ,OAAO,GAAG,OAAO,YAAY,EAAE,qBAAqB,CAyBhE;AAQM,kDAHI,OAAO,GACL,WAAW,IAAI,OAAO,YAAY,EAAE,cAAc,CAGxB;AAOhC,2DAHI,OAAO,GACL,iBAAiB,IAAI,OAAO,YAAY,EAAE,qBAAqB,CAS3E;AAOM,mEAHI,OAAO,YAAY,EAAE,qBAAqB,GACxC,OAAO,YAAY,EAAE,4BAA4B,CAuB7D;AA0CM,0DALI,OAAO,QACP,MAAM,QACN,MAAM,GACJ,QAAQ,oBAAoB,IAAI,iBAAiB,GAAC,SAAS,CA4DvE;AAUM,4CAHI,OAAO,GACL,QAAQ,aAAa,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,CAgC7D;uCA7OgD,YAAY;gCAAZ,YAAY"}

package/src/policy-format.js

@@ -1,6 +1,8 @@
 /**
- * @module Provides functions for enforcing compartment-map linkage and global
+ * Provides functions for enforcing compartment-map linkage and global
  * variable policies for each compartment.
+ *
+ * @module
  */
 
 /** @import {SomePackagePolicy, SomePolicy} from './types.js' */
@@ -11,7 +13,8 @@ const q = JSON.stringify;
 
 const ATTENUATOR_KEY = 'attenuate';
 const ATTENUATOR_PARAMS_KEY = 'params';
-const WILDCARD_POLICY_VALUE = 'any';
+export const WILDCARD_POLICY_VALUE = 'any';
+
 const POLICY_FIELDS_LOOKUP = /** @type {const} */ ([
   'builtins',
   'globals',

package/src/policy.d.ts

@@ -2,7 +2,7 @@
  * Const string to identify the internal attenuators compartment
  */
 export const ATTENUATORS_COMPARTMENT: "<ATTENUATORS>";
-export function detectAttenuators(policy?: Policy | undefined): Array<string>;
+export function detectAttenuators(policy?: Policy): Array<string>;
 export function dependencyAllowedByPolicy(namingKit: PackageNamingKit, packagePolicy: PackagePolicy): boolean;
 /**
  * Returns the policy applicable to the canonicalName of the package
@@ -24,7 +24,7 @@ export function getPolicyForPackage(namingKit: PackageNamingKit, policy: SomePol
 export function getPolicyForPackage(namingKit: PackageNamingKit, policy?: SomePolicy | undefined): SomePackagePolicy | undefined;
 export function makeDeferredAttenuatorsProvider(compartments: Record<string, Compartment>, compartmentDescriptors: Record<string, CompartmentDescriptor>): DeferredAttenuatorsProvider;
 export function attenuateGlobals(globalThis: object, globals: object, packagePolicy: PackagePolicy, attenuators: DeferredAttenuatorsProvider, pendingJobs: Array<Promise<any>>, name?: string): void;
-export function enforceModulePolicy(specifier: string, compartmentDescriptor: CompartmentDescriptor, { exit, errorHint }?: EnforceModulePolicyOptions | undefined): void;
+export function enforceModulePolicy(specifier: string, compartmentDescriptor: CompartmentDescriptor, { exit, errorHint }?: EnforceModulePolicyOptions): void;
 export function attenuateModuleHook(specifier: string, originalModuleRecord: import("ses").ThirdPartyStaticModuleInterface, policy: PackagePolicy, attenuators: DeferredAttenuatorsProvider): Promise<import("ses").ThirdPartyStaticModuleInterface>;
 /**
  * Options for {@link enforceModulePolicy}

package/src/policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["policy.js"],"names":[],"mappings":"AAgCA;;GAEG;AACH,sDAAuD;AAyDhD,gEAFM,KAAK,CAAC,MAAM,CAAC,CAezB;AA0BM,qDAJI,gBAAgB,iBAChB,aAAa,GACX,OAAO,CASnB;;;;;;;;;AAKE,+CACQ,gBAAgB,UAChB,UAAU,GACR,iBAAiB,CAC7B;;;;;;;;;AAKE,+CACQ,gBAAgB,oCAEd,iBAAiB,GAAC,SAAS,CACvC;AAkFM,8DAJI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,0BAC3B,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GACnC,2BAA2B,CA0CvC;AAoDM,6CARI,MAAM,WACN,MAAM,iBACN,aAAa,eACb,2BAA2B,eAC3B,KAAK,cAAS,SACd,MAAM,GACJ,IAAI,CAgDhB;AA2BM,+CAJI,MAAM,yBACN,qBAAqB,sEAiC/B;AAgDM,+CANI,MAAM,wBACN,OAAO,KAAK,EAAE,+BAA+B,UAC7C,aAAa,eACb,2BAA2B,GACzB,OAAO,CAAC,OAAO,KAAK,EAAE,+BAA+B,CAAC,CAyBlE;;;;;;;;;;;;;;4BAveS,YAAY;sCAAZ,YAAY;mCAAZ,YAAY;gCAAZ,YAAY;uCAAZ,YAAY;2CAAZ,YAAY;iDAAZ,YAAY"}
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["policy.js"],"names":[],"mappings":"AAkCA;;GAEG;AACH,sCAAuC,eAAe,CAAC;AAyDhD,2CAHI,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAezB;AA0BM,qDAJI,gBAAgB,iBAChB,aAAa,GACX,OAAO,CASnB;;;;;;;;;AAKE,+CACQ,gBAAgB,UAChB,UAAU,GACR,iBAAiB,CAC7B;;;;;;;;;AAKE,+CACQ,gBAAgB,oCAEd,iBAAiB,GAAC,SAAS,CACvC;AA+EM,8DAJI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,0BAC3B,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GACnC,2BAA2B,CA0CvC;AAoDM,6CARI,MAAM,WACN,MAAM,iBACN,aAAa,eACb,2BAA2B,eAC3B,KAAK,cAAS,SACd,MAAM,GACJ,IAAI,CAgDhB;AA2BM,+CAJI,MAAM,yBACN,qBAAqB,wBACrB,0BAA0B,QAgCpC;AAgDM,+CANI,MAAM,wBACN,OAAO,KAAK,EAAE,+BAA+B,UAC7C,aAAa,eACb,2BAA2B,GACzB,OAAO,CAAC,OAAO,KAAK,EAAE,+BAA+B,CAAC,CAyBlE;;;;;;;;;;;;;;4BApeS,YAAY;sCAAZ,YAAY;mCAAZ,YAAY;gCAAZ,YAAY;uCAAZ,YAAY;2CAAZ,YAAY;iDAAZ,YAAY"}

package/src/policy.js

@@ -1,5 +1,7 @@
 /**
- * @module Provides mechanisms for interacting with Compartment Map runtime policies.
+ * Provides mechanisms for interacting with Compartment Map runtime policies.
+ *
+ * @module
  */
 
 // @ts-check
@@ -171,10 +173,7 @@ export const getPolicyForPackage = (namingKit, policy) => {
   }
   const canonicalName = generateCanonicalName(namingKit);
   if (canonicalName === ATTENUATORS_COMPARTMENT) {
-    return {
-      defaultAttenuator: policy.defaultAttenuator,
-      packages: 'any',
-    };
+    return { defaultAttenuator: policy.defaultAttenuator, packages: 'any' };
   }
   if (policy.resources && policy.resources[canonicalName] !== undefined) {
     return policy.resources[canonicalName];
@@ -240,6 +239,7 @@ export const makeDeferredAttenuatorsProvider = (
   compartments,
   compartmentDescriptors,
 ) => {
+  /** @type {DeferredAttenuatorsProvider['import']} */
   let importAttenuator;
   let defaultAttenuator;
   // Attenuators compartment is not created when there's no policy.
@@ -257,7 +257,7 @@ export const makeDeferredAttenuatorsProvider = (
     // time of the import function being called.
     /**
      *
-     * @param {string} attenuatorSpecifier
+     * @param {string | null} attenuatorSpecifier
      * @returns {Promise<Attenuator>}
      */
     importAttenuator = async attenuatorSpecifier => {
@@ -267,15 +267,14 @@ export const makeDeferredAttenuatorsProvider = (
         }
         attenuatorSpecifier = defaultAttenuator;
       }
-      const { namespace } =
-        await compartments[ATTENUATORS_COMPARTMENT].import(attenuatorSpecifier);
+      const { namespace } = await compartments[ATTENUATORS_COMPARTMENT].import(
+        /** @type {string} */ (attenuatorSpecifier),
+      );
       return namespace;
     };
   }
 
-  return {
-    import: importAttenuator,
-  };
+  return { import: importAttenuator };
 };
 
 /**

package/src/powers.d.ts

@@ -1,6 +1,6 @@
 export function unpackReadPowers(powers: ReadFn | ReadPowers | MaybeReadPowers): MaybeReadPowers;
 export function isReadNowPowers(value: ReadPowers | ReadFn | undefined): value is ReadNowPowers;
-export function findInvalidReadNowPowersProps(value?: ReadFn | ReadPowers | undefined): ReadNowPowersProp[];
+export function findInvalidReadNowPowersProps(value?: ReadPowers | ReadFn): ReadNowPowersProp[];
 import type { ReadFn } from './types.js';
 import type { ReadPowers } from './types.js';
 import type { MaybeReadPowers } from './types.js';

package/src/powers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"powers.d.ts","sourceRoot":"","sources":["powers.js"],"names":[],"mappings":"AA6BO,yCAHI,MAAM,GAAG,UAAU,GAAG,eAAe,GACnC,eAAe,CAgC3B;AAiBM,uCAHI,UAAU,GAAC,MAAM,GAAC,SAAS,GACzB,KAAK,IAAI,aAAa,CAShC;AAWI,wFAFM,iBAAiB,EAAE,CAS/B;4BApFS,YAAY;gCAAZ,YAAY;qCAAZ,YAAY;mCAAZ,YAAY;uCAAZ,YAAY"}
+{"version":3,"file":"powers.d.ts","sourceRoot":"","sources":["powers.js"],"names":[],"mappings":"AA+BO,yCAHI,MAAM,GAAG,UAAU,GAAG,eAAe,GACnC,eAAe,CAgC3B;AAiBM,uCAHI,UAAU,GAAC,MAAM,GAAC,SAAS,GACzB,KAAK,IAAI,aAAa,CAShC;AAWI,sDAHI,UAAU,GAAG,MAAM,GACjB,iBAAiB,EAAE,CAS/B;4BApFS,YAAY;gCAAZ,YAAY;qCAAZ,YAAY;mCAAZ,YAAY;uCAAZ,YAAY"}

package/src/powers.js

@@ -1,9 +1,11 @@
 /**
- * @module As the interface of the Compartment Mapper evolved, it became
+ * As the interface of the Compartment Mapper evolved, it became
  * necessary to expand some function signatures that accepted a single power to
  * one that accepted a powers object.
  * This module provides functions for safely unpacking I/O capabilities and
  * maintaining backward-compatibility with older accepted usage patterns.
+ *
+ * @module
  */
 
 /**

package/src/search.d.ts

@@ -1,16 +1,11 @@
-export function searchDescriptor<T>(location: string, maybeReadDescriptor: (location: string) => Promise<T | undefined>): Promise<{
-    data: T;
-    directory: string;
-    location: string;
-    packageDescriptorLocation: string;
-}>;
-export function search(readPowers: ReadFn | ReadPowers | MaybeReadPowers, moduleLocation: string): Promise<{
-    packageLocation: string;
-    packageDescriptorLocation: string;
-    packageDescriptorText: string;
-    moduleSpecifier: string;
-}>;
+export function searchDescriptor<T>(location: string, maybeReadDescriptor: MaybeReadDescriptorFn<T>, { log: _log }?: SearchDescriptorOptions): Promise<SearchDescriptorResult<T>>;
+export function search(readPowers: ReadFn | ReadPowers | MaybeReadPowers, moduleLocation: string, { log }?: SearchOptions): Promise<SearchResult>;
+import type { MaybeReadDescriptorFn } from './types.js';
+import type { SearchDescriptorOptions } from './types.js';
+import type { SearchDescriptorResult } from './types.js';
 import type { ReadFn } from './types.js';
 import type { ReadPowers } from './types.js';
 import type { MaybeReadPowers } from './types.js';
+import type { SearchOptions } from './types.js';
+import type { SearchResult } from './types.js';
 //# sourceMappingURL=search.d.ts.map

package/src/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["search.js"],"names":[],"mappings":"AAwCO,iCALM,CAAC,YACH,MAAM,uBACN,CAAC,QAAQ,EAAC,MAAM,KAAG,OAAO,CAAC,CAAC,GAAC,SAAS,CAAC,GACrC,OAAO,CAAC;IAAC,IAAI,EAAC,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAC,MAAM,CAAC;IAAC,yBAAyB,EAAE,MAAM,CAAA;CAAC,CAAC,CA0BpG;AAoCM,mCATI,MAAM,GAAG,UAAU,GAAG,eAAe,kBACrC,MAAM,GACJ,OAAO,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB,EAAE,MAAM,CAAC;IAClC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC,CAoBJ;4BA5GS,YAAY;gCAAZ,YAAY;qCAAZ,YAAY"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["search.js"],"names":[],"mappings":"AAqDO,iCANM,CAAC,YACH,MAAM,uBACN,sBAAsB,CAAC,CAAC,kBACxB,uBAAuB,GACrB,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,CA8B9C;AAgCM,mCALI,MAAM,GAAG,UAAU,GAAG,eAAe,kBACrC,MAAM,YACN,aAAa,GACX,OAAO,CAAC,YAAY,CAAC,CA0BjC;2CAxHS,YAAY;6CAAZ,YAAY;4CAAZ,YAAY;4BAAZ,YAAY;gCAAZ,YAAY;qCAAZ,YAAY;mCAAZ,YAAY;kCAAZ,YAAY"}