@attlaz/client 1.112.0 → 1.114.0

package/dist/Model/Search/SearchResult.d.ts

@@ -1,24 +1,23 @@
-import { Adapter } from '../Adapter/Adapter.js';
-import { AdapterConnection } from '../Adapter/AdapterConnection.js';
 import { ApiRecord } from '../ApiRecord.js';
-import { CodeSource } from '../Deployment/CodeSource.js';
-import { CodeSourceAccount } from '../Deployment/CodeSourceAccount.js';
-import { EntityType } from '../EntityType.js';
-import { Flow } from '../../Flow/Model/Flow.js';
-import { FlowRun } from '../../Flow/Model/FlowRun.js';
-import { Channel } from '../Messaging/Channel/Channel.js';
-import { Subscriber } from '../Messaging/Subscriber.js';
-import { CodeDeploy } from '../Project/CodeDeploy.js';
-import { Project } from '../Project/Project.js';
-import { ProjectEnvironment } from '../Project/ProjectEnvironment.js';
-import { Trigger } from '../Trigger/Trigger.js';
-import { Workspace } from '../Workspace/Workspace.js';
-import { WorkspaceMember } from '../Workspace/WorkspaceMember.js';
+/**
+ * One row of a search response.
+ *
+ * The search index is a display projection: `label` and `description` are stored in the index and
+ * are everything the result list renders. Navigation is resolved on click from `entityId` and
+ * `type`, so no entity is loaded for the results the user never clicks.
+ *
+ * `type` is deliberately a plain string rather than {@link EntityType}: an entity type this client
+ * does not know about must still be shown. Parsing it into the enum here used to throw, and a
+ * throw in a parser makes the row disappear from the collection with no error the user can see —
+ * every multi-word type was silently missing from search for over a year that way. Map it to
+ * `EntityType` where navigation is decided, and let an unrecognised type render as a result that
+ * cannot be opened.
+ */
 export declare class SearchResult {
-    type: EntityType;
+    type: string;
+    entityId: string;
     label: string;
     description: string;
-    entity: Workspace | WorkspaceMember | Project | ProjectEnvironment | Flow | FlowRun | Trigger | Channel | Subscriber | Adapter | AdapterConnection | CodeSourceAccount | CodeSource | CodeDeploy;
     score: number;
     static parse(rawResult: ApiRecord): SearchResult;
 }

package/dist/Model/Search/SearchResult.js

@@ -1,94 +1,30 @@
-import { Adapter } from '../Adapter/Adapter.js';
-import { AdapterConnection } from '../Adapter/AdapterConnection.js';
-import { CodeSource } from '../Deployment/CodeSource.js';
-import { CodeSourceAccount } from '../Deployment/CodeSourceAccount.js';
-import { EntityType } from '../EntityType.js';
-import { Flow } from '../../Flow/Model/Flow.js';
-import { FlowRun } from '../../Flow/Model/FlowRun.js';
-import { Channel } from '../Messaging/Channel/Channel.js';
-import { Subscriber } from '../Messaging/Subscriber.js';
-import { CodeDeploy } from '../Project/CodeDeploy.js';
-import { Project } from '../Project/Project.js';
-import { ProjectEnvironment } from '../Project/ProjectEnvironment.js';
-import { Trigger } from '../Trigger/Trigger.js';
-import { Workspace } from '../Workspace/Workspace.js';
-import { WorkspaceMember } from '../Workspace/WorkspaceMember.js';
+/**
+ * One row of a search response.
+ *
+ * The search index is a display projection: `label` and `description` are stored in the index and
+ * are everything the result list renders. Navigation is resolved on click from `entityId` and
+ * `type`, so no entity is loaded for the results the user never clicks.
+ *
+ * `type` is deliberately a plain string rather than {@link EntityType}: an entity type this client
+ * does not know about must still be shown. Parsing it into the enum here used to throw, and a
+ * throw in a parser makes the row disappear from the collection with no error the user can see —
+ * every multi-word type was silently missing from search for over a year that way. Map it to
+ * `EntityType` where navigation is decided, and let an unrecognised type render as a result that
+ * cannot be opened.
+ */
 export class SearchResult {
     type;
+    entityId;
     label;
     description;
-    entity;
     score;
     static parse(rawResult) {
         const searchResult = new SearchResult();
-        searchResult.type = EntityType.fromString(rawResult.entity_type);
-        // searchResult.entity = rawResult.entity;
+        searchResult.type = rawResult.entity_type;
+        searchResult.entityId = rawResult.entity;
         searchResult.label = rawResult.label;
         searchResult.description = rawResult.description;
         searchResult.score = rawResult.score;
-        const rawEntity = rawResult.entity;
-        switch (searchResult.type) {
-            case EntityType.Organisation:
-                // TODO: implement
-                searchResult.entity = rawEntity;
-                break;
-            case EntityType.Workspace:
-                searchResult.entity = Workspace.parse(rawEntity);
-                break;
-            case EntityType.Project:
-                searchResult.entity = Project.parse(rawEntity);
-                break;
-            case EntityType.ProjectEnvironment:
-                searchResult.entity = ProjectEnvironment.parse(rawEntity);
-                break;
-            case EntityType.Flow:
-                searchResult.entity = Flow.parse(rawEntity);
-                break;
-            case EntityType.FlowRun:
-                searchResult.entity = FlowRun.parse(rawEntity);
-                break;
-            case EntityType.WorkspaceMember:
-                searchResult.entity = WorkspaceMember.parse(rawEntity);
-                break;
-            case EntityType.Adapter:
-                searchResult.entity = Adapter.parse(rawEntity);
-                break;
-            case EntityType.AdapterConnection:
-                searchResult.entity = AdapterConnection.parse(rawEntity);
-                break;
-            case EntityType.Channel:
-                searchResult.entity = Channel.parse(rawEntity);
-                break;
-            case EntityType.ChannelSubscriber:
-                searchResult.entity = Subscriber.parseRaw(rawEntity);
-                break;
-            case EntityType.Trigger:
-                searchResult.entity = Trigger.parse(rawEntity);
-                break;
-            case EntityType.CodeSourceAccount:
-                searchResult.entity = CodeSourceAccount.parse(rawEntity);
-                break;
-            case EntityType.CodeSource:
-                searchResult.entity = CodeSource.parse(rawEntity);
-                break;
-            case EntityType.CodeSourceDeploy:
-                searchResult.entity = CodeDeploy.parse(rawEntity);
-                break;
-            case EntityType.StorageBucket:
-                // TODO: implement
-                searchResult.entity = rawEntity;
-                break;
-            case EntityType.LogStream:
-                // TODO: implement
-                searchResult.entity = rawEntity;
-                break;
-            case EntityType.RunnerPool:
-                // TODO: implement
-                searchResult.entity = rawEntity;
-                break;
-            default:
-                throw new Error('Unknown search result type "' + searchResult.type + '"');
-        }
         return searchResult;
     }
 }

package/dist/Service/StorageEndpoint.d.ts

@@ -20,6 +20,11 @@ export declare class StorageEndpoint extends Endpoint {
      * JSON envelope would either inflate it (base64) or destroy it (a UTF-8 decode replaces every
      * invalid sequence, so bytes do not survive the round trip).
      */
+    /**
+     * Whether an item exists, without transferring it. Backed by HEAD, so a content-addressed check
+     * ("do I already have these bytes?") costs headers rather than the whole object.
+     */
+    hasItem(projectEnvironmentId: string, storageType: StorageType, bucketKey: string, storageItemKey: string): Promise<boolean>;
     getItemBytes(projectEnvironmentId: string, storageType: StorageType, bucketKey: string, storageItemKey: string): Promise<Buffer>;
     /**
      * Store raw bytes. Metadata travels as headers, since the body is the value.

package/dist/Service/StorageEndpoint.js

@@ -3,6 +3,8 @@ import { StorageInformation } from '../Model/Storage/StorageInformation.js';
 import { StorageItem } from '../Model/Storage/StorageItem.js';
 import { StorageItemInformation } from '../Model/Storage/StorageItemInformation.js';
 import { QueryString } from '../Http/Data/QueryString.js';
+import { ClientError } from '../Http/ClientError.js';
+import { HttpStatus } from '../Http/HttpStatus.js';
 import { Endpoint } from './Endpoint.js';
 export class StorageEndpoint extends Endpoint {
     async getInformation(projectEnvironmentId, storageType) {
@@ -98,6 +100,23 @@ export class StorageEndpoint extends Endpoint {
      * JSON envelope would either inflate it (base64) or destroy it (a UTF-8 decode replaces every
      * invalid sequence, so bytes do not survive the round trip).
      */
+    /**
+     * Whether an item exists, without transferring it. Backed by HEAD, so a content-addressed check
+     * ("do I already have these bytes?") costs headers rather than the whole object.
+     */
+    async hasItem(projectEnvironmentId, storageType, bucketKey, storageItemKey) {
+        const cmd = path('/projectenvironments/:projectEnvironmentId/storage/:storageType/:bucketKey/items/:key', { projectEnvironmentId, storageType, bucketKey, key: storageItemKey });
+        try {
+            await this.requestBytes(cmd, null, 'HEAD');
+            return true;
+        }
+        catch (error) {
+            if (ClientError.statusOf(error) === HttpStatus.HTTP_NOTFOUND) {
+                return false;
+            }
+            throw error;
+        }
+    }
     async getItemBytes(projectEnvironmentId, storageType, bucketKey, storageItemKey) {
         const cmd = path('/projectenvironments/:projectEnvironmentId/storage/:storageType/:bucketKey/items/:key', { projectEnvironmentId, storageType, bucketKey, key: storageItemKey });
         return await this.requestBytes(cmd);

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.111.0";
+export declare const VERSION = "1.113.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "1.111.0";
+export const VERSION = "1.113.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attlaz/client",
-  "version": "1.112.0",
+  "version": "1.114.0",
   "description": "Javascript Client to access Attlaz API",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -53,7 +53,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "devDependencies": {
-    "@types/node": "^26.2.0",
+    "@types/node": "^26.4.0",
     "@typescript-eslint/eslint-plugin": "^8.59.3",
     "@typescript-eslint/parser": "^8.59.3",
     "eslint": "^9.39.5",
@@ -65,7 +65,7 @@
     "eslint-plugin-promise": "^7.3.0",
     "rimraf": "^6.1.3",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   },
   "directories": {
     "test": "test"