@tileflow/static 0.1.0-alpha.17 → 0.1.0-alpha.19

package/dist/chunk-HKYA7ZIU.js

@@ -0,0 +1,79 @@
+import {
+  normalizeStaticScene,
+  validateStaticScene
+} from "./chunk-ROBEGDDY.js";
+import {
+  hashStableValue,
+  isSafeHttpUrl,
+  staticSceneSchema,
+  stripUndefined
+} from "./chunk-YUG3PBK2.js";
+
+// src/manifest.ts
+import { z } from "zod";
+var staticRendererSchemaVersion = 1;
+var staticRenderManifestSchema = z.object({
+  mapId: z.string().trim().min(1).max(128),
+  rendererVersion: z.string().trim().min(1).max(64),
+  schemaVersion: z.literal(staticRendererSchemaVersion),
+  scene: staticSceneSchema,
+  styleId: z.string().trim().min(1).max(128).optional(),
+  styleRevision: z.string().trim().min(1).max(128),
+  styleUrl: z.string().trim().url().max(512).refine(isSafeHttpUrl, {
+    message: "Expected an http(s) style URL without credentials or a fragment"
+  })
+});
+function validateStaticRenderManifest(input) {
+  const parsed = staticRenderManifestSchema.safeParse(input);
+  if (!parsed.success) {
+    return {
+      error: parsed.error.issues.map((issue) => `${issue.path.join(".") || "manifest"}: ${issue.message}`).join("; "),
+      ok: false
+    };
+  }
+  const sceneValidation = validateStaticScene(parsed.data.scene);
+  if (!sceneValidation.ok) {
+    return sceneValidation;
+  }
+  return {
+    manifest: {
+      ...parsed.data,
+      scene: sceneValidation.scene
+    },
+    ok: true
+  };
+}
+function createRenderManifest(input) {
+  return staticRenderManifestSchema.parse(
+    stripUndefined({
+      mapId: input.mapId,
+      rendererVersion: input.rendererVersion,
+      schemaVersion: staticRendererSchemaVersion,
+      scene: normalizeStaticScene(input.scene),
+      styleId: input.styleId,
+      styleRevision: input.styleRevision,
+      styleUrl: input.styleUrl
+    })
+  );
+}
+async function hashRenderManifest(manifest) {
+  const normalized = staticRenderManifestSchema.parse({
+    ...manifest,
+    scene: normalizeStaticScene(manifest.scene)
+  });
+  return hashStableValue(normalized);
+}
+async function hashStaticSceneRequest(scene) {
+  const validation = validateStaticScene(scene);
+  if (!validation.ok) throw new Error(`Invalid Tileflow static scene: ${validation.error}`);
+  return hashStableValue(validation.scene);
+}
+
+export {
+  staticRendererSchemaVersion,
+  staticRenderManifestSchema,
+  validateStaticRenderManifest,
+  createRenderManifest,
+  hashRenderManifest,
+  hashStaticSceneRequest
+};

package/dist/chunk-LGEYA6FQ.js

@@ -0,0 +1,106 @@
+import {
+  normalizeStaticOverlay
+} from "./chunk-YUG3PBK2.js";
+
+// src/overlays.ts
+function line(input) {
+  return normalizeStaticOverlay({ ...input, type: "line" });
+}
+function circle(input) {
+  return normalizeStaticOverlay({ ...input, type: "circle" });
+}
+function marker(input) {
+  return normalizeStaticOverlay({ ...input, type: "marker" });
+}
+function polygon(input) {
+  return normalizeStaticOverlay({ ...input, type: "polygon" });
+}
+function compileStaticOverlays(overlays) {
+  const sources = {};
+  const layers = [];
+  for (const [index, overlay] of overlays.entries()) {
+    const id = safeLayerId(`overlay-${index + 1}-${overlay.id ?? overlay.type}`);
+    const sourceId = `${id}-source`;
+    if (overlay.type === "line") {
+      sources[sourceId] = {
+        data: feature("LineString", overlay.coordinates),
+        type: "geojson"
+      };
+      layers.push({
+        id,
+        layout: { "line-cap": "round", "line-join": "round" },
+        paint: {
+          "line-color": overlay.color,
+          "line-opacity": overlay.opacity,
+          "line-width": overlay.width
+        },
+        source: sourceId,
+        type: "line"
+      });
+      continue;
+    }
+    if (overlay.type === "polygon") {
+      sources[sourceId] = {
+        data: feature("Polygon", overlay.coordinates),
+        type: "geojson"
+      };
+      layers.push({
+        id,
+        paint: {
+          "fill-color": overlay.fill,
+          "fill-opacity": overlay.opacity
+        },
+        source: sourceId,
+        type: "fill"
+      });
+      if (overlay.stroke && overlay.strokeWidth > 0) {
+        layers.push({
+          id: `${id}-stroke`,
+          layout: { "line-cap": "round", "line-join": "round" },
+          paint: {
+            "line-color": overlay.stroke,
+            "line-width": overlay.strokeWidth
+          },
+          source: sourceId,
+          type: "line"
+        });
+      }
+      continue;
+    }
+    sources[sourceId] = {
+      data: feature("Point", overlay.coordinate),
+      type: "geojson"
+    };
+    layers.push({
+      id,
+      paint: {
+        "circle-color": overlay.color,
+        "circle-opacity": overlay.type === "circle" ? overlay.opacity : 1,
+        "circle-radius": overlay.radius,
+        "circle-stroke-color": overlay.strokeColor ?? overlay.color,
+        "circle-stroke-width": overlay.strokeWidth
+      },
+      source: sourceId,
+      type: "circle"
+    });
+  }
+  return { layers, sources };
+}
+function feature(type, coordinates) {
+  return {
+    geometry: { coordinates, type },
+    properties: {},
+    type: "Feature"
+  };
+}
+function safeLayerId(value) {
+  return value.replace(/[^a-zA-Z0-9_-]/g, "-").slice(0, 80);
+}
+
+export {
+  line,
+  circle,
+  marker,
+  polygon,
+  compileStaticOverlays
+};

package/dist/chunk-ROBEGDDY.js

@@ -0,0 +1,63 @@
+import {
+  jsonByteLength,
+  normalizeStaticCoordinate,
+  normalizeStaticOverlay,
+  roundNumber,
+  staticSceneLimits,
+  staticSceneSchema,
+  stripUndefined
+} from "./chunk-YUG3PBK2.js";
+
+// src/scene.ts
+function validateStaticScene(input) {
+  const parsed = staticSceneSchema.safeParse(input);
+  if (!parsed.success) {
+    return {
+      error: parsed.error.issues.map((issue) => `${issue.path.join(".") || "scene"}: ${issue.message}`).join("; "),
+      ok: false
+    };
+  }
+  if (jsonByteLength(parsed.data.overlays) > staticSceneLimits.maxGeoJsonBytes) {
+    return {
+      error: `overlays exceed ${staticSceneLimits.maxGeoJsonBytes} bytes`,
+      ok: false
+    };
+  }
+  return { ok: true, scene: normalizeParsedStaticScene(parsed.data) };
+}
+function normalizeStaticScene(scene) {
+  return normalizeParsedStaticScene(staticSceneSchema.parse(scene));
+}
+function normalizeParsedStaticScene(parsed) {
+  return stripUndefined({
+    camera: parsed.camera.type === "center" ? {
+      bearing: roundNumber(parsed.camera.bearing ?? 0),
+      center: normalizeStaticCoordinate(parsed.camera.center),
+      type: "center",
+      zoom: roundNumber(parsed.camera.zoom)
+    } : {
+      bearing: roundNumber(parsed.camera.bearing ?? 0),
+      bounds: parsed.camera.bounds.map(roundNumber),
+      padding: parsed.camera.padding ?? 32,
+      type: "bounds"
+    },
+    map: parsed.map,
+    overlays: parsed.overlays.map(
+      (overlay, index) => normalizeStaticOverlay({
+        ...overlay,
+        id: overlay.id ?? `overlay-${index + 1}`
+      })
+    ),
+    size: {
+      dpr: parsed.size.dpr ?? 1,
+      height: parsed.size.height,
+      width: parsed.size.width
+    },
+    theme: parsed.theme
+  });
+}
+
+export {
+  validateStaticScene,
+  normalizeStaticScene
+};

package/dist/chunk-YUG3PBK2.js

@@ -0,0 +1,198 @@
+// src/canonical.ts
+function stableStringify(value) {
+  return JSON.stringify(sortJson(value));
+}
+function roundNumber(value) {
+  return Number(value.toFixed(6));
+}
+function stripUndefined(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return value;
+  }
+  return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== void 0));
+}
+function jsonByteLength(value) {
+  return new TextEncoder().encode(JSON.stringify(value)).length;
+}
+async function hashStableValue(value) {
+  const bytes = new TextEncoder().encode(stableStringify(value));
+  const digest = await crypto.subtle.digest("SHA-256", bytes);
+  return base64Url(new Uint8Array(digest));
+}
+function isSafeHttpUrl(value) {
+  try {
+    const url = new URL(value);
+    return ["http:", "https:"].includes(url.protocol) && !url.username && !url.password && !url.hash;
+  } catch {
+    return false;
+  }
+}
+function sortJson(value) {
+  if (Array.isArray(value)) {
+    return value.map(sortJson);
+  }
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, entry]) => [key, sortJson(entry)])
+    );
+  }
+  return value;
+}
+function base64Url(bytes) {
+  let binary = "";
+  for (const byte of bytes) {
+    binary += String.fromCharCode(byte);
+  }
+  return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
+}
+
+// src/scene-contract.ts
+import { z } from "zod";
+var staticSceneSchemaVersion = 1;
+var staticSceneLimits = {
+  maxDimension: 1280,
+  maxGeoJsonBytes: 96e3,
+  maxOverlays: 24,
+  maxPathCoordinates: 2e3,
+  maxPhysicalPixels: 1280 * 1280,
+  minDimension: 64
+};
+var coordinateSchema = z.tuple([z.number().finite(), z.number().finite()]).refine(([lng, lat]) => lng >= -180 && lng <= 180 && lat >= -90 && lat <= 90, {
+  message: "Expected [lng, lat] within world bounds"
+});
+var colorSchema = z.string().regex(/^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/, {
+  message: "Expected a hex color like #C6A15B"
+});
+var portableIdSchema = z.string().min(1).max(64).regex(/^[a-z][a-z0-9-]{0,63}$/u, {
+  message: "Expected lowercase kebab-case beginning with a letter"
+}).refine(
+  (name) => !["constructor", "prototype"].includes(name) && !/^(?:AUX|CON|NUL|PRN|COM[1-9]|LPT[1-9])$/i.test(name),
+  "Expected a portable identifier that is not a reserved filename or prototype key"
+);
+var concreteThemeSchema = portableIdSchema.refine((value) => value !== "system", {
+  message: 'Static maps require a concrete theme; "system" is browser-only'
+});
+var sizeSchema = z.object({
+  dpr: z.literal(1).optional(),
+  height: z.number().int().min(staticSceneLimits.minDimension).max(staticSceneLimits.maxDimension),
+  width: z.number().int().min(staticSceneLimits.minDimension).max(staticSceneLimits.maxDimension)
+}).refine(
+  (size) => size.width * size.height * (size.dpr ?? 1) <= staticSceneLimits.maxPhysicalPixels,
+  {
+    message: "Static map exceeds the maximum render pixel budget"
+  }
+);
+var centerCameraSchema = z.object({
+  bearing: z.number().finite().min(-180).max(180).optional(),
+  center: coordinateSchema,
+  type: z.literal("center"),
+  zoom: z.number().finite().min(0).max(22)
+});
+var boundsCameraSchema = z.object({
+  bearing: z.number().finite().min(-180).max(180).optional(),
+  bounds: z.tuple([z.number().finite(), z.number().finite(), z.number().finite(), z.number().finite()]).refine(
+    ([west, south, east, north]) => west >= -180 && west <= 180 && east >= -180 && east <= 180 && south >= -90 && south <= 90 && north >= -90 && north <= 90 && west !== east && south !== north,
+    { message: "Expected bounds as [west, south, east, north]" }
+  ),
+  padding: z.number().int().min(0).max(256).optional(),
+  type: z.literal("bounds")
+}).refine((camera) => camera.bounds[3] > camera.bounds[1], {
+  message: "Bounds north must be greater than south"
+});
+var lineOverlaySchema = z.object({
+  color: colorSchema.default("#C6A15B"),
+  coordinates: z.array(coordinateSchema).min(2).max(staticSceneLimits.maxPathCoordinates),
+  id: z.string().trim().min(1).max(64).optional(),
+  opacity: z.number().finite().min(0).max(1).default(1),
+  type: z.literal("line"),
+  width: z.number().finite().min(0.5).max(32).default(4)
+});
+var circleOverlaySchema = z.object({
+  color: colorSchema.default("#C6A15B"),
+  coordinate: coordinateSchema,
+  id: z.string().trim().min(1).max(64).optional(),
+  opacity: z.number().finite().min(0).max(1).default(1),
+  radius: z.number().finite().min(1).max(64).default(6),
+  strokeColor: colorSchema.optional(),
+  strokeWidth: z.number().finite().min(0).max(16).default(0),
+  type: z.literal("circle")
+});
+var markerOverlaySchema = z.object({
+  color: colorSchema.default("#C6A15B"),
+  coordinate: coordinateSchema,
+  id: z.string().trim().min(1).max(64).optional(),
+  radius: z.number().finite().min(2).max(64).default(8),
+  strokeColor: colorSchema.default("#ffffff"),
+  strokeWidth: z.number().finite().min(0).max(16).default(2),
+  type: z.literal("marker")
+});
+var polygonRingSchema = z.array(coordinateSchema).min(4).max(staticSceneLimits.maxPathCoordinates).refine(
+  (ring) => {
+    const first = ring[0];
+    const last = ring[ring.length - 1];
+    return Boolean(first && last && first[0] === last[0] && first[1] === last[1]);
+  },
+  { message: "Polygon rings must end at their starting coordinate" }
+);
+var polygonOverlaySchema = z.object({
+  coordinates: z.array(polygonRingSchema).min(1).max(16),
+  fill: colorSchema.default("#C6A15B"),
+  id: z.string().trim().min(1).max(64).optional(),
+  opacity: z.number().finite().min(0).max(1).default(0.28),
+  stroke: colorSchema.optional(),
+  strokeWidth: z.number().finite().min(0).max(16).default(0),
+  type: z.literal("polygon")
+});
+var staticOverlaySchema = z.discriminatedUnion("type", [
+  lineOverlaySchema,
+  circleOverlaySchema,
+  markerOverlaySchema,
+  polygonOverlaySchema
+]);
+var staticSceneSchema = z.object({
+  camera: z.discriminatedUnion("type", [centerCameraSchema, boundsCameraSchema]),
+  map: portableIdSchema,
+  overlays: z.array(staticOverlaySchema).max(staticSceneLimits.maxOverlays).default([]),
+  size: sizeSchema,
+  theme: concreteThemeSchema
+});
+
+// src/overlay-normalization.ts
+function normalizeStaticOverlay(overlay) {
+  const parsed = staticOverlaySchema.parse(overlay);
+  const normalized = stripUndefined({ ...parsed });
+  if ("coordinate" in normalized) {
+    normalized.coordinate = normalizeStaticCoordinate(normalized.coordinate);
+  }
+  if ("coordinates" in normalized) {
+    normalized.coordinates = normalizeStaticCoordinates(normalized.coordinates);
+  }
+  return normalized;
+}
+function normalizeStaticCoordinate(coordinate) {
+  return [roundNumber(coordinate[0]), roundNumber(coordinate[1])];
+}
+function normalizeStaticCoordinates(value) {
+  if (!Array.isArray(value)) {
+    return value;
+  }
+  if (value.length === 2 && typeof value[0] === "number" && typeof value[1] === "number") {
+    return normalizeStaticCoordinate(value);
+  }
+  return value.map(normalizeStaticCoordinates);
+}
+
+export {
+  stableStringify,
+  roundNumber,
+  stripUndefined,
+  jsonByteLength,
+  hashStableValue,
+  isSafeHttpUrl,
+  staticSceneSchemaVersion,
+  staticSceneLimits,
+  staticOverlaySchema,
+  staticSceneSchema,
+  normalizeStaticOverlay,
+  normalizeStaticCoordinate
+};

package/dist/client.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import { d as StaticSceneInput } from './scene-contract-DzsUeJ_V.js';
+
+declare function stableStringify(value: unknown): string;
+
+type StaticMapResult = {
+    cached: boolean;
+    hash: string;
+    imageUrl: string;
+    operationId: string | null;
+    remainingUnits: number | null;
+    status: 'ready';
+    unitCost: 0 | 15;
+};
+type StaticMapCreateOptions = {
+    apiKey?: string;
+    apiUrl?: string;
+    fetch?: typeof fetch;
+    idempotencyKey: string;
+    maxWaitMs?: number;
+    pollIntervalMs?: number;
+    signal?: AbortSignal;
+};
+type StaticMapEndpointRequestOptions = Omit<StaticMapCreateOptions, 'apiUrl'> & {
+    createUrl: string;
+};
+type PreparedStaticMapRequest = Readonly<{
+    sceneKey: string;
+}>;
+declare const staticMapReadyResultSchema: z.ZodObject<{
+    cached: z.ZodBoolean;
+    hash: z.ZodString;
+    imageUrl: z.ZodString;
+    operationId: z.ZodString;
+    remainingUnits: z.ZodNumber;
+    status: z.ZodLiteral<"ready">;
+    unitCost: z.ZodLiteral<15>;
+}, z.core.$strict>;
+declare const staticMapProcessingResultSchema: z.ZodObject<{
+    operationId: z.ZodString;
+    retryAfterMs: z.ZodNumber;
+    status: z.ZodLiteral<"processing">;
+}, z.core.$strict>;
+
+declare function validateStaticMapIdempotencyKey(value: unknown): {
+    key: string;
+    ok: true;
+} | {
+    error: string;
+    ok: false;
+};
+declare function createStaticMapIdempotencyKey(): string;
+declare function prepareStaticMapRequest(scene: StaticSceneInput): PreparedStaticMapRequest;
+declare function createStaticMap(scene: StaticSceneInput, options: StaticMapCreateOptions): Promise<StaticMapResult>;
+declare function precacheStaticMap(scene: StaticSceneInput, options: StaticMapCreateOptions): Promise<StaticMapResult>;
+declare function requestStaticMapUntilReady(request: PreparedStaticMapRequest, options: StaticMapEndpointRequestOptions): Promise<StaticMapResult>;
+
+export { type PreparedStaticMapRequest, type StaticMapCreateOptions, type StaticMapEndpointRequestOptions, type StaticMapResult, createStaticMap, createStaticMapIdempotencyKey, precacheStaticMap, prepareStaticMapRequest, requestStaticMapUntilReady, stableStringify, staticMapProcessingResultSchema, staticMapReadyResultSchema, validateStaticMapIdempotencyKey };

package/dist/client.js

@@ -0,0 +1,25 @@
+import {
+  createStaticMap,
+  createStaticMapIdempotencyKey,
+  precacheStaticMap,
+  prepareStaticMapRequest,
+  requestStaticMapUntilReady,
+  staticMapProcessingResultSchema,
+  staticMapReadyResultSchema,
+  validateStaticMapIdempotencyKey
+} from "./chunk-43QGLF6K.js";
+import "./chunk-ROBEGDDY.js";
+import {
+  stableStringify
+} from "./chunk-YUG3PBK2.js";
+export {
+  createStaticMap,
+  createStaticMapIdempotencyKey,
+  precacheStaticMap,
+  prepareStaticMapRequest,
+  requestStaticMapUntilReady,
+  stableStringify,
+  staticMapProcessingResultSchema,
+  staticMapReadyResultSchema,
+  validateStaticMapIdempotencyKey
+};