@relazio/plugin-sdk 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,96 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2025-12-22
+
+### Added
+- **Universal Entity Builder**: Complete builder system for creating entities and edges
+  - `createEntity()` - Universal, scalable function for creating any entity type (present or future)
+  - `EntityBuilder` - Fluent builder for advanced entity construction
+  - `createEdge()` - Edge creation function with validation
+  - `EdgeBuilder` - Fluent builder for complex edges
+- **Automatic ID Generation**: Deterministic ID generation system
+  - `generateEntityId()` - MD5 hash-based deterministic entity IDs
+  - `generateEdgeId()` - Deterministic edge IDs
+  - `generateRandomId()` - Random IDs for temporary entities
+  - `normalizeValue()` - Value normalization for ID consistency
+- **ResultBuilder**: Fluent builder for transform results
+  - `.addEntity()` - Add entity with automatic edge creation
+  - `.addEntities()` - Add multiple entities of the same type
+  - `.addEntityOnly()` - Add entity without edge
+  - `.setMessage()` - Set success message
+  - `.addMetadata()` - Add metadata to result
+- **Helper Functions**: Utility functions for common cases
+  - `emptyResult()` - Empty result with optional message
+  - `errorResult()` - Error result
+  - `singleEntityResult()` - Single entity result
+  - `multiEntityResult()` - Multiple entity result
+- **Validation Utilities**: Automatic format validation
+  - `validateEntities()` - Validate entity array
+  - `validateEdges()` - Validate edge array
+  - `validateTransformResult()` - Validate complete result
+- **Documentation**: Complete documentation and examples
+  - Quick Start Guide
+  - Builders Guide
+  - Response Format Specification
+  - New comprehensive example: `simple-sync-example`
+  - Updated async example: `async-subdomain-scanner`
+
+### Changed
+- **BREAKING**: `OSINTEntity` now requires mandatory `id` field
+- **BREAKING**: `OSINTEdge` now requires mandatory `id` field
+- **BREAKING**: Removed support for `targetId: 'auto'` in edges
+- **Scalability Improvement**: Removed type-specific helpers in favor of universal `createEntity()`
+  - Advantage: No SDK updates needed for new entity types
+  - Advantage: Supports custom entity types without code changes
+  - Advantage: Consistent, predictable API
+- Updated all entity types to align with Relazio external format
+- Added new entity types: `username`, `credential`, `social`, `document`, `image`, `video`, `wallet`, `transaction`, `exchange`, `maps`
+- `TransformInput.entity` is now of type `OSINTEntity` (includes ID)
+- Updated examples to use scalable approach
+- Reorganized documentation to `docs/` folder
+- All documentation rewritten in formal English
+
+### Removed
+- Type-specific helper functions (`createIP`, `createDomain`, etc.) - replaced with universal `createEntity()`
+- Migration guide (not needed for initial release)
+
+### Fixed
+- Automatic format validation for responses
+- Guaranteed unique IDs for all entities and edges
+- Consistent field naming (only `metadata`, not `properties`)
+
+## [0.1.1] - 2025-12-20
+
+### Changed
+- Simplified documentation
+- Translated documentation to English
+- Made documentation more formal and concise
+
+### Fixed
+- HTTP localhost support for development (manifest generator)
+
+## [0.1.0] - 2025-12-20
+
+### Added
+- Initial public release
+- Multi-tenant support with automatic organization management
+- Synchronous and asynchronous transform handlers
+- Built-in Express server with CORS and error handling
+- Automatic `/register`, `/unregister`, `/manifest.json` endpoints
+- HMAC-SHA256 signature utilities for webhook security
+- Job progress tracking for async operations
+- InstallationRegistry for organization management
+- In-memory storage (development) and custom storage support (production)
+- TypeScript support with full type definitions
+- Working examples (email-parser, dns-toolkit, async-subdomain-scanner, multi-tenant-plugin)
+
+### Security
+- HMAC-SHA256 webhook signatures
+- Organization isolation
+- Unique webhook secrets per organization
+- TLS certificate validation

package/README.md

@@ -7,7 +7,7 @@ Official SDK for building external plugins for the Relazio OSINT platform.
 
 ## Overview
 
-The Relazio Plugin SDK enables developers to create external plugins that extend the Relazio platform's capabilities. The SDK provides a complete framework for building secure, multi-tenant plugins with minimal boilerplate code.
+The Relazio Plugin SDK provides a complete framework for building secure, scalable external plugins that extend the Relazio platform's capabilities with minimal boilerplate.
 
 ## Features
 
@@ -17,6 +17,10 @@ The Relazio Plugin SDK enables developers to create external plugins that extend
 - **Security**: HMAC-SHA256 signature generation and validation
 - **Job Management**: Progress tracking and webhook notifications for async operations
 - **TypeScript**: Full type safety and IntelliSense support
+- **Scalable Entity Creation**: Universal `createEntity()` function works with any entity type
+- **Automatic ID Generation**: Deterministic ID generation for entities and edges
+- **Result Builder**: Fluent API for constructing complex transform results
+- **Automatic Validation**: Format validation according to Relazio specifications
 
 ## Installation
 
@@ -27,7 +31,7 @@ npm install @relazio/plugin-sdk
 ## Quick Start
 
 ```typescript
-import { RelazioPlugin } from '@relazio/plugin-sdk';
+import { RelazioPlugin, createEntity, ResultBuilder } from '@relazio/plugin-sdk';
 
 const plugin = new RelazioPlugin({
   id: 'my-plugin',
@@ -45,15 +49,20 @@ plugin.transform({
   inputType: 'domain',
   outputTypes: ['ip'],
   
-  async handler(input, config) {
-    return {
-      entities: [{
-        type: 'ip',
-        value: '8.8.8.8',
-        label: 'Google DNS'
-      }],
-      edges: []
-    };
+  async handler(input) {
+    // Create entity using universal createEntity()
+    const ip = createEntity('ip', '8.8.8.8', {
+      label: 'Google DNS',
+      metadata: { country: 'US' }
+    });
+    
+    // Build result with automatic edge creation
+    return new ResultBuilder(input)
+      .addEntity(ip, 'resolves to', {
+        relationship: 'dns_resolution'
+      })
+      .setMessage('DNS resolved successfully')
+      .build();
   }
 });
 
@@ -65,9 +74,90 @@ await plugin.start({
 
 ## Documentation
 
-- [Examples](./examples/) - Working plugin examples
+- **[Quick Start Guide](./docs/quick-start.md)** - Get started in 5 minutes with sync and async examples
+- **[Builders Guide](./docs/builders-guide.md)** - Complete guide to builders and utilities
+- **[Response Format Specification](./docs/response-format.md)** - Required response format
+- **[Examples Documentation](./docs/examples.md)** - Complete working examples
+  - [simple-sync-example](./examples/simple-sync-example/) - Synchronous transform example
+  - [async-subdomain-scanner](./examples/async-subdomain-scanner/) - Asynchronous transform example
 - [Changelog](./CHANGELOG.md) - Version history
 
+## Entity & Edge Builders
+
+The SDK uses a dynamic, scalable approach that works with any entity type:
+
+### Universal Entity Creation
+
+```typescript
+import { createEntity } from '@relazio/plugin-sdk';
+
+// Works with ANY type - even future types!
+const ip = createEntity('ip', '8.8.8.8', {
+  label: 'Google DNS',
+  metadata: { country: 'US', isp: 'Google LLC' }
+});
+
+const domain = createEntity('domain', 'example.com');
+
+const location = createEntity('location', 'New York, NY', {
+  metadata: { latitude: 40.7, longitude: -74.0 }
+});
+
+// Works with custom types too!
+const customEntity = createEntity('future-entity-type', 'value', {
+  metadata: { /* ... */ }
+});
+
+// ID automatically generated: "ip-c909e98d"
+console.log(ip.id);
+```
+
+**Advantages**:
+- No SDK updates needed for new entity types
+- Works with custom entity types
+- Type-safe with TypeScript
+- Deterministic ID generation
+
+### Result Builder
+
+Build complex results easily:
+
+```typescript
+import { ResultBuilder, createEntity } from '@relazio/plugin-sdk';
+
+handler: async (input) => {
+  const location = createEntity('location', 'Mountain View, CA', {
+    metadata: { latitude: 37.386, longitude: -122.084 }
+  });
+  
+  const org = createEntity('organization', 'Google LLC', {
+    metadata: { asn: 'AS15169' }
+  });
+  
+  // Edges created automatically!
+  return new ResultBuilder(input)
+    .addEntity(location, 'located in', {
+      relationship: 'geolocation'
+    })
+    .addEntity(org, 'assigned by', {
+      relationship: 'isp_assignment'
+    })
+    .setMessage('IP analyzed successfully')
+    .build();
+}
+```
+
+### Supported Entity Types
+
+```typescript
+type EntityType = 
+  | 'email' | 'domain' | 'ip' | 'person' | 'username' 
+  | 'phone' | 'organization' | 'hash' | 'credential'
+  | 'social' | 'document' | 'note' | 'image' | 'video'
+  | 'location' | 'wallet' | 'transaction' | 'exchange'
+  | 'url' | 'maps' | 'custom';
+```
+
 ## Multi-Tenant Architecture
 
 The SDK automatically handles organization registration and management:
@@ -141,6 +231,24 @@ await plugin.stop()
 - Node.js >= 18.0.0
 - TypeScript >= 5.0.0 (for development)
 
+## Examples
+
+### Synchronous Transform
+
+```bash
+cd examples/simple-sync-example
+npm install
+npm start
+```
+
+### Asynchronous Transform
+
+```bash
+cd examples/async-subdomain-scanner
+npm install
+npm start
+```
+
 ## License
 
 MIT License - see [LICENSE](./LICENSE) file for details.
@@ -150,3 +258,4 @@ MIT License - see [LICENSE](./LICENSE) file for details.
 - [npm Package](https://www.npmjs.com/package/@relazio/plugin-sdk)
 - [GitHub Repository](https://github.com/relazio/plugin-sdk)
 - [Issue Tracker](https://github.com/relazio/plugin-sdk/issues)
+- [Documentation](./docs/)

package/dist/core/types.d.ts

@@ -1,35 +1,35 @@
 /**
  * Tipi core per Relazio Plugin SDK
  */
-export type EntityType = 'domain' | 'ip' | 'email' | 'phone' | 'person' | 'organization' | 'location' | 'note' | 'url' | 'hash' | 'custom';
+export type EntityType = 'email' | 'domain' | 'ip' | 'person' | 'username' | 'phone' | 'organization' | 'hash' | 'credential' | 'social' | 'document' | 'note' | 'image' | 'video' | 'location' | 'wallet' | 'transaction' | 'exchange' | 'url' | 'maps' | 'custom';
 export type PluginCategory = 'network' | 'identity' | 'social' | 'financial' | 'security' | 'other';
 export type JobStatus = 'pending' | 'submitted' | 'processing' | 'completed' | 'failed' | 'timeout' | 'cancelled';
 /**
- * Entità OSINT
+ * Entità OSINT (formato esterno - con ID obbligatorio)
  */
 export interface OSINTEntity {
+    id: string;
     type: EntityType;
     value: string;
     label?: string;
     metadata?: Record<string, any>;
 }
 /**
- * Arco/connessione tra entità
+ * Arco/connessione tra entità (formato esterno)
  */
 export interface OSINTEdge {
+    id: string;
     sourceId: string;
-    targetId: string | 'auto';
+    targetId: string;
     label: string;
-    relationship: string;
+    relationship?: string;
     metadata?: Record<string, any>;
 }
 /**
  * Input per una transform
  */
 export interface TransformInput {
-    entity: OSINTEntity & {
-        id: string;
-    };
+    entity: OSINTEntity;
     config?: Record<string, any>;
     organizationId?: string;
 }

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,IAAI,GACJ,OAAO,GACP,OAAO,GACP,QAAQ,GACR,cAAc,GACd,UAAU,GACV,MAAM,GACN,KAAK,GACL,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,UAAU,GACV,QAAQ,GACR,WAAW,GACX,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,WAAW,GACX,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,SAAS,GACT,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,UAAU,CAAC;IACtB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,UAAU,CAAC;IACtB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KACxB,OAAO,CAAC,eAAe,CAAC,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,EAAE,UAAU,KACZ,OAAO,CAAC,eAAe,CAAC,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,cAAc,CAAC;QACzB,YAAY,EAAE;YACZ,UAAU,EAAE,UAAU,EAAE,CAAC;YACzB,WAAW,EAAE,UAAU,EAAE,CAAC;YAC1B,aAAa,EAAE,MAAM,CAAC;YACtB,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC;QACF,aAAa,CAAC,EAAE;YACd,QAAQ,EAAE,OAAO,CAAC;YAClB,MAAM,EAAE,YAAY,CAAC;SACtB,CAAC;QACF,UAAU,EAAE,KAAK,CAAC;YAChB,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,EAAE,UAAU,CAAC;YACtB,WAAW,EAAE,UAAU,EAAE,CAAC;YAC1B,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,KAAK,EAAE,OAAO,CAAC;SAChB,CAAC,CAAC;QACH,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,EAAE,CAAC;YACf,sBAAsB,EAAE,MAAM,CAAC;SAChC,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -12,4 +12,7 @@ export { InstallationRegistry, MemoryStorage } from './registry/installation';
 export type { Installation, RegistrationRequest, RegistrationResponse, InstallationStorage } from './registry/installation';
 export { ExpressServer } from './server/express';
 export type { Server } from './server/express';
+export { createEntity, createEdge, EntityBuilder, EdgeBuilder, validateEntities, validateEdges, validateTransformResult, } from './utils/builders';
+export { generateEntityId, generateEdgeId, generateRandomId, normalizeValue, isValidEntityId, isValidEdgeId, } from './utils/id-generator';
+export { ResultBuilder, emptyResult, errorResult, singleEntityResult, multiEntityResult, } from './utils/result-builder';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,YAAY,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,SAAS,EACT,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACvF,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG7D,OAAO,EACL,oBAAoB,EACpB,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,YAAY,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,SAAS,EACT,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACvF,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG7D,OAAO,EACL,oBAAoB,EACpB,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAEL,YAAY,EACZ,UAAU,EACV,aAAa,EACb,WAAW,EAEX,gBAAgB,EAChB,aAAa,EACb,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,aAAa,EACb,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -4,7 +4,7 @@
  * SDK ufficiale per creare plugin esterni per Relazio
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExpressServer = exports.MemoryStorage = exports.InstallationRegistry = exports.InMemorySecretProvider = exports.JobQueue = exports.JobProgressTracker = exports.verifyWebhookSignature = exports.HMACUtils = exports.ManifestGenerator = exports.OSINTPlugin = exports.RelazioPlugin = void 0;
+exports.multiEntityResult = exports.singleEntityResult = exports.errorResult = exports.emptyResult = exports.ResultBuilder = exports.isValidEdgeId = exports.isValidEntityId = exports.normalizeValue = exports.generateRandomId = exports.generateEdgeId = exports.generateEntityId = exports.validateTransformResult = exports.validateEdges = exports.validateEntities = exports.EdgeBuilder = exports.EntityBuilder = exports.createEdge = exports.createEntity = exports.ExpressServer = exports.MemoryStorage = exports.InstallationRegistry = exports.InMemorySecretProvider = exports.JobQueue = exports.JobProgressTracker = exports.verifyWebhookSignature = exports.HMACUtils = exports.ManifestGenerator = exports.OSINTPlugin = exports.RelazioPlugin = void 0;
 // Core exports
 var plugin_1 = require("./core/plugin");
 Object.defineProperty(exports, "RelazioPlugin", { enumerable: true, get: function () { return plugin_1.RelazioPlugin; } });
@@ -27,3 +27,29 @@ Object.defineProperty(exports, "MemoryStorage", { enumerable: true, get: functio
 // Server
 var express_1 = require("./server/express");
 Object.defineProperty(exports, "ExpressServer", { enumerable: true, get: function () { return express_1.ExpressServer; } });
+// Utils - Entity & Edge Builders
+var builders_1 = require("./utils/builders");
+// Core builders (scalabili e dinamici)
+Object.defineProperty(exports, "createEntity", { enumerable: true, get: function () { return builders_1.createEntity; } });
+Object.defineProperty(exports, "createEdge", { enumerable: true, get: function () { return builders_1.createEdge; } });
+Object.defineProperty(exports, "EntityBuilder", { enumerable: true, get: function () { return builders_1.EntityBuilder; } });
+Object.defineProperty(exports, "EdgeBuilder", { enumerable: true, get: function () { return builders_1.EdgeBuilder; } });
+// Validazione
+Object.defineProperty(exports, "validateEntities", { enumerable: true, get: function () { return builders_1.validateEntities; } });
+Object.defineProperty(exports, "validateEdges", { enumerable: true, get: function () { return builders_1.validateEdges; } });
+Object.defineProperty(exports, "validateTransformResult", { enumerable: true, get: function () { return builders_1.validateTransformResult; } });
+// Utils - ID Generation
+var id_generator_1 = require("./utils/id-generator");
+Object.defineProperty(exports, "generateEntityId", { enumerable: true, get: function () { return id_generator_1.generateEntityId; } });
+Object.defineProperty(exports, "generateEdgeId", { enumerable: true, get: function () { return id_generator_1.generateEdgeId; } });
+Object.defineProperty(exports, "generateRandomId", { enumerable: true, get: function () { return id_generator_1.generateRandomId; } });
+Object.defineProperty(exports, "normalizeValue", { enumerable: true, get: function () { return id_generator_1.normalizeValue; } });
+Object.defineProperty(exports, "isValidEntityId", { enumerable: true, get: function () { return id_generator_1.isValidEntityId; } });
+Object.defineProperty(exports, "isValidEdgeId", { enumerable: true, get: function () { return id_generator_1.isValidEdgeId; } });
+// Utils - Result Builder
+var result_builder_1 = require("./utils/result-builder");
+Object.defineProperty(exports, "ResultBuilder", { enumerable: true, get: function () { return result_builder_1.ResultBuilder; } });
+Object.defineProperty(exports, "emptyResult", { enumerable: true, get: function () { return result_builder_1.emptyResult; } });
+Object.defineProperty(exports, "errorResult", { enumerable: true, get: function () { return result_builder_1.errorResult; } });
+Object.defineProperty(exports, "singleEntityResult", { enumerable: true, get: function () { return result_builder_1.singleEntityResult; } });
+Object.defineProperty(exports, "multiEntityResult", { enumerable: true, get: function () { return result_builder_1.multiEntityResult; } });

package/dist/utils/builders.d.ts

@@ -0,0 +1,147 @@
+import type { OSINTEntity, OSINTEdge, EntityType } from '../core/types';
+/**
+ * Crea un'entità OSINT nel formato corretto
+ * Genera automaticamente un ID deterministico se non specificato
+ *
+ * @param type - Tipo di entità
+ * @param value - Valore dell'entità (obbligatorio)
+ * @param options - Opzioni aggiuntive (label, metadata, id)
+ * @returns Entità nel formato corretto
+ *
+ * @example
+ * ```ts
+ * // Esempio semplice
+ * createEntity('ip', '8.8.8.8')
+ *
+ * // Con label e metadata
+ * createEntity('ip', '8.8.8.8', {
+ *   label: 'Google DNS',
+ *   metadata: { country: 'US', isp: 'Google LLC' }
+ * })
+ *
+ * // Con ID personalizzato
+ * createEntity('location', 'Mountain View, CA', {
+ *   id: 'custom-location-id',
+ *   metadata: { latitude: 37.386, longitude: -122.084 }
+ * })
+ * ```
+ */
+export declare function createEntity(type: EntityType, value: string, options?: {
+    id?: string;
+    label?: string;
+    metadata?: Record<string, any>;
+}): OSINTEntity;
+/**
+ * Crea un edge tra due entità nel formato corretto
+ * Genera automaticamente un ID deterministico se non specificato
+ *
+ * @param sourceId - ID dell'entità sorgente
+ * @param targetId - ID dell'entità target
+ * @param label - Label visibile dell'edge (obbligatorio)
+ * @param options - Opzioni aggiuntive (id, relationship, metadata)
+ * @returns Edge nel formato corretto
+ *
+ * @example
+ * ```ts
+ * // Esempio semplice
+ * createEdge('ip-c909e98d', 'location-a3f42bc1', 'located in')
+ *
+ * // Con relationship e metadata
+ * createEdge('ip-c909e98d', 'org-5b3c1a2d', 'assigned by', {
+ *   relationship: 'isp_assignment',
+ *   metadata: { confidence: 0.98 }
+ * })
+ *
+ * // Con ID personalizzato
+ * createEdge('node-1', 'node-2', 'related to', {
+ *   id: 'custom-edge-id'
+ * })
+ * ```
+ */
+export declare function createEdge(sourceId: string, targetId: string, label: string, options?: {
+    id?: string;
+    relationship?: string;
+    metadata?: Record<string, any>;
+}): OSINTEdge;
+/**
+ * NOTA: Gli helper specifici sono stati rimossi per rendere l'SDK più scalabile.
+ * Usa `createEntity(type, value, options)` per creare qualsiasi tipo di entità.
+ *
+ * Esempio:
+ * ```ts
+ * createEntity('ip', '8.8.8.8', { metadata: { country: 'US' } })
+ * createEntity('domain', 'example.com')
+ * createEntity('custom-type', 'value')  // Funziona anche con tipi futuri!
+ * ```
+ */
+/**
+ * Builder fluente per creare entità complesse
+ *
+ * @example
+ * ```ts
+ * const entity = EntityBuilder
+ *   .create('ip', '8.8.8.8')
+ *   .withLabel('Google DNS')
+ *   .withMetadata({ country: 'US', isp: 'Google LLC' })
+ *   .build();
+ * ```
+ */
+export declare class EntityBuilder {
+    private entity;
+    private constructor();
+    static create(type: EntityType, value: string): EntityBuilder;
+    withId(id: string): this;
+    withLabel(label: string): this;
+    withMetadata(metadata: Record<string, any>): this;
+    addMetadata(key: string, value: any): this;
+    build(): OSINTEntity;
+}
+/**
+ * Builder fluente per creare edge complessi
+ *
+ * @example
+ * ```ts
+ * const edge = EdgeBuilder
+ *   .create('ip-abc', 'location-xyz', 'located in')
+ *   .withRelationship('geolocation')
+ *   .withMetadata({ confidence: 0.98 })
+ *   .build();
+ * ```
+ */
+export declare class EdgeBuilder {
+    private edge;
+    private constructor();
+    static create(sourceId: string, targetId: string, label: string): EdgeBuilder;
+    withId(id: string): this;
+    withRelationship(relationship: string): this;
+    withMetadata(metadata: Record<string, any>): this;
+    addMetadata(key: string, value: any): this;
+    build(): OSINTEdge;
+}
+/**
+ * Helper per validare un array di entità
+ * Controlla ID duplicati e campi obbligatori
+ */
+export declare function validateEntities(entities: OSINTEntity[]): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Helper per validare un array di edge
+ * Controlla ID duplicati, campi obbligatori e riferimenti validi
+ */
+export declare function validateEdges(edges: OSINTEdge[], entities: OSINTEntity[], inputEntityId?: string): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Helper per validare una risposta completa di transform
+ */
+export declare function validateTransformResult(result: {
+    entities: OSINTEntity[];
+    edges: OSINTEdge[];
+}, inputEntityId?: string): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=builders.d.ts.map

package/dist/utils/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/utils/builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGxE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC,GACA,WAAW,CAYb;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC,GACA,SAAS,CAmBX;AAED;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuB;IAErC,OAAO;IAOP,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAI7D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKjD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAQ1C,KAAK,IAAI,WAAW;CAkBrB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAqB;IAEjC,OAAO;IAQP,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW;IAI7E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAK5C,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKjD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAQ1C,KAAK,IAAI,SAAS;CA0BnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA6B9F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAAE,EAClB,QAAQ,EAAE,WAAW,EAAE,EACvB,aAAa,CAAC,EAAE,MAAM,GACrB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA8CtC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE;IAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,EACvD,aAAa,CAAC,EAAE,MAAM,GACrB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAQtC"}