@tileflow/search 0.1.0-alpha.3 → 0.1.0-alpha.4

package/README.md

@@ -110,9 +110,77 @@ export const suggestPlaces = (query: string) => autocomplete({query, language: '
 export const resolveSelection = (token: string) => resolveSuggestion({token}, options);
 ```
 
-Text search and Nearby are distinct operations. Suggestions have no position. Resolve only the
-selected suggestion. Reverse results are candidates in provider order, without containment,
-entrance precision, routability, deliverability or address-validation guarantees.
+Text search and Nearby are distinct operations. A suggestion has a title, an optional one-line
+`addressLabel` that tells same-named places apart, and no position. Resolve only the selected
+suggestion. Reverse results are candidates in provider order, without containment, entrance
+precision, routability, deliverability or address-validation guarantees.
+
+To show positions, distances and categories while someone types, ask for each suggestion's place.
+A completed request then uses 25 units instead of 10, and choosing a suggestion needs no further
+resolution:
+
+<!-- docs:check -->
+
+```ts
+import {autocomplete} from '@tileflow/search';
+
+const apiKey = process.env.TILEFLOW_API_KEY;
+if (!apiKey) throw new Error('Set TILEFLOW_API_KEY on the server.');
+const options = {apiKey};
+
+export async function suggestNearbyPlaces(query: string, proximity: [number, number]) {
+  const {suggestions} = await autocomplete({query, proximity, include: ['place']}, options);
+  return suggestions.map(({label, addressLabel, place}) => ({
+    label,
+    addressLabel,
+    position: place?.position,
+    distanceMeters: place?.distanceMeters,
+  }));
+}
+```
+
+## Place details
+
+Results carry an optional `distanceMeters` when the provider reports one: from `proximity`, from
+the centre of `bounds`, or from the reverse or Nearby position. Places can also carry `foodTypes`.
+Other details are requested with `include` and make the operation an extended one:
+
+| Detail         | Returns                                                     | Available from                                           |
+| -------------- | ----------------------------------------------------------- | -------------------------------------------------------- |
+| `contacts`     | `phones`, `websites` and `emails`, each a `value` and label | Text search inside `bounds`, Nearby, explicit resolution |
+| `openingHours` | Display lines per schedule and `openNow` at request time    | Text search inside `bounds`, Nearby, explicit resolution |
+| `timeZone`     | IANA `name` and `utcOffsetSeconds`                          | Every place operation                                    |
+| `accessPoints` | Entrance or access positions, separate from `position`      | Every place operation                                    |
+
+Asking geocoding without `bounds`, or reverse geocoding, for contacts or opening hours fails with
+`GEOCODING_FILTER_UNSUPPORTED` before any request is sent. Each detail is optional in a response:
+a place whose hours the provider does not supply has no `openingHours`.
+
+<!-- docs:check -->
+
+```ts
+import {resolvePlace} from '@tileflow/search';
+
+const apiKey = process.env.TILEFLOW_API_KEY;
+if (!apiKey) throw new Error('Set TILEFLOW_API_KEY on the server.');
+const options = {apiKey};
+
+export async function placeCard(token: string) {
+  const {result} = await resolvePlace({token, include: ['contacts', 'openingHours']}, options);
+  const website = result.contacts?.websites?.find(({value}) => /^https?:\/\//iu.test(value));
+  return {
+    name: result.name ?? result.label,
+    openNow: result.openingHours?.some(({openNow}) => openNow) ?? false,
+    hours: result.openingHours?.flatMap(({display}) => display ?? []) ?? [],
+    phone: result.contacts?.phones?.[0]?.value,
+    website: website?.value,
+  };
+}
+```
+
+Contact values are provider text, not validated links: check the scheme before rendering one as
+a link, and expect several phones or websites for a place, not all equally relevant. `openNow`
+describes the moment of the request. Like every result, details are for temporary display.
 
 ## Limits and temporary use
 
@@ -140,15 +208,15 @@ retention, Advanced features and caller-selected provider options are rejected b
 
 ## Usage and errors
 
-| Completed operation                   | Shared API units |
-| ------------------------------------- | ---------------: |
-| Category discovery                    |                0 |
-| Autocomplete                          |               10 |
-| Forward, reverse, explicit resolution |               25 |
-| Each Nearby page                      |               25 |
+| Completed operation                   | Shared API units | With `include` |
+| ------------------------------------- | ---------------: | -------------: |
+| Category discovery                    |                0 |              — |
+| Autocomplete                          |               10 |             25 |
+| Forward, reverse, explicit resolution |               25 |             75 |
+| Each Nearby page                      |               25 |             75 |
 
-Valid empty responses consume the same units. Three autocomplete calls and one resolution consume
-55 units. These are part of Starter's shared API allowance, with no separate Search credits or
+`searchOperationUnits(operation, include)` returns the same weights. Valid empty responses consume
+the same units. Three autocomplete calls and one resolution consume 55 units. These are part of Starter's shared API allowance, with no separate Search credits or
 commercial search session. Hovering, displaying results and moving a map do not call Search.
 
 `GeocodingError` exposes `status`, nullable `code`, nullable `requestId` and nullable bounded

package/dist/{chunk-FEWG4I4E.js → chunk-QDEMNVJD.js}

@@ -10,8 +10,10 @@ import {
   nearbyResponseSchema,
   resolveSuggestionRequestSchema,
   resolveSuggestionResponseSchema,
-  searchCategoriesResponseSchema
-} from "./chunk-R7KE2IN7.js";
+  searchCategoriesResponseSchema,
+  searchContactDetails,
+  searchOperationUnits
+} from "./chunk-W66J2DAS.js";
 
 // src/client.ts
 import { z } from "zod";
@@ -91,12 +93,14 @@ async function geocode(request, options) {
   if (!parsedRequest.success) {
     throw new Error("Invalid Tileflow geocoding request");
   }
+  if (!parsedRequest.data.bounds) rejectContactDetails(parsedRequest.data.include);
+  const units = searchOperationUnits("forward", parsedRequest.data.include);
   return requestGeocoding(
     "/v1/geocoding/forward",
     parsedRequest.data,
     options,
     geocodingForwardResponseSchema,
-    (response) => response.results.length <= (parsedRequest.data.limit ?? geocodingLimits.defaultLimit)
+    (response) => response.usage.units === units && response.results.length <= (parsedRequest.data.limit ?? geocodingLimits.defaultLimit)
   );
 }
 async function geocodeReverse(request, options) {
@@ -104,12 +108,14 @@ async function geocodeReverse(request, options) {
   if (!parsedRequest.success) {
     throw new Error("Invalid Tileflow geocoding request");
   }
+  rejectContactDetails(parsedRequest.data.include);
+  const units = searchOperationUnits("reverse", parsedRequest.data.include);
   return requestGeocoding(
     "/v1/geocoding/reverse",
     parsedRequest.data,
     options,
     geocodingForwardResponseSchema,
-    (response) => response.results.length <= parsedRequest.data.limit && containsOnlyKinds(response, parsedRequest.data.kinds)
+    (response) => response.usage.units === units && response.results.length <= parsedRequest.data.limit && containsOnlyKinds(response, parsedRequest.data.kinds)
   );
 }
 async function autocomplete(request, options) {
@@ -117,12 +123,13 @@ async function autocomplete(request, options) {
   if (!parsedRequest.success) {
     throw new Error("Invalid Tileflow geocoding request");
   }
+  const withPlaces = parsedRequest.data.include !== void 0;
   return requestGeocoding(
     "/v1/geocoding/autocomplete",
     parsedRequest.data,
     options,
     autocompleteResponseSchema,
-    (response) => response.suggestions.length <= parsedRequest.data.limit
+    (response) => response.usage.units === searchOperationUnits("autocomplete", parsedRequest.data.include) && response.suggestions.length <= parsedRequest.data.limit && response.suggestions.every((suggestion) => suggestion.place !== void 0 === withPlaces)
   );
 }
 async function resolveSuggestion(request, options) {
@@ -130,11 +137,13 @@ async function resolveSuggestion(request, options) {
   if (!parsedRequest.success) {
     throw new Error("Invalid Tileflow geocoding request");
   }
+  const units = searchOperationUnits("resolve", parsedRequest.data.include);
   return requestGeocoding(
     "/v1/geocoding/resolve",
     parsedRequest.data,
     options,
-    resolveSuggestionResponseSchema
+    resolveSuggestionResponseSchema,
+    (response) => response.usage.units === units
   );
 }
 var resolvePlace = resolveSuggestion;
@@ -148,12 +157,13 @@ async function searchNearby(request, options) {
       status: 422
     });
   }
+  const units = searchOperationUnits("nearby", query.include);
   return requestGeocoding(
     "/v1/geocoding/nearby",
     query,
     options,
     nearbyResponseSchema,
-    (response) => response.results.length <= query.limit,
+    (response) => response.usage.units === units && response.results.length <= query.limit,
     nearbyLimits.maximumResponseBytes
   );
 }
@@ -216,6 +226,14 @@ async function requestGeocoding(path, request, options, responseSchema, isExpect
   }
   return parsedResponse.data;
 }
+function rejectContactDetails(include) {
+  if (include?.some((detail) => searchContactDetails.includes(detail))) {
+    throw new GeocodingError("Unsupported geocoding filters", {
+      code: "GEOCODING_FILTER_UNSUPPORTED",
+      status: 422
+    });
+  }
+}
 function containsOnlyKinds(response, allowedKinds) {
   if (!allowedKinds) return true;
   const kindFilter = new Set(allowedKinds);

package/dist/{chunk-R7KE2IN7.js → chunk-W66J2DAS.js}

@@ -16,7 +16,10 @@ var geocodingLimits = Object.freeze({
   maximumResponseBytes: 64 * 1024,
   maximumSafeErrorBytes: 8 * 1024,
   maximumSourceCharacters: 128,
-  maximumSuggestionTokenCharacters: 2048
+  maximumSuggestionTokenCharacters: 2048,
+  maximumDetailEntries: 100,
+  maximumOpeningHoursEntries: 20,
+  maximumOpeningHoursLines: 50
 });
 var boundedText = (maximum) => z.string().trim().min(1).max(maximum).refine((value) => !controlCharacterPattern.test(value), {
   message: "Control characters are not allowed"
@@ -28,8 +31,14 @@ var geocodingRetentionModes = ["temporary"];
 var geocodingBoundsSchema = z.tuple([longitude, latitude, longitude, latitude]).refine(([west, , east]) => west < east, { message: "West must be less than east" }).refine(([, south, , north]) => south < north, {
   message: "South must be less than north"
 });
+var searchPlaceDetails = ["contacts", "openingHours", "timeZone", "accessPoints"];
+var searchPlaceDetailSchema = z.enum(searchPlaceDetails);
+var searchPlaceDetailsSchema = z.array(searchPlaceDetailSchema).min(1).max(searchPlaceDetails.length).refine((values) => new Set(values).size === values.length, {
+  message: "Place details must be unique"
+});
 var geocodingForwardRequestSchema = z.object({
   bounds: geocodingBoundsSchema.optional(),
+  include: searchPlaceDetailsSchema.optional(),
   language: z.string().max(geocodingLimits.maximumLanguageCharacters).regex(languagePattern).optional(),
   limit: z.number().int().min(1).max(geocodingLimits.maximumLimit).optional(),
   proximity: geocodingPositionSchema.optional(),
@@ -39,8 +48,10 @@ var geocodingForwardRequestSchema = z.object({
   message: "Bounds and proximity are mutually exclusive",
   path: ["proximity"]
 });
+var autocompleteIncludeSchema = z.tuple([z.literal("place")]);
 var autocompleteRequestSchema = z.object({
   bounds: geocodingBoundsSchema.optional(),
+  include: autocompleteIncludeSchema.optional(),
   language: z.string().max(geocodingLimits.maximumLanguageCharacters).regex(languagePattern).optional(),
   limit: z.number().int().min(1).max(geocodingLimits.maximumLimit).default(geocodingLimits.defaultLimit),
   proximity: geocodingPositionSchema.optional(),
@@ -51,6 +62,7 @@ var autocompleteRequestSchema = z.object({
 });
 var reverseGeocodingKindSchema = z.enum(["address", "street", "locality", "place"]);
 var geocodingReverseRequestSchema = z.object({
+  include: searchPlaceDetailsSchema.optional(),
   kinds: z.array(reverseGeocodingKindSchema).min(1).max(4).optional(),
   language: z.string().max(geocodingLimits.maximumLanguageCharacters).regex(languagePattern).optional(),
   limit: z.number().int().min(1).max(geocodingLimits.maximumLimit).default(geocodingLimits.defaultReverseLimit),
@@ -93,10 +105,40 @@ var searchCategorySchema = z.object({
 var searchPlaceMetadata = {
   name: searchLiteralText(200).optional(),
   categories: z.array(searchCategorySchema).min(1).max(100).optional(),
+  foodTypes: z.array(searchCategorySchema).min(1).max(100).optional(),
   businessChains: z.array(z.object({ id: searchLiteralText(100), name: searchLiteralText(100) }).strict()).min(1).max(100).optional()
 };
+var contactListSchema = z.array(
+  z.object({
+    value: searchLiteralText(2048),
+    label: searchLiteralText(256).optional()
+  }).strict()
+).min(1).max(geocodingLimits.maximumDetailEntries);
+var searchContactsSchema = z.object({
+  phones: contactListSchema.optional(),
+  websites: contactListSchema.optional(),
+  emails: contactListSchema.optional()
+}).strict();
+var searchOpeningHoursSchema = z.array(
+  z.object({
+    display: z.array(searchLiteralText(256)).min(1).max(geocodingLimits.maximumOpeningHoursLines).optional(),
+    openNow: z.boolean().optional()
+  }).strict()
+).min(1).max(geocodingLimits.maximumOpeningHoursEntries);
+var searchTimeZoneSchema = z.object({
+  name: searchLiteralText(64),
+  utcOffsetSeconds: z.number().int().min(-86400).max(86400).optional()
+}).strict();
+var searchPlaceDetailFields = {
+  distanceMeters: z.number().finite().nonnegative().optional(),
+  contacts: searchContactsSchema.optional(),
+  openingHours: searchOpeningHoursSchema.optional(),
+  timeZone: searchTimeZoneSchema.optional(),
+  accessPoints: z.array(z.object({ position: geocodingPositionSchema }).strict()).min(1).max(geocodingLimits.maximumDetailEntries).optional()
+};
 var geocodingResultSchema = z.object({
   ...searchPlaceMetadata,
+  ...searchPlaceDetailFields,
   address: geocodingAddressSchema,
   bounds: geocodingBoundsSchema.optional(),
   kind: z.enum(geocodingResultKinds),
@@ -116,18 +158,21 @@ var geocodingAttributionSchema = z.object({
     message: "Expected an HTTPS URL without credentials"
   }).optional()
 }).strict();
+var placeOperationUnitsSchema = z.union([z.literal(25), z.literal(75)]);
 var geocodingForwardResponseSchema = z.object({
   attribution: z.array(geocodingAttributionSchema).min(1).max(geocodingLimits.maximumAttributionEntries),
   queryId: z.string().regex(queryIdPattern),
   results: z.array(geocodingResultSchema).max(geocodingLimits.maximumLimit),
   schemaVersion: z.literal(1),
   source: geocodingSourceSchema,
-  usage: z.object({ units: z.literal(25) }).strict()
+  usage: z.object({ units: placeOperationUnitsSchema }).strict()
 }).strict();
 var geocodingReverseResponseSchema = geocodingForwardResponseSchema;
 var geocodingSuggestionSchema = z.object({
   kind: z.enum(geocodingResultKinds),
   label: boundedText(512),
+  addressLabel: boundedText(512).optional(),
+  place: geocodingResultSchema.optional(),
   token: z.string().min(1).max(geocodingLimits.maximumSuggestionTokenCharacters).regex(/^[\x21-\x7e]+$/u)
 }).strict();
 var autocompleteResponseSchema = z.object({
@@ -135,9 +180,10 @@ var autocompleteResponseSchema = z.object({
   schemaVersion: z.literal(1),
   source: geocodingSourceSchema,
   suggestions: z.array(geocodingSuggestionSchema).max(geocodingLimits.maximumLimit),
-  usage: z.object({ units: z.literal(10) }).strict()
+  usage: z.object({ units: z.union([z.literal(10), z.literal(25)]) }).strict()
 }).strict();
 var resolveSuggestionRequestSchema = z.object({
+  include: searchPlaceDetailsSchema.optional(),
   retention: z.enum(geocodingRetentionModes).default("temporary"),
   token: z.string().min(1).max(geocodingLimits.maximumSuggestionTokenCharacters).regex(/^[\x21-\x7e]+$/u)
 }).strict();
@@ -146,7 +192,7 @@ var resolveSuggestionResponseSchema = z.object({
   result: geocodingResultSchema,
   schemaVersion: z.literal(1),
   source: geocodingSourceSchema,
-  usage: z.object({ units: z.literal(25) }).strict()
+  usage: z.object({ units: placeOperationUnitsSchema }).strict()
 }).strict();
 function isCredentialFreeHttpsUrl(value) {
   try {
@@ -177,12 +223,12 @@ var nearbyRequestSchema = z.object({
   excludeCategories: categoryFilter.optional(),
   countries: z.array(z.string().regex(/^(?:[A-Z]{2}|[A-Z]{3})$/u)).min(1).max(nearbyLimits.maximumCountries).optional(),
   language: geocodingForwardRequestSchema.shape.language,
+  include: searchPlaceDetailsSchema.optional(),
   limit: z.number().int().min(1).max(nearbyLimits.maximumLimit).default(nearbyLimits.defaultLimit),
   cursor: nearbyCursorSchema.optional()
 }).strict();
 var nearbyPlaceSchema = geocodingResultSchema.omit({ sourceRef: true }).extend({
   kind: z.literal("place"),
-  distanceMeters: z.number().finite().nonnegative().optional(),
   token: geocodingSuggestionSchema.shape.token.optional()
 }).strict();
 var nearbyResponseSchema = z.object({
@@ -192,7 +238,7 @@ var nearbyResponseSchema = z.object({
   nextCursor: nearbyCursorSchema.optional(),
   source: geocodingSourceSchema,
   attribution: geocodingForwardResponseSchema.shape.attribution,
-  usage: z.object({ units: z.literal(25) }).strict()
+  usage: z.object({ units: placeOperationUnitsSchema }).strict()
 }).strict().refine(
   (value) => new TextEncoder().encode(JSON.stringify(value)).byteLength <= nearbyLimits.maximumResponseBytes,
   { message: "Nearby response exceeds the encoded byte limit" }
@@ -207,13 +253,23 @@ var searchCategoriesResponseSchema = z.object({
 }).strict();
 var resolvePlaceRequestSchema = resolveSuggestionRequestSchema;
 var resolvePlaceResponseSchema = resolveSuggestionResponseSchema;
+var searchContactDetails = ["contacts", "openingHours"];
+function searchOperationUnits(operation, include) {
+  if (operation === "categories") return 0;
+  if (operation === "autocomplete") return include?.length ? 25 : 10;
+  return include?.length ? 75 : 25;
+}
 
 export {
   geocodingLimits,
   geocodingPositionSchema,
   geocodingRetentionModes,
   geocodingBoundsSchema,
+  searchPlaceDetails,
+  searchPlaceDetailSchema,
+  searchPlaceDetailsSchema,
   geocodingForwardRequestSchema,
+  autocompleteIncludeSchema,
   autocompleteRequestSchema,
   reverseGeocodingKindSchema,
   geocodingReverseRequestSchema,
@@ -223,6 +279,10 @@ export {
   searchCategoryIdSchema,
   searchCategorySchema,
   searchPlaceMetadata,
+  searchContactsSchema,
+  searchOpeningHoursSchema,
+  searchTimeZoneSchema,
+  searchPlaceDetailFields,
   geocodingResultSchema,
   geocodingSourceSchema,
   geocodingAttributionSchema,
@@ -239,5 +299,7 @@ export {
   nearbyResponseSchema,
   searchCategoriesResponseSchema,
   resolvePlaceRequestSchema,
-  resolvePlaceResponseSchema
+  resolvePlaceResponseSchema,
+  searchContactDetails,
+  searchOperationUnits
 };

package/dist/client.js

@@ -8,8 +8,8 @@ import {
   resolvePlace,
   resolveSuggestion,
   searchNearby
-} from "./chunk-FEWG4I4E.js";
-import "./chunk-R7KE2IN7.js";
+} from "./chunk-QDEMNVJD.js";
+import "./chunk-W66J2DAS.js";
 export {
   GEOCODING_ERROR_CODES,
   GeocodingError,

package/dist/contract.d.ts

@@ -13,12 +13,39 @@ declare const geocodingLimits: Readonly<{
     maximumSafeErrorBytes: number;
     maximumSourceCharacters: 128;
     maximumSuggestionTokenCharacters: 2048;
+    maximumDetailEntries: 100;
+    maximumOpeningHoursEntries: 20;
+    maximumOpeningHoursLines: 50;
 }>;
 declare const geocodingPositionSchema: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
 declare const geocodingRetentionModes: readonly ["temporary"];
 declare const geocodingBoundsSchema: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+/**
+ * Optional place details. Requesting any of them makes the operation an extended one with a
+ * higher unit weight. Contacts and opening hours need a text search inside bounds, Nearby or an
+ * explicit resolution; time zones and access points are available to every place operation.
+ */
+declare const searchPlaceDetails: readonly ["contacts", "openingHours", "timeZone", "accessPoints"];
+declare const searchPlaceDetailSchema: z.ZodEnum<{
+    accessPoints: "accessPoints";
+    contacts: "contacts";
+    openingHours: "openingHours";
+    timeZone: "timeZone";
+}>;
+declare const searchPlaceDetailsSchema: z.ZodArray<z.ZodEnum<{
+    accessPoints: "accessPoints";
+    contacts: "contacts";
+    openingHours: "openingHours";
+    timeZone: "timeZone";
+}>>;
 declare const geocodingForwardRequestSchema: z.ZodObject<{
     bounds: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        accessPoints: "accessPoints";
+        contacts: "contacts";
+        openingHours: "openingHours";
+        timeZone: "timeZone";
+    }>>>;
     language: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodNumber>;
     proximity: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
@@ -27,8 +54,11 @@ declare const geocodingForwardRequestSchema: z.ZodObject<{
         temporary: "temporary";
     }>>;
 }, z.core.$strict>;
+/** Autocomplete returns each suggestion's place, with its position, when `place` is included. */
+declare const autocompleteIncludeSchema: z.ZodTuple<[z.ZodLiteral<"place">], null>;
 declare const autocompleteRequestSchema: z.ZodObject<{
     bounds: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    include: z.ZodOptional<z.ZodTuple<[z.ZodLiteral<"place">], null>>;
     language: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodNumber>;
     proximity: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
@@ -41,6 +71,12 @@ declare const reverseGeocodingKindSchema: z.ZodEnum<{
     street: "street";
 }>;
 declare const geocodingReverseRequestSchema: z.ZodObject<{
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        accessPoints: "accessPoints";
+        contacts: "contacts";
+        openingHours: "openingHours";
+        timeZone: "timeZone";
+    }>>>;
     kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         address: "address";
         locality: "locality";
@@ -84,11 +120,68 @@ declare const searchPlaceMetadata: {
         localizedName: z.ZodOptional<z.ZodString>;
         primary: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>>;
+    foodTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        localizedName: z.ZodOptional<z.ZodString>;
+        primary: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
     businessChains: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
     }, z.core.$strict>>>;
 };
+/** Contact values are provider text, not validated links: check a scheme before linking one. */
+declare const searchContactsSchema: z.ZodObject<{
+    phones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    websites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    emails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+declare const searchOpeningHoursSchema: z.ZodArray<z.ZodObject<{
+    display: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    openNow: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>>;
+declare const searchTimeZoneSchema: z.ZodObject<{
+    name: z.ZodString;
+    utcOffsetSeconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+declare const searchPlaceDetailFields: {
+    distanceMeters: z.ZodOptional<z.ZodNumber>;
+    contacts: z.ZodOptional<z.ZodObject<{
+        phones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        websites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        emails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    openingHours: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        display: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        openNow: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    timeZone: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        utcOffsetSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    accessPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>>>;
+};
 declare const geocodingResultSchema: z.ZodObject<{
     address: z.ZodObject<{
         city: z.ZodOptional<z.ZodString>;
@@ -118,6 +211,32 @@ declare const geocodingResultSchema: z.ZodObject<{
     label: z.ZodString;
     position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     sourceRef: z.ZodOptional<z.ZodString>;
+    distanceMeters: z.ZodOptional<z.ZodNumber>;
+    contacts: z.ZodOptional<z.ZodObject<{
+        phones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        websites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        emails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    openingHours: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        display: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        openNow: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    timeZone: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        utcOffsetSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    accessPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>>>;
     name: z.ZodOptional<z.ZodString>;
     categories: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -125,6 +244,12 @@ declare const geocodingResultSchema: z.ZodObject<{
         localizedName: z.ZodOptional<z.ZodString>;
         primary: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>>;
+    foodTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        localizedName: z.ZodOptional<z.ZodString>;
+        primary: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
     businessChains: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
@@ -173,6 +298,32 @@ declare const geocodingForwardResponseSchema: z.ZodObject<{
         label: z.ZodString;
         position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
         sourceRef: z.ZodOptional<z.ZodString>;
+        distanceMeters: z.ZodOptional<z.ZodNumber>;
+        contacts: z.ZodOptional<z.ZodObject<{
+            phones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            websites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            emails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        openingHours: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            display: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            openNow: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        timeZone: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            utcOffsetSeconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        accessPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>>>;
         name: z.ZodOptional<z.ZodString>;
         categories: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -180,6 +331,12 @@ declare const geocodingForwardResponseSchema: z.ZodObject<{
             localizedName: z.ZodOptional<z.ZodString>;
             primary: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>>;
+        foodTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            localizedName: z.ZodOptional<z.ZodString>;
+            primary: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
         businessChains: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;
@@ -191,7 +348,7 @@ declare const geocodingForwardResponseSchema: z.ZodObject<{
         revision: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
     usage: z.ZodObject<{
-        units: z.ZodLiteral<25>;
+        units: z.ZodUnion<readonly [z.ZodLiteral<25>, z.ZodLiteral<75>]>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 declare const geocodingReverseResponseSchema: z.ZodObject<{
@@ -229,6 +386,32 @@ declare const geocodingReverseResponseSchema: z.ZodObject<{
         label: z.ZodString;
         position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
         sourceRef: z.ZodOptional<z.ZodString>;
+        distanceMeters: z.ZodOptional<z.ZodNumber>;
+        contacts: z.ZodOptional<z.ZodObject<{
+            phones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            websites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            emails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        openingHours: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            display: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            openNow: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        timeZone: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            utcOffsetSeconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        accessPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>>>;
         name: z.ZodOptional<z.ZodString>;
         categories: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -236,6 +419,12 @@ declare const geocodingReverseResponseSchema: z.ZodObject<{
             localizedName: z.ZodOptional<z.ZodString>;
             primary: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>>;
+        foodTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            localizedName: z.ZodOptional<z.ZodString>;
+            primary: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
         businessChains: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;
@@ -247,7 +436,7 @@ declare const geocodingReverseResponseSchema: z.ZodObject<{
         revision: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
     usage: z.ZodObject<{
-        units: z.ZodLiteral<25>;
+        units: z.ZodUnion<readonly [z.ZodLiteral<25>, z.ZodLiteral<75>]>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 declare const geocodingSuggestionSchema: z.ZodObject<{
@@ -263,6 +452,80 @@ declare const geocodingSuggestionSchema: z.ZodObject<{
         unknown: "unknown";
     }>;
     label: z.ZodString;
+    addressLabel: z.ZodOptional<z.ZodString>;
+    place: z.ZodOptional<z.ZodObject<{
+        address: z.ZodObject<{
+            city: z.ZodOptional<z.ZodString>;
+            country: z.ZodOptional<z.ZodString>;
+            countryCode: z.ZodOptional<z.ZodString>;
+            county: z.ZodOptional<z.ZodString>;
+            district: z.ZodOptional<z.ZodString>;
+            houseNumber: z.ZodOptional<z.ZodString>;
+            locality: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            postalCode: z.ZodOptional<z.ZodString>;
+            region: z.ZodOptional<z.ZodString>;
+            street: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        bounds: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        kind: z.ZodEnum<{
+            address: "address";
+            country: "country";
+            county: "county";
+            district: "district";
+            locality: "locality";
+            place: "place";
+            region: "region";
+            street: "street";
+            unknown: "unknown";
+        }>;
+        label: z.ZodString;
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        sourceRef: z.ZodOptional<z.ZodString>;
+        distanceMeters: z.ZodOptional<z.ZodNumber>;
+        contacts: z.ZodOptional<z.ZodObject<{
+            phones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            websites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            emails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        openingHours: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            display: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            openNow: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        timeZone: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            utcOffsetSeconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        accessPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>>>;
+        name: z.ZodOptional<z.ZodString>;
+        categories: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            localizedName: z.ZodOptional<z.ZodString>;
+            primary: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        foodTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            localizedName: z.ZodOptional<z.ZodString>;
+            primary: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        businessChains: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
     token: z.ZodString;
 }, z.core.$strict>;
 declare const autocompleteResponseSchema: z.ZodObject<{
@@ -288,13 +551,93 @@ declare const autocompleteResponseSchema: z.ZodObject<{
             unknown: "unknown";
         }>;
         label: z.ZodString;
+        addressLabel: z.ZodOptional<z.ZodString>;
+        place: z.ZodOptional<z.ZodObject<{
+            address: z.ZodObject<{
+                city: z.ZodOptional<z.ZodString>;
+                country: z.ZodOptional<z.ZodString>;
+                countryCode: z.ZodOptional<z.ZodString>;
+                county: z.ZodOptional<z.ZodString>;
+                district: z.ZodOptional<z.ZodString>;
+                houseNumber: z.ZodOptional<z.ZodString>;
+                locality: z.ZodOptional<z.ZodString>;
+                name: z.ZodOptional<z.ZodString>;
+                postalCode: z.ZodOptional<z.ZodString>;
+                region: z.ZodOptional<z.ZodString>;
+                street: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            bounds: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            kind: z.ZodEnum<{
+                address: "address";
+                country: "country";
+                county: "county";
+                district: "district";
+                locality: "locality";
+                place: "place";
+                region: "region";
+                street: "street";
+                unknown: "unknown";
+            }>;
+            label: z.ZodString;
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+            sourceRef: z.ZodOptional<z.ZodString>;
+            distanceMeters: z.ZodOptional<z.ZodNumber>;
+            contacts: z.ZodOptional<z.ZodObject<{
+                phones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    value: z.ZodString;
+                    label: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                websites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    value: z.ZodString;
+                    label: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                emails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    value: z.ZodString;
+                    label: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+            openingHours: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                display: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                openNow: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            timeZone: z.ZodOptional<z.ZodObject<{
+                name: z.ZodString;
+                utcOffsetSeconds: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+            accessPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+            }, z.core.$strict>>>;
+            name: z.ZodOptional<z.ZodString>;
+            categories: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                localizedName: z.ZodOptional<z.ZodString>;
+                primary: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            foodTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                localizedName: z.ZodOptional<z.ZodString>;
+                primary: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            businessChains: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
         token: z.ZodString;
     }, z.core.$strict>>;
     usage: z.ZodObject<{
-        units: z.ZodLiteral<10>;
+        units: z.ZodUnion<readonly [z.ZodLiteral<10>, z.ZodLiteral<25>]>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 declare const resolveSuggestionRequestSchema: z.ZodObject<{
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        accessPoints: "accessPoints";
+        contacts: "contacts";
+        openingHours: "openingHours";
+        timeZone: "timeZone";
+    }>>>;
     retention: z.ZodDefault<z.ZodEnum<{
         temporary: "temporary";
     }>>;
@@ -334,6 +677,32 @@ declare const resolveSuggestionResponseSchema: z.ZodObject<{
         label: z.ZodString;
         position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
         sourceRef: z.ZodOptional<z.ZodString>;
+        distanceMeters: z.ZodOptional<z.ZodNumber>;
+        contacts: z.ZodOptional<z.ZodObject<{
+            phones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            websites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            emails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        openingHours: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            display: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            openNow: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        timeZone: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            utcOffsetSeconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        accessPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>>>;
         name: z.ZodOptional<z.ZodString>;
         categories: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -341,6 +710,12 @@ declare const resolveSuggestionResponseSchema: z.ZodObject<{
             localizedName: z.ZodOptional<z.ZodString>;
             primary: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>>;
+        foodTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            localizedName: z.ZodOptional<z.ZodString>;
+            primary: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
         businessChains: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;
@@ -352,7 +727,7 @@ declare const resolveSuggestionResponseSchema: z.ZodObject<{
         revision: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
     usage: z.ZodObject<{
-        units: z.ZodLiteral<25>;
+        units: z.ZodUnion<readonly [z.ZodLiteral<25>, z.ZodLiteral<75>]>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 type GeocodingForwardRequest = z.input<typeof geocodingForwardRequestSchema>;
@@ -361,6 +736,10 @@ type ReverseGeocodingKind = z.infer<typeof reverseGeocodingKindSchema>;
 type GeocodingReverseRequest = z.input<typeof geocodingReverseRequestSchema>;
 type NormalizedGeocodingReverseRequest = z.output<typeof geocodingReverseRequestSchema>;
 type GeocodingResult = z.infer<typeof geocodingResultSchema>;
+type SearchPlaceDetail = z.infer<typeof searchPlaceDetailSchema>;
+type SearchContacts = z.infer<typeof searchContactsSchema>;
+type SearchOpeningHours = z.infer<typeof searchOpeningHoursSchema>;
+type SearchTimeZone = z.infer<typeof searchTimeZoneSchema>;
 type GeocodingForwardResponse = z.infer<typeof geocodingForwardResponseSchema>;
 type GeocodingReverseResponse = GeocodingForwardResponse;
 type AutocompleteRequest = z.input<typeof autocompleteRequestSchema>;
@@ -390,11 +769,42 @@ declare const nearbyRequestSchema: z.ZodObject<{
     excludeCategories: z.ZodOptional<z.ZodArray<z.ZodString>>;
     countries: z.ZodOptional<z.ZodArray<z.ZodString>>;
     language: z.ZodOptional<z.ZodString>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        accessPoints: "accessPoints";
+        contacts: "contacts";
+        openingHours: "openingHours";
+        timeZone: "timeZone";
+    }>>>;
     limit: z.ZodDefault<z.ZodNumber>;
     cursor: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 declare const nearbyPlaceSchema: z.ZodObject<{
     bounds: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    contacts: z.ZodOptional<z.ZodObject<{
+        phones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        websites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        emails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    openingHours: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        display: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        openNow: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    timeZone: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        utcOffsetSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    accessPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>>>;
     address: z.ZodObject<{
         city: z.ZodOptional<z.ZodString>;
         country: z.ZodOptional<z.ZodString>;
@@ -417,12 +827,18 @@ declare const nearbyPlaceSchema: z.ZodObject<{
         localizedName: z.ZodOptional<z.ZodString>;
         primary: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>>;
+    distanceMeters: z.ZodOptional<z.ZodNumber>;
+    foodTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        localizedName: z.ZodOptional<z.ZodString>;
+        primary: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
     businessChains: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
     }, z.core.$strict>>>;
     kind: z.ZodLiteral<"place">;
-    distanceMeters: z.ZodOptional<z.ZodNumber>;
     token: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 declare const nearbyResponseSchema: z.ZodObject<{
@@ -430,6 +846,31 @@ declare const nearbyResponseSchema: z.ZodObject<{
     provider: z.ZodLiteral<"aws">;
     results: z.ZodArray<z.ZodObject<{
         bounds: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        contacts: z.ZodOptional<z.ZodObject<{
+            phones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            websites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            emails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        openingHours: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            display: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            openNow: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        timeZone: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            utcOffsetSeconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        accessPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>>>;
         address: z.ZodObject<{
             city: z.ZodOptional<z.ZodString>;
             country: z.ZodOptional<z.ZodString>;
@@ -452,12 +893,18 @@ declare const nearbyResponseSchema: z.ZodObject<{
             localizedName: z.ZodOptional<z.ZodString>;
             primary: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>>;
+        distanceMeters: z.ZodOptional<z.ZodNumber>;
+        foodTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            localizedName: z.ZodOptional<z.ZodString>;
+            primary: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
         businessChains: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;
         }, z.core.$strict>>>;
         kind: z.ZodLiteral<"place">;
-        distanceMeters: z.ZodOptional<z.ZodNumber>;
         token: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     nextCursor: z.ZodOptional<z.ZodString>;
@@ -470,7 +917,7 @@ declare const nearbyResponseSchema: z.ZodObject<{
         url: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     usage: z.ZodObject<{
-        units: z.ZodLiteral<25>;
+        units: z.ZodUnion<readonly [z.ZodLiteral<25>, z.ZodLiteral<75>]>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 declare const searchCategoriesResponseSchema: z.ZodObject<{
@@ -495,6 +942,12 @@ declare const searchCategoriesResponseSchema: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strict>;
 declare const resolvePlaceRequestSchema: z.ZodObject<{
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        accessPoints: "accessPoints";
+        contacts: "contacts";
+        openingHours: "openingHours";
+        timeZone: "timeZone";
+    }>>>;
     retention: z.ZodDefault<z.ZodEnum<{
         temporary: "temporary";
     }>>;
@@ -534,6 +987,32 @@ declare const resolvePlaceResponseSchema: z.ZodObject<{
         label: z.ZodString;
         position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
         sourceRef: z.ZodOptional<z.ZodString>;
+        distanceMeters: z.ZodOptional<z.ZodNumber>;
+        contacts: z.ZodOptional<z.ZodObject<{
+            phones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            websites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            emails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        openingHours: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            display: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            openNow: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        timeZone: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            utcOffsetSeconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        accessPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>>>;
         name: z.ZodOptional<z.ZodString>;
         categories: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -541,6 +1020,12 @@ declare const resolvePlaceResponseSchema: z.ZodObject<{
             localizedName: z.ZodOptional<z.ZodString>;
             primary: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>>;
+        foodTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            localizedName: z.ZodOptional<z.ZodString>;
+            primary: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
         businessChains: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;
@@ -552,7 +1037,7 @@ declare const resolvePlaceResponseSchema: z.ZodObject<{
         revision: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
     usage: z.ZodObject<{
-        units: z.ZodLiteral<25>;
+        units: z.ZodUnion<readonly [z.ZodLiteral<25>, z.ZodLiteral<75>]>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 type NearbyRequest = z.input<typeof nearbyRequestSchema>;
@@ -563,5 +1048,13 @@ type SearchCategory = z.infer<typeof searchCategorySchema>;
 type SearchCategoriesResponse = z.infer<typeof searchCategoriesResponseSchema>;
 type ResolvePlaceRequest = ResolveSuggestionRequest;
 type ResolvePlaceResponse = ResolveSuggestionResponse;
+/** Place details that need a provider text search or a selected place: not geocoding. */
+declare const searchContactDetails: readonly SearchPlaceDetail[];
+/**
+ * The shared API units a completed Search operation consumes. Autocomplete uses 10, or 25 with
+ * its places; every other place operation uses 25, or 75 with any place detail. Category
+ * discovery uses none.
+ */
+declare function searchOperationUnits(operation: 'autocomplete' | 'forward' | 'reverse' | 'resolve' | 'nearby' | 'categories', include?: readonly string[]): 0 | 10 | 25 | 75;
 
-export { type AutocompleteRequest, type AutocompleteResponse, type GeocodingForwardRequest, type GeocodingForwardResponse, type GeocodingResult, type GeocodingReverseRequest, type GeocodingReverseResponse, type GeocodingSuggestion, type NearbyPlace, type NearbyRequest, type NearbyResponse, type NormalizedAutocompleteRequest, type NormalizedGeocodingForwardRequest, type NormalizedGeocodingReverseRequest, type NormalizedNearbyRequest, type NormalizedResolveSuggestionRequest, type ResolvePlaceRequest, type ResolvePlaceResponse, type ResolveSuggestionRequest, type ResolveSuggestionResponse, type ReverseGeocodingKind, type SearchCategoriesResponse, type SearchCategory, autocompleteRequestSchema, autocompleteResponseSchema, geocodingAddressSchema, geocodingAttributionSchema, geocodingBoundsSchema, geocodingForwardRequestSchema, geocodingForwardResponseSchema, geocodingLimits, geocodingPositionSchema, geocodingResultKinds, geocodingResultSchema, geocodingRetentionModes, geocodingReverseRequestSchema, geocodingReverseResponseSchema, geocodingSourceSchema, geocodingSuggestionSchema, nearbyCursorSchema, nearbyLimits, nearbyPlaceSchema, nearbyRequestSchema, nearbyResponseSchema, resolvePlaceRequestSchema, resolvePlaceResponseSchema, resolveSuggestionRequestSchema, resolveSuggestionResponseSchema, reverseGeocodingKindSchema, searchCategoriesResponseSchema, searchCategoryIdSchema, searchCategorySchema, searchLiteralText, searchPlaceMetadata };
+export { type AutocompleteRequest, type AutocompleteResponse, type GeocodingForwardRequest, type GeocodingForwardResponse, type GeocodingResult, type GeocodingReverseRequest, type GeocodingReverseResponse, type GeocodingSuggestion, type NearbyPlace, type NearbyRequest, type NearbyResponse, type NormalizedAutocompleteRequest, type NormalizedGeocodingForwardRequest, type NormalizedGeocodingReverseRequest, type NormalizedNearbyRequest, type NormalizedResolveSuggestionRequest, type ResolvePlaceRequest, type ResolvePlaceResponse, type ResolveSuggestionRequest, type ResolveSuggestionResponse, type ReverseGeocodingKind, type SearchCategoriesResponse, type SearchCategory, type SearchContacts, type SearchOpeningHours, type SearchPlaceDetail, type SearchTimeZone, autocompleteIncludeSchema, autocompleteRequestSchema, autocompleteResponseSchema, geocodingAddressSchema, geocodingAttributionSchema, geocodingBoundsSchema, geocodingForwardRequestSchema, geocodingForwardResponseSchema, geocodingLimits, geocodingPositionSchema, geocodingResultKinds, geocodingResultSchema, geocodingRetentionModes, geocodingReverseRequestSchema, geocodingReverseResponseSchema, geocodingSourceSchema, geocodingSuggestionSchema, nearbyCursorSchema, nearbyLimits, nearbyPlaceSchema, nearbyRequestSchema, nearbyResponseSchema, resolvePlaceRequestSchema, resolvePlaceResponseSchema, resolveSuggestionRequestSchema, resolveSuggestionResponseSchema, reverseGeocodingKindSchema, searchCategoriesResponseSchema, searchCategoryIdSchema, searchCategorySchema, searchContactDetails, searchContactsSchema, searchLiteralText, searchOpeningHoursSchema, searchOperationUnits, searchPlaceDetailFields, searchPlaceDetailSchema, searchPlaceDetails, searchPlaceDetailsSchema, searchPlaceMetadata, searchTimeZoneSchema };

package/dist/contract.js

@@ -1,4 +1,5 @@
 import {
+  autocompleteIncludeSchema,
   autocompleteRequestSchema,
   autocompleteResponseSchema,
   geocodingAddressSchema,
@@ -28,10 +29,20 @@ import {
   searchCategoriesResponseSchema,
   searchCategoryIdSchema,
   searchCategorySchema,
+  searchContactDetails,
+  searchContactsSchema,
   searchLiteralText,
-  searchPlaceMetadata
-} from "./chunk-R7KE2IN7.js";
+  searchOpeningHoursSchema,
+  searchOperationUnits,
+  searchPlaceDetailFields,
+  searchPlaceDetailSchema,
+  searchPlaceDetails,
+  searchPlaceDetailsSchema,
+  searchPlaceMetadata,
+  searchTimeZoneSchema
+} from "./chunk-W66J2DAS.js";
 export {
+  autocompleteIncludeSchema,
   autocompleteRequestSchema,
   autocompleteResponseSchema,
   geocodingAddressSchema,
@@ -61,6 +72,15 @@ export {
   searchCategoriesResponseSchema,
   searchCategoryIdSchema,
   searchCategorySchema,
+  searchContactDetails,
+  searchContactsSchema,
   searchLiteralText,
-  searchPlaceMetadata
+  searchOpeningHoursSchema,
+  searchOperationUnits,
+  searchPlaceDetailFields,
+  searchPlaceDetailSchema,
+  searchPlaceDetails,
+  searchPlaceDetailsSchema,
+  searchPlaceMetadata,
+  searchTimeZoneSchema
 };

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { GEOCODING_ERROR_CODES, GeocodeOptions, GeocodingError, GeocodingErrorCode, autocomplete, geocode, geocodeReverse, listCategories, resolvePlace, resolveSuggestion, searchNearby } from './client.js';
-export { AutocompleteRequest, AutocompleteResponse, GeocodingForwardRequest, GeocodingForwardResponse, GeocodingResult, GeocodingReverseRequest, GeocodingReverseResponse, GeocodingSuggestion, NearbyPlace, NearbyRequest, NearbyResponse, NormalizedAutocompleteRequest, NormalizedGeocodingForwardRequest, NormalizedGeocodingReverseRequest, NormalizedNearbyRequest, NormalizedResolveSuggestionRequest, ResolvePlaceRequest, ResolvePlaceResponse, ResolveSuggestionRequest, ResolveSuggestionResponse, ReverseGeocodingKind, SearchCategoriesResponse, SearchCategory, autocompleteRequestSchema, autocompleteResponseSchema, geocodingAddressSchema, geocodingAttributionSchema, geocodingBoundsSchema, geocodingForwardRequestSchema, geocodingForwardResponseSchema, geocodingLimits, geocodingPositionSchema, geocodingResultKinds, geocodingResultSchema, geocodingRetentionModes, geocodingReverseRequestSchema, geocodingReverseResponseSchema, geocodingSourceSchema, geocodingSuggestionSchema, nearbyCursorSchema, nearbyLimits, nearbyPlaceSchema, nearbyRequestSchema, nearbyResponseSchema, resolvePlaceRequestSchema, resolvePlaceResponseSchema, resolveSuggestionRequestSchema, resolveSuggestionResponseSchema, reverseGeocodingKindSchema, searchCategoriesResponseSchema, searchCategoryIdSchema, searchCategorySchema, searchLiteralText, searchPlaceMetadata } from './contract.js';
+export { AutocompleteRequest, AutocompleteResponse, GeocodingForwardRequest, GeocodingForwardResponse, GeocodingResult, GeocodingReverseRequest, GeocodingReverseResponse, GeocodingSuggestion, NearbyPlace, NearbyRequest, NearbyResponse, NormalizedAutocompleteRequest, NormalizedGeocodingForwardRequest, NormalizedGeocodingReverseRequest, NormalizedNearbyRequest, NormalizedResolveSuggestionRequest, ResolvePlaceRequest, ResolvePlaceResponse, ResolveSuggestionRequest, ResolveSuggestionResponse, ReverseGeocodingKind, SearchCategoriesResponse, SearchCategory, SearchContacts, SearchOpeningHours, SearchPlaceDetail, SearchTimeZone, autocompleteIncludeSchema, autocompleteRequestSchema, autocompleteResponseSchema, geocodingAddressSchema, geocodingAttributionSchema, geocodingBoundsSchema, geocodingForwardRequestSchema, geocodingForwardResponseSchema, geocodingLimits, geocodingPositionSchema, geocodingResultKinds, geocodingResultSchema, geocodingRetentionModes, geocodingReverseRequestSchema, geocodingReverseResponseSchema, geocodingSourceSchema, geocodingSuggestionSchema, nearbyCursorSchema, nearbyLimits, nearbyPlaceSchema, nearbyRequestSchema, nearbyResponseSchema, resolvePlaceRequestSchema, resolvePlaceResponseSchema, resolveSuggestionRequestSchema, resolveSuggestionResponseSchema, reverseGeocodingKindSchema, searchCategoriesResponseSchema, searchCategoryIdSchema, searchCategorySchema, searchContactDetails, searchContactsSchema, searchLiteralText, searchOpeningHoursSchema, searchOperationUnits, searchPlaceDetailFields, searchPlaceDetailSchema, searchPlaceDetails, searchPlaceDetailsSchema, searchPlaceMetadata, searchTimeZoneSchema } from './contract.js';
 import 'zod';

package/dist/index.js

@@ -8,8 +8,9 @@ import {
   resolvePlace,
   resolveSuggestion,
   searchNearby
-} from "./chunk-FEWG4I4E.js";
+} from "./chunk-QDEMNVJD.js";
 import {
+  autocompleteIncludeSchema,
   autocompleteRequestSchema,
   autocompleteResponseSchema,
   geocodingAddressSchema,
@@ -39,13 +40,23 @@ import {
   searchCategoriesResponseSchema,
   searchCategoryIdSchema,
   searchCategorySchema,
+  searchContactDetails,
+  searchContactsSchema,
   searchLiteralText,
-  searchPlaceMetadata
-} from "./chunk-R7KE2IN7.js";
+  searchOpeningHoursSchema,
+  searchOperationUnits,
+  searchPlaceDetailFields,
+  searchPlaceDetailSchema,
+  searchPlaceDetails,
+  searchPlaceDetailsSchema,
+  searchPlaceMetadata,
+  searchTimeZoneSchema
+} from "./chunk-W66J2DAS.js";
 export {
   GEOCODING_ERROR_CODES,
   GeocodingError,
   autocomplete,
+  autocompleteIncludeSchema,
   autocompleteRequestSchema,
   autocompleteResponseSchema,
   geocode,
@@ -80,7 +91,16 @@ export {
   searchCategoriesResponseSchema,
   searchCategoryIdSchema,
   searchCategorySchema,
+  searchContactDetails,
+  searchContactsSchema,
   searchLiteralText,
   searchNearby,
-  searchPlaceMetadata
+  searchOpeningHoursSchema,
+  searchOperationUnits,
+  searchPlaceDetailFields,
+  searchPlaceDetailSchema,
+  searchPlaceDetails,
+  searchPlaceDetailsSchema,
+  searchPlaceMetadata,
+  searchTimeZoneSchema
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/search",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "license": "Apache-2.0",
   "description": "Headless geocoding and location selection client and wire contracts for Tileflow.",
   "type": "module",