@qnsp/storage-sdk 0.0.1

package/dist/index.js

@@ -0,0 +1,398 @@
+import { performance } from "node:perf_hooks";
+import { createStorageClientTelemetry, isStorageClientTelemetry } from "./observability.js";
+export class StorageClient {
+    config;
+    telemetry;
+    targetService;
+    constructor(config) {
+        this.config = {
+            baseUrl: config.baseUrl.replace(/\/$/, ""),
+            apiKey: config.apiKey ?? "",
+            tenantId: config.tenantId,
+            timeoutMs: config.timeoutMs ?? 30_000,
+        };
+        this.telemetry = config.telemetry
+            ? isStorageClientTelemetry(config.telemetry)
+                ? config.telemetry
+                : createStorageClientTelemetry(config.telemetry)
+            : null;
+        try {
+            this.targetService = new URL(this.config.baseUrl).host;
+        }
+        catch {
+            this.targetService = "storage-service";
+        }
+    }
+    async request(method, path, options) {
+        const url = `${this.config.baseUrl}${path}`;
+        const headers = {
+            "Content-Type": "application/json",
+            ...options?.headers,
+        };
+        if (this.config.apiKey) {
+            headers["Authorization"] = `Bearer ${this.config.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeoutMs);
+        const signal = options?.signal ?? controller.signal;
+        const route = options?.telemetryRoute ?? new URL(path, this.config.baseUrl).pathname;
+        const target = options?.telemetryTarget ?? this.targetService;
+        const start = performance.now();
+        let status = "ok";
+        let httpStatus;
+        let errorMessage;
+        try {
+            const init = {
+                method,
+                headers,
+                signal,
+            };
+            if (options?.body !== undefined) {
+                init.body = JSON.stringify(options.body);
+            }
+            const response = await fetch(url, init);
+            clearTimeout(timeoutId);
+            httpStatus = response.status;
+            if (!response.ok) {
+                status = "error";
+                const errorText = await response.text().catch(() => "Unknown error");
+                errorMessage = errorText;
+                throw new Error(`Storage API error: ${response.status} ${response.statusText} - ${errorText}`);
+            }
+            if (response.status === 204) {
+                return undefined;
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            status = "error";
+            if (!errorMessage && error instanceof Error) {
+                errorMessage = error.message;
+            }
+            if (error instanceof Error && error.name === "AbortError") {
+                errorMessage = `timeout after ${this.config.timeoutMs}ms`;
+                throw new Error(`Request timeout after ${this.config.timeoutMs}ms`);
+            }
+            throw error;
+        }
+        finally {
+            const durationMs = performance.now() - start;
+            const event = {
+                operation: options?.operation ?? `${method} ${route}`,
+                method,
+                route,
+                target,
+                status,
+                durationMs,
+                ...(typeof httpStatus === "number" ? { httpStatus } : {}),
+                ...(status === "error" && errorMessage ? { error: errorMessage } : {}),
+            };
+            this.recordTelemetryEvent(event);
+        }
+    }
+    async initiateUpload(options) {
+        return this.request("POST", "/storage/v1/documents", {
+            body: {
+                name: options.name,
+                mimeType: options.mimeType,
+                sizeBytes: options.sizeBytes,
+                classification: options.classification ?? "confidential",
+                metadata: options.metadata ?? {},
+                tags: options.tags ?? [],
+                retentionPolicy: options.retentionPolicy,
+            },
+            operation: "initiateUpload",
+        });
+    }
+    async uploadPart(uploadId, partId, data) {
+        const url = `${this.config.baseUrl}/storage/v1/uploads/${uploadId}/parts/${partId}`;
+        const headers = {
+            "Content-Type": "application/octet-stream",
+        };
+        if (this.config.apiKey) {
+            headers["Authorization"] = `Bearer ${this.config.apiKey}`;
+        }
+        const bytesSent = data instanceof Buffer || data instanceof Uint8Array ? data.byteLength : undefined;
+        const route = "/storage/v1/uploads/:uploadId/parts/:partId";
+        const start = performance.now();
+        let status = "ok";
+        let httpStatus;
+        let errorMessage;
+        const body = data instanceof ReadableStream
+            ? data
+            : data instanceof Buffer
+                ? new ReadableStream({
+                    start(controller) {
+                        controller.enqueue(new Uint8Array(data));
+                        controller.close();
+                    },
+                })
+                : new ReadableStream({
+                    start(controller) {
+                        controller.enqueue(data);
+                        controller.close();
+                    },
+                });
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method: "PUT",
+                headers,
+                body,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            httpStatus = response.status;
+            if (!response.ok) {
+                status = "error";
+                const errorText = await response.text().catch(() => "Unknown error");
+                errorMessage = errorText;
+                throw new Error(`Upload part error: ${response.status} ${response.statusText} - ${errorText}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            status = "error";
+            if (!errorMessage && error instanceof Error) {
+                errorMessage = error.message;
+            }
+            if (error instanceof Error && error.name === "AbortError") {
+                errorMessage = `timeout after ${this.config.timeoutMs}ms`;
+                throw new Error(`Request timeout after ${this.config.timeoutMs}ms`);
+            }
+            throw error;
+        }
+        finally {
+            const durationMs = performance.now() - start;
+            const event = {
+                operation: "uploadPart",
+                method: "PUT",
+                route,
+                target: this.targetService,
+                status,
+                durationMs,
+                ...(typeof httpStatus === "number" ? { httpStatus } : {}),
+                ...(status === "error" && errorMessage ? { error: errorMessage } : {}),
+                ...(typeof bytesSent === "number" ? { bytesSent } : {}),
+            };
+            this.recordTelemetryEvent(event);
+        }
+    }
+    async getUploadStatus(uploadId) {
+        // Use GET since we need the full status object
+        return this.request("GET", `/storage/v1/uploads/${uploadId}`, {
+            operation: "getUploadStatus",
+            telemetryRoute: "/storage/v1/uploads/:uploadId",
+        });
+    }
+    async completeUpload(uploadId) {
+        return this.request("POST", `/storage/v1/uploads/${uploadId}/complete`, {
+            operation: "completeUpload",
+            telemetryRoute: "/storage/v1/uploads/:uploadId/complete",
+        });
+    }
+    async getDownloadDescriptor(documentId, version, options) {
+        const params = new URLSearchParams({
+            tenantId: this.config.tenantId,
+        });
+        if (options?.token) {
+            params.set("token", options.token);
+        }
+        if (options?.expiresAt) {
+            params.set("expiresAt", String(options.expiresAt));
+        }
+        if (options?.signature) {
+            params.set("signature", options.signature);
+        }
+        return this.request("GET", `/storage/v1/documents/${documentId}/versions/${version}/download?${params}`, {
+            operation: "getDownloadDescriptor",
+            telemetryRoute: "/storage/v1/documents/:documentId/versions/:version/download",
+        });
+    }
+    async downloadStream(documentId, version, options) {
+        const params = new URLSearchParams({
+            tenantId: this.config.tenantId,
+        });
+        if (options?.token) {
+            params.set("token", options.token);
+        }
+        if (options?.expiresAt) {
+            params.set("expiresAt", String(options.expiresAt));
+        }
+        if (options?.signature) {
+            params.set("signature", options.signature);
+        }
+        if (options?.range) {
+            params.set("range", options.range);
+        }
+        const url = `${this.config.baseUrl}/storage/v1/documents/${documentId}/versions/${version}/content?${params}`;
+        const headers = {};
+        if (options?.range) {
+            headers["Range"] = options.range;
+        }
+        if (this.config.apiKey) {
+            headers["Authorization"] = `Bearer ${this.config.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeoutMs);
+        const route = "/storage/v1/documents/:documentId/versions/:version/content";
+        const start = performance.now();
+        let status = "ok";
+        let httpStatus;
+        let errorMessage;
+        let bytesReceived;
+        try {
+            const response = await fetch(url, {
+                method: "GET",
+                headers,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            httpStatus = response.status;
+            if (!response.ok) {
+                status = "error";
+                const errorText = await response.text().catch(() => "Unknown error");
+                errorMessage = errorText;
+                throw new Error(`Download error: ${response.status} ${response.statusText} - ${errorText}`);
+            }
+            const contentRange = response.headers.get("Content-Range");
+            const rangeMatch = contentRange?.startsWith("bytes ")
+                ? contentRange.match(/bytes (\d+)-(\d+)\/(\d+)/)
+                : null;
+            const parsedRange = rangeMatch?.[1] && rangeMatch[2]
+                ? {
+                    start: Number.parseInt(rangeMatch[1], 10),
+                    end: Number.parseInt(rangeMatch[2], 10),
+                }
+                : undefined;
+            const totalSize = rangeMatch?.[3]
+                ? Number.parseInt(rangeMatch[3], 10)
+                : Number.parseInt(response.headers.get("X-Total-Size") ?? "0", 10);
+            const contentLength = Number.parseInt(response.headers.get("Content-Length") ?? "0", 10);
+            const checksumSha3 = response.headers.get("X-Checksum-Sha3") ?? "";
+            const stream = response.body ??
+                new ReadableStream({
+                    start(controller) {
+                        controller.close();
+                    },
+                });
+            bytesReceived = contentLength > 0 ? contentLength : totalSize > 0 ? totalSize : undefined;
+            const statusCode = (response.status === 206 ? 206 : 200);
+            return {
+                stream,
+                statusCode,
+                totalSize: totalSize > 0 ? totalSize : contentLength,
+                contentLength: contentLength > 0 ? contentLength : totalSize,
+                checksumSha3,
+                ...(parsedRange ? { range: parsedRange } : {}),
+            };
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            status = "error";
+            if (!errorMessage && error instanceof Error) {
+                errorMessage = error.message;
+            }
+            if (error instanceof Error && error.name === "AbortError") {
+                errorMessage = `timeout after ${this.config.timeoutMs}ms`;
+                throw new Error(`Request timeout after ${this.config.timeoutMs}ms`);
+            }
+            throw error;
+        }
+        finally {
+            const durationMs = performance.now() - start;
+            const event = {
+                operation: "downloadStream",
+                method: "GET",
+                route,
+                target: this.targetService,
+                status,
+                durationMs,
+                ...(typeof httpStatus === "number" ? { httpStatus } : {}),
+                ...(status === "error" && errorMessage ? { error: errorMessage } : {}),
+                ...(typeof bytesReceived === "number" ? { bytesReceived } : {}),
+            };
+            this.recordTelemetryEvent(event);
+        }
+    }
+    /**
+     * Retrieve document policies (compliance + lifecycle summary).
+     * Requires x-tenant-id header.
+     */
+    async getDocumentPolicies(documentId) {
+        return this.request("GET", `/storage/v1/documents/${documentId}/policies`, {
+            operation: "getDocumentPolicies",
+            telemetryRoute: "/storage/v1/documents/:documentId/policies",
+            headers: {
+                "x-tenant-id": this.config.tenantId,
+            },
+        });
+    }
+    /**
+     * Update document retention/WORM/legal hold list atomically.
+     * Requires x-tenant-id header.
+     */
+    async updateDocumentPolicies(documentId, input) {
+        return this.request("PATCH", `/storage/v1/documents/${documentId}/policies`, {
+            body: input,
+            operation: "updateDocumentPolicies",
+            telemetryRoute: "/storage/v1/documents/:documentId/policies",
+            headers: {
+                "x-tenant-id": this.config.tenantId,
+            },
+        });
+    }
+    /**
+     * Apply a legal hold by id. Hold ids are caller-defined.
+     * Requires x-tenant-id header.
+     */
+    async applyLegalHold(documentId, request) {
+        return this.request("POST", `/storage/v1/documents/${documentId}/legal-holds`, {
+            body: request,
+            operation: "applyLegalHold",
+            telemetryRoute: "/storage/v1/documents/:documentId/legal-holds",
+            headers: {
+                "x-tenant-id": this.config.tenantId,
+            },
+        });
+    }
+    /**
+     * Release a legal hold by id.
+     * Requires x-tenant-id header.
+     */
+    async releaseLegalHold(documentId, holdId) {
+        return this.request("DELETE", `/storage/v1/documents/${documentId}/legal-holds/${holdId}`, {
+            operation: "releaseLegalHold",
+            telemetryRoute: "/storage/v1/documents/:documentId/legal-holds/:holdId",
+            headers: {
+                "x-tenant-id": this.config.tenantId,
+            },
+        });
+    }
+    /**
+     * Schedule a lifecycle tier transition for a document.
+     * Requires x-tenant-id header.
+     */
+    async scheduleLifecycleTransition(documentId, request) {
+        return this.request("POST", `/storage/v1/documents/${documentId}/lifecycle/transitions`, {
+            body: request,
+            operation: "scheduleLifecycleTransition",
+            telemetryRoute: "/storage/v1/documents/:documentId/lifecycle/transitions",
+            headers: {
+                "x-tenant-id": this.config.tenantId,
+            },
+        });
+    }
+    recordTelemetryEvent(event) {
+        if (!this.telemetry) {
+            return;
+        }
+        this.telemetry.record(event);
+    }
+}
+export * from "./events.js";
+export * from "./observability.js";
+//# 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,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAO9C,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AA+I5F,MAAM,OAAO,aAAa;IACR,MAAM,CAA8B;IACpC,SAAS,CAAgC;IACzC,aAAa,CAAS;IAEvC,YAAY,MAA2B;QACtC,IAAI,CAAC,MAAM,GAAG;YACb,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM;SACrC,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS;YAChC,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,SAAS,CAAC;gBAC3C,CAAC,CAAC,MAAM,CAAC,SAAS;gBAClB,CAAC,CAAC,4BAA4B,CAAC,MAAM,CAAC,SAAS,CAAC;YACjD,CAAC,CAAC,IAAI,CAAC;QAER,IAAI,CAAC;YACJ,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC,aAAa,GAAG,iBAAiB,CAAC;QACxC,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,OAAO,CAAI,MAAc,EAAE,IAAY,EAAE,OAAwB;QAC9E,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QAC5C,MAAM,OAAO,GAA2B;YACvC,cAAc,EAAE,kBAAkB;YAClC,GAAG,OAAO,EAAE,OAAO;SACnB,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC3D,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC;QACpD,MAAM,KAAK,GAAG,OAAO,EAAE,cAAc,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC;QACrF,MAAM,MAAM,GAAG,OAAO,EAAE,eAAe,IAAI,IAAI,CAAC,aAAa,CAAC;QAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,IAAI,MAAM,GAAmB,IAAI,CAAC;QAClC,IAAI,UAA8B,CAAC;QACnC,IAAI,YAAgC,CAAC;QAErC,IAAI,CAAC;YACJ,MAAM,IAAI,GAAgB;gBACzB,MAAM;gBACN,OAAO;gBACP,MAAM;aACN,CAAC;YAEF,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1C,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAExC,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;YAE7B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAClB,MAAM,GAAG,OAAO,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;gBACrE,YAAY,GAAG,SAAS,CAAC;gBACzB,MAAM,IAAI,KAAK,CACd,sBAAsB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,SAAS,EAAE,CAC7E,CAAC;YACH,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,SAAc,CAAC;YACvB,CAAC;YAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM,GAAG,OAAO,CAAC;YACjB,IAAI,CAAC,YAAY,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC7C,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9B,CAAC;YACD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC3D,YAAY,GAAG,iBAAiB,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,KAAK,CAAC;QACb,CAAC;gBAAS,CAAC;YACV,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAC7C,MAAM,KAAK,GAAgC;gBAC1C,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,GAAG,MAAM,IAAI,KAAK,EAAE;gBACrD,MAAM;gBACN,KAAK;gBACL,MAAM;gBACN,MAAM;gBACN,UAAU;gBACV,GAAG,CAAC,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,MAAM,KAAK,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtE,CAAC;YACF,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACF,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAA8B;QAelD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE;YACpD,IAAI,EAAE;gBACL,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,cAAc;gBACxD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;gBAChC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;gBACxB,eAAe,EAAE,OAAO,CAAC,eAAe;aACxC;YACD,SAAS,EAAE,gBAAgB;SAC3B,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CACf,QAAgB,EAChB,MAAc,EACd,IAAsD;QAEtD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,uBAAuB,QAAQ,UAAU,MAAM,EAAE,CAAC;QACpF,MAAM,OAAO,GAA2B;YACvC,cAAc,EAAE,0BAA0B;SAC1C,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC3D,CAAC;QAED,MAAM,SAAS,GACd,IAAI,YAAY,MAAM,IAAI,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,MAAM,KAAK,GAAG,6CAA6C,CAAC;QAC5D,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,IAAI,MAAM,GAAmB,IAAI,CAAC;QAClC,IAAI,UAA8B,CAAC;QACnC,IAAI,YAAgC,CAAC;QAErC,MAAM,IAAI,GACT,IAAI,YAAY,cAAc;YAC7B,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAI,YAAY,MAAM;gBACvB,CAAC,CAAC,IAAI,cAAc,CAAC;oBACnB,KAAK,CAAC,UAAU;wBACf,UAAU,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;wBACzC,UAAU,CAAC,KAAK,EAAE,CAAC;oBACpB,CAAC;iBACD,CAAC;gBACH,CAAC,CAAC,IAAI,cAAc,CAAC;oBACnB,KAAK,CAAC,UAAU;wBACf,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;wBACzB,UAAU,CAAC,KAAK,EAAE,CAAC;oBACpB,CAAC;iBACD,CAAC,CAAC;QAEP,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE9E,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBACjC,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,IAAI;gBACJ,MAAM,EAAE,UAAU,CAAC,MAAM;aACzB,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;YAE7B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAClB,MAAM,GAAG,OAAO,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;gBACrE,YAAY,GAAG,SAAS,CAAC;gBACzB,MAAM,IAAI,KAAK,CACd,sBAAsB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,SAAS,EAAE,CAC7E,CAAC;YACH,CAAC;YAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAqB,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM,GAAG,OAAO,CAAC;YACjB,IAAI,CAAC,YAAY,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC7C,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9B,CAAC;YACD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC3D,YAAY,GAAG,iBAAiB,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,KAAK,CAAC;QACb,CAAC;gBAAS,CAAC;YACV,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAC7C,MAAM,KAAK,GAAgC;gBAC1C,SAAS,EAAE,YAAY;gBACvB,MAAM,EAAE,KAAK;gBACb,KAAK;gBACL,MAAM,EAAE,IAAI,CAAC,aAAa;gBAC1B,MAAM;gBACN,UAAU;gBACV,GAAG,CAAC,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,MAAM,KAAK,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtE,GAAG,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD,CAAC;YACF,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACF,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAgB;QACrC,+CAA+C;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAe,KAAK,EAAE,uBAAuB,QAAQ,EAAE,EAAE;YAC3E,SAAS,EAAE,iBAAiB;YAC5B,cAAc,EAAE,+BAA+B;SAC/C,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAgB;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,uBAAuB,QAAQ,WAAW,EAAE;YACvE,SAAS,EAAE,gBAAgB;YAC3B,cAAc,EAAE,wCAAwC;SACxD,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,qBAAqB,CAC1B,UAAkB,EAClB,OAAe,EACf,OAIC;QAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YAClC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;SAC9B,CAAC,CAAC;QAEH,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAClB,KAAK,EACL,yBAAyB,UAAU,aAAa,OAAO,aAAa,MAAM,EAAE,EAC5E;YACC,SAAS,EAAE,uBAAuB;YAClC,cAAc,EAAE,8DAA8D;SAC9E,CACD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CACnB,UAAkB,EAClB,OAAe,EACf,OAKC;QASD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YAClC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;SAC9B,CAAC,CAAC;QAEH,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,yBAAyB,UAAU,aAAa,OAAO,YAAY,MAAM,EAAE,CAAC;QAC9G,MAAM,OAAO,GAA2B,EAAE,CAAC;QAE3C,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACpB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QAClC,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC3D,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9E,MAAM,KAAK,GAAG,6DAA6D,CAAC;QAC5E,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,IAAI,MAAM,GAAmB,IAAI,CAAC;QAClC,IAAI,UAA8B,CAAC;QACnC,IAAI,YAAgC,CAAC;QACrC,IAAI,aAAiC,CAAC;QAEtC,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBACjC,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,MAAM,EAAE,UAAU,CAAC,MAAM;aACzB,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;YAE7B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAClB,MAAM,GAAG,OAAO,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;gBACrE,YAAY,GAAG,SAAS,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,SAAS,EAAE,CAAC,CAAC;YAC7F,CAAC;YAED,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC3D,MAAM,UAAU,GAAG,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC;gBACpD,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,0BAA0B,CAAC;gBAChD,CAAC,CAAC,IAAI,CAAC;YAER,MAAM,WAAW,GAChB,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC;gBAC/B,CAAC,CAAC;oBACA,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACzC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;iBACvC;gBACF,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC;gBAChC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACpC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;YACpE,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;YACzF,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;YAEnE,MAAM,MAAM,GACX,QAAQ,CAAC,IAAI;gBACb,IAAI,cAAc,CAAa;oBAC9B,KAAK,CAAC,UAAU;wBACf,UAAU,CAAC,KAAK,EAAE,CAAC;oBACpB,CAAC;iBACD,CAAC,CAAC;YAEJ,aAAa,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YAE1F,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAc,CAAC;YAEtE,OAAO;gBACN,MAAM;gBACN,UAAU;gBACV,SAAS,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa;gBACpD,aAAa,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;gBAC5D,YAAY;gBACZ,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM,GAAG,OAAO,CAAC;YACjB,IAAI,CAAC,YAAY,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC7C,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9B,CAAC;YACD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC3D,YAAY,GAAG,iBAAiB,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,KAAK,CAAC;QACb,CAAC;gBAAS,CAAC;YACV,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAC7C,MAAM,KAAK,GAAgC;gBAC1C,SAAS,EAAE,gBAAgB;gBAC3B,MAAM,EAAE,KAAK;gBACb,KAAK;gBACL,MAAM,EAAE,IAAI,CAAC,aAAa;gBAC1B,MAAM;gBACN,UAAU;gBACV,GAAG,CAAC,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,MAAM,KAAK,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtE,GAAG,CAAC,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC;YACF,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,UAAkB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,yBAAyB,UAAU,WAAW,EAAE;YAC1E,SAAS,EAAE,qBAAqB;YAChC,cAAc,EAAE,4CAA4C;YAC5D,OAAO,EAAE;gBACR,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;aACnC;SACD,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,sBAAsB,CAC3B,UAAkB,EAClB,KAA4B;QAE5B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,yBAAyB,UAAU,WAAW,EAAE;YAC5E,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,wBAAwB;YACnC,cAAc,EAAE,4CAA4C;YAC5D,OAAO,EAAE;gBACR,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;aACnC;SACD,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CACnB,UAAkB,EAClB,OAA8B;QAM9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,yBAAyB,UAAU,cAAc,EAAE;YAC9E,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,gBAAgB;YAC3B,cAAc,EAAE,+CAA+C;YAC/D,OAAO,EAAE;gBACR,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;aACnC;SACD,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAAC,UAAkB,EAAE,MAAc;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,yBAAyB,UAAU,gBAAgB,MAAM,EAAE,EAAE;YAC1F,SAAS,EAAE,kBAAkB;YAC7B,cAAc,EAAE,uDAAuD;YACvE,OAAO,EAAE;gBACR,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;aACnC;SACD,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,2BAA2B,CAChC,UAAkB,EAClB,OAAkC;QAUlC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,yBAAyB,UAAU,wBAAwB,EAAE;YACxF,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,6BAA6B;YACxC,cAAc,EAAE,yDAAyD;YACzE,OAAO,EAAE;gBACR,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;aACnC;SACD,CAAC,CAAC;IACJ,CAAC;IAEO,oBAAoB,CAAC,KAAkC;QAC9D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,OAAO;QACR,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACD;AAED,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/observability.d.ts

@@ -0,0 +1,28 @@
+import type { MetricReader } from "@opentelemetry/sdk-metrics";
+export interface StorageClientTelemetryConfig {
+    readonly serviceName: string;
+    readonly serviceVersion?: string;
+    readonly environment?: string;
+    readonly otlpEndpoint?: string;
+    readonly metricsIntervalMs?: number;
+    readonly metricsTimeoutMs?: number;
+    readonly exporterFactory?: () => MetricReader;
+}
+export interface StorageClientTelemetryEvent {
+    readonly operation: string;
+    readonly method: string;
+    readonly route: string;
+    readonly status: "ok" | "error";
+    readonly durationMs: number;
+    readonly httpStatus?: number;
+    readonly target?: string;
+    readonly error?: string;
+    readonly bytesSent?: number;
+    readonly bytesReceived?: number;
+}
+export interface StorageClientTelemetry {
+    record(event: StorageClientTelemetryEvent): void;
+}
+export declare function createStorageClientTelemetry(config: StorageClientTelemetryConfig): StorageClientTelemetry;
+export declare function isStorageClientTelemetry(value: StorageClientTelemetry | StorageClientTelemetryConfig): value is StorageClientTelemetry;
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAS/D,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,YAAY,CAAC;CAC9C;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACtC,MAAM,CAAC,KAAK,EAAE,2BAA2B,GAAG,IAAI,CAAC;CACjD;AAED,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,4BAA4B,GAClC,sBAAsB,CAwFxB;AAED,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,sBAAsB,GAAG,4BAA4B,GAC1D,KAAK,IAAI,sBAAsB,CAEjC"}

package/dist/observability.js

@@ -0,0 +1,82 @@
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import { ConsoleMetricExporter, createCounter, createHistogram, createMeterProvider, PeriodicExportingMetricReader, } from "@qnsp/observability";
+export function createStorageClientTelemetry(config) {
+    const interval = config.metricsIntervalMs ?? 60_000;
+    const timeout = config.metricsTimeoutMs ?? 15_000;
+    const readers = [];
+    if (typeof config.exporterFactory === "function") {
+        readers.push(config.exporterFactory());
+    }
+    else if (config.otlpEndpoint) {
+        readers.push(new PeriodicExportingMetricReader({
+            exporter: new OTLPMetricExporter({
+                url: config.otlpEndpoint,
+            }),
+            exportIntervalMillis: interval,
+            exportTimeoutMillis: timeout,
+        }));
+    }
+    else if (process.env["NODE_ENV"] !== "test") {
+        readers.push(new PeriodicExportingMetricReader({
+            exporter: new ConsoleMetricExporter(),
+            exportIntervalMillis: interval,
+            exportTimeoutMillis: timeout,
+        }));
+    }
+    const provider = createMeterProvider({
+        serviceName: config.serviceName,
+        serviceVersion: config.serviceVersion ?? "0.0.0",
+        environment: config.environment ?? process.env["NODE_ENV"] ?? "development",
+    }, readers);
+    const requestCounter = createCounter(provider, "storage_sdk_requests_total", {
+        description: "Count of Storage SDK HTTP requests",
+    });
+    const failureCounter = createCounter(provider, "storage_sdk_request_failures_total", {
+        description: "Count of failed Storage SDK HTTP requests",
+    });
+    const durationHistogram = createHistogram(provider, "storage_sdk_request_duration_ms", {
+        description: "Latency of Storage SDK HTTP requests",
+        unit: "ms",
+    });
+    const bytesCounter = createCounter(provider, "storage_sdk_bytes_total", {
+        description: "Bytes sent or received by the Storage SDK",
+        unit: "By",
+    });
+    return {
+        record(event) {
+            const baseAttributes = {
+                service: config.serviceName,
+                operation: event.operation,
+                method: event.method,
+                route: event.route,
+                target: event.target ?? event.route,
+                status: event.status,
+                ...(event.httpStatus ? { http_status: event.httpStatus } : {}),
+            };
+            requestCounter.add(1, baseAttributes);
+            durationHistogram.record(event.durationMs, baseAttributes);
+            if (event.status === "error") {
+                failureCounter.add(1, {
+                    ...baseAttributes,
+                    error: event.error ?? "unknown",
+                });
+            }
+            if (typeof event.bytesSent === "number") {
+                bytesCounter.add(event.bytesSent, {
+                    ...baseAttributes,
+                    direction: "sent",
+                });
+            }
+            if (typeof event.bytesReceived === "number") {
+                bytesCounter.add(event.bytesReceived, {
+                    ...baseAttributes,
+                    direction: "received",
+                });
+            }
+        },
+    };
+}
+export function isStorageClientTelemetry(value) {
+    return typeof value?.record === "function";
+}
+//# sourceMappingURL=observability.js.map

package/dist/observability.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@qnsp/storage-sdk",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "description": "TypeScript SDK client for the QNSP storage-service API.",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.208.0",
+    "@opentelemetry/sdk-metrics": "^2.2.0",
+    "@qnsp/events": "^0.0.1",
+    "@qnsp/observability": "^0.0.1",
+    "undici": "^7.16.0",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.14",
+    "tsx": "^4.20.6",
+    "vitest": "^4.0.10"
+  },
+  "engines": {
+    "node": "24.12.0"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "dev": "tsx watch src/index.ts",
+    "lint": "biome check .",
+    "test": "vitest run",
+    "typecheck": "tsc --project tsconfig.json --noEmit"
+  }
+}