@_linked/server 3.10.0 → 3.12.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @\_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
+
+- [#210](https://github.com/linked-fw/server/pull/210) [`f494caa`](https://github.com/linked-fw/server/commit/f494caadb531d8acdbd3729a31df7ffe3dfbd525) Thanks [@flyon](https://github.com/flyon)! - `LINKED_ONTOLOGY_GRAPH` and `LINKED_SHAPE_GRAPH` set where the stores keep the packages' ontology data and shapes (core 2.41's graph targets): `package` (default), `default`, or the absolute IRI of one shared graph. The server checks them at boot (an invalid value stops the boot, naming the variable) and fills them into every store that takes graph targets, where the store's own options leave them unset; a store that takes none (`RemoteDataset`) runs `package`, with a warning when the variables ask for another mode. `GET /admin/routes` reports each store's `ontologyGraph` / `shapeGraph` and the variables (`graphTargetEnv`). The boot log names a shared graph or the default graph when the syncs wrote there, and `shapeGraphs` reports `target`. The ontology phase's `graphs` / `droppedGraphs` no longer list the inference probe's temporary graphs. Needs `@_linked/core` ^2.41.0.
+
 ## 3.10.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

@@ -39,7 +39,7 @@ import { LinkedStorage } from '@_linked/core/utils/LinkedStorage';
 import { getAllShapeClasses, getShapeClass, getSuperShapesClasses, } from '@_linked/core/utils/ShapeClass';
 import path from 'path';
 import { pathToFileURL } from 'node:url';
-import { isFatalError } from '../utils/fatalError.js';
+import { FatalStartupError, isFatalError } from '../utils/fatalError.js';
 import { discoverLinkedDependencies, hasModuleEntry, isBundledBySsr, NODE_IMPORT_CONDITIONS, readDependencyLists, readInstalledPackage, resolveBackendEntry, resolveDevBackendEntry, ssrNoExternalOf, } from '../utils/linkedDependencies.js';
 /**
  * `instanceof ShapeProvider`, tolerating a second copy of server-utils.
@@ -139,6 +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, 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';
@@ -363,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;
@@ -436,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
@@ -683,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
@@ -806,6 +819,16 @@ let LinkedServer = class LinkedServer extends Shape {
      * @todo Check if default file store is set, if not, set it
      */
     async initStores() {
+        var _a;
+        // 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);
+        }
+        catch (err) {
+            throw new FatalStartupError(`[LinkedServer] ${(_a = err === null || err === void 0 ? void 0 : err.message) !== null && _a !== void 0 ? _a : err}`, { cause: err });
+        }
         return Promise.all(LinkedStorage.getDatasets().map((store) => {
             return store.init ? store.init() : Promise.resolve();
         }));