@_linked/server 3.11.0 → 3.12.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @\_linked/server
 
+## 3.12.0
+
+### Minor Changes
+
+- [#212](https://github.com/linked-fw/server/pull/212) [`2ac07c4`](https://github.com/linked-fw/server/commit/2ac07c49918f31d94bcec03821a0ab29b1811f85) Thanks [@flyon](https://github.com/flyon)! - The graph targets are one global setting (`@_linked/core` 2.42). At boot the server reads `LINKED_ONTOLOGY_GRAPH` / `LINKED_SHAPE_GRAPH` (an invalid value is still a fatal boot error) and calls core's `setGraphTargets` once, before the boot initialises the stores and before the syncs; it no longer sets targets on each store. `GET /admin/routes` reports the setting as `graphTargets` (`{ontologyGraph, shapeGraph}`) next to `graphTargetEnv`; the per-dataset `ontologyGraph` / `shapeGraph` fields are gone. New boot warning: when routing pins `NodeShape` / `PropertyShape` or the ontology term shapes (`rdfs:Class`, `owl:Class`, `rdf:Property`, `owl:ObjectProperty`, `owl:DatatypeProperty`, `owl:AnnotationProperty`) to a dataset other than the default one, the server names them and the dataset and says the syncs write into the default dataset only. `applyGraphTargetsFromEnv(env)` takes no stores any more. Requires `@_linked/core` 2.42.0.
+
 ## 3.11.0
 
 ### Minor Changes

package/lib/esm/shapes/LinkedServer.d.ts

@@ -133,6 +133,12 @@ export declare class LinkedServer extends Shape {
     private syncRegisteredShapes;
     /** The root directory of a package with shapes: the app, a discovered linked package, or one the app resolves. */
     private shapePackageDir;
+    /**
+     * Boot: one warning when routing pins the shape shapes or the ontology term shapes to a dataset
+     * other than the default one, since the syncs write into the default dataset only (see
+     * {@link syncPinWarning}).
+     */
+    private warnOfSyncPins;
     /**
      * Boot: sync the registered ontologies into their graphs in app data and run the shape
      * check, before the shape sync (see utils/ontologySync). The sync follows the shape sync's

package/lib/esm/shapes/LinkedServer.js

@@ -139,7 +139,7 @@ import { resolveRouteAssets } from '../utils/routeAssets.js';
 import { resolveRouteComponent, ssrCssInlineUrls, ssrCssScope, } from '../utils/ssrCss.js';
 import { appShapesGraph, bootOrphanScope, loadShapeGraphCore, syncShapeGraphsInto, viteShapesTurtleGenerator, } from '../utils/syncShapes.js';
 import { bootSyncsOntologies, loadOntologyCore, runOntologyPhase, ontologyPackageDirs, sourceModuleImporter, shapeSyncOn, syncOntologiesThenShapes, } from '../utils/ontologySync.js';
-import { applyGraphTargetsFromEnv } from '../utils/graphTargets.js';
+import { applyGraphTargetsFromEnv, syncPinWarning } from '../utils/graphTargets.js';
 import { AdminRequestError, assertReloadablePackages, registerAdminRoutes, resolveAdminSecret, } from '../utils/adminChannel.js';
 import { envMs, withTimeout } from '../utils/withTimeout.js';
 import { invalidateSourceUnder } from '../utils/reloadSource.js';
@@ -364,6 +364,7 @@ let LinkedServer = class LinkedServer extends Shape {
         this.initPackage();
         this.server = express();
         await this.initBackendProviders();
+        this.warnOfSyncPins();
         await this.syncOntologiesOnBoot();
         await this.materializeShapesIntoStore();
         return this;
@@ -437,6 +438,16 @@ let LinkedServer = class LinkedServer extends Shape {
         const installed = readInstalledPackage(name, process.cwd());
         return installed === null || installed === void 0 ? void 0 : installed.root;
     }
+    /**
+     * Boot: one warning when routing pins the shape shapes or the ontology term shapes to a dataset
+     * other than the default one, since the syncs write into the default dataset only (see
+     * {@link syncPinWarning}).
+     */
+    warnOfSyncPins() {
+        const warning = syncPinWarning();
+        if (warning)
+            console.warn(warning);
+    }
     /**
      * Boot: sync the registered ontologies into their graphs in app data and run the shape
      * check, before the shape sync (see utils/ontologySync). The sync follows the shape sync's
@@ -684,6 +695,7 @@ let LinkedServer = class LinkedServer extends Shape {
         // });
         // before controllers
         await this.initBackendProviders();
+        this.warnOfSyncPins();
         await this.syncOntologiesOnBoot();
         await this.materializeShapesIntoStore();
         //START OF EXPRESS ROUTES AND MIDDLEWARE
@@ -808,11 +820,11 @@ let LinkedServer = class LinkedServer extends Shape {
      */
     async initStores() {
         var _a;
-        // LINKED_ONTOLOGY_GRAPH / LINKED_SHAPE_GRAPH: checked (an invalid value stops the boot) and
-        // filled into every store that takes graph targets, before anything reads or syncs.
+        // LINKED_ONTOLOGY_GRAPH / LINKED_SHAPE_GRAPH: checked (an invalid value stops the boot) and set
+        // once as core's global graph targets, before any store is initialised and before the syncs.
         // A rejected boot does not end the process by itself, so the error is fatal.
         try {
-            applyGraphTargetsFromEnv(process.env, LinkedStorage.getDatasets());
+            applyGraphTargetsFromEnv(process.env);
         }
         catch (err) {
             throw new FatalStartupError(`[LinkedServer] ${(_a = err === null || err === void 0 ? void 0 : err.message) !== null && _a !== void 0 ? _a : err}`, { cause: err });