@attlaz/client 1.117.0 → 1.119.0

package/dist/Client.d.ts

@@ -1,6 +1,7 @@
 import { OAuthClientToken } from './Http/OAuthClientToken.js';
 import { ITransport, ParseErrorHandler } from './Http/Transport/ITransport.js';
 import { OAuthClient, TokenChangeHandler } from './Http/Transport/OAuthClient.js';
+import { ApiInformation } from './Model/ApiInformation.js';
 import { AccessTokenEndpoint } from './Service/AccessTokenEndpoint.js';
 import { AdapterConnectionEndpoint } from './Service/AdapterConnectionEndpoint.js';
 import { ConnectionBundleEndpoint } from './Service/ConnectionBundleEndpoint.js';
@@ -111,9 +112,7 @@ export declare class Client {
      * rejected. Pass null to stop observing. OAuth-only; a custom transport has no token.
      */
     setTokenChangeHandler(handler: TokenChangeHandler | null): void;
-    getApiInformation(): Promise<{
-        version: string;
-    }>;
+    getApiInformation(): Promise<ApiInformation>;
     getAdapterEndpoint(): AdapterEndpoint;
     getAdapterConnectionEndpoint(): AdapterConnectionEndpoint;
     getConnectionBundleEndpoint(): ConnectionBundleEndpoint;

package/dist/Client.js

@@ -213,10 +213,12 @@ export class Client {
     }
     async getApiInformation() {
         const result = await this.httpClient.request('/system/info', null, 'GET', true);
-        if (result.version === undefined) {
+        // The gateway is the first entry, and the only one a non-administrator is shown.
+        const gateway = result.apis?.[0];
+        if (gateway === undefined || gateway.version === null) {
             throw new Error('Unable to get API information: invalid response');
         }
-        return { version: result.version };
+        return { version: gateway.version, apis: result.apis ?? [] };
     }
     /* Endpoints */
     getAdapterEndpoint() {

package/dist/Model/ApiInformation.d.ts

@@ -0,0 +1,29 @@
+/** One API behind the endpoint, as `GET /system/info` reports it. */
+export type ApiInfo = {
+    name: string;
+    /** Null for the gateway; null for every API unless the caller is an administrator. */
+    endpoint: string | null;
+    routes: {
+        id: string;
+        prefix: string;
+        apiVersion: string;
+    }[];
+    online: boolean;
+    version: string | null;
+    libraries: {
+        name: string;
+        version: string;
+    }[];
+    error: string | null;
+};
+/**
+ * What the endpoint is running.
+ *
+ * `apis` lists the gateway first, then every API it routes to — but only an administrator is shown
+ * more than the gateway, so a normal caller gets a single entry.
+ */
+export type ApiInformation = {
+    /** The gateway's version — what `version` meant before `apis` existed. */
+    version: string;
+    apis: ApiInfo[];
+};

package/dist/Model/ApiInformation.js

@@ -0,0 +1 @@
+export {};

package/dist/Model/Mcp/McpAccess.d.ts

@@ -14,6 +14,13 @@ export declare class McpAccess implements StateAware {
     state: State;
     revokedAt: Date | null;
     createdAt: Date;
+    /**
+     * When a client last called this access's URL, or null if it never has.
+     *
+     * ⚠️ Nothing writes this yet — the column and the plumbing exist so the recording can be added
+     * in one place later. Until then it is always null, which reads as "Never".
+     */
+    lastUsedAt: Date | null;
     /**
      * The full URL to hand to a client, or null when the access has no live key — the state an
      * interrupted rotation leaves behind, which the UI has to be able to show rather than assume away.

package/dist/Model/Mcp/McpAccess.js

@@ -13,6 +13,13 @@ export class McpAccess {
     state = State.Active;
     revokedAt = null;
     createdAt;
+    /**
+     * When a client last called this access's URL, or null if it never has.
+     *
+     * ⚠️ Nothing writes this yet — the column and the plumbing exist so the recording can be added
+     * in one place later. Until then it is always null, which reads as "Never".
+     */
+    lastUsedAt = null;
     /**
      * The full URL to hand to a client, or null when the access has no live key — the state an
      * interrupted rotation leaves behind, which the UI has to be able to show rather than assume away.
@@ -45,6 +52,7 @@ export class McpAccess {
         access.revokedAt = (raw.revoked_at === null || raw.revoked_at === undefined) ? null : Utils.parseRawDate(raw.revoked_at);
         access.createdAt = Utils.parseRawDate(raw.created_at);
         access.url = (raw.url === null || raw.url === undefined) ? null : raw.url;
+        access.lastUsedAt = (raw.last_used_at === null || raw.last_used_at === undefined) ? null : Utils.parseRawDate(raw.last_used_at);
         return access;
     }
 }

package/dist/Model/Pagination/CursorPagination.d.ts

@@ -1,5 +1,16 @@
 export declare class CursorPagination {
+    /** Guards against a limit no server would honour; mirrors the bound Core validates against. */
+    private static readonly MAX_LIMIT;
     limit: number | null;
     startingAfter: string | null;
     endingBefore: string | null;
+    /**
+     * `limit` stays optional, and null keeps meaning "let the server decide" — that is a real
+     * intent, and what every existing caller wants. What the constructor adds is validation and a
+     * way to state a limit in one expression instead of constructing and then assigning.
+     *
+     * Core's equivalent defaults to 10 because a repository always needs a number. This one must
+     * not: defaulting here would silently start sending `limit=10` on every call that omits it.
+     */
+    constructor(limit?: number | null);
 }

package/dist/Model/Pagination/CursorPagination.js

@@ -1,5 +1,29 @@
 export class CursorPagination {
+    /** Guards against a limit no server would honour; mirrors the bound Core validates against. */
+    static MAX_LIMIT = 1000000;
     limit = null;
     startingAfter = null;
     endingBefore = null;
+    /**
+     * `limit` stays optional, and null keeps meaning "let the server decide" — that is a real
+     * intent, and what every existing caller wants. What the constructor adds is validation and a
+     * way to state a limit in one expression instead of constructing and then assigning.
+     *
+     * Core's equivalent defaults to 10 because a repository always needs a number. This one must
+     * not: defaulting here would silently start sending `limit=10` on every call that omits it.
+     */
+    constructor(limit = null) {
+        if (limit !== null) {
+            if (!Number.isInteger(limit)) {
+                throw new Error('Limit should be a whole number');
+            }
+            if (limit < 1) {
+                throw new Error('Limit should be at least 1');
+            }
+            if (limit > CursorPagination.MAX_LIMIT) {
+                throw new Error('Limit should not exceed ' + CursorPagination.MAX_LIMIT);
+            }
+        }
+        this.limit = limit;
+    }
 }

package/dist/Service/McpAccessEndpoint.d.ts

@@ -12,6 +12,8 @@ export declare class McpAccessEndpoint extends Endpoint {
     getAccessById(accessId: string): Promise<McpAccess | null>;
     /** Creates the access and its first URL together — an access with no URL cannot be reached. */
     createAccess(name: string, target: string): Promise<McpAccess>;
+    /** Renames only. The target is write-once and the URL is changed by rotating, not here. */
+    renameAccess(accessId: string, name: string): Promise<McpAccess>;
     /** New URL, old one dead, and every token bound to the old one revoked. */
     rotateKey(accessId: string): Promise<McpAccess>;
     /** Reversible, and keeps its tokens, so resuming needs no re-authentication. */

package/dist/Service/McpAccessEndpoint.js

@@ -52,6 +52,24 @@ export class McpAccessEndpoint extends Endpoint {
             throw error;
         }
     }
+    /** Renames only. The target is write-once and the URL is changed by rotating, not here. */
+    async renameAccess(accessId, name) {
+        try {
+            const url = path('/mcp-accesses/:accessId', { accessId });
+            const result = await this.requestObject(url, { name }, McpAccess.parse, 'PATCH');
+            const access = result.getData();
+            if (access === null) {
+                throw new Error('MCP access not found: ' + accessId);
+            }
+            return access;
+        }
+        catch (error) {
+            if (this.httpClient.isDebugEnabled()) {
+                console.error('Failed to rename the MCP access: ', error);
+            }
+            throw error;
+        }
+    }
     /** New URL, old one dead, and every token bound to the old one revoked. */
     async rotateKey(accessId) {
         return await this.lifecycle(accessId, path('/mcp-accesses/:accessId/rotate-key', { accessId }), 'POST', 'rotate the MCP URL');

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export type { TokenChangeHandler } from './Http/Transport/OAuthClient.js';
 export { OAuthClientOptions } from './Http/OAuthClientOptions.js';
 export { OAuthClientToken } from './Http/OAuthClientToken.js';
 export { ClientError } from './Http/ClientError.js';
+export { ApiInfo, ApiInformation } from './Model/ApiInformation.js';
 export { ApiError } from './Model/Error/ApiError.js';
 export type { ParseErrorHandler } from './Http/Transport/ITransport.js';
 export { HttpStatus } from './Http/HttpStatus.js';

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.116.0";
+export declare const VERSION = "1.118.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "1.116.0";
+export const VERSION = "1.118.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attlaz/client",
-  "version": "1.117.0",
+  "version": "1.119.0",
   "description": "Javascript Client to access Attlaz API",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",