@hazeljs/rag 0.2.0-alpha.1

package/dist/agentic/decorators/self-reflective.decorator.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Self-Reflective Decorator
+ * Evaluates and iteratively improves retrieval results
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SelfReflective = SelfReflective;
+exports.getReflections = getReflections;
+require("reflect-metadata");
+const prompts_1 = require("@hazeljs/prompts");
+require("../../prompts/agentic/self-reflective.prompt");
+require("../../prompts/agentic/self-reflective-improve.prompt");
+const self_reflective_prompt_1 = require("../../prompts/agentic/self-reflective.prompt");
+const self_reflective_improve_prompt_1 = require("../../prompts/agentic/self-reflective-improve.prompt");
+const REFLECTION_METADATA_KEY = Symbol('reflection');
+function SelfReflective(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const maxIterations = config.maxIterations || 3;
+            const threshold = config.qualityThreshold || 0.8;
+            let iteration = 0;
+            let currentResult = await originalMethod.apply(this, args);
+            let bestResult = currentResult;
+            let bestQuality = 0;
+            const reflections = [];
+            while (iteration < maxIterations) {
+                iteration++;
+                // Assess quality
+                const query = args[0];
+                const quality = await assessQuality(currentResult, query, config);
+                reflections.push({
+                    originalResponse: JSON.stringify(currentResult),
+                    quality,
+                    improvements: quality.issues,
+                    iterations: iteration,
+                });
+                // Track best result
+                if (quality.score > bestQuality) {
+                    bestQuality = quality.score;
+                    bestResult = currentResult;
+                }
+                // Check if quality threshold met
+                if (quality.score >= threshold) {
+                    break;
+                }
+                // Attempt improvement
+                if (config.enableAutoImprovement && config.llmProvider) {
+                    const improved = await improveResults(currentResult, quality, query, config);
+                    if (improved) {
+                        currentResult = improved;
+                    }
+                    else {
+                        break;
+                    }
+                }
+                else {
+                    break;
+                }
+            }
+            // Store reflection metadata
+            Reflect.defineMetadata(REFLECTION_METADATA_KEY, reflections, target, propertyKey);
+            return bestResult;
+        };
+        return descriptor;
+    };
+}
+/**
+ * Assess quality of results
+ */
+async function assessQuality(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, query, config) {
+    if (config.llmProvider) {
+        return assessQualityWithLLM(results, query, config);
+    }
+    return assessQualityHeuristic(results, query);
+}
+/**
+ * LLM-based quality assessment
+ */
+async function assessQualityWithLLM(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, query, config) {
+    const resultsStr = JSON.stringify(results, null, 2);
+    const prompt = prompts_1.PromptRegistry.get(self_reflective_prompt_1.SELF_REFLECTIVE_KEY).render({ query, resultsStr: resultsStr.slice(0, 2000) });
+    try {
+        const assessment = await config.llmProvider.generateStructured(prompt, {});
+        const score = (assessment.relevance + assessment.completeness + assessment.accuracy + assessment.clarity) /
+            4;
+        return {
+            score,
+            ...assessment,
+        };
+    }
+    catch {
+        return assessQualityHeuristic(results, query);
+    }
+}
+/**
+ * Heuristic-based quality assessment
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function assessQualityHeuristic(results, query) {
+    const issues = [];
+    let relevance = 0.5;
+    let completeness = 0.5;
+    const accuracy = 0.8;
+    let clarity = 0.7;
+    // Check if results exist
+    if (!results || (Array.isArray(results) && results.length === 0)) {
+        issues.push('No results returned');
+        relevance = 0;
+        completeness = 0;
+        return { score: 0, relevance, completeness, accuracy, clarity, issues };
+    }
+    // Check result count
+    const resultCount = Array.isArray(results) ? results.length : 1;
+    if (resultCount < 3) {
+        issues.push('Few results returned');
+        completeness = 0.5;
+    }
+    else if (resultCount >= 5) {
+        completeness = 0.9;
+    }
+    // Check for query terms in results
+    const queryTerms = query.toLowerCase().split(/\s+/);
+    let matchCount = 0;
+    if (Array.isArray(results)) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        results.forEach((result) => {
+            const content = (result.content || '').toLowerCase();
+            queryTerms.forEach((term) => {
+                if (content.includes(term))
+                    matchCount++;
+            });
+        });
+        relevance = Math.min(matchCount / (queryTerms.length * resultCount), 1);
+    }
+    if (relevance < 0.3) {
+        issues.push('Low relevance to query');
+    }
+    // Check for diversity
+    if (Array.isArray(results) && results.length > 1) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const uniqueContent = new Set(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        results.map((r) => r.content?.slice(0, 100)));
+        if (uniqueContent.size < results.length * 0.7) {
+            issues.push('Low diversity in results');
+            clarity = 0.6;
+        }
+    }
+    const score = (relevance + completeness + accuracy + clarity) / 4;
+    return { score, relevance, completeness, accuracy, clarity, issues };
+}
+/**
+ * Improve results based on quality assessment
+ */
+async function improveResults(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, quality, query, config
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+    if (!config.llmProvider) {
+        return null;
+    }
+    const prompt = prompts_1.PromptRegistry.get(self_reflective_improve_prompt_1.SELF_REFLECTIVE_IMPROVE_KEY).render({
+        query,
+        issues: quality.issues.join(', '),
+        resultsStr: JSON.stringify(results, null, 2).slice(0, 1000),
+    });
+    try {
+        await config.llmProvider.generateStructured(prompt, {});
+        // Return null to indicate we should re-query with improvements
+        // The calling code would need to handle this
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get reflection metadata
+ */
+function getReflections(target, propertyKey) {
+    return Reflect.getMetadata(REFLECTION_METADATA_KEY, target, propertyKey) || [];
+}
+//# sourceMappingURL=self-reflective.decorator.js.map

package/dist/agentic/decorators/self-reflective.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-reflective.decorator.js","sourceRoot":"","sources":["../../../src/agentic/decorators/self-reflective.decorator.ts"],"names":[],"mappings":"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"}

package/dist/agentic/decorators/source-verification.decorator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Source Verification Decorator
+ * Verifies source quality and generates citations
+ */
+import 'reflect-metadata';
+import { VerifiedResponse } from '../types';
+export interface SourceVerificationConfig {
+    checkFreshness?: boolean;
+    verifyAuthority?: boolean;
+    requireCitations?: boolean;
+    freshnessThresholdDays?: number;
+}
+export declare function SourceVerification(config?: SourceVerificationConfig): MethodDecorator;
+export declare function getVerifiedResponse(target: object, propertyKey: string | symbol): VerifiedResponse | undefined;
+//# sourceMappingURL=source-verification.decorator.d.ts.map

package/dist/agentic/decorators/source-verification.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-verification.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/source-verification.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAgD,MAAM,UAAU,CAAC;AAE1F,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAID,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,wBAA6B,GAAG,eAAe,CAoCzF;AAuGD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,gBAAgB,GAAG,SAAS,CAE9B"}

package/dist/agentic/decorators/source-verification.decorator.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Source Verification Decorator
+ * Verifies source quality and generates citations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SourceVerification = SourceVerification;
+exports.getVerifiedResponse = getVerifiedResponse;
+require("reflect-metadata");
+const VERIFICATION_METADATA_KEY = Symbol('sourceVerification');
+function SourceVerification(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const results = await originalMethod.apply(this, args);
+            if (!Array.isArray(results)) {
+                return results;
+            }
+            // Verify each source
+            const verifiedSources = await Promise.all(results.map((result) => verifySource(result, config)));
+            // Generate citations
+            const citations = config.requireCitations ? generateCitations(verifiedSources) : [];
+            // Calculate overall confidence
+            const overallConfidence = calculateOverallConfidence(verifiedSources);
+            const verifiedResponse = {
+                answer: '', // Would be filled by calling code
+                sources: verifiedSources,
+                overallConfidence,
+                citations,
+            };
+            Reflect.defineMetadata(VERIFICATION_METADATA_KEY, verifiedResponse, target, propertyKey);
+            return verifiedSources;
+        };
+        return descriptor;
+    };
+}
+async function verifySource(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+source, config) {
+    const verification = {
+        authorityScore: 0.7,
+        freshnessScore: 0.7,
+        relevanceScore: source.score || 0.5,
+        verified: true,
+        issues: [],
+    };
+    // Check freshness
+    if (config.checkFreshness && source.metadata?.timestamp) {
+        const freshnessScore = calculateFreshnessScore(source.metadata.timestamp, config.freshnessThresholdDays || 365);
+        verification.freshnessScore = freshnessScore;
+        if (freshnessScore < 0.5) {
+            verification.issues.push('Content may be outdated');
+        }
+    }
+    // Check authority
+    if (config.verifyAuthority && source.metadata?.source) {
+        const authorityScore = calculateAuthorityScore(source.metadata.source);
+        verification.authorityScore = authorityScore;
+        if (authorityScore < 0.5) {
+            verification.issues.push('Source authority uncertain');
+        }
+    }
+    // Overall verification
+    const avgScore = (verification.authorityScore + verification.freshnessScore + verification.relevanceScore) / 3;
+    verification.verified = avgScore >= 0.6 && verification.issues.length === 0;
+    return {
+        ...source,
+        verification,
+    };
+}
+function calculateFreshnessScore(timestamp, thresholdDays) {
+    const date = typeof timestamp === 'string' ? new Date(timestamp) : timestamp;
+    const now = new Date();
+    const ageInDays = (now.getTime() - date.getTime()) / (1000 * 60 * 60 * 24);
+    if (ageInDays <= 30)
+        return 1.0;
+    if (ageInDays <= 90)
+        return 0.9;
+    if (ageInDays <= 180)
+        return 0.8;
+    if (ageInDays <= 365)
+        return 0.7;
+    if (ageInDays <= thresholdDays)
+        return 0.5;
+    return 0.3;
+}
+function calculateAuthorityScore(source) {
+    const lowerSource = source.toLowerCase();
+    // High authority domains
+    const highAuthority = ['.edu', '.gov', '.org', 'wikipedia', 'scholar'];
+    if (highAuthority.some((domain) => lowerSource.includes(domain))) {
+        return 0.9;
+    }
+    // Medium authority
+    const mediumAuthority = ['.com', 'blog', 'medium'];
+    if (mediumAuthority.some((domain) => lowerSource.includes(domain))) {
+        return 0.7;
+    }
+    return 0.5;
+}
+function generateCitations(sources) {
+    return sources
+        .filter((s) => s.verification.verified)
+        .map((source, index) => ({
+        text: source.content.slice(0, 100) + '...',
+        sourceId: source.id,
+        position: index + 1,
+        confidence: source.verification.relevanceScore,
+    }));
+}
+function calculateOverallConfidence(sources) {
+    if (sources.length === 0)
+        return 0;
+    const verifiedCount = sources.filter((s) => s.verification.verified).length;
+    const avgRelevance = sources.reduce((sum, s) => sum + s.verification.relevanceScore, 0) / sources.length;
+    return (verifiedCount / sources.length) * avgRelevance;
+}
+function getVerifiedResponse(target, propertyKey) {
+    return Reflect.getMetadata(VERIFICATION_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=source-verification.decorator.js.map

package/dist/agentic/decorators/source-verification.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-verification.decorator.js","sourceRoot":"","sources":["../../../src/agentic/decorators/source-verification.decorator.ts"],"names":[],"mappings":"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"}

package/dist/agentic/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agentic RAG - Advanced Retrieval-Augmented Generation
+ * Export all agentic RAG functionality
+ */
+export type { QueryPlan, SubQuery, ReasoningChain, ReasoningHop, ReflectionResult, QualityAssessment, VerifiedResponse, VerifiedSource, Citation, Context, FeedbackData, AgenticGraphSearchResult, GraphNode, GraphEdge, AdaptiveStrategyResult, HyDEResult, CorrectiveRAGResult, Correction, AgenticLLMProvider, LLMOptions, CacheEntry, AgenticRAGConfig, } from './types';
+export type { Entity as AgenticEntity, Message as AgenticMessage } from './types';
+export * from './decorators';
+export * from './agentic-rag.service';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agentic/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,SAAS,EACT,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,wBAAwB,EACxB,SAAS,EACT,SAAS,EACT,sBAAsB,EACtB,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,MAAM,IAAI,aAAa,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;AAGlF,cAAc,cAAc,CAAC;AAG7B,cAAc,uBAAuB,CAAC"}

package/dist/agentic/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Agentic RAG - Advanced Retrieval-Augmented Generation
+ * Export all agentic RAG functionality
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Decorators
+__exportStar(require("./decorators"), exports);
+// Service
+__exportStar(require("./agentic-rag.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/agentic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agentic/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AA+BH,aAAa;AACb,+CAA6B;AAE7B,UAAU;AACV,wDAAsC"}

package/dist/agentic/types.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Agentic RAG Types
+ * Core types and interfaces for agentic RAG capabilities
+ */
+import { SearchResult } from '../types';
+/**
+ * Query Plan - Decomposed query structure
+ */
+export interface QueryPlan {
+    originalQuery: string;
+    subQueries: SubQuery[];
+    strategy: 'sequential' | 'parallel' | 'adaptive';
+    estimatedComplexity: number;
+}
+export interface SubQuery {
+    id: string;
+    query: string;
+    type: 'factual' | 'analytical' | 'comparative' | 'temporal';
+    dependencies: string[];
+    priority: number;
+}
+/**
+ * Reasoning Chain - Multi-hop reasoning result
+ */
+export interface ReasoningChain {
+    query: string;
+    hops: ReasoningHop[];
+    finalAnswer: string;
+    confidence: number;
+    sources: SearchResult[];
+}
+export interface ReasoningHop {
+    hopNumber: number;
+    query: string;
+    results: SearchResult[];
+    reasoning: string;
+    nextQuery?: string;
+}
+/**
+ * Reflection Result - Self-reflection output
+ */
+export interface ReflectionResult {
+    originalResponse: string;
+    quality: QualityAssessment;
+    improvements: string[];
+    revisedResponse?: string;
+    iterations: number;
+}
+export interface QualityAssessment {
+    score: number;
+    relevance: number;
+    completeness: number;
+    accuracy: number;
+    clarity: number;
+    issues: string[];
+}
+/**
+ * Verified Response - Response with source verification
+ */
+export interface VerifiedResponse {
+    answer: string;
+    sources: VerifiedSource[];
+    overallConfidence: number;
+    citations: Citation[];
+}
+export interface VerifiedSource extends SearchResult {
+    verification: SourceVerification;
+}
+export interface SourceVerification {
+    authorityScore: number;
+    freshnessScore: number;
+    relevanceScore: number;
+    verified: boolean;
+    issues: string[];
+}
+export interface Citation {
+    text: string;
+    sourceId: string;
+    position: number;
+    confidence: number;
+}
+/**
+ * Context - Conversation and session context
+ */
+export interface Context {
+    sessionId: string;
+    userId?: string;
+    conversationHistory: Message[];
+    entities: Entity[];
+    topics: Topic[];
+    metadata: Record<string, unknown>;
+}
+export interface Message {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp: Date;
+}
+export interface Entity {
+    name: string;
+    type: string;
+    mentions: number;
+    lastSeen: Date;
+    attributes: Record<string, unknown>;
+}
+export interface Topic {
+    name: string;
+    relevance: number;
+    keywords: string[];
+}
+/**
+ * Feedback Data - User feedback for active learning
+ */
+export interface FeedbackData {
+    resultId: string;
+    rating: number;
+    relevant: boolean;
+    comments?: string;
+    timestamp: Date;
+    userId?: string;
+}
+/**
+ * Agentic Graph Search Result - Knowledge graph retrieval result (agentic module)
+ * @deprecated Use GraphSearchResult from @hazeljs/rag graph module instead.
+ */
+export interface AgenticGraphSearchResult extends SearchResult {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    path: string[];
+}
+export interface GraphNode {
+    id: string;
+    label: string;
+    type: string;
+    properties: Record<string, unknown>;
+}
+export interface GraphEdge {
+    source: string;
+    target: string;
+    type: string;
+    properties: Record<string, unknown>;
+}
+/**
+ * Adaptive Strategy Result
+ */
+export interface AdaptiveStrategyResult {
+    selectedStrategy: string;
+    reason: string;
+    confidence: number;
+    alternatives: Array<{
+        strategy: string;
+        score: number;
+    }>;
+}
+/**
+ * HyDE Result - Hypothetical Document Embeddings
+ */
+export interface HyDEResult {
+    hypotheticalDocuments: string[];
+    retrievedResults: SearchResult[];
+    aggregatedScore: number;
+}
+/**
+ * Corrective RAG Result
+ */
+export interface CorrectiveRAGResult {
+    results: SearchResult[];
+    corrections: Correction[];
+    fallbackUsed: boolean;
+    confidence: number;
+}
+export interface Correction {
+    type: 'low_relevance' | 'missing_info' | 'contradictory';
+    description: string;
+    action: string;
+}
+/**
+ * LLM Provider Interface for Agentic RAG
+ */
+export interface AgenticLLMProvider {
+    generate(prompt: string, options?: LLMOptions): Promise<string>;
+    generateStructured<T>(prompt: string, schema: unknown): Promise<T>;
+    embed(text: string): Promise<number[]>;
+}
+export interface LLMOptions {
+    temperature?: number;
+    maxTokens?: number;
+    stopSequences?: string[];
+}
+/**
+ * Cache Entry
+ */
+export interface CacheEntry<T> {
+    key: string;
+    value: T;
+    timestamp: number;
+    ttl: number;
+    hits: number;
+}
+/**
+ * Agentic RAG Configuration
+ */
+export interface AgenticRAGConfig {
+    name: string;
+    description?: string;
+    llmProvider?: AgenticLLMProvider;
+    enableCaching?: boolean;
+    enableMetrics?: boolean;
+    maxRetries?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/agentic/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Agentic RAG Types
+ * Core types and interfaces for agentic RAG capabilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/agentic/types.js.map

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

package/dist/decorators/embeddable.decorator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @Embeddable Decorator
+ * Automatically generates embeddings for entity fields
+ */
+import 'reflect-metadata';
+type NewableFunction = new (...args: unknown[]) => unknown;
+export interface EmbeddableOptions {
+    fields: string[];
+    strategy?: 'concat' | 'weighted' | 'separate';
+    model?: string;
+    separator?: string;
+    weights?: Record<string, number>;
+}
+/**
+ * Marks an entity as embeddable with automatic embedding generation
+ */
+export declare function Embeddable(options: EmbeddableOptions): ClassDecorator;
+/**
+ * Get embeddable metadata from a class
+ */
+export declare function getEmbeddableMetadata(target: NewableFunction): EmbeddableOptions | undefined;
+/**
+ * Marks a property as a vector column for storing embeddings
+ */
+export declare function VectorColumn(): PropertyDecorator;
+/**
+ * Get vector column metadata
+ */
+export declare function getVectorColumns(target: NewableFunction): string[];
+export {};
+//# sourceMappingURL=embeddable.decorator.d.ts.map

package/dist/decorators/embeddable.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddable.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/embeddable.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,KAAK,eAAe,GAAG,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAID;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAKrE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,GAAG,SAAS,CAE5F;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,iBAAiB,CAMhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAElE"}