@hozon/blob 0.1.0 → 0.2.0

package/lib/fresh.d.ts

@@ -0,0 +1,2 @@
+import type { BlobEntry, BlobStoreAPI } from '@hozon/store-blob';
+export declare function getFreshEntry(store: BlobStoreAPI, blobID: string): Promise<BlobEntry | null>;

package/lib/fresh.js

@@ -0,0 +1,6 @@
+// A scope remembers getEntry results; reads made under the blob lock must see the current row.
+export async function getFreshEntry(store, blobID) {
+    return (await store.getEntries([
+        blobID
+    ])).get(blobID) ?? null;
+}

package/lib/index.d.ts

@@ -1,5 +1,6 @@
 export { BlobLockTimeoutError } from '@hozon/blob-backend';
 export { InvalidBlobIDError } from '@hozon/blob-id';
+export { InvalidCursorError } from '@hozon/store-blob';
 export { BlobIDMismatchError, type BlobIDMismatchErrorParams, BlobNotFoundError, BlobTooLargeError, BlobWriteAbortedError, ChunkDigestMismatchError, type ChunkDigestMismatchErrorParams, ChunkLengthError, type ChunkLengthErrorParams, ContentTypeMismatchError, type ContentTypeMismatchErrorParams, InvalidManifestError, InvalidRangeError, TransferIncompleteError, type TransferIncompleteErrorParams, } from './errors.js';
 export { type BlobLimits, DEFAULT_CHUNK_SIZE, DEFAULT_LIMITS } from './limits.js';
 export { type BlobService, type BlobServiceParams, createBlobService } from './service.js';

package/lib/index.js

@@ -1,5 +1,6 @@
 export { BlobLockTimeoutError } from '@hozon/blob-backend';
 export { InvalidBlobIDError } from '@hozon/blob-id';
+export { InvalidCursorError } from '@hozon/store-blob';
 export { BlobIDMismatchError, BlobNotFoundError, BlobTooLargeError, BlobWriteAbortedError, ChunkDigestMismatchError, ChunkLengthError, ContentTypeMismatchError, InvalidManifestError, InvalidRangeError, TransferIncompleteError } from './errors.js';
 export { DEFAULT_CHUNK_SIZE, DEFAULT_LIMITS } from './limits.js';
 export { createBlobService } from './service.js';

package/lib/manage.js

@@ -1,10 +1,11 @@
 import { getBlobStore } from '@hozon/store-blob';
 import { BlobNotFoundError } from './errors.js';
+import { getFreshEntry } from './fresh.js';
 export async function setBlobPinned(ctx, id, pinned) {
     const blobID = ctx.codec.canonicalize(id);
     await ctx.lock.withLock(blobID, async ()=>{
         const store = await getBlobStore(ctx.db);
-        if (await store.getEntry(blobID) === null) throw new BlobNotFoundError(blobID);
+        if (await getFreshEntry(store, blobID) === null) throw new BlobNotFoundError(blobID);
         await store.setPinned(blobID, pinned);
     });
 }
@@ -12,7 +13,7 @@ export async function deleteBlob(ctx, id) {
     const blobID = ctx.codec.canonicalize(id);
     return await ctx.lock.withLock(blobID, async ()=>{
         const store = await getBlobStore(ctx.db);
-        const entry = await store.getEntry(blobID);
+        const entry = await getFreshEntry(store, blobID);
         if (entry === null) return false;
         const transfer = entry.state === 'partial' ? await store.getTransfer(blobID) : null;
         // The row goes first: a crash then leaves orphaned bytes, never a row without bytes.

package/lib/transfer.js

@@ -1,5 +1,6 @@
 import { getBlobStore } from '@hozon/store-blob';
 import { BlobIDMismatchError, BlobNotFoundError, ChunkDigestMismatchError, ChunkLengthError, InvalidManifestError, TransferIncompleteError } from './errors.js';
+import { getFreshEntry } from './fresh.js';
 import { createStagingID } from './write.js';
 function bytesEqual(a, b) {
     if (a.length !== b.length) return false;
@@ -98,7 +99,7 @@ async function stagingExists(backend, transfer, chunkSize) {
 // Lock held: the transfer of a `partial` entry, or BlobNotFoundError.
 async function requireTransfer(ctx, blobID) {
     const store = await getBlobStore(ctx.db);
-    const entry = await store.getEntry(blobID);
+    const entry = await getFreshEntry(store, blobID);
     const transfer = entry?.state === 'partial' ? await store.getTransfer(blobID) : null;
     if (entry === null || transfer === null) {
         throw new BlobNotFoundError(blobID, {
@@ -119,7 +120,7 @@ export async function beginFetch(ctx, id, manifest) {
     const chunkSize = manifest.contentLength === 0 ? ctx.chunkSize : manifest.chunkSize;
     await ctx.lock.withLock(blobID, async ()=>{
         const store = await getBlobStore(ctx.db);
-        const entry = await store.getEntry(blobID);
+        const entry = await getFreshEntry(store, blobID);
         if (entry?.state === 'local') return;
         // A stub with another length could never complete against this manifest.
         if (entry !== null && entry.contentLength !== manifest.contentLength) {
@@ -166,7 +167,7 @@ export async function getPresentChunks(ctx, id) {
     const blobID = ctx.codec.canonicalize(id);
     return await ctx.lock.withLock(blobID, async ()=>{
         const store = await getBlobStore(ctx.db);
-        const entry = await store.getEntry(blobID);
+        const entry = await getFreshEntry(store, blobID);
         if (entry?.state !== 'partial') return [];
         const transfer = await store.getTransfer(blobID);
         if (transfer === null) return [];
@@ -289,7 +290,7 @@ export async function completeFetch(ctx, id) {
                 index,
                 digest
             })));
-        const promoted = await store.getEntry(blobID);
+        const promoted = await getFreshEntry(store, blobID);
         if (promoted === null) throw new Error(`Blob entry ${blobID} missing after promotion`);
         return promoted;
     });

package/lib/write.js

@@ -1,6 +1,7 @@
 import { hashStream } from '@hozon/blob-id';
 import { getBlobStore } from '@hozon/store-blob';
 import { BlobIDMismatchError, BlobTooLargeError, BlobWriteAbortedError, ContentTypeMismatchError } from './errors.js';
+import { getFreshEntry } from './fresh.js';
 // Random staging ID: `prefix` (`w` for writes, `t` for transfers), a dash, 32 hex chars.
 export function createStagingID(runtime, prefix) {
     const bytes = runtime.getRandomValues(new Uint8Array(16));
@@ -132,14 +133,14 @@ export async function writeBlob(ctx, params) {
         return await ctx.lock.withLock(blobID, async ()=>{
             throwIfAborted(signal);
             const store = await getBlobStore(ctx.db);
-            const existing = await store.getEntry(blobID);
+            const existing = await getFreshEntry(store, blobID);
             if (existing?.state === 'local') {
                 await discardStaging();
                 // Existing metadata wins; only a null content type is filled in.
                 const fill = async (target)=>{
                     if (existing.contentType !== null || contentType === undefined) return existing;
                     await target.fillContentType(blobID, contentType);
-                    return await target.getEntry(blobID) ?? existing;
+                    return await getFreshEntry(target, blobID) ?? existing;
                 };
                 const { entry, result } = await record(ctx, fn, fill);
                 return {
@@ -168,7 +169,7 @@ export async function writeBlob(ctx, params) {
                 }));
             const promote = async (target)=>{
                 await target.promoteEntry(input, chunks);
-                const entry = await target.getEntry(blobID);
+                const entry = await getFreshEntry(target, blobID);
                 if (entry === null) throw new Error(`Blob entry ${blobID} missing after promotion`);
                 return entry;
             };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hozon/blob",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Content-addressed blob service with verified writes for Hozon",
   "repository": {
     "type": "git",
@@ -18,17 +18,18 @@
   ],
   "dependencies": {
     "@hozon/blob-backend": "^0.2.0",
-    "@hozon/blob-id": "^0.1.0",
-    "@hozon/db": "^0.2.2",
-    "@hozon/store-blob": "^0.2.0",
+    "@hozon/blob-id": "^0.1.1",
+    "@hozon/db": "^0.4.0",
+    "@hozon/store-blob": "^0.3.0",
     "@sozai/runtime": "^0.1.0"
   },
   "devDependencies": {
     "@hozon/blob-node-fs": "^0.2.0",
-    "@hozon/node-sqlite": "^0.1.0",
-    "@types/node": "^26.6.4",
-    "del-cli": "^7.0.0",
-    "vitest": "5.0.3"
+    "@hozon/node-sqlite": "^0.2.0",
+    "@sozai/codec": "^0.4.3",
+    "@types/node": "^26.6.5",
+    "del-cli": "^8.0.1",
+    "vitest": "5.0.5"
   },
   "publishConfig": {
     "access": "public"