@aphexcms/cms-core 0.1.12 → 0.1.14

package/dist/routes/documents-query.d.ts

@@ -0,0 +1,24 @@
+import type { RequestHandler } from '@sveltejs/kit';
+/**
+ * POST /api/documents/query - Advanced document querying with complex filters
+ *
+ * Accepts LocalAPI FindOptions in request body for full filtering power
+ *
+ * @example
+ * POST /api/documents/query
+ * {
+ *   "type": "page",
+ *   "where": {
+ *     "status": { "equals": "published" },
+ *     "hero.heading": { "contains": "Welcome" },
+ *     "publishedAt": { "gte": "2024-01-01" }
+ *   },
+ *   "limit": 20,
+ *   "page": 1,
+ *   "sort": ["-publishedAt", "title"],
+ *   "depth": 1,
+ *   "perspective": "published"
+ * }
+ */
+export declare const POST: RequestHandler;
+//# sourceMappingURL=documents-query.d.ts.map

package/dist/routes/documents-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents-query.d.ts","sourceRoot":"","sources":["../../src/lib/routes/documents-query.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AASpD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,IAAI,EAAE,cAqFlB,CAAC"}

package/dist/routes/documents-query.js

@@ -0,0 +1,95 @@
+// Aphex CMS Document Query API - Complex filtering with POST
+import { json } from '@sveltejs/kit';
+import { authToContext } from '../local-api/auth-helpers.js';
+import { PermissionError } from '../local-api/permissions.js';
+// Default values
+const DEFAULT_PAGE_SIZE = 20;
+const DEFAULT_PAGE = 1;
+/**
+ * POST /api/documents/query - Advanced document querying with complex filters
+ *
+ * Accepts LocalAPI FindOptions in request body for full filtering power
+ *
+ * @example
+ * POST /api/documents/query
+ * {
+ *   "type": "page",
+ *   "where": {
+ *     "status": { "equals": "published" },
+ *     "hero.heading": { "contains": "Welcome" },
+ *     "publishedAt": { "gte": "2024-01-01" }
+ *   },
+ *   "limit": 20,
+ *   "page": 1,
+ *   "sort": ["-publishedAt", "title"],
+ *   "depth": 1,
+ *   "perspective": "published"
+ * }
+ */
+export const POST = async ({ request, locals }) => {
+    try {
+        const { localAPI } = locals.aphexCMS;
+        const context = authToContext(locals.auth);
+        const body = await request.json();
+        // Extract document type
+        const documentType = body.type;
+        if (!documentType) {
+            return json({
+                success: false,
+                error: 'Bad Request',
+                message: 'Document type is required in request body'
+            }, { status: 400 });
+        }
+        // Check if collection exists
+        if (!localAPI.hasCollection(documentType)) {
+            return json({
+                success: false,
+                error: 'Invalid document type',
+                message: `Collection '${documentType}' not found. Available: ${localAPI.getCollectionNames().join(', ')}`
+            }, { status: 400 });
+        }
+        // Parse pagination - support both page-based and offset-based
+        const page = body.page ? Math.max(1, parseInt(body.page)) : DEFAULT_PAGE;
+        const pageSize = body.pageSize || body.limit || DEFAULT_PAGE_SIZE;
+        const offset = body.offset !== undefined ? body.offset : (page - 1) * pageSize;
+        // Build FindOptions from request body
+        const findOptions = {
+            where: body.where,
+            limit: pageSize,
+            offset: offset,
+            sort: body.sort,
+            depth: body.depth !== undefined ? Math.max(0, Math.min(body.depth, 5)) : 0,
+            select: body.select,
+            perspective: body.perspective || 'draft'
+        };
+        // Query via LocalAPI
+        const result = await localAPI.collections[documentType].find(context, findOptions);
+        return json({
+            success: true,
+            data: result.docs,
+            pagination: {
+                total: result.totalDocs,
+                page: result.page,
+                pageSize: result.limit,
+                totalPages: result.totalPages,
+                hasNextPage: result.hasNextPage,
+                hasPrevPage: result.hasPrevPage
+            }
+        });
+    }
+    catch (error) {
+        console.error('Failed to query documents:', error);
+        if (error instanceof PermissionError) {
+            return json({
+                success: false,
+                error: 'Forbidden',
+                message: error.message
+            }, { status: 403 });
+        }
+        return json({
+            success: false,
+            error: 'Failed to query documents',
+            message: error instanceof Error ? error.message : 'Unknown error'
+        }, { status: 500 });
+    }
+};

package/dist/routes/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/lib/routes/documents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAQpD,eAAO,MAAM,GAAG,EAAE,cAsEjB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,cAwFlB,CAAC"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/lib/routes/documents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AASpD,eAAO,MAAM,GAAG,EAAE,cAiGjB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,cAsElB,CAAC"}

package/dist/routes/documents.js

@@ -1,63 +1,81 @@
 // Aphex CMS Document API Handlers
 import { json } from '@sveltejs/kit';
-import { canWrite } from '../types/auth.js';
+import { authToContext } from '../local-api/auth-helpers.js';
+import { PermissionError } from '../local-api/permissions.js';
 // Default values for API
-const DEFAULT_API_LIMIT = 20;
-const DEFAULT_API_OFFSET = 0;
-// GET /api/documents - List documents with filtering
+const DEFAULT_PAGE_SIZE = 20;
+const DEFAULT_PAGE = 1;
+// GET /api/documents - Simple document listing with basic filters
 export const GET = async ({ url, locals }) => {
     try {
-        const { databaseAdapter } = locals.aphexCMS;
-        const auth = locals.auth;
-        if (!auth) {
+        const { localAPI } = locals.aphexCMS;
+        const context = authToContext(locals.auth);
+        // Parse query params
+        const docType = url.searchParams.get('type') || url.searchParams.get('docType');
+        const status = url.searchParams.get('status');
+        const pageParam = url.searchParams.get('page');
+        const pageSizeParam = url.searchParams.get('pageSize') || url.searchParams.get('limit');
+        const depthParam = url.searchParams.get('depth');
+        const sortParam = url.searchParams.get('sort');
+        const perspective = url.searchParams.get('perspective') || 'draft';
+        // Parse pagination
+        const page = pageParam ? Math.max(1, parseInt(pageParam)) : DEFAULT_PAGE;
+        const pageSize = pageSizeParam ? parseInt(pageSizeParam) : DEFAULT_PAGE_SIZE;
+        const offset = (page - 1) * pageSize;
+        // Parse depth (clamp between 0-5)
+        const depth = depthParam ? Math.max(0, Math.min(parseInt(depthParam), 5)) : 0;
+        if (!docType) {
             return json({
                 success: false,
-                error: 'Unauthorized',
-                message: 'Authentication required'
-            }, { status: 401 });
+                error: 'Bad Request',
+                message: 'Document type is required. Use ?type=page or ?docType=page'
+            }, { status: 400 });
         }
-        const docType = url.searchParams.get('docType');
-        const status = url.searchParams.get('status') || undefined;
-        const limitParam = url.searchParams.get('limit');
-        const offsetParam = url.searchParams.get('offset');
-        const depthParam = url.searchParams.get('depth');
-        const organizationIdsParam = url.searchParams.get('organizationIds'); // Comma-separated list
-        // Parse with defaults
-        const limit = limitParam ? parseInt(limitParam) : DEFAULT_API_LIMIT;
-        const offset = offsetParam ? parseInt(offsetParam) : DEFAULT_API_OFFSET;
-        const depth = depthParam ? parseInt(depthParam) : 0;
-        // Parse organizationIds if provided
-        const filterOrganizationIds = organizationIdsParam
-            ? organizationIdsParam
-                .split(',')
-                .map((id) => id.trim())
-                .filter(Boolean)
-            : undefined;
-        const filters = {
-            ...(docType && { type: docType }),
-            ...(status && { status }),
-            ...(filterOrganizationIds && { filterOrganizationIds }),
-            limit: isNaN(limit) ? DEFAULT_API_LIMIT : limit,
-            offset: isNaN(offset) ? DEFAULT_API_OFFSET : offset,
-            depth: isNaN(depth) ? 0 : Math.max(0, Math.min(depth, 5)) // Clamp between 0-5 for safety
-        };
-        const documents = await databaseAdapter.findManyDoc(auth.organizationId, filters);
+        // Get collection API (TypeScript-safe)
+        const collection = localAPI.collections[docType];
+        if (!collection) {
+            return json({
+                success: false,
+                error: 'Invalid document type',
+                message: `Collection '${docType}' not found. Available: ${localAPI.getCollectionNames().join(', ')}`
+            }, { status: 400 });
+        }
+        // Build where clause from query params
+        const where = {};
+        if (status) {
+            where.status = { equals: status };
+        }
+        // Query via LocalAPI
+        const result = await collection.find(context, {
+            where: Object.keys(where).length > 0 ? where : undefined,
+            limit: pageSize,
+            offset: offset,
+            depth: depth,
+            sort: sortParam || undefined,
+            perspective
+        });
         return json({
             success: true,
-            data: documents,
-            meta: {
-                count: documents.length,
-                limit: filters.limit,
-                offset: filters.offset,
-                filters: {
-                    docType,
-                    status
-                }
+            data: result.docs,
+            pagination: {
+                total: result.totalDocs,
+                page: result.page,
+                pageSize: result.limit,
+                totalPages: result.totalPages,
+                hasNextPage: result.hasNextPage,
+                hasPrevPage: result.hasPrevPage
             }
         });
     }
     catch (error) {
         console.error('Failed to fetch documents:', error);
+        if (error instanceof PermissionError) {
+            return json({
+                success: false,
+                error: 'Forbidden',
+                message: error.message
+            }, { status: 403 });
+        }
         return json({
             success: false,
             error: 'Failed to fetch documents',
@@ -68,27 +86,13 @@ export const GET = async ({ url, locals }) => {
 // POST /api/documents - Create new document
 export const POST = async ({ request, locals }) => {
     try {
-        const { databaseAdapter } = locals.aphexCMS;
-        const auth = locals.auth;
-        if (!auth) {
-            return json({
-                success: false,
-                error: 'Unauthorized',
-                message: 'Authentication required'
-            }, { status: 401 });
-        }
-        // Check write permissions (viewers are read-only)
-        if (!canWrite(auth)) {
-            return json({
-                success: false,
-                error: 'Forbidden',
-                message: 'You do not have permission to create documents. Viewers have read-only access.'
-            }, { status: 403 });
-        }
+        const { localAPI } = locals.aphexCMS;
+        const context = authToContext(locals.auth);
         const body = await request.json();
         // Validate required fields (support both old and new format)
         const documentType = body.type;
         const documentData = body.draftData || body.data;
+        const shouldPublish = body.publish || false;
         if (!documentType || !documentData) {
             return json({
                 success: false,
@@ -96,24 +100,18 @@ export const POST = async ({ request, locals }) => {
                 message: 'Document type and data are required'
             }, { status: 400 });
         }
-        // Validate document type exists
-        const { cmsEngine } = locals.aphexCMS;
-        const schema = cmsEngine.getSchemaTypeByName(documentType);
-        if (!schema) {
+        // Get collection API (TypeScript-safe)
+        const collection = localAPI.collections[documentType];
+        if (!collection) {
             return json({
                 success: false,
                 error: 'Invalid document type',
-                message: `Schema type '${documentType}' not found`
+                message: `Collection '${documentType}' not found. Available: ${localAPI.getCollectionNames().join(', ')}`
             }, { status: 400 });
         }
-        // NO VALIDATION FOR DRAFTS - Sanity-style: drafts can have any state
-        // Validation only happens on publish
-        // Create document (always starts as draft)
-        const newDocument = await databaseAdapter.createDocument({
-            type: documentType,
-            draftData: documentData,
-            organizationId: auth.organizationId,
-            createdBy: auth.type === 'session' ? auth.user.id : undefined
+        // Create via LocalAPI (permission checks happen inside)
+        const newDocument = await collection.create(context, documentData, {
+            publish: shouldPublish
         });
         return json({
             success: true,
@@ -122,6 +120,13 @@ export const POST = async ({ request, locals }) => {
     }
     catch (error) {
         console.error('Failed to create document:', error);
+        if (error instanceof PermissionError) {
+            return json({
+                success: false,
+                error: 'Forbidden',
+                message: error.message
+            }, { status: 403 });
+        }
         return json({
             success: false,
             error: 'Failed to create document',

package/dist/routes/index.d.ts

@@ -1,5 +1,7 @@
 export * as documents from './documents.js';
 export * as documentsById from './documents-by-id.js';
+export * as documentsQuery from './documents-query.js';
+export * as documentsPublish from './documents-publish.js';
 export * as assets from './assets.js';
 export * as schemas from './schemas.js';
 export * as schemasByType from './schemas-by-type.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/routes/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,aAAa,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAGnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,aAAa,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/routes/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,aAAa,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,gBAAgB,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAGnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,aAAa,MAAM,mBAAmB,CAAC"}

package/dist/routes/index.js

@@ -3,6 +3,8 @@
 // Document management routes
 export * as documents from './documents.js';
 export * as documentsById from './documents-by-id.js';
+export * as documentsQuery from './documents-query.js';
+export * as documentsPublish from './documents-publish.js';
 // Asset management routes
 export * as assets from './assets.js';
 // Schema information routes

package/dist/server/index.d.ts

@@ -13,4 +13,5 @@ export { AssetService } from '../services/asset-service.js';
 export * from '../routes-exports.js';
 export * from '../schema-utils/index.js';
 export { createHashForPublishing } from '../utils/content-hash.js';
+export { LocalAPI, createLocalAPI, getLocalAPI, CollectionAPI, PermissionChecker, PermissionError, type Collections, type LocalAPIContext, type CreateOptions, type UpdateOptions } from '../local-api/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/server/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAG5D,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAIzD,cAAc,mBAAmB,CAAC;AAGlC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/server/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAG5D,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAIzD,cAAc,mBAAmB,CAAC;AAGlC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,OAAO,EACN,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,MAAM,oBAAoB,CAAC"}

package/dist/server/index.js

@@ -26,3 +26,5 @@ export * from '../routes-exports.js';
 export * from '../schema-utils/index.js';
 // Content hash utilities (server-side)
 export { createHashForPublishing } from '../utils/content-hash.js';
+// Local API (unified operations layer)
+export { LocalAPI, createLocalAPI, getLocalAPI, CollectionAPI, PermissionChecker, PermissionError } from '../local-api/index.js';

package/dist/types/config.d.ts

@@ -14,6 +14,23 @@ export interface CMSPlugin {
         [key: string]: any;
     };
 }
+/**
+ * Plugin reference with options
+ * Example: { name: '@aphexcms/graphql-plugin', options: { endpoint: '/api/graphql' } }
+ */
+export interface CMSPluginReference {
+    name: string;
+    options?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Plugin configuration - supports three formats:
+ * 1. String reference: '@aphexcms/graphql-plugin' (loaded at runtime)
+ * 2. Plugin reference with options: { name: '@aphexcms/graphql-plugin', options: {...} }
+ * 3. Instantiated plugin: createGraphQLPlugin({...}) (traditional, but causes large bundles)
+ */
+export type CMSPluginConfig = string | CMSPluginReference | CMSPlugin;
 export interface CMSConfig {
     schemaTypes: SchemaType[];
     database: DatabaseAdapter;
@@ -30,7 +47,7 @@ export interface CMSConfig {
             fonts?: Record<string, string>;
         };
     };
-    plugins?: CMSPlugin[];
+    plugins?: CMSPluginConfig[];
     auth?: {
         provider: AuthProvider;
         loginUrl?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/types/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAA;KAAE,CAAC;IAC1E,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACzB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE;QACf,QAAQ,CAAC,EAAE;YACV,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,OAAO,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,KAAK,CAAC,EAAE;YACP,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SAC/B,CAAC;KACF,CAAC;IACF,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE;QACN,QAAQ,EAAE,YAAY,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,CAAC,EAAE;QACV;;;;WAIG;QACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/types/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAA;KAAE,CAAC;IAC1E,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,SAAS;IACzB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE;QACf,QAAQ,CAAC,EAAE;YACV,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,OAAO,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,KAAK,CAAC,EAAE;YACP,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SAC/B,CAAC;KACF,CAAC;IACF,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE;QACN,QAAQ,EAAE,YAAY,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,CAAC,EAAE;QACV;;;;WAIG;QACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACF"}

package/dist/types/document.d.ts

@@ -4,6 +4,7 @@ import { AuthUser } from '../types/user.js';
  */
 export interface Document {
     id: string;
+    organizationId: string;
     type: string;
     status: 'draft' | 'published' | null;
     draftData: any;

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

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/lib/types/document.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,GAAG,CAAC;IACf,aAAa,EAAE,GAAG,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;IACtC,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/lib/types/document.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,GAAG,CAAC;IACf,aAAa,EAAE,GAAG,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;IACtC,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB"}

package/dist/types/filters.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Valid filter value types
+ */
+export type FilterValue = string | number | boolean | Date | null;
+/**
+ * Field filter operators with type-safe constraints
+ * Each adapter will parse these into their specific query language
+ */
+export interface FieldFilter<T = unknown> {
+    equals?: T;
+    not_equals?: T;
+    in?: T[];
+    not_in?: T[];
+    exists?: boolean;
+    greater_than?: T extends number | Date ? T : number | Date;
+    greater_than_equal?: T extends number | Date ? T : number | Date;
+    less_than?: T extends number | Date ? T : number | Date;
+    less_than_equal?: T extends number | Date ? T : number | Date;
+    like?: T extends string ? string : string;
+    contains?: T extends string ? string : string;
+    starts_with?: T extends string ? string : string;
+    ends_with?: T extends string ? string : string;
+}
+/**
+ * WHERE clause for filtering (database-agnostic)
+ * Each adapter will parse this into their specific query language
+ *
+ * Examples:
+ * ```typescript
+ * // Simple field filters
+ * { title: { contains: 'blog' } }
+ * { status: { equals: 'published' } }
+ *
+ * // Multiple conditions (implicit AND)
+ * {
+ *   status: { equals: 'published' },
+ *   publishedAt: { greater_than: new Date('2024-01-01') }
+ * }
+ *
+ * // Nested OR logic
+ * {
+ *   status: { equals: 'published' },
+ *   or: [
+ *     { 'author.name': { equals: 'John' } },
+ *     { 'author.name': { equals: 'Jane' } }
+ *   ]
+ * }
+ *
+ * // Nested AND logic
+ * {
+ *   and: [
+ *     { 'seo.title': { contains: 'blog' } },
+ *     { content: { exists: true } }
+ *   ]
+ * }
+ * ```
+ */
+export interface Where<T = unknown> {
+    and?: Where<T>[];
+    or?: Where<T>[];
+    [field: string]: FieldFilter<unknown> | FilterValue | FieldFilter<unknown>[] | Where<T>[] | undefined;
+}
+/**
+ * Helper type to flatten object into dot-notation paths
+ * Limits depth to 3 levels to avoid infinite recursion and improve performance
+ */
+type DotNotation<T, D extends number = 3> = D extends 0 ? never : T extends object ? {
+    [K in keyof T & string]: K | (T[K] extends object ? T[K] extends Array<any> ? never : `${K}.${DotNotation<T[K], Prev[D]>}` : never);
+}[keyof T & string] : never;
+type Prev = [never, 0, 1, 2, 3];
+/**
+ * Helper type to extract the value type at a given path
+ * Handles both direct keys and dot-notation paths
+ */
+type PathValue<T, P> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? PathValue<T[K], Rest> : unknown : P extends keyof T ? T[P] : unknown;
+/**
+ * Type-safe WHERE clause with autocomplete for field names
+ * Provides autocomplete for known fields while still allowing dynamic field names
+ */
+export type WhereTyped<T> = {
+    and?: WhereTyped<T>[];
+    or?: WhereTyped<T>[];
+} & {
+    [K in DotNotation<T> | (keyof T & string)]?: FieldFilter<PathValue<T, K>> | FilterValue;
+} & {
+    [field: string]: FieldFilter<unknown> | FilterValue | WhereTyped<T>[] | undefined;
+};
+/**
+ * Options for find operations (database-agnostic)
+ */
+export interface FindOptions<T = unknown> {
+    /**
+     * Filter conditions
+     * When T is provided, you get autocomplete on field names!
+     */
+    where?: WhereTyped<T>;
+    /**
+     * Maximum number of results to return
+     * @default 50
+     */
+    limit?: number;
+    /**
+     * Number of results to skip (for pagination)
+     * @default 0
+     */
+    offset?: number;
+    /**
+     * Sort order
+     * - Single field: 'title' (ascending) or '-publishedAt' (descending)
+     * - Multiple fields: ['title', '-publishedAt']
+     */
+    sort?: string | string[];
+    /**
+     * Reference resolution depth
+     * - 0: No reference resolution
+     * - 1: Resolve first-level references
+     * - 2: Resolve second-level references
+     * @default 0
+     */
+    depth?: number;
+    /**
+     * Field selection (projection)
+     * - Only return specified fields
+     * - Example: ['id', 'title', 'slug']
+     */
+    select?: string[];
+    /**
+     * Perspective to query
+     * - 'draft': Query draft data
+     * - 'published': Query published data
+     * @default 'draft'
+     */
+    perspective?: 'draft' | 'published';
+}
+/**
+ * Result from find operations with pagination metadata
+ */
+export interface FindResult<T> {
+    /**
+     * Array of documents matching the query
+     */
+    docs: T[];
+    /**
+     * Total number of documents matching the query (without limit/offset)
+     */
+    totalDocs: number;
+    /**
+     * Maximum number of results returned per page
+     */
+    limit: number;
+    /**
+     * Number of results skipped
+     */
+    offset: number;
+    /**
+     * Current page number (1-indexed)
+     */
+    page: number;
+    /**
+     * Total number of pages
+     */
+    totalPages: number;
+    /**
+     * Whether there is a next page
+     */
+    hasNextPage: boolean;
+    /**
+     * Whether there is a previous page
+     */
+    hasPrevPage: boolean;
+}
+export {};
+//# sourceMappingURL=filters.d.ts.map

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

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

package/dist/types/filters.js

@@ -0,0 +1,5 @@
+// types/filters.ts
+//
+// Database-agnostic filter types for the unified Local API
+// These interfaces define the contract that all database adapters must implement
+export {};

package/dist/types/index.d.ts

@@ -6,4 +6,5 @@ export * from './config.js';
 export * from './user.js';
 export * from './sidebar.js';
 export * from './organization.js';
+export * from './filters.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC"}

package/dist/types/index.js

@@ -6,3 +6,4 @@ export * from './config.js';
 export * from './user.js';
 export * from './sidebar.js';
 export * from './organization.js';
+export * from './filters.js';