lokicms-plugin-sql 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC7E,YAAY,EACV,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/query/index.js

@@ -0,0 +1,8 @@
+/**
+ * Query Layer Index
+ *
+ * Query building and transformation utilities.
+ */
+export { createQueryBuilder, createQueryBuilderForType } from './builder.js';
+export { createRowTransformer, createAutoMapping, createEntryTransformer, createContentTypeTransformer, snakeCase, } from './transformer.js';
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAW7E,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,SAAS,GACV,MAAM,kBAAkB,CAAC"}

package/dist/query/transformer.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Row Transformer
+ *
+ * Transforms SQL rows to/from LokiJS documents.
+ */
+import type { SQLProviderType } from '../types.js';
+/**
+ * Field mapping
+ */
+export interface FieldMapping {
+    /** SQL column name */
+    column: string;
+    /** Document field name */
+    field: string;
+    /** Transform function */
+    transform?: (value: unknown) => unknown;
+    /** Reverse transform function */
+    reverseTransform?: (value: unknown) => unknown;
+}
+/**
+ * Schema mapping
+ */
+export interface SchemaMapping {
+    /** Table name */
+    table: string;
+    /** Collection name */
+    collection: string;
+    /** Primary key column */
+    primaryKey: string;
+    /** Field mappings */
+    fields: FieldMapping[];
+    /** Auto-generated fields (timestamps, etc.) */
+    autoFields?: string[];
+}
+/**
+ * Transformer interface
+ */
+export interface RowTransformer {
+    /** Transform SQL row to document */
+    toDocument(row: Record<string, unknown>): Record<string, unknown>;
+    /** Transform document to SQL row */
+    toRow(doc: Record<string, unknown>): Record<string, unknown>;
+    /** Get column names */
+    getColumns(): string[];
+    /** Get field names */
+    getFields(): string[];
+    /** Get primary key column */
+    getPrimaryKey(): string;
+}
+/**
+ * Create row transformer
+ */
+export declare function createRowTransformer(mapping: SchemaMapping, providerType: SQLProviderType): RowTransformer;
+/**
+ * Create automatic field mapping from table info
+ */
+export declare function createAutoMapping(table: string, collection: string, columns: Array<{
+    name: string;
+    type: string;
+    primaryKey: boolean;
+}>): SchemaMapping;
+/**
+ * Convert camelCase to snake_case
+ */
+export declare function snakeCase(str: string): string;
+/**
+ * Create transformer for LokiCMS entries
+ */
+export declare function createEntryTransformer(providerType: SQLProviderType, tablePrefix?: string): RowTransformer;
+/**
+ * Create transformer for LokiCMS content types
+ */
+export declare function createContentTypeTransformer(providerType: SQLProviderType, tablePrefix?: string): RowTransformer;
+//# sourceMappingURL=transformer.d.ts.map

package/dist/query/transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.d.ts","sourceRoot":"","sources":["../../src/query/transformer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACxC,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElE,oCAAoC;IACpC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7D,uBAAuB;IACvB,UAAU,IAAI,MAAM,EAAE,CAAC;IAEvB,sBAAsB;IACtB,SAAS,IAAI,MAAM,EAAE,CAAC;IAEtB,6BAA6B;IAC7B,aAAa,IAAI,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,YAAY,EAAE,eAAe,GAC5B,cAAc,CA2FhB;AA4FD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,GAClE,aAAa,CAgBf;AASD;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,eAAe,EAC7B,WAAW,GAAE,MAAmB,GAC/B,cAAc,CAoBhB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,eAAe,EAC7B,WAAW,GAAE,MAAmB,GAC/B,cAAc,CAkBhB"}

package/dist/query/transformer.js

@@ -0,0 +1,236 @@
+/**
+ * Row Transformer
+ *
+ * Transforms SQL rows to/from LokiJS documents.
+ */
+/**
+ * Create row transformer
+ */
+export function createRowTransformer(mapping, providerType) {
+    const columnToField = new Map();
+    const fieldToColumn = new Map();
+    // Build lookup maps
+    for (const field of mapping.fields) {
+        columnToField.set(field.column, field);
+        fieldToColumn.set(field.field, field);
+    }
+    /**
+     * Transform SQL row to document
+     */
+    function toDocument(row) {
+        const doc = {};
+        for (const [column, value] of Object.entries(row)) {
+            const mapping = columnToField.get(column);
+            if (mapping) {
+                const transformedValue = mapping.transform
+                    ? mapping.transform(value)
+                    : transformValue(value, providerType, 'toDocument');
+                doc[mapping.field] = transformedValue;
+            }
+            else {
+                // No mapping, use column name as field name
+                doc[column] = transformValue(value, providerType, 'toDocument');
+            }
+        }
+        return doc;
+    }
+    /**
+     * Transform document to SQL row
+     */
+    function toRow(doc) {
+        const row = {};
+        for (const [field, value] of Object.entries(doc)) {
+            // Skip LokiJS internal fields
+            if (field.startsWith('$') || field === 'meta') {
+                continue;
+            }
+            const mapping = fieldToColumn.get(field);
+            if (mapping) {
+                const transformedValue = mapping.reverseTransform
+                    ? mapping.reverseTransform(value)
+                    : transformValue(value, providerType, 'toRow');
+                row[mapping.column] = transformedValue;
+            }
+            else {
+                // No mapping, use field name as column name
+                row[field] = transformValue(value, providerType, 'toRow');
+            }
+        }
+        return row;
+    }
+    /**
+     * Get column names
+     */
+    function getColumns() {
+        return mapping.fields.map((f) => f.column);
+    }
+    /**
+     * Get field names
+     */
+    function getFields() {
+        return mapping.fields.map((f) => f.field);
+    }
+    /**
+     * Get primary key column
+     */
+    function getPrimaryKey() {
+        return mapping.primaryKey;
+    }
+    return {
+        toDocument,
+        toRow,
+        getColumns,
+        getFields,
+        getPrimaryKey,
+    };
+}
+/**
+ * Transform value based on type and direction
+ */
+function transformValue(value, providerType, direction) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (direction === 'toDocument') {
+        // SQL → Document transformations
+        // Handle JSON strings
+        if (typeof value === 'string') {
+            // Try to parse as JSON if it looks like JSON
+            if ((value.startsWith('{') && value.endsWith('}')) ||
+                (value.startsWith('[') && value.endsWith(']'))) {
+                try {
+                    return JSON.parse(value);
+                }
+                catch {
+                    return value;
+                }
+            }
+        }
+        // Handle Buffer/Blob to base64
+        if (Buffer.isBuffer(value)) {
+            return value.toString('base64');
+        }
+        // Handle BigInt
+        if (typeof value === 'bigint') {
+            return Number(value);
+        }
+        // Handle Date
+        if (value instanceof Date) {
+            return value.toISOString();
+        }
+        return value;
+    }
+    else {
+        // Document → SQL transformations
+        // Handle objects/arrays to JSON
+        if (typeof value === 'object' && value !== null) {
+            if (Array.isArray(value) || Object.keys(value).length > 0) {
+                // PostgreSQL can use native JSONB
+                if (providerType === 'postgresql') {
+                    return JSON.stringify(value);
+                }
+                // Other providers store as JSON string
+                return JSON.stringify(value);
+            }
+        }
+        // Handle ISO date strings
+        if (typeof value === 'string') {
+            // Check if it's an ISO date string
+            const dateRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/;
+            if (dateRegex.test(value)) {
+                // Keep as string for most providers
+                return value;
+            }
+        }
+        // Handle base64 to Buffer
+        if (typeof value === 'string' && isBase64(value)) {
+            // Only convert if explicitly needed
+            return value;
+        }
+        return value;
+    }
+}
+/**
+ * Check if string is base64 encoded
+ */
+function isBase64(str) {
+    if (str.length < 16)
+        return false;
+    const base64Regex = /^[A-Za-z0-9+/]+=*$/;
+    return base64Regex.test(str);
+}
+/**
+ * Create automatic field mapping from table info
+ */
+export function createAutoMapping(table, collection, columns) {
+    const primaryKey = columns.find((c) => c.primaryKey)?.name ?? 'id';
+    const fields = columns.map((col) => ({
+        column: col.name,
+        field: camelCase(col.name),
+        // Add type-specific transforms if needed
+    }));
+    return {
+        table,
+        collection,
+        primaryKey,
+        fields,
+        autoFields: ['created_at', 'updated_at'],
+    };
+}
+/**
+ * Convert snake_case to camelCase
+ */
+function camelCase(str) {
+    return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+/**
+ * Convert camelCase to snake_case
+ */
+export function snakeCase(str) {
+    return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+/**
+ * Create transformer for LokiCMS entries
+ */
+export function createEntryTransformer(providerType, tablePrefix = 'lokicms_') {
+    const mapping = {
+        table: `${tablePrefix}entries`,
+        collection: 'entries',
+        primaryKey: 'id',
+        fields: [
+            { column: 'id', field: 'id' },
+            { column: 'content_type', field: 'contentType' },
+            { column: 'data', field: 'data' },
+            { column: 'status', field: 'status' },
+            { column: 'locale', field: 'locale' },
+            { column: 'created_at', field: 'createdAt' },
+            { column: 'updated_at', field: 'updatedAt' },
+            { column: 'published_at', field: 'publishedAt' },
+            { column: 'created_by', field: 'createdBy' },
+            { column: 'updated_by', field: 'updatedBy' },
+        ],
+    };
+    return createRowTransformer(mapping, providerType);
+}
+/**
+ * Create transformer for LokiCMS content types
+ */
+export function createContentTypeTransformer(providerType, tablePrefix = 'lokicms_') {
+    const mapping = {
+        table: `${tablePrefix}content_types`,
+        collection: 'contentTypes',
+        primaryKey: 'id',
+        fields: [
+            { column: 'id', field: 'id' },
+            { column: 'name', field: 'name' },
+            { column: 'slug', field: 'slug' },
+            { column: 'description', field: 'description' },
+            { column: 'fields', field: 'fields' },
+            { column: 'options', field: 'options' },
+            { column: 'created_at', field: 'createdAt' },
+            { column: 'updated_at', field: 'updatedAt' },
+        ],
+    };
+    return createRowTransformer(mapping, providerType);
+}
+//# sourceMappingURL=transformer.js.map

package/dist/query/transformer.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,350 @@
+/**
+ * LokiCMS SQL Plugin - Type Definitions
+ */
+/**
+ * Supported SQL providers
+ */
+export type SQLProviderType = 'postgresql' | 'mysql' | 'mariadb' | 'sqlite';
+/**
+ * Vector storage providers (includes lokijs for in-memory)
+ */
+export type VectorProviderType = SQLProviderType | 'lokijs';
+/**
+ * Connection mode
+ */
+export type ConnectionMode = 'readwrite' | 'readonly';
+/**
+ * PostgreSQL connection config
+ */
+export interface PostgreSQLConnectionConfig {
+    connectionString?: string;
+    host?: string;
+    port?: number;
+    database?: string;
+    user?: string;
+    password?: string;
+    ssl?: boolean | {
+        rejectUnauthorized?: boolean;
+    };
+}
+/**
+ * MySQL/MariaDB connection config
+ */
+export interface MySQLConnectionConfig {
+    host: string;
+    port?: number;
+    database: string;
+    user: string;
+    password: string;
+    ssl?: boolean | object;
+}
+/**
+ * SQLite connection config
+ */
+export interface SQLiteConnectionConfig {
+    filename: string;
+    readonly?: boolean;
+}
+/**
+ * Union of all connection configs
+ */
+export type ConnectionConfig = PostgreSQLConnectionConfig | MySQLConnectionConfig | SQLiteConnectionConfig;
+/**
+ * Table to collection mapping
+ */
+export interface TableMapping {
+    /** Target LokiJS collection name */
+    collection: string;
+    /** Sync interval in minutes (for readonly sources) */
+    syncInterval?: number;
+    /** Primary key column (default: 'id') */
+    primaryKey?: string;
+    /** Transform function for rows */
+    transform?: (row: Record<string, unknown>) => Record<string, unknown>;
+    /** Columns to select (default: all) */
+    columns?: string[];
+    /** WHERE clause for filtering */
+    where?: string;
+}
+/**
+ * Source configuration (for data federation)
+ */
+export interface SourceConfig {
+    /** Unique source name */
+    name: string;
+    /** Provider type */
+    provider: SQLProviderType;
+    /** Connection mode (sources are typically readonly) */
+    mode: ConnectionMode;
+    /** Connection configuration */
+    connection: ConnectionConfig;
+    /** Table mappings */
+    tables: Record<string, TableMapping>;
+    /** Auto-sync enabled */
+    autoSync?: boolean;
+}
+/**
+ * Vector storage configuration
+ */
+export interface VectorConfig {
+    /** Provider for vector storage */
+    provider: VectorProviderType;
+    /** Connection (if not lokijs) */
+    connection?: ConnectionConfig;
+    /** Vector dimensions */
+    dimensions?: number;
+    /** Enable vector indexing */
+    enableIndex?: boolean;
+}
+/**
+ * Cache configuration
+ */
+export interface CacheConfig {
+    /** Enable caching */
+    enabled: boolean;
+    /** TTL in minutes */
+    ttlMinutes?: number;
+    /** Collections to cache (empty = all) */
+    collections?: string[];
+}
+/**
+ * Main plugin configuration
+ */
+export interface SQLPluginConfig {
+    /** Primary data source */
+    primary?: {
+        provider: SQLProviderType;
+        mode: ConnectionMode;
+        connection: ConnectionConfig;
+    };
+    /** Additional readonly sources */
+    sources?: SourceConfig[];
+    /** Vector storage configuration */
+    vectors?: VectorConfig;
+    /** Cache configuration */
+    cache?: CacheConfig;
+    /** Table prefix for LokiCMS tables */
+    tablePrefix?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Database capabilities
+ */
+export interface ProviderCapabilities {
+    /** Supports JSONB/JSON columns */
+    json: boolean;
+    /** Supports vector data type */
+    vectors: boolean;
+    /** Vector extension/version info */
+    vectorInfo?: string;
+    /** Supports full-text search */
+    fullText: boolean;
+    /** Full-text method (tsvector, FULLTEXT, FTS5) */
+    fullTextMethod?: string;
+    /** Supports transactions */
+    transactions: boolean;
+    /** Max connections */
+    maxConnections?: number;
+}
+/**
+ * Query result
+ */
+export interface QueryResult<T = Record<string, unknown>> {
+    rows: T[];
+    rowCount: number;
+    fields?: Array<{
+        name: string;
+        dataType: string;
+    }>;
+}
+/**
+ * Provider status
+ */
+export interface ProviderStatus {
+    connected: boolean;
+    provider: SQLProviderType;
+    version?: string;
+    database?: string;
+    mode: ConnectionMode;
+    capabilities: ProviderCapabilities;
+    error?: string;
+}
+/**
+ * Vector entry
+ */
+export interface VectorEntry {
+    id: string;
+    entryId: string;
+    collection: string;
+    vector: number[];
+    textHash: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Vector search options
+ */
+export interface VectorSearchOptions {
+    limit?: number;
+    collection?: string;
+    minSimilarity?: number;
+}
+/**
+ * Vector search result
+ */
+export interface VectorSearchResult {
+    id: string;
+    entryId: string;
+    collection: string;
+    similarity: number;
+}
+/**
+ * Sync result
+ */
+export interface SyncResult {
+    success: boolean;
+    source: string;
+    table: string;
+    collection: string;
+    inserted: number;
+    updated: number;
+    deleted: number;
+    errors: string[];
+    duration: number;
+}
+/**
+ * Import options
+ */
+export interface ImportOptions {
+    /** Source name */
+    source: string;
+    /** Table to import */
+    table?: string;
+    /** Full refresh (delete existing) */
+    fullRefresh?: boolean;
+    /** Batch size */
+    batchSize?: number;
+}
+/**
+ * Cache entry
+ */
+export interface CacheEntry {
+    key: string;
+    value: unknown;
+    expiresAt: number;
+    createdAt: number;
+}
+/**
+ * Cache stats
+ */
+export interface CacheStats {
+    enabled: boolean;
+    entries: number;
+    size: number;
+    hits: number;
+    misses: number;
+    ttlMinutes: number;
+}
+/**
+ * Column info
+ */
+export interface ColumnInfo {
+    name: string;
+    type: string;
+    nullable: boolean;
+    primaryKey: boolean;
+    defaultValue?: unknown;
+}
+/**
+ * Table info
+ */
+export interface TableInfo {
+    name: string;
+    schema?: string;
+    columns: ColumnInfo[];
+    rowCount?: number;
+}
+/**
+ * Database schema
+ */
+export interface DatabaseSchema {
+    tables: TableInfo[];
+    views?: string[];
+}
+/**
+ * Logger interface
+ */
+export interface PluginLogger {
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+}
+/**
+ * MCP Tool definition
+ */
+export interface McpToolDefinition {
+    description: string;
+    inputSchema: unknown;
+    handler(input: unknown): Promise<unknown>;
+}
+/**
+ * MCP Tools registry
+ */
+export interface McpTools {
+    registerTool(name: string, tool: McpToolDefinition): void;
+}
+/**
+ * Plugin hooks
+ */
+export interface PluginHooks {
+    on(event: string, callback: (...args: unknown[]) => void): void;
+    emit(event: string, ...args: unknown[]): void;
+}
+/**
+ * Plugin API
+ */
+export interface PluginAPI {
+    config: Record<string, unknown>;
+    logger: PluginLogger;
+    hooks: PluginHooks;
+    mcp: McpTools;
+    services: {
+        entries: unknown;
+        contentTypes: unknown;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Plugin definition
+ */
+export interface PluginDefinition {
+    name: string;
+    version: string;
+    description: string;
+    register(api: PluginAPI): Promise<void>;
+}
+/** Supported providers */
+export declare const SQL_PROVIDERS: readonly SQLProviderType[];
+/** Vector providers */
+export declare const VECTOR_PROVIDERS: readonly VectorProviderType[];
+/** Default table prefix */
+export declare const DEFAULT_TABLE_PREFIX = "lokicms_";
+/** Default vector dimensions */
+export declare const DEFAULT_VECTOR_DIMENSIONS = 384;
+/** Default cache TTL */
+export declare const DEFAULT_CACHE_TTL = 60;
+/**
+ * SQL error codes
+ */
+export type SQLErrorCode = 'NOT_CONFIGURED' | 'CONNECTION_FAILED' | 'QUERY_FAILED' | 'PROVIDER_NOT_FOUND' | 'SOURCE_NOT_FOUND' | 'SYNC_FAILED' | 'VECTOR_NOT_SUPPORTED' | 'READONLY_SOURCE' | 'INVALID_CONFIG';
+/**
+ * SQL error
+ */
+export declare class SQLError extends Error {
+    code: SQLErrorCode;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: SQLErrorCode, details?: Record<string, unknown> | undefined);
+}
+//# sourceMappingURL=types.d.ts.map