sqlew 4.3.1 → 5.0.0

package/dist/backend/backend-factory.js

@@ -0,0 +1,171 @@
+/**
+ * Backend Factory
+ *
+ * Creates and manages backend instances based on configuration.
+ * Supports LocalBackend (direct DB) and SaaS backend (submodule).
+ */
+import { CLOUD_ENV_VARS } from '../config/types.js';
+import { LocalBackend } from './local-backend.js';
+import { TransformingBackend } from './transforming-backend.js';
+import { createBackend as createSaaSBackend, resolveProject, } from '@sqlew/saas-connector';
+import { debugLog } from '../utils/debug-logger.js';
+import { loadCloudConfigFromGlobal, checkEnvFilePermissions, loadCachedProjectId, saveCachedProjectId, } from '../config/cloud-config-loader.js';
+/**
+ * Global backend instance (singleton)
+ */
+let globalBackend = null;
+let initialized = false;
+/**
+ * Check if the configuration specifies cloud mode
+ */
+export function isCloudMode(config) {
+    return config.database?.type === 'cloud';
+}
+/**
+ * Load cloud configuration from global ~/.sqlew.env or environment variables
+ *
+ * Flow:
+ * 1. Load API key from ~/.sqlew.env
+ * 2. Load project name from .sqlew/config.toml
+ * 3. Check cached project ID in ~/.sqlew.env
+ * 4. If not cached, resolve via /api/v1/project/resolve and cache
+ *
+ * @param projectRoot - Project root directory (for ConnectionIdentity)
+ * @returns CloudConfig or null if not configured
+ */
+export async function loadCloudConfig(projectRoot) {
+    // Check file permissions (Unix: warn if not 600)
+    const permCheck = checkEnvFilePermissions();
+    if (!permCheck.ok) {
+        console.warn(`⚠️  ${permCheck.message}`);
+    }
+    // Load base config (API key, project name, connection identity)
+    const baseConfig = loadCloudConfigFromGlobal(projectRoot);
+    if (!baseConfig) {
+        return null;
+    }
+    // Resolve project ID if project name is set
+    let projectId;
+    if (baseConfig.projectName) {
+        // 1. Check cache
+        const cachedId = loadCachedProjectId(baseConfig.projectName);
+        if (cachedId) {
+            projectId = cachedId;
+            debugLog('INFO', 'Using cached project ID', { projectName: baseConfig.projectName });
+        }
+        else {
+            // 2. Resolve via API
+            try {
+                debugLog('INFO', 'Resolving project ID via API', { projectName: baseConfig.projectName });
+                projectId = await resolveProject(baseConfig.apiKey, baseConfig.projectName);
+                // 3. Cache for future use
+                saveCachedProjectId(baseConfig.projectName, projectId);
+                debugLog('INFO', 'Project ID resolved and cached', { projectName: baseConfig.projectName });
+            }
+            catch (error) {
+                console.warn(`⚠️  Failed to resolve project ID: ${error instanceof Error ? error.message : String(error)}`);
+                // Continue without projectId - some features may not work
+            }
+        }
+    }
+    return {
+        ...baseConfig,
+        projectId,
+    };
+}
+/**
+ * Validate cloud configuration
+ */
+export function validateCloudConfig(config) {
+    const errors = [];
+    if (!config) {
+        errors.push(`${CLOUD_ENV_VARS.API_KEY} is required for cloud mode`);
+        return { valid: false, errors };
+    }
+    if (!config.apiKey) {
+        errors.push(`${CLOUD_ENV_VARS.API_KEY} is required for cloud mode`);
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Create a backend instance based on configuration
+ *
+ * @param config - sqlew configuration
+ * @param projectRoot - Project root directory
+ * @returns Backend instance
+ */
+export async function createBackend(config, projectRoot) {
+    if (isCloudMode(config)) {
+        // Load cloud config from environment (async: resolves project ID)
+        const cloudConfig = await loadCloudConfig(projectRoot);
+        const validation = validateCloudConfig(cloudConfig);
+        if (!validation.valid) {
+            throw new Error(validation.errors.join('; '));
+        }
+        // Create SaaS backend and wrap with TransformingBackend
+        // TransformingBackend handles quick_set → set transformation locally
+        try {
+            const saasBackend = createSaaSBackend(cloudConfig);
+            return new TransformingBackend(saasBackend);
+        }
+        catch (error) {
+            throw new Error(`SaaS connector initialization failed. Run: cd saas-connector && npm run build`);
+        }
+    }
+    // Default: LocalBackend
+    return new LocalBackend();
+}
+/**
+ * Initialize the global backend instance
+ *
+ * @param config - sqlew configuration
+ * @param projectRoot - Project root directory
+ * @returns Backend instance
+ */
+export async function initializeBackend(config, projectRoot) {
+    if (initialized && globalBackend) {
+        return globalBackend;
+    }
+    globalBackend = await createBackend(config, projectRoot);
+    initialized = true;
+    const modeInfo = globalBackend.backendType === 'saas'
+        ? `saas (${globalBackend.pluginName || 'saas-connector'})`
+        : globalBackend.backendType;
+    debugLog('INFO', 'Backend initialized', { type: modeInfo });
+    return globalBackend;
+}
+/**
+ * Get the current backend instance
+ *
+ * @returns Backend instance (creates LocalBackend if not initialized)
+ */
+export function getBackend() {
+    if (!globalBackend) {
+        console.error('⚠️  Backend not initialized, using default LocalBackend');
+        globalBackend = new LocalBackend();
+    }
+    return globalBackend;
+}
+/**
+ * Check if backend is initialized
+ */
+export function isBackendInitialized() {
+    return initialized;
+}
+/**
+ * Get current backend type
+ */
+export function getBackendType() {
+    return globalBackend?.backendType ?? null;
+}
+/**
+ * Reset backend state (for testing)
+ */
+export async function resetBackend() {
+    if (globalBackend) {
+        await globalBackend.disconnect();
+        globalBackend = null;
+    }
+    initialized = false;
+}
+//# sourceMappingURL=backend-factory.js.map

package/dist/backend/backend-factory.js.map

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

package/dist/backend/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Backend Module
+ *
+ * Provides abstraction layer for local and SaaS backends.
+ */
+export type { ToolBackend, HealthCheckResult, BackendType } from './types.js';
+export { LocalBackend } from './local-backend.js';
+export { TransformingBackend } from './transforming-backend.js';
+export { inferDecisionParams } from './inference.js';
+export type { InferredParams, InferenceResult } from './inference.js';
+export { initializeBackend, getBackend, isBackendInitialized, getBackendType, resetBackend, createBackend, isCloudMode, loadCloudConfig, validateCloudConfig, } from './backend-factory.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtE,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,EACX,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,13 @@
+/**
+ * Backend Module
+ *
+ * Provides abstraction layer for local and SaaS backends.
+ */
+// Backend implementations
+export { LocalBackend } from './local-backend.js';
+export { TransformingBackend } from './transforming-backend.js';
+// Inference utilities (for quick_set transformation)
+export { inferDecisionParams } from './inference.js';
+// Factory and global state
+export { initializeBackend, getBackend, isBackendInitialized, getBackendType, resetBackend, createBackend, isCloudMode, loadCloudConfig, validateCloudConfig, } from './backend-factory.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,qDAAqD;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrD,2BAA2B;AAC3B,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,EACX,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/backend/inference.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Inference logic for quick_set → set transformation
+ *
+ * Extracted from tools/context/actions/quick-set.ts for use in
+ * TransformingBackend when SaaS mode is active.
+ *
+ * @since v5.0.1
+ */
+/**
+ * Inferred parameters from key analysis
+ */
+export interface InferredParams {
+    layer?: string;
+    tags?: string[];
+    scope?: string;
+}
+/**
+ * Result of parameter inference
+ */
+export interface InferenceResult {
+    /** Transformed parameters ready for decision.set */
+    transformedParams: Record<string, unknown>;
+    /** What was inferred (for response metadata) */
+    inferred: InferredParams;
+}
+/**
+ * Infer decision parameters from key structure
+ *
+ * Inference Rules:
+ * - Layer: Inferred from key prefix (api/ → presentation, db/ → data, etc.)
+ * - Tags: Extracted from key hierarchy (split by /, -, _)
+ * - Scope: Parent path of key (everything except last part)
+ *
+ * @param params - Quick set parameters (key and value required)
+ * @returns Transformed params and inference metadata
+ */
+export declare function inferDecisionParams(params: Record<string, unknown>): InferenceResult;
+//# sourceMappingURL=inference.d.ts.map

package/dist/backend/inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../../src/backend/inference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,gDAAgD;IAChD,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAuDpF"}

package/dist/backend/inference.js

@@ -0,0 +1,76 @@
+/**
+ * Inference logic for quick_set → set transformation
+ *
+ * Extracted from tools/context/actions/quick-set.ts for use in
+ * TransformingBackend when SaaS mode is active.
+ *
+ * @since v5.0.1
+ */
+/**
+ * Infer decision parameters from key structure
+ *
+ * Inference Rules:
+ * - Layer: Inferred from key prefix (api/ → presentation, db/ → data, etc.)
+ * - Tags: Extracted from key hierarchy (split by /, -, _)
+ * - Scope: Parent path of key (everything except last part)
+ *
+ * @param params - Quick set parameters (key and value required)
+ * @returns Transformed params and inference metadata
+ */
+export function inferDecisionParams(params) {
+    const key = params.key;
+    const inferred = {};
+    // Layer inference from key prefix
+    let layer = params.layer;
+    if (!layer) {
+        const keyLower = key.toLowerCase();
+        if (keyLower.startsWith('api/') || keyLower.startsWith('endpoint/') || keyLower.startsWith('ui/')) {
+            layer = 'presentation';
+        }
+        else if (keyLower.startsWith('service/') || keyLower.startsWith('logic/') || keyLower.startsWith('workflow/')) {
+            layer = 'business';
+        }
+        else if (keyLower.startsWith('db/') || keyLower.startsWith('model/') || keyLower.startsWith('schema/')) {
+            layer = 'data';
+        }
+        else if (keyLower.startsWith('config/') || keyLower.startsWith('deploy/')) {
+            layer = 'infrastructure';
+        }
+        else {
+            layer = 'business'; // Default layer
+        }
+        inferred.layer = layer;
+    }
+    // Tags extraction from key hierarchy
+    let tags = params.tags;
+    if (!tags || tags.length === 0) {
+        // Split key by '/', '-', or '_' to get hierarchy parts
+        tags = key.split(/[\/\-_]/).filter((p) => p.trim() !== '');
+        inferred.tags = tags;
+    }
+    // Scope inference from key hierarchy
+    let scopes = params.scopes;
+    if (!scopes || scopes.length === 0) {
+        // Get parent scope from key (everything except last part)
+        const parts = key.split('/');
+        if (parts.length > 1) {
+            const scope = parts.slice(0, -1).join('/');
+            scopes = [scope];
+            inferred.scope = scope;
+        }
+    }
+    return {
+        transformedParams: {
+            key: params.key,
+            value: params.value,
+            agent: params.agent,
+            layer,
+            version: params.version || 'v1.0.0',
+            status: params.status || 'active',
+            tags,
+            scopes,
+        },
+        inferred,
+    };
+}
+//# sourceMappingURL=inference.js.map

package/dist/backend/inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.js","sourceRoot":"","sources":["../../src/backend/inference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IACjE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAa,CAAC;IACjC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,kCAAkC;IAClC,IAAI,KAAK,GAAG,MAAM,CAAC,KAA2B,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACnC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAClG,KAAK,GAAG,cAAc,CAAC;QACzB,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChH,KAAK,GAAG,UAAU,CAAC;QACrB,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACzG,KAAK,GAAG,MAAM,CAAC;QACjB,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5E,KAAK,GAAG,gBAAgB,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,UAAU,CAAC,CAAC,gBAAgB;QACtC,CAAC;QACD,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,qCAAqC;IACrC,IAAI,IAAI,GAAG,MAAM,CAAC,IAA4B,CAAC;IAC/C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,uDAAuD;QACvD,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACnE,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,qCAAqC;IACrC,IAAI,MAAM,GAAG,MAAM,CAAC,MAA8B,CAAC;IACnD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,0DAA0D;QAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC;YACjB,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO;QACL,iBAAiB,EAAE;YACjB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,QAAQ;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ;YACjC,IAAI;YACJ,MAAM;SACP;QACD,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/backend/local-backend.d.ts

@@ -0,0 +1,40 @@
+/**
+ * LocalBackend - Direct database connection via Knex
+ *
+ * This backend executes tool actions directly against the local database.
+ * All existing tool logic is wrapped here for the ToolBackend abstraction.
+ */
+import type { ToolBackend, HealthCheckResult, BackendType } from './types.js';
+/**
+ * LocalBackend implementation
+ *
+ * Wraps all existing tool logic for the ToolBackend abstraction.
+ */
+export declare class LocalBackend implements ToolBackend {
+    readonly backendType: BackendType;
+    /**
+     * Execute a tool action against the local database
+     */
+    execute<TResponse = unknown>(tool: string, action: string, params: Record<string, unknown>): Promise<TResponse>;
+    /**
+     * Health check - verify database connection
+     */
+    healthCheck(): Promise<HealthCheckResult>;
+    /**
+     * Disconnect from database
+     */
+    disconnect(): Promise<void>;
+    private executeDecision;
+    private executeConstraint;
+    private executeHelp;
+    private executeExample;
+    private executeUseCase;
+    /**
+     * Get project root path for file-based operations
+     *
+     * Priority: ProjectContext.project_root_path > process.cwd()
+     */
+    private getProjectRoot;
+    private executeQueue;
+}
+//# sourceMappingURL=local-backend.d.ts.map

package/dist/backend/local-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-backend.d.ts","sourceRoot":"","sources":["../../src/backend/local-backend.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA8B9E;;;;GAIG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAW;IAE5C;;OAEG;IACG,OAAO,CAAC,SAAS,GAAG,OAAO,EAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,SAAS,CAAC;IAkCrB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAmB/C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAgBnB,eAAe;YA+Ff,iBAAiB;YAgCjB,WAAW;YAmDX,cAAc;YA2Cd,cAAc;IAuC5B;;;;OAIG;IACH,OAAO,CAAC,cAAc;YASR,YAAY;CAiD3B"}