solid-logic 3.1.1 → 4.0.0-3818f4f

package/README.md

@@ -1,7 +1,134 @@
 # solid-logic
-Core business logic of SolidOS
 
-# Adendum
+<img src="https://raw.githubusercontent.com/solid/community-server/main/templates/images/solid.svg" alt="[Solid logo]" height="150" align="right"/>
+
+[![MIT license](https://img.shields.io/github/license/solidos/solidos)](https://github.com/solidos/solidos/blob/main/LICENSE.md)
+
+
+Core business logic of SolidOS which can be used for any webapp as well.
+
+
+# Usage
+
+## 📦 Install via npm
+
+```sh
+npm install solid-logic rdflib
+```
+
+> **Important**: `rdflib` is a peer dependency - you must install it separately.
+
+### Import in your project (ESM/TypeScript)
+
+```js
+import { solidLogicSingleton, store, authn } from 'solid-logic';
+
+// Example usage
+console.log('Current user:', authn.currentUser());
+```
+
+## 🌐 Use directly in a browser
+
+Both UMD and ESM bundles externalize rdflib to keep bundle sizes small and avoid version conflicts.
+
+## Available Files
+
+| Format | File | Usage | Global Variable |
+|--------|------|-------|----------------|
+| UMD | `dist/solid-logic.js` | Development | `window.SolidLogic` |
+| UMD | `dist/solid-logic.min.js` | Production | `window.SolidLogic` |
+| ESM | `dist/solid-logic.esm.js` | Development | Import only |
+| ESM | `dist/solid-logic.esm.min.js` | Production | Import only |
+
+### UMD Bundle (Script Tags)
+
+**⚠️ Important**: Load rdflib **before** solid-logic or you'll get `$rdf is not defined` errors.
+
+```html
+<!-- 1. Load rdflib first (creates window.$rdf) -->
+<script src="https://cdn.jsdelivr.net/npm/rdflib/dist/rdflib.min.js"></script>
+
+<!-- 2. Load solid-logic (expects $rdf to exist) -->
+<script src="https://unpkg.com/solid-logic/dist/solid-logic.min.js"></script>
+
+<script>
+	// Access via global variable
+	const { solidLogicSingleton, store, authn } = window.SolidLogic;
+	
+	// Example usage
+	console.log('Store:', store);
+	console.log('Authentication:', authn.currentUser());
+</script>
+```
+
+### ESM Bundle (Native Modules)
+
+```html
+<script type="module">
+	import * as $rdf from 'https://esm.sh/rdflib';
+	import { solidLogicSingleton, store, authn } from 'https://esm.sh/solid-logic';
+
+	// Example usage
+	console.log('Store:', store);
+	console.log('Authentication:', authn.currentUser());
+</script>
+```
+
+### ESM with Import Maps (Recommended)
+
+```html
+<script type="importmap">
+{
+	"imports": {
+		"rdflib": "https://esm.sh/rdflib",
+		"solid-logic": "https://esm.sh/solid-logic"
+	}
+}
+</script>
+<script type="module">
+	import * as $rdf from 'rdflib';
+	import { solidLogicSingleton, store, authn } from 'solid-logic';
+
+	// Example usage - cleaner imports!
+	console.log('Store:', store);
+	console.log('Authentication:', authn.currentUser());
+</script>
+```
+
+## Common Exports
+
+```js
+import { 
+	solidLogicSingleton,  // Complete singleton instance
+	store,                // RDF store
+	authn,                // Authentication logic
+	authSession,          // Authentication session
+	ACL_LINK,            // ACL constants
+	getSuggestedIssuers,  // Identity provider suggestions
+	createTypeIndexLogic, // Type index functionality
+	// Error classes
+	UnauthorizedError,
+	NotFoundError,
+	FetchError
+} from 'solid-logic';
+```
+
+# How to develop
+
+Check the scripts in the `package.json` for build, watch, lint and test.
+
+# Used stack
+
+* TypeScript + Babel
+* Jest
+* ESLint
+* Webpack
+
+# How to release
+
+Change version and push directly to main. This will trigger the npm release latest script in CI.
+
+# History
 
 Solid-logic was a move to separate business logic from UI functionality so that people using different UI frameworks could use logic code. 
 

package/dist/acl/aclLogic.d.ts

@@ -0,0 +1,5 @@
+import { NamedNode } from 'rdflib';
+import { AclLogic } from '../types';
+export declare const ACL_LINK: NamedNode;
+export declare function createAclLogic(store: any): AclLogic;
+//# sourceMappingURL=aclLogic.d.ts.map

package/{lib → dist}/acl/aclLogic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aclLogic.d.ts","sourceRoot":"","sources":["../../src/acl/aclLogic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,SAAS,EAA6B,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAIpC,eAAO,MAAM,QAAQ,WAEpB,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,KAAA,GAAG,QAAQ,CAkJ9C"}
+{"version":3,"file":"aclLogic.d.ts","sourceRoot":"","sources":["../../src/acl/aclLogic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,SAAS,EAA6B,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAInC,eAAO,MAAM,QAAQ,WAEpB,CAAA;AAED,wBAAgB,cAAc,CAAC,KAAK,KAAA,GAAG,QAAQ,CAiJ9C"}

package/dist/acl/aclLogic.js

@@ -0,0 +1,117 @@
+import { graph, Namespace, serialize, sym } from 'rdflib';
+import { ns as namespace } from '../util/ns';
+export const ACL_LINK = sym('http://www.iana.org/assignments/link-relations/acl');
+export function createAclLogic(store) {
+    const ns = namespace;
+    async function findAclDocUrl(url) {
+        await store.fetcher.load(url);
+        const docNode = store.any(url, ACL_LINK);
+        if (!docNode) {
+            throw new Error(`No ACL link discovered for ${url}`);
+        }
+        return docNode.value;
+    }
+    /**
+     * 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, me, options) {
+        const aclDoc = store.any(store.sym(docURI), ACL_LINK);
+        return Promise.resolve()
+            .then(() => {
+            if (aclDoc) {
+                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);
+                }
+                return aclDoc;
+            });
+        });
+    }
+    /**
+     * @param docURI
+     * @returns
+     */
+    function fetchACLRel(docURI) {
+        const fetcher = store.fetcher;
+        if (!fetcher) {
+            throw new Error('Cannot fetch ACL rel, store has no fetcher');
+        }
+        return fetcher.load(docURI).then(result => {
+            if (!result.ok) {
+                throw new Error('fetchACLRel: While loading:' + result.error);
+            }
+            const aclDoc = store.any(store.sym(docURI), ACL_LINK);
+            if (!aclDoc) {
+                throw new Error('fetchACLRel: No Link rel=ACL header for ' + docURI);
+            }
+            return aclDoc;
+        });
+    }
+    /**
+     * @param docURI
+     * @param me
+     * @param aclURI
+     * @param options
+     *
+     * @returns Serialized ACL
+     */
+    function genACLText(docURI, me, aclURI, options = {}) {
+        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
+            }
+        }
+        return serialize(acl, g, aclURI);
+    }
+    return {
+        findAclDocUrl,
+        setACLUserPublic,
+        genACLText
+    };
+}
+//# sourceMappingURL=aclLogic.js.map

package/dist/acl/aclLogic.js.map

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

package/dist/authSession/authSession.js

@@ -0,0 +1,3 @@
+import { Session, } from '@inrupt/solid-client-authn-browser';
+export const authSession = new Session();
+//# sourceMappingURL=authSession.js.map

package/dist/authSession/authSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authSession.js","sourceRoot":"","sources":["../../src/authSession/authSession.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,GACR,MAAM,oCAAoC,CAAA;AAE3C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,EAAE,CAAA"}

package/{lib → dist}/authn/SolidAuthnLogic.d.ts

@@ -1,6 +1,6 @@
-import { NamedNode } from "rdflib";
-import { Session } from "@inrupt/solid-client-authn-browser";
-import { AuthenticationContext, AuthnLogic } from "../types";
+import { NamedNode } from 'rdflib';
+import { Session } from '@inrupt/solid-client-authn-browser';
+import { AuthenticationContext, AuthnLogic } from '../types';
 export declare class SolidAuthnLogic implements AuthnLogic {
     private session;
     constructor(solidAuthSession: Session);

package/{lib → dist}/authn/SolidAuthnLogic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SolidAuthnLogic.d.ts","sourceRoot":"","sources":["../../src/authn/SolidAuthnLogic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,SAAS,EAAO,MAAM,QAAQ,CAAC;AAGnD,OAAO,EAAU,OAAO,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE7D,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,OAAO,CAAU;gBAEb,gBAAgB,EAAE,OAAO;IAKrC,IAAI,WAAW,IAAG,OAAO,CAAwB;IAEjD,WAAW,IAAI,SAAS,GAAG,IAAI;IAW/B;;;;;;OAMG;IACG,SAAS,CAAC,CAAC,EACf,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,KAAK,CAAC,GAC5C,OAAO,CAAC,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC;IA2DhC;;;;;;OAMG;IACH,QAAQ,CACN,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAChC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,SAAS,GAAG,IAAI;IAanB;;OAEG;IACH,gBAAgB,CAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,IAAI;CAKpF"}
+{"version":3,"file":"SolidAuthnLogic.d.ts","sourceRoot":"","sources":["../../src/authn/SolidAuthnLogic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,SAAS,EAAO,MAAM,QAAQ,CAAA;AAGlD,OAAO,EAAU,OAAO,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE5D,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,OAAO,CAAS;gBAEZ,gBAAgB,EAAE,OAAO;IAKrC,IAAI,WAAW,IAAG,OAAO,CAAwB;IAEjD,WAAW,IAAI,SAAS,GAAG,IAAI;IAW/B;;;;;;OAMG;IACG,SAAS,CAAC,CAAC,EACf,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,KAAK,CAAC,GAC5C,OAAO,CAAC,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC;IA2DhC;;;;;;OAMG;IACH,QAAQ,CACN,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAChC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,SAAS,GAAG,IAAI;IAanB;;OAEG;IACH,gBAAgB,CAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,IAAI;CAKpF"}

package/dist/authn/SolidAuthnLogic.js

@@ -0,0 +1,109 @@
+import { namedNode, sym } from 'rdflib';
+import { appContext, offlineTestID } from './authUtil';
+import * as debug from '../util/debug';
+import { EVENTS } from '@inrupt/solid-client-authn-browser';
+export class SolidAuthnLogic {
+    constructor(solidAuthSession) {
+        this.session = solidAuthSession;
+    }
+    // we created authSession getter because we want to access it as authn.authSession externally
+    get authSession() { return this.session; }
+    currentUser() {
+        const app = appContext();
+        if (app.viewingNoAuthPage) {
+            return sym(app.webId);
+        }
+        if (this && this.session && this.session.info && this.session.info.webId && this.session.info.isLoggedIn) {
+            return sym(this.session.info.webId);
+        }
+        return offlineTestID(); // null unless testing
+    }
+    /**
+     * Retrieves currently logged in webId from either
+     * defaultTestUser or SolidAuth
+     * Also activates a session after login
+     * @param [setUserCallback] Optional callback
+     * @returns Resolves with webId uri, if no callback provided
+     */
+    async checkUser(setUserCallback) {
+        // Save hash for "restorePreviousSession"
+        const preLoginRedirectHash = new URL(window.location.href).hash;
+        if (preLoginRedirectHash) {
+            window.localStorage.setItem('preLoginRedirectHash', preLoginRedirectHash);
+        }
+        this.session.events.on(EVENTS.SESSION_RESTORED, (url) => {
+            debug.log(`Session restored to ${url}`);
+            if (document.location.toString() !== url)
+                history.replaceState(null, '', url);
+        });
+        /**
+         * Handle a successful authentication redirect
+         */
+        const redirectUrl = new URL(window.location.href);
+        redirectUrl.hash = '';
+        await this.session
+            .handleIncomingRedirect({
+            restorePreviousSession: true,
+            url: redirectUrl.href
+        });
+        // Check to see if a hash was stored in local storage
+        const postLoginRedirectHash = window.localStorage.getItem('preLoginRedirectHash');
+        if (postLoginRedirectHash) {
+            const curUrl = new URL(window.location.href);
+            if (curUrl.hash !== postLoginRedirectHash) {
+                if (history.pushState) {
+                    // debug.log('Setting window.location.has using pushState')
+                    history.pushState(null, document.title, postLoginRedirectHash);
+                }
+                else {
+                    // debug.warn('Setting window.location.has using location.hash')
+                    location.hash = postLoginRedirectHash;
+                }
+                curUrl.hash = postLoginRedirectHash;
+            }
+            // See https://stackoverflow.com/questions/3870057/how-can-i-update-window-location-hash-without-jumping-the-document
+            // window.location.href = curUrl.toString()// @@ See https://developer.mozilla.org/en-US/docs/Web/API/Window/location
+            window.localStorage.setItem('preLoginRedirectHash', '');
+        }
+        // Check to see if already logged in / have the WebID
+        let me = offlineTestID();
+        if (me) {
+            return Promise.resolve(setUserCallback ? setUserCallback(me) : me);
+        }
+        const webId = this.webIdFromSession(this.session.info);
+        if (webId) {
+            me = this.saveUser(webId);
+        }
+        if (me) {
+            debug.log(`(Logged in as ${me} by authentication)`);
+        }
+        return Promise.resolve(setUserCallback ? setUserCallback(me) : me);
+    }
+    /**
+     * Saves `webId` in `context.me`
+     * @param webId
+     * @param context
+     *
+     * @returns Returns the WebID, after setting it
+     */
+    saveUser(webId, context) {
+        let webIdUri;
+        if (webId) {
+            webIdUri = (typeof webId === 'string') ? webId : webId.uri;
+            const me = namedNode(webIdUri);
+            if (context) {
+                context.me = me;
+            }
+            return me;
+        }
+        return null;
+    }
+    /**
+     * @returns {Promise<string|null>} Resolves with WebID URI or null
+     */
+    webIdFromSession(session) {
+        const webId = (session === null || session === void 0 ? void 0 : session.webId) && session.isLoggedIn ? session.webId : null;
+        return webId;
+    }
+}
+//# sourceMappingURL=SolidAuthnLogic.js.map

package/dist/authn/SolidAuthnLogic.js.map

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

package/{lib → dist}/authn/authUtil.d.ts

@@ -1,4 +1,4 @@
-import { NamedNode } from "rdflib";
+import { NamedNode } from 'rdflib';
 /**
  * find a user or app's context as set in window.SolidAppContext
  * this is a const, not a function, because we have problems to jest mock it otherwise

package/dist/authn/authUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authUtil.d.ts","sourceRoot":"","sources":["../../src/authn/authUtil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAO,MAAM,QAAQ,CAAA;AAGvC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,QAAM,GAuB5B,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAK,SAAS,GAAG,IAAI,CAyBjD"}

package/dist/authn/authUtil.js

@@ -0,0 +1,64 @@
+import { sym } from 'rdflib';
+import * as debug from '../util/debug';
+/**
+ * find a user or app's context as set in window.SolidAppContext
+ * this is a const, not a function, because we have problems to jest mock it otherwise
+ * see: https://github.com/facebook/jest/issues/936#issuecomment-545080082 for more
+ * @return {any} - an appContext object
+ */
+export const appContext = () => {
+    let { SolidAppContext } = window;
+    SolidAppContext || (SolidAppContext = {});
+    SolidAppContext.viewingNoAuthPage = false;
+    if (SolidAppContext.noAuth && window.document) {
+        const currentPage = window.document.location.href;
+        if (currentPage.startsWith(SolidAppContext.noAuth)) {
+            SolidAppContext.viewingNoAuthPage = true;
+            const params = new URLSearchParams(window.document.location.search);
+            if (params) {
+                let viewedPage = SolidAppContext.viewedPage = params.get('uri') || null;
+                if (viewedPage) {
+                    viewedPage = decodeURI(viewedPage);
+                    if (!viewedPage.startsWith(SolidAppContext.noAuth)) {
+                        const ary = viewedPage.split(/\//);
+                        SolidAppContext.idp = ary[0] + '//' + ary[2];
+                        SolidAppContext.viewingNoAuthPage = false;
+                    }
+                }
+            }
+        }
+    }
+    return SolidAppContext;
+};
+/**
+ * Returns `sym($SolidTestEnvironment.username)` if
+ * `$SolidTestEnvironment.username` is defined as a global
+ * or
+ * returns testID defined in the HTML page
+ * @returns {NamedNode|null}
+ */
+export function offlineTestID() {
+    const { $SolidTestEnvironment } = window;
+    if (typeof $SolidTestEnvironment !== 'undefined' &&
+        $SolidTestEnvironment.username) {
+        // Test setup
+        debug.log('Assuming the user is ' + $SolidTestEnvironment.username);
+        return sym($SolidTestEnvironment.username);
+    }
+    // hack that makes SolidOS work in offline mode by adding the webId directly in html
+    // example usage: https://github.com/solidos/mashlib/blob/29b8b53c46bf02e0e219f0bacd51b0e9951001dd/test/contact/local.html#L37
+    if (typeof document !== 'undefined' &&
+        document.location &&
+        ('' + document.location).slice(0, 16) === 'http://localhost') {
+        const div = document.getElementById('appTarget');
+        if (!div)
+            return null;
+        const id = div.getAttribute('testID');
+        if (!id)
+            return null;
+        debug.log('Assuming user is ' + id);
+        return sym(id);
+    }
+    return null;
+}
+//# sourceMappingURL=authUtil.js.map

package/dist/authn/authUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authUtil.js","sourceRoot":"","sources":["../../src/authn/authUtil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,GAAG,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,eAAe,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAO,EAAE;IAC/B,IAAI,EAAE,eAAe,EAAE,GAAQ,MAAM,CAAA;IACrC,eAAe,KAAf,eAAe,GAAK,EAAE,EAAA;IACtB,eAAe,CAAC,iBAAiB,GAAG,KAAK,CAAA;IACzC,IAAI,eAAe,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAA;QACjD,IAAI,WAAW,CAAC,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;YACrD,eAAe,CAAC,iBAAiB,GAAG,IAAI,CAAA;YACxC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YACnE,IAAI,MAAM,EAAE,CAAC;gBACT,IAAI,UAAU,GAAG,eAAe,CAAC,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAA;gBACvE,IAAI,UAAU,EAAE,CAAC;oBACjB,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,CAAA;oBAClC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;wBACjD,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;wBAClC,eAAe,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;wBAC5C,eAAe,CAAC,iBAAiB,GAAG,KAAK,CAAA;oBAC7C,CAAC;gBACD,CAAC;YACL,CAAC;QACD,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAA;AAC1B,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa;IACzB,MAAM,EAAE,qBAAqB,EAAE,GAAQ,MAAM,CAAA;IAC7C,IACE,OAAO,qBAAqB,KAAK,WAAW;QAC5C,qBAAqB,CAAC,QAAQ,EAC9B,CAAC;QACD,aAAa;QACb,KAAK,CAAC,GAAG,CAAC,uBAAuB,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAA;QACnE,OAAO,GAAG,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAC5C,CAAC;IACD,oFAAoF;IACpF,8HAA8H;IAC9H,IACE,OAAO,QAAQ,KAAK,WAAW;QAC/B,QAAQ,CAAC,QAAQ;QACjB,CAAC,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,kBAAkB,EAC5D,CAAC;QACD,MAAM,GAAG,GAAG,QAAQ,CAAC,cAAc,CAAC,WAAW,CAAC,CAAA;QAChD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAA;QACrB,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;QACrC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAA;QACpB,KAAK,CAAC,GAAG,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAA;QACnC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,IAAI,CAAA;AACf,CAAC"}

package/{lib → dist}/chat/chatLogic.d.ts

@@ -1,3 +1,3 @@
-import { ChatLogic } from "../types";
+import { ChatLogic } from '../types';
 export declare function createChatLogic(store: any, profileLogic: any): ChatLogic;
 //# sourceMappingURL=chatLogic.d.ts.map

package/{lib → dist}/chat/chatLogic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chatLogic.d.ts","sourceRoot":"","sources":["../../src/chat/chatLogic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAA4C,MAAM,UAAU,CAAA;AAM9E,wBAAgB,eAAe,CAAC,KAAK,KAAA,EAAE,YAAY,KAAA,GAAG,SAAS,CA0N9D"}
+{"version":3,"file":"chatLogic.d.ts","sourceRoot":"","sources":["../../src/chat/chatLogic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAA4C,MAAM,UAAU,CAAA;AAM9E,wBAAgB,eAAe,CAAC,KAAK,KAAA,EAAE,YAAY,KAAA,GAAG,SAAS,CAyN9D"}