solid-logic 1.3.17-1274f5aa → 1.3.17-1aa535b3

package/src/acl/aclLogic.ts

@@ -1,137 +1,153 @@
-/**
- * Simple Access Control
- *
- * This function sets up a simple default ACL for a resource, with
- * RWC for the owner, and a specified access (default none) for the public.
- * In all cases owner has read write control.
- * Parameter lists modes allowed to public
- *
- * @param options
- * @param options.public eg ['Read', 'Write']
- *
- * @returns Resolves with aclDoc uri on successful write
- */
+import { graph, NamedNode, Namespace, serialize, sym } from "rdflib"
+import ns from '../util/ns'
 
-import { graph, NamedNode, Namespace, serialize } from "rdflib"
-import solidNamespace from 'solid-namespace'
-import * as $rdf from 'rdflib'
-import { solidLogicSingleton } from "../logic/solidLogicSingleton"
-import { ACL_LINK } from "../util/UtilityLogic"
 
-export const ns = solidNamespace($rdf)
+export const ACL_LINK = sym(
+    "http://www.iana.org/assignments/link-relations/acl"
+);
 
-export function setACLUserPublic ( 
-docURI: string,
-me: NamedNode,
-options: {
-    defaultForNew?: boolean,
-    public?: []
-}
-): Promise<NamedNode> {
-const aclDoc = solidLogicSingleton.store.any(
-    solidLogicSingleton.store.sym(docURI),
-    ACL_LINK
-)
-
-return Promise.resolve()
-    .then(() => {
-    if (aclDoc) {
-        return aclDoc as NamedNode
+export function createAclLogic(store) {
+    
+    async function findAclDocUrl(url: string) {
+        const doc = store.sym(url);
+        await store.fetcher.load(doc);
+        const docNode = store.any(doc, ACL_LINK);
+        if (!docNode) {
+            throw new Error(`No ACL link discovered for ${url}`);
+        }
+        return docNode.value;
     }
-
-    return fetchACLRel(docURI).catch(err => {
-        throw new Error(`Error fetching rel=ACL header for ${docURI}: ${err}`)
-    })
-    })
-    .then(aclDoc => {
-    const aclText = genACLText(docURI, me, aclDoc.uri, options)
-    if (!solidLogicSingleton.store.fetcher) {
-        throw new Error('Cannot PUT this, store has no fetcher')
+    /**
+     * Simple Access Control
+     *
+     * This function sets up a simple default ACL for a resource, with
+     * RWC for the owner, and a specified access (default none) for the public.
+     * In all cases owner has read write control.
+     * Parameter lists modes allowed to public
+     *
+     * @param options
+     * @param options.public eg ['Read', 'Write']
+     *
+     * @returns Resolves with aclDoc uri on successful write
+     */
+    function setACLUserPublic ( 
+    docURI: string,
+    me: NamedNode,
+    options: {
+        defaultForNew?: boolean,
+        public?: []
     }
-    return solidLogicSingleton.store.fetcher
-        .webOperation('PUT', aclDoc.uri, {
-        data: aclText,
-        contentType: 'text/turtle'
-        })
-        .then(result => {
-        if (!result.ok) {
-            throw new Error('Error writing ACL text: ' + result.error)
+    ): Promise<NamedNode> {
+    const aclDoc = store.any(
+        store.sym(docURI),
+        ACL_LINK
+    )
+
+    return Promise.resolve()
+        .then(() => {
+        if (aclDoc) {
+            return aclDoc as NamedNode
         }
 
-        return aclDoc
+        return fetchACLRel(docURI).catch(err => {
+            throw new Error(`Error fetching rel=ACL header for ${docURI}: ${err}`)
+        })
         })
-    })
-}
+        .then(aclDoc => {
+        const aclText = genACLText(docURI, me, aclDoc.uri, options)
+        if (!store.fetcher) {
+            throw new Error('Cannot PUT this, store has no fetcher')
+        }
+        return store.fetcher
+            .webOperation('PUT', aclDoc.uri, {
+            data: aclText,
+            contentType: 'text/turtle'
+            })
+            .then(result => {
+            if (!result.ok) {
+                throw new Error('Error writing ACL text: ' + result.error)
+            }
 
-/**
- * @param docURI
- * @returns
- */
-function fetchACLRel (docURI: string): Promise<NamedNode> {
-    const fetcher = solidLogicSingleton.store.fetcher
-    if (!fetcher) {
-        throw new Error('Cannot fetch ACL rel, store has no fetcher')
+            return aclDoc
+            })
+        })
     }
 
-    return fetcher.load(docURI).then(result => {
-        if (!result.ok) {
-        throw new Error('fetchACLRel: While loading:' + (result as any).error)
+    /**
+     * @param docURI
+     * @returns
+     */
+    function fetchACLRel (docURI: string): Promise<NamedNode> {
+        const fetcher = store.fetcher
+        if (!fetcher) {
+            throw new Error('Cannot fetch ACL rel, store has no fetcher')
         }
 
-        const aclDoc = solidLogicSingleton.store.any(
-        solidLogicSingleton.store.sym(docURI),
-        ACL_LINK
-        )
+        return fetcher.load(docURI).then(result => {
+            if (!result.ok) {
+            throw new Error('fetchACLRel: While loading:' + (result as any).error)
+            }
 
-        if (!aclDoc) {
-        throw new Error('fetchACLRel: No Link rel=ACL header for ' + docURI)
-        }
+            const aclDoc = store.any(
+            store.sym(docURI),
+            ACL_LINK
+            )
 
-        return aclDoc as NamedNode
-    })
-}
+            if (!aclDoc) {
+            throw new Error('fetchACLRel: No Link rel=ACL header for ' + docURI)
+            }
+
+            return aclDoc as NamedNode
+        })
+    }
 
-/**
- * @param docURI
- * @param me
- * @param aclURI
- * @param options
- *
- * @returns Serialized ACL
- */
-export function genACLText (
-docURI: string,
-me: NamedNode,
-aclURI: string,
-options: {
-    defaultForNew?: boolean,
-    public?: []
-} = {}
-): string | undefined {
-const optPublic = options.public || []
-const g = graph()
-const auth = Namespace('http://www.w3.org/ns/auth/acl#')
-let a = g.sym(`${aclURI}#a1`)
-const acl = g.sym(aclURI)
-const doc = g.sym(docURI)
-g.add(a, ns.rdf('type'), auth('Authorization'), acl)
-g.add(a, auth('accessTo'), doc, acl)
-if (options.defaultForNew) {
-    g.add(a, auth('default'), doc, acl)
-}
-g.add(a, auth('agent'), me, acl)
-g.add(a, auth('mode'), auth('Read'), acl)
-g.add(a, auth('mode'), auth('Write'), acl)
-g.add(a, auth('mode'), auth('Control'), acl)
+    /**
+     * @param docURI
+     * @param me
+     * @param aclURI
+     * @param options
+     *
+     * @returns Serialized ACL
+     */
+    function genACLText (
+    docURI: string,
+    me: NamedNode,
+    aclURI: string,
+    options: {
+        defaultForNew?: boolean,
+        public?: []
+    } = {}
+    ): string | undefined {
+        const optPublic = options.public || []
+        const g = graph()
+        const auth = Namespace('http://www.w3.org/ns/auth/acl#')
+        let a = g.sym(`${aclURI}#a1`)
+        const acl = g.sym(aclURI)
+        const doc = g.sym(docURI)
+        g.add(a, ns.rdf('type'), auth('Authorization'), acl)
+        g.add(a, auth('accessTo'), doc, acl)
+        if (options.defaultForNew) {
+            g.add(a, auth('default'), doc, acl)
+        }
+        g.add(a, auth('agent'), me, acl)
+        g.add(a, auth('mode'), auth('Read'), acl)
+        g.add(a, auth('mode'), auth('Write'), acl)
+        g.add(a, auth('mode'), auth('Control'), acl)
 
-if (optPublic.length) {
-    a = g.sym(`${aclURI}#a2`)
-    g.add(a, ns.rdf('type'), auth('Authorization'), acl)
-    g.add(a, auth('accessTo'), doc, acl)
-    g.add(a, auth('agentClass'), ns.foaf('Agent'), acl)
-    for (let p = 0; p < optPublic.length; p++) {
-    g.add(a, auth('mode'), auth(optPublic[p]), acl) // Like 'Read' etc
+        if (optPublic.length) {
+            a = g.sym(`${aclURI}#a2`)
+            g.add(a, ns.rdf('type'), auth('Authorization'), acl)
+            g.add(a, auth('accessTo'), doc, acl)
+            g.add(a, auth('agentClass'), ns.foaf('Agent'), acl)
+            for (let p = 0; p < optPublic.length; p++) {
+            g.add(a, auth('mode'), auth(optPublic[p]), acl) // Like 'Read' etc
+            }
+        }
+        return serialize(acl, g, aclURI)
+    }
+    return {
+        findAclDocUrl,
+        setACLUserPublic,
+        genACLText
     }
-}
-return serialize(acl, g, aclURI)
-}
+}

package/src/authn/SolidAuthnLogic.ts

@@ -3,6 +3,7 @@ import { appContext, offlineTestID } from "./authUtil";
 import * as debug from '../util/debug'
 import { Session } from "@inrupt/solid-client-authn-browser";
 import { AuthenticationContext, AuthnLogic } from "../types";
+
 export class SolidAuthnLogic implements AuthnLogic {
   private session: Session;
 
@@ -58,10 +59,10 @@ export class SolidAuthnLogic implements AuthnLogic {
       const curUrl = new URL(window.location.href)
       if (curUrl.hash !== postLoginRedirectHash) {
         if (history.pushState) {
-          // console.log('Setting window.location.has using pushState')
+          // debug.log('Setting window.location.has using pushState')
           history.pushState(null, document.title, postLoginRedirectHash)
         } else {
-          // console.warn('Setting window.location.has using location.hash')
+          // debug.warn('Setting window.location.has using location.hash')
           location.hash = postLoginRedirectHash
         }
         curUrl.hash = postLoginRedirectHash

package/src/chat/chatLogic.ts

@@ -0,0 +1,225 @@
+import { NamedNode, Node, st, term } from "rdflib"
+import { CreatedPaneOptions, NewPaneOptions } from "../types"
+import { determineChatContainer, newThing } from "../util/utils"
+import { ns as namespace } from '../util/ns'
+
+const CHAT_LOCATION_IN_CONTAINER = "index.ttl#this";
+
+export function createChatLogic(store, profileLogic) {
+    const ns = namespace
+    
+    async function setAcl(
+        chatContainer: NamedNode,
+        me: NamedNode,
+        invitee: NamedNode
+    ): Promise<void> {
+        // Some servers don't present a Link http response header
+        // if the container doesn't exist yet, so refetch the container
+        // now that it has been created:
+        await store.fetcher.load(chatContainer);
+
+        // FIXME: check the Why value on this quad:
+        const chatAclDoc = store.any(
+            chatContainer,
+            new NamedNode("http://www.iana.org/assignments/link-relations/acl")
+        );
+        if (!chatAclDoc) {
+            throw new Error("Chat ACL doc not found!");
+        }
+
+        const aclBody = `
+            @prefix acl: <http://www.w3.org/ns/auth/acl#>.
+            <#owner>
+            a acl:Authorization;
+            acl:agent <${me.value}>;
+            acl:accessTo <.>;
+            acl:default <.>;
+            acl:mode
+                acl:Read, acl:Write, acl:Control.
+            <#invitee>
+            a acl:Authorization;
+            acl:agent <${invitee.value}>;
+            acl:accessTo <.>;
+            acl:default <.>;
+            acl:mode
+                acl:Read, acl:Append.
+            `;
+        await store.fetcher.webOperation("PUT", chatAclDoc.value, {
+            data: aclBody,
+            contentType: "text/turtle",
+        });
+    }
+
+    async function addToPrivateTypeIndex(chatThing, me) {
+        // Add to private type index
+        const privateTypeIndex = store.any(
+            me,
+            ns.solid("privateTypeIndex")
+        ) as NamedNode | null;
+        if (!privateTypeIndex) {
+            throw new Error("Private type index not found!");
+        }
+        await store.fetcher.load(privateTypeIndex);
+        const reg = newThing(privateTypeIndex);
+        const ins = [
+            st(
+                reg,
+                ns.rdf("type"),
+                ns.solid("TypeRegistration"),
+                privateTypeIndex.doc()
+            ),
+            st(
+                reg,
+                ns.solid("forClass"),
+                ns.meeting("LongChat"),
+                privateTypeIndex.doc()
+            ),
+            st(reg, ns.solid("instance"), chatThing, privateTypeIndex.doc()),
+        ];
+        await new Promise((resolve, reject) => {
+            store.updater.update([], ins, function (_uri, ok, errm) {
+                if (!ok) {
+                    reject(new Error(errm));
+                } else {
+                    resolve(null);
+                }
+            });
+        });
+    }
+
+    async function findChat(invitee: NamedNode) {
+        const me = await profileLogic.loadMe();
+        const podRoot = await profileLogic.getPodRoot(me);
+        const chatContainer = determineChatContainer(invitee, podRoot);
+        let exists = true;
+        try {
+            await store.fetcher.load(
+                new NamedNode(chatContainer.value + "index.ttl#this")
+            );
+        } catch (e) {
+            exists = false;
+        }
+        return { me, chatContainer, exists };
+    }
+
+    async function createChatThing(
+        chatContainer: NamedNode,
+        me: NamedNode
+    ): Promise<NamedNode> {
+        const created = await mintNew({
+            me,
+            newBase: chatContainer.value,
+        });
+        return created.newInstance;
+    }
+
+    function mintNew(newPaneOptions: NewPaneOptions): Promise<CreatedPaneOptions> {
+        const kb = store;
+        const updater = kb.updater;
+        if (newPaneOptions.me && !newPaneOptions.me.uri) {
+            throw new Error("chat mintNew:  Invalid userid " + newPaneOptions.me);
+        }
+
+        const newInstance = (newPaneOptions.newInstance =
+            newPaneOptions.newInstance ||
+            kb.sym(newPaneOptions.newBase + CHAT_LOCATION_IN_CONTAINER));
+        const newChatDoc = newInstance.doc();
+
+        kb.add(
+            newInstance,
+            ns.rdf("type"),
+            ns.meeting("LongChat"),
+            newChatDoc
+        );
+        kb.add(newInstance, ns.dc("title"), "Chat channel", newChatDoc);
+        kb.add(
+            newInstance,
+            ns.dc("created"),
+            term<Node>(new Date(Date.now())),
+            newChatDoc
+        );
+        if (newPaneOptions.me) {
+            kb.add(newInstance, ns.dc("author"), newPaneOptions.me, newChatDoc);
+        }
+
+        return new Promise(function (resolve, reject) {
+            updater?.put(
+                newChatDoc,
+                kb.statementsMatching(undefined, undefined, undefined, newChatDoc),
+                "text/turtle",
+                function (uri2, ok, message) {
+                    if (ok) {
+                        resolve({
+                            ...newPaneOptions,
+                            newInstance,
+                        });
+                    } else {
+                        reject(
+                            new Error(
+                                "FAILED to save new chat channel at: " + uri2 + " : " + message
+                            )
+                        );
+                    }
+                }
+            );
+        });
+    }
+
+    /**
+     * Find (and optionally create) an individual chat between the current user and the given invitee
+     * @param invitee - The person to chat with
+     * @param createIfMissing - Whether the chat should be created, if missing
+     * @returns null if missing, or a node referring to an already existing chat, or the newly created chat
+     */
+    async function getChat(
+        invitee: NamedNode,
+        createIfMissing = true
+    ): Promise<NamedNode | null> {
+        const { me, chatContainer, exists } = await findChat(invitee);
+        if (exists) {
+            return new NamedNode(chatContainer.value + CHAT_LOCATION_IN_CONTAINER);
+        }
+
+        if (createIfMissing) {
+            const chatThing = await createChatThing(chatContainer, me);
+            await sendInvite(invitee, chatThing);
+            await setAcl(chatContainer, me, invitee);
+            await addToPrivateTypeIndex(chatThing, me);
+            return chatThing;
+        }
+        return null;
+    }
+
+    async function sendInvite(invitee: NamedNode, chatThing: NamedNode) {
+        await store.fetcher.load(invitee.doc());
+        const inviteeInbox = store.any(
+            invitee,
+            ns.ldp("inbox"),
+            undefined,
+            invitee.doc()
+        );
+        if (!inviteeInbox) {
+            throw new Error(`Invitee inbox not found! ${invitee.value}`);
+        }
+        const inviteBody = `
+        <> a <http://www.w3.org/ns/pim/meeting#LongChatInvite> ;
+        ${ns.rdf("seeAlso")} <${chatThing.value}> .
+        `;
+
+        const inviteResponse = await store.fetcher.webOperation(
+            "POST",
+            inviteeInbox.value,
+            {
+                data: inviteBody,
+                contentType: "text/turtle",
+            }
+        );
+        const locationStr = inviteResponse?.headers.get("location");
+        if (!locationStr) {
+            throw new Error(`Invite sending returned a ${inviteResponse?.status}`);
+        }
+    }
+    return {
+        setAcl, addToPrivateTypeIndex, findChat, createChatThing, getChat, sendInvite, mintNew
+    }
+}

package/src/discovery/discoveryLogic.ts

@@ -1,29 +1,17 @@
-import { NamedNode, Namespace, LiveStore, sym, st } from "rdflib";
-import { solidLogicSingleton } from "../logic/solidLogicSingleton"
-import { newThing } from "../util/uri"
-const {  authn } = solidLogicSingleton
-const { currentUser } = authn
+import { NamedNode, LiveStore, sym, st } from 'rdflib'
+import * as $rdf from 'rdflib'
+import { newThing } from "../util/utils"
+import solidNamespace from 'solid-namespace'
+import { authn } from '../logic/solidLogicSingleton'
 
-type TypeIndexScope = { label: string, index: NamedNode, agent: NamedNode } ;
-type ScopedApp = { instance: NamedNode, scope: TypeIndexScope }
-
-const ns = {
-  dct:     Namespace('http://purl.org/dc/terms/'),
-  ldp:     Namespace('http://www.w3.org/ns/ldp#'),
-  meeting: Namespace('http://www.w3.org/ns/pim/meeting#'),
-  rdf:     Namespace('http://www.w3.org/1999/02/22-rdf-syntax-ns#'),
-  schema:  Namespace('http://schema.org/'),
-  solid:   Namespace('http://www.w3.org/ns/solid/terms#'),
-  space:   Namespace('http://www.w3.org/ns/pim/space#'),
-  stat:    Namespace('http://www.w3.org/ns/posix/stat#'),
-  vcard:   Namespace('http://www.w3.org/2006/vcard/ns#'),
-  wf:      Namespace('http://www.w3.org/2005/01/wf/flow#'),
-  xsd:     Namespace('http://www.w3.org/2001/XMLSchema#')
+const ns = solidNamespace($rdf)
 
-}
+type TypeIndexScope = { label: string, index: NamedNode, agent: NamedNode }
+type ScopedApp = { instance: NamedNode, scope: TypeIndexScope }
 
-/** Create a resource if it really does not exist
- *  Be absolutely sure something does not exist before creating a new empty file
+/**
+ * Create a resource if it really does not exist
+ * Be absolutely sure something does not exist before creating a new empty file
  * as otherwise existing could  be deleted.
  * @param doc {NamedNode} - The resource
  */
@@ -64,9 +52,10 @@ export function suggestPublicTypeIndex (me:NamedNode) {
 export function suggestPrivateTypeIndex (preferencesFile:NamedNode) {
   return sym(preferencesFile.doc().dir()?.uri + 'privateTypeIndex.ttl')
 }
+
 /* Follow link from this doc to another thing, or else make a new link
 **
-**  return: null no ld one and failed to make a new one
+** return: null no ld one and failed to make a new one
 */
 export async function followOrCreateLink (store: LiveStore, subject: NamedNode, predicate: NamedNode,
      object: NamedNode, doc:NamedNode):Promise<NamedNode | null> {
@@ -119,7 +108,7 @@ export async function loadPreferences (store: LiveStore, user: NamedNode): Promi
   }
   try {
     await store.fetcher.load(preferencesFile as NamedNode)
-  } catch (err) { // Mabeb a permission propblem or origin problem
+  } catch (err) { // Maybe a permission propblem or origin problem
     return undefined
   }
   return preferencesFile as NamedNode
@@ -150,7 +139,7 @@ export async function loadTypeIndexesFor (store: LiveStore, user:NamedNode): Pro
 
     const privateTypeIndex = store.any(user, ns.solid('privateTypeIndex'), undefined, profile) ||
 
-        await followOrCreateLink(store, user, ns.solid('privateTypeIndex') as NamedNode, suggestedPrivateTypeIndex, preferencesFile);
+    await followOrCreateLink(store, user, ns.solid('privateTypeIndex') as NamedNode, suggestedPrivateTypeIndex, preferencesFile);
 
     privateScopes = privateTypeIndex ? [ { label: 'private', index: privateTypeIndex as NamedNode, agent: user } ] : []
   } else {
@@ -187,7 +176,6 @@ export async function loadAllTypeIndexes (store:LiveStore, user:NamedNode) {
 }
 
 // Utility: remove duplicates from Array of NamedNodes
-
 export function uniqueNodes (arr: NamedNode[]): NamedNode[] {
   const uris = arr.map(x => x.uri)
   const set = new Set(uris)
@@ -210,7 +198,6 @@ export async function getScopedAppsFromIndex (store, scope, theClass: NamedNode
      reg => store.each(reg as NamedNode, ns.solid('instanceContainer'), null, index)).flat()
 
   //  instanceContainers may be deprocatable if no one has used them
-
   const containers = uniqueNodes(instanceContainers)
   if (containers.length > 0) { console.log('@@ getScopedAppsFromIndex containers ', containers)}
   for (let i = 0; i < containers.length; i++) {
@@ -222,7 +209,6 @@ export async function getScopedAppsFromIndex (store, scope, theClass: NamedNode
   return instances.map(instance => { return {instance, scope}})
 }
 
-
 export async function getScopedAppInstances (store:LiveStore, klass: NamedNode, user: NamedNode):Promise<ScopedApp[]> {
   const scopes = await loadAllTypeIndexes(store, user)
   let scopedApps = []
@@ -232,16 +218,18 @@ export async function getScopedAppInstances (store:LiveStore, klass: NamedNode,
   }
   return scopedApps
 }
+
 // This is the function signature which used to be in solid-ui/logic
 // Recommended to use getScopedAppInstances instead as it provides more information.
 //
 export async function getAppInstances (store:LiveStore, klass: NamedNode): Promise<NamedNode[]> {
-  const user = currentUser()
+  const user = authn.currentUser()
   if (!user) throw new Error('getAppInstances: Must be logged in to find apps.')
   const scopedAppInstances = await getScopedAppInstances(store, klass, user)
   return scopedAppInstances.map(scoped => scoped.instance)
 }
-/**
+
+/*
  * Register a new app in a type index
  * used in chat in bookmark.js (solid-ui)
  * Returns the registration object if successful else null
@@ -276,5 +264,4 @@ export async function deleteTypeIndexRegistration (store: LiveStore, item) {
   const statements = store.statementsMatching(reg, null, null, item.scope.index)
   await store.updater.update(statements, [])
 }
-
 // ENDS