@_linked/server 3.11.0 → 3.12.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @\_linked/server
 
+## 3.12.1
+
+### Patch Changes
+
+- [#214](https://github.com/linked-fw/server/pull/214) [`654a3c2`](https://github.com/linked-fw/server/commit/654a3c2941ef49e317dd2ba58324f0221e894ca3) Thanks [@flyon](https://github.com/flyon)! - License: MIT (data under its original license)
+
+## 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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Semantu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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 });