@volontariapp/storage-client 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.3.0
+
+### Minor Changes
+
+- Relay the business errors of ms-storage (file not found, attachment refused...) with their own status and code instead of wrapping them in STORAGE_ATTACHMENT_FAILED (500). Transport failures keep their existing codes, so the asynchronous fallback of ms-post and ms-event is unchanged. The reason of STORAGE_ATTACHMENT_FAILED now starts with the gRPC status name (for example "UNAVAILABLE: ..."). Add the isStorageUnavailable helper and the StorageUnavailableError (503) for consumers without an asynchronous fallback, such as the avatar of ms-user.
+
 ## 0.2.2
 
 ### Patch Changes

package/dist/errors/grpc-error.d.ts

@@ -0,0 +1,3 @@
+import type { GrpcStatusError } from '../interfaces/index.js';
+export declare function isGrpcError(error: unknown): error is GrpcStatusError;
+//# sourceMappingURL=grpc-error.d.ts.map

package/dist/errors/grpc-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc-error.d.ts","sourceRoot":"","sources":["../../src/errors/grpc-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CASpE"}

package/dist/errors/grpc-error.js

@@ -0,0 +1,9 @@
+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=grpc-error.js.map

package/dist/errors/grpc-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc-error.js","sourceRoot":"","sources":["../../src/errors/grpc-error.ts"],"names":[],"mappings":"AAEA,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/errors/index.d.ts

@@ -6,6 +6,8 @@ export declare class StorageClientError extends Error {
 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;
+export * from './storage-unavailable.error.js';
+export * from './storage-relayed.error.js';
+export * from './is-storage-unavailable.js';
+export * from './grpc-error.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC"}

package/dist/errors/index.js

@@ -16,12 +16,8 @@ export class StorageClientTimeoutError extends StorageClientError {
         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');
-}
+export * from './storage-unavailable.error.js';
+export * from './storage-relayed.error.js';
+export * from './is-storage-unavailable.js';
+export * from './grpc-error.js';
 //# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -1 +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"}
+{"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;AAED,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC"}

package/dist/errors/is-storage-unavailable.d.ts

@@ -0,0 +1,2 @@
+export declare const isStorageUnavailable: (error: unknown) => boolean;
+//# sourceMappingURL=is-storage-unavailable.d.ts.map

package/dist/errors/is-storage-unavailable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-storage-unavailable.d.ts","sourceRoot":"","sources":["../../src/errors/is-storage-unavailable.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,oBAAoB,UAAW,OAAO,KAAG,OAmBrD,CAAC"}

package/dist/errors/is-storage-unavailable.js

@@ -0,0 +1,21 @@
+import { isBaseError } from '@volontariapp/errors';
+import { isGrpcError } from './grpc-error.js';
+const GRPC_UNAVAILABLE = 14;
+const GRPC_DEADLINE_EXCEEDED = 4;
+export const isStorageUnavailable = (error) => {
+    if (isBaseError(error)) {
+        if (error.code === 'STORAGE_TIMEOUT') {
+            return true;
+        }
+        if (error.code === 'STORAGE_ATTACHMENT_FAILED') {
+            const rawReason = error.details?.['reason'];
+            const reason = typeof rawReason === 'string' ? rawReason.toUpperCase() : '';
+            return (reason.includes('UNAVAILABLE') ||
+                reason.includes('DEADLINE_EXCEEDED') ||
+                reason.includes('CONNECT ECONNREFUSED'));
+        }
+        return false;
+    }
+    return (isGrpcError(error) && (error.code === GRPC_UNAVAILABLE || error.code === GRPC_DEADLINE_EXCEEDED));
+};
+//# sourceMappingURL=is-storage-unavailable.js.map

package/dist/errors/is-storage-unavailable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-storage-unavailable.js","sourceRoot":"","sources":["../../src/errors/is-storage-unavailable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAMjC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAW,EAAE;IAC9D,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,2BAA2B,EAAE,CAAC;YAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,OAAO,CACL,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAC9B,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBACpC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CACxC,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CACL,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,CAAC,CACjG,CAAC;AACJ,CAAC,CAAC"}

package/dist/errors/storage-relayed.error.d.ts

@@ -0,0 +1,15 @@
+import { BaseApiError, type GrpcStatus } from '@volontariapp/errors';
+import type { GrpcStatusError } from '../interfaces/index.js';
+export interface StorageErrorBody {
+    statusCode: number;
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export declare class StorageRelayedError extends BaseApiError {
+    readonly statusCode: number;
+    readonly grpcCode: GrpcStatus;
+    constructor(body: StorageErrorBody, grpcCode: GrpcStatus);
+}
+export declare const relayStorageError: (error: GrpcStatusError) => StorageRelayedError | undefined;
+//# sourceMappingURL=storage-relayed.error.d.ts.map

package/dist/errors/storage-relayed.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-relayed.error.d.ts","sourceRoot":"","sources":["../../src/errors/storage-relayed.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAiCD,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,QAAQ,EAAE,UAAU,CAAC;gBAEzB,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU;CAKzD;AAGD,eAAO,MAAM,iBAAiB,UAAW,eAAe,KAAG,mBAAmB,GAAG,SAGhF,CAAC"}

package/dist/errors/storage-relayed.error.js

@@ -0,0 +1,38 @@
+import { BaseApiError } from '@volontariapp/errors';
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const parseBody = (raw) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(parsed) ||
+        typeof parsed['statusCode'] !== 'number' ||
+        typeof parsed['code'] !== 'string' ||
+        typeof parsed['message'] !== 'string') {
+        return undefined;
+    }
+    const details = parsed['details'];
+    return {
+        statusCode: parsed['statusCode'],
+        code: parsed['code'],
+        message: parsed['message'],
+        ...(isRecord(details) ? { details } : {}),
+    };
+};
+export class StorageRelayedError extends BaseApiError {
+    statusCode;
+    grpcCode;
+    constructor(body, grpcCode) {
+        super(body.message, body.code, body.details);
+        this.statusCode = body.statusCode;
+        this.grpcCode = grpcCode;
+    }
+}
+export const relayStorageError = (error) => {
+    const body = parseBody(error.details);
+    return body === undefined ? undefined : new StorageRelayedError(body, error.code);
+};
+//# sourceMappingURL=storage-relayed.error.js.map

package/dist/errors/storage-relayed.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-relayed.error.js","sourceRoot":"","sources":["../../src/errors/storage-relayed.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmB,MAAM,sBAAsB,CAAC;AAWrE,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,MAAM,SAAS,GAAG,CAAC,GAAW,EAAgC,EAAE;IAC9D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IACE,CAAC,QAAQ,CAAC,MAAM,CAAC;QACjB,OAAO,MAAM,CAAC,YAAY,CAAC,KAAK,QAAQ;QACxC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ;QAClC,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ,EACrC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;QAC1B,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC,CAAC;AAMF,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnC,UAAU,CAAS;IACnB,QAAQ,CAAa;IAErC,YAAY,IAAsB,EAAE,QAAoB;QACtD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAGD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAsB,EAAmC,EAAE;IAC3F,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AACpF,CAAC,CAAC"}

package/dist/errors/storage-unavailable.error.d.ts

@@ -0,0 +1,7 @@
+import { BaseApiError, GrpcStatus } from '@volontariapp/errors';
+export declare class StorageUnavailableError extends BaseApiError {
+    readonly statusCode = 503;
+    readonly grpcCode = GrpcStatus.UNAVAILABLE;
+    constructor(entityId: string);
+}
+//# sourceMappingURL=storage-unavailable.error.d.ts.map

package/dist/errors/storage-unavailable.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-unavailable.error.d.ts","sourceRoot":"","sources":["../../src/errors/storage-unavailable.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMhE,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,SAAgB,UAAU,OAAO;IACjC,SAAgB,QAAQ,0BAA0B;gBAEtC,QAAQ,EAAE,MAAM;CAK7B"}

package/dist/errors/storage-unavailable.error.js

@@ -0,0 +1,11 @@
+import { BaseApiError, GrpcStatus } from '@volontariapp/errors';
+export class StorageUnavailableError extends BaseApiError {
+    statusCode = 503;
+    grpcCode = GrpcStatus.UNAVAILABLE;
+    constructor(entityId) {
+        super(`Storage service is unavailable for entity ${entityId}`, 'STORAGE_UNAVAILABLE', {
+            entityId,
+        });
+    }
+}
+//# sourceMappingURL=storage-unavailable.error.js.map

package/dist/errors/storage-unavailable.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-unavailable.error.js","sourceRoot":"","sources":["../../src/errors/storage-unavailable.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMhE,MAAM,OAAO,uBAAwB,SAAQ,YAAY;IACvC,UAAU,GAAG,GAAG,CAAC;IACjB,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC;IAElD,YAAY,QAAgB;QAC1B,KAAK,CAAC,6CAA6C,QAAQ,EAAE,EAAE,qBAAqB,EAAE;YACpF,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -1 +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"}
+{"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;IA0CnC,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

@@ -16,10 +16,10 @@ 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 { GrpcStatus, 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';
+import { isGrpcError, relayStorageError } from '../errors/index.js';
 let StorageClientService = StorageClientService_1 = class StorageClientService {
     clientGrpc;
     defaultOptions;
@@ -51,7 +51,16 @@ let StorageClientService = StorageClientService_1 = class StorageClientService {
                 throw error;
             }
             const grpcErr = isGrpcError(error) ? error : undefined;
-            const message = grpcErr?.details ?? (error instanceof Error ? error.message : String(error));
+            const relayed = grpcErr === undefined ? undefined : relayStorageError(grpcErr);
+            if (relayed !== undefined) {
+                this.logger.warn(`ConfirmFileAttachment refused for entity ${command.entityId}: ${relayed.code}`);
+                throw relayed;
+            }
+            const message = grpcErr === undefined
+                ? error instanceof Error
+                    ? error.message
+                    : String(error)
+                : `${GrpcStatus[grpcErr.code] ?? String(grpcErr.code)}: ${grpcErr.details}`;
             this.logger.error(`ConfirmFileAttachment failed for entity ${command.entityId}: ${message}`);
             throw STORAGE_ATTACHMENT_FAILED(command.entityId, message);
         }

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

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

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

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

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

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

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

@@ -0,0 +1,124 @@
+import 'reflect-metadata';
+import { jest, describe, it, expect, beforeEach } from '@jest/globals';
+import { throwError } from 'rxjs';
+import { GrpcStatus, isBaseApiError } from '@volontariapp/errors';
+import { EntityType, STORAGE_ATTACHMENT_FAILED, STORAGE_TIMEOUT, StorageClientService, StorageUnavailableError, isStorageUnavailable, } from '../index.js';
+const command = {
+    entityId: 'user-1',
+    entityType: EntityType.ENTITY_TYPE_USER_AVATAR,
+    fileIds: ['avatar-file-1'],
+};
+const wireError = (grpcCode, body) => ({
+    code: grpcCode,
+    details: JSON.stringify({ timestamp: '2026-10-16T10:00:00.000Z', ...body }),
+    message: `${String(grpcCode)} ERROR`,
+});
+describe('StorageClientService error mapping (Unit)', () => {
+    let service;
+    let confirmFileAttachment;
+    const failWith = (error) => {
+        confirmFileAttachment.mockReturnValue(throwError(() => error));
+    };
+    beforeEach(() => {
+        confirmFileAttachment = jest.fn();
+        const clientGrpc = {
+            getService: () => ({ confirmFileAttachment }),
+            getClientByServiceName: () => ({}),
+        };
+        service = new StorageClientService(clientGrpc, { timeoutMs: 1000 });
+        service.onModuleInit();
+    });
+    describe('errors raised by ms-storage (JSON body in details)', () => {
+        it('relays a not found file with its status and code', async () => {
+            failWith(wireError(GrpcStatus.NOT_FOUND, {
+                statusCode: 404,
+                code: 'FILE_NOT_FOUND',
+                message: "File with ID 'avatar-file-1' was not found.",
+                details: { fileId: 'avatar-file-1' },
+            }));
+            const error = await service.confirmFileAttachment(command).catch((e) => e);
+            expect(isBaseApiError(error)).toBe(true);
+            expect(error).toMatchObject({
+                statusCode: 404,
+                grpcCode: GrpcStatus.NOT_FOUND,
+                code: 'FILE_NOT_FOUND',
+                message: "File with ID 'avatar-file-1' was not found.",
+                details: { fileId: 'avatar-file-1' },
+            });
+        });
+        it('relays a refused attachment as 422', async () => {
+            failWith(wireError(GrpcStatus.FAILED_PRECONDITION, {
+                statusCode: 422,
+                code: 'FILE_ATTACHMENT_REFUSED',
+                message: 'File already reserved for another entity.',
+            }));
+            await expect(service.confirmFileAttachment(command)).rejects.toMatchObject({
+                statusCode: 422,
+                grpcCode: GrpcStatus.FAILED_PRECONDITION,
+                code: 'FILE_ATTACHMENT_REFUSED',
+            });
+        });
+    });
+    describe('failures without a usable body keep their existing error', () => {
+        it.each([
+            ['a plain gRPC error', { code: 5, details: 'File not found', message: '5 NOT_FOUND' }],
+            ['a body that is not JSON', { code: 13, details: '{oops', message: '13 INTERNAL' }],
+            [
+                'a JSON body without a status code',
+                { code: 13, details: JSON.stringify({ message: 'boom' }), message: '13 INTERNAL' },
+            ],
+            [
+                'a transport failure (UNAVAILABLE)',
+                { code: 14, details: 'No connection established', message: '14 UNAVAILABLE' },
+            ],
+        ])('still raises STORAGE_ATTACHMENT_FAILED for %s', async (_label, error) => {
+            failWith(error);
+            await expect(service.confirmFileAttachment(command)).rejects.toMatchObject({
+                statusCode: 500,
+                code: 'STORAGE_ATTACHMENT_FAILED',
+            });
+        });
+    });
+    it('keeps the transport reason readable for the consumers that fall back', async () => {
+        failWith({ code: 14, details: 'No connection established', message: '14 UNAVAILABLE' });
+        const error = await service.confirmFileAttachment(command).catch((e) => e);
+        expect(isStorageUnavailable(error)).toBe(true);
+    });
+});
+describe('isStorageUnavailable', () => {
+    it.each([
+        ['a timeout', STORAGE_TIMEOUT('user-1', 2000)],
+        [
+            'an UNAVAILABLE failure',
+            STORAGE_ATTACHMENT_FAILED('user-1', '14 UNAVAILABLE: no connection'),
+        ],
+        ['a DEADLINE_EXCEEDED failure', STORAGE_ATTACHMENT_FAILED('user-1', 'DEADLINE_EXCEEDED')],
+        ['a refused connection', STORAGE_ATTACHMENT_FAILED('user-1', 'connect ECONNREFUSED 10.0.0.1')],
+        ['a raw UNAVAILABLE gRPC error', { code: 14, details: 'down', message: 'down' }],
+        ['a raw DEADLINE_EXCEEDED gRPC error', { code: 4, details: 'slow', message: 'slow' }],
+    ])('is true for %s', (_label, error) => {
+        expect(isStorageUnavailable(error)).toBe(true);
+    });
+    it.each([
+        ['another attachment failure', STORAGE_ATTACHMENT_FAILED('user-1', 'boom')],
+        ['a plain error', new Error('boom')],
+        ['a gRPC NOT_FOUND error', { code: 5, details: 'File not found', message: 'File not found' }],
+        ['a string', 'UNAVAILABLE'],
+        ['nothing', undefined],
+    ])('is false for %s', (_label, error) => {
+        expect(isStorageUnavailable(error)).toBe(false);
+    });
+});
+describe('StorageUnavailableError', () => {
+    it('is a 503 UNAVAILABLE API error naming the entity', () => {
+        const error = new StorageUnavailableError('user-1');
+        expect(isBaseApiError(error)).toBe(true);
+        expect(error).toMatchObject({
+            statusCode: 503,
+            grpcCode: GrpcStatus.UNAVAILABLE,
+            code: 'STORAGE_UNAVAILABLE',
+        });
+        expect(error.message).toContain('user-1');
+    });
+});
+//# sourceMappingURL=storage-client-errors.unit.spec.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volontariapp/storage-client",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "publishConfig": {
     "access": "public",
     "provenance": true