feat(compartment-mapper): expose findUnknownCanonicalNames()

[boneskull]

This exports a new function findUnknownCanonicalNames() from policy.js.

This function was extracted from the existing validatePolicyResources() in node-modules.js.

The use-case for this function is to help gather unknown canonical names in the case where mapNodeModules() is called without policy. Currently, policy is required for the unknownCanonicalNameHook to fire, which makes sense. Instead, we can use this new function to compare an arbitrary policy against the result of mapNodeModules().

Practically speaking, @lavamoat/node can use this to compare generated policy and/or policy overrides against the result of mapNodeModules().

[boneskull]

Warning

This PR is part of a stack and targets branch boneskull/cjs-ast-parser, not master.
DO NOT MERGE until create Babel-based AST parser for CommonJS sources #3162 is merged into master.

📚 Pull Request Stack

• branch: master
  • fix(compartment-mapper,bundle-source): async parser support #3186 - branch: boneskull/async-parser
    • fix(module-source): fix SourceMapHook & other types #3187 - branch: boneskull/fix-module-source-types
      • feat(parser-pipeline): create @endo/parser-pipeline #3158 - branch: boneskull/ast-service
        • feat(evasive-transform): expose createEvasiveTransformPass for use with @endo/parser-pipeline #3188 - branch: boneskull/evasive-pipeline
          • feat(module-source): expose createModuleSourcePasses() #3159 - branch: boneskull/module-source-pipeline
            • create Babel-based AST parser for CommonJS sources #3162 - branch: boneskull/cjs-ast-parser
              • feat(compartment-mapper): expose findUnknownCanonicalNames() #3205 - branch: boneskull/export-find-canonical-names (this PR)

---

Managed by gh-stack

[changeset-bot]

🦋 Changeset detected

Latest commit: 198d94c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 7 packages

Name	Type
@endo/compartment-mapper	Minor
@endo/bundle-source	Patch
@endo/check-bundle	Patch
@endo/daemon	Patch
@endo/import-bundle	Patch
@endo/test262-runner	Patch
@endo/cli	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR