@carbonenginejs/runtime-resource 0.9.2 → 0.10.0

package/dist/worker/CjsResManWorker.js.map

@@ -0,0 +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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"}

package/dist/worker/CjsResManWorkerLoader.js

@@ -0,0 +1,434 @@
+import { Operation, Message } from './protocol.js';
+import { CjsResManMainThreadLoader } from './CjsResManMainThreadLoader.js';
+
+const DEFAULT_WORKER_OPTIONS = Object.freeze({
+  type: "module",
+  name: "CjsResManWorker"
+});
+
+/**
+ * Browser module-worker strategy that correlates source/format requests, transfers owned buffers, propagates cancellation and fatal failure, and delegates unsupported operations to a main-thread loader.
+ *
+ * One module worker can overlap fetch requests and serializes synchronous
+ * reader work on its own event loop. Sources opt in through
+ * `CreateWorkerRequest(path, options)`. Formats opt in through a static
+ * `worker` declaration containing their module URL and export name.
+ */
+class CjsResManWorkerLoader {
+  #boundError;
+  #boundMessage;
+  #nextId = 1;
+  #pending = new Map();
+
+  /**
+   * @param {object} [options={}] Worker construction and fallback options.
+   * @param {CjsResManMainThreadLoader|object} [options.fallback] Unsupported-operation fallback.
+   * @param {Worker|object} [options.worker] Existing Worker-compatible instance.
+   * @param {(url: string|URL, options: object) => Worker|object} [options.workerFactory] Worker factory.
+   * @param {string|URL} [options.workerUrl] Module worker entry URL.
+   * @param {object} [options.workerOptions] Options passed to the Worker constructor.
+   * @param {boolean} [options.enabled=true] Whether worker execution may be used.
+   */
+  constructor(options = {}) {
+    if (!options || typeof options !== "object" || Array.isArray(options)) {
+      throw new TypeError("CjsResManWorkerLoader options must be an object.");
+    }
+    this.fallback = options.fallback || new CjsResManMainThreadLoader();
+    assertResourceLoader(this.fallback, "fallback");
+    this.workerFactory = options.workerFactory || defaultWorkerFactory;
+    if (typeof this.workerFactory !== "function") {
+      throw new TypeError("CjsResManWorkerLoader workerFactory must be a function.");
+    }
+    this.workerUrl = options.workerUrl || new URL("./CjsResManWorker.js", import.meta.url);
+    this.workerOptions = Object.freeze({
+      ...DEFAULT_WORKER_OPTIONS,
+      ...(options.workerOptions || {})
+    });
+    this.enabled = options.enabled !== false;
+    this.failed = false;
+    this.worker = options.worker || null;
+    this.#boundMessage = event => this.#OnMessage(event);
+    this.#boundError = event => this.#OnError(event);
+    if (this.worker) this.#Attach(this.worker);
+  }
+
+  /**
+   * Enable and lazily create the configured worker.
+   *
+   * @param {string|URL} [workerUrl] Optional replacement worker URL.
+   * @returns {boolean} Whether a worker is ready.
+   */
+  Enable(workerUrl = this.workerUrl) {
+    this.enabled = true;
+    if (workerUrl !== undefined && workerUrl !== null) this.workerUrl = workerUrl;
+    if (this.worker) return true;
+    if (this.failed) return false;
+    try {
+      const worker = this.workerFactory(this.workerUrl, this.workerOptions);
+      if (!worker || typeof worker.postMessage !== "function") {
+        throw new TypeError("Worker factory did not return a Worker-compatible object.");
+      }
+      this.worker = worker;
+      this.#Attach(worker);
+      return true;
+    } catch {
+      this.worker = null;
+      this.failed = true;
+      return false;
+    }
+  }
+
+  /**
+   * Stop worker use and reject every pending request.
+   *
+   * @param {*} [reason] Optional failure reason.
+   * @returns {CjsResManWorkerLoader} This loader.
+   */
+  Disable(reason = null) {
+    const worker = this.worker;
+    if (worker) {
+      this.#Detach(worker);
+      worker.terminate?.();
+    }
+    this.worker = null;
+    this.enabled = false;
+    this.failed = reason !== null && reason !== undefined;
+    if (this.#pending.size) {
+      const error = normalizeWorkerError(reason || createWorkerUnavailableError("Resource worker was disabled."));
+      for (const request of this.#pending.values()) {
+        cleanupPendingRequest(request);
+        request.reject(error);
+      }
+      this.#pending.clear();
+    }
+    return this;
+  }
+
+  /**
+   * Clear a previous creation/fatal failure so a later enable can retry.
+   *
+   * @returns {CjsResManWorkerLoader} This loader.
+   */
+  Reset() {
+    this.failed = false;
+    this.enabled = true;
+    return this;
+  }
+
+  /**
+   * Replace the unsupported-operation fallback.
+   *
+   * @param {CjsResManMainThreadLoader|object} fallback Loader exposing Read and ReadFormat.
+   * @returns {CjsResManWorkerLoader} This loader.
+   */
+  SetFallback(fallback) {
+    assertResourceLoader(fallback, "fallback");
+    this.fallback = fallback;
+    return this;
+  }
+
+  /**
+   * Report whether worker execution is configured and constructible.
+   *
+   * @returns {boolean}
+   */
+  IsAvailable() {
+    return this.enabled && (Boolean(this.worker) || this.Enable());
+  }
+
+  /**
+   * Read a source through its declared worker request, falling back when the
+   * source is not worker-aware or a worker cannot be created.
+   *
+   * @param {object|Function} source Source implementation.
+   * @param {string} path Normalized resource path.
+   * @param {object} [options={}] Source options.
+   * @returns {Promise<*>|*} Source result.
+   */
+  Read(source, path, options = {}) {
+    assertResourceSource(source);
+    if (typeof source.CreateWorkerRequest !== "function") {
+      return this.fallback.Read(source, path, options);
+    }
+    const request = normalizeWorkerRequest(source.CreateWorkerRequest(path, options));
+    if (!request || !this.IsAvailable()) {
+      return this.fallback.Read(source, path, options);
+    }
+    return this.Execute(request.operation, request.payload, {
+      signal: request.signal || options.signal,
+      transfer: request.transfer
+    });
+  }
+
+  /**
+   * Test whether a registered format can be safely dispatched to this worker.
+   *
+   * @param {object} descriptor Registered format descriptor.
+   * @param {object} [formatOptions={}] Normalized format options.
+   * @returns {boolean}
+   */
+  CanReadFormat(descriptor, formatOptions = {}) {
+    const declaration = normalizeFormatWorkerDeclaration(descriptor);
+    return Boolean(declaration && isWorkerFormatOutputSupported(declaration, formatOptions) && canCloneWorkerValue(formatOptions) && this.IsAvailable());
+  }
+
+  /**
+   * Execute a worker-safe format reader or use the main-thread fallback.
+   *
+   * Inputs are cloned by default so shared source-cache ownership is not
+   * detached. A format may explicitly declare `transferInput: true` when its
+   * caller guarantees exclusive ownership.
+   *
+   * @param {object} descriptor Registered format descriptor.
+   * @param {*} input Reader input.
+   * @param {object} [formatOptions={}] Normalized format options.
+   * @returns {Promise<*>} Format result.
+   */
+  ReadFormat(descriptor, input, formatOptions = {}) {
+    const declaration = normalizeFormatWorkerDeclaration(descriptor);
+    if (!declaration || !isWorkerFormatOutputSupported(declaration, formatOptions) || !canCloneWorkerValue(formatOptions) || !this.IsAvailable()) {
+      return this.fallback.ReadFormat(descriptor, input, formatOptions);
+    }
+    const transfer = declaration.transferInput ? getExclusiveInputTransferables(input) : [];
+    return this.Execute(Operation.FORMAT_READ, {
+      module: declaration.module,
+      exportName: declaration.exportName,
+      input,
+      options: formatOptions
+    }, {
+      transfer
+    });
+  }
+
+  /**
+   * Dispatch one operation using the stable worker message protocol.
+   *
+   * @param {string} operation Operation name.
+   * @param {*} payload Structured-cloneable operation payload.
+   * @param {object} [options={}] Transfer and cancellation options.
+   * @returns {Promise<*>} Worker result.
+   */
+  Execute(operation, payload, options = {}) {
+    if (typeof operation !== "string" || operation.trim() === "") {
+      return Promise.reject(new TypeError("Worker operation must be a non-empty string."));
+    }
+    if (!this.IsAvailable()) {
+      return Promise.reject(createWorkerUnavailableError());
+    }
+    const signal = options.signal || null;
+    if (signal?.aborted) return Promise.reject(createAbortError(signal.reason));
+    const id = this.#nextId++;
+    let resolve;
+    let reject;
+    const promise = new Promise((onResolve, onReject) => {
+      resolve = onResolve;
+      reject = onReject;
+    });
+    const request = {
+      id,
+      resolve,
+      reject,
+      signal,
+      onAbort: null
+    };
+    if (signal && typeof signal.addEventListener === "function") {
+      request.onAbort = () => {
+        if (!this.#pending.delete(id)) return;
+        cleanupPendingRequest(request);
+        try {
+          this.worker?.postMessage({
+            type: Message.CANCEL,
+            id
+          });
+        } catch {
+          // The local abort remains authoritative if the worker is already gone.
+        }
+        reject(createAbortError(signal.reason));
+      };
+      signal.addEventListener("abort", request.onAbort, {
+        once: true
+      });
+    }
+    this.#pending.set(id, request);
+    try {
+      this.worker.postMessage({
+        type: Message.EXECUTE,
+        id,
+        operation,
+        payload
+      }, normalizeTransferList(options.transfer));
+    } catch (error) {
+      this.#pending.delete(id);
+      cleanupPendingRequest(request);
+      reject(error);
+    }
+    return promise;
+  }
+
+  /**
+   * Return the number of unresolved worker requests.
+   *
+   * @returns {number}
+   */
+  GetPendingCount() {
+    return this.#pending.size;
+  }
+
+  /** Attach this loader's result and failure listeners to a worker. */
+  #Attach(worker) {
+    if (typeof worker.addEventListener === "function") {
+      worker.addEventListener("message", this.#boundMessage);
+      worker.addEventListener("error", this.#boundError);
+      worker.addEventListener("messageerror", this.#boundError);
+    } else {
+      worker.onmessage = this.#boundMessage;
+      worker.onerror = this.#boundError;
+      worker.onmessageerror = this.#boundError;
+    }
+  }
+
+  /** Detach this loader's result and failure listeners from a worker. */
+  #Detach(worker) {
+    if (typeof worker.removeEventListener === "function") {
+      worker.removeEventListener("message", this.#boundMessage);
+      worker.removeEventListener("error", this.#boundError);
+      worker.removeEventListener("messageerror", this.#boundError);
+    } else {
+      if (worker.onmessage === this.#boundMessage) worker.onmessage = null;
+      if (worker.onerror === this.#boundError) worker.onerror = null;
+      if (worker.onmessageerror === this.#boundError) worker.onmessageerror = null;
+    }
+  }
+
+  /** Settle the pending request identified by one worker result message. */
+  #OnMessage(event) {
+    const data = event?.data;
+    if (!data || data.type !== Message.RESULT) return;
+    const request = this.#pending.get(data.id);
+    if (!request) return;
+    this.#pending.delete(data.id);
+    cleanupPendingRequest(request);
+    if (data.ok) request.resolve(data.result);else request.reject(normalizeWorkerError(data.error));
+  }
+
+  /** Disable worker execution after a fatal worker or message failure. */
+  #OnError(event) {
+    const reason = event?.error || event || new Error("Resource worker failed.");
+    this.Disable(reason);
+  }
+}
+function assertResourceSource(source) {
+  if (!source || typeof source !== "object" && typeof source !== "function" || typeof source.Read !== "function") {
+    throw new TypeError("Resource source must provide Read(path, options).");
+  }
+}
+function assertResourceLoader(loader, name = "loader") {
+  if (!loader || typeof loader.Read !== "function" || typeof loader.ReadFormat !== "function") {
+    throw new TypeError(`CjsResManWorkerLoader ${name} must provide Read and ReadFormat.`);
+  }
+}
+function defaultWorkerFactory(url, options) {
+  if (typeof Worker === "undefined") {
+    throw new ReferenceError("Browser Worker is not available.");
+  }
+  return new Worker(url, options);
+}
+function normalizeWorkerRequest(request) {
+  if (request === null || request === undefined || request === false) return null;
+  if (!request || typeof request !== "object" || Array.isArray(request)) {
+    throw new TypeError("CreateWorkerRequest must return an object or null.");
+  }
+  if (typeof request.operation !== "string" || request.operation.trim() === "") {
+    throw new TypeError("Worker source request requires a non-empty operation.");
+  }
+  return {
+    operation: request.operation,
+    payload: request.payload,
+    signal: request.signal || null,
+    transfer: normalizeTransferList(request.transfer)
+  };
+}
+function normalizeFormatWorkerDeclaration(descriptor) {
+  const Format = descriptor?.Format;
+  const declaration = descriptor?.worker || Format?.worker;
+  if (!declaration) return null;
+  const value = typeof declaration === "string" ? {
+    module: declaration
+  } : declaration;
+  if (!value || typeof value !== "object" || !value.module) return null;
+  return Object.freeze({
+    module: String(value.module),
+    exportName: String(value.exportName || Format?.name || "default"),
+    outputTypes: Array.isArray(value.outputTypes) ? Object.freeze(value.outputTypes.map(String)) : null,
+    defaultOutput: value.defaultOutput === undefined ? undefined : String(value.defaultOutput),
+    transferInput: value.transferInput === true
+  });
+}
+function isWorkerFormatOutputSupported(declaration, formatOptions) {
+  if (!declaration.outputTypes) return true;
+  const output = formatOptions.emit ?? declaration.defaultOutput;
+  return output !== undefined && declaration.outputTypes.includes(String(output));
+}
+function normalizeTransferList(value) {
+  if (value === null || value === undefined) return [];
+  if (!Array.isArray(value)) {
+    throw new TypeError("Worker transfer list must be an array.");
+  }
+  return value;
+}
+function getExclusiveInputTransferables(input) {
+  if (input instanceof ArrayBuffer) return [input];
+  if (ArrayBuffer.isView(input) && input.byteOffset === 0 && input.byteLength === input.buffer.byteLength) {
+    return [input.buffer];
+  }
+  return [];
+}
+function canCloneWorkerValue(value, seen = new Set()) {
+  if (value === null || value === undefined) return true;
+  const type = typeof value;
+  if (type === "string" || type === "number" || type === "boolean" || type === "bigint") {
+    return true;
+  }
+  if (type !== "object") return false;
+  if (value instanceof ArrayBuffer || ArrayBuffer.isView(value) || value instanceof Date) {
+    return true;
+  }
+  if (seen.has(value)) return false;
+  seen.add(value);
+  if (Array.isArray(value)) {
+    return value.every(entry => canCloneWorkerValue(entry, seen));
+  }
+  const prototype = Object.getPrototypeOf(value);
+  if (prototype !== Object.prototype && prototype !== null) return false;
+  return Object.values(value).every(entry => canCloneWorkerValue(entry, seen));
+}
+function cleanupPendingRequest(request) {
+  if (request.signal && request.onAbort && typeof request.signal.removeEventListener === "function") {
+    request.signal.removeEventListener("abort", request.onAbort);
+  }
+}
+function createWorkerUnavailableError(message = "Resource worker is unavailable.") {
+  const error = new Error(message);
+  error.name = "CjsResManWorkerUnavailableError";
+  error.code = "CJS_RESOURCE_WORKER_UNAVAILABLE";
+  return error;
+}
+function createAbortError(reason) {
+  if (reason instanceof Error) return reason;
+  const error = new Error(reason === undefined ? "Resource worker request was aborted." : String(reason));
+  error.name = "AbortError";
+  error.code = "ABORT_ERR";
+  return error;
+}
+function normalizeWorkerError(value) {
+  if (value instanceof Error) return value;
+  const error = new Error(value?.message || "Resource worker operation failed.");
+  error.name = value?.name || "CjsResManWorkerError";
+  for (const key of ["code", "operation", "path", "status", "statusText"]) {
+    if (value?.[key] !== undefined) error[key] = value[key];
+  }
+  return error;
+}
+
+export { CjsResManWorkerLoader };
+//# sourceMappingURL=CjsResManWorkerLoader.js.map

package/dist/worker/CjsResManWorkerLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsResManWorkerLoader.js","sources":["../../../src/worker/CjsResManWorkerLoader.js"],"sourcesContent":["import { Message, Operation } from \"./protocol.js\";\nimport { CjsResManMainThreadLoader } from \"./CjsResManMainThreadLoader.js\";\n\nconst DEFAULT_WORKER_OPTIONS = Object.freeze({\n  type: \"module\",\n  name: \"CjsResManWorker\"\n});\n\n/**\n * Browser module-worker strategy that correlates source/format requests, transfers owned buffers, propagates cancellation and fatal failure, and delegates unsupported operations to a main-thread loader.\n *\n * One module worker can overlap fetch requests and serializes synchronous\n * reader work on its own event loop. Sources opt in through\n * `CreateWorkerRequest(path, options)`. Formats opt in through a static\n * `worker` declaration containing their module URL and export name.\n */\nexport class CjsResManWorkerLoader\n{\n  #boundError;\n  #boundMessage;\n  #nextId = 1;\n  #pending = new Map();\n\n  /**\n   * @param {object} [options={}] Worker construction and fallback options.\n   * @param {CjsResManMainThreadLoader|object} [options.fallback] Unsupported-operation fallback.\n   * @param {Worker|object} [options.worker] Existing Worker-compatible instance.\n   * @param {(url: string|URL, options: object) => Worker|object} [options.workerFactory] Worker factory.\n   * @param {string|URL} [options.workerUrl] Module worker entry URL.\n   * @param {object} [options.workerOptions] Options passed to the Worker constructor.\n   * @param {boolean} [options.enabled=true] Whether worker execution may be used.\n   */\n  constructor(options = {}) {\n    if (!options || typeof options !== \"object\" || Array.isArray(options)) {\n      throw new TypeError(\"CjsResManWorkerLoader options must be an object.\");\n    }\n\n    this.fallback = options.fallback || new CjsResManMainThreadLoader();\n    assertResourceLoader(this.fallback, \"fallback\");\n    this.workerFactory = options.workerFactory || defaultWorkerFactory;\n    if (typeof this.workerFactory !== \"function\") {\n      throw new TypeError(\"CjsResManWorkerLoader workerFactory must be a function.\");\n    }\n    this.workerUrl = options.workerUrl\n      || new URL(\"./CjsResManWorker.js\", import.meta.url);\n    this.workerOptions = Object.freeze({\n      ...DEFAULT_WORKER_OPTIONS,\n      ...(options.workerOptions || {})\n    });\n    this.enabled = options.enabled !== false;\n    this.failed = false;\n    this.worker = options.worker || null;\n    this.#boundMessage = event => this.#OnMessage(event);\n    this.#boundError = event => this.#OnError(event);\n    if (this.worker) this.#Attach(this.worker);\n  }\n\n  /**\n   * Enable and lazily create the configured worker.\n   *\n   * @param {string|URL} [workerUrl] Optional replacement worker URL.\n   * @returns {boolean} Whether a worker is ready.\n   */\n  Enable(workerUrl = this.workerUrl) {\n    this.enabled = true;\n    if (workerUrl !== undefined && workerUrl !== null) this.workerUrl = workerUrl;\n    if (this.worker) return true;\n    if (this.failed) return false;\n\n    try {\n      const worker = this.workerFactory(this.workerUrl, this.workerOptions);\n      if (!worker || typeof worker.postMessage !== \"function\") {\n        throw new TypeError(\"Worker factory did not return a Worker-compatible object.\");\n      }\n      this.worker = worker;\n      this.#Attach(worker);\n      return true;\n    } catch {\n      this.worker = null;\n      this.failed = true;\n      return false;\n    }\n  }\n\n  /**\n   * Stop worker use and reject every pending request.\n   *\n   * @param {*} [reason] Optional failure reason.\n   * @returns {CjsResManWorkerLoader} This loader.\n   */\n  Disable(reason = null) {\n    const worker = this.worker;\n    if (worker) {\n      this.#Detach(worker);\n      worker.terminate?.();\n    }\n    this.worker = null;\n    this.enabled = false;\n    this.failed = reason !== null && reason !== undefined;\n\n    if (this.#pending.size) {\n      const error = normalizeWorkerError(\n        reason || createWorkerUnavailableError(\"Resource worker was disabled.\")\n      );\n      for (const request of this.#pending.values()) {\n        cleanupPendingRequest(request);\n        request.reject(error);\n      }\n      this.#pending.clear();\n    }\n    return this;\n  }\n\n  /**\n   * Clear a previous creation/fatal failure so a later enable can retry.\n   *\n   * @returns {CjsResManWorkerLoader} This loader.\n   */\n  Reset() {\n    this.failed = false;\n    this.enabled = true;\n    return this;\n  }\n\n  /**\n   * Replace the unsupported-operation fallback.\n   *\n   * @param {CjsResManMainThreadLoader|object} fallback Loader exposing Read and ReadFormat.\n   * @returns {CjsResManWorkerLoader} This loader.\n   */\n  SetFallback(fallback) {\n    assertResourceLoader(fallback, \"fallback\");\n    this.fallback = fallback;\n    return this;\n  }\n\n  /**\n   * Report whether worker execution is configured and constructible.\n   *\n   * @returns {boolean}\n   */\n  IsAvailable() {\n    return this.enabled && (Boolean(this.worker) || this.Enable());\n  }\n\n  /**\n   * Read a source through its declared worker request, falling back when the\n   * source is not worker-aware or a worker cannot be created.\n   *\n   * @param {object|Function} source Source implementation.\n   * @param {string} path Normalized resource path.\n   * @param {object} [options={}] Source options.\n   * @returns {Promise<*>|*} Source result.\n   */\n  Read(source, path, options = {}) {\n    assertResourceSource(source);\n    if (typeof source.CreateWorkerRequest !== \"function\") {\n      return this.fallback.Read(source, path, options);\n    }\n\n    const request = normalizeWorkerRequest(source.CreateWorkerRequest(path, options));\n    if (!request || !this.IsAvailable()) {\n      return this.fallback.Read(source, path, options);\n    }\n    return this.Execute(request.operation, request.payload, {\n      signal: request.signal || options.signal,\n      transfer: request.transfer\n    });\n  }\n\n  /**\n   * Test whether a registered format can be safely dispatched to this worker.\n   *\n   * @param {object} descriptor Registered format descriptor.\n   * @param {object} [formatOptions={}] Normalized format options.\n   * @returns {boolean}\n   */\n  CanReadFormat(descriptor, formatOptions = {}) {\n    const declaration = normalizeFormatWorkerDeclaration(descriptor);\n    return Boolean(\n      declaration\n      && isWorkerFormatOutputSupported(declaration, formatOptions)\n      && canCloneWorkerValue(formatOptions)\n      && this.IsAvailable()\n    );\n  }\n\n  /**\n   * Execute a worker-safe format reader or use the main-thread fallback.\n   *\n   * Inputs are cloned by default so shared source-cache ownership is not\n   * detached. A format may explicitly declare `transferInput: true` when its\n   * caller guarantees exclusive ownership.\n   *\n   * @param {object} descriptor Registered format descriptor.\n   * @param {*} input Reader input.\n   * @param {object} [formatOptions={}] Normalized format options.\n   * @returns {Promise<*>} Format result.\n   */\n  ReadFormat(descriptor, input, formatOptions = {}) {\n    const declaration = normalizeFormatWorkerDeclaration(descriptor);\n    if (!declaration\n      || !isWorkerFormatOutputSupported(declaration, formatOptions)\n      || !canCloneWorkerValue(formatOptions)\n      || !this.IsAvailable()) {\n      return this.fallback.ReadFormat(descriptor, input, formatOptions);\n    }\n\n    const transfer = declaration.transferInput\n      ? getExclusiveInputTransferables(input)\n      : [];\n    return this.Execute(Operation.FORMAT_READ, {\n      module: declaration.module,\n      exportName: declaration.exportName,\n      input,\n      options: formatOptions\n    }, { transfer });\n  }\n\n  /**\n   * Dispatch one operation using the stable worker message protocol.\n   *\n   * @param {string} operation Operation name.\n   * @param {*} payload Structured-cloneable operation payload.\n   * @param {object} [options={}] Transfer and cancellation options.\n   * @returns {Promise<*>} Worker result.\n   */\n  Execute(operation, payload, options = {}) {\n    if (typeof operation !== \"string\" || operation.trim() === \"\") {\n      return Promise.reject(new TypeError(\"Worker operation must be a non-empty string.\"));\n    }\n    if (!this.IsAvailable()) {\n      return Promise.reject(createWorkerUnavailableError());\n    }\n    const signal = options.signal || null;\n    if (signal?.aborted) return Promise.reject(createAbortError(signal.reason));\n\n    const id = this.#nextId++;\n    let resolve;\n    let reject;\n    const promise = new Promise((onResolve, onReject) => {\n      resolve = onResolve;\n      reject = onReject;\n    });\n    const request = {\n      id,\n      resolve,\n      reject,\n      signal,\n      onAbort: null\n    };\n    if (signal && typeof signal.addEventListener === \"function\") {\n      request.onAbort = () => {\n        if (!this.#pending.delete(id)) return;\n        cleanupPendingRequest(request);\n        try {\n          this.worker?.postMessage({\n            type: Message.CANCEL,\n            id\n          });\n        } catch {\n          // The local abort remains authoritative if the worker is already gone.\n        }\n        reject(createAbortError(signal.reason));\n      };\n      signal.addEventListener(\"abort\", request.onAbort, { once: true });\n    }\n    this.#pending.set(id, request);\n\n    try {\n      this.worker.postMessage({\n        type: Message.EXECUTE,\n        id,\n        operation,\n        payload\n      }, normalizeTransferList(options.transfer));\n    } catch (error) {\n      this.#pending.delete(id);\n      cleanupPendingRequest(request);\n      reject(error);\n    }\n    return promise;\n  }\n\n  /**\n   * Return the number of unresolved worker requests.\n   *\n   * @returns {number}\n   */\n  GetPendingCount() {\n    return this.#pending.size;\n  }\n\n  /** Attach this loader's result and failure listeners to a worker. */\n  #Attach(worker) {\n    if (typeof worker.addEventListener === \"function\") {\n      worker.addEventListener(\"message\", this.#boundMessage);\n      worker.addEventListener(\"error\", this.#boundError);\n      worker.addEventListener(\"messageerror\", this.#boundError);\n    } else {\n      worker.onmessage = this.#boundMessage;\n      worker.onerror = this.#boundError;\n      worker.onmessageerror = this.#boundError;\n    }\n  }\n\n  /** Detach this loader's result and failure listeners from a worker. */\n  #Detach(worker) {\n    if (typeof worker.removeEventListener === \"function\") {\n      worker.removeEventListener(\"message\", this.#boundMessage);\n      worker.removeEventListener(\"error\", this.#boundError);\n      worker.removeEventListener(\"messageerror\", this.#boundError);\n    } else {\n      if (worker.onmessage === this.#boundMessage) worker.onmessage = null;\n      if (worker.onerror === this.#boundError) worker.onerror = null;\n      if (worker.onmessageerror === this.#boundError) worker.onmessageerror = null;\n    }\n  }\n\n  /** Settle the pending request identified by one worker result message. */\n  #OnMessage(event) {\n    const data = event?.data;\n    if (!data || data.type !== Message.RESULT) return;\n    const request = this.#pending.get(data.id);\n    if (!request) return;\n    this.#pending.delete(data.id);\n    cleanupPendingRequest(request);\n    if (data.ok) request.resolve(data.result);\n    else request.reject(normalizeWorkerError(data.error));\n  }\n\n  /** Disable worker execution after a fatal worker or message failure. */\n  #OnError(event) {\n    const reason = event?.error || event || new Error(\"Resource worker failed.\");\n    this.Disable(reason);\n  }\n}\n\nfunction assertResourceSource(source) {\n  if (!source || (typeof source !== \"object\" && typeof source !== \"function\")\n    || typeof source.Read !== \"function\") {\n    throw new TypeError(\"Resource source must provide Read(path, options).\");\n  }\n}\n\nfunction assertResourceLoader(loader, name = \"loader\") {\n  if (!loader || typeof loader.Read !== \"function\" || typeof loader.ReadFormat !== \"function\") {\n    throw new TypeError(`CjsResManWorkerLoader ${name} must provide Read and ReadFormat.`);\n  }\n}\n\nfunction defaultWorkerFactory(url, options) {\n  if (typeof Worker === \"undefined\") {\n    throw new ReferenceError(\"Browser Worker is not available.\");\n  }\n  return new Worker(url, options);\n}\n\nfunction normalizeWorkerRequest(request) {\n  if (request === null || request === undefined || request === false) return null;\n  if (!request || typeof request !== \"object\" || Array.isArray(request)) {\n    throw new TypeError(\"CreateWorkerRequest must return an object or null.\");\n  }\n  if (typeof request.operation !== \"string\" || request.operation.trim() === \"\") {\n    throw new TypeError(\"Worker source request requires a non-empty operation.\");\n  }\n  return {\n    operation: request.operation,\n    payload: request.payload,\n    signal: request.signal || null,\n    transfer: normalizeTransferList(request.transfer)\n  };\n}\n\nfunction normalizeFormatWorkerDeclaration(descriptor) {\n  const Format = descriptor?.Format;\n  const declaration = descriptor?.worker || Format?.worker;\n  if (!declaration) return null;\n\n  const value = typeof declaration === \"string\"\n    ? { module: declaration }\n    : declaration;\n  if (!value || typeof value !== \"object\" || !value.module) return null;\n  return Object.freeze({\n    module: String(value.module),\n    exportName: String(value.exportName || Format?.name || \"default\"),\n    outputTypes: Array.isArray(value.outputTypes)\n      ? Object.freeze(value.outputTypes.map(String))\n      : null,\n    defaultOutput: value.defaultOutput === undefined\n      ? undefined\n      : String(value.defaultOutput),\n    transferInput: value.transferInput === true\n  });\n}\n\nfunction isWorkerFormatOutputSupported(declaration, formatOptions) {\n  if (!declaration.outputTypes) return true;\n  const output = formatOptions.emit ?? declaration.defaultOutput;\n  return output !== undefined && declaration.outputTypes.includes(String(output));\n}\n\nfunction normalizeTransferList(value) {\n  if (value === null || value === undefined) return [];\n  if (!Array.isArray(value)) {\n    throw new TypeError(\"Worker transfer list must be an array.\");\n  }\n  return value;\n}\n\nfunction getExclusiveInputTransferables(input) {\n  if (input instanceof ArrayBuffer) return [ input ];\n  if (ArrayBuffer.isView(input)\n    && input.byteOffset === 0\n    && input.byteLength === input.buffer.byteLength) {\n    return [ input.buffer ];\n  }\n  return [];\n}\n\nfunction canCloneWorkerValue(value, seen = new Set()) {\n  if (value === null || value === undefined) return true;\n  const type = typeof value;\n  if (type === \"string\" || type === \"number\" || type === \"boolean\" || type === \"bigint\") {\n    return true;\n  }\n  if (type !== \"object\") return false;\n  if (value instanceof ArrayBuffer || ArrayBuffer.isView(value) || value instanceof Date) {\n    return true;\n  }\n  if (seen.has(value)) return false;\n  seen.add(value);\n  if (Array.isArray(value)) {\n    return value.every(entry => canCloneWorkerValue(entry, seen));\n  }\n  const prototype = Object.getPrototypeOf(value);\n  if (prototype !== Object.prototype && prototype !== null) return false;\n  return Object.values(value).every(entry => canCloneWorkerValue(entry, seen));\n}\n\nfunction cleanupPendingRequest(request) {\n  if (request.signal && request.onAbort\n    && typeof request.signal.removeEventListener === \"function\") {\n    request.signal.removeEventListener(\"abort\", request.onAbort);\n  }\n}\n\nfunction createWorkerUnavailableError(message = \"Resource worker is unavailable.\") {\n  const error = new Error(message);\n  error.name = \"CjsResManWorkerUnavailableError\";\n  error.code = \"CJS_RESOURCE_WORKER_UNAVAILABLE\";\n  return error;\n}\n\nfunction createAbortError(reason) {\n  if (reason instanceof Error) return reason;\n  const error = new Error(reason === undefined ? \"Resource worker request was aborted.\" : String(reason));\n  error.name = \"AbortError\";\n  error.code = \"ABORT_ERR\";\n  return error;\n}\n\nfunction normalizeWorkerError(value) {\n  if (value instanceof Error) return value;\n  const error = new Error(value?.message || \"Resource worker operation failed.\");\n  error.name = value?.name || \"CjsResManWorkerError\";\n  for (const key of [ \"code\", \"operation\", \"path\", \"status\", \"statusText\" ]) {\n    if (value?.[key] !== undefined) error[key] = value[key];\n  }\n  return error;\n}\n"],"names":["DEFAULT_WORKER_OPTIONS","Object","freeze","type","name","CjsResManWorkerLoader","Map","constructor","options","Array","isArray","TypeError","fallback","CjsResManMainThreadLoader","assertResourceLoader","workerFactory","defaultWorkerFactory","workerUrl","URL","import","meta","url","workerOptions","enabled","failed","worker","event","Enable","undefined","postMessage","Disable","reason","terminate","size","error","normalizeWorkerError","createWorkerUnavailableError","request","values","cleanupPendingRequest","reject","clear","Reset","SetFallback","IsAvailable","Boolean","Read","source","path","assertResourceSource","CreateWorkerRequest","normalizeWorkerRequest","Execute","operation","payload","signal","transfer","CanReadFormat","descriptor","formatOptions","declaration","normalizeFormatWorkerDeclaration","isWorkerFormatOutputSupported","canCloneWorkerValue","ReadFormat","input","transferInput","getExclusiveInputTransferables","Operation","FORMAT_READ","module","exportName","trim","Promise","aborted","createAbortError","id","resolve","promise","onResolve","onReject","onAbort","addEventListener","delete","Message","CANCEL","once","set","EXECUTE","normalizeTransferList","GetPendingCount","#Attach","onmessage","onerror","onmessageerror","#Detach","removeEventListener","#OnMessage","data","RESULT","get","ok","result","#OnError","Error","loader","Worker","ReferenceError","Format","value","String","outputTypes","map","defaultOutput","output","emit","includes","ArrayBuffer","isView","byteOffset","byteLength","buffer","seen","Set","Date","has","add","every","entry","prototype","getPrototypeOf","message","code","key"],"mappings":"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"}

package/dist/worker/protocol.js

@@ -0,0 +1,12 @@
+const Operation = Object.freeze({
+  FETCH: "source.fetch",
+  FORMAT_READ: "format.read"
+});
+const Message = Object.freeze({
+  CANCEL: "cancel",
+  EXECUTE: "execute",
+  RESULT: "result"
+});
+
+export { Message, Operation };
+//# sourceMappingURL=protocol.js.map

package/dist/worker/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sources":["../../../src/worker/protocol.js"],"sourcesContent":["export const Operation = Object.freeze({\n  FETCH: \"source.fetch\",\n  FORMAT_READ: \"format.read\"\n});\n\nexport const Message = Object.freeze({\n  CANCEL: \"cancel\",\n  EXECUTE: \"execute\",\n  RESULT: \"result\"\n});\n"],"names":["Operation","Object","freeze","FETCH","FORMAT_READ","Message","CANCEL","EXECUTE","RESULT"],"mappings":"MAAaA,SAAS,GAAGC,MAAM,CAACC,MAAM,CAAC;AACrCC,EAAAA,KAAK,EAAE,cAAc;AACrBC,EAAAA,WAAW,EAAE;AACf,CAAC;MAEYC,OAAO,GAAGJ,MAAM,CAACC,MAAM,CAAC;AACnCI,EAAAA,MAAM,EAAE,QAAQ;AAChBC,EAAAA,OAAO,EAAE,SAAS;AAClBC,EAAAA,MAAM,EAAE;AACV,CAAC;;;;"}

package/docs/README.md

@@ -9,9 +9,11 @@ Summary: Documentation home for the GPU-free resource lifecycle, cache, format,
 
 `@carbonenginejs/runtime-resource` owns the GPU-free resource layer of
 CarbonEngineJS: resource identity and state, the MotherLode cache, semantic
-resource classes, registered format readers, source adapters, and the queued
+resource classes, registered format readers, fetch providers, and the queued
 CPU load/publication pipeline. It stops at a published CPU payload; engine
-packages realize that payload into backend objects.
+packages realize that payload into backend objects. It also owns the canonical
+device-free `Tr2EffectRes`/`Tr2Shader` reflection graph and portable-reflection
+hydration boundary.
 
 ## Use this package when
 
@@ -19,6 +21,10 @@ packages realize that payload into backend objects.
   selection, `Ready()`/`GetObject()`) without choosing a GPU backend;
 - you need one of the non-shader format readers as a tree-shakeable subpath
   (`@carbonenginejs/runtime-resource/formats/<name>`);
+- you need canonical effect permutation selection or immutable shader
+  reflection records from `@carbonenginejs/runtime-resource/resource/shader`;
+- you need canonical raw audio resources for complete files or byte windows
+  over shared physical sources;
 - you are writing an engine adapter that consumes published CPU payloads and
   needs the documented retention, reload, and texture-array contracts.
 
@@ -31,7 +37,8 @@ packages realize that payload into backend objects.
   packages (`engine-webgpu`, future WebGL engines) that realize prepared
   resources.
 - Owned responsibility: resource identity, cache, CPU payload lifecycle,
-  format selection and conversion, and load/publication queues.
+  format selection and conversion, load/publication queues, and canonical
+  device-free effect/shader reflection hydration and selection.
 - Owned elsewhere: WebGL/WebGPU realization, device budgets, and device-loss
   recovery belong to engine packages; shader formats belong to the dedicated
   shader format packages.
@@ -54,6 +61,12 @@ packages realize that payload into backend objects.
   reload contract.
 - [reference/queues.md](reference/queues.md): queued CPU load, publication,
   registration, and the `Wait()` fence.
+- [reference/workers.md](reference/workers.md): browser-worker source and
+  declared worker-safe format execution.
+- [reference/classes/audio.md](reference/classes/audio.md): complete/shared
+  audio byte owners and individually addressable audio resource views.
+- [reference/classes/resources.md](reference/classes/resources.md): canonical
+  resource records, effect selection, and shader-reflection classes.
 - [reference/texture-arrays.md](reference/texture-arrays.md): texture-array
   proxies, update generations, and adapter commits.
 - [reference/texture-pipeline.md](reference/texture-pipeline.md):