@attlaz/client 1.98.0 → 1.100.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/Model/User/PasswordCheck.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Why a password was rejected. `null` means it was accepted.
+ *
+ * Mirrors the server's `PasswordCheckResult` — duplicated here rather than imported, per the client's
+ * standing rule that it does not depend on Core.
+ */
+export type PasswordCheckCode = 'password_missing' | 'password_not_long_enough' | 'password_too_long' | 'password_repeat_match' | 'password_general_match' | 'password_too_weak';
+export declare class PasswordCheck {
+    /** Null when the password is acceptable. */
+    code: PasswordCheckCode | null;
+    /** Human-readable reason, ready to display. Null when the password is acceptable. */
+    error: string | null;
+    /**
+     * zxcvbn score, 0 (weakest) to 4 (strongest). Null when the password was rejected before it was
+     * scored — an empty or out-of-bounds password never reaches the estimator.
+     *
+     * Treat it as a display hint, not a policy: the server owns the threshold, and a low score with
+     * `code === null` still means accepted.
+     */
+    strength: number | null;
+    isAcceptable(): boolean;
+}

package/dist/Model/User/PasswordCheck.js

@@ -0,0 +1,17 @@
+export class PasswordCheck {
+    /** Null when the password is acceptable. */
+    code = null;
+    /** Human-readable reason, ready to display. Null when the password is acceptable. */
+    error = null;
+    /**
+     * zxcvbn score, 0 (weakest) to 4 (strongest). Null when the password was rejected before it was
+     * scored — an empty or out-of-bounds password never reaches the estimator.
+     *
+     * Treat it as a display hint, not a policy: the server owns the threshold, and a low score with
+     * `code === null` still means accepted.
+     */
+    strength = null;
+    isAcceptable() {
+        return this.code === null;
+    }
+}

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/Service/UserEndpoint.d.ts

@@ -1,6 +1,7 @@
 import { UserAuthProvider } from '../Model/User/UserAuthProvider.js';
 import { User } from '../Model/User/User.js';
 import { UserSummary } from '../Model/User/UserSummary.js';
+import { PasswordCheck } from '../Model/User/PasswordCheck.js';
 import { CollectionResult } from '../Model/Result/CollectionResult.js';
 import { Endpoint } from './Endpoint.js';
 import { UserNotificationSession } from '../Model/User/UserNotificationSession.js';
@@ -23,6 +24,18 @@ export declare class UserEndpoint extends Endpoint {
     update(user: User): Promise<User>;
     create(user: User, password: string, invitationCode?: string | null): Promise<User>;
     requestResetPassword(email: string): Promise<boolean>;
+    /**
+     * Ask the server whether a password is acceptable, without setting it.
+     *
+     * Unauthenticated — signup calls this before an account, and therefore a token, exists. Pass the
+     * email when it is known so the server can price the password against the user's own details;
+     * `stijn2026` for `stijn@echron.com` scores far lower with it than without.
+     *
+     * Advisory only. The same rules run again when the password is actually set, so a caller must not
+     * treat acceptance here as a guarantee.
+     */
+    checkPassword(password: string, email?: string | null): Promise<PasswordCheck>;
+    private static parsePasswordCheck;
     resetPassword(code: string, password: string): Promise<boolean>;
     createWebPush(session: UserNotificationSession): Promise<boolean>;
     getSessions(pagination: CursorPagination): Promise<CollectionResult<UserNotificationSession>>;

package/dist/Service/UserEndpoint.js

@@ -2,6 +2,7 @@ import { path } from '../Http/Data/Path.js';
 import { UserAuthProvider } from '../Model/User/UserAuthProvider.js';
 import { User } from '../Model/User/User.js';
 import { UserSummary } from '../Model/User/UserSummary.js';
+import { PasswordCheck } from '../Model/User/PasswordCheck.js';
 import { Endpoint } from './Endpoint.js';
 import { UserNotificationSession } from '../Model/User/UserNotificationSession.js';
 import { QueryString } from '../Http/Data/QueryString.js';
@@ -115,6 +116,42 @@ export class UserEndpoint extends Endpoint {
             throw e;
         }
     }
+    /**
+     * Ask the server whether a password is acceptable, without setting it.
+     *
+     * Unauthenticated — signup calls this before an account, and therefore a token, exists. Pass the
+     * email when it is known so the server can price the password against the user's own details;
+     * `stijn2026` for `stijn@echron.com` scores far lower with it than without.
+     *
+     * Advisory only. The same rules run again when the password is actually set, so a caller must not
+     * treat acceptance here as a guarantee.
+     */
+    async checkPassword(password, email = null) {
+        try {
+            const url = '/users/check-password';
+            const parameters = email === null ? { password } : { password, email };
+            const result = await this.requestObject(url, parameters, UserEndpoint.parsePasswordCheck, 'POST', false);
+            const check = result.getData();
+            if (check === null) {
+                throw new Error('Unable to check password: wrong response from API');
+            }
+            return check;
+        }
+        catch (e) {
+            if (this.httpClient.isDebugEnabled()) {
+                // Never log the password itself.
+                console.error('Failed to check password: ', e);
+            }
+            throw e;
+        }
+    }
+    static parsePasswordCheck(raw) {
+        const check = new PasswordCheck();
+        check.code = (raw.code ?? null);
+        check.error = (raw.error ?? null);
+        check.strength = (raw.strength ?? null);
+        return check;
+    }
     async resetPassword(code, password) {
         try {
             const url = path('/users/resetpassword/:code', { code });

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 * */
@@ -208,6 +209,8 @@ export { UserAction } from './Model/User/UserAction.js';
 export type { UserActionFilter } from './Model/User/UserActionFilter.js';
 export { UserSummary } from './Model/User/UserSummary.js';
 export type { UserSummaryType } from './Model/User/UserSummary.js';
+export { PasswordCheck } from './Model/User/PasswordCheck.js';
+export type { PasswordCheckCode } from './Model/User/PasswordCheck.js';
 export { RunnerImage } from './Model/Runner/RunnerImage.js';
 export { Component } from './Model/Component/Component.js';
 export { ComponentKind } from './Model/Component/ComponentKind.js';
@@ -227,6 +230,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 * */
@@ -171,6 +172,7 @@ export { User } from './Model/User/User.js';
 export { UserAuthProvider } from './Model/User/UserAuthProvider.js';
 export { UserAction } from './Model/User/UserAction.js';
 export { UserSummary } from './Model/User/UserSummary.js';
+export { PasswordCheck } from './Model/User/PasswordCheck.js';
 export { RunnerImage } from './Model/Runner/RunnerImage.js';
 export { Component } from './Model/Component/Component.js';
 export { ComponentKind } from './Model/Component/ComponentKind.js';
@@ -190,6 +192,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.99.0";

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attlaz/client",
-  "version": "1.98.0",
+  "version": "1.100.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,8 +53,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "devDependencies": {
-    "@types/jest": "^30.0.0",
-    "@types/node": "^26.1.2",
+    "@types/node": "^26.2.0",
     "@typescript-eslint/eslint-plugin": "^8.59.3",
     "@typescript-eslint/parser": "^8.59.3",
     "eslint": "^9.39.5",
@@ -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"