@_linked/server 2.0.3 → 2.1.0

package/.github/workflows/publish.yml

@@ -15,8 +15,20 @@ jobs:
       contents: write
       pull-requests: write
     steps:
+      # Author the changesets "Version Packages" PR as the org release App (not the default
+      # GITHUB_TOKEN) so its CI runs without a manual "Approve and run" gate. Requires the org
+      # App installed on this repo + org secrets RELEASE_APP_ID / RELEASE_APP_PRIVATE_KEY.
+      - name: Generate GitHub App token
+        id: app-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ secrets.RELEASE_APP_ID }}
+          private-key: ${{ secrets.RELEASE_APP_PRIVATE_KEY }}
+
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          token: ${{ steps.app-token.outputs.token }}
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
@@ -37,6 +49,6 @@ jobs:
           title: 'chore: release'
           commit: 'chore: release'
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @\_linked/server
 
+## 2.1.0
+
+### Minor Changes
+
+- [#13](https://github.com/linked-cm/server/pull/13) [`8932811`](https://github.com/linked-cm/server/commit/89328117fa9500897a5a57b86e07efe5860d81cd) Thanks [@flyon](https://github.com/flyon)! - **ESM-only.** Dropped the CommonJS build; the package now ships ES modules only (`type: module`, no `require` export condition, no `lib/cjs`). All first-party consumers are ESM; CJS projects on Node 22+ can still `require()` it (sync ESM) or use dynamic `import()`. Also fixed the root `types` field (was a non-existent `./index.d.ts`).
+
+### Patch Changes
+
+- [#13](https://github.com/linked-cm/server/pull/13) [`daef98d`](https://github.com/linked-cm/server/commit/daef98d777144285c2f63ed43821902371df2c66) Thanks [@flyon](https://github.com/flyon)! - `BackendAPIStore` now speaks DSL-JSON over the wire, adapting to the `@_linked/core` query-contract flip (datasets receive the live/closed query, not IR).
+
+  - The frontend store serializes each query with `query.toJSON()` before `Server.call` (the live query can't cross the wire), replacing the removed `getQueryObject()` path.
+  - `BackendAPIStoreProvider` rehydrates it with `fromJSON(json)` back into a live query before routing through `LinkedStorage` — the backend store lowers it to SPARQL itself.
+
+  No API change for callers; the round-trip is `lower(fromJSON(query.toJSON())) ≡ lower(query)`.
+
+- [#13](https://github.com/linked-cm/server/pull/13) [`28d0f49`](https://github.com/linked-cm/server/commit/28d0f497b332a663af9d40162d017a2a35cbfb31) Thanks [@flyon](https://github.com/flyon)! - Dropped `lincd-sioc: ~1.0` from `package.json` dependencies. Audit
+  confirmed no source file in `packages/server/src` imports from sioc;
+  the dep was vestigial.
+
+  No API change. Consumers that depended on `@_linked/server` transitively
+  pulling sioc into their lockfile will need to add `@_linked/sioc` (the
+  new name; see its own release notes) as a direct dep if they actually
+  use it.
+
+  Context: see create-now plan-011 report (docs/reports/009-legacy-lincd-eradication.md).
+
 ## 2.0.3
 
 ### Patch Changes

package/lib/esm/index.d.ts

@@ -1,6 +1,6 @@
 import './types.js';
 import './ontologies/lincd-server.js';
-import './shapes/LincdServer.js';
+import './shapes/LinkedServer.js';
 import './shapes/LincdAPI.js';
 import './shapes/quadstores/BackendAPIStore.js';
 import './shapes/filestores/LocalFileStore.js';

package/lib/esm/index.js

@@ -1,7 +1,7 @@
 import './types.js';
 import './ontologies/lincd-server.js';
 //SHAPES FIRST
-import './shapes/LincdServer.js';
+import './shapes/LinkedServer.js';
 import './shapes/LincdAPI.js';
 import './shapes/quadstores/BackendAPIStore.js';
 import './shapes/filestores/LocalFileStore.js';

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,CAAC;AACpB,OAAO,8BAA8B,CAAC;AAEtC,cAAc;AACd,OAAO,yBAAyB,CAAC;AACjC,OAAO,sBAAsB,CAAC;AAC9B,OAAO,wCAAwC,CAAC;AAChD,OAAO,uCAAuC,CAAC;AAC/C,OAAO,yBAAyB,CAAC;AAEjC,iBAAiB;AACjB,OAAO,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,CAAC;AACpB,OAAO,8BAA8B,CAAC;AAEtC,cAAc;AACd,OAAO,0BAA0B,CAAC;AAClC,OAAO,sBAAsB,CAAC;AAC9B,OAAO,wCAAwC,CAAC;AAChD,OAAO,uCAAuC,CAAC;AAC/C,OAAO,yBAAyB,CAAC;AAEjC,iBAAiB;AACjB,OAAO,sBAAsB,CAAC"}

package/lib/esm/ontologies/lincd-server.d.ts

@@ -2,30 +2,47 @@
  * Load the data of this ontology.
  * In @_linked/core, loadData returns the raw JSON import — no JSONLD.parse() needed.
  */
-export declare var loadData: () => Promise<any>;
-export declare var ns: (term: string) => import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var _self: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var LincdServer: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var BackendFileStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var NodeFileStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var BackendStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var BackendAPIStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var LincdWebApp: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var ownPackage: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var maintainsPackage: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var N3FileStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var LincdAPI: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var hasAPI: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
+export declare var loadData: () => Promise<{
+    "@context": {
+        dc: string;
+        owl: string;
+        rdf: string;
+        rdfs: string;
+        "lincd-server": string;
+    };
+    "@graph": {
+        "@id": string;
+        "@type": string;
+        "rdfs:comment": string;
+        "rdfs:isDefinedBy": {
+            "@id": string;
+        };
+        "rdfs:label": string;
+    }[];
+}>;
+export declare var ns: (term: string) => import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var _self: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var LincdServer: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var BackendFileStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var NodeFileStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var BackendStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var BackendAPIStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var LincdWebApp: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var ownPackage: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var maintainsPackage: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var N3FileStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var LincdAPI: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var hasAPI: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
 export declare const lincdServer: {
-    LincdServer: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    BackendFileStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    NodeFileStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    BackendStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    N3FileStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    BackendAPIStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    LincdWebApp: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    ownPackage: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    maintainsPackage: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    LincdAPI: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    hasAPI: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
+    LincdServer: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    BackendFileStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    NodeFileStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    BackendStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    N3FileStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    BackendAPIStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    LincdWebApp: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    ownPackage: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    maintainsPackage: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    LincdAPI: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    hasAPI: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
 };

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

@@ -13,7 +13,7 @@ export type ShapeSummary = {
     numInstances: number;
 };
 export declare class LincdAPI extends Shape {
-    static targetClass: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
+    static targetClass: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
     process(request: any, response: any, httpMethod: 'get' | 'post' | 'put' | 'delete'): Promise<void>;
     get_shape_details({ shapes, }: {
         shapes: string[];
@@ -33,9 +33,9 @@ export declare class LincdAPI extends Shape {
     }): Promise<unknown>;
     post_delete({ query }: {
         query: any;
-    }): Promise<import("@_linked/core/queries/DeleteQuery.js").DeleteResponse>;
+    }): Promise<import("@_linked/core/queries/DeleteQuery").DeleteResponse>;
     post_select_raw({ query }: {
         query: any;
-    }): Promise<void | import("@_linked/core/sparql/resultMapping.js").SparqlJsonResults>;
+    }): Promise<void | import("@_linked/core/sparql/resultMapping").SparqlJsonResults>;
     private checkRawQuerySupport;
 }

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

@@ -1,7 +1,7 @@
 import { Shape } from '@_linked/core/shapes/Shape';
 import { Lincd_API_Client } from '@_linked/server-utils/shapes/Lincd_API_Client';
 export declare class LincdWebApp extends Shape {
-    static targetClass: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
+    static targetClass: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
     static get localApp(): LincdWebApp;
     get api(): Lincd_API_Client;
 }

package/lib/esm/shapes/{LincdServer.d.ts → LinkedServer.d.ts}

@@ -2,11 +2,11 @@ import { Express as ExpressServer } from 'express';
 import { Server as HttpServer } from 'http';
 import type { LinkedConfig } from '@_linked/cli/interfaces';
 import { Shape } from '@_linked/core/shapes/Shape';
-export declare class LincdServer extends Shape {
+export declare class LinkedServer extends Shape {
     /**
      * indicates that instances of this shape need to have this rdf.type
      */
-    static targetClass: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
+    static targetClass: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
     private config;
     private cachedPaths;
     private assets;
@@ -31,6 +31,21 @@ export declare class LincdServer extends Shape {
     get app(): ExpressServer;
     initPackage(): void;
     initOnly(): Promise<this>;
+    /**
+     * Materialize this server's registered shapes into the RDF store as SHACL
+     * (core `syncShapes` → pure `sh:NodeShape` + property shapes), so a running
+     * app's app-data holds the shapes its instances validate/query against
+     * (plan-010 T1e.2). This is the canonical, uniform reuse+create mechanism:
+     * whatever shapes the app package registers (published re-exports + generated)
+     * get materialized on boot (and re-run on shape-file HMR).
+     *
+     * Gated to servers whose DEFAULT dataset is a **concrete** materializable store
+     * (detected via `rawQuery`) — i.e. an app pointing at its app-data FusekiStore.
+     * CN's default is the context-routing `AppDataRouter` (no `rawQuery`; a bare
+     * `syncShapes` orphan-read would throw with no active project), so CN is skipped
+     * here — it materializes its own pinned native shapes in its storage config.
+     */
+    private materializeShapesIntoStore;
     start(): Promise<this>;
     initOntologies(): Promise<void>;
     /**
@@ -58,6 +73,19 @@ export declare class LincdServer extends Shape {
         backendProviderExports: any;
         shapeProviders: any[];
     }>;
+    /**
+     * Plan-011 phase 2 — HMR re-index entry point.
+     *
+     * Called by the CLI orchestrator's Vite watcher whenever a `.ts`/`.tsx`
+     * file inside a workspace package changes. Disposes the package's
+     * existing providers (so routes, listeners, timers don't accumulate),
+     * drops them from the registry, and re-runs indexPackageBackendProviders
+     * to pick up the freshly-imported module.
+     *
+     * Dispose calls have a 5 s soft timeout. A hanging dispose logs a
+     * warning and is abandoned so HMR doesn't stall the whole dev loop.
+     */
+    onSourceChange(pkg: string): Promise<void>;
     processBackendMethodCall(request: any, response: any): Promise<void>;
     noCache(response: any): void;
     processAPICall(request: any, response: any, method: 'get' | 'post' | 'put' | 'delete'): Promise<void>;