@twinfinity/twin 6.0.2 → 6.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twinfinity/twin",
-  "version": "6.0.2",
+  "version": "6.1.0",
   "description": "Twinfinity Twin Service client",
   "source": "src/index.ts",
   "main": "dist/index.js",
@@ -39,8 +39,8 @@
     "docs"
   ],
   "peerDependencies": {
-    "@twinfinity/authentication": "6.0.2",
-    "@twinfinity/t8-client-model": "6.0.2-beta"
+    "@twinfinity/authentication": "6.1.0",
+    "@twinfinity/t8-client-model": "6.1.0-beta"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^3.2.3",

package/src/TwinClient.ts

@@ -94,6 +94,13 @@ import { Twin } from './types/Twin';
 import { TwinGeometryInfo } from './types/TwinGeometryInfo';
 
 export interface ITwinClient {
+    /**
+     * Rooted twins base URL — typically `<host>/sites/<container>/_ps/twins`.
+     * Use this when constructing related URLs (e.g. twin content) that need
+     * to live in the same auth scope as the metadata calls.
+     */
+    readonly baseUrl: string;
+
     /**
      * @param relatedTo - Filter twins by container ID.
      * @throws {TwinValidationError} On invalid query parameters (400).
@@ -646,6 +653,17 @@ export class TwinClient implements ITwinClient {
         this._assetTypeCatalogUrl = `${base}/_ps/asset-type-catalog`;
     }
 
+    /**
+     * Rooted twins base URL — typically `<host>/sites/<container>/_ps/twins`.
+     * Exposed so callers that want to build content URLs in the same auth
+     * scope as the metadata calls can derive them from here. The bare
+     * `<host>/_ps/twins/...` variant is not necessarily an authorized route
+     * on all deployments.
+     */
+    get baseUrl(): string {
+        return this._baseUrl;
+    }
+
     async listTwins(
         relatedTo?: string,
         page: string | undefined = undefined,