@dxos/blob 0.11.1 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.md +13 -4
  2. package/dist/lib/chunk-ni-uri.mjs +103 -0
  3. package/dist/lib/chunk-ni-uri.mjs.map +1 -0
  4. package/dist/lib/hosted.mjs +55 -0
  5. package/dist/lib/hosted.mjs.map +1 -0
  6. package/dist/lib/index.mjs +2 -0
  7. package/dist/lib/s3.mjs +515 -0
  8. package/dist/lib/s3.mjs.map +1 -0
  9. package/dist/types/src/backend.d.ts +31 -0
  10. package/dist/types/src/backend.d.ts.map +1 -1
  11. package/dist/types/src/hosted/blob-backend.d.ts +21 -0
  12. package/dist/types/src/hosted/blob-backend.d.ts.map +1 -0
  13. package/dist/types/src/hosted/blob-backend.test.d.ts +2 -0
  14. package/dist/types/src/hosted/blob-backend.test.d.ts.map +1 -0
  15. package/dist/types/src/hosted/index.d.ts +2 -0
  16. package/dist/types/src/hosted/index.d.ts.map +1 -0
  17. package/dist/types/src/index.d.ts +2 -1
  18. package/dist/types/src/index.d.ts.map +1 -1
  19. package/dist/types/src/ni-uri.d.ts +51 -0
  20. package/dist/types/src/ni-uri.d.ts.map +1 -0
  21. package/dist/types/src/ni-uri.test.d.ts +2 -0
  22. package/dist/types/src/ni-uri.test.d.ts.map +1 -0
  23. package/dist/types/src/s3/blob-backend.d.ts +38 -0
  24. package/dist/types/src/s3/blob-backend.d.ts.map +1 -0
  25. package/dist/types/src/s3/constants.d.ts +17 -0
  26. package/dist/types/src/s3/constants.d.ts.map +1 -0
  27. package/dist/types/src/s3/index.d.ts +6 -0
  28. package/dist/types/src/s3/index.d.ts.map +1 -0
  29. package/dist/types/src/s3/s3-client.d.ts +93 -0
  30. package/dist/types/src/s3/s3-client.d.ts.map +1 -0
  31. package/dist/types/src/s3/s3-client.test.d.ts +2 -0
  32. package/dist/types/src/s3/s3-client.test.d.ts.map +1 -0
  33. package/dist/types/src/s3/s3-uri.d.ts +44 -0
  34. package/dist/types/src/s3/s3-uri.d.ts.map +1 -0
  35. package/dist/types/src/s3/s3-uri.test.d.ts +2 -0
  36. package/dist/types/src/s3/s3-uri.test.d.ts.map +1 -0
  37. package/dist/types/src/s3/sigv4.d.ts +55 -0
  38. package/dist/types/src/s3/sigv4.d.ts.map +1 -0
  39. package/dist/types/src/s3/sigv4.test.d.ts +2 -0
  40. package/dist/types/src/s3/sigv4.test.d.ts.map +1 -0
  41. package/dist/types/tsconfig.tsbuildinfo +1 -1
  42. package/package.json +14 -2
  43. package/src/backend.ts +23 -0
  44. package/src/hosted/blob-backend.test.ts +113 -0
  45. package/src/hosted/blob-backend.ts +67 -0
  46. package/src/hosted/index.ts +5 -0
  47. package/src/index.ts +2 -1
  48. package/src/ni-uri.test.ts +31 -0
  49. package/src/ni-uri.ts +136 -0
  50. package/src/s3/blob-backend.ts +75 -0
  51. package/src/s3/constants.ts +24 -0
  52. package/src/s3/index.ts +13 -0
  53. package/src/s3/s3-client.test.ts +145 -0
  54. package/src/s3/s3-client.ts +331 -0
  55. package/src/s3/s3-uri.test.ts +81 -0
  56. package/src/s3/s3-uri.ts +93 -0
  57. package/src/s3/sigv4.test.ts +99 -0
  58. package/src/s3/sigv4.ts +203 -0
package/README.md CHANGED
@@ -21,8 +21,17 @@ store takes a `BlobTransport` (four operations), S3 takes an `S3Host` (credentia
21
21
  resolution). This is what lets the same backend register in a browser, in a headless worker with no
22
22
  `Client`, or in a test with a plain object.
23
23
 
24
- ## Status
24
+ ## Layout
25
25
 
26
- This package currently holds the contract. The registry, URI encoding, and the backends themselves
27
- still live in `@dxos/echo-client` and `@dxos/client`; moving them here is tracked in
28
- [the design doc](../echo-client/src/blob/DESIGN.md), along with the `edge`/`ni:` → `blob` rename.
26
+ | Entry point | Contents |
27
+ | --- | --- |
28
+ | `@dxos/blob` | `BlobBackend`, `BlobTransport`, the `ni:` URI encoding |
29
+ | `@dxos/blob/s3` | S3/R2 backend — SigV4 over WebCrypto, no AWS SDK |
30
+ | `@dxos/blob/hosted` | the DXOS-hosted store, over a `BlobTransport` |
31
+
32
+ Each backend is its own entry point so nothing that does not use S3 carries the signer.
33
+
34
+ `BlobManager` — the registry itself — lives in `@dxos/echo-client`, not here. This package sits
35
+ *below* `@dxos/echo` (which imports `BlobBackend` for `Hypergraph.registerBlobBackend`), while the
36
+ manager creates `Blob.Blob` objects and throws `EchoError`, so it must sit above. See
37
+ [the design doc](./docs/DESIGN.md), which also covers the pending `edge`/`ni:` → `blob` rename.
@@ -0,0 +1,103 @@
1
+ //#region src/ni-uri.ts
2
+ /**
3
+ * IANA hash-algorithm name for SHA-256 in RFC 6920 Named Information URIs.
4
+ *
5
+ * @see https://www.rfc-editor.org/rfc/rfc6920
6
+ */
7
+ var ALG = "sha-256";
8
+ /**
9
+ * URI scheme for Named Information URIs (`ni:`).
10
+ *
11
+ * @see https://www.rfc-editor.org/rfc/rfc6920#section-4
12
+ */
13
+ var SCHEME = "ni";
14
+ var BASE64URL_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
15
+ /** RFC 4648 §5 base64url encoding without padding. */
16
+ var toBase64url = (bytes) => {
17
+ let out = "";
18
+ for (let offset = 0; offset < bytes.length; offset += 3) {
19
+ const byte0 = bytes[offset];
20
+ const byte1 = bytes[offset + 1];
21
+ const byte2 = bytes[offset + 2];
22
+ out += BASE64URL_ALPHABET[byte0 >> 2];
23
+ out += BASE64URL_ALPHABET[(byte0 & 3) << 4 | (byte1 === void 0 ? 0 : byte1 >> 4)];
24
+ if (byte1 === void 0) break;
25
+ out += BASE64URL_ALPHABET[(byte1 & 15) << 2 | (byte2 === void 0 ? 0 : byte2 >> 6)];
26
+ if (byte2 === void 0) break;
27
+ out += BASE64URL_ALPHABET[byte2 & 63];
28
+ }
29
+ return out;
30
+ };
31
+ /** RFC 4648 §5 base64url decoding; ignores characters outside the alphabet. */
32
+ var fromBase64url = (value) => {
33
+ const lookup = (/* @__PURE__ */ new Int8Array(128)).fill(-1);
34
+ for (let index = 0; index < 64; index++) lookup[BASE64URL_ALPHABET.charCodeAt(index)] = index;
35
+ const out = new Uint8Array(value.length * 3 >> 2);
36
+ let bits = 0;
37
+ let accumulator = 0;
38
+ let position = 0;
39
+ for (let index = 0; index < value.length; index++) {
40
+ const code = value.charCodeAt(index);
41
+ if (code >= lookup.length) continue;
42
+ const digit = lookup[code];
43
+ if (digit < 0) continue;
44
+ accumulator = accumulator << 6 | digit;
45
+ bits += 6;
46
+ if (bits >= 8) {
47
+ bits -= 8;
48
+ out[position++] = accumulator >> bits & 255;
49
+ }
50
+ }
51
+ return out.subarray(0, position);
52
+ };
53
+ var hexFromDigest = (digest) => Array.from(digest).map((byte) => byte.toString(16).padStart(2, "0")).join("");
54
+ var digestFromHex = (hex) => {
55
+ const bytes = new Uint8Array(hex.length / 2);
56
+ for (let index = 0; index < bytes.length; index++) bytes[index] = Number.parseInt(hex.slice(index * 2, index * 2 + 2), 16);
57
+ return bytes;
58
+ };
59
+ /**
60
+ * Computes the raw SHA-256 digest of `bytes`.
61
+ */
62
+ var digestBytes = async (bytes) => {
63
+ const digest = await crypto.subtle.digest("SHA-256", bytes);
64
+ return new Uint8Array(digest);
65
+ };
66
+ /**
67
+ * Builds an RFC 6920 Named Information URI from a raw SHA-256 digest.
68
+ *
69
+ * @see https://www.rfc-editor.org/rfc/rfc6920#section-3
70
+ */
71
+ var fromDigest = (digest) => `ni:///${ALG};${toBase64url(digest)}`;
72
+ /**
73
+ * Builds an RFC 6920 Named Information URI from a lowercase hex-encoded SHA-256 digest.
74
+ */
75
+ var fromDigestHex = (hex) => fromDigest(digestFromHex(hex));
76
+ /**
77
+ * Computes the RFC 6920 Named Information URI for `bytes` (`ni:///sha-256;<base64url-digest>`).
78
+ *
79
+ * @see https://www.rfc-editor.org/rfc/rfc6920
80
+ */
81
+ var encode = async (bytes) => fromDigest(await digestBytes(bytes));
82
+ /**
83
+ * Extracts the raw SHA-256 digest from a `ni:` URI.
84
+ *
85
+ * @throws If `uri` is not a well-formed `ni:///sha-256;…` URI.
86
+ */
87
+ var decode = (uri) => {
88
+ const match = /^ni:\/\/\/([a-z0-9-]+);([A-Za-z0-9_-]+)$/.exec(uri);
89
+ if (!match || match[1] !== "sha-256") throw new Error(`Invalid ni: URI: ${uri}`);
90
+ return fromBase64url(match[2]);
91
+ };
92
+ /**
93
+ * Returns the lowercase hex SHA-256 digest encoded in a `ni:` URI.
94
+ */
95
+ var digestHex = (uri) => hexFromDigest(decode(uri));
96
+ /**
97
+ * Computes the lowercase hex SHA-256 digest of `bytes`.
98
+ */
99
+ var digestHexFromBytes = async (bytes) => hexFromDigest(await digestBytes(bytes));
100
+ //#endregion
101
+ export { digestHex as a, fromBase64url as c, toBase64url as d, digestBytes as i, fromDigest as l, SCHEME as n, digestHexFromBytes as o, decode as r, encode as s, ALG as t, fromDigestHex as u };
102
+
103
+ //# sourceMappingURL=chunk-ni-uri.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chunk-ni-uri.mjs","names":[],"sources":["../../src/ni-uri.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n/**\n * IANA hash-algorithm name for SHA-256 in RFC 6920 Named Information URIs.\n *\n * @see https://www.rfc-editor.org/rfc/rfc6920\n */\nexport const ALG = 'sha-256';\n\n/**\n * URI scheme for Named Information URIs (`ni:`).\n *\n * @see https://www.rfc-editor.org/rfc/rfc6920#section-4\n */\nexport const SCHEME = 'ni';\n\nconst BASE64URL_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';\n\n/** RFC 4648 §5 base64url encoding without padding. */\nexport const toBase64url = (bytes: Uint8Array): string => {\n let out = '';\n for (let offset = 0; offset < bytes.length; offset += 3) {\n const byte0 = bytes[offset];\n const byte1 = bytes[offset + 1];\n const byte2 = bytes[offset + 2];\n out += BASE64URL_ALPHABET[byte0 >> 2];\n out += BASE64URL_ALPHABET[((byte0 & 0x03) << 4) | (byte1 === undefined ? 0 : byte1 >> 4)];\n if (byte1 === undefined) {\n break;\n }\n out += BASE64URL_ALPHABET[((byte1 & 0x0f) << 2) | (byte2 === undefined ? 0 : byte2 >> 6)];\n if (byte2 === undefined) {\n break;\n }\n out += BASE64URL_ALPHABET[byte2 & 0x3f];\n }\n return out;\n};\n\n/** RFC 4648 §5 base64url decoding; ignores characters outside the alphabet. */\nexport const fromBase64url = (value: string): Uint8Array => {\n const lookup = new Int8Array(128).fill(-1);\n for (let index = 0; index < BASE64URL_ALPHABET.length; index++) {\n lookup[BASE64URL_ALPHABET.charCodeAt(index)] = index;\n }\n\n const out = new Uint8Array((value.length * 3) >> 2);\n let bits = 0;\n let accumulator = 0;\n let position = 0;\n for (let index = 0; index < value.length; index++) {\n const code = value.charCodeAt(index);\n if (code >= lookup.length) {\n continue;\n }\n const digit = lookup[code];\n if (digit < 0) {\n continue;\n }\n accumulator = (accumulator << 6) | digit;\n bits += 6;\n if (bits >= 8) {\n bits -= 8;\n out[position++] = (accumulator >> bits) & 0xff;\n }\n }\n return out.subarray(0, position);\n};\n\nconst hexFromDigest = (digest: Uint8Array): string =>\n Array.from(digest)\n .map((byte) => byte.toString(16).padStart(2, '0'))\n .join('');\n\nconst digestFromHex = (hex: string): Uint8Array => {\n const bytes = new Uint8Array(hex.length / 2);\n for (let index = 0; index < bytes.length; index++) {\n bytes[index] = Number.parseInt(hex.slice(index * 2, index * 2 + 2), 16);\n }\n return bytes;\n};\n\n/**\n * Computes the raw SHA-256 digest of `bytes`.\n */\nexport const digestBytes = async (bytes: Uint8Array): Promise<Uint8Array> => {\n // WebCrypto's `BufferSource` type requires an `ArrayBuffer`-backed view, while `Uint8Array` is\n // generic over `ArrayBufferLike` (which also covers `SharedArrayBuffer`) — a real gap between\n // the DOM lib types and the TS standard lib, not fixable by typing `bytes` differently.\n const digest = await crypto.subtle.digest('SHA-256', bytes as BufferSource);\n return new Uint8Array(digest);\n};\n\n/**\n * Builds an RFC 6920 Named Information URI from a raw SHA-256 digest.\n *\n * @see https://www.rfc-editor.org/rfc/rfc6920#section-3\n */\nexport const fromDigest = (digest: Uint8Array): string => `ni:///${ALG};${toBase64url(digest)}`;\n\n/**\n * Builds an RFC 6920 Named Information URI from a lowercase hex-encoded SHA-256 digest.\n */\nexport const fromDigestHex = (hex: string): string => fromDigest(digestFromHex(hex));\n\n/**\n * Computes the RFC 6920 Named Information URI for `bytes` (`ni:///sha-256;<base64url-digest>`).\n *\n * @see https://www.rfc-editor.org/rfc/rfc6920\n */\nexport const encode = async (bytes: Uint8Array): Promise<string> => fromDigest(await digestBytes(bytes));\n\n/**\n * Extracts the raw SHA-256 digest from a `ni:` URI.\n *\n * @throws If `uri` is not a well-formed `ni:///sha-256;…` URI.\n */\nexport const decode = (uri: string): Uint8Array => {\n const match = /^ni:\\/\\/\\/([a-z0-9-]+);([A-Za-z0-9_-]+)$/.exec(uri);\n if (!match || match[1] !== ALG) {\n throw new Error(`Invalid ni: URI: ${uri}`);\n }\n return fromBase64url(match[2]);\n};\n\n/**\n * Returns the lowercase hex SHA-256 digest encoded in a `ni:` URI.\n */\nexport const digestHex = (uri: string): string => hexFromDigest(decode(uri));\n\n/**\n * Computes the lowercase hex SHA-256 digest of `bytes`.\n */\nexport const digestHexFromBytes = async (bytes: Uint8Array): Promise<string> => hexFromDigest(await digestBytes(bytes));\n"],"mappings":";;;;;;AASA,IAAa,MAAM;;;;;;AAOnB,IAAa,SAAS;AAEtB,IAAM,qBAAqB;;AAG3B,IAAa,eAAe,UAA8B;CACxD,IAAI,MAAM;CACV,KAAK,IAAI,SAAS,GAAG,SAAS,MAAM,QAAQ,UAAU,GAAG;EACvD,MAAM,QAAQ,MAAM;EACpB,MAAM,QAAQ,MAAM,SAAS;EAC7B,MAAM,QAAQ,MAAM,SAAS;EAC7B,OAAO,mBAAmB,SAAS;EACnC,OAAO,oBAAqB,QAAQ,MAAS,KAAM,UAAU,KAAA,IAAY,IAAI,SAAS;EACtF,IAAI,UAAU,KAAA,GACZ;EAEF,OAAO,oBAAqB,QAAQ,OAAS,KAAM,UAAU,KAAA,IAAY,IAAI,SAAS;EACtF,IAAI,UAAU,KAAA,GACZ;EAEF,OAAO,mBAAmB,QAAQ;CACpC;CACA,OAAO;AACT;;AAGA,IAAa,iBAAiB,UAA8B;CAC1D,MAAM,0BAAS,IAAI,UAAU,GAAG,EAAA,CAAE,KAAK,EAAE;CACzC,KAAK,IAAI,QAAQ,GAAG,QAAQ,IAA2B,SACrD,OAAO,mBAAmB,WAAW,KAAK,KAAK;CAGjD,MAAM,MAAM,IAAI,WAAY,MAAM,SAAS,KAAM,CAAC;CAClD,IAAI,OAAO;CACX,IAAI,cAAc;CAClB,IAAI,WAAW;CACf,KAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS;EACjD,MAAM,OAAO,MAAM,WAAW,KAAK;EACnC,IAAI,QAAQ,OAAO,QACjB;EAEF,MAAM,QAAQ,OAAO;EACrB,IAAI,QAAQ,GACV;EAEF,cAAe,eAAe,IAAK;EACnC,QAAQ;EACR,IAAI,QAAQ,GAAG;GACb,QAAQ;GACR,IAAI,cAAe,eAAe,OAAQ;EAC5C;CACF;CACA,OAAO,IAAI,SAAS,GAAG,QAAQ;AACjC;AAEA,IAAM,iBAAiB,WACrB,MAAM,KAAK,MAAM,CAAA,CACd,KAAK,SAAS,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAA,CAChD,KAAK,EAAE;AAEZ,IAAM,iBAAiB,QAA4B;CACjD,MAAM,QAAQ,IAAI,WAAW,IAAI,SAAS,CAAC;CAC3C,KAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SACxC,MAAM,SAAS,OAAO,SAAS,IAAI,MAAM,QAAQ,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE;CAExE,OAAO;AACT;;;;AAKA,IAAa,cAAc,OAAO,UAA2C;CAI3E,MAAM,SAAS,MAAM,OAAO,OAAO,OAAO,WAAW,KAAqB;CAC1E,OAAO,IAAI,WAAW,MAAM;AAC9B;;;;;;AAOA,IAAa,cAAc,WAA+B,SAAS,IAAI,GAAG,YAAY,MAAM;;;;AAK5F,IAAa,iBAAiB,QAAwB,WAAW,cAAc,GAAG,CAAC;;;;;;AAOnF,IAAa,SAAS,OAAO,UAAuC,WAAW,MAAM,YAAY,KAAK,CAAC;;;;;;AAOvG,IAAa,UAAU,QAA4B;CACjD,MAAM,QAAQ,2CAA2C,KAAK,GAAG;CACjE,IAAI,CAAC,SAAS,MAAM,OAAA,WAClB,MAAM,IAAI,MAAM,oBAAoB,KAAK;CAE3C,OAAO,cAAc,MAAM,EAAE;AAC/B;;;;AAKA,IAAa,aAAa,QAAwB,cAAc,OAAO,GAAG,CAAC;;;;AAK3E,IAAa,qBAAqB,OAAO,UAAuC,cAAc,MAAM,YAAY,KAAK,CAAC"}
@@ -0,0 +1,55 @@
1
+ import { a as digestHex, u as fromDigestHex } from "./chunk-ni-uri.mjs";
2
+ import { invariant } from "@dxos/invariant";
3
+ //#region src/hosted/blob-backend.ts
4
+ var __dxlog_file = "/__w/dxos/dxos/packages/core/echo/blob/src/hosted/blob-backend.ts";
5
+ var parseNiUri = (uri) => {
6
+ invariant(uri.startsWith(`ni:///`), `Invalid ni: URI: ${uri}`, {
7
+ "~LogMeta": "~LogMeta",
8
+ F: __dxlog_file,
9
+ L: 18,
10
+ S: void 0,
11
+ A: ["uri.startsWith(`${SCHEME}:///`)", "`Invalid ni: URI: ${uri}`"]
12
+ });
13
+ return digestHex(uri);
14
+ };
15
+ /** Largest blob the edge blob service accepts, in bytes. */
16
+ var MAX_EDGE_BLOB_SIZE = 52428800;
17
+ /**
18
+ * Blob backend that stores bytes in the edge blob service, addressed by RFC 6920 `ni:` URIs over a
19
+ * SHA-256 digest of the complete blob. The edge blob service itself is a flat key-value store keyed
20
+ * by hex digest — online-only in v1; reads and writes reject if the edge is unreachable and there is
21
+ * no local cache.
22
+ *
23
+ * @see {@link https://www.rfc-editor.org/rfc/rfc6920 RFC 6920}
24
+ *
25
+ * TODO(wittjosiah): Add a local cache (e.g. via `@dxos/random-access-storage`, keyed by content
26
+ * hash) so reads/writes don't always round-trip to the edge. Blocked on `BlobBackend` gaining a
27
+ * `remove` and GC/refcounting for content-addressed blobs — without that, a local cache has no way
28
+ * to know when a cached entry is safe to evict once its owning Blob object is deleted.
29
+ */
30
+ var createEdgeBlobBackend = ({ transport }) => {
31
+ const finalizeUpload = transport.finalizeUpload?.bind(transport);
32
+ return {
33
+ schemes: ["ni"],
34
+ maxSize: MAX_EDGE_BLOB_SIZE,
35
+ put: async ({ data, contentType, contentHash }) => {
36
+ await transport.put(contentHash, data, { contentType });
37
+ return { uri: fromDigestHex(contentHash) };
38
+ },
39
+ get: async ({ uri }) => transport.get(parseNiUri(uri)),
40
+ has: async ({ uri }) => transport.has(parseNiUri(uri)),
41
+ getUrl: async ({ uri }) => transport.url(parseNiUri(uri)).toString(),
42
+ ...finalizeUpload && { adoptUpload: async ({ uploadId }) => {
43
+ const { key, size, contentType } = await finalizeUpload(uploadId);
44
+ return {
45
+ uri: fromDigestHex(key),
46
+ size,
47
+ contentType
48
+ };
49
+ } }
50
+ };
51
+ };
52
+ //#endregion
53
+ export { MAX_EDGE_BLOB_SIZE, createEdgeBlobBackend };
54
+
55
+ //# sourceMappingURL=hosted.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted.mjs","names":[],"sources":["../../src/hosted/blob-backend.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { invariant } from '@dxos/invariant';\n\nimport { type BlobBackend, type BlobTransport } from '../backend.ts';\nimport { SCHEME, digestHex, fromDigestHex } from '../ni-uri.ts';\n\nexport interface CreateEdgeBlobBackendOptions {\n transport: BlobTransport;\n}\n\n// `SCHEME` from `ni-uri` rather than `Blob.Scheme.ni` from `@dxos/echo`: both are the string `ni`,\n// and taking it from here is what keeps this package below `@dxos/echo` in the graph. `@dxos/echo`\n// exposes `registerBlobBackend(…: BlobBackend)`, so anything it depends on cannot depend back on it.\nconst parseNiUri = (uri: string): string => {\n invariant(uri.startsWith(`${SCHEME}:///`), `Invalid ni: URI: ${uri}`);\n return digestHex(uri);\n};\n\n/** Largest blob the edge blob service accepts, in bytes. */\nexport const MAX_EDGE_BLOB_SIZE = 50 * 1024 * 1024;\n\n/**\n * Blob backend that stores bytes in the edge blob service, addressed by RFC 6920 `ni:` URIs over a\n * SHA-256 digest of the complete blob. The edge blob service itself is a flat key-value store keyed\n * by hex digest — online-only in v1; reads and writes reject if the edge is unreachable and there is\n * no local cache.\n *\n * @see {@link https://www.rfc-editor.org/rfc/rfc6920 RFC 6920}\n *\n * TODO(wittjosiah): Add a local cache (e.g. via `@dxos/random-access-storage`, keyed by content\n * hash) so reads/writes don't always round-trip to the edge. Blocked on `BlobBackend` gaining a\n * `remove` and GC/refcounting for content-addressed blobs — without that, a local cache has no way\n * to know when a cached entry is safe to evict once its owning Blob object is deleted.\n */\nexport const createEdgeBlobBackend = ({ transport }: CreateEdgeBlobBackendOptions): BlobBackend => {\n // Bound once here rather than re-read inside the closure: the capability check and the call then\n // share one proof that the method exists, and `bind` keeps a method-style transport working.\n const finalizeUpload = transport.finalizeUpload?.bind(transport);\n\n return {\n schemes: [SCHEME],\n maxSize: MAX_EDGE_BLOB_SIZE,\n\n put: async ({ data, contentType, contentHash }) => {\n await transport.put(contentHash, data, { contentType });\n return { uri: fromDigestHex(contentHash) };\n },\n\n get: async ({ uri }) => transport.get(parseNiUri(uri)),\n\n has: async ({ uri }) => transport.has(parseNiUri(uri)),\n\n getUrl: async ({ uri }) => transport.url(parseNiUri(uri)).toString(),\n\n // Spread rather than always present: `adoptUpload` being absent is how the manager tells a\n // backend that cannot adopt uploads from an adoption that failed.\n ...(finalizeUpload && {\n adoptUpload: async ({ uploadId }: { uploadId: string }) => {\n const { key, size, contentType } = await finalizeUpload(uploadId);\n return { uri: fromDigestHex(key), size, contentType };\n },\n }),\n };\n};\n"],"mappings":";;;;AAgBA,IAAM,cAAc,QAAwB;CAC1C,UAAU,IAAI,WAAW,QAAe,GAAG,oBAAoB,OAAI;EAAA,YAAA;EAAA,GAAA;EAAA,GAAA;EAAA,GAAA,KAAA;EAAA,GAAA,CAAA,mCAAA,2BAAA;CAAA,CAAC;CACpE,OAAO,UAAU,GAAG;AACtB;;AAGA,IAAa,qBAAqB;;;;;;;;;;;;;;AAelC,IAAa,yBAAyB,EAAE,gBAA2D;CAGjG,MAAM,iBAAiB,UAAU,gBAAgB,KAAK,SAAS;CAE/D,OAAO;EACL,SAAS,CAAA,IAAO;EAChB,SAAS;EAET,KAAK,OAAO,EAAE,MAAM,aAAa,kBAAkB;GACjD,MAAM,UAAU,IAAI,aAAa,MAAM,EAAE,YAAY,CAAC;GACtD,OAAO,EAAE,KAAK,cAAc,WAAW,EAAE;EAC3C;EAEA,KAAK,OAAO,EAAE,UAAU,UAAU,IAAI,WAAW,GAAG,CAAC;EAErD,KAAK,OAAO,EAAE,UAAU,UAAU,IAAI,WAAW,GAAG,CAAC;EAErD,QAAQ,OAAO,EAAE,UAAU,UAAU,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC,SAAS;EAInE,GAAI,kBAAkB,EACpB,aAAa,OAAO,EAAE,eAAqC;GACzD,MAAM,EAAE,KAAK,MAAM,gBAAgB,MAAM,eAAe,QAAQ;GAChE,OAAO;IAAE,KAAK,cAAc,GAAG;IAAG;IAAM;GAAY;EACtD,EACF;CACF;AACF"}
@@ -0,0 +1,2 @@
1
+ import { a as digestHex, c as fromBase64url, d as toBase64url, i as digestBytes, l as fromDigest, n as SCHEME, o as digestHexFromBytes, r as decode, s as encode, t as ALG, u as fromDigestHex } from "./chunk-ni-uri.mjs";
2
+ export { ALG, SCHEME, decode, digestBytes, digestHex, digestHexFromBytes, encode, fromBase64url, fromDigest, fromDigestHex, toBase64url };