@metamask/snaps-execution-environments 11.0.2 → 11.1.0

package/dist/common/endowments/network.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"network.mjs","sourceRoot":"","sources":["../../../src/common/endowments/network.ts"],"names":[],"mappings":"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","sourcesContent":["import { assert } from '@metamask/utils';\n\nimport type { EndowmentFactoryOptions } from './commonEndowmentFactory';\nimport { withTeardown } from '../utils';\n\n/**\n * This class wraps a Response object.\n * That way, a teardown process can stop any processes left.\n */\nexport class ResponseWrapper implements Response {\n  readonly #teardownRef: { lastTeardown: number };\n\n  readonly #ogResponse: Response;\n\n  readonly #onStart: () => Promise<void>;\n\n  readonly #onFinish: () => Promise<void>;\n\n  constructor(\n    ogResponse: Response,\n    teardownRef: { lastTeardown: number },\n    onStart: () => Promise<void>,\n    onFinish: () => Promise<void>,\n  ) {\n    this.#ogResponse = ogResponse;\n    this.#teardownRef = teardownRef;\n    this.#onStart = onStart;\n    this.#onFinish = onFinish;\n  }\n\n  get body(): ReadableStream<Uint8Array> | null {\n    return this.#ogResponse.body;\n  }\n\n  get bodyUsed() {\n    return this.#ogResponse.bodyUsed;\n  }\n\n  get headers() {\n    return this.#ogResponse.headers;\n  }\n\n  get ok() {\n    return this.#ogResponse.ok;\n  }\n\n  get redirected() {\n    return this.#ogResponse.redirected;\n  }\n\n  get status() {\n    return this.#ogResponse.status;\n  }\n\n  get statusText() {\n    return this.#ogResponse.statusText;\n  }\n\n  get type() {\n    return this.#ogResponse.type;\n  }\n\n  get url() {\n    return this.#ogResponse.url;\n  }\n\n  async text() {\n    return await withTeardown<string>(\n      (async () => {\n        await this.#onStart();\n        try {\n          return await this.#ogResponse.text();\n        } finally {\n          await this.#onFinish();\n        }\n      })(),\n      this.#teardownRef,\n    );\n  }\n\n  async arrayBuffer(): Promise<ArrayBuffer> {\n    return await withTeardown<ArrayBuffer>(\n      (async () => {\n        await this.#onStart();\n        try {\n          return await this.#ogResponse.arrayBuffer();\n        } finally {\n          await this.#onFinish();\n        }\n      })(),\n      this.#teardownRef,\n    );\n  }\n\n  async blob(): Promise<Blob> {\n    return await withTeardown<Blob>(\n      (async () => {\n        await this.#onStart();\n        try {\n          return await this.#ogResponse.blob();\n        } finally {\n          await this.#onFinish();\n        }\n      })(),\n      this.#teardownRef,\n    );\n  }\n\n  clone(): Response {\n    const newResponse = this.#ogResponse.clone();\n    return new ResponseWrapper(\n      newResponse,\n      this.#teardownRef,\n      this.#onStart,\n      this.#onFinish,\n    );\n  }\n\n  async formData(): Promise<FormData> {\n    return await withTeardown<FormData>(\n      (async () => {\n        await this.#onStart();\n        try {\n          return await this.#ogResponse.formData();\n        } finally {\n          await this.#onFinish();\n        }\n      })(),\n      this.#teardownRef,\n    );\n  }\n\n  async json(): Promise<any> {\n    return await withTeardown(\n      (async () => {\n        await this.#onStart();\n        try {\n          return await this.#ogResponse.json();\n        } finally {\n          await this.#onFinish();\n        }\n      })(),\n      this.#teardownRef,\n    );\n  }\n}\n\n// We redefine the global Response class to overwrite [Symbol.hasInstance].\n// This fixes problems where the response from `fetch` would not pass\n// instance of checks, leading to failures in WASM bindgen.\nclass AlteredResponse extends Response {\n  static [Symbol.hasInstance](instance: unknown) {\n    return instance instanceof Response || instance instanceof ResponseWrapper;\n  }\n}\n\n/**\n * Create a network endowment, consisting of a `fetch` function.\n * This allows us to provide a teardown function, so that we can cancel\n * any pending requests, connections, streams, etc. that may be open when a snap\n * is terminated.\n *\n * This wraps the original implementation of `fetch`,\n * to ensure that a bad actor cannot get access to the original function, thus\n * potentially preventing the network requests from being torn down.\n *\n * @param options - An options bag.\n * @param options.notify - A reference to the notify function of the snap executor.\n * @returns An object containing a wrapped `fetch`\n * function, as well as a teardown function.\n */\nconst createNetwork = ({ notify }: EndowmentFactoryOptions = {}) => {\n  assert(notify, 'Notify must be passed to network endowment factory');\n  // Open fetch calls or open body streams\n  const openConnections = new Set<{ cancel: () => Promise<void> }>();\n  // Track last teardown count\n  const teardownRef = { lastTeardown: 0 };\n\n  // Remove items from openConnections after they were garbage collected\n  const cleanup = new FinalizationRegistry<() => void>(\n    /* istanbul ignore next: can't test garbage collection without modifying node parameters */\n    (callback) => callback(),\n  );\n\n  const _fetch: typeof fetch = async (\n    input: RequestInfo | URL,\n    init?: RequestInit,\n  ): Promise<Response> => {\n    const abortController = new AbortController();\n    if (init?.signal !== null && init?.signal !== undefined) {\n      const originalSignal = init.signal;\n      // Merge abort controllers\n      originalSignal.addEventListener(\n        'abort',\n        () => {\n          abortController.abort((originalSignal as any).reason);\n        },\n        { once: true },\n      );\n    }\n\n    let started = false;\n    const onStart = async () => {\n      if (!started) {\n        started = true;\n        await notify({\n          method: 'OutboundRequest',\n          params: { source: 'fetch' },\n        });\n      }\n    };\n\n    let finished = false;\n    const onFinish = async () => {\n      if (!finished) {\n        finished = true;\n        await notify({\n          method: 'OutboundResponse',\n          params: { source: 'fetch' },\n        });\n      }\n    };\n\n    let res: Response;\n    let openFetchConnection: { cancel: () => Promise<void> } | undefined;\n    return await withTeardown(\n      (async () => {\n        try {\n          const fetchPromise = fetch(input, {\n            ...init,\n            signal: abortController.signal,\n          });\n\n          await notify({\n            method: 'OutboundRequest',\n            params: { source: 'fetch' },\n          });\n\n          openFetchConnection = {\n            cancel: async () => {\n              abortController.abort();\n              try {\n                await fetchPromise;\n              } catch {\n                /* do nothing */\n              }\n            },\n          };\n          openConnections.add(openFetchConnection);\n\n          res = new ResponseWrapper(\n            await fetchPromise,\n            teardownRef,\n            onStart,\n            onFinish,\n          );\n        } finally {\n          if (openFetchConnection !== undefined) {\n            openConnections.delete(openFetchConnection);\n          }\n          await notify({\n            method: 'OutboundResponse',\n            params: { source: 'fetch' },\n          });\n        }\n\n        if (res.body !== null) {\n          const body = new WeakRef<ReadableStream>(res.body);\n\n          const openBodyConnection = {\n            cancel:\n              /* istanbul ignore next: see it.todo('can be torn down during body read') test */\n              async () => {\n                try {\n                  await body.deref()?.cancel();\n                } catch {\n                  /* do nothing */\n                }\n              },\n          };\n          openConnections.add(openBodyConnection);\n          cleanup.register(\n            res.body,\n            /* istanbul ignore next: can't test garbage collection without modifying node parameters */\n            () => openConnections.delete(openBodyConnection),\n          );\n        }\n        return harden(res);\n      })(),\n      teardownRef,\n    );\n  };\n\n  const teardownFunction = async () => {\n    teardownRef.lastTeardown += 1;\n    const promises: Promise<void>[] = [];\n    openConnections.forEach(({ cancel }) => promises.push(cancel()));\n    openConnections.clear();\n    await Promise.all(promises);\n  };\n\n  return {\n    fetch: harden(_fetch),\n    // Request, Headers and Response are the endowments injected alongside fetch\n    // only when 'endowment:network-access' permission is requested,\n    // therefore these are hardened as part of fetch dependency injection within its factory.\n    // These endowments are not (and should never be) available by default.\n    Request: harden(Request),\n    Headers: harden(Headers),\n    Response: harden(AlteredResponse),\n    teardownFunction,\n  };\n};\n\nconst endowmentModule = {\n  names: ['fetch', 'Request', 'Headers', 'Response'] as const,\n  factory: createNetwork,\n};\nexport default endowmentModule;\n"]}
+{"version":3,"file":"network.mjs","sourceRoot":"","sources":["../../../src/common/endowments/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,wBAAwB;AAGzC,OAAO,EAAE,YAAY,EAAE,qBAAiB;AAExC;;;GAGG;AACH,MAAM,OAAO,eAAe;IACjB,YAAY,CAA2B;IAEvC,WAAW,CAAW;IAEtB,QAAQ,CAAsB;IAE9B,SAAS,CAAsB;IAExC,YACE,UAAoB,EACpB,WAAqC,EACrC,OAA4B,EAC5B,QAA6B;QAE7B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;IAClC,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;IACrC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;IACjC,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;IACrC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,MAAM,YAAY,CACvB,CAAC,KAAK,IAAI,EAAE;YACV,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACvC,CAAC;oBAAS,CAAC;gBACT,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,EAAE,EACJ,IAAI,CAAC,YAAY,CAClB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,MAAM,YAAY,CACvB,CAAC,KAAK,IAAI,EAAE;YACV,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;YAC9C,CAAC;oBAAS,CAAC;gBACT,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,EAAE,EACJ,IAAI,CAAC,YAAY,CAClB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,MAAM,YAAY,CACvB,CAAC,KAAK,IAAI,EAAE;YACV,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACvC,CAAC;oBAAS,CAAC;gBACT,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,EAAE,EACJ,IAAI,CAAC,YAAY,CAClB,CAAC;IACJ,CAAC;IAED,KAAK;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAC7C,OAAO,IAAI,eAAe,CACxB,WAAW,EACX,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,CACf,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,MAAM,YAAY,CACvB,CAAC,KAAK,IAAI,EAAE;YACV,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC3C,CAAC;oBAAS,CAAC;gBACT,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,EAAE,EACJ,IAAI,CAAC,YAAY,CAClB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,MAAM,YAAY,CACvB,CAAC,KAAK,IAAI,EAAE;YACV,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACvC,CAAC;oBAAS,CAAC;gBACT,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,EAAE,EACJ,IAAI,CAAC,YAAY,CAClB,CAAC;IACJ,CAAC;CACF;AAED,2EAA2E;AAC3E,qEAAqE;AACrE,2DAA2D;AAC3D,MAAM,eAAgB,SAAQ,QAAQ;IACpC,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QAC3C,OAAO,QAAQ,YAAY,QAAQ,IAAI,QAAQ,YAAY,eAAe,CAAC;IAC7E,CAAC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,aAAa,GAAG,CAAC,EAAE,MAAM,KAA8B,EAAE,EAAE,EAAE;IACjE,MAAM,CACJ,MAAM,EACN,qEAAqE,CACtE,CAAC;IACF,wCAAwC;IACxC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAmC,CAAC;IACnE,4BAA4B;IAC5B,MAAM,WAAW,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAExC,sEAAsE;IACtE,MAAM,OAAO,GAAG,IAAI,oBAAoB;IACtC,2FAA2F;IAC3F,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CACzB,CAAC;IAEF,MAAM,MAAM,GAAiB,KAAK,EAChC,KAAwB,EACxB,IAAkB,EACC,EAAE;QACrB,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,IAAI,IAAI,EAAE,MAAM,KAAK,IAAI,IAAI,IAAI,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;YACxD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;YACnC,0BAA0B;YAC1B,cAAc,CAAC,gBAAgB,CAC7B,OAAO,EACP,GAAG,EAAE;gBACH,eAAe,CAAC,KAAK,CAAE,cAAsB,CAAC,MAAM,CAAC,CAAC;YACxD,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,MAAM,CAAC;oBACX,MAAM,EAAE,iBAAiB;oBACzB,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;YAC1B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,MAAM,CAAC;oBACX,MAAM,EAAE,kBAAkB;oBAC1B,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,GAAa,CAAC;QAClB,IAAI,mBAAgE,CAAC;QACrE,OAAO,MAAM,YAAY,CACvB,CAAC,KAAK,IAAI,EAAE;YACV,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,EAAE;oBAChC,GAAG,IAAI;oBACP,MAAM,EAAE,eAAe,CAAC,MAAM;iBAC/B,CAAC,CAAC;gBAEH,MAAM,MAAM,CAAC;oBACX,MAAM,EAAE,iBAAiB;oBACzB,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;iBAC5B,CAAC,CAAC;gBAEH,mBAAmB,GAAG;oBACpB,MAAM,EAAE,KAAK,IAAI,EAAE;wBACjB,eAAe,CAAC,KAAK,EAAE,CAAC;wBACxB,IAAI,CAAC;4BACH,MAAM,YAAY,CAAC;wBACrB,CAAC;wBAAC,MAAM,CAAC;4BACP,gBAAgB;wBAClB,CAAC;oBACH,CAAC;iBACF,CAAC;gBACF,eAAe,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;gBAEzC,GAAG,GAAG,IAAI,eAAe,CACvB,MAAM,YAAY,EAClB,WAAW,EACX,OAAO,EACP,QAAQ,CACT,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;oBACtC,eAAe,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;gBAC9C,CAAC;gBACD,MAAM,MAAM,CAAC;oBACX,MAAM,EAAE,kBAAkB;oBAC1B,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;iBAC5B,CAAC,CAAC;YACL,CAAC;YAED,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAiB,GAAG,CAAC,IAAI,CAAC,CAAC;gBAEnD,MAAM,kBAAkB,GAAG;oBACzB,MAAM;oBACJ,iFAAiF;oBACjF,KAAK,IAAI,EAAE;wBACT,IAAI,CAAC;4BACH,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC;wBAC/B,CAAC;wBAAC,MAAM,CAAC;4BACP,gBAAgB;wBAClB,CAAC;oBACH,CAAC;iBACJ,CAAC;gBACF,eAAe,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBACxC,OAAO,CAAC,QAAQ,CACd,GAAG,CAAC,IAAI;gBACR,2FAA2F;gBAC3F,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,kBAAkB,CAAC,CACjD,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC,CAAC,EAAE,EACJ,WAAW,CACZ,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,gBAAgB,GAAG,KAAK,IAAI,EAAE;QAClC,WAAW,CAAC,YAAY,IAAI,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACjE,eAAe,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,4EAA4E;QAC5E,gEAAgE;QAChE,yFAAyF;QACzF,uEAAuE;QACvE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC,eAAe,CAAC;QACjC,gBAAgB;KACjB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG;IACtB,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAU;IAC3D,OAAO,EAAE,aAAa;CACvB,CAAC;AACF,eAAe,eAAe,CAAC","sourcesContent":["import { assert } from '@metamask/utils';\n\nimport type { EndowmentFactoryOptions } from './commonEndowmentFactory';\nimport { withTeardown } from '../utils';\n\n/**\n * This class wraps a Response object.\n * That way, a teardown process can stop any processes left.\n */\nexport class ResponseWrapper implements Response {\n  readonly #teardownRef: { lastTeardown: number };\n\n  readonly #ogResponse: Response;\n\n  readonly #onStart: () => Promise<void>;\n\n  readonly #onFinish: () => Promise<void>;\n\n  constructor(\n    ogResponse: Response,\n    teardownRef: { lastTeardown: number },\n    onStart: () => Promise<void>,\n    onFinish: () => Promise<void>,\n  ) {\n    this.#ogResponse = ogResponse;\n    this.#teardownRef = teardownRef;\n    this.#onStart = onStart;\n    this.#onFinish = onFinish;\n  }\n\n  get body(): ReadableStream<Uint8Array> | null {\n    return this.#ogResponse.body;\n  }\n\n  get bodyUsed() {\n    return this.#ogResponse.bodyUsed;\n  }\n\n  get headers() {\n    return this.#ogResponse.headers;\n  }\n\n  get ok() {\n    return this.#ogResponse.ok;\n  }\n\n  get redirected() {\n    return this.#ogResponse.redirected;\n  }\n\n  get status() {\n    return this.#ogResponse.status;\n  }\n\n  get statusText() {\n    return this.#ogResponse.statusText;\n  }\n\n  get type() {\n    return this.#ogResponse.type;\n  }\n\n  get url() {\n    return this.#ogResponse.url;\n  }\n\n  async text() {\n    return await withTeardown<string>(\n      (async () => {\n        await this.#onStart();\n        try {\n          return await this.#ogResponse.text();\n        } finally {\n          await this.#onFinish();\n        }\n      })(),\n      this.#teardownRef,\n    );\n  }\n\n  async arrayBuffer(): Promise<ArrayBuffer> {\n    return await withTeardown<ArrayBuffer>(\n      (async () => {\n        await this.#onStart();\n        try {\n          return await this.#ogResponse.arrayBuffer();\n        } finally {\n          await this.#onFinish();\n        }\n      })(),\n      this.#teardownRef,\n    );\n  }\n\n  async blob(): Promise<Blob> {\n    return await withTeardown<Blob>(\n      (async () => {\n        await this.#onStart();\n        try {\n          return await this.#ogResponse.blob();\n        } finally {\n          await this.#onFinish();\n        }\n      })(),\n      this.#teardownRef,\n    );\n  }\n\n  clone(): Response {\n    const newResponse = this.#ogResponse.clone();\n    return new ResponseWrapper(\n      newResponse,\n      this.#teardownRef,\n      this.#onStart,\n      this.#onFinish,\n    );\n  }\n\n  async formData(): Promise<FormData> {\n    return await withTeardown<FormData>(\n      (async () => {\n        await this.#onStart();\n        try {\n          return await this.#ogResponse.formData();\n        } finally {\n          await this.#onFinish();\n        }\n      })(),\n      this.#teardownRef,\n    );\n  }\n\n  async json(): Promise<any> {\n    return await withTeardown(\n      (async () => {\n        await this.#onStart();\n        try {\n          return await this.#ogResponse.json();\n        } finally {\n          await this.#onFinish();\n        }\n      })(),\n      this.#teardownRef,\n    );\n  }\n}\n\n// We redefine the global Response class to overwrite [Symbol.hasInstance].\n// This fixes problems where the response from `fetch` would not pass\n// instance of checks, leading to failures in WASM bindgen.\nclass AlteredResponse extends Response {\n  static [Symbol.hasInstance](instance: unknown) {\n    return instance instanceof Response || instance instanceof ResponseWrapper;\n  }\n}\n\n/**\n * Create a network endowment, consisting of a `fetch` function.\n * This allows us to provide a teardown function, so that we can cancel\n * any pending requests, connections, streams, etc. that may be open when the\n * execution context is torn down.\n *\n * This wraps the original implementation of `fetch`,\n * to ensure that a bad actor cannot get access to the original function, thus\n * potentially preventing the network requests from being torn down.\n *\n * @param options - An options bag.\n * @param options.notify - A notification callback for outbound request\n * lifecycle events.\n * @returns An object containing a wrapped `fetch`\n * function, as well as a teardown function.\n */\nconst createNetwork = ({ notify }: EndowmentFactoryOptions = {}) => {\n  assert(\n    notify,\n    'The \"notify\" callback is required by the network endowment factory.',\n  );\n  // Open fetch calls or open body streams\n  const openConnections = new Set<{ cancel: () => Promise<void> }>();\n  // Track last teardown count\n  const teardownRef = { lastTeardown: 0 };\n\n  // Remove items from openConnections after they were garbage collected\n  const cleanup = new FinalizationRegistry<() => void>(\n    /* istanbul ignore next: can't test garbage collection without modifying node parameters */\n    (callback) => callback(),\n  );\n\n  const _fetch: typeof fetch = async (\n    input: RequestInfo | URL,\n    init?: RequestInit,\n  ): Promise<Response> => {\n    const abortController = new AbortController();\n    if (init?.signal !== null && init?.signal !== undefined) {\n      const originalSignal = init.signal;\n      // Merge abort controllers\n      originalSignal.addEventListener(\n        'abort',\n        () => {\n          abortController.abort((originalSignal as any).reason);\n        },\n        { once: true },\n      );\n    }\n\n    let started = false;\n    const onStart = async () => {\n      if (!started) {\n        started = true;\n        await notify({\n          method: 'OutboundRequest',\n          params: { source: 'fetch' },\n        });\n      }\n    };\n\n    let finished = false;\n    const onFinish = async () => {\n      if (!finished) {\n        finished = true;\n        await notify({\n          method: 'OutboundResponse',\n          params: { source: 'fetch' },\n        });\n      }\n    };\n\n    let res: Response;\n    let openFetchConnection: { cancel: () => Promise<void> } | undefined;\n    return await withTeardown(\n      (async () => {\n        try {\n          const fetchPromise = fetch(input, {\n            ...init,\n            signal: abortController.signal,\n          });\n\n          await notify({\n            method: 'OutboundRequest',\n            params: { source: 'fetch' },\n          });\n\n          openFetchConnection = {\n            cancel: async () => {\n              abortController.abort();\n              try {\n                await fetchPromise;\n              } catch {\n                /* do nothing */\n              }\n            },\n          };\n          openConnections.add(openFetchConnection);\n\n          res = new ResponseWrapper(\n            await fetchPromise,\n            teardownRef,\n            onStart,\n            onFinish,\n          );\n        } finally {\n          if (openFetchConnection !== undefined) {\n            openConnections.delete(openFetchConnection);\n          }\n          await notify({\n            method: 'OutboundResponse',\n            params: { source: 'fetch' },\n          });\n        }\n\n        if (res.body !== null) {\n          const body = new WeakRef<ReadableStream>(res.body);\n\n          const openBodyConnection = {\n            cancel:\n              /* istanbul ignore next: see it.todo('can be torn down during body read') test */\n              async () => {\n                try {\n                  await body.deref()?.cancel();\n                } catch {\n                  /* do nothing */\n                }\n              },\n          };\n          openConnections.add(openBodyConnection);\n          cleanup.register(\n            res.body,\n            /* istanbul ignore next: can't test garbage collection without modifying node parameters */\n            () => openConnections.delete(openBodyConnection),\n          );\n        }\n        return harden(res);\n      })(),\n      teardownRef,\n    );\n  };\n\n  const teardownFunction = async () => {\n    teardownRef.lastTeardown += 1;\n    const promises: Promise<void>[] = [];\n    openConnections.forEach(({ cancel }) => promises.push(cancel()));\n    openConnections.clear();\n    await Promise.all(promises);\n  };\n\n  return {\n    fetch: harden(_fetch),\n    // Request, Headers and Response are the endowments injected alongside fetch\n    // only when 'endowment:network-access' permission is requested,\n    // therefore these are hardened as part of fetch dependency injection within its factory.\n    // These endowments are not (and should never be) available by default.\n    Request: harden(Request),\n    Headers: harden(Headers),\n    Response: harden(AlteredResponse),\n    teardownFunction,\n  };\n};\n\nconst endowmentModule = {\n  names: ['fetch', 'Request', 'Headers', 'Response'] as const,\n  factory: createNetwork,\n};\nexport default endowmentModule;\n"]}

package/dist/common/validation.d.cts

@@ -3,14 +3,14 @@ import type { Infer, Struct } from "@metamask/superstruct";
 import type { CaipChainId, JsonRpcRequest } from "@metamask/utils";
 export declare const JsonRpcRequestWithoutIdStruct: Struct<{
     method: string;
+    params?: import("@metamask/snaps-sdk").Json[] | Record<string, import("@metamask/snaps-sdk").Json> | undefined;
     jsonrpc?: "2.0" | undefined;
     id?: string | number | null | undefined;
-    params?: Record<string, import("@metamask/snaps-sdk").Json> | import("@metamask/snaps-sdk").Json[] | undefined;
 }, {
     jsonrpc: Struct<"2.0" | undefined, "2.0">;
     id: Struct<string | number | null | undefined, null>;
     method: Struct<string, null>;
-    params: Struct<Record<string, import("@metamask/snaps-sdk").Json> | import("@metamask/snaps-sdk").Json[] | undefined, null>;
+    params: Struct<import("@metamask/snaps-sdk").Json[] | Record<string, import("@metamask/snaps-sdk").Json> | undefined, null>;
 }>;
 export type JsonRpcRequestWithoutId = Infer<typeof JsonRpcRequestWithoutIdStruct>;
 export declare const EndowmentStruct: Struct<string, null>;
@@ -41,15 +41,15 @@ export declare const ExecuteSnapRequestArgumentsStruct: Struct<{
     endowments: Struct<string[], Struct<string, null>>;
 }>;
 export declare const SnapRpcRequestArgumentsStruct: Struct<{
-    snapId: string;
-    handler: HandlerType;
-    origin: string;
     request: {
         method: string;
+        params?: Record<string, any> | undefined;
         jsonrpc?: "2.0" | undefined;
         id?: string | number | null | undefined;
-        params?: Record<string, any> | undefined;
     };
+    origin: string;
+    snapId: string;
+    handler: HandlerType;
 }, {
     snapId: Struct<string, null>;
     handler: Struct<HandlerType, {
@@ -78,14 +78,14 @@ export declare const SnapRpcRequestArgumentsStruct: Struct<{
     origin: Struct<string, null>;
     request: Struct<{
         method: string;
+        params?: Record<string, any> | undefined;
         jsonrpc?: "2.0" | undefined;
         id?: string | number | null | undefined;
-        params?: Record<string, any> | undefined;
     }, {
         params: Struct<Record<string, any> | undefined, null>;
+        method: Struct<string, null>;
         jsonrpc: Struct<"2.0" | undefined, "2.0">;
         id: Struct<string | number | null | undefined, null>;
-        method: Struct<string, null>;
     }>;
 }>;
 export type PingRequestArguments = Infer<typeof PingRequestArgumentsStruct>;
@@ -351,12 +351,12 @@ export type OnProtocolRequestArguments = Infer<typeof OnProtocolRequestArguments
  */
 export declare function assertIsOnProtocolRequestArguments(value: unknown): asserts value is OnProtocolRequestArguments;
 export declare const WebSocketEventStruct: Struct<{
-    id: string;
     origin: string;
+    id: string;
     type: "open";
 } | {
-    id: string;
     origin: string;
+    id: string;
     type: "close";
     code: number;
     reason: string | null;
@@ -369,18 +369,18 @@ export declare const WebSocketEventStruct: Struct<{
         type: "binary";
         message: number[];
     };
-    id: string;
     origin: string;
+    id: string;
     type: "message";
 }, null>;
 export declare const OnWebSocketEventArgumentsStruct: Struct<{
     event: {
-        id: string;
         origin: string;
+        id: string;
         type: "open";
     } | {
-        id: string;
         origin: string;
+        id: string;
         type: "close";
         code: number;
         reason: string | null;
@@ -393,18 +393,18 @@ export declare const OnWebSocketEventArgumentsStruct: Struct<{
             type: "binary";
             message: number[];
         };
-        id: string;
         origin: string;
+        id: string;
         type: "message";
     };
 }, {
     event: Struct<{
-        id: string;
         origin: string;
+        id: string;
         type: "open";
     } | {
-        id: string;
         origin: string;
+        id: string;
         type: "close";
         code: number;
         reason: string | null;
@@ -417,8 +417,8 @@ export declare const OnWebSocketEventArgumentsStruct: Struct<{
             type: "binary";
             message: number[];
         };
-        id: string;
         origin: string;
+        id: string;
         type: "message";
     }, null>;
 }>;

package/dist/common/validation.d.mts

@@ -3,14 +3,14 @@ import type { Infer, Struct } from "@metamask/superstruct";
 import type { CaipChainId, JsonRpcRequest } from "@metamask/utils";
 export declare const JsonRpcRequestWithoutIdStruct: Struct<{
     method: string;
+    params?: import("@metamask/snaps-sdk").Json[] | Record<string, import("@metamask/snaps-sdk").Json> | undefined;
     jsonrpc?: "2.0" | undefined;
     id?: string | number | null | undefined;
-    params?: Record<string, import("@metamask/snaps-sdk").Json> | import("@metamask/snaps-sdk").Json[] | undefined;
 }, {
     jsonrpc: Struct<"2.0" | undefined, "2.0">;
     id: Struct<string | number | null | undefined, null>;
     method: Struct<string, null>;
-    params: Struct<Record<string, import("@metamask/snaps-sdk").Json> | import("@metamask/snaps-sdk").Json[] | undefined, null>;
+    params: Struct<import("@metamask/snaps-sdk").Json[] | Record<string, import("@metamask/snaps-sdk").Json> | undefined, null>;
 }>;
 export type JsonRpcRequestWithoutId = Infer<typeof JsonRpcRequestWithoutIdStruct>;
 export declare const EndowmentStruct: Struct<string, null>;
@@ -41,15 +41,15 @@ export declare const ExecuteSnapRequestArgumentsStruct: Struct<{
     endowments: Struct<string[], Struct<string, null>>;
 }>;
 export declare const SnapRpcRequestArgumentsStruct: Struct<{
-    snapId: string;
-    handler: HandlerType;
-    origin: string;
     request: {
         method: string;
+        params?: Record<string, any> | undefined;
         jsonrpc?: "2.0" | undefined;
         id?: string | number | null | undefined;
-        params?: Record<string, any> | undefined;
     };
+    origin: string;
+    snapId: string;
+    handler: HandlerType;
 }, {
     snapId: Struct<string, null>;
     handler: Struct<HandlerType, {
@@ -78,14 +78,14 @@ export declare const SnapRpcRequestArgumentsStruct: Struct<{
     origin: Struct<string, null>;
     request: Struct<{
         method: string;
+        params?: Record<string, any> | undefined;
         jsonrpc?: "2.0" | undefined;
         id?: string | number | null | undefined;
-        params?: Record<string, any> | undefined;
     }, {
         params: Struct<Record<string, any> | undefined, null>;
+        method: Struct<string, null>;
         jsonrpc: Struct<"2.0" | undefined, "2.0">;
         id: Struct<string | number | null | undefined, null>;
-        method: Struct<string, null>;
     }>;
 }>;
 export type PingRequestArguments = Infer<typeof PingRequestArgumentsStruct>;
@@ -351,12 +351,12 @@ export type OnProtocolRequestArguments = Infer<typeof OnProtocolRequestArguments
  */
 export declare function assertIsOnProtocolRequestArguments(value: unknown): asserts value is OnProtocolRequestArguments;
 export declare const WebSocketEventStruct: Struct<{
-    id: string;
     origin: string;
+    id: string;
     type: "open";
 } | {
-    id: string;
     origin: string;
+    id: string;
     type: "close";
     code: number;
     reason: string | null;
@@ -369,18 +369,18 @@ export declare const WebSocketEventStruct: Struct<{
         type: "binary";
         message: number[];
     };
-    id: string;
     origin: string;
+    id: string;
     type: "message";
 }, null>;
 export declare const OnWebSocketEventArgumentsStruct: Struct<{
     event: {
-        id: string;
         origin: string;
+        id: string;
         type: "open";
     } | {
-        id: string;
         origin: string;
+        id: string;
         type: "close";
         code: number;
         reason: string | null;
@@ -393,18 +393,18 @@ export declare const OnWebSocketEventArgumentsStruct: Struct<{
             type: "binary";
             message: number[];
         };
-        id: string;
         origin: string;
+        id: string;
         type: "message";
     };
 }, {
     event: Struct<{
-        id: string;
         origin: string;
+        id: string;
         type: "open";
     } | {
-        id: string;
         origin: string;
+        id: string;
         type: "close";
         code: number;
         reason: string | null;
@@ -417,8 +417,8 @@ export declare const OnWebSocketEventArgumentsStruct: Struct<{
             type: "binary";
             message: number[];
         };
-        id: string;
         origin: string;
+        id: string;
         type: "message";
     }, null>;
 }>;

package/dist/endowments.cjs

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Public endowment factory exports for use outside the Snaps ecosystem.
+ *
+ * **Prerequisite**: These factories call the SES `harden()` global internally.
+ * The consuming environment must have loaded SES and called `lockdown()` before
+ * invoking any factory function.
+ *
+ * Each module provides a `names` array and a `factory` function. Call
+ * `factory()` to obtain hardened endowment values (and an optional
+ * `teardownFunction` for stateful endowments that manage resources).
+ *
+ * @example
+ * ```ts
+ * import { timeout, date } from '@metamask/snaps-execution-environments/endowments';
+ *
+ * const timers = timeout.factory();
+ * // { setTimeout, clearTimeout, teardownFunction }
+ *
+ * const dateEndowment = date.factory();
+ * // { Date } (with attenuated Date.now)
+ * ```
+ *
+ * @module endowments
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCommonEndowments = exports.network = exports.consoleEndowment = exports.math = exports.crypto = exports.textDecoder = exports.textEncoder = exports.date = exports.interval = exports.timeout = void 0;
+const console_1 = __importDefault(require("./common/endowments/console.cjs"));
+const network_1 = __importDefault(require("./common/endowments/network.cjs"));
+// Individual endowment factory modules with no required options
+var timeout_1 = require("./common/endowments/timeout.cjs");
+Object.defineProperty(exports, "timeout", { enumerable: true, get: function () { return __importDefault(timeout_1).default; } });
+var interval_1 = require("./common/endowments/interval.cjs");
+Object.defineProperty(exports, "interval", { enumerable: true, get: function () { return __importDefault(interval_1).default; } });
+var date_1 = require("./common/endowments/date.cjs");
+Object.defineProperty(exports, "date", { enumerable: true, get: function () { return __importDefault(date_1).default; } });
+var textEncoder_1 = require("./common/endowments/textEncoder.cjs");
+Object.defineProperty(exports, "textEncoder", { enumerable: true, get: function () { return __importDefault(textEncoder_1).default; } });
+var textDecoder_1 = require("./common/endowments/textDecoder.cjs");
+Object.defineProperty(exports, "textDecoder", { enumerable: true, get: function () { return __importDefault(textDecoder_1).default; } });
+var crypto_1 = require("./common/endowments/crypto.cjs");
+Object.defineProperty(exports, "crypto", { enumerable: true, get: function () { return __importDefault(crypto_1).default; } });
+var math_1 = require("./common/endowments/math.cjs");
+Object.defineProperty(exports, "math", { enumerable: true, get: function () { return __importDefault(math_1).default; } });
+/**
+ * The console endowment factory. Produces an attenuated `console` object that
+ * prefixes output with the provided source label.
+ */
+exports.consoleEndowment = console_1.default;
+/**
+ * The network endowment factory. Produces a wrapped `fetch` function and
+ * related types with teardown support.
+ */
+exports.network = network_1.default;
+// Consolidated factory builder and types
+var commonEndowmentFactory_1 = require("./common/endowments/commonEndowmentFactory.cjs");
+Object.defineProperty(exports, "buildCommonEndowments", { enumerable: true, get: function () { return __importDefault(commonEndowmentFactory_1).default; } });
+//# sourceMappingURL=endowments.cjs.map

package/dist/endowments.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"endowments.cjs","sourceRoot":"","sources":["../src/endowments.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;AAMH,8EAAiE;AACjE,8EAAwD;AAExD,gEAAgE;AAChE,2DAAiE;AAAxD,mHAAA,OAAO,OAAW;AAC3B,6DAAmE;AAA1D,qHAAA,OAAO,OAAY;AAC5B,qDAA2D;AAAlD,6GAAA,OAAO,OAAQ;AACxB,mEAAyE;AAAhE,2HAAA,OAAO,OAAe;AAC/B,mEAAyE;AAAhE,2HAAA,OAAO,OAAe;AAC/B,yDAA+D;AAAtD,iHAAA,OAAO,OAAU;AAC1B,qDAA2D;AAAlD,6GAAA,OAAO,OAAQ;AAgBxB;;;GAGG;AACU,QAAA,gBAAgB,GAGzB,iBAAsB,CAAC;AAE3B;;;GAGG;AACU,QAAA,OAAO,GAGhB,iBAAa,CAAC;AAElB,yCAAyC;AACzC,yFAA8F;AAArF,gJAAA,OAAO,OAAyB","sourcesContent":["/**\n * Public endowment factory exports for use outside the Snaps ecosystem.\n *\n * **Prerequisite**: These factories call the SES `harden()` global internally.\n * The consuming environment must have loaded SES and called `lockdown()` before\n * invoking any factory function.\n *\n * Each module provides a `names` array and a `factory` function. Call\n * `factory()` to obtain hardened endowment values (and an optional\n * `teardownFunction` for stateful endowments that manage resources).\n *\n * @example\n * ```ts\n * import { timeout, date } from '@metamask/snaps-execution-environments/endowments';\n *\n * const timers = timeout.factory();\n * // { setTimeout, clearTimeout, teardownFunction }\n *\n * const dateEndowment = date.factory();\n * // { Date } (with attenuated Date.now)\n * ```\n *\n * @module endowments\n */\n\nimport type {\n  EndowmentFactoryOptions,\n  EndowmentFactoryResult,\n} from './common/endowments/commonEndowmentFactory';\nimport consoleEndowmentModule from './common/endowments/console';\nimport networkModule from './common/endowments/network';\n\n// Individual endowment factory modules with no required options\nexport { default as timeout } from './common/endowments/timeout';\nexport { default as interval } from './common/endowments/interval';\nexport { default as date } from './common/endowments/date';\nexport { default as textEncoder } from './common/endowments/textEncoder';\nexport { default as textDecoder } from './common/endowments/textDecoder';\nexport { default as crypto } from './common/endowments/crypto';\nexport { default as math } from './common/endowments/math';\n\n/**\n * Options required by the console endowment factory.\n */\nexport type ConsoleEndowmentOptions = Required<\n  Pick<EndowmentFactoryOptions, 'sourceLabel'>\n>;\n\n/**\n * Options required by the network endowment factory.\n */\nexport type NetworkEndowmentOptions = Required<\n  Pick<EndowmentFactoryOptions, 'notify'>\n>;\n\n/**\n * The console endowment factory. Produces an attenuated `console` object that\n * prefixes output with the provided source label.\n */\nexport const consoleEndowment: {\n  readonly names: readonly ['console'];\n  factory: (options: ConsoleEndowmentOptions) => EndowmentFactoryResult;\n} = consoleEndowmentModule;\n\n/**\n * The network endowment factory. Produces a wrapped `fetch` function and\n * related types with teardown support.\n */\nexport const network: {\n  readonly names: readonly ['fetch', 'Request', 'Headers', 'Response'];\n  factory: (options: NetworkEndowmentOptions) => EndowmentFactoryResult;\n} = networkModule;\n\n// Consolidated factory builder and types\nexport { default as buildCommonEndowments } from './common/endowments/commonEndowmentFactory';\nexport type {\n  NotifyFunction,\n  EndowmentFactoryOptions,\n  EndowmentFactoryResult,\n  EndowmentFactory,\n} from './common/endowments/commonEndowmentFactory';\n"]}

package/dist/endowments.d.cts

@@ -0,0 +1,59 @@
+/**
+ * Public endowment factory exports for use outside the Snaps ecosystem.
+ *
+ * **Prerequisite**: These factories call the SES `harden()` global internally.
+ * The consuming environment must have loaded SES and called `lockdown()` before
+ * invoking any factory function.
+ *
+ * Each module provides a `names` array and a `factory` function. Call
+ * `factory()` to obtain hardened endowment values (and an optional
+ * `teardownFunction` for stateful endowments that manage resources).
+ *
+ * @example
+ * ```ts
+ * import { timeout, date } from '@metamask/snaps-execution-environments/endowments';
+ *
+ * const timers = timeout.factory();
+ * // { setTimeout, clearTimeout, teardownFunction }
+ *
+ * const dateEndowment = date.factory();
+ * // { Date } (with attenuated Date.now)
+ * ```
+ *
+ * @module endowments
+ */
+import type { EndowmentFactoryOptions, EndowmentFactoryResult } from "./common/endowments/commonEndowmentFactory.cjs";
+export { default as timeout } from "./common/endowments/timeout.cjs";
+export { default as interval } from "./common/endowments/interval.cjs";
+export { default as date } from "./common/endowments/date.cjs";
+export { default as textEncoder } from "./common/endowments/textEncoder.cjs";
+export { default as textDecoder } from "./common/endowments/textDecoder.cjs";
+export { default as crypto } from "./common/endowments/crypto.cjs";
+export { default as math } from "./common/endowments/math.cjs";
+/**
+ * Options required by the console endowment factory.
+ */
+export type ConsoleEndowmentOptions = Required<Pick<EndowmentFactoryOptions, 'sourceLabel'>>;
+/**
+ * Options required by the network endowment factory.
+ */
+export type NetworkEndowmentOptions = Required<Pick<EndowmentFactoryOptions, 'notify'>>;
+/**
+ * The console endowment factory. Produces an attenuated `console` object that
+ * prefixes output with the provided source label.
+ */
+export declare const consoleEndowment: {
+    readonly names: readonly ['console'];
+    factory: (options: ConsoleEndowmentOptions) => EndowmentFactoryResult;
+};
+/**
+ * The network endowment factory. Produces a wrapped `fetch` function and
+ * related types with teardown support.
+ */
+export declare const network: {
+    readonly names: readonly ['fetch', 'Request', 'Headers', 'Response'];
+    factory: (options: NetworkEndowmentOptions) => EndowmentFactoryResult;
+};
+export { default as buildCommonEndowments } from "./common/endowments/commonEndowmentFactory.cjs";
+export type { NotifyFunction, EndowmentFactoryOptions, EndowmentFactoryResult, EndowmentFactory, } from "./common/endowments/commonEndowmentFactory.cjs";
+//# sourceMappingURL=endowments.d.cts.map

package/dist/endowments.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endowments.d.cts","sourceRoot":"","sources":["../src/endowments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACvB,uDAAmD;AAKpD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,wCAAoC;AACjE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,yCAAqC;AACnE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,qCAAiC;AAC3D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,4CAAwC;AACzE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,4CAAwC;AACzE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,uCAAmC;AAC/D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,qCAAiC;AAE3D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAC5C,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAC7C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAC5C,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CACxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,sBAAsB,CAAC;CAC9C,CAAC;AAE3B;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACrE,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,sBAAsB,CAAC;CACvD,CAAC;AAGlB,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,uDAAmD;AAC9F,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,GACjB,uDAAmD"}

package/dist/endowments.d.mts

@@ -0,0 +1,59 @@
+/**
+ * Public endowment factory exports for use outside the Snaps ecosystem.
+ *
+ * **Prerequisite**: These factories call the SES `harden()` global internally.
+ * The consuming environment must have loaded SES and called `lockdown()` before
+ * invoking any factory function.
+ *
+ * Each module provides a `names` array and a `factory` function. Call
+ * `factory()` to obtain hardened endowment values (and an optional
+ * `teardownFunction` for stateful endowments that manage resources).
+ *
+ * @example
+ * ```ts
+ * import { timeout, date } from '@metamask/snaps-execution-environments/endowments';
+ *
+ * const timers = timeout.factory();
+ * // { setTimeout, clearTimeout, teardownFunction }
+ *
+ * const dateEndowment = date.factory();
+ * // { Date } (with attenuated Date.now)
+ * ```
+ *
+ * @module endowments
+ */
+import type { EndowmentFactoryOptions, EndowmentFactoryResult } from "./common/endowments/commonEndowmentFactory.mjs";
+export { default as timeout } from "./common/endowments/timeout.mjs";
+export { default as interval } from "./common/endowments/interval.mjs";
+export { default as date } from "./common/endowments/date.mjs";
+export { default as textEncoder } from "./common/endowments/textEncoder.mjs";
+export { default as textDecoder } from "./common/endowments/textDecoder.mjs";
+export { default as crypto } from "./common/endowments/crypto.mjs";
+export { default as math } from "./common/endowments/math.mjs";
+/**
+ * Options required by the console endowment factory.
+ */
+export type ConsoleEndowmentOptions = Required<Pick<EndowmentFactoryOptions, 'sourceLabel'>>;
+/**
+ * Options required by the network endowment factory.
+ */
+export type NetworkEndowmentOptions = Required<Pick<EndowmentFactoryOptions, 'notify'>>;
+/**
+ * The console endowment factory. Produces an attenuated `console` object that
+ * prefixes output with the provided source label.
+ */
+export declare const consoleEndowment: {
+    readonly names: readonly ['console'];
+    factory: (options: ConsoleEndowmentOptions) => EndowmentFactoryResult;
+};
+/**
+ * The network endowment factory. Produces a wrapped `fetch` function and
+ * related types with teardown support.
+ */
+export declare const network: {
+    readonly names: readonly ['fetch', 'Request', 'Headers', 'Response'];
+    factory: (options: NetworkEndowmentOptions) => EndowmentFactoryResult;
+};
+export { default as buildCommonEndowments } from "./common/endowments/commonEndowmentFactory.mjs";
+export type { NotifyFunction, EndowmentFactoryOptions, EndowmentFactoryResult, EndowmentFactory, } from "./common/endowments/commonEndowmentFactory.mjs";
+//# sourceMappingURL=endowments.d.mts.map

package/dist/endowments.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endowments.d.mts","sourceRoot":"","sources":["../src/endowments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACvB,uDAAmD;AAKpD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,wCAAoC;AACjE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,yCAAqC;AACnE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,qCAAiC;AAC3D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,4CAAwC;AACzE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,4CAAwC;AACzE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,uCAAmC;AAC/D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,qCAAiC;AAE3D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAC5C,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAC7C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAC5C,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CACxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,sBAAsB,CAAC;CAC9C,CAAC;AAE3B;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACrE,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,sBAAsB,CAAC;CACvD,CAAC;AAGlB,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,uDAAmD;AAC9F,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,GACjB,uDAAmD"}

package/dist/endowments.mjs

@@ -0,0 +1,47 @@
+/**
+ * Public endowment factory exports for use outside the Snaps ecosystem.
+ *
+ * **Prerequisite**: These factories call the SES `harden()` global internally.
+ * The consuming environment must have loaded SES and called `lockdown()` before
+ * invoking any factory function.
+ *
+ * Each module provides a `names` array and a `factory` function. Call
+ * `factory()` to obtain hardened endowment values (and an optional
+ * `teardownFunction` for stateful endowments that manage resources).
+ *
+ * @example
+ * ```ts
+ * import { timeout, date } from '@metamask/snaps-execution-environments/endowments';
+ *
+ * const timers = timeout.factory();
+ * // { setTimeout, clearTimeout, teardownFunction }
+ *
+ * const dateEndowment = date.factory();
+ * // { Date } (with attenuated Date.now)
+ * ```
+ *
+ * @module endowments
+ */
+import consoleEndowmentModule from "./common/endowments/console.mjs";
+import networkModule from "./common/endowments/network.mjs";
+// Individual endowment factory modules with no required options
+export { default as timeout } from "./common/endowments/timeout.mjs";
+export { default as interval } from "./common/endowments/interval.mjs";
+export { default as date } from "./common/endowments/date.mjs";
+export { default as textEncoder } from "./common/endowments/textEncoder.mjs";
+export { default as textDecoder } from "./common/endowments/textDecoder.mjs";
+export { default as crypto } from "./common/endowments/crypto.mjs";
+export { default as math } from "./common/endowments/math.mjs";
+/**
+ * The console endowment factory. Produces an attenuated `console` object that
+ * prefixes output with the provided source label.
+ */
+export const consoleEndowment = consoleEndowmentModule;
+/**
+ * The network endowment factory. Produces a wrapped `fetch` function and
+ * related types with teardown support.
+ */
+export const network = networkModule;
+// Consolidated factory builder and types
+export { default as buildCommonEndowments } from "./common/endowments/commonEndowmentFactory.mjs";
+//# sourceMappingURL=endowments.mjs.map

package/dist/endowments.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"endowments.mjs","sourceRoot":"","sources":["../src/endowments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,sBAAsB,wCAAoC;AACjE,OAAO,aAAa,wCAAoC;AAExD,gEAAgE;AAChE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,wCAAoC;AACjE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,yCAAqC;AACnE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,qCAAiC;AAC3D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,4CAAwC;AACzE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,4CAAwC;AACzE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,uCAAmC;AAC/D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,qCAAiC;AAgB3D;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAGzB,sBAAsB,CAAC;AAE3B;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAGhB,aAAa,CAAC;AAElB,yCAAyC;AACzC,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,uDAAmD","sourcesContent":["/**\n * Public endowment factory exports for use outside the Snaps ecosystem.\n *\n * **Prerequisite**: These factories call the SES `harden()` global internally.\n * The consuming environment must have loaded SES and called `lockdown()` before\n * invoking any factory function.\n *\n * Each module provides a `names` array and a `factory` function. Call\n * `factory()` to obtain hardened endowment values (and an optional\n * `teardownFunction` for stateful endowments that manage resources).\n *\n * @example\n * ```ts\n * import { timeout, date } from '@metamask/snaps-execution-environments/endowments';\n *\n * const timers = timeout.factory();\n * // { setTimeout, clearTimeout, teardownFunction }\n *\n * const dateEndowment = date.factory();\n * // { Date } (with attenuated Date.now)\n * ```\n *\n * @module endowments\n */\n\nimport type {\n  EndowmentFactoryOptions,\n  EndowmentFactoryResult,\n} from './common/endowments/commonEndowmentFactory';\nimport consoleEndowmentModule from './common/endowments/console';\nimport networkModule from './common/endowments/network';\n\n// Individual endowment factory modules with no required options\nexport { default as timeout } from './common/endowments/timeout';\nexport { default as interval } from './common/endowments/interval';\nexport { default as date } from './common/endowments/date';\nexport { default as textEncoder } from './common/endowments/textEncoder';\nexport { default as textDecoder } from './common/endowments/textDecoder';\nexport { default as crypto } from './common/endowments/crypto';\nexport { default as math } from './common/endowments/math';\n\n/**\n * Options required by the console endowment factory.\n */\nexport type ConsoleEndowmentOptions = Required<\n  Pick<EndowmentFactoryOptions, 'sourceLabel'>\n>;\n\n/**\n * Options required by the network endowment factory.\n */\nexport type NetworkEndowmentOptions = Required<\n  Pick<EndowmentFactoryOptions, 'notify'>\n>;\n\n/**\n * The console endowment factory. Produces an attenuated `console` object that\n * prefixes output with the provided source label.\n */\nexport const consoleEndowment: {\n  readonly names: readonly ['console'];\n  factory: (options: ConsoleEndowmentOptions) => EndowmentFactoryResult;\n} = consoleEndowmentModule;\n\n/**\n * The network endowment factory. Produces a wrapped `fetch` function and\n * related types with teardown support.\n */\nexport const network: {\n  readonly names: readonly ['fetch', 'Request', 'Headers', 'Response'];\n  factory: (options: NetworkEndowmentOptions) => EndowmentFactoryResult;\n} = networkModule;\n\n// Consolidated factory builder and types\nexport { default as buildCommonEndowments } from './common/endowments/commonEndowmentFactory';\nexport type {\n  NotifyFunction,\n  EndowmentFactoryOptions,\n  EndowmentFactoryResult,\n  EndowmentFactory,\n} from './common/endowments/commonEndowmentFactory';\n"]}