@_linked/server 3.12.1 → 3.14.0

package/lib/esm/utils/graphTargets.d.ts

@@ -11,32 +11,57 @@
  * `.from(graphs.allOntologies)` reaches the backend as the portable name, and the backend's
  * store expands it under this setting.
  *
- * The syncs write into the default dataset only. {@link syncPinWarning} names the shapes whose
- * routing sends their reads elsewhere.
+ * The syncs follow the storage routing (core's `syncTargets`); {@link syncTargetsLine} names the
+ * datasets they write into when that is more than the default dataset.
  */
 import { type GraphTargets } from '@_linked/core/utils/graphTargets';
+import type { GraphSyncTargets } from '@_linked/core/shapes/syncTargets';
+import type { IDataset } from '@_linked/core/interfaces/IDataset';
 /**
  * Read `LINKED_ONTOLOGY_GRAPH` / `LINKED_SHAPE_GRAPH` from `env` (checked: an invalid value throws,
  * naming the variable) and set them as the process's graph targets (core's `setGraphTargets`;
  * unset ones are `'package'`). Returns the settings the env gave.
  */
 export declare function applyGraphTargetsFromEnv(env: Record<string, string | undefined>): Partial<GraphTargets>;
-/** The env variables as set (unset and empty ones left out), for `GET /admin/routes`. */
-export declare function graphTargetEnv(env: Record<string, string | undefined>): Record<string, string>;
-/** The classes of the shape shapes: what the shape sync writes. */
-export declare const SHAPE_SHAPE_CLASSES: readonly string[];
+/** The variable that says who writes the app's shape and ontology graphs. */
+export declare const GRAPH_WRITER_ENV = "LINKED_GRAPH_WRITER";
+/**
+ * Who writes the app's shape and ontology graphs: `'app'` (the default) the app itself, at boot;
+ * `'host'` a host that runs it (Create Now), which reads the
+ * content through `POST /admin/graph-content` and writes it itself, so the app writes none.
+ */
+export type GraphWriter = 'app' | 'host';
 /**
- * The classes of the ontology term shapes (the class and property shapes core, `@_linked/rdfs`
- * and `@_linked/owl` register): what the ontology sync writes and the hierarchy reads.
+ * `LINKED_GRAPH_WRITER` from `env`: unset or empty is `'app'`; any value other than `app` or
+ * `host` throws, naming the variable (the boot stops on it).
  */
-export declare const ONTOLOGY_TERM_CLASSES: readonly string[];
+export declare function graphWriterFromEnv(env: Record<string, string | undefined>): GraphWriter;
+/**
+ * Whether this process writes its shape and ontology graphs: the one check every write path of the
+ * syncs goes through (the boot's ontology and shape syncs). False
+ * under `LINKED_GRAPH_WRITER=host`.
+ */
+export declare function appWritesGraphs(env?: Record<string, string | undefined>): boolean;
+/** The env variables as set (unset and empty ones left out), for `GET /admin/routes`. */
+export declare function graphTargetEnv(env: Record<string, string | undefined>): Record<string, string>;
+/** Which boot syncs run: only the graphs a running sync writes are named. */
+export interface BootSyncs {
+    /** The shape sync runs (`shapeSyncOn`): it writes the shape graphs and the app's shape graph. */
+    shapeSync: boolean;
+    /** The ontology sync runs (the same switch as the shape sync): it writes the ontology graphs. */
+    ontologySync: boolean;
+}
 /**
- * One warning when routing pins a shape the boot syncs write (the shape shapes `NodeShape` /
- * `PropertyShape`, or an ontology term shape such as `rdfs:Class` / `owl:ObjectProperty`) to a
- * dataset other than the default one: the syncs write into the default dataset only, so reads of
- * those shapes on the pinned dataset miss what they wrote. Names each such shape (sub-shapes of a
- * watched shape included) and its dataset. Undefined when there is nothing to warn about (or no
- * default dataset). Reads the registered shapes outside any shape catalog (run it at boot, never
- * inside `withShapeCatalog`).
+ * One log line naming the datasets the boot syncs that run write into, per graph kind, when the
+ * routing sends any graph beyond the default dataset (core's `graphSyncTargets`: a package's
+ * shape graph goes wherever its shapes or the shape shapes route, its ontology graph also
+ * wherever shapes using its classes or the term shapes route, the app's graph wherever shapes
+ * declaring `contains`, or their sub-shapes, route). Undefined when every graph goes to the default dataset only (the
+ * syncs' own lines say enough), when no sync runs or without a default dataset. `core` is
+ * `@_linked/core/shapes/syncTargets` (server only, imported when the boot runs). Reads the
+ * registered shapes outside any shape catalog (run it at boot, never inside `withShapeCatalog`).
  */
-export declare function syncPinWarning(): string | undefined;
+export declare function syncTargetsLine(syncs: BootSyncs, core: {
+    graphSyncTargets: () => GraphSyncTargets;
+    datasetLabel: (dataset: IDataset) => string;
+}): string | undefined;

package/lib/esm/utils/graphTargets.js

@@ -11,12 +11,11 @@
  * `.from(graphs.allOntologies)` reaches the backend as the portable name, and the backend's
  * store expands it under this setting.
  *
- * The syncs write into the default dataset only. {@link syncPinWarning} names the shapes whose
- * routing sends their reads elsewhere.
+ * The syncs follow the storage routing (core's `syncTargets`); {@link syncTargetsLine} names the
+ * datasets they write into when that is more than the default dataset.
  */
 import { GRAPH_TARGET_ENV, graphTargetOptionsFromEnv, setGraphTargets, } from '@_linked/core/utils/graphTargets';
 import { LinkedStorage } from '@_linked/core/utils/LinkedStorage';
-import { getAllShapeClasses } from '@_linked/core/utils/ShapeClass';
 /**
  * Read `LINKED_ONTOLOGY_GRAPH` / `LINKED_SHAPE_GRAPH` from `env` (checked: an invalid value throws,
  * naming the variable) and set them as the process's graph targets (core's `setGraphTargets`;
@@ -27,6 +26,29 @@ export function applyGraphTargetsFromEnv(env) {
     setGraphTargets(fromEnv);
     return fromEnv;
 }
+/** The variable that says who writes the app's shape and ontology graphs. */
+export const GRAPH_WRITER_ENV = 'LINKED_GRAPH_WRITER';
+/**
+ * `LINKED_GRAPH_WRITER` from `env`: unset or empty is `'app'`; any value other than `app` or
+ * `host` throws, naming the variable (the boot stops on it).
+ */
+export function graphWriterFromEnv(env) {
+    var _a;
+    const value = (_a = env[GRAPH_WRITER_ENV]) === null || _a === void 0 ? void 0 : _a.trim();
+    if (!value || value === 'app')
+        return 'app';
+    if (value === 'host')
+        return 'host';
+    throw new Error(`${GRAPH_WRITER_ENV} must be 'app' or 'host' (who writes the app's shape and ontology graphs), not ${JSON.stringify(value)}`);
+}
+/**
+ * Whether this process writes its shape and ontology graphs: the one check every write path of the
+ * syncs goes through (the boot's ontology and shape syncs). False
+ * under `LINKED_GRAPH_WRITER=host`.
+ */
+export function appWritesGraphs(env = process.env) {
+    return graphWriterFromEnv(env) === 'app';
+}
 /** The env variables as set (unset and empty ones left out), for `GET /admin/routes`. */
 export function graphTargetEnv(env) {
     const out = {};
@@ -37,77 +59,48 @@ export function graphTargetEnv(env) {
     }
     return out;
 }
-const SH = 'http://www.w3.org/ns/shacl#';
-const RDF = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#';
-const RDFS = 'http://www.w3.org/2000/01/rdf-schema#';
-const OWL = 'http://www.w3.org/2002/07/owl#';
-/** The classes of the shape shapes: what the shape sync writes. */
-export const SHAPE_SHAPE_CLASSES = [`${SH}NodeShape`, `${SH}PropertyShape`];
-/**
- * The classes of the ontology term shapes (the class and property shapes core, `@_linked/rdfs`
- * and `@_linked/owl` register): what the ontology sync writes and the hierarchy reads.
- */
-export const ONTOLOGY_TERM_CLASSES = [
-    `${RDFS}Class`,
-    `${OWL}Class`,
-    `${RDF}Property`,
-    `${OWL}ObjectProperty`,
-    `${OWL}DatatypeProperty`,
-    `${OWL}AnnotationProperty`,
-];
-/** A dataset as `GET /admin/routes` tells it apart: its store class, and its `id` when it has one. */
-function datasetName(dataset) {
-    var _a;
-    const id = dataset.id;
-    const store = ((_a = dataset === null || dataset === void 0 ? void 0 : dataset.constructor) === null || _a === void 0 ? void 0 : _a.name) || 'unknown';
-    return typeof id === 'string' && id ? `${store} "${id}"` : store;
-}
 /**
- * The watched class `shapeClass` or one of its super-shapes targets (a sub-shape of `owl:Class`,
- * say `owl:Restriction`, goes where its parent is pinned), else undefined.
+ * One log line naming the datasets the boot syncs that run write into, per graph kind, when the
+ * routing sends any graph beyond the default dataset (core's `graphSyncTargets`: a package's
+ * shape graph goes wherever its shapes or the shape shapes route, its ontology graph also
+ * wherever shapes using its classes or the term shapes route, the app's graph wherever shapes
+ * declaring `contains`, or their sub-shapes, route). Undefined when every graph goes to the default dataset only (the
+ * syncs' own lines say enough), when no sync runs or without a default dataset. `core` is
+ * `@_linked/core/shapes/syncTargets` (server only, imported when the boot runs). Reads the
+ * registered shapes outside any shape catalog (run it at boot, never inside `withShapeCatalog`).
  */
-function watchedClassOf(shapeClass, watched) {
-    var _a;
-    for (let current = shapeClass; typeof current === 'function' && current !== Function.prototype; current = Object.getPrototypeOf(current)) {
-        const id = (_a = current.targetClass) === null || _a === void 0 ? void 0 : _a.id;
-        if (typeof id === 'string' && watched.has(id))
-            return id;
-    }
-    return undefined;
-}
-/**
- * One warning when routing pins a shape the boot syncs write (the shape shapes `NodeShape` /
- * `PropertyShape`, or an ontology term shape such as `rdfs:Class` / `owl:ObjectProperty`) to a
- * dataset other than the default one: the syncs write into the default dataset only, so reads of
- * those shapes on the pinned dataset miss what they wrote. Names each such shape (sub-shapes of a
- * watched shape included) and its dataset. Undefined when there is nothing to warn about (or no
- * default dataset). Reads the registered shapes outside any shape catalog (run it at boot, never
- * inside `withShapeCatalog`).
- */
-export function syncPinWarning() {
-    var _a;
+export function syncTargetsLine(syncs, core) {
     const defaultDataset = LinkedStorage.getDefaultDataset();
-    if (!defaultDataset)
+    if (!defaultDataset || (!syncs.shapeSync && !syncs.ontologySync))
         return undefined;
-    const watched = new Set([...SHAPE_SHAPE_CLASSES, ...ONTOLOGY_TERM_CLASSES]);
-    const pinned = new Map();
-    for (const [iri, shapeClass] of getAllShapeClasses()) {
-        const targetClass = watchedClassOf(shapeClass, watched);
-        if (!targetClass)
-            continue;
-        const dataset = LinkedStorage.getDatasetForShapeClass(shapeClass);
-        if (!dataset || dataset === defaultDataset)
-            continue;
-        const list = (_a = pinned.get(dataset)) !== null && _a !== void 0 ? _a : [];
-        list.push(`${shapeClass.name || iri} (${targetClass})`);
-        pinned.set(dataset, list);
+    const { datasetLabel } = core;
+    const targets = core.graphSyncTargets();
+    const beyondDefault = (lists) => [...lists].some((list) => list.some((ds) => ds !== defaultDataset));
+    const kinds = [];
+    const perDataset = (byPackage) => {
+        const all = [...byPackage.keys()];
+        return targets.datasets
+            .map((ds) => {
+            const names = all.filter((name) => { var _a; return (_a = byPackage.get(name)) === null || _a === void 0 ? void 0 : _a.includes(ds); }).sort();
+            if (!names.length)
+                return undefined;
+            return `${datasetLabel(ds)} (${names.length === all.length ? 'every package' : names.join(', ')})`;
+        })
+            .filter((part) => !!part)
+            .join(', ');
+    };
+    let routed = false;
+    if (syncs.shapeSync) {
+        routed || (routed = beyondDefault(targets.shapes.values()) || beyondDefault([targets.appShapes]));
+        kinds.push(`shape graphs → ${perDataset(targets.shapes)}`);
+        kinds.push(`app shape graph → ${targets.appShapes.map(datasetLabel).join(', ')}`);
+    }
+    if (syncs.ontologySync) {
+        routed || (routed = beyondDefault(targets.ontologies.values()));
+        kinds.push(`ontology graphs → ${perDataset(targets.ontologies)}`);
     }
-    if (pinned.size === 0)
+    if (!routed)
         return undefined;
-    const parts = [...pinned].map(([dataset, shapes]) => `${shapes.sort().join(', ')} → ${datasetName(dataset)}`);
-    return (`[LinkedServer] Routing pins shapes the boot syncs write to a dataset other than the default ` +
-        `one: ${parts.join('; ')}. The ontology and shape syncs, when they run, write into the default dataset ` +
-        `(${datasetName(defaultDataset)}) only, so reads of these shapes on the pinned dataset do not ` +
-        `see what the syncs wrote.`);
+    return `[LinkedServer] The boot syncs follow the routing: ${kinds.join('; ')}.`;
 }
 //# sourceMappingURL=graphTargets.js.map

package/lib/esm/utils/graphTargets.js.map

@@ -1 +1 @@
-{"version":3,"file":"graphTargets.js","sourceRoot":"","sources":["../../../src/utils/graphTargets.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Where the boot syncs keep the registered packages' ontology data and shapes: core's graph\n * targets (`ontologyGraph`, `shapeGraph`; `@_linked/core/utils/graphTargets`), one global setting\n * of the process. `LINKED_ONTOLOGY_GRAPH` and `LINKED_SHAPE_GRAPH` each take `'package'` (the\n * default, one graph per package), `'default'` (the default graph) or the absolute IRI of one\n * shared graph.\n *\n * The server reads them once at boot, checks them (an invalid value stops the boot, naming the\n * variable) and calls core's `setGraphTargets` before the stores are initialised and before the\n * syncs. No store takes a setting of its own, and the frontend needs none: its\n * `.from(graphs.allOntologies)` reaches the backend as the portable name, and the backend's\n * store expands it under this setting.\n *\n * The syncs write into the default dataset only. {@link syncPinWarning} names the shapes whose\n * routing sends their reads elsewhere.\n */\nimport {\n  GRAPH_TARGET_ENV,\n  graphTargetOptionsFromEnv,\n  setGraphTargets,\n  type GraphTargets,\n} from '@_linked/core/utils/graphTargets';\nimport { LinkedStorage } from '@_linked/core/utils/LinkedStorage';\nimport { getAllShapeClasses } from '@_linked/core/utils/ShapeClass';\nimport type { IDataset } from '@_linked/core/interfaces/IDataset';\n\n/**\n * Read `LINKED_ONTOLOGY_GRAPH` / `LINKED_SHAPE_GRAPH` from `env` (checked: an invalid value throws,\n * naming the variable) and set them as the process's graph targets (core's `setGraphTargets`;\n * unset ones are `'package'`). Returns the settings the env gave.\n */\nexport function applyGraphTargetsFromEnv(env: Record<string, string | undefined>): Partial<GraphTargets> {\n  const fromEnv = graphTargetOptionsFromEnv(env);\n  setGraphTargets(fromEnv);\n  return fromEnv;\n}\n\n/** The env variables as set (unset and empty ones left out), for `GET /admin/routes`. */\nexport function graphTargetEnv(env: Record<string, string | undefined>): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const name of [GRAPH_TARGET_ENV.ontologyGraph, GRAPH_TARGET_ENV.shapeGraph]) {\n    const value = env[name];\n    if (value) out[name] = value;\n  }\n  return out;\n}\n\nconst SH = 'http://www.w3.org/ns/shacl#';\nconst RDF = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#';\nconst RDFS = 'http://www.w3.org/2000/01/rdf-schema#';\nconst OWL = 'http://www.w3.org/2002/07/owl#';\n\n/** The classes of the shape shapes: what the shape sync writes. */\nexport const SHAPE_SHAPE_CLASSES: readonly string[] = [`${SH}NodeShape`, `${SH}PropertyShape`];\n\n/**\n * The classes of the ontology term shapes (the class and property shapes core, `@_linked/rdfs`\n * and `@_linked/owl` register): what the ontology sync writes and the hierarchy reads.\n */\nexport const ONTOLOGY_TERM_CLASSES: readonly string[] = [\n  `${RDFS}Class`,\n  `${OWL}Class`,\n  `${RDF}Property`,\n  `${OWL}ObjectProperty`,\n  `${OWL}DatatypeProperty`,\n  `${OWL}AnnotationProperty`,\n];\n\n/** A dataset as `GET /admin/routes` tells it apart: its store class, and its `id` when it has one. */\nfunction datasetName(dataset: IDataset): string {\n  const id = (dataset as { id?: unknown }).id;\n  const store = dataset?.constructor?.name || 'unknown';\n  return typeof id === 'string' && id ? `${store} \"${id}\"` : store;\n}\n\n/**\n * The watched class `shapeClass` or one of its super-shapes targets (a sub-shape of `owl:Class`,\n * say `owl:Restriction`, goes where its parent is pinned), else undefined.\n */\nfunction watchedClassOf(shapeClass: Function, watched: ReadonlySet<string>): string | undefined {\n  for (let current: unknown = shapeClass; typeof current === 'function' && current !== Function.prototype; current = Object.getPrototypeOf(current)) {\n    const id = (current as { targetClass?: { id?: unknown } }).targetClass?.id;\n    if (typeof id === 'string' && watched.has(id)) return id;\n  }\n  return undefined;\n}\n\n/**\n * One warning when routing pins a shape the boot syncs write (the shape shapes `NodeShape` /\n * `PropertyShape`, or an ontology term shape such as `rdfs:Class` / `owl:ObjectProperty`) to a\n * dataset other than the default one: the syncs write into the default dataset only, so reads of\n * those shapes on the pinned dataset miss what they wrote. Names each such shape (sub-shapes of a\n * watched shape included) and its dataset. Undefined when there is nothing to warn about (or no\n * default dataset). Reads the registered shapes outside any shape catalog (run it at boot, never\n * inside `withShapeCatalog`).\n */\nexport function syncPinWarning(): string | undefined {\n  const defaultDataset = LinkedStorage.getDefaultDataset();\n  if (!defaultDataset) return undefined;\n  const watched = new Set([...SHAPE_SHAPE_CLASSES, ...ONTOLOGY_TERM_CLASSES]);\n  const pinned = new Map<IDataset, string[]>();\n  for (const [iri, shapeClass] of getAllShapeClasses()) {\n    const targetClass = watchedClassOf(shapeClass, watched);\n    if (!targetClass) continue;\n    const dataset = LinkedStorage.getDatasetForShapeClass(shapeClass);\n    if (!dataset || dataset === defaultDataset) continue;\n    const list = pinned.get(dataset) ?? [];\n    list.push(`${shapeClass.name || iri} (${targetClass})`);\n    pinned.set(dataset, list);\n  }\n  if (pinned.size === 0) return undefined;\n  const parts = [...pinned].map(([dataset, shapes]) => `${shapes.sort().join(', ')} → ${datasetName(dataset)}`);\n  return (\n    `[LinkedServer] Routing pins shapes the boot syncs write to a dataset other than the default ` +\n    `one: ${parts.join('; ')}. The ontology and shape syncs, when they run, write into the default dataset ` +\n    `(${datasetName(defaultDataset)}) only, so reads of these shapes on the pinned dataset do not ` +\n    `see what the syncs wrote.`\n  );\n}\n"]}
+{"version":3,"file":"graphTargets.js","sourceRoot":"","sources":["../../../src/utils/graphTargets.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Where the boot syncs keep the registered packages' ontology data and shapes: core's graph\n * targets (`ontologyGraph`, `shapeGraph`; `@_linked/core/utils/graphTargets`), one global setting\n * of the process. `LINKED_ONTOLOGY_GRAPH` and `LINKED_SHAPE_GRAPH` each take `'package'` (the\n * default, one graph per package), `'default'` (the default graph) or the absolute IRI of one\n * shared graph.\n *\n * The server reads them once at boot, checks them (an invalid value stops the boot, naming the\n * variable) and calls core's `setGraphTargets` before the stores are initialised and before the\n * syncs. No store takes a setting of its own, and the frontend needs none: its\n * `.from(graphs.allOntologies)` reaches the backend as the portable name, and the backend's\n * store expands it under this setting.\n *\n * The syncs follow the storage routing (core's `syncTargets`); {@link syncTargetsLine} names the\n * datasets they write into when that is more than the default dataset.\n */\nimport {\n  GRAPH_TARGET_ENV,\n  graphTargetOptionsFromEnv,\n  setGraphTargets,\n  type GraphTargets,\n} from '@_linked/core/utils/graphTargets';\nimport { LinkedStorage } from '@_linked/core/utils/LinkedStorage';\nimport type { GraphSyncTargets } from '@_linked/core/shapes/syncTargets';\nimport type { IDataset } from '@_linked/core/interfaces/IDataset';\n\n/**\n * Read `LINKED_ONTOLOGY_GRAPH` / `LINKED_SHAPE_GRAPH` from `env` (checked: an invalid value throws,\n * naming the variable) and set them as the process's graph targets (core's `setGraphTargets`;\n * unset ones are `'package'`). Returns the settings the env gave.\n */\nexport function applyGraphTargetsFromEnv(env: Record<string, string | undefined>): Partial<GraphTargets> {\n  const fromEnv = graphTargetOptionsFromEnv(env);\n  setGraphTargets(fromEnv);\n  return fromEnv;\n}\n\n/** The variable that says who writes the app's shape and ontology graphs. */\nexport const GRAPH_WRITER_ENV = 'LINKED_GRAPH_WRITER';\n\n/**\n * Who writes the app's shape and ontology graphs: `'app'` (the default) the app itself, at boot;\n * `'host'` a host that runs it (Create Now), which reads the\n * content through `POST /admin/graph-content` and writes it itself, so the app writes none.\n */\nexport type GraphWriter = 'app' | 'host';\n\n/**\n * `LINKED_GRAPH_WRITER` from `env`: unset or empty is `'app'`; any value other than `app` or\n * `host` throws, naming the variable (the boot stops on it).\n */\nexport function graphWriterFromEnv(env: Record<string, string | undefined>): GraphWriter {\n  const value = env[GRAPH_WRITER_ENV]?.trim();\n  if (!value || value === 'app') return 'app';\n  if (value === 'host') return 'host';\n  throw new Error(\n    `${GRAPH_WRITER_ENV} must be 'app' or 'host' (who writes the app's shape and ontology graphs), not ${JSON.stringify(value)}`,\n  );\n}\n\n/**\n * Whether this process writes its shape and ontology graphs: the one check every write path of the\n * syncs goes through (the boot's ontology and shape syncs). False\n * under `LINKED_GRAPH_WRITER=host`.\n */\nexport function appWritesGraphs(env: Record<string, string | undefined> = process.env): boolean {\n  return graphWriterFromEnv(env) === 'app';\n}\n\n/** The env variables as set (unset and empty ones left out), for `GET /admin/routes`. */\nexport function graphTargetEnv(env: Record<string, string | undefined>): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const name of [GRAPH_TARGET_ENV.ontologyGraph, GRAPH_TARGET_ENV.shapeGraph]) {\n    const value = env[name];\n    if (value) out[name] = value;\n  }\n  return out;\n}\n\n/** Which boot syncs run: only the graphs a running sync writes are named. */\nexport interface BootSyncs {\n  /** The shape sync runs (`shapeSyncOn`): it writes the shape graphs and the app's shape graph. */\n  shapeSync: boolean;\n  /** The ontology sync runs (the same switch as the shape sync): it writes the ontology graphs. */\n  ontologySync: boolean;\n}\n\n/**\n * One log line naming the datasets the boot syncs that run write into, per graph kind, when the\n * routing sends any graph beyond the default dataset (core's `graphSyncTargets`: a package's\n * shape graph goes wherever its shapes or the shape shapes route, its ontology graph also\n * wherever shapes using its classes or the term shapes route, the app's graph wherever shapes\n * declaring `contains`, or their sub-shapes, route). Undefined when every graph goes to the default dataset only (the\n * syncs' own lines say enough), when no sync runs or without a default dataset. `core` is\n * `@_linked/core/shapes/syncTargets` (server only, imported when the boot runs). Reads the\n * registered shapes outside any shape catalog (run it at boot, never inside `withShapeCatalog`).\n */\nexport function syncTargetsLine(\n  syncs: BootSyncs,\n  core: {\n    graphSyncTargets: () => GraphSyncTargets;\n    datasetLabel: (dataset: IDataset) => string;\n  },\n): string | undefined {\n  const defaultDataset = LinkedStorage.getDefaultDataset();\n  if (!defaultDataset || (!syncs.shapeSync && !syncs.ontologySync)) return undefined;\n  const { datasetLabel } = core;\n  const targets = core.graphSyncTargets();\n  const beyondDefault = (lists: Iterable<IDataset[]>) =>\n    [...lists].some((list) => list.some((ds) => ds !== defaultDataset));\n  const kinds: string[] = [];\n  const perDataset = (byPackage: Map<string, IDataset[]>): string => {\n    const all = [...byPackage.keys()];\n    return targets.datasets\n      .map((ds) => {\n        const names = all.filter((name) => byPackage.get(name)?.includes(ds)).sort();\n        if (!names.length) return undefined;\n        return `${datasetLabel(ds)} (${names.length === all.length ? 'every package' : names.join(', ')})`;\n      })\n      .filter((part): part is string => !!part)\n      .join(', ');\n  };\n  let routed = false;\n  if (syncs.shapeSync) {\n    routed ||= beyondDefault(targets.shapes.values()) || beyondDefault([targets.appShapes]);\n    kinds.push(`shape graphs → ${perDataset(targets.shapes)}`);\n    kinds.push(`app shape graph → ${targets.appShapes.map(datasetLabel).join(', ')}`);\n  }\n  if (syncs.ontologySync) {\n    routed ||= beyondDefault(targets.ontologies.values());\n    kinds.push(`ontology graphs → ${perDataset(targets.ontologies)}`);\n  }\n  if (!routed) return undefined;\n  return `[LinkedServer] The boot syncs follow the routing: ${kinds.join('; ')}.`;\n}\n"]}

package/lib/esm/utils/linkedDependencies.d.ts

@@ -20,12 +20,26 @@ export interface LinkedDependency {
         version?: string;
     }[];
 }
+/** What a `package.json` is, by its `linked.kind`. */
+export type LinkedKind = 'app' | 'ontology' | 'assets' | 'library';
+/** Every value `linked.kind` may take. */
+export declare const LINKED_KINDS: readonly LinkedKind[];
 /**
- * A package whose backend providers the server loads at boot: one whose
- * package.json declares `"linkedPackage": true`. That flag is the only test —
+ * THE way to tell what a `package.json` is: its `"linked": {"kind": …}`. `app` is an app (built
+ * by `linked build-app`); `ontology`, `assets` and `library` are linked packages (an ontology
+ * package may carry shapes for its own terms; `library` is framework code). Undefined for
+ * anything else: no `linked` object and a kind that is not one of these.
+ *
+ * Until every published package carries `linked.kind`, a `package.json` without one is still
+ * read by the retired flags: `linkedApp: true` is an `app`, `linkedPackage: true` a `library`.
+ */
+export declare function linkedKind(json: unknown): LinkedKind | undefined;
+/**
+ * A package whose backend providers the server loads at boot: a named package
+ * whose `linked.kind` is not `app` ({@link linkedKind}). That is the only test —
  * not the package's scope. `@_linked/localize` is in the `@_linked` scope and
- * is a CLI tool, not a linked package; a custom-scope package with the flag is
- * a linked package. The CLI's workspace discovery uses the same flag.
+ * is a CLI tool, not a linked package; a custom-scope package with a kind is
+ * a linked package. The CLI's workspace discovery uses the same test.
  *
  * The legacy `"lincd": true` flag is deliberately NOT enough. Those packages
  * import the old `lincd` core, and loading them at boot is what produced
@@ -50,7 +64,34 @@ export declare function readInstalledPackage(name: string, fromDir: string): {
     json: any;
 } | null;
 /**
- * Every linked package reachable from the app's `dependencies`, each one AFTER
+ * The npm names a `package.json` lists in `linked.unpublishedPackages` (K-unpublished): packages
+ * it uses that are not on npm, localized into the app's `packages-local/`. The server treats them
+ * as direct dependencies of whoever lists them. Read with the cli's one reader, so a malformed
+ * list throws rather than shrinking silently.
+ */
+export declare function unpublishedNames(json: unknown): string[];
+/**
+ * A package the app lists in `linked.unpublishedPackages`, found by its npm name: first the
+ * way Node finds it (`node_modules/<name>` from `fromDir` up, which is npm's workspace link into
+ * `packages-local/` once the app is installed), else among `<appDir>/packages-local/<dir>`
+ * by the `name` in each `package.json` (a checkout not yet installed). Null when there is no
+ * checkout of it.
+ */
+export declare function findListedPackage(name: string, fromDir: string, appDir: string): {
+    root: string;
+    json: any;
+} | null;
+/**
+ * Every name in the app's `linked.unpublishedPackages`, and transitively in the lists of the
+ * listed packages it finds ({@link findListedPackage}): the packages the server treats as the
+ * app's own direct dependencies. A listed package without a checkout still counts; only its own
+ * list cannot be read.
+ */
+export declare function listedPackageNames(appDir: string, appPackageJson: any): Set<string>;
+/**
+ * Every linked package reachable from the app's `dependencies` and its
+ * `linked.unpublishedPackages` (transitively, through each package's own
+ * `dependencies` and list), each one AFTER
  * the linked packages it depends on. Providers register middleware in the
  * order they are indexed, so a package's middleware must not run before that
  * of a package it builds on (e.g. anything reading `request.linkedAuth` after
@@ -68,10 +109,15 @@ export declare function readInstalledPackage(name: string, fromDir: string): {
  * is the one the app itself resolves, so it is the same module instance the
  * app's own imports reach; when the app cannot resolve the package at all
  * (it is only installed nested) it is the first copy found.
+ *
+ * `isLinked` decides which installed packages are linked ones (default
+ * {@link isLinkedPackageJson}); a caller reading installs of another
+ * generation passes its own.
  */
-export declare function discoverLinkedDependencies(appDir: string, appPackageJson: any): LinkedDependency[];
+export declare function discoverLinkedDependencies(appDir: string, appPackageJson: any, isLinked?: (json: any) => boolean): LinkedDependency[];
 /**
- * Package name → the names of its direct `dependencies` and `peerDependencies`, for the app
+ * Package name → the names of its direct `dependencies`, `peerDependencies` and
+ * `linked.unpublishedPackages`, for the app
  * (`appPackageJson`) and every package in `packageDirs` (name → package root, as discovery
  * found it). The shape check scopes its direction-I errors with it. A package whose
  * `package.json` cannot be read is left out.

package/lib/esm/utils/linkedDependencies.js

@@ -1,11 +1,48 @@
 import * as fs from 'fs';
 import * as path from 'path';
+import { unpublishedPackages } from '@_linked/cli/installed-packages';
+/** Every value `linked.kind` may take. */
+export const LINKED_KINDS = [
+    'app',
+    'ontology',
+    'assets',
+    'library',
+];
 /**
- * A package whose backend providers the server loads at boot: one whose
- * package.json declares `"linkedPackage": true`. That flag is the only test —
+ * THE way to tell what a `package.json` is: its `"linked": {"kind": …}`. `app` is an app (built
+ * by `linked build-app`); `ontology`, `assets` and `library` are linked packages (an ontology
+ * package may carry shapes for its own terms; `library` is framework code). Undefined for
+ * anything else: no `linked` object and a kind that is not one of these.
+ *
+ * Until every published package carries `linked.kind`, a `package.json` without one is still
+ * read by the retired flags: `linkedApp: true` is an `app`, `linkedPackage: true` a `library`.
+ */
+export function linkedKind(json) {
+    var _a;
+    if (!json || typeof json !== 'object')
+        return undefined;
+    const linked = json.linked;
+    if (!linked || typeof linked !== 'object')
+        return retiredFlagKind(json);
+    const kind = linked.kind;
+    return (_a = LINKED_KINDS.find((k) => k === kind)) !== null && _a !== void 0 ? _a : retiredFlagKind(json);
+}
+/** The kind a `package.json` published before `linked.kind` declares by its retired flags. */
+function retiredFlagKind(json) {
+    const flags = json;
+    if (flags.linkedApp === true)
+        return 'app';
+    if (flags.linkedPackage === true)
+        return 'library';
+    return undefined;
+}
+// end of the linkedKind twin.
+/**
+ * A package whose backend providers the server loads at boot: a named package
+ * whose `linked.kind` is not `app` ({@link linkedKind}). That is the only test —
  * not the package's scope. `@_linked/localize` is in the `@_linked` scope and
- * is a CLI tool, not a linked package; a custom-scope package with the flag is
- * a linked package. The CLI's workspace discovery uses the same flag.
+ * is a CLI tool, not a linked package; a custom-scope package with a kind is
+ * a linked package. The CLI's workspace discovery uses the same test.
  *
  * The legacy `"lincd": true` flag is deliberately NOT enough. Those packages
  * import the old `lincd` core, and loading them at boot is what produced
@@ -15,7 +52,8 @@ import * as path from 'path';
 export function isLinkedPackageJson(json) {
     if (!json || typeof json.name !== 'string')
         return false;
-    return json.linkedPackage === true;
+    const kind = linkedKind(json);
+    return kind !== undefined && kind !== 'app';
 }
 /**
  * Find an installed package the way Node does: `<dir>/node_modules/<name>`,
@@ -66,7 +104,73 @@ export function readInstalledPackage(name, fromDir) {
     }
 }
 /**
- * Every linked package reachable from the app's `dependencies`, each one AFTER
+ * The npm names a `package.json` lists in `linked.unpublishedPackages` (K-unpublished): packages
+ * it uses that are not on npm, localized into the app's `packages-local/`. The server treats them
+ * as direct dependencies of whoever lists them. Read with the cli's one reader, so a malformed
+ * list throws rather than shrinking silently.
+ */
+export function unpublishedNames(json) {
+    return unpublishedPackages(json).map((p) => p.name);
+}
+/** Where a listed package's checkout lives in the app, when npm has not linked it yet. */
+const LOCAL_DIR = 'packages-local';
+/**
+ * A package the app lists in `linked.unpublishedPackages`, found by its npm name: first the
+ * way Node finds it (`node_modules/<name>` from `fromDir` up, which is npm's workspace link into
+ * `packages-local/` once the app is installed), else among `<appDir>/packages-local/<dir>`
+ * by the `name` in each `package.json` (a checkout not yet installed). Null when there is no
+ * checkout of it.
+ */
+export function findListedPackage(name, fromDir, appDir) {
+    const installed = readInstalledPackage(name, fromDir);
+    if (installed)
+        return installed;
+    const localDir = path.join(appDir, LOCAL_DIR);
+    let entries = [];
+    try {
+        entries = fs.readdirSync(localDir).sort();
+    }
+    catch (_a) {
+        return null;
+    }
+    for (const entry of entries) {
+        const root = path.join(localDir, entry);
+        try {
+            const json = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf-8'));
+            if ((json === null || json === void 0 ? void 0 : json.name) === name)
+                return { root, json };
+        }
+        catch (_b) { }
+    }
+    return null;
+}
+/**
+ * Every name in the app's `linked.unpublishedPackages`, and transitively in the lists of the
+ * listed packages it finds ({@link findListedPackage}): the packages the server treats as the
+ * app's own direct dependencies. A listed package without a checkout still counts; only its own
+ * list cannot be read.
+ */
+export function listedPackageNames(appDir, appPackageJson) {
+    const names = new Set();
+    const queue = unpublishedNames(appPackageJson).map((name) => ({ name, fromDir: appDir }));
+    while (queue.length) {
+        const { name, fromDir } = queue.shift();
+        if (names.has(name) || name === (appPackageJson === null || appPackageJson === void 0 ? void 0 : appPackageJson.name))
+            continue;
+        names.add(name);
+        const found = findListedPackage(name, fromDir, appDir);
+        if (!found)
+            continue;
+        const root = realpathOr(found.root);
+        for (const next of unpublishedNames(found.json))
+            queue.push({ name: next, fromDir: root });
+    }
+    return names;
+}
+/**
+ * Every linked package reachable from the app's `dependencies` and its
+ * `linked.unpublishedPackages` (transitively, through each package's own
+ * `dependencies` and list), each one AFTER
  * the linked packages it depends on. Providers register middleware in the
  * order they are indexed, so a package's middleware must not run before that
  * of a package it builds on (e.g. anything reading `request.linkedAuth` after
@@ -84,19 +188,25 @@ export function readInstalledPackage(name, fromDir) {
  * is the one the app itself resolves, so it is the same module instance the
  * app's own imports reach; when the app cannot resolve the package at all
  * (it is only installed nested) it is the first copy found.
+ *
+ * `isLinked` decides which installed packages are linked ones (default
+ * {@link isLinkedPackageJson}); a caller reading installs of another
+ * generation passes its own.
  */
-export function discoverLinkedDependencies(appDir, appPackageJson) {
+export function discoverLinkedDependencies(appDir, appPackageJson, isLinked = isLinkedPackageJson) {
     var _a;
     const out = [];
     const byName = new Map();
     const visitedRoots = new Set();
     const appName = appPackageJson === null || appPackageJson === void 0 ? void 0 : appPackageJson.name;
-    const visit = (name, fromDir) => {
+    const visit = (name, fromDir, listed = false) => {
         var _a;
         if (name === appName)
             return;
-        const installed = readInstalledPackage(name, fromDir);
-        if (!installed || !isLinkedPackageJson(installed.json))
+        const installed = listed
+            ? findListedPackage(name, fromDir, appDir)
+            : readInstalledPackage(name, fromDir);
+        if (!installed || !isLinked(installed.json))
             return;
         const realRoot = realpathOr(installed.root);
         if (visitedRoots.has(realRoot))
@@ -111,6 +221,9 @@ export function discoverLinkedDependencies(appDir, appPackageJson) {
         for (const dep of Object.keys((_a = installed.json.dependencies) !== null && _a !== void 0 ? _a : {})) {
             visit(dep, realRoot);
         }
+        for (const dep of unpublishedNames(installed.json)) {
+            visit(dep, realRoot, true);
+        }
         // Pushed after its dependencies, once per name: the first copy found
         // fixes the package's place in the order.
         if (!out.includes(entry))
@@ -119,11 +232,14 @@ export function discoverLinkedDependencies(appDir, appPackageJson) {
     for (const name of Object.keys((_a = appPackageJson === null || appPackageJson === void 0 ? void 0 : appPackageJson.dependencies) !== null && _a !== void 0 ? _a : {})) {
         visit(name, appDir);
     }
+    for (const name of unpublishedNames(appPackageJson)) {
+        visit(name, appDir, true);
+    }
     for (const entry of out) {
         if (entry.copies.length < 2)
             continue;
         const fromApp = readInstalledPackage(entry.packageName, appDir);
-        if (fromApp && isLinkedPackageJson(fromApp.json)) {
+        if (fromApp && isLinked(fromApp.json)) {
             const appCopy = realpathOr(fromApp.root);
             if (entry.copies.some((c) => c.path === appCopy))
                 entry.path = appCopy;
@@ -132,7 +248,8 @@ export function discoverLinkedDependencies(appDir, appPackageJson) {
     return out;
 }
 /**
- * Package name → the names of its direct `dependencies` and `peerDependencies`, for the app
+ * Package name → the names of its direct `dependencies`, `peerDependencies` and
+ * `linked.unpublishedPackages`, for the app
  * (`appPackageJson`) and every package in `packageDirs` (name → package root, as discovery
  * found it). The shape check scopes its direction-I errors with it. A package whose
  * `package.json` cannot be read is left out.
@@ -147,6 +264,7 @@ export function readDependencyLists(packageDirs, appPackageJson) {
             ...new Set([
                 ...Object.keys((_a = json === null || json === void 0 ? void 0 : json.dependencies) !== null && _a !== void 0 ? _a : {}),
                 ...Object.keys((_b = json === null || json === void 0 ? void 0 : json.peerDependencies) !== null && _b !== void 0 ? _b : {}),
+                ...unpublishedNames(json),
             ]),
         ].sort();
     };