styled-map-package 1.0.0

package/test/utils/image-streams.js

@@ -0,0 +1,30 @@
+// @ts-ignore
+import JPEGEncoder from '@stealthybox/jpg-stream/encoder.js'
+// @ts-ignore
+import BlockStream from 'block-stream2'
+// @ts-ignore
+import PNGEncoder from 'png-stream/encoder.js'
+import randomBytesReadableStream from 'random-bytes-readable-stream'
+
+/**
+ * Create a random-noise image stream with the given dimensions, either PNG or
+ * JPEG.
+ *
+ * @param {object} options
+ * @param {number} options.width
+ * @param {number} options.height
+ * @param {'png' | 'jpg'} options.format
+ * @returns
+ */
+export function randomImageStream({ width, height, format }) {
+  const encoder =
+    format === 'jpg'
+      ? new JPEGEncoder(width, height, { colorSpace: 'rgb', quality: 30 })
+      : new PNGEncoder(width, height, { colorSpace: 'rgb' })
+  return (
+    randomBytesReadableStream({ size: width * height * 3 })
+      // JPEG Encoder requires one line at a time
+      .pipe(new BlockStream({ size: width * 3 }))
+      .pipe(encoder)
+  )
+}

package/test/utils/reader-helper.js

@@ -0,0 +1,72 @@
+import { once } from 'node:events'
+
+import { replaceVariables } from '../../lib/utils/templates.js'
+import { DigestStream } from './digest-stream.js'
+
+/** @import { Reader } from '../../lib/index.js' */
+/**
+ * A helper class for reading resources from a styled map package.
+ */
+export class ReaderHelper {
+  #reader
+  /** @type {Awaited<ReturnType<Reader['getStyle']>> | undefined} */
+  #style
+  /** @param {Reader} reader */
+  constructor(reader) {
+    this.#reader = reader
+  }
+
+  /** @param {string} path */
+  async #digest(path) {
+    const resource = await this.#reader.getResource(path)
+    const digestStream = new DigestStream('md5')
+    resource.stream.pipe(digestStream).resume()
+    await once(digestStream, 'finish')
+    return digestStream.digest('hex')
+  }
+
+  /**
+   * @param {{ z: number, x: number, y: number, sourceId: string }} opts
+   */
+  async getTileHash({ z, x, y, sourceId }) {
+    const style = this.#style || (this.#style = await this.#reader.getStyle(''))
+    const source = style.sources[sourceId]
+    if (!source || !('tiles' in source) || !source.tiles) {
+      throw new Error(`Source not found: ${sourceId}`)
+    }
+    const tilePath = replaceVariables(source.tiles[0], { z, x, y })
+    return this.#digest(tilePath)
+  }
+
+  /**
+   * @param {import('../../lib/writer.js').GlyphInfo} glyphInfo
+   */
+  async getGlyphHash({ font, range }) {
+    const style = this.#style || (this.#style = await this.#reader.getStyle(''))
+    if (typeof style.glyphs !== 'string') {
+      throw new Error('No glyphs defined in style')
+    }
+    const glyphPath = replaceVariables(style.glyphs, { fontstack: font, range })
+    return this.#digest(glyphPath)
+  }
+
+  /** @param {{ id?: string, pixelRatio?: 1 | 2 | 3, ext: 'json' | 'png'}} opts */
+  async getSpriteHash({ id, pixelRatio = 1, ext }) {
+    const style = this.#style || (this.#style = await this.#reader.getStyle(''))
+    if (!style.sprite) {
+      throw new Error('No sprites defined in style')
+    }
+    const pixelRatioString = pixelRatio === 1 ? '' : `@${pixelRatio}x`
+    let spritePath
+    if (typeof style.sprite === 'string') {
+      spritePath = style.sprite + pixelRatioString + '.' + ext
+    } else {
+      const sprite = style.sprite.find((s) => s.id === (id || 'default'))
+      if (!sprite) {
+        throw new Error(`Sprite not found: ${id}`)
+      }
+      spritePath = sprite.url + pixelRatioString + '.' + ext
+    }
+    return this.#digest(spritePath)
+  }
+}