@kubun/graphql 0.4.5 → 0.6.0

package/lib/context.d.ts

@@ -2,7 +2,7 @@ import type { KubunDB } from '@kubun/db';
 import type { DocumentData, DocumentNode } from '@kubun/protocol';
 import type { GraphQLResolveInfo } from 'graphql';
 import type { Connection, Edge } from 'graphql-relay';
-import type { AllConnectionArguments, UpdateMutationInput } from './types.js';
+import type { AllConnectionArguments, ModelAccessDefaults, UpdateMutationInput } from './types.js';
 /**
  * Query functions requiring server implementation
  */
@@ -11,6 +11,11 @@ export type QueryContext = {
     loadDocument(id: string): Promise<DocumentNode | null>;
     resolveConnection(modelIDs: Array<string>, args: AllConnectionArguments): Promise<Connection<DocumentNode>>;
     resolveList(modelIDs: Array<string>, ids: Array<string>): Promise<Array<DocumentNode>>;
+    searchDocuments(query: string, modelIDs: Array<string>, first?: number): Promise<Array<{
+        documentID: string;
+        modelID: string;
+        rank: number;
+    }>>;
 };
 /**
  * Subscription functions requiring server implementation
@@ -41,10 +46,9 @@ export type MutationContext = {
     executeSetMutation(modelID: string, unique: Uint8Array, data: DocumentData, info: GraphQLResolveInfo): Promise<DocumentNode>;
     executeUpdateMutation(input: UpdateMutationInput, info: GraphQLResolveInfo): Promise<DocumentNode>;
     executeRemoveMutation(id: string, info: GraphQLResolveInfo): Promise<void>;
-    executeSetModelAccessDefaults(modelId: string, permissionType: 'read' | 'write', accessLevel: string, allowedDIDs: Array<string> | null): Promise<void>;
+    executeSetModelAccessDefaults(modelId: string, permissionType: 'read' | 'write', accessLevel: string, allowedDIDs: Array<string> | null): Promise<ModelAccessDefaults>;
     executeRemoveModelAccessDefaults(modelId: string, permissionTypes: Array<'read' | 'write'>): Promise<void>;
-    executeSetDocumentAccessOverride(documentId: string, permissionType: 'read' | 'write', accessLevel: string, allowedDIDs: Array<string> | null): Promise<void>;
+    executeSetDocumentAccessOverride(documentId: string, permissionType: 'read' | 'write', accessLevel: string, allowedDIDs: Array<string> | null): Promise<DocumentNode>;
     executeRemoveDocumentAccessOverride(documentId: string, permissionTypes: Array<'read' | 'write'>): Promise<void>;
 };
 export type Context = ReadOnlyContext & MutationContext;
-//# sourceMappingURL=context.d.ts.map

package/lib/context.js

@@ -1,223 +1 @@
-import { defer } from '@enkaku/async';
-import { DocumentID } from '@kubun/id';
-export function createReadContext(params) {
-    const { db, viewerDID, accessChecker } = params;
-    function createEventGenerator(filter, transform) {
-        let isDone = false;
-        let pending = null;
-        const queue = [];
-        const stop = db.events.on('document:saved', (event)=>{
-            if (filter(event)) {
-                const toPush = transform(event);
-                if (pending == null) {
-                    queue.push(toPush);
-                } else {
-                    pending.resolve(toPush);
-                    pending = null;
-                }
-            }
-        });
-        const setDone = ()=>{
-            stop();
-            isDone = true;
-            return Promise.resolve({
-                done: true,
-                value: undefined
-            });
-        };
-        return {
-            [Symbol.asyncDispose] () {
-                stop();
-                isDone = true;
-                return Promise.resolve();
-            },
-            [Symbol.asyncIterator] () {
-                return this;
-            },
-            next: ()=>{
-                if (isDone) {
-                    return Promise.resolve({
-                        done: true,
-                        value: undefined
-                    });
-                }
-                const value = queue.shift();
-                if (value != null) {
-                    return Promise.resolve({
-                        value,
-                        done: false
-                    });
-                }
-                pending = defer();
-                return pending.promise.then((value)=>({
-                        value,
-                        done: false
-                    }));
-            },
-            return: setDone,
-            throw: setDone
-        };
-    }
-    return {
-        getViewer () {
-            return viewerDID;
-        },
-        async loadDocument (id) {
-            const doc = await db.getDocument(DocumentID.fromString(id));
-            if (!doc) return null;
-            // Check access if access checker is provided
-            if (accessChecker) {
-                const hasAccess = await accessChecker(doc, 'read');
-                if (!hasAccess) {
-                    // Access denied - return null (error will be added by GraphQL layer)
-                    return null;
-                }
-            }
-            return doc;
-        },
-        async resolveConnection (modelIDs, args) {
-            // If no access checker, return all documents
-            if (accessChecker == null) {
-                const { entries, hasMore } = await db.queryDocuments({
-                    ...args,
-                    modelIDs
-                });
-                return {
-                    edges: entries.map((e)=>({
-                            cursor: e.cursor,
-                            node: e.document
-                        })),
-                    pageInfo: {
-                        hasNextPage: args.first ? hasMore : false,
-                        hasPreviousPage: args.first ? false : hasMore,
-                        endCursor: entries.at(-1)?.cursor ?? null,
-                        startCursor: entries.at(0)?.cursor ?? null
-                    }
-                };
-            }
-            // With access control: post-fetch filtering with over-fetching
-            const allEntries = [];
-            let requestedCount = 0;
-            let attempts = 0;
-            const maxAttempts = 10 // Prevent infinite loops
-            ;
-            if (args.first != null) {
-                requestedCount = args.first;
-                const fetchSize = requestedCount * 2 // Over-fetch to reduce round trips
-                ;
-                let cursor = args.after;
-                while(allEntries.length < requestedCount && attempts < maxAttempts){
-                    // Fetch unfiltered batch from DB
-                    const { entries, hasMore } = await db.queryDocuments({
-                        ...args,
-                        modelIDs,
-                        first: fetchSize,
-                        after: cursor
-                    });
-                    if (entries.length === 0 && !hasMore) break;
-                    // Filter based on access rules
-                    for (const entry of entries){
-                        if (await accessChecker(entry.document, 'read')) {
-                            allEntries.push(entry);
-                            if (allEntries.length >= requestedCount) break;
-                        }
-                    }
-                    if (!hasMore) break;
-                    cursor = entries.at(-1)?.cursor ?? null;
-                    attempts++;
-                }
-            } else if (args.last != null) {
-                requestedCount = args.last;
-                const fetchSize = requestedCount * 2 // Over-fetch to reduce round trips
-                ;
-                let cursor = args.before;
-                while(allEntries.length < requestedCount && attempts < maxAttempts){
-                    // Fetch unfiltered batch from DB
-                    const { entries, hasMore } = await db.queryDocuments({
-                        ...args,
-                        modelIDs,
-                        last: fetchSize,
-                        before: cursor
-                    });
-                    if (entries.length === 0 && !hasMore) break;
-                    // Filter based on access rules - note we reverse the entries array for backward pagination
-                    for (const entry of [
-                        ...entries
-                    ].reverse()){
-                        if (await accessChecker(entry.document, 'read')) {
-                            allEntries.unshift(entry);
-                            if (allEntries.length >= requestedCount) break;
-                        }
-                    }
-                    if (!hasMore) break;
-                    cursor = entries.at(0)?.cursor ?? null;
-                    attempts++;
-                }
-            }
-            // Return only requested count
-            const resultEntries = allEntries.slice(0, requestedCount);
-            const hasMoreResults = allEntries.length > requestedCount;
-            return {
-                edges: resultEntries.map((e)=>({
-                        cursor: e.cursor,
-                        node: e.document
-                    })),
-                pageInfo: {
-                    hasNextPage: args.first ? hasMoreResults : false,
-                    hasPreviousPage: args.first ? false : hasMoreResults,
-                    endCursor: resultEntries.at(-1)?.cursor ?? null,
-                    startCursor: resultEntries.at(0)?.cursor ?? null
-                }
-            };
-        },
-        async resolveList (modelIDs, docIDs) {
-            const documents = await db.listDocuments({
-                modelIDs,
-                docIDs
-            });
-            // If no access checker, return all documents
-            if (!accessChecker) {
-                return documents;
-            }
-            // Filter based on access control
-            const accessible = [];
-            for (const doc of documents){
-                if (await accessChecker(doc, 'read')) {
-                    accessible.push(doc);
-                }
-            }
-            return accessible;
-        },
-        subscribeToDocumentCreated (modelIDs) {
-            return createEventGenerator((event)=>event.type === 'create' && modelIDs.includes(event.document.model), (event)=>event.document);
-        },
-        subscribeToDocumentChanged (id) {
-            return createEventGenerator((event)=>{
-                return event.type === 'update' && event.document.id === id && event.document.data !== null;
-            }, (event)=>event.document);
-        },
-        subscribeToDocumentRemoved () {
-            return createEventGenerator((event)=>event.type === 'update' && event.document.data === null, (event)=>event.document.id);
-        },
-        subscribeToDocumentEdgeAdded (modelIDs, hasRelation) {
-            return createEventGenerator((event)=>{
-                return(// document has data
-                event.document.data !== null && // document model is one of the target models
-                modelIDs.includes(event.document.model) && // relation field targets the expected document
-                hasRelation(event.document.data) && // new document or new relation to document
-                (event.type === 'create' || event.previous.data !== null && hasRelation(event.previous.data)));
-            }, (event)=>({
-                    cursor: event.getCursor(),
-                    node: event.document
-                }));
-        },
-        subscribeToDocumentEdgeRemoved (modelIDs, hasRelation) {
-            return createEventGenerator((event)=>{
-                return event.type === 'update' && // document model is one of the target models
-                modelIDs.includes(event.document.model) && // relation existed in previous version
-                event.previous.data !== null && hasRelation(event.previous.data) && // relation is removed
-                (event.document.data === null || !hasRelation(event.document.data));
-            }, (event)=>event.document.id);
-        }
-    };
-}
+import{defer as e}from"@enkaku/async";import{DocumentID as t}from"@kubun/id";export function createReadContext(r){let{db:a,viewerDID:n,accessChecker:o}=r;function u(t,r){let n=!1,o=null,u=[],s=a.events.on("document:saved",e=>{if(t(e)){let t=r(e);null==o?u.push(t):(o.resolve(t),o=null)}}),l=()=>(s(),n=!0,Promise.resolve({done:!0,value:void 0}));return{[Symbol.asyncDispose]:()=>(s(),n=!0,Promise.resolve()),[Symbol.asyncIterator](){return this},next:()=>{if(n)return Promise.resolve({done:!0,value:void 0});let t=u.shift();return null!=t?Promise.resolve({value:t,done:!1}):(o=e()).promise.then(e=>({value:e,done:!1}))},return:l,throw:l}}return{getViewer:()=>n,async loadDocument(e){let r=await a.getDocument(t.fromString(e));return r&&(!o||await o(r,"read"))?r:null},searchDocuments:async(e,t,r)=>await a.searchDocuments({query:e,modelIDs:t,first:r}),async resolveConnection(e,t){if(null!=t.search&&""!==t.search.trim()){let r=await a.searchDocuments({query:t.search,modelIDs:e,first:200});if(0===r.length)return{edges:[],pageInfo:{hasNextPage:!1,hasPreviousPage:!1,startCursor:null,endCursor:null}};let n=r.map(e=>e.documentID),u=await a.listDocuments({modelIDs:e,docIDs:n}),s=u;if(o)for(let e of(s=[],u))await o(e,"read")&&s.push(e);let l=new Map(r.map(e=>[e.documentID,e.rank]));s.sort((e,t)=>Math.abs(l.get(t.id)??0)-Math.abs(l.get(e.id)??0));let i=s.slice(0,t.first??50);return{edges:i.map((e,t)=>({cursor:String(t),node:e})),pageInfo:{hasNextPage:s.length>i.length,hasPreviousPage:!1,startCursor:i.length>0?"0":null,endCursor:i.length>0?String(i.length-1):null}}}if(null==o){let{entries:r,hasMore:n}=await a.queryDocuments({...t,modelIDs:e});return{edges:r.map(e=>({cursor:e.cursor,node:e.document})),pageInfo:{hasNextPage:!!t.first&&n,hasPreviousPage:!t.first&&n,endCursor:r.at(-1)?.cursor??null,startCursor:r.at(0)?.cursor??null}}}let r=[],n=0,u=0;if(null!=t.first){let s=2*(n=t.first),l=t.after;for(;r.length<n&&u<10;){let{entries:i,hasMore:d}=await a.queryDocuments({...t,modelIDs:e,first:s,after:l});if(0===i.length&&!d)break;for(let e of i)if(await o(e.document,"read")&&(r.push(e),r.length>=n))break;if(!d)break;l=i.at(-1)?.cursor??null,u++}}else if(null!=t.last){let s=2*(n=t.last),l=t.before;for(;r.length<n&&u<10;){let{entries:i,hasMore:d}=await a.queryDocuments({...t,modelIDs:e,last:s,before:l});if(0===i.length&&!d)break;for(let e of[...i].reverse())if(await o(e.document,"read")&&(r.unshift(e),r.length>=n))break;if(!d)break;l=i.at(0)?.cursor??null,u++}}let s=r.slice(0,n),l=r.length>n;return{edges:s.map(e=>({cursor:e.cursor,node:e.document})),pageInfo:{hasNextPage:!!t.first&&l,hasPreviousPage:!t.first&&l,endCursor:s.at(-1)?.cursor??null,startCursor:s.at(0)?.cursor??null}}},async resolveList(e,t){let r=await a.listDocuments({modelIDs:e,docIDs:t});if(!o)return r;let n=[];for(let e of r)await o(e,"read")&&n.push(e);return n},subscribeToDocumentCreated(e){let t=u(t=>"create"===t.type&&e.includes(t.document.model),e=>e.document);return o?async function*(){for await(let e of t)await o(e,"read")&&(yield e)}():t},subscribeToDocumentChanged(e){let t=u(t=>"update"===t.type&&t.document.id===e&&null!==t.document.data,e=>e.document);return o?async function*(){for await(let e of t)await o(e,"read")&&(yield e)}():t},subscribeToDocumentRemoved:()=>u(e=>"update"===e.type&&null===e.document.data,e=>e.document.id),subscribeToDocumentEdgeAdded(e,t){let r=u(r=>null!==r.document.data&&e.includes(r.document.model)&&t(r.document.data)&&("create"===r.type||null!==r.previous.data&&t(r.previous.data)),e=>({cursor:e.getCursor(),node:e.document}));return o?async function*(){for await(let e of r)await o(e.node,"read")&&(yield e)}():r},subscribeToDocumentEdgeRemoved:(e,t)=>u(r=>"update"===r.type&&e.includes(r.document.model)&&null!==r.previous.data&&t(r.previous.data)&&(null===r.document.data||!t(r.document.data)),e=>e.document.id)}}

package/lib/identifiers.d.ts

@@ -1,4 +1,3 @@
 import { GraphQLScalarType } from 'graphql';
 export declare const GraphQLAttachmentID: GraphQLScalarType<string, string>;
 export declare const GraphQLDocID: GraphQLScalarType<string, string>;
-//# sourceMappingURL=identifiers.d.ts.map

package/lib/identifiers.js

@@ -1,42 +1 @@
-import { AttachmentID, DocumentID } from '@kubun/id';
-import { GraphQLError, GraphQLScalarType, Kind } from 'graphql';
-function validateAttachmentID(input) {
-    if (typeof input !== 'string') {
-        throw new GraphQLError(`Invalid AttachmentID input: ${input}`);
-    }
-    // Throws if input is not a valid AttachmentID string
-    AttachmentID.fromString(input);
-    return input;
-}
-export const GraphQLAttachmentID = new GraphQLScalarType({
-    name: 'AttachmentID',
-    description: 'A Kubun Attachment identifier',
-    serialize: validateAttachmentID,
-    parseValue: validateAttachmentID,
-    parseLiteral (ast) {
-        if (ast.kind !== Kind.STRING) {
-            throw new GraphQLError(`Can only validate strings as AttachmentID but got a: ${ast.kind}`);
-        }
-        return validateAttachmentID(ast.value);
-    }
-});
-function validateDocID(input) {
-    if (typeof input !== 'string') {
-        throw new GraphQLError(`Invalid DocumentID input: ${input}`);
-    }
-    // Throws if input is not a valid DocumentID string
-    DocumentID.fromString(input);
-    return input;
-}
-export const GraphQLDocID = new GraphQLScalarType({
-    name: 'DocumentID',
-    description: 'A Kubun Document identifier',
-    serialize: validateDocID,
-    parseValue: validateDocID,
-    parseLiteral (ast) {
-        if (ast.kind !== Kind.STRING) {
-            throw new GraphQLError(`Can only validate strings as DocumentID but got a: ${ast.kind}`);
-        }
-        return validateDocID(ast.value);
-    }
-});
+import{AttachmentID as t,DocumentID as n}from"@kubun/id";import{GraphQLError as e,GraphQLScalarType as i,Kind as r}from"graphql";function a(n){if("string"!=typeof n)throw new e(`Invalid AttachmentID input: ${n}`);return t.fromString(n),n}export const GraphQLAttachmentID=new i({name:"AttachmentID",description:"A Kubun Attachment identifier",serialize:a,parseValue:a,parseLiteral(t){if(t.kind!==r.STRING)throw new e(`Can only validate strings as AttachmentID but got a: ${t.kind}`);return a(t.value)}});function o(t){if("string"!=typeof t)throw new e(`Invalid DocumentID input: ${t}`);return n.fromString(t),t}export const GraphQLDocID=new i({name:"DocumentID",description:"A Kubun Document identifier",serialize:o,parseValue:o,parseLiteral(t){if(t.kind!==r.STRING)throw new e(`Can only validate strings as DocumentID but got a: ${t.kind}`);return o(t.value)}});

package/lib/index.d.ts

@@ -4,4 +4,3 @@ export { GraphQLAttachmentID, GraphQLDocID } from './identifiers.js';
 export type { SchemaBuilderParams, SharedDefinitions, } from './schema.js';
 export { createSchema, SchemaBuilder } from './schema.js';
 export type * from './types.js';
-//# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -1,3 +1 @@
-export { createReadContext } from './context.js';
-export { GraphQLAttachmentID, GraphQLDocID } from './identifiers.js';
-export { createSchema, SchemaBuilder } from './schema.js';
+export{createReadContext}from"./context.js";export{GraphQLAttachmentID,GraphQLDocID}from"./identifiers.js";export{createSchema,SchemaBuilder}from"./schema.js";

package/lib/schema.d.ts

@@ -85,4 +85,3 @@ export declare class SchemaBuilder {
 }
 export declare function createSchema(params: SchemaBuilderParams): GraphQLSchema;
 export {};
-//# sourceMappingURL=schema.d.ts.map