@atproto/lex-data 0.0.10 → 0.0.12

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @atproto/lex-data
 
+## 0.0.12
+
+### Patch Changes
+
+- [#4660](https://github.com/bluesky-social/atproto/pull/4660) [`ea5df64`](https://github.com/bluesky-social/atproto/commit/ea5df64db9e408d2b320f5f75eb2878aef6bc6df) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Minor code simplification
+
+## 0.0.11
+
+### Patch Changes
+
+- [#4601](https://github.com/bluesky-social/atproto/pull/4601) [`ed61c62`](https://github.com/bluesky-social/atproto/commit/ed61c62f3161fcde85ee9a93f8ed339c7e06c015) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Fix `exports` field in package.json
+
+- [#4601](https://github.com/bluesky-social/atproto/pull/4601) [`ed61c62`](https://github.com/bluesky-social/atproto/commit/ed61c62f3161fcde85ee9a93f8ed339c7e06c015) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Add JSDoc
+
 ## 0.0.10
 
 ### Patch Changes

package/dist/blob.d.ts

@@ -1,7 +1,28 @@
 import { Cid, RawCid } from './cid.js';
 import { LexValue } from './lex.js';
 /**
- * @note {@link BlobRef} is just a {@link LexMap} with a specific shape.
+ * Reference to binary data (like images, videos, etc.) in the AT Protocol data model.
+ *
+ * A BlobRef is a {@link LexMap} with a specific structure that identifies binary
+ * content by its content hash (CID), along with metadata about the content type
+ * and size.
+ *
+ * @typeParam Ref - The type of CID reference, defaults to any {@link Cid}
+ *
+ * @example
+ * ```typescript
+ * import type { BlobRef } from '@atproto/lex-data'
+ *
+ * const imageRef: BlobRef = {
+ *   $type: 'blob',
+ *   mimeType: 'image/jpeg',
+ *   ref: cid,  // CID of the blob content
+ *   size: 12345
+ * }
+ * ```
+ *
+ * @see {@link isBlobRef} to check if a value is a valid BlobRef
+ * @see {@link LegacyBlobRef} for the older blob reference format
  */
 export type BlobRef<Ref extends Cid = Cid> = {
     $type: 'blob';
@@ -9,46 +30,162 @@ export type BlobRef<Ref extends Cid = Cid> = {
     ref: Ref;
     size: number;
 };
+/**
+ * Options for validating a {@link BlobRef}.
+ */
 export type BlobRefCheckOptions = {
     /**
      * If `false`, skips strict CID validation of {@link BlobRef.ref}, allowing
      * any valid CID. Otherwise, validates that the CID is v1, uses the raw
      * multicodec, and has a sha256 multihash.
      *
-     * @defaults to `true`
+     * @default true
      */
     strict?: boolean;
 };
+/**
+ * Infers the BlobRef type based on the check options.
+ *
+ * @typeParam TOptions - The options used for checking
+ */
 export type InferCheckedBlobRef<TOptions extends BlobRefCheckOptions> = TOptions extends {
     strict: false;
 } ? BlobRef : {
     strict: boolean;
 } extends TOptions ? BlobRef : BlobRef<RawCid>;
+/**
+ * Type guard to check if a value is a valid {@link BlobRef}.
+ *
+ * Validates the structure of the input including:
+ * - `$type` must be `'blob'`
+ * - `mimeType` must be a valid MIME type string (containing '/')
+ * - `size` must be a non-negative safe integer
+ * - `ref` must be a valid CID (strict validation by default)
+ *
+ * @param input - The value to check
+ * @param options - Optional validation options
+ * @returns `true` if the input is a valid BlobRef
+ *
+ * @example
+ * ```typescript
+ * import { isBlobRef } from '@atproto/lex-data'
+ *
+ * if (isBlobRef(data)) {
+ *   console.log(data.mimeType)  // e.g., 'image/jpeg'
+ *   console.log(data.size)      // e.g., 12345
+ * }
+ *
+ * // Allow any valid CID (not just raw CIDs)
+ * if (isBlobRef(data, { strict: false })) {
+ *   // ...
+ * }
+ * ```
+ */
 export declare function isBlobRef(input: unknown): input is BlobRef<RawCid>;
 export declare function isBlobRef<TOptions extends BlobRefCheckOptions>(input: unknown, options: TOptions): input is InferCheckedBlobRef<TOptions>;
 export declare function isBlobRef(input: unknown, options?: BlobRefCheckOptions): input is BlobRef;
 /**
- * @note {@link LegacyBlobRef} is just a {@link LexMap} with a specific shape.
+ * Legacy format for blob references used in older AT Protocol data.
+ *
+ * This is the older format that stores the CID as a string rather than
+ * as a structured CID object. New code should use {@link BlobRef} instead.
+ *
+ * @example
+ * ```typescript
+ * import type { LegacyBlobRef } from '@atproto/lex-data'
+ *
+ * const legacyRef: LegacyBlobRef = {
+ *   cid: 'bafyreib...',
+ *   mimeType: 'image/jpeg'
+ * }
+ * ```
+ *
+ * @see {@link isLegacyBlobRef} to check if a value is a LegacyBlobRef
+ * @see {@link BlobRef} for the current blob reference format
+ * @deprecated Use {@link BlobRef} for new code
  */
 export type LegacyBlobRef = {
     cid: string;
     mimeType: string;
 };
+/**
+ * Type guard to check if a value is a valid {@link LegacyBlobRef}.
+ *
+ * Validates the structure of the input:
+ * - `cid` must be a valid CID string
+ * - `mimeType` must be a non-empty string
+ * - No additional properties allowed
+ *
+ * @param input - The value to check
+ * @returns `true` if the input is a valid LegacyBlobRef
+ *
+ * @example
+ * ```typescript
+ * import { isLegacyBlobRef } from '@atproto/lex-data'
+ *
+ * if (isLegacyBlobRef(data)) {
+ *   console.log(data.cid)       // CID as string
+ *   console.log(data.mimeType)  // e.g., 'image/jpeg'
+ * }
+ * ```
+ *
+ * @see {@link isBlobRef} for checking the current blob reference format
+ */
 export declare function isLegacyBlobRef(input: unknown): input is LegacyBlobRef;
+/**
+ * Options for enumerating blob references within a {@link LexValue}.
+ */
 export type EnumBlobRefsOptions = BlobRefCheckOptions & {
     /**
-     * @defaults to `false`
+     * If `true`, also yields {@link LegacyBlobRef} objects in addition to
+     * {@link BlobRef} objects.
+     *
+     * @default false
      */
     allowLegacy?: boolean;
 };
+/**
+ * Infers the yielded type of {@link enumBlobRefs} based on options.
+ *
+ * @typeParam TOptions - The options used for enumeration
+ */
 export type InferEnumBlobRefs<TOptions extends EnumBlobRefsOptions> = TOptions extends {
     allowLegacy: true;
 } ? InferCheckedBlobRef<TOptions> | LegacyBlobRef : {
     allowLegacy: boolean;
 } extends TOptions ? InferCheckedBlobRef<TOptions> | LegacyBlobRef : InferCheckedBlobRef<TOptions>;
 /**
- * Enumerates all {@link BlobRef}s (and, optionally, {@link LegacyBlobRef}s)
- * found within a {@link LexValue}.
+ * Generator that enumerates all {@link BlobRef}s (and, optionally,
+ * {@link LegacyBlobRef}s) found within a {@link LexValue}.
+ *
+ * Performs a deep traversal of the input value, yielding any blob references
+ * found. This is useful for extracting all media references from a record.
+ *
+ * @param input - The LexValue to search for blob references
+ * @param options - Optional configuration for the enumeration
+ * @yields Each blob reference found in the input
+ *
+ * @example
+ * ```typescript
+ * import { enumBlobRefs } from '@atproto/lex-data'
+ *
+ * const record = {
+ *   text: 'Hello',
+ *   images: [
+ *     { $type: 'blob', mimeType: 'image/jpeg', ref: cid1, size: 1000 },
+ *     { $type: 'blob', mimeType: 'image/png', ref: cid2, size: 2000 }
+ *   ]
+ * }
+ *
+ * for (const blobRef of enumBlobRefs(record)) {
+ *   console.log(blobRef.mimeType, blobRef.size)
+ * }
+ *
+ * // Include legacy blob references
+ * for (const ref of enumBlobRefs(record, { allowLegacy: true })) {
+ *   // ref may be BlobRef or LegacyBlobRef
+ * }
+ * ```
  */
 export declare function enumBlobRefs(input: LexValue): Generator<BlobRef<RawCid>, void, unknown>;
 export declare function enumBlobRefs<TOptions extends EnumBlobRefsOptions>(input: LexValue, options: TOptions): Generator<InferEnumBlobRefs<TOptions>, void, unknown>;

package/dist/blob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../src/blob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,EAA4B,MAAM,UAAU,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGnC;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,GAAG,CAAA;IACR,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,mBAAmB,CAAC,QAAQ,SAAS,mBAAmB,IAClE,QAAQ,SAAS;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GAC9B,OAAO,GACP;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,SAAS,QAAQ,GAClC,OAAO,GACP,OAAO,CAAC,MAAM,CAAC,CAAA;AAEvB,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;AACnE,wBAAgB,SAAS,CAAC,QAAQ,SAAS,mBAAmB,EAC5D,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,QAAQ,GAChB,KAAK,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAA;AACzC,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,KAAK,IAAI,OAAO,CAAA;AAkDnB;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAyBtE;AAED,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG;IACtD;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,iBAAiB,CAAC,QAAQ,SAAS,mBAAmB,IAChE,QAAQ,SAAS;IAAE,WAAW,EAAE,IAAI,CAAA;CAAE,GAClC,mBAAmB,CAAC,QAAQ,CAAC,GAAG,aAAa,GAC7C;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,SAAS,QAAQ,GACvC,mBAAmB,CAAC,QAAQ,CAAC,GAAG,aAAa,GAC7C,mBAAmB,CAAC,QAAQ,CAAC,CAAA;AAErC;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,GACd,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AAC5C,wBAAgB,YAAY,CAAC,QAAQ,SAAS,mBAAmB,EAC/D,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,QAAQ,GAChB,SAAS,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AACxD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,SAAS,CAAC,OAAO,GAAG,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA"}
+{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../src/blob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,EAA4B,MAAM,UAAU,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGnC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,OAAO,CAAC,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,GAAG,CAAA;IACR,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,QAAQ,SAAS,mBAAmB,IAClE,QAAQ,SAAS;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GAC9B,OAAO,GACP;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,SAAS,QAAQ,GAClC,OAAO,GACP,OAAO,CAAC,MAAM,CAAC,CAAA;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;AACnE,wBAAgB,SAAS,CAAC,QAAQ,SAAS,mBAAmB,EAC5D,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,QAAQ,GAChB,KAAK,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAA;AACzC,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,KAAK,IAAI,OAAO,CAAA;AAkDnB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAyBtE;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG;IACtD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,QAAQ,SAAS,mBAAmB,IAChE,QAAQ,SAAS;IAAE,WAAW,EAAE,IAAI,CAAA;CAAE,GAClC,mBAAmB,CAAC,QAAQ,CAAC,GAAG,aAAa,GAC7C;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,SAAS,QAAQ,GACvC,mBAAmB,CAAC,QAAQ,CAAC,GAAG,aAAa,GAC7C,mBAAmB,CAAC,QAAQ,CAAC,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,GACd,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AAC5C,wBAAgB,YAAY,CAAC,QAAQ,SAAS,mBAAmB,EAC/D,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,QAAQ,GAChB,SAAS,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AACxD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,SAAS,CAAC,OAAO,GAAG,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA"}

package/dist/blob.js

@@ -39,6 +39,29 @@ function isBlobRef(input, options) {
     }
     return true;
 }
+/**
+ * Type guard to check if a value is a valid {@link LegacyBlobRef}.
+ *
+ * Validates the structure of the input:
+ * - `cid` must be a valid CID string
+ * - `mimeType` must be a non-empty string
+ * - No additional properties allowed
+ *
+ * @param input - The value to check
+ * @returns `true` if the input is a valid LegacyBlobRef
+ *
+ * @example
+ * ```typescript
+ * import { isLegacyBlobRef } from '@atproto/lex-data'
+ *
+ * if (isLegacyBlobRef(data)) {
+ *   console.log(data.cid)       // CID as string
+ *   console.log(data.mimeType)  // e.g., 'image/jpeg'
+ * }
+ * ```
+ *
+ * @see {@link isBlobRef} for checking the current blob reference format
+ */
 function isLegacyBlobRef(input) {
     if (!(0, object_js_1.isPlainObject)(input)) {
         return false;

package/dist/blob.js.map

@@ -1 +1 @@
-{"version":3,"file":"blob.js","sourceRoot":"","sources":["../src/blob.ts"],"names":[],"mappings":"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","sourcesContent":["import { Cid, RawCid, ifCid, validateCidString } from './cid.js'\nimport { LexValue } from './lex.js'\nimport { isPlainObject, isPlainProto } from './object.js'\n\n/**\n * @note {@link BlobRef} is just a {@link LexMap} with a specific shape.\n */\nexport type BlobRef<Ref extends Cid = Cid> = {\n  $type: 'blob'\n  mimeType: string\n  ref: Ref\n  size: number\n}\n\nexport type BlobRefCheckOptions = {\n  /**\n   * If `false`, skips strict CID validation of {@link BlobRef.ref}, allowing\n   * any valid CID. Otherwise, validates that the CID is v1, uses the raw\n   * multicodec, and has a sha256 multihash.\n   *\n   * @defaults to `true`\n   */\n  strict?: boolean\n}\n\nexport type InferCheckedBlobRef<TOptions extends BlobRefCheckOptions> =\n  TOptions extends { strict: false }\n    ? BlobRef\n    : { strict: boolean } extends TOptions\n      ? BlobRef\n      : BlobRef<RawCid>\n\nexport function isBlobRef(input: unknown): input is BlobRef<RawCid>\nexport function isBlobRef<TOptions extends BlobRefCheckOptions>(\n  input: unknown,\n  options: TOptions,\n): input is InferCheckedBlobRef<TOptions>\nexport function isBlobRef(\n  input: unknown,\n  options?: BlobRefCheckOptions,\n): input is BlobRef\nexport function isBlobRef(\n  input: unknown,\n  options?: BlobRefCheckOptions,\n): input is BlobRef {\n  if (!isPlainObject(input)) {\n    return false\n  }\n\n  if (input?.$type !== 'blob') {\n    return false\n  }\n\n  const { mimeType, size, ref } = input\n  // @NOTE Very basic mime validation\n  if (typeof mimeType !== 'string' || !mimeType.includes('/')) {\n    return false\n  }\n\n  if (typeof size !== 'number' || size < 0 || !Number.isSafeInteger(size)) {\n    return false\n  }\n\n  if (typeof ref !== 'object' || ref === null) {\n    return false\n  }\n\n  for (const key in input) {\n    if (\n      key !== '$type' &&\n      key !== 'mimeType' &&\n      key !== 'ref' &&\n      key !== 'size'\n    ) {\n      return false\n    }\n  }\n\n  const cid = ifCid(\n    ref,\n    // Strict unless explicitly disabled\n    options?.strict === false ? undefined : { flavor: 'raw' },\n  )\n  if (!cid) {\n    return false\n  }\n\n  return true\n}\n\n/**\n * @note {@link LegacyBlobRef} is just a {@link LexMap} with a specific shape.\n */\nexport type LegacyBlobRef = {\n  cid: string\n  mimeType: string\n}\n\nexport function isLegacyBlobRef(input: unknown): input is LegacyBlobRef {\n  if (!isPlainObject(input)) {\n    return false\n  }\n\n  const { cid, mimeType } = input\n  if (typeof cid !== 'string') {\n    return false\n  }\n\n  if (typeof mimeType !== 'string' || mimeType.length === 0) {\n    return false\n  }\n\n  for (const key in input) {\n    if (key !== 'cid' && key !== 'mimeType') {\n      return false\n    }\n  }\n\n  if (!validateCidString(cid)) {\n    return false\n  }\n\n  return true\n}\n\nexport type EnumBlobRefsOptions = BlobRefCheckOptions & {\n  /**\n   * @defaults to `false`\n   */\n  allowLegacy?: boolean\n}\n\nexport type InferEnumBlobRefs<TOptions extends EnumBlobRefsOptions> =\n  TOptions extends { allowLegacy: true }\n    ? InferCheckedBlobRef<TOptions> | LegacyBlobRef\n    : { allowLegacy: boolean } extends TOptions\n      ? InferCheckedBlobRef<TOptions> | LegacyBlobRef\n      : InferCheckedBlobRef<TOptions>\n\n/**\n * Enumerates all {@link BlobRef}s (and, optionally, {@link LegacyBlobRef}s)\n * found within a {@link LexValue}.\n */\nexport function enumBlobRefs(\n  input: LexValue,\n): Generator<BlobRef<RawCid>, void, unknown>\nexport function enumBlobRefs<TOptions extends EnumBlobRefsOptions>(\n  input: LexValue,\n  options: TOptions,\n): Generator<InferEnumBlobRefs<TOptions>, void, unknown>\nexport function enumBlobRefs(\n  input: LexValue,\n  options?: EnumBlobRefsOptions,\n): Generator<BlobRef | LegacyBlobRef, void, unknown>\nexport function* enumBlobRefs(\n  input: LexValue,\n  options?: EnumBlobRefsOptions,\n): Generator<BlobRef | LegacyBlobRef, void, unknown> {\n  // LegacyBlobRef not included by default\n  const includeLegacy = options?.allowLegacy === true\n\n  // Using a stack to avoid recursion depth issues.\n  const stack: LexValue[] = [input]\n\n  // Since we are using a stack, we could end-up in an infinite loop with cyclic\n  // structures. Cyclic structures are not valid LexValues and should, thus,\n  // never occur, but let's be safe.\n  const visited = new Set<object>()\n\n  do {\n    const value = stack.pop()!\n\n    if (value != null && typeof value === 'object') {\n      if (Array.isArray(value)) {\n        if (visited.has(value)) continue\n        visited.add(value)\n        stack.push(...value)\n      } else if (isPlainProto(value)) {\n        if (visited.has(value)) continue\n        visited.add(value)\n        if (isBlobRef(value, options)) {\n          yield value\n        } else if (includeLegacy && isLegacyBlobRef(value)) {\n          yield value\n        } else {\n          for (const v of Object.values(value)) {\n            if (v != null) stack.push(v)\n          }\n        }\n      }\n    }\n  } while (stack.length > 0)\n\n  // Optimization: ease GC's work\n  visited.clear()\n}\n"]}
+{"version":3,"file":"blob.js","sourceRoot":"","sources":["../src/blob.ts"],"names":[],"mappings":"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","sourcesContent":["import { Cid, RawCid, ifCid, validateCidString } from './cid.js'\nimport { LexValue } from './lex.js'\nimport { isPlainObject, isPlainProto } from './object.js'\n\n/**\n * Reference to binary data (like images, videos, etc.) in the AT Protocol data model.\n *\n * A BlobRef is a {@link LexMap} with a specific structure that identifies binary\n * content by its content hash (CID), along with metadata about the content type\n * and size.\n *\n * @typeParam Ref - The type of CID reference, defaults to any {@link Cid}\n *\n * @example\n * ```typescript\n * import type { BlobRef } from '@atproto/lex-data'\n *\n * const imageRef: BlobRef = {\n *   $type: 'blob',\n *   mimeType: 'image/jpeg',\n *   ref: cid,  // CID of the blob content\n *   size: 12345\n * }\n * ```\n *\n * @see {@link isBlobRef} to check if a value is a valid BlobRef\n * @see {@link LegacyBlobRef} for the older blob reference format\n */\nexport type BlobRef<Ref extends Cid = Cid> = {\n  $type: 'blob'\n  mimeType: string\n  ref: Ref\n  size: number\n}\n\n/**\n * Options for validating a {@link BlobRef}.\n */\nexport type BlobRefCheckOptions = {\n  /**\n   * If `false`, skips strict CID validation of {@link BlobRef.ref}, allowing\n   * any valid CID. Otherwise, validates that the CID is v1, uses the raw\n   * multicodec, and has a sha256 multihash.\n   *\n   * @default true\n   */\n  strict?: boolean\n}\n\n/**\n * Infers the BlobRef type based on the check options.\n *\n * @typeParam TOptions - The options used for checking\n */\nexport type InferCheckedBlobRef<TOptions extends BlobRefCheckOptions> =\n  TOptions extends { strict: false }\n    ? BlobRef\n    : { strict: boolean } extends TOptions\n      ? BlobRef\n      : BlobRef<RawCid>\n\n/**\n * Type guard to check if a value is a valid {@link BlobRef}.\n *\n * Validates the structure of the input including:\n * - `$type` must be `'blob'`\n * - `mimeType` must be a valid MIME type string (containing '/')\n * - `size` must be a non-negative safe integer\n * - `ref` must be a valid CID (strict validation by default)\n *\n * @param input - The value to check\n * @param options - Optional validation options\n * @returns `true` if the input is a valid BlobRef\n *\n * @example\n * ```typescript\n * import { isBlobRef } from '@atproto/lex-data'\n *\n * if (isBlobRef(data)) {\n *   console.log(data.mimeType)  // e.g., 'image/jpeg'\n *   console.log(data.size)      // e.g., 12345\n * }\n *\n * // Allow any valid CID (not just raw CIDs)\n * if (isBlobRef(data, { strict: false })) {\n *   // ...\n * }\n * ```\n */\nexport function isBlobRef(input: unknown): input is BlobRef<RawCid>\nexport function isBlobRef<TOptions extends BlobRefCheckOptions>(\n  input: unknown,\n  options: TOptions,\n): input is InferCheckedBlobRef<TOptions>\nexport function isBlobRef(\n  input: unknown,\n  options?: BlobRefCheckOptions,\n): input is BlobRef\nexport function isBlobRef(\n  input: unknown,\n  options?: BlobRefCheckOptions,\n): input is BlobRef {\n  if (!isPlainObject(input)) {\n    return false\n  }\n\n  if (input?.$type !== 'blob') {\n    return false\n  }\n\n  const { mimeType, size, ref } = input\n  // @NOTE Very basic mime validation\n  if (typeof mimeType !== 'string' || !mimeType.includes('/')) {\n    return false\n  }\n\n  if (typeof size !== 'number' || size < 0 || !Number.isSafeInteger(size)) {\n    return false\n  }\n\n  if (typeof ref !== 'object' || ref === null) {\n    return false\n  }\n\n  for (const key in input) {\n    if (\n      key !== '$type' &&\n      key !== 'mimeType' &&\n      key !== 'ref' &&\n      key !== 'size'\n    ) {\n      return false\n    }\n  }\n\n  const cid = ifCid(\n    ref,\n    // Strict unless explicitly disabled\n    options?.strict === false ? undefined : { flavor: 'raw' },\n  )\n  if (!cid) {\n    return false\n  }\n\n  return true\n}\n\n/**\n * Legacy format for blob references used in older AT Protocol data.\n *\n * This is the older format that stores the CID as a string rather than\n * as a structured CID object. New code should use {@link BlobRef} instead.\n *\n * @example\n * ```typescript\n * import type { LegacyBlobRef } from '@atproto/lex-data'\n *\n * const legacyRef: LegacyBlobRef = {\n *   cid: 'bafyreib...',\n *   mimeType: 'image/jpeg'\n * }\n * ```\n *\n * @see {@link isLegacyBlobRef} to check if a value is a LegacyBlobRef\n * @see {@link BlobRef} for the current blob reference format\n * @deprecated Use {@link BlobRef} for new code\n */\nexport type LegacyBlobRef = {\n  cid: string\n  mimeType: string\n}\n\n/**\n * Type guard to check if a value is a valid {@link LegacyBlobRef}.\n *\n * Validates the structure of the input:\n * - `cid` must be a valid CID string\n * - `mimeType` must be a non-empty string\n * - No additional properties allowed\n *\n * @param input - The value to check\n * @returns `true` if the input is a valid LegacyBlobRef\n *\n * @example\n * ```typescript\n * import { isLegacyBlobRef } from '@atproto/lex-data'\n *\n * if (isLegacyBlobRef(data)) {\n *   console.log(data.cid)       // CID as string\n *   console.log(data.mimeType)  // e.g., 'image/jpeg'\n * }\n * ```\n *\n * @see {@link isBlobRef} for checking the current blob reference format\n */\nexport function isLegacyBlobRef(input: unknown): input is LegacyBlobRef {\n  if (!isPlainObject(input)) {\n    return false\n  }\n\n  const { cid, mimeType } = input\n  if (typeof cid !== 'string') {\n    return false\n  }\n\n  if (typeof mimeType !== 'string' || mimeType.length === 0) {\n    return false\n  }\n\n  for (const key in input) {\n    if (key !== 'cid' && key !== 'mimeType') {\n      return false\n    }\n  }\n\n  if (!validateCidString(cid)) {\n    return false\n  }\n\n  return true\n}\n\n/**\n * Options for enumerating blob references within a {@link LexValue}.\n */\nexport type EnumBlobRefsOptions = BlobRefCheckOptions & {\n  /**\n   * If `true`, also yields {@link LegacyBlobRef} objects in addition to\n   * {@link BlobRef} objects.\n   *\n   * @default false\n   */\n  allowLegacy?: boolean\n}\n\n/**\n * Infers the yielded type of {@link enumBlobRefs} based on options.\n *\n * @typeParam TOptions - The options used for enumeration\n */\nexport type InferEnumBlobRefs<TOptions extends EnumBlobRefsOptions> =\n  TOptions extends { allowLegacy: true }\n    ? InferCheckedBlobRef<TOptions> | LegacyBlobRef\n    : { allowLegacy: boolean } extends TOptions\n      ? InferCheckedBlobRef<TOptions> | LegacyBlobRef\n      : InferCheckedBlobRef<TOptions>\n\n/**\n * Generator that enumerates all {@link BlobRef}s (and, optionally,\n * {@link LegacyBlobRef}s) found within a {@link LexValue}.\n *\n * Performs a deep traversal of the input value, yielding any blob references\n * found. This is useful for extracting all media references from a record.\n *\n * @param input - The LexValue to search for blob references\n * @param options - Optional configuration for the enumeration\n * @yields Each blob reference found in the input\n *\n * @example\n * ```typescript\n * import { enumBlobRefs } from '@atproto/lex-data'\n *\n * const record = {\n *   text: 'Hello',\n *   images: [\n *     { $type: 'blob', mimeType: 'image/jpeg', ref: cid1, size: 1000 },\n *     { $type: 'blob', mimeType: 'image/png', ref: cid2, size: 2000 }\n *   ]\n * }\n *\n * for (const blobRef of enumBlobRefs(record)) {\n *   console.log(blobRef.mimeType, blobRef.size)\n * }\n *\n * // Include legacy blob references\n * for (const ref of enumBlobRefs(record, { allowLegacy: true })) {\n *   // ref may be BlobRef or LegacyBlobRef\n * }\n * ```\n */\nexport function enumBlobRefs(\n  input: LexValue,\n): Generator<BlobRef<RawCid>, void, unknown>\nexport function enumBlobRefs<TOptions extends EnumBlobRefsOptions>(\n  input: LexValue,\n  options: TOptions,\n): Generator<InferEnumBlobRefs<TOptions>, void, unknown>\nexport function enumBlobRefs(\n  input: LexValue,\n  options?: EnumBlobRefsOptions,\n): Generator<BlobRef | LegacyBlobRef, void, unknown>\nexport function* enumBlobRefs(\n  input: LexValue,\n  options?: EnumBlobRefsOptions,\n): Generator<BlobRef | LegacyBlobRef, void, unknown> {\n  // LegacyBlobRef not included by default\n  const includeLegacy = options?.allowLegacy === true\n\n  // Using a stack to avoid recursion depth issues.\n  const stack: LexValue[] = [input]\n\n  // Since we are using a stack, we could end-up in an infinite loop with cyclic\n  // structures. Cyclic structures are not valid LexValues and should, thus,\n  // never occur, but let's be safe.\n  const visited = new Set<object>()\n\n  do {\n    const value = stack.pop()!\n\n    if (value != null && typeof value === 'object') {\n      if (Array.isArray(value)) {\n        if (visited.has(value)) continue\n        visited.add(value)\n        stack.push(...value)\n      } else if (isPlainProto(value)) {\n        if (visited.has(value)) continue\n        visited.add(value)\n        if (isBlobRef(value, options)) {\n          yield value\n        } else if (includeLegacy && isLegacyBlobRef(value)) {\n          yield value\n        } else {\n          for (const v of Object.values(value)) {\n            if (v != null) stack.push(v)\n          }\n        }\n      }\n    }\n  } while (stack.length > 0)\n\n  // Optimization: ease GC's work\n  visited.clear()\n}\n"]}

package/dist/cid.d.ts

@@ -1,22 +1,55 @@
 import { CID } from 'multiformats/cid';
-export declare const DAG_CBOR_MULTICODEC = 113;
-export type DAG_CBOR_MULTICODEC = typeof DAG_CBOR_MULTICODEC;
-export declare const RAW_MULTICODEC = 85;
-export type RAW_MULTICODEC = typeof RAW_MULTICODEC;
-export declare const SHA256_MULTIHASH: 18;
-export type SHA256_MULTIHASH = typeof SHA256_MULTIHASH;
-export declare const SHA512_MULTIHASH: 19;
-export type SHA512_MULTIHASH = typeof SHA512_MULTIHASH;
-export interface Multihash<TCode extends number = number> {
+/**
+ * Codec code that indicates the CID references a CBOR-encoded data structure.
+ *
+ * Used when encoding structured data in AT Protocol repositories.
+ *
+ * @see {@link https://dasl.ing/cid.html Content IDs (DASL)}
+ */
+export declare const CBOR_DATA_CODEC = 113;
+export type CBOR_DATA_CODEC = typeof CBOR_DATA_CODEC;
+/**
+ * Codec code that indicates the CID references raw binary data (like media blobs).
+ *
+ * Used in DASL CIDs for binary blobs like images and media.
+ *
+ * @see {@link https://dasl.ing/cid.html Content IDs (DASL)}
+ */
+export declare const RAW_DATA_CODEC = 85;
+export type RAW_DATA_CODEC = typeof RAW_DATA_CODEC;
+/**
+ * Hash code that indicates that a CID uses SHA-256.
+ */
+export declare const SHA256_HASH_CODE: 18;
+export type SHA256_HASH_CODE = typeof SHA256_HASH_CODE;
+/**
+ * Hash code that indicates that a CID uses SHA-512.
+ */
+export declare const SHA512_HASH_CODE: 19;
+export type SHA512_HASH_CODE = typeof SHA512_HASH_CODE;
+/**
+ * Represent the hash part of a CID, which includes the hash algorithm code and
+ * the raw digest bytes.
+ *
+ * @see {@link https://dasl.ing/cid.html Content IDs (DASL)}
+ */
+export interface Multihash<THashCode extends number = number> {
     /**
-     * Code of the multihash
+     * Code of the hash algorithm (e.g., SHA256_HASH_CODE).
      */
-    code: TCode;
+    code: THashCode;
     /**
-     * Raw digest
+     * Raw digest bytes.
      */
     digest: Uint8Array;
 }
+/**
+ * Compares two {@link Multihash} for equality.
+ *
+ * @param a - First {@link Multihash}
+ * @param b - Second {@link Multihash}
+ * @returns `true` if both multihashes have the same code and digest
+ */
 export declare function multihashEquals(a: Multihash, b: Multihash): boolean;
 declare module 'multiformats/cid' {
     /**
@@ -50,45 +83,124 @@ export { /** @deprecated */ CID };
  * implementation directly. This is to avoid compatibility issues, and in order
  * to allow better portability, compatibility and future updates.
  */
-export declare function asMultiformatsCID<TVersion extends 0 | 1 = 0 | 1, TCode extends number = number, TMultihashCode extends number = number>(input: Cid<TVersion, TCode, TMultihashCode>): CID & Cid<TVersion, TCode, TMultihashCode>;
+export declare function asMultiformatsCID<TVersion extends 0 | 1 = 0 | 1, TCodec extends number = number, THashCode extends number = number>(input: Cid<TVersion, TCodec, THashCode>): CID & Cid<TVersion, TCodec, THashCode>;
 /**
- * Interface for working with CIDs
+ * Content Identifier (CID) for addressing content by its hash.
+ *
+ * CIDs are self-describing content addresses used throughout AT Protocol for
+ * linking to data by its cryptographic hash. This interface provides a
+ * stable API that is compatible with the `multiformats` library but avoids
+ * direct dependency issues.
+ *
+ * @typeParam TVersion - CID version (0 or 1)
+ * @typeParam TCodec - Multicodec content type code
+ * @typeParam THashCode - Multihash algorithm code
+ *
+ * @example
+ * ```typescript
+ * import type { Cid } from '@atproto/lex-data'
+ * import { parseCid, isCid } from '@atproto/lex-data'
+ *
+ * // Parse a CID from a string
+ * const cid: Cid = parseCid('bafyreib...')
+ *
+ * // Check if a value is a CID
+ * if (isCid(value)) {
+ *   console.log(cid.toString())
+ * }
+ * ```
+ *
+ * @see {@link isCid} to check if a value is a valid CID
+ * @see {@link parseCid} to parse a CID from a string
+ * @see {@link decodeCid} to decode a CID from bytes
+ * @see {@link https://dasl.ing/cid.html Content IDs (DASL)}
  */
-export interface Cid<TVersion extends 0 | 1 = 0 | 1, TCode extends number = number, TMultihashCode extends number = number> {
+export interface Cid<TVersion extends 0 | 1 = 0 | 1, TCodec extends number = number, THashCode extends number = number> {
+    /** CID version (0 or 1). AT Protocol uses CIDv1. */
     readonly version: TVersion;
-    readonly code: TCode;
-    readonly multihash: Multihash<TMultihashCode>;
+    /** Coded (e.g., {@link CBOR_DATA_CODEC}, {@link RAW_DATA_CODEC}). */
+    readonly code: TCodec;
+    /** The multihash containing the hash algorithm and digest. */
+    readonly multihash: Multihash<THashCode>;
     /**
      * Binary representation of the whole CID.
      */
     readonly bytes: Uint8Array;
+    /**
+     * Compares this CID with another for equality.
+     *
+     * @param other - The CID to compare with
+     * @returns `true` if the CIDs are equal
+     */
     equals(other: Cid): boolean;
+    /**
+     * Returns the string representation of this CID (base32 for v1, base58btc for v0).
+     */
     toString(): string;
 }
 /**
- * Represents the cid of raw binary data (like media blobs).
+ * Represents the CID of raw binary data (like media blobs).
  *
- * The use of {@link SHA256_MULTIHASH} is recommended but not required for raw CIDs.
+ * The use of {@link SHA256_HASH_CODE} is recommended but not required for raw CIDs.
  *
- * @see {@link https://atproto.com/specs/data-model#link-and-cid-formats ATproto Data Model - Link and CID Formats}
+ * @see {@link https://atproto.com/specs/data-model#link-and-cid-formats AT Protocol Data Model - Link and CID Formats}
+ */
+export type RawCid = Cid<1, RAW_DATA_CODEC>;
+/**
+ * Type guard to check if a CID is a raw binary CID.
+ *
+ * @param cid - The CID to check
+ * @returns `true` if the CID is a version 1 CID with raw multicodec
  */
-export type RawCid = Cid<1, RAW_MULTICODEC>;
 export declare function isRawCid(cid: Cid): cid is RawCid;
 /**
  * Represents a DASL compliant CID.
- * @see {@link https://dasl.ing/cid.html DASL-CIDs}
+ *
+ * DASL CIDs are version 1 CIDs using either raw or DAG-CBOR multicodec
+ * with SHA-256 multihash.
+ *
+ * @see {@link https://dasl.ing/cid.html Content IDs (DASL)}
+ */
+export type DaslCid = Cid<1, RAW_DATA_CODEC | CBOR_DATA_CODEC, SHA256_HASH_CODE>;
+/**
+ * Type guard to check if a CID is DASL compliant.
+ *
+ * @param cid - The CID to check
+ * @returns `true` if the CID is DASL compliant (v1, raw/dag-cbor, sha256)
  */
-export type DaslCid = Cid<1, RAW_MULTICODEC | DAG_CBOR_MULTICODEC, SHA256_MULTIHASH>;
 export declare function isDaslCid(cid: Cid): cid is DaslCid;
 /**
- * Represents the cid of ATProto DAG-CBOR data (like repository MST nodes).
- * @see {@link https://atproto.com/specs/data-model#link-and-cid-formats ATproto Data Model - Link and CID Formats}
+ * Represents the CID of AT Protocol DAG-CBOR data (like repository MST nodes).
+ *
+ * CBOR CIDs are version 1 CIDs using DAG-CBOR multicodec with SHA-256 multihash.
+ *
+ * @see {@link https://atproto.com/specs/data-model#link-and-cid-formats AT Protocol Data Model - Link and CID Formats}
+ */
+export type CborCid = Cid<1, CBOR_DATA_CODEC, SHA256_HASH_CODE>;
+/**
+ * Type guard to check if a CID is a DAG-CBOR CID.
+ *
+ * @param cid - The CID to check
+ * @returns `true` if the CID is a DAG-CBOR CID (v1, dag-cbor, sha256)
  */
-export type CborCid = Cid<1, DAG_CBOR_MULTICODEC, SHA256_MULTIHASH>;
 export declare function isCborCid(cid: Cid): cid is CborCid;
+/**
+ * Options for checking CID flavor constraints.
+ */
 export type CheckCidOptions = {
+    /**
+     * The CID flavor to check for.
+     * - `'raw'` - Raw binary CID ({@link RawCid})
+     * - `'cbor'` - DAG-CBOR CID ({@link CborCid})
+     * - `'dasl'` - DASL compliant CID ({@link DaslCid})
+     */
     flavor?: 'raw' | 'cbor' | 'dasl';
 };
+/**
+ * Infers the CID type based on check options.
+ *
+ * @typeParam TOptions - The options used for checking
+ */
 export type InferCheckedCid<TOptions> = TOptions extends {
     flavor: 'raw';
 } ? RawCid : TOptions extends {
@@ -133,9 +245,43 @@ export declare function decodeCid(cidBytes: Uint8Array, options?: CheckCidOption
  */
 export declare function parseCid<TOptions extends CheckCidOptions>(input: string, options: TOptions): InferCheckedCid<TOptions>;
 export declare function parseCid(input: string, options?: CheckCidOptions): Cid;
+/**
+ * Validates that a string is a valid CID representation.
+ *
+ * Unlike {@link parseCid}, this function returns a boolean instead of throwing.
+ * It also verifies that the string is the canonical representation of the CID.
+ *
+ * @param input - The string to validate
+ * @param options - Optional flavor constraints
+ * @returns `true` if the string is a valid CID
+ */
 export declare function validateCidString(input: string, options?: CheckCidOptions): boolean;
+/**
+ * Safely parses a CID string, returning `null` on failure instead of throwing.
+ *
+ * @param input - The string to parse
+ * @param options - Optional flavor constraints
+ * @returns The parsed CID, or `null` if parsing fails
+ *
+ * @example
+ * ```typescript
+ * import { parseCidSafe } from '@atproto/lex-data'
+ *
+ * const cid = parseCidSafe('bafyreib...')
+ * if (cid) {
+ *   console.log(cid.toString())
+ * }
+ * ```
+ */
 export declare function parseCidSafe<TOptions extends CheckCidOptions>(input: string, options: TOptions): InferCheckedCid<TOptions> | null;
 export declare function parseCidSafe(input: string, options?: CheckCidOptions): Cid | null;
+/**
+ * Ensures that a string is a valid CID representation.
+ *
+ * @param input - The string to validate
+ * @param options - Optional flavor constraints
+ * @throws If the string is not a valid CID
+ */
 export declare function ensureValidCidString(input: string, options?: CheckCidOptions): void;
 /**
  * Verifies whether the multihash of a given {@link cid} matches the hash of the provided {@link bytes}.
@@ -144,8 +290,46 @@ export declare function ensureValidCidString(input: string, options?: CheckCidOp
  * @returns true if the CID matches the bytes, false otherwise.
  */
 export declare function isCidForBytes(cid: Cid, bytes: Uint8Array): Promise<boolean>;
-export declare function createCid<TCode extends number, TMultihashCode extends number>(code: TCode, multihashCode: TMultihashCode, digest: Uint8Array): Cid<1, TCode, TMultihashCode>;
+/**
+ * Creates a CID from a multicodec, multihash code, and digest.
+ *
+ * @param code - The multicodec content type code
+ * @param multihashCode - The multihash algorithm code
+ * @param digest - The raw hash digest bytes
+ * @returns A new CIDv1 instance
+ *
+ * @example
+ * ```typescript
+ * import { createCid, RAW_DATA_CODEC, SHA256_HASH_CODE } from '@atproto/lex-data'
+ *
+ * const cid = createCid(RAW_DATA_CODEC, SHA256_HASH_CODE, hashDigest)
+ * ```
+ */
+export declare function createCid<TCodec extends number, THashCode extends number>(code: TCodec, multihashCode: THashCode, digest: Uint8Array): Cid<1, TCodec, THashCode>;
+/**
+ * Creates a DAG-CBOR CID for the given CBOR bytes.
+ *
+ * Computes the SHA-256 hash of the bytes and creates a CIDv1 with DAG-CBOR multicodec.
+ *
+ * @param bytes - The CBOR-encoded bytes to hash
+ * @returns A promise that resolves to the CborCid
+ */
 export declare function cidForCbor(bytes: Uint8Array): Promise<CborCid>;
+/**
+ * Creates a raw CID for the given binary bytes.
+ *
+ * Computes the SHA-256 hash of the bytes and creates a CIDv1 with raw multicodec.
+ *
+ * @param bytes - The raw binary bytes to hash
+ * @returns A promise that resolves to the RawCid
+ */
 export declare function cidForRawBytes(bytes: Uint8Array): Promise<RawCid>;
+/**
+ * Creates a raw CID from an existing SHA-256 hash digest.
+ *
+ * @param digest - The SHA-256 hash digest (must be 32 bytes)
+ * @returns A RawCid with the given digest
+ * @throws If the digest length is not 32 bytes
+ */
 export declare function cidForRawHash(digest: Uint8Array): RawCid;
 //# sourceMappingURL=cid.d.ts.map

package/dist/cid.d.ts.map

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