> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spreadjam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# NodeRegistry

> Manage node definitions -- register, query, validate, and execute nodes.

## Overview

`NodeRegistry` manages all node definitions. It's generic over node type strings for type-safe lookups.

```typescript theme={null}
import { NodeRegistry } from '@jam-nodes/core';

const registry = new NodeRegistry();
```

You can optionally constrain type strings:

```typescript theme={null}
const registry = new NodeRegistry<'conditional' | 'end' | 'custom'>();
```

## Methods

### register

Register a single node definition. Throws if the type is already registered.

```typescript theme={null}
register<TInput, TOutput>(definition: NodeDefinition<TInput, TOutput>): this
```

### registerAll

Register multiple nodes at once.

```typescript theme={null}
registerAll(definitions: NodeDefinition[]): this
```

```typescript theme={null}
import { builtInNodes } from '@jam-nodes/nodes';
registry.registerAll(builtInNodes);
```

### unregister

Remove a registered node type. Returns `true` if it existed.

```typescript theme={null}
unregister(type: string): boolean
```

### has

Check if a type is registered.

```typescript theme={null}
has(type: string): boolean
```

### getDefinition

Get the full definition including executor.

```typescript theme={null}
getDefinition(type: string): NodeDefinition | undefined
```

### getMetadata

Get client-safe metadata (no executor). Safe to send to the browser.

```typescript theme={null}
getMetadata(type: string): NodeMetadata | undefined
```

### getExecutor

Get just the executor function.

```typescript theme={null}
getExecutor(type: string): NodeExecutor | undefined
```

### getNodeTypes

Get all registered type identifiers.

```typescript theme={null}
getNodeTypes(): string[]
```

### getAllDefinitions / getAllMetadata

```typescript theme={null}
getAllDefinitions(): NodeDefinition[]
getAllMetadata(): NodeMetadata[]
```

### getByCategory / getMetadataByCategory

Filter definitions or metadata by category.

```typescript theme={null}
getByCategory(category: NodeCategory): NodeDefinition[]
getMetadataByCategory(category: NodeCategory): NodeMetadata[]
```

### validateInput / validateOutput

Validate data against a node's Zod schema. Throws `ZodError` on failure.

```typescript theme={null}
validateInput<TInput>(type: string, input: unknown): TInput
validateOutput<TOutput>(type: string, output: unknown): TOutput
```

### size

```typescript theme={null}
get size(): number
```

## Example

```typescript theme={null}
const registry = new NodeRegistry();
registry.registerAll(builtInNodes);

const def = registry.getDefinition('conditional');
const executor = registry.getExecutor('filter');
const logicNodes = registry.getByCategory('logic');
const validated = registry.validateInput('delay', { durationMs: 5000 });

console.log(registry.size); // 16
```

## Factory Function

`createRegistry<TNodeType>()` creates a new empty `NodeRegistry`.

```typescript theme={null}
import { createRegistry } from '@jam-nodes/core';
const registry = createRegistry();
```