@juspay/neurolink 11.27.0 → 11.28.0

package/CHANGELOG.md

@@ -1,8 +1,8 @@
-## [11.27.0](https://github.com/juspay/neurolink/compare/v11.26.2...v11.27.0) (2026-08-25)
+## [11.28.0](https://github.com/juspay/neurolink/compare/v11.27.0...v11.28.0) (2026-08-25)
 
 ### Features
 
-- **(models):** the five metadata stores read the manifests as their source of truth ([605f648](https://github.com/juspay/neurolink/commit/605f648b7038e8566aec2127c971a792475dee36))
+- **(media):** one catalog, one registration path, catalog-derived choices ([a185e4b](https://github.com/juspay/neurolink/commit/a185e4b4aaf3d9697f756fb8e3882b98b480ef85))
 
 ## [11.2.3](https://github.com/juspay/neurolink/compare/v11.2.2...v11.2.3) (2026-08-19)
 

package/dist/adapters/video/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Video Adapter Module — Image-to-Video Generation Integration for NeuroLink
+ *
+ * Provides video-generation capability across providers (Vertex Veo, Kling,
+ * Runway, Replicate-hosted video models).
+ *
+ * Use `VideoProcessor.generate(provider, image, prompt, options)` to
+ * dispatch to the registered handler for `provider`.
+ *
+ * Importing this module does NOT register any handlers as a side effect.
+ * Call `registerDefaultVideoHandlers()` explicitly (or go through
+ * `ProviderRegistry.registerAllProviders()`, which every documented
+ * `NeuroLink` entry point already calls) to register every shipped video
+ * handler whose backing API key is present in `process.env`. Registration
+ * is idempotent and silently skipped if a provider is already registered or
+ * its constructor throws.
+ *
+ * @module adapters/video
+ */
+export { VIDEO_ERROR_CODES, VideoError, VideoProcessor, } from "../../utils/videoProcessor.js";
+export { KlingVideoHandler } from "./klingVideoHandler.js";
+export { ReplicateVideoHandler } from "./replicateVideoHandler.js";
+export { RunwayVideoHandler } from "./runwayVideoHandler.js";
+export { isVertexVideoConfigured, VertexVideoHandler, } from "./vertexVideoHandler.js";
+/**
+ * Register every shipped video handler whose backing credentials are
+ * present in the environment. Safe to call multiple times — existing
+ * registrations are preserved.
+ */
+export declare function registerDefaultVideoHandlers(): void;

package/dist/adapters/video/index.js

@@ -0,0 +1,74 @@
+/**
+ * Video Adapter Module — Image-to-Video Generation Integration for NeuroLink
+ *
+ * Provides video-generation capability across providers (Vertex Veo, Kling,
+ * Runway, Replicate-hosted video models).
+ *
+ * Use `VideoProcessor.generate(provider, image, prompt, options)` to
+ * dispatch to the registered handler for `provider`.
+ *
+ * Importing this module does NOT register any handlers as a side effect.
+ * Call `registerDefaultVideoHandlers()` explicitly (or go through
+ * `ProviderRegistry.registerAllProviders()`, which every documented
+ * `NeuroLink` entry point already calls) to register every shipped video
+ * handler whose backing API key is present in `process.env`. Registration
+ * is idempotent and silently skipped if a provider is already registered or
+ * its constructor throws.
+ *
+ * @module adapters/video
+ */
+import { MEDIA_HANDLER_CATALOG } from "../../factories/mediaHandlerCatalog.js";
+import { logger } from "../../utils/logger.js";
+import { VideoProcessor } from "../../utils/videoProcessor.js";
+export { VIDEO_ERROR_CODES, VideoError, VideoProcessor, } from "../../utils/videoProcessor.js";
+// ============================================================================
+// HANDLER CLASSES
+// ============================================================================
+export { KlingVideoHandler } from "./klingVideoHandler.js";
+export { ReplicateVideoHandler } from "./replicateVideoHandler.js";
+export { RunwayVideoHandler } from "./runwayVideoHandler.js";
+export { isVertexVideoConfigured, VertexVideoHandler, } from "./vertexVideoHandler.js";
+// ============================================================================
+// AUTO-REGISTRATION
+// ============================================================================
+import { KlingVideoHandler } from "./klingVideoHandler.js";
+import { ReplicateVideoHandler } from "./replicateVideoHandler.js";
+import { RunwayVideoHandler } from "./runwayVideoHandler.js";
+import { VertexVideoHandler } from "./vertexVideoHandler.js";
+// Provider names are the Task-8 catalog's job — only the factory (which
+// needs the imported handler class) stays local to this module.
+const VIDEO_HANDLER_FACTORIES = {
+    vertex: () => new VertexVideoHandler(),
+    kling: () => new KlingVideoHandler(),
+    runway: () => new RunwayVideoHandler(),
+    replicate: () => new ReplicateVideoHandler(),
+};
+const VIDEO_HANDLER_CANDIDATES = MEDIA_HANDLER_CATALOG.filter((entry) => entry.kind === "video").map((entry) => {
+    const factory = VIDEO_HANDLER_FACTORIES[entry.name];
+    if (!factory) {
+        throw new Error(`[video] no handler factory for catalog entry "${entry.name}"`);
+    }
+    return { name: entry.name, factory };
+});
+/**
+ * Register every shipped video handler whose backing credentials are
+ * present in the environment. Safe to call multiple times — existing
+ * registrations are preserved.
+ */
+export function registerDefaultVideoHandlers() {
+    for (const { name, factory } of VIDEO_HANDLER_CANDIDATES) {
+        if (VideoProcessor.supports(name)) {
+            continue;
+        }
+        try {
+            const handler = factory();
+            if (!handler.isConfigured()) {
+                continue;
+            }
+            VideoProcessor.registerHandler(name, handler);
+        }
+        catch (err) {
+            logger.debug(`[video] ${name} auto-registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}

package/dist/avatar/index.d.ts

@@ -7,9 +7,12 @@
  * Use `AvatarProcessor.generate(provider, options)` to dispatch to the
  * registered handler for `provider`.
  *
- * Importing this module also auto-registers every shipped avatar handler
- * whose backing API key is present in `process.env`. Registration is
- * idempotent and silently skipped if a provider is already registered or
+ * Importing this module does NOT register any handlers as a side effect.
+ * Call `registerDefaultAvatarHandlers()` explicitly (or go through
+ * `ProviderRegistry.registerAllProviders()`, which every documented
+ * `NeuroLink` entry point already calls) to register every shipped avatar
+ * handler whose backing API key is present in `process.env`. Registration
+ * is idempotent and silently skipped if a provider is already registered or
  * its constructor throws.
  *
  * @module avatar

package/dist/avatar/index.js

@@ -7,13 +7,17 @@
  * Use `AvatarProcessor.generate(provider, options)` to dispatch to the
  * registered handler for `provider`.
  *
- * Importing this module also auto-registers every shipped avatar handler
- * whose backing API key is present in `process.env`. Registration is
- * idempotent and silently skipped if a provider is already registered or
+ * Importing this module does NOT register any handlers as a side effect.
+ * Call `registerDefaultAvatarHandlers()` explicitly (or go through
+ * `ProviderRegistry.registerAllProviders()`, which every documented
+ * `NeuroLink` entry point already calls) to register every shipped avatar
+ * handler whose backing API key is present in `process.env`. Registration
+ * is idempotent and silently skipped if a provider is already registered or
  * its constructor throws.
  *
  * @module avatar
  */
+import { MEDIA_HANDLER_CATALOG } from "../factories/mediaHandlerCatalog.js";
 import { logger } from "../utils/logger.js";
 import { AvatarProcessor } from "../utils/avatarProcessor.js";
 export { AVATAR_ERROR_CODES, AvatarError, AvatarProcessor, } from "../utils/avatarProcessor.js";
@@ -29,15 +33,20 @@ export { ReplicateAvatar, ReplicateAvatar as ReplicateAvatarHandler, } from "./p
 import { DIDAvatar } from "./providers/DIDAvatar.js";
 import { HeyGenAvatar } from "./providers/HeyGenAvatar.js";
 import { ReplicateAvatar } from "./providers/ReplicateAvatar.js";
-const AVATAR_HANDLER_CANDIDATES = [
-    { name: "d-id", factory: () => new DIDAvatar() },
-    { name: "heygen", factory: () => new HeyGenAvatar() },
-    {
-        name: "replicate",
-        aliases: ["musetalk"],
-        factory: () => new ReplicateAvatar(),
-    },
-];
+// Provider names + aliases are the Task-8 catalog's job — only the factory
+// (which needs the imported handler class) stays local to this module.
+const AVATAR_HANDLER_FACTORIES = {
+    "d-id": () => new DIDAvatar(),
+    heygen: () => new HeyGenAvatar(),
+    replicate: () => new ReplicateAvatar(),
+};
+const AVATAR_HANDLER_CANDIDATES = MEDIA_HANDLER_CATALOG.filter((entry) => entry.kind === "avatar").map((entry) => {
+    const factory = AVATAR_HANDLER_FACTORIES[entry.name];
+    if (!factory) {
+        throw new Error(`[avatar] no handler factory for catalog entry "${entry.name}"`);
+    }
+    return { name: entry.name, aliases: entry.aliases, factory };
+});
 /**
  * Register every shipped avatar handler whose backing credentials are
  * present in the environment. Safe to call multiple times — existing
@@ -79,7 +88,3 @@ export function registerDefaultAvatarHandlers() {
         }
     }
 }
-// Run once at module import so consumers who follow the documented
-// `nl.generate(...)` flow get every configured handler without manually
-// calling `registerHandler`.
-registerDefaultAvatarHandlers();