lynkow 1.31.12 → 1.31.13

package/dist/index.d.mts

@@ -2250,9 +2250,12 @@ interface JsonLdNode {
     /**
      * Stable `@id` for this node. Server-generated (pattern `own-<8hex>`) when
      * the caller omits it on create. Safe to treat as an opaque string; the
-     * public API rewrites it to an absolute URL (`<pageUrl>#<id>`) in the
-     * resolved graph. Never starts with the reserved `auto:` prefix, which is
-     * reserved for nodes Lynkow injects automatically.
+     * public API rewrites it to an absolute URL in the resolved graph,
+     * with the prefix determined by the node's effective {@link scope}
+     * (`<site-url>#<id>` for site-scoped entries like `Organization`,
+     * `<page-url>#<id>` for page-scoped entries like `Article`).
+     * Never starts with the reserved `auto:` prefix, which is reserved
+     * for nodes Lynkow injects automatically.
      */
     id: string;
     /**
@@ -2276,6 +2279,19 @@ interface JsonLdNode {
     data: Record<string, unknown>;
     /** Whether the node was created from a Lynkow typed preset or from raw JSON-LD. */
     source: JsonLdNodeSource;
+    /**
+     * Optional `@id` scope override. When omitted, the cascade infers
+     * the default from the level the entry was declared at:
+     * - `site` for entries at site or category level (Organization,
+     *   LocalBusiness for a section, Publisher).
+     * - `page` for entries at page or content level (Article, Product,
+     *   custom Person).
+     * Set explicitly to opt out of the default - e.g. `scope: 'site'`
+     * on a content-level Organization that should still be stable
+     * across pages. The resolved `@id` becomes `<site-url>#<id>` for
+     * `site` scope and `<page-url>#<id>` for `page` scope.
+     */
+    scope?: 'site' | 'page';
 }
 /**
  * Cascade configuration stored at any level (site, category, page, content).

package/dist/index.d.ts

@@ -2250,9 +2250,12 @@ interface JsonLdNode {
     /**
      * Stable `@id` for this node. Server-generated (pattern `own-<8hex>`) when
      * the caller omits it on create. Safe to treat as an opaque string; the
-     * public API rewrites it to an absolute URL (`<pageUrl>#<id>`) in the
-     * resolved graph. Never starts with the reserved `auto:` prefix, which is
-     * reserved for nodes Lynkow injects automatically.
+     * public API rewrites it to an absolute URL in the resolved graph,
+     * with the prefix determined by the node's effective {@link scope}
+     * (`<site-url>#<id>` for site-scoped entries like `Organization`,
+     * `<page-url>#<id>` for page-scoped entries like `Article`).
+     * Never starts with the reserved `auto:` prefix, which is reserved
+     * for nodes Lynkow injects automatically.
      */
     id: string;
     /**
@@ -2276,6 +2279,19 @@ interface JsonLdNode {
     data: Record<string, unknown>;
     /** Whether the node was created from a Lynkow typed preset or from raw JSON-LD. */
     source: JsonLdNodeSource;
+    /**
+     * Optional `@id` scope override. When omitted, the cascade infers
+     * the default from the level the entry was declared at:
+     * - `site` for entries at site or category level (Organization,
+     *   LocalBusiness for a section, Publisher).
+     * - `page` for entries at page or content level (Article, Product,
+     *   custom Person).
+     * Set explicitly to opt out of the default - e.g. `scope: 'site'`
+     * on a content-level Organization that should still be stable
+     * across pages. The resolved `@id` becomes `<site-url>#<id>` for
+     * `site` scope and `<page-url>#<id>` for `page` scope.
+     */
+    scope?: 'site' | 'page';
 }
 /**
  * Cascade configuration stored at any level (site, category, page, content).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lynkow",
-  "version": "1.31.12",
+  "version": "1.31.13",
   "description": "Official SDK for Lynkow Headless",
   "author": "Lynkow",
   "license": "SEE LICENSE IN LICENSE",