solid-logic 3.1.1-86b6bac → 3.1.1-8dffdcb

package/README.md

@@ -10,64 +10,71 @@ Core business logic of SolidOS which can be used for any webapp as well.
 
 # Usage
 
-## Install via npm
+## 📦 Install via npm
 
 ```sh
-npm install solid-logic
+npm install solid-logic rdflib
 ```
 
+> **Important**: `rdflib` is a peer dependency - you must install it separately.
+
 ### Import in your project (ESM/TypeScript)
 
 ```js
-import { someFunction } from 'solid-logic';
+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 take rdflib as external, this means you need to install it yourself, separately. 
+## 🌐 Use directly in a browser
+
+Both UMD and ESM bundles externalize rdflib to keep bundle sizes small and avoid version conflicts.
+
+## Available Files
 
-## Files
-- For browser UMD, without rdflib: `dist/solid-logic.js` (global `window.SolidLogic`)
-- For browser ESM, without rdflib: `dist/solid-logic.esm.js` (import as module)
-- UMD has also chunked files.
-- both versions also contain minified versions.
+| 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)
 
-### UMD bundle (global variable)
+**⚠️ Important**: Load rdflib **before** solid-logic or you'll get `$rdf is not defined` errors.
 
 ```html
-<!-- Load dependencies first -->
+<!-- 1. Load rdflib first (creates window.$rdf) -->
 <script src="https://cdn.jsdelivr.net/npm/rdflib/dist/rdflib.min.js"></script>
-<!-- Load solid-logic UMD bundle -->
+
+<!-- 2. Load solid-logic (expects $rdf to exist) -->
 <script src="https://unpkg.com/solid-logic/dist/solid-logic.min.js"></script>
-<!-- or -->
-<!-- script src="https://cdn.jsdelivr.net/npm/solid-logic/dist/solid-logic.min.js"></script -->
-<!-- or -->
-<!-- script src="dist/solid-logic.js"></script -->
+
 <script>
 	// Access via global variable
-	const rdflib = window.$rdf;
-	const logic = window.SolidLogic;
+	const { solidLogicSingleton, store, authn } = window.SolidLogic;
+	
 	// Example usage
-	// logic.someFunction(...)
+	console.log('Store:', store);
+	console.log('Authentication:', authn.currentUser());
 </script>
 ```
 
-
-### ESM bundle (import as module)
+### ESM Bundle (Native Modules)
 
 ```html
 <script type="module">
-	import * as $rdf from 'https://esm.sh/rdflib'
-	import { someFunction } from 'https://esm.sh/solid-logic'
+	import * as $rdf from 'https://esm.sh/rdflib';
+	import { solidLogicSingleton, store, authn } from 'https://esm.sh/solid-logic';
 
 	// Example usage
-	// someFunction(...)
+	console.log('Store:', store);
+	console.log('Authentication:', authn.currentUser());
 </script>
 ```
 
-or 
-
-### ESM bundle with import map (bare specifiers)
+### ESM with Import Maps (Recommended)
 
 ```html
 <script type="importmap">
@@ -79,14 +86,33 @@ or
 }
 </script>
 <script type="module">
-    import * as $rdf from 'rdflib'
-	import { someFunction } from 'solid-logic'
+	import * as $rdf from 'rdflib';
+	import { solidLogicSingleton, store, authn } from 'solid-logic';
 
-	// Example usage
-	// someFunction(...)
+	// 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.

package/dist/logic/solidLogicSingleton.js

@@ -13,17 +13,17 @@ const _fetch = async (url, requestInit) => {
 };
 // Global singleton pattern to ensure unique store across library versions
 const SINGLETON_SYMBOL = Symbol.for('solid-logic-singleton');
-const globalThis = (typeof window !== 'undefined' ? window : global);
+const globalTarget = (typeof window !== 'undefined' ? window : global);
 function getOrCreateSingleton() {
-    if (!globalThis[SINGLETON_SYMBOL]) {
+    if (!globalTarget[SINGLETON_SYMBOL]) {
         debug.log('SolidLogic: Creating new global singleton instance.');
-        globalThis[SINGLETON_SYMBOL] = createSolidLogic({ fetch: _fetch }, authSession);
+        globalTarget[SINGLETON_SYMBOL] = createSolidLogic({ fetch: _fetch }, authSession);
         debug.log('Unique quadstore initialized.');
     }
     else {
         debug.log('SolidLogic: Using existing global singleton instance.');
     }
-    return globalThis[SINGLETON_SYMBOL];
+    return globalTarget[SINGLETON_SYMBOL];
 }
 //this const makes solidLogicSingleton global accessible in mashlib
 const solidLogicSingleton = getOrCreateSingleton();

package/dist/logic/solidLogicSingleton.js.map

@@ -1 +1 @@
-{"version":3,"file":"solidLogicSingleton.js","sourceRoot":"","sources":["../../src/logic/solidLogicSingleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAG/C,MAAM,MAAM,GAAG,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE;IACtC,MAAM,SAAS,GAAG,WAAW,IAAI,WAAW,CAAC,WAAW,IAAI,WAAW,CAAC,WAAW,IAAI,MAAM,CAAA;IAC7F,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,oDAAoD;QAC5F,uDAAuD;QACvD,OAAO,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IAC9C,CAAC;SAAM,CAAC;QACJ,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IACzC,CAAC;AACL,CAAC,CAAA;AAED,0EAA0E;AAC1E,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;AAO5D,MAAM,UAAU,GAAG,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAwB,CAAA;AAE3F,SAAS,oBAAoB;IACzB,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAA;QAChE,UAAU,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,CAAA;QAC/E,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAA;IAC9C,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAA;IACtE,CAAC;IACD,OAAO,UAAU,CAAC,gBAAgB,CAAE,CAAA;AACxC,CAAC;AACD,mEAAmE;AACnE,MAAM,mBAAmB,GAAG,oBAAoB,EAAE,CAAA;AAElD,OAAO,EAAE,mBAAmB,EAAE,CAAA"}
+{"version":3,"file":"solidLogicSingleton.js","sourceRoot":"","sources":["../../src/logic/solidLogicSingleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAG/C,MAAM,MAAM,GAAG,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE;IACtC,MAAM,SAAS,GAAG,WAAW,IAAI,WAAW,CAAC,WAAW,IAAI,WAAW,CAAC,WAAW,IAAI,MAAM,CAAA;IAC7F,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,oDAAoD;QAC5F,uDAAuD;QACvD,OAAO,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IAC9C,CAAC;SAAM,CAAC;QACJ,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IACzC,CAAC;AACL,CAAC,CAAA;AAED,0EAA0E;AAC1E,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;AAO5D,MAAM,YAAY,GAAG,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAwB,CAAA;AAE7F,SAAS,oBAAoB;IACzB,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAA;QAChE,YAAY,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,CAAA;QACjF,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAA;IAC9C,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAA;IACtE,CAAC;IACD,OAAO,YAAY,CAAC,gBAAgB,CAAE,CAAA;AAC1C,CAAC;AACD,mEAAmE;AACnE,MAAM,mBAAmB,GAAG,oBAAoB,EAAE,CAAA;AAElD,OAAO,EAAE,mBAAmB,EAAE,CAAA"}

package/dist/solid-logic.esm.js

@@ -7283,17 +7283,17 @@ const _fetch = async (url, requestInit) => {
 };
 // Global singleton pattern to ensure unique store across library versions
 const SINGLETON_SYMBOL = Symbol.for('solid-logic-singleton');
-const globalThis = (typeof window !== 'undefined' ? window : __webpack_require__.g);
+const globalTarget = (typeof window !== 'undefined' ? window : __webpack_require__.g);
 function getOrCreateSingleton() {
-    if (!globalThis[SINGLETON_SYMBOL]) {
+    if (!globalTarget[SINGLETON_SYMBOL]) {
         log('SolidLogic: Creating new global singleton instance.');
-        globalThis[SINGLETON_SYMBOL] = createSolidLogic({ fetch: _fetch }, authSession);
+        globalTarget[SINGLETON_SYMBOL] = createSolidLogic({ fetch: _fetch }, authSession);
         log('Unique quadstore initialized.');
     }
     else {
         log('SolidLogic: Using existing global singleton instance.');
     }
-    return globalThis[SINGLETON_SYMBOL];
+    return globalTarget[SINGLETON_SYMBOL];
 }
 //this const makes solidLogicSingleton global accessible in mashlib
 const solidLogicSingleton = getOrCreateSingleton();