@opensaas/stack-rag 0.1.6 → 0.3.0

package/dist/runtime/provider-helpers.js

@@ -0,0 +1,95 @@
+/**
+ * Helper utilities for working with embedding providers
+ * Simplifies provider creation from environment variables
+ */
+import { createEmbeddingProvider } from '../providers/index.js';
+import 'dotenv/config';
+/**
+ * Create an embedding provider from environment variables
+ *
+ * Reads configuration from environment variables:
+ * - EMBEDDING_PROVIDER: 'openai' or 'ollama' (default: 'openai')
+ * - OPENAI_API_KEY: Required if using OpenAI
+ * - OLLAMA_BASE_URL: Ollama endpoint (default: 'http://localhost:11434')
+ *
+ * @param overrides - Optional overrides for environment config
+ * @returns Configured embedding provider
+ *
+ * @example
+ * ```typescript
+ * import { createProviderFromEnv } from '@opensaas/stack-rag/runtime'
+ *
+ * // Uses EMBEDDING_PROVIDER and OPENAI_API_KEY from env
+ * const provider = createProviderFromEnv()
+ *
+ * // Override provider type
+ * const ollamaProvider = createProviderFromEnv({ provider: 'ollama' })
+ * ```
+ */
+export function createProviderFromEnv(overrides) {
+    const providerType = overrides?.provider || process.env.EMBEDDING_PROVIDER || 'openai';
+    let config;
+    if (providerType === 'openai') {
+        const apiKey = overrides?.openaiApiKey || process.env.OPENAI_API_KEY;
+        if (!apiKey) {
+            throw new Error('OPENAI_API_KEY environment variable is required when using OpenAI provider');
+        }
+        config = {
+            type: 'openai',
+            apiKey,
+            model: overrides?.model ||
+                'text-embedding-3-small',
+        };
+    }
+    else if (providerType === 'ollama') {
+        config = {
+            type: 'ollama',
+            baseURL: overrides?.ollamaBaseUrl || process.env.OLLAMA_BASE_URL || 'http://localhost:11434',
+            model: overrides?.model || 'nomic-embed-text',
+        };
+    }
+    else {
+        throw new Error(`Unknown provider type: ${providerType}. Supported: openai, ollama`);
+    }
+    return createEmbeddingProvider(config);
+}
+/**
+ * Get provider configuration from environment
+ *
+ * Useful for inspecting what provider would be used without creating it.
+ *
+ * @returns Provider configuration object
+ *
+ * @example
+ * ```typescript
+ * import { getProviderConfigFromEnv } from '@opensaas/stack-rag/runtime'
+ *
+ * const config = getProviderConfigFromEnv()
+ * console.log(`Using ${config.type} provider`)
+ * ```
+ */
+export function getProviderConfigFromEnv() {
+    const providerType = process.env.EMBEDDING_PROVIDER || 'openai';
+    if (providerType === 'openai') {
+        const apiKey = process.env.OPENAI_API_KEY;
+        if (!apiKey) {
+            throw new Error('OPENAI_API_KEY environment variable is required');
+        }
+        return {
+            type: 'openai',
+            apiKey,
+            model: 'text-embedding-3-small',
+        };
+    }
+    else if (providerType === 'ollama') {
+        return {
+            type: 'ollama',
+            baseURL: process.env.OLLAMA_BASE_URL || 'http://localhost:11434',
+            model: 'nomic-embed-text',
+        };
+    }
+    else {
+        throw new Error(`Unknown provider type: ${providerType}`);
+    }
+}
+//# sourceMappingURL=provider-helpers.js.map

package/dist/runtime/provider-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-helpers.js","sourceRoot":"","sources":["../../src/runtime/provider-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAG/D,OAAO,eAAe,CAAA;AAOtB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAKrC;IACC,MAAM,YAAY,GAChB,SAAS,EAAE,QAAQ,IAAK,OAAO,CAAC,GAAG,CAAC,kBAAmC,IAAI,QAAQ,CAAA;IAErF,IAAI,MAA+B,CAAA;IAEnC,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,SAAS,EAAE,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;QAEpE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAA;QAC/F,CAAC;QAED,MAAM,GAAG;YACP,IAAI,EAAE,QAAQ;YACd,MAAM;YACN,KAAK,EACF,SAAS,EAAE,KAA6D;gBACzE,wBAAwB;SAC3B,CAAA;IACH,CAAC;SAAM,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,GAAG;YACP,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,SAAS,EAAE,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,wBAAwB;YAC5F,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,kBAAkB;SAC9C,CAAA;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,6BAA6B,CAAC,CAAA;IACtF,CAAC;IAED,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,YAAY,GAAI,OAAO,CAAC,GAAG,CAAC,kBAAmC,IAAI,QAAQ,CAAA;IAEjF,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;QAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;QACpE,CAAC;QAED,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,MAAM;YACN,KAAK,EAAE,wBAAwB;SAChC,CAAA;IACH,CAAC;SAAM,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,wBAAwB;YAChE,KAAK,EAAE,kBAAkB;SAC1B,CAAA;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC"}

package/dist/runtime/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Type definitions for RAG plugin runtime services
+ * These types are used for type-safe access to context.plugins.rag
+ */
+/**
+ * Runtime services provided by the RAG plugin
+ * Available via context.plugins.rag
+ */
+export interface RAGRuntimeServices {
+    /**
+     * Generate embedding for a given text
+     * Uses the configured embedding provider
+     *
+     * @param text - The text to generate an embedding for
+     * @param providerName - Optional provider name if multiple providers are configured
+     * @returns Vector embedding as array of numbers
+     */
+    generateEmbedding: (text: string, providerName?: string) => Promise<number[]>;
+    /**
+     * Generate embeddings for multiple texts (batch)
+     * More efficient than calling generateEmbedding multiple times
+     *
+     * @param texts - Array of texts to generate embeddings for
+     * @param providerName - Optional provider name if multiple providers are configured
+     * @returns Array of vector embeddings
+     */
+    generateEmbeddings: (texts: string[], providerName?: string) => Promise<number[][]>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAE7E;;;;;;;OAOG;IACH,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;CACpF"}

package/dist/runtime/types.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for RAG plugin runtime services
+ * These types are used for type-safe access to context.plugins.rag
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/runtime/types.js.map

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

package/dist/storage/access-filter.d.ts

@@ -0,0 +1,30 @@
+import type { AccessContext, PrismaFilter } from '@opensaas/stack-core';
+import type { OpenSaasConfig } from '@opensaas/stack-core';
+/**
+ * Build access control filter for a given list and context
+ * Extracts the filter that would be applied by the access control engine
+ *
+ * @param listKey - The list name (e.g., 'Post', 'Article')
+ * @param context - The access context with session
+ * @param config - The OpenSaas configuration
+ * @returns Prisma filter object or null if access is denied
+ */
+export declare function buildAccessControlFilter(listKey: string, context: AccessContext, config: OpenSaasConfig): Promise<PrismaFilter | null>;
+/**
+ * Merge access control filter with user-provided where clause
+ *
+ * @param accessFilter - Filter from access control
+ * @param userWhere - User-provided where clause
+ * @returns Combined filter or null if access is denied
+ */
+export declare function mergeAccessFilter(accessFilter: PrismaFilter | null, userWhere?: Record<string, unknown>): PrismaFilter | null;
+/**
+ * Convert a Prisma filter object to SQL WHERE clause
+ * Handles common Prisma filter operators
+ *
+ * @param filter - Prisma filter object
+ * @param tableName - Table name for column references
+ * @returns SQL WHERE clause string (without "WHERE" keyword)
+ */
+export declare function prismaFilterToSQL(filter: PrismaFilter, tableName?: string): string;
+//# sourceMappingURL=access-filter.d.ts.map

package/dist/storage/access-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-filter.d.ts","sourceRoot":"","sources":["../../src/storage/access-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAiB,MAAM,sBAAsB,CAAA;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAoD1D;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAiC9B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACtC,YAAY,GAAG,IAAI,CAMrB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAiJlF"}

package/dist/storage/access-filter.js

@@ -0,0 +1,241 @@
+/**
+ * Execute an access control function (copied from @opensaas/stack-core/access)
+ */
+async function checkAccess(accessControl, args) {
+    // No access control means deny by default
+    if (!accessControl) {
+        return false;
+    }
+    // Execute the access control function
+    const result = await accessControl(args);
+    return result;
+}
+/**
+ * Merge user filter with access control filter (copied from @opensaas/stack-core/access)
+ */
+function mergeFilters(userFilter, accessFilter) {
+    // If access is denied, return null
+    if (accessFilter === false) {
+        return null;
+    }
+    // If access is fully granted, use user filter
+    if (accessFilter === true) {
+        return userFilter || {};
+    }
+    // Merge access filter with user filter
+    if (!userFilter) {
+        return accessFilter;
+    }
+    // Combine filters with AND
+    return {
+        AND: [accessFilter, userFilter],
+    };
+}
+/**
+ * Build access control filter for a given list and context
+ * Extracts the filter that would be applied by the access control engine
+ *
+ * @param listKey - The list name (e.g., 'Post', 'Article')
+ * @param context - The access context with session
+ * @param config - The OpenSaas configuration
+ * @returns Prisma filter object or null if access is denied
+ */
+export async function buildAccessControlFilter(listKey, context, config) {
+    const listConfig = config.lists[listKey];
+    if (!listConfig) {
+        throw new Error(`List '${listKey}' not found in config`);
+    }
+    // Check query access control
+    const queryAccess = listConfig.access?.operation?.query;
+    if (!queryAccess) {
+        // No access control means deny by default (following OpenSaaS Stack pattern)
+        return null;
+    }
+    // Execute access control function
+    const accessResult = await checkAccess(queryAccess, {
+        session: context.session,
+        context,
+    });
+    // If access is denied (false), return null
+    if (accessResult === false) {
+        return null;
+    }
+    // If access is fully granted (true), return empty filter
+    if (accessResult === true) {
+        return {};
+    }
+    // Otherwise, return the filter object
+    return accessResult;
+}
+/**
+ * Merge access control filter with user-provided where clause
+ *
+ * @param accessFilter - Filter from access control
+ * @param userWhere - User-provided where clause
+ * @returns Combined filter or null if access is denied
+ */
+export function mergeAccessFilter(accessFilter, userWhere = {}) {
+    if (accessFilter === null) {
+        return null;
+    }
+    return mergeFilters(userWhere, accessFilter);
+}
+/**
+ * Convert a Prisma filter object to SQL WHERE clause
+ * Handles common Prisma filter operators
+ *
+ * @param filter - Prisma filter object
+ * @param tableName - Table name for column references
+ * @returns SQL WHERE clause string (without "WHERE" keyword)
+ */
+export function prismaFilterToSQL(filter, tableName) {
+    if (!filter || Object.keys(filter).length === 0) {
+        return 'TRUE'; // No filter means all records
+    }
+    const conditions = [];
+    for (const [key, value] of Object.entries(filter)) {
+        // Handle logical operators
+        if (key === 'AND') {
+            if (!Array.isArray(value))
+                continue;
+            const andConditions = value
+                .map((subFilter) => prismaFilterToSQL(subFilter, tableName))
+                .filter((c) => c !== 'TRUE');
+            if (andConditions.length > 0) {
+                conditions.push(`(${andConditions.join(' AND ')})`);
+            }
+            continue;
+        }
+        if (key === 'OR') {
+            if (!Array.isArray(value))
+                continue;
+            const orConditions = value
+                .map((subFilter) => prismaFilterToSQL(subFilter, tableName))
+                .filter((c) => c !== 'TRUE');
+            if (orConditions.length > 0) {
+                conditions.push(`(${orConditions.join(' OR ')})`);
+            }
+            continue;
+        }
+        if (key === 'NOT') {
+            const notCondition = prismaFilterToSQL(value, tableName);
+            if (notCondition !== 'TRUE') {
+                conditions.push(`NOT (${notCondition})`);
+            }
+            continue;
+        }
+        // Handle field conditions
+        const columnName = tableName ? `"${tableName}"."${key}"` : `"${key}"`;
+        if (value === null) {
+            conditions.push(`${columnName} IS NULL`);
+            continue;
+        }
+        if (typeof value !== 'object' || value === null) {
+            // Direct equality
+            const escapedValue = escapeSQLValue(value);
+            conditions.push(`${columnName} = ${escapedValue}`);
+            continue;
+        }
+        // Handle nested field conditions
+        const fieldConditions = [];
+        for (const [operator, operatorValue] of Object.entries(value)) {
+            switch (operator) {
+                case 'equals':
+                    if (operatorValue === null) {
+                        fieldConditions.push(`${columnName} IS NULL`);
+                    }
+                    else {
+                        fieldConditions.push(`${columnName} = ${escapeSQLValue(operatorValue)}`);
+                    }
+                    break;
+                case 'not':
+                    if (operatorValue === null) {
+                        fieldConditions.push(`${columnName} IS NOT NULL`);
+                    }
+                    else {
+                        fieldConditions.push(`${columnName} != ${escapeSQLValue(operatorValue)}`);
+                    }
+                    break;
+                case 'in':
+                    if (Array.isArray(operatorValue) && operatorValue.length > 0) {
+                        const values = operatorValue.map((v) => escapeSQLValue(v)).join(', ');
+                        fieldConditions.push(`${columnName} IN (${values})`);
+                    }
+                    break;
+                case 'notIn':
+                    if (Array.isArray(operatorValue) && operatorValue.length > 0) {
+                        const values = operatorValue.map((v) => escapeSQLValue(v)).join(', ');
+                        fieldConditions.push(`${columnName} NOT IN (${values})`);
+                    }
+                    break;
+                case 'lt':
+                    fieldConditions.push(`${columnName} < ${escapeSQLValue(operatorValue)}`);
+                    break;
+                case 'lte':
+                    fieldConditions.push(`${columnName} <= ${escapeSQLValue(operatorValue)}`);
+                    break;
+                case 'gt':
+                    fieldConditions.push(`${columnName} > ${escapeSQLValue(operatorValue)}`);
+                    break;
+                case 'gte':
+                    fieldConditions.push(`${columnName} >= ${escapeSQLValue(operatorValue)}`);
+                    break;
+                case 'contains':
+                    fieldConditions.push(`${columnName} LIKE ${escapeSQLValue(`%${operatorValue}%`)}`);
+                    break;
+                case 'startsWith':
+                    fieldConditions.push(`${columnName} LIKE ${escapeSQLValue(`${operatorValue}%`)}`);
+                    break;
+                case 'endsWith':
+                    fieldConditions.push(`${columnName} LIKE ${escapeSQLValue(`%${operatorValue}`)}`);
+                    break;
+                case 'isNull':
+                    if (operatorValue === true) {
+                        fieldConditions.push(`${columnName} IS NULL`);
+                    }
+                    else {
+                        fieldConditions.push(`${columnName} IS NOT NULL`);
+                    }
+                    break;
+                // Add more operators as needed
+                default:
+                    console.warn(`Unsupported Prisma filter operator: ${operator}`);
+            }
+        }
+        if (fieldConditions.length > 0) {
+            conditions.push(fieldConditions.join(' AND '));
+        }
+    }
+    if (conditions.length === 0) {
+        return 'TRUE';
+    }
+    if (conditions.length === 1) {
+        return conditions[0];
+    }
+    return conditions.join(' AND ');
+}
+/**
+ * Escape SQL values to prevent SQL injection
+ * Basic escaping - in production, use parameterized queries
+ */
+function escapeSQLValue(value) {
+    if (value === null) {
+        return 'NULL';
+    }
+    if (typeof value === 'string') {
+        // Escape single quotes by doubling them
+        return `'${value.replace(/'/g, "''")}'`;
+    }
+    if (typeof value === 'number') {
+        return value.toString();
+    }
+    if (typeof value === 'boolean') {
+        return value ? 'TRUE' : 'FALSE';
+    }
+    if (value instanceof Date) {
+        return `'${value.toISOString()}'`;
+    }
+    // Fallback for other types
+    return `'${String(value).replace(/'/g, "''")}'`;
+}
+//# sourceMappingURL=access-filter.js.map

package/dist/storage/access-filter.js.map

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

package/dist/storage/index.d.ts

@@ -36,6 +36,8 @@ export declare function registerVectorStorage(type: string, factory: (config: Ve
 export declare function createVectorStorage(config: VectorStorageConfig): VectorStorage;
 export * from './types.js';
 export { JsonVectorStorage, createJsonStorage } from './json.js';
+export { JsonFileStorage, createJsonFileStorage } from './json-file.js';
 export { PgVectorStorage, createPgVectorStorage } from './pgvector.js';
 export { SqliteVssStorage, createSqliteVssStorage } from './sqlite-vss.js';
+export { buildAccessControlFilter, mergeAccessFilter, prismaFilterToSQL } from './access-filter.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AA4B7D;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,aAAa,GACtD,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAW9E;AAGD,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AA4B7D;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,aAAa,GACtD,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAW9E;AAGD,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACvE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAG1E,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/storage/index.js

@@ -68,6 +68,9 @@ export function createVectorStorage(config) {
 // Export types and individual storage backends
 export * from './types.js';
 export { JsonVectorStorage, createJsonStorage } from './json.js';
+export { JsonFileStorage, createJsonFileStorage } from './json-file.js';
 export { PgVectorStorage, createPgVectorStorage } from './pgvector.js';
 export { SqliteVssStorage, createSqliteVssStorage } from './sqlite-vss.js';
+// Export access control utilities
+export { buildAccessControlFilter, mergeAccessFilter, prismaFilterToSQL } from './access-filter.js';
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAExD;;;GAGG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA0D,CAAA;AAE1F;;GAEG;AACH,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAA;AACvD,gBAAgB,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;IAC7D,CAAC;IACD,OAAO,qBAAqB,CAAC,MAA4D,CAAC,CAAA;AAC5F,CAAC,CAAC,CAAA;AACF,gBAAgB,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;IAC5C,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,sBAAsB,CAAC,MAA6D,CAAC,CAAA;AAC9F,CAAC,CAAC,CAAA;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAY,EACZ,OAAuD;IAEvD,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAEjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,CAAC,IAAI,IAAI;YAC7C,uBAAuB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1E,CAAA;IACH,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAA;AACxB,CAAC;AAED,+CAA+C;AAC/C,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAExD;;;GAGG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA0D,CAAA;AAE1F;;GAEG;AACH,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAA;AACvD,gBAAgB,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;IAC7D,CAAC;IACD,OAAO,qBAAqB,CAAC,MAA4D,CAAC,CAAA;AAC5F,CAAC,CAAC,CAAA;AACF,gBAAgB,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;IAC5C,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,sBAAsB,CAAC,MAA6D,CAAC,CAAA;AAC9F,CAAC,CAAC,CAAA;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAY,EACZ,OAAuD;IAEvD,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAEjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,CAAC,IAAI,IAAI;YAC7C,uBAAuB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1E,CAAA;IACH,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAA;AACxB,CAAC;AAED,+CAA+C;AAC/C,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACvE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAE1E,kCAAkC;AAClC,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/storage/json-file.d.ts

@@ -0,0 +1,53 @@
+import type { VectorStorage, SearchOptions } from './types.js';
+import type { SearchResult, EmbeddingsIndex } from '../config/types.js';
+/**
+ * JSON file-based vector storage
+ * Loads embeddings from a JSON file generated at build time
+ * Performs similarity search in JavaScript without database queries
+ * Ideal for static sites, documentation, and build-time generated embeddings
+ */
+export declare class JsonFileStorage implements VectorStorage {
+    readonly type = "json-file";
+    private index;
+    private filePath;
+    constructor(filePath: string);
+    /**
+     * Load embeddings index from file
+     * Caches the result in memory
+     */
+    private loadIndex;
+    /**
+     * Search for similar documents using JavaScript-based cosine similarity
+     * Note: listKey parameter is included for interface compatibility but not used
+     * since this storage is typically used for standalone content (e.g., docs)
+     */
+    search<T = unknown>(_listKey: string, _fieldName: string, queryVector: number[], options: SearchOptions): Promise<SearchResult<T>[]>;
+    /**
+     * Calculate cosine similarity between two vectors
+     */
+    cosineSimilarity(a: number[], b: number[]): number;
+    /**
+     * Get the loaded index for inspection
+     */
+    getIndex(): EmbeddingsIndex | null;
+    /**
+     * Force reload the index from disk
+     */
+    reloadIndex(): void;
+}
+/**
+ * Create a JSON file vector storage instance
+ *
+ * @example
+ * ```typescript
+ * import { createJsonFileStorage } from '@opensaas/stack-rag/storage'
+ *
+ * const storage = createJsonFileStorage('.embeddings/docs.json')
+ * const results = await storage.search('', '', queryVector, {
+ *   limit: 10,
+ *   minScore: 0.7
+ * })
+ * ```
+ */
+export declare function createJsonFileStorage(filePath: string): JsonFileStorage;
+//# sourceMappingURL=json-file.d.ts.map

package/dist/storage/json-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.d.ts","sourceRoot":"","sources":["../../src/storage/json-file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGvE;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,IAAI,eAAc;IAE3B,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,QAAQ,EAAE,MAAM;IAI5B;;;OAGG;IACH,OAAO,CAAC,SAAS;IAoBjB;;;;OAIG;IACG,MAAM,CAAC,CAAC,GAAG,OAAO,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IA8D7B;;OAEG;IACH,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAIlD;;OAEG;IACH,QAAQ,IAAI,eAAe,GAAG,IAAI;IAIlC;;OAEG;IACH,WAAW,IAAI,IAAI;CAIpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAEvE"}

package/dist/storage/json-file.js

@@ -0,0 +1,124 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { cosineSimilarity as calculateCosineSimilarity } from './types.js';
+/**
+ * JSON file-based vector storage
+ * Loads embeddings from a JSON file generated at build time
+ * Performs similarity search in JavaScript without database queries
+ * Ideal for static sites, documentation, and build-time generated embeddings
+ */
+export class JsonFileStorage {
+    type = 'json-file';
+    index = null;
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    /**
+     * Load embeddings index from file
+     * Caches the result in memory
+     */
+    loadIndex() {
+        if (this.index) {
+            return this.index;
+        }
+        if (!existsSync(this.filePath)) {
+            throw new Error(`Embeddings file not found: ${this.filePath}. Run embeddings generation first.`);
+        }
+        try {
+            const content = readFileSync(this.filePath, 'utf-8');
+            this.index = JSON.parse(content);
+            return this.index;
+        }
+        catch (error) {
+            throw new Error(`Failed to load embeddings from ${this.filePath}: ${error}`);
+        }
+    }
+    /**
+     * Search for similar documents using JavaScript-based cosine similarity
+     * Note: listKey parameter is included for interface compatibility but not used
+     * since this storage is typically used for standalone content (e.g., docs)
+     */
+    async search(_listKey, _fieldName, queryVector, options) {
+        const { limit = 10, minScore = 0.0, where = {} } = options;
+        const index = this.loadIndex();
+        // Validate query vector dimensions against index config
+        if (queryVector.length !== index.config.dimensions) {
+            throw new Error(`Query vector dimensions (${queryVector.length}) don't match index dimensions (${index.config.dimensions})`);
+        }
+        const results = [];
+        // Search through all documents and chunks
+        for (const [documentId, document] of Object.entries(index.documents)) {
+            // Apply where filters if provided (simple equality check)
+            if (where && Object.keys(where).length > 0) {
+                let matches = true;
+                for (const [key, value] of Object.entries(where)) {
+                    if (document[key] !== value) {
+                        matches = false;
+                        break;
+                    }
+                }
+                if (!matches)
+                    continue;
+            }
+            // Search through each chunk
+            for (const chunk of document.chunks) {
+                const score = this.cosineSimilarity(queryVector, chunk.embedding);
+                if (score >= minScore) {
+                    results.push({
+                        item: {
+                            documentId,
+                            title: document.title,
+                            content: chunk.text,
+                            chunkIndex: chunk.metadata.chunkIndex,
+                            metadata: chunk.metadata,
+                        },
+                        score,
+                        distance: 1 - score,
+                        documentId,
+                        chunkIndex: chunk.metadata.chunkIndex,
+                    });
+                }
+            }
+        }
+        // Sort by score (descending) and limit results
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, limit);
+    }
+    /**
+     * Calculate cosine similarity between two vectors
+     */
+    cosineSimilarity(a, b) {
+        return calculateCosineSimilarity(a, b);
+    }
+    /**
+     * Get the loaded index for inspection
+     */
+    getIndex() {
+        return this.index;
+    }
+    /**
+     * Force reload the index from disk
+     */
+    reloadIndex() {
+        this.index = null;
+        this.loadIndex();
+    }
+}
+/**
+ * Create a JSON file vector storage instance
+ *
+ * @example
+ * ```typescript
+ * import { createJsonFileStorage } from '@opensaas/stack-rag/storage'
+ *
+ * const storage = createJsonFileStorage('.embeddings/docs.json')
+ * const results = await storage.search('', '', queryVector, {
+ *   limit: 10,
+ *   minScore: 0.7
+ * })
+ * ```
+ */
+export function createJsonFileStorage(filePath) {
+    return new JsonFileStorage(filePath);
+}
+//# sourceMappingURL=json-file.js.map

package/dist/storage/json-file.js.map

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