@attlaz/client 1.98.0 → 1.99.0

package/dist/Client.d.ts

@@ -21,6 +21,7 @@ import { HealthAlertEndpoint } from './Service/HealthAlertEndpoint.js';
 import { InboxEndpoint } from './Service/InboxEndpoint.js';
 import { LogEndpoint } from './Logging/Service/LogEndpoint.js';
 import { PlatformEndpoint } from './Service/PlatformEndpoint.js';
+import { TimezoneEndpoint } from './Service/TimezoneEndpoint.js';
 import { PlatformLanguageEndpoint } from './Service/PlatformLanguageEndpoint.js';
 import { ProjectEndpoint } from './Service/ProjectEndpoint.js';
 import { ProjectEnvironmentEndpoint } from './Service/ProjectEnvironmentEndpoint.js';
@@ -102,6 +103,7 @@ export declare class Client {
     getConfigEndpoint(): ConfigEndpoint;
     getInboxEndpoint(): InboxEndpoint;
     getPlatformEndpoint(): PlatformEndpoint;
+    getTimezoneEndpoint(): TimezoneEndpoint;
     getSubscriberEndpoint(): SubscriberEndpoint;
     getLogEndPoint(): LogEndpoint;
     getFlowEndpoint(): FlowEndpoint;

package/dist/Client.js

@@ -21,6 +21,7 @@ import { HealthAlertEndpoint } from './Service/HealthAlertEndpoint.js';
 import { InboxEndpoint } from './Service/InboxEndpoint.js';
 import { LogEndpoint } from './Logging/Service/LogEndpoint.js';
 import { PlatformEndpoint } from './Service/PlatformEndpoint.js';
+import { TimezoneEndpoint } from './Service/TimezoneEndpoint.js';
 import { PlatformLanguageEndpoint } from './Service/PlatformLanguageEndpoint.js';
 import { ProjectEndpoint } from './Service/ProjectEndpoint.js';
 import { ProjectEnvironmentEndpoint } from './Service/ProjectEnvironmentEndpoint.js';
@@ -77,6 +78,7 @@ export class Client {
         InboxEndpoint,
         LogEndpoint,
         PlatformEndpoint,
+        TimezoneEndpoint,
         PlatformLanguageEndpoint,
         ProjectEndpoint,
         ProjectEnvironmentEndpoint,
@@ -217,6 +219,9 @@ export class Client {
     getPlatformEndpoint() {
         return this.getEndpoint('platform', this.Store.PlatformEndpoint);
     }
+    getTimezoneEndpoint() {
+        return this.getEndpoint('timezone', this.Store.TimezoneEndpoint);
+    }
     getSubscriberEndpoint() {
         return this.getEndpoint('subscriber', this.Store.SubscriberEndpoint);
     }

package/dist/Model/Component/Component.d.ts

@@ -1,5 +1,6 @@
 import { State } from '../State.js';
 import { ComponentKind } from './ComponentKind.js';
+import { ComponentVersion } from './ComponentVersion.js';
 /** One thing the platform builds and deploys: an api, a service, or the runner. */
 export declare class Component {
     id: string;
@@ -12,6 +13,12 @@ export declare class Component {
      * component is not managed this way, never "deploy nothing".
      */
     activeVersionId: string | null;
+    /**
+     * The active version itself, present only when requested with `?expand=active_version`.
+     * Null both when nothing is promoted and when the caller did not ask for it — check
+     * `activeVersionId` to tell those apart.
+     */
+    activeVersion: ComponentVersion | null;
     createdAt: Date;
     updatedAt: Date;
     state: State;

package/dist/Model/Component/Component.js

@@ -10,6 +10,12 @@ export class Component {
      * component is not managed this way, never "deploy nothing".
      */
     activeVersionId;
+    /**
+     * The active version itself, present only when requested with `?expand=active_version`.
+     * Null both when nothing is promoted and when the caller did not ask for it — check
+     * `activeVersionId` to tell those apart.
+     */
+    activeVersion = null;
     createdAt;
     updatedAt;
     state;

package/dist/Model/Timezone.d.ts

@@ -0,0 +1,18 @@
+import { ApiRecord } from './ApiRecord.js';
+/**
+ * A timezone the platform accepts, as reported by the API.
+ *
+ * The list comes from the server rather than from the browser's own `Intl`: the two run different
+ * tz database versions, so a browser-built list can offer a zone the API then rejects, or spell one
+ * differently from the name the API stores.
+ */
+export declare class Timezone {
+    name: string;
+    /**
+     * Offset from UTC in minutes at the moment the API answered — positive east of Greenwich, and
+     * not a whole number of hours everywhere (Asia/Katmandu is 345). It follows daylight saving, so
+     * it is a value to display, never one to store or to compare zones by.
+     */
+    utcOffsetMinutes: number;
+    static parse(raw: ApiRecord): Timezone;
+}

package/dist/Model/Timezone.js

@@ -0,0 +1,22 @@
+/**
+ * A timezone the platform accepts, as reported by the API.
+ *
+ * The list comes from the server rather than from the browser's own `Intl`: the two run different
+ * tz database versions, so a browser-built list can offer a zone the API then rejects, or spell one
+ * differently from the name the API stores.
+ */
+export class Timezone {
+    name;
+    /**
+     * Offset from UTC in minutes at the moment the API answered — positive east of Greenwich, and
+     * not a whole number of hours everywhere (Asia/Katmandu is 345). It follows daylight saving, so
+     * it is a value to display, never one to store or to compare zones by.
+     */
+    utcOffsetMinutes;
+    static parse(raw) {
+        const timezone = new Timezone();
+        timezone.name = raw.name;
+        timezone.utcOffsetMinutes = raw.utc_offset_minutes;
+        return timezone;
+    }
+}

package/dist/Service/ComponentEndpoint.d.ts

@@ -1,4 +1,5 @@
 import { Component } from '../Model/Component/Component.js';
+import { ComponentKind } from '../Model/Component/ComponentKind.js';
 import { ComponentStatus } from '../Model/Component/ComponentStatus.js';
 import { ComponentVersion } from '../Model/Component/ComponentVersion.js';
 import { CursorPagination } from '../Model/Pagination/CursorPagination.js';
@@ -11,7 +12,13 @@ import { Endpoint } from './Endpoint.js';
  * Root-only, reads included.
  */
 export declare class ComponentEndpoint extends Endpoint {
-    getAll(pagination?: CursorPagination | null): Promise<CollectionResult<Component>>;
+    /**
+     * @param expand pass `['active_version']` to receive the promoted version inline instead of
+     *               just its id — one call rather than one per component.
+     * @param kinds  restrict to these kinds; a collection, so apis and services can be fetched
+     *               together without the runner.
+     */
+    getAll(pagination?: CursorPagination | null, expand?: string[] | null, kinds?: ComponentKind[] | null): Promise<CollectionResult<Component>>;
     getVersions(componentId: string, pagination?: CursorPagination | null): Promise<CollectionResult<ComponentVersion>>;
     /** Observed state for every component at once — one call, not one per component. */
     getStatus(pagination?: CursorPagination | null): Promise<CollectionResult<ComponentStatus>>;

package/dist/Service/ComponentEndpoint.js

@@ -14,9 +14,21 @@ import { Endpoint } from './Endpoint.js';
  * Root-only, reads included.
  */
 export class ComponentEndpoint extends Endpoint {
-    async getAll(pagination = null) {
+    /**
+     * @param expand pass `['active_version']` to receive the promoted version inline instead of
+     *               just its id — one call rather than one per component.
+     * @param kinds  restrict to these kinds; a collection, so apis and services can be fetched
+     *               together without the runner.
+     */
+    async getAll(pagination = null, expand = null, kinds = null) {
         const queryString = new QueryString('/system/components');
         queryString.addPagination(pagination);
+        if (kinds !== null && kinds.length > 0) {
+            queryString.set('kind', kinds);
+        }
+        if (expand !== null && expand.length > 0) {
+            queryString.set('expand', expand);
+        }
         return await this.requestCollection(queryString, ComponentEndpoint.parseComponent, null, 'GET');
     }
     async getVersions(componentId, pagination = null) {
@@ -36,7 +48,9 @@ export class ComponentEndpoint extends Endpoint {
      */
     async setActiveVersion(componentId, versionId) {
         const queryString = new QueryString(path('/system/components/:componentId/active-version', { componentId }));
-        await this.requestObject(queryString, { version_id: versionId }, (raw) => raw, 'POST');
+        // `_formatted` because formatParameters() strips a trailing `_id` from body keys, which
+        // would turn `version_id` into `version` — a key the endpoint does not read.
+        await this.requestObject(queryString, { version_id: versionId, _formatted: true }, (raw) => raw, 'POST');
     }
     static parseComponent(raw) {
         const component = new Component();
@@ -44,7 +58,16 @@ export class ComponentEndpoint extends Endpoint {
         component.name = raw.name;
         component.kind = ComponentKind.fromString(raw.kind);
         component.imageRepository = raw.image_repository;
-        component.activeVersionId = raw.active_version ?? null;
+        // `active_version` is either the id or, when expanded, the version itself.
+        const activeVersion = raw.active_version ?? null;
+        if (activeVersion !== null && typeof activeVersion === 'object') {
+            component.activeVersion = ComponentEndpoint.parseVersion(activeVersion);
+            component.activeVersionId = component.activeVersion.id;
+        }
+        else {
+            component.activeVersionId = activeVersion;
+            component.activeVersion = null;
+        }
         component.createdAt = Utils.parseRawDate(raw.created_at);
         component.updatedAt = Utils.parseRawDate(raw.updated_at);
         component.state = State.fromString(raw.state);

package/dist/Service/TimezoneEndpoint.d.ts

@@ -0,0 +1,13 @@
+import { CollectionResult } from '../Model/Result/CollectionResult.js';
+import { Timezone } from '../Model/Timezone.js';
+import { Endpoint } from './Endpoint.js';
+export declare class TimezoneEndpoint extends Endpoint {
+    /**
+     * Every timezone a schedule or a user profile can be set to.
+     *
+     * Deliberately not paginated: this is a fixed reference list of a few hundred entries owned by
+     * the platform's runtime, not a growing collection, and a picker needs all of it to filter
+     * against.
+     */
+    getAll(): Promise<CollectionResult<Timezone>>;
+}

package/dist/Service/TimezoneEndpoint.js

@@ -0,0 +1,15 @@
+import { QueryString } from '../Http/Data/QueryString.js';
+import { Timezone } from '../Model/Timezone.js';
+import { Endpoint } from './Endpoint.js';
+export class TimezoneEndpoint extends Endpoint {
+    /**
+     * Every timezone a schedule or a user profile can be set to.
+     *
+     * Deliberately not paginated: this is a fixed reference list of a few hundred entries owned by
+     * the platform's runtime, not a growing collection, and a picker needs all of it to filter
+     * against.
+     */
+    async getAll() {
+        return await this.requestCollection(new QueryString('/timezones'), Timezone.parse);
+    }
+}

package/dist/index.d.ts

@@ -161,6 +161,7 @@ export { SearchResult } from './Model/Search/SearchResult.js';
 export { Trigger } from './Model/Trigger/Trigger.js';
 /** Worker* */
 export { Platform } from './Model/Worker/Platform.js';
+export { Timezone } from './Model/Timezone.js';
 export { PlatformImage } from './Model/Worker/PlatformImage.js';
 export { InfrastructureConfiguration } from './Model/Worker/InfrastructureConfiguration.js';
 /** Deployment * */
@@ -227,6 +228,7 @@ export { LogEndpoint } from './Logging/Service/LogEndpoint.js';
 export { WorkspaceMemberEndpoint } from './Service/WorkspaceMemberEndpoint.js';
 export { InboxEndpoint } from './Service/InboxEndpoint.js';
 export { PlatformEndpoint } from './Service/PlatformEndpoint.js';
+export { TimezoneEndpoint } from './Service/TimezoneEndpoint.js';
 export { CodeDeployEndpoint } from './Service/CodeDeployEndpoint.js';
 export { ProjectEnvironmentEndpoint } from './Service/ProjectEnvironmentEndpoint.js';
 export { SearchEndpoint } from './Service/SearchEndpoint.js';

package/dist/index.js

@@ -127,6 +127,7 @@ export { SearchResult } from './Model/Search/SearchResult.js';
 export { Trigger } from './Model/Trigger/Trigger.js';
 /** Worker* */
 export { Platform } from './Model/Worker/Platform.js';
+export { Timezone } from './Model/Timezone.js';
 export { PlatformImage } from './Model/Worker/PlatformImage.js';
 export { InfrastructureConfiguration } from './Model/Worker/InfrastructureConfiguration.js';
 /** Deployment * */
@@ -190,6 +191,7 @@ export { LogEndpoint } from './Logging/Service/LogEndpoint.js';
 export { WorkspaceMemberEndpoint } from './Service/WorkspaceMemberEndpoint.js';
 export { InboxEndpoint } from './Service/InboxEndpoint.js';
 export { PlatformEndpoint } from './Service/PlatformEndpoint.js';
+export { TimezoneEndpoint } from './Service/TimezoneEndpoint.js';
 export { CodeDeployEndpoint } from './Service/CodeDeployEndpoint.js';
 export { ProjectEnvironmentEndpoint } from './Service/ProjectEnvironmentEndpoint.js';
 export { SearchEndpoint } from './Service/SearchEndpoint.js';

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.97.0";
+export declare const VERSION = "1.98.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "1.97.0";
+export const VERSION = "1.98.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attlaz/client",
-  "version": "1.98.0",
+  "version": "1.99.0",
   "description": "Javascript Client to access Attlaz API",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -37,14 +37,15 @@
   "license": "MIT",
   "scripts": {
     "prebuild": "npm run setversion",
-    "prepare": "npm run clean && tsc --project tsconfig.production.json && npm run setversion",
-    "build": "npm run clean && tsc",
+    "prepare": "npm run clean && tsc --project tsconfig.build.json && npm run setversion",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
     "setversion": "node -p \"'export const VERSION = ' + JSON.stringify(require('./package.json').version) + ';'\" > src/version.ts",
     "clean": "rimraf dist",
     "scan": "docker run -v .:/path zricethezav/gitleaks:latest detect --source=\"/path\" ",
-    "test": "jest",
-    "test:unit": "jest --config jest.config.unit.js",
-    "typecheck": "tsc --project tsconfig.json --noEmit"
+    "test": "vitest run --mode unit",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "test-integration": "vitest run --mode integration",
+    "test-live": "vitest --mode unit"
   },
   "publishConfig": {
     "access": "public",
@@ -52,7 +53,6 @@
     "registry": "https://registry.npmjs.org"
   },
   "devDependencies": {
-    "@types/jest": "^30.0.0",
     "@types/node": "^26.1.2",
     "@typescript-eslint/eslint-plugin": "^8.59.3",
     "@typescript-eslint/parser": "^8.59.3",
@@ -63,10 +63,9 @@
     "eslint-plugin-jsdoc": "^62.9.0",
     "eslint-plugin-prefer-arrow": "^1.2.3",
     "eslint-plugin-promise": "^7.3.0",
-    "jest": "^30.4.2",
     "rimraf": "^6.1.3",
-    "ts-jest": "^29.4.12",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
   },
   "directories": {
     "test": "test"