geo-semantic-layer 2.0.1

package/dist/config-BcP2K8Tq.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Core configuration types for Semantic Layer
+ * @module types/config
+ */
+/**
+ * Supported entity types for the root identity
+ */
+type IdentityType = 'Organization' | 'Person';
+/**
+ * Contact type for Schema.org ContactPoint
+ */
+type ContactType = 'customer service' | 'technical support' | 'sales' | 'billing';
+/**
+ * Content density levels for GEO optimization
+ */
+type ContentDensity = 'high' | 'medium' | 'low';
+/**
+ * Cache strategy options
+ */
+type CacheStrategy = 'memory' | 'local-storage' | 'redis';
+/**
+ * Postal address structure (Schema.org PostalAddress)
+ */
+interface PostalAddress {
+    '@type'?: 'PostalAddress';
+    streetAddress?: string;
+    addressLocality?: string;
+    addressRegion?: string;
+    postalCode?: string;
+    addressCountry?: string;
+}
+/**
+ * Contact point structure (Schema.org ContactPoint)
+ */
+interface ContactPoint {
+    '@type'?: 'ContactPoint';
+    telephone?: string;
+    email?: string;
+    contactType?: ContactType;
+    areaServed?: string;
+    availableLanguage?: string[];
+}
+/**
+ * Identity configuration for Organization or Person
+ */
+interface IdentityConfig {
+    type: IdentityType;
+    name: string;
+    alternateName?: string;
+    description?: string;
+    url?: string;
+    logoUrl?: string;
+    imageUrl?: string;
+    /**
+     * Critical for entity disambiguation in AI systems
+     * Should include: social profiles, Wikidata ID, Wikipedia URL, etc.
+     */
+    sameAs: string[];
+    email?: string;
+    telephone?: string;
+    address?: PostalAddress;
+    contactPoint?: ContactPoint;
+    foundingDate?: string;
+    founder?: string[];
+    jobTitle?: string;
+    worksFor?: string;
+}
+/**
+ * GEO (Generative Engine Optimization) configuration
+ */
+interface GeoConfig {
+    /**
+     * Validate citations before rendering to prevent hallucinations
+     */
+    enableHallucinationGuard: boolean;
+    /**
+     * Content density for token optimization
+     */
+    contentDensity: ContentDensity;
+    /**
+     * Auto-inject ClaimReview schemas for facts
+     */
+    enableCitations: boolean;
+    /**
+     * AI-powered entity extraction and linking
+     */
+    autoDetectEntities: boolean;
+}
+/**
+ * Cache configuration
+ */
+interface CacheConfig {
+    strategy: CacheStrategy;
+    ttl: number;
+}
+/**
+ * Plugin interface for extensibility
+ */
+interface SemanticPlugin {
+    name: string;
+    setup: (config: SemanticConfig) => {
+        onSchemaGenerated?: (schema: Record<string, unknown>) => void;
+        onValidationError?: (error: Error) => void;
+    };
+}
+/**
+ * Locale-specific identity configuration
+ */
+interface LocaleConfig {
+    identity: Partial<IdentityConfig>;
+}
+/**
+ * Main semantic layer configuration
+ */
+interface SemanticConfig {
+    /**
+     * Base URL of the website
+     */
+    siteUrl: string;
+    /**
+     * Default locale (e.g., 'en-US', 'es-ES')
+     */
+    defaultLocale: string;
+    /**
+     * Root identity (Organization or Person)
+     */
+    identity: IdentityConfig;
+    /**
+     * GEO optimization settings
+     */
+    geo?: GeoConfig;
+    /**
+     * Cache configuration
+     */
+    cache?: CacheConfig;
+    /**
+     * Multi-language support
+     */
+    locales?: Record<string, LocaleConfig>;
+    /**
+     * Auto-generate hreflang tags
+     */
+    autoHreflang?: boolean;
+    /**
+     * Registered plugins
+     */
+    plugins?: SemanticPlugin[];
+}
+
+export type { ContactType as C, GeoConfig as G, IdentityType as I, LocaleConfig as L, PostalAddress as P, SemanticPlugin as S, ContentDensity as a, CacheStrategy as b, ContactPoint as c, IdentityConfig as d, CacheConfig as e, SemanticConfig as f };