itlab-internal-services 2.16.23 → 2.16.24

package/dist/modules/services/providers/files/files.service.d.ts

@@ -82,4 +82,5 @@ export declare class FilesService extends BaseHttpService {
     uploadAvatarV1(accountId: string, avatar: File): Promise<void>;
     deleteAvatarV1(accountId: string): Promise<void>;
     cropImageV1(image: File, options?: CropImageOptionsDtoV1): Promise<Buffer>;
+    downloadBlobV1(container: 'file' | 'avatar' | 'pass', blobName: string): Promise<Buffer>;
 }

package/dist/modules/services/providers/files/files.service.js

@@ -137,6 +137,20 @@ let FilesService = class FilesService extends base_http_service_1.BaseHttpServic
             throw new common_1.HttpException(data, status);
         }
     }
+    // ─────────────────────────────────────────────────────────────
+    // Storage Blob Methods
+    // ─────────────────────────────────────────────────────────────
+    async downloadBlobV1(container, blobName) {
+        try {
+            const { data } = await this.httpClient.get(`v1/internal/blob/${container}/${blobName}`);
+            return data;
+        }
+        catch (error) {
+            const { status, data, message } = this.parseError(error);
+            this.logger.error(`Error downloading blob: ${message}`);
+            throw new common_1.HttpException(data, status);
+        }
+    }
 };
 exports.FilesService = FilesService;
 exports.FilesService = FilesService = __decorate([

package/dist/modules/services/providers/pass/dtos/create-team-member-pass.dto.v1.d.ts

@@ -12,24 +12,23 @@ export type CreateTeamMemberPassDtoV1 = {
      */
     memberId: string;
     /**
-     * Optional: HTTPS URL pointing to the member’s avatar image.
-     * Must be served from a trusted domain for security.
+     * Optional: Blobname of the member's avatar.
      *
-     * @example 'https://example.com/avatar.jpg'
+     * @example 'avatar/507f1f77bcf86cd799439022'
      */
-    avatar?: string;
+    avatarBlob?: `${'avatar' | 'file'}/${string}`;
     /**
      * Full name of the team member, displayed prominently on the pass.
      *
      * @example 'John Smith'
      */
-    fullName: string;
+    name: string;
     /**
-     * Email address of the team member.
+     * Optional: Email address of the team member.
      *
      * @example 'john.smith@example.com'
      */
-    email: string;
+    email?: string;
     /**
      * Descriptive job title or role within the organization.
      *

package/dist/modules/services/providers/pass/dtos/create-tech-scout-pass.dto.v1.d.ts

@@ -0,0 +1,52 @@
+/**
+ * CreateTechScoutPassDtoV1
+ *
+ * Data structure used to generate a digital Apple Wallet pass for a Tech Scout.
+ * Captures personal identity and membership history.
+ */
+export type CreateTechScoutPassDtoV1 = {
+    /**
+     * MongoDB ObjectId uniquely identifying the tech scout.
+     *
+     * @example '507f1f77bcf86cd799439011'
+     */
+    techScoutId: string;
+    /**
+     * Optional: Blobname of the tech-scout's avatar.
+     *
+     * @example 'avatar/507f1f77bcf86cd799439022'
+     */
+    avatarBlob?: `${'avatar' | 'file'}/${string}`;
+    /**
+     * Full name of the member as it should appear on the digital pass.
+     *
+     * @example 'Jane Doe'
+     */
+    name: string;
+    /**
+     * Email address used to identify and contact the guild member.
+     *
+     * @example 'jane.doe@example.com'
+     */
+    email: string;
+    /**
+     * Department of the tech scout
+     *
+     * @example IGF1
+     */
+    department: string;
+    /**
+     * Optional: Role of the tech scout
+     *
+     * @example Developer
+     */
+    role?: string;
+    /**
+     * Timestamp when the member joined.
+     */
+    memberSince: number;
+    /**
+     * Timestamp when the member left.
+     */
+    memberUntil?: number;
+};

package/dist/modules/services/providers/pass/dtos/index.d.ts

@@ -1,2 +1,2 @@
-export * from './create-guild-member-pass.dto.v1';
 export * from './create-team-member-pass.dto.v1';
+export * from './create-tech-scout-pass.dto.v1';

package/dist/modules/services/providers/pass/dtos/index.js

@@ -14,5 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./create-guild-member-pass.dto.v1"), exports);
 __exportStar(require("./create-team-member-pass.dto.v1"), exports);
+__exportStar(require("./create-tech-scout-pass.dto.v1"), exports);

package/dist/modules/services/providers/pass/pass-types.d.ts

@@ -1,8 +1,8 @@
-import { CreateGuildMemberPassDtoV1, CreateTeamMemberPassDtoV1 } from './dtos';
+import { CreateTeamMemberPassDtoV1, CreateTechScoutPassDtoV1 } from './dtos';
 /**
  * Constant list of supported digital pass types.
  */
-declare const supportedPassTypes: readonly ["team-member", "guild-member"];
+declare const supportedPassTypes: readonly ["v1.team-member", "v1.tech-scout"];
 /**
  * Union type representing valid pass types.
  */
@@ -12,7 +12,8 @@ export type PassType = (typeof supportedPassTypes)[number];
  * This enables type-safe payload handling when creating passes.
  */
 export type PassTypeDtoMap = {
-    'team-member': CreateTeamMemberPassDtoV1;
-    'guild-member': CreateGuildMemberPassDtoV1;
+    'v1.team-member': CreateTeamMemberPassDtoV1;
+    'v1.tech-scout': CreateTechScoutPassDtoV1;
 };
+export declare const PassTypeEndpointMap: Record<PassType, string>;
 export {};

package/dist/modules/services/providers/pass/pass-types.js

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PassTypeEndpointMap = void 0;
 /**
  * Constant list of supported digital pass types.
  */
 // eslint-disable-next-line
-const supportedPassTypes = ['team-member', 'guild-member'];
+const supportedPassTypes = ['v1.team-member', 'v1.tech-scout'];
+exports.PassTypeEndpointMap = {
+    'v1.team-member': 'v1/internal/team-member',
+    'v1.tech-scout': 'v1/internal/tech-scout',
+};

package/dist/modules/services/providers/pass/pass.service.d.ts

@@ -1,8 +1,7 @@
 import { ConfigService } from '@nestjs/config';
 import { AuthenticationModuleOptions } from '../../../authentication';
 import { BaseHttpService } from '../../base-http.service';
-import { CreateGuildMemberPassDtoV1, CreateTeamMemberPassDtoV1 } from './dtos';
-import { PassType, PassTypeDtoMap } from './pass-types';
+import { CreateTeamMemberPassDtoV1, CreateTechScoutPassDtoV1 } from './dtos';
 /**
  * PassService
  *
@@ -19,80 +18,37 @@ export declare class PassService extends BaseHttpService {
      */
     constructor(authenticationOptions: AuthenticationModuleOptions, configService: ConfigService);
     /**
-     * Fetches a digital pass by its serial number.
+     * Creates a pass of the given type with the provided payload
      *
-     * @param {string} serialNumber - Unique serial number of the pass.
-     * @returns {Promise<string>} - Returns the SAS URL of the pass.
+     * @template Type - One of the supported PassType keys
+     * @param type - The type of the pass to create
+     * @param payload - The payload DTO corresponding to the type
      */
-    getPassBySerialV1(serialNumber: string): Promise<string>;
+    private createPass;
     /**
-     * Deletes a digital pass by its serial number.
-     *
-     * @param {string} serialNumber - Unique serial number of the pass.
-     */
-    deletePassBySerialV1(serialNumber: string): void;
-    /**
-     * Fetches a pass based on its type and associated member ID.
-     *
-     * @param {PassType} type - Type of the pass.
-     * @param {string} memberId - Identifier of the associated member.
-     * @returns {Promise<string>} - Returns the SAS URL of the pass.
-     */
-    private getPassByTypeV1;
-    /**
-     * Deletes a pass based on its type and associated member ID.
-     *
-     * @param {PassType} type - Type of the pass.
-     * @param {string} memberId - Identifier of the associated member.
-     */
-    private deletePassByTypeV1;
-    /**
-     * Creates a pass using its type and corresponding payload DTO.
-     *
-     * @template Type - A specific pass type from PassType.
-     * @param {Type} type - Type of the pass to create.
-     * @param {PassTypeDtoMap[Type]} payload - DTO matching the type of pass.
-     * @returns {Promise<string>} - The resulting pass URL or identifier.
+     * Deletes a pass of the given type with the provided passId
+     * @param type - The type of the pass to delete
+     * @param passId - The ID of the pass to delete
      */
-    createPassV1<Type extends PassType>(type: Type, payload: PassTypeDtoMap[Type]): Promise<string>;
+    private deletePass;
     /**
-     * Retrieves the digital pass for a specific team member.
-     *
-     * @param {string} memberId - Identifier of the team member.
-     * @returns {Promise<string>} - SAS URL of the team member's pass.
-     */
-    getTeamMemberPassV1(memberId: string): Promise<string>;
-    /**
-     * Creates a pass for a team member.
-     *
-     * @param {CreateTeamMemberPassDtoV1} data - Required details to generate the team member pass.
-     * @returns {Promise<string>} - URL or ID of the created pass.
-     */
-    createTeamMemberPassV1(data: CreateTeamMemberPassDtoV1): Promise<string>;
-    /**
-     * Deletes a team member’s pass.
-     *
-     * @param {string} memberId - Identifier of the team member.
+     * Creates a team-member pass
+     * @param {CreateTeamMemberPassDtoV1} payload - DTO containing relevant data
      */
-    deleteTeamMemberPassV1(memberId: string): void;
+    createTeamMemberPassV1(payload: CreateTeamMemberPassDtoV1): void;
     /**
-     * Retrieves the digital pass for a specific guild member.
-     *
-     * @param {string} memberId - Identifier of the guild member.
-     * @returns {Promise<string>} - SAS URL of the guild member's pass.
+     * Deletes a team-member pass
+     * @param {string} passId - The ID of the pass to delete
      */
-    getGuildMemberPassV1(memberId: string): Promise<string>;
+    deleteTeamMemberPassV1(passId: string): void;
     /**
-     * Creates a pass for a guild member.
-     *
-     * @param {CreateGuildMemberPassDtoV1} data - Required details to generate the guild member pass.
-     * @returns {Promise<string>} - URL or ID of the created pass.
+     * Creates a tech-scout pass
+     * @param {CreateTechScoutPassDtoV1} payload - DTO containing relevant data
      */
-    createGuildMemberPassV1(data: CreateGuildMemberPassDtoV1): Promise<string>;
+    createTechScoutPassV1(payload: CreateTechScoutPassDtoV1): void;
     /**
-     * Deletes a guild member’s pass.
-     *
-     * @param {string} memberId - Identifier of the guild member.
+     * Deletes a tech-scout pass
+     * @param {string} passId - The ID of the pass to delete
      */
-    deleteGuildMemberPassV1(memberId: string): void;
+    deleteTechScoutPassV1(passId: string): void;
 }

package/dist/modules/services/providers/pass/pass.service.js

@@ -18,6 +18,7 @@ const config_1 = require("@nestjs/config");
 const authentication_1 = require("../../../authentication");
 const base_http_service_1 = require("../../base-http.service");
 const base_urls_1 = require("../../base-urls");
+const pass_types_1 = require("./pass-types");
 /**
  * PassService
  *
@@ -35,161 +36,75 @@ let PassService = class PassService extends base_http_service_1.BaseHttpService
     constructor(authenticationOptions, configService) {
         super('Pass', base_urls_1.BaseUrls.passService, authenticationOptions, configService);
     }
-    // ─────────────────────────────────────────────
-    // Serial Number-Based Operations
-    // ─────────────────────────────────────────────
-    /**
-     * Fetches a digital pass by its serial number.
-     *
-     * @param {string} serialNumber - Unique serial number of the pass.
-     * @returns {Promise<string>} - Returns the SAS URL of the pass.
-     */
-    async getPassBySerialV1(serialNumber) {
-        try {
-            const { data } = await this.httpClient.get(`v1/internal/pass/${serialNumber}`);
-            this.logger.log(`Pass retrieved using serial: ${serialNumber}`);
-            return data;
-        }
-        catch (error) {
-            const { status, data, message } = this.parseError(error);
-            this.logger.error(`Error retrieving pass with serial ${serialNumber}: ${message}`);
-            throw new common_1.HttpException(data, status);
-        }
-    }
     /**
-     * Deletes a digital pass by its serial number.
+     * Creates a pass of the given type with the provided payload
      *
-     * @param {string} serialNumber - Unique serial number of the pass.
+     * @template Type - One of the supported PassType keys
+     * @param type - The type of the pass to create
+     * @param payload - The payload DTO corresponding to the type
      */
-    deletePassBySerialV1(serialNumber) {
+    createPass(type, payload) {
+        this.logger.log(`Creating pass ${type}`);
         this.httpClient
-            .delete(`v1/internal/pass/${serialNumber}`)
+            .post(pass_types_1.PassTypeEndpointMap[type], payload)
             .then(() => {
-            this.logger.log(`Pass deleted for serial: ${serialNumber}`);
+            this.logger.log(`${type} pass created successfully`);
         })
             .catch((error) => {
             const { message } = this.parseError(error);
-            this.logger.error(`Error deleting pass with serial ${serialNumber}: ${message}`);
+            this.logger.error(`Failed to create ${type} pass: ${message}`);
         });
     }
-    // ─────────────────────────────────────────────
-    // Type/Member-Based Operations
-    // ─────────────────────────────────────────────
     /**
-     * Fetches a pass based on its type and associated member ID.
-     *
-     * @param {PassType} type - Type of the pass.
-     * @param {string} memberId - Identifier of the associated member.
-     * @returns {Promise<string>} - Returns the SAS URL of the pass.
+     * Deletes a pass of the given type with the provided passId
+     * @param type - The type of the pass to delete
+     * @param passId - The ID of the pass to delete
      */
-    async getPassByTypeV1(type, memberId) {
-        const endpoint = `v1/internal/${type}/${memberId}`;
-        try {
-            const { data } = await this.httpClient.get(endpoint);
-            this.logger.log(`Pass retrieved for ${type} member ID: ${memberId}`);
-            return data;
-        }
-        catch (error) {
-            const { status, data, message } = this.parseError(error);
-            this.logger.error(`Error retrieving ${type} pass for ${memberId}: ${message}`);
-            throw new common_1.HttpException(data, status);
-        }
-    }
-    /**
-     * Deletes a pass based on its type and associated member ID.
-     *
-     * @param {PassType} type - Type of the pass.
-     * @param {string} memberId - Identifier of the associated member.
-     */
-    deletePassByTypeV1(type, memberId) {
-        const endpoint = `v1/internal/${type}/${memberId}`;
+    deletePass(type, passId) {
+        this.logger.log(`Deleting pass ${type} ${passId}`);
         this.httpClient
-            .delete(endpoint)
+            .delete(`${pass_types_1.PassTypeEndpointMap[type]}/${passId}`)
             .then(() => {
-            this.logger.log(`Pass deleted for ${type} member ID: ${memberId}`);
+            this.logger.log(`${type} ${passId} pass deleted successfully`);
         })
             .catch((error) => {
             const { message } = this.parseError(error);
-            this.logger.error(`Error deleting ${type} pass for ${memberId}: ${message}`);
+            this.logger.error(`Failed to delete ${type} ${passId} pass: ${message}`);
         });
     }
-    /**
-     * Creates a pass using its type and corresponding payload DTO.
-     *
-     * @template Type - A specific pass type from PassType.
-     * @param {Type} type - Type of the pass to create.
-     * @param {PassTypeDtoMap[Type]} payload - DTO matching the type of pass.
-     * @returns {Promise<string>} - The resulting pass URL or identifier.
-     */
-    async createPassV1(type, payload) {
-        try {
-            const { data } = await this.httpClient.post(`v1/internal/${type}`, payload);
-            this.logger.log(`Pass successfully created for ${type}`);
-            return data;
-        }
-        catch (error) {
-            const { status, data, message } = this.parseError(error);
-            this.logger.error(`Error creating pass for ${type}: ${message}`);
-            throw new common_1.HttpException(data, status);
-        }
-    }
     // ─────────────────────────────────────────────
-    // Team Member Pass Helpers
+    // Team Member Pass
     // ─────────────────────────────────────────────
     /**
-     * Retrieves the digital pass for a specific team member.
-     *
-     * @param {string} memberId - Identifier of the team member.
-     * @returns {Promise<string>} - SAS URL of the team member's pass.
-     */
-    async getTeamMemberPassV1(memberId) {
-        return this.getPassByTypeV1('team-member', memberId);
-    }
-    /**
-     * Creates a pass for a team member.
-     *
-     * @param {CreateTeamMemberPassDtoV1} data - Required details to generate the team member pass.
-     * @returns {Promise<string>} - URL or ID of the created pass.
+     * Creates a team-member pass
+     * @param {CreateTeamMemberPassDtoV1} payload - DTO containing relevant data
      */
-    async createTeamMemberPassV1(data) {
-        return this.createPassV1('team-member', data);
+    createTeamMemberPassV1(payload) {
+        this.createPass('v1.team-member', payload);
     }
     /**
-     * Deletes a team member’s pass.
-     *
-     * @param {string} memberId - Identifier of the team member.
+     * Deletes a team-member pass
+     * @param {string} passId - The ID of the pass to delete
      */
-    deleteTeamMemberPassV1(memberId) {
-        this.deletePassByTypeV1('team-member', memberId);
+    deleteTeamMemberPassV1(passId) {
+        this.deletePass('v1.team-member', passId);
     }
     // ─────────────────────────────────────────────
-    // Guild Member Pass Helpers
+    // Tech Scout Pass
     // ─────────────────────────────────────────────
     /**
-     * Retrieves the digital pass for a specific guild member.
-     *
-     * @param {string} memberId - Identifier of the guild member.
-     * @returns {Promise<string>} - SAS URL of the guild member's pass.
+     * Creates a tech-scout pass
+     * @param {CreateTechScoutPassDtoV1} payload - DTO containing relevant data
      */
-    async getGuildMemberPassV1(memberId) {
-        return this.getPassByTypeV1('guild-member', memberId);
+    createTechScoutPassV1(payload) {
+        this.createPass('v1.tech-scout', payload);
     }
     /**
-     * Creates a pass for a guild member.
-     *
-     * @param {CreateGuildMemberPassDtoV1} data - Required details to generate the guild member pass.
-     * @returns {Promise<string>} - URL or ID of the created pass.
-     */
-    async createGuildMemberPassV1(data) {
-        return this.createPassV1('guild-member', data);
-    }
-    /**
-     * Deletes a guild member’s pass.
-     *
-     * @param {string} memberId - Identifier of the guild member.
+     * Deletes a tech-scout pass
+     * @param {string} passId - The ID of the pass to delete
      */
-    deleteGuildMemberPassV1(memberId) {
-        this.deletePassByTypeV1('guild-member', memberId);
+    deleteTechScoutPassV1(passId) {
+        this.deletePass('v1.tech-scout', passId);
     }
 };
 exports.PassService = PassService;

package/package.json

@@ -4,7 +4,7 @@
     "name": "Timo Scheuermann",
     "email": "timo.scheuermann@sv-informatik.de"
   },
-  "version": "2.16.23",
+  "version": "2.16.24",
   "type": "commonjs",
   "files": [
     "dist"
@@ -35,7 +35,7 @@
     "cache-manager": "^7.2.4",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.2",
-    "itlab-functions": "^1.0.13",
+    "itlab-functions": "1.0.15",
     "mongoose": "^8.19.2",
     "rxjs": "^7.8.2"
   },

package/dist/modules/services/providers/pass/dtos/create-guild-member-pass.dto.v1.d.ts

@@ -1,33 +0,0 @@
-/**
- * CreateGuildMemberPassDtoV1
- *
- * Data structure used to generate a digital Apple Wallet pass for a Technology Guild member.
- * Captures personal identity and membership history.
- */
-export type CreateGuildMemberPassDtoV1 = {
-    /**
-     * MongoDB ObjectId uniquely identifying the guild member.
-     *
-     * @example '507f1f77bcf86cd799439011'
-     */
-    memberId: string;
-    /**
-     * Full legal name of the member as it should appear on the digital pass.
-     *
-     * @example 'Jane Doe'
-     */
-    fullName: string;
-    /**
-     * Email address used to identify and contact the guild member.
-     *
-     * @example 'jane.doe@example.com'
-     */
-    email: string;
-    /**
-     * Human-readable date string indicating when the member joined.
-     * Format should be: 'Month Year' (e.g., 'June 2020').
-     *
-     * @example 'June 2020'
-     */
-    memberSince: string;
-};