foon-sdk 1.0.0

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+export { ErrorCategory, FONError } from './errors.types';
+export type { SecurityOptions, InputValidationResult } from './security.types';
+export type { NormalizedSchema, SchemaField, SchemaAdapter, ValidationResult, ValidationError, } from './schema.types';
+export type { MappingPlan, Assignment, Drop, Warning } from './mapping.types';
+export type { Cache, CachedMappingPlan, CacheMetadata } from './cache.types';
+export type { Provider, ProposalOptions, ProviderConfig, ProviderMetrics, } from './provider.types';
+export type { TraceReport, Timings, ExecutionTrace, AssignmentTrace, RejectedAssignment, Conflict, ValidationTrace, CacheTrace, ConfidenceSummary, } from './trace.types';
+export type { Mode, TransformOptions, TransformResult, TransformHooks } from './transform.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAGzD,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG/E,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG9E,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG7E,YAAY,EACV,QAAQ,EACR,eAAe,EACf,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,OAAO,EACP,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,UAAU,EACV,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,IAAI,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FONError = exports.ErrorCategory = void 0;
+// Error types
+var errors_types_1 = require("./errors.types");
+Object.defineProperty(exports, "ErrorCategory", { enumerable: true, get: function () { return errors_types_1.ErrorCategory; } });
+Object.defineProperty(exports, "FONError", { enumerable: true, get: function () { return errors_types_1.FONError; } });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,+CAAyD;AAAhD,6GAAA,aAAa,OAAA;AAAE,wGAAA,QAAQ,OAAA"}

package/dist/types/mapping.types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Mapping plan returned by LLM provider
+ * This is the core data structure that drives transformation
+ */
+export interface MappingPlan {
+    /** Field assignments from input to target schema */
+    assignments: Assignment[];
+    /** Fields to drop (not in schema) */
+    drops: Drop[];
+    /** Warnings about potential issues */
+    warnings: Warning[];
+}
+/**
+ * Single field mapping assignment
+ */
+export interface Assignment {
+    /** Source JSONPath in input */
+    from: string;
+    /** Target JSONPath in output */
+    to: string;
+    /** Confidence score (0..1) */
+    confidence: number;
+    /** Optional type transformation hint */
+    transform?: string;
+}
+/**
+ * Field to be dropped
+ */
+export interface Drop {
+    /** JSONPath of dropped field */
+    path: string;
+    /** Reason for dropping */
+    reason: string;
+    /** Confidence in drop decision */
+    confidence: number;
+}
+/**
+ * Warning about input data
+ */
+export interface Warning {
+    /** Warning message */
+    message: string;
+    /** Confidence in warning */
+    confidence: number;
+    /** Optional context */
+    context?: string;
+}
+//# sourceMappingURL=mapping.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.types.d.ts","sourceRoot":"","sources":["../../src/types/mapping.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,WAAW,EAAE,UAAU,EAAE,CAAC;IAE1B,qCAAqC;IACrC,KAAK,EAAE,IAAI,EAAE,CAAC;IAEd,sCAAsC;IACtC,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IAEX,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IAEnB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IAEf,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/mapping.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mapping.types.js.map

package/dist/types/mapping.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.types.js","sourceRoot":"","sources":["../../src/types/mapping.types.ts"],"names":[],"mappings":""}

package/dist/types/provider.types.d.ts

@@ -0,0 +1,62 @@
+import { MappingPlan } from './mapping.types';
+import { NormalizedSchema } from './schema.types';
+import { SecurityOptions } from './security.types';
+/**
+ * Provider interface for LLM integration
+ */
+export interface Provider {
+    /** Provider name (e.g., "gemini", "openai") */
+    readonly name: string;
+    /** Prompt version for cache key */
+    readonly promptVersion: string;
+    /**
+     * Generate a mapping plan from input to schema
+     */
+    proposeMappingPlan(input: unknown, schema: NormalizedSchema, options: ProposalOptions): Promise<MappingPlan>;
+}
+/**
+ * Options for mapping plan proposal
+ */
+export interface ProposalOptions {
+    /** Confidence threshold to inform the LLM */
+    confidenceThreshold: number;
+    /** Security settings */
+    security: SecurityOptions;
+    /** Optional schema description for context */
+    schemaDescription?: string;
+}
+/**
+ * Base provider configuration
+ */
+export interface ProviderConfig {
+    /** API key for the provider (optional for local providers like Ollama) */
+    apiKey?: string;
+    /** Model name/ID (provider-specific) */
+    model?: string;
+    /** Base URL for API (optional, uses provider default) */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Max retries for network errors (default: 3, not for LLM failures) */
+    maxRetries?: number;
+}
+/**
+ * Provider metrics for observability
+ */
+export interface ProviderMetrics {
+    /** Provider name */
+    provider: string;
+    /** Model used */
+    model: string;
+    /** Request duration in ms */
+    duration: number;
+    /** Token usage if available */
+    tokens?: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    /** Whether request hit cache */
+    cached: boolean;
+}
+//# sourceMappingURL=provider.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.types.d.ts","sourceRoot":"","sources":["../../src/types/provider.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,mCAAmC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,kBAAkB,CAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,mBAAmB,EAAE,MAAM,CAAC;IAE5B,wBAAwB;IACxB,QAAQ,EAAE,eAAe,CAAC;IAE1B,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IAEjB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,+BAA+B;IAC/B,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/types/provider.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=provider.types.js.map

package/dist/types/provider.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.types.js","sourceRoot":"","sources":["../../src/types/provider.types.ts"],"names":[],"mappings":""}

package/dist/types/schema.types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Normalized schema representation
+ */
+export interface NormalizedSchema {
+    /** Schema version or hash for cache key generation */
+    version: string;
+    /** List of all fields in the schema */
+    fields: SchemaField[];
+    /** Original JSON Schema object */
+    raw: object;
+}
+/**
+ * Individual field in normalized schema
+ */
+export interface SchemaField {
+    /** JSONPath to the field (e.g., "$.name.given") */
+    path: string;
+    /** JSON Schema type(s) */
+    type: string | string[];
+    /** Whether field is required */
+    required: boolean;
+    /** Field description (helps LLM mapping) */
+    description?: string;
+    /** Format constraint (e.g., "email", "date-time") */
+    format?: string;
+    /** Enum values if applicable */
+    enum?: unknown[];
+    /** Default value if applicable */
+    default?: unknown;
+    /** Additional schema properties */
+    [key: string]: unknown;
+}
+/**
+ * Schema adapter interface
+ */
+export interface SchemaAdapter {
+    /** Get the normalized schema */
+    getNormalizedSchema(): NormalizedSchema;
+    /** List all fields */
+    listFields(): SchemaField[];
+    /** Get a specific field by path */
+    getField(path: string): SchemaField | undefined;
+    /** Check if a path is required */
+    isRequired(path: string): boolean;
+    /** Validate a payload against the schema */
+    validate(payload: unknown): ValidationResult;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Individual validation error
+ */
+export interface ValidationError {
+    /** JSONPath where error occurred */
+    path: string;
+    /** Error message */
+    message: string;
+    /** AJV keyword that failed */
+    keyword?: string;
+    /** Additional error parameters */
+    params?: object;
+}
+//# sourceMappingURL=schema.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.types.d.ts","sourceRoot":"","sources":["../../src/types/schema.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,gCAAgC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAElB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IAEjB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,mCAAmC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,mBAAmB,IAAI,gBAAgB,CAAC;IAExC,sBAAsB;IACtB,UAAU,IAAI,WAAW,EAAE,CAAC;IAE5B,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAEhD,kCAAkC;IAClC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/schema.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.types.js.map

package/dist/types/schema.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.types.js","sourceRoot":"","sources":["../../src/types/schema.types.ts"],"names":[],"mappings":""}

package/dist/types/security.types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Security options for input validation and sanitization
+ */
+export interface SecurityOptions {
+    /** Maximum input size in bytes (default: 1MB) */
+    maxInputSize?: number;
+    /** Maximum nesting depth (default: 10) */
+    maxDepth?: number;
+    /** Maximum number of keys (default: 1000) */
+    maxKeys?: number;
+    /** Maximum string length for prompt inclusion (default: 10000) */
+    maxStringLength?: number;
+    /** Keys to redact (default: ['password', 'token', 'authorization', 'secret', 'apiKey', 'apiSecret']) */
+    redactKeys?: string[];
+    /** Enable prompt sanitization to mitigate prompt injection (default: true) */
+    sanitizePrompt?: boolean;
+    /** Include sample values in LLM prompt (default: false for security) */
+    includeValues?: boolean;
+}
+/**
+ * Input validation result
+ */
+export interface InputValidationResult {
+    valid: boolean;
+    errors: string[];
+    stats?: {
+        size: number;
+        depth: number;
+        keys: number;
+    };
+}
+//# sourceMappingURL=security.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"security.types.d.ts","sourceRoot":"","sources":["../../src/types/security.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}

package/dist/types/security.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=security.types.js.map

package/dist/types/security.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.types.js","sourceRoot":"","sources":["../../src/types/security.types.ts"],"names":[],"mappings":""}

package/dist/types/trace.types.d.ts

@@ -0,0 +1,129 @@
+import { Assignment, Drop, Warning, MappingPlan } from './mapping.types';
+import { ValidationError } from './schema.types';
+/**
+ * Complete trace report for a transformation
+ */
+export interface TraceReport {
+    /** Unique trace ID */
+    traceId: string;
+    /** Transformation mode */
+    mode: 'SEMANTIC';
+    /** Provider used */
+    provider: string;
+    /** Prompt version */
+    promptVersion: string;
+    /** Timing information */
+    timings: Timings;
+    /** Mapping plan (raw and parsed) */
+    mappingPlan: {
+        raw: string;
+        parsed: MappingPlan;
+    };
+    /** Execution details */
+    execution: ExecutionTrace;
+    /** Validation details */
+    validation: ValidationTrace;
+    /** Cache details */
+    cache: CacheTrace;
+    /** Confidence statistics */
+    confidenceSummary: ConfidenceSummary;
+}
+/**
+ * Timing breakdown
+ */
+export interface Timings {
+    /** Total transformation time (ms) */
+    total: number;
+    /** Time to get mapping plan (ms) */
+    proposal: number;
+    /** Time to execute plan (ms) */
+    execution: number;
+    /** Time to validate output (ms) */
+    validation: number;
+}
+/**
+ * Execution trace details
+ */
+export interface ExecutionTrace {
+    /** Successfully applied assignments */
+    assignmentsApplied: AssignmentTrace[];
+    /** Rejected assignments */
+    assignmentsRejected: RejectedAssignment[];
+    /** Fields that were dropped */
+    droppedFields: Drop[];
+    /** Warnings generated */
+    warnings: Warning[];
+    /** Conflicts detected */
+    conflicts: Conflict[];
+}
+/**
+ * Trace of a single applied assignment
+ */
+export interface AssignmentTrace {
+    /** The assignment */
+    assignment: Assignment;
+    /** Value from source */
+    fromValue: unknown;
+    /** Value written to target */
+    toValue: unknown;
+    /** Whether type transformation was applied */
+    transformed: boolean;
+}
+/**
+ * Rejected assignment details
+ */
+export interface RejectedAssignment {
+    /** The rejected assignment */
+    assignment: Assignment;
+    /** Reason for rejection */
+    reason: 'CONFIDENCE_TOO_LOW' | 'INVALID_PATH' | 'TYPE_MISMATCH';
+    /** Additional details */
+    details?: string;
+}
+/**
+ * Mapping conflict
+ */
+export interface Conflict {
+    /** Target path with conflict */
+    targetPath: string;
+    /** Source paths causing conflict */
+    sources: string[];
+    /** How conflict was resolved */
+    resolution: 'FIRST_WINS' | 'LAST_WINS' | 'FAILED';
+}
+/**
+ * Validation trace
+ */
+export interface ValidationTrace {
+    /** Whether validation succeeded */
+    success: boolean;
+    /** Validation errors if any */
+    errors: ValidationError[];
+}
+/**
+ * Cache trace
+ */
+export interface CacheTrace {
+    /** Whether cache was hit */
+    hit: boolean;
+    /** Cache key used */
+    key: string;
+    /** TTL if cache was set */
+    ttl?: number;
+}
+/**
+ * Confidence statistics summary
+ */
+export interface ConfidenceSummary {
+    /** Minimum confidence in applied assignments */
+    min: number;
+    /** Maximum confidence in applied assignments */
+    max: number;
+    /** Average confidence in applied assignments */
+    avg: number;
+    /** Number of assignments below threshold */
+    countBelowThreshold: number;
+    /** Configured threshold */
+    threshold: number;
+}
+//# sourceMappingURL=trace.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.types.d.ts","sourceRoot":"","sources":["../../src/types/trace.types.ts"],"names":[],"mappings":"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"}

package/dist/types/trace.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=trace.types.js.map

package/dist/types/trace.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.types.js","sourceRoot":"","sources":["../../src/types/trace.types.ts"],"names":[],"mappings":""}

package/dist/types/transform.types.d.ts

@@ -0,0 +1,56 @@
+import { Provider, ProviderMetrics } from './provider.types';
+import { SchemaAdapter } from './schema.types';
+import { SecurityOptions } from './security.types';
+import { Cache } from './cache.types';
+import { TraceReport } from './trace.types';
+import { FONError } from './errors.types';
+/**
+ * Transformation mode
+ */
+export type Mode = 'SEMANTIC';
+/**
+ * Transform options
+ */
+export interface TransformOptions {
+    /** Transformation mode (default: SEMANTIC) */
+    mode?: Mode;
+    /** Target JSON Schema (object or SchemaAdapter instance) */
+    schema: object | SchemaAdapter;
+    /** LLM provider instance (required) */
+    provider: Provider;
+    /** Confidence threshold (default: 0.85) */
+    confidenceThreshold?: number;
+    /** Cache instance (optional, in-memory LRU by default) */
+    cache?: Cache;
+    /** Enable verbose trace output (default: false) */
+    verbose?: boolean;
+    /** Security options */
+    security?: SecurityOptions;
+    /** Optional hooks for observability */
+    hooks?: TransformHooks;
+}
+/**
+ * Transform result
+ */
+export interface TransformResult {
+    /** Whether transformation succeeded */
+    ok: boolean;
+    /** Transformed output (schema-valid JSON) if successful */
+    output?: unknown;
+    /** Error if transformation failed */
+    error?: FONError;
+    /** Trace report (always present) */
+    trace: TraceReport;
+}
+/**
+ * Hooks for observability
+ */
+export interface TransformHooks {
+    /** Called when trace is complete */
+    onTrace?: (trace: TraceReport) => void;
+    /** Called on error */
+    onError?: (error: FONError, traceId: string) => void;
+    /** Called after provider request */
+    onProviderCall?: (metrics: ProviderMetrics) => void;
+}
+//# sourceMappingURL=transform.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform.types.d.ts","sourceRoot":"","sources":["../../src/types/transform.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,UAAU,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,4DAA4D;IAC5D,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;IAE/B,uCAAuC;IACvC,QAAQ,EAAE,QAAQ,CAAC;IAEnB,2CAA2C;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B,uCAAuC;IACvC,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,EAAE,EAAE,OAAO,CAAC;IAEZ,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAEjB,oCAAoC;IACpC,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAEvC,sBAAsB;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAErD,oCAAoC;IACpC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;CACrD"}

package/dist/types/transform.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=transform.types.js.map

package/dist/types/transform.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.types.js","sourceRoot":"","sources":["../../src/types/transform.types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,107 @@
+{
+  "name": "foon-sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for semantic JSON transformation using LLMs - transforms free-form JSON to schema-compliant JSON",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./express": {
+      "types": "./dist/express/index.d.ts",
+      "import": "./dist/express/index.js",
+      "require": "./dist/express/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "test": "jest --testPathIgnorePatterns=e2e",
+    "test:all": "jest",
+    "test:publish": "npm run test",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:unit": "jest --testPathPattern=unit",
+    "test:integration": "jest --testPathPattern=integration",
+    "test:e2e": "jest --testPathPattern=e2e",
+    "lint": "eslint src/**/*.ts tests/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts tests/**/*.ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "clean": "rimraf dist",
+    "prebuild": "npm run clean",
+    "prepublishOnly": "npm run build && npm run test:publish",
+    "example:basic": "ts-node examples/basic-usage.ts",
+    "example:express": "ts-node examples/express-crud-app.ts"
+  },
+  "keywords": [
+    "json",
+    "schema",
+    "transformation",
+    "llm",
+    "semantic",
+    "mapping",
+    "validation",
+    "adapter",
+    "express",
+    "middleware"
+  ],
+  "author": "Achraf Achkari",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/achachraf/foon-sdk.git"
+  },
+  "homepage": "https://foon.ink",
+  "bugs": {
+    "url": "https://github.com/achachraf/foon-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ajv": "^8.12.0",
+    "ajv-formats": "^3.0.1",
+    "jsonpath-plus": "^7.2.0",
+    "lru-cache": "^10.0.0",
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@types/supertest": "^6.0.2",
+    "@types/uuid": "^9.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "dotenv": "^16.3.1",
+    "eslint": "^8.55.0",
+    "express": "^4.18.2",
+    "jest": "^29.7.0",
+    "prettier": "^3.1.0",
+    "rimraf": "^5.0.5",
+    "supertest": "^6.3.3",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}