@easyling/sanity-connector 1.4.0 → 2.0.0

package/dist-types/services/authStateManager.d.ts

@@ -1,93 +0,0 @@
-/**
- * Authentication State Manager
- *
- * Manages the overall authentication state and provides reactive updates
- * to UI components through an observable pattern.
- *
- * Requirements: 6.1, 6.2, 6.3, 6.4, 6.5
- */
-import { AuthState, AuthStateData } from '../types/oauth';
-import { TokenStorage } from './tokenStorage';
-/**
- * Callback function type for state change subscriptions
- */
-type StateChangeCallback = (state: AuthStateData) => void;
-/**
- * Authentication State Manager
- *
- * Provides centralized management of authentication state with reactive updates.
- * Uses observable pattern to notify subscribers of state changes.
- */
-export declare class AuthStateManager {
-    private currentState;
-    private subscribers;
-    private tokenStorage;
-    /**
-     * Create a new Authentication State Manager
-     *
-     * Requirements: 6.1, 6.2
-     *
-     * @param tokenStorage - Token storage service for persistence
-     */
-    constructor(tokenStorage: TokenStorage);
-    /**
-     * Validate state transition
-     *
-     * Requirements: 6.5
-     *
-     * @param fromState - Current state
-     * @param toState - Target state
-     * @returns True if transition is valid
-     */
-    private isValidTransition;
-    /**
-     * Get current authentication state
-     *
-     * Requirements: 6.1, 6.2
-     *
-     * @returns Current authentication state data
-     */
-    getState(): AuthStateData;
-    /**
-     * Update authentication state and notify subscribers
-     *
-     * Requirements: 6.2, 6.5
-     *
-     * @param state - New authentication state
-     * @param data - Additional state data
-     * @throws {OAuthError} If state transition is invalid
-     */
-    setState(state: AuthState, data?: Partial<AuthStateData>): void;
-    /**
-     * Notify all subscribers of state change
-     *
-     * Requirements: 6.2
-     */
-    private notifySubscribers;
-    /**
-     * Subscribe to state changes
-     *
-     * Requirements: 6.2
-     *
-     * @param callback - Function to call when state changes
-     * @returns Unsubscribe function
-     */
-    subscribe(callback: StateChangeCallback): () => void;
-    /**
-     * Initialize state from stored authentication data
-     *
-     * Requirements: 6.1, 6.4
-     *
-     * @returns Promise that resolves when initialization is complete
-     */
-    initialize(): Promise<void>;
-    /**
-     * Logout and clear all authentication data
-     *
-     * Requirements: 6.3, 6.4
-     *
-     * @returns Promise that resolves when logout is complete
-     */
-    logout(): Promise<void>;
-}
-export {};

package/dist-types/services/collisionDetectionService.d.ts

@@ -1,85 +0,0 @@
-/**
- * Collision Detection Service
- * Requirements: Translation Collision Handling - EARS 2.1, 2.2
- *
- * Detects existing translated documents for the same source document and target locale
- * to enable collision resolution handling.
- */
-import { SanityClient, SanityDocument } from 'sanity';
-/**
- * Result of a collision detection check
- */
-export interface CollisionResult {
-    /** Whether a collision was detected */
-    detected: boolean;
-    /** The existing translated document if collision was detected */
-    existingDocument?: SanityDocument;
-    /** How the collision was identified */
-    matchedBy?: 'parent' | 'slug-locale';
-}
-/**
- * Options for collision detection
- */
-export interface CollisionDetectionOptions {
-    /** The source document ID (the original document being translated) */
-    sourceDocumentId: string;
-    /** The target locale code for the translation */
-    targetLocale: string;
-    /** The slug of the translated document (optional, used for slug-locale matching) */
-    slug?: string;
-    /** The document type to search within */
-    documentType?: string;
-}
-/**
- * Error type for collision detection operations
- */
-export declare class CollisionDetectionError extends Error {
-    code: string;
-    details?: unknown | undefined;
-    constructor(message: string, code: string, details?: unknown | undefined);
-}
-/**
- * Service for detecting translation collisions
- *
- * A collision occurs when a translated document already exists for the same
- * source document and target locale. The service identifies collisions using:
- * 1. Parent reference matching: parentDocument._ref == sourceDocumentId AND locale == targetLocale
- * 2. Slug-locale matching: slug.current == slug AND locale == targetLocale
- */
-export declare class CollisionDetectionService {
-    private client;
-    constructor(client: SanityClient);
-    /**
-     * Detect if a collision exists for the given source document and target locale
-     *
-     * @param options - Options specifying the source document, target locale, and optional slug
-     * @returns CollisionResult indicating whether a collision was found and details
-     */
-    detectCollision(options: CollisionDetectionOptions): Promise<CollisionResult>;
-    /**
-     * Find an existing document by parent reference and locale
-     *
-     * @param sourceDocumentId - The ID of the source/parent document
-     * @param targetLocale - The target locale code
-     * @param documentType - Optional document type to filter by
-     */
-    private findByParentReference;
-    /**
-     * Find an existing document by slug and locale
-     *
-     * @param slug - The document slug to match
-     * @param targetLocale - The target locale code
-     * @param documentType - Optional document type to filter by
-     */
-    private findBySlugAndLocale;
-    /**
-     * Check if multiple collisions exist for bulk translation operations
-     *
-     * @param sourceDocumentId - The source document being translated
-     * @param targetLocales - Array of target locale codes
-     * @param slug - Optional slug for slug-locale matching
-     * @param documentType - Optional document type to filter by
-     * @returns Map of locale code to collision result
-     */
-    detectBulkCollisions(sourceDocumentId: string, targetLocales: string[], slug?: string, documentType?: string): Promise<Map<string, CollisionResult>>;
-}

package/dist-types/services/contentExtractor.d.ts

@@ -1,161 +0,0 @@
-import { SanityDocument } from 'sanity';
-export interface DocumentContent {
-    documentId: string;
-    title: string;
-    htmlContent: string;
-}
-export interface ExtendedDocumentContent extends DocumentContent {
-    slug?: string;
-    /** Fields can be either flat values or TranslatableField objects with value and dnt properties */
-    fields?: Record<string, any>;
-    /** Whether the title was found at the document's top level (false if extracted from nested fields) */
-    titleFoundAtTopLevel?: boolean;
-    /** Whether the body/content was found at the document's top level (false if extracted from nested fields) */
-    bodyFoundAtTopLevel?: boolean;
-    /** The field name where body content was found (e.g., 'body', 'content', 'text', or nested path) */
-    bodyFieldName?: string;
-}
-export interface ExtractedContent {
-    documentId: string;
-    documentType: string;
-    title: string;
-    htmlContent: string;
-    extractedAt: Date;
-}
-export declare class ContentExtractor {
-    /**
-     * Infer the Sanity field type from a value
-     *
-     * @param value - The field value to inspect
-     * @returns The inferred Sanity type string
-     */
-    private inferSanityType;
-    /**
-     * Check if a value is an atomic Sanity type that should NOT be recursively flattened
-     * These include types like slug, date, datetime, reference, image, file, etc.
-     * Custom object types (e.g., articleInfo, footnoteInfo) are NOT atomic and should be flattened
-     */
-    private isSanitySpecialType;
-    /**
-     * Check if an object should be recursively flattened into separate fields
-     * Plain objects (fieldsets, custom object types without _type) should be flattened
-     * Sanity special types should NOT be flattened
-     */
-    private shouldFlattenObject;
-    /**
-     * Recursively flatten a nested object into individual TranslatableField entries
-     * Each leaf field gets its own entry with a dotted path key
-     *
-     * Arrays of objects with _key are flattened with key-based paths like:
-     *   article.footnotes[_key == "abc123"].footnote
-     *
-     * @param obj - The object to flatten
-     * @param basePath - The base path prefix for keys
-     * @param fields - The fields record to populate
-     * @param docContext - Document context for GROQ path generation
-     */
-    private flattenObjectToFields;
-    /**
-     * Flatten an array into individual TranslatableField entries
-     * Arrays of objects with _key get key-based paths
-     *
-     * @param array - The array to flatten
-     * @param fieldPath - The field path for this array
-     * @param fieldName - The field name (last segment of path)
-     * @param fields - The fields record to populate
-     * @param docContext - Document context for GROQ path generation
-     */
-    private flattenArrayToFields;
-    /**
-     * Add a leaf field (primitive or atomic Sanity type) to the fields record
-     */
-    private addLeafField;
-    /**
-     * Extract content from a single Sanity document and convert to HTML
-     */
-    extractDocumentContent(document: SanityDocument): Promise<string>;
-    /**
-     * Convert Sanity document content to HTML format
-     */
-    convertToHtml(content: any): string;
-    /**
-     * Extract structured content with separated body, title, slug, and fields
-     * Also applies DNT preferences if available
-     */
-    extractStructuredContent(document: SanityDocument): Promise<ExtendedDocumentContent>;
-    /**
-     * Apply DNT preferences to extracted fields based on document type
-     * Now uses document-type-based configuration that applies to all documents of the same type
-     *
-     * DNT priority:
-     * 1. Stored user preference (explicit override)
-     * 2. Default based on field type (slug, date, datetime, reference, etc.)
-     * 3. Default based on field name (containing "author" or "contributor")
-     * 4. Default based on group/fieldset name (containing "date" or "time")
-     * 5. Default to translatable (dnt: false)
-     */
-    private applyDNTPreferences;
-    /**
-     * Extract content from multiple documents for bulk operations
-     */
-    extractBulkContent(documents: SanityDocument[]): Promise<DocumentContent[]>;
-    /**
-     * Extract structured content from multiple documents
-     */
-    extractBulkStructuredContent(documents: SanityDocument[]): Promise<ExtendedDocumentContent[]>;
-    /**
-     * Process individual fields based on their type
-     */
-    private processField;
-    /**
-     * Process array fields (like portable text blocks)
-     */
-    private processArray;
-    /**
-     * Process portable text blocks and convert to HTML
-     */
-    private processPortableTextBlock;
-    /**
-     * Extract content from portable text block children
-     */
-    private processPortableTextBlockContent;
-    /**
-     * Process object fields
-     */
-    private processObject;
-    /**
-     * Wrap content in HTML with field name as class
-     */
-    private wrapInHtml;
-    /**
-     * Separate main content from metadata fields
-     * All fields are immediately wrapped in TranslatableField format with type information
-     * DNT defaults are computed based on field type and name patterns
-     *
-     * Complex types (objects/fieldsets) are recursively flattened into individual fields
-     * using dotted path notation (e.g., "metadata.version", "metadata.status")
-     */
-    private separateContentAndFields;
-    /**
-     * Recursively search nested objects and fieldsets for a body/content field
-     */
-    private findBodyInNestedFields;
-    /**
-     * Extract slug from document
-     */
-    private extractSlug;
-    /**
-     * Extract title from document
-     * Searches top-level fields first, then descends into nested objects/fieldsets
-     * @returns Object with title string and flag indicating if found at top level
-     */
-    private extractTitle;
-    /**
-     * Recursively search nested objects and fieldsets for a title field
-     */
-    private findTitleInNestedFields;
-    /**
-     * Escape HTML special characters
-     */
-    private escapeHtml;
-}

package/dist-types/services/dialogService.d.ts

@@ -1,95 +0,0 @@
-/**
- * Dialog management service with React state management
- * Requirements: 3.1, 3.2, 3.5, 3.6, 3.7
- *
- * Centralized dialog management with queue support for multiple simultaneous dialogs
- */
-import React, { ReactNode } from 'react';
-import type { DialogManager, ConfirmationDialogOptions, SuccessDialogOptions, ErrorDialogOptions, LocaleSelectionDialogOptions, LocaleSelectionResult } from '../types/dialog';
-/**
- * Dialog types for queue management
- */
-type DialogType = 'confirmation' | 'success' | 'error' | 'localeSelection';
-/**
- * Dialog options union type
- */
-type DialogOptions = ConfirmationDialogOptions | SuccessDialogOptions | ErrorDialogOptions | LocaleSelectionDialogOptions;
-/**
- * Dialog queue item structure
- */
-interface DialogQueueItem {
-    id: string;
-    type: DialogType;
-    options: DialogOptions;
-    resolve?: (value: unknown) => void;
-    reject?: (error: Error) => void;
-}
-/**
- * Dialog context state
- */
-interface DialogContextState {
-    currentDialog: DialogQueueItem | null;
-    dialogQueue: DialogQueueItem[];
-    showConfirmation: (options: ConfirmationDialogOptions) => Promise<boolean>;
-    showLocaleSelection: (options: LocaleSelectionDialogOptions) => Promise<LocaleSelectionResult>;
-    showSuccess: (options: SuccessDialogOptions) => void;
-    showError: (options: ErrorDialogOptions) => Promise<boolean>;
-    closeAll: () => void;
-}
-/**
- * Hook to access dialog service from React components
- */
-export declare const useDialogService: () => DialogContextState;
-/**
- * Dialog Provider Props
- */
-interface DialogProviderProps {
-    children: ReactNode;
-}
-/**
- * Dialog Provider Component
- * Manages dialog state and queue for the entire application
- */
-export declare const DialogProvider: React.FC<DialogProviderProps>;
-/**
- * Singleton DialogService class for non-React contexts
- * Note: This requires the DialogProvider to be mounted in the React tree
- */
-export declare class DialogService implements DialogManager {
-    private static instance;
-    private contextRef;
-    private constructor();
-    /**
-     * Get singleton instance
-     */
-    static getInstance(): DialogService;
-    /**
-     * Set the context reference (called by DialogProvider)
-     */
-    setContext(context: DialogContextState): void;
-    /**
-     * Show a confirmation dialog
-     */
-    showConfirmation(options: ConfirmationDialogOptions): Promise<boolean>;
-    /**
-     * Show a locale selection dialog
-     */
-    showLocaleSelection(options: LocaleSelectionDialogOptions): Promise<LocaleSelectionResult>;
-    /**
-     * Show a success notification
-     */
-    showSuccess(options: SuccessDialogOptions): void;
-    /**
-     * Show an error dialog
-     */
-    showError(options: ErrorDialogOptions): Promise<boolean>;
-    /**
-     * Close all open dialogs
-     */
-    closeAll(): void;
-}
-/**
- * Export singleton instance for convenience
- */
-export declare const dialogService: DialogService;
-export {};

package/dist-types/services/dntServiceManager.d.ts

@@ -1,43 +0,0 @@
-/**
- * DNT Service Manager
- *
- * Provides singleton access to DNTStorageAdapter with proper initialization.
- * Similar to OAuthServiceManager pattern.
- */
-import { SanityClient } from 'sanity';
-import { DNTStorageAdapter } from './dntStorageAdapter';
-/**
- * Singleton manager for DNT storage services
- */
-export declare class DNTServiceManager {
-    private static instance;
-    private dntStorage;
-    private client;
-    private constructor();
-    /**
-     * Get or create the singleton instance
-     */
-    static getInstance(client?: SanityClient): DNTServiceManager;
-    /**
-     * Initialize the service with a Sanity client
-     */
-    initialize(client: SanityClient): void;
-    /**
-     * Get the DNT storage adapter
-     * Throws if not initialized
-     */
-    getDNTStorage(): DNTStorageAdapter;
-    /**
-     * Check if the service is initialized
-     */
-    isInitialized(): boolean;
-    /**
-     * Reset the singleton instance (useful for testing)
-     */
-    static reset(): void;
-}
-/**
- * Convenience function to get DNT storage adapter
- * Throws if service is not initialized
- */
-export declare function getDNTStorage(): DNTStorageAdapter;

package/dist-types/services/dntStorageAdapter.d.ts

@@ -1,72 +0,0 @@
-/**
- * DNT (Do Not Translate) preferences storage adapter
- *
- * Now uses document-type-based storage in the unified configuration.
- * When you mark a field as DNT for any document of a type (e.g., 'product'),
- * it applies to ALL documents of that type.
- *
- * This replaces the old per-document localStorage approach with centralized
- * configuration stored in Sanity.
- */
-import { DNTPreferences, DNTStorage } from '../types/dnt';
-import { UnifiedConfigStorage } from './unifiedConfigStorage';
-/**
- * DNT Storage Adapter using unified configuration
- */
-export declare class DNTStorageAdapter implements DNTStorage {
-    private configStorage;
-    constructor(configStorage: UnifiedConfigStorage);
-    /**
-     * Get DNT field configuration for a document type
-     */
-    getFieldsForType(documentType: string): Promise<Record<string, boolean>>;
-    /**
-     * Set DNT status for a specific field in a document type
-     */
-    setFieldDNT(documentType: string, fieldPath: string, dnt: boolean): Promise<void>;
-    /**
-     * Toggle DNT status for a field in a document type
-     */
-    toggleFieldDNT(documentType: string, fieldPath: string): Promise<boolean>;
-    /**
-     * Get DNT status for a specific field in a document type
-     */
-    getFieldDNT(documentType: string, fieldPath: string): Promise<boolean>;
-    /**
-     * Clear all DNT fields for a document type
-     */
-    clearFieldsForType(documentType: string): Promise<void>;
-    /**
-     * Get all DNT configurations (all document types)
-     */
-    getAllDNTFields(): Promise<Record<string, Record<string, boolean>>>;
-    /**
-     * @deprecated Use getFieldsForType instead. This method now uses document type, not document ID.
-     * Get DNT preferences - now based on document type, not individual document ID
-     */
-    getPreferences(_documentId: string): Promise<DNTPreferences | null>;
-    /**
-     * @deprecated Use setFieldDNT instead
-     */
-    savePreferences(preferences: DNTPreferences): Promise<void>;
-    /**
-     * @deprecated Use clearFieldsForType instead
-     */
-    clearPreferences(_documentId: string): Promise<void>;
-}
-/**
- * Legacy DNT Storage Adapter using localStorage (deprecated)
- * Kept for migration purposes only
- * @deprecated Use DNTStorageAdapter with UnifiedConfigStorage instead
- */
-export declare class LegacyDNTStorageAdapter {
-    private static readonly STORAGE_KEY_PREFIX;
-    private getStorageKey;
-    getPreferences(documentId: string): Promise<DNTPreferences | null>;
-    savePreferences(preferences: DNTPreferences): Promise<void>;
-    clearPreferences(documentId: string): Promise<void>;
-    /**
-     * Migrate legacy localStorage preferences to unified configuration
-     */
-    migrateToUnified(configStorage: UnifiedConfigStorage, documentId: string, documentType: string): Promise<void>;
-}