@tileflow/static 0.1.0-alpha.24 → 0.1.0-alpha.25

package/README.md

@@ -237,3 +237,11 @@ logical operation, including a distinct-key cache reuse. Downloading an immutabl
 consumes zero units.
 
 Docs: https://tileflow.dev/docs
+
+## Team credentials
+
+A Team credential can serve multiple Maps. Pass `mapId` in the options to `createStaticMap` or
+`precacheStaticMap`; it must be a Managed Map ID such as `map_1234567890abcdef`. The client sends
+`X-Tileflow-Map-Id` separately from the portable scene. `scene.map` remains the deployed environment
+name. The Hosted API must support unified Team credentials and authorize the selected Map.
+Existing Map-scoped keys remain usable without this option. Keep either key on a trusted server.

package/dist/{chunk-N63IFMFM.js → chunk-RGXE4HDY.js}

@@ -136,6 +136,12 @@ async function requestStaticMapUntilReady(request, options) {
   if (options.apiKey) {
     headers.Authorization = `Bearer ${options.apiKey}`;
   }
+  if (options.mapId !== void 0) {
+    if (!/^map_[A-Za-z0-9_-]{16}$/u.test(options.mapId)) {
+      throw new Error("Invalid Tileflow Map ID.");
+    }
+    headers["X-Tileflow-Map-Id"] = options.mapId;
+  }
   return runWithinStaticMapBudget(maxWaitMs, options.signal, async (signal) => {
     let operationId = null;
     while (true) {

package/dist/client.d.ts

@@ -39,6 +39,7 @@ type StaticMapHostedResult = StaticMapResultBase & Readonly<{
 type StaticMapResult = StaticMapImageResult | StaticMapHostedResult;
 type StaticMapCreateOptions = {
     apiKey?: string;
+    mapId?: string;
     apiUrl?: string;
     fetch?: typeof fetch;
     idempotencyKey: string;

package/dist/client.js

@@ -10,7 +10,7 @@ import {
   staticMapHostedResultSchema,
   staticMapProcessingResultSchema,
   validateStaticMapIdempotencyKey
-} from "./chunk-N63IFMFM.js";
+} from "./chunk-RGXE4HDY.js";
 import {
   StaticMapError,
   staticMapErrorResponseSchema

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   staticMapHostedResultSchema,
   staticMapProcessingResultSchema,
   validateStaticMapIdempotencyKey
-} from "./chunk-N63IFMFM.js";
+} from "./chunk-RGXE4HDY.js";
 import {
   createRenderManifest,
   hashRenderManifest,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/static",
-  "version": "0.1.0-alpha.24",
+  "version": "0.1.0-alpha.25",
   "license": "Apache-2.0",
   "description": "Static map request schemas and helpers for Tileflow.",
   "type": "module",