@privateaim/core-kit 0.8.38 → 0.8.41

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## [0.8.41](https://github.com/PrivateAIM/hub/compare/v0.8.40...v0.8.41) (2026-05-10)
+
+
+### Features
+
+* typed controller signatures, validators in kit packages, swagger via @trapi/cli ([#1590](https://github.com/PrivateAIM/hub/issues/1590)) ([74a35c8](https://github.com/PrivateAIM/hub/commit/74a35c8bed92036a00b581868589c40a192278aa))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * devDependencies
+    * @privateaim/kit bumped from ^0.8.40 to ^0.8.41
+    * @privateaim/telemetry-kit bumped from ^0.8.40 to ^0.8.41
+  * peerDependencies
+    * @privateaim/kit bumped from ^0.8.40 to ^0.8.41
+    * @privateaim/telemetry-kit bumped from ^0.8.40 to ^0.8.41
+
+## [0.8.40](https://github.com/PrivateAIM/hub/compare/v0.8.39...v0.8.40) (2026-04-29)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * devDependencies
+    * @privateaim/kit bumped from ^0.8.39 to ^0.8.40
+    * @privateaim/telemetry-kit bumped from ^0.8.39 to ^0.8.40
+  * peerDependencies
+    * @privateaim/kit bumped from ^0.8.39 to ^0.8.40
+    * @privateaim/telemetry-kit bumped from ^0.8.39 to ^0.8.40
+
+## [0.8.39](https://github.com/PrivateAIM/hub/compare/v0.8.38...v0.8.39) (2026-04-29)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * devDependencies
+    * @privateaim/kit bumped from ^0.8.38 to ^0.8.39
+    * @privateaim/telemetry-kit bumped from ^0.8.38 to ^0.8.39
+  * peerDependencies
+    * @privateaim/kit bumped from ^0.8.38 to ^0.8.39
+    * @privateaim/telemetry-kit bumped from ^0.8.38 to ^0.8.39
+
 ## [0.8.38](https://github.com/PrivateAIM/hub/compare/v0.8.37...v0.8.38) (2026-04-23)
 
 

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@privateaim/core-kit",
     "type": "module",
-    "version": "0.8.38",
+    "version": "0.8.41",
     "license": "Apache-2.0",
     "description": "",
     "module": "./dist/index.mjs",
@@ -23,15 +23,21 @@
         "build-watch": "rimraf ./dist && tsc -p tsconfig.build.json --watch",
         "test": "cross-env NODE_ENV=test vitest run --config test/vitest.config.ts"
     },
+    "dependencies": {
+        "@ebec/http": "^2.3.0",
+        "@validup/adapter-zod": "^0.2.3",
+        "validup": "^0.2.1",
+        "zod": "^4.3.6"
+    },
     "devDependencies": {
         "@authup/core-kit": "^1.0.0-beta.36",
-        "@privateaim/kit": "^0.8.38",
-        "@privateaim/telemetry-kit": "^0.8.38"
+        "@privateaim/kit": "^0.8.41",
+        "@privateaim/telemetry-kit": "^0.8.41"
     },
     "peerDependencies": {
         "@authup/core-kit": "^1.0.0-beta.36",
-        "@privateaim/kit": "^0.8.38",
-        "@privateaim/telemetry-kit": "^0.8.38"
+        "@privateaim/kit": "^0.8.41",
+        "@privateaim/telemetry-kit": "^0.8.41"
     },
     "gitHead": "5d3b6f4ce1edf2383bdfbf66e913a08c8a3a2e40",
     "publishConfig": {

package/src/domains/analysis/index.ts

@@ -9,3 +9,5 @@ export * from './entity';
 export * from './error';
 export * from './helpers';
 export * from './constants';
+export * from './validator';
+export * from './validator-image-command-argument';

package/src/domains/analysis/validator-image-command-argument.ts

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2025.
+ *  Author Peter Placzek (tada5hi)
+ *  For the full copyright and license information,
+ *  view the LICENSE file that was distributed with this source code.
+ */
+
+import { Container } from 'validup';
+import { createValidator } from '@validup/adapter-zod';
+import { z } from 'zod';
+import type { MasterImageCommandArgument } from '../master-image/types.ts';
+
+export class ImageAttributeCommandArgumentsValidator extends Container<MasterImageCommandArgument> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'value',
+            createValidator(
+                z.string()
+                    .min(2)
+                    .max(512),
+            ),
+        );
+
+        this.mount(
+            'position',
+            { optional: true },
+            createValidator(
+                z.literal('before')
+                    .or(z.literal('after'))
+                    .or(z.null())
+                    .or(z.undefined())
+                    .optional(),
+            ),
+        );
+    }
+}

package/src/domains/analysis/validator.ts

@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import { BadRequestError } from '@ebec/http';
+import { Container } from 'validup';
+import { createValidator } from '@validup/adapter-zod';
+import { z } from 'zod';
+import type { Analysis } from './entity.ts';
+import { ValidatorGroup } from '@privateaim/kit';
+import { ImageAttributeCommandArgumentsValidator } from './validator-image-command-argument.ts';
+
+export class AnalysisValidator extends Container<Analysis> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'project_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        this.mount(
+            'name',
+            { optional: true },
+            createValidator(z.string().min(3).max(128).nullable()),
+        );
+
+        this.mount(
+            'description',
+            { optional: true },
+            createValidator(z.string().min(5).max(4096).nullable()),
+        );
+
+        this.mount(
+            'master_image_id',
+            { optional: true },
+            createValidator(z.uuid().nullable()),
+        );
+
+        this.mount(
+            'registry_id',
+            { optional: true },
+            createValidator(z.uuid().nullable()),
+        );
+
+        const commandArgumentValidator = new ImageAttributeCommandArgumentsValidator();
+        // image_command_executable
+        this.mount('image_command_arguments', { optional: true }, (ctx) => {
+            if (ctx.value == null) {
+                return ctx.value;
+            }
+
+            if (!Array.isArray(ctx.value)) {
+                throw new BadRequestError('image_command_arguments must be an array.');
+            }
+
+            const promises = ctx.value.map((child) => commandArgumentValidator.run(child, {
+                group: ctx.group,
+                flat: false,
+                path: ctx.path,
+            }));
+
+            return Promise.all(promises);
+        });
+    }
+}

package/src/domains/analysis-bucket/index.ts

@@ -8,3 +8,4 @@
 export * from './constants';
 export * from './entity';
 export * from './utils';
+export * from './validator';

package/src/domains/analysis-bucket/validator.ts

@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import type { AnalysisBucket } from './entity.ts';
+import { AnalysisBucketType } from './constants.ts';
+import { Container } from 'validup';
+import { createValidator } from '@validup/adapter-zod';
+import { z } from 'zod';
+import { ValidatorGroup } from '@privateaim/kit';
+
+export class AnalysisBucketValidator extends Container<AnalysisBucket> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'analysis_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        this.mount(
+            'bucket_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        this.mount(
+            'type',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.enum(AnalysisBucketType)),
+        );
+    }
+}

package/src/domains/analysis-bucket-file/index.ts

@@ -6,3 +6,4 @@
  */
 
 export * from './entity';
+export * from './validator';

package/src/domains/analysis-bucket-file/validator.ts

@@ -0,0 +1,54 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import { Container } from 'validup';
+import type { AnalysisBucketFile } from './entity.ts';
+import { createValidator } from '@validup/adapter-zod';
+import { z } from 'zod';
+import { ValidatorGroup } from '@privateaim/kit';
+
+export class AnalysisBucketFileValidator extends Container<AnalysisBucketFile> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'analysis_bucket_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        const pathValidator = createValidator(z.string());
+        this.mount(
+            'path',
+            { group: ValidatorGroup.CREATE },
+            pathValidator,
+        );
+
+        this.mount(
+            'path',
+            { group: ValidatorGroup.UPDATE, optional: true },
+            pathValidator,
+        );
+
+        this.mount(
+            'bucket_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        this.mount(
+            'bucket_file_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        this.mount(
+            'root',
+            createValidator(z.boolean().optional().default(false)),
+        );
+    }
+}

package/src/domains/analysis-node/index.ts

@@ -7,3 +7,4 @@
 
 export * from './entity';
 export * from './constants';
+export * from './validator';

package/src/domains/analysis-node/validator.ts

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import type { AnalysisNode } from './entity.ts';
+import { AnalysisNodeApprovalStatus } from './constants.ts';
+import { Container } from 'validup';
+import { createValidator } from '@validup/adapter-zod';
+import { z } from 'zod';
+import { ProcessStatus, ValidatorGroup } from '@privateaim/kit';
+
+export class AnalysisNodeValidator extends Container<AnalysisNode> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'node_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        this.mount(
+            'analysis_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        this.mount(
+            'execution_status',
+            { optional: true },
+            createValidator(z.enum(ProcessStatus).nullable()),
+        );
+
+        this.mount(
+            'execution_progress',
+            { optional: true },
+            createValidator(z.number().int().min(0).max(100).nullable()),
+        );
+
+        this.mount(
+            'approval_status',
+            { optional: true },
+            createValidator(z.enum(AnalysisNodeApprovalStatus).nullable()),
+        );
+
+        this.mount(
+            'comment',
+            { optional: true },
+            createValidator(z.string().nullable()),
+        );
+    }
+}

package/src/domains/analysis-node-log/index.ts

@@ -6,3 +6,4 @@
  */
 
 export * from './entity';
+export * from './validator';

package/src/domains/analysis-node-log/validator.ts

@@ -0,0 +1,87 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import zod from 'zod';
+import { LogLevel } from '@privateaim/telemetry-kit';
+import { Container } from 'validup';
+import { createValidator } from '@validup/adapter-zod';
+import type { AnalysisNodeLog } from './entity.ts';
+
+export class AnalysisNodeLogValidator extends Container<AnalysisNodeLog> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'node_id',
+            createValidator(
+                zod
+                    .uuidv4(),
+            ),
+        );
+
+        this.mount(
+            'analysis_id',
+            createValidator(
+                zod
+                    .uuidv4(),
+            ),
+        );
+
+        this.mount(
+            'status',
+            { optional: true },
+            createValidator(
+                zod
+                    .string()
+                    .min(3)
+                    .max(64)
+                    .optional()
+                    .nullable(),
+            ),
+        );
+
+        this.mount(
+            'message',
+            createValidator(
+                zod
+                    .string()
+                    .min(3)
+                    .max(2048),
+            ),
+        );
+
+        this.mount(
+            'code',
+            { optional: true },
+            createValidator(
+                zod
+                    .string()
+                    .min(3)
+                    .max(64)
+                    .optional()
+                    .nullable(),
+            ),
+        );
+
+        this.mount(
+            'level',
+            createValidator(
+                zod
+                    .enum(LogLevel),
+            ),
+        );
+
+        this.mount(
+            'labels',
+            { optional: true },
+            createValidator(
+                zod
+                    .record(zod.string(), zod.string()),
+            ),
+        );
+    }
+}

package/src/domains/analysis-permission/index.ts

@@ -6,3 +6,4 @@
  */
 
 export * from './entity';
+export * from './validator';

package/src/domains/analysis-permission/validator.ts

@@ -0,0 +1,36 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import { Container } from 'validup';
+import { createValidator } from '@validup/adapter-zod';
+import { z } from 'zod';
+import { ValidatorGroup } from '@privateaim/kit';
+import type { AnalysisPermission } from './entity.ts';
+
+export class AnalysisPermissionValidator extends Container<AnalysisPermission> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'permission_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        this.mount(
+            'analysis_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        this.mount(
+            'policy_id',
+            { optional: true },
+            createValidator(z.uuid().nullable()),
+        );
+    }
+}

package/src/domains/node/index.ts

@@ -7,3 +7,4 @@
 
 export * from './constants';
 export * from './entity';
+export * from './validator';

package/src/domains/node/validator.ts

@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import type { Node } from './entity.ts';
+import { NodeType } from './constants.ts';
+import { Container } from 'validup';
+import { createValidator } from '@validup/adapter-zod';
+import { z } from 'zod';
+import { ValidatorGroup } from '@privateaim/kit';
+
+export class NodeValidator extends Container<Node> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'name',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.string().min(3).max(128)),
+        );
+
+        this.mount(
+            'name',
+            { group: ValidatorGroup.UPDATE, optional: true },
+            createValidator(z.string().min(3).max(128).nullable()),
+        );
+
+        this.mount(
+            'type',
+            { optional: true },
+            createValidator(z.enum(NodeType).nullable()),
+        );
+
+        this.mount(
+            'hidden',
+            { optional: true },
+            createValidator(z.boolean().nullable()),
+        );
+
+        this.mount(
+            'public_key',
+            { optional: true },
+            createValidator(z.string().min(5).max(4096).nullable()),
+        );
+
+        this.mount(
+            'external_name',
+            { optional: true },
+            createValidator(z.string().min(1).max(64).regex(/^[a-z0-9-_]*$/).nullable()),
+        );
+
+        this.mount(
+            'registry_id',
+            { optional: true },
+            createValidator(z.uuid().nullable()),
+        );
+
+        this.mount(
+            'client_id',
+            { optional: true },
+            createValidator(z.uuid().nullable()),
+        );
+
+        this.mount(
+            'realm_id',
+            { group: ValidatorGroup.CREATE, optional: true },
+            createValidator(z.uuid().nullable()),
+        );
+    }
+}

package/src/domains/project/index.ts

@@ -6,3 +6,4 @@
  */
 
 export * from './entity';
+export * from './validator';

package/src/domains/project/validator.ts

@@ -0,0 +1,43 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import { Container } from 'validup';
+import { createValidator } from '@validup/adapter-zod';
+import { z } from 'zod';
+import { ValidatorGroup } from '@privateaim/kit';
+import type { Project } from './entity.ts';
+
+export class ProjectValidator extends Container<Project> {
+    protected initialize() {
+        super.initialize();
+
+        const nameValidator = createValidator(z.string().min(5).max(100));
+        this.mount(
+            'name',
+            { group: ValidatorGroup.CREATE },
+            nameValidator,
+        );
+
+        this.mount(
+            'name',
+            { group: ValidatorGroup.UPDATE, optional: true },
+            nameValidator,
+        );
+
+        this.mount(
+            'description',
+            { optional: true },
+            createValidator(z.string().min(5).max(4096).nullable()),
+        );
+
+        this.mount(
+            'master_image_id',
+            { optional: true },
+            createValidator(z.uuid().nullable()),
+        );
+    }
+}

package/src/domains/project-node/index.ts

@@ -7,3 +7,4 @@
 
 export * from './constants';
 export * from './entity';
+export * from './validator';

package/src/domains/project-node/validator.ts

@@ -0,0 +1,43 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import type { ProjectNode } from './entity.ts';
+import { ProjectNodeApprovalStatus } from './constants.ts';
+import { Container } from 'validup';
+import { createValidator } from '@validup/adapter-zod';
+import { z } from 'zod';
+import { ValidatorGroup } from '@privateaim/kit';
+
+export class ProjectNodeValidator extends Container<ProjectNode> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'project_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        this.mount(
+            'node_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        this.mount(
+            'approval_status',
+            { group: ValidatorGroup.UPDATE, optional: true },
+            createValidator(z.enum(ProjectNodeApprovalStatus).nullable()),
+        );
+
+        this.mount(
+            'comment',
+            { group: ValidatorGroup.UPDATE, optional: true },
+            createValidator(z.string().min(3).max(4096).nullable()),
+        );
+    }
+}

package/src/domains/registry/index.ts

@@ -8,3 +8,4 @@
 export * from './constants';
 export * from './entity';
 export * from './utils';
+export * from './validator';

package/src/domains/registry/validator.ts

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import { Container } from 'validup';
+import { createValidator } from '@validup/adapter-zod';
+import { z } from 'zod';
+import { ValidatorGroup } from '@privateaim/kit';
+import type { Registry } from './entity.ts';
+
+export class RegistryValidator extends Container<Registry> {
+    protected initialize() {
+        super.initialize();
+
+        const nameValidator = createValidator(z.string().min(3).max(128));
+
+        this.mount(
+            'name',
+            { group: ValidatorGroup.CREATE },
+            nameValidator,
+        );
+
+        this.mount(
+            'name',
+            { group: ValidatorGroup.UPDATE, optional: true },
+            nameValidator,
+        );
+
+        const hostValidator = createValidator(z.string().min(3).max(512));
+        this.mount(
+            'host',
+            { group: ValidatorGroup.CREATE },
+            hostValidator,
+        );
+
+        this.mount(
+            'host',
+            { group: ValidatorGroup.UPDATE, optional: true },
+            hostValidator,
+        );
+
+        this.mount(
+            'account_name',
+            { optional: true },
+            createValidator(z.string().min(3).max(256).nullable()),
+        );
+
+        this.mount(
+            'account_secret',
+            { optional: true },
+            createValidator(z.string().min(3).max(256).nullable()),
+        );
+    }
+}

package/src/domains/registry-project/index.ts

@@ -9,3 +9,4 @@ export * from './constants';
 export * from './entity';
 export * from './socket';
 export * from './utils';
+export * from './validator';

package/src/domains/registry-project/validator.ts

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import type { RegistryProject } from './entity.ts';
+import { RegistryProjectType } from './constants.ts';
+import { Container } from 'validup';
+import { createValidator } from '@validup/adapter-zod';
+import { z } from 'zod';
+import { ValidatorGroup } from '@privateaim/kit';
+
+export class RegistryProjectValidator extends Container<RegistryProject> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'registry_id',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.uuid()),
+        );
+
+        const nameValidator = createValidator(z.string().min(5).max(128));
+        this.mount(
+            'name',
+            { group: ValidatorGroup.CREATE },
+            nameValidator,
+        );
+
+        this.mount(
+            'name',
+            { group: ValidatorGroup.UPDATE, optional: true },
+            nameValidator,
+        );
+
+        const externalNameValidator = createValidator(z.string().min(1).max(255).regex(/^[a-z0-9-_]*$/));
+        this.mount(
+            'external_name',
+            { group: ValidatorGroup.CREATE },
+            externalNameValidator,
+        );
+
+        this.mount(
+            'external_name',
+            { group: ValidatorGroup.UPDATE, optional: true },
+            externalNameValidator,
+        );
+
+        this.mount(
+            'type',
+            { group: ValidatorGroup.CREATE },
+            createValidator(z.enum(RegistryProjectType)),
+        );
+    }
+}