bitfab 0.64.1 → 0.64.2

package/dist/{chunk-EQBRW3MC.js → chunk-FX4X7LOW.js}

@@ -1,7 +1,8 @@
 import {
   BitfabError,
+  warnOnce,
   writeOnce
-} from "./chunk-RQ7HWX2T.js";
+} from "./chunk-O632VPWV.js";
 
 // src/codeChange.ts
 var NUL = String.fromCharCode(0);
@@ -84,6 +85,31 @@ function warnJudgeAssertionsDeprecated(write = console.warn) {
 }
 
 // src/replayRegistry.ts
+var REGISTRATION_FIELDS = /* @__PURE__ */ new Set([
+  "client",
+  "fn",
+  "traceFunctionKey",
+  "options",
+  "optionsFactory"
+]);
+function validateReplayRegistry(registry) {
+  for (const [pipeline, registration] of Object.entries(registry)) {
+    if (typeof registration !== "object" || registration === null) {
+      throw new BitfabError(
+        `Replay registry entry '${pipeline}' must be an object with client and fn.`
+      );
+    }
+    const unknownFields = Object.keys(registration).filter(
+      (field) => !REGISTRATION_FIELDS.has(field)
+    );
+    if (unknownFields.length > 0) {
+      warnOnce(
+        `replay-registry-unknown-fields:${pipeline}:${unknownFields.join(",")}`,
+        `Replay registry entry '${pipeline}' has unknown field(s): ${unknownFields.join(", ")}. They are ignored. An entry takes client, fn, traceFunctionKey, options, and optionsFactory. Put replay options such as adaptInputs, mock, and mockOverride inside options. A later SDK release will reject unknown fields.`
+      );
+    }
+  }
+}
 var VALUE_FLAGS = /* @__PURE__ */ new Set([
   "--limit",
   "--attempts",
@@ -290,7 +316,7 @@ async function seedFromRegistry(registry, pipeline, cases, options = {}) {
       sessionId: seedCase.sessionId
     })
   );
-  const { flushTraces: flushTraces2 } = await import("./http-QJV2QWDF.js");
+  const { flushTraces: flushTraces2 } = await import("./http-IOT2GDD2.js");
   await flushTraces2(3e4);
   return { pipeline, traceFunctionKey, traceIds };
 }
@@ -894,7 +920,28 @@ async function importRegistry(path) {
     register();
     isTypeScriptLoaderRegistered = true;
   }
-  return import(pathToFileURL(path).href);
+  try {
+    return await import(pathToFileURL(path).href);
+  } catch (error) {
+    if (isModuleNotFoundError(error)) {
+      throw new BitfabError(`${error.message}
+
+${registryImportHint(path)}`);
+    }
+    throw error;
+  }
+}
+function isModuleNotFoundError(error) {
+  const code = error?.code;
+  return error instanceof Error && (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND");
+}
+function registryImportHint(path) {
+  return [
+    `The replay registry '${path}' could not load one of its imports.`,
+    "A registry belongs in the package that builds the traced function's call and already depends on everything it imports (its tools, clients, and config), and bitfab-replay runs from that package's directory.",
+    "When the traced function lives in a lower-level library that an app package calls, put the registry in the app package and add @bitfab/sdk to it. Copying the app's dependencies into the library is the wrong fix.",
+    `See "When the traced function needs the app's dependencies" at https://docs.bitfab.ai/typescript-sdk.`
+  ].join("\n");
 }
 function resolveRegistry(moduleValue, path) {
   if (typeof moduleValue !== "object" || moduleValue === null) {
@@ -908,6 +955,7 @@ function resolveRegistry(moduleValue, path) {
       `Replay registry '${path}' must export a default registry.`
     );
   }
+  validateReplayRegistry(registry);
   return registry;
 }
 async function runRegistryMain(run, io = {}) {
@@ -959,4 +1007,4 @@ export {
   runRegistryMain,
   runIfEntrypoint
 };
-//# sourceMappingURL=chunk-EQBRW3MC.js.map
+//# sourceMappingURL=chunk-FX4X7LOW.js.map