@fluidframework/runtime-utils 2.60.0 → 2.61.0-355516

package/src/handles.ts

@@ -3,6 +3,10 @@
  * Licensed under the MIT License.
  */
 
+import type {
+	IContainerRuntime,
+	IContainerRuntimeInternal,
+} from "@fluidframework/container-runtime-definitions/internal";
 import type { IFluidHandleErased } from "@fluidframework/core-interfaces";
 import { IFluidHandle, fluidHandleSymbol } from "@fluidframework/core-interfaces";
 import type {
@@ -195,3 +199,52 @@ export abstract class FluidHandleBase<T> implements IFluidHandleInternal<T> {
 		return toFluidHandleErased(this);
 	}
 }
+
+/**
+ * Lookup the blob storage ID for a blob handle.
+ * @param containerRuntime - The container runtime instance
+ * @param handle - The blob handle to lookup the storage ID for
+ * @returns The storage ID if found and the blob is not pending, undefined otherwise
+ * @remarks
+ * This is a legacy+alpha helper function that provides access to blob storage IDs.
+ * For blobs with pending payloads (localId exists but upload hasn't finished), this is expected to return undefined.
+ * Consumers should use the observability APIs on the handle (handle.payloadState, payloadShared event)
+ * to understand/wait for storage ID availability.
+ * Similarly, when the runtime is detached, this will return undefined as no blobs have been uploaded to storage.
+ *
+ * Warning: the returned blob URL may expire and does not support permalinks.
+ * This API is intended for temporary integration scenarios only.
+ * @legacy
+ * @alpha
+ */
+export function lookupTemporaryBlobStorageId(
+	containerRuntime: IContainerRuntime,
+	handle: IFluidHandle,
+): string | undefined {
+	// Verify that the handle points to a blob by checking its path format
+	const absolutePath: string | undefined = toFluidHandleInternal(handle).absolutePath;
+
+	// Blob handles have paths in the format "/_blobs/{localId}"
+	if (!absolutePath?.startsWith("/_blobs/")) {
+		throw new Error(
+			"Handle does not point to a blob - expected path to start with '/_blobs/'",
+		);
+	}
+
+	// Extract the local ID from the path
+	const pathParts = absolutePath.split("/");
+	if (
+		pathParts.length !== 3 ||
+		pathParts[1] !== "_blobs" ||
+		pathParts[2] === undefined ||
+		pathParts[2] === ""
+	) {
+		throw new Error("Invalid blob handle path format");
+	}
+
+	const localId = pathParts[2];
+
+	// Cast the runtime to the internal interface and call the lookup method
+	const internalRuntime = containerRuntime as IContainerRuntimeInternal;
+	return internalRuntime.lookupTemporaryBlobStorageId(localId);
+}

package/src/index.ts

@@ -19,6 +19,7 @@ export {
 	isFluidHandlePayloadPending,
 	isLocalFluidHandle,
 	isSerializedHandle,
+	lookupTemporaryBlobStorageId,
 	toFluidHandleErased,
 	toFluidHandleInternal,
 } from "./handles.js";
@@ -65,6 +66,7 @@ export {
 	getValidationForRuntimeOptions,
 	getConfigsForMinVersionForCollab,
 	isValidMinVersionForCollab,
+	semanticVersionToMinimumVersionForCollab,
 } from "./compatibilityBase.js";
 export type {
 	ConfigMap,

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/runtime-utils";
-export const pkgVersion = "2.60.0";
+export const pkgVersion = "2.61.0-355516";