@volontariapp/storage-client 0.0.0-stage → 0.2.0-snap-5aae3b8

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+## 0.2.0
+
+### Minor Changes
+
+- Storage Wave 2 implementation:
+  - shared: add StorageStream enum (outbox success/failure, file scanned/rejected, attachment rejected) and event/user replacement streams
+  - domain-post: add post_media entity & model, PostMediaStatus, PostMediaScanStatus, reader visibility filtering, and updateMediaScanStatus
+  - domain-event: add cover_file_id & cover_status (CoverStatus enum), idempotent creation, and updateCover with event.cover_replaced outbox emission
+  - domain-user: add avatar_file_id, updateAvatar with user.avatar_replaced outbox emission, and deprecate logoPath
+  - errors-nest: add storage domain errors (FILE_NOT_FOUND, STORAGE_ATTACHMENT_FAILED, STORAGE_TIMEOUT, INVALID_FILE_ATTACHMENT)
+  - storage-client: new package providing NestJS StorageClientService, StorageClientModule, WithMetadata typing, and ConfirmFileAttachment helper
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @volontariapp/errors-nest@0.14.0
+
+All notable changes to this project will be documented in this file.
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial package release for NestJS storage gRPC client with ConfirmFileAttachment helper.

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const STORAGE_CLIENT_OPTIONS: unique symbol;
+export declare const DEFAULT_STORAGE_TIMEOUT_MS = 2000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,eAAmC,CAAC;AACvE,eAAO,MAAM,0BAA0B,OAAO,CAAC"}

package/dist/constants.js

@@ -0,0 +1,3 @@
+export const STORAGE_CLIENT_OPTIONS = Symbol('STORAGE_CLIENT_OPTIONS');
+export const DEFAULT_STORAGE_TIMEOUT_MS = 2000;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,11 @@
+export declare class StorageClientError extends Error {
+    readonly code?: string | number | undefined;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code?: string | number | undefined, details?: unknown | undefined);
+}
+export declare class StorageClientTimeoutError extends StorageClientError {
+    constructor(message?: string);
+}
+import type { GrpcStatusError } from '../interfaces/index.js';
+export declare function isGrpcError(error: unknown): error is GrpcStatusError;
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;aACtB,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,YAAA,EACtB,OAAO,CAAC,EAAE,OAAO,YAAA;CAMpC;AAED,qBAAa,yBAA0B,SAAQ,kBAAkB;gBACnD,OAAO,SAAgC;CAKpD;AAED,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CASpE"}

package/dist/errors/index.js

@@ -0,0 +1,27 @@
+export class StorageClientError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'StorageClientError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class StorageClientTimeoutError extends StorageClientError {
+    constructor(message = 'Storage gRPC call timed out') {
+        super(message, 'DEADLINE_EXCEEDED');
+        this.name = 'StorageClientTimeoutError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export function isGrpcError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        typeof error.code === 'number' &&
+        'details' in error &&
+        typeof error.details === 'string');
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGzB;IACA;IAHlB,YACE,OAAe,EACC,IAAsB,EACtB,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAkB;QACtB,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,kBAAkB;IAC/D,YAAY,OAAO,GAAG,6BAA6B;QACjD,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAID,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAQ,KAA2B,CAAC,IAAI,KAAK,QAAQ;QACrD,SAAS,IAAI,KAAK;QAClB,OAAQ,KAA8B,CAAC,OAAO,KAAK,QAAQ,CAC5D,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './constants.js';
+export * from './interfaces/index.js';
+export * from './errors/index.js';
+export * from './services/storage-client.service.js';
+export * from './storage-client.module.js';
+export { STORAGE_SERVICE_NAME, EntityType, FileStatus, ScanStatus, type ConfirmFileAttachmentCommand, type ConfirmFileAttachmentResponse, type FileMetadata, type StorageServiceClient, } from '@volontariapp/contracts-nest';
+export { FILE_NOT_FOUND, STORAGE_ATTACHMENT_FAILED, STORAGE_TIMEOUT, INVALID_FILE_ATTACHMENT, } from '@volontariapp/errors-nest';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAG3C,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,UAAU,EACV,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,eAAe,EACf,uBAAuB,GACxB,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from './constants.js';
+export * from './interfaces/index.js';
+export * from './errors/index.js';
+export * from './services/storage-client.service.js';
+export * from './storage-client.module.js';
+export { STORAGE_SERVICE_NAME, EntityType, FileStatus, ScanStatus, } from '@volontariapp/contracts-nest';
+export { FILE_NOT_FOUND, STORAGE_ATTACHMENT_FAILED, STORAGE_TIMEOUT, INVALID_FILE_ATTACHMENT, } from '@volontariapp/errors-nest';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAG3C,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,UAAU,GAKX,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,eAAe,EACf,uBAAuB,GACxB,MAAM,2BAA2B,CAAC"}

package/dist/interfaces/index.d.ts

@@ -0,0 +1,31 @@
+import type { InjectionToken, ModuleMetadata, OptionalFactoryDependency, Type } from '@nestjs/common';
+import type { Metadata } from '@grpc/grpc-js';
+import type { Observable } from 'rxjs';
+export type WithMetadata<T> = {
+    [K in keyof T]: T[K] extends (request: infer R) => Observable<infer Res> ? (request: R, metadata?: Metadata) => Observable<Res> : T[K];
+};
+export interface GrpcStatusError {
+    code: number;
+    details: string;
+    message: string;
+    metadata?: Metadata;
+}
+export interface StorageClientOptions {
+    url?: string;
+    internalToken?: string;
+    timeoutMs?: number;
+}
+export interface StorageClientOptionsFactory {
+    createStorageClientOptions(): Promise<StorageClientOptions> | StorageClientOptions;
+}
+export interface StorageClientAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    useExisting?: Type<StorageClientOptionsFactory>;
+    useClass?: Type<StorageClientOptionsFactory>;
+    useFactory?: (...args: unknown[]) => Promise<StorageClientOptions> | StorageClientOptions;
+    inject?: Array<InjectionToken | OptionalFactoryDependency>;
+}
+export interface ConfirmAttachmentOptions {
+    internalToken?: string;
+    timeoutMs?: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,yBAAyB,EACzB,IAAI,EACL,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,UAAU,CAAC,MAAM,GAAG,CAAC,GACpE,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,KAAK,UAAU,CAAC,GAAG,CAAC,GACpD,CAAC,CAAC,CAAC,CAAC;CACT,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IAEnC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,0BAA0B,IAAI,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;CACpF;AAED,MAAM,WAAW,yBAA0B,SAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC;IAChF,WAAW,CAAC,EAAE,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;IAC1F,MAAM,CAAC,EAAE,KAAK,CAAC,cAAc,GAAG,yBAAyB,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,wBAAwB;IAEvC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/interfaces/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":""}

package/dist/services/storage-client.service.d.ts

@@ -0,0 +1,18 @@
+import { OnModuleInit } from '@nestjs/common';
+import type { ClientGrpc } from '@nestjs/microservices';
+import { type ConfirmFileAttachmentCommand, type ConfirmFileAttachmentResponse } from '@volontariapp/contracts-nest';
+import type { ConfirmAttachmentOptions, StorageClientOptions } from '../interfaces/index.js';
+export declare class StorageClientService implements OnModuleInit {
+    private readonly clientGrpc;
+    private readonly defaultOptions?;
+    private readonly logger;
+    private storageService;
+    constructor(clientGrpc: ClientGrpc, defaultOptions?: StorageClientOptions | undefined);
+    onModuleInit(): void;
+    confirmFileAttachment(command: ConfirmFileAttachmentCommand, options?: ConfirmAttachmentOptions): Promise<ConfirmFileAttachmentResponse>;
+    confirmPostAttachment(postId: string, fileIds: string[], options?: ConfirmAttachmentOptions): Promise<ConfirmFileAttachmentResponse>;
+    confirmEventCoverAttachment(eventId: string, fileId: string, options?: ConfirmAttachmentOptions): Promise<ConfirmFileAttachmentResponse>;
+    confirmUserAvatarAttachment(userId: string, fileId: string, options?: ConfirmAttachmentOptions): Promise<ConfirmFileAttachmentResponse>;
+    confirmBadgeIconAttachment(badgeId: string, fileId: string, options?: ConfirmAttachmentOptions): Promise<ConfirmFileAttachmentResponse>;
+}
+//# sourceMappingURL=storage-client.service.d.ts.map

package/dist/services/storage-client.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-client.service.d.ts","sourceRoot":"","sources":["../../src/services/storage-client.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAY,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAEnC,MAAM,8BAA8B,CAAC;AAKtC,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EAErB,MAAM,wBAAwB,CAAC;AAGhC,qBACa,oBAAqB,YAAW,YAAY;IAMrD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAG3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IARlC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsD;IAC7E,OAAO,CAAC,cAAc,CAAsC;gBAIzC,UAAU,EAAE,UAAU,EAGtB,cAAc,CAAC,EAAE,oBAAoB,YAAA;IAGxD,YAAY;IAKN,qBAAqB,CACzB,OAAO,EAAE,4BAA4B,EACrC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,6BAA6B,CAAC;IA8BnC,qBAAqB,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,6BAA6B,CAAC;IAWnC,2BAA2B,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,6BAA6B,CAAC;IAWnC,2BAA2B,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,6BAA6B,CAAC;IAWnC,0BAA0B,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,6BAA6B,CAAC;CAU1C"}

package/dist/services/storage-client.service.js

@@ -0,0 +1,96 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var StorageClientService_1;
+import { Inject, Injectable, Optional } from '@nestjs/common';
+import { Metadata } from '@grpc/grpc-js';
+import { firstValueFrom, throwError, timeout } from 'rxjs';
+import { STORAGE_SERVICE_NAME, EntityType, } from '@volontariapp/contracts-nest';
+import { Logger } from '@volontariapp/logger';
+import { isBaseError } from '@volontariapp/errors';
+import { STORAGE_ATTACHMENT_FAILED, STORAGE_TIMEOUT } from '@volontariapp/errors-nest';
+import { DEFAULT_STORAGE_TIMEOUT_MS, STORAGE_CLIENT_OPTIONS } from '../constants.js';
+import { isGrpcError } from '../errors/index.js';
+let StorageClientService = StorageClientService_1 = class StorageClientService {
+    clientGrpc;
+    defaultOptions;
+    logger = new Logger({ context: StorageClientService_1.name });
+    storageService;
+    constructor(clientGrpc, defaultOptions) {
+        this.clientGrpc = clientGrpc;
+        this.defaultOptions = defaultOptions;
+    }
+    onModuleInit() {
+        this.storageService =
+            this.clientGrpc.getService(STORAGE_SERVICE_NAME);
+    }
+    async confirmFileAttachment(command, options) {
+        const timeoutMs = options?.timeoutMs ?? this.defaultOptions?.timeoutMs ?? DEFAULT_STORAGE_TIMEOUT_MS;
+        const internalToken = options?.internalToken ?? this.defaultOptions?.internalToken;
+        const metadata = new Metadata();
+        if (internalToken) {
+            metadata.set('x-internal-token', internalToken);
+        }
+        try {
+            return await firstValueFrom(this.storageService.confirmFileAttachment(command, metadata).pipe(timeout({
+                first: timeoutMs,
+                with: () => throwError(() => STORAGE_TIMEOUT(command.entityId, timeoutMs)),
+            })));
+        }
+        catch (error) {
+            if (isBaseError(error)) {
+                throw error;
+            }
+            const grpcErr = isGrpcError(error) ? error : undefined;
+            const message = grpcErr?.details ?? (error instanceof Error ? error.message : String(error));
+            this.logger.error(`ConfirmFileAttachment failed for entity ${command.entityId}: ${message}`);
+            throw STORAGE_ATTACHMENT_FAILED(command.entityId, message);
+        }
+    }
+    async confirmPostAttachment(postId, fileIds, options) {
+        return this.confirmFileAttachment({
+            entityId: postId,
+            entityType: EntityType.ENTITY_TYPE_POST,
+            fileIds,
+        }, options);
+    }
+    async confirmEventCoverAttachment(eventId, fileId, options) {
+        return this.confirmFileAttachment({
+            entityId: eventId,
+            entityType: EntityType.ENTITY_TYPE_EVENT_COVER,
+            fileIds: [fileId],
+        }, options);
+    }
+    async confirmUserAvatarAttachment(userId, fileId, options) {
+        return this.confirmFileAttachment({
+            entityId: userId,
+            entityType: EntityType.ENTITY_TYPE_USER_AVATAR,
+            fileIds: [fileId],
+        }, options);
+    }
+    async confirmBadgeIconAttachment(badgeId, fileId, options) {
+        return this.confirmFileAttachment({
+            entityId: badgeId,
+            entityType: EntityType.ENTITY_TYPE_BADGE_ICON,
+            fileIds: [fileId],
+        }, options);
+    }
+};
+StorageClientService = StorageClientService_1 = __decorate([
+    Injectable(),
+    __param(0, Inject(STORAGE_SERVICE_NAME)),
+    __param(1, Optional()),
+    __param(1, Inject(STORAGE_CLIENT_OPTIONS)),
+    __metadata("design:paramtypes", [Object, Object])
+], StorageClientService);
+export { StorageClientService };
+//# sourceMappingURL=storage-client.service.js.map

package/dist/services/storage-client.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-client.service.js","sourceRoot":"","sources":["../../src/services/storage-client.service.ts"],"names":[],"mappings":"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"}

package/dist/storage-client.module.d.ts

@@ -0,0 +1,8 @@
+import { type DynamicModule } from '@nestjs/common';
+import type { StorageClientAsyncOptions, StorageClientOptions } from './interfaces/index.js';
+export declare class StorageClientModule {
+    static register(options?: StorageClientOptions): DynamicModule;
+    static registerAsync(asyncOptions: StorageClientAsyncOptions): DynamicModule;
+    private static createAsyncOptionsProvider;
+}
+//# sourceMappingURL=storage-client.module.d.ts.map

package/dist/storage-client.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-client.module.d.ts","sourceRoot":"","sources":["../src/storage-client.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAyB,MAAM,gBAAgB,CAAC;AAI3E,OAAO,KAAK,EACV,yBAAyB,EACzB,oBAAoB,EAErB,MAAM,uBAAuB,CAAC;AAG/B,qBACa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa;IAwBlE,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,yBAAyB,GAAG,aAAa;IAuB5E,OAAO,CAAC,MAAM,CAAC,0BAA0B;CAqB1C"}

package/dist/storage-client.module.js

@@ -0,0 +1,80 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var StorageClientModule_1;
+import { Module } from '@nestjs/common';
+import { ClientsModule } from '@nestjs/microservices';
+import { getGrpcOptions, STORAGE_SERVICE_NAME } from '@volontariapp/contracts-nest';
+import { STORAGE_CLIENT_OPTIONS } from './constants.js';
+import { StorageClientService } from './services/storage-client.service.js';
+let StorageClientModule = StorageClientModule_1 = class StorageClientModule {
+    static register(options = {}) {
+        const url = options.url ?? 'localhost:50055';
+        return {
+            module: StorageClientModule_1,
+            imports: [
+                ClientsModule.register([
+                    {
+                        name: STORAGE_SERVICE_NAME,
+                        ...getGrpcOptions('STORAGE', url),
+                    },
+                ]),
+            ],
+            providers: [
+                {
+                    provide: STORAGE_CLIENT_OPTIONS,
+                    useValue: options,
+                },
+                StorageClientService,
+            ],
+            exports: [StorageClientService, ClientsModule],
+        };
+    }
+    static registerAsync(asyncOptions) {
+        const clientsModuleAsync = ClientsModule.registerAsync([
+            {
+                name: STORAGE_SERVICE_NAME,
+                imports: asyncOptions.imports ?? [],
+                inject: [STORAGE_CLIENT_OPTIONS],
+                useFactory: (options) => {
+                    const url = options.url ?? 'localhost:50055';
+                    return getGrpcOptions('STORAGE', url);
+                },
+            },
+        ]);
+        const optionsProvider = this.createAsyncOptionsProvider(asyncOptions);
+        return {
+            module: StorageClientModule_1,
+            imports: [...(asyncOptions.imports ?? []), clientsModuleAsync],
+            providers: [optionsProvider, StorageClientService],
+            exports: [StorageClientService, ClientsModule],
+        };
+    }
+    static createAsyncOptionsProvider(asyncOptions) {
+        if (asyncOptions.useFactory) {
+            return {
+                provide: STORAGE_CLIENT_OPTIONS,
+                useFactory: asyncOptions.useFactory,
+                inject: asyncOptions.inject ?? [],
+            };
+        }
+        const inject = asyncOptions.useExisting
+            ? [asyncOptions.useExisting]
+            : asyncOptions.useClass
+                ? [asyncOptions.useClass]
+                : [];
+        return {
+            provide: STORAGE_CLIENT_OPTIONS,
+            useFactory: async (factory) => factory.createStorageClientOptions(),
+            inject,
+        };
+    }
+};
+StorageClientModule = StorageClientModule_1 = __decorate([
+    Module({})
+], StorageClientModule);
+export { StorageClientModule };
+//# sourceMappingURL=storage-client.module.js.map

package/dist/storage-client.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-client.module.js","sourceRoot":"","sources":["../src/storage-client.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAsB,MAAM,EAAiB,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAMxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAGrE,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,UAAgC,EAAE;QAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,iBAAiB,CAAC;QAE7C,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,OAAO,EAAE;gBACP,aAAa,CAAC,QAAQ,CAAC;oBACrB;wBACE,IAAI,EAAE,oBAAoB;wBAC1B,GAAG,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC;qBAClC;iBACF,CAAC;aACH;YACD,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,sBAAsB;oBAC/B,QAAQ,EAAE,OAAO;iBAClB;gBACD,oBAAoB;aACrB;YACD,OAAO,EAAE,CAAC,oBAAoB,EAAE,aAAa,CAAC;SAC/C,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,YAAuC;QAC1D,MAAM,kBAAkB,GAAG,aAAa,CAAC,aAAa,CAAC;YACrD;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,YAAY,CAAC,OAAO,IAAI,EAAE;gBACnC,MAAM,EAAE,CAAC,sBAAsB,CAAC;gBAChC,UAAU,EAAE,CAAC,OAA6B,EAAE,EAAE;oBAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,iBAAiB,CAAC;oBAC7C,OAAO,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBACxC,CAAC;aACF;SACF,CAAC,CAAC;QAEH,MAAM,eAAe,GAAa,IAAI,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAC;QAEhF,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,OAAO,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,kBAAkB,CAAC;YAC9D,SAAS,EAAE,CAAC,eAAe,EAAE,oBAAoB,CAAC;YAClD,OAAO,EAAE,CAAC,oBAAoB,EAAE,aAAa,CAAC;SAC/C,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,0BAA0B,CAAC,YAAuC;QAC/E,IAAI,YAAY,CAAC,UAAU,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,sBAAsB;gBAC/B,UAAU,EAAE,YAAY,CAAC,UAAU;gBACnC,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,EAAE;aAClC,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW;YACrC,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC;YAC5B,CAAC,CAAC,YAAY,CAAC,QAAQ;gBACrB,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC;gBACzB,CAAC,CAAC,EAAE,CAAC;QACT,OAAO;YACL,OAAO,EAAE,sBAAsB;YAC/B,UAAU,EAAE,KAAK,EAAE,OAAoC,EAAE,EAAE,CACzD,OAAO,CAAC,0BAA0B,EAAE;YACtC,MAAM;SACP,CAAC;IACJ,CAAC;CACF,CAAA;AArEY,mBAAmB;IAD/B,MAAM,CAAC,EAAE,CAAC;GACE,mBAAmB,CAqE/B"}

package/dist/test/storage-client.service.unit.spec.d.ts

@@ -0,0 +1,2 @@
+import 'reflect-metadata';
+//# sourceMappingURL=storage-client.service.unit.spec.d.ts.map

package/dist/test/storage-client.service.unit.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-client.service.unit.spec.d.ts","sourceRoot":"","sources":["../../src/test/storage-client.service.unit.spec.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC"}

package/dist/test/storage-client.service.unit.spec.js

@@ -0,0 +1,166 @@
+import 'reflect-metadata';
+import { jest, describe, it, expect, beforeEach } from '@jest/globals';
+import { of, throwError, timer } from 'rxjs';
+import { map } from 'rxjs/operators';
+import { StorageClientService, isGrpcError, EntityType, STORAGE_SERVICE_NAME, } from '../index.js';
+describe('StorageClientService (Unit)', () => {
+    let service;
+    let mockClientGrpc;
+    let mockStorageService;
+    beforeEach(() => {
+        mockStorageService = {
+            confirmFileAttachment: jest.fn(),
+        };
+        mockClientGrpc = {
+            getService: jest.fn().mockReturnValue(mockStorageService),
+            getClientByServiceName: jest.fn(),
+        };
+        service = new StorageClientService(mockClientGrpc, {
+            internalToken: 'default-secret-token',
+            timeoutMs: 1000,
+        });
+        service.onModuleInit();
+    });
+    describe('onModuleInit', () => {
+        it('should acquire StorageService from ClientGrpc', () => {
+            const spyService = jest.spyOn(mockClientGrpc, 'getService');
+            service.onModuleInit();
+            expect(spyService).toHaveBeenCalledWith(STORAGE_SERVICE_NAME);
+        });
+    });
+    describe('confirmFileAttachment', () => {
+        it('should call gRPC client with command and metadata, returning response', async () => {
+            const mockResponse = {
+                success: true,
+                updatedCount: 1,
+                files: [],
+            };
+            mockStorageService.confirmFileAttachment.mockReturnValue(of(mockResponse));
+            const result = await service.confirmFileAttachment({
+                entityId: 'post-1',
+                entityType: EntityType.ENTITY_TYPE_POST,
+                fileIds: ['file-1'],
+            });
+            expect(result).toEqual(mockResponse);
+            expect(mockStorageService.confirmFileAttachment).toHaveBeenCalledTimes(1);
+            const [command, rawMeta] = mockStorageService.confirmFileAttachment.mock.calls[0];
+            const metadata = rawMeta;
+            expect(command).toEqual({
+                entityId: 'post-1',
+                entityType: EntityType.ENTITY_TYPE_POST,
+                fileIds: ['file-1'],
+            });
+            expect(metadata.get('x-internal-token')).toEqual(['default-secret-token']);
+        });
+        it('should allow overriding internalToken and timeoutMs in call options', async () => {
+            const mockResponse = {
+                success: true,
+                updatedCount: 1,
+                files: [],
+            };
+            mockStorageService.confirmFileAttachment.mockReturnValue(of(mockResponse));
+            await service.confirmFileAttachment({
+                entityId: 'post-1',
+                entityType: EntityType.ENTITY_TYPE_POST,
+                fileIds: ['file-1'],
+            }, { internalToken: 'custom-token', timeoutMs: 500 });
+            const [, rawMeta] = mockStorageService.confirmFileAttachment.mock.calls[0];
+            const metadata = rawMeta;
+            expect(metadata.get('x-internal-token')).toEqual(['custom-token']);
+        });
+        it('should throw StorageClientTimeoutError when call exceeds timeout', async () => {
+            mockStorageService.confirmFileAttachment.mockReturnValue(timer(200).pipe(map(() => ({
+                success: true,
+                updatedCount: 1,
+                files: [],
+            }))));
+            await expect(service.confirmFileAttachment({
+                entityId: 'event-1',
+                entityType: EntityType.ENTITY_TYPE_EVENT_COVER,
+                fileIds: ['cover-file-1'],
+            }, { timeoutMs: 50 })).rejects.toMatchObject({
+                code: 'STORAGE_TIMEOUT',
+            });
+        });
+        it('should throw STORAGE_ATTACHMENT_FAILED when gRPC call throws', async () => {
+            const grpcError = {
+                code: 5,
+                details: 'File not found',
+                message: '5 NOT_FOUND: File not found',
+            };
+            mockStorageService.confirmFileAttachment.mockReturnValue(throwError(() => grpcError));
+            await expect(service.confirmFileAttachment({
+                entityId: 'user-1',
+                entityType: EntityType.ENTITY_TYPE_USER_AVATAR,
+                fileIds: ['avatar-file-1'],
+            })).rejects.toMatchObject({
+                code: 'STORAGE_ATTACHMENT_FAILED',
+            });
+        });
+    });
+    describe('convenience methods', () => {
+        it('confirmPostAttachment should call confirmFileAttachment with ENTITY_TYPE_POST', async () => {
+            const spy = jest.spyOn(service, 'confirmFileAttachment').mockResolvedValue({
+                success: true,
+                updatedCount: 2,
+                files: [],
+            });
+            await service.confirmPostAttachment('p-123', ['f-1', 'f-2']);
+            expect(spy).toHaveBeenCalledWith({
+                entityId: 'p-123',
+                entityType: EntityType.ENTITY_TYPE_POST,
+                fileIds: ['f-1', 'f-2'],
+            }, undefined);
+        });
+        it('confirmEventCoverAttachment should call confirmFileAttachment with ENTITY_TYPE_EVENT_COVER', async () => {
+            const spy = jest.spyOn(service, 'confirmFileAttachment').mockResolvedValue({
+                success: true,
+                updatedCount: 1,
+                files: [],
+            });
+            await service.confirmEventCoverAttachment('e-123', 'cov-1');
+            expect(spy).toHaveBeenCalledWith({
+                entityId: 'e-123',
+                entityType: EntityType.ENTITY_TYPE_EVENT_COVER,
+                fileIds: ['cov-1'],
+            }, undefined);
+        });
+        it('confirmUserAvatarAttachment should call confirmFileAttachment with ENTITY_TYPE_USER_AVATAR', async () => {
+            const spy = jest.spyOn(service, 'confirmFileAttachment').mockResolvedValue({
+                success: true,
+                updatedCount: 1,
+                files: [],
+            });
+            await service.confirmUserAvatarAttachment('u-123', 'av-1');
+            expect(spy).toHaveBeenCalledWith({
+                entityId: 'u-123',
+                entityType: EntityType.ENTITY_TYPE_USER_AVATAR,
+                fileIds: ['av-1'],
+            }, undefined);
+        });
+        it('confirmBadgeIconAttachment should call confirmFileAttachment with ENTITY_TYPE_BADGE_ICON', async () => {
+            const spy = jest.spyOn(service, 'confirmFileAttachment').mockResolvedValue({
+                success: true,
+                updatedCount: 1,
+                files: [],
+            });
+            await service.confirmBadgeIconAttachment('b-123', 'icon-1');
+            expect(spy).toHaveBeenCalledWith({
+                entityId: 'b-123',
+                entityType: EntityType.ENTITY_TYPE_BADGE_ICON,
+                fileIds: ['icon-1'],
+            }, undefined);
+        });
+    });
+    describe('isGrpcError', () => {
+        it('should return true for valid gRPC error structure', () => {
+            expect(isGrpcError({ code: 14, details: 'Unavailable', message: '14 UNAVAILABLE' })).toBe(true);
+        });
+        it('should return false for non-grpc errors', () => {
+            expect(isGrpcError(new Error('general error'))).toBe(false);
+            expect(isGrpcError(null)).toBe(false);
+            expect(isGrpcError('string error')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=storage-client.service.unit.spec.js.map

package/dist/test/storage-client.service.unit.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-client.service.unit.spec.js","sourceRoot":"","sources":["../../src/test/storage-client.service.unit.spec.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "@volontariapp/storage-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0-snap-5aae3b8",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Volontariapp/npm-packages.git"
+  },
+  "description": "NestJS gRPC client for ms-storage ConfirmFileAttachment and storage operations",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24.14.0"
+  },
+  "scripts": {
+    "prepublishOnly": "yarn build",
+    "build": "tsc -p tsconfig.json",
+    "lint": "eslint src/",
+    "test": "node --experimental-vm-modules $(yarn bin jest)",
+    "test:coverage": "node --experimental-vm-modules $(yarn bin jest) --coverage"
+  },
+  "devDependencies": {
+    "@grpc/grpc-js": "^1.12.0",
+    "@jest/globals": "^30.3.0",
+    "@nestjs/common": "^11.1.18",
+    "@nestjs/core": "^11.1.18",
+    "@nestjs/microservices": "^11.1.14",
+    "@nestjs/testing": "^11.1.18",
+    "@types/jest": "^30.0.0",
+    "jest": "^30.3.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "ts-jest": "^29.4.9",
+    "typescript": "5.7.3"
+  },
+  "peerDependencies": {
+    "@grpc/grpc-js": "^1.12.0",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/microservices": "^11.0.0",
+    "rxjs": "^7.8.2"
+  },
+  "dependencies": {
+    "@volontariapp/contracts": "4.3.16",
+    "@volontariapp/contracts-nest": "3.3.8",
+    "@volontariapp/errors": "0.6.5",
+    "@volontariapp/errors-nest": "0.14.0-snap-5aae3b8",
+    "@volontariapp/logger": "0.4.0"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.