@carbonenginejs/runtime-resource 0.12.2 → 0.13.0

package/dist/worker/CjsResManWorker.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsResManWorker.js","sources":["../../../src/worker/CjsResManWorker.js"],"sourcesContent":["import { Message, Operation } from \"./protocol.js\";\n\n/**\n * Static browser-worker host that owns its operation/message vocabulary,\n * executes clone-safe source and format operations, installs the message\n * envelope, transfers owned buffers, and serializes failures for `CjsResMan`.\n */\nexport class CjsResManWorker\n{\n  /** Stable operations understood by the bundled resource module worker. */\n  static Operation = Operation;\n\n  /** Stable message kinds exchanged with the resource module worker. */\n  static Message = Message;\n\n  /**\n   * Execute one bundled resource worker operation.\n   *\n   * This method also permits deterministic non-browser tests and custom\n   * worker hosts without installing global message handlers.\n   *\n   * @param {string} operation Worker operation name.\n   * @param {*} payload Structured-cloneable operation payload.\n   * @param {object} [context={}] Optional fetch and abort context.\n   * @returns {Promise<*>} Operation result.\n   */\n  static async execute(operation, payload, context = {})\n  {\n    switch (operation)\n    {\n      case Operation.FETCH:\n        return fetchResource(payload, context);\n\n      case Operation.FORMAT_READ:\n        return readFormat(payload);\n\n      default:\n      {\n        const error = new Error(`Unknown resource worker operation: ${operation}`);\n        error.code = \"CJS_RESOURCE_WORKER_OPERATION_UNKNOWN\";\n        error.operation = operation;\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Install the ResMan message protocol on a Worker-compatible scope.\n   *\n   * @param {WorkerGlobalScope|object} scope Worker global.\n   * @returns {() => void} Uninstall callback.\n   */\n  static install(scope = globalThis)\n  {\n    if (!scope || typeof scope.postMessage !== \"function\")\n    {\n      throw new TypeError(\"Resource worker scope must provide postMessage.\");\n    }\n    const controllers = new Map();\n    const onMessage = async event =>\n    {\n      const message = event?.data;\n      if (!message || typeof message !== \"object\") return;\n\n      if (message.type === Message.CANCEL)\n      {\n        controllers.get(message.id)?.abort();\n        return;\n      }\n      if (message.type !== Message.EXECUTE) return;\n\n      const controller = typeof AbortController === \"function\"\n        ? new AbortController()\n        : null;\n      if (controller) controllers.set(message.id, controller);\n      try\n      {\n        const result = await CjsResManWorker.execute(\n          message.operation,\n          message.payload,\n          { signal: controller?.signal }\n        );\n        scope.postMessage({\n          type: Message.RESULT,\n          id: message.id,\n          ok: true,\n          result\n        }, CjsResManWorker.collectTransferables(result));\n      }\n      catch (error)\n      {\n        scope.postMessage({\n          type: Message.RESULT,\n          id: message.id,\n          ok: false,\n          error: CjsResManWorker.serializeError(error, message.operation)\n        });\n      }\n      finally\n      {\n        controllers.delete(message.id);\n      }\n    };\n\n    if (typeof scope.addEventListener === \"function\")\n    {\n      scope.addEventListener(\"message\", onMessage);\n      return () => scope.removeEventListener?.(\"message\", onMessage);\n    }\n    const previous = scope.onmessage;\n    scope.onmessage = onMessage;\n    return () =>\n    {\n      if (scope.onmessage === onMessage) scope.onmessage = previous || null;\n    };\n  }\n\n  /**\n   * Collect unique transferable ArrayBuffers from a worker result.\n   *\n   * SharedArrayBuffer is intentionally excluded because it is shared rather\n   * than transferable.\n   *\n   * @param {*} value Result graph.\n   * @returns {ArrayBuffer[]} Transfer list.\n   */\n  static collectTransferables(value)\n  {\n    const buffers = new Set();\n    const seen = new Set();\n\n    const visit = entry =>\n    {\n      if (entry === null || entry === undefined) return;\n      if (entry instanceof ArrayBuffer)\n      {\n        buffers.add(entry);\n        return;\n      }\n      if (ArrayBuffer.isView(entry))\n      {\n        if (entry.buffer instanceof ArrayBuffer) buffers.add(entry.buffer);\n        return;\n      }\n      if (typeof entry !== \"object\" || seen.has(entry)) return;\n      seen.add(entry);\n      if (Array.isArray(entry))\n      {\n        for (const item of entry) visit(item);\n        return;\n      }\n      for (const item of Object.values(entry)) visit(item);\n    };\n\n    visit(value);\n    return [ ...buffers ];\n  }\n\n  /**\n   * Convert an exception into a cloneable diagnostic.\n   *\n   * @param {*} value Failure value.\n   * @param {string} [operation] Operation name.\n   * @returns {object} Cloneable error data.\n   */\n  static serializeError(value, operation = undefined)\n  {\n    return {\n      name: value?.name || \"CjsResManWorkerError\",\n      message: value?.message || String(value),\n      code: value?.code,\n      operation: value?.operation || operation,\n      path: value?.path,\n      status: value?.status,\n      statusText: value?.statusText\n    };\n  }\n}\n\nasync function fetchResource(payload, context) {\n  if (!payload || typeof payload.url !== \"string\") {\n    throw new TypeError(\"Worker fetch requires a URL.\");\n  }\n  const fetchImplementation = context.fetch || globalThis.fetch;\n  if (typeof fetchImplementation !== \"function\") {\n    throw new ReferenceError(\"Worker fetch is unavailable.\");\n  }\n  const options = {\n    ...(payload.options || {}),\n    ...(context.signal ? { signal: context.signal } : {})\n  };\n  const response = await fetchImplementation(payload.url, options);\n  if (!response.ok) {\n    const error = new Error(\n      `Resource fetch failed: ${response.status} ${response.statusText}`\n    );\n    error.code = \"CJS_RESOURCE_FETCH_FAILED\";\n    error.path = payload.path;\n    error.status = response.status;\n    error.statusText = response.statusText;\n    throw error;\n  }\n\n  switch (payload.responseType || \"arraybuffer\") {\n    case \"arraybuffer\":\n      return response.arrayBuffer();\n    case \"blob\":\n      return response.blob();\n    case \"json\":\n      return response.json();\n    case \"text\":\n      return response.text();\n    default: {\n      const error = new Error(`Unsupported worker fetch response type: ${payload.responseType}`);\n      error.code = \"CJS_RESOURCE_WORKER_RESPONSE_TYPE\";\n      throw error;\n    }\n  }\n}\n\nasync function readFormat(payload) {\n  if (!payload || typeof payload.module !== \"string\" || payload.module === \"\") {\n    throw new TypeError(\"Worker format read requires a module URL.\");\n  }\n  const module = await import(payload.module);\n  const Format = module[payload.exportName || \"default\"];\n  if (typeof Format !== \"function\") {\n    throw new TypeError(\n      `Worker format export was not found: ${payload.exportName || \"default\"}`\n    );\n  }\n  const options = payload.options || {};\n  if (typeof Format.readAsync === \"function\") {\n    return Format.readAsync(payload.input, options);\n  }\n  if (typeof Format.read === \"function\") {\n    return Format.read(payload.input, options);\n  }\n\n  const reader = new Format(options);\n  if (typeof reader.ReadAsync === \"function\") {\n    return reader.ReadAsync(payload.input, options);\n  }\n  if (typeof reader.Read === \"function\") {\n    return reader.Read(payload.input, options);\n  }\n  throw new TypeError(`${Format.name} does not expose a read operation.`);\n}\n\nconst isWorkerScope = typeof WorkerGlobalScope !== \"undefined\"\n  && globalThis instanceof WorkerGlobalScope;\nif (isWorkerScope) CjsResManWorker.install(globalThis);\n"],"names":["CjsResManWorker","Operation","Message","execute","operation","payload","context","FETCH","fetchResource","FORMAT_READ","readFormat","error","Error","code","install","scope","globalThis","postMessage","TypeError","controllers","Map","onMessage","event","message","data","type","CANCEL","get","id","abort","EXECUTE","controller","AbortController","set","result","signal","RESULT","ok","collectTransferables","serializeError","delete","addEventListener","removeEventListener","previous","onmessage","value","buffers","Set","seen","visit","entry","undefined","ArrayBuffer","add","isView","buffer","has","Array","isArray","item","Object","values","name","String","path","status","statusText","url","fetchImplementation","fetch","ReferenceError","options","response","responseType","arrayBuffer","blob","json","text","module","Format","exportName","readAsync","input","read","reader","ReadAsync","Read","isWorkerScope","WorkerGlobalScope"],"mappings":"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"}
+{"version":3,"file":"CjsResManWorker.js","sources":["../../../src/worker/CjsResManWorker.js"],"sourcesContent":["import { Message, Operation } from \"./protocol.js\";\n\n/**\n * Static browser-worker host that owns its operation/message vocabulary,\n * executes clone-safe source and format operations, installs the message\n * envelope, transfers owned buffers, and serializes failures for `CjsResMan`.\n */\nexport class CjsResManWorker\n{\n  /** Stable operations understood by the bundled resource module worker. */\n  static Operation = Operation;\n\n  /** Stable message kinds exchanged with the resource module worker. */\n  static Message = Message;\n\n  /**\n   * Execute one bundled resource worker operation.\n   *\n   * This method also permits deterministic non-browser tests and custom\n   * worker hosts without installing global message handlers.\n   *\n   * @param {string} operation Worker operation name.\n   * @param {*} payload Structured-cloneable operation payload.\n   * @param {object} [context={}] Optional fetch and abort context.\n   * @returns {Promise<*>} Operation result.\n   */\n  static async execute(operation, payload, context = {})\n  {\n    switch (operation)\n    {\n      case Operation.FETCH:\n        return fetchResource(payload, context);\n\n      case Operation.FORMAT_READ:\n        return readFormat(payload);\n\n      default:\n      {\n        const error = new Error(`Unknown resource worker operation: ${operation}`);\n        error.code = \"CJS_RESOURCE_WORKER_OPERATION_UNKNOWN\";\n        error.operation = operation;\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Install the ResMan message protocol on a Worker-compatible scope.\n   *\n   * @param {WorkerGlobalScope|object} scope Worker global.\n   * @returns {() => void} Uninstall callback.\n   */\n  static install(scope = globalThis)\n  {\n    if (!scope || typeof scope.postMessage !== \"function\")\n    {\n      throw new TypeError(\"Resource worker scope must provide postMessage.\");\n    }\n    const controllers = new Map();\n    const onMessage = async event =>\n    {\n      const message = event?.data;\n      if (!message || typeof message !== \"object\") return;\n\n      if (message.type === Message.CANCEL)\n      {\n        controllers.get(message.id)?.abort();\n        return;\n      }\n      if (message.type !== Message.EXECUTE) return;\n\n      const controller = typeof AbortController === \"function\"\n        ? new AbortController()\n        : null;\n      if (controller) controllers.set(message.id, controller);\n      try\n      {\n        const result = await CjsResManWorker.execute(\n          message.operation,\n          message.payload,\n          { signal: controller?.signal }\n        );\n        scope.postMessage({\n          type: Message.RESULT,\n          id: message.id,\n          ok: true,\n          result\n        }, CjsResManWorker.collectTransferables(result));\n      }\n      catch (error)\n      {\n        scope.postMessage({\n          type: Message.RESULT,\n          id: message.id,\n          ok: false,\n          error: CjsResManWorker.serializeError(error, message.operation)\n        });\n      }\n      finally\n      {\n        controllers.delete(message.id);\n      }\n    };\n\n    if (typeof scope.addEventListener === \"function\")\n    {\n      scope.addEventListener(\"message\", onMessage);\n      return () => scope.removeEventListener?.(\"message\", onMessage);\n    }\n    const previous = scope.onmessage;\n    scope.onmessage = onMessage;\n    return () =>\n    {\n      if (scope.onmessage === onMessage) scope.onmessage = previous || null;\n    };\n  }\n\n  /**\n   * Collect unique transferable ArrayBuffers from a worker result.\n   *\n   * SharedArrayBuffer is intentionally excluded because it is shared rather\n   * than transferable.\n   *\n   * @param {*} value Result graph.\n   * @returns {ArrayBuffer[]} Transfer list.\n   */\n  static collectTransferables(value)\n  {\n    const buffers = new Set();\n    const seen = new Set();\n\n    const visit = entry =>\n    {\n      if (entry === null || entry === undefined) return;\n      if (entry instanceof ArrayBuffer)\n      {\n        buffers.add(entry);\n        return;\n      }\n      if (ArrayBuffer.isView(entry))\n      {\n        if (entry.buffer instanceof ArrayBuffer) buffers.add(entry.buffer);\n        return;\n      }\n      if (typeof entry !== \"object\" || seen.has(entry)) return;\n      seen.add(entry);\n      if (Array.isArray(entry))\n      {\n        for (const item of entry) visit(item);\n        return;\n      }\n      for (const item of Object.values(entry)) visit(item);\n    };\n\n    visit(value);\n    return [ ...buffers ];\n  }\n\n  /**\n   * Convert an exception into a cloneable diagnostic.\n   *\n   * @param {*} value Failure value.\n   * @param {string} [operation] Operation name.\n   * @returns {object} Cloneable error data.\n   */\n  static serializeError(value, operation = undefined)\n  {\n    return {\n      name: value?.name || \"CjsResManWorkerError\",\n      message: value?.message || String(value),\n      code: value?.code,\n      operation: value?.operation || operation,\n      path: value?.path,\n      status: value?.status,\n      statusText: value?.statusText\n    };\n  }\n}\n\nasync function fetchResource(payload, context) {\n  if (!payload || typeof payload.url !== \"string\") {\n    throw new TypeError(\"Worker fetch requires a URL.\");\n  }\n  const fetchImplementation = context.fetch || globalThis.fetch;\n  if (typeof fetchImplementation !== \"function\") {\n    throw new ReferenceError(\"Worker fetch is unavailable.\");\n  }\n  const options = {\n    ...(payload.options || {}),\n    ...(context.signal ? { signal: context.signal } : {})\n  };\n  const response = await fetchImplementation(payload.url, options);\n  if (!response.ok) {\n    const error = new Error(\n      `Resource fetch failed: ${response.status} ${response.statusText}`\n    );\n    error.code = \"CJS_RESOURCE_FETCH_FAILED\";\n    error.path = payload.path;\n    error.status = response.status;\n    error.statusText = response.statusText;\n    throw error;\n  }\n\n  switch (payload.responseType || \"arraybuffer\") {\n    case \"arraybuffer\":\n      return response.arrayBuffer();\n    case \"blob\":\n      return response.blob();\n    case \"json\":\n      return response.json();\n    case \"text\":\n      return response.text();\n    default: {\n      const error = new Error(`Unsupported worker fetch response type: ${payload.responseType}`);\n      error.code = \"CJS_RESOURCE_WORKER_RESPONSE_TYPE\";\n      throw error;\n    }\n  }\n}\n\nasync function readFormat(payload) {\n  if (!payload || typeof payload.module !== \"string\" || payload.module === \"\") {\n    throw new TypeError(\"Worker format read requires a module URL.\");\n  }\n  const module = await import(payload.module);\n  const Format = module[payload.exportName || \"default\"];\n  if (typeof Format !== \"function\") {\n    throw new TypeError(\n      `Worker format export was not found: ${payload.exportName || \"default\"}`\n    );\n  }\n  const options = payload.options || {};\n  const context = payload.context || null;\n  if (typeof Format.readAsync === \"function\") {\n    return Format.readAsync(payload.input, options, context);\n  }\n  if (typeof Format.read === \"function\") {\n    return Format.read(payload.input, options, context);\n  }\n\n  const reader = new Format(options);\n  if (typeof reader.ReadAsync === \"function\") {\n    return reader.ReadAsync(payload.input, options, context);\n  }\n  if (typeof reader.Read === \"function\") {\n    return reader.Read(payload.input, options, context);\n  }\n  throw new TypeError(`${Format.name} does not expose a read operation.`);\n}\n\nconst isWorkerScope = typeof WorkerGlobalScope !== \"undefined\"\n  && globalThis instanceof WorkerGlobalScope;\nif (isWorkerScope) CjsResManWorker.install(globalThis);\n"],"names":["CjsResManWorker","Operation","Message","execute","operation","payload","context","FETCH","fetchResource","FORMAT_READ","readFormat","error","Error","code","install","scope","globalThis","postMessage","TypeError","controllers","Map","onMessage","event","message","data","type","CANCEL","get","id","abort","EXECUTE","controller","AbortController","set","result","signal","RESULT","ok","collectTransferables","serializeError","delete","addEventListener","removeEventListener","previous","onmessage","value","buffers","Set","seen","visit","entry","undefined","ArrayBuffer","add","isView","buffer","has","Array","isArray","item","Object","values","name","String","path","status","statusText","url","fetchImplementation","fetch","ReferenceError","options","response","responseType","arrayBuffer","blob","json","text","module","Format","exportName","readAsync","input","read","reader","ReadAsync","Read","isWorkerScope","WorkerGlobalScope"],"mappings":"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"}